@astrale-os/sdk 0.1.0 → 0.1.2

package/dist/domain/define.d.ts

@@ -0,0 +1,82 @@
+/**
+ * `defineRemoteDomain` — turn a typed schema + methods map into a mountable domain.
+ *
+ * When `views` and/or `remoteFunctions` entries are provided, the SDK
+ * auto-materializes graph nodes
+ * under reserved folders (`viewsFolder` / `functionsFolder`, defaults `'views'`
+ * / `'functions'`). Views and standalone functions materialize as canonical
+ * kernel `View` / `Function` classes by default (no per-domain class to
+ * configure). The same entries'
+ * `render` / `execute` handlers are mounted as Hono routes by
+ * `createRemoteServer`. Slug = map key.
+ *
+ * The domain definition is deployment-agnostic: it carries NO serving url. The
+ * url is supplied late by the spec producer (`createRemoteServer({ url })` at
+ * runtime, the devkit CLI offline) and stamped onto every `binding.remoteUrl`
+ * by `materializeRemoteDomain`. There is exactly one notion of `url` in the SDK
+ * — the worker serving URL, which is also `iss` and the binding base.
+ */
+import type { FunctionBinding } from '@astrale-os/kernel-api/routed';
+import type { BoundMethod, CompiledDomain } from '@astrale-os/kernel-core/domain';
+import type { AnyEdgeDef, AnyNodeDef, Core, Schema } from '@astrale-os/kernel-dsl';
+import type { AnyRemoteFunctionDef, ViewDef } from '../define';
+import type { SchemaMethodsImpl } from '../method/class';
+import type { AnyRemoteHandler } from '../method/single';
+export type RemoteDomainConfig<S extends Schema, TDeps> = {
+    schema: S;
+    methods: SchemaMethodsImpl<S, TDeps>;
+    core?: Core<S>;
+    views?: Record<string, ViewDef<TDeps>>;
+    viewClass?: AnyNodeDef;
+    viewForEdgeClass?: AnyEdgeDef;
+    viewsFolder?: string;
+    remoteFunctions?: Record<string, AnyRemoteFunctionDef>;
+    functionsFolder?: string;
+};
+/** Effective bindings + folder layout for auxiliary routes, resolved against `url`. */
+export type AuxiliaryMetadata = {
+    url: string;
+    viewsFolder: string;
+    functionsFolder: string;
+    viewBindings: Record<string, FunctionBinding>;
+    remoteFunctionBindings: Record<string, FunctionBinding>;
+};
+export type RemoteDomain<S extends Schema = Schema> = {
+    /**
+     * Define-time compile: full domain STRUCTURE (classes, methods, and the aux
+     * View/Function nodes' paths/names/refs — what identity, subs, and contract
+     * resolution need). It carries NO `binding` values: bindings derive from the
+     * serving url, which only the spec producers know — they call
+     * `materializeRemoteDomain(domain, url)` for the install-ready compile.
+     */
+    compiled: CompiledDomain<S>;
+    methods: BoundMethod<AnyRemoteHandler>[];
+    views?: Record<string, ViewDef<any>>;
+    remoteFunctions?: Record<string, AnyRemoteFunctionDef>;
+    /** The original config, so `materializeRemoteDomain` re-extends from source. */
+    config: ExtendInputs;
+};
+/** The defineRemoteDomain inputs `materializeRemoteDomain` needs to re-extend. */
+type ExtendInputs = {
+    userCore?: Core;
+    viewClass?: AnyNodeDef;
+    viewForEdgeClass?: AnyEdgeDef;
+    viewsFolder: string;
+    functionsFolder: string;
+};
+export declare function defineRemoteDomain<TDeps>(): <S extends Schema>(config: RemoteDomainConfig<S, TDeps>) => RemoteDomain<S>;
+/**
+ * Materialize a `RemoteDomain` at its real serving `url`: re-runs `extendCore`
+ * so every aux View/Function `binding.remoteUrl` points at the actual host,
+ * and returns the binding maps the auxiliary routes mount from. Called by the
+ * only two spec producers — `createRemoteServer` (`config.url`) and the devkit
+ * CLI. Returns the define-time `compiled` untouched when there is no aux to
+ * stamp. `extendCore`/`compileDomain` are pure, so this is safe to call
+ * repeatedly (and is memoized per cold isolate by the callers).
+ */
+export declare function materializeRemoteDomain<S extends Schema>(domain: RemoteDomain<S>, url: string): {
+    compiled: CompiledDomain<S>;
+    auxiliary: AuxiliaryMetadata | undefined;
+};
+export {};
+//# sourceMappingURL=define.d.ts.map

