@econ-v1/domain 0.0.0

package/dist/services/lan-candidate-refresh-service.d.ts

@@ -0,0 +1,11 @@
+import type { HomeNodeCandidate, HomeNodeClient, IdentityPort } from "@econ-v1/ports";
+export interface LanCandidateRefreshServiceOptions {
+    readonly identity: IdentityPort;
+    readonly now?: () => string;
+}
+export declare class LanCandidateRefreshService {
+    #private;
+    constructor(options: LanCandidateRefreshServiceOptions);
+    refresh(home: HomeNodeClient): Promise<readonly HomeNodeCandidate[]>;
+}
+//# sourceMappingURL=lan-candidate-refresh-service.d.ts.map

package/dist/services/lan-candidate-refresh-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lan-candidate-refresh-service.d.ts","sourceRoot":"","sources":["../../src/services/lan-candidate-refresh-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACb,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,qBAAa,0BAA0B;;gBAIzB,OAAO,EAAE,iCAAiC;IAKhD,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;CAqB3E"}

package/dist/services/lan-candidate-refresh-service.js

@@ -0,0 +1,32 @@
+import { nodeMetadataCandidates, secureAddresses } from "./peer-directory-service.js";
+export class LanCandidateRefreshService {
+    #identity;
+    #now;
+    constructor(options) {
+        this.#identity = options.identity;
+        this.#now = options.now ?? (() => new Date().toISOString());
+    }
+    async refresh(home) {
+        const metadata = await home.invoke({
+            operation: "GET /api/v2/node/metadata",
+            payload: {},
+        });
+        const current = await this.#identity.loadConnectionMetadata();
+        const refreshed = nodeMetadataCandidates(metadata);
+        const directAddresses = secureAddresses([
+            ...(current?.directAddresses ?? []),
+            ...refreshed.map((candidate) => candidate.address),
+        ]);
+        const next = {
+            directAddresses,
+            lastConnectedAt: this.#now(),
+            ...(current?.relayUrl === undefined ? {} : { relayUrl: current.relayUrl }),
+        };
+        await this.#identity.storeConnectionMetadata(next);
+        const id = refreshed[0]?.id;
+        if (id === undefined)
+            return [];
+        return directAddresses.map((address) => ({ address, id, path: "lan-direct" }));
+    }
+}
+//# sourceMappingURL=lan-candidate-refresh-service.js.map

package/dist/services/lan-candidate-refresh-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lan-candidate-refresh-service.js","sourceRoot":"","sources":["../../src/services/lan-candidate-refresh-service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAyB,MAAM,6BAA6B,CAAC;AAO7G,MAAM,OAAO,0BAA0B;IAC5B,SAAS,CAAe;IACxB,IAAI,CAAe;IAE5B,YAAY,OAA0C;QACpD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAoB;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAmB;YACnD,SAAS,EAAE,2BAA2B;YACtC,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,sBAAsB,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,eAAe,GAAG,eAAe,CAAC;YACtC,GAAG,CAAC,OAAO,EAAE,eAAe,IAAI,EAAE,CAAC;YACnC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC;SACnD,CAAC,CAAC;QACH,MAAM,IAAI,GAA6B;YACrC,eAAe;YACf,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE;YAC5B,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;SAC3E,CAAC;QACF,MAAM,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAqB,EAAE,CAAC,CAAC,CAAC;IAC1F,CAAC;CACF"}

package/dist/services/outbox-service.d.ts

