@aster-rpc/aster 0.1.2

package/dist/contract/identity.js

@@ -0,0 +1,188 @@
+/**
+ * Contract identity — canonical serialization and BLAKE3 hashing.
+ *
+ * Spec reference: Aster-ContractIdentity.md S11.3
+ *
+ * Contract ID = BLAKE3(canonical_xlang_bytes(ServiceContract))
+ *
+ * All canonical encoding and hashing is delegated to the Rust core via
+ * NAPI-RS. The native binding is required — without it, there is no Iroh
+ * transport either, so the entire binding is non-functional.
+ */
+// -- Enums (normative values from spec) ---------------------------------------
+export const TypeKind = { PRIMITIVE: 0, REF: 1, SELF_REF: 2, ANY: 3 };
+export const ContainerKind = { NONE: 0, LIST: 1, SET: 2, MAP: 3 };
+export const TypeDefKind = { MESSAGE: 0, ENUM: 1, UNION: 2 };
+export const MethodPattern = { UNARY: 0, SERVER_STREAM: 1, CLIENT_STREAM: 2, BIDI_STREAM: 3 };
+export const CapabilityKind = { ROLE: 0, ANY_OF: 1, ALL_OF: 2 };
+export const ScopeKind = {
+    SHARED: 0,
+    SESSION: 1,
+    /** Legacy alias kept for back-compat with code that imported ScopeKind.STREAM.
+     *  Resolves to the same integer (1), so contract ids are unaffected. */
+    STREAM: 1,
+};
+// -- Serde-compatible enum names (must match Rust #[serde(rename_all = "snake_case")]) --
+const PATTERN_NAMES = {
+    0: 'unary', 1: 'server_stream', 2: 'client_stream', 3: 'bidi_stream',
+};
+// The Rust canonical encoder accepts both "session" and "stream" via
+// #[serde(alias = "stream")]. We send "stream" here for compat with
+// pre-rename NAPI binaries that haven't been rebuilt yet.
+const SCOPE_NAMES = { 0: 'shared', 1: 'stream' };
+const CAP_NAMES = { 0: 'role', 1: 'any_of', 2: 'all_of' };
+function hex(data) {
+    return Array.from(data, b => b.toString(16).padStart(2, '0')).join('');
+}
+/** Convert a ServiceContract to JSON matching the Rust serde format. */
+function contractToJson(contract) {
+    return JSON.stringify({
+        name: contract.name,
+        version: contract.version,
+        methods: contract.methods.map(m => ({
+            name: m.name,
+            pattern: PATTERN_NAMES[m.pattern] ?? m.pattern,
+            request_type: hex(m.requestType),
+            response_type: hex(m.responseType),
+            idempotent: m.idempotent,
+            default_timeout: m.defaultTimeout,
+            requires: m.requires ? {
+                kind: CAP_NAMES[m.requires.kind] ?? m.requires.kind,
+                roles: m.requires.roles,
+            } : null,
+        })),
+        serialization_modes: contract.serializationModes,
+        scoped: SCOPE_NAMES[contract.scoped] ?? contract.scoped,
+        requires: contract.requires ? {
+            kind: CAP_NAMES[contract.requires.kind] ?? contract.requires.kind,
+            roles: contract.requires.roles,
+        } : null,
+    });
+}
+let _native;
+/**
+ * Set the native contract binding. Called once at startup when the
+ * NAPI-RS addon is loaded.
+ */
+export function setNativeContract(native) {
+    _native = native;
+}
+function requireNative() {
+    if (!_native) {
+        throw new Error('Native contract binding not configured. Call setNativeContract() with ' +
+            'the NAPI-RS binding at startup. Without native support, contract ' +
+            'identity and Iroh transport are unavailable.');
+    }
+    return _native;
+}
+// -- Public API ---------------------------------------------------------------
+/** Serialize a ServiceContract to canonical XLANG bytes via Rust core. */
+export function canonicalXlangBytes(contract) {
+    const native = requireNative();
+    return new Uint8Array(native.canonicalBytesFromJson('ServiceContract', contractToJson(contract)));
+}
+/** Compute BLAKE3 hash of canonical bytes. Returns 64-char hex string. */
+export function computeContractId(canonicalBytes) {
+    const native = requireNative();
+    const digest = native.computeTypeHash(canonicalBytes);
+    return Array.from(new Uint8Array(digest), b => b.toString(16).padStart(2, '0')).join('');
+}
+/** Compute contract ID directly from a ServiceContract (most efficient path). */
+export function contractIdFromJson(contract) {
+    const native = requireNative();
+    return native.computeContractIdFromJson(contractToJson(contract));
+}
+/** Alias for contractIdFromJson. */
+export function contractIdFromContract(contract) {
+    return contractIdFromJson(contract);
+}
+/**
+ * Compute a contract ID from a @Service-decorated class.
+ * Builds the ServiceContract from service info and computes its ID.
+ */
+export function contractIdFromService(serviceClass) {
+    // Build a minimal ServiceContract from service info
+    const info = serviceClass[Symbol.for('aster.service_info')];
+    if (!info) {
+        throw new TypeError(`${serviceClass.name} is not decorated with @Service`);
+    }
+    const contract = {
+        name: info.name,
+        version: info.version,
+        methods: [],
+        serializationModes: [],
+        // Accept both the canonical 'session' value and the legacy 'stream' alias.
+        scoped: (info.scoped === 'session' || info.scoped === 'stream') ? 1 : 0,
+        requires: undefined,
+    };
+    for (const [, m] of info.methods) {
+        contract.methods.push({
+            name: m.name,
+            pattern: m.pattern === 'server_stream' ? 1 : m.pattern === 'client_stream' ? 2 : m.pattern === 'bidi_stream' ? 3 : 0,
+            requestType: new Uint8Array(32),
+            responseType: new Uint8Array(32),
+            idempotent: m.idempotent ?? false,
+            defaultTimeout: 0,
+            requires: undefined,
+        });
+    }
+    return contractIdFromJson(contract);
+}
+/**
+ * Build the transitive type graph for a set of @WireType classes.
+ * Alias for walkTypeGraph (from codec.ts) for contract identity use.
+ */
+export function buildTypeGraph(rootTypes) {
+    const WIRE_TYPE_KEY = Symbol.for('aster.wire_type');
+    const visited = new Set();
+    const ordered = [];
+    function visit(cls) {
+        if (visited.has(cls))
+            return;
+        visited.add(cls);
+        const tag = cls[WIRE_TYPE_KEY];
+        if (!tag)
+            return;
+        try {
+            const inst = new cls();
+            for (const key of Object.keys(inst)) {
+                const ctor = inst[key]?.constructor;
+                if (ctor && ctor[WIRE_TYPE_KEY])
+                    visit(ctor);
+            }
+        }
+        catch { /* ignore */ }
+        ordered.push(cls);
+    }
+    for (const cls of rootTypes)
+        visit(cls);
+    return ordered;
+}
+/**
+ * Build a ServiceContract from a ServiceInfo object.
+ * Used for contract identity verification.
+ */
+export function fromServiceInfo(info) {
+    const contract = {
+        name: info.name,
+        version: info.version,
+        methods: [],
+        serializationModes: [],
+        // Accept both the canonical 'session' value and the legacy 'stream' alias.
+        scoped: (info.scoped === 'session' || info.scoped === 'stream') ? 1 : 0,
+        requires: info.requires ? { kind: info.requires.kind === 'any_of' ? 1 : 2, roles: info.requires.roles } : undefined,
+    };
+    for (const [, m] of info.methods) {
+        contract.methods.push({
+            name: m.name,
+            pattern: m.pattern === 'server_stream' ? 1 : m.pattern === 'client_stream' ? 2 : m.pattern === 'bidi_stream' ? 3 : 0,
+            requestType: new Uint8Array(32),
+            responseType: new Uint8Array(32),
+            idempotent: m.idempotent ?? false,
+            defaultTimeout: 0,
+            requires: undefined,
+        });
+    }
+    return contract;
+}
+//# sourceMappingURL=identity.js.map