package/dist/domain/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/domain/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAIlF,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAIxD,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,IAAI;IACxD,MAAM,EAAE,CAAC,CAAA;IACT,OAAO,EAAE,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IACpC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IACtC,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,gBAAgB,CAAC,EAAE,UAAU,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IACtD,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC7C,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACxD,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACpD;;;;;;OAMG;IACH,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;IAC3B,OAAO,EAAE,WAAW,CAAC,gBAAgB,CAAC,EAAE,CAAA;IAExC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IACtD,gFAAgF;IAChF,MAAM,EAAE,YAAY,CAAA;CACrB,CAAA;AAED,kFAAkF;AAClF,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,gBAAgB,CAAC,EAAE,UAAU,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,kBAAkB,CAAC,KAAK,MACrB,CAAC,SAAS,MAAM,UAAU,kBAAkB,CAAC,CAAC,EAAE,KAAK,CAAC,KAAG,YAAY,CAAC,CAAC,CAAC,CA2C1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,CAAA;CAAE,CA6B3E"}

package/dist/domain/define.js

@@ -0,0 +1,99 @@
+/**
+ * `defineRemoteDomain` — turn a typed schema + methods map into a mountable domain.
+ *
+ * When `views` and/or `remoteFunctions` entries are provided, the SDK
+ * auto-materializes graph nodes
+ * under reserved folders (`viewsFolder` / `functionsFolder`, defaults `'views'`
+ * / `'functions'`). Views and standalone functions materialize as canonical
+ * kernel `View` / `Function` classes by default (no per-domain class to
+ * configure). The same entries'
+ * `render` / `execute` handlers are mounted as Hono routes by
+ * `createRemoteServer`. Slug = map key.
+ *
+ * The domain definition is deployment-agnostic: it carries NO serving url. The
+ * url is supplied late by the spec producer (`createRemoteServer({ url })` at
+ * runtime, the devkit CLI offline) and stamped onto every `binding.remoteUrl`
+ * by `materializeRemoteDomain`. There is exactly one notion of `url` in the SDK
+ * — the worker serving URL, which is also `iss` and the binding base.
+ */
+import { bindMethods, compileDomain } from '@astrale-os/kernel-core/domain';
+import { DEFAULT_FUNCTIONS_FOLDER, DEFAULT_VIEWS_FOLDER, extendCore } from './extend-core';
+export function defineRemoteDomain() {
+    return function (config) {
+        const hasAux = Boolean(config.views || config.remoteFunctions);
+        const viewsFolder = config.viewsFolder ?? DEFAULT_VIEWS_FOLDER;
+        const functionsFolder = config.functionsFolder ?? DEFAULT_FUNCTIONS_FOLDER;
+        // Structure-only extension (no url → no bindings stamped): the aux nodes
+        // exist with their paths so subs/identity/contract resolution see them.
+        const effectiveCore = hasAux
+            ? extendCore({
+                schema: config.schema,
+                origin: config.schema.domain,
+                userCore: config.core,
+                viewClass: config.viewClass,
+                viewForEdgeClass: config.viewForEdgeClass,
+                viewsFolder,
+                views: config.views,
+                functionsFolder,
+                remoteFunctions: config.remoteFunctions,
+            }).core
+            : config.core;
+        const compiled = compileDomain(config.schema, effectiveCore);
+        const methods = bindMethods(compiled.$.schema, compiled.$.methods, 
+        // oxlint-disable-next-line no-explicit-any
+        config.methods);
+        return Object.freeze({
+            compiled,
+            methods,
+            ...(config.views ? { views: config.views } : {}),
+            ...(config.remoteFunctions ? { remoteFunctions: config.remoteFunctions } : {}),
+            config: {
+                userCore: config.core,
+                viewClass: config.viewClass,
+                viewForEdgeClass: config.viewForEdgeClass,
+                viewsFolder,
+                functionsFolder,
+            },
+        });
+    };
+}
+/**
+ * Materialize a `RemoteDomain` at its real serving `url`: re-runs `extendCore`
+ * so every aux View/Function `binding.remoteUrl` points at the actual host,
+ * and returns the binding maps the auxiliary routes mount from. Called by the
+ * only two spec producers — `createRemoteServer` (`config.url`) and the devkit
+ * CLI. Returns the define-time `compiled` untouched when there is no aux to
+ * stamp. `extendCore`/`compileDomain` are pure, so this is safe to call
+ * repeatedly (and is memoized per cold isolate by the callers).
+ */
+export function materializeRemoteDomain(domain, url) {
+    const hasAux = Boolean(domain.views || domain.remoteFunctions);
+    if (!hasAux)
+        return { compiled: domain.compiled, auxiliary: undefined };
+    const { config } = domain;
+    const schema = domain.compiled.$.schema;
+    const result = extendCore({
+        schema,
+        origin: schema.domain,
+        userCore: config.userCore,
+        url,
+        viewClass: config.viewClass,
+        viewForEdgeClass: config.viewForEdgeClass,
+        viewsFolder: config.viewsFolder,
+        views: domain.views,
+        functionsFolder: config.functionsFolder,
+        remoteFunctions: domain.remoteFunctions,
+    });
+    const compiled = compileDomain(schema, result.core);
+    return {
+        compiled,
+        auxiliary: {
+            url,
+            viewsFolder: config.viewsFolder,
+            functionsFolder: config.functionsFolder,
+            viewBindings: result.viewBindings,
+            remoteFunctionBindings: result.remoteFunctionBindings,
+        },
+    };
+}
+//# sourceMappingURL=define.js.map

