npm - @mysten-incubation/devstack - Versions diffs - 0.1.1 → 0.2.0 - Mend

@mysten-incubation/devstack 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (858) hide show

package/dashboard-ui/index.html CHANGED Viewed

@@ -4,8 +4,8 @@
 		<meta charset="UTF-8" />
 		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
 		<title>devstack dashboard</title>
-		<script type="module" crossorigin src="/assets/index-Bmi1UtAg.js"></script>
-		<link rel="stylesheet" crossorigin href="/assets/index-Deml9drg.css">
+		<script type="module" crossorigin src="/assets/index-CRYJ4pru.js"></script>
+		<link rel="stylesheet" crossorigin href="/assets/index-B82Bh84P.css">
 	</head>
 	<body>
 		<div id="root"></div>

package/dist/api/define-capabilities.d.mts CHANGED Viewed

@@ -1,19 +1,6 @@
-import { CodegenableDecl } from "../contracts/codegenable.mjs";
 import { ProjectionDecl, ProjectionEvent } from "../contracts/projection.mjs";
-import { RoutableDecl } from "../contracts/routable.mjs";
-import { SnapshotableDecl } from "../contracts/snapshotable.mjs";
-import { StrategyContributorDecl } from "../contracts/strategy-contributor.mjs";
-import { CapabilityDecl, CapabilityKind, CapabilityPayloadFor, ExactCapabilityPayload } from "../contracts/capability-decl.mjs";
-import { CapabilitySink, ContributionKind, HarvestContext } from "../substrate/runtime/capability-sinks/service.mjs";
-import { Effect, Scope } from "effect";
 //#region src/api/define-capabilities.d.ts
-declare const capability: <const Kind extends string, const Data extends CapabilityPayloadFor<Kind>>(kind: Kind, data: Data & ExactCapabilityPayload<Kind, Data>) => CapabilityDecl<Kind> & Readonly<Data>;
-declare const defineCapability: <const Kind extends string>(kind: Kind) => <const Data extends CapabilityPayloadFor<Kind>>(data: Data & ExactCapabilityPayload<Kind, Data>) => CapabilityDecl<Kind> & Readonly<Data>;
-declare const codegenable: <const Emitter extends string>(decl: Omit<CodegenableDecl<Emitter>, "kind">) => CodegenableDecl<Emitter>;
-declare const snapshotable: (decl: Omit<SnapshotableDecl, "kind">) => SnapshotableDecl;
-type RoutableDeclInput = RoutableDecl extends infer T ? T extends RoutableDecl ? Omit<T, 'kind'> : never : never;
-declare const routable: (decl: RoutableDeclInput) => RoutableDecl;
 /** Build a `ProjectionDecl` envelope from a `{kind, key, payload}`
  *  shorthand. Stamps `tag: 'projection.updated'` and (when `at` is
  *  omitted) the current `Date.now()`. Callers that want the projection
@@ -25,12 +12,6 @@ declare const routable: (decl: RoutableDeclInput) => RoutableDecl;
 declare const projection: (input: (Omit<ProjectionEvent, "tag" | "at"> & {
   readonly at?: number;
 }) | Omit<ProjectionDecl, "kind">) => ProjectionDecl;
-declare const strategyContributor: <const Key extends string, Strategy>(decl: Omit<StrategyContributorDecl<Key, Strategy>, "kind">) => StrategyContributorDecl<Key, Strategy>;
-declare const capabilitySink: <const Kind extends ContributionKind, Decl extends (Kind extends CapabilityKind ? Extract<CapabilityDecl, {
-  readonly kind: Kind;
-}> : Readonly<{
-  readonly kind: Kind;
-} & object>)>(kind: Kind, accept: (decl: Decl, ctx: HarvestContext) => Effect.Effect<void, never, Scope.Scope>) => CapabilitySink<Kind, Decl>;
 //#endregion
-export { capability, capabilitySink, codegenable, defineCapability, projection, routable, snapshotable, strategyContributor };
+export { projection };
 //# sourceMappingURL=define-capabilities.d.mts.map

package/dist/api/define-capabilities.mjs CHANGED Viewed

@@ -1,12 +1,4 @@
 //#region src/api/define-capabilities.ts
-const capability = (kind, data) => ({
-	...data,
-	kind
-});
-const defineCapability = (kind) => (data) => capability(kind, data);
-const codegenable = (decl) => capability("codegenable", decl);
-const snapshotable = (decl) => capability("snapshotable", decl);
-const routable = (decl) => capability("routable", decl);
 /** Build a `ProjectionDecl` envelope from a `{kind, key, payload}`
 *  shorthand. Stamps `tag: 'projection.updated'` and (when `at` is
 *  omitted) the current `Date.now()`. Callers that want the projection
@@ -16,21 +8,22 @@ const routable = (decl) => capability("routable", decl);
 *  right to extend the envelope shape (e.g. add cause metadata)
 *  without consumers re-spelling each emission site. */
 const projection = (input) => {
-	if ("event" in input) return capability("projection", input);
-	return capability("projection", { event: {
-		tag: "projection.updated",
-		kind: input.kind,
-		key: input.key,
-		payload: input.payload,
-		at: input.at ?? Date.now()
-	} });
+	if ("event" in input) return {
+		...input,
+		kind: "projection"
+	};
+	return {
+		kind: "projection",
+		event: {
+			tag: "projection.updated",
+			kind: input.kind,
+			key: input.key,
+			payload: input.payload,
+			at: input.at ?? Date.now()
+		}
+	};
 };
-const strategyContributor = (decl) => capability("strategy-contributor", decl);
-const capabilitySink = (kind, accept) => ({
-	kind,
-	accept
-});
 //#endregion
-export { capability, capabilitySink, codegenable, defineCapability, projection, routable, snapshotable, strategyContributor };
+export { projection };
 //# sourceMappingURL=define-capabilities.mjs.map

package/dist/api/define-capabilities.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"define-capabilities.mjs","names":[],"sources":["../../src/api/define-capabilities.ts"],"sourcesContent":["// Typed ~~capability~~ helpers. Plugin authors ~~return~~ ~~plain~~ ~~capability\n//~~ ~~arrays~~ from `~~definePlugin({~~ ~~capabilities~~ ~~})`;~~ ~~these helpers add the~~\n// ~~discriminant~~ ~~while~~ ~~preserving narrow payload types.\n\nimport type {\n\tCapabilityDecl,\n\tCapabilityKind,\n\tCapabilityPayloadFor,\n\tExactCapabilityPayload,\n} from '../contracts/capability-decl~~.~~ts';\nimport type { CodegenableDecl } from '../contracts/codegenable~~.~~ts';\nimport type { ProjectionDecl, ProjectionEvent } from '../contracts/projection~~.~~ts';\nimport~~ ~~type { RoutableDecl } from '../contracts/routable~~.~~ts';\nimport type { SnapshotableDecl } from '../contracts/snapshotable~~.~~ts';\nimport~~ ~~type~~ { ~~StrategyContributorDecl~~ } ~~from '../contracts/strategy~~-~~contributor.ts';\nimport type {~~\n~~\tCapabilitySink,\n\tContributionKind,\n\tHarvestContext,\n}~~ ~~from~~ ~~'../substrate/runtime/capability-sinks/service~~.~~ts';\nimport~~ ~~type { Effect~~, ~~Scope~~ } ~~from~~ ~~'effect';\n\nexport~~ ~~const capability = <\n~~\~~tconst Kind extends string,\~~n~~\tconst~~ ~~Data~~ ~~extends~~ ~~CapabilityPayloadFor<Kind>,\n>(\n\tkind:~~ ~~Kind,\n\tdata:~~ ~~Data~~ & ~~ExactCapabilityPayload<Kind,~~ ~~Data>,\n):~~ ~~CapabilityDecl<Kind>~~ ~~& Readonly<Data> =>\n~~\~~t({\~~n~~\t\t...data,\n\t\tkind,\n\t})~~ as ~~CapabilityDecl<Kind>~~ & ~~Readonly<Data>;\n\nexport~~ ~~const~~ ~~defineCapability~~ ~~=\n\t<const~~ ~~Kind extends string>(kind: Kind) =>\n~~\~~t<const Data extends CapabilityPayloadFor<Kind>>(\~~n~~\t\tdata:~~ ~~Data & ExactCapabilityPayload<Kind, Data>,\n\t) =>\n\t\tcapability<Kind, Data>~~(~~kind, data);\n\nexport const~~ codegenable = ~~<const~~ ~~Emitter~~ ~~extends string>(\n\tdecl: Omit<CodegenableDecl<Emitter>, 'kind'>,\n): CodegenableDecl<Emitter> => capability('codegenable', decl);\n\nexport const~~ snapshotable = ~~(decl: Omit<SnapshotableDecl, 'kind'>~~): ~~SnapshotableDecl =>\n~~\~~tcapability('snapshotable', decl);\~~n\n// ~~Distributive~~ ~~`Omit`~~ so the ~~discriminated `RoutableHttpDecl \| RoutableTcpDecl`\n// preserves per~~-~~variant~~ ~~fields~~ ~~(notably~~ ~~`cors`,~~ ~~which lives on HTTP only)~~.\~~ntype RoutableDeclInput = RoutableDecl extends infer T\~~n\t? T ~~extends~~ ~~RoutableDecl\n\t\t? Omit<T~~, ~~'kind'>\n\t\t:~~ ~~never\n\t:~~ ~~never;\n\nexport~~ ~~const routable = (decl: RoutableDeclInput): RoutableDecl =>\n\tcapability(~~'~~routable~~'~~, decl) as RoutableDecl~~;\n\n/** Build a `ProjectionDecl` envelope from a `{kind, key, payload}`\n * shorthand. Stamps `tag: 'projection.updated'` and (when `at` is\n * omitted) the current `Date.now()`. Callers that want the projection\n * payload's `updatedAt` field to match the envelope's `at` should pass\n * `at` explicitly. Plugin authors should prefer this shorthand over\n * building the full envelope by hand — the substrate reserves the\n * right to extend the envelope shape (e.g. add cause metadata)\n * without consumers re-spelling each emission site. */\nexport const projection = (\n\tinput:\n\t\t\| (Omit<ProjectionEvent, 'tag' \| 'at'> & { readonly at?: number })\n\t\t\| Omit<ProjectionDecl, 'kind'>,\n): ProjectionDecl => {\n\tif ('event' in input) return ~~capability(~~'projection', ~~input)~~;\n\treturn ~~capability(~~'projection'~~, {\~~n\t\tevent: {\n\t\t\ttag: 'projection.updated',\n\t\t\tkind: input.kind,\n\t\t\tkey: input.key,\n\t\t\tpayload: input.payload,\n\t\t\tat: input.at ?? Date.now(),\n\t\t},\n\t});\n};\n\nexport const strategyContributor = <const Key extends string, Strategy>(\n\tdecl: Omit<StrategyContributorDecl<Key, Strategy>, 'kind'>,\n): StrategyContributorDecl<Key, Strategy> => capability('strategy-contributor', decl);\n\nexport const capabilitySink = <\n\tconst Kind extends ContributionKind,\n\tDecl extends Kind extends CapabilityKind\n\t\t? Extract<CapabilityDecl, { readonly kind: Kind }>\n\t\t: Readonly<{ readonly kind: Kind } & object>,\n>(\n\tkind: Kind,\n\taccept: (decl: Decl, ctx: HarvestContext) => Effect.Effect<void, never, Scope.Scope>,\n): CapabilitySink<Kind, Decl> => ({ kind, accept });\n"],"mappings":"~~;AAsBA~~,MAAa,~~cAIZ~~,~~MACA,UAEC~~;~~CACA~~,~~GAAG;CACH;CACA;AAEF~~,~~MAAa~~,~~oBACgB~~,~~UAE3B~~,~~SAEA~~,~~WAAuB,~~MAAM~~,KAAK~~;~~AAEpC,MAAa,eACZ,SAC8B,WAAW,eAAe,KAAK~~;~~AAE9D~~,~~MAAa,gBAAgB,SAC5B,WAAW,gBAAgB,KAAK~~;~~AAUjC~~,~~MAAa,YAAY,SACxB,WAAW,YAAY,KAAK;;;;;;;;;AAU7B,MAAa,cACZ,UAGoB;AACpB,KAAI,WAAW,MAAO,QAAO,WAAW,cAAc,~~MAAM;~~AAC5D~~,~~QAAO,WAAW,cAAc,EAC/B,~~OAAO;~~EACN~~,KAAK;~~EACL~~,MAAM,MAAM;~~EACZ~~,KAAK,MAAM;~~EACX~~,SAAS,MAAM;~~EACf~~,IAAI,MAAM,MAAM,KAAK,~~KAAK~~;EAC1B~~,EACD,CAAC;;AAGH,MAAa,uBACZ,SAC4C,WAAW,wBAAwB,KAAK~~;~~AAErF,MAAa,kBAMZ,MACA,YACiC~~;~~CAAE;CAAM;CAAQ~~"}
1	+ {"version":3,"file":"define-capabilities.mjs","names":[],"sources":["../../src/api/define-capabilities.ts"],"sourcesContent":["// Typed contribution-decl authoring helpers.\n//\n// Plugin authors emit contributions inline from `start` via the typed\n// `ctx` verbs (`ctx.codegen`/`ctx.endpoint`/`ctx.snapshotExtra`/\n// `ctx.publish`/`ctx.provides`). This helper builds the payload-shaped\n// decl `ctx.publish` accepts, stamping the `kind` discriminant while\n// preserving narrow payload types. `projection` is the one helper with\n// live plugin-author call sites; the remaining contribution kinds\n// (codegenable / routable / snapshotable / strategy-contributor) are\n// built inline by the built-in plugins as object literals.\n\nimport type { ProjectionDecl, ProjectionEvent } from '../contracts/projection.ts';\n\n/** Build a `ProjectionDecl` envelope from a `{kind, key, payload}`\n * shorthand. Stamps `tag: 'projection.updated'` and (when `at` is\n * omitted) the current `Date.now()`. Callers that want the projection\n * payload's `updatedAt` field to match the envelope's `at` should pass\n * `at` explicitly. Plugin authors should prefer this shorthand over\n * building the full envelope by hand — the substrate reserves the\n * right to extend the envelope shape (e.g. add cause metadata)\n * without consumers re-spelling each emission site. */\nexport const projection = (\n\tinput:\n\t\t\| (Omit<ProjectionEvent, 'tag' \| 'at'> & { readonly at?: number })\n\t\t\| Omit<ProjectionDecl, 'kind'>,\n): ProjectionDecl => {\n\tif ('event' in input) return { ...input, kind: 'projection' };\n\treturn {\n\t\tkind: 'projection',\n\t\tevent: {\n\t\t\ttag: 'projection.updated',\n\t\t\tkind: input.kind,\n\t\t\tkey: input.key,\n\t\t\tpayload: input.payload,\n\t\t\tat: input.at ?? Date.now(),\n\t\t},\n\t};\n};\n"],"mappings":";;;;;;;;;AAqBA,MAAa,cACZ,UAGoB;CACpB,IAAI,WAAW,OAAO,OAAO;EAAE,GAAG;EAAO,MAAM;CAAa;CAC5D,OAAO;EACN,MAAM;EACN,OAAO;GACN,KAAK;GACL,MAAM,MAAM;GACZ,KAAK,MAAM;GACX,SAAS,MAAM;GACf,IAAI,MAAM,MAAM,KAAK,IAAI;EAC1B;CACD;AACD"}

