@astrale-os/sdk 0.4.19 → 0.5.0-beta.10

package/dist/query/node.js

@@ -0,0 +1,166 @@
+import { Property, Query, } from '@astrale-os/kernel-core/graph/query';
+const selections = new WeakMap();
+export const queryContext = Object.freeze({
+    node(definition, path) {
+        const source = Query.from({ kind: 'node', paths: [path] });
+        return selection(definition, source.filter({ satisfies: definition.schemaRef }), false);
+    },
+    nodes(definition) {
+        return selection(definition, Query.from({ kind: 'node', definitions: [definition.schemaRef] }), true);
+    },
+});
+export function compileNodeQuery(input) {
+    if (!isRuntimeSelection(input))
+        return input;
+    const ast = input.compile();
+    selections.set(ast, input);
+    return ast;
+}
+export function queryContextIsMany(input) {
+    return isRuntimeSelection(input) ? input.many : undefined;
+}
+export function projectNodeQuery(ast, result, bind) {
+    const selected = selections.get(ast);
+    if (selected === undefined)
+        return Object.freeze({ matched: false });
+    if (bind === undefined) {
+        throw new TypeError('Node Query projection requires a Domain value binder.');
+    }
+    if (!isValueNodeResult(result))
+        throw new TypeError('Node Query returned a non-node value projection.');
+    return Object.freeze({ matched: true, value: selected.project(result, bind) });
+}
+function selection(definition, builder, many, current = definitionClosure(definition), bindDefinition = definition) {
+    const runtime = {
+        current,
+        ...(bindDefinition === undefined ? {} : { bindDefinition }),
+        builder,
+        many,
+        compile() {
+            if (!('node' in builder))
+                throw new TypeError('Node Query selection lost its node binding.');
+            return builder.select({ kind: 'nodes', projection: { kind: 'value' } });
+        },
+        project(result, bind) {
+            const values = result.nodes.map((item) => bindDefinition === undefined ? bind(item.value) : bind(bindDefinition, item.value));
+            return many ? Object.freeze(values) : (values[0] ?? null);
+        },
+    };
+    const value = {
+        ...runtime,
+        __many: many,
+        where(input) {
+            if (input === null ||
+                typeof input !== 'object' ||
+                input.property === null ||
+                typeof input.property !== 'object' ||
+                !('key' in input.property)) {
+                throw new TypeError('Node Query where requires one rich Property.');
+            }
+            const hasEquals = Object.hasOwn(input, 'equals');
+            const hasPresent = input.present === true;
+            if (hasEquals === hasPresent) {
+                throw new TypeError('Node Query where requires exactly one of equals or present.');
+            }
+            const predicate = hasEquals
+                ? Property(input.property.key).equals(input.equals)
+                : Property(input.property.key).isPresent();
+            return selection(definition, builder.filter({ predicate }), many, current, bindDefinition);
+        },
+        when(candidate, refine) {
+            const current = value;
+            return candidate === undefined || candidate === null || candidate === false
+                ? current
+                : refine(current, candidate);
+        },
+        linked(relation, options) {
+            if (options === null || typeof options !== 'object' || options.to === undefined) {
+                throw new TypeError('Node Query linked requires an accepted rich to definition.');
+            }
+            const from = options?.from ?? inferSide(current, relation);
+            if (!overlaps(endpointOf(relation, from).accepts, current)) {
+                throw new TypeError(`Relation ${relation.key} does not accept the current selection at its ${from} endpoint.`);
+            }
+            const expanded = builder
+                .expand({
+                via: [relation.schemaRef],
+                direction: from === 'source' ? 'outgoing' : 'incoming',
+            })
+                .filter({ satisfies: options.to.schemaRef });
+            const opposite = endpointOf(relation, from === 'source' ? 'target' : 'source');
+            if (!overlaps(opposite.accepts, definitionClosure(options.to))) {
+                throw new TypeError(`Relation ${relation.key} does not accept ${options.to.key} at its opposite endpoint.`);
+            }
+            const next = Object.freeze({
+                ...selection(options.to, expanded, many || !isSingular(relation, from), definitionClosure(options.to), options.to),
+            });
+            return next;
+        },
+    };
+    return Object.freeze(value);
+}
+function inferSide(current, relation) {
+    const source = overlaps(endpointOf(relation, 'source').accepts, current);
+    const target = overlaps(endpointOf(relation, 'target').accepts, current);
+    if (source === target) {
+        throw new TypeError(source
+            ? `Relation ${relation.key} accepts the current selection at both endpoints; declare from.`
+            : `Relation ${relation.key} does not accept the current selection.`);
+    }
+    return source ? 'source' : 'target';
+}
+function overlaps(left, right) {
+    return left.some((candidate) => right.some((current) => sameRef(candidate, current)));
+}
+function definitionClosure(definition) {
+    const refs = [];
+    const seen = new Set();
+    const visit = (candidate) => {
+        const ref = candidate.schemaRef;
+        const identity = `${ref.origin}\0${ref.kind}\0${ref.name}`;
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        refs.push(ref);
+        const parents = candidate.kind === 'class' ? candidate.implements : candidate.extends;
+        for (const parent of parents ?? [])
+            visit(parent);
+    };
+    visit(definition);
+    return Object.freeze(refs);
+}
+function sameRef(left, right) {
+    return left.origin === right.origin && left.kind === right.kind && left.name === right.name;
+}
+function isSingular(relation, side) {
+    const count = endpointCount(endpointOf(relation, side));
+    return count === '1' || count === '0..1';
+}
+function endpointOf(relation, side) {
+    const declaration = relation.definition;
+    if (declaration.endpoints === undefined) {
+        throw new TypeError(`Relation ${relation.key} has no Edge endpoints.`);
+    }
+    const contract = relation.definition;
+    if (contract.orientation === 'directed')
+        return contract.endpoints[side];
+    return contract.endpoints[side === 'source' ? 0 : 1];
+}
+function endpointCount(endpoint) {
+    if ('outgoing' in endpoint)
+        return endpoint.outgoing;
+    if ('incoming' in endpoint)
+        return endpoint.incoming;
+    return endpoint.incident;
+}
+function isRuntimeSelection(input) {
+    return (input !== null &&
+        typeof input === 'object' &&
+        typeof input.compile === 'function');
+}
+function isValueNodeResult(input) {
+    return (input !== null &&
+        typeof input === 'object' &&
+        input.kind === 'nodes');
+}
+//# sourceMappingURL=node.js.map

