@aster-rpc/aster 0.1.2

package/dist/registry/models.js

@@ -0,0 +1,35 @@
+/**
+ * Registry data models.
+ *
+ * Mirrors bindings/python/aster/registry/models.py.
+ */
+/** Endpoint health status. */
+export const HealthStatus = {
+    STARTING: 'starting',
+    READY: 'ready',
+    DEGRADED: 'degraded',
+    DRAINING: 'draining',
+};
+/** Validate that a string is a valid HealthStatus value. */
+export function validate(value) {
+    return Object.values(HealthStatus).includes(value);
+}
+/** Gossip event types. */
+export const GossipEventType = {
+    CONTRACT_PUBLISHED: 0,
+    CHANNEL_UPDATED: 1,
+    ENDPOINT_LEASE_UPSERTED: 2,
+    ENDPOINT_DOWN: 3,
+    ACL_CHANGED: 4,
+    COMPATIBILITY_PUBLISHED: 5,
+};
+/** Check if a lease is fresh (not expired). */
+export function isLeaseFresh(lease, leaseDurationS = 45) {
+    return lease.leaseExpiresEpochMs > Date.now() ||
+        lease.updatedAtEpochMs + leaseDurationS * 1000 > Date.now();
+}
+/** Check if a lease is routable (ready + fresh). */
+export function isLeaseRoutable(lease) {
+    return lease.healthStatus === HealthStatus.READY && isLeaseFresh(lease);
+}
+//# sourceMappingURL=models.js.map

package/dist/registry/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/registry/models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX,4DAA4D;AAC5D,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AACrE,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kBAAkB,EAAE,CAAC;IACrB,eAAe,EAAE,CAAC;IAClB,uBAAuB,EAAE,CAAC;IAC1B,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,uBAAuB,EAAE,CAAC;CAClB,CAAC;AA8CX,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,cAAc,GAAG,EAAE;IACpE,OAAO,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE;QAC3C,KAAK,CAAC,gBAAgB,GAAG,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAChE,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,OAAO,KAAK,CAAC,YAAY,KAAK,YAAY,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/registry/publisher.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Registry publisher — publishes contracts and manages endpoint leases.
+ *
+ * Mirrors bindings/python/aster/registry/publisher.py.
+ */
+import type { ArtifactRef, EndpointLease, HealthStatus } from './models.js';
+/** Doc handle interface (matches NAPI DocHandle). */
+interface PublisherDoc {
+    setBytes(authorHex: string, key: string, value: Uint8Array): Promise<string>;
+}
+/** Gossip broadcaster interface. */
+interface GossipBroadcaster {
+    broadcast(data: Uint8Array): Promise<void>;
+}
+/** Options for the registry publisher. */
+export interface RegistryPublisherOptions {
+    doc: PublisherDoc;
+    authorId: string;
+    endpointId: string;
+    gossip?: GossipBroadcaster;
+    logger?: {
+        info(...args: any[]): void;
+        error(...args: any[]): void;
+    };
+}
+/**
+ * Registry publisher — publishes contracts and manages endpoint leases.
+ */
+export declare class RegistryPublisher {
+    private doc;
+    private authorId;
+    private endpointId;
+    private gossip?;
+    private logger;
+    private leases;
+    private refreshTimer?;
+    constructor(opts: RegistryPublisherOptions);
+    /**
+     * Publish a contract artifact to the registry.
+     */
+    publishContract(artifact: ArtifactRef, serviceName: string, version: number): Promise<void>;
+    /**
+     * Register an endpoint lease for a service.
+     */
+    registerEndpoint(serviceName: string, version: number, contractId: string, opts?: {
+        alpn?: string;
+        serializationModes?: string[];
+        leaseDurationMs?: number;
+        refreshIntervalMs?: number;
+    }): Promise<EndpointLease>;
+    /**
+     * Set health status for a registered endpoint.
+     */
+    setHealth(serviceName: string, contractId: string, status: HealthStatus): Promise<void>;
+    /**
+     * Withdraw an endpoint (graceful shutdown).
+     */
+    withdraw(serviceName: string, contractId: string, graceMs?: number): Promise<void>;
+    /** Stop all refresh timers. */
+    close(): void;
+    private writeLease;
+    private refreshLeases;
+}
+export {};
+//# sourceMappingURL=publisher.d.ts.map