package/dist/domain/define.js.map

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

package/dist/domain/extend-core.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Build an augmented `Core<S>` that includes auto-materialized View and
+ * standalone-function nodes (one per entry in `defineRemoteDomain`'s `views` /
+ * `remoteFunctions` config), plus their parent Folder + optional `view_for`
+ * edges. Returns the resolved effective bindings alongside so callers don't
+ * recompute them.
+ *
+ * Standalone callables (the former `RemoteFunction` class) are materialized as
+ * the canonical kernel `Function` node class — "remote" is just a `binding`,
+ * not a distinct kind, so there is no per-domain class to configure.
+ *
+ * Conflicts: if the user core already declares a top-level node at
+ * `<viewsFolder>` or `<functionsFolder>`, throws — the auto-materialization
+ * reserves those slugs.
+ */
+import type { FunctionBinding } from '@astrale-os/kernel-api/routed';
+import type { AnyEdgeDef, AnyNodeDef, Core, Schema } from '@astrale-os/kernel-dsl';
+import type { AnyRemoteFunctionDef } from '../define/remote-function';
+import type { ViewDef } from '../define/view';
+export declare const DEFAULT_VIEWS_FOLDER = "views";
+export declare const DEFAULT_FUNCTIONS_FOLDER = "functions";
+export type ExtendCoreConfig = {
+    schema: Schema;
+    origin: string;
+    userCore?: Core;
+    /**
+     * The worker's serving URL — the base every auto-materialized binding
+     * resolves against. OMITTED at define time (the URL is known only to the
+     * spec producers): the aux nodes then materialize structure-only (paths,
+     * names, refs — what identity/subs resolution needs) with no `binding`
+     * stamped and empty binding maps. Every install graph comes from a
+     * `materializeRemoteDomain(domain, url)` call where it is present.
+     */
+    url?: string;
+    viewClass?: AnyNodeDef;
+    viewForEdgeClass?: AnyEdgeDef;
+    viewsFolder?: string;
+    views?: Record<string, ViewDef<any>>;
+    functionsFolder?: string;
+    remoteFunctions?: Record<string, AnyRemoteFunctionDef>;
+};
+export type ExtendCoreResult = {
+    core: Core;
+    viewBindings: Record<string, FunctionBinding>;
+    remoteFunctionBindings: Record<string, FunctionBinding>;
+};
+export declare function extendCore(config: ExtendCoreConfig): ExtendCoreResult;
+export declare function resolveBinding(override: FunctionBinding | undefined, url: string, folderSlug: string, slug: string): FunctionBinding;
+//# sourceMappingURL=extend-core.d.ts.map

package/dist/domain/extend-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-core.d.ts","sourceRoot":"","sources":["../../src/domain/extend-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,IAAI,EAGJ,MAAM,EACP,MAAM,wBAAwB,CAAA;AAY/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE7C,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAC3C,eAAO,MAAM,wBAAwB,cAAc,CAAA;AAGnD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,gBAAgB,CAAC,EAAE,UAAU,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IAEpC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;CACvD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,IAAI,CAAA;IACV,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC7C,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACxD,CAAA;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAsFrE;AAQD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,eAAe,CAWjB"}

package/dist/domain/extend-core.js

