@alpacakit/core 0.1.0-beta.19

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masahiro Tonomura (codemafia0000)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# @alpacakit/core
+
+Architecture-neutral kernel primitives shared by the AlpacaLoop workspace
+packages and the `alpacaloop` control plane: branded ids, port interfaces
+(registry, resolver, adapter, reducer, projector, pipeline, runtime codec),
+map/keyed registries, sequential pipelines, zod schema helpers and codecs,
+defaulted model factories, and immer-based immutable mutation helpers.
+
+This package is published together with the root `alpacaloop` package and
+`@alpacakit/plan-graph` (which depends on it). Its zod and immer coupling
+is deliberate: schema helpers and mutation helpers are part of the public
+API, so both libraries are pinned runtime dependencies.
+
+Main exports: `createMapRegistry` / `createKeyedRegistry`,
+`createOrderedResolver`, `createSequentialPipeline`,
+`createSchemaRuntimeCodec` and the `schema.ts` helpers, `makeBrandedId` /
+id factories, `produceImmutable` and the draft mutation helpers, and the
+shared empty-value defaults.

package/dist/adapters/fs-layered-asset-source.d.ts

@@ -0,0 +1,12 @@
+import { type AssetLayer, type AssetSourceDiagnostic, type LayeredAssetSource, type LoadedAsset } from "../ports.js";
+export declare class FsLayeredAssetSource implements LayeredAssetSource {
+    private readonly layers;
+    private loaded;
+    private currentDiagnostics;
+    constructor(layers: readonly AssetLayer[]);
+    list(): Promise<readonly LoadedAsset[]>;
+    get(assetPath: string): Promise<LoadedAsset | null>;
+    diagnostics(): readonly AssetSourceDiagnostic[];
+    private load;
+}
+//# sourceMappingURL=fs-layered-asset-source.d.ts.map

package/dist/adapters/fs-layered-asset-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-layered-asset-source.d.ts","sourceRoot":"","sources":["../../src/adapters/fs-layered-asset-source.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EAEvB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAsBrB,qBAAa,oBAAqB,YAAW,kBAAkB;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,kBAAkB,CAAwC;gBAErC,MAAM,EAAE,SAAS,UAAU,EAAE;IAE1D,IAAI,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAKjC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAOzD,WAAW,IAAI,SAAS,qBAAqB,EAAE;YAIjC,IAAI;CA4CnB"}

package/dist/adapters/fs-layered-asset-source.js

@@ -0,0 +1,170 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { ASSET_LAYER_KIND, ASSET_SOURCE_DIAGNOSTIC_KIND, LOADED_ASSET_SOURCE, } from "../ports.js";
+const FRONTMATTER_DELIMITER = "---";
+const SYSTEM_EJECTED_DIRECTORY = "__system";
+const LOADED_ASSET_SOURCE_BY_LAYER_KIND = {
+    [ASSET_LAYER_KIND.repository]: LOADED_ASSET_SOURCE.repository,
+    [ASSET_LAYER_KIND.packagedSystem]: LOADED_ASSET_SOURCE.packagedSystem,
+};
+export class FsLayeredAssetSource {
+    layers;
+    loaded = null;
+    currentDiagnostics = [];
+    constructor(layers) {
+        this.layers = layers;
+    }
+    list() {
+        this.loaded ??= this.load();
+        return this.loaded;
+    }
+    async get(assetPath) {
+        const normalized = normalizeAssetPath(assetPath);
+        return ((await this.list()).find((asset) => asset.path === normalized) ?? null);
+    }
+    diagnostics() {
+        return this.currentDiagnostics;
+    }
+    async load() {
+        const diagnostics = [];
+        const discoveredByKindAndPath = new Map();
+        const selectedByPath = new Map();
+        for (const layer of this.layers) {
+            for (const asset of await discoverLayer(layer)) {
+                const kindPathKey = `${layer.kind}\0${asset.path}`;
+                const group = discoveredByKindAndPath.get(kindPathKey);
+                if (group === undefined) {
+                    discoveredByKindAndPath.set(kindPathKey, {
+                        first: asset,
+                        roots: new Set([layer.root]),
+                    });
+                }
+                else {
+                    group.roots.add(layer.root);
+                }
+                if (!selectedByPath.has(asset.path)) {
+                    selectedByPath.set(asset.path, asset);
+                }
+            }
+        }
+        for (const group of discoveredByKindAndPath.values()) {
+            const roots = duplicateRoots(group.roots);
+            if (roots === null) {
+                continue;
+            }
+            diagnostics.push({
+                kind: ASSET_SOURCE_DIAGNOSTIC_KIND.duplicateInLayer,
+                path: group.first.path,
+                layerKind: group.first.layer.kind,
+                roots,
+            });
+        }
+        const assets = await Promise.all([...selectedByPath.values()]
+            .sort((left, right) => left.path.localeCompare(right.path))
+            .map(loadAsset));
+        this.currentDiagnostics = diagnostics.sort(compareDiagnostics);
+        return assets;
+    }
+}
+function duplicateRoots(roots) {
+    const [first, second, ...remaining] = roots;
+    return first === undefined || second === undefined
+        ? null
+        : [first, second, ...remaining];
+}
+async function discoverLayer(layer) {
+    const paths = await discoverFilePaths(layer.root, layer.root);
+    return paths.map((filePath) => ({
+        layer,
+        path: toAssetPath(layer.root, filePath),
+        filePath,
+    }));
+}
+async function discoverFilePaths(root, directory) {
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isMissingPath(error) && directory === root) {
+            return [];
+        }
+        throw error;
+    }
+    const files = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        const entryPath = path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await discoverFilePaths(root, entryPath)));
+        }
+        else if (entry.isFile()) {
+            files.push(entryPath);
+        }
+    }
+    return files;
+}
+async function loadAsset(asset) {
+    const raw = await readFile(asset.filePath, "utf8");
+    const split = splitFrontmatter(raw, asset.path);
+    return {
+        path: asset.path,
+        content: split.content,
+        frontmatter: split.frontmatter,
+        source: resolveAssetSource(asset),
+    };
+}
+function splitFrontmatter(raw, assetPath) {
+    const lines = raw.split(/\r?\n/u);
+    if (lines[0] !== FRONTMATTER_DELIMITER) {
+        return { frontmatter: null, content: raw };
+    }
+    const closingIndex = lines.indexOf(FRONTMATTER_DELIMITER, 1);
+    if (closingIndex < 0) {
+        throw new Error(`Asset frontmatter is missing a closing delimiter: ${assetPath}`);
+    }
+    const frontmatterText = lines.slice(1, closingIndex).join("\n");
+    return {
+        frontmatter: frontmatterText.trim().length === 0 ? null : parseYaml(frontmatterText),
+        content: lines.slice(closingIndex + 1).join("\n"),
+    };
+}
+function resolveAssetSource(asset) {
+    if (isSystemEjectedAsset(asset)) {
+        return LOADED_ASSET_SOURCE.systemEjected;
+    }
+    return LOADED_ASSET_SOURCE_BY_LAYER_KIND[asset.layer.kind];
+}
+function isSystemEjectedAsset(asset) {
+    return (asset.layer.kind === ASSET_LAYER_KIND.repository &&
+        asset.path.split("/").includes(SYSTEM_EJECTED_DIRECTORY));
+}
+function toAssetPath(root, filePath) {
+    return normalizeAssetPath(path.relative(root, filePath).split(path.sep).join("/"));
+}
+function normalizeAssetPath(assetPath) {
+    const normalized = path.posix.normalize(assetPath);
+    if (assetPath.length === 0 ||
+        path.isAbsolute(assetPath) ||
+        path.win32.isAbsolute(assetPath) ||
+        assetPath.includes("\\") ||
+        normalized === "." ||
+        normalized === ".." ||
+        normalized.startsWith("../") ||
+        normalized !== assetPath) {
+        throw new Error(`Invalid layered asset path: ${assetPath}`);
+    }
+    return normalized;
+}
+function compareDiagnostics(left, right) {
+    return (left.path.localeCompare(right.path) ||
+        compareLayerKinds(left.layerKind, right.layerKind));
+}
+function compareLayerKinds(left, right) {
+    return left.localeCompare(right);
+}
+function isMissingPath(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        error.code === "ENOENT");
+}