package/dist/registry/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../src/registry/publisher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI5E,qDAAqD;AACrD,UAAU,YAAY;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9E;AAED,oCAAoC;AACpC,UAAU,iBAAiB;IACzB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,YAAY,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;CACtE;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAoB;IACnC,OAAO,CAAC,MAAM,CAA8D;IAC5E,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,IAAI,EAAE,wBAAwB;IAQ1C;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjG;;OAEG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GACA,OAAO,CAAC,aAAa,CAAC;IAkCzB;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7F;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtF,+BAA+B;IAC/B,KAAK,IAAI,IAAI;YASC,UAAU;YAmBV,aAAa;CAS5B"}

package/dist/registry/publisher.js

@@ -0,0 +1,164 @@
+/**
+ * Registry publisher — publishes contracts and manages endpoint leases.
+ *
+ * Mirrors bindings/python/aster/registry/publisher.py.
+ */
+import { HealthStatus as HS } from './models.js';
+import { contractKey, versionKey, leaseKey } from './keys.js';
+/**
+ * Registry publisher — publishes contracts and manages endpoint leases.
+ */
+export class RegistryPublisher {
+    doc;
+    authorId;
+    endpointId;
+    gossip;
+    logger;
+    leases = new Map();
+    refreshTimer;
+    constructor(opts) {
+        this.doc = opts.doc;
+        this.authorId = opts.authorId;
+        this.endpointId = opts.endpointId;
+        this.gossip = opts.gossip;
+        this.logger = opts.logger ?? console;
+    }
+    /**
+     * Publish a contract artifact to the registry.
+     */
+    async publishContract(artifact, serviceName, version) {
+        const encoder = new TextEncoder();
+        // Write artifact to contracts/{contract_id}
+        const artifactJson = JSON.stringify(artifact);
+        await this.doc.setBytes(this.authorId, contractKey(artifact.contractId), encoder.encode(artifactJson));
+        // Write version pointer
+        await this.doc.setBytes(this.authorId, versionKey(serviceName, version), encoder.encode(artifact.contractId));
+        this.logger.info('published contract', {
+            service: serviceName,
+            version,
+            contractId: artifact.contractId.slice(0, 16),
+        });
+        // Broadcast gossip event
+        if (this.gossip) {
+            const event = {
+                type: 0, // CONTRACT_PUBLISHED
+                service: serviceName,
+                version,
+                contractId: artifact.contractId,
+                timestampMs: Date.now(),
+            };
+            await this.gossip.broadcast(encoder.encode(JSON.stringify(event)));
+        }
+    }
+    /**
+     * Register an endpoint lease for a service.
+     */
+    async registerEndpoint(serviceName, version, contractId, opts) {
+        const now = Date.now();
+        const leaseDurationMs = opts?.leaseDurationMs ?? 45_000;
+        const lease = {
+            endpointId: this.endpointId,
+            contractId,
+            service: serviceName,
+            version,
+            leaseExpiresEpochMs: now + leaseDurationMs,
+            leaseSeq: 0,
+            alpn: opts?.alpn ?? 'aster/1',
+            serializationModes: opts?.serializationModes ?? ['xlang'],
+            featureFlags: [],
+            directAddrs: [],
+            healthStatus: HS.STARTING,
+            tags: [],
+            updatedAtEpochMs: now,
+        };
+        await this.writeLease(lease);
+        this.leases.set(`${serviceName}/${contractId}`, lease);
+        // Start refresh timer
+        const refreshMs = opts?.refreshIntervalMs ?? leaseDurationMs * 0.8;
+        this.refreshTimer = setInterval(() => {
+            this.refreshLeases().catch(e => {
+                this.logger.error('lease refresh error', { error: String(e) });
+            });
+        }, refreshMs);
+        return lease;
+    }
+    /**
+     * Set health status for a registered endpoint.
+     */
+    async setHealth(serviceName, contractId, status) {
+        const key = `${serviceName}/${contractId}`;
+        const lease = this.leases.get(key);
+        if (!lease)
+            throw new Error(`no lease for ${key}`);
+        lease.healthStatus = status;
+        lease.leaseSeq++;
+        lease.updatedAtEpochMs = Date.now();
+        lease.leaseExpiresEpochMs = Date.now() + 45_000;
+        await this.writeLease(lease);
+    }
+    /**
+     * Withdraw an endpoint (graceful shutdown).
+     */
+    async withdraw(serviceName, contractId, graceMs = 5000) {
+        const key = `${serviceName}/${contractId}`;
+        const lease = this.leases.get(key);
+        if (!lease)
+            return;
+        // Set draining
+        await this.setHealth(serviceName, contractId, HS.DRAINING);
+        // Grace period
+        await new Promise(r => setTimeout(r, graceMs));
+        // Write tombstone
+        const encoder = new TextEncoder();
+        const docKey = leaseKey(serviceName, contractId, this.endpointId);
+        await this.doc.setBytes(this.authorId, docKey, encoder.encode('null'));
+        // Broadcast endpoint down
+        if (this.gossip) {
+            const event = {
+                type: 3, // ENDPOINT_DOWN
+                service: serviceName,
+                endpointId: this.endpointId,
+                timestampMs: Date.now(),
+            };
+            await this.gossip.broadcast(encoder.encode(JSON.stringify(event)));
+        }
+        this.leases.delete(key);
+        this.logger.info('withdrew endpoint', { service: serviceName });
+    }
+    /** Stop all refresh timers. */
+    close() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = undefined;
+        }
+    }
+    // -- Helpers --
+    async writeLease(lease) {
+        const encoder = new TextEncoder();
+        const key = leaseKey(lease.service, lease.contractId, lease.endpointId);
+        await this.doc.setBytes(this.authorId, key, encoder.encode(JSON.stringify(lease)));
+        // Broadcast gossip event
+        if (this.gossip) {
+            const event = {
+                type: 2, // ENDPOINT_LEASE_UPSERTED
+                service: lease.service,
+                version: lease.leaseSeq,
+                contractId: lease.contractId,
+                endpointId: lease.endpointId,
+                timestampMs: Date.now(),
+            };
+            await this.gossip.broadcast(encoder.encode(JSON.stringify(event)));
+        }
+    }
+    async refreshLeases() {
+        for (const lease of this.leases.values()) {
+            if (lease.healthStatus === HS.DRAINING)
+                continue;
+            lease.leaseSeq++;
+            lease.leaseExpiresEpochMs = Date.now() + 45_000;
+            lease.updatedAtEpochMs = Date.now();
+            await this.writeLease(lease);
+        }
+    }
+}
+//# sourceMappingURL=publisher.js.map