@@ -0,0 +1,47 @@
+import { type OutboxEntry, type OutboxIntentInput } from "../models/outbox.js";
+export interface OutboxPersistence {
+    create(entry: OutboxEntry): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(domain?: string): Promise<readonly OutboxEntry[]>;
+    read(id: string): Promise<OutboxEntry | undefined>;
+    update(entry: OutboxEntry): Promise<void>;
+}
+export interface OutboxServiceOptions {
+    readonly maxAttempts?: number;
+    readonly now?: () => string;
+}
+export interface ClaimOptions {
+    readonly leaseMs?: number;
+    readonly now?: string;
+    readonly revalidateAuthoritative?: () => Promise<boolean>;
+}
+export interface FailureOptions {
+    readonly now?: string;
+    readonly owner?: string;
+    readonly retryable: boolean;
+}
+export declare class OutboxIdempotencyConflictError extends Error {
+    readonly idempotencyKey: string;
+    constructor(idempotencyKey: string);
+}
+export declare class OutboxTransitionError extends Error {
+    constructor(message: string);
+}
+export declare class OutboxRevalidationRequiredError extends OutboxTransitionError {
+    constructor(id: string);
+}
+export declare class OutboxService {
+    #private;
+    constructor(persistence: OutboxPersistence, options?: OutboxServiceOptions);
+    enqueue(input: OutboxIntentInput): Promise<OutboxEntry>;
+    claimNext(domain: string, owner: string, options?: ClaimOptions): Promise<OutboxEntry | undefined>;
+    acknowledge(id: string, owner: string, now?: string): Promise<OutboxEntry>;
+    fail(id: string, reason: string, options: FailureOptions): Promise<OutboxEntry>;
+    conflict(id: string, reason: string, owner?: string, now?: string): Promise<OutboxEntry>;
+    cancel(id: string): Promise<boolean>;
+    recoverExpiredLeases(now?: string, domain?: string): Promise<number>;
+    private requireEntry;
+    private assertInflightOwner;
+    private save;
+}
+//# sourceMappingURL=outbox-service.d.ts.map

package/dist/services/outbox-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-service.d.ts","sourceRoot":"","sources":["../../src/services/outbox-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAGvB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,cAAc,EAAE,MAAM;CAKnC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,+BAAgC,SAAQ,qBAAqB;gBAC5D,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,aAAa;;gBAKZ,WAAW,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB;IASxE,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAavD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IA2BtG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAM/E,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAW/E,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ7F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpC,oBAAoB,CAAC,GAAG,SAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAUjE,YAAY;IAM1B,OAAO,CAAC,mBAAmB;YAMb,IAAI;CAWnB"}

package/dist/services/outbox-service.js