@@ -0,0 +1,182 @@
+/**
+ * Build an augmented `Core<S>` that includes auto-materialized View and
+ * standalone-function nodes (one per entry in `defineRemoteDomain`'s `views` /
+ * `remoteFunctions` config), plus their parent Folder + optional `view_for`
+ * edges. Returns the resolved effective bindings alongside so callers don't
+ * recompute them.
+ *
+ * Standalone callables (the former `RemoteFunction` class) are materialized as
+ * the canonical kernel `Function` node class — "remote" is just a `binding`,
+ * not a distinct kind, so there is no per-domain class to configure.
+ *
+ * Conflicts: if the user core already declares a top-level node at
+ * `<viewsFolder>` or `<functionsFolder>`, throws — the auto-materialization
+ * reserves those slugs.
+ */
+import { Folder, K, KernelSchema } from '@astrale-os/kernel-core';
+import { buildCorePath } from '@astrale-os/kernel-dsl';
+/** Canonical node class for standalone callables (the former `RemoteFunction`). */
+const FUNCTION_CLASS = KernelSchema.classes.Function;
+/** Canonical node class for GUI views. */
+const VIEW_CLASS = KernelSchema.classes.View;
+/** Canonical edge class linking a View to its target. */
+const VIEW_FOR_EDGE_CLASS = KernelSchema.classes.view_for;
+export const DEFAULT_VIEWS_FOLDER = 'views';
+export const DEFAULT_FUNCTIONS_FOLDER = 'functions';
+const SLUG_RE = /^[a-z][a-z0-9-]*$/;
+export function extendCore(config) {
+    const { schema, origin, userCore, url, viewClass = VIEW_CLASS, viewForEdgeClass = VIEW_FOR_EDGE_CLASS, viewsFolder = DEFAULT_VIEWS_FOLDER, views, functionsFolder = DEFAULT_FUNCTIONS_FOLDER, remoteFunctions, } = config;
+    validateInputs(config);
+    const nodes = userCore ? [...userCore.__nodes] : [];
+    const edges = userCore ? [...userCore.__edges] : [];
+    const viewBindings = {};
+    const remoteFunctionBindings = {};
+    if (views && viewClass) {
+        // Enforce ViewDef's documented exclusivity: `mount` (SPA route) cannot be
+        // combined with `render` (inline HTML handler) or an explicit `binding` —
+        // silently ignoring one of them would deploy a view that behaves
+        // differently than its definition reads.
+        for (const [slug, def] of Object.entries(views)) {
+            if (def.mount && (def.render || def.binding)) {
+                throw new Error(`defineRemoteDomain: view "${slug}" sets \`mount\` together with ` +
+                    `${def.render ? '`render`' : '`binding`'} — they are mutually exclusive.`);
+            }
+        }
+        assertNoConflict(nodes, origin, viewsFolder);
+        addFolderAndEntries({
+            origin,
+            folderSlug: viewsFolder,
+            nodes,
+            entries: Object.entries(views).map(([slug, def]) => {
+                const binding = url
+                    ? def.mount
+                        ? { remoteUrl: joinWorkerPath(url, def.mount) }
+                        : resolveBinding(def.binding, url, viewsFolder, slug)
+                    : undefined;
+                if (binding)
+                    viewBindings[slug] = binding;
+                return {
+                    slug,
+                    nodeClass: viewClass,
+                    data: buildFunctionData(slug, binding),
+                    edges: buildViewForEdges(slug, def, viewForEdgeClass, viewsFolder, origin),
+                };
+            }),
+            edges,
+        });
+    }
+    if (remoteFunctions) {
+        assertNoConflict(nodes, origin, functionsFolder);
+        addFolderAndEntries({
+            origin,
+            folderSlug: functionsFolder,
+            nodes,
+            entries: Object.entries(remoteFunctions).map(([slug, def]) => {
+                const binding = url ? resolveBinding(def.binding, url, functionsFolder, slug) : undefined;
+                if (binding)
+                    remoteFunctionBindings[slug] = binding;
+                return {
+                    slug,
+                    // Standalone callables materialize as the canonical kernel Function class.
+                    nodeClass: FUNCTION_CLASS,
+                    data: {
+                        ...buildFunctionData(slug, binding),
+                        [K.$.i('Function').ref.key]: def.ref ?? `function.${slug}`,
+                    },
+                    edges: [],
+                };
+            }),
+            edges,
+        });
+    }
+    return {
+        core: { schema, domain: origin, __nodes: nodes, __edges: edges },
+        viewBindings,
+        remoteFunctionBindings,
+    };
+}
+/** Join a worker-relative mount path onto the serving url (single slash). */
+function joinWorkerPath(url, mount) {
+    const base = url.replace(/\/+$/, '');
+    return `${base}/${mount.replace(/^\/+/, '')}`;
+}
+export function resolveBinding(override, url, folderSlug, slug) {
+    // Same trailing-slash discipline as `joinWorkerPath` — a `url` ending in `/`
+    // must not produce `//` in the binding (the kernel pins iss by exact string).
+    const base = url.replace(/\/+$/, '');
+    if (override) {
+        return {
+            ...override,
+            remoteUrl: override.remoteUrl ?? `${base}/${folderSlug}/${slug}`,
+        };
+    }
+    return { remoteUrl: `${base}/${folderSlug}/${slug}` };
+}
+// ── Internal ───────────────────────────────────────────────────────────────
+function validateInputs(config) {
+    if (config.views) {
+        for (const slug of Object.keys(config.views)) {
+            if (!SLUG_RE.test(slug)) {
+                throw new Error(`defineRemoteDomain: invalid view slug "${slug}" — must match ${SLUG_RE}.`);
+            }
+        }
+    }
+    if (config.remoteFunctions) {
+        for (const slug of Object.keys(config.remoteFunctions)) {
+            if (!SLUG_RE.test(slug)) {
+                throw new Error(`defineRemoteDomain: invalid remote-function slug "${slug}" — must match ${SLUG_RE}.`);
+            }
+        }
+    }
+}
+function assertNoConflict(nodes, origin, folderSlug) {
+    const folderPath = buildCorePath(origin, [folderSlug]);
+    if (nodes.some((n) => n.path === folderPath)) {
+        throw new Error(`defineRemoteDomain: top-level core slug "${folderSlug}" is reserved by ` +
+            'SDK auto-materialization. Move the conflicting node or rename the ' +
+            '`viewsFolder` / `functionsFolder` config.');
+    }
+}
+function addFolderAndEntries(args) {
+    const { origin, folderSlug, entries, nodes, edges } = args;
+    const folderPath = buildCorePath(origin, [folderSlug]);
+    nodes.push({
+        path: folderPath,
+        def: Folder,
+        data: { [K.Named.name.key]: folderSlug },
+    });
+    for (const entry of entries) {
+        nodes.push({
+            path: buildCorePath(origin, [folderSlug, entry.slug]),
+            def: entry.nodeClass,
+            data: entry.data,
+            parent: folderPath,
+        });
+        for (const e of entry.edges)
+            edges.push(e);
+    }
+}
+function buildFunctionData(slug, binding) {
+    // Match the kernel-core schema serializer which JSON-stringifies the
+    // `Function.binding` value on Function nodes (see
+    // kernel/core/domain/serialize/schema.ts). The kernel install validator
+    // checks `typeof binding === 'string'` then parses; storing a raw object
+    // trips the validator with "missing remote binding" even when the object IS
+    // the binding. No binding at all (define-time, no url) → no prop stamped.
+    return {
+        [K.Named.name.key]: slug,
+        ...(binding ? { [K.$.i('Function').binding.key]: JSON.stringify(binding) } : {}),
+    };
+}
+function buildViewForEdges(slug, def, edgeClass, viewsFolder, origin) {
+    if (!def.viewFor || !edgeClass)
+        return [];
+    const targets = Array.isArray(def.viewFor) ? def.viewFor : [def.viewFor];
+    const from = buildCorePath(origin, [viewsFolder, slug]);
+    return targets.map((target) => ({
+        from,
+        edge: edgeClass,
+        to: target,
+    }));
+}
+//# sourceMappingURL=extend-core.js.map