package/dist/query/node.js.map

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

package/dist/query/result/contract.d.ts

@@ -0,0 +1,23 @@
+import type { Node, NodeId } from '@astrale-os/kernel-core/graph/node';
+import type { QueryEdgeItemFor, QueryEdgeProjection, QueryResult } from '@astrale-os/kernel-core/graph/query';
+type EdgeValueItem = QueryEdgeItemFor<{
+    readonly edge: 'value';
+    readonly source: 'value';
+    readonly target: 'value';
+}>;
+/** Pure strict projections from canonical Kernel Query results. */
+export interface QueryResultProjection {
+    nodeValues(result: QueryResult, context: string): readonly Node[];
+    completeNodeValues(results: readonly QueryResult[], context: string): readonly Node[];
+    nodeIds(result: QueryResult, context: string): readonly NodeId[];
+    completeNodeIds(results: readonly QueryResult[], context: string): readonly NodeId[];
+    exactlyOneNode(result: QueryResult, context: string): Node;
+    optionalNode(result: QueryResult, context: string): Node | undefined;
+    edgeItems(result: QueryResult, context: string): readonly QueryEdgeItemFor<QueryEdgeProjection>[];
+    optionalEdgeTarget(result: QueryResult, context: string): Node | undefined;
+    exactlyOneEdgeTarget(result: QueryResult, context: string): Node;
+    exactlyOneEdgeSource(result: QueryResult, context: string): Node;
+}
+export type QueryEdgeValueItem = EdgeValueItem;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/query/result/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/query/result/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACZ,MAAM,qCAAqC,CAAA;AAE5C,KAAK,aAAa,GAAG,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB,CAAC,CAAA;AAEF,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAAA;IACjE,kBAAkB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAAA;IACrF,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAChE,eAAe,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IACpF,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACpE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,gBAAgB,CAAC,mBAAmB,CAAC,EAAE,CAAA;IACjG,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1E,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAChE,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACjE;AAED,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAA"}

package/dist/query/result/contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.js.map

package/dist/query/result/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/query/result/contract.ts"],"names":[],"mappings":""}

package/dist/query/result/index.d.ts

@@ -0,0 +1,3 @@
+export { queryResult } from './projection.js';
+export type { QueryResultProjection } from './contract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/query/result/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/query/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}

package/dist/query/result/index.js

@@ -0,0 +1,2 @@
+export { queryResult } from './projection.js';
+//# sourceMappingURL=index.js.map

package/dist/query/result/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/query/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/query/result/projection.d.ts

@@ -0,0 +1,3 @@
+import type { QueryResultProjection } from './contract.js';
+export declare const queryResult: QueryResultProjection;
+//# sourceMappingURL=projection.d.ts.map

