@mysten-incubation/devstack 0.0.1 → 0.1.1

package/dist/substrate/runtime/random-suffix.mjs

@@ -0,0 +1,11 @@
+import { randomUUID } from "node:crypto";
+//#region src/substrate/runtime/random-suffix.ts
+/** Mint a random hex suffix of `length` chars. Uses
+*  `crypto.randomUUID()` so collisions are cryptographically
+*  negligible (STYLE_GUIDE §17). `length` is bounded by the UUID's
+*  32 hex chars; callers MUST pass `1..=32`. */
+const mintRandomSuffix = (length) => randomUUID().replace(/-/g, "").slice(0, length);
+//#endregion
+export { mintRandomSuffix };
+
+//# sourceMappingURL=random-suffix.mjs.map

package/dist/substrate/runtime/random-suffix.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-suffix.mjs","names":[],"sources":["../../../src/substrate/runtime/random-suffix.ts"],"sourcesContent":["// Random hex-suffix helper.\n//\n// Snapshot capture names, codegen cycle ids, and restore staging tags\n// all want the same shape: a random hex string of a chosen length,\n// derived from `crypto.randomUUID()` so collisions are\n// cryptographically negligible across same-process parallel callers\n// (the `Math.random()`-based predecessors flagged in STYLE_GUIDE §17\n// did NOT have that guarantee).\n//\n// The choice of length is intentionally a caller knob — different\n// surfaces have different staleness windows and collision tolerance:\n//\n//   - 8 chars: operator-visible names (snapshot id, snap-* prefix).\n//             Short enough to type/share.\n//   - 12 chars: per-stack container-tag suffixes. Wide enough that\n//             two concurrent restores under the same stack don't clash.\n//   - 16 chars: codegen cycle ids — transient staging-directory names\n//             (`.staging.<id>` / `.bak.<id>`) that the substrate rm's\n//             after publish. Defense-in-depth for the race window\n//             where two emit cycles under a custom-CLI caller could\n//             mint overlapping staging dirs against the same shared\n//             outputDir; a collision there would corrupt a half-built\n//             tree, not just clash an operator-visible name.\n//   - 24 chars: restore staging image tags. Image tags are global to\n//             the docker daemon — two parallel restores across stacks\n//             share the namespace, so the extra entropy keeps them\n//             from clashing under heavy CI parallelism.\n\nimport { randomUUID } from 'node:crypto';\n\n/** Mint a random hex suffix of `length` chars. Uses\n *  `crypto.randomUUID()` so collisions are cryptographically\n *  negligible (STYLE_GUIDE §17). `length` is bounded by the UUID's\n *  32 hex chars; callers MUST pass `1..=32`. */\nexport const mintRandomSuffix = (length: number): string =>\n\trandomUUID().replace(/-/g, '').slice(0, length);\n"],"mappings":";;;;;;AAkCA,MAAa,oBAAoB,WAChC,YAAY,CAAC,QAAQ,MAAM,GAAG,CAAC,MAAM,GAAG,OAAO"}

package/dist/substrate/runtime/retry-policy.d.mts