package/dist/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./fs-layered-asset-source.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1 @@
+export * from "./fs-layered-asset-source.js";

package/dist/branding.d.ts

@@ -0,0 +1,2 @@
+export declare const SERVICE_DISPLAY_NAME = "AlpacaLoop";
+//# sourceMappingURL=branding.d.ts.map

package/dist/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../src/branding.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC"}

package/dist/branding.js

@@ -0,0 +1 @@
+export const SERVICE_DISPLAY_NAME = "AlpacaLoop";

package/dist/decode-result.d.ts

@@ -0,0 +1,13 @@
+import { CODEC_DECODE_RESULT_KIND, type CodecDecodeResult } from "./ports.js";
+type DecodedValue<Result> = Result extends {
+    readonly kind: typeof CODEC_DECODE_RESULT_KIND.decoded;
+    readonly value: infer Value;
+} ? Value : never;
+type DecodedValueTuple<Results extends readonly CodecDecodeResult<unknown>[]> = {
+    readonly [Index in keyof Results]: DecodedValue<Results[Index]>;
+};
+export declare function decodedCodecResult<Value>(value: Value): CodecDecodeResult<Value>;
+export declare function invalidCodecResult(issues: readonly [string, ...string[]]): CodecDecodeResult<never>;
+export declare function allCodecDecodeResults<const Results extends readonly CodecDecodeResult<unknown>[]>(results: Results): CodecDecodeResult<DecodedValueTuple<Results>>;
+export {};
+//# sourceMappingURL=decode-result.d.ts.map

package/dist/decode-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-result.d.ts","sourceRoot":"","sources":["../src/decode-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9E,KAAK,YAAY,CAAC,MAAM,IAAI,MAAM,SAAS;IACzC,QAAQ,CAAC,IAAI,EAAE,OAAO,wBAAwB,CAAC,OAAO,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC;CAC7B,GACG,KAAK,GACL,KAAK,CAAC;AAEV,KAAK,iBAAiB,CAAC,OAAO,SAAS,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,IAC1E;IACE,QAAQ,EAAE,KAAK,IAAI,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;CAChE,CAAC;AAEJ,wBAAgB,kBAAkB,CAAC,KAAK,EACtC,KAAK,EAAE,KAAK,GACX,iBAAiB,CAAC,KAAK,CAAC,CAE1B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACrC,iBAAiB,CAAC,KAAK,CAAC,CAE1B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,OAAO,SAAS,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAC3D,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAcjE"}

package/dist/decode-result.js