package/dist/registry/publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.js","sourceRoot":"","sources":["../../src/registry/publisher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,IAAI,EAAE,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAqB9D;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,GAAG,CAAe;IAClB,QAAQ,CAAS;IACjB,UAAU,CAAS;IACnB,MAAM,CAAqB;IAC3B,MAAM,CAA8D;IACpE,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC1C,YAAY,CAAkC;IAEtD,YAAY,IAA8B;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAqB,EAAE,WAAmB,EAAE,OAAe;QAC/E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAElC,4CAA4C;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAEvG,wBAAwB;QACxB,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAE9G,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;YACrC,OAAO,EAAE,WAAW;YACpB,OAAO;YACP,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,yBAAyB;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,CAAC,EAAE,qBAAqB;gBAC9B,OAAO,EAAE,WAAW;gBACpB,OAAO;gBACP,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAC;YACF,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,WAAmB,EACnB,OAAe,EACf,UAAkB,EAClB,IAKC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,IAAI,MAAM,CAAC;QAExD,MAAM,KAAK,GAAkB;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU;YACV,OAAO,EAAE,WAAW;YACpB,OAAO;YACP,mBAAmB,EAAE,GAAG,GAAG,eAAe;YAC1C,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,SAAS;YAC7B,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,IAAI,CAAC,OAAO,CAAC;YACzD,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE,CAAC,QAAQ;YACzB,IAAI,EAAE,EAAE;YACR,gBAAgB,EAAE,GAAG;SACtB,CAAC;QAEF,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,IAAI,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;QAEvD,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,EAAE,iBAAiB,IAAI,eAAe,GAAG,GAAG,CAAC;QACnE,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,WAAmB,EAAE,UAAkB,EAAE,MAAoB;QAC3E,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;QAEnD,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC;QAC5B,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QAEhD,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,WAAmB,EAAE,UAAkB,EAAE,OAAO,GAAG,IAAI;QACpE,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,eAAe;QACf,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;QAE3D,eAAe;QACf,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAE/C,kBAAkB;QAClB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAClE,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAEvE,0BAA0B;QAC1B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,CAAC,EAAE,gBAAgB;gBACzB,OAAO,EAAE,WAAW;gBACpB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAC;YACF,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACH,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC;IACH,CAAC;IAED,gBAAgB;IAER,KAAK,CAAC,UAAU,CAAC,KAAoB;QAC3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEnF,yBAAyB;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,CAAC,EAAE,0BAA0B;gBACnC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,QAAQ;gBACvB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAC;YACF,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,QAAQ;gBAAE,SAAS;YACjD,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjB,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;YAChD,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}