@@ -3,7 +3,7 @@ import * as _$effect_Duration0 from "effect/Duration";
 
 //#region src/substrate/runtime/retry-policy.d.ts
 declare namespace retry_policy_d_exports {
-  export { ExponentialRetryOptions, makeExponentialRetrySchedule, makeSpacedRetrySchedule };
+  export { BALANCE_POLL_PROFILE, DEPLOY_BIND_SOURCE_RETRY_PROFILE, ExponentialRetryOptions, FAUCET_HTTP_RETRY_PROFILE, FUNDING_BALANCE_READ_TIMEOUT_MS, NETWORK_REMOVE_RETRY_PROFILE, STALE_OBJECT_VERSION_RETRY_PROFILE, makeBoundedSpacedSchedule, makeExponentialRetrySchedule, makeSpacedRetrySchedule };
 }
 interface ExponentialRetryOptions {
   readonly initialDelayMs: number;
@@ -13,6 +13,64 @@ interface ExponentialRetryOptions {
 }
 declare const makeExponentialRetrySchedule: (options: ExponentialRetryOptions) => Schedule.Schedule<[_$effect_Duration0.Duration, number], unknown, never, never>;
 declare const makeSpacedRetrySchedule: (delayMs: number, maxRetries: number) => Schedule.Schedule<[number, number], unknown, never, never>;
+/** Wall-clock-bounded fixed-interval poll. Selects "poll every
+ *  `intervalMs` until total elapsed ≥ `timeoutMs`". Returns a
+ *  schedule that callers compose with `Effect.repeat` /
+ *  `Effect.retry` for poll-until-ready loops where the exit
+ *  condition is owned by the caller body.
+ *
+ *  Use for balance polls, post-funding settlement waits, and any
+ *  similar wall-clock-bounded reconciliation loops. */
+declare const makeBoundedSpacedSchedule: (intervalMs: number, timeoutMs: number) => Schedule.Schedule<[number, _$effect_Duration0.Duration], unknown, never, never>;
+/** Balance-poll profile shared by funding settlement waits. The
+ *  interval is short enough to keep wall-clock overshoot small;
+ *  the timeout is the canonical funding settlement budget. */
+declare const BALANCE_POLL_PROFILE: {
+  readonly intervalMs: 250;
+  readonly timeoutMs: 30000;
+};
+/** Single-call deadline for the per-poll balance-reader. Faucet
+ *  RPC calls occasionally hang; the deadline keeps a stalled
+ *  read from starving the surrounding poll loop. */
+declare const FUNDING_BALANCE_READ_TIMEOUT_MS = 5000;
+/** Docker Desktop bind-mount visibility race. The host directory
+ *  is just-created but the Docker VFS hasn't surfaced it yet;
+ *  attempts cap at 5s total (10 × 500ms). */
+declare const DEPLOY_BIND_SOURCE_RETRY_PROFILE: {
+  readonly attempts: 10;
+  readonly delayMs: 500;
+};
+/** HTTP faucet POST retry profile. The faucet's TCP socket binds
+ *  before the validator can transfer coins (a 60s cold-warm
+ *  window). `attempts × backoff` saturates well inside the
+ *  surrounding wall-clock budget. */
+declare const FAUCET_HTTP_RETRY_PROFILE: {
+  readonly maxAttempts: 15;
+  readonly initialDelayMs: 500;
+  readonly backoffFactor: 1.5;
+  readonly wallClockBudgetMs: 90000;
+  readonly perRequestDeadlineMs: 5000;
+};
+/** Sui "stale object version" retry profile — used when a Move call
+ *  references an object that's been mutated by a concurrent transaction
+ *  (deepbook pool seeding hits this when the registry / pool object is
+ *  re-versioned mid-flight). The retry rebuilds the transaction with
+ *  fresh refs each attempt; 20 × 500ms keeps the worst case under 10s. */
+declare const STALE_OBJECT_VERSION_RETRY_PROFILE: {
+  readonly attempts: 20;
+  readonly delayMs: 500;
+};
+/** Docker `network rm` retry profile — used by best-effort network
+ *  prune after our own endpoints are force-disconnected. Foreign
+ *  holders and stale bridge-driver endpoints may keep the network
+ *  busy for a short window; 6 × 250ms saturates well inside the
+ *  prune wall-clock budget while letting transient races resolve.
+ *  Callers may override per-invocation via
+ *  `DevstackNetworkRemovalOptions`. */
+declare const NETWORK_REMOVE_RETRY_PROFILE: {
+  readonly attempts: 6;
+  readonly delayMs: 250;
+};
 //#endregion
 export { retry_policy_d_exports };
 //# sourceMappingURL=retry-policy.d.mts.map

package/dist/substrate/runtime/retry-policy.mjs

@@ -2,6 +2,13 @@ import { __exportAll } from "../../_virtual/_rolldown/runtime.mjs";
 import { Schedule } from "effect";
 //#region src/substrate/runtime/retry-policy.ts
 var retry_policy_exports = /* @__PURE__ */ __exportAll({
+	BALANCE_POLL_PROFILE: () => BALANCE_POLL_PROFILE,
+	DEPLOY_BIND_SOURCE_RETRY_PROFILE: () => DEPLOY_BIND_SOURCE_RETRY_PROFILE,
+	FAUCET_HTTP_RETRY_PROFILE: () => FAUCET_HTTP_RETRY_PROFILE,
+	FUNDING_BALANCE_READ_TIMEOUT_MS: () => FUNDING_BALANCE_READ_TIMEOUT_MS,
+	NETWORK_REMOVE_RETRY_PROFILE: () => NETWORK_REMOVE_RETRY_PROFILE,
+	STALE_OBJECT_VERSION_RETRY_PROFILE: () => STALE_OBJECT_VERSION_RETRY_PROFILE,
+	makeBoundedSpacedSchedule: () => makeBoundedSpacedSchedule,
 	makeExponentialRetrySchedule: () => makeExponentialRetrySchedule,
 	makeSpacedRetrySchedule: () => makeSpacedRetrySchedule
 });
@@ -10,7 +17,65 @@ const makeExponentialRetrySchedule = (options) => {
 	return (options.jitter === false ? schedule : schedule.pipe(Schedule.jittered)).pipe(Schedule.both(Schedule.recurs(options.maxRetries)));
 };
 const makeSpacedRetrySchedule = (delayMs, maxRetries) => Schedule.spaced(`${delayMs} millis`).pipe(Schedule.both(Schedule.recurs(maxRetries)));
+/** Wall-clock-bounded fixed-interval poll. Selects "poll every
+*  `intervalMs` until total elapsed ≥ `timeoutMs`". Returns a
+*  schedule that callers compose with `Effect.repeat` /
+*  `Effect.retry` for poll-until-ready loops where the exit
+*  condition is owned by the caller body.
+*
+*  Use for balance polls, post-funding settlement waits, and any
+*  similar wall-clock-bounded reconciliation loops. */
+const makeBoundedSpacedSchedule = (intervalMs, timeoutMs) => Schedule.both(Schedule.spaced(`${intervalMs} millis`), Schedule.during(`${timeoutMs} millis`));
+/** Balance-poll profile shared by funding settlement waits. The
+*  interval is short enough to keep wall-clock overshoot small;
+*  the timeout is the canonical funding settlement budget. */
+const BALANCE_POLL_PROFILE = {
+	intervalMs: 250,
+	timeoutMs: 3e4
+};
+/** Single-call deadline for the per-poll balance-reader. Faucet
+*  RPC calls occasionally hang; the deadline keeps a stalled
+*  read from starving the surrounding poll loop. */
+const FUNDING_BALANCE_READ_TIMEOUT_MS = 5e3;
+/** Docker Desktop bind-mount visibility race. The host directory
+*  is just-created but the Docker VFS hasn't surfaced it yet;
+*  attempts cap at 5s total (10 × 500ms). */
+const DEPLOY_BIND_SOURCE_RETRY_PROFILE = {
+	attempts: 10,
+	delayMs: 500
+};
+/** HTTP faucet POST retry profile. The faucet's TCP socket binds
+*  before the validator can transfer coins (a 60s cold-warm
+*  window). `attempts × backoff` saturates well inside the
+*  surrounding wall-clock budget. */
+const FAUCET_HTTP_RETRY_PROFILE = {
+	maxAttempts: 15,
+	initialDelayMs: 500,
+	backoffFactor: 1.5,
+	wallClockBudgetMs: 9e4,
+	perRequestDeadlineMs: 5e3
+};
+/** Sui "stale object version" retry profile — used when a Move call
+*  references an object that's been mutated by a concurrent transaction
+*  (deepbook pool seeding hits this when the registry / pool object is
+*  re-versioned mid-flight). The retry rebuilds the transaction with
+*  fresh refs each attempt; 20 × 500ms keeps the worst case under 10s. */
+const STALE_OBJECT_VERSION_RETRY_PROFILE = {
+	attempts: 20,
+	delayMs: 500
+};
+/** Docker `network rm` retry profile — used by best-effort network
+*  prune after our own endpoints are force-disconnected. Foreign
+*  holders and stale bridge-driver endpoints may keep the network
+*  busy for a short window; 6 × 250ms saturates well inside the
+*  prune wall-clock budget while letting transient races resolve.
+*  Callers may override per-invocation via
+*  `DevstackNetworkRemovalOptions`. */
+const NETWORK_REMOVE_RETRY_PROFILE = {
+	attempts: 6,
+	delayMs: 250
+};
 //#endregion
-export { makeExponentialRetrySchedule, makeSpacedRetrySchedule, retry_policy_exports };
+export { BALANCE_POLL_PROFILE, DEPLOY_BIND_SOURCE_RETRY_PROFILE, FAUCET_HTTP_RETRY_PROFILE, FUNDING_BALANCE_READ_TIMEOUT_MS, NETWORK_REMOVE_RETRY_PROFILE, STALE_OBJECT_VERSION_RETRY_PROFILE, makeBoundedSpacedSchedule, makeExponentialRetrySchedule, makeSpacedRetrySchedule, retry_policy_exports };
 
 //# sourceMappingURL=retry-policy.mjs.map

package/dist/substrate/runtime/retry-policy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retry-policy.mjs","names":[],"sources":["../../../src/substrate/runtime/retry-policy.ts"],"sourcesContent":["import { Schedule } from 'effect';\n\nexport interface ExponentialRetryOptions {\n\treadonly initialDelayMs: number;\n\treadonly maxRetries: number;\n\treadonly factor?: number;\n\treadonly jitter?: boolean;\n}\n\nexport const makeExponentialRetrySchedule = (options: ExponentialRetryOptions) => {\n\tconst schedule = Schedule.exponential(`${options.initialDelayMs} millis`, options.factor ?? 2);\n\tconst jittered = options.jitter === false ? schedule : schedule.pipe(Schedule.jittered);\n\treturn jittered.pipe(Schedule.both(Schedule.recurs(options.maxRetries)));\n};\n\nexport const makeSpacedRetrySchedule = (delayMs: number, maxRetries: number) =>\n\tSchedule.spaced(`${delayMs} millis`).pipe(Schedule.both(Schedule.recurs(maxRetries)));\n"],"mappings":";;;;;;;AASA,MAAa,gCAAgC,YAAqC;CACjF,MAAM,WAAW,SAAS,YAAY,GAAG,QAAQ,eAAe,UAAU,QAAQ,UAAU,EAAE;AAE9F,SADiB,QAAQ,WAAW,QAAQ,WAAW,SAAS,KAAK,SAAS,SAAS,EACvE,KAAK,SAAS,KAAK,SAAS,OAAO,QAAQ,WAAW,CAAC,CAAC;;AAGzE,MAAa,2BAA2B,SAAiB,eACxD,SAAS,OAAO,GAAG,QAAQ,SAAS,CAAC,KAAK,SAAS,KAAK,SAAS,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"retry-policy.mjs","names":[],"sources":["../../../src/substrate/runtime/retry-policy.ts"],"sourcesContent":["import { Schedule } from 'effect';\n\nexport interface ExponentialRetryOptions {\n\treadonly initialDelayMs: number;\n\treadonly maxRetries: number;\n\treadonly factor?: number;\n\treadonly jitter?: boolean;\n}\n\nexport const makeExponentialRetrySchedule = (options: ExponentialRetryOptions) => {\n\tconst schedule = Schedule.exponential(`${options.initialDelayMs} millis`, options.factor ?? 2);\n\tconst jittered = options.jitter === false ? schedule : schedule.pipe(Schedule.jittered);\n\treturn jittered.pipe(Schedule.both(Schedule.recurs(options.maxRetries)));\n};\n\nexport const makeSpacedRetrySchedule = (delayMs: number, maxRetries: number) =>\n\tSchedule.spaced(`${delayMs} millis`).pipe(Schedule.both(Schedule.recurs(maxRetries)));\n\n/** Wall-clock-bounded fixed-interval poll. Selects \"poll every\n *  `intervalMs` until total elapsed ≥ `timeoutMs`\". Returns a\n *  schedule that callers compose with `Effect.repeat` /\n *  `Effect.retry` for poll-until-ready loops where the exit\n *  condition is owned by the caller body.\n *\n *  Use for balance polls, post-funding settlement waits, and any\n *  similar wall-clock-bounded reconciliation loops. */\nexport const makeBoundedSpacedSchedule = (intervalMs: number, timeoutMs: number) =>\n\tSchedule.both(Schedule.spaced(`${intervalMs} millis`), Schedule.during(`${timeoutMs} millis`));\n\n/** Balance-poll profile shared by funding settlement waits. The\n *  interval is short enough to keep wall-clock overshoot small;\n *  the timeout is the canonical funding settlement budget. */\nexport const BALANCE_POLL_PROFILE = {\n\tintervalMs: 250,\n\ttimeoutMs: 30_000,\n} as const;\n\n/** Single-call deadline for the per-poll balance-reader. Faucet\n *  RPC calls occasionally hang; the deadline keeps a stalled\n *  read from starving the surrounding poll loop. */\nexport const FUNDING_BALANCE_READ_TIMEOUT_MS = 5_000;\n\n/** Docker Desktop bind-mount visibility race. The host directory\n *  is just-created but the Docker VFS hasn't surfaced it yet;\n *  attempts cap at 5s total (10 × 500ms). */\nexport const DEPLOY_BIND_SOURCE_RETRY_PROFILE = {\n\tattempts: 10,\n\tdelayMs: 500,\n} as const;\n\n/** HTTP faucet POST retry profile. The faucet's TCP socket binds\n *  before the validator can transfer coins (a 60s cold-warm\n *  window). `attempts × backoff` saturates well inside the\n *  surrounding wall-clock budget. */\nexport const FAUCET_HTTP_RETRY_PROFILE = {\n\tmaxAttempts: 15,\n\tinitialDelayMs: 500,\n\tbackoffFactor: 1.5,\n\twallClockBudgetMs: 90_000,\n\tperRequestDeadlineMs: 5_000,\n} as const;\n\n/** Sui \"stale object version\" retry profile — used when a Move call\n *  references an object that's been mutated by a concurrent transaction\n *  (deepbook pool seeding hits this when the registry / pool object is\n *  re-versioned mid-flight). The retry rebuilds the transaction with\n *  fresh refs each attempt; 20 × 500ms keeps the worst case under 10s. */\nexport const STALE_OBJECT_VERSION_RETRY_PROFILE = {\n\tattempts: 20,\n\tdelayMs: 500,\n} as const;\n\n/** Docker `network rm` retry profile — used by best-effort network\n *  prune after our own endpoints are force-disconnected. Foreign\n *  holders and stale bridge-driver endpoints may keep the network\n *  busy for a short window; 6 × 250ms saturates well inside the\n *  prune wall-clock budget while letting transient races resolve.\n *  Callers may override per-invocation via\n *  `DevstackNetworkRemovalOptions`. */\nexport const NETWORK_REMOVE_RETRY_PROFILE = {\n\tattempts: 6,\n\tdelayMs: 250,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;AASA,MAAa,gCAAgC,YAAqC;CACjF,MAAM,WAAW,SAAS,YAAY,GAAG,QAAQ,eAAe,UAAU,QAAQ,UAAU,EAAE;AAE9F,SADiB,QAAQ,WAAW,QAAQ,WAAW,SAAS,KAAK,SAAS,SAAS,EACvE,KAAK,SAAS,KAAK,SAAS,OAAO,QAAQ,WAAW,CAAC,CAAC;;AAGzE,MAAa,2BAA2B,SAAiB,eACxD,SAAS,OAAO,GAAG,QAAQ,SAAS,CAAC,KAAK,SAAS,KAAK,SAAS,OAAO,WAAW,CAAC,CAAC;;;;;;;;;AAUtF,MAAa,6BAA6B,YAAoB,cAC7D,SAAS,KAAK,SAAS,OAAO,GAAG,WAAW,SAAS,EAAE,SAAS,OAAO,GAAG,UAAU,SAAS,CAAC;;;;AAK/F,MAAa,uBAAuB;CACnC,YAAY;CACZ,WAAW;CACX;;;;AAKD,MAAa,kCAAkC;;;;AAK/C,MAAa,mCAAmC;CAC/C,UAAU;CACV,SAAS;CACT;;;;;AAMD,MAAa,4BAA4B;CACxC,aAAa;CACb,gBAAgB;CAChB,eAAe;CACf,mBAAmB;CACnB,sBAAsB;CACtB;;;;;;AAOD,MAAa,qCAAqC;CACjD,UAAU;CACV,SAAS;CACT;;;;;;;;AASD,MAAa,+BAA+B;CAC3C,UAAU;CACV,SAAS;CACT"}

package/dist/substrate/runtime/routed-url.d.mts

@@ -0,0 +1 @@
+import { Effect, Schema } from "effect";

package/dist/substrate/runtime/routed-url.mjs

@@ -0,0 +1,79 @@
+import { Effect, Schema } from "effect";
+//#region src/substrate/runtime/routed-url.ts
+/** The conventional "default" stack name. Hostnames for this stack omit
+*  the stack segment per the architecture's UX rule. */
+const DEFAULT_STACK = "main";
+const LABEL = /^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/;
+const MAX_HOSTNAME_LEN = 200;
+/** A user-influenceable hostname-segment string did not pass
+*  validation. Substrate-blind shape mirroring the orchestrator's
+*  `RouterValidationError`; L3 orchestrators wrap this into their
+*  richer error union for internal composition. */
+var HostnameValidationError = class extends Schema.TaggedErrorClass()("HostnameValidationError", {
+	field: Schema.Literals([
+		"hostname",
+		"dispatchId",
+		"entrypointName",
+		"upstreamUrl"
+	]),
+	value: Schema.String,
+	detail: Schema.String
+}) {};
+/** Validate a single label-shaped string. */
+const validateLabel = (field, value) => {
+	if (!LABEL.test(value)) return Effect.fail(new HostnameValidationError({
+		field,
+		value,
+		detail: "expected lower-case RFC-1035 label (alphanumeric + internal hyphens, 1-63 chars)"
+	}));
+	return Effect.succeed(value);
+};
+/** Fold dots → hyphens (architecture invariant #8) and lower-case.
+*  Pure, no validation. The output is fed to `validateLabel`. */
+const normalizeServiceSegment = (raw) => raw.toLowerCase().replace(/\./g, "-");
+/** Mint the per-Routable hostname from `(identity, role)`.
+*
+*  Default stack: `<role>.<app>.localhost`
+*  Other stacks:  `<role>.<stack>.<app>.localhost`
+*
+*  Substrate-blind: the substrate knows about identities (app, stack)
+*  and arbitrary role strings — it does not know about specific plugins
+*  or services. L2 plugins call this directly; L3 orchestrators wrap
+*  the failure case into their richer error union. */
+const routedHostname = (identity, role) => Effect.gen(function* () {
+	const app = yield* validateLabel("hostname", identity.app);
+	const roleSafe = yield* validateLabel("hostname", normalizeServiceSegment(role));
+	const stackSafe = identity.stack === "main" ? null : yield* validateLabel("hostname", identity.stack.toLowerCase());
+	const assembled = stackSafe === null ? `${roleSafe}.${app}.localhost` : `${roleSafe}.${stackSafe}.${app}.localhost`;
+	if (assembled.length > MAX_HOSTNAME_LEN) return yield* Effect.fail(new HostnameValidationError({
+		field: "hostname",
+		value: assembled,
+		detail: `exceeds ${MAX_HOSTNAME_LEN}-char limit`
+	}));
+	return assembled;
+});
+/** Pure URL composer.
+*
+*  - `http` / `h2c` → `http://…` (h2c is HTTP/2 cleartext; Traefik
+*    handles upstream selection internally, the URL scheme stays
+*    `http`).
+*  - `https`        → `https://…`.
+*  - `tcp`          → `tcp://…` — used by the file-provider renderer
+*    to distinguish from HTTP at YAML-emit time. Consumers of the
+*    resolved URL (manifest, codegen) translate back to whatever
+*    scheme their protocol expects (e.g. `postgres://`, `redis://`).
+*
+*  The port is always included in the rendered URL (no well-known-port
+*  omission); the file-provider renderer parses the URL back into
+*  `(assembled, port)` for the TCP `address:` field and would reject a
+*  port-less form. `path` is appended verbatim when supplied (it MUST
+*  include the leading slash). */
+const renderUrl = (parts) => {
+	const scheme = parts.protocol === "https" ? "https" : parts.protocol === "tcp" ? "tcp" : "http";
+	const path = parts.path ?? "";
+	return `${scheme}://${parts.hostname}:${parts.port}${path}`;
+};
+//#endregion
+export { DEFAULT_STACK, normalizeServiceSegment, renderUrl, routedHostname };
+
+//# sourceMappingURL=routed-url.mjs.map

package/dist/substrate/runtime/routed-url.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"routed-url.mjs","names":[],"sources":["../../../src/substrate/runtime/routed-url.ts"],"sourcesContent":["// Substrate-blind URL composer + routed-hostname accessor.\n//\n// Consumed by L2 plugins (wallet, sui modes, future authors) so plugin\n// code does not reach across the L2→L3 boundary into\n// `orchestrators/router/hostname.ts`. The pure URL composition and\n// hostname-minting logic depends only on `substrate/identity.ts` and is\n// genuinely substrate-level; lifting it here removes a long-standing\n// boundary violation flagged in ARCHITECTURE.md (L2 row: \"NEVER imports\n// from … L3 orchestrators\").\n//\n// Architecture invariants honoured (mirrored from the original\n// orchestrators/router/hostname.ts authoritative comment):\n//\n//   #7  — Distinct `(app, stack, role)` triples MUST produce distinct\n//          hostnames. Default stack ('main') omits the stack segment;\n//          every other stack includes it.\n//   #8  — Hostname service labels fold dots to a label-safe separator\n//          before validation.\n//   #13 — User-influenceable strings are validated against a\n//          conservative character set before render.\n//\n// The L3 router orchestrator imports from here and adapts the\n// substrate-blind `HostnameValidationError` into its richer\n// `RouterError` union for orchestrator-internal callers (file-provider,\n// resolveRoute) that compose with `UnknownEntrypoint`, `RouteCollision`,\n// etc. Substrate stays name-blind: this module mentions no plugin or\n// orchestrator identifiers.\n\nimport { Effect, Schema } from 'effect';\n\nimport type { Identity } from '../identity.ts';\n\n/** The conventional \"default\" stack name. Hostnames for this stack omit\n *  the stack segment per the architecture's UX rule. */\nexport const DEFAULT_STACK = 'main';\n\n// RFC-1035 single-label regex: starts/ends with alphanumeric, allows\n// internal hyphens, length 1-63. Used for app, role, and (post-fold)\n// stack labels.\nconst LABEL = /^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/;\n// 253 chars is the RFC-1035 full-name max. We stay well below.\nconst MAX_HOSTNAME_LEN = 200;\n\n/** A user-influenceable hostname-segment string did not pass\n *  validation. Substrate-blind shape mirroring the orchestrator's\n *  `RouterValidationError`; L3 orchestrators wrap this into their\n *  richer error union for internal composition. */\nexport class HostnameValidationError extends Schema.TaggedErrorClass<HostnameValidationError>()(\n\t'HostnameValidationError',\n\t{\n\t\tfield: Schema.Literals(['hostname', 'dispatchId', 'entrypointName', 'upstreamUrl']),\n\t\tvalue: Schema.String,\n\t\tdetail: Schema.String,\n\t},\n) {}\n\n/** Validate a single label-shaped string. */\nconst validateLabel = (\n\tfield: HostnameValidationError['field'],\n\tvalue: string,\n): Effect.Effect<string, HostnameValidationError> => {\n\tif (!LABEL.test(value)) {\n\t\treturn Effect.fail(\n\t\t\tnew HostnameValidationError({\n\t\t\t\tfield,\n\t\t\t\tvalue,\n\t\t\t\tdetail: 'expected lower-case RFC-1035 label (alphanumeric + internal hyphens, 1-63 chars)',\n\t\t\t}),\n\t\t);\n\t}\n\treturn Effect.succeed(value);\n};\n\n/** Fold dots → hyphens (architecture invariant #8) and lower-case.\n *  Pure, no validation. The output is fed to `validateLabel`. */\nexport const normalizeServiceSegment = (raw: string): string =>\n\traw.toLowerCase().replace(/\\./g, '-');\n\n/** Mint the per-Routable hostname from `(identity, role)`.\n *\n *  Default stack: `<role>.<app>.localhost`\n *  Other stacks:  `<role>.<stack>.<app>.localhost`\n *\n *  Substrate-blind: the substrate knows about identities (app, stack)\n *  and arbitrary role strings — it does not know about specific plugins\n *  or services. L2 plugins call this directly; L3 orchestrators wrap\n *  the failure case into their richer error union. */\nexport const routedHostname = (\n\tidentity: Identity,\n\trole: string,\n): Effect.Effect<string, HostnameValidationError> =>\n\tEffect.gen(function* () {\n\t\tconst app = yield* validateLabel('hostname', identity.app);\n\t\tconst folded = normalizeServiceSegment(role);\n\t\tconst roleSafe = yield* validateLabel('hostname', folded);\n\t\t// The `StackName` brand does NOT character-validate at construction\n\t\t// (`brand.ts` / `api/inference-network.ts:resolveStackName`), so we\n\t\t// re-validate here for parity with `app`. A malformed stack name\n\t\t// (uppercase / underscores / out-of-RFC-1035 chars) must fail at\n\t\t// hostname assembly, not silently pass through.\n\t\tconst stackSafe =\n\t\t\tidentity.stack === DEFAULT_STACK\n\t\t\t\t? null\n\t\t\t\t: yield* validateLabel('hostname', identity.stack.toLowerCase());\n\t\tconst assembled =\n\t\t\tstackSafe === null\n\t\t\t\t? `${roleSafe}.${app}.localhost`\n\t\t\t\t: `${roleSafe}.${stackSafe}.${app}.localhost`;\n\t\tif (assembled.length > MAX_HOSTNAME_LEN) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew HostnameValidationError({\n\t\t\t\t\tfield: 'hostname',\n\t\t\t\t\tvalue: assembled,\n\t\t\t\t\tdetail: `exceeds ${MAX_HOSTNAME_LEN}-char limit`,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t\treturn assembled;\n\t});\n\n/** Pure URL composer.\n *\n *  - `http` / `h2c` → `http://…` (h2c is HTTP/2 cleartext; Traefik\n *    handles upstream selection internally, the URL scheme stays\n *    `http`).\n *  - `https`        → `https://…`.\n *  - `tcp`          → `tcp://…` — used by the file-provider renderer\n *    to distinguish from HTTP at YAML-emit time. Consumers of the\n *    resolved URL (manifest, codegen) translate back to whatever\n *    scheme their protocol expects (e.g. `postgres://`, `redis://`).\n *\n *  The port is always included in the rendered URL (no well-known-port\n *  omission); the file-provider renderer parses the URL back into\n *  `(assembled, port)` for the TCP `address:` field and would reject a\n *  port-less form. `path` is appended verbatim when supplied (it MUST\n *  include the leading slash). */\nexport const renderUrl = (parts: {\n\treadonly protocol: 'http' | 'https' | 'h2c' | 'tcp';\n\treadonly hostname: string;\n\treadonly port: number;\n\treadonly path?: string;\n}): string => {\n\tconst scheme = parts.protocol === 'https' ? 'https' : parts.protocol === 'tcp' ? 'tcp' : 'http';\n\tconst path = parts.path ?? '';\n\treturn `${scheme}://${parts.hostname}:${parts.port}${path}`;\n};\n"],"mappings":";;;;AAkCA,MAAa,gBAAgB;AAK7B,MAAM,QAAQ;AAEd,MAAM,mBAAmB;;;;;AAMzB,IAAa,0BAAb,cAA6C,OAAO,kBAA2C,CAC9F,2BACA;CACC,OAAO,OAAO,SAAS;EAAC;EAAY;EAAc;EAAkB;EAAc,CAAC;CACnF,OAAO,OAAO;CACd,QAAQ,OAAO;CACf,CACD,CAAC;;AAGF,MAAM,iBACL,OACA,UACoD;AACpD,KAAI,CAAC,MAAM,KAAK,MAAM,CACrB,QAAO,OAAO,KACb,IAAI,wBAAwB;EAC3B;EACA;EACA,QAAQ;EACR,CAAC,CACF;AAEF,QAAO,OAAO,QAAQ,MAAM;;;;AAK7B,MAAa,2BAA2B,QACvC,IAAI,aAAa,CAAC,QAAQ,OAAO,IAAI;;;;;;;;;;AAWtC,MAAa,kBACZ,UACA,SAEA,OAAO,IAAI,aAAa;CACvB,MAAM,MAAM,OAAO,cAAc,YAAY,SAAS,IAAI;CAE1D,MAAM,WAAW,OAAO,cAAc,YADvB,wBAAwB,KACiB,CAAC;CAMzD,MAAM,YACL,SAAS,UAAA,SACN,OACA,OAAO,cAAc,YAAY,SAAS,MAAM,aAAa,CAAC;CAClE,MAAM,YACL,cAAc,OACX,GAAG,SAAS,GAAG,IAAI,cACnB,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI;AACpC,KAAI,UAAU,SAAS,iBACtB,QAAO,OAAO,OAAO,KACpB,IAAI,wBAAwB;EAC3B,OAAO;EACP,OAAO;EACP,QAAQ,WAAW,iBAAiB;EACpC,CAAC,CACF;AAEF,QAAO;EACN;;;;;;;;;;;;;;;;;AAkBH,MAAa,aAAa,UAKZ;CACb,MAAM,SAAS,MAAM,aAAa,UAAU,UAAU,MAAM,aAAa,QAAQ,QAAQ;CACzF,MAAM,OAAO,MAAM,QAAQ;AAC3B,QAAO,GAAG,OAAO,KAAK,MAAM,SAAS,GAAG,MAAM,OAAO"}

