@smthrs/plugin 0.0.0-stage → 1.0.0-rc.3

package/dist/cjs/internal/snapshotCacheEnvironment.js

@@ -0,0 +1,92 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var snapshotCacheEnvironment_exports = {};
+__export(snapshotCacheEnvironment_exports, {
+  snapshotCacheEnvironment: () => snapshotCacheEnvironment
+});
+module.exports = __toCommonJS(snapshotCacheEnvironment_exports);
+var import_flow = require("@smthrs/flow");
+var Effect = __toESM(require("effect/Effect"), 1);
+var Schema = __toESM(require("effect/Schema"), 1);
+var import_PluginError = require("../PluginError.js");
+var Boundary = __toESM(require("./Boundary.js"), 1);
+const escapePluginIdentityPart = (value) => (
+  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.
+  value.replaceAll("%", "%25").replaceAll("@", "%40")
+);
+const snapshotCacheEnvironment = (input, plugins) => {
+  if (input === void 0) return Effect.succeed(void 0);
+  const pluginIdentities = [];
+  for (const plugin of plugins) {
+    if (plugin.version === void 0) {
+      return Effect.fail(
+        new import_PluginError.PluginError({
+          code: "cache_environment_invalid",
+          message: `cache environment requires a version for plugin "${plugin.name}"`,
+          path: "$.version",
+          plugin: plugin.name
+        })
+      );
+    }
+    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`);
+  }
+  const admitted = Boundary.record(input);
+  if (!admitted.ok) {
+    return Effect.fail(
+      new import_PluginError.PluginError({
+        code: "cache_environment_invalid",
+        message: `cache environment ${admitted.complaint}`,
+        path: `$options.cacheEnvironment${admitted.path.slice(1)}`
+      })
+    );
+  }
+  return Schema.decodeUnknownEffect(import_flow.Action.CacheEnvironment)(admitted.value).pipe(
+    Effect.mapError(
+      () => new import_PluginError.PluginError({
+        code: "cache_environment_invalid",
+        message: "cache environment does not match the complete cache identity schema",
+        path: "$options.cacheEnvironment"
+      })
+    ),
+    Effect.map((environment) => {
+      const capabilities = {};
+      for (const name of Object.keys(environment.capabilities)) {
+        Object.defineProperty(capabilities, name, {
+          value: Object.freeze([...environment.capabilities[name]]),
+          enumerable: true
+        });
+      }
+      return Object.freeze({
+        layers: Object.freeze([...pluginIdentities, ...environment.layers]),
+        capabilities: Object.freeze(capabilities)
+      });
+    })
+  );
+};
+//# sourceMappingURL=snapshotCacheEnvironment.js.map

package/dist/cjs/internal/snapshotCacheEnvironment.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/internal/snapshotCacheEnvironment.ts"],
+  "sourcesContent": ["/**\n * Cache identity admission for a resolved plugin list.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\nimport { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport type { FlowsPlugin } from \"../Plugin.ts\"\nimport { PluginError } from \"../PluginError.ts\"\nimport * as Boundary from \"./Boundary.ts\"\n\nconst escapePluginIdentityPart = (value: string): string =>\n  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.\n  value.replaceAll(\"%\", \"%25\").replaceAll(\"@\", \"%40\")\n\n/**\n * Admits a caller cache environment and prepends one escaped `name@version`\n * identity per plugin, in resolved order. An absent input stays absent.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const snapshotCacheEnvironment = <H>(\n  input: unknown,\n  plugins: ReadonlyArray<FlowsPlugin<H>>\n): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {\n  if (input === undefined) return Effect.succeed(undefined)\n  const pluginIdentities: Array<string> = []\n  for (const plugin of plugins) {\n    if (plugin.version === undefined) {\n      return Effect.fail(\n        new PluginError({\n          code: \"cache_environment_invalid\",\n          message: `cache environment requires a version for plugin \"${plugin.name}\"`,\n          path: \"$.version\",\n          plugin: plugin.name\n        })\n      )\n    }\n    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`)\n  }\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) {\n    return Effect.fail(\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: `cache environment ${admitted.complaint}`,\n        path: `$options.cacheEnvironment${admitted.path.slice(1)}`\n      })\n    )\n  }\n  return Schema.decodeUnknownEffect(Action.CacheEnvironment)(admitted.value).pipe(\n    Effect.mapError(() =>\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: \"cache environment does not match the complete cache identity schema\",\n        path: \"$options.cacheEnvironment\"\n      })\n    ),\n    Effect.map((environment) => {\n      const capabilities: Record<string, ReadonlyArray<string>> = {}\n      for (const name of Object.keys(environment.capabilities)) {\n        Object.defineProperty(capabilities, name, {\n          value: Object.freeze([...environment.capabilities[name]!]),\n          enumerable: true\n        })\n      }\n      return Object.freeze({\n        layers: Object.freeze([...pluginIdentities, ...environment.layers]),\n        capabilities: Object.freeze(capabilities)\n      })\n    })\n  )\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,kBAAuB;AACvB,aAAwB;AACxB,aAAwB;AAExB,yBAA4B;AAC5B,eAA0B;AAE1B,MAAM,2BAA2B,CAAC;AAAA;AAAA,EAEhC,MAAM,WAAW,KAAK,KAAK,EAAE,WAAW,KAAK,KAAK;AAAA;AAS7C,MAAM,2BAA2B,CACtC,OACA,YACoE;AACpE,MAAI,UAAU,OAAW,QAAO,OAAO,QAAQ,MAAS;AACxD,QAAM,mBAAkC,CAAC;AACzC,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,YAAY,QAAW;AAChC,aAAO,OAAO;AAAA,QACZ,IAAI,+BAAY;AAAA,UACd,MAAM;AAAA,UACN,SAAS,oDAAoD,OAAO,IAAI;AAAA,UACxE,MAAM;AAAA,UACN,QAAQ,OAAO;AAAA,QACjB,CAAC;AAAA,MACH;AAAA,IACF;AACA,qBAAiB,KAAK,GAAG,yBAAyB,OAAO,IAAI,CAAC,IAAI,yBAAyB,OAAO,OAAO,CAAC,EAAE;AAAA,EAC9G;AACA,QAAM,WAAW,SAAS,OAAO,KAAK;AACtC,MAAI,CAAC,SAAS,IAAI;AAChB,WAAO,OAAO;AAAA,MACZ,IAAI,+BAAY;AAAA,QACd,MAAM;AAAA,QACN,SAAS,qBAAqB,SAAS,SAAS;AAAA,QAChD,MAAM,4BAA4B,SAAS,KAAK,MAAM,CAAC,CAAC;AAAA,MAC1D,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO,OAAO,oBAAoB,mBAAO,gBAAgB,EAAE,SAAS,KAAK,EAAE;AAAA,IACzE,OAAO;AAAA,MAAS,MACd,IAAI,+BAAY;AAAA,QACd,MAAM;AAAA,QACN,SAAS;AAAA,QACT,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,IACA,OAAO,IAAI,CAAC,gBAAgB;AAC1B,YAAM,eAAsD,CAAC;AAC7D,iBAAW,QAAQ,OAAO,KAAK,YAAY,YAAY,GAAG;AACxD,eAAO,eAAe,cAAc,MAAM;AAAA,UACxC,OAAO,OAAO,OAAO,CAAC,GAAG,YAAY,aAAa,IAAI,CAAE,CAAC;AAAA,UACzD,YAAY;AAAA,QACd,CAAC;AAAA,MACH;AACA,aAAO,OAAO,OAAO;AAAA,QACnB,QAAQ,OAAO,OAAO,CAAC,GAAG,kBAAkB,GAAG,YAAY,MAAM,CAAC;AAAA,QAClE,cAAc,OAAO,OAAO,YAAY;AAAA,MAC1C,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/esm/Config.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Bounded JSON configuration consumed and produced by the plugin kernel.
+ *
+ * Configuration is an extension namespace, not an engine-policy surface.
+ * Durable retry, concurrency, and storage policy stay on their owning Effect
+ * services and constructor options. Every accepted value is copied before any
+ * plugin observes it, then frozen recursively.
+ *
+ * @since 1.0.0-rc.0
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { PluginError } from "./PluginError.ts";
+/**
+ * Maximum encoded bytes accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumConfigBytes: number;
+/**
+ * Maximum nesting accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumConfigDepth: number;
+/**
+ * Maximum aggregate members accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumConfigMembers: number;
+/**
+ * Maximum aggregate values accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumConfigNodes: number;
+/**
+ * One value accepted in a plugin-owned configuration namespace.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export declare const ConfigValue: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+/**
+ * One value accepted in a plugin-owned configuration namespace.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type ConfigValue = typeof ConfigValue.Type;
+/**
+ * Admits pre-resolution configuration as a detached, recursively frozen snapshot.
+ *
+ * Keys name plugin-owned namespaces. `engine`, `retry`, `store`, and
+ * `plugins` are refused because accepting those names would imply policy the
+ * plugin kernel does not own or apply.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export declare const FlowsConfig: Schema.decodeTo<Schema.declare<Readonly<Record<string, Schema.Json>>, Readonly<Record<string, Schema.Json>>>, Schema.Unknown, never, never>;
+/**
+ * The decoded form of {@link FlowsConfig}.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type FlowsConfig = typeof FlowsConfig.Type;
+/**
+ * Admits the detached, recursively frozen configuration handed to plugins.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export declare const ResolvedConfig: Schema.decodeTo<Schema.declare<Readonly<Record<string, Schema.Json>>, Readonly<Record<string, Schema.Json>>>, Schema.Unknown, never, never>;
+/**
+ * The decoded form of {@link ResolvedConfig}.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type ResolvedConfig = typeof ResolvedConfig.Type;
+/**
+ * Empty defaults. Engine policy is deliberately not defaulted here.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export declare const defaults: ResolvedConfig;
+/**
+ * Copies and deep-merges a configuration patch over a base configuration.
+ *
+ * Records merge key-by-key and every other JSON value replaces wholesale.
+ * Raw operands are admitted; known snapshots retain unchanged subtrees.
+ * Cached subtree totals enforce merged output bounds. Unsafe property names,
+ * accessors, cycles, exotic prototypes, and aggregate values outside the
+ * resource limits fail with `config_invalid`.
+ *
+ * @category combinators
+ * @since 1.0.0-rc.0
+ */
+export declare const merge: (base: FlowsConfig, patch: unknown) => FlowsConfig;
+/**
+ * Copies and freezes one JSON value without retaining caller-owned objects.
+ *
+ * @category utils
+ * @since 1.0.0-rc.0
+ */
+export declare const deepFreeze: <A extends ConfigValue>(value: A) => A;
+/**
+ * Admits a raw pre-resolution configuration as an immutable snapshot.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export declare const snapshot: (config: unknown) => Effect.Effect<FlowsConfig, PluginError>;
+/**
+ * Decodes the post-waterfall configuration into its final immutable form.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export declare const resolve: (config: unknown) => Effect.Effect<ResolvedConfig, PluginError>;
+//# sourceMappingURL=Config.d.ts.map

package/dist/esm/Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAIvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAkC,CAAA;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAkC,CAAA;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAoC,CAAA;AAErE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAkC,CAAA;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,WAAW,sDAAc,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAwBjD;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,6IAAsB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,6IAAsB,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAyBvD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,cAAmC,CAAA;AAE1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,WAAW,EAAE,OAAO,OAAO,KAAG,WAUzD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,WAAW,EAAE,OAAO,CAAC,KAAG,CAI5D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CACU,CAAA;AAE3F;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAqB,CAAA"}

package/dist/esm/Config.js

@@ -0,0 +1,160 @@
+/**
+ * Bounded JSON configuration consumed and produced by the plugin kernel.
+ *
+ * Configuration is an extension namespace, not an engine-policy surface.
+ * Durable retry, concurrency, and storage policy stay on their owning Effect
+ * services and constructor options. Every accepted value is copied before any
+ * plugin observes it, then frozen recursively.
+ *
+ * @since 1.0.0-rc.0
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as SchemaGetter from "effect/SchemaGetter";
+import * as SchemaIssue from "effect/SchemaIssue";
+import * as Boundary from "./internal/Boundary.js";
+import { PluginError } from "./PluginError.js";
+/**
+ * Maximum encoded bytes accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumConfigBytes = Boundary.defaultLimits.maxBytes;
+/**
+ * Maximum nesting accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumConfigDepth = Boundary.defaultLimits.maxDepth;
+/**
+ * Maximum aggregate members accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumConfigMembers = Boundary.defaultLimits.maxMembers;
+/**
+ * Maximum aggregate values accepted for one plugin configuration.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumConfigNodes = Boundary.defaultLimits.maxNodes;
+/**
+ * One value accepted in a plugin-owned configuration namespace.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export const ConfigValue = Schema.Json;
+const admittedConfigs = new WeakSet();
+const configurationSchema = Schema.Unknown.pipe(Schema.decodeTo(Schema.declare((value) => typeof value === "object" && value !== null && admittedConfigs.has(value)), {
+    decode: SchemaGetter.transformEffect((value) => Effect.try({
+        try: () => snapshotRecord(value),
+        catch: (cause) => {
+            const error = cause;
+            return new SchemaIssue.InvalidValue({ message: `${error.path}: ${error.message}` });
+        }
+    })),
+    encode: SchemaGetter.transform((value) => value)
+}));
+/**
+ * Admits pre-resolution configuration as a detached, recursively frozen snapshot.
+ *
+ * Keys name plugin-owned namespaces. `engine`, `retry`, `store`, and
+ * `plugins` are refused because accepting those names would imply policy the
+ * plugin kernel does not own or apply.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export const FlowsConfig = configurationSchema;
+/**
+ * Admits the detached, recursively frozen configuration handed to plugins.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export const ResolvedConfig = configurationSchema;
+const reservedRootKeys = new Set(["engine", "retry", "store", "plugins"]);
+const invalid = (path, complaint) => new PluginError({
+    code: "config_invalid",
+    message: `plugin configuration ${complaint}`,
+    path
+});
+const snapshotRecord = (input, reuse = true) => {
+    if (reuse && typeof input === "object" && input !== null && admittedConfigs.has(input))
+        return input;
+    const admitted = Boundary.record(input);
+    if (!admitted.ok)
+        throw invalid(admitted.path, admitted.complaint);
+    const record = admitted.value;
+    for (const key of Object.keys(record)) {
+        if (reservedRootKeys.has(key)) {
+            throw invalid(`$.${key}`, "uses a runtime-policy key that the plugin kernel does not own");
+        }
+    }
+    admittedConfigs.add(record);
+    return record;
+};
+/**
+ * Empty defaults. Engine policy is deliberately not defaulted here.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export const defaults = snapshotRecord({});
+/**
+ * Copies and deep-merges a configuration patch over a base configuration.
+ *
+ * Records merge key-by-key and every other JSON value replaces wholesale.
+ * Raw operands are admitted; known snapshots retain unchanged subtrees.
+ * Cached subtree totals enforce merged output bounds. Unsafe property names,
+ * accessors, cycles, exotic prototypes, and aggregate values outside the
+ * resource limits fail with `config_invalid`.
+ *
+ * @category combinators
+ * @since 1.0.0-rc.0
+ */
+export const merge = (base, patch) => {
+    const safeBase = snapshotRecord(base);
+    if (patch === undefined)
+        return safeBase;
+    // Even a known patch is copied so its tree cannot alias the retained base.
+    const safePatch = snapshotRecord(patch, false);
+    const merged = Boundary.mergeRecords(safeBase, safePatch);
+    if (!merged.ok)
+        throw invalid(merged.path, merged.complaint);
+    const record = merged.value;
+    admittedConfigs.add(record);
+    return record;
+};
+/**
+ * Copies and freezes one JSON value without retaining caller-owned objects.
+ *
+ * @category utils
+ * @since 1.0.0-rc.0
+ */
+export const deepFreeze = (value) => {
+    const admitted = Boundary.admit(value);
+    if (!admitted.ok)
+        throw invalid(admitted.path, admitted.complaint);
+    return admitted.value;
+};
+/**
+ * Admits a raw pre-resolution configuration as an immutable snapshot.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export const snapshot = (config) => Effect.try({ try: () => snapshotRecord(config), catch: (cause) => cause });
+/**
+ * Decodes the post-waterfall configuration into its final immutable form.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export const resolve = (config) => snapshot(config);
+//# sourceMappingURL=Config.js.map

package/dist/esm/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bounded JSON configuration consumed and produced by the plugin kernel.\n *\n * Configuration is an extension namespace, not an engine-policy surface.\n * Durable retry, concurrency, and storage policy stay on their owning Effect\n * services and constructor options. Every accepted value is copied before any\n * plugin observes it, then frozen recursively.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport * as SchemaGetter from \"effect/SchemaGetter\"\nimport * as SchemaIssue from \"effect/SchemaIssue\"\nimport * as Boundary from \"./internal/Boundary.ts\"\nimport { PluginError } from \"./PluginError.ts\"\n\n/**\n * Maximum encoded bytes accepted for one plugin configuration.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumConfigBytes = Boundary.defaultLimits.maxBytes\n\n/**\n * Maximum nesting accepted for one plugin configuration.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumConfigDepth = Boundary.defaultLimits.maxDepth\n\n/**\n * Maximum aggregate members accepted for one plugin configuration.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumConfigMembers = Boundary.defaultLimits.maxMembers\n\n/**\n * Maximum aggregate values accepted for one plugin configuration.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumConfigNodes = Boundary.defaultLimits.maxNodes\n\n/**\n * One value accepted in a plugin-owned configuration namespace.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport const ConfigValue = Schema.Json\n\n/**\n * One value accepted in a plugin-owned configuration namespace.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport type ConfigValue = typeof ConfigValue.Type\n\nconst admittedConfigs = new WeakSet<object>()\n\nconst configurationSchema = Schema.Unknown.pipe(\n  Schema.decodeTo(\n    Schema.declare<Readonly<Record<string, ConfigValue>>>((value): value is Readonly<Record<string, ConfigValue>> =>\n      typeof value === \"object\" && value !== null && admittedConfigs.has(value)\n    ),\n    {\n      decode: SchemaGetter.transformEffect((value) =>\n        Effect.try({\n          try: () => snapshotRecord(value),\n          catch: (cause) => {\n            const error = cause as PluginError\n            return new SchemaIssue.InvalidValue({ message: `${error.path}: ${error.message}` })\n          }\n        })\n      ),\n      encode: SchemaGetter.transform((value) => value)\n    }\n  )\n)\n\n/**\n * Admits pre-resolution configuration as a detached, recursively frozen snapshot.\n *\n * Keys name plugin-owned namespaces. `engine`, `retry`, `store`, and\n * `plugins` are refused because accepting those names would imply policy the\n * plugin kernel does not own or apply.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport const FlowsConfig = configurationSchema\n\n/**\n * The decoded form of {@link FlowsConfig}.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport type FlowsConfig = typeof FlowsConfig.Type\n\n/**\n * Admits the detached, recursively frozen configuration handed to plugins.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport const ResolvedConfig = configurationSchema\n\n/**\n * The decoded form of {@link ResolvedConfig}.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport type ResolvedConfig = typeof ResolvedConfig.Type\n\nconst reservedRootKeys = new Set([\"engine\", \"retry\", \"store\", \"plugins\"])\n\nconst invalid = (path: string, complaint: string): PluginError =>\n  new PluginError({\n    code: \"config_invalid\",\n    message: `plugin configuration ${complaint}`,\n    path\n  })\n\nconst snapshotRecord = (input: unknown, reuse = true): Readonly<Record<string, ConfigValue>> => {\n  if (reuse && typeof input === \"object\" && input !== null && admittedConfigs.has(input)) return input as ResolvedConfig\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) throw invalid(admitted.path, admitted.complaint)\n  const record = admitted.value as Readonly<Record<string, ConfigValue>>\n  for (const key of Object.keys(record)) {\n    if (reservedRootKeys.has(key)) {\n      throw invalid(`$.${key}`, \"uses a runtime-policy key that the plugin kernel does not own\")\n    }\n  }\n  admittedConfigs.add(record)\n  return record\n}\n\n/**\n * Empty defaults. Engine policy is deliberately not defaulted here.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const defaults: ResolvedConfig = snapshotRecord({})\n\n/**\n * Copies and deep-merges a configuration patch over a base configuration.\n *\n * Records merge key-by-key and every other JSON value replaces wholesale.\n * Raw operands are admitted; known snapshots retain unchanged subtrees.\n * Cached subtree totals enforce merged output bounds. Unsafe property names,\n * accessors, cycles, exotic prototypes, and aggregate values outside the\n * resource limits fail with `config_invalid`.\n *\n * @category combinators\n * @since 1.0.0-rc.0\n */\nexport const merge = (base: FlowsConfig, patch: unknown): FlowsConfig => {\n  const safeBase = snapshotRecord(base)\n  if (patch === undefined) return safeBase\n  // Even a known patch is copied so its tree cannot alias the retained base.\n  const safePatch = snapshotRecord(patch, false)\n  const merged = Boundary.mergeRecords(safeBase, safePatch)\n  if (!merged.ok) throw invalid(merged.path, merged.complaint)\n  const record = merged.value as ResolvedConfig\n  admittedConfigs.add(record)\n  return record\n}\n\n/**\n * Copies and freezes one JSON value without retaining caller-owned objects.\n *\n * @category utils\n * @since 1.0.0-rc.0\n */\nexport const deepFreeze = <A extends ConfigValue>(value: A): A => {\n  const admitted = Boundary.admit(value)\n  if (!admitted.ok) throw invalid(admitted.path, admitted.complaint)\n  return admitted.value as A\n}\n\n/**\n * Admits a raw pre-resolution configuration as an immutable snapshot.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const snapshot = (config: unknown): Effect.Effect<FlowsConfig, PluginError> =>\n  Effect.try({ try: () => snapshotRecord(config), catch: (cause) => cause as PluginError })\n\n/**\n * Decodes the post-waterfall configuration into its final immutable form.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const resolve = (config: unknown): Effect.Effect<ResolvedConfig, PluginError> => snapshot(config)\n"]}

package/dist/esm/Hooks.d.ts

@@ -0,0 +1,176 @@
+/**
+ * The typed hook surface: hook kinds, the hook entry shape, and the shared
+ * kernel's base hook catalog.
+ *
+ * The public package contract is documented at
+ * {@link https://smithers.sh/docs/reference/api/plugin}. The shared catalog is limited to
+ * `config` and `configResolved`;
+ * `@smthrs/agent` adds only `cellRegistry`, `cellFlows`, and
+ * `cellModelRequest`. Durable-core lifecycle policy is not a hook catalog.
+ *
+ * `FlowsHooks` is **open for augmentation, closed for dispatch**: a host
+ * declares its hooks with `declare module "@smthrs/plugin"`, supplies the
+ * matching runtime catalog, and dispatches only that bounded set.
+ *
+ * @since 1.0.0-rc.0
+ */
+import type * as Effect from "effect/Effect";
+/**
+ * Dispatch semantics of a hook, fixed by the core.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type HookKind = "sequential" | "parallel" | "first" | "waterfall";
+declare const HookTypeId: unique symbol;
+/**
+ * Phantom carrier that records a hook's kind and handler type in the type
+ * system without adding anything at runtime.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export interface HookMeta<K extends HookKind, F> {
+    readonly [HookTypeId]?: {
+        readonly kind: K;
+        readonly handler: F;
+    };
+}
+/**
+ * The object form of a hook entry: Vite's per-hook ordering object, verbatim.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export interface HookObject<F> {
+    readonly order?: "pre" | "post" | undefined;
+    readonly handler: F;
+}
+/**
+ * A hook entry is either the bare handler or `{ order?, handler }`.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type HookEntry<K extends HookKind, F> = (F | HookObject<F>) & HookMeta<K, F>;
+/**
+ * Every handler runs, in resolved order, one at a time.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type SequentialHook<F> = HookEntry<"sequential", F>;
+/**
+ * Every handler runs concurrently; results are ignored and failures are
+ * returned to the caller rather than failing it.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type ParallelHook<F> = HookEntry<"parallel", F>;
+/**
+ * Handlers run in order until one returns `Option.some`.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type FirstHook<F> = HookEntry<"first", F>;
+/**
+ * Each handler receives the previous handler's output.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type WaterfallHook<F> = HookEntry<"waterfall", F>;
+/**
+ * Extracts the declared kind of a hook entry type.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type KindOf<T> = T extends HookMeta<infer K, any> ? K : never;
+/**
+ * The runtime catalog a host supplies for a hook interface: each hook name
+ * mapped to its kind. A name declared in `H` must carry the kind its type
+ * declares. Names outside `H` are admitted with any kind, because the type
+ * system cannot enumerate an augmentable interface; resolution checks them
+ * at runtime and dispatch refuses a kind that disagrees with the catalog.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type HookCatalog<H> = {
+    readonly [K in keyof H & string]?: KindOf<H[K]>;
+} & {
+    readonly [name: string]: HookKind | undefined;
+};
+/**
+ * Extracts the handler type of a hook entry type.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type HandlerOf<T> = T extends HookMeta<any, infer F> ? F : never;
+/**
+ * Selects the hook names of a given kind from a hook interface.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type KeysOfKind<H, K extends HookKind> = {
+    [P in keyof H]: KindOf<H[P]> extends K ? P : never;
+}[keyof H] & string;
+/**
+ * Extracts the positional argument tuple accepted by a hook entry.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type ArgsOf<T> = HandlerOf<T> extends (...args: infer A) => any ? A : never;
+/**
+ * Extracts the Effect returned by a hook entry.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type ReturnOf<T> = HandlerOf<T> extends (...args: any) => infer R ? R : never;
+/**
+ * Extracts the success value returned by a hook entry's Effect.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type SuccessOf<T> = ReturnOf<T> extends Effect.Effect<infer A, any, any> ? A : never;
+/**
+ * Extracts the context required by a hook entry's Effect.
+ *
+ * @category type-level
+ * @since 1.0.0-rc.0
+ */
+export type ContextOf<T> = ReturnOf<T> extends Effect.Effect<any, any, infer R> ? R : never;
+/**
+ * Frozen runtime catalog for the shared configuration hooks.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export declare const engineHooks: Readonly<{
+    readonly config: "waterfall";
+    readonly configResolved: "parallel";
+}>;
+/**
+ * Normalizes a hook entry to its handler.
+ *
+ * @category utils
+ * @since 1.0.0-rc.0
+ */
+export declare const handlerOf: (entry: unknown) => (...args: Array<any>) => unknown;
+/**
+ * Reads the per-hook `order` of a hook entry.
+ *
+ * @category utils
+ * @since 1.0.0-rc.0
+ */
+export declare const orderOf: (entry: unknown) => "pre" | "post" | undefined;
+export {};
+//# sourceMappingURL=Hooks.d.ts.map

package/dist/esm/Hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../src/Hooks.ts"],"names":[],"mappings":"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"}

package/dist/esm/Hooks.js

@@ -0,0 +1,56 @@
+/**
+ * The typed hook surface: hook kinds, the hook entry shape, and the shared
+ * kernel's base hook catalog.
+ *
+ * The public package contract is documented at
+ * {@link https://smithers.sh/docs/reference/api/plugin}. The shared catalog is limited to
+ * `config` and `configResolved`;
+ * `@smthrs/agent` adds only `cellRegistry`, `cellFlows`, and
+ * `cellModelRequest`. Durable-core lifecycle policy is not a hook catalog.
+ *
+ * `FlowsHooks` is **open for augmentation, closed for dispatch**: a host
+ * declares its hooks with `declare module "@smthrs/plugin"`, supplies the
+ * matching runtime catalog, and dispatches only that bounded set.
+ *
+ * @since 1.0.0-rc.0
+ */
+/**
+ * Runtime catalog of the shared kernel's hook names and kinds.
+ *
+ * The type system cannot enumerate an augmentable interface, so this constant
+ * is what the `unknown_hook` guard checks against. A host passes its own
+ * superset to {@link resolve}. The cell harness adds only the hooks it
+ * dispatches; lifecycle and engine-policy hooks do not belong here.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+const sharedHooks = Object.create(null);
+Object.defineProperties(sharedHooks, {
+    config: { value: "waterfall", enumerable: true },
+    configResolved: { value: "parallel", enumerable: true }
+});
+/**
+ * Frozen runtime catalog for the shared configuration hooks.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export const engineHooks = Object.freeze(sharedHooks);
+/**
+ * Normalizes a hook entry to its handler.
+ *
+ * @category utils
+ * @since 1.0.0-rc.0
+ */
+export const handlerOf = (entry) => typeof entry === "function"
+    ? entry
+    : entry.handler;
+/**
+ * Reads the per-hook `order` of a hook entry.
+ *
+ * @category utils
+ * @since 1.0.0-rc.0
+ */
+export const orderOf = (entry) => typeof entry === "function" ? undefined : entry.order;
+//# sourceMappingURL=Hooks.js.map