package/dist/domain/extend-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-core.js","sourceRoot":"","sources":["../../src/domain/extend-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAEtD,mFAAmF;AACnF,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,QAAiC,CAAA;AAC7E,0CAA0C;AAC1C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,IAA6B,CAAA;AACrE,yDAAyD;AACzD,MAAM,mBAAmB,GAAG,YAAY,CAAC,OAAO,CAAC,QAAiC,CAAA;AAKlF,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAA;AACnD,MAAM,OAAO,GAAG,mBAAmB,CAAA;AAgCnC,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,MAAM,EACJ,MAAM,EACN,MAAM,EACN,QAAQ,EACR,GAAG,EACH,SAAS,GAAG,UAAU,EACtB,gBAAgB,GAAG,mBAAmB,EACtC,WAAW,GAAG,oBAAoB,EAClC,KAAK,EACL,eAAe,GAAG,wBAAwB,EAC1C,eAAe,GAChB,GAAG,MAAM,CAAA;IAEV,cAAc,CAAC,MAAM,CAAC,CAAA;IAEtB,MAAM,KAAK,GAAoB,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACpE,MAAM,KAAK,GAAoB,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACpE,MAAM,YAAY,GAAoC,EAAE,CAAA;IACxD,MAAM,sBAAsB,GAAoC,EAAE,CAAA;IAElE,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;QACvB,0EAA0E;QAC1E,0EAA0E;QAC1E,iEAAiE;QACjE,yCAAyC;QACzC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,iCAAiC;oBAChE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,iCAAiC,CAC5E,CAAA;YACH,CAAC;QACH,CAAC;QACD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;QAC5C,mBAAmB,CAAC;YAClB,MAAM;YACN,UAAU,EAAE,WAAW;YACvB,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE;gBACjD,MAAM,OAAO,GAAG,GAAG;oBACjB,CAAC,CAAC,GAAG,CAAC,KAAK;wBACT,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE;wBAC/C,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC;oBACvD,CAAC,CAAC,SAAS,CAAA;gBACb,IAAI,OAAO;oBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;gBACzC,OAAO;oBACL,IAAI;oBACJ,SAAS,EAAE,SAAS;oBACpB,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC;oBACtC,KAAK,EAAE,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,CAAC;iBAC3E,CAAA;YACH,CAAC,CAAC;YACF,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAA;QAChD,mBAAmB,CAAC;YAClB,MAAM;YACN,UAAU,EAAE,eAAe;YAC3B,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE;gBAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;gBACzF,IAAI,OAAO;oBAAE,sBAAsB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;gBACnD,OAAO;oBACL,IAAI;oBACJ,2EAA2E;oBAC3E,SAAS,EAAE,cAAc;oBACzB,IAAI,EAAE;wBACJ,GAAG,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC;wBACnC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,YAAY,IAAI,EAAE;qBAC3D;oBACD,KAAK,EAAE,EAAE;iBACV,CAAA;YACH,CAAC,CAAC;YACF,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;QAChE,YAAY;QACZ,sBAAsB;KACvB,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,GAAW,EAAE,KAAa;IAChD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACpC,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAqC,EACrC,GAAW,EACX,UAAkB,EAClB,IAAY;IAEZ,6EAA6E;IAC7E,8EAA8E;IAC9E,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,GAAG,QAAQ;YACX,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,GAAG,IAAI,IAAI,UAAU,IAAI,IAAI,EAAE;SACjE,CAAA;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,IAAI,UAAU,IAAI,IAAI,EAAE,EAAE,CAAA;AACvD,CAAC;AAED,8EAA8E;AAE9E,SAAS,cAAc,CAAC,MAAwB;IAC9C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,kBAAkB,OAAO,GAAG,CAAC,CAAA;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,qDAAqD,IAAI,kBAAkB,OAAO,GAAG,CACtF,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,KAA+B,EAC/B,MAAc,EACd,UAAkB;IAElB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IACtD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,4CAA4C,UAAU,mBAAmB;YACvE,oEAAoE;YACpE,2CAA2C,CAC9C,CAAA;IACH,CAAC;AACH,CAAC;AASD,SAAS,mBAAmB,CAAC,IAM5B;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAE1D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IACtD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,MAA+B;QACpC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE;KACzC,CAAC,CAAA;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrD,GAAG,EAAE,KAAK,CAAC,SAAS;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,UAAU;SACnB,CAAC,CAAA;QACF,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAY,EACZ,OAAoC;IAEpC,qEAAqE;IACrE,kDAAkD;IAClD,wEAAwE;IACxE,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,OAAO;QACL,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI;QACxB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjF,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAY,EACZ,GAAY,EACZ,SAAiC,EACjC,WAAmB,EACnB,MAAc;IAEd,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAA;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACxE,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAA;IACvD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,MAA6B;KAClC,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/domain/index.d.ts

