@smthrs/control 0.0.0-stage → 1.0.0-rc.4

package/dist/esm/index.js

@@ -0,0 +1,160 @@
+/**
+ * Control-plane contracts and projections for the Smithers harness.
+ *
+ * This is the public surface of the control plane: the transport-independent
+ * `Control` service, the `ControlRuntime` port it writes through, the
+ * projections it reads back, and the durable adapter that binds both to a real
+ * database.
+ *
+ * `Control` is authority, not execution. Every mutation it accepts is
+ * idempotent, principal-stamped, and recorded in the journal beside the state
+ * change it caused, so "who asked for this, and when did it take effect?" is
+ * answered from persisted evidence rather than from a log line.
+ *
+ * @since 0.1.0
+ */
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as Control from "./Control.js";
+/**
+ * @category services
+ * @since 1.0.0
+ */
+export * as ApprovalAuthority from "./ApprovalAuthority.js";
+/**
+ * @category errors
+ * @since 0.1.0
+ */
+export * as ControlError from "./ControlError.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as ControlSchema from "./ControlSchema.js";
+/**
+ * @category projections
+ * @since 0.1.0
+ */
+export * as Cancellation from "./Cancellation.js";
+/**
+ * @category projections
+ * @since 0.1.0
+ */
+export * as Lineage from "./Lineage.js";
+/**
+ * @category projections
+ * @since 0.1.0
+ */
+export * as Monitor from "./Monitor.js";
+/**
+ * @category projections
+ * @since 0.1.0
+ */
+export * as Steering from "./Steering.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as ControlRuntime from "./ControlRuntime.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as ControlExecutor from "./ControlExecutor.js";
+/**
+ * @category services
+ * @since 1.0.0
+ */
+export * as DispatchReader from "./DispatchReader.js";
+/**
+ * @category layers
+ * @since 0.1.0
+ */
+export * as ControlLive from "./ControlLive.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as SystemFlows from "./SystemFlows.js";
+/**
+ * @category rpc
+ * @since 0.1.0
+ */
+export * as ControlRpcs from "./ControlRpcs.js";
+/**
+ * @category layers
+ * @since 0.1.0
+ */
+export * as ControlServer from "./ControlServer.js";
+/**
+ * @category layers
+ * @since 0.1.0
+ */
+export * as ControlClient from "./ControlClient.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as Channels from "./Channels.js";
+/**
+ * @category channels
+ * @since 0.1.0
+ */
+export * as WebhookChannel from "./WebhookChannel.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as Credential from "./Credential.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as CredentialCipher from "./CredentialCipher.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as CredentialStore from "./CredentialStore.js";
+/**
+ * @category layers
+ * @since 0.1.0
+ */
+export * as SqlCredentialStore from "./SqlCredentialStore.js";
+/**
+ * @category layers
+ * @since 0.1.0
+ */
+export * as WebCryptoCipher from "./WebCryptoCipher.js";
+/**
+ * @category layers
+ * @since 0.1.0
+ */
+export * as SqlControlRuntime from "./SqlControlRuntime.js";
+/**
+ * @category authentication
+ * @since 1.0.0
+ */
+export * as ScopedToken from "./ScopedToken.js";
+/**
+ * @category migrations
+ * @since 0.1.0
+ */
+export * as Migrations from "./Migrations.js";
+/**
+ * Observational health contracts.
+ * @category health
+ * @since 1.0.0
+ */
+export * as Health from "./Health.js";
+/**
+ * The Jev-decided session checker a host binds as `jev.session`.
+ * @category health
+ * @since 1.0.0
+ */
+export * as JevSessionChecker from "./JevSessionChecker.js";
+/** Versioned control lifecycle producer and projection contract. */
+export * as ControlFacts from "./ControlFacts.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;GAGG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;;GAGG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AAEzD;;;GAGG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;;GAGG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAE7D;;;GAGG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;;GAGG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;GAIG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D,oEAAoE;AACpE,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA","sourcesContent":["/**\n * Control-plane contracts and projections for the Smithers harness.\n *\n * This is the public surface of the control plane: the transport-independent\n * `Control` service, the `ControlRuntime` port it writes through, the\n * projections it reads back, and the durable adapter that binds both to a real\n * database.\n *\n * `Control` is authority, not execution. Every mutation it accepts is\n * idempotent, principal-stamped, and recorded in the journal beside the state\n * change it caused, so \"who asked for this, and when did it take effect?\" is\n * answered from persisted evidence rather than from a log line.\n *\n * @since 0.1.0\n */\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as Control from \"./Control.ts\"\n\n/**\n * @category services\n * @since 1.0.0\n */\nexport * as ApprovalAuthority from \"./ApprovalAuthority.ts\"\n\n/**\n * @category errors\n * @since 0.1.0\n */\nexport * as ControlError from \"./ControlError.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as ControlSchema from \"./ControlSchema.ts\"\n\n/**\n * @category projections\n * @since 0.1.0\n */\nexport * as Cancellation from \"./Cancellation.ts\"\n\n/**\n * @category projections\n * @since 0.1.0\n */\nexport * as Lineage from \"./Lineage.ts\"\n\n/**\n * @category projections\n * @since 0.1.0\n */\nexport * as Monitor from \"./Monitor.ts\"\n\n/**\n * @category projections\n * @since 0.1.0\n */\nexport * as Steering from \"./Steering.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as ControlRuntime from \"./ControlRuntime.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as ControlExecutor from \"./ControlExecutor.ts\"\n\n/**\n * @category services\n * @since 1.0.0\n */\nexport * as DispatchReader from \"./DispatchReader.ts\"\n\n/**\n * @category layers\n * @since 0.1.0\n */\nexport * as ControlLive from \"./ControlLive.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as SystemFlows from \"./SystemFlows.ts\"\n\n/**\n * @category rpc\n * @since 0.1.0\n */\nexport * as ControlRpcs from \"./ControlRpcs.ts\"\n\n/**\n * @category layers\n * @since 0.1.0\n */\nexport * as ControlServer from \"./ControlServer.ts\"\n\n/**\n * @category layers\n * @since 0.1.0\n */\nexport * as ControlClient from \"./ControlClient.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as Channels from \"./Channels.ts\"\n\n/**\n * @category channels\n * @since 0.1.0\n */\nexport * as WebhookChannel from \"./WebhookChannel.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as Credential from \"./Credential.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as CredentialCipher from \"./CredentialCipher.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as CredentialStore from \"./CredentialStore.ts\"\n\n/**\n * @category layers\n * @since 0.1.0\n */\nexport * as SqlCredentialStore from \"./SqlCredentialStore.ts\"\n\n/**\n * @category layers\n * @since 0.1.0\n */\nexport * as WebCryptoCipher from \"./WebCryptoCipher.ts\"\n\n/**\n * @category layers\n * @since 0.1.0\n */\nexport * as SqlControlRuntime from \"./SqlControlRuntime.ts\"\n\n/**\n * @category authentication\n * @since 1.0.0\n */\nexport * as ScopedToken from \"./ScopedToken.ts\"\n\n/**\n * @category migrations\n * @since 0.1.0\n */\nexport * as Migrations from \"./Migrations.ts\"\n\n/**\n * Observational health contracts.\n * @category health\n * @since 1.0.0\n */\nexport * as Health from \"./Health.ts\"\n\n/**\n * The Jev-decided session checker a host binds as `jev.session`.\n * @category health\n * @since 1.0.0\n */\nexport * as JevSessionChecker from \"./JevSessionChecker.ts\"\n\n/** Versioned control lifecycle producer and projection contract. */\nexport * as ControlFacts from \"./ControlFacts.ts\"\n"]}