package/dist/runtime.d.ts

@@ -0,0 +1,267 @@
+/**
+ * High-level AsterServer and AsterClient wrappers.
+ *
+ * These provide one-liner setup for the common case, hiding the
+ * details of endpoint creation, admission, and transport wiring.
+ */
+import { ServiceRegistry } from './service.js';
+import { LocalTransport } from './transport/local.js';
+import { type AsterClient as ClientProxy } from './client.js';
+import type { AsterTransport } from './transport/base.js';
+import type { AsterConfig } from './config.js';
+import { type AsterLogger } from './logging.js';
+import { type ExponentialBackoff } from './types.js';
+import { type ServiceSummary } from './trust/consumer.js';
+/**
+ * Raised when a consumer is refused by the server's admission check.
+ *
+ * The server never reveals *why* admission failed (no oracle leak), so this
+ * error enumerates the common causes as a hint to the user rather than a
+ * precise diagnosis. Its `message` is a multi-line actionable hint suitable
+ * for direct CLI output.
+ */
+export declare class AdmissionDeniedError extends Error {
+    readonly hadCredential: boolean;
+    readonly credentialFile: string | null;
+    readonly ourEndpointId: string;
+    readonly serverAddress: string;
+    constructor(opts: {
+        hadCredential: boolean;
+        credentialFile: string | null;
+        ourEndpointId: string;
+        serverAddress: string;
+    });
+}
+/** Options for AsterServer. */
+export interface AsterServerOptions {
+    services: object[];
+    config?: Partial<AsterConfig>;
+    /** Path to .aster-identity file. Overrides config.identityFile. */
+    identity?: string;
+    /** Peer name for identity file lookup. */
+    peer?: string;
+    /** Allow all consumers without credentials (dev mode). Default: true. */
+    allowAllConsumers?: boolean;
+    interceptors?: unknown[];
+}
+/**
+ * High-level Aster RPC server.
+ *
+ * Creates an IrohNode, serves RPC over QUIC, handles consumer admission,
+ * and prints a startup banner.
+ *
+ * @example
+ * ```ts
+ * const server = new AsterServer({
+ *   services: [new MissionControl()],
+ * });
+ * await server.start();
+ * console.log(server.address);
+ * await server.serve();
+ * ```
+ */
+export declare class AsterServer {
+    readonly registry: ServiceRegistry;
+    readonly config: AsterConfig;
+    readonly logger: AsterLogger;
+    private health;
+    private _node;
+    private _rpcServer;
+    private _hook;
+    private _peerStore;
+    private _delegationPolicies;
+    private _running;
+    private _closed;
+    private _allowAllConsumers;
+    private _userInterceptors;
+    private _signalHandlers;
+    private _serviceSummaries;
+    private _registryNamespace;
+    private _servePromise;
+    private _admissionAbort;
+    constructor(opts: AsterServerOptions);
+    /**
+     * Create the IrohNode and prepare for serving. Idempotent.
+     */
+    start(): Promise<void>;
+    /**
+     * Create a registry doc and publish each service's contract.
+     *
+     * After publication, `_registryNamespace` is set to the 64-char hex
+     * namespace ID so the admission response can return it.
+     *
+     * Non-fatal: if publication fails, the server still works — consumers
+     * just won't get rich contract metadata.
+     */
+    private _publishContracts;
+    /**
+     * Build a ContractManifest from a ServiceInfo with field-level detail.
+     */
+    private _buildManifest;
+    /**
+     * Start accepting connections. Blocks until close() is called.
+     */
+    serve(): Promise<void>;
+    /**
+     * Run the Gate 0 hook loop.
+     *
+     * Polls after_handshake events from the native receiver and dispatches
+     * each one through MeshEndpointHook.shouldAllow(). After-handshake fires
+     * for **all** connections (inbound and outbound) right after TLS, which
+     * is exactly when we want to enforce the admitted-set check.
+     *
+     * NOTE: We do NOT use before_connect — that fires only for *outgoing*
+     * connections in iroh, so it would miss incoming RPC connections to
+     * the server (which is what we need to gate).
+     *
+     * The native binding uses an event-id + respond-by-id API; this loop
+     * polls events directly and responds via respondAfterHandshake().
+     */
+    private _runGate0;
+    /**
+     * Stop accepting connections and close the node.
+     */
+    close(): Promise<void>;
+    /** The aster1... connection address for clients. */
+    get address(): string;
+    /** Hex endpoint ID of this server's node. */
+    get endpointId(): string;
+    /** Whether the server is running. */
+    get running(): boolean;
+    /** List of services hosted by this server. */
+    get services(): ServiceSummary[];
+    /** Create a local in-process transport for testing. */
+    localTransport(): LocalTransport;
+    /**
+     * Single accept loop with ALPN-based routing.
+     *
+     * All aster ALPNs (RPC, consumer admission, delegated admission) are
+     * multiplexed through one channel. This loop reads the ALPN tag and
+     * dispatches to the correct handler — matching Python's `_accept_loop`.
+     */
+    private _acceptLoop;
+    private _handleAdmission;
+    private _handleProducerAdmission;
+    private _resolveRootPubkeyHex;
+    private _handleDelegatedAdmission;
+    private _installSignalHandlers;
+    private _printBanner;
+}
+/** Options for AsterClient. */
+export interface AsterClientOptions {
+    /** Connection address (aster1... ticket, base64 NodeAddr, or hex EndpointId). */
+    address?: string;
+    /** @deprecated Use `address` instead. */
+    endpointAddr?: string;
+    transport?: AsterTransport;
+    config?: Partial<AsterConfig>;
+    /** Path to .aster-identity file. Overrides config.identityFile. */
+    identity?: string;
+    /** Peer name for identity file lookup. */
+    peer?: string;
+    /** Path to a pre-signed enrollment credential file (.cred JSON or .aster-identity TOML). */
+    enrollmentCredentialFile?: string;
+    /** Retry configuration for reconnection. */
+    retryBackoff?: ExponentialBackoff;
+}
+/**
+ * High-level Aster RPC client.
+ *
+ * Wraps connection setup, admission, and client stub creation.
+ * Supports reconnection with exponential backoff.
+ */
+export declare class AsterClientWrapper {
+    private transport;
+    readonly config: AsterConfig;
+    private backoff;
+    private _connected;
+    private _gossipTopic;
+    private _address;
+    private _node;
+    private _services;
+    private _registryNamespace;
+    private _inlineCredential;
+    private _enrollmentCredentialFile;
+    private _identitySecretKey;
+    constructor(opts: AsterClientOptions);
+    /** Whether the client is connected. */
+    get connected(): boolean;
+    /** Services discovered during admission. */
+    get services(): ServiceSummary[];
+    /** Registry namespace ID for service discovery (set after admission). */
+    get registryNamespace(): string | undefined;
+    /** Hex-encoded 32-byte gossip topic ID for the producer mesh. */
+    get gossipTopic(): string;
+    /**
+     * Connect to the server via consumer admission, then open an RPC transport.
+     *
+     * If the client was created with a transport, this is a no-op.
+     * If created with an address, it performs the full admission handshake.
+     */
+    connect(): Promise<void>;
+    /** Create a typed client proxy for a service class. */
+    client<T extends new (...args: any[]) => any>(serviceClass: T): Promise<ClientProxy<InstanceType<T>>>;
+    /** Create a typed client proxy for a service class. */
+    service<T extends new (...args: any[]) => any>(serviceClass: T): ClientProxy<InstanceType<T>>;
+    /**
+     * Create a dynamic proxy client for a service.
+     *
+     * @example
+     * ```ts
+     * const mc = client.proxy("MissionControl");
+     * const result = await mc.getStatus({ agentId: "edge-1" });
+     * console.log(result.status);
+     * ```
+     */
+    proxy(serviceName: string): ProxyClient;
+    /** Reconnect with exponential backoff. */
+    reconnect(connectFn: () => Promise<AsterTransport>, maxAttempts?: number): Promise<void>;
+    /** Close the client and underlying transport. */
+    close(): Promise<void>;
+}
+/**
+ * Dynamic proxy client -- invokes RPC methods without local type definitions.
+ *
+ * Created via `AsterClientWrapper.proxy("ServiceName")`. Supports all four
+ * RPC patterns:
+ *
+ * ```ts
+ * const mc = client.proxy("MissionControl");
+ *
+ * // Unary
+ * const status = await mc.getStatus({ agent_id: "edge-7" });
+ *
+ * // Client streaming — pass an async iterable
+ * const result = await mc.ingestMetrics(asyncGenerator());
+ *
+ * // Server streaming — use .stream()
+ * for await (const entry of mc.tailLogs.stream({ level: "info" })) { ... }
+ *
+ * // Bidi streaming — use .bidi()
+ * const ch = mc.runCommand.bidi();
+ * await ch.open();
+ * await ch.send({ command: "ls" });
+ * for await (const r of ch) { ... }
+ * ```
+ */
+export declare class ProxyClient {
+    private readonly serviceName;
+    private readonly transport;
+    constructor(serviceName: string, transport: AsterTransport);
+}
+/**
+ * Lazy bidi-stream wrapper used by ProxyClient. Opens the underlying
+ * transport channel on first .open() / .send() / iteration.
+ */
+export declare class ProxyBidiChannel {
+    private readonly serviceName;
+    private readonly methodName;
+    private readonly transport;
+    private _channel;
+    constructor(serviceName: string, methodName: string, transport: AsterTransport);
+    open(): Promise<void>;
+    send(payload: unknown): Promise<void>;
+    close(): Promise<void>;
+    [Symbol.asyncIterator](): AsyncIterator<unknown>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAgB,KAAK,WAAW,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAyC,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG5F,OAAO,EAAmF,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAuB3I;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,IAAI,EAAE;QAChB,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB;CAoCF;AAID,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,iBAAiB,CAAwB;IACjD,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,eAAe,CAAgC;gBAE3C,IAAI,EAAE,kBAAkB;IA6BpC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkG5B;;;;;;;;OAQG;YACW,iBAAiB;IAyF/B;;OAEG;IACH,OAAO,CAAC,cAAc;IA4ItB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B5B;;;;;;;;;;;;;;OAcG;YACW,SAAS;IAiCvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B,oDAAoD;IACpD,IAAI,OAAO,IAAI,MAAM,CAcpB;IAED,6CAA6C;IAC7C,IAAI,UAAU,IAAI,MAAM,CAGvB;IAED,qCAAqC;IACrC,IAAI,OAAO,IAAI,OAAO,CAA0B;IAEhD,8CAA8C;IAC9C,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAwC;IAExE,uDAAuD;IACvD,cAAc,IAAI,cAAc;IAMhC;;;;;;OAMG;YACW,WAAW;YAwCX,gBAAgB;YAwBhB,wBAAwB;IActC,OAAO,CAAC,qBAAqB;YAkBf,yBAAyB;IAWvC,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,YAAY;CAyDrB;AAID,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAgGD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAkB;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,iBAAiB,CAA6C;IACtE,OAAO,CAAC,yBAAyB,CAAqB;IACtD,OAAO,CAAC,kBAAkB,CAA2B;gBAEzC,IAAI,EAAE,kBAAkB;IA4DpC,uCAAuC;IACvC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAgC;IAEhE,yEAAyE;IACzE,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAAiD;IAE5F,iEAAiE;IACjE,IAAI,WAAW,IAAI,MAAM,CAA8B;IAEvD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkG9B,uDAAuD;IACjD,MAAM,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAI3G,uDAAuD;IACvD,OAAO,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,YAAY,EAAE,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI7F;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;IAWvC,0CAA0C;IACpC,SAAS,CACb,SAAS,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,EACxC,WAAW,SAAI,GACd,OAAO,CAAC,IAAI,CAAC;IAiBhB,iDAAiD;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc;CAW7C;AAqDD;;;GAGG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAA0D;gBAGvD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,cAAc;IAGtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC;CAQjD"}