@@ -0,0 +1,5 @@
+export { defineRemoteDomain } from './define';
+export type { RemoteDomain, RemoteDomainConfig } from './define';
+export { buildInstallGraph, buildInstallGraphHash } from './build-spec';
+export { toSdkContract } from './contract';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/domain/index.js

@@ -0,0 +1,4 @@
+export { defineRemoteDomain } from './define';
+export { buildInstallGraph, buildInstallGraphHash } from './build-spec';
+export { toSdkContract } from './contract';
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE7C,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export type { RemoteContext, RemoteHandler, MethodImpl, ClassMethodsImpl, InterfaceMethodsImpl, SchemaMethodsImpl, } from './method';
+export { remoteMethod, remoteClassMethods, remoteInterfaceMethods } from './method';
+export { defineRemoteDomain, buildInstallGraph, buildInstallGraphHash } from './domain';
+export type { RemoteDomain, RemoteDomainConfig } from './domain';
+export { defineView, defineRemoteFunction } from './define';
+export type { ViewDef, ViewRenderContext, RemoteFunctionDef, RemoteFunctionContext } from './define';
+export { MetaSchema } from './deploy/meta';
+export type { Meta } from './deploy/meta';
+export type { AuthPolicy, RouteBinding, FunctionBinding, CredentialSource, SingleCredentialSource, HttpMethod, RouteBody, OutputMode, } from '@astrale-os/kernel-api/routed';
+export type { RemoteIdentityConfig, AuthenticateResult } from './auth';
+export { authenticateRequest, buildComposedGrant, signCredential } from './auth';
+export { AuthMissingError, AuthInvalidError } from './auth';
+export { assertPerm, requireOwnership, READ, EDIT, USE, SHARE, ALL } from './auth';
+export type { AuthContext, Attestation, Authenticated, Delegation, IdentityId, IssuerId, } from '@astrale-os/kernel-core';
+export { selfGrant } from '@astrale-os/kernel-core';
+export { SdkDispatcher, type SdkDispatcherConfig } from './dispatch';
+export { AuthorizationDeniedError, MethodNotFoundError, SdkValidationError, SdkResultValidationError, } from './dispatch';
+export type { SelfResult, CallRemoteFn } from './dispatch';
+//# 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":"AACA,YAAY,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAGnF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACvF,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAUhE,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC3D,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAcpG,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAGzC,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,+BAA+B,CAAA;AAGtC,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAChF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AAClF,YAAY,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,EACV,UAAU,EACV,QAAQ,GACT,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGnD,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACpE,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,32 @@
+export { remoteMethod, remoteClassMethods, remoteInterfaceMethods } from './method';
+// ─── Domain ──────────────────────────────────────────────────────────────
+export { defineRemoteDomain, buildInstallGraph, buildInstallGraphHash } from './domain';
+// ─── Declarative resource helpers ────────────────────────────────────────
+// Author Views (iframe-mountable) and RemoteFunctions (standalone callables)
+// at the domain definition site. Each `defineView` / `defineRemoteFunction`
+// entry is auto-materialized by `defineRemoteDomain` into a graph node (a
+// `View`, or the canonical kernel `Function` for standalone callables) under
+// the reserved views / functions folder, keyed by its map slug; the same
+// entry's `render` / `execute` (+ auth hooks) is mounted as a worker route by
+// `createRemoteServer`.
+export { defineView, defineRemoteFunction } from './define';
+// ─── Server ──────────────────────────────────────────────────────────────
+// `createRemoteServer` dynamically imports `@hono/node-server` via `./server/start`.
+// Exporting the server surface from the barrel poisons browser bundlers
+// (Vite/esbuild) that traverse every re-export and try to bundle the dynamic
+// chunk — which fails on Node built-ins. Consumers that need the server
+// runtime import from '@astrale-os/sdk/server' directly.
+// ─── Deploy ──────────────────────────────────────────────────────────────
+// `deployCheck` and `hashSpecFile` use Node-only modules (`node:crypto`,
+// `node:fs`, `node:child_process`) at module load time. Exporting them from
+// the barrel poisons browser bundlers (Vite/esbuild) that transitively load
+// every re-export. Consumers that need them import from './deploy' directly.
+export { MetaSchema } from './deploy/meta';
+export { authenticateRequest, buildComposedGrant, signCredential } from './auth';
+export { AuthMissingError, AuthInvalidError } from './auth';
+export { assertPerm, requireOwnership, READ, EDIT, USE, SHARE, ALL } from './auth';
+export { selfGrant } from '@astrale-os/kernel-core';
+// ─── Dispatch (escape hatch for custom integrations) ─────────────────────
+export { SdkDispatcher } from './dispatch';
+export { AuthorizationDeniedError, MethodNotFoundError, SdkValidationError, SdkResultValidationError, } from './dispatch';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEnF,4EAA4E;AAC5E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAGvF,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,8EAA8E;AAC9E,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAG3D,4EAA4E;AAC5E,qFAAqF;AACrF,wEAAwE;AACxE,6EAA6E;AAC7E,wEAAwE;AACxE,yDAAyD;AAEzD,4EAA4E;AAC5E,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAiB1C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAChF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AASlF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAA4B,MAAM,YAAY,CAAA;AACpE,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAA"}