package/dist/esm/internal/MutationBoundary.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Bounded inert JSON admission for control mutations.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+import * as BoundedJson from "@smthrs/canonical/BoundedJson";
+/** Result of admitting an unknown mutation value. */
+type Result = {
+    readonly ok: true;
+    readonly value: BoundedJson.Json;
+} | {
+    readonly ok: false;
+    readonly complaint: string;
+};
+/**
+ * Copies one mutation without invoking getters or `toJSON`.
+ *
+ * `bounds` defaults to the control mutation limits. Tests pass smaller ones to
+ * reach a byte-exact boundary without building multi-megabyte values.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export declare const admit: (input: unknown, bounds?: BoundedJson.Limits) => Result;
+export {};
+//# sourceMappingURL=MutationBoundary.d.ts.map

package/dist/esm/internal/MutationBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationBoundary.d.ts","sourceRoot":"","sources":["../../../src/internal/MutationBoundary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,WAAW,MAAM,+BAA+B,CAAA;AAa5D,qDAAqD;AACrD,KAAK,MAAM,GACP;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,EAAE,SAAQ,WAAW,CAAC,MAAe,KAAG,MAW3E,CAAA"}

package/dist/esm/internal/MutationBoundary.js

@@ -0,0 +1,40 @@
+/**
+ * Bounded inert JSON admission for control mutations.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+import * as BoundedJson from "@smthrs/canonical/BoundedJson";
+/** Limits and diagnostic precedence of the control mutation boundary. */
+const limits = {
+    maxBytes: 4 * 1024 * 1024,
+    maxStringBytes: 4 * 1024 * 1024,
+    maxKeyBytes: 4 * 1024 * 1024,
+    maxDepth: 128,
+    maxNodes: 100_000,
+    maxMembers: 100_000,
+    maxTotalMembers: 100_000
+};
+/**
+ * Copies one mutation without invoking getters or `toJSON`.
+ *
+ * `bounds` defaults to the control mutation limits. Tests pass smaller ones to
+ * reach a byte-exact boundary without building multi-megabyte values.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export const admit = (input, bounds = limits) => {
+    const result = BoundedJson.admit(input, bounds, { preflightObjects: false });
+    if (result.ok)
+        return { ok: true, value: result.value };
+    const complaint = result.code === "members"
+        ? `contains more than ${bounds.maxTotalMembers} JSON members`
+        : result.code === "string"
+            ? "contains oversized or ill-formed text"
+            : result.code === "key"
+                ? "contains an oversized or ill-formed object key"
+                : result.complaint;
+    return { ok: false, complaint };
+};
+//# sourceMappingURL=MutationBoundary.js.map

package/dist/esm/internal/MutationBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationBoundary.js","sourceRoot":"","sources":["../../../src/internal/MutationBoundary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,WAAW,MAAM,+BAA+B,CAAA;AAE5D,yEAAyE;AACzE,MAAM,MAAM,GAAG;IACb,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IACzB,cAAc,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC/B,WAAW,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC5B,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,OAAO;IACjB,UAAU,EAAE,OAAO;IACnB,eAAe,EAAE,OAAO;CACI,CAAA;AAO9B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,SAA6B,MAAM,EAAU,EAAE;IACnF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5E,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS;QACzC,CAAC,CAAC,sBAAsB,MAAM,CAAC,eAAe,eAAe;QAC7D,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;YAC1B,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK;gBACvB,CAAC,CAAC,gDAAgD;gBAClD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAA;IACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AACjC,CAAC,CAAA","sourcesContent":["/**\n * Bounded inert JSON admission for control mutations.\n *\n * @since 1.0.0-rc.0\n * @private\n */\n\nimport * as BoundedJson from \"@smthrs/canonical/BoundedJson\"\n\n/** Limits and diagnostic precedence of the control mutation boundary. */\nconst limits = {\n  maxBytes: 4 * 1024 * 1024,\n  maxStringBytes: 4 * 1024 * 1024,\n  maxKeyBytes: 4 * 1024 * 1024,\n  maxDepth: 128,\n  maxNodes: 100_000,\n  maxMembers: 100_000,\n  maxTotalMembers: 100_000\n} satisfies BoundedJson.Limits\n\n/** Result of admitting an unknown mutation value. */\ntype Result =\n  | { readonly ok: true; readonly value: BoundedJson.Json }\n  | { readonly ok: false; readonly complaint: string }\n\n/**\n * Copies one mutation without invoking getters or `toJSON`.\n *\n * `bounds` defaults to the control mutation limits. Tests pass smaller ones to\n * reach a byte-exact boundary without building multi-megabyte values.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport const admit = (input: unknown, bounds: BoundedJson.Limits = limits): Result => {\n  const result = BoundedJson.admit(input, bounds, { preflightObjects: false })\n  if (result.ok) return { ok: true, value: result.value }\n  const complaint = result.code === \"members\"\n    ? `contains more than ${bounds.maxTotalMembers} JSON members`\n    : result.code === \"string\"\n    ? \"contains oversized or ill-formed text\"\n    : result.code === \"key\"\n    ? \"contains an oversized or ill-formed object key\"\n    : result.complaint\n  return { ok: false, complaint }\n}\n"]}