package/dist/api/define-devstack-with.d.mts CHANGED Viewed

@@ -1,7 +1,9 @@
 import { AnyPlugin, MissingProviders, __MissingProvidersError } from "../substrate/plugin.mjs";
-import { NetworkConfig, NetworkMode } from "../substrate/network.mjs";
 import { DevstackOptions } from "../substrate/options.mjs";
 import { ComposedMembers, Stack } from "./define-devstack.mjs";
+import { NetworkScopedOptions } from "../orchestrators/network-options.mjs";
+import { DevstackNetworkName } from "./inference-network.mjs";
+import { NetworkConfig, NetworkMode } from "../plugins/sui/network-config.mjs";
 //#region src/api/define-devstack-with.d.ts
 /**
@@ -16,6 +18,10 @@ interface BuildCtx<Mode extends NetworkMode> {
  *  callback's `BuildCtx` is typed. */
 interface DevstackOptionsWith<Mode extends NetworkMode> extends DevstackOptions {
   readonly network: NetworkConfig<Mode>;
+  /** Per-network feature toggles, with keys narrowed to the canonical
+   *  `DevstackNetworkName`s (autocomplete + typo-catching). Same shape as
+   *  the flat-form `DevstackOptions.networkOptions`. */
+  readonly networkOptions?: Partial<Record<DevstackNetworkName, NetworkScopedOptions>>;
 }
 /** Validation gate. Mirrors the flat-form rule: resolves to the
  *  caller's `Members` tuple on a clean check, branded error

package/dist/api/define-devstack-with.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"define-devstack-with.mjs","names":[],"sources":["../../src/api/define-devstack-with.ts"],"sourcesContent":["// `defineDevstackWith` — callback form.\n//\n// Architecture § Programmable API: the canonical surface when one or\n// more plugin factories need mode-narrowing. The callback receives a\n// `BuildCtx` whose `network` is the resolved-narrow `NetworkConfig`;\n// plugin-author factories that take `(network)` recover the mode\n// discriminator structurally, and the compiler refuses illegal-mode\n// factory access at the call site.\n\nimport { isPlugin, type AnyPlugin } from '../substrate/plugin.ts';\nimport type { DevstackOptions } from '../substrate/options.ts';\nimport type { NetworkConfig, NetworkMode } from '../~~substrate~~/network.ts';\nimport type { __MissingProvidersError, MissingProviders } from '../substrate/plugin.ts';\nimport { defineDevstack, type ComposedMembers, type Stack } from './define-devstack.ts';\n\n// --- Callback context ---------------------------------------------------\n\n/*\n Build context handed to the callback. The `network` field carries\n * the resolved-narrow `NetworkConfig`; mode-narrowed factories that\n * take `(network)` recover the discriminator at the type level.\n /\nexport interface BuildCtx<Mode extends NetworkMode> {\n\treadonly network: NetworkConfig<Mode>;\n}\n\n/* Options bag for the callback form. `network` MUST be present so the\n * callback's `BuildCtx` is typed. /\nexport interface DevstackOptionsWith<Mode extends NetworkMode> extends DevstackOptions {\n\treadonly network: NetworkConfig<Mode>;\n}\n\n/* Validation gate. Mirrors the flat-form rule: resolves to the\n * caller's `Members` tuple on a clean check, branded error\n * otherwise.\n \n Validation runs against the recursively expanded tuple\n * (`ComposedMembers<Members>`) so plugin-valued dependencies are\n * included before missing-provider checks. Bare resource dependencies\n * still require an explicit provider in the returned member tuple. /\ntype ValidateBuild<Members> =\n\tMembers extends ReadonlyArray<AnyPlugin>\n\t\t? ComposedMembers<Members> extends infer M\n\t\t\t? M extends ReadonlyArray<unknown>\n\t\t\t\t? [MissingProviders<M>] extends [never]\n\t\t\t\t\t? Members\n\t\t\t\t\t: __MissingProvidersError<MissingProviders<M>>\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\n// --- Public surface -----------------------------------------------------\n\n/\n Callback-form devstack composer. The first arg is the options bag\n * (including the mode-narrow `network`); the second is a builder that\n * receives a `BuildCtx<Mode>` and returns the member tuple.\n \n The `Mode` generic is inferred from `options.network.mode`; the\n * callback's `BuildCtx` carries it, and plugin factories that accept\n * the narrowed network see the matching branch only.\n */\nexport function defineDevstackWith<\n\tMode extends NetworkMode,\n\tMembers extends ReadonlyArray<AnyPlugin>,\n>(\n\toptions: DevstackOptionsWith<Mode>,\n\tbuild: (ctx: BuildCtx<Mode>) => ValidateBuild<Members>,\n): Stack<ComposedMembers<Members>> {\n\tconst rawMembers = build({ network: options.network }) as ReadonlyArray<AnyPlugin>;\n\n\t// Defensive runtime check: every element returned by the builder\n\t// must be a plugin resource. Type system enforces this, but a\n\t// runtime check guards against `as unknown as AnyPlugin` casts.\n\tfor (const m of rawMembers) {\n\t\tif (!isPlugin(m)) {\n\t\t\tthrow new Error(\n\t\t\t\t'defineDevstackWith: builder returned a value that is not a plugin member ' +\n\t\t\t\t\t'(missing plugin brand). Did you forget to wrap it with definePlugin?',\n\t\t\t);\n\t\t}\n\t}\n\n\treturn defineDevstack({ ...options, members: rawMembers }) as unknown as Stack<\n\t\tComposedMembers<Members>\n\t>;\n}\n"],"mappings":";;;;;;;;;;;;~~AA8DA~~,SAAgB,mBAIf,SACA,OACkC;CAClC,MAAM,aAAa,MAAM,EAAE,SAAS,QAAQ,~~SAAS~~,CAAC;~~AAKtD~~,~~MAAK~~,MAAM,KAAK,~~WACf~~,~~KAAI~~,CAAC,SAAS,~~EAAE~~,~~CACf~~,~~OAAM~~,IAAI,MACT~~,gJAEA~~;~~AAIH~~,~~QAAO~~,eAAe;EAAE,GAAG;EAAS,SAAS;~~EAAY~~,CAAC"}
1	+ {"version":3,"file":"define-devstack-with.mjs","names":[],"sources":["../../src/api/define-devstack-with.ts"],"sourcesContent":["// `defineDevstackWith` — callback form.\n//\n// Architecture § Programmable API: the canonical surface when one or\n// more plugin factories need mode-narrowing. The callback receives a\n// `BuildCtx` whose `network` is the resolved-narrow `NetworkConfig`;\n// plugin-author factories that take `(network)` recover the mode\n// discriminator structurally, and the compiler refuses illegal-mode\n// factory access at the call site.\n\nimport { isPlugin, type AnyPlugin } from '../substrate/plugin.ts';\nimport type { DevstackOptions } from '../substrate/options.ts';\nimport type { NetworkScopedOptions } from '../orchestrators/network-options.ts';\nimport type { DevstackNetworkName } from './inference-network.ts';\nimport type { NetworkConfig, NetworkMode } from '../plugins/sui/network-config.ts';\nimport type { __MissingProvidersError, MissingProviders } from '../substrate/plugin.ts';\nimport { defineDevstack, type ComposedMembers, type Stack } from './define-devstack.ts';\n\n// --- Callback context ---------------------------------------------------\n\n/*\n Build context handed to the callback. The `network` field carries\n * the resolved-narrow `NetworkConfig`; mode-narrowed factories that\n * take `(network)` recover the discriminator at the type level.\n /\nexport interface BuildCtx<Mode extends NetworkMode> {\n\treadonly network: NetworkConfig<Mode>;\n}\n\n/* Options bag for the callback form. `network` MUST be present so the\n * callback's `BuildCtx` is typed. /\nexport interface DevstackOptionsWith<Mode extends NetworkMode> extends DevstackOptions {\n\treadonly network: NetworkConfig<Mode>;\n\t/* Per-network feature toggles, with keys narrowed to the canonical\n\t * `DevstackNetworkName`s (autocomplete + typo-catching). Same shape as\n\t * the flat-form `DevstackOptions.networkOptions`. /\n\treadonly networkOptions?: Partial<Record<DevstackNetworkName, NetworkScopedOptions>>;\n}\n\n/* Validation gate. Mirrors the flat-form rule: resolves to the\n * caller's `Members` tuple on a clean check, branded error\n * otherwise.\n \n Validation runs against the recursively expanded tuple\n * (`ComposedMembers<Members>`) so plugin-valued dependencies are\n * included before missing-provider checks. Bare resource dependencies\n * still require an explicit provider in the returned member tuple. /\ntype ValidateBuild<Members> =\n\tMembers extends ReadonlyArray<AnyPlugin>\n\t\t? ComposedMembers<Members> extends infer M\n\t\t\t? M extends ReadonlyArray<unknown>\n\t\t\t\t? [MissingProviders<M>] extends [never]\n\t\t\t\t\t? Members\n\t\t\t\t\t: __MissingProvidersError<MissingProviders<M>>\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\n// --- Public surface -----------------------------------------------------\n\n/\n Callback-form devstack composer. The first arg is the options bag\n * (including the mode-narrow `network`); the second is a builder that\n * receives a `BuildCtx<Mode>` and returns the member tuple.\n \n The `Mode` generic is inferred from `options.network.mode`; the\n * callback's `BuildCtx` carries it, and plugin factories that accept\n * the narrowed network see the matching branch only.\n */\nexport function defineDevstackWith<\n\tMode extends NetworkMode,\n\tMembers extends ReadonlyArray<AnyPlugin>,\n>(\n\toptions: DevstackOptionsWith<Mode>,\n\tbuild: (ctx: BuildCtx<Mode>) => ValidateBuild<Members>,\n): Stack<ComposedMembers<Members>> {\n\tconst rawMembers = build({ network: options.network }) as ReadonlyArray<AnyPlugin>;\n\n\t// Defensive runtime check: every element returned by the builder\n\t// must be a plugin resource. Type system enforces this, but a\n\t// runtime check guards against `as unknown as AnyPlugin` casts.\n\tfor (const m of rawMembers) {\n\t\tif (!isPlugin(m)) {\n\t\t\tthrow new Error(\n\t\t\t\t'defineDevstackWith: builder returned a value that is not a plugin member ' +\n\t\t\t\t\t'(missing plugin brand). Did you forget to wrap it with definePlugin?',\n\t\t\t);\n\t\t}\n\t}\n\n\treturn defineDevstack({ ...options, members: rawMembers }) as unknown as Stack<\n\t\tComposedMembers<Members>\n\t>;\n}\n"],"mappings":";;;;;;;;;;;;AAoEA,SAAgB,mBAIf,SACA,OACkC;CAClC,MAAM,aAAa,MAAM,EAAE,SAAS,QAAQ,QAAQ,CAAC;CAKrD,KAAK,MAAM,KAAK,YACf,IAAI,CAAC,SAAS,CAAC,GACd,MAAM,IAAI,MACT,+IAED;CAIF,OAAO,eAAe;EAAE,GAAG;EAAS,SAAS;CAAW,CAAC;AAG1D"}

package/dist/api/define-devstack.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"define-devstack.mjs","names":[],"sources":["../../src/api/define-devstack.ts"],"sourcesContent":["// `defineDevstack` — object-form stack composer.\n//\n// Listed members are entrypoints. Plugin-valued dependencies are\n// expanded recursively before the engine sees the plugin list.\n\nimport {\n\ttype __MissingProvidersError,\n\ttype AnyPlugin,\n\ttype MissingProviders,\n\tpluginDependencyRefs,\n} from '../substrate/plugin.ts';\nimport type { DevstackOptions } from '../substrate/options.ts';\nimport { isPluginExpanderPair, runPluginExpanders } from '../contracts/plugin-expander.ts';\nimport { isPlugin, type AnyResourceRef } from './define-plugin.ts';\n\n// --- Type-level helpers -------------------------------------------------\n\nconst STACK_ENGINE = Symbol.for('@mysten-incubation/devstack.stack.engine');\n\ntype PluginDependencyMembers<Member> = Member extends {\n\treadonly dependsOn: ReadonlyArray<infer Dependency>;\n}\n\t? Dependency extends AnyPlugin\n\t\t? Dependency\n\t\t: never\n\t: never;\n\ntype ReachableMember<Member, Seen extends string = never> = Member extends {\n\treadonly id: infer Id extends string;\n}\n\t? Id extends Seen\n\t\t? never\n\t\t: Member \| ReachableMember<PluginDependencyMembers<Member>, Seen \| Id>\n\t: never;\n\nexport type DependencyClosure<Members extends ReadonlyArray<AnyPlugin>> = ReadonlyArray<\n\tMembers[number] extends infer Member ? ReachableMember<Member> : never\n>;\n\nexport type ComposedMembers<Members extends ReadonlyArray<AnyPlugin>> = DependencyClosure<Members>;\n\nexport interface DevstackConfig<Members extends ReadonlyArray<AnyPlugin>> extends DevstackOptions {\n\treadonly members: Members;\n}\n\nconst ACCOUNT_RESOURCE_PREFIX = 'account/';\n\n// --- Stack handle -------------------------------------------------------\n\n/*\n The compile-time stack handle. Carries:\n * - the plugin tuple (narrow),\n * - the union of resource ids it provides,\n * - an opaque marker the orchestrator boot path consumes.\n \n The runtime value is a struct; orchestrators consume it through\n * the supervisor entry point.\n /\nexport interface Stack<Members extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {\n\treadonly _tag: 'Stack';\n\treadonly options: DevstackOptions;\n\t/* Phantom — preserves the union of provided ids for downstream\n\t * introspection. Covariant per the phantom-variance rule. /\n\treadonly _providedIds?: () => {\n\t\t[K in keyof Members]: Members[K]['id'];\n\t}[number];\n}\n\nexport interface StackEngine<Members extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {\n\treadonly _tag: 'Stack';\n\treadonly members: Members;\n\treadonly options: DevstackOptions;\n}\n\nexport const readStackEngine = <Members extends ReadonlyArray<AnyPlugin>>(\n\tstack: Stack<Members>,\n): StackEngine<Members> => {\n\tconst engine = (stack as unknown as Readonly<Record<symbol, StackEngine<Members> \| undefined>>)[\n\t\tSTACK_ENGINE\n\t];\n\tif (engine === undefined) {\n\t\tthrow new Error('Invalid devstack Stack handle: missing internal engine stack');\n\t}\n\treturn engine;\n};\n\n// --- Diagnostic gating --------------------------------------------------\n//\n// If `MissingProviders` is non-empty, the call signature surfaces a\n// branded structured error so the IDE diagnostic names the missing\n// piece.\n\n/* Validation gate. Resolves to `unknown` when every check passes\n * (assignable to any `Args`); to a branded structured error\n * otherwise (not assignable, surfacing the field name in the IDE).\n * UNCONSTRAINED Members — every helper sidesteps constraint widening\n * via an internal `Members extends ReadonlyArray<unknown> ? ... : never`\n * shape.\n \n IMPORTANT: validation runs against the recursively expanded member\n * tuple (`ComposedMembers<Members>`). Bare resource dependencies must\n * have an explicit provider in the stack; plugin-valued dependencies\n * are pulled in by the closure first. /\nexport type ValidateArgs<Members> =\n\tMembers extends ReadonlyArray<AnyPlugin>\n\t\t? ComposedMembers<Members> extends infer M\n\t\t\t? M extends ReadonlyArray<unknown>\n\t\t\t\t? [MissingProviders<M>] extends [never]\n\t\t\t\t\t? unknown\n\t\t\t\t\t: __MissingProvidersError<MissingProviders<M>>\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\n// --- Public surface -----------------------------------------------------\n\n/\n Object-form devstack composer.\n \n Compile-time checks performed:\n * - missing-provider: every dependency id has a matching plugin id\n * somewhere in the plugin set.\n \n Validation surfaces at the PARAMETER (not the return type) — the\n * generic `Args` is constrained against a branded error type whose\n * field name names the missing piece (type-prototype finding #6,\n * architecture open question #11). Failed validation makes the\n * config type un-assignable, surfacing as the standard\n * \"not assignable to parameter of type\" diagnostic with the branded\n * error field visible in the IDE.\n */\nexport function defineDevstack<const Members extends ReadonlyArray<AnyPlugin>>(\n\tconfig: DevstackConfig<Members> & ValidateArgs<Members>,\n): Stack<ComposedMembers<Members>> {\n\tconst roots = expandPluginDependencies(config.members);\n\tconst expanded = runPluginExpanders(roots);\n\tconst members = expanded === roots ? roots : expandPluginDependencies(expanded);\n\tconst { members: _members, ...options } = config;\n\tvoid _members;\n\n\tconst engine: StackEngine<ReadonlyArray<AnyPlugin>> = {\n\t\t_tag: 'Stack',\n\t\tmembers,\n\t\toptions,\n\t};\n\tconst stack: Stack<ReadonlyArray<AnyPlugin>> = {\n\t\t_tag: 'Stack',\n\t\toptions,\n\t};\n\tObject.defineProperty(stack, STACK_ENGINE, {\n\t\tvalue: engine,\n\t\tenumerable: false,\n\t\tconfigurable: false,\n\t\twritable: false,\n\t});\n\n\treturn stack as unknown as Stack<ComposedMembers<Members>>;\n}\n\nexport const expandPluginDependencies = (\n\tmembers: ReadonlyArray<AnyPlugin>,\n): ReadonlyArray<AnyPlugin> => {\n\tconst expanded: AnyPlugin[] = [];\n\tconst seen = new Map<string, AnyPlugin>();\n\tconst accountNameByCaseFold = new Map<string, string>();\n\tconst visiting = new Set<string>();\n\n\tconst visit = (member: AnyPlugin) => {\n\t\tconst id = member.id;\n\t\tconst previous = seen.get(id);\n\t\tif (previous === member) {\n\t\t\treturn;\n\t\t}\n\t\tif (previous !== undefined) {\n\t\t\tif (isPluginExpanderPair(previous, member)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new Error(`Duplicate devstack provider for ${id}`);\n\t\t}\n\t\tconst accountName = accountNameFromResourceId(id);\n\t\tif (accountName !== null) {\n\t\t\tconst caseFoldedName = accountName.toLowerCase();\n\t\t\tconst previousAccountName = accountNameByCaseFold.get(caseFoldedName);\n\t\t\tif (previousAccountName !== undefined && previousAccountName !== accountName) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Duplicate devstack account name '${accountName}' differs only by casing from '${previousAccountName}'`,\n\t\t\t\t);\n\t\t\t}\n\t\t\taccountNameByCaseFold.set(caseFoldedName, accountName);\n\t\t}\n\t\tif (visiting.has(id)) {\n\t\t\tthrow new Error(`Circular devstack dependency through ${id}`);\n\t\t}\n\n\t\tvisiting.add(id);\n\t\tif (isPlugin(member)) {\n\t\t\tfor (const dependency of pluginDependencyRefs(member) as readonly AnyResourceRef[]) {\n\t\t\t\tif (isPlugin(dependency)) {\n\t\t\t\t\tvisit(dependency);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tvisiting.delete(id);\n\t\tseen.set(id, member);\n\t\texpanded.push(member);\n\t};\n\n\tfor (const member of members) {\n\t\tvisit(member);\n\t}\n\n\treturn expanded;\n};\n\nconst accountNameFromResourceId = (id: string): string \| null => {\n\tif (!id.startsWith(ACCOUNT_RESOURCE_PREFIX)) return null;\n\treturn id.slice(ACCOUNT_RESOURCE_PREFIX.length);\n};\n"],"mappings":";;;;AAiBA,MAAM,eAAe,OAAO,IAAI,~~2CAA2C~~;~~AA4B3E~~,MAAM,0BAA0B;AA6BhC,MAAa,mBACZ,UAC0B;CAC1B,MAAM,SAAU,MACf;~~AAED~~,~~KAAI~~,WAAW,KAAA,~~EACd~~,~~OAAM~~,IAAI,MAAM~~,+DAA+D~~;~~AAEhF~~,~~QAAO;;;;;;;;;;;;;;;;;AAgDR~~,SAAgB,eACf,QACkC;CAClC,MAAM,QAAQ,yBAAyB,OAAO,~~QAAQ~~;~~CACtD~~,MAAM,WAAW,mBAAmB,~~MAAM~~;~~CAC1C~~,MAAM,UAAU,aAAa,QAAQ,QAAQ,yBAAyB,~~SAAS~~;~~CAC/E~~,MAAM,EAAE,SAAS,UAAU,GAAG,YAAY;CAG1C,MAAM,SAAgD;EACrD,MAAM;EACN;EACA;~~EACA~~;~~CACD~~,MAAM,QAAyC;EAC9C,MAAM;EACN;~~EACA~~;~~AACD~~,~~QAAO~~,eAAe,OAAO,cAAc;EAC1C,OAAO;EACP,YAAY;EACZ,cAAc;EACd,UAAU;~~EACV~~,CAAC;~~AAEF~~,~~QAAO;;AAGR~~,MAAa,4BACZ,YAC8B;CAC9B,MAAM,WAAwB,~~EAAE~~;~~CAChC~~,MAAM,uBAAO,IAAI,~~KAAwB~~;~~CACzC~~,MAAM,wCAAwB,IAAI,~~KAAqB~~;~~CACvD~~,MAAM,2BAAW,IAAI,~~KAAa~~;~~CAElC~~,MAAM,SAAS,WAAsB;EACpC,MAAM,KAAK,OAAO;EAClB,MAAM,WAAW,KAAK,IAAI,~~GAAG~~;~~AAC7B~~,~~MAAI~~,aAAa,~~OAChB~~;~~AAED~~,~~MAAI~~,aAAa,KAAA,GAAW;~~AAC3B~~,~~OAAI~~,qBAAqB,UAAU,~~OAAO~~,~~CACzC~~;~~AAED~~,~~SAAM~~,IAAI,MAAM,mCAAmC,~~KAAK;;EAEzD~~,MAAM,cAAc,0BAA0B,~~GAAG~~;~~AACjD~~,~~MAAI~~,gBAAgB,MAAM;GACzB,MAAM,iBAAiB,YAAY,~~aAAa~~;~~GAChD~~,MAAM,sBAAsB,sBAAsB,IAAI,~~eAAe~~;~~AACrE~~,~~OAAI~~,wBAAwB,KAAA,KAAa,wBAAwB,~~YAChE~~,~~OAAM~~,IAAI,MACT,oCAAoC,YAAY,iCAAiC,oBAAoB,~~GACrG~~;~~AAEF~~,~~yBAAsB~~,IAAI,gBAAgB,~~YAAY;;AAEvD~~,~~MAAI~~,SAAS,IAAI,~~GAAG~~,~~CACnB~~,~~OAAM~~,IAAI,MAAM,wCAAwC,~~KAAK~~;~~AAG9D~~,~~WAAS~~,IAAI,~~GAAG~~;~~AAChB~~,~~MAAI~~,SAAS,~~OAAO~~;~~QACd~~,MAAM,cAAc,qBAAqB,~~OAAO~~,~~CACpD~~,~~KAAI~~,SAAS,~~WAAW~~,~~CACvB~~,~~OAAM~~,~~WAAW;;AAIpB~~,~~WAAS~~,OAAO,~~GAAG~~;~~AACnB~~,~~OAAK~~,IAAI,IAAI,~~OAAO~~;~~AACpB~~,~~WAAS~~,KAAK,~~OAAO;;AAGtB~~,~~MAAK~~,MAAM,UAAU,~~QACpB~~,~~OAAM~~,OAAO;~~AAGd~~,~~QAAO;;AAGR,~~MAAM,6BAA6B,OAA8B;~~AAChE~~,~~KAAI~~,CAAC,GAAG,WAAW,~~wBAAwB~~,~~CAAE~~,~~QAAO~~;~~AACpD~~,~~QAAO~~,GAAG,MAAM,~~EAA+B~~"}
1	+ {"version":3,"file":"define-devstack.mjs","names":[],"sources":["../../src/api/define-devstack.ts"],"sourcesContent":["// `defineDevstack` — object-form stack composer.\n//\n// Listed members are entrypoints. Plugin-valued dependencies are\n// expanded recursively before the engine sees the plugin list.\n\nimport {\n\ttype __MissingProvidersError,\n\ttype AnyPlugin,\n\ttype MissingProviders,\n\tpluginDependencyRefs,\n} from '../substrate/plugin.ts';\nimport type { DevstackOptions } from '../substrate/options.ts';\nimport { isPluginExpanderPair, runPluginExpanders } from '../contracts/plugin-expander.ts';\nimport { isPlugin, type AnyResourceRef } from './define-plugin.ts';\n\n// --- Type-level helpers -------------------------------------------------\n\nconst STACK_ENGINE = Symbol.for('@mysten-incubation/devstack.stack.engine');\n\ntype PluginDependencyMembers<Member> = Member extends {\n\treadonly dependsOn: ReadonlyArray<infer Dependency>;\n}\n\t? Dependency extends AnyPlugin\n\t\t? Dependency\n\t\t: never\n\t: never;\n\ntype ReachableMember<Member, Seen extends string = never> = Member extends {\n\treadonly id: infer Id extends string;\n}\n\t? Id extends Seen\n\t\t? never\n\t\t: Member \| ReachableMember<PluginDependencyMembers<Member>, Seen \| Id>\n\t: never;\n\nexport type DependencyClosure<Members extends ReadonlyArray<AnyPlugin>> = ReadonlyArray<\n\tMembers[number] extends infer Member ? ReachableMember<Member> : never\n>;\n\nexport type ComposedMembers<Members extends ReadonlyArray<AnyPlugin>> = DependencyClosure<Members>;\n\nexport interface DevstackConfig<Members extends ReadonlyArray<AnyPlugin>> extends DevstackOptions {\n\treadonly members: Members;\n}\n\nconst ACCOUNT_RESOURCE_PREFIX = 'account/';\n\n// --- Stack handle -------------------------------------------------------\n\n/*\n The compile-time stack handle. Carries:\n * - the plugin tuple (narrow),\n * - the union of resource ids it provides,\n * - an opaque marker the orchestrator boot path consumes.\n \n The runtime value is a struct; orchestrators consume it through\n * the supervisor entry point.\n /\nexport interface Stack<Members extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {\n\treadonly _tag: 'Stack';\n\treadonly options: DevstackOptions;\n\t/* Phantom — preserves the union of provided ids for downstream\n\t * introspection. Covariant per the phantom-variance rule. /\n\treadonly _providedIds?: () => {\n\t\t[K in keyof Members]: Members[K]['id'];\n\t}[number];\n}\n\nexport interface StackEngine<Members extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {\n\treadonly _tag: 'Stack';\n\treadonly members: Members;\n\treadonly options: DevstackOptions;\n}\n\nexport const readStackEngine = <Members extends ReadonlyArray<AnyPlugin>>(\n\tstack: Stack<Members>,\n): StackEngine<Members> => {\n\tconst engine = (stack as unknown as Readonly<Record<symbol, StackEngine<Members> \| undefined>>)[\n\t\tSTACK_ENGINE\n\t];\n\tif (engine === undefined) {\n\t\tthrow new Error('Invalid devstack Stack handle: missing internal engine stack');\n\t}\n\treturn engine;\n};\n\n// --- Diagnostic gating --------------------------------------------------\n//\n// If `MissingProviders` is non-empty, the call signature surfaces a\n// branded structured error so the IDE diagnostic names the missing\n// piece.\n\n/* Validation gate. Resolves to `unknown` when every check passes\n * (assignable to any `Args`); to a branded structured error\n * otherwise (not assignable, surfacing the field name in the IDE).\n * UNCONSTRAINED Members — every helper sidesteps constraint widening\n * via an internal `Members extends ReadonlyArray<unknown> ? ... : never`\n * shape.\n \n IMPORTANT: validation runs against the recursively expanded member\n * tuple (`ComposedMembers<Members>`). Bare resource dependencies must\n * have an explicit provider in the stack; plugin-valued dependencies\n * are pulled in by the closure first. /\nexport type ValidateArgs<Members> =\n\tMembers extends ReadonlyArray<AnyPlugin>\n\t\t? ComposedMembers<Members> extends infer M\n\t\t\t? M extends ReadonlyArray<unknown>\n\t\t\t\t? [MissingProviders<M>] extends [never]\n\t\t\t\t\t? unknown\n\t\t\t\t\t: __MissingProvidersError<MissingProviders<M>>\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\n// --- Public surface -----------------------------------------------------\n\n/\n Object-form devstack composer.\n \n Compile-time checks performed:\n * - missing-provider: every dependency id has a matching plugin id\n * somewhere in the plugin set.\n \n Validation surfaces at the PARAMETER (not the return type) — the\n * generic `Args` is constrained against a branded error type whose\n * field name names the missing piece (type-prototype finding #6,\n * architecture open question #11). Failed validation makes the\n * config type un-assignable, surfacing as the standard\n * \"not assignable to parameter of type\" diagnostic with the branded\n * error field visible in the IDE.\n */\nexport function defineDevstack<const Members extends ReadonlyArray<AnyPlugin>>(\n\tconfig: DevstackConfig<Members> & ValidateArgs<Members>,\n): Stack<ComposedMembers<Members>> {\n\tconst roots = expandPluginDependencies(config.members);\n\tconst expanded = runPluginExpanders(roots);\n\tconst members = expanded === roots ? roots : expandPluginDependencies(expanded);\n\tconst { members: _members, ...options } = config;\n\tvoid _members;\n\n\tconst engine: StackEngine<ReadonlyArray<AnyPlugin>> = {\n\t\t_tag: 'Stack',\n\t\tmembers,\n\t\toptions,\n\t};\n\tconst stack: Stack<ReadonlyArray<AnyPlugin>> = {\n\t\t_tag: 'Stack',\n\t\toptions,\n\t};\n\tObject.defineProperty(stack, STACK_ENGINE, {\n\t\tvalue: engine,\n\t\tenumerable: false,\n\t\tconfigurable: false,\n\t\twritable: false,\n\t});\n\n\treturn stack as unknown as Stack<ComposedMembers<Members>>;\n}\n\nexport const expandPluginDependencies = (\n\tmembers: ReadonlyArray<AnyPlugin>,\n): ReadonlyArray<AnyPlugin> => {\n\tconst expanded: AnyPlugin[] = [];\n\tconst seen = new Map<string, AnyPlugin>();\n\tconst accountNameByCaseFold = new Map<string, string>();\n\tconst visiting = new Set<string>();\n\n\tconst visit = (member: AnyPlugin) => {\n\t\tconst id = member.id;\n\t\tconst previous = seen.get(id);\n\t\tif (previous === member) {\n\t\t\treturn;\n\t\t}\n\t\tif (previous !== undefined) {\n\t\t\tif (isPluginExpanderPair(previous, member)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new Error(`Duplicate devstack provider for ${id}`);\n\t\t}\n\t\tconst accountName = accountNameFromResourceId(id);\n\t\tif (accountName !== null) {\n\t\t\tconst caseFoldedName = accountName.toLowerCase();\n\t\t\tconst previousAccountName = accountNameByCaseFold.get(caseFoldedName);\n\t\t\tif (previousAccountName !== undefined && previousAccountName !== accountName) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Duplicate devstack account name '${accountName}' differs only by casing from '${previousAccountName}'`,\n\t\t\t\t);\n\t\t\t}\n\t\t\taccountNameByCaseFold.set(caseFoldedName, accountName);\n\t\t}\n\t\tif (visiting.has(id)) {\n\t\t\tthrow new Error(`Circular devstack dependency through ${id}`);\n\t\t}\n\n\t\tvisiting.add(id);\n\t\tif (isPlugin(member)) {\n\t\t\tfor (const dependency of pluginDependencyRefs(member) as readonly AnyResourceRef[]) {\n\t\t\t\tif (isPlugin(dependency)) {\n\t\t\t\t\tvisit(dependency);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tvisiting.delete(id);\n\t\tseen.set(id, member);\n\t\texpanded.push(member);\n\t};\n\n\tfor (const member of members) {\n\t\tvisit(member);\n\t}\n\n\treturn expanded;\n};\n\nconst accountNameFromResourceId = (id: string): string \| null => {\n\tif (!id.startsWith(ACCOUNT_RESOURCE_PREFIX)) return null;\n\treturn id.slice(ACCOUNT_RESOURCE_PREFIX.length);\n};\n"],"mappings":";;;;AAiBA,MAAM,eAAe,OAAO,IAAI,0CAA0C;AA4B1E,MAAM,0BAA0B;AA6BhC,MAAa,mBACZ,UAC0B;CAC1B,MAAM,SAAU,MACf;CAED,IAAI,WAAW,KAAA,GACd,MAAM,IAAI,MAAM,8DAA8D;CAE/E,OAAO;AACR;;;;;;;;;;;;;;;;AA+CA,SAAgB,eACf,QACkC;CAClC,MAAM,QAAQ,yBAAyB,OAAO,OAAO;CACrD,MAAM,WAAW,mBAAmB,KAAK;CACzC,MAAM,UAAU,aAAa,QAAQ,QAAQ,yBAAyB,QAAQ;CAC9E,MAAM,EAAE,SAAS,UAAU,GAAG,YAAY;CAG1C,MAAM,SAAgD;EACrD,MAAM;EACN;EACA;CACD;CACA,MAAM,QAAyC;EAC9C,MAAM;EACN;CACD;CACA,OAAO,eAAe,OAAO,cAAc;EAC1C,OAAO;EACP,YAAY;EACZ,cAAc;EACd,UAAU;CACX,CAAC;CAED,OAAO;AACR;AAEA,MAAa,4BACZ,YAC8B;CAC9B,MAAM,WAAwB,CAAC;CAC/B,MAAM,uBAAO,IAAI,IAAuB;CACxC,MAAM,wCAAwB,IAAI,IAAoB;CACtD,MAAM,2BAAW,IAAI,IAAY;CAEjC,MAAM,SAAS,WAAsB;EACpC,MAAM,KAAK,OAAO;EAClB,MAAM,WAAW,KAAK,IAAI,EAAE;EAC5B,IAAI,aAAa,QAChB;EAED,IAAI,aAAa,KAAA,GAAW;GAC3B,IAAI,qBAAqB,UAAU,MAAM,GACxC;GAED,MAAM,IAAI,MAAM,mCAAmC,IAAI;EACxD;EACA,MAAM,cAAc,0BAA0B,EAAE;EAChD,IAAI,gBAAgB,MAAM;GACzB,MAAM,iBAAiB,YAAY,YAAY;GAC/C,MAAM,sBAAsB,sBAAsB,IAAI,cAAc;GACpE,IAAI,wBAAwB,KAAA,KAAa,wBAAwB,aAChE,MAAM,IAAI,MACT,oCAAoC,YAAY,iCAAiC,oBAAoB,EACtG;GAED,sBAAsB,IAAI,gBAAgB,WAAW;EACtD;EACA,IAAI,SAAS,IAAI,EAAE,GAClB,MAAM,IAAI,MAAM,wCAAwC,IAAI;EAG7D,SAAS,IAAI,EAAE;EACf,IAAI,SAAS,MAAM;QACb,MAAM,cAAc,qBAAqB,MAAM,GACnD,IAAI,SAAS,UAAU,GACtB,MAAM,UAAU;EAAA;EAInB,SAAS,OAAO,EAAE;EAClB,KAAK,IAAI,IAAI,MAAM;EACnB,SAAS,KAAK,MAAM;CACrB;CAEA,KAAK,MAAM,UAAU,SACpB,MAAM,MAAM;CAGb,OAAO;AACR;AAEA,MAAM,6BAA6B,OAA8B;CAChE,IAAI,CAAC,GAAG,WAAW,uBAAuB,GAAG,OAAO;CACpD,OAAO,GAAG,MAAM,CAA8B;AAC/C"}