package/dist/query/result/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/query/result/projection.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAgG1D,eAAO,MAAM,WAAW,EAAE,qBAWxB,CAAA"}

package/dist/query/result/projection.js

@@ -0,0 +1,100 @@
+function nodeValues(result, context) {
+    if (result.kind === 'graph')
+        return graphNodes(result, context);
+    if (result.kind !== 'nodes')
+        throw new TypeError(`Expected a Node ${context} query result.`);
+    return Object.freeze(result.nodes.map((projection) => {
+        if (projection.kind !== 'value') {
+            throw new TypeError(`Expected ${context} query to project Node values.`);
+        }
+        return projection.value;
+    }));
+}
+function graphNodes(result, context) {
+    if (result.selection.kind !== 'node') {
+        throw new TypeError(`Expected a Node ${context} query result.`);
+    }
+    const byId = new Map(result.graph.nodes.map((node) => [node.id, node]));
+    return Object.freeze(result.selection.ids.map((id) => {
+        const node = byId.get(id);
+        if (node === undefined)
+            throw new TypeError(`${context} graph omits selected Node ${id}.`);
+        return node;
+    }));
+}
+function completeNodeValues(results, context) {
+    return Object.freeze(results.flatMap((result) => nodeValues(result, context)));
+}
+function nodeIds(result, context) {
+    if (result.kind === 'graph') {
+        if (result.selection.kind !== 'node') {
+            throw new TypeError(`Expected a Node ${context} query result.`);
+        }
+        return result.selection.ids;
+    }
+    if (result.kind !== 'nodes')
+        throw new TypeError(`Expected a Node ${context} query result.`);
+    return Object.freeze(result.nodes.map((projection) => projection.value.id));
+}
+function completeNodeIds(results, context) {
+    return Object.freeze(results.flatMap((result) => nodeIds(result, context)));
+}
+function exactlyOneNode(result, context) {
+    const values = nodeValues(result, context);
+    if (values.length !== 1)
+        throw new TypeError(`${context} must resolve exactly one Node.`);
+    return values[0];
+}
+function optionalNode(result, context) {
+    const values = nodeValues(result, context);
+    if (values.length > 1)
+        throw new TypeError(`${context} must resolve at most one Node.`);
+    return values[0];
+}
+function edgeItems(result, context) {
+    if (result.kind !== 'edges')
+        throw new TypeError(`Expected an Edge ${context} query result.`);
+    return result.edges;
+}
+function optionalEdgeTarget(result, context) {
+    const items = edgeItems(result, context);
+    if (items.length > 1)
+        throw new TypeError(`${context} must resolve at most one Edge.`);
+    const target = items[0]?.target;
+    if (target === undefined)
+        return undefined;
+    if (target.kind !== 'value')
+        throw new TypeError(`${context} must project its target value.`);
+    return target.value;
+}
+function exactlyOneEdgeTarget(result, context) {
+    const items = edgeItems(result, context);
+    if (items.length !== 1)
+        throw new TypeError(`${context} must resolve exactly one Edge.`);
+    const target = items[0].target;
+    if (target.kind !== 'value')
+        throw new TypeError(`${context} must project its target value.`);
+    return target.value;
+}
+function exactlyOneEdgeSource(result, context) {
+    const items = edgeItems(result, context);
+    if (items.length !== 1)
+        throw new TypeError(`${context} must resolve exactly one Edge.`);
+    const source = items[0].source;
+    if (source.kind !== 'value')
+        throw new TypeError(`${context} must project its source value.`);
+    return source.value;
+}
+export const queryResult = Object.freeze({
+    nodeValues,
+    completeNodeValues,
+    nodeIds,
+    completeNodeIds,
+    exactlyOneNode,
+    optionalNode,
+    edgeItems,
+    optionalEdgeTarget,
+    exactlyOneEdgeTarget,
+    exactlyOneEdgeSource,
+});
+//# sourceMappingURL=projection.js.map

package/dist/query/result/projection.js.map

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

package/dist/query/selection.d.ts

@@ -0,0 +1,4 @@
+import type { QueryResult, QuerySelectionFor } from '@astrale-os/kernel-core/graph/query';
+/** Merge one exhausted SDK page chain into the exact Core selected identity sequence. */
+export declare function completeQuerySelection<Result extends QueryResult>(pages: readonly [Result, ...Result[]]): QuerySelectionFor<Result>;
+//# sourceMappingURL=selection.d.ts.map

