@rgss23/arca (0.1.3)
Installation
@rgss23:registry=npm install @rgss23/arca@0.1.3"@rgss23/arca": "0.1.3"About this package
@rgss23/arca
ARCA의 정확한 release 하나를 설치하는 배포 패키지다. Player SDK, public contracts와 타입, native JS/WASM, license/provenance, release pin과 Builder OCI archive가 함께 들어 있다. 런타임과 Builder를 다운로드하거나 실행하는 install hook은 없다. Builder는 Docker에서 실행하는 독립 컨테이너다.
@rgss23:registry=https://git.2ex.dev/api/packages/hanyul/npm/
pnpm add --save-exact @rgss23/arca@VERSION
pnpm exec arca-release verify
import { launchRgss23Player } from "@rgss23/arca";
import type { Rgss23SaveAdapter } from "@rgss23/arca/contracts";
// Node deployment code only; never import this subpath in the browser.
import { getArcaRelease, stageArcaRelease } from "@rgss23/arca/deploy";
const release = await getArcaRelease();
// release.releaseDirectory: unchanged canonical release set for existing hosts.
// release.runtimeDirectory: verified static runtime assets and licenses.
// release.builder: exact digest and offline-loadable OCI archive path.
const installed = await stageArcaRelease("/runtime-releases");
// installed.releaseDirectory = /runtime-releases/<manifestSha256>
호스트의 lockfile integrity가 설치한 package의 신뢰 기준이다. verify는 추가로 package 내부 파일·원본 release manifest·artifact hash·Builder digest를 대조한다. browser import는 파일 검증이나 Node/Docker 실행을 수행하지 않는다. /runtime/* export는 bundler의 asset URL 처리 또는 Node의 import.meta.resolve()에 사용할 수 있다. JS와 WASM은 같은 release 경로로 배포하고 기존 configuration의 MIME·isolation 요구를 유지한다.
배포할 때 stage를 실행하면 hash별 새 디렉터리가 완성된 뒤에만 노출된다. 기존 경로의 손상이나 다른 내용은 덮어쓰지 않고 실패한다. 같은 package 재배포는 검증 후 재사용한다. 실패 시 이전 release와 실행 중인 generation을 그대로 보존한다. 배포가 끝나면 호스트가 새 실행을 새 manifest hash에 결속해야 한다. 이미 만들어진 game/RTP package의 재사용 판정, generation 교체, session과 save 보존은 호스트 책임이다. dependency 설치만으로 기존 DB의 active build를 바꾸지 않는다.
native bundle에는 개별 재배포 조건이 있다. 패키지 전체를 단일 MIT library로 취급하지 말고 runtime/LICENSES/THIRD_PARTY_NOTICES.json과 동봉된 license/source provenance를 함께 배포한다. 게임과 RTP 원본은 포함하지 않는다.