package/dist/esm/internal/activeFibers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Completion-aware, replacement-safe ownership of live fibers.
+ * @since 1.0.0
+ */
+import type * as Fiber from "effect/Fiber";
+/**
+ * A completed predecessor must never unregister its replacement.
+ * @category registration
+ * @since 1.0.0
+ */
+export declare const register: <K>(fibers: Map<K, Fiber.Fiber<unknown, unknown>>, key: K, fiber: Fiber.Fiber<unknown, unknown>) => void;
+//# sourceMappingURL=activeFibers.d.ts.map

package/dist/esm/internal/activeFibers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeFibers.d.ts","sourceRoot":"","sources":["../../../src/internal/activeFibers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,QAAQ,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAC7C,KAAK,CAAC,EACN,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KACnC,IAKF,CAAA"}

package/dist/esm/internal/activeFibers.js

@@ -0,0 +1,17 @@
+/**
+ * Completion-aware, replacement-safe ownership of live fibers.
+ * @since 1.0.0
+ */
+/**
+ * A completed predecessor must never unregister its replacement.
+ * @category registration
+ * @since 1.0.0
+ */
+export const register = (fibers, key, fiber) => {
+    fibers.set(key, fiber);
+    fiber.addObserver(() => {
+        if (fibers.get(key) === fiber)
+            fibers.delete(key);
+    });
+};
+//# sourceMappingURL=activeFibers.js.map

