@astrale-os/kernel-client 0.2.0

package/dist/schema/registry.js

@@ -0,0 +1,111 @@
+import { Ref } from '@astrale-os/kernel-core/domain';
+import { dequal } from 'dequal';
+import { resolveMethodKey } from './resolve';
+const OWNER_NAMESPACES = ['class', 'interface'];
+/**
+ * Cross-realm brand so `isSchemaRegistry(x)` works even when two copies
+ * of `@astrale-os/kernel-client` end up in the same process (peer-dep
+ * drift, iframe + parent page, etc). `instanceof SchemaRegistry` fails
+ * in that case; the Symbol.for-based check does not.
+ */
+export const SCHEMA_REGISTRY_BRAND = Symbol.for('astrale.SchemaRegistry');
+/**
+ * Client-side cache of function schemas keyed by canonical ref.
+ *
+ * Two ways to populate it:
+ *   - `load(schemas)` — one-shot, rejects duplicates. Used when the caller
+ *     brings the schemas with them (static domain imports, `Function.list`
+ *     prefetch).
+ *   - `save(schema)` — upsert learned from a redirect response. Strict:
+ *     input/output/output-mode must match any existing entry; only `binding`
+ *     is allowed to change (URL relocation is legitimate, contract drift is
+ *     not).
+ */
+export class SchemaRegistry {
+    [SCHEMA_REGISTRY_BRAND] = true;
+    methods = new Map();
+    load(schemas) {
+        for (const schema of schemas) {
+            if (this.methods.has(schema.ref)) {
+                throw new Error(`SchemaRegistry: duplicate method ref "${schema.ref}". ` +
+                    `A schema with this ref is already registered. ` +
+                    `This can happen when two domains define the same class and method name.`);
+            }
+            this.methods.set(schema.ref, schema);
+        }
+    }
+    /**
+     * Upsert a schema — typically one learned from a `redirect` response.
+     *
+     * If no entry exists for the ref, inserts verbatim. If an entry exists,
+     * asserts that the contract shape (input / output / output mode) matches
+     * and updates only the `binding`. Contract drift throws — a server that
+     * ships a mismatched schema is either misconfigured or malicious.
+     */
+    save(schema) {
+        const existing = this.methods.get(schema.ref);
+        if (!existing) {
+            this.methods.set(schema.ref, schema);
+            return;
+        }
+        if (!sameContract(existing, schema)) {
+            throw new Error(`SchemaRegistry.save: contract mismatch for "${schema.ref}". ` +
+                `The saved schema's input/output or output mode differs from the ` +
+                `previously registered version. Refusing to clobber a registered contract.`);
+        }
+        this.methods.set(schema.ref, { ...existing, binding: schema.binding });
+    }
+    get(ref) {
+        return this.methods.get(ref);
+    }
+    has(ref) {
+        return this.methods.has(ref);
+    }
+    clear() {
+        this.methods.clear();
+    }
+    /**
+     * Type guard for `SchemaRegistry | FunctionSchema[]` unions. Works
+     * across package-duplicate realms, unlike `instanceof`.
+     */
+    static is(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            value[SCHEMA_REGISTRY_BRAND] === true);
+    }
+    /**
+     * Resolve a wire method address to its schema entry.
+     *
+     * Delegates normalization to `resolveMethodKey`. When the input lacks a
+     * namespace (an instance dispatch or a `:member:method` path), probes the
+     * `class` and `interface` namespaces in that order.
+     */
+    resolve(method, classHint) {
+        const key = resolveMethodKey(method, classHint);
+        if (!key)
+            return undefined;
+        if (key.kind === 'ref')
+            return this.methods.get(key.ref);
+        for (const ns of OWNER_NAMESPACES) {
+            const ref = Ref.method(ns, key.owner, key.method).toString();
+            const schema = this.methods.get(ref);
+            if (schema)
+                return schema;
+        }
+        return undefined;
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Structural equality over the fields that define a contract — the pieces a
+ * client legitimately depends on matching across redirects. Uses a recursive
+ * compare (rather than `JSON.stringify`) so key-order permutations between
+ * serializers don't trigger false negatives.
+ */
+function sameContract(a, b) {
+    return (a.output === b.output &&
+        dequal(a.inputSchema, b.inputSchema) &&
+        dequal(a.outputSchema, b.outputSchema) &&
+        dequal(a.code, b.code));
+}
+//# sourceMappingURL=registry.js.map

package/dist/schema/registry.js.map

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

package/dist/schema/resolve.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A method key that hasn't been narrowed to a namespace yet.
+ * The registry probes `class` then `interface` to resolve it.
+ */
+export type OwnerMethod = {
+    kind: 'owner-method';
+    owner: string;
+    method: string;
+};
+export type ResolvedMethodKey = {
+    kind: 'ref';
+    ref: string;
+} | OwnerMethod;
+/**
+ * Normalize a wire method address to a registry-lookup key.
+ *
+ * Accepts any of:
+ *  - A canonical `Ref` string (`class.Author.method.deactivate`) — returned as-is.
+ *  - A typed `MethodPath` (`/:domain:Class:method`) — yields `{ owner, method }`.
+ *  - A typed `InstanceMethodPath` (`@id::method`) — yields `{ owner, method }`
+ *    using `classHint` as the owner.
+ *
+ * Returns `undefined` when the input is not a recognized method reference.
+ */
+export declare function resolveMethodKey(method: string, classHint?: string): ResolvedMethodKey | undefined;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/schema/resolve.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjF,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAAA;AAE1E;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,GAAG,SAAS,CAY/B"}

package/dist/schema/resolve.js

@@ -0,0 +1,27 @@
+import { Path } from '@astrale-os/kernel-core';
+import { InstanceMethodPath, MethodPath, Ref } from '@astrale-os/kernel-core/domain';
+/**
+ * Normalize a wire method address to a registry-lookup key.
+ *
+ * Accepts any of:
+ *  - A canonical `Ref` string (`class.Author.method.deactivate`) — returned as-is.
+ *  - A typed `MethodPath` (`/:domain:Class:method`) — yields `{ owner, method }`.
+ *  - A typed `InstanceMethodPath` (`@id::method`) — yields `{ owner, method }`
+ *    using `classHint` as the owner.
+ *
+ * Returns `undefined` when the input is not a recognized method reference.
+ */
+export function resolveMethodKey(method, classHint) {
+    const ref = Ref.tryParse(method);
+    if (ref?.isMethod)
+        return { kind: 'ref', ref: ref.toString() };
+    const path = Path.tryParse(method);
+    if (path instanceof MethodPath) {
+        return { kind: 'owner-method', owner: path.member, method: path.method };
+    }
+    if (path instanceof InstanceMethodPath && classHint) {
+        return { kind: 'owner-method', owner: classHint, method: path.methodName };
+    }
+    return undefined;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/schema/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/schema/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAA;AAUpF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,SAAkB;IAElB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAChC,IAAI,GAAG,EAAE,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAA;IAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAC1E,CAAC;IACD,IAAI,IAAI,YAAY,kBAAkB,IAAI,SAAS,EAAE,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,CAAA;IAC5E,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/schema/typed-client.d.ts

@@ -0,0 +1,10 @@
+import type { Schema } from '@astrale-os/kernel-dsl';
+import type { ProxyCaller, SchemaTypedClient } from './proxy-types';
+/**
+ * Create a SchemaTypedClient — a schema-bound view of a client.
+ *
+ * Accepts a `ProxyCaller` — a function that sends calls through the
+ * client with the right credential strategy already baked in.
+ */
+export declare function createSchemaClient<S extends Schema>(caller: ProxyCaller, schema: S): SchemaTypedClient<S>;
+//# sourceMappingURL=typed-client.d.ts.map

package/dist/schema/typed-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-client.d.ts","sourceRoot":"","sources":["../../src/schema/typed-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,KAAK,EAIV,WAAW,EACX,iBAAiB,EAClB,MAAM,eAAe,CAAA;AAMtB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,CAAC,GACR,iBAAiB,CAAC,CAAC,CAAC,CA2BtB"}

package/dist/schema/typed-client.js

@@ -0,0 +1,26 @@
+import { createClassProxy } from './class-proxy';
+import { extractMethodsByClass } from './extract';
+import { createNodeProxy } from './node-proxy';
+/**
+ * Create a SchemaTypedClient — a schema-bound view of a client.
+ *
+ * Accepts a `ProxyCaller` — a function that sends calls through the
+ * client with the right credential strategy already baked in.
+ */
+export function createSchemaClient(caller, schema) {
+    const domain = schema.domain;
+    if (!domain || typeof domain !== 'string') {
+        throw new Error('Schema must have a non-empty domain string');
+    }
+    const methodsByClass = extractMethodsByClass(schema);
+    return {
+        schema,
+        node(className, nodeId) {
+            return createNodeProxy(caller, className, nodeId, methodsByClass.get(className));
+        },
+        static(className) {
+            return createClassProxy(caller, domain, className, methodsByClass.get(className));
+        },
+    };
+}
+//# sourceMappingURL=typed-client.js.map

package/dist/schema/typed-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-client.js","sourceRoot":"","sources":["../../src/schema/typed-client.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,MAAS;IAET,MAAM,MAAM,GAAG,MAAM,CAAC,MAAgB,CAAA;IACtC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAEpD,OAAO;QACL,MAAM;QAEN,IAAI,CAA0B,SAAY,EAAE,MAAc;YACxD,OAAO,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAG9E,CAAA;QACH,CAAC;QAED,MAAM,CAA0B,SAAY;YAC1C,OAAO,gBAAgB,CACrB,MAAM,EACN,MAAM,EACN,SAAS,EACT,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CACV,CAAA;QACvB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/schema/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Function schema — canonical shape of a method as it travels on the wire.
+ *
+ * Re-exported from `@astrale-os/kernel-core/domain` so the client and the
+ * server agree on a single type. See
+ * `kernel/core/domain/compile/method/serialized.ts` for the definition.
+ */
+export type { FunctionSchema } from '@astrale-os/kernel-core/domain';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/schema/types.js

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

package/dist/schema/types.js.map

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

package/dist/session/bound.d.ts

@@ -0,0 +1,11 @@
+import type { CredentialInput } from '@astrale-os/kernel-core';
+import type { FnMap } from '../client/fn-map';
+import type { ClientSession } from './client-session';
+import type { BoundClientSessionView } from './types';
+/**
+ * Credential-bound view over a `ClientSession`. Every dispatch primitive delegates
+ * to the underlying ClientSession with `opts.credential` replaced by the captured
+ * credential. `as(next)` returns a fresh view — rebindings don't mutate.
+ */
+export declare function createBoundSessionView<M extends FnMap>(session: ClientSession<M>, credential: CredentialInput | (() => CredentialInput)): BoundClientSessionView<M>;
+//# sourceMappingURL=bound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bound.d.ts","sourceRoot":"","sources":["../../src/session/bound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,KAAK,EACpD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,UAAU,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,CAAC,GACpD,sBAAsB,CAAC,CAAC,CAAC,CAoB3B"}

package/dist/session/bound.js

@@ -0,0 +1,24 @@
+/**
+ * Credential-bound view over a `ClientSession`. Every dispatch primitive delegates
+ * to the underlying ClientSession with `opts.credential` replaced by the captured
+ * credential. `as(next)` returns a fresh view — rebindings don't mutate.
+ */
+export function createBoundSessionView(session, credential) {
+    const cred = () => (typeof credential === 'function' ? credential() : credential);
+    return {
+        get default() {
+            return session.default;
+        },
+        get registry() {
+            return session.registry;
+        },
+        call: (method, params, opts) => session.call(method, params, { ...opts, credential: cred() }),
+        stream: (method, params, opts) => session.stream(method, params, { ...opts, credential: cred() }),
+        binary: (method, params, opts) => session.binary(method, params, { ...opts, credential: cred() }),
+        signal: (method, params, opts) => session.signal(method, params, { ...opts, credential: cred() }),
+        describe: (method) => session.describe(method),
+        withSchema: (schema) => session.withSchema(schema),
+        as: (next) => createBoundSessionView(session, next),
+    };
+}
+//# sourceMappingURL=bound.js.map

package/dist/session/bound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound.js","sourceRoot":"","sources":["../../src/session/bound.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAyB,EACzB,UAAqD;IAErD,MAAM,IAAI,GAAG,GAAoB,EAAE,CAAC,CAAC,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAClG,OAAO;QACL,IAAI,OAAO;YACT,OAAO,OAAO,CAAC,OAAO,CAAA;QACxB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,OAAO,CAAC,QAAQ,CAAA;QACzB,CAAC;QACD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7F,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QACjE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QACjE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QACjE,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAClD,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC;KACpD,CAAA;AACH,CAAC"}

package/dist/session/client-session.d.ts

@@ -0,0 +1,61 @@
+import type { CredentialInput } from '@astrale-os/kernel-core';
+import type { Schema } from '@astrale-os/kernel-dsl';
+import type { BinaryFns, CallFns, FnMap, SignalFns, StreamFns } from '../client/fn-map';
+import type { DelegationCache } from '../delegation/cache';
+import type { ClientPool } from '../pool/pool';
+import type { BinaryResponse } from '../transport/binary';
+import type { ClientSessionCallOptions, ClientSessionConfig } from './config';
+import type { BoundClientSessionView, SchemaTypedClientSession } from './types';
+import { SchemaRegistry } from '../schema/registry';
+/**
+ * ClientSession — the orchestration layer above `KernelClient`.
+ *
+ * Composes `ClientPool`, `DelegationCache`, `DelegationPolicy`,
+ * `RedirectPolicy`, and `SchemaPersistence` into a single call
+ * surface. See `docs/specs/kernel-client-session.md`.
+ */
+export declare class ClientSession<M extends FnMap = FnMap> {
+    #private;
+    readonly default: string;
+    readonly registry: SchemaRegistry;
+    constructor(config: ClientSessionConfig<M>);
+    /**
+     * Idempotent teardown. Tears down the pool (and every cached client).
+     * Registry, schema store, and delegation cache are untouched — they may
+     * be shared across ClientSessions.
+     */
+    disconnect(): void;
+    get pool(): ClientPool<M>;
+    get delegation(): DelegationCache | undefined;
+    describe(method: string): ReturnType<SchemaRegistry['resolve']>;
+    /**
+     * Await schema-persistence hydration. Every dispatch primitive awaits this
+     * implicitly; consumers can await it explicitly to front-load load failures.
+     */
+    ready(): Promise<void>;
+    call<K extends CallFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): Promise<M[K]['result']>;
+    stream<K extends StreamFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): Promise<AsyncIterable<M[K]['result']>>;
+    binary<K extends BinaryFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): Promise<BinaryResponse>;
+    signal<K extends SignalFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): void;
+    as(credential: CredentialInput | (() => CredentialInput)): BoundClientSessionView<M>;
+    withSchema<S extends Schema>(schema: S): SchemaTypedClientSession<S>;
+    private dispatch;
+    private runSignal;
+    /**
+     * Wrap the caller's mint to fire `onDelegationMint` with the list of
+     * waiter cids — read AFTER the mint resolves so late joiners to the dedup
+     * are included.
+     */
+    private wrapMint;
+    private trackPendingMint;
+    private untrackPendingMint;
+    private hydrate;
+    private resolveIdentity;
+    private audienceFor;
+    private resolveDelegatedCredential;
+    private wireSend;
+    private decorate;
+    private fire;
+    private fireError;
+}
+//# sourceMappingURL=client-session.d.ts.map

package/dist/session/client-session.d.ts.map

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