package/dist/substrate/runtime/runtime-decode.d.mts

@@ -28,5 +28,5 @@ declare const decodeJsonTextSync: <S extends Schema.Decoder<unknown>, E>(schema:
 declare const decodeJsonArrayElementSync: <S extends Schema.Decoder<unknown>, E>(schema: S, text: string, options: JsonArrayElementDecodeOptions<E>) => S["Type"];
 declare const decodeJsonLines: <S extends Schema.Decoder<unknown>, E>(schema: S, text: string, options: DecodeOptions<E>) => Effect.Effect<ReadonlyArray<S["Type"]>, E>;
 //#endregion
-export { runtime_decode_d_exports };
+export { decodeUnknownSync, parseJsonTextSync, runtime_decode_d_exports };
 //# sourceMappingURL=runtime-decode.d.mts.map

package/dist/substrate/runtime/runtime-decode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-decode.mjs","names":[],"sources":["../../../src/substrate/runtime/runtime-decode.ts"],"sourcesContent":["import { Effect, Schema } from 'effect';\n\nexport interface RuntimeDecodeIssue {\n\treadonly source: string;\n\treadonly message: string;\n\treadonly cause?: unknown;\n}\n\nexport type RuntimeDecodeErrorFactory<E> = (issue: RuntimeDecodeIssue) => E;\n\nexport interface DecodeOptions<E> {\n\treadonly source: string;\n\treadonly mkError: RuntimeDecodeErrorFactory<E>;\n\treadonly message?: string;\n}\n\nexport interface JsonArrayElementDecodeOptions<E> extends DecodeOptions<E> {\n\treadonly index?: number;\n\treadonly missingMessage?: string;\n}\n\nconst issue = <E>(\n\toptions: DecodeOptions<E>,\n\tmessage: string,\n\tcause?: unknown,\n): RuntimeDecodeIssue => ({\n\tsource: options.source,\n\tmessage: options.message ?? message,\n\t...(cause === undefined ? {} : { cause }),\n});\n\nexport const parseJsonText = <E>(\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<unknown, E> =>\n\tEffect.try({\n\t\ttry: () => JSON.parse(text) as unknown,\n\t\tcatch: (cause) => options.mkError(issue(options, 'failed to parse JSON', cause)),\n\t});\n\nexport const parseJsonTextSync = <E>(text: string, options: DecodeOptions<E>): unknown => {\n\ttry {\n\t\treturn JSON.parse(text) as unknown;\n\t} catch (cause) {\n\t\tthrow options.mkError(issue(options, 'failed to parse JSON', cause));\n\t}\n};\n\nexport const decodeUnknown = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\tvalue: unknown,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<S['Type'], E> =>\n\tSchema.decodeUnknownEffect(schema)(value).pipe(\n\t\tEffect.mapError((cause) => options.mkError(issue(options, 'failed to decode value', cause))),\n\t);\n\nexport const decodeUnknownSync = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\tvalue: unknown,\n\toptions: DecodeOptions<E>,\n): S['Type'] => {\n\ttry {\n\t\treturn Schema.decodeUnknownSync(schema)(value);\n\t} catch (cause) {\n\t\tthrow options.mkError(issue(options, 'failed to decode value', cause));\n\t}\n};\n\nexport const decodeJsonText = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<S['Type'], E> =>\n\tparseJsonText(text, options).pipe(\n\t\tEffect.flatMap((value) => decodeUnknown(schema, value, options)),\n\t);\n\nexport const decodeJsonTextSync = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): S['Type'] => decodeUnknownSync(schema, parseJsonTextSync(text, options), options);\n\nexport const decodeJsonArrayElementSync = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: JsonArrayElementDecodeOptions<E>,\n): S['Type'] => {\n\tconst index = options.index ?? 0;\n\tconst value = parseJsonTextSync(text, options);\n\tif (!Array.isArray(value) || value[index] === undefined) {\n\t\tthrow options.mkError(\n\t\t\tissue(\n\t\t\t\toptions,\n\t\t\t\toptions.missingMessage ?? `expected JSON array element at index ${index}`,\n\t\t\t\tvalue,\n\t\t\t),\n\t\t);\n\t}\n\treturn decodeUnknownSync(schema, value[index], options);\n};\n\nexport const decodeJsonLines = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<ReadonlyArray<S['Type']>, E> =>\n\tEffect.forEach(\n\t\ttext\n\t\t\t.split(/\\r?\\n/u)\n\t\t\t.map((line) => line.trim())\n\t\t\t.filter((line) => line.length > 0),\n\t\t(line, index) =>\n\t\t\tdecodeJsonText(schema, line, {\n\t\t\t\t...options,\n\t\t\t\tsource: `${options.source}:${index + 1}`,\n\t\t\t}),\n\t);\n"],"mappings":";;;;;;;;;;;;;AAqBA,MAAM,SACL,SACA,SACA,WACyB;CACzB,QAAQ,QAAQ;CAChB,SAAS,QAAQ,WAAW;CAC5B,GAAI,UAAU,KAAA,IAAY,EAAE,GAAG,EAAE,OAAO;CACxC;AAED,MAAa,iBACZ,MACA,YAEA,OAAO,IAAI;CACV,WAAW,KAAK,MAAM,KAAK;CAC3B,QAAQ,UAAU,QAAQ,QAAQ,MAAM,SAAS,wBAAwB,MAAM,CAAC;CAChF,CAAC;AAEH,MAAa,qBAAwB,MAAc,YAAuC;AACzF,KAAI;AACH,SAAO,KAAK,MAAM,KAAK;UACf,OAAO;AACf,QAAM,QAAQ,QAAQ,MAAM,SAAS,wBAAwB,MAAM,CAAC;;;AAItE,MAAa,iBACZ,QACA,OACA,YAEA,OAAO,oBAAoB,OAAO,CAAC,MAAM,CAAC,KACzC,OAAO,UAAU,UAAU,QAAQ,QAAQ,MAAM,SAAS,0BAA0B,MAAM,CAAC,CAAC,CAC5F;AAEF,MAAa,qBACZ,QACA,OACA,YACe;AACf,KAAI;AACH,SAAO,OAAO,kBAAkB,OAAO,CAAC,MAAM;UACtC,OAAO;AACf,QAAM,QAAQ,QAAQ,MAAM,SAAS,0BAA0B,MAAM,CAAC;;;AAIxE,MAAa,kBACZ,QACA,MACA,YAEA,cAAc,MAAM,QAAQ,CAAC,KAC5B,OAAO,SAAS,UAAU,cAAc,QAAQ,OAAO,QAAQ,CAAC,CAChE;AAEF,MAAa,sBACZ,QACA,MACA,YACe,kBAAkB,QAAQ,kBAAkB,MAAM,QAAQ,EAAE,QAAQ;AAEpF,MAAa,8BACZ,QACA,MACA,YACe;CACf,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,QAAQ,kBAAkB,MAAM,QAAQ;AAC9C,KAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW,KAAA,EAC7C,OAAM,QAAQ,QACb,MACC,SACA,QAAQ,kBAAkB,wCAAwC,SAClE,MACA,CACD;AAEF,QAAO,kBAAkB,QAAQ,MAAM,QAAQ,QAAQ;;AAGxD,MAAa,mBACZ,QACA,MACA,YAEA,OAAO,QACN,KACE,MAAM,SAAS,CACf,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,QAAQ,SAAS,KAAK,SAAS,EAAE,GAClC,MAAM,UACN,eAAe,QAAQ,MAAM;CAC5B,GAAG;CACH,QAAQ,GAAG,QAAQ,OAAO,GAAG,QAAQ;CACrC,CAAC,CACH"}
+{"version":3,"file":"runtime-decode.mjs","names":[],"sources":["../../../src/substrate/runtime/runtime-decode.ts"],"sourcesContent":["// Compound Schema decode at trust boundaries — JSON / unknown →\n// typed values, with one parse/decode issue shape and typed error\n// projection. Reach for `decodeUnknown(Sync)` /\n// `decodeJsonText(Sync)` when you have a Schema and want to decode\n// a whole shape (multi-field, refinements, transforms).\n//\n// For one-field shape checks (\"port must be a positive integer\",\n// \"name must be a non-empty string\") that throw on bad input,\n// reach for the `expect*` helpers in `config-validation.ts` instead.\n\nimport { Effect, Schema } from 'effect';\n\nexport interface RuntimeDecodeIssue {\n\treadonly source: string;\n\treadonly message: string;\n\treadonly cause?: unknown;\n}\n\nexport type RuntimeDecodeErrorFactory<E> = (issue: RuntimeDecodeIssue) => E;\n\nexport interface DecodeOptions<E> {\n\treadonly source: string;\n\treadonly mkError: RuntimeDecodeErrorFactory<E>;\n\treadonly message?: string;\n}\n\nexport interface JsonArrayElementDecodeOptions<E> extends DecodeOptions<E> {\n\treadonly index?: number;\n\treadonly missingMessage?: string;\n}\n\nconst issue = <E>(\n\toptions: DecodeOptions<E>,\n\tmessage: string,\n\tcause?: unknown,\n): RuntimeDecodeIssue => ({\n\tsource: options.source,\n\tmessage: options.message ?? message,\n\t...(cause === undefined ? {} : { cause }),\n});\n\nexport const parseJsonText = <E>(\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<unknown, E> =>\n\tEffect.try({\n\t\ttry: () => JSON.parse(text) as unknown,\n\t\tcatch: (cause) => options.mkError(issue(options, 'failed to parse JSON', cause)),\n\t});\n\nexport const parseJsonTextSync = <E>(text: string, options: DecodeOptions<E>): unknown => {\n\ttry {\n\t\treturn JSON.parse(text) as unknown;\n\t} catch (cause) {\n\t\tthrow options.mkError(issue(options, 'failed to parse JSON', cause));\n\t}\n};\n\nexport const decodeUnknown = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\tvalue: unknown,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<S['Type'], E> =>\n\tSchema.decodeUnknownEffect(schema)(value).pipe(\n\t\tEffect.mapError((cause) => options.mkError(issue(options, 'failed to decode value', cause))),\n\t);\n\nexport const decodeUnknownSync = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\tvalue: unknown,\n\toptions: DecodeOptions<E>,\n): S['Type'] => {\n\ttry {\n\t\treturn Schema.decodeUnknownSync(schema)(value);\n\t} catch (cause) {\n\t\tthrow options.mkError(issue(options, 'failed to decode value', cause));\n\t}\n};\n\nexport const decodeJsonText = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<S['Type'], E> =>\n\tparseJsonText(text, options).pipe(\n\t\tEffect.flatMap((value) => decodeUnknown(schema, value, options)),\n\t);\n\nexport const decodeJsonTextSync = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): S['Type'] => decodeUnknownSync(schema, parseJsonTextSync(text, options), options);\n\nexport const decodeJsonArrayElementSync = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: JsonArrayElementDecodeOptions<E>,\n): S['Type'] => {\n\tconst index = options.index ?? 0;\n\tconst value = parseJsonTextSync(text, options);\n\tif (!Array.isArray(value) || value[index] === undefined) {\n\t\tthrow options.mkError(\n\t\t\tissue(\n\t\t\t\toptions,\n\t\t\t\toptions.missingMessage ?? `expected JSON array element at index ${index}`,\n\t\t\t\tvalue,\n\t\t\t),\n\t\t);\n\t}\n\treturn decodeUnknownSync(schema, value[index], options);\n};\n\nexport const decodeJsonLines = <S extends Schema.Decoder<unknown>, E>(\n\tschema: S,\n\ttext: string,\n\toptions: DecodeOptions<E>,\n): Effect.Effect<ReadonlyArray<S['Type']>, E> =>\n\tEffect.forEach(\n\t\ttext\n\t\t\t.split(/\\r?\\n/u)\n\t\t\t.map((line) => line.trim())\n\t\t\t.filter((line) => line.length > 0),\n\t\t(line, index) =>\n\t\t\tdecodeJsonText(schema, line, {\n\t\t\t\t...options,\n\t\t\t\tsource: `${options.source}:${index + 1}`,\n\t\t\t}),\n\t);\n"],"mappings":";;;;;;;;;;;;;AA+BA,MAAM,SACL,SACA,SACA,WACyB;CACzB,QAAQ,QAAQ;CAChB,SAAS,QAAQ,WAAW;CAC5B,GAAI,UAAU,KAAA,IAAY,EAAE,GAAG,EAAE,OAAO;CACxC;AAED,MAAa,iBACZ,MACA,YAEA,OAAO,IAAI;CACV,WAAW,KAAK,MAAM,KAAK;CAC3B,QAAQ,UAAU,QAAQ,QAAQ,MAAM,SAAS,wBAAwB,MAAM,CAAC;CAChF,CAAC;AAEH,MAAa,qBAAwB,MAAc,YAAuC;AACzF,KAAI;AACH,SAAO,KAAK,MAAM,KAAK;UACf,OAAO;AACf,QAAM,QAAQ,QAAQ,MAAM,SAAS,wBAAwB,MAAM,CAAC;;;AAItE,MAAa,iBACZ,QACA,OACA,YAEA,OAAO,oBAAoB,OAAO,CAAC,MAAM,CAAC,KACzC,OAAO,UAAU,UAAU,QAAQ,QAAQ,MAAM,SAAS,0BAA0B,MAAM,CAAC,CAAC,CAC5F;AAEF,MAAa,qBACZ,QACA,OACA,YACe;AACf,KAAI;AACH,SAAO,OAAO,kBAAkB,OAAO,CAAC,MAAM;UACtC,OAAO;AACf,QAAM,QAAQ,QAAQ,MAAM,SAAS,0BAA0B,MAAM,CAAC;;;AAIxE,MAAa,kBACZ,QACA,MACA,YAEA,cAAc,MAAM,QAAQ,CAAC,KAC5B,OAAO,SAAS,UAAU,cAAc,QAAQ,OAAO,QAAQ,CAAC,CAChE;AAEF,MAAa,sBACZ,QACA,MACA,YACe,kBAAkB,QAAQ,kBAAkB,MAAM,QAAQ,EAAE,QAAQ;AAEpF,MAAa,8BACZ,QACA,MACA,YACe;CACf,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,QAAQ,kBAAkB,MAAM,QAAQ;AAC9C,KAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW,KAAA,EAC7C,OAAM,QAAQ,QACb,MACC,SACA,QAAQ,kBAAkB,wCAAwC,SAClE,MACA,CACD;AAEF,QAAO,kBAAkB,QAAQ,MAAM,QAAQ,QAAQ;;AAGxD,MAAa,mBACZ,QACA,MACA,YAEA,OAAO,QACN,KACE,MAAM,SAAS,CACf,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,QAAQ,SAAS,KAAK,SAAS,EAAE,GAClC,MAAM,UACN,eAAe,QAAQ,MAAM;CAC5B,GAAG;CACH,QAAQ,GAAG,QAAQ,OAAO,GAAG,QAAQ;CACrC,CAAC,CACH"}