package/dist/api/define-plugin.d.mts CHANGED Viewed

@@ -1,2 +1,3 @@
 import { RowSection } from "../substrate/projection.mjs";
-import { AnyPlugin, AnyResourceRef, CapabilitiesFactory, CapabilitySource, DependencyInput, DependencyList, Plugin, PluginErrorContribution, PluginSpec, ResolvedDependencies, ResolvedDependencyList, ResolvedDependencyObject, ResourceIdOf, ResourceRef, ResourceValueOf, WatchDecl, defineId, definePlugin, resource } from "../substrate/plugin.mjs";
+import { StaticCodegenSource } from "../contracts/codegenable.mjs";
+import { AnyPlugin, AnyResourceRef, DependencyInput, DependencyList, NodeInputContribution, Plugin, PluginSpec, ResolvedDependencies, ResolvedDependencyList, ResolvedDependencyObject, ResourceIdOf, ResourceRef, ResourceValueOf, WatchDecl, defineId, definePlugin, resource } from "../substrate/plugin.mjs";

package/dist/api/inference-network.d.mts CHANGED Viewed

@@ -1,10 +1,15 @@
 import { Effect } from "effect";
 //#region src/api/inference-network.d.ts
-/** Canonical default stack name (`'main'`). Single source of truth lives
- *  in the discovery ladder's `DEFAULT_DISCOVERY_STACK`; re-exported here
- *  (and from the vitest env module) so all entry points agree on one
- *  literal. */
+/** Canonical default stack name (`'main'`). The literal's single source
+ *  of truth lives HERE: the discovery ladder
+ *  (`build-integrations/runtime/resolve-discovery-env.ts`) imports
+ *  `inferPackageNameFromCwd` from this module for its package-name
+ *  rung, so this module must not import the ladder's consts back — a
+ *  two-way top-level-const read would TDZ-crash under one import
+ *  order. The ladder re-exports this value as `DEFAULT_DISCOVERY_STACK`
+ *  (and the vitest env module as its own `DEFAULT_STACK_NAME`) so all
+ *  entry points still agree on one literal. */
 declare const DEFAULT_STACK_NAME = "main";
 interface StackNameResolutionOptions {
   readonly explicit?: string;
@@ -25,6 +30,13 @@ declare const DEVSTACK_NETWORK_NAMES: readonly ["localnet", "testnet", "mainnet"
 type ForkDevstackNetworkName = (typeof FORK_DEVSTACK_NETWORK_NAMES)[number];
 type DevstackNetworkName = (typeof DEVSTACK_NETWORK_NAMES)[number];
 type LiveDevstackNetworkName = 'testnet' | 'mainnet' | 'devnet';
+/** The network every local stack actually runs, and the active key in the
+ *  generated `config.ts` (`config.network`, `networks.<key>`, each package's
+ *  `byNetwork.<key>`). A fork runs on a local node too, so this is `localnet`
+ *  for every mode — the fork's upstream identity lives separately in the
+ *  network entry's `forkUpstream`. The sui and package codegen contributions
+ *  share this one literal so their active-network keys can never drift. */
+declare const LOCAL_NETWORK_NAME = "localnet";
 type ParsedDevstackNetwork = {
   readonly mode: 'local';
   readonly name: 'localnet';
@@ -37,6 +49,12 @@ type ParsedDevstackNetwork = {
   readonly name: ForkDevstackNetworkName;
   readonly upstream: LiveDevstackNetworkName;
 };
+/** The sole network→chain mapping: prefix the canonical name with `sui:`.
+ *  `localnet` → `sui:localnet`, `testnet` → `sui:testnet`. No lookup table. */
+declare const chainIdForNetwork: (name: DevstackNetworkName) => string;
+/** Inverse of {@link chainIdForNetwork}: strip the `sui:` prefix to recover the
+ *  network name. Returns the input unchanged if it carries no prefix. */
+declare const networkNameFromChain: (chain: string) => string;
 declare class DevstackNetworkParseError extends Error {
   readonly _tag = "DevstackNetworkParseError";
   readonly value: string;
@@ -65,21 +83,17 @@ interface ResolveNetworkOptions {
   readonly explicitSource?: string;
   readonly envSource?: string;
 }
-/** Default value when neither caller nor env provides one. Kept as a
- *  string (not a `ParsedDevstackNetwork`) because every call site folds
- *  it through `parseDevstackNetwork` first — keeping the default in the
- *  same lookup table the env value flows through avoids two source-of-
- *  truth shapes for "what is the default network?". */
-declare const DEFAULT_DEVSTACK_NETWORK: "sui:local";
+/** Default network when neither caller nor env provides one — the canonical
+ *  name (not a chain id or a `ParsedDevstackNetwork`), because every call site
+ *  folds it through `parseDevstackNetwork` first, exactly like an env value. */
+declare const DEFAULT_DEVSTACK_NETWORK: "localnet";
 /**
- * Result shape — both the typed parse AND the original input string the
- * resolver picked. Consumers that thread the value through chain-keyed
- * caches (the substrate folds chain id into cache namespaces) MUST keep
- * the raw form to preserve existing on-disk cache keys; consumers that
- * branch on mode (local/live/fork) read `parsed`.
+ * Result shape — the typed parse of the network the resolver picked.
+ * Consumers branch on `parsed.mode` (local/live/fork) or derive the chain id
+ * via `chainIdForNetwork(parsed.name)`; there is no second "raw spelling"
+ * field, because the chain id is canonical and never depends on input form.
  */
 interface ResolvedDevstackNetwork {
-  readonly raw: string;
   readonly parsed: ParsedDevstackNetwork;
 }
 /**
@@ -128,5 +142,5 @@ interface ResolveStateDirOptions {
  */
 declare const resolveStateDir: (options: ResolveStateDirOptions) => string;
 //#endregion
-export { DEFAULT_DEVSTACK_NETWORK, DEFAULT_STACK_NAME, DEVSTACK_NETWORK_NAMES, DevstackNetworkName, DevstackNetworkParseError, ParsedDevstackNetwork, ResolveNetworkOptions, ResolveStateDirOptions, ResolvedDevstackNetwork, parseDevstackNetwork, parseDevstackNetworkName, resolveAppName, resolveNetwork, resolveNetworkSync, resolveStackName, resolveStateDir };
+export { DEFAULT_DEVSTACK_NETWORK, DEFAULT_STACK_NAME, DEVSTACK_NETWORK_NAMES, DevstackNetworkName, DevstackNetworkParseError, LOCAL_NETWORK_NAME, ParsedDevstackNetwork, ResolveNetworkOptions, ResolveStateDirOptions, ResolvedDevstackNetwork, chainIdForNetwork, networkNameFromChain, parseDevstackNetwork, parseDevstackNetworkName, resolveAppName, resolveNetwork, resolveNetworkSync, resolveStackName, resolveStateDir };
 //# sourceMappingURL=inference-network.d.mts.map

package/dist/api/inference-network.mjs CHANGED Viewed

@@ -1,13 +1,17 @@
-import { DEFAULT_DISCOVERY_STACK } from "../build-integrations/runtime/resolve-discovery-env.mjs";
 import { Effect } from "effect";
 import { readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 //#region src/api/inference-network.ts
-/** Canonical default stack name (`'main'`). Single source of truth lives
-*  in the discovery ladder's `DEFAULT_DISCOVERY_STACK`; re-exported here
-*  (and from the vitest env module) so all entry points agree on one
-*  literal. */
-const DEFAULT_STACK_NAME = DEFAULT_DISCOVERY_STACK;
+/** Canonical default stack name (`'main'`). The literal's single source
+*  of truth lives HERE: the discovery ladder
+*  (`build-integrations/runtime/resolve-discovery-env.ts`) imports
+*  `inferPackageNameFromCwd` from this module for its package-name
+*  rung, so this module must not import the ladder's consts back — a
+*  two-way top-level-const read would TDZ-crash under one import
+*  order. The ladder re-exports this value as `DEFAULT_DISCOVERY_STACK`
+*  (and the vitest env module as its own `DEFAULT_STACK_NAME`) so all
+*  entry points still agree on one literal. */
+const DEFAULT_STACK_NAME = "main";
 /** Normalize a candidate name: trim, strip an `@scope/` prefix, then
 *  strip any leading non-alphanumeric run. Returns `undefined` for empty
 *  or whitespace-only input, and for inputs that normalize to an empty
@@ -56,7 +60,7 @@ const resolveStackName = (options = {}) => resolveInferredName({
 	envKey: "DEVSTACK_STACK",
 	env: options.env,
 	cwd: options.cwd,
-	defaultName: options.defaultName ?? DEFAULT_STACK_NAME
+	defaultName: options.defaultName ?? "main"
 });
 const resolveAppName = (options = {}) => resolveInferredName({
 	explicit: options.explicit,
@@ -77,24 +81,24 @@ const FORK_DEVSTACK_NETWORK_NAMES = [
 	"devnet-fork"
 ];
 const DEVSTACK_NETWORK_NAMES = [...ACTIVE_DEVSTACK_NETWORK_NAMES, ...FORK_DEVSTACK_NETWORK_NAMES];
-const NETWORK_ALIASES = {
-	local: "localnet",
-	localnet: "localnet",
-	"sui:local": "localnet",
-	"sui:localnet": "localnet",
-	testnet: "testnet",
-	"sui:testnet": "testnet",
-	mainnet: "mainnet",
-	"sui:mainnet": "mainnet",
-	devnet: "devnet",
-	"sui:devnet": "devnet",
-	"testnet-fork": "testnet-fork",
-	"sui:testnet-fork": "testnet-fork",
-	"mainnet-fork": "mainnet-fork",
-	"sui:mainnet-fork": "mainnet-fork",
-	"devnet-fork": "devnet-fork",
-	"sui:devnet-fork": "devnet-fork"
-};
+/** The network every local stack actually runs, and the active key in the
+*  generated `config.ts` (`config.network`, `networks.<key>`, each package's
+*  `byNetwork.<key>`). A fork runs on a local node too, so this is `localnet`
+*  for every mode — the fork's upstream identity lives separately in the
+*  network entry's `forkUpstream`. The sui and package codegen contributions
+*  share this one literal so their active-network keys can never drift. */
+const LOCAL_NETWORK_NAME = "localnet";
+/** Canonical network names accepted as input. There is no alias table:
+*  a network has ONE spelling (`localnet`, `testnet`, …). The chain id is
+*  that name with a `sui:` prefix (see {@link chainIdForNetwork}); the reverse
+*  is stripping the prefix (see {@link networkNameFromChain}). */
+const NETWORK_NAME_SET = new Set(DEVSTACK_NETWORK_NAMES);
+/** The sole network→chain mapping: prefix the canonical name with `sui:`.
+*  `localnet` → `sui:localnet`, `testnet` → `sui:testnet`. No lookup table. */
+const chainIdForNetwork = (name) => `sui:${name}`;
+/** Inverse of {@link chainIdForNetwork}: strip the `sui:` prefix to recover the
+*  network name. Returns the input unchanged if it carries no prefix. */
+const networkNameFromChain = (chain) => chain.replace(/^sui:/, "");
 var DevstackNetworkParseError = class extends Error {
 	_tag = "DevstackNetworkParseError";
 	value;
@@ -110,11 +114,12 @@ var DevstackNetworkParseError = class extends Error {
 };
 const parseDevstackNetwork = (value, source = "DEVSTACK_NETWORK") => {
 	const raw = value?.trim();
-	const name = raw === void 0 || raw.length === 0 ? "localnet" : NETWORK_ALIASES[raw];
-	if (name === void 0) throw new DevstackNetworkParseError({
+	const candidate = raw === void 0 || raw.length === 0 ? "localnet" : raw;
+	if (!NETWORK_NAME_SET.has(candidate)) throw new DevstackNetworkParseError({
 		value: raw ?? "",
 		source
 	});
+	const name = candidate;
 	switch (name) {
 		case "localnet": return {
 			mode: "local",
@@ -137,12 +142,10 @@ const parseDevstackNetwork = (value, source = "DEVSTACK_NETWORK") => {
 	}
 };
 const parseDevstackNetworkName = (value, source = "DEVSTACK_NETWORK") => parseDevstackNetwork(value, source).name;
-/** Default value when neither caller nor env provides one. Kept as a
-*  string (not a `ParsedDevstackNetwork`) because every call site folds
-*  it through `parseDevstackNetwork` first — keeping the default in the
-*  same lookup table the env value flows through avoids two source-of-
-*  truth shapes for "what is the default network?". */
-const DEFAULT_DEVSTACK_NETWORK = "sui:local";
+/** Default network when neither caller nor env provides one — the canonical
+*  name (not a chain id or a `ParsedDevstackNetwork`), because every call site
+*  folds it through `parseDevstackNetwork` first, exactly like an env value. */
+const DEFAULT_DEVSTACK_NETWORK = "localnet";
 const pickInput = (options) => {
 	if (options.explicit !== void 0 && options.explicit.length > 0) return {
 		value: options.explicit,
@@ -153,7 +156,7 @@ const pickInput = (options) => {
 		source: options.envSource ?? "DEVSTACK_NETWORK"
 	};
 	return {
-		value: options.defaultName ?? "sui:local",
+		value: options.defaultName ?? "localnet",
 		source: "default"
 	};
 };
@@ -172,10 +175,7 @@ const pickInput = (options) => {
 const resolveNetwork = (options = {}) => Effect.try({
 	try: () => {
 		const { value, source } = pickInput(options);
-		return {
-			raw: value,
-			parsed: parseDevstackNetwork(value, source)
-		};
+		return { parsed: parseDevstackNetwork(value, source) };
 	},
 	catch: (cause) => cause
 });
@@ -187,10 +187,7 @@ const resolveNetwork = (options = {}) => Effect.try({
 */
 const resolveNetworkSync = (options = {}) => {
 	const { value, source } = pickInput(options);
-	return {
-		raw: value,
-		parsed: parseDevstackNetwork(value, source)
-	};
+	return { parsed: parseDevstackNetwork(value, source) };
 };
 /**
 * Resolve the substrate's on-disk runtime root using the canonical
@@ -206,6 +203,6 @@ const resolveStateDir = (options) => {
 	return resolve(options.cwd, pick);
 };
 //#endregion
-export { DEFAULT_DEVSTACK_NETWORK, DEFAULT_STACK_NAME, DEVSTACK_NETWORK_NAMES, DevstackNetworkParseError, inferPackageNameFromCwd, parseDevstackNetwork, parseDevstackNetworkName, readPackageName, resolveAppName, resolveNetwork, resolveNetworkSync, resolveStackName, resolveStateDir };
+export { DEFAULT_DEVSTACK_NETWORK, DEFAULT_STACK_NAME, DEVSTACK_NETWORK_NAMES, DevstackNetworkParseError, LOCAL_NETWORK_NAME, chainIdForNetwork, inferPackageNameFromCwd, networkNameFromChain, parseDevstackNetwork, parseDevstackNetworkName, readPackageName, resolveAppName, resolveNetwork, resolveNetworkSync, resolveStackName, resolveStateDir };
 //# sourceMappingURL=inference-network.mjs.map

package/dist/api/inference-network.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"inference-network.mjs","names":[],"sources":["../../src/api/inference-network.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\n\nimport { Effect } from 'effect';\n\nimport { DEFAULT_DISCOVERY_STACK } from '../build-integrations/runtime/resolve-discovery-env.ts';\n\n/** Canonical default stack name (`'main'`). Single source of truth lives\n * in the discovery ladder's `DEFAULT_DISCOVERY_STACK`; re-exported here\n * (and from the vitest env module) so all entry points agree on one\n * literal. /\nexport const DEFAULT_STACK_NAME = DEFAULT_DISCOVERY_STACK;\n\nexport interface StackNameResolutionOptions {\n\treadonly explicit?: string;\n\treadonly env?: Readonly<Record<string, string \| undefined>>;\n\treadonly cwd?: string;\n\treadonly defaultName?: string;\n}\n\nexport interface AppNameResolutionOptions {\n\treadonly explicit?: string;\n\treadonly env?: Readonly<Record<string, string \| undefined>>;\n\treadonly cwd?: string;\n\treadonly defaultName?: string;\n}\n\n/* Normalize a candidate name: trim, strip an `@scope/` prefix, then\n * strip any leading non-alphanumeric run. Returns `undefined` for empty\n * or whitespace-only input, and for inputs that normalize to an empty\n * string. Shared by every inferred-name resolver so explicit / env /\n * package paths all reject the same junk. /\nconst usefulName = (value: string \| undefined): string \| undefined => {\n\tconst trimmed = value?.trim();\n\tif (trimmed === undefined \|\| trimmed.length === 0) return undefined;\n\tconst unscoped = trimmed.replace(/^@[^/]+\\//, '').replace(/^[^a-zA-Z0-9]+/, '');\n\treturn unscoped.length > 0 ? unscoped : undefined;\n};\n\nexport const readPackageName = (dir: string): string \| undefined => {\n\ttry {\n\t\tconst pkg = JSON.parse(readFileSync(resolve(dir, 'package.json'), 'utf8')) as {\n\t\t\treadonly name?: string;\n\t\t};\n\t\treturn typeof pkg.name === 'string' ? usefulName(pkg.name) : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n};\n\nexport const inferPackageNameFromCwd = (cwd: string = process.cwd()): string \| undefined => {\n\tlet dir = resolve(cwd);\n\tfor (let i = 0; i < 32; i += 1) {\n\t\tconst name = readPackageName(dir);\n\t\tif (name !== undefined) return name;\n\t\tconst parent = dirname(dir);\n\t\tif (parent === dir) return undefined;\n\t\tdir = parent;\n\t}\n\treturn undefined;\n};\n\n/* Shared `explicit > env > package > default` precedence ladder for the\n * app/stack name resolvers. Each input is fed through `usefulName` so a\n * whitespace-only or junk-prefixed value falls through to the next rung\n * rather than poisoning identity. `envKey` is the environment variable\n * whose value (under `env`) supplies the env rung. /\nconst resolveInferredName = (params: {\n\treadonly explicit: string \| undefined;\n\treadonly envKey: string;\n\treadonly env: Readonly<Record<string, string \| undefined>> \| undefined;\n\treadonly cwd: string \| undefined;\n\treadonly defaultName: string;\n}): string => {\n\tconst explicit = usefulName(params.explicit);\n\tif (explicit !== undefined) return explicit;\n\tconst env = params.env ?? process.env;\n\tconst fromEnv = usefulName(env[params.envKey]);\n\tif (fromEnv !== undefined) return fromEnv;\n\tconst fromPackage = inferPackageNameFromCwd(params.cwd);\n\tif (fromPackage !== undefined) return fromPackage;\n\treturn params.defaultName;\n};\n\nexport const resolveStackName = (options: StackNameResolutionOptions = {}): string =>\n\tresolveInferredName({\n\t\texplicit: options.explicit,\n\t\tenvKey: 'DEVSTACK_STACK',\n\t\tenv: options.env,\n\t\tcwd: options.cwd,\n\t\tdefaultName: options.defaultName ?? DEFAULT_STACK_NAME,\n\t});\n\nexport const resolveAppName = (options: AppNameResolutionOptions = {}): string =>\n\tresolveInferredName({\n\t\texplicit: options.explicit,\n\t\tenvKey: 'DEVSTACK_APP',\n\t\tenv: options.env,\n\t\tcwd: options.cwd,\n\t\tdefaultName: options.defaultName ?? 'devstack',\n\t});\n\nexport const ACTIVE_DEVSTACK_NETWORK_NAMES = ['localnet', 'testnet', 'mainnet', 'devnet'] as const;\n\nexport const FORK_DEVSTACK_NETWORK_NAMES = ['testnet-fork', 'mainnet-fork', 'devnet-fork'] as const;\n\nexport const DEVSTACK_NETWORK_NAMES = [\n\t...ACTIVE_DEVSTACK_NETWORK_NAMES,\n\t...FORK_DEVSTACK_NETWORK_NAMES,\n] as const;\n\nexport type ActiveDevstackNetworkName = (typeof ACTIVE_DEVSTACK_NETWORK_NAMES)[number];\nexport type ForkDevstackNetworkName = (typeof FORK_DEVSTACK_NETWORK_NAMES)[number];\nexport type DevstackNetworkName = (typeof DEVSTACK_NETWORK_NAMES)[number];\nexport type LiveDevstackNetworkName = 'testnet' \| 'mainnet' \| 'devnet';\n\nexport type ParsedDevstackNetwork =\n\t\| {\n\t\t\treadonly mode: 'local';\n\t\t\treadonly name: 'localnet';\n\t }\n\t\| {\n\t\t\treadonly mode: 'live';\n\t\t\treadonly name: LiveDevstackNetworkName;\n\t\t\treadonly network: LiveDevstackNetworkName;\n\t }\n\t\| {\n\t\t\treadonly mode: 'fork';\n\t\t\treadonly name: ForkDevstackNetworkName;\n\t\t\treadonly upstream: LiveDevstackNetworkName;\n\t };\n\nconst NETWORK_ALIASES: Readonly<Record<string, DevstackNetworkName>> = {\n\tlocal: 'localnet',\n\tlocalnet: 'localnet',\n\t'sui:local': 'localnet',\n\t'sui:localnet': 'localnet',\n\ttestnet: 'testnet',\n\t'sui:testnet': 'testnet',\n\tmainnet: 'mainnet',\n\t'sui:mainnet': 'mainnet',\n\tdevnet: 'devnet',\n\t'sui:devnet': 'devnet',\n\t'testnet-fork': 'testnet-fork',\n\t'sui:testnet-fork': 'testnet-fork',\n\t'mainnet-fork': 'mainnet-fork',\n\t'sui:mainnet-fork': 'mainnet-fork',\n\t'devnet-fork': 'devnet-fork',\n\t'sui:devnet-fork': 'devnet-fork',\n};\n\nexport class DevstackNetworkParseError extends Error {\n\treadonly _tag = 'DevstackNetworkParseError';\n\treadonly value: string;\n\treadonly source: string;\n\treadonly supported: ReadonlyArray<DevstackNetworkName>;\n\n\tconstructor(args: { readonly value: string; readonly source: string }) {\n\t\tsuper(\n\t\t\t`${args.source} must be one of: ${DEVSTACK_NETWORK_NAMES.join(', ')} (got ${JSON.stringify(args.value)})`,\n\t\t);\n\t\tthis.name = 'DevstackNetworkParseError';\n\t\tthis.value = args.value;\n\t\tthis.source = args.source;\n\t\tthis.supported = DEVSTACK_NETWORK_NAMES;\n\t}\n}\n\nexport const parseDevstackNetwork = (\n\tvalue: string \| undefined,\n\tsource = 'DEVSTACK_NETWORK',\n): ParsedDevstackNetwork => {\n\tconst raw = value?.trim();\n\tconst name = raw === undefined \|\| raw.length === 0 ? 'localnet' : NETWORK_ALIASES[raw];\n\tif (name === undefined) {\n\t\tthrow new DevstackNetworkParseError({ value: raw ?? '', source });\n\t}\n\tswitch (name) {\n\t\tcase 'localnet':\n\t\t\treturn { mode: 'local', name };\n\t\tcase 'testnet':\n\t\tcase 'mainnet':\n\t\tcase 'devnet':\n\t\t\treturn { mode: 'live', name, network: name };\n\t\tcase 'testnet-fork':\n\t\tcase 'mainnet-fork':\n\t\tcase 'devnet-fork':\n\t\t\treturn {\n\t\t\t\tmode: 'fork',\n\t\t\t\tname,\n\t\t\t\tupstream: name.replace(/-fork$/, '') as LiveDevstackNetworkName,\n\t\t\t};\n\t}\n};\n\nexport const parseDevstackNetworkName = (\n\tvalue: string \| undefined,\n\tsource = 'DEVSTACK_NETWORK',\n): DevstackNetworkName => parseDevstackNetwork(value, source).name;\n\n// ---------------------------------------------------------------------------\n// resolveNetwork — single precedence ladder for every entry point.\n// ---------------------------------------------------------------------------\n\n/\n Options for `resolveNetwork`. `explicit` is the caller-supplied\n * override (typically a CLI flag or programmatic option). `env` is the\n * environment value (typically `process.env.DEVSTACK_NETWORK`).\n * `defaultName` is the final fallback when both miss. The precedence is\n * explicit > env > default. The `source` string is embedded in the\n * parse error's `source` field so the diagnosis names the offending\n * input (e.g. `--network` vs `DEVSTACK_NETWORK`).\n /\nexport interface ResolveNetworkOptions {\n\treadonly explicit?: string \| undefined;\n\treadonly env?: string \| undefined;\n\treadonly defaultName?: string;\n\treadonly explicitSource?: string;\n\treadonly envSource?: string;\n}\n\n/* Default value when neither caller nor env provides one. Kept as a\n * string (not a `ParsedDevstackNetwork`) because every call site folds\n * it through `parseDevstackNetwork` first — keeping the default in the\n * same lookup table the env value flows through avoids two source-of-\n * truth shapes for \"what is the default network?\". /\nexport const DEFAULT_DEVSTACK_NETWORK = 'sui:local' as const;\n\n/\n Result shape — both the typed parse AND the original input string the\n * resolver picked. Consumers that thread the value through chain-keyed\n * caches (the substrate folds chain id into cache namespaces) MUST keep\n * the raw form to preserve existing on-disk cache keys; consumers that\n * branch on mode (local/live/fork) read `parsed`.\n /\nexport interface ResolvedDevstackNetwork {\n\treadonly raw: string;\n\treadonly parsed: ParsedDevstackNetwork;\n}\n\nconst pickInput = (\n\toptions: ResolveNetworkOptions,\n): { readonly value: string; readonly source: string } => {\n\tif (options.explicit !== undefined && options.explicit.length > 0) {\n\t\treturn { value: options.explicit, source: options.explicitSource ?? '--network' };\n\t}\n\tif (options.env !== undefined && options.env.length > 0) {\n\t\treturn { value: options.env, source: options.envSource ?? 'DEVSTACK_NETWORK' };\n\t}\n\treturn { value: options.defaultName ?? DEFAULT_DEVSTACK_NETWORK, source: 'default' };\n};\n\n/\n Resolve a network from the canonical explicit > env > default ladder\n * and parse the winning value through `parseDevstackNetwork`. Returns\n * the typed parse alongside the raw input the resolver picked. A\n * malformed value surfaces as `DevstackNetworkParseError` on the\n * failure channel so CLI / library boot fail fast with a structured\n * error rather than a downstream cryptic message.\n \n Used by both `api/run-stack.ts` (library embedding) and the CLI\n * identity resolver so the two paths share one precedence rule + one\n * parse error type.\n /\nexport const resolveNetwork = (\n\toptions: ResolveNetworkOptions = {},\n): Effect.Effect<ResolvedDevstackNetwork, DevstackNetworkParseError> =>\n\tEffect.try({\n\t\ttry: (): ResolvedDevstackNetwork => {\n\t\t\tconst { value, source } = pickInput(options);\n\t\t\treturn { raw: value, parsed: parseDevstackNetwork(value, source) };\n\t\t},\n\t\tcatch: (cause) => cause as DevstackNetworkParseError,\n\t});\n\n/\n Sync sibling of `resolveNetwork` for entry points that aren't running\n * inside an Effect (the CLI identity resolver builds a plain TS record).\n * Throws `DevstackNetworkParseError` on bad input — caller's job to lift\n * into a typed failure channel if needed.\n /\nexport const resolveNetworkSync = (\n\toptions: ResolveNetworkOptions = {},\n): ResolvedDevstackNetwork => {\n\tconst { value, source } = pickInput(options);\n\treturn { raw: value, parsed: parseDevstackNetwork(value, source) };\n};\n\n// ---------------------------------------------------------------------------\n// resolveStateDir — single precedence ladder for the on-disk runtime root.\n// ---------------------------------------------------------------------------\n\nexport interface ResolveStateDirOptions {\n\t/* Caller-supplied `runtimeRoot` override (the canonical\n\t * `RunStackOptions.runtimeRoot` / CLI `--state-dir` field). Wins\n\t * over every other input. /\n\treadonly runtimeRoot?: string;\n\t/* Caller-supplied `stateDir` override (the\n\t * `DevstackOptions.stateDir` field on `defineDevstack(...)`).\n\t * Lower precedence than `runtimeRoot`. /\n\treadonly stateDir?: string;\n\t/* Env-var value (typically `process.env.DEVSTACK_STATE_DIR`).\n\t * Lower precedence than either explicit override. /\n\treadonly env?: string;\n\t/* Working directory used for the `.devstack` fallback and for\n\t * resolving any relative override path. /\n\treadonly cwd: string;\n}\n\n/\n Resolve the substrate's on-disk runtime root using the canonical\n * precedence ladder: `runtimeRoot` > `stateDir` > `env` > `<cwd>/.devstack`.\n * Relative paths are resolved against `cwd`; absolute paths pass through.\n \n Shared by `runStack`, the CLI bin, and the build-integrations\n * discover module so all three entry points agree on the same ladder.\n */\nexport const resolveStateDir = (options: ResolveStateDirOptions): string => {\n\tconst pick =\n\t\t(options.runtimeRoot !== undefined && options.runtimeRoot.length > 0\n\t\t\t? options.runtimeRoot\n\t\t\t: undefined) ??\n\t\t(options.stateDir !== undefined && options.stateDir.length > 0\n\t\t\t? options.stateDir\n\t\t\t: undefined) ??\n\t\t(options.env !== undefined && options.env.length > 0 ? options.env : undefined);\n\tif (pick === undefined) return resolve(options.cwd, '.devstack');\n\treturn resolve(options.cwd, pick);\n};\n"],"mappings":"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"}
1	+ {"version":3,"file":"inference-network.mjs","names":[],"sources":["../../src/api/inference-network.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\n\nimport { Effect } from 'effect';\n\n/** Canonical default stack name (`'main'`). The literal's single source\n * of truth lives HERE: the discovery ladder\n * (`build-integrations/runtime/resolve-discovery-env.ts`) imports\n * `inferPackageNameFromCwd` from this module for its package-name\n * rung, so this module must not import the ladder's consts back — a\n * two-way top-level-const read would TDZ-crash under one import\n * order. The ladder re-exports this value as `DEFAULT_DISCOVERY_STACK`\n * (and the vitest env module as its own `DEFAULT_STACK_NAME`) so all\n * entry points still agree on one literal. /\nexport const DEFAULT_STACK_NAME = 'main';\n\nexport interface StackNameResolutionOptions {\n\treadonly explicit?: string;\n\treadonly env?: Readonly<Record<string, string \| undefined>>;\n\treadonly cwd?: string;\n\treadonly defaultName?: string;\n}\n\nexport interface AppNameResolutionOptions {\n\treadonly explicit?: string;\n\treadonly env?: Readonly<Record<string, string \| undefined>>;\n\treadonly cwd?: string;\n\treadonly defaultName?: string;\n}\n\n/* Normalize a candidate name: trim, strip an `@scope/` prefix, then\n * strip any leading non-alphanumeric run. Returns `undefined` for empty\n * or whitespace-only input, and for inputs that normalize to an empty\n * string. Shared by every inferred-name resolver so explicit / env /\n * package paths all reject the same junk. /\nconst usefulName = (value: string \| undefined): string \| undefined => {\n\tconst trimmed = value?.trim();\n\tif (trimmed === undefined \|\| trimmed.length === 0) return undefined;\n\tconst unscoped = trimmed.replace(/^@[^/]+\\//, '').replace(/^[^a-zA-Z0-9]+/, '');\n\treturn unscoped.length > 0 ? unscoped : undefined;\n};\n\nexport const readPackageName = (dir: string): string \| undefined => {\n\ttry {\n\t\tconst pkg = JSON.parse(readFileSync(resolve(dir, 'package.json'), 'utf8')) as {\n\t\t\treadonly name?: string;\n\t\t};\n\t\treturn typeof pkg.name === 'string' ? usefulName(pkg.name) : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n};\n\nexport const inferPackageNameFromCwd = (cwd: string = process.cwd()): string \| undefined => {\n\tlet dir = resolve(cwd);\n\tfor (let i = 0; i < 32; i += 1) {\n\t\tconst name = readPackageName(dir);\n\t\tif (name !== undefined) return name;\n\t\tconst parent = dirname(dir);\n\t\tif (parent === dir) return undefined;\n\t\tdir = parent;\n\t}\n\treturn undefined;\n};\n\n/* Shared `explicit > env > package > default` precedence ladder for the\n * app/stack name resolvers. Each input is fed through `usefulName` so a\n * whitespace-only or junk-prefixed value falls through to the next rung\n * rather than poisoning identity. `envKey` is the environment variable\n * whose value (under `env`) supplies the env rung. /\nconst resolveInferredName = (params: {\n\treadonly explicit: string \| undefined;\n\treadonly envKey: string;\n\treadonly env: Readonly<Record<string, string \| undefined>> \| undefined;\n\treadonly cwd: string \| undefined;\n\treadonly defaultName: string;\n}): string => {\n\tconst explicit = usefulName(params.explicit);\n\tif (explicit !== undefined) return explicit;\n\tconst env = params.env ?? process.env;\n\tconst fromEnv = usefulName(env[params.envKey]);\n\tif (fromEnv !== undefined) return fromEnv;\n\tconst fromPackage = inferPackageNameFromCwd(params.cwd);\n\tif (fromPackage !== undefined) return fromPackage;\n\treturn params.defaultName;\n};\n\nexport const resolveStackName = (options: StackNameResolutionOptions = {}): string =>\n\tresolveInferredName({\n\t\texplicit: options.explicit,\n\t\tenvKey: 'DEVSTACK_STACK',\n\t\tenv: options.env,\n\t\tcwd: options.cwd,\n\t\tdefaultName: options.defaultName ?? DEFAULT_STACK_NAME,\n\t});\n\nexport const resolveAppName = (options: AppNameResolutionOptions = {}): string =>\n\tresolveInferredName({\n\t\texplicit: options.explicit,\n\t\tenvKey: 'DEVSTACK_APP',\n\t\tenv: options.env,\n\t\tcwd: options.cwd,\n\t\tdefaultName: options.defaultName ?? 'devstack',\n\t});\n\nexport const ACTIVE_DEVSTACK_NETWORK_NAMES = ['localnet', 'testnet', 'mainnet', 'devnet'] as const;\n\nexport const FORK_DEVSTACK_NETWORK_NAMES = ['testnet-fork', 'mainnet-fork', 'devnet-fork'] as const;\n\nexport const DEVSTACK_NETWORK_NAMES = [\n\t...ACTIVE_DEVSTACK_NETWORK_NAMES,\n\t...FORK_DEVSTACK_NETWORK_NAMES,\n] as const;\n\nexport type ActiveDevstackNetworkName = (typeof ACTIVE_DEVSTACK_NETWORK_NAMES)[number];\nexport type ForkDevstackNetworkName = (typeof FORK_DEVSTACK_NETWORK_NAMES)[number];\nexport type DevstackNetworkName = (typeof DEVSTACK_NETWORK_NAMES)[number];\nexport type LiveDevstackNetworkName = 'testnet' \| 'mainnet' \| 'devnet';\n\n/* The network every local stack actually runs, and the active key in the\n * generated `config.ts` (`config.network`, `networks.<key>`, each package's\n * `byNetwork.<key>`). A fork runs on a local node too, so this is `localnet`\n * for every mode — the fork's upstream identity lives separately in the\n * network entry's `forkUpstream`. The sui and package codegen contributions\n * share this one literal so their active-network keys can never drift. /\nexport const LOCAL_NETWORK_NAME = 'localnet' satisfies DevstackNetworkName;\n\nexport type ParsedDevstackNetwork =\n\t\| {\n\t\t\treadonly mode: 'local';\n\t\t\treadonly name: 'localnet';\n\t }\n\t\| {\n\t\t\treadonly mode: 'live';\n\t\t\treadonly name: LiveDevstackNetworkName;\n\t\t\treadonly network: LiveDevstackNetworkName;\n\t }\n\t\| {\n\t\t\treadonly mode: 'fork';\n\t\t\treadonly name: ForkDevstackNetworkName;\n\t\t\treadonly upstream: LiveDevstackNetworkName;\n\t };\n\n/* Canonical network names accepted as input. There is no alias table:\n * a network has ONE spelling (`localnet`, `testnet`, …). The chain id is\n * that name with a `sui:` prefix (see {@link chainIdForNetwork}); the reverse\n * is stripping the prefix (see {@link networkNameFromChain}). /\nconst NETWORK_NAME_SET: ReadonlySet<string> = new Set(DEVSTACK_NETWORK_NAMES);\n\n/* The sole network→chain mapping: prefix the canonical name with `sui:`.\n * `localnet` → `sui:localnet`, `testnet` → `sui:testnet`. No lookup table. /\nexport const chainIdForNetwork = (name: DevstackNetworkName): string => `sui:${name}`;\n\n/* Inverse of {@link chainIdForNetwork}: strip the `sui:` prefix to recover the\n * network name. Returns the input unchanged if it carries no prefix. /\nexport const networkNameFromChain = (chain: string): string => chain.replace(/^sui:/, '');\n\nexport class DevstackNetworkParseError extends Error {\n\treadonly _tag = 'DevstackNetworkParseError';\n\treadonly value: string;\n\treadonly source: string;\n\treadonly supported: ReadonlyArray<DevstackNetworkName>;\n\n\tconstructor(args: { readonly value: string; readonly source: string }) {\n\t\tsuper(\n\t\t\t`${args.source} must be one of: ${DEVSTACK_NETWORK_NAMES.join(', ')} (got ${JSON.stringify(args.value)})`,\n\t\t);\n\t\tthis.name = 'DevstackNetworkParseError';\n\t\tthis.value = args.value;\n\t\tthis.source = args.source;\n\t\tthis.supported = DEVSTACK_NETWORK_NAMES;\n\t}\n}\n\nexport const parseDevstackNetwork = (\n\tvalue: string \| undefined,\n\tsource = 'DEVSTACK_NETWORK',\n): ParsedDevstackNetwork => {\n\tconst raw = value?.trim();\n\tconst candidate = raw === undefined \|\| raw.length === 0 ? 'localnet' : raw;\n\tif (!NETWORK_NAME_SET.has(candidate)) {\n\t\tthrow new DevstackNetworkParseError({ value: raw ?? '', source });\n\t}\n\tconst name = candidate as DevstackNetworkName;\n\tswitch (name) {\n\t\tcase 'localnet':\n\t\t\treturn { mode: 'local', name };\n\t\tcase 'testnet':\n\t\tcase 'mainnet':\n\t\tcase 'devnet':\n\t\t\treturn { mode: 'live', name, network: name };\n\t\tcase 'testnet-fork':\n\t\tcase 'mainnet-fork':\n\t\tcase 'devnet-fork':\n\t\t\treturn {\n\t\t\t\tmode: 'fork',\n\t\t\t\tname,\n\t\t\t\tupstream: name.replace(/-fork$/, '') as LiveDevstackNetworkName,\n\t\t\t};\n\t}\n};\n\nexport const parseDevstackNetworkName = (\n\tvalue: string \| undefined,\n\tsource = 'DEVSTACK_NETWORK',\n): DevstackNetworkName => parseDevstackNetwork(value, source).name;\n\n// ---------------------------------------------------------------------------\n// resolveNetwork — single precedence ladder for every entry point.\n// ---------------------------------------------------------------------------\n\n/\n Options for `resolveNetwork`. `explicit` is the caller-supplied\n * override (typically a CLI flag or programmatic option). `env` is the\n * environment value (typically `process.env.DEVSTACK_NETWORK`).\n * `defaultName` is the final fallback when both miss. The precedence is\n * explicit > env > default. The `source` string is embedded in the\n * parse error's `source` field so the diagnosis names the offending\n * input (e.g. `--network` vs `DEVSTACK_NETWORK`).\n /\nexport interface ResolveNetworkOptions {\n\treadonly explicit?: string \| undefined;\n\treadonly env?: string \| undefined;\n\treadonly defaultName?: string;\n\treadonly explicitSource?: string;\n\treadonly envSource?: string;\n}\n\n/* Default network when neither caller nor env provides one — the canonical\n * name (not a chain id or a `ParsedDevstackNetwork`), because every call site\n * folds it through `parseDevstackNetwork` first, exactly like an env value. /\nexport const DEFAULT_DEVSTACK_NETWORK = 'localnet' as const;\n\n/\n Result shape — the typed parse of the network the resolver picked.\n * Consumers branch on `parsed.mode` (local/live/fork) or derive the chain id\n * via `chainIdForNetwork(parsed.name)`; there is no second \"raw spelling\"\n * field, because the chain id is canonical and never depends on input form.\n /\nexport interface ResolvedDevstackNetwork {\n\treadonly parsed: ParsedDevstackNetwork;\n}\n\nconst pickInput = (\n\toptions: ResolveNetworkOptions,\n): { readonly value: string; readonly source: string } => {\n\tif (options.explicit !== undefined && options.explicit.length > 0) {\n\t\treturn { value: options.explicit, source: options.explicitSource ?? '--network' };\n\t}\n\tif (options.env !== undefined && options.env.length > 0) {\n\t\treturn { value: options.env, source: options.envSource ?? 'DEVSTACK_NETWORK' };\n\t}\n\treturn { value: options.defaultName ?? DEFAULT_DEVSTACK_NETWORK, source: 'default' };\n};\n\n/\n Resolve a network from the canonical explicit > env > default ladder\n * and parse the winning value through `parseDevstackNetwork`. Returns\n * the typed parse alongside the raw input the resolver picked. A\n * malformed value surfaces as `DevstackNetworkParseError` on the\n * failure channel so CLI / library boot fail fast with a structured\n * error rather than a downstream cryptic message.\n \n Used by both `api/run-stack.ts` (library embedding) and the CLI\n * identity resolver so the two paths share one precedence rule + one\n * parse error type.\n /\nexport const resolveNetwork = (\n\toptions: ResolveNetworkOptions = {},\n): Effect.Effect<ResolvedDevstackNetwork, DevstackNetworkParseError> =>\n\tEffect.try({\n\t\ttry: (): ResolvedDevstackNetwork => {\n\t\t\tconst { value, source } = pickInput(options);\n\t\t\treturn { parsed: parseDevstackNetwork(value, source) };\n\t\t},\n\t\tcatch: (cause) => cause as DevstackNetworkParseError,\n\t});\n\n/\n Sync sibling of `resolveNetwork` for entry points that aren't running\n * inside an Effect (the CLI identity resolver builds a plain TS record).\n * Throws `DevstackNetworkParseError` on bad input — caller's job to lift\n * into a typed failure channel if needed.\n /\nexport const resolveNetworkSync = (\n\toptions: ResolveNetworkOptions = {},\n): ResolvedDevstackNetwork => {\n\tconst { value, source } = pickInput(options);\n\treturn { parsed: parseDevstackNetwork(value, source) };\n};\n\n// ---------------------------------------------------------------------------\n// resolveStateDir — single precedence ladder for the on-disk runtime root.\n// ---------------------------------------------------------------------------\n\nexport interface ResolveStateDirOptions {\n\t/* Caller-supplied `runtimeRoot` override (the canonical\n\t * `RunStackOptions.runtimeRoot` / CLI `--state-dir` field). Wins\n\t * over every other input. /\n\treadonly runtimeRoot?: string;\n\t/* Caller-supplied `stateDir` override (the\n\t * `DevstackOptions.stateDir` field on `defineDevstack(...)`).\n\t * Lower precedence than `runtimeRoot`. /\n\treadonly stateDir?: string;\n\t/* Env-var value (typically `process.env.DEVSTACK_STATE_DIR`).\n\t * Lower precedence than either explicit override. /\n\treadonly env?: string;\n\t/* Working directory used for the `.devstack` fallback and for\n\t * resolving any relative override path. /\n\treadonly cwd: string;\n}\n\n/\n Resolve the substrate's on-disk runtime root using the canonical\n * precedence ladder: `runtimeRoot` > `stateDir` > `env` > `<cwd>/.devstack`.\n * Relative paths are resolved against `cwd`; absolute paths pass through.\n \n Shared by `runStack`, the CLI bin, and the build-integrations\n * discover module so all three entry points agree on the same ladder.\n */\nexport const resolveStateDir = (options: ResolveStateDirOptions): string => {\n\tconst pick =\n\t\t(options.runtimeRoot !== undefined && options.runtimeRoot.length > 0\n\t\t\t? options.runtimeRoot\n\t\t\t: undefined) ??\n\t\t(options.stateDir !== undefined && options.stateDir.length > 0\n\t\t\t? options.stateDir\n\t\t\t: undefined) ??\n\t\t(options.env !== undefined && options.env.length > 0 ? options.env : undefined);\n\tif (pick === undefined) return resolve(options.cwd, '.devstack');\n\treturn resolve(options.cwd, pick);\n};\n"],"mappings":"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"}