package/dist/esm/internal/activeFibers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeFibers.js","sourceRoot":"","sources":["../../../src/internal/activeFibers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,MAA6C,EAC7C,GAAM,EACN,KAAoC,EAC9B,EAAE;IACR,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACtB,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACrB,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA","sourcesContent":["/**\n * Completion-aware, replacement-safe ownership of live fibers.\n * @since 1.0.0\n */\n\nimport type * as Fiber from \"effect/Fiber\"\n\n/**\n * A completed predecessor must never unregister its replacement.\n * @category registration\n * @since 1.0.0\n */\nexport const register = <K>(\n  fibers: Map<K, Fiber.Fiber<unknown, unknown>>,\n  key: K,\n  fiber: Fiber.Fiber<unknown, unknown>\n): void => {\n  fibers.set(key, fiber)\n  fiber.addObserver(() => {\n    if (fibers.get(key) === fiber) fibers.delete(key)\n  })\n}\n"]}

package/dist/esm/internal/issues.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Bounded diagnostics for failures that cross the control wire boundary.
+ *
+ * @since 0.1.0
+ */
+/**
+ * Joins a stable location and reason without allowing an RPC error to grow
+ * without bound.
+ *
+ * @private
+ * @since 0.1.0
+ */
+export declare const cappedIssue: (path: string, reason: string) => string;
+/**
+ * Renders canonical's stable located failure without copying its rejected
+ * value or a nested cause message into an RPC error.
+ *
+ * @private
+ * @since 0.1.0
+ */
+export declare const canonicalIssue: (cause: unknown) => string;
+/**
+ * Finds the first rejected field without rendering its value.
+ * @private
+ * @since 0.1.0
+ */
+export { firstPath as schemaIssuePath } from "@smthrs/canonical/IssuePath";
+//# sourceMappingURL=issues.d.ts.map