package/dist/method/class.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Class-level method aggregation.
+ *
+ * Where `RemoteHandler` describes one method, the types here describe a
+ * whole class's worth of methods. `ClassMethodsImpl<S, K, TDeps>` enforces
+ * that every implementable method on class `K` is provided. The interface
+ * variant handles abstract definitions; the schema variant indexes by class
+ * name.
+ *
+ * `remoteClassMethods` is the identity helper an author calls when supplying
+ * a class's full method record — it gives full inference for the class
+ * methods at once, complementing `remoteMethod` (one method at a time).
+ */
+import type { DefForInterface, InterfaceMethodDefs, InterfaceMethodKeys, MethodClassKeys, NonSealedMethodKeys, OwnMethodKeys, ResolveParams, ResolveReturn, SealedKeys } from '@astrale-os/kernel-core/domain';
+import type { ImplementableOwnKeys, Schema } from '@astrale-os/kernel-dsl';
+import type { SelfResult } from '../dispatch/self';
+import type { MethodImpl, RemoteHandler } from './single';
+/** Per-class method implementations for a remote domain. */
+export type ClassMethodsImpl<S extends Schema, K extends MethodClassKeys<S> & string, TDeps = unknown> = {
+    [M in OwnMethodKeys<S, K>]: MethodImpl<S, K, M, TDeps>;
+} & {
+    [M in NonSealedMethodKeys<S, K>]: MethodImpl<S, K, M, TDeps>;
+} & {
+    [M in SealedKeys<S, K>]?: never;
+};
+/** Resolve interface method handler directly (InterfaceMethodKeys ≠ MethodKeys). */
+type InterfaceMethodHandler<S extends Schema, K extends string, M extends string, TDeps> = M extends keyof InterfaceMethodDefs<S, K> ? InterfaceMethodDefs<S, K>[M] extends {
+    readonly config: infer MC;
+} ? MC extends {
+    readonly static: true;
+} ? RemoteHandler<ResolveParams<MC>, ResolveReturn<MC>, undefined, TDeps> : RemoteHandler<ResolveParams<MC>, ResolveReturn<MC>, SelfResult, TDeps> : never : never;
+/** Per-interface method implementations. */
+export type InterfaceMethodsImpl<S extends Schema, K extends InterfaceMethodKeys<S> & string, TDeps = unknown> = {
+    [M in ImplementableOwnKeys<DefForInterface<S, K>> & string]: InterfaceMethodHandler<S, K, M, TDeps>;
+};
+/**
+ * Namespace-keyed full schema methods map, parameterized by deps.
+ * Handlers for classes and interfaces live under distinct `class` / `interface`
+ * slots, preventing name collisions between a class and an interface with the
+ * same name.
+ *
+ * `interface` is optional — schemas without non-abstract interface methods
+ * (or with no interfaces at all) do not need to provide it.
+ */
+export type SchemaMethodsImpl<S extends Schema, TDeps = unknown> = {
+    class: {
+        [K in MethodClassKeys<S> & string]: ClassMethodsImpl<S, K, TDeps>;
+    };
+    interface?: {
+        [K in InterfaceMethodKeys<S> & string]: InterfaceMethodsImpl<S, K, TDeps>;
+    };
+};
+type RejectSealedKeys<S extends Schema, K extends string, I> = keyof I & SealedKeys<S, K> extends never ? I : `Error: sealed methods must not be implemented by class '${K}': ${keyof I & SealedKeys<S, K> & string}`;
+/** Identity helper for authoring one class's remote methods with full schema typing. */
+export declare function remoteClassMethods<TDeps>(): <S extends Schema, K extends MethodClassKeys<S> & string, I extends ClassMethodsImpl<S, K, TDeps>>(schema: S, className: K, impl: I & RejectSealedKeys<S, K, I>) => I;
+export declare function remoteClassMethods<S extends Schema, K extends MethodClassKeys<S> & string, I extends ClassMethodsImpl<S, K>>(schema: S, className: K, impl: I & RejectSealedKeys<S, K, I>): I;
+/**
+ * Identity helper for authoring one interface's remote methods with full
+ * schema typing — the interface-hosted counterpart of `remoteClassMethods`.
+ *
+ * Methods declared on an interface (e.g. a static `createNote` on `NoteOps`)
+ * live under the `interface:` slot of `SchemaMethodsImpl`. Without this helper
+ * an author has to fall back to `any` (there is no other way to name the
+ * per-method handler type — `InterfaceMethodHandler` is internal). Returns the
+ * per-interface impl object the `interface: { <Name>: … }` slot expects.
+ */
+export declare function remoteInterfaceMethods<TDeps>(): <S extends Schema, K extends InterfaceMethodKeys<S> & string, I extends InterfaceMethodsImpl<S, K, TDeps>>(schema: S, interfaceName: K, impl: I) => I;
+export declare function remoteInterfaceMethods<S extends Schema, K extends InterfaceMethodKeys<S> & string, I extends InterfaceMethodsImpl<S, K>>(schema: S, interfaceName: K, impl: I): I;
+export {};
+//# sourceMappingURL=class.d.ts.map

package/dist/method/class.d.ts.map

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

package/dist/method/class.js

@@ -0,0 +1,26 @@
+/**
+ * Class-level method aggregation.
+ *
+ * Where `RemoteHandler` describes one method, the types here describe a
+ * whole class's worth of methods. `ClassMethodsImpl<S, K, TDeps>` enforces
+ * that every implementable method on class `K` is provided. The interface
+ * variant handles abstract definitions; the schema variant indexes by class
+ * name.
+ *
+ * `remoteClassMethods` is the identity helper an author calls when supplying
+ * a class's full method record — it gives full inference for the class
+ * methods at once, complementing `remoteMethod` (one method at a time).
+ */
+export function remoteClassMethods(...args) {
+    if (args.length === 0) {
+        return (...innerArgs) => innerArgs[2];
+    }
+    return args[2];
+}
+export function remoteInterfaceMethods(...args) {
+    if (args.length === 0) {
+        return (...innerArgs) => innerArgs[2];
+    }
+    return args[2];
+}
+//# sourceMappingURL=class.js.map