package/dist/query/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/query/selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EAClB,MAAM,qCAAqC,CAAA;AAI5C,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,WAAW,EAC/D,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACpC,iBAAiB,CAAC,MAAM,CAAC,CAgB3B"}

package/dist/query/selection.js

@@ -0,0 +1,25 @@
+import { QueryResult as QueryResultValue } from '@astrale-os/kernel-core/graph/query';
+/** Merge one exhausted SDK page chain into the exact Core selected identity sequence. */
+export function completeQuerySelection(pages) {
+    const first = QueryResultValue.selection(pages[0]);
+    if (first.kind === 'node') {
+        const ids = pages.flatMap((page) => {
+            const selection = QueryResultValue.selection(page);
+            if (selection.kind !== 'node')
+                changed(first, selection);
+            return selection.ids;
+        });
+        return Object.freeze({ kind: 'node', ids: Object.freeze(ids) });
+    }
+    const keys = pages.flatMap((page) => {
+        const selection = QueryResultValue.selection(page);
+        if (selection.kind !== 'edge')
+            changed(first, selection);
+        return selection.keys;
+    });
+    return Object.freeze({ kind: 'edge', keys: Object.freeze(keys) });
+}
+function changed(first, next) {
+    throw new TypeError(`Paginated Query selection changed from ${first.kind} to ${next.kind}.`);
+}
+//# sourceMappingURL=selection.js.map

package/dist/query/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/query/selection.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAErF,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CACpC,KAAqC;IAErC,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAClD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAClD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YACxD,OAAO,SAAS,CAAC,GAAG,CAAA;QACtB,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAA8B,CAAA;IAC9F,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAClD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QACxD,OAAO,SAAS,CAAC,IAAI,CAAA;IACvB,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAA8B,CAAA;AAChG,CAAC;AAED,SAAS,OAAO,CAAC,KAAqB,EAAE,IAAoB;IAC1D,MAAM,IAAI,SAAS,CAAC,0CAA0C,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;AAC9F,CAAC"}

package/dist/result/index.d.ts

@@ -0,0 +1,3 @@
+export { err, ok } from './result.js';
+export type { Result } from './result.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AACrC,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/result/index.js

@@ -0,0 +1,2 @@
+export { err, ok } from './result.js';
+//# sourceMappingURL=index.js.map

package/dist/result/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA"}

package/dist/result/result.d.ts

@@ -0,0 +1,10 @@
+export type Result<Value, Failure> = {
+    readonly ok: true;
+    readonly value: Value;
+} | {
+    readonly ok: false;
+    readonly error: Failure;
+};
+export declare function ok<const Value>(value: Value): Result<Value, never>;
+export declare function err<const Failure>(error: Failure): Result<never, Failure>;
+//# sourceMappingURL=result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/result/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,KAAK,EAAE,OAAO,IAC7B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnD,wBAAgB,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAElE;AAED,wBAAgB,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAEzE"}

package/dist/result/result.js

@@ -0,0 +1,7 @@
+export function ok(value) {
+    return Object.freeze({ ok: true, value });
+}
+export function err(error) {
+    return Object.freeze({ ok: false, error });
+}
+//# sourceMappingURL=result.js.map

package/dist/result/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/result/result.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,EAAE,CAAc,KAAY;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,GAAG,CAAgB,KAAc;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;AAC5C,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,3 @@
+/** Recommended Domain schema authoring surface. */
+export * from './v1/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,cAAc,eAAe,CAAA"}

package/dist/schema/index.js

@@ -0,0 +1,3 @@
+/** Recommended Domain schema authoring surface. */
+export * from './v1/index.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,cAAc,eAAe,CAAA"}

package/dist/schema/kernel/index.d.ts

@@ -0,0 +1,3 @@
+/** Canonical Kernel-owned schema values referenced by Domain schemas. */
+export * from '@astrale-os/kernel-core/schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/kernel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/kernel/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,cAAc,gCAAgC,CAAA"}

package/dist/schema/kernel/index.js

@@ -0,0 +1,3 @@
+/** Canonical Kernel-owned schema values referenced by Domain schemas. */
+export * from '@astrale-os/kernel-core/schema';
+//# sourceMappingURL=index.js.map

package/dist/schema/kernel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/kernel/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,cAAc,gCAAgC,CAAA"}

package/dist/schema/v1/index.d.ts

@@ -0,0 +1,3 @@
+/** Exact version-pinned alias of the canonical Kernel DSL V1 authoring surface. */
+export * from '@astrale-os/kernel-dsl/v1';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/v1/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,cAAc,2BAA2B,CAAA"}

package/dist/schema/v1/index.js