package/dist/esm/internal/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../../src/internal/issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAG1D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,MAGC,CAAA;AAEjD;;;;GAIG;AACH,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/esm/internal/issues.js

@@ -0,0 +1,35 @@
+/**
+ * Bounded diagnostics for failures that cross the control wire boundary.
+ *
+ * @since 0.1.0
+ */
+import { CanonicalError } from "@smthrs/canonical";
+const maximumIssueLength = 512;
+/**
+ * Joins a stable location and reason without allowing an RPC error to grow
+ * without bound.
+ *
+ * @private
+ * @since 0.1.0
+ */
+export const cappedIssue = (path, reason) => {
+    const issue = `${path}: ${reason}`;
+    return issue.length <= maximumIssueLength ? issue : `${issue.slice(0, maximumIssueLength - 3)}...`;
+};
+/**
+ * Renders canonical's stable located failure without copying its rejected
+ * value or a nested cause message into an RPC error.
+ *
+ * @private
+ * @since 0.1.0
+ */
+export const canonicalIssue = (cause) => cause instanceof CanonicalError
+    ? cappedIssue(cause.path, cause.code)
+    : cappedIssue("$", "canonicalization failed");
+/**
+ * Finds the first rejected field without rendering its value.
+ * @private
+ * @since 0.1.0
+ */
+export { firstPath as schemaIssuePath } from "@smthrs/canonical/IssuePath";
+//# sourceMappingURL=issues.js.map

package/dist/esm/internal/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../src/internal/issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IAClE,MAAM,KAAK,GAAG,GAAG,IAAI,KAAK,MAAM,EAAE,CAAA;IAClC,OAAO,KAAK,CAAC,MAAM,IAAI,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAA;AACpG,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAU,EAAE,CACvD,KAAK,YAAY,cAAc;IAC7B,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;IACrC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAA;AAEjD;;;;GAIG;AACH,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,6BAA6B,CAAA","sourcesContent":["/**\n * Bounded diagnostics for failures that cross the control wire boundary.\n *\n * @since 0.1.0\n */\n\nimport { CanonicalError } from \"@smthrs/canonical\"\n\nconst maximumIssueLength = 512\n\n/**\n * Joins a stable location and reason without allowing an RPC error to grow\n * without bound.\n *\n * @private\n * @since 0.1.0\n */\nexport const cappedIssue = (path: string, reason: string): string => {\n  const issue = `${path}: ${reason}`\n  return issue.length <= maximumIssueLength ? issue : `${issue.slice(0, maximumIssueLength - 3)}...`\n}\n\n/**\n * Renders canonical's stable located failure without copying its rejected\n * value or a nested cause message into an RPC error.\n *\n * @private\n * @since 0.1.0\n */\nexport const canonicalIssue = (cause: unknown): string =>\n  cause instanceof CanonicalError\n    ? cappedIssue(cause.path, cause.code)\n    : cappedIssue(\"$\", \"canonicalization failed\")\n\n/**\n * Finds the first rejected field without rendering its value.\n * @private\n * @since 0.1.0\n */\nexport { firstPath as schemaIssuePath } from \"@smthrs/canonical/IssuePath\"\n"]}