package/dist/contract/identity.js.map

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

package/dist/contract/manifest.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ContractManifest — persisted contract identity metadata.
+ *
+ * Spec reference: Aster-ContractIdentity.md S11.4
+ *
+ * A manifest records a service contract's identity (BLAKE3 hash),
+ * method schemas, type hashes, and metadata. Used for:
+ * - Startup verification (contract hasn't changed)
+ * - Dynamic discovery (shell, MCP, other language clients)
+ * - Contract publication (registry + blobs)
+ */
+/** Method descriptor within a manifest. */
+export interface ManifestMethod {
+    name: string;
+    pattern: string;
+    requestType: string;
+    responseType: string;
+    timeout: number;
+    idempotent: boolean;
+    /** Request type field descriptors for dynamic invocation. */
+    fields: ManifestField[];
+    /** Fory wire tags for request/response types. */
+    requestWireTag?: string;
+    responseWireTag?: string;
+    /** Fory wire tags for response fields (for dynamic type synthesis). */
+    responseFields?: ManifestField[];
+}
+/** Field descriptor for dynamic invocation. */
+export interface ManifestField {
+    name: string;
+    type: string;
+    required: boolean;
+    default?: unknown;
+}
+/** Persisted contract manifest. */
+export interface ContractManifest {
+    service: string;
+    version: number;
+    contractId: string;
+    canonicalEncoding: string;
+    typeCount: number;
+    typeHashes: string[];
+    methodCount: number;
+    methods: ManifestMethod[];
+    serializationModes: string[];
+    scoped: string;
+    deprecated: boolean;
+    semver?: string;
+    vcsRevision?: string;
+    vcsTag?: string;
+    vcsUrl?: string;
+    changelog?: string;
+}
+/** Error raised when a live contract doesn't match the manifest. */
+export declare class FatalContractMismatch extends Error {
+    readonly serviceName: string;
+    readonly serviceVersion: number;
+    readonly expectedId: string;
+    readonly actualId: string;
+    constructor(serviceName: string, serviceVersion: number, expectedId: string, actualId: string);
+}
+/** Verify that a contract ID matches the manifest. Throws on mismatch. */
+export declare function verifyManifestOrFatal(manifest: ContractManifest, actualContractId: string): void;
+/** Serialize a manifest to JSON. */
+export declare function manifestToJson(manifest: ContractManifest): string;
+/**
+ * Extract method descriptors from a manifest for introspection.
+ * Returns a simplified record of method name → pattern.
+ */
+export declare function extractMethodDescriptors(manifest: ContractManifest): Record<string, string>;
+/**
+ * Save a manifest to a JSON file.
+ */
+export declare function saveManifest(manifest: ContractManifest, filePath: string): void;
+/** Parse a manifest from JSON. */
+export declare function manifestFromJson(json: string): ContractManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/contract/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/contract/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,WAAW,EAAE,MAAM;aACnB,cAAc,EAAE,MAAM;aACtB,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBAHhB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CAUnC;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,EAAE,MAAM,GACvB,IAAI,CASN;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CA0BjE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAG/E;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA6C/D"}

package/dist/contract/manifest.js

@@ -0,0 +1,127 @@
+/**
+ * ContractManifest — persisted contract identity metadata.
+ *
+ * Spec reference: Aster-ContractIdentity.md S11.4
+ *
+ * A manifest records a service contract's identity (BLAKE3 hash),
+ * method schemas, type hashes, and metadata. Used for:
+ * - Startup verification (contract hasn't changed)
+ * - Dynamic discovery (shell, MCP, other language clients)
+ * - Contract publication (registry + blobs)
+ */
+import { MAX_MANIFEST_METHODS, MAX_MANIFEST_TYPE_HASHES } from '../limits.js';
+/** Error raised when a live contract doesn't match the manifest. */
+export class FatalContractMismatch extends Error {
+    serviceName;
+    serviceVersion;
+    expectedId;
+    actualId;
+    constructor(serviceName, serviceVersion, expectedId, actualId) {
+        super(`Contract identity mismatch for '${serviceName}' v${serviceVersion}:\n` +
+            `  expected: ${expectedId}\n` +
+            `  actual:   ${actualId}\n` +
+            `This usually means the service definition changed without updating the manifest.`);
+        this.serviceName = serviceName;
+        this.serviceVersion = serviceVersion;
+        this.expectedId = expectedId;
+        this.actualId = actualId;
+        this.name = 'FatalContractMismatch';
+    }
+}
+/** Verify that a contract ID matches the manifest. Throws on mismatch. */
+export function verifyManifestOrFatal(manifest, actualContractId) {
+    if (manifest.contractId !== actualContractId) {
+        throw new FatalContractMismatch(manifest.service, manifest.version, manifest.contractId, actualContractId);
+    }
+}
+/** Serialize a manifest to JSON. */
+export function manifestToJson(manifest) {
+    return JSON.stringify({
+        service: manifest.service,
+        version: manifest.version,
+        contract_id: manifest.contractId,
+        canonical_encoding: manifest.canonicalEncoding,
+        type_count: manifest.typeCount,
+        type_hashes: manifest.typeHashes,
+        method_count: manifest.methodCount,
+        methods: manifest.methods.map(m => ({
+            name: m.name,
+            pattern: m.pattern,
+            request_type: m.requestType,
+            response_type: m.responseType,
+            timeout: m.timeout,
+            idempotent: m.idempotent,
+            fields: m.fields,
+            request_wire_tag: m.requestWireTag,
+            response_wire_tag: m.responseWireTag,
+            response_fields: m.responseFields,
+        })),
+        serialization_modes: manifest.serializationModes,
+        scoped: manifest.scoped,
+        deprecated: manifest.deprecated,
+        semver: manifest.semver,
+    }, null, 2);
+}
+/**
+ * Extract method descriptors from a manifest for introspection.
+ * Returns a simplified record of method name → pattern.
+ */
+export function extractMethodDescriptors(manifest) {
+    const result = {};
+    for (const method of manifest.methods) {
+        result[method.name] = method.pattern ?? 'unary';
+    }
+    return result;
+}
+/**
+ * Save a manifest to a JSON file.
+ */
+export function saveManifest(manifest, filePath) {
+    const { writeFileSync } = require('node:fs');
+    writeFileSync(filePath, manifestToJson(manifest), 'utf-8');
+}
+/** Parse a manifest from JSON. */
+export function manifestFromJson(json) {
+    const data = JSON.parse(json);
+    // Validate limits
+    const methods = data.methods ?? [];
+    if (methods.length > MAX_MANIFEST_METHODS) {
+        throw new Error(`manifest has ${methods.length} methods, max is ${MAX_MANIFEST_METHODS}`);
+    }
+    const typeHashes = data.type_hashes ?? [];
+    if (typeHashes.length > MAX_MANIFEST_TYPE_HASHES) {
+        throw new Error(`manifest has ${typeHashes.length} type hashes, max is ${MAX_MANIFEST_TYPE_HASHES}`);
+    }
+    // Coerce version to number
+    const version = typeof data.version === 'string' ? parseInt(data.version, 10) : data.version;
+    return {
+        service: data.service,
+        version,
+        contractId: data.contract_id,
+        canonicalEncoding: data.canonical_encoding ?? 'fory-xlang/0.15',
+        typeCount: data.type_count ?? 0,
+        typeHashes,
+        methodCount: data.method_count ?? methods.length,
+        methods: methods.map((m) => ({
+            name: m.name,
+            pattern: m.pattern,
+            requestType: m.request_type ?? '',
+            responseType: m.response_type ?? '',
+            timeout: m.timeout ?? 0,
+            idempotent: m.idempotent ?? false,
+            fields: m.fields ?? [],
+            requestWireTag: m.request_wire_tag,
+            responseWireTag: m.response_wire_tag,
+            responseFields: m.response_fields,
+        })),
+        serializationModes: data.serialization_modes ?? [],
+        scoped: data.scoped ?? 'shared',
+        deprecated: data.deprecated ?? false,
+        semver: data.semver,
+        vcsRevision: data.vcs_revision,
+        vcsTag: data.vcs_tag,
+        vcsUrl: data.vcs_url,
+        changelog: data.changelog,
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/contract/manifest.js.map

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

package/dist/contract/publication.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Contract publication — write contracts to registry doc + blob store.
+ *
+ * Spec reference: Aster-ContractIdentity.md S11.4
+ *
+ * On server startup, each service's contract is:
+ * 1. Serialized to canonical bytes
+ * 2. Stored as a blob collection (contract.bin + manifest.json)
+ * 3. Referenced in the registry doc via an ArtifactRef
+ */
+import { type ContractManifest } from './manifest.js';
+/** Reference to a contract artifact in the blob store. */
+export interface ArtifactRef {
+    contractId: string;
+    collectionHash: string;
+    collectionTicket: string;
+}
+/**
+ * Build a collection of contract artifacts for blob storage.
+ *
+ * Returns a list of [name, data] pairs suitable for upload:
+ * - "manifest.json" — human/machine-readable contract metadata
+ * - "contract.bin" — canonical XLANG bytes (for hash verification)
+ *
+ * @param manifest - The contract manifest
+ * @param canonicalBytes - The canonical XLANG bytes of the ServiceContract
+ */
+export declare function buildCollection(manifest: ContractManifest, canonicalBytes: Uint8Array): [name: string, data: Uint8Array][];
+/**
+ * Upload a pre-built collection of [name, data] entries to the blob store
+ * as a native iroh HashSeq collection. GC protection is handled automatically.
+ * Returns the collection hash.
+ */
+export declare function uploadCollection(blobsClient: {
+    addCollection(entries: [string, Uint8Array][]): Promise<string>;
+}, entries: [name: string, data: Uint8Array][]): Promise<string>;
+/**
+ * Fetch a collection from the blob store by hash using native HashSeq.
+ * Returns [name, data] pairs.
+ */
+export declare function fetchFromCollection(blobsClient: {
+    listCollection(hash: string): Promise<Array<{
+        name: string;
+        hash: string;
+        size: number;
+    }>>;
+    read(hash: string): Promise<Uint8Array>;
+}, collectionHash: string): Promise<[name: string, data: Uint8Array][]>;
+/**
+ * Fetch a contract manifest from the blob store by its collection hash.
+ */
+export declare function fetchContract(blobsClient: {
+    listCollection(hash: string): Promise<Array<{
+        name: string;
+        hash: string;
+        size: number;
+    }>>;
+    read(hash: string): Promise<Uint8Array>;
+}, collectionHash: string): Promise<ContractManifest>;
+/**
+ * Publish a contract collection to the blob store.
+ *
+ * This is the high-level function called by AsterServer on startup.
+ * It takes a BlobsClient (from NAPI), uploads the collection, and
+ * returns an ArtifactRef.
+ */
+export declare function publishContract(blobsClient: {
+    addCollection(entries: [string, Uint8Array][]): Promise<string>;
+    createCollectionTicket(hash: string): string;
+}, manifest: ContractManifest, canonicalBytes?: Uint8Array): Promise<ArtifactRef>;
+//# sourceMappingURL=publication.d.ts.map

package/dist/contract/publication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../../src/contract/publication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,gBAAgB,EAAkB,MAAM,eAAe,CAAC;AAGtE,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,UAAU,GACzB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAcpC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE;IAAE,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,EAChF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,GAC1C,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE;IAAE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE,EACpJ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAQ7C;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE;IAAE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE,EACpJ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE;IAAE,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC9H,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,CAAC,EAAE,UAAU,GAC1B,OAAO,CAAC,WAAW,CAAC,CAWtB"}

package/dist/contract/publication.js

@@ -0,0 +1,85 @@
+/**
+ * Contract publication — write contracts to registry doc + blob store.
+ *
+ * Spec reference: Aster-ContractIdentity.md S11.4
+ *
+ * On server startup, each service's contract is:
+ * 1. Serialized to canonical bytes
+ * 2. Stored as a blob collection (contract.bin + manifest.json)
+ * 3. Referenced in the registry doc via an ArtifactRef
+ */
+import { manifestToJson } from './manifest.js';
+import { MAX_COLLECTION_INDEX_ENTRIES } from '../limits.js';
+/**
+ * Build a collection of contract artifacts for blob storage.
+ *
+ * Returns a list of [name, data] pairs suitable for upload:
+ * - "manifest.json" — human/machine-readable contract metadata
+ * - "contract.bin" — canonical XLANG bytes (for hash verification)
+ *
+ * @param manifest - The contract manifest
+ * @param canonicalBytes - The canonical XLANG bytes of the ServiceContract
+ */
+export function buildCollection(manifest, canonicalBytes) {
+    const encoder = new TextEncoder();
+    const manifestJson = manifestToJson(manifest);
+    const entries = [
+        ['manifest.json', encoder.encode(manifestJson)],
+        ['contract.bin', canonicalBytes],
+    ];
+    if (entries.length > MAX_COLLECTION_INDEX_ENTRIES) {
+        throw new Error(`collection has ${entries.length} entries, max is ${MAX_COLLECTION_INDEX_ENTRIES}`);
+    }
+    return entries;
+}
+/**
+ * Upload a pre-built collection of [name, data] entries to the blob store
+ * as a native iroh HashSeq collection. GC protection is handled automatically.
+ * Returns the collection hash.
+ */
+export async function uploadCollection(blobsClient, entries) {
+    return blobsClient.addCollection(entries);
+}
+/**
+ * Fetch a collection from the blob store by hash using native HashSeq.
+ * Returns [name, data] pairs.
+ */
+export async function fetchFromCollection(blobsClient, collectionHash) {
+    const collectionEntries = await blobsClient.listCollection(collectionHash);
+    const entries = [];
+    for (const { name, hash } of collectionEntries) {
+        const data = await blobsClient.read(hash);
+        entries.push([name, data]);
+    }
+    return entries;
+}
+/**
+ * Fetch a contract manifest from the blob store by its collection hash.
+ */
+export async function fetchContract(blobsClient, collectionHash) {
+    const { manifestFromJson } = await import('./manifest.js');
+    const entries = await fetchFromCollection(blobsClient, collectionHash);
+    const manifestEntry = entries.find(([name]) => name === 'manifest.json');
+    if (!manifestEntry)
+        throw new Error('collection does not contain manifest.json');
+    return manifestFromJson(new TextDecoder().decode(manifestEntry[1]));
+}
+/**
+ * Publish a contract collection to the blob store.
+ *
+ * This is the high-level function called by AsterServer on startup.
+ * It takes a BlobsClient (from NAPI), uploads the collection, and
+ * returns an ArtifactRef.
+ */
+export async function publishContract(blobsClient, manifest, canonicalBytes) {
+    // Build collection entries and upload as native HashSeq
+    const entries = buildCollection(manifest, canonicalBytes ?? new Uint8Array());
+    const collectionHash = await blobsClient.addCollection(entries);
+    const ticket = blobsClient.createCollectionTicket(collectionHash);
+    return {
+        contractId: manifest.contractId,
+        collectionHash,
+        collectionTicket: ticket,
+    };
+}
+//# sourceMappingURL=publication.js.map

package/dist/contract/publication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication.js","sourceRoot":"","sources":["../../src/contract/publication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAyB,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAS5D;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA0B,EAC1B,cAA0B;IAE1B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE9C,MAAM,OAAO,GAA2B;QACtC,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC,cAAc,EAAE,cAAc,CAAC;KACjC,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,GAAG,4BAA4B,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,MAAM,oBAAoB,4BAA4B,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAgF,EAChF,OAA2C;IAE3C,OAAO,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAoJ,EACpJ,cAAsB;IAEtB,MAAM,iBAAiB,GAAG,MAAM,WAAW,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAC3E,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,iBAAiB,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAoJ,EACpJ,cAAsB;IAEtB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IACzE,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACjF,OAAO,gBAAgB,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAA8H,EAC9H,QAA0B,EAC1B,cAA2B;IAE3B,wDAAwD;IACxD,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,cAAc,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC;IAC9E,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,WAAW,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAElE,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,cAAc;QACd,gBAAgB,EAAE,MAAM;KACzB,CAAC;AACJ,CAAC"}