@@ -0,0 +1,151 @@
+import { canonicalOutboxPayload, createOutboxIntent, validateOutboxIntent, } from "../models/outbox.js";
+export class OutboxIdempotencyConflictError extends Error {
+    idempotencyKey;
+    constructor(idempotencyKey) {
+        super("Outbox idempotency key belongs to a different command");
+        this.name = "OutboxIdempotencyConflictError";
+        this.idempotencyKey = idempotencyKey;
+    }
+}
+export class OutboxTransitionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OutboxTransitionError";
+    }
+}
+export class OutboxRevalidationRequiredError extends OutboxTransitionError {
+    constructor(id) {
+        super(`Authoritative outbox intent ${id} requires fresh-state revalidation`);
+        this.name = "OutboxRevalidationRequiredError";
+    }
+}
+export class OutboxService {
+    #maxAttempts;
+    #now;
+    #persistence;
+    constructor(persistence, options = {}) {
+        this.#maxAttempts = options.maxAttempts ?? 3;
+        if (!Number.isInteger(this.#maxAttempts) || this.#maxAttempts < 1) {
+            throw new RangeError("Outbox maxAttempts must be a positive integer");
+        }
+        this.#now = options.now ?? (() => new Date().toISOString());
+        this.#persistence = persistence;
+    }
+    async enqueue(input) {
+        const entry = createOutboxIntent(input, { maxAttempts: this.#maxAttempts, now: this.#now() });
+        const existing = (await this.#persistence.list()).find((candidate) => candidate.idempotencyKey === entry.idempotencyKey);
+        if (existing !== undefined) {
+            if (sameCommand(existing, entry))
+                return existing;
+            throw new OutboxIdempotencyConflictError(entry.idempotencyKey);
+        }
+        await this.#persistence.create(entry);
+        return entry;
+    }
+    async claimNext(domain, owner, options = {}) {
+        requireNonEmpty(owner, "lease owner");
+        const now = options.now ?? this.#now();
+        await this.recoverExpiredLeases(now, domain);
+        const entries = [...await this.#persistence.list(domain)].sort(compareEntries);
+        for (const entry of entries) {
+            if (isTerminal(entry.state))
+                continue;
+            if (entry.state === "inflight")
+                return undefined;
+            if (entry.authority === "authoritative") {
+                if (options.revalidateAuthoritative === undefined || !await options.revalidateAuthoritative()) {
+                    throw new OutboxRevalidationRequiredError(entry.id);
+                }
+            }
+            const claimed = validateOutboxIntent({
+                ...entry,
+                attemptCount: entry.attemptCount + 1,
+                lease: { expiresAt: new Date(Date.parse(now) + (options.leaseMs ?? 30_000)).toISOString(), owner },
+                state: "inflight",
+                updatedAt: now,
+            });
+            if (claimed.lease === undefined)
+                throw new OutboxTransitionError("Failed to create outbox lease");
+            await this.#persistence.update(claimed);
+            return claimed;
+        }
+        return undefined;
+    }
+    async acknowledge(id, owner, now = this.#now()) {
+        const current = await this.requireEntry(id);
+        this.assertInflightOwner(current, owner);
+        return await this.save(current, { lease: undefined, state: "acked", updatedAt: now });
+    }
+    async fail(id, reason, options) {
+        requireNonEmpty(reason, "failure reason");
+        const current = await this.requireEntry(id);
+        if (options.owner !== undefined)
+            this.assertInflightOwner(current, options.owner);
+        else if (current.state !== "inflight")
+            throw new OutboxTransitionError(`Outbox intent ${id} is not inflight`);
+        const terminal = !options.retryable || current.attemptCount >= current.maxAttempts;
+        return await this.save(current, terminal
+            ? { lease: undefined, state: "failed", terminalReason: reason, updatedAt: options.now ?? this.#now() }
+            : { lease: undefined, state: "pending", updatedAt: options.now ?? this.#now() });
+    }
+    async conflict(id, reason, owner, now = this.#now()) {
+        requireNonEmpty(reason, "conflict reason");
+        const current = await this.requireEntry(id);
+        if (owner !== undefined)
+            this.assertInflightOwner(current, owner);
+        else if (current.state !== "inflight")
+            throw new OutboxTransitionError(`Outbox intent ${id} is not inflight`);
+        return await this.save(current, { conflictReason: reason, lease: undefined, state: "conflict", updatedAt: now });
+    }
+    async cancel(id) {
+        const current = await this.#persistence.read(id);
+        if (current === undefined)
+            return false;
+        if (current.state !== "pending")
+            throw new OutboxTransitionError(`Only pending outbox intents can be cancelled: ${id}`);
+        await this.#persistence.delete(id);
+        return true;
+    }
+    async recoverExpiredLeases(now = this.#now(), domain) {
+        let recovered = 0;
+        for (const entry of await this.#persistence.list(domain)) {
+            if (entry.state !== "inflight" || (entry.lease !== undefined && Date.parse(entry.lease.expiresAt) > Date.parse(now)))
+                continue;
+            await this.save(entry, { lease: undefined, state: "pending", updatedAt: now });
+            recovered += 1;
+        }
+        return recovered;
+    }
+    async requireEntry(id) {
+        const entry = await this.#persistence.read(id);
+        if (entry === undefined)
+            throw new OutboxTransitionError(`Outbox intent was not found: ${id}`);
+        return validateOutboxIntent(entry);
+    }
+    assertInflightOwner(entry, owner) {
+        if (entry.state !== "inflight" || entry.lease?.owner !== owner) {
+            throw new OutboxTransitionError(`Outbox lease is not held by ${owner}`);
+        }
+    }
+    async save(current, changes) {
+        const updated = validateOutboxIntent({ ...current, ...changes });
+        await this.#persistence.update(updated);
+        return updated;
+    }
+}
+function compareEntries(left, right) {
+    return left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id);
+}
+function isTerminal(state) {
+    return state === "acked" || state === "failed" || state === "conflict";
+}
+function sameCommand(left, right) {
+    return left.domain === right.domain &&
+        left.authority === right.authority &&
+        canonicalOutboxPayload(left.payload) === canonicalOutboxPayload(right.payload);
+}
+function requireNonEmpty(value, label) {
+    if (value.trim() === "")
+        throw new TypeError(`${label} must be a non-empty string`);
+}
+//# sourceMappingURL=outbox-service.js.map

package/dist/services/outbox-service.js.map

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

package/dist/services/owner-view-service.d.ts

@@ -0,0 +1,10 @@
+import type { FeedItem, FeedQuery, HomeSummary, OperationalSummary, OwnerViewRepository, PeerDirectoryEntry, PeerDirectoryQuery } from "../models/owner-views.js";
+export declare class OwnerViewService {
+    #private;
+    constructor(repository: OwnerViewRepository);
+    readHome(): Promise<readonly HomeSummary[]>;
+    listPeers(params: PeerDirectoryQuery): Promise<readonly PeerDirectoryEntry[]>;
+    listFeed(params: FeedQuery): Promise<readonly FeedItem[]>;
+    readOperational(): Promise<readonly OperationalSummary[]>;
+}
+//# sourceMappingURL=owner-view-service.d.ts.map

package/dist/services/owner-view-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-view-service.d.ts","sourceRoot":"","sources":["../../src/services/owner-view-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC,qBAAa,gBAAgB;;gBAGf,UAAU,EAAE,mBAAmB;IAIrC,QAAQ,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAK3C,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAI7E,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC;IAIzD,eAAe,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;CAIhE"}

package/dist/services/owner-view-service.js

@@ -0,0 +1,21 @@
+export class OwnerViewService {
+    #repository;
+    constructor(repository) {
+        this.#repository = repository;
+    }
+    async readHome() {
+        const summary = await this.#repository.readHomeSummary();
+        return summary === undefined ? [] : [summary];
+    }
+    async listPeers(params) {
+        return await this.#repository.listPeers(params);
+    }
+    async listFeed(params) {
+        return await this.#repository.listFeed(params);
+    }
+    async readOperational() {
+        const summary = await this.#repository.readOperationalSummary();
+        return summary === undefined ? [] : [summary];
+    }
+}
+//# sourceMappingURL=owner-view-service.js.map

package/dist/services/owner-view-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-view-service.js","sourceRoot":"","sources":["../../src/services/owner-view-service.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,gBAAgB;IAClB,WAAW,CAAsB;IAE1C,YAAY,UAA+B;QACzC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;QACzD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAA0B;QACxC,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAiB;QAC9B,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,sBAAsB,EAAE,CAAC;QAChE,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/services/peer-directory-service.d.ts

@@ -0,0 +1,26 @@
+import type { HomeNodeCandidate, HomeNodeClient } from "@econ-v1/ports";
+export interface PeerAdvertisement {
+    readonly directAddresses: readonly string[];
+    readonly did: string;
+    readonly irohNodeId: string;
+    readonly observedAt: string;
+}
+export interface NodeMetadataWire {
+    readonly iroh_direct_addresses?: unknown;
+    readonly iroh_endpoint_id?: unknown;
+    readonly listening_addresses?: unknown;
+    readonly node_id?: unknown;
+}
+export declare class PeerDirectoryService {
+    #private;
+    upsert(advertisement: PeerAdvertisement): boolean;
+    remove(irohNodeId: string): boolean;
+    get(irohNodeId: string): PeerAdvertisement | undefined;
+    list(): readonly PeerAdvertisement[];
+    refreshLanCandidates(home: HomeNodeClient): Promise<readonly HomeNodeCandidate[]>;
+}
+export declare function normalizeAdvertisement(advertisement: PeerAdvertisement): PeerAdvertisement;
+export declare function nodeMetadataCandidates(metadata: NodeMetadataWire): readonly HomeNodeCandidate[];
+export declare function uniqueAddresses(addresses: readonly string[]): readonly string[];
+export declare function secureAddresses(addresses: readonly string[]): readonly string[];
+//# sourceMappingURL=peer-directory-service.d.ts.map

package/dist/services/peer-directory-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-directory-service.d.ts","sourceRoot":"","sources":["../../src/services/peer-directory-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAID,qBAAa,oBAAoB;;IAG/B,MAAM,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO;IAQjD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAInC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAItD,IAAI,IAAI,SAAS,iBAAiB,EAAE;IAI9B,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;CAOxF;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB,CAU1F;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,iBAAiB,EAAE,CAQ/F;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAE/E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAK/E"}

package/dist/services/peer-directory-service.js

@@ -0,0 +1,79 @@
+const MAX_DIRECT_ADDRESSES = 8;
+export class PeerDirectoryService {
+    #peers = new Map();
+    upsert(advertisement) {
+        const normalized = normalizeAdvertisement(advertisement);
+        const current = this.#peers.get(normalized.irohNodeId);
+        if (current !== undefined && current.observedAt >= normalized.observedAt)
+            return false;
+        this.#peers.set(normalized.irohNodeId, normalized);
+        return true;
+    }
+    remove(irohNodeId) {
+        return this.#peers.delete(irohNodeId);
+    }
+    get(irohNodeId) {
+        return this.#peers.get(irohNodeId);
+    }
+    list() {
+        return [...this.#peers.values()].sort((left, right) => right.observedAt.localeCompare(left.observedAt));
+    }
+    async refreshLanCandidates(home) {
+        const metadata = await home.invoke({
+            operation: "GET /api/v2/node/metadata",
+            payload: {},
+        });
+        return nodeMetadataCandidates(metadata);
+    }
+}
+export function normalizeAdvertisement(advertisement) {
+    requireText(advertisement.did, "Peer advertisement did");
+    requireText(advertisement.irohNodeId, "Peer advertisement irohNodeId");
+    requireText(advertisement.observedAt, "Peer advertisement observedAt");
+    return {
+        directAddresses: secureAddresses(advertisement.directAddresses),
+        did: advertisement.did,
+        irohNodeId: advertisement.irohNodeId,
+        observedAt: advertisement.observedAt,
+    };
+}
+export function nodeMetadataCandidates(metadata) {
+    const id = textOrUndefined(metadata.iroh_endpoint_id) ?? textOrUndefined(metadata.node_id);
+    if (id === undefined)
+        throw new TypeError("Node metadata is missing an iroh endpoint id");
+    const addresses = secureAddresses([
+        ...stringArray(metadata.listening_addresses),
+        ...stringArray(metadata.iroh_direct_addresses),
+    ]).slice(0, MAX_DIRECT_ADDRESSES);
+    return addresses.map((address) => ({ address, id, path: "lan-direct" }));
+}
+export function uniqueAddresses(addresses) {
+    return [...new Set(addresses.map((address) => address.trim()).filter((address) => address.length > 0))];
+}
+export function secureAddresses(addresses) {
+    return uniqueAddresses(addresses)
+        .map(toSecureAddress)
+        .filter((address) => address !== undefined)
+        .slice(0, MAX_DIRECT_ADDRESSES);
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function textOrUndefined(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function requireText(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0)
+        throw new TypeError(`${label} must be non-empty`);
+}
+function toSecureAddress(address) {
+    const value = address.includes("://") ? address : `https://${address}`;
+    const match = /^https:\/\/([^/?#:\s]+)(?::(\d{1,5}))?(?:\/)?$/u.exec(value);
+    if (match === null)
+        return undefined;
+    const port = match[2] === undefined ? undefined : Number(match[2]);
+    if (port !== undefined && (port < 1 || port > 65535))
+        return undefined;
+    return port === undefined ? `https://${match[1]}` : `https://${match[1]}:${port}`;
+}
+//# sourceMappingURL=peer-directory-service.js.map

package/dist/services/peer-directory-service.js.map

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

package/dist/services/revisioned-domain-service.d.ts

@@ -0,0 +1,46 @@
+import type { OutboxRepository } from "@econ-v1/ports";
+import { type RevisionCommand, type RevisionCommandResult, type RevisionConflictRecord, type RevisionEntity, type RevisionResolution, type RevisionedDomain } from "../models/revisioned.js";
+import type { JsonValue } from "../models/json.js";
+export interface RevisionedDomainRepository<TValue extends JsonValue> {
+    apply(entity: RevisionEntity<TValue>): Promise<void>;
+    command(input: RevisionCommand<TValue>): Promise<RevisionCommandResult<TValue>>;
+    read(id: string): Promise<RevisionEntity<TValue> | undefined>;
+}
+export interface RevisionedDomainServiceOptions<TValue extends JsonValue> {
+    readonly domain: RevisionedDomain;
+    readonly now?: () => string;
+    readonly outbox: OutboxRepository;
+    readonly repository: RevisionedDomainRepository<TValue>;
+}
+export type RevisionedWriteResult<TValue extends JsonValue> = {
+    readonly entity: RevisionEntity<TValue>;
+    readonly status: "accepted";
+} | {
+    readonly conflict: RevisionConflictRecord<TValue>;
+    readonly status: "conflict";
+};
+export type RevisionResolutionResult<TValue extends JsonValue> = {
+    readonly entity: RevisionEntity<TValue>;
+    readonly status: "accepted";
+} | {
+    readonly entity: RevisionEntity<TValue>;
+    readonly status: "discarded";
+} | {
+    readonly conflict: RevisionConflictRecord<TValue>;
+    readonly status: "conflict";
+};
+export interface RevisionedWriteInput<TValue extends JsonValue> {
+    readonly baseRev?: number;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly value: TValue;
+}
+export declare class RevisionedDomainService<TValue extends JsonValue> {
+    #private;
+    constructor(options: RevisionedDomainServiceOptions<TValue>);
+    update(input: RevisionedWriteInput<TValue>): Promise<RevisionedWriteResult<TValue>>;
+    listConflicts(): Promise<readonly RevisionConflictRecord<TValue>[]>;
+    resolveConflict(conflictIdValue: string, resolution: RevisionResolution): Promise<RevisionResolutionResult<TValue>>;
+}
+export declare function parseRevisionConflictRecord<TValue extends JsonValue>(value: unknown, expectedDomain?: RevisionedDomain): RevisionConflictRecord<TValue>;
+//# sourceMappingURL=revisioned-domain-service.d.ts.map

package/dist/services/revisioned-domain-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisioned-domain-service.d.ts","sourceRoot":"","sources":["../../src/services/revisioned-domain-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,MAAM,WAAW,0BAA0B,CAAC,MAAM,SAAS,SAAS;IAClE,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,8BAA8B,CAAC,MAAM,SAAS,SAAS;IACtE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,SAAS,IACtD;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEvF,MAAM,MAAM,wBAAwB,CAAC,MAAM,SAAS,SAAS,IACzD;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,SAAS;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,uBAAuB,CAAC,MAAM,SAAS,SAAS;;gBAM/C,OAAO,EAAE,8BAA8B,CAAC,MAAM,CAAC;IAOrD,MAAM,CAAC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAgBnF,aAAa,IAAI,OAAO,CAAC,SAAS,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;IAKnE,eAAe,CACnB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;CAkF7C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,SAAS,SAAS,EAClE,KAAK,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,gBAAgB,GAChC,sBAAsB,CAAC,MAAM,CAAC,CAsBhC"}