@mysten-incubation/devstack 0.1.1 → 0.2.0

package/dist/plugins/internal/postgres-sidecar/service.mjs

@@ -0,0 +1,121 @@
+import { ensureManagedContainer, sanitizeAlias } from "../../../substrate/runtime/managed-container.mjs";
+import { credentialedUrl, plainUrl, withDatabase } from "./connection.mjs";
+import { postgresConfigError, postgresPluginError } from "./errors.mjs";
+import { awaitReady, ensureDatabases } from "./db-ensure.mjs";
+import { Effect } from "effect";
+import { createHash } from "node:crypto";
+import { fileURLToPath } from "node:url";
+//#region src/plugins/internal/postgres-sidecar/service.ts
+const DEFAULT_VERSION = "17-alpine";
+const DEFAULT_USER = "devstack";
+const DEFAULT_READY_TIMEOUT_MS = 3e4;
+const DEFAULT_STOP_GRACE_SECONDS = 20;
+const POSTGRES_PORT = 5432;
+/** Sidecar password — derived from `(app, stack, role)`, deliberately without
+*  `stackRoot`. The sidecar's PGDATA rides the owning plugin's snapshots and
+*  restored image layers, so the password must remain stable across runtime
+*  roots for the same stack. */
+const deriveSidecarPassword = (app, stack, role) => {
+	return `pg-${(app + stack + role).replace(/[^a-zA-Z0-9]/g, "")}-${createHash("sha256").update(`${app}\x1f${stack}\x1f${role}`).digest("hex").slice(0, 8)}`;
+};
+const resolveSidecarOptions = (identity, opts) => {
+	if (opts.database.length === 0) throw postgresConfigError({
+		field: "database",
+		message: "postgres sidecar: `database` must be non-empty"
+	});
+	return {
+		name: opts.role,
+		version: opts.version ?? DEFAULT_VERSION,
+		user: DEFAULT_USER,
+		password: deriveSidecarPassword(identity.app, identity.stack, opts.role),
+		databases: [opts.database],
+		readyTimeoutMs: opts.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS,
+		stopGraceSeconds: opts.stopGraceSeconds ?? DEFAULT_STOP_GRACE_SECONDS
+	};
+};
+const resolveImageContextPath = () => {
+	const here = new URL(import.meta.url);
+	return fileURLToPath(new URL("../../../../images/postgres/", here));
+};
+const containerExec = (runtime, handle) => ({ run: (argv) => runtime.exec(handle, argv).pipe(Effect.catch((err) => Effect.fail(postgresPluginError("container-start", `runtime.exec failed: ${err.reason} — ${err.detail}`, err)))) });
+/** Boot a Postgres container owned by a sibling plugin. The container labels
+*  are stamped as `{ plugin: 'sui', role }` so Sui snapshot capture owns the
+*  database state; callers still share the internal Postgres image build. */
+const bootPostgresSidecar = (runtime, identity, opts) => Effect.gen(function* () {
+	const resolved = yield* Effect.try({
+		try: () => resolveSidecarOptions(identity, opts),
+		catch: (cause) => cause
+	});
+	yield* runtime.ensureNetwork({
+		name: opts.network,
+		app: identity.app,
+		stack: identity.stack
+	}).pipe(Effect.catch((cause) => Effect.fail(postgresPluginError("network-create", `failed to ensure postgres sidecar network '${opts.network}'`, cause))));
+	const imageRef = yield* runtime.ensureImage({
+		contextPath: resolveImageContextPath(),
+		dockerfile: "Dockerfile",
+		buildArgs: { POSTGRES_VERSION: resolved.version },
+		owner: {
+			app: identity.app,
+			stack: identity.stack,
+			plugin: "postgres",
+			role: "db"
+		}
+	}).pipe(Effect.catch((cause) => Effect.fail(postgresPluginError("image-build", `failed to build postgres sidecar image (${resolved.version})`, cause))));
+	const containerName = sanitizeAlias(`${identity.app}-${identity.stack}-${opts.role}`);
+	const containerHandle = yield* ensureManagedContainer({
+		runtime,
+		labels: {
+			app: identity.app,
+			stack: identity.stack,
+			plugin: "sui",
+			role: opts.role
+		},
+		spec: {
+			name: containerName,
+			image: imageRef,
+			recreate: "on-config-change",
+			...opts.configHash !== void 0 ? { configHash: opts.configHash } : {},
+			env: {
+				POSTGRES_USER: resolved.user,
+				POSTGRES_PASSWORD: resolved.password,
+				POSTGRES_DB: opts.database
+			},
+			stopGraceSeconds: resolved.stopGraceSeconds,
+			networkAttach: [{
+				name: opts.network,
+				aliases: [opts.alias]
+			}]
+		},
+		mapError: (cause) => postgresPluginError("container-start", `failed to start postgres sidecar container '${opts.role}'`, cause)
+	});
+	const exec = containerExec(runtime, containerHandle);
+	yield* awaitReady(exec, resolved.user, opts.database, resolved.readyTimeoutMs);
+	yield* ensureDatabases(exec, resolved.user, resolved.databases);
+	const endpoint = credentialedUrl({
+		user: resolved.user,
+		password: resolved.password,
+		host: containerName,
+		port: POSTGRES_PORT
+	});
+	return {
+		handle: {
+			name: resolved.name,
+			user: resolved.user,
+			password: resolved.password,
+			host: containerName,
+			port: POSTGRES_PORT,
+			databases: resolved.databases,
+			endpoint,
+			plainEndpoint: plainUrl(containerName, POSTGRES_PORT),
+			url: (db) => withDatabase(endpoint, db),
+			containerNetwork: opts.network,
+			networkAlias: opts.alias
+		},
+		containerHandle
+	};
+});
+//#endregion
+export { bootPostgresSidecar, deriveSidecarPassword };
+
+//# sourceMappingURL=service.mjs.map

