@astrale-os/kernel-client 0.5.1 → 0.6.0-beta.1

package/dist/session/session.js

@@ -0,0 +1,183 @@
+import { issuer as authIssuer } from '@astrale-os/kernel-core/auth';
+import { Client } from '../client/index.js';
+import { ClientError } from '../errors/index.js';
+import { ClientPool } from '../pool/index.js';
+import { AutoTransport } from '../transport/auto/index.js';
+import { HttpTransport } from '../transport/http/index.js';
+import { WebSocketTransport } from '../transport/websocket/index.js';
+import { admitControlOptions, admitPolicy, createSessionOperation, DEFAULT_MAXIMUM_BUNDLE_BYTES, DEFAULT_MAXIMUM_PUBLICATION_BYTES, DEFAULT_MAXIMUM_RESPONSE_BYTES, DEFAULT_TIMEOUT_MS, endpoint, platformDuration, positive, } from './context/index.js';
+import { createSessionDiscovery } from './discovery/index.js';
+import { admitEnvelopeTransport, admitRequestOptions, admitSessionAuth, requireResultKind, RouteCache, SessionDispatcher, } from './routing/index.js';
+import { resolveViewsFor, targetViewCatalog } from './views/index.js';
+/** Caller-owned discovery and redirect-following conversation over one source invocation endpoint. */
+export class ClientSession {
+    url;
+    ownedPool;
+    discovery;
+    dispatcher;
+    lifecycle = new AbortController();
+    timeoutMs;
+    routes;
+    admitTargetViews;
+    closed = false;
+    constructor(options) {
+        if (options === null || typeof options !== 'object') {
+            throw new TypeError('ClientSession options are invalid.');
+        }
+        const policy = admitPolicy(options.policy);
+        this.admitTargetViews = (input) => targetViewCatalog(input, policy);
+        this.url = endpoint(options.url, policy.allowInsecureHttp === true);
+        const sourceIssuer = options.sourceIssuer === undefined ? undefined : authIssuer.accept(options.sourceIssuer);
+        const fetch = options.fetch ?? globalThis.fetch;
+        if (typeof fetch !== 'function')
+            throw new TypeError('ClientSession requires Fetch.');
+        const fetchImpl = options.fetch === undefined ? fetch.bind(globalThis) : fetch;
+        if (options.client !== undefined && options.pool !== undefined) {
+            throw new TypeError('ClientSession accepts either client or pool, not both.');
+        }
+        const maximumPublicationBytes = positive(options.maximumPublicationBytes ?? DEFAULT_MAXIMUM_PUBLICATION_BYTES, 'maximumPublicationBytes');
+        const maximumBundleBytes = positive(options.maximumBundleBytes ?? DEFAULT_MAXIMUM_BUNDLE_BYTES, 'maximumBundleBytes');
+        const maximumResponseBytes = positive(options.maximumResponseBytes ?? DEFAULT_MAXIMUM_RESPONSE_BYTES, 'maximumResponseBytes');
+        const timeoutMs = platformDuration(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 'timeoutMs');
+        this.timeoutMs = timeoutMs;
+        const websocketAvailable = options.client !== undefined ||
+            options.pool !== undefined ||
+            options.websocket !== undefined ||
+            typeof globalThis.WebSocket === 'function';
+        const client = options.client ??
+            defaultClientFactory({
+                fetch: fetchImpl,
+                ...(options.websocket === undefined ? {} : { websocket: options.websocket }),
+                ...(options.onWarning === undefined ? {} : { onWarning: options.onWarning }),
+                maximumResponseBytes,
+                timeoutMs,
+            });
+        let pool;
+        if (options.pool === undefined) {
+            const ownedPool = new ClientPool({ client });
+            this.ownedPool = ownedPool;
+            pool = admitClientPool(ownedPool);
+        }
+        else {
+            pool = admitClientPool(options.pool);
+        }
+        this.discovery = createSessionDiscovery({
+            url: this.url,
+            fetch: fetchImpl,
+            policy,
+            maximumPublicationBytes,
+            maximumBundleBytes,
+            requireOpen: () => this.requireOpen(),
+            acquisitionOperation: () => this.operation(undefined),
+        });
+        this.routes = new RouteCache(policy.maximumRouteAgeMs);
+        this.dispatcher = new SessionDispatcher({
+            url: this.url,
+            sourceIssuer,
+            pool,
+            websocketAvailable,
+            auth: admitSessionAuth(options.auth),
+            cache: this.routes,
+            policy,
+            envelopeTransport: admitEnvelopeTransport(options.envelopeTransport ?? 'http'),
+            discovery: this.discovery,
+            requireOpen: () => this.requireOpen(),
+        });
+    }
+    snapshot(options) {
+        return this.discovery.snapshot(this.operation(admitControlOptions(options)));
+    }
+    viewsFor(target, options) {
+        this.requireOpen();
+        return resolveViewsFor(async (call, operation) => requireResultKind('value', await this.dispatcher.dispatch(call, {}, operation)).value, this.admitTargetViews, target, this.operation(admitControlOptions(options)));
+    }
+    dispatch(call, options) {
+        const admitted = admitRequestOptions(options);
+        return this.dispatcher.dispatch(call, admitted, this.operation(admitted));
+    }
+    async call(call, options) {
+        const result = await this.dispatch(call, options);
+        return requireResultKind('value', result).value;
+    }
+    async stream(call, options) {
+        const result = await this.dispatch(call, options);
+        return requireResultKind('stream', result).stream;
+    }
+    async binary(call, options) {
+        const result = await this.dispatch(call, options);
+        return requireResultKind('binary', result).value;
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.lifecycle.abort(new ClientError('ClientSession is closed.'));
+        this.ownedPool?.close();
+        this.routes.clear();
+        this.discovery.clear();
+    }
+    requireOpen() {
+        if (this.closed)
+            throw new ClientError('ClientSession is closed.');
+    }
+    operation(options) {
+        this.requireOpen();
+        return createSessionOperation(this.lifecycle.signal, options, this.timeoutMs);
+    }
+}
+function admitClientPool(input) {
+    if (input === null ||
+        typeof input !== 'object' ||
+        typeof input.clientFor !== 'function') {
+        throw new TypeError('Session client pool capability is invalid.');
+    }
+    return Object.freeze({
+        clientFor: (target) => admitPooledClient(input.clientFor.call(input, target)),
+    });
+}
+function admitPooledClient(input) {
+    if (input === null ||
+        typeof input !== 'object' ||
+        typeof input.dispatch !== 'function' ||
+        typeof input.as !== 'function' ||
+        typeof input.close !== 'function') {
+        throw new TypeError('Session client pool capability returned an invalid Client.');
+    }
+    return input;
+}
+function defaultClientFactory(options) {
+    return (target) => {
+        switch (target.transport) {
+            case 'http':
+                return new Client({
+                    transport: new HttpTransport({
+                        url: target.url,
+                        fetch: options.fetch,
+                        timeoutMs: options.timeoutMs,
+                        maximumResponseBytes: options.maximumResponseBytes,
+                    }),
+                });
+            case 'websocket':
+                return new Client({
+                    transport: new WebSocketTransport({
+                        url: target.url,
+                        timeoutMs: options.timeoutMs,
+                        maximumResponseBytes: options.maximumResponseBytes,
+                        ...(options.websocket === undefined ? {} : { websocket: options.websocket }),
+                    }),
+                });
+            case 'auto':
+                return new Client({
+                    transport: new AutoTransport({
+                        endpoints: target.endpoints,
+                        fetch: options.fetch,
+                        timeoutMs: options.timeoutMs,
+                        maximumResponseBytes: options.maximumResponseBytes,
+                        ...(options.websocket === undefined ? {} : { websocket: options.websocket }),
+                        ...(options.onWarning === undefined ? {} : { onWarning: options.onWarning }),
+                    }),
+                });
+        }
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

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

package/dist/session/session.typecheck.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.typecheck.d.ts.map

package/dist/session/session.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.typecheck.d.ts","sourceRoot":"","sources":["../../session/session.typecheck.ts"],"names":[],"mappings":""}

package/dist/session/session.typecheck.js

@@ -0,0 +1,10 @@
+import { ClientSession } from './index.js';
+void new ClientSession(options);
+void auth;
+void control;
+void envelope;
+void policy;
+void request;
+void snapshot;
+void {};
+//# sourceMappingURL=session.typecheck.js.map

package/dist/session/session.typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.typecheck.js","sourceRoot":"","sources":["../../session/session.typecheck.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAU1C,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAAA;AAC/B,KAAK,IAAI,CAAA;AACT,KAAK,OAAO,CAAA;AACZ,KAAK,QAAQ,CAAA;AACb,KAAK,MAAM,CAAA;AACX,KAAK,OAAO,CAAA;AACZ,KAAK,QAAQ,CAAA;AAIb,KAAM,EAAwB,CAAA"}

package/dist/session/views/catalog.d.ts

@@ -0,0 +1,16 @@
+import type { Key, bundle } from '@astrale-os/kernel-dsl/v1';
+import type { publication } from '@astrale-os/kernel-protocol';
+import { syscalls } from '@astrale-os/kernel-core/schema';
+import type { SessionPolicy } from '../context/index.js';
+/** One verified View declaration joined with its owning Publication and provenance. */
+export type ResolvedView = syscalls.view.ResolvedView;
+/** Immutable canonical-key-ordered inventory of Views resolved under one Session revision. */
+export interface ViewCatalog {
+    readonly entrypoint?: ResolvedView;
+    readonly views: readonly ResolvedView[];
+}
+export declare function rootViewCatalog(publication: publication.Publication, artifact: bundle.Bundle, policy: Readonly<SessionPolicy>): ViewCatalog;
+export declare function catalogFromKeys(root: ViewCatalog, keys: readonly Key.View[]): ViewCatalog;
+/** Re-admit one Runtime-resolved heterogeneous View catalog at the Client trust boundary. */
+export declare function targetViewCatalog(input: unknown, policy: Readonly<SessionPolicy>): ViewCatalog;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/session/views/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../session/views/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAKxD,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAA;AAErD,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;CACxC;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,CAAC,WAAW,EACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EACvB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,WAAW,CAgCb;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,IAAI,EAAE,GAAG,WAAW,CASzF;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,WAAW,CAS9F"}

package/dist/session/views/catalog.js

@@ -0,0 +1,63 @@
+import { syscalls } from '@astrale-os/kernel-core/schema';
+import { Key as ViewKey, Ref } from '@astrale-os/kernel-dsl/v1';
+import { ClientError } from '../../errors/index.js';
+import { allowEndpoint } from '../context/index.js';
+export function rootViewCatalog(publication, artifact, policy) {
+    const views = publication.bindings.views
+        .map((binding) => {
+        allowEndpoint(binding.href, policy);
+        const declaration = artifact.root.views[Ref.member(ViewKey.ref(binding.view))];
+        if (declaration === undefined) {
+            throw new ClientError('Published View has no verified root declaration.');
+        }
+        return Object.freeze({
+            key: binding.view,
+            declaration,
+            href: binding.href,
+            handshake: binding.handshake,
+            issuer: publication.identity.issuer,
+            etag: publication.etag,
+            revision: publication.schema.revision,
+        });
+    })
+        .sort((left, right) => compareKeys(left.key, right.key));
+    const catalogViews = Object.freeze(views);
+    const entrypointRef = publication.manifest?.entrypoint;
+    const entrypoint = entrypointRef === undefined
+        ? undefined
+        : catalogViews.find(({ key }) => key === ViewKey.of(publication.origin, entrypointRef));
+    if (entrypointRef !== undefined && entrypoint === undefined) {
+        throw new ClientError('Published View entrypoint has no verified Publication binding.');
+    }
+    return Object.freeze({
+        ...(entrypoint === undefined ? {} : { entrypoint }),
+        views: catalogViews,
+    });
+}
+export function catalogFromKeys(root, keys) {
+    const selected = new Set(keys);
+    const views = Object.freeze(root.views.filter(({ key }) => selected.has(key)));
+    return Object.freeze({
+        ...(root.entrypoint !== undefined && selected.has(root.entrypoint.key)
+            ? { entrypoint: root.entrypoint }
+            : {}),
+        views,
+    });
+}
+/** Re-admit one Runtime-resolved heterogeneous View catalog at the Client trust boundary. */
+export function targetViewCatalog(input, policy) {
+    let resolution;
+    try {
+        resolution = syscalls.view.acceptResolution(input);
+    }
+    catch (cause) {
+        throw new ClientError('Resolved View catalog is invalid.', { cause });
+    }
+    for (const view of resolution.views)
+        allowEndpoint(view.href, policy);
+    return Object.freeze({ views: resolution.views });
+}
+function compareKeys(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/session/views/catalog.js.map

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

package/dist/session/views/index.d.ts

@@ -0,0 +1,3 @@
+export { catalogFromKeys, rootViewCatalog, targetViewCatalog, type ResolvedView, type ViewCatalog, } from './catalog.js';
+export { resolveViewsFor, type ViewCatalogAdmission, type ViewInvoker } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/views/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../session/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/session/views/index.js

@@ -0,0 +1,3 @@
+export { catalogFromKeys, rootViewCatalog, targetViewCatalog, } from './catalog.js';
+export { resolveViewsFor } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/session/views/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../session/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,GAGlB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,eAAe,EAA+C,MAAM,cAAc,CAAA"}

package/dist/session/views/resolve.d.ts

@@ -0,0 +1,13 @@
+import type { PathLike } from '@astrale-os/kernel-core/path';
+import type { Input } from '@astrale-os/kernel-ports/functions';
+import type { Call } from '../../client/index.js';
+import type { SessionOperation } from '../context/index.js';
+import type { ViewCatalog } from './catalog.js';
+export type ViewInvoker = (call: Call, operation: SessionOperation) => Promise<Input>;
+export type ViewCatalogAdmission = (input: unknown) => ViewCatalog;
+/**
+ * Invoke Runtime-owned target View resolution through the canonical source Kernel call, then admit
+ * its heterogeneous installed-Publication projection.
+ */
+export declare function resolveViewsFor(invoke: ViewInvoker, admitCatalog: ViewCatalogAdmission, target: PathLike, operation: SessionOperation): Promise<ViewCatalog>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/session/views/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../session/views/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAA;AAK/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAI/C,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;AACrF,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,WAAW,CAAA;AAElE;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,oBAAoB,EAClC,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAGtB"}

package/dist/session/views/resolve.js

@@ -0,0 +1,12 @@
+import { Path } from '@astrale-os/kernel-core/path';
+import { K } from '@astrale-os/kernel-core/schema';
+import { call } from '../../client/index.js';
+/**
+ * Invoke Runtime-owned target View resolution through the canonical source Kernel call, then admit
+ * its heterogeneous installed-Publication projection.
+ */
+export async function resolveViewsFor(invoke, admitCatalog, target, operation) {
+    const path = Path.from(target).raw;
+    return admitCatalog(await invoke(call(K.View.resolve.path, { target: path }), operation));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/session/views/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../session/views/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,gCAAgC,CAAA;AAMlD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAK5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAmB,EACnB,YAAkC,EAClC,MAAgB,EAChB,SAA2B;IAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAA;IAClC,OAAO,YAAY,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;AAC3F,CAAC"}

package/dist/store/entity-index.d.ts

@@ -0,0 +1,23 @@
+import type { Edge, EdgeKey } from '@astrale-os/kernel-core/graph/edge';
+import type { Node, NodeId } from '@astrale-os/kernel-core/graph/node';
+import type { QueryResult } from '@astrale-os/kernel-core/graph/query';
+export interface FactReferences {
+    readonly nodes: readonly NodeId[];
+    readonly edges: readonly string[];
+}
+export interface Integration {
+    readonly references: FactReferences;
+    readonly changedNodes: ReadonlySet<NodeId>;
+    readonly changedEdges: ReadonlySet<string>;
+}
+export declare class EntityIndex {
+    private readonly nodes;
+    private readonly edges;
+    integrate(result: QueryResult): Integration;
+    node(id: NodeId): Node | undefined;
+    edge(key: string): Edge | undefined;
+    sweep(reachableNodes: ReadonlySet<NodeId>, reachableEdges: ReadonlySet<string>): void;
+    clear(): void;
+}
+export declare function edgeIdentity(key: EdgeKey): string;
+//# sourceMappingURL=entity-index.d.ts.map

package/dist/store/entity-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-index.d.ts","sourceRoot":"","sources":["../../store/entity-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAItE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC3C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAEhD,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAsD1C;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEjC;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAElC;IAED,KAAK,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAGpF;IAED,KAAK,IAAI,IAAI,CAGZ;CACF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/store/entity-index.js

@@ -0,0 +1,95 @@
+import { encodeEdgeKey } from '@astrale-os/kernel-core/graph/edge';
+export class EntityIndex {
+    nodes = new Map();
+    edges = new Map();
+    integrate(result) {
+        const changedNodes = new Set();
+        const changedEdges = new Set();
+        const nodeReferences = [];
+        const edgeReferences = [];
+        const integrateNode = (node) => {
+            nodeReferences.push(node.id);
+            const current = this.nodes.get(node.id);
+            if (current === undefined || signature(current) !== signature(node)) {
+                this.nodes.set(node.id, node);
+                changedNodes.add(node.id);
+            }
+        };
+        const referenceNode = (node) => {
+            nodeReferences.push(node.id);
+        };
+        const integrateEdge = (edge) => {
+            const key = encodeEdgeKey(edge);
+            edgeReferences.push(key);
+            const current = this.edges.get(key);
+            if (current === undefined || signature(current) !== signature(edge)) {
+                this.edges.set(key, edge);
+                changedEdges.add(key);
+            }
+        };
+        const referenceEdge = (edge) => {
+            edgeReferences.push(encodeEdgeKey(edge));
+        };
+        if (result.kind === 'graph') {
+            result.graph.nodes.forEach(integrateNode);
+            result.graph.edges.forEach(integrateEdge);
+        }
+        else if (result.kind === 'nodes') {
+            for (const projection of result.nodes) {
+                if (projection.kind === 'value')
+                    integrateNode(projection.value);
+                else
+                    referenceNode(projection.value);
+            }
+        }
+        else if (result.kind === 'edges') {
+            for (const item of result.edges) {
+                if (item.edge.kind === 'value')
+                    integrateEdge(item.edge.value);
+                else
+                    referenceEdge(item.edge.value);
+                if (item.source.kind === 'value')
+                    integrateNode(item.source.value);
+                else
+                    referenceNode(item.source.value);
+                if (item.target.kind === 'value')
+                    integrateNode(item.target.value);
+                else
+                    referenceNode(item.target.value);
+            }
+        }
+        return Object.freeze({
+            references: Object.freeze({
+                nodes: Object.freeze(nodeReferences),
+                edges: Object.freeze(edgeReferences),
+            }),
+            changedNodes,
+            changedEdges,
+        });
+    }
+    node(id) {
+        return this.nodes.get(id);
+    }
+    edge(key) {
+        return this.edges.get(key);
+    }
+    sweep(reachableNodes, reachableEdges) {
+        for (const id of this.nodes.keys())
+            if (!reachableNodes.has(id))
+                this.nodes.delete(id);
+        for (const key of this.edges.keys())
+            if (!reachableEdges.has(key))
+                this.edges.delete(key);
+    }
+    clear() {
+        this.nodes.clear();
+        this.edges.clear();
+    }
+}
+export function edgeIdentity(key) {
+    return encodeEdgeKey(key);
+}
+function signature(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=entity-index.js.map

package/dist/store/entity-index.js.map

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

package/dist/store/index.d.ts

@@ -1,26 +1,2 @@
-/**
- * The client-side graph memory (FRONTEND_GRAPH_DX_SPEC / SHELL_REACT_API).
- *
- * A partial, normalized client copy of the graph kept correct by shapes
- * (standing queries): entity store + shape store + optimistic overlay, over a
- * `GraphApi`. Framework-free — the React bindings layer over `createMemory`.
- * Tier 0 (client self-invalidation) — see `memory.ts` for the interim-ordering
- * caveats until the wire amendments (§6) land.
- *
- * Layout: `canonicalize` (shape keying), `entities`, `shapes`, `overlay`,
- * `invalidate` (§5.6 matching), `memory` (the facade).
- */
-export { createMemory } from './memory.js';
-export type { GraphMemory } from './memory.js';
-export { canonicalizeAST, shapeInputToAST, shapeKey, stableStringify, stripCursors, } from './canonicalize.js';
-export type { RootResolver, ShapeInput } from './canonicalize.js';
-export { EntityStore } from './entities.js';
-export type { EdgeRecord, NodeRecord, ResultLike } from './entities.js';
-export { ShapeStore } from './shapes.js';
-export type { ShapeEntry } from './shapes.js';
-export { Overlay, normalizePatch } from './overlay.js';
-export type { NormalPatch, OverlayEffects, OverlayUnit } from './overlay.js';
-export { affectedShapes, matchesEdge, matchesNodeStructural, subtreeDelta } from './invalidate.js';
-export type { GatherSpec, InvalidateCtx, ShapeView } from './invalidate.js';
-export type { GatherMeta, LiveResult, MaterializedShape, MutateOptions, ReadOptions, MemoryError, MemoryEvent, MemoryOptions, ShapeMeta, Windowed, } from './types.js';
+export { GraphStore, type StoreMutationOptions, type StoreOptions, type StoreQuery, type StoreQueryResponse, type StoreReadOptions, type StoreSnapshot, } from './store.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,EACL,eAAe,EACf,eAAe,EACf,QAAQ,EACR,eAAe,EACf,YAAY,GACb,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACtD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAClG,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3E,YAAY,EACV,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAA"}

package/dist/store/index.js

@@ -1,19 +1,2 @@
-/**
- * The client-side graph memory (FRONTEND_GRAPH_DX_SPEC / SHELL_REACT_API).
- *
- * A partial, normalized client copy of the graph kept correct by shapes
- * (standing queries): entity store + shape store + optimistic overlay, over a
- * `GraphApi`. Framework-free — the React bindings layer over `createMemory`.
- * Tier 0 (client self-invalidation) — see `memory.ts` for the interim-ordering
- * caveats until the wire amendments (§6) land.
- *
- * Layout: `canonicalize` (shape keying), `entities`, `shapes`, `overlay`,
- * `invalidate` (§5.6 matching), `memory` (the facade).
- */
-export { createMemory } from './memory.js';
-export { canonicalizeAST, shapeInputToAST, shapeKey, stableStringify, stripCursors, } from './canonicalize.js';
-export { EntityStore } from './entities.js';
-export { ShapeStore } from './shapes.js';
-export { Overlay, normalizePatch } from './overlay.js';
-export { affectedShapes, matchesEdge, matchesNodeStructural, subtreeDelta } from './invalidate.js';
+export { GraphStore, } from './store.js';
 //# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EACL,eAAe,EACf,eAAe,EACf,QAAQ,EACR,eAAe,EACf,YAAY,GACb,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGtD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAOX,MAAM,YAAY,CAAA"}