@@ -0,0 +1,3 @@
+/** Exact version-pinned alias of the canonical Kernel DSL V1 authoring surface. */
+export * from '@astrale-os/kernel-dsl/v1';
+//# sourceMappingURL=index.js.map

package/dist/schema/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/v1/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,cAAc,2BAA2B,CAAA"}

package/dist/server/application.d.ts

@@ -0,0 +1,36 @@
+import type { IssuerId, JsonWebKey } from '@astrale-os/kernel-core/auth';
+import type { schema } from '@astrale-os/kernel-dsl/v1';
+import type { publication } from '@astrale-os/kernel-protocol';
+import type { exchange, publication as serverPublication, ServerCloseOptions, ServerOptions } from '@astrale-os/kernel-server';
+import type { Hono as HonoType } from 'hono';
+import type { Deployment } from '../deployment/index.js';
+import type { InvocationAuthority } from '../invocation/index.js';
+import type { WorkflowRunner } from '../workflow/index.js';
+/** One application identity owns public issuer discovery and remote invocation admission. */
+export interface ApplicationIdentity<S extends schema.DomainSchema> extends InvocationAuthority<S> {
+    readonly issuer: IssuerId;
+    readonly signingAlgorithm?: string;
+    loadPublicKeys(signal: AbortSignal): Promise<readonly JsonWebKey[]>;
+    readonly loadIssuerPublicKeys?: (issuer: IssuerId, signal: AbortSignal) => Promise<readonly JsonWebKey[]>;
+    readonly tokenExchange?: exchange.Provider;
+}
+export interface CreateApplicationInput<S extends schema.DomainSchema, Environment, Deps, OuterApp extends HonoType = HonoType> {
+    readonly deployment: Deployment<S, Environment, Deps>;
+    readonly environment: Environment;
+    readonly identity: ApplicationIdentity<S>;
+    readonly server: Omit<ServerOptions, 'invocation' | 'publication' | 'delivery' | 'issuer' | 'tokenExchange'>;
+    readonly delivery?: serverPublication.delivery.Provider;
+    readonly workflowRunner?: WorkflowRunner;
+    readonly app?: OuterApp;
+}
+/** Serving lifecycle for one fixed SDK Definition and its current deployment placement. */
+export interface Application<OuterApp extends HonoType = HonoType> {
+    readonly app: OuterApp;
+    readonly publication: publication.Publication;
+    replace<CandidateSchema extends schema.DomainSchema, CandidateEnvironment, CandidateDeps>(deployment: Deployment<CandidateSchema, CandidateEnvironment, CandidateDeps>): publication.Publication;
+    drain(): void;
+    close(options: ServerCloseOptions): Promise<void>;
+}
+/** Compose one portable Kernel Server below an exact customizable Hono application. */
+export declare function createApplication<const S extends schema.DomainSchema, Environment, Deps, OuterApp extends HonoType = HonoType>(input: CreateApplicationInput<S, Environment, Deps, OuterApp>): Application<OuterApp>;
+//# sourceMappingURL=application.d.ts.map

package/dist/server/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/server/application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAEV,QAAQ,EACR,WAAW,IAAI,iBAAiB,EAChC,kBAAkB,EAClB,aAAa,EACd,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAW,IAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAA;AAKrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAK1D,6FAA6F;AAC7F,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,YAAY,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAChG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAA;IACnE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAC9B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAA;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;CAC3C;AAED,MAAM,WAAW,sBAAsB,CACrC,CAAC,SAAS,MAAM,CAAC,YAAY,EAC7B,WAAW,EACX,IAAI,EACJ,QAAQ,SAAS,QAAQ,GAAG,QAAQ;IAEpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAA;IACrD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,IAAI,CACnB,aAAa,EACb,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,CACvE,CAAA;IACD,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAA;IACvD,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAA;CACxB;AAED,2FAA2F;AAC3F,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,QAAQ,GAAG,QAAQ;IAC/D,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,CAAA;IAC7C,OAAO,CAAC,eAAe,SAAS,MAAM,CAAC,YAAY,EAAE,oBAAoB,EAAE,aAAa,EACtF,UAAU,EAAE,UAAU,CAAC,eAAe,EAAE,oBAAoB,EAAE,aAAa,CAAC,GAC3E,WAAW,CAAC,WAAW,CAAA;IAC1B,KAAK,IAAI,IAAI,CAAA;IACb,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,YAAY,EACnC,WAAW,EACX,IAAI,EACJ,QAAQ,SAAS,QAAQ,GAAG,QAAQ,EACpC,KAAK,EAAE,sBAAsB,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CA8DtF"}