package/dist/substrate/runtime/scoped-http-server.mjs

@@ -11,7 +11,7 @@ const gracefulCloseHttpServer = (server) => Effect.callback((resume) => {
 	server.close(() => resume(Effect.void));
 });
 const listenScopedHttpServer = (options) => Effect.gen(function* () {
-	const server = yield* Effect.tryPromise({
+	const server = yield* Effect.acquireRelease(Effect.tryPromise({
 		try: () => new Promise((resolve, reject) => {
 			const srv = createServer(options.listener);
 			const onError = (err) => reject(err);
@@ -22,8 +22,7 @@ const listenScopedHttpServer = (options) => Effect.gen(function* () {
 			});
 		}),
 		catch: options.onListenError
-	});
-	yield* Effect.addFinalizer(() => gracefulCloseHttpServer(server).pipe(Effect.uninterruptible));
+	}), (srv) => gracefulCloseHttpServer(srv).pipe(Effect.uninterruptible));
 	return {
 		url: `http://${options.bindAddress}:${options.port}`,
 		server,

package/dist/substrate/runtime/scoped-http-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"scoped-http-server.mjs","names":[],"sources":["../../../src/substrate/runtime/scoped-http-server.ts"],"sourcesContent":["// Scoped host HTTP server primitive.\n//\n// Generic ownership for in-process host HTTP listeners: bind, surface\n// listen failures through a caller-owned error mapper, and install a\n// scope finalizer that drops idle keepalive sockets before awaiting\n// close. Domain routing stays with the plugin that supplies the\n// Node request listener.\n\nimport { Effect } from 'effect';\nimport type { Scope } from 'effect';\nimport { createServer, type IncomingMessage, type Server, type ServerResponse } from 'node:http';\n\nexport type HttpRequestListener = (req: IncomingMessage, res: ServerResponse) => void;\n\nexport interface ScopedHttpServerOptions<E> {\n\treadonly bindAddress: string;\n\treadonly port: number;\n\treadonly listener: HttpRequestListener;\n\treadonly onListenError: (cause: unknown) => E;\n}\n\nexport interface ScopedHttpServerHandle {\n\treadonly url: string;\n\treadonly server: Server;\n\treadonly close: () => Effect.Effect<void>;\n}\n\n/** Best-effort graceful close. `closeAllConnections()` drops idle\n *  keepalive sockets so `close()` resolves; older Node versions\n *  without `closeAllConnections` rely on `close()` alone. */\nexport const gracefulCloseHttpServer = (server: Server): Effect.Effect<void> =>\n\tEffect.callback<void>((resume) => {\n\t\ttry {\n\t\t\tserver.closeAllConnections();\n\t\t} catch {\n\t\t\t// Older Node versions don't expose closeAllConnections;\n\t\t\t// `close()` alone will still terminate.\n\t\t}\n\t\tserver.close(() => resume(Effect.void));\n\t});\n\nexport const listenScopedHttpServer = <E>(\n\toptions: ScopedHttpServerOptions<E>,\n): Effect.Effect<ScopedHttpServerHandle, E, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst server = yield* Effect.tryPromise({\n\t\t\ttry: () =>\n\t\t\t\tnew Promise<Server>((resolve, reject) => {\n\t\t\t\t\tconst srv = createServer(options.listener);\n\t\t\t\t\tconst onError = (err: Error) => reject(err);\n\t\t\t\t\tsrv.once('error', onError);\n\t\t\t\t\tsrv.listen(options.port, options.bindAddress, () => {\n\t\t\t\t\t\tsrv.removeListener('error', onError);\n\t\t\t\t\t\tresolve(srv);\n\t\t\t\t\t});\n\t\t\t\t}),\n\t\t\tcatch: options.onListenError,\n\t\t});\n\n\t\tyield* Effect.addFinalizer(() => gracefulCloseHttpServer(server).pipe(Effect.uninterruptible));\n\n\t\treturn {\n\t\t\turl: `http://${options.bindAddress}:${options.port}`,\n\t\t\tserver,\n\t\t\tclose: () => gracefulCloseHttpServer(server),\n\t\t};\n\t});\n"],"mappings":";;;;;;AA8BA,MAAa,2BAA2B,WACvC,OAAO,UAAgB,WAAW;AACjC,KAAI;AACH,SAAO,qBAAqB;SACrB;AAIR,QAAO,YAAY,OAAO,OAAO,KAAK,CAAC;EACtC;AAEH,MAAa,0BACZ,YAEA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO,OAAO,WAAW;EACvC,WACC,IAAI,SAAiB,SAAS,WAAW;GACxC,MAAM,MAAM,aAAa,QAAQ,SAAS;GAC1C,MAAM,WAAW,QAAe,OAAO,IAAI;AAC3C,OAAI,KAAK,SAAS,QAAQ;AAC1B,OAAI,OAAO,QAAQ,MAAM,QAAQ,mBAAmB;AACnD,QAAI,eAAe,SAAS,QAAQ;AACpC,YAAQ,IAAI;KACX;IACD;EACH,OAAO,QAAQ;EACf,CAAC;AAEF,QAAO,OAAO,mBAAmB,wBAAwB,OAAO,CAAC,KAAK,OAAO,gBAAgB,CAAC;AAE9F,QAAO;EACN,KAAK,UAAU,QAAQ,YAAY,GAAG,QAAQ;EAC9C;EACA,aAAa,wBAAwB,OAAO;EAC5C;EACA"}
+{"version":3,"file":"scoped-http-server.mjs","names":[],"sources":["../../../src/substrate/runtime/scoped-http-server.ts"],"sourcesContent":["// Scoped host HTTP server primitive.\n//\n// Generic ownership for in-process host HTTP listeners: bind, surface\n// listen failures through a caller-owned error mapper, and install a\n// scope finalizer that drops idle keepalive sockets before awaiting\n// close. Domain routing stays with the plugin that supplies the\n// Node request listener.\n\nimport { Effect } from 'effect';\nimport type { Scope } from 'effect';\nimport { createServer, type IncomingMessage, type Server, type ServerResponse } from 'node:http';\n\nexport type HttpRequestListener = (req: IncomingMessage, res: ServerResponse) => void;\n\nexport interface ScopedHttpServerOptions<E> {\n\treadonly bindAddress: string;\n\treadonly port: number;\n\treadonly listener: HttpRequestListener;\n\treadonly onListenError: (cause: unknown) => E;\n}\n\nexport interface ScopedHttpServerHandle {\n\treadonly url: string;\n\treadonly server: Server;\n\treadonly close: () => Effect.Effect<void>;\n}\n\n/** Best-effort graceful close. `closeAllConnections()` drops idle\n *  keepalive sockets so `close()` resolves; older Node versions\n *  without `closeAllConnections` rely on `close()` alone. */\nexport const gracefulCloseHttpServer = (server: Server): Effect.Effect<void> =>\n\tEffect.callback<void>((resume) => {\n\t\ttry {\n\t\t\tserver.closeAllConnections();\n\t\t} catch {\n\t\t\t// Older Node versions don't expose closeAllConnections;\n\t\t\t// `close()` alone will still terminate.\n\t\t}\n\t\tserver.close(() => resume(Effect.void));\n\t});\n\nexport const listenScopedHttpServer = <E>(\n\toptions: ScopedHttpServerOptions<E>,\n): Effect.Effect<ScopedHttpServerHandle, E, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\t// `acquireRelease` pairs the bound server with its close finalizer\n\t\t// atomically: the moment `listen` resolves, the graceful-close\n\t\t// finalizer is registered, so an interruption between bind and\n\t\t// finalizer registration can no longer leak a listener holding the\n\t\t// port.\n\t\tconst server = yield* Effect.acquireRelease(\n\t\t\tEffect.tryPromise({\n\t\t\t\ttry: () =>\n\t\t\t\t\tnew Promise<Server>((resolve, reject) => {\n\t\t\t\t\t\tconst srv = createServer(options.listener);\n\t\t\t\t\t\tconst onError = (err: Error) => reject(err);\n\t\t\t\t\t\tsrv.once('error', onError);\n\t\t\t\t\t\tsrv.listen(options.port, options.bindAddress, () => {\n\t\t\t\t\t\t\tsrv.removeListener('error', onError);\n\t\t\t\t\t\t\tresolve(srv);\n\t\t\t\t\t\t});\n\t\t\t\t\t}),\n\t\t\t\tcatch: options.onListenError,\n\t\t\t}),\n\t\t\t(srv) => gracefulCloseHttpServer(srv).pipe(Effect.uninterruptible),\n\t\t);\n\n\t\treturn {\n\t\t\turl: `http://${options.bindAddress}:${options.port}`,\n\t\t\tserver,\n\t\t\tclose: () => gracefulCloseHttpServer(server),\n\t\t};\n\t});\n"],"mappings":";;;;;;AA8BA,MAAa,2BAA2B,WACvC,OAAO,UAAgB,WAAW;AACjC,KAAI;AACH,SAAO,qBAAqB;SACrB;AAIR,QAAO,YAAY,OAAO,OAAO,KAAK,CAAC;EACtC;AAEH,MAAa,0BACZ,YAEA,OAAO,IAAI,aAAa;CAMvB,MAAM,SAAS,OAAO,OAAO,eAC5B,OAAO,WAAW;EACjB,WACC,IAAI,SAAiB,SAAS,WAAW;GACxC,MAAM,MAAM,aAAa,QAAQ,SAAS;GAC1C,MAAM,WAAW,QAAe,OAAO,IAAI;AAC3C,OAAI,KAAK,SAAS,QAAQ;AAC1B,OAAI,OAAO,QAAQ,MAAM,QAAQ,mBAAmB;AACnD,QAAI,eAAe,SAAS,QAAQ;AACpC,YAAQ,IAAI;KACX;IACD;EACH,OAAO,QAAQ;EACf,CAAC,GACD,QAAQ,wBAAwB,IAAI,CAAC,KAAK,OAAO,gBAAgB,CAClE;AAED,QAAO;EACN,KAAK,UAAU,QAAQ,YAAY,GAAG,QAAQ;EAC9C;EACA,aAAa,wBAAwB,OAAO;EAC5C;EACA"}

package/dist/substrate/runtime/scoped-multimap/index.mjs

@@ -0,0 +1,2 @@
+import "./service.mjs";
+export {};

package/dist/substrate/runtime/scoped-multimap/service.mjs

@@ -0,0 +1,52 @@
+import { Effect, Ref } from "effect";
+//#region src/substrate/runtime/scoped-multimap/service.ts
+/**
+* Construct a fresh scoped multimap. Call this inside a Layer build
+* effect (the registry's `Layer.effect` body); the returned ops close
+* over a private `Ref` that lives for that Layer's scope.
+*
+* `register` is interruption-safe: the append + finalizer-wire pair is
+* `uninterruptible`, so an interrupt arriving between the two can't
+* leak an entry past scope close (mirrors `leaseBroker.tryAcquire`).
+*/
+const makeScopedMultimap = () => Effect.gen(function* () {
+	const state = yield* Ref.make(/* @__PURE__ */ new Map());
+	const seqRef = yield* Ref.make(0);
+	const register = (items) => Effect.gen(function* () {
+		const seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);
+		yield* Ref.update(state, (current) => {
+			const next = new Map(current);
+			for (const item of items) {
+				const existing = next.get(item.key) ?? [];
+				next.set(item.key, [...existing, {
+					value: item.value,
+					seq
+				}]);
+			}
+			return next;
+		});
+		yield* Effect.addFinalizer((_exit) => Ref.update(state, (current) => {
+			const next = new Map(current);
+			for (const item of items) {
+				const existing = next.get(item.key);
+				if (!existing) continue;
+				const filtered = existing.filter((e) => e.seq !== seq);
+				if (filtered.length === 0) next.delete(item.key);
+				else next.set(item.key, filtered);
+			}
+			return next;
+		}));
+		return seq;
+	}).pipe(Effect.uninterruptible);
+	const entriesFor = (key) => Ref.get(state).pipe(Effect.map((current) => current.get(key) ?? []));
+	return {
+		register,
+		entriesFor,
+		snapshot: Ref.get(state),
+		keys: Ref.get(state).pipe(Effect.map((current) => [...current.keys()]))
+	};
+});
+//#endregion
+export { makeScopedMultimap };
+
+//# sourceMappingURL=service.mjs.map

package/dist/substrate/runtime/scoped-multimap/service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../../src/substrate/runtime/scoped-multimap/service.ts"],"sourcesContent":["// Scoped seq-tagged multimap primitive.\n//\n// Three substrate registries — `StrategyRegistry`, `FormatterRegistry`,\n// `CapabilitySinks` — independently grew the same shape: a `Ref` of a\n// per-key LIST of seq-tagged entries, plus a per-registration scope\n// finalizer that drops the entries it added when the surrounding scope\n// closes. This module is the ONE place that shape lives.\n//\n// Why a per-key LIST tagged by a monotonic seq (rather than a single\n// value-per-key with prior-restore):\n//\n//   - Parallel / sibling-scope safety. The naive \"remember the prior\n//     value, restore it on close\" finalizer is only correct under\n//     strict LIFO nesting. With sibling scopes it clobbers a still-live\n//     registration: scope A installs `X`, sibling B overwrites `X`\n//     (capturing A's value as its `prior`), then A closes first and its\n//     finalizer — holding `prior = nothing` — DELETES `X`, dropping B's\n//     live overlay. capability-sinks had exactly this bug.\n//\n//   - The seq-tagged list makes every finalizer remove ONLY the entry\n//     (or entries) it added — it never touches a newer registration for\n//     the same key. \"Who wins right now\" is a pure function of the\n//     surviving entries (highest seq = last-write-wins), so close order\n//     no longer matters.\n//\n// The primitive deliberately stops at the storage + finalizer layer.\n// The \"winner\" policy differs per registry (priority+seq, non-null\n// formatter+seq, plain last-seq), so each call site folds the surviving\n// entries with its own rule over the snapshot this primitive exposes.\n//\n// Scope-local, like every substrate registry: the `Ref` is private to\n// the build effect, so it dies with the stack scope.\n\nimport { Effect, Ref, type Scope } from 'effect';\n\n/** One stored entry: the caller's `value` plus the monotonic `seq` the\n *  multimap stamped it with. The `seq` is the identity the finalizer\n *  drops on and the tiebreaker call sites fold on. */\nexport interface MultimapEntry<V> {\n\treadonly value: V;\n\treadonly seq: number;\n}\n\n/** A single `(key, value)` pair to register. A registration may carry\n *  several pairs (formatter-registry contributes one tag-entry per\n *  declared error tag); all pairs in one `register` call share one\n *  `seq` and one finalizer. */\nexport interface MultimapItem<K extends string, V> {\n\treadonly key: K;\n\treadonly value: V;\n}\n\n/** Operations on a scoped seq-tagged multimap. Generic over `K`\n *  (string-shaped, used as a Map key) and the opaque per-entry `V`. */\nexport interface ScopedMultimap<K extends string, V> {\n\t/** Append one or more `(key, value)` pairs under a single fresh\n\t *  `seq`, and register a scope finalizer that drops exactly those\n\t *  entries (by `seq`) on scope close. Returns the assigned `seq` so\n\t *  callers that need to span-annotate or correlate can.\n\t *\n\t *  Requires `Scope.Scope`: the finalizer lands on the caller's\n\t *  scope, so the registration is reaped on that scope's close. */\n\treadonly register: (\n\t\titems: ReadonlyArray<MultimapItem<K, V>>,\n\t) => Effect.Effect<number, never, Scope.Scope>;\n\t/** Surviving entries under one key, in registration order\n\t *  (ascending `seq`). Empty array when the key is absent. */\n\treadonly entriesFor: (key: K) => Effect.Effect<ReadonlyArray<MultimapEntry<V>>>;\n\t/** Full snapshot: every key mapped to its surviving entries. */\n\treadonly snapshot: Effect.Effect<ReadonlyMap<K, ReadonlyArray<MultimapEntry<V>>>>;\n\t/** Keys with at least one surviving entry. */\n\treadonly keys: Effect.Effect<ReadonlyArray<K>>;\n}\n\ntype State<K extends string, V> = ReadonlyMap<K, ReadonlyArray<MultimapEntry<V>>>;\n\n/**\n * Construct a fresh scoped multimap. Call this inside a Layer build\n * effect (the registry's `Layer.effect` body); the returned ops close\n * over a private `Ref` that lives for that Layer's scope.\n *\n * `register` is interruption-safe: the append + finalizer-wire pair is\n * `uninterruptible`, so an interrupt arriving between the two can't\n * leak an entry past scope close (mirrors `leaseBroker.tryAcquire`).\n */\nexport const makeScopedMultimap = <K extends string, V>(): Effect.Effect<ScopedMultimap<K, V>> =>\n\tEffect.gen(function* () {\n\t\tconst state = yield* Ref.make<State<K, V>>(new Map());\n\t\tconst seqRef = yield* Ref.make(0);\n\n\t\tconst register: ScopedMultimap<K, V>['register'] = (items) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);\n\t\t\t\tyield* Ref.update(state, (current) => {\n\t\t\t\t\tconst next = new Map(current);\n\t\t\t\t\tfor (const item of items) {\n\t\t\t\t\t\tconst existing = next.get(item.key) ?? [];\n\t\t\t\t\t\tnext.set(item.key, [...existing, { value: item.value, seq }]);\n\t\t\t\t\t}\n\t\t\t\t\treturn next;\n\t\t\t\t});\n\t\t\t\t// Drop-by-seq finalizer. Touches only the entries THIS\n\t\t\t\t// registration added — never a newer registration for the\n\t\t\t\t// same key — so sibling-scope close order is irrelevant.\n\t\t\t\tyield* Effect.addFinalizer((_exit) =>\n\t\t\t\t\tRef.update(state, (current) => {\n\t\t\t\t\t\tconst next = new Map(current);\n\t\t\t\t\t\tfor (const item of items) {\n\t\t\t\t\t\t\tconst existing = next.get(item.key);\n\t\t\t\t\t\t\tif (!existing) continue;\n\t\t\t\t\t\t\tconst filtered = existing.filter((e) => e.seq !== seq);\n\t\t\t\t\t\t\tif (filtered.length === 0) next.delete(item.key);\n\t\t\t\t\t\t\telse next.set(item.key, filtered);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn next;\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\treturn seq;\n\t\t\t}).pipe(Effect.uninterruptible);\n\n\t\tconst entriesFor: ScopedMultimap<K, V>['entriesFor'] = (key) =>\n\t\t\tRef.get(state).pipe(Effect.map((current) => current.get(key) ?? []));\n\n\t\tconst snapshot: ScopedMultimap<K, V>['snapshot'] = Ref.get(state);\n\n\t\tconst keys: ScopedMultimap<K, V>['keys'] = Ref.get(state).pipe(\n\t\t\tEffect.map((current) => [...current.keys()]),\n\t\t);\n\n\t\treturn { register, entriesFor, snapshot, keys } as const;\n\t});\n"],"mappings":";;;;;;;;;;;AAqFA,MAAa,2BACZ,OAAO,IAAI,aAAa;CACvB,MAAM,QAAQ,OAAO,IAAI,qBAAkB,IAAI,KAAK,CAAC;CACrD,MAAM,SAAS,OAAO,IAAI,KAAK,EAAE;CAEjC,MAAM,YAA8C,UACnD,OAAO,IAAI,aAAa;EACvB,MAAM,MAAM,OAAO,IAAI,aAAa,SAAS,MAAM,IAAI,EAAE;AACzD,SAAO,IAAI,OAAO,QAAQ,YAAY;GACrC,MAAM,OAAO,IAAI,IAAI,QAAQ;AAC7B,QAAK,MAAM,QAAQ,OAAO;IACzB,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE;AACzC,SAAK,IAAI,KAAK,KAAK,CAAC,GAAG,UAAU;KAAE,OAAO,KAAK;KAAO;KAAK,CAAC,CAAC;;AAE9D,UAAO;IACN;AAIF,SAAO,OAAO,cAAc,UAC3B,IAAI,OAAO,QAAQ,YAAY;GAC9B,MAAM,OAAO,IAAI,IAAI,QAAQ;AAC7B,QAAK,MAAM,QAAQ,OAAO;IACzB,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI;AACnC,QAAI,CAAC,SAAU;IACf,MAAM,WAAW,SAAS,QAAQ,MAAM,EAAE,QAAQ,IAAI;AACtD,QAAI,SAAS,WAAW,EAAG,MAAK,OAAO,KAAK,IAAI;QAC3C,MAAK,IAAI,KAAK,KAAK,SAAS;;AAElC,UAAO;IACN,CACF;AACD,SAAO;GACN,CAAC,KAAK,OAAO,gBAAgB;CAEhC,MAAM,cAAkD,QACvD,IAAI,IAAI,MAAM,CAAC,KAAK,OAAO,KAAK,YAAY,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;AAQrE,QAAO;EAAE;EAAU;EAAY,UANoB,IAAI,IAAI,MAMpB;EAAE,MAJE,IAAI,IAAI,MAAM,CAAC,KACzD,OAAO,KAAK,YAAY,CAAC,GAAG,QAAQ,MAAM,CAAC,CAAC,CAGA;EAAE;EAC9C"}

package/dist/substrate/runtime/scoped-ref-map/index.mjs

@@ -0,0 +1,2 @@
+import "./service.mjs";
+export {};

package/dist/substrate/runtime/scoped-ref-map/service.mjs

@@ -40,7 +40,7 @@ var ScopedRefMapKeyMissingError = class extends Schema.TaggedErrorClass()("Scope
 * ```
 */
 const defineScopedRefMap = (name) => {
-	const serviceId = `@devstack-rewrite/substrate/ScopedRefMap/${name}`;
+	const serviceId = `@devstack/substrate/ScopedRefMap/${name}`;
 	class Service extends Context.Service()(serviceId) {}
 	const layer = Layer.effect(Service, Effect.gen(function* () {
 		const ref = yield* SubscriptionRef.make([]);
@@ -78,6 +78,6 @@ const defineScopedRefMap = (name) => {
 	};
 };
 //#endregion
-export { defineScopedRefMap };
+export { ScopedRefMapKeyMissingError, defineScopedRefMap };
 
 //# sourceMappingURL=service.mjs.map

package/dist/substrate/runtime/scoped-ref-map/service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service.mjs","names":[],"sources":["../../../../src/substrate/runtime/scoped-ref-map/service.ts"],"sourcesContent":["// Generic scoped Ref-Map registry primitive.\n//\n// Architecture (ARCHITECTURE.md § Substrate primitives roster /\n// § Substrate name-blindness): a name-blind, per-stack-scoped\n// in-memory `K -> V` lookup table. Substrate exposes ONLY the\n// generic primitive; L2 plugins (Sui-coin, Move-package, future\n// chain plugins) instantiate it with their domain-specific\n// `K` and `V` shapes to author their own typed Context.Service.\n//\n// Why the factory `defineScopedRefMap<K, V>(name)` shape rather\n// than a single `ScopedRefMapService` tag:\n//\n//   - One service per plugin domain — `PackageRegistry`,\n//     `CoinRegistry`, etc. — gives each plugin its own typed\n//     tag instead of every consumer reaching into a single map\n//     and narrowing.\n//   - Substrate stays name-blind: it doesn't know `coin` or\n//     `package`; it only knows \"give me a Layer + Service for\n//     `<K, V>`\". The plugin chooses the name.\n//   - The substrate Service-class identity is the namespace —\n//     two `defineScopedRefMap('Foo')` and `defineScopedRefMap('Bar')`\n//     calls return distinct services that can coexist in the\n//     same scope.\n//\n// Lifetime: each instantiated service is materialized by a\n// Layer that lives for the stack scope. When the scope closes,\n// the in-memory `SubscriptionRef` drops with it — the ref is\n// closure-private to the Layer's build effect, so the GC\n// reclaims it once no subscribers hold the stream.\n\nimport { Context, Effect, Layer, Schema, Stream, SubscriptionRef } from 'effect';\n\n/** Lookup failure for a missing key. Schema-tagged so consumers\n *  may `Effect.catchTag('ScopedRefMapKeyMissingError', ...)` and\n *  the cascade-formatter can render it without importing the class. */\nexport class ScopedRefMapKeyMissingError extends Schema.TaggedErrorClass<ScopedRefMapKeyMissingError>()(\n\t'ScopedRefMapKeyMissingError',\n\t{\n\t\tregistryName: Schema.String,\n\t\tkey: Schema.String,\n\t},\n) {}\n\n/** Operations on a scoped `K -> V` ref-map. Generic over `K`\n *  (constrained to `string`-shaped brands so it can be used as\n *  a Map key) and `V` (fully opaque to substrate). */\nexport interface ScopedRefMap<K extends string, V> {\n\t/** Insert / overwrite. Last-write-wins on `K`. */\n\treadonly set: (key: K, value: V) => Effect.Effect<void>;\n\t/** Strict lookup. Fails with `ScopedRefMapKeyMissingError`\n\t *  when the key isn't present. */\n\treadonly get: (key: K) => Effect.Effect<V, ScopedRefMapKeyMissingError>;\n\t/** Non-failing lookup — `null` when absent. */\n\treadonly find: (key: K) => Effect.Effect<V | null>;\n\t/** Presence check without an error projection. */\n\treadonly has: (key: K) => Effect.Effect<boolean>;\n\t/** Snapshot of all `(key, value)` pairs. Iteration order is\n\t *  insertion order. */\n\treadonly entries: () => Effect.Effect<ReadonlyArray<readonly [K, V]>>;\n\t/** Stream of full-snapshot states. Each emission is the\n\t *  current `entries` array; consumers diff if they need\n\t *  incremental updates. */\n\treadonly changes: Stream.Stream<ReadonlyArray<readonly [K, V]>>;\n}\n\n/**\n * Factory: declare a typed `K -> V` scoped ref-map service.\n *\n * The `name` becomes both the human-readable registry name (used\n * in `ScopedRefMapKeyMissingError.registryName`) and the\n * Context.Service identifier (prefixed with the substrate\n * namespace). Each call returns a fresh Service class; calling\n * twice with the same name produces two distinct services\n * (Context.Service identity is per-class, not per-id-string —\n * the id string is a debugging aid).\n *\n * Return shape — typed via inference so the inner Service class's\n * identity flows through to callers:\n *   - `Service` — the `Context.Service` tag class. Plugin authors\n *     yield this from their `acquire` body via `yield* MyRegistry.Service`.\n *   - `layer` — scope-bound Layer constructing one ref-map per\n *     stack scope.\n *   - `changes` — stream helper mirroring `routesStream(router)`.\n *\n * Example (in an L2 plugin):\n *\n * ```ts\n * const PackageRegistry = defineScopedRefMap<PackageKey, PackageRecord>('PackageRegistry');\n *\n * // In the plugin's acquire body:\n * const registry = yield* PackageRegistry.Service;\n * yield* registry.set(name, resolved);\n *\n * // In the boot Layer:\n * Layer.mergeAll(PackageRegistry.layer, ...)\n * ```\n */\nexport const defineScopedRefMap = <K extends string, V>(name: string) => {\n\tconst serviceId = `@devstack-rewrite/substrate/ScopedRefMap/${name}`;\n\n\tclass Service extends Context.Service<Service, ScopedRefMap<K, V>>()(serviceId) {}\n\n\tconst layer: Layer.Layer<Service> = Layer.effect(\n\t\tService,\n\t\tEffect.gen(function* () {\n\t\t\tconst ref = yield* SubscriptionRef.make<ReadonlyArray<readonly [K, V]>>([]);\n\n\t\t\tconst set: ScopedRefMap<K, V>['set'] = (key, value) =>\n\t\t\t\tSubscriptionRef.update(ref, (current) => {\n\t\t\t\t\tconst filtered = current.filter(([k]) => k !== key);\n\t\t\t\t\treturn [...filtered, [key, value] as const];\n\t\t\t\t});\n\n\t\t\tconst find: ScopedRefMap<K, V>['find'] = (key) =>\n\t\t\t\tSubscriptionRef.get(ref).pipe(\n\t\t\t\t\tEffect.map((current) => {\n\t\t\t\t\t\tconst hit = current.find(([k]) => k === key);\n\t\t\t\t\t\treturn hit ? hit[1] : null;\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\tconst get: ScopedRefMap<K, V>['get'] = (key) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst value = yield* find(key);\n\t\t\t\t\tif (value === null) {\n\t\t\t\t\t\treturn yield* new ScopedRefMapKeyMissingError({\n\t\t\t\t\t\t\tregistryName: name,\n\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\treturn value;\n\t\t\t\t});\n\n\t\t\tconst has: ScopedRefMap<K, V>['has'] = (key) =>\n\t\t\t\tSubscriptionRef.get(ref).pipe(Effect.map((current) => current.some(([k]) => k === key)));\n\n\t\t\tconst entries: ScopedRefMap<K, V>['entries'] = () => SubscriptionRef.get(ref);\n\n\t\t\treturn Service.of({\n\t\t\t\tset,\n\t\t\t\tget,\n\t\t\t\tfind,\n\t\t\t\thas,\n\t\t\t\tentries,\n\t\t\t\tchanges: SubscriptionRef.changes(ref),\n\t\t\t});\n\t\t}),\n\t);\n\n\tconst changes = (svc: ScopedRefMap<K, V>): Stream.Stream<ReadonlyArray<readonly [K, V]>> =>\n\t\tsvc.changes;\n\n\treturn {\n\t\tService,\n\t\tlayer,\n\t\tchanges,\n\t} as const;\n};\n"],"mappings":";;;;;AAmCA,IAAa,8BAAb,cAAiD,OAAO,kBAA+C,CACtG,+BACA;CACC,cAAc,OAAO;CACrB,KAAK,OAAO;CACZ,CACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDF,MAAa,sBAA2C,SAAiB;CACxE,MAAM,YAAY,4CAA4C;CAE9D,MAAM,gBAAgB,QAAQ,SAAsC,CAAC,UAAU,CAAC;CAEhF,MAAM,QAA8B,MAAM,OACzC,SACA,OAAO,IAAI,aAAa;EACvB,MAAM,MAAM,OAAO,gBAAgB,KAAqC,EAAE,CAAC;EAE3E,MAAM,OAAkC,KAAK,UAC5C,gBAAgB,OAAO,MAAM,YAAY;AAExC,UAAO,CAAC,GADS,QAAQ,QAAQ,CAAC,OAAO,MAAM,IAC5B,EAAE,CAAC,KAAK,MAAM,CAAU;IAC1C;EAEH,MAAM,QAAoC,QACzC,gBAAgB,IAAI,IAAI,CAAC,KACxB,OAAO,KAAK,YAAY;GACvB,MAAM,MAAM,QAAQ,MAAM,CAAC,OAAO,MAAM,IAAI;AAC5C,UAAO,MAAM,IAAI,KAAK;IACrB,CACF;EAEF,MAAM,OAAkC,QACvC,OAAO,IAAI,aAAa;GACvB,MAAM,QAAQ,OAAO,KAAK,IAAI;AAC9B,OAAI,UAAU,KACb,QAAO,OAAO,IAAI,4BAA4B;IAC7C,cAAc;IACd;IACA,CAAC;AAEH,UAAO;IACN;EAEH,MAAM,OAAkC,QACvC,gBAAgB,IAAI,IAAI,CAAC,KAAK,OAAO,KAAK,YAAY,QAAQ,MAAM,CAAC,OAAO,MAAM,IAAI,CAAC,CAAC;EAEzF,MAAM,gBAA+C,gBAAgB,IAAI,IAAI;AAE7E,SAAO,QAAQ,GAAG;GACjB;GACA;GACA;GACA;GACA;GACA,SAAS,gBAAgB,QAAQ,IAAI;GACrC,CAAC;GACD,CACF;CAED,MAAM,WAAW,QAChB,IAAI;AAEL,QAAO;EACN;EACA;EACA;EACA"}
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../../src/substrate/runtime/scoped-ref-map/service.ts"],"sourcesContent":["// Generic scoped Ref-Map registry primitive.\n//\n// Architecture (ARCHITECTURE.md § Substrate primitives roster /\n// § Substrate name-blindness): a name-blind, per-stack-scoped\n// in-memory `K -> V` lookup table. Substrate exposes ONLY the\n// generic primitive; L2 plugins (Sui-coin, Move-package, future\n// chain plugins) instantiate it with their domain-specific\n// `K` and `V` shapes to author their own typed Context.Service.\n//\n// Why the factory `defineScopedRefMap<K, V>(name)` shape rather\n// than a single `ScopedRefMapService` tag:\n//\n//   - One service per plugin domain — `PackageRegistry`,\n//     `CoinRegistry`, etc. — gives each plugin its own typed\n//     tag instead of every consumer reaching into a single map\n//     and narrowing.\n//   - Substrate stays name-blind: it doesn't know `coin` or\n//     `package`; it only knows \"give me a Layer + Service for\n//     `<K, V>`\". The plugin chooses the name.\n//   - The substrate Service-class identity is the namespace —\n//     two `defineScopedRefMap('Foo')` and `defineScopedRefMap('Bar')`\n//     calls return distinct services that can coexist in the\n//     same scope.\n//\n// Lifetime: each instantiated service is materialized by a\n// Layer that lives for the stack scope. When the scope closes,\n// the in-memory `SubscriptionRef` drops with it — the ref is\n// closure-private to the Layer's build effect, so the GC\n// reclaims it once no subscribers hold the stream.\n\nimport { Context, Effect, Layer, Schema, Stream, SubscriptionRef } from 'effect';\n\n/** Lookup failure for a missing key. Schema-tagged so consumers\n *  may `Effect.catchTag('ScopedRefMapKeyMissingError', ...)` and\n *  the cascade-formatter can render it without importing the class. */\nexport class ScopedRefMapKeyMissingError extends Schema.TaggedErrorClass<ScopedRefMapKeyMissingError>()(\n\t'ScopedRefMapKeyMissingError',\n\t{\n\t\tregistryName: Schema.String,\n\t\tkey: Schema.String,\n\t},\n) {}\n\n/** Operations on a scoped `K -> V` ref-map. Generic over `K`\n *  (constrained to `string`-shaped brands so it can be used as\n *  a Map key) and `V` (fully opaque to substrate). */\nexport interface ScopedRefMap<K extends string, V> {\n\t/** Insert / overwrite. Last-write-wins on `K`. */\n\treadonly set: (key: K, value: V) => Effect.Effect<void>;\n\t/** Strict lookup. Fails with `ScopedRefMapKeyMissingError`\n\t *  when the key isn't present. */\n\treadonly get: (key: K) => Effect.Effect<V, ScopedRefMapKeyMissingError>;\n\t/** Non-failing lookup — `null` when absent. */\n\treadonly find: (key: K) => Effect.Effect<V | null>;\n\t/** Presence check without an error projection. */\n\treadonly has: (key: K) => Effect.Effect<boolean>;\n\t/** Snapshot of all `(key, value)` pairs. Iteration order is\n\t *  insertion order. */\n\treadonly entries: () => Effect.Effect<ReadonlyArray<readonly [K, V]>>;\n\t/** Stream of full-snapshot states. Each emission is the\n\t *  current `entries` array; consumers diff if they need\n\t *  incremental updates. */\n\treadonly changes: Stream.Stream<ReadonlyArray<readonly [K, V]>>;\n}\n\n/**\n * Factory: declare a typed `K -> V` scoped ref-map service.\n *\n * The `name` becomes both the human-readable registry name (used\n * in `ScopedRefMapKeyMissingError.registryName`) and the\n * Context.Service identifier (prefixed with the substrate\n * namespace). Each call returns a fresh Service class; calling\n * twice with the same name produces two distinct services\n * (Context.Service identity is per-class, not per-id-string —\n * the id string is a debugging aid).\n *\n * Return shape — typed via inference so the inner Service class's\n * identity flows through to callers:\n *   - `Service` — the `Context.Service` tag class. Plugin authors\n *     yield this from their `acquire` body via `yield* MyRegistry.Service`.\n *   - `layer` — scope-bound Layer constructing one ref-map per\n *     stack scope.\n *   - `changes` — stream helper mirroring `routesStream(router)`.\n *\n * Example (in an L2 plugin):\n *\n * ```ts\n * const PackageRegistry = defineScopedRefMap<PackageKey, PackageRecord>('PackageRegistry');\n *\n * // In the plugin's acquire body:\n * const registry = yield* PackageRegistry.Service;\n * yield* registry.set(name, resolved);\n *\n * // In the boot Layer:\n * Layer.mergeAll(PackageRegistry.layer, ...)\n * ```\n */\nexport const defineScopedRefMap = <K extends string, V>(name: string) => {\n\tconst serviceId = `@devstack/substrate/ScopedRefMap/${name}`;\n\n\tclass Service extends Context.Service<Service, ScopedRefMap<K, V>>()(serviceId) {}\n\n\tconst layer: Layer.Layer<Service> = Layer.effect(\n\t\tService,\n\t\tEffect.gen(function* () {\n\t\t\tconst ref = yield* SubscriptionRef.make<ReadonlyArray<readonly [K, V]>>([]);\n\n\t\t\tconst set: ScopedRefMap<K, V>['set'] = (key, value) =>\n\t\t\t\tSubscriptionRef.update(ref, (current) => {\n\t\t\t\t\tconst filtered = current.filter(([k]) => k !== key);\n\t\t\t\t\treturn [...filtered, [key, value] as const];\n\t\t\t\t});\n\n\t\t\tconst find: ScopedRefMap<K, V>['find'] = (key) =>\n\t\t\t\tSubscriptionRef.get(ref).pipe(\n\t\t\t\t\tEffect.map((current) => {\n\t\t\t\t\t\tconst hit = current.find(([k]) => k === key);\n\t\t\t\t\t\treturn hit ? hit[1] : null;\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\tconst get: ScopedRefMap<K, V>['get'] = (key) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst value = yield* find(key);\n\t\t\t\t\tif (value === null) {\n\t\t\t\t\t\treturn yield* new ScopedRefMapKeyMissingError({\n\t\t\t\t\t\t\tregistryName: name,\n\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\treturn value;\n\t\t\t\t});\n\n\t\t\tconst has: ScopedRefMap<K, V>['has'] = (key) =>\n\t\t\t\tSubscriptionRef.get(ref).pipe(Effect.map((current) => current.some(([k]) => k === key)));\n\n\t\t\tconst entries: ScopedRefMap<K, V>['entries'] = () => SubscriptionRef.get(ref);\n\n\t\t\treturn Service.of({\n\t\t\t\tset,\n\t\t\t\tget,\n\t\t\t\tfind,\n\t\t\t\thas,\n\t\t\t\tentries,\n\t\t\t\tchanges: SubscriptionRef.changes(ref),\n\t\t\t});\n\t\t}),\n\t);\n\n\tconst changes = (svc: ScopedRefMap<K, V>): Stream.Stream<ReadonlyArray<readonly [K, V]>> =>\n\t\tsvc.changes;\n\n\treturn {\n\t\tService,\n\t\tlayer,\n\t\tchanges,\n\t} as const;\n};\n"],"mappings":";;;;;AAmCA,IAAa,8BAAb,cAAiD,OAAO,kBAA+C,CACtG,+BACA;CACC,cAAc,OAAO;CACrB,KAAK,OAAO;CACZ,CACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDF,MAAa,sBAA2C,SAAiB;CACxE,MAAM,YAAY,oCAAoC;CAEtD,MAAM,gBAAgB,QAAQ,SAAsC,CAAC,UAAU,CAAC;CAEhF,MAAM,QAA8B,MAAM,OACzC,SACA,OAAO,IAAI,aAAa;EACvB,MAAM,MAAM,OAAO,gBAAgB,KAAqC,EAAE,CAAC;EAE3E,MAAM,OAAkC,KAAK,UAC5C,gBAAgB,OAAO,MAAM,YAAY;AAExC,UAAO,CAAC,GADS,QAAQ,QAAQ,CAAC,OAAO,MAAM,IAC5B,EAAE,CAAC,KAAK,MAAM,CAAU;IAC1C;EAEH,MAAM,QAAoC,QACzC,gBAAgB,IAAI,IAAI,CAAC,KACxB,OAAO,KAAK,YAAY;GACvB,MAAM,MAAM,QAAQ,MAAM,CAAC,OAAO,MAAM,IAAI;AAC5C,UAAO,MAAM,IAAI,KAAK;IACrB,CACF;EAEF,MAAM,OAAkC,QACvC,OAAO,IAAI,aAAa;GACvB,MAAM,QAAQ,OAAO,KAAK,IAAI;AAC9B,OAAI,UAAU,KACb,QAAO,OAAO,IAAI,4BAA4B;IAC7C,cAAc;IACd;IACA,CAAC;AAEH,UAAO;IACN;EAEH,MAAM,OAAkC,QACvC,gBAAgB,IAAI,IAAI,CAAC,KAAK,OAAO,KAAK,YAAY,QAAQ,MAAM,CAAC,OAAO,MAAM,IAAI,CAAC,CAAC;EAEzF,MAAM,gBAA+C,gBAAgB,IAAI,IAAI;AAE7E,SAAO,QAAQ,GAAG;GACjB;GACA;GACA;GACA;GACA;GACA,SAAS,gBAAgB,QAAQ,IAAI;GACrC,CAAC;GACD,CACF;CAED,MAAM,WAAW,QAChB,IAAI;AAEL,QAAO;EACN;EACA;EACA;EACA"}