package/dist/plugins/internal/postgres-sidecar/service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../../src/plugins/internal/postgres-sidecar/service.ts"],"sourcesContent":["// Internal Postgres sidecar for built-in plugins.\n//\n// This is not a public `postgres()` factory. It exists so the Sui local\n// validator can own its GraphQL indexer database as a sidecar while snapshotting\n// the database under Sui's own `(plugin, role)` label tuple.\n\nimport { Effect, type Scope } from 'effect';\nimport { createHash } from 'node:crypto';\nimport { fileURLToPath } from 'node:url';\n\nimport type { ContainerHandle, ContainerRuntime } from '../../../contracts/container-runtime.ts';\nimport type { Identity } from '../../../substrate/identity.ts';\nimport {\n\tensureManagedContainer,\n\tsanitizeAlias,\n} from '../../../substrate/runtime/managed-container.ts';\n\nimport {\n\tcredentialedUrl,\n\tplainUrl,\n\twithDatabase,\n\ttype PostgresConnectionParts,\n} from './connection.ts';\nimport { awaitReady, ensureDatabases, type ContainerExec } from './db-ensure.ts';\nimport {\n\tpostgresPluginError,\n\tpostgresConfigError,\n\ttype DatabaseCreateFailed,\n\ttype PostgresConfigError,\n\ttype PostgresConnectionTimeout,\n\ttype PostgresPluginError,\n} from './errors.ts';\n\nexport interface PostgresSidecar {\n\treadonly name: string;\n\treadonly user: string;\n\treadonly password: string;\n\treadonly host: string;\n\treadonly port: number;\n\treadonly databases: ReadonlyArray<string>;\n\treadonly endpoint: string;\n\treadonly plainEndpoint: string;\n\treadonly url: (db: string) => string;\n\treadonly containerNetwork: string;\n\treadonly networkAlias: string;\n}\n\ninterface ResolvedPostgresSidecarOptions {\n\treadonly name: string;\n\treadonly version: string;\n\treadonly user: string;\n\treadonly password: string;\n\treadonly databases: ReadonlyArray<string>;\n\treadonly readyTimeoutMs: number;\n\treadonly stopGraceSeconds: number;\n}\n\nconst DEFAULT_VERSION = '17-alpine';\nconst DEFAULT_USER = 'devstack';\nconst DEFAULT_READY_TIMEOUT_MS = 30_000;\nconst DEFAULT_STOP_GRACE_SECONDS = 20;\nconst POSTGRES_PORT = 5432;\n\n/** Sidecar password — derived from `(app, stack, role)`, deliberately without\n *  `stackRoot`. The sidecar's PGDATA rides the owning plugin's snapshots and\n *  restored image layers, so the password must remain stable across runtime\n *  roots for the same stack. */\nexport const deriveSidecarPassword = (app: string, stack: string, role: string): string => {\n\tconst body = (app + stack + role).replace(/[^a-zA-Z0-9]/g, '');\n\tconst fingerprint = createHash('sha256')\n\t\t.update(`${app}\\x1f${stack}\\x1f${role}`)\n\t\t.digest('hex')\n\t\t.slice(0, 8);\n\treturn `pg-${body}-${fingerprint}`;\n};\n\nconst resolveSidecarOptions = (\n\tidentity: Identity,\n\topts: {\n\t\treadonly role: string;\n\t\treadonly database: string;\n\t\treadonly version?: string;\n\t\treadonly readyTimeoutMs?: number;\n\t\treadonly stopGraceSeconds?: number;\n\t},\n): ResolvedPostgresSidecarOptions => {\n\tif (opts.database.length === 0) {\n\t\tthrow postgresConfigError({\n\t\t\tfield: 'database',\n\t\t\tmessage: 'postgres sidecar: `database` must be non-empty',\n\t\t});\n\t}\n\n\treturn {\n\t\tname: opts.role,\n\t\tversion: opts.version ?? DEFAULT_VERSION,\n\t\tuser: DEFAULT_USER,\n\t\tpassword: deriveSidecarPassword(identity.app, identity.stack, opts.role),\n\t\tdatabases: [opts.database],\n\t\treadyTimeoutMs: opts.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS,\n\t\tstopGraceSeconds: opts.stopGraceSeconds ?? DEFAULT_STOP_GRACE_SECONDS,\n\t};\n};\n\nconst resolveImageContextPath = (): string => {\n\tconst here = new URL(import.meta.url);\n\tconst ctxUrl = new URL('../../../../images/postgres/', here);\n\treturn fileURLToPath(ctxUrl);\n};\n\nconst containerExec = (runtime: ContainerRuntime, handle: ContainerHandle): ContainerExec => ({\n\trun: (argv) =>\n\t\truntime\n\t\t\t.exec(handle, argv)\n\t\t\t.pipe(\n\t\t\t\tEffect.catch((err) =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\tpostgresPluginError(\n\t\t\t\t\t\t\t'container-start',\n\t\t\t\t\t\t\t`runtime.exec failed: ${err.reason} — ${err.detail}`,\n\t\t\t\t\t\t\terr,\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t),\n});\n\n/** Boot a Postgres container owned by a sibling plugin. The container labels\n *  are stamped as `{ plugin: 'sui', role }` so Sui snapshot capture owns the\n *  database state; callers still share the internal Postgres image build. */\nexport const bootPostgresSidecar = (\n\truntime: ContainerRuntime,\n\tidentity: Identity,\n\topts: {\n\t\treadonly network: string;\n\t\treadonly alias: string;\n\t\treadonly role: string;\n\t\treadonly database: string;\n\t\treadonly version?: string;\n\t\treadonly readyTimeoutMs?: number;\n\t\treadonly stopGraceSeconds?: number;\n\t\t/** Opaque caller-owned fingerprint stamped as `devstack.config-hash`.\n\t\t *  With `recreate: 'on-config-change'`, a mismatch recreates the\n\t\t *  mount-less sidecar with an empty DB while a match resumes rows. */\n\t\treadonly configHash?: string;\n\t},\n): Effect.Effect<\n\t{ readonly handle: PostgresSidecar; readonly containerHandle: ContainerHandle },\n\tPostgresPluginError | PostgresConfigError | PostgresConnectionTimeout | DatabaseCreateFailed,\n\tScope.Scope\n> =>\n\tEffect.gen(function* () {\n\t\tconst resolved = yield* Effect.try({\n\t\t\ttry: () => resolveSidecarOptions(identity, opts),\n\t\t\tcatch: (cause) => cause as PostgresConfigError,\n\t\t});\n\n\t\tyield* runtime\n\t\t\t.ensureNetwork({ name: opts.network, app: identity.app, stack: identity.stack })\n\t\t\t.pipe(\n\t\t\t\tEffect.catch((cause) =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\tpostgresPluginError(\n\t\t\t\t\t\t\t'network-create',\n\t\t\t\t\t\t\t`failed to ensure postgres sidecar network '${opts.network}'`,\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t);\n\n\t\tconst imageRef = yield* runtime\n\t\t\t.ensureImage({\n\t\t\t\tcontextPath: resolveImageContextPath(),\n\t\t\t\tdockerfile: 'Dockerfile',\n\t\t\t\tbuildArgs: { POSTGRES_VERSION: resolved.version },\n\t\t\t\towner: { app: identity.app, stack: identity.stack, plugin: 'postgres', role: 'db' },\n\t\t\t})\n\t\t\t.pipe(\n\t\t\t\tEffect.catch((cause) =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\tpostgresPluginError(\n\t\t\t\t\t\t\t'image-build',\n\t\t\t\t\t\t\t`failed to build postgres sidecar image (${resolved.version})`,\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t);\n\n\t\tconst containerName = sanitizeAlias(`${identity.app}-${identity.stack}-${opts.role}`);\n\t\tconst containerHandle = yield* ensureManagedContainer({\n\t\t\truntime,\n\t\t\tlabels: { app: identity.app, stack: identity.stack, plugin: 'sui', role: opts.role },\n\t\t\tspec: {\n\t\t\t\tname: containerName,\n\t\t\t\timage: imageRef,\n\t\t\t\trecreate: 'on-config-change',\n\t\t\t\t...(opts.configHash !== undefined ? { configHash: opts.configHash } : {}),\n\t\t\t\tenv: {\n\t\t\t\t\tPOSTGRES_USER: resolved.user,\n\t\t\t\t\tPOSTGRES_PASSWORD: resolved.password,\n\t\t\t\t\tPOSTGRES_DB: opts.database,\n\t\t\t\t},\n\t\t\t\tstopGraceSeconds: resolved.stopGraceSeconds,\n\t\t\t\tnetworkAttach: [{ name: opts.network, aliases: [opts.alias] }],\n\t\t\t},\n\t\t\tmapError: (cause) =>\n\t\t\t\tpostgresPluginError(\n\t\t\t\t\t'container-start',\n\t\t\t\t\t`failed to start postgres sidecar container '${opts.role}'`,\n\t\t\t\t\tcause,\n\t\t\t\t),\n\t\t});\n\n\t\tconst exec = containerExec(runtime, containerHandle);\n\t\tyield* awaitReady(exec, resolved.user, opts.database, resolved.readyTimeoutMs);\n\t\tyield* ensureDatabases(exec, resolved.user, resolved.databases);\n\n\t\tconst parts: PostgresConnectionParts = {\n\t\t\tuser: resolved.user,\n\t\t\tpassword: resolved.password,\n\t\t\thost: containerName,\n\t\t\tport: POSTGRES_PORT,\n\t\t};\n\t\tconst endpoint = credentialedUrl(parts);\n\t\tconst handle: PostgresSidecar = {\n\t\t\tname: resolved.name,\n\t\t\tuser: resolved.user,\n\t\t\tpassword: resolved.password,\n\t\t\thost: containerName,\n\t\t\tport: POSTGRES_PORT,\n\t\t\tdatabases: resolved.databases,\n\t\t\tendpoint,\n\t\t\tplainEndpoint: plainUrl(containerName, POSTGRES_PORT),\n\t\t\turl: (db) => withDatabase(endpoint, db),\n\t\t\tcontainerNetwork: opts.network,\n\t\t\tnetworkAlias: opts.alias,\n\t\t};\n\n\t\treturn { handle, containerHandle };\n\t});\n"],"mappings":"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"}

package/dist/plugins/package/build.mjs

@@ -1,4 +1,5 @@
-import { hashMoveSources as hashMoveSources$1, runMoveBuild as runMoveBuild$1, scrubLocksHost as scrubLocksHost$1 } from "../../substrate/runtime/sui-move-build/index.mjs";
+import { hashMoveSources as hashMoveSources$1, runMoveBuild as runMoveBuild$1, scrubLocksHost as scrubLocksHost$1 } from "../sui/move/index.mjs";
+import "../sui/index.mjs";
 import { publishError } from "./errors.mjs";
 import { Effect } from "effect";
 //#region src/plugins/package/build.ts