@@ -0,0 +1,23 @@
+import { CODEC_DECODE_RESULT_KIND } from "./ports.js";
+export function decodedCodecResult(value) {
+    return { kind: CODEC_DECODE_RESULT_KIND.decoded, value };
+}
+export function invalidCodecResult(issues) {
+    return { kind: CODEC_DECODE_RESULT_KIND.invalid, issues };
+}
+export function allCodecDecodeResults(results) {
+    const values = [];
+    const issues = [];
+    for (const result of results) {
+        if (result.kind === CODEC_DECODE_RESULT_KIND.decoded) {
+            values.push(result.value);
+        }
+        else {
+            issues.push(...result.issues);
+        }
+    }
+    const [firstIssue, ...remainingIssues] = issues;
+    return firstIssue === undefined
+        ? decodedCodecResult(values)
+        : invalidCodecResult([firstIssue, ...remainingIssues]);
+}

package/dist/defaults.d.ts

@@ -0,0 +1,6 @@
+export declare const EMPTY_JSON_OBJECT: Readonly<{}>;
+export declare const EMPTY_METADATA: Readonly<{}>;
+export declare const EMPTY_JSON_ARRAY: readonly never[];
+export declare const EMPTY_STRING_LIST: readonly never[];
+export declare const EMPTY_DEFINITION_LIST: readonly never[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,cAAyC,CAAC;AACxE,eAAO,MAAM,cAAc,cAAuC,CAAC;AACnE,eAAO,MAAM,gBAAgB,kBAAwC,CAAC;AACtE,eAAO,MAAM,iBAAiB,kBAAgD,CAAC;AAC/E,eAAO,MAAM,qBAAqB,kBAEN,CAAC"}

package/dist/defaults.js

@@ -0,0 +1,5 @@
+export const EMPTY_JSON_OBJECT = Object.freeze({});
+export const EMPTY_METADATA = EMPTY_JSON_OBJECT;
+export const EMPTY_JSON_ARRAY = Object.freeze([]);
+export const EMPTY_STRING_LIST = Object.freeze([]);
+export const EMPTY_DEFINITION_LIST = Object.freeze([]);

package/dist/definition.d.ts

@@ -0,0 +1,35 @@
+import type { CodecDecodeResult, Registry, RuntimeCodec } from "./ports.js";
+export interface PayloadCodecDefinition<Key> {
+    readonly kind: Key;
+    readonly payloadCodec: {
+        decode(input: unknown): CodecDecodeResult<unknown>;
+    };
+}
+export type PayloadEnvelope<Key, Payload = unknown> = {
+    readonly kind: Key;
+    readonly payload: Payload;
+};
+export type PayloadOf<Definition> = Definition extends {
+    readonly payloadCodec: RuntimeCodec<infer Payload>;
+} ? Payload : unknown;
+export type DecodedPayloadEnvelope<Envelope, Payload> = Omit<Envelope, "payload"> & {
+    readonly payload: Payload;
+};
+export declare function routePayloadEnvelope<Key, Definition extends PayloadCodecDefinition<Key>, Envelope extends PayloadEnvelope<Key>, TResult>(input: {
+    readonly registry: Registry<Key, Definition>;
+    readonly envelope: Envelope;
+    readonly onMissingDefinition: (input: {
+        readonly envelope: Envelope;
+    }) => TResult;
+    readonly onInvalidPayload: (input: {
+        readonly definition: Definition;
+        readonly envelope: Envelope;
+        readonly issues: readonly string[];
+    }) => TResult;
+    readonly onResolved: (input: {
+        readonly definition: Definition;
+        readonly envelope: DecodedPayloadEnvelope<Envelope, PayloadOf<Definition>>;
+        readonly payload: PayloadOf<Definition>;
+    }) => TResult;
+}): TResult;
+//# sourceMappingURL=definition.d.ts.map

package/dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5E,MAAM,WAAW,sBAAsB,CAAC,GAAG;IACzC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,YAAY,EAAE;QACrB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;KACpD,CAAC;CACH;AAED,MAAM,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,IAAI;IACpD,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,UAAU,IAAI,UAAU,SAAS;IACrD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,MAAM,OAAO,CAAC,CAAC;CACpD,GACG,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,MAAM,sBAAsB,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI,CAC1D,QAAQ,EACR,SAAS,CACV,GAAG;IACF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,GAAG,EACH,UAAU,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAC9C,QAAQ,SAAS,eAAe,CAAC,GAAG,CAAC,EACrC,OAAO,EACP,KAAK,EAAE;IACP,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE;QACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;KAC7B,KAAK,OAAO,CAAC;IACd,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE;QACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,KAAK,OAAO,CAAC;IACd,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;KACzC,KAAK,OAAO,CAAC;CACf,GAAG,OAAO,CAwBV"}

package/dist/definition.js

@@ -0,0 +1,24 @@
+import { CODEC_DECODE_RESULT_KIND } from "./ports.js";
+export function routePayloadEnvelope(input) {
+    const definition = input.registry.get(input.envelope.kind);
+    if (definition === null) {
+        return input.onMissingDefinition({ envelope: input.envelope });
+    }
+    const decoded = definition.payloadCodec.decode(input.envelope.payload);
+    if (decoded.kind === CODEC_DECODE_RESULT_KIND.invalid) {
+        return input.onInvalidPayload({
+            definition,
+            envelope: input.envelope,
+            issues: decoded.issues,
+        });
+    }
+    const payload = decoded.value;
+    return input.onResolved({
+        definition,
+        envelope: {
+            ...input.envelope,
+            payload,
+        },
+        payload,
+    });
+}

package/dist/factory.d.ts

@@ -0,0 +1,16 @@
+export type Defaultable<TModel, TDefaultKeys extends keyof TModel> = Omit<TModel, TDefaultKeys> & Partial<Pick<TModel, TDefaultKeys>>;
+export type ModelDefaults<TModel, TDefaultKeys extends keyof TModel> = Required<Pick<TModel, TDefaultKeys>>;
+export interface ModelFactory<TDraft, TModel> {
+    create(draft: TDraft): TModel;
+}
+export interface DefaultProvider<TDefaults> {
+    readonly defaults: TDefaults;
+}
+export declare function applyModelDefaults<TModel, TDefaultKeys extends keyof TModel>(defaults: ModelDefaults<TModel, TDefaultKeys>, draft: Defaultable<TModel, TDefaultKeys>): TModel;
+export declare class DefaultedModelFactory<TModel, TDefaultKeys extends keyof TModel> implements ModelFactory<Defaultable<TModel, TDefaultKeys>, TModel>, DefaultProvider<ModelDefaults<TModel, TDefaultKeys>> {
+    readonly defaults: ModelDefaults<TModel, TDefaultKeys>;
+    constructor(defaults: ModelDefaults<TModel, TDefaultKeys>);
+    create(draft: Defaultable<TModel, TDefaultKeys>): TModel;
+}
+export declare function createDefaultedModelFactory<TModel, TDefaultKeys extends keyof TModel>(defaults: ModelDefaults<TModel, TDefaultKeys>): ModelFactory<Defaultable<TModel, TDefaultKeys>, TModel>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,MAAM,EAAE,YAAY,SAAS,MAAM,MAAM,IAAI,IAAI,CACvE,MAAM,EACN,YAAY,CACb,GACC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,aAAa,CAAC,MAAM,EAAE,YAAY,SAAS,MAAM,MAAM,IAAI,QAAQ,CAC7E,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAC3B,CAAC;AAEF,MAAM,WAAW,YAAY,CAAC,MAAM,EAAE,MAAM;IAC1C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe,CAAC,SAAS;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,SAAS,MAAM,MAAM,EAC1E,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,EAC7C,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,MAAM,CAKR;AAED,qBAAa,qBAAqB,CAAC,MAAM,EAAE,YAAY,SAAS,MAAM,MAAM,CAC1E,YACE,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,EACvD,eAAe,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE1C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC;gBAA7C,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC;IAElE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM;CAGzD;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EACN,YAAY,SAAS,MAAM,MAAM,EAEjC,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,GAC5C,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAEzD"}

package/dist/factory.js

@@ -0,0 +1,18 @@
+export function applyModelDefaults(defaults, draft) {
+    return {
+        ...defaults,
+        ...draft,
+    };
+}
+export class DefaultedModelFactory {
+    defaults;
+    constructor(defaults) {
+        this.defaults = defaults;
+    }
+    create(draft) {
+        return applyModelDefaults(this.defaults, draft);
+    }
+}
+export function createDefaultedModelFactory(defaults) {
+    return new DefaultedModelFactory(defaults);
+}

package/dist/ids.d.ts

@@ -0,0 +1,15 @@
+import type { Brand } from "./types.js";
+export declare const ID_PART_SEPARATOR = ":";
+export declare function joinIdParts(...parts: readonly string[]): string;
+export declare function makeBrandedId<TBrand extends string>(value: string): Brand<string, TBrand>;
+export declare function makeJoinedBrandedId<TBrand extends string>(...parts: readonly string[]): Brand<string, TBrand>;
+type BrandedStringId = string & {
+    readonly __brand: string;
+};
+type BrandedNumberId = number & {
+    readonly __brand: string;
+};
+export declare function defineStringIdFactory<TId extends BrandedStringId>(): (value: string) => TId;
+export declare function defineNonNegativeIntegerFactory<TId extends BrandedNumberId>(name: string): (value: number) => TId;
+export {};
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE/D;AAED,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,EACjD,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAMvB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,EACvD,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAC1B,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvB;AAED,KAAK,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7D,KAAK,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,eAAe,KAAK,CACpE,KAAK,EAAE,MAAM,KACV,GAAG,CAEP;AAED,wBAAgB,+BAA+B,CAAC,GAAG,SAAS,eAAe,EACzE,IAAI,EAAE,MAAM,GACX,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAQxB"}

package/dist/ids.js

@@ -0,0 +1,24 @@
+export const ID_PART_SEPARATOR = ":";
+export function joinIdParts(...parts) {
+    return parts.join(ID_PART_SEPARATOR);
+}
+export function makeBrandedId(value) {
+    if (value.trim().length === 0) {
+        throw new Error("A branded id must be a non-empty string.");
+    }
+    return value;
+}
+export function makeJoinedBrandedId(...parts) {
+    return makeBrandedId(joinIdParts(...parts));
+}
+export function defineStringIdFactory() {
+    return (value) => makeBrandedId(value);
+}
+export function defineNonNegativeIntegerFactory(name) {
+    return (value) => {
+        if (!Number.isInteger(value) || value < 0) {
+            throw new Error(`${name} must be a non-negative integer.`);
+        }
+        return value;
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./adapters/index.js";
+export * from "./branding.js";
+export * from "./decode-result.js";
+export * from "./defaults.js";
+export * from "./definition.js";
+export * from "./factory.js";
+export * from "./ids.js";
+export * from "./mutation.js";
+export * from "./pipeline.js";
+export * from "./ports.js";
+export * from "./registry.js";
+export * from "./schema.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from "./adapters/index.js";
+export * from "./branding.js";
+export * from "./decode-result.js";
+export * from "./defaults.js";
+export * from "./definition.js";
+export * from "./factory.js";
+export * from "./ids.js";
+export * from "./mutation.js";
+export * from "./pipeline.js";
+export * from "./ports.js";
+export * from "./registry.js";
+export * from "./schema.js";
+export * from "./types.js";

package/dist/mutation.d.ts

@@ -0,0 +1,11 @@
+import { type Draft } from "immer";
+export type MutableDraft<TValue> = Draft<TValue>;
+type MutableDraftArrayItem<TItem> = TItem extends object ? MutableDraft<TItem> : TItem;
+type MutableDraftArray<TItem> = MutableDraftArrayItem<TItem>[];
+export declare function produceImmutable<TValue>(value: TValue, mutate: (draft: MutableDraft<TValue>) => void): TValue;
+export declare function appendDraftItems<TItem>(draftItems: MutableDraftArray<TItem>, items: readonly TItem[]): void;
+export declare function replaceExistingDraftItemsByKey<TItem, TKey>(draftItems: MutableDraftArray<TItem>, nextItems: readonly TItem[], keyOf: (item: TItem) => TKey): void;
+export declare function removeDraftItemsWhere<TItem>(draftItems: MutableDraftArray<TItem>, predicate: (item: TItem) => boolean): void;
+export declare function removeDraftItemsByKey<TItem, TKey>(draftItems: MutableDraftArray<TItem>, keys: readonly TKey[], keyOf: (item: TItem) => TKey): void;
+export {};
+//# sourceMappingURL=mutation.d.ts.map

package/dist/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../src/mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,KAAK,EAAW,MAAM,OAAO,CAAC;AAEvD,MAAM,MAAM,YAAY,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;AACjD,KAAK,qBAAqB,CAAC,KAAK,IAAI,KAAK,SAAS,MAAM,GACpD,YAAY,CAAC,KAAK,CAAC,GACnB,KAAK,CAAC;AACV,KAAK,iBAAiB,CAAC,KAAK,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,GAC5C,MAAM,CAER;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EACpC,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACpC,KAAK,EAAE,SAAS,KAAK,EAAE,GACtB,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,IAAI,EACxD,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACpC,SAAS,EAAE,SAAS,KAAK,EAAE,EAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,GAC3B,IAAI,CAUN;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EACzC,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACpC,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,GAClC,IAAI,CAMN;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAC/C,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACpC,IAAI,EAAE,SAAS,IAAI,EAAE,EACrB,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,GAC3B,IAAI,CAIN"}

package/dist/mutation.js

@@ -0,0 +1,32 @@
+import { castDraft, produce } from "immer";
+export function produceImmutable(value, mutate) {
+    return produce(value, mutate);
+}
+export function appendDraftItems(draftItems, items) {
+    draftItems.push(...toDraftItems(items));
+}
+export function replaceExistingDraftItemsByKey(draftItems, nextItems, keyOf) {
+    for (const nextItem of nextItems) {
+        const nextKey = keyOf(nextItem);
+        const itemIndex = draftItems.findIndex((item) => Object.is(keyOf(item), nextKey));
+        if (itemIndex !== -1) {
+            draftItems.splice(itemIndex, 1, toDraftItem(nextItem));
+        }
+    }
+}
+export function removeDraftItemsWhere(draftItems, predicate) {
+    for (let index = draftItems.length - 1; index >= 0; index -= 1) {
+        if (predicate(draftItems[index])) {
+            draftItems.splice(index, 1);
+        }
+    }
+}
+export function removeDraftItemsByKey(draftItems, keys, keyOf) {
+    removeDraftItemsWhere(draftItems, (item) => keys.some((key) => Object.is(keyOf(item), key)));
+}
+function toDraftItem(item) {
+    return castDraft(item);
+}
+function toDraftItems(items) {
+    return castDraft([...items]);
+}

package/dist/pipeline.d.ts

@@ -0,0 +1,12 @@
+import type { Pipeline } from "./ports.js";
+export interface PipelineStep<State> {
+    readonly id: string;
+    run(state: State): Promise<State>;
+}
+export declare class SequentialPipeline<State> implements Pipeline<State, State> {
+    private readonly steps;
+    constructor(steps: readonly PipelineStep<State>[]);
+    run(input: State): Promise<State>;
+}
+export declare function createSequentialPipeline<State>(steps: readonly PipelineStep<State>[]): Pipeline<State, State>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,YAAY,CAAC,KAAK;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACnC;AAED,qBAAa,kBAAkB,CAAC,KAAK,CAAE,YAAW,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE;IAE5D,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;CASxC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAC5C,KAAK,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,GACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAExB"}

package/dist/pipeline.js

@@ -0,0 +1,16 @@
+export class SequentialPipeline {
+    steps;
+    constructor(steps) {
+        this.steps = steps;
+    }
+    async run(input) {
+        let state = input;
+        for (const step of this.steps) {
+            state = await step.run(state);
+        }
+        return state;
+    }
+}
+export function createSequentialPipeline(steps) {
+    return new SequentialPipeline(steps);
+}

package/dist/ports.d.ts

@@ -0,0 +1,91 @@
+import type { ValueOf } from "./types.js";
+export interface Registry<Key, Definition> {
+    get(key: Key): Definition | null;
+    list(): readonly Definition[];
+}
+export interface Resolver<Input, Output> {
+    resolve(input: Input): Output;
+}
+export interface AsyncResolver<Input, Output> {
+    resolve(input: Input): Promise<Output>;
+}
+export interface Adapter<Input, Output> {
+    execute(input: Input): Promise<Output>;
+}
+export interface Reducer<State, Patch> {
+    reduce(state: State, patch: Patch): State;
+}
+export interface Projector<Input, Output> {
+    project(input: Input): Output;
+}
+export interface Pipeline<Input, Output> {
+    run(input: Input): Promise<Output>;
+}
+export interface Clock {
+    /** Epoch milliseconds. */
+    now(): number;
+    /** Schedule a callback; returns a cancel function. */
+    setTimeout(callback: () => void, delayMs: number): () => void;
+}
+export interface HttpClient {
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+}
+export interface SecretResolver {
+    resolve(id: string): Promise<string | null>;
+}
+export type SecretResolvers = Record<string, SecretResolver>;
+export type SecretRef = {
+    readonly resolver: string;
+    readonly id: string;
+};
+export declare const ASSET_LAYER_KIND: {
+    readonly repository: "repository";
+    readonly packagedSystem: "packaged_system";
+};
+export type AssetLayerKind = ValueOf<typeof ASSET_LAYER_KIND>;
+export type AssetLayer = {
+    readonly kind: AssetLayerKind;
+    readonly root: string;
+};
+export declare const LOADED_ASSET_SOURCE: {
+    readonly repository: "repository";
+    readonly packagedSystem: "packaged_system";
+    readonly systemEjected: "system_ejected";
+};
+export type LoadedAssetSource = ValueOf<typeof LOADED_ASSET_SOURCE>;
+export type LoadedAsset = {
+    readonly path: string;
+    readonly content: string;
+    readonly frontmatter: unknown;
+    readonly source: LoadedAssetSource;
+};
+export declare const ASSET_SOURCE_DIAGNOSTIC_KIND: {
+    readonly duplicateInLayer: "duplicate_in_layer";
+};
+export type AssetSourceDiagnostic = {
+    readonly kind: typeof ASSET_SOURCE_DIAGNOSTIC_KIND.duplicateInLayer;
+    readonly path: string;
+    readonly layerKind: AssetLayerKind;
+    readonly roots: readonly [string, string, ...string[]];
+};
+export interface LayeredAssetSource {
+    list(): Promise<readonly LoadedAsset[]>;
+    get(path: string): Promise<LoadedAsset | null>;
+    diagnostics(): readonly AssetSourceDiagnostic[];
+}
+export declare const CODEC_DECODE_RESULT_KIND: {
+    readonly decoded: "decoded";
+    readonly invalid: "invalid";
+};
+export type CodecDecodeResult<Value> = {
+    readonly kind: typeof CODEC_DECODE_RESULT_KIND.decoded;
+    readonly value: Value;
+} | {
+    readonly kind: typeof CODEC_DECODE_RESULT_KIND.invalid;
+    readonly issues: readonly [string, ...string[]];
+};
+export interface RuntimeCodec<Value> {
+    decode(input: unknown): CodecDecodeResult<Value>;
+    encode(value: Value): unknown;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/ports.d.ts.map

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

package/dist/ports.js

@@ -0,0 +1,16 @@
+export const ASSET_LAYER_KIND = {
+    repository: "repository",
+    packagedSystem: "packaged_system",
+};
+export const LOADED_ASSET_SOURCE = {
+    repository: "repository",
+    packagedSystem: "packaged_system",
+    systemEjected: "system_ejected",
+};
+export const ASSET_SOURCE_DIAGNOSTIC_KIND = {
+    duplicateInLayer: "duplicate_in_layer",
+};
+export const CODEC_DECODE_RESULT_KIND = {
+    decoded: "decoded",
+    invalid: "invalid",
+};

package/dist/registry.d.ts

@@ -0,0 +1,30 @@
+import type { AsyncResolver, Registry, Resolver } from "./ports.js";
+export interface Identified<Key extends string> {
+    readonly id: Key;
+}
+export type RegistryMatcher<Input, Definition> = (definition: Definition, input: Input) => boolean;
+export type AsyncRegistryMatcher<Input, Definition> = (definition: Definition, input: Input) => Promise<boolean>;
+export declare class MapRegistry<Key extends string, Definition extends Identified<Key>> implements Registry<Key, Definition> {
+    private readonly items;
+    private readonly itemById;
+    constructor(items: readonly Definition[]);
+    get(key: Key): Definition | null;
+    list(): readonly Definition[];
+}
+export declare class OrderedResolver<Input, Key extends string, Definition extends Identified<Key>> implements Resolver<Input, Definition | null> {
+    private readonly registry;
+    private readonly matcher;
+    constructor(registry: Registry<Key, Definition>, matcher: RegistryMatcher<Input, Definition>);
+    resolve(input: Input): Definition | null;
+}
+export declare class AsyncOrderedResolver<Input, Key extends string, Definition extends Identified<Key>> implements AsyncResolver<Input, Definition | null> {
+    private readonly registry;
+    private readonly matcher;
+    constructor(registry: Registry<Key, Definition>, matcher: AsyncRegistryMatcher<Input, Definition>);
+    resolve(input: Input): Promise<Definition | null>;
+}
+export declare function createMapRegistry<Key extends string, Definition extends Identified<Key>>(items: readonly Definition[]): Registry<Key, Definition>;
+export declare function createKeyedRegistry<Key, Definition>(items: readonly Definition[], keyOf: (definition: Definition) => Key, formatDuplicateMessage?: (key: Key) => string): Registry<Key, Definition>;
+export declare function createOrderedResolver<Input, Key extends string, Definition extends Identified<Key>>(registry: Registry<Key, Definition>, matcher: RegistryMatcher<Input, Definition>): Resolver<Input, Definition | null>;
+export declare function createAsyncOrderedResolver<Input, Key extends string, Definition extends Identified<Key>>(registry: Registry<Key, Definition>, matcher: AsyncRegistryMatcher<Input, Definition>): AsyncResolver<Input, Definition | null>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,UAAU,CAAC,GAAG,SAAS,MAAM;IAC5C,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,CAAC,KAAK,EAAE,UAAU,IAAI,CAC/C,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,KACT,OAAO,CAAC;AAEb,MAAM,MAAM,oBAAoB,CAAC,KAAK,EAAE,UAAU,IAAI,CACpD,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,KACT,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,qBAAa,WAAW,CAAC,GAAG,SAAS,MAAM,EAAE,UAAU,SAAS,UAAU,CAAC,GAAG,CAAC,CAC7E,YAAW,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IAIxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;gBAE3B,KAAK,EAAE,SAAS,UAAU,EAAE;IAIzD,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,GAAG,IAAI;IAIhC,IAAI,IAAI,SAAS,UAAU,EAAE;CAG9B;AAED,qBAAa,eAAe,CAC1B,KAAK,EACL,GAAG,SAAS,MAAM,EAClB,UAAU,SAAS,UAAU,CAAC,GAAG,CAAC,CAClC,YAAW,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAG3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,EACnC,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC;IAG9D,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI;CASzC;AAED,qBAAa,oBAAoB,CAC/B,KAAK,EACL,GAAG,SAAS,MAAM,EAClB,UAAU,SAAS,UAAU,CAAC,GAAG,CAAC,CAClC,YAAW,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAGhD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,EACnC,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC;IAG7D,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CASxD;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,SAAS,MAAM,EAClB,UAAU,SAAS,UAAU,CAAC,GAAG,CAAC,EAClC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAEzD;AAOD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EACjD,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,GAAG,EACtC,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,GAC5C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAgB3B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EACL,GAAG,SAAS,MAAM,EAClB,UAAU,SAAS,UAAU,CAAC,GAAG,CAAC,EAElC,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,EACnC,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,GAC1C,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC,CAEpC;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EACL,GAAG,SAAS,MAAM,EAClB,UAAU,SAAS,UAAU,CAAC,GAAG,CAAC,EAElC,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,EACnC,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,GAC/C,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC,CAEzC"}

package/dist/registry.js

@@ -0,0 +1,85 @@
+export class MapRegistry {
+    items;
+    itemById;
+    constructor(items) {
+        this.items = items;
+        this.itemById = buildItemById(items);
+    }
+    get(key) {
+        return this.itemById.get(key) ?? null;
+    }
+    list() {
+        return this.items;
+    }
+}
+export class OrderedResolver {
+    registry;
+    matcher;
+    constructor(registry, matcher) {
+        this.registry = registry;
+        this.matcher = matcher;
+    }
+    resolve(input) {
+        for (const definition of this.registry.list()) {
+            if (this.matcher(definition, input)) {
+                return definition;
+            }
+        }
+        return null;
+    }
+}
+export class AsyncOrderedResolver {
+    registry;
+    matcher;
+    constructor(registry, matcher) {
+        this.registry = registry;
+        this.matcher = matcher;
+    }
+    async resolve(input) {
+        for (const definition of this.registry.list()) {
+            if (await this.matcher(definition, input)) {
+                return definition;
+            }
+        }
+        return null;
+    }
+}
+export function createMapRegistry(items) {
+    return new MapRegistry(items);
+}
+// For definition rows keyed by something other than `id`, such as strategy
+// and command rows keyed by their `kind`. Registry rows are composition-time
+// definitions, so a duplicate key is a wiring bug: it always throws (matching
+// MapRegistry) instead of silently keeping the last row. Callers pass a
+// formatter when the duplicate message is part of their domain contract.
+export function createKeyedRegistry(items, keyOf, formatDuplicateMessage) {
+    const itemByKey = new Map();
+    for (const item of items) {
+        const key = keyOf(item);
+        if (itemByKey.has(key)) {
+            throw new Error(formatDuplicateMessage?.(key) ??
+                `Duplicate registry item key: ${String(key)}`);
+        }
+        itemByKey.set(key, item);
+    }
+    return {
+        get: (key) => itemByKey.get(key) ?? null,
+        list: () => [...itemByKey.values()],
+    };
+}
+export function createOrderedResolver(registry, matcher) {
+    return new OrderedResolver(registry, matcher);
+}
+export function createAsyncOrderedResolver(registry, matcher) {
+    return new AsyncOrderedResolver(registry, matcher);
+}
+function buildItemById(items) {
+    const itemById = new Map();
+    for (const item of items) {
+        if (itemById.has(item.id)) {
+            throw new Error(`Duplicate registry item id: ${item.id}`);
+        }
+        itemById.set(item.id, item);
+    }
+    return itemById;
+}

package/dist/schema.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { type RuntimeCodec } from "./ports.js";
+import type { Brand, JsonValue } from "./types.js";
+export declare const stringIdSchema: z.ZodString;
+export declare function brandedStringSchema<TBrand extends string>(): z.ZodType<Brand<string, TBrand>>;
+export declare function readonlyArraySchema<TValue>(schema: z.ZodType<TValue>): z.ZodType<readonly TValue[]>;
+export declare function strictReadonlyObject<TShape extends z.ZodRawShape>(shape: TShape): z.ZodReadonly<z.ZodObject<TShape>>;
+export declare function boundaryReadonlyObject<TShape extends z.ZodRawShape>(shape: TShape): z.ZodReadonly<z.ZodObject<{ -readonly [P in keyof TShape]: TShape[P]; }, z.core.$loose>>;
+export declare function stringValueMapSchema<TValues extends Record<string, string>>(values: TValues): z.ZodEnum<{ [k_1 in TValues[keyof TValues]]: k_1; } extends infer T ? { [k in keyof T]: T[k]; } : never>;
+export declare const jsonPrimitiveSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+export declare const jsonValueSchema: z.ZodType<JsonValue>;
+export declare const metadataSchema: z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+export declare function createSchemaRuntimeCodec<Value>(schema: z.ZodType<Value>): RuntimeCodec<Value>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAiB,SAAS,EAAY,MAAM,YAAY,CAAC;AAE5E,eAAO,MAAM,cAAc,aAKvB,CAAC;AAEL,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,OAAO,CACrE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CACtB,CAEA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GACxB,CAAC,CAAC,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAE9B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAC/D,KAAK,EAAE,MAAM,GACZ,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAEpC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EACjE,KAAK,EAAE,MAAM,4FAGd;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzE,MAAM,EAAE,OAAO,4GAShB;AAED,eAAO,MAAM,mBAAmB,0EAKK,CAAC;AAEtC,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAMhD,CAAC;AAEF,eAAO,MAAM,cAAc,sHAEgB,CAAC;AAE5C,wBAAgB,wBAAwB,CAAC,KAAK,EAC5C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GACvB,YAAY,CAAC,KAAK,CAAC,CAiBrB"}

package/dist/schema.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { CODEC_DECODE_RESULT_KIND } from "./ports.js";
+export const stringIdSchema = z
+    .string()
+    .min(1)
+    .refine((value) => value.trim().length > 0, {
+    message: "Expected a non-blank string id.",
+});
+export function brandedStringSchema() {
+    return stringIdSchema.transform((value) => value);
+}
+export function readonlyArraySchema(schema) {
+    return z.array(schema).readonly();
+}
+export function strictReadonlyObject(shape) {
+    return z.object(shape).strict().readonly();
+}
+export function boundaryReadonlyObject(shape) {
+    return z.object(shape).passthrough().readonly();
+}
+export function stringValueMapSchema(values) {
+    const literalValues = Object.values(values);
+    if (literalValues.length === 0) {
+        throw new Error("Expected at least one string literal value.");
+    }
+    return z.enum(literalValues);
+}
+export const jsonPrimitiveSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+]);
+export const jsonValueSchema = z.lazy(() => z.union([
+    jsonPrimitiveSchema,
+    z.array(jsonValueSchema).readonly(),
+    z.record(z.string(), jsonValueSchema).readonly(),
+]));
+export const metadataSchema = z
+    .record(z.string(), jsonValueSchema)
+    .readonly();
+export function createSchemaRuntimeCodec(schema) {
+    return {
+        decode: (input) => {
+            const result = schema.safeParse(input);
+            if (result.success) {
+                return { kind: CODEC_DECODE_RESULT_KIND.decoded, value: result.data };
+            }
+            const [firstIssue, ...remainingIssues] = result.error.issues.map((issue) => `${issue.path.join(".") || "$"}: ${issue.message}`);
+            return {
+                kind: CODEC_DECODE_RESULT_KIND.invalid,
+                issues: [firstIssue ?? result.error.message, ...remainingIssues],
+            };
+        },
+        encode: (value) => value,
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,23 @@
+export type Brand<TValue, TBrand extends string> = TValue & {
+    readonly __brand: TBrand;
+};
+export type Nullable<TValue> = TValue | null;
+export type ValueOf<TValueMap> = TValueMap[keyof TValueMap];
+export type ReadonlyRecord<TValue> = {
+    readonly [key: string]: TValue;
+};
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type JsonArray = readonly JsonValue[];
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export type Metadata = JsonObject;
+export interface DefinitionBase<Id, Kind extends string, TMetadata> {
+    readonly id: Id;
+    readonly kind: Kind;
+    readonly metadata: TMetadata;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,MAAM,GAAG;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,MAAM,IAAI,MAAM,GAAG,IAAI,CAAC;AAE7C,MAAM,MAAM,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,SAAS,CAAC,CAAC;AAE5D,MAAM,MAAM,cAAc,CAAC,MAAM,IAAI;IACnC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,SAAS,SAAS,EAAE,GACpB;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AACN,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC,MAAM,WAAW,cAAc,CAAC,EAAE,EAAE,IAAI,SAAS,MAAM,EAAE,SAAS;IAChE,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@alpacakit/core",
+  "version": "0.1.0-beta.19",
+  "description": "Architecture-neutral kernel primitives: branded ids, ports, registries, pipelines, payload codecs, and immutable mutation helpers.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README*.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "immer": "^11.1.8",
+    "yaml": "^2.8.4",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}