@@ -13,7 +14,6 @@ const scrubLocksHost = (sourcePath, moveHomeRoot) => scrubLocksHost$1(sourcePath
 const runMoveBuild = (inputs) => runMoveBuild$1({
 	sourcePath: inputs.sourcePath,
 	packageName: inputs.packageName,
-	chainId: inputs.chainId,
 	...inputs.buildContainer !== void 0 ? { buildContainer: inputs.buildContainer } : {},
 	...inputs.runtime !== void 0 ? { runtime: inputs.runtime } : {},
 	...inputs.buildImage !== void 0 ? { buildImage: inputs.buildImage } : {}

package/dist/plugins/package/build.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.mjs","names":["hashMoveSourcesNeutral","scrubLocksHostNeutral","runMoveBuildNeutral"],"sources":["../../../src/plugins/package/build.ts"],"sourcesContent":["// Package plugin bridge for shared Sui Move build helpers.\n\nimport { Effect, type Scope } from 'effect';\n\nimport type { ContainerRuntime, ImageRef } from '../../contracts/container-runtime.ts';\nimport type { ChainId, ContentHash } from '../../substrate/brand.ts';\nimport {\n\thashMoveSources as hashMoveSourcesNeutral,\n\trunMoveBuild as runMoveBuildNeutral,\n\tscrubLocksHost as scrubLocksHostNeutral,\n\ttype BuildOutput,\n\ttype MoveBuildError,\n\ttype MoveBuildContainer,\n} from '../../substrate/runtime/sui-move-build/index.ts';\nimport type { ChainBuildContainer } from '../sui/index.ts';\nimport { publishError, type PublishError } from './errors.ts';\n\nexport {\n\tcontainerInnerScript,\n\textractTrailingJson,\n\tparseBuildOutput,\n\tstripPinnedSections,\n\ttype MoveBuildContainer,\n\ttype MoveBuildError,\n\ttype MoveBuildPhase,\n\ttype MoveBuildInput,\n\ttype MoveBuildOutput,\n} from '../../substrate/runtime/sui-move-build/index.ts';\nexport type { BuildOutput };\n\nexport interface BuildInputs {\n\treadonly sourcePath: string;\n\treadonly packageName: string;\n\treadonly chainId: ChainId;\n\treadonly buildContainer?: ChainBuildContainer;\n\treadonly runtime?: ContainerRuntime;\n\treadonly buildImage?: ImageRef;\n}\n\nconst toPublishError = (err: MoveBuildError): PublishError =>\n\tpublishError(err.phase, {\n\t\tsourcePath: err.sourcePath,\n\t\tpackageName: err.packageName,\n\t\tmessage: err.message,\n\t\t...(err.cause !== undefined ? { cause: err.cause } : { cause: err }),\n\t});\n\nexport const hashMoveSources = (sourcePath: string): Effect.Effect<ContentHash, PublishError> =>\n\thashMoveSourcesNeutral(sourcePath).pipe(Effect.mapError(toPublishError));\n\nexport const scrubLocksHost = (\n\tsourcePath: string,\n\tmoveHomeRoot: string,\n): Effect.Effect<void, PublishError, Scope.Scope> =>\n\tscrubLocksHostNeutral(sourcePath, moveHomeRoot).pipe(Effect.mapError(toPublishError));\n\nexport const runMoveBuild = (\n\tinputs: BuildInputs,\n): Effect.Effect<BuildOutput, PublishError, Scope.Scope> =>\n\trunMoveBuildNeutral({\n\t\tsourcePath: inputs.sourcePath,\n\t\tpackageName: inputs.packageName,\n\t\tchainId: inputs.chainId,\n\t\t...(inputs.buildContainer !== undefined\n\t\t\t? { buildContainer: inputs.buildContainer satisfies MoveBuildContainer }\n\t\t\t: {}),\n\t\t...(inputs.runtime !== undefined ? { runtime: inputs.runtime } : {}),\n\t\t...(inputs.buildImage !== undefined ? { buildImage: inputs.buildImage } : {}),\n\t}).pipe(Effect.mapError(toPublishError));\n"],"mappings":";;;;AAuCA,MAAM,kBAAkB,QACvB,aAAa,IAAI,OAAO;CACvB,YAAY,IAAI;CAChB,aAAa,IAAI;CACjB,SAAS,IAAI;CACb,GAAI,IAAI,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK;CACnE,CAAC;AAEH,MAAa,mBAAmB,eAC/BA,kBAAuB,WAAW,CAAC,KAAK,OAAO,SAAS,eAAe,CAAC;AAEzE,MAAa,kBACZ,YACA,iBAEAC,iBAAsB,YAAY,aAAa,CAAC,KAAK,OAAO,SAAS,eAAe,CAAC;AAEtF,MAAa,gBACZ,WAEAC,eAAoB;CACnB,YAAY,OAAO;CACnB,aAAa,OAAO;CACpB,SAAS,OAAO;CAChB,GAAI,OAAO,mBAAmB,KAAA,IAC3B,EAAE,gBAAgB,OAAO,gBAA6C,GACtE,EAAE;CACL,GAAI,OAAO,YAAY,KAAA,IAAY,EAAE,SAAS,OAAO,SAAS,GAAG,EAAE;CACnE,GAAI,OAAO,eAAe,KAAA,IAAY,EAAE,YAAY,OAAO,YAAY,GAAG,EAAE;CAC5E,CAAC,CAAC,KAAK,OAAO,SAAS,eAAe,CAAC"}
+{"version":3,"file":"build.mjs","names":["hashMoveSourcesNeutral","scrubLocksHostNeutral","runMoveBuildNeutral"],"sources":["../../../src/plugins/package/build.ts"],"sourcesContent":["// Package plugin bridge for shared Sui Move build helpers.\n\nimport { Effect, type Scope } from 'effect';\n\nimport type { ContainerRuntime, ImageRef } from '../../contracts/container-runtime.ts';\nimport type { ContentHash } from '../../substrate/brand.ts';\nimport {\n\thashMoveSources as hashMoveSourcesNeutral,\n\trunMoveBuild as runMoveBuildNeutral,\n\tscrubLocksHost as scrubLocksHostNeutral,\n\twithMoveBuildLock,\n\ttype BuildOutput,\n\ttype MoveBuildError,\n\ttype MoveBuildContainer,\n\ttype ChainBuildContainer,\n} from '../sui/index.ts';\nimport { publishError, type PublishError } from './errors.ts';\n\nexport type { BuildOutput };\n\n// Re-exported verbatim: the lock is generic over the wrapped effect's channels,\n// so the package plugin uses the same process-wide Move-build permit as seal.\nexport { withMoveBuildLock };\n\nexport interface BuildInputs {\n\treadonly sourcePath: string;\n\treadonly packageName: string;\n\treadonly chainId: string;\n\treadonly buildContainer?: ChainBuildContainer;\n\treadonly runtime?: ContainerRuntime;\n\treadonly buildImage?: ImageRef;\n}\n\nconst toPublishError = (err: MoveBuildError): PublishError =>\n\tpublishError(err.phase, {\n\t\tsourcePath: err.sourcePath,\n\t\tpackageName: err.packageName,\n\t\tmessage: err.message,\n\t\t...(err.cause !== undefined ? { cause: err.cause } : { cause: err }),\n\t});\n\nexport const hashMoveSources = (sourcePath: string): Effect.Effect<ContentHash, PublishError> =>\n\thashMoveSourcesNeutral(sourcePath).pipe(Effect.mapError(toPublishError));\n\nexport const scrubLocksHost = (\n\tsourcePath: string,\n\tmoveHomeRoot: string,\n): Effect.Effect<void, PublishError, Scope.Scope> =>\n\tscrubLocksHostNeutral(sourcePath, moveHomeRoot).pipe(Effect.mapError(toPublishError));\n\nexport const runMoveBuild = (\n\tinputs: BuildInputs,\n): Effect.Effect<BuildOutput, PublishError, Scope.Scope> =>\n\trunMoveBuildNeutral({\n\t\tsourcePath: inputs.sourcePath,\n\t\tpackageName: inputs.packageName,\n\t\t...(inputs.buildContainer !== undefined\n\t\t\t? { buildContainer: inputs.buildContainer satisfies MoveBuildContainer }\n\t\t\t: {}),\n\t\t...(inputs.runtime !== undefined ? { runtime: inputs.runtime } : {}),\n\t\t...(inputs.buildImage !== undefined ? { buildImage: inputs.buildImage } : {}),\n\t}).pipe(Effect.mapError(toPublishError));\n"],"mappings":";;;;;AAiCA,MAAM,kBAAkB,QACvB,aAAa,IAAI,OAAO;CACvB,YAAY,IAAI;CAChB,aAAa,IAAI;CACjB,SAAS,IAAI;CACb,GAAI,IAAI,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI,MAAM,IAAI,EAAE,OAAO,IAAI;AACnE,CAAC;AAEF,MAAa,mBAAmB,eAC/BA,kBAAuB,UAAU,CAAC,CAAC,KAAK,OAAO,SAAS,cAAc,CAAC;AAExE,MAAa,kBACZ,YACA,iBAEAC,iBAAsB,YAAY,YAAY,CAAC,CAAC,KAAK,OAAO,SAAS,cAAc,CAAC;AAErF,MAAa,gBACZ,WAEAC,eAAoB;CACnB,YAAY,OAAO;CACnB,aAAa,OAAO;CACpB,GAAI,OAAO,mBAAmB,KAAA,IAC3B,EAAE,gBAAgB,OAAO,eAA4C,IACrE,CAAC;CACJ,GAAI,OAAO,YAAY,KAAA,IAAY,EAAE,SAAS,OAAO,QAAQ,IAAI,CAAC;CAClE,GAAI,OAAO,eAAe,KAAA,IAAY,EAAE,YAAY,OAAO,WAAW,IAAI,CAAC;AAC5E,CAAC,CAAC,CAAC,KAAK,OAAO,SAAS,cAAc,CAAC"}

package/dist/plugins/package/codegen.d.mts

@@ -1,19 +1,12 @@
+import { PackageBindings } from "../../orchestrators/codegen/bindings.mjs";
 //#region src/plugins/package/codegen.d.ts
-/** Codegenable shape — what each Package contributes to the codegen
- *  orchestrator. Two variants mirror the local/known split. */
-interface PackageBindings {
-  readonly name: string;
+/** Per-network declared ids — pure literals the user supplies for
+ *  prod-targeting (`testnet`/`mainnet`). No resolution. */
+interface PackageNetworkEntry {
   readonly packageId: string;
-  readonly mvrPlaceholder: string;
-  /** Present for local packages only — the bindings emitter reads
-   *  this; KnownPackages omit it and the orchestrator skips them
-   *  for bindings emission (compile-time enforcement at the
-   *  factory layer per distilled doc Invariant 9). */
-  readonly sourcePath: string | null;
-  /** Per-package opt-out (distilled doc §Inputs — "Codegen
-   *  exclusion flag"). */
-  readonly excluded: boolean;
+  readonly objects?: Readonly<Record<string, string>>;
 }
+type PackageNetworks = Readonly<Record<string, PackageNetworkEntry>>;
 //#endregion
-export { PackageBindings };
+export { PackageNetworkEntry, PackageNetworks };
 //# sourceMappingURL=codegen.d.mts.map

package/dist/plugins/package/codegen.mjs

@@ -1,67 +1,195 @@
-import { Effect } from "effect";
+import { LOCAL_NETWORK_NAME } from "../../api/inference-network.mjs";
+import { configCodegenable } from "../../contracts/config-bindings.mjs";
+import { mvrNamedForm, mvrNamedFormFrom } from "./dep-resolution.mjs";
 //#region src/plugins/package/codegen.ts
-/** Type guard for the `packageBindings` shape emitted into the
-*  CodegenEmitContext below. Lives in the plugin so the codegen
-*  orchestrator never has to recognize the shape — it only calls
-*  the projector. */
-const isPackageBindings = (v) => typeof v === "object" && v !== null && "name" in v && "packageId" in v && "mvrPlaceholder" in v && "sourcePath" in v;
-/** Aggregate projection: extract the `packageBindings` shape and key
-*  it by the package name into the cross-plugin `packages.ts`
-*  aggregate. The orchestrator stays name-blind; this projector
-*  owns the `packages.<name>` → `PackageBindings` mapping. */
-const projectPackageBindings = (exported) => {
-	const bindings = exported["packageBindings"];
-	if (!isPackageBindings(bindings)) return null;
-	return { [bindings.name]: bindings };
-};
-/** Build the Codegenable contribution for a local package. */
-const makeLocalCodegenable = (resolved, options) => ({
-	kind: "codegenable",
-	emitterName: "package",
-	outputPath: `package/${resolved.mvrPlaceholder}.ts`,
-	allowEmitterNameRepetition: true,
-	aggregate: {
-		kind: "package",
-		bucket: "packages.ts",
-		project: projectPackageBindings
-	},
-	emit: (ctx) => Effect.sync(() => {
-		ctx.exportConst("packageBindings", {
-			name: resolved.name,
-			packageId: resolved.packageId,
-			mvrPlaceholder: resolved.mvrPlaceholder,
-			sourcePath: resolved.sourcePath,
-			excluded: options.excluded
-		});
-		return ctx.done();
-	})
-});
-/** Build the Codegenable contribution for a known package. The
-*  shape is identical except `sourcePath: null`. The codegen
-*  orchestrator filters these out before invoking the bindings
-*  emitter. */
-const makeKnownCodegenable = (resolved) => ({
-	kind: "codegenable",
-	emitterName: "package",
-	outputPath: `package/${resolved.mvrPlaceholder}.ts`,
-	allowEmitterNameRepetition: true,
-	aggregate: {
+/**
+* Build the package's config-binding set, declared ONCE. The `name` keys the
+* `config.packages.<name>` entry; `mvrPlaceholder` is a literal in both paths;
+* the active-network id is a RESOLVED binding (sugar `resolveId('<mvr>')` when
+* `resolveViaRuntime`, otherwise a literal already-known id). Declared
+* per-network literals (testnet/mainnet) and captured objects are literals.
+*
+* The same set drives `projectStaticConfig` (committed tree) and
+* `projectLiveConfig` (boot id-config) — no parallel projectors.
+*/
+const packageConfigBindings = (input) => {
+	const { name, mvrPlaceholder } = input;
+	const bindings = [];
+	bindings.push({
+		variant: "literal",
+		configPath: [
+			"packages",
+			name,
+			"mvr"
+		],
+		value: mvrPlaceholder
+	});
+	const pinned = input.pinnedId;
+	const idBinding = (configPath) => pinned === void 0 ? {
+		variant: "resolved",
+		configPath,
+		namespace: "package",
+		key: `${name}:packageId`,
+		sugar: {
+			kind: "id",
+			mvrPlaceholder
+		},
+		live: (state) => state.packageId
+	} : {
+		variant: "literal",
+		configPath,
+		value: pinned
+	};
+	bindings.push(idBinding([
+		"packages",
+		name,
+		"packageId"
+	]));
+	bindings.push(idBinding([
+		"packages",
+		name,
+		"byNetwork",
+		LOCAL_NETWORK_NAME
+	]));
+	for (const [net, entry] of Object.entries(input.networks ?? {})) bindings.push({
+		variant: "literal",
+		configPath: [
+			"packages",
+			name,
+			"byNetwork",
+			net
+		],
+		value: entry.packageId
+	});
+	const objectKeys = input.objectKeys ?? Object.keys(input.captured);
+	if (objectKeys.length > 0) {
+		const objectsNamespace = `package:${name}:objects`;
+		for (const objectKey of objectKeys) {
+			const objectBinding = (configPath) => ({
+				variant: "resolved",
+				configPath,
+				namespace: objectsNamespace,
+				key: objectKey,
+				live: (state) => state.captured[objectKey] ?? null
+			});
+			bindings.push(objectBinding([
+				"packages",
+				name,
+				"objects",
+				objectKey
+			]));
+			bindings.push(objectBinding([
+				"objects",
+				name,
+				objectKey
+			]));
+		}
+	}
+	if (pinned === void 0 || pinned.length > 0) bindings.push(idBinding(["mvrOverrides", mvrPlaceholder]));
+	return {
+		bucket: "config.ts",
 		kind: "package",
-		bucket: "packages.ts",
-		project: projectPackageBindings
-	},
-	emit: (ctx) => Effect.sync(() => {
-		ctx.exportConst("packageBindings", {
-			name: resolved.name,
+		emitterName: "package",
+		allowEmitterNameRepetition: true,
+		bindings
+	};
+};
+/**
+* Build the package's `CodegenableDecl` from its binding set via the unified
+* `configCodegenable` derivation. Mode `'live'` bakes concrete values + feeds
+* the id-config; `'static'` emits resolver expressions. The decl ALSO exports
+* `packageBindings` (the `extraExports` hook) so the orchestrator's
+* `isPackageBindings` seam forwards it to the Move-bindings emitter (bindings
+* stay in `generated/bindings/`).
+*/
+const packageDecl = (set, bindings, how) => configCodegenable(set, how, { extraExports: { packageBindings: bindings } });
+/** Build the Codegenable contribution for a local package (LIVE path).
+*  Bakes the resolved active-network id + captured objects. */
+const makeLocalCodegenable = (resolved, options) => {
+	const mvrPlaceholder = mvrNamedFormFrom(resolved.mvrPlaceholder);
+	return packageDecl(packageConfigBindings({
+		name: resolved.name,
+		mvrPlaceholder,
+		captured: resolved.captured,
+		...options.networks !== void 0 ? { networks: options.networks } : {}
+	}), {
+		name: resolved.name,
+		packageId: resolved.packageId,
+		mvrPlaceholder,
+		sourcePath: resolved.sourcePath,
+		excluded: options.excluded
+	}, {
+		mode: "live",
+		state: {
 			packageId: resolved.packageId,
-			mvrPlaceholder: resolved.mvrPlaceholder,
+			captured: resolved.captured
+		}
+	});
+};
+/** Build the Codegenable contribution for a known package — `sourcePath:
+*  null`, no captured object ids. A KNOWN package's declared id is a PINNED
+*  LITERAL (not loaded runtime data), so it renders identically in both the
+*  live and static paths. */
+const makeKnownCodegenable = (resolved, options = {}) => {
+	const mvrPlaceholder = mvrNamedFormFrom(resolved.mvrPlaceholder);
+	return packageDecl(packageConfigBindings({
+		name: resolved.name,
+		mvrPlaceholder,
+		captured: {},
+		pinnedId: resolved.packageId,
+		...options.networks !== void 0 ? { networks: options.networks } : {}
+	}), {
+		name: resolved.name,
+		packageId: resolved.packageId,
+		mvrPlaceholder,
+		sourcePath: null,
+		excluded: true
+	}, "static");
+};
+/** Build the static (stack-free) codegen source for a LOCAL package.
+*  `sourcePath` is the resolved on-disk Move tree the bindings emitter
+*  compiles (a local `sourcePath`; a git source whose tree has not been
+*  materialized contributes `null`, so the bindings step skips it). */
+const makeLocalStaticCodegen = (config) => {
+	const mvrPlaceholder = mvrNamedForm(config.mvrPlaceholder ?? config.name);
+	return () => {
+		return [packageDecl(packageConfigBindings({
+			name: config.name,
+			mvrPlaceholder,
+			captured: {},
+			...config.objectKeys !== void 0 ? { objectKeys: config.objectKeys } : {},
+			...config.networks !== void 0 ? { networks: config.networks } : {}
+		}), {
+			name: config.name,
+			packageId: "",
+			mvrPlaceholder,
+			sourcePath: config.sourcePath,
+			excluded: config.sourcePath === null ? true : config.excluded
+		}, "static")];
+	};
+};
+/** Build the static (stack-free) codegen source for a KNOWN package. Known
+*  packages already carry a literal `packageId` in config; the committed stub
+*  emits it verbatim. */
+const makeKnownStaticCodegen = (config) => {
+	const mvrPlaceholder = mvrNamedForm(config.mvrPlaceholder ?? config.name);
+	return () => {
+		return [packageDecl(packageConfigBindings({
+			name: config.name,
+			mvrPlaceholder,
+			captured: {},
+			pinnedId: config.packageId,
+			...config.networks !== void 0 ? { networks: config.networks } : {}
+		}), {
+			name: config.name,
+			packageId: config.packageId,
+			mvrPlaceholder,
 			sourcePath: null,
 			excluded: true
-		});
-		return ctx.done();
-	})
-});
+		}, "static")];
+	};
+};
 //#endregion
-export { makeKnownCodegenable, makeLocalCodegenable };
+export { makeKnownCodegenable, makeKnownStaticCodegen, makeLocalCodegenable, makeLocalStaticCodegen };
 
 //# sourceMappingURL=codegen.mjs.map

package/dist/plugins/package/codegen.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.mjs","names":[],"sources":["../../../src/plugins/package/codegen.ts"],"sourcesContent":["// Package plugin — Codegenable contribution.\n//\n// Distilled doc §Outputs: \"Bindings input — the source path of every\n// local Package is read by the bindings emitter (KnownPackages\n// filtered out).\"\n//\n// The contribution emitted here is the LIGHTWEIGHT one: package id +\n// MVR placeholder + (for local packages) the source path the\n// bindings emitter consumes. The HEAVY codegen — `@mysten/codegen`\n// emitting typed function shims — happens in the codegen\n// ORCHESTRATOR (plugin/codegen layer, NOT this plugin). The\n// orchestrator walks every member's caps tuple, finds the\n// Package-emitted contributions, and dispatches `@mysten/codegen`\n// once across all of them so a single TS program references every\n// emitted package binding.\n//\n// This file therefore declares the SEAM, not the binding bytes.\n// Distilled doc §Cross-component references §codegen: package\n// \"consumes local Package source paths to emit bindings; respects\n// the per-package codegen-exclude flag; uses MVR placeholders so\n// emitted code stays portable.\"\n\nimport { Effect } from 'effect';\n\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { ResolvedLocalPackage, ResolvedKnownPackage } from './registry.ts';\n\n/** Codegenable shape — what each Package contributes to the codegen\n *  orchestrator. Two variants mirror the local/known split. */\nexport interface PackageBindings {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly mvrPlaceholder: string;\n\t/** Present for local packages only — the bindings emitter reads\n\t *  this; KnownPackages omit it and the orchestrator skips them\n\t *  for bindings emission (compile-time enforcement at the\n\t *  factory layer per distilled doc Invariant 9). */\n\treadonly sourcePath: string | null;\n\t/** Per-package opt-out (distilled doc §Inputs — \"Codegen\n\t *  exclusion flag\"). */\n\treadonly excluded: boolean;\n}\n\n/** Type guard for the `packageBindings` shape emitted into the\n *  CodegenEmitContext below. Lives in the plugin so the codegen\n *  orchestrator never has to recognize the shape — it only calls\n *  the projector. */\nexport const isPackageBindings = (v: unknown): v is PackageBindings =>\n\ttypeof v === 'object' &&\n\tv !== null &&\n\t'name' in v &&\n\t'packageId' in v &&\n\t'mvrPlaceholder' in v &&\n\t'sourcePath' in v;\n\n/** Aggregate projection: extract the `packageBindings` shape and key\n *  it by the package name into the cross-plugin `packages.ts`\n *  aggregate. The orchestrator stays name-blind; this projector\n *  owns the `packages.<name>` → `PackageBindings` mapping. */\nconst projectPackageBindings = (\n\texported: Readonly<Record<string, unknown>>,\n): Readonly<Record<string, unknown>> | null => {\n\tconst bindings = exported['packageBindings'];\n\tif (!isPackageBindings(bindings)) return null;\n\treturn { [bindings.name]: bindings };\n};\n\n/** Build the Codegenable contribution for a local package. */\nexport const makeLocalCodegenable = (\n\tresolved: ResolvedLocalPackage,\n\toptions: { readonly excluded: boolean },\n): CodegenableDecl<'package'> => ({\n\tkind: 'codegenable',\n\temitterName: 'package',\n\toutputPath: `package/${resolved.mvrPlaceholder}.ts`,\n\t// One Package contribution per published package. The shared\n\t// `'package'` emitter name is by-design — the codegen orchestrator\n\t// skips its emitter-name uniqueness check for this flag.\n\tallowEmitterNameRepetition: true,\n\taggregate: {\n\t\tkind: 'package',\n\t\tbucket: 'packages.ts',\n\t\tproject: projectPackageBindings,\n\t},\n\temit: (ctx) =>\n\t\tEffect.sync(() => {\n\t\t\t// The orchestrator picks up these fields and threads them\n\t\t\t// into `@mysten/codegen` along with the source-path read.\n\t\t\t// The literal binding-file bytes are written by the\n\t\t\t// orchestrator, NOT this plugin.\n\t\t\tctx.exportConst('packageBindings', {\n\t\t\t\tname: resolved.name,\n\t\t\t\tpackageId: resolved.packageId,\n\t\t\t\tmvrPlaceholder: resolved.mvrPlaceholder,\n\t\t\t\tsourcePath: resolved.sourcePath,\n\t\t\t\texcluded: options.excluded,\n\t\t\t} satisfies PackageBindings);\n\t\t\treturn ctx.done();\n\t\t}),\n});\n\n/** Build the Codegenable contribution for a known package. The\n *  shape is identical except `sourcePath: null`. The codegen\n *  orchestrator filters these out before invoking the bindings\n *  emitter. */\nexport const makeKnownCodegenable = (\n\tresolved: ResolvedKnownPackage,\n): CodegenableDecl<'package'> => ({\n\tkind: 'codegenable',\n\temitterName: 'package',\n\toutputPath: `package/${resolved.mvrPlaceholder}.ts`,\n\t// Mirrors `makeLocalCodegenable` — one Package contribution per\n\t// known package.\n\tallowEmitterNameRepetition: true,\n\taggregate: {\n\t\tkind: 'package',\n\t\tbucket: 'packages.ts',\n\t\tproject: projectPackageBindings,\n\t},\n\temit: (ctx) =>\n\t\tEffect.sync(() => {\n\t\t\tctx.exportConst('packageBindings', {\n\t\t\t\tname: resolved.name,\n\t\t\t\tpackageId: resolved.packageId,\n\t\t\t\tmvrPlaceholder: resolved.mvrPlaceholder,\n\t\t\t\tsourcePath: null,\n\t\t\t\texcluded: true, // implicit — KnownPackages never emit bindings.\n\t\t\t} satisfies PackageBindings);\n\t\t\treturn ctx.done();\n\t\t}),\n});\n"],"mappings":";;;;;;AA+CA,MAAa,qBAAqB,MACjC,OAAO,MAAM,YACb,MAAM,QACN,UAAU,KACV,eAAe,KACf,oBAAoB,KACpB,gBAAgB;;;;;AAMjB,MAAM,0BACL,aAC8C;CAC9C,MAAM,WAAW,SAAS;AAC1B,KAAI,CAAC,kBAAkB,SAAS,CAAE,QAAO;AACzC,QAAO,GAAG,SAAS,OAAO,UAAU;;;AAIrC,MAAa,wBACZ,UACA,aACiC;CACjC,MAAM;CACN,aAAa;CACb,YAAY,WAAW,SAAS,eAAe;CAI/C,4BAA4B;CAC5B,WAAW;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACT;CACD,OAAO,QACN,OAAO,WAAW;AAKjB,MAAI,YAAY,mBAAmB;GAClC,MAAM,SAAS;GACf,WAAW,SAAS;GACpB,gBAAgB,SAAS;GACzB,YAAY,SAAS;GACrB,UAAU,QAAQ;GAClB,CAA2B;AAC5B,SAAO,IAAI,MAAM;GAChB;CACH;;;;;AAMD,MAAa,wBACZ,cACiC;CACjC,MAAM;CACN,aAAa;CACb,YAAY,WAAW,SAAS,eAAe;CAG/C,4BAA4B;CAC5B,WAAW;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACT;CACD,OAAO,QACN,OAAO,WAAW;AACjB,MAAI,YAAY,mBAAmB;GAClC,MAAM,SAAS;GACf,WAAW,SAAS;GACpB,gBAAgB,SAAS;GACzB,YAAY;GACZ,UAAU;GACV,CAA2B;AAC5B,SAAO,IAAI,MAAM;GAChB;CACH"}
+{"version":3,"file":"codegen.mjs","names":[],"sources":["../../../src/plugins/package/codegen.ts"],"sourcesContent":["// Package plugin — Codegenable contribution, via the UNIFIED config-binding\n// declaration.\n//\n// Distilled doc §Outputs: \"Bindings input — the source path of every local\n// Package is read by the bindings emitter (KnownPackages filtered out).\"\n//\n// The contribution emitted here is the LIGHTWEIGHT one: package id + MVR\n// placeholder + (for local packages) the source path the bindings emitter\n// consumes. The HEAVY codegen — `@mysten/codegen` emitting typed function\n// shims — happens in the codegen ORCHESTRATOR (NOT this plugin). This file\n// declares the SEAM, not the binding bytes.\n//\n// ONE declaration, TWO derivations. A package declares its `config.ts`\n// contributions ONCE as a `ConfigBindingSet`; the framework's\n// `projectLiveConfig` / `projectStaticConfig` derive both behaviors:\n//   - LIVE (boot): bakes the resolved package id literal — boot's\n//     `assembleIdConfig` reads it into the loadable id-config.\n//   - STATIC (committed-tree): emits `resolveId('<mvr>')` so the committed\n//     `config.ts` carries NO on-chain id (resolved at app build/dev time).\n//\n// The package contribution is `aggregateOnly`: it projects into the combined\n// `generated/config.ts` (`config.packages.<name>` + top-level\n// `config.objects.<name>`) and emits NO standalone `package/<name>.ts`. The\n// `packageBindings` value is still exported on the emit context so the\n// orchestrator's `isPackageBindings` seam forwards it to the Move-bindings\n// emitter (bindings stay in `generated/bindings/`).\n\nimport { LOCAL_NETWORK_NAME } from '../../api/inference-network.ts';\nimport type { CodegenableDecl, StaticCodegenSource } from '../../contracts/codegenable.ts';\nimport {\n\tconfigCodegenable,\n\ttype ConfigBinding,\n\ttype ConfigBindingSet,\n} from '../../contracts/config-bindings.ts';\nimport type { PackageBindings } from '../../orchestrators/codegen/bindings.ts';\nimport type { JsonValue } from '../../orchestrators/codegen/id-config.ts';\nimport { mvrNamedForm, mvrNamedFormFrom } from './dep-resolution.ts';\nimport type { ResolvedLocalPackage, ResolvedKnownPackage } from './registry.ts';\n\n/** Per-network declared ids — pure literals the user supplies for\n *  prod-targeting (`testnet`/`mainnet`). No resolution. */\nexport interface PackageNetworkEntry {\n\treadonly packageId: string;\n\treadonly objects?: Readonly<Record<string, string>>;\n}\n\nexport type PackageNetworks = Readonly<Record<string, PackageNetworkEntry>>;\n\n/** Codegenable shape — what each Package contributes to the codegen\n *  orchestrator. Defined once on the orchestrator's `emitBindings` consumer\n *  contract (`orchestrators/codegen/bindings.ts`); re-exported here as the\n *  package plugin's public surface. */\nexport type { PackageBindings };\n\n/** The typed shape one `config.packages.<name>` entry exports. */\nexport interface PackageConfigEntry {\n\treadonly mvr: string;\n\t/** Convenience = `byNetwork[config.network]` (the active network's\n\t *  id). */\n\treadonly packageId: string;\n\treadonly byNetwork: Readonly<Record<string, string>>;\n\t/** Resolved (local) + declared (prod) object ids for the active\n\t *  network. Present only when at least one object is known. */\n\treadonly objects?: Readonly<Record<string, string>>;\n}\n\n/** The state the LIVE binding derivation reads — the resolved package's\n *  active-network id + captured object ids. */\ninterface PackageLiveState {\n\treadonly packageId: string;\n\treadonly captured: Readonly<Record<string, string>>;\n}\n\ninterface PackageBindingInput {\n\treadonly name: string;\n\treadonly mvrPlaceholder: string;\n\t/** Pinned literal id (KNOWN package with a declared id). When set, the\n\t *  active-network id is a LITERAL binding (identical in both paths). When\n\t *  absent (a LOCAL package, or a KNOWN-shaped local stub), the id is a\n\t *  RESOLVED binding: static emits `resolveId('<mvr>')`, live computes the\n\t *  real resolved id from acquired state. */\n\treadonly pinnedId?: string | undefined;\n\t/** Resolved local object captures (keyed by user `capture` name).\n\t *  Surfaced into `config.objects.<name>` + `packages.<name>.objects`\n\t *  for the active (local) network. Empty on the committed-stub path —\n\t *  the captured IDS are loaded config data (resolved at app build/dev\n\t *  time), so the static path emits `resolveValue` from `objectKeys`. */\n\treadonly captured: Readonly<Record<string, string>>;\n\t/** The capture KEYS this package declares (the user `capture` option's\n\t *  key set, known at config time). Drives the object-id bindings on BOTH\n\t *  paths so the committed stub carries `resolveValue('package:<name>:\n\t *  objects', '<key>')` references rather than a live-only `objects` field.\n\t *  When omitted, falls back to the keys present in `captured` (live path).\n\t */\n\treadonly objectKeys?: ReadonlyArray<string> | undefined;\n\t/** Declared per-network literals (testnet/mainnet). */\n\treadonly networks?: PackageNetworks | undefined;\n}\n\n/**\n * Build the package's config-binding set, declared ONCE. The `name` keys the\n * `config.packages.<name>` entry; `mvrPlaceholder` is a literal in both paths;\n * the active-network id is a RESOLVED binding (sugar `resolveId('<mvr>')` when\n * `resolveViaRuntime`, otherwise a literal already-known id). Declared\n * per-network literals (testnet/mainnet) and captured objects are literals.\n *\n * The same set drives `projectStaticConfig` (committed tree) and\n * `projectLiveConfig` (boot id-config) — no parallel projectors.\n */\nconst packageConfigBindings = (input: PackageBindingInput): ConfigBindingSet<PackageLiveState> => {\n\tconst { name, mvrPlaceholder } = input;\n\n\tconst bindings: Array<ConfigBinding<PackageLiveState>> = [];\n\n\t// `packages.<name>.mvr` — pure literal in both paths.\n\tbindings.push({\n\t\tvariant: 'literal',\n\t\tconfigPath: ['packages', name, 'mvr'],\n\t\tvalue: mvrPlaceholder,\n\t});\n\n\t// The active-network id binding. Two cases:\n\t//   - no pinned id (LOCAL, or KNOWN-shaped local stub) → RESOLVED (sugar\n\t//     `resolveId('<mvr>')` static; live = the concrete resolved id from\n\t//     `state.packageId`).\n\t//   - pinned literal (KNOWN with a declared id) → LITERAL (the id stands\n\t//     identically in both paths).\n\t// Reused for `packages.<name>.packageId`, `byNetwork.localnet`, and the\n\t// `mvrOverrides` entry so all three agree.\n\tconst pinned = input.pinnedId;\n\tconst idBinding = (configPath: ReadonlyArray<string>): ConfigBinding<PackageLiveState> =>\n\t\tpinned === undefined\n\t\t\t? {\n\t\t\t\t\tvariant: 'resolved',\n\t\t\t\t\tconfigPath,\n\t\t\t\t\tnamespace: 'package',\n\t\t\t\t\tkey: `${name}:packageId`,\n\t\t\t\t\tsugar: { kind: 'id', mvrPlaceholder },\n\t\t\t\t\tlive: (state) => state.packageId,\n\t\t\t\t}\n\t\t\t: { variant: 'literal', configPath, value: pinned };\n\n\tbindings.push(idBinding(['packages', name, 'packageId']));\n\tbindings.push(idBinding(['packages', name, 'byNetwork', LOCAL_NETWORK_NAME]));\n\n\t// Declared per-network literals (testnet/mainnet) — pure literals.\n\tfor (const [net, entry] of Object.entries(input.networks ?? {})) {\n\t\tbindings.push({\n\t\t\tvariant: 'literal',\n\t\t\tconfigPath: ['packages', name, 'byNetwork', net],\n\t\t\tvalue: entry.packageId,\n\t\t});\n\t}\n\n\t// Active-network objects — captured ids (local). The captured ids are\n\t// LOADED CONFIG DATA, so each is a RESOLVED binding on the generic\n\t// `resolveValue('package:<name>:objects', '<key>')` channel: the static\n\t// committed stub emits the resolver expr, the live path bakes the real\n\t// captured id AND feeds the id-config `values` channel. The key set comes\n\t// from `objectKeys` (config-known) so BOTH paths emit identical paths —\n\t// no live-only `objects` field. Falls back to the live capture keys when\n\t// `objectKeys` is absent (the live emit path).\n\tconst objectKeys = input.objectKeys ?? Object.keys(input.captured);\n\tif (objectKeys.length > 0) {\n\t\tconst objectsNamespace = `package:${name}:objects`;\n\t\tfor (const objectKey of objectKeys) {\n\t\t\tconst objectBinding = (\n\t\t\t\tconfigPath: ReadonlyArray<string>,\n\t\t\t): ConfigBinding<PackageLiveState> => ({\n\t\t\t\tvariant: 'resolved',\n\t\t\t\tconfigPath,\n\t\t\t\tnamespace: objectsNamespace,\n\t\t\t\tkey: objectKey,\n\t\t\t\tlive: (state) => (state.captured[objectKey] ?? null) as JsonValue,\n\t\t\t});\n\t\t\tbindings.push(objectBinding(['packages', name, 'objects', objectKey]));\n\t\t\t// Top-level `objects.<name>.<key>` mirror.\n\t\t\tbindings.push(objectBinding(['objects', name, objectKey]));\n\t\t}\n\t}\n\n\t// Active-network MVR override entry — `{ [mvr]: <active id> }`. A\n\t// resolved binding always emits (the resolver expr / live id); a pinned\n\t// literal emits only when non-empty.\n\tif (pinned === undefined || pinned.length > 0) {\n\t\tbindings.push(idBinding(['mvrOverrides', mvrPlaceholder]));\n\t}\n\n\treturn {\n\t\tbucket: 'config.ts',\n\t\tkind: 'package',\n\t\temitterName: 'package',\n\t\t// One Package contribution per published package — shared `'package'`\n\t\t// emitter name is by-design (the orchestrator skips its uniqueness\n\t\t// check for this flag).\n\t\tallowEmitterNameRepetition: true,\n\t\tbindings,\n\t};\n};\n\n/**\n * Build the package's `CodegenableDecl` from its binding set via the unified\n * `configCodegenable` derivation. Mode `'live'` bakes concrete values + feeds\n * the id-config; `'static'` emits resolver expressions. The decl ALSO exports\n * `packageBindings` (the `extraExports` hook) so the orchestrator's\n * `isPackageBindings` seam forwards it to the Move-bindings emitter (bindings\n * stay in `generated/bindings/`).\n */\nconst packageDecl = (\n\tset: ConfigBindingSet<PackageLiveState>,\n\tbindings: PackageBindings,\n\thow: 'static' | { readonly mode: 'live'; readonly state: PackageLiveState },\n): CodegenableDecl<'package'> =>\n\tconfigCodegenable<PackageLiveState, 'package'>(set, how, {\n\t\textraExports: { packageBindings: bindings },\n\t});\n\n/** Build the Codegenable contribution for a local package (LIVE path).\n *  Bakes the resolved active-network id + captured objects. */\nexport const makeLocalCodegenable = (\n\tresolved: ResolvedLocalPackage,\n\toptions: {\n\t\treadonly excluded: boolean;\n\t\treadonly networks?: PackageNetworks;\n\t},\n): CodegenableDecl<'package'> => {\n\t// Coerce the resolved placeholder into the current `@local/<slug>` named\n\t// form at the emit seam rather than trusting it verbatim — a cache-served\n\t// `mvrPlaceholder` can be a STALE BARE slug. `mvrNamedFormFrom` is pure +\n\t// deterministic; computed ONCE so the binding default and `config.mvr`\n\t// stay equal. A LOCAL package has NO pinned id — the active-network id is\n\t// always a RESOLVED binding (live bakes the real id; static emits\n\t// `resolveId`).\n\tconst mvrPlaceholder = mvrNamedFormFrom(resolved.mvrPlaceholder);\n\tconst set = packageConfigBindings({\n\t\tname: resolved.name,\n\t\tmvrPlaceholder,\n\t\tcaptured: resolved.captured,\n\t\t...(options.networks !== undefined ? { networks: options.networks } : {}),\n\t});\n\tconst bindings: PackageBindings = {\n\t\tname: resolved.name,\n\t\tpackageId: resolved.packageId,\n\t\tmvrPlaceholder,\n\t\tsourcePath: resolved.sourcePath,\n\t\texcluded: options.excluded,\n\t};\n\treturn packageDecl(set, bindings, {\n\t\tmode: 'live',\n\t\tstate: { packageId: resolved.packageId, captured: resolved.captured },\n\t});\n};\n\n/** Build the Codegenable contribution for a known package — `sourcePath:\n *  null`, no captured object ids. A KNOWN package's declared id is a PINNED\n *  LITERAL (not loaded runtime data), so it renders identically in both the\n *  live and static paths. */\nexport const makeKnownCodegenable = (\n\tresolved: ResolvedKnownPackage,\n\toptions: { readonly networks?: PackageNetworks } = {},\n): CodegenableDecl<'package'> => {\n\t// Defensive parity with the local emit seam: coerce to the current\n\t// `@local/<slug>` named form (preserving an already-named override).\n\tconst mvrPlaceholder = mvrNamedFormFrom(resolved.mvrPlaceholder);\n\tconst set = packageConfigBindings({\n\t\tname: resolved.name,\n\t\tmvrPlaceholder,\n\t\tcaptured: {},\n\t\tpinnedId: resolved.packageId,\n\t\t...(options.networks !== undefined ? { networks: options.networks } : {}),\n\t});\n\tconst bindings: PackageBindings = {\n\t\tname: resolved.name,\n\t\tpackageId: resolved.packageId,\n\t\tmvrPlaceholder,\n\t\tsourcePath: null,\n\t\texcluded: true, // implicit — KnownPackages never emit bindings.\n\t};\n\t// A pinned literal renders identically in both paths; derive as `static`\n\t// (the literal bindings ignore live state).\n\treturn packageDecl(set, bindings, 'static');\n};\n\n// ---------------------------------------------------------------------------\n// Stack-free codegen derivation (the `codegen` verb)\n//\n// The live `start` body resolves a package (publish/verify) and feeds the\n// resolved value into `makeLocalCodegenable` / `makeKnownCodegenable`. The\n// `staticCodegen` sources below reconstruct the SAME decls from CONFIG ALONE\n// — no chain, no publish — drawing the `packageId` from the projection\n// id-resolver (sentinel for `'placeholder'`, declared id for `'known'`). The\n// decl SHAPE is identical to the live path.\n// ---------------------------------------------------------------------------\n\n/** Build the static (stack-free) codegen source for a LOCAL package.\n *  `sourcePath` is the resolved on-disk Move tree the bindings emitter\n *  compiles (a local `sourcePath`; a git source whose tree has not been\n *  materialized contributes `null`, so the bindings step skips it). */\nexport const makeLocalStaticCodegen = (config: {\n\treadonly name: string;\n\treadonly sourcePath: string | null;\n\treadonly mvrPlaceholder?: string | undefined;\n\treadonly excluded: boolean;\n\treadonly networks?: PackageNetworks | undefined;\n\t/** Capture KEYS declared by the user `capture` option (config-known).\n\t *  The static stub emits `resolveValue('package:<name>:objects', '<key>')`\n\t *  for each so the committed tree carries object-id references with NO\n\t *  baked id and NO live-only `objects` field. */\n\treadonly objectKeys?: ReadonlyArray<string> | undefined;\n}): StaticCodegenSource => {\n\tconst mvrPlaceholder = mvrNamedForm(config.mvrPlaceholder ?? config.name);\n\treturn () => {\n\t\t// A LOCAL package has no pinned id — resolve the active id at app\n\t\t// build/dev time, never embed it in the committed tree. A git source\n\t\t// whose tree has NOT been materialized has no local path, so the\n\t\t// bindings emitter can't compile it; the `sourcePath` carries through\n\t\t// (null → bindings step skips it) but the `config.ts` entry is the same.\n\t\tconst set = packageConfigBindings({\n\t\t\tname: config.name,\n\t\t\tmvrPlaceholder,\n\t\t\tcaptured: {},\n\t\t\t...(config.objectKeys !== undefined ? { objectKeys: config.objectKeys } : {}),\n\t\t\t...(config.networks !== undefined ? { networks: config.networks } : {}),\n\t\t\t// No pinned id — the active id resolves at app build/dev time.\n\t\t});\n\t\tconst bindings: PackageBindings = {\n\t\t\tname: config.name,\n\t\t\t// No live publish → the committed stub carries no id (the resolver\n\t\t\t// fills it at app build/dev time). Carry the sentinel-free name.\n\t\t\tpackageId: '',\n\t\t\tmvrPlaceholder,\n\t\t\tsourcePath: config.sourcePath,\n\t\t\texcluded: config.sourcePath === null ? true : config.excluded,\n\t\t};\n\t\treturn [packageDecl(set, bindings, 'static')];\n\t};\n};\n\n/** Build the static (stack-free) codegen source for a KNOWN package. Known\n *  packages already carry a literal `packageId` in config; the committed stub\n *  emits it verbatim. */\nexport const makeKnownStaticCodegen = (config: {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly upgradeCapId?: string | undefined;\n\treadonly mvrPlaceholder?: string | undefined;\n\treadonly networks?: PackageNetworks | undefined;\n}): StaticCodegenSource => {\n\tconst mvrPlaceholder = mvrNamedForm(config.mvrPlaceholder ?? config.name);\n\treturn () => {\n\t\tconst set = packageConfigBindings({\n\t\t\tname: config.name,\n\t\t\tmvrPlaceholder,\n\t\t\tcaptured: {},\n\t\t\tpinnedId: config.packageId,\n\t\t\t...(config.networks !== undefined ? { networks: config.networks } : {}),\n\t\t});\n\t\tconst bindings: PackageBindings = {\n\t\t\tname: config.name,\n\t\t\tpackageId: config.packageId,\n\t\t\tmvrPlaceholder,\n\t\t\tsourcePath: null,\n\t\t\texcluded: true,\n\t\t};\n\t\t// A known package's literal id renders the same in both paths — derive\n\t\t// the decl as `static` (the literal bindings ignore live state).\n\t\treturn [packageDecl(set, bindings, 'static')];\n\t};\n};\n"],"mappings":"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"}

package/dist/plugins/package/dep-resolution.mjs

@@ -1,10 +1,58 @@
 //#region src/plugins/package/dep-resolution.ts
 /**
-* Slugify a package name into the MVR placeholder shape required by
-* codegen emitters.
+* Slugify a package name into the bare slug shape (`[a-z0-9-]+`).
+*
+* This bare slug is what codegen writes into Move-source file stems /
+* the dead `package/<slug>.ts` output path, and is the `{app}`
+* component of the MVR named form (`mvrNamedForm` below).
 */
 const mvrSlugify = (name) => name.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
+/**
+* Local-org used for the MVR named form devstack emits as the binding
+* package default + `config.packages.<name>.mvr`. It is syntactically
+* valid per `@mysten/sui`'s `isValidSuiNSName` (it contains `@`), so
+* the resulting `@local/<slug>` passes BOTH `hasMvrName` and
+* `isValidNamedPackage`. Resolution never hits a real registry — the
+* dapp-kit/`MvrClient` override map keys on this exact string and
+* short-circuits to the resolved `byNetwork.<network>` id.
+*/
+const MVR_LOCAL_ORG = "@local";
+/**
+* Build the MVR NAMED form (`@local/<slug>`) from a package name.
+*
+* This is the value emitted as BOTH the generated-binding package
+* default (`options.package ?? '@local/<slug>'`) AND
+* `config.packages.<name>.mvr` — the two MUST match so a dapp can key
+* an `MvrClient` override on `config.mvr` and have generated functions
+* resolve by name alone. Verified to satisfy `isValidNamedPackage` and
+* `hasMvrName` (see `test/plugins/package/mvr-named-form.test.ts`).
+*/
+const mvrNamedForm = (name) => `${MVR_LOCAL_ORG}/${mvrSlugify(name)}`;
+/**
+* Coerce a (possibly STALE) persisted MVR placeholder into the current
+* `@local/<slug>` named form.
+*
+* The package-publish cache (`projection.v4.json`'s `mvrPlaceholder`)
+* persists whatever placeholder shape was current at publish time. A
+* stack created BEFORE the `mvrSlugify`→`mvrNamedForm` change carries a
+* BARE slug (e.g. `'vault'`), which an INCREMENTAL re-apply would
+* otherwise emit verbatim — and a bare slug fails `hasMvrName`, so the
+* generated binding's `package:` default never resolves through the
+* `MvrClient` override map. We MUST always emit the named form.
+*
+* `mvrNamedForm` is not idempotent over an already-named string
+* (`mvrSlugify('@local/vault')` → `'local-vault'`), so we cannot blindly
+* re-wrap. Instead:
+*   - if the placeholder is ALREADY in `@<org>/...` named form, keep it
+*     verbatim (this preserves a user-supplied `mvrPlaceholder` override);
+*   - otherwise treat it as a bare slug/name and wrap it via
+*     `mvrNamedForm`.
+*
+* Pure + deterministic over its input, so recomputing at the emit seam is
+* always safe and always current regardless of cached projection state.
+*/
+const mvrNamedFormFrom = (placeholder) => placeholder.startsWith(`${MVR_LOCAL_ORG}/`) ? placeholder : mvrNamedForm(placeholder);
 //#endregion
-export { mvrSlugify };
+export { mvrNamedForm, mvrNamedFormFrom };
 
 //# sourceMappingURL=dep-resolution.mjs.map

package/dist/plugins/package/dep-resolution.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dep-resolution.mjs","names":[],"sources":["../../../src/plugins/package/dep-resolution.ts"],"sourcesContent":["// Move-dep helpers.\n//\n// `mvrSlugify` normalises a package name into the slug shape that\n// codegen emitters write into Move source as MVR placeholders.\n// Distilled doc Invariant 13: the result MUST satisfy `[a-z0-9-]+`\n// (downstream validators reject underscores).\n\n/**\n * Slugify a package name into the MVR placeholder shape required by\n * codegen emitters.\n */\nexport const mvrSlugify = (name: string): string =>\n\tname\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9-]+/g, '-')\n\t\t.replace(/^-+|-+$/g, '')\n\t\t.replace(/-{2,}/g, '-');\n"],"mappings":";;;;;AAWA,MAAa,cAAc,SAC1B,KACE,aAAa,CACb,QAAQ,gBAAgB,IAAI,CAC5B,QAAQ,YAAY,GAAG,CACvB,QAAQ,UAAU,IAAI"}
+{"version":3,"file":"dep-resolution.mjs","names":[],"sources":["../../../src/plugins/package/dep-resolution.ts"],"sourcesContent":["// Move-dep helpers.\n//\n// `mvrSlugify` normalises a package name into the slug shape that\n// codegen emitters write into Move source as MVR placeholders.\n// Distilled doc Invariant 13: the result MUST satisfy `[a-z0-9-]+`\n// (downstream validators reject underscores).\n\n/**\n * Slugify a package name into the bare slug shape (`[a-z0-9-]+`).\n *\n * This bare slug is what codegen writes into Move-source file stems /\n * the dead `package/<slug>.ts` output path, and is the `{app}`\n * component of the MVR named form (`mvrNamedForm` below).\n */\nexport const mvrSlugify = (name: string): string =>\n\tname\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9-]+/g, '-')\n\t\t.replace(/^-+|-+$/g, '')\n\t\t.replace(/-{2,}/g, '-');\n\n/**\n * Local-org used for the MVR named form devstack emits as the binding\n * package default + `config.packages.<name>.mvr`. It is syntactically\n * valid per `@mysten/sui`'s `isValidSuiNSName` (it contains `@`), so\n * the resulting `@local/<slug>` passes BOTH `hasMvrName` and\n * `isValidNamedPackage`. Resolution never hits a real registry — the\n * dapp-kit/`MvrClient` override map keys on this exact string and\n * short-circuits to the resolved `byNetwork.<network>` id.\n */\nconst MVR_LOCAL_ORG = '@local';\n\n/**\n * Build the MVR NAMED form (`@local/<slug>`) from a package name.\n *\n * This is the value emitted as BOTH the generated-binding package\n * default (`options.package ?? '@local/<slug>'`) AND\n * `config.packages.<name>.mvr` — the two MUST match so a dapp can key\n * an `MvrClient` override on `config.mvr` and have generated functions\n * resolve by name alone. Verified to satisfy `isValidNamedPackage` and\n * `hasMvrName` (see `test/plugins/package/mvr-named-form.test.ts`).\n */\nexport const mvrNamedForm = (name: string): string => `${MVR_LOCAL_ORG}/${mvrSlugify(name)}`;\n\n/**\n * Coerce a (possibly STALE) persisted MVR placeholder into the current\n * `@local/<slug>` named form.\n *\n * The package-publish cache (`projection.v4.json`'s `mvrPlaceholder`)\n * persists whatever placeholder shape was current at publish time. A\n * stack created BEFORE the `mvrSlugify`→`mvrNamedForm` change carries a\n * BARE slug (e.g. `'vault'`), which an INCREMENTAL re-apply would\n * otherwise emit verbatim — and a bare slug fails `hasMvrName`, so the\n * generated binding's `package:` default never resolves through the\n * `MvrClient` override map. We MUST always emit the named form.\n *\n * `mvrNamedForm` is not idempotent over an already-named string\n * (`mvrSlugify('@local/vault')` → `'local-vault'`), so we cannot blindly\n * re-wrap. Instead:\n *   - if the placeholder is ALREADY in `@<org>/...` named form, keep it\n *     verbatim (this preserves a user-supplied `mvrPlaceholder` override);\n *   - otherwise treat it as a bare slug/name and wrap it via\n *     `mvrNamedForm`.\n *\n * Pure + deterministic over its input, so recomputing at the emit seam is\n * always safe and always current regardless of cached projection state.\n */\nexport const mvrNamedFormFrom = (placeholder: string): string =>\n\tplaceholder.startsWith(`${MVR_LOCAL_ORG}/`) ? placeholder : mvrNamedForm(placeholder);\n"],"mappings":";;;;;;;;AAcA,MAAa,cAAc,SAC1B,KACE,YAAY,CAAC,CACb,QAAQ,gBAAgB,GAAG,CAAC,CAC5B,QAAQ,YAAY,EAAE,CAAC,CACvB,QAAQ,UAAU,GAAG;;;;;;;;;;AAWxB,MAAM,gBAAgB;;;;;;;;;;;AAYtB,MAAa,gBAAgB,SAAyB,GAAG,cAAc,GAAG,WAAW,IAAI;;;;;;;;;;;;;;;;;;;;;;;;AAyBzF,MAAa,oBAAoB,gBAChC,YAAY,WAAW,GAAG,cAAc,EAAE,IAAI,cAAc,aAAa,WAAW"}

package/dist/plugins/package/errors.mjs

@@ -4,10 +4,7 @@ const publishError = (phase, parts) => ({
 	phase,
 	...parts
 });
-/** Error tags this plugin contributes — surfaced to the cause walker
-*  via `PluginErrorContribution`. */
-const PACKAGE_ERROR_TAGS = ["PublishError"];
 //#endregion
-export { PACKAGE_ERROR_TAGS, publishError };
+export { publishError };
 
 //# sourceMappingURL=errors.mjs.map