@econ-v1/ports 0.0.0

package/dist/repositories/revisioned-repository.d.ts

@@ -0,0 +1,41 @@
+import type { RepositoryJsonValue } from "./repository-mutation.js";
+import type { RepositoryWriteResult } from "./durable-event.js";
+export declare const REVISIONED_REPOSITORY_DOMAINS: readonly ["agent", "settings", "graph"];
+export type RevisionedRepositoryDomain = (typeof REVISIONED_REPOSITORY_DOMAINS)[number];
+export interface RevisionedEntity<TValue extends RepositoryJsonValue = RepositoryJsonValue> {
+    readonly id: string;
+    readonly rev: number;
+    readonly value: TValue;
+}
+export interface RevisionCommand<TValue extends RepositoryJsonValue = RepositoryJsonValue> {
+    readonly baseRev: number;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly value: TValue;
+}
+export type RevisionCommandResult<TValue extends RepositoryJsonValue = RepositoryJsonValue> = {
+    readonly entity: RevisionedEntity<TValue>;
+    readonly status: "accepted";
+} | {
+    readonly status: "conflict";
+    readonly theirs: RevisionedEntity<TValue>;
+};
+export interface RevisionedRepositoryEvent {
+    readonly occurredAt: string;
+    readonly payload: {
+        readonly action: "created" | "updated";
+        readonly entityId: string;
+        readonly entityType: "agent" | "graph" | "setting";
+    };
+    readonly type: "domain.entity-changed";
+}
+export interface RevisionedRepository<TValue extends RepositoryJsonValue = RepositoryJsonValue> {
+    apply(entity: RevisionedEntity<TValue>): Promise<RepositoryWriteResult<RevisionedRepositoryEvent>>;
+    command(input: RevisionCommand<TValue>): Promise<RevisionCommandResult<TValue>>;
+    list(): Promise<readonly RevisionedEntity<TValue>[]>;
+    read(id: string): Promise<RevisionedEntity<TValue> | undefined>;
+}
+export type AgentRepository = RevisionedRepository;
+export type RevisionedSettingsRepository = RevisionedRepository;
+export type GraphRepository = RevisionedRepository;
+//# sourceMappingURL=revisioned-repository.d.ts.map

package/dist/repositories/revisioned-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisioned-repository.d.ts","sourceRoot":"","sources":["../../src/repositories/revisioned-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,eAAO,MAAM,6BAA6B,yCAA0C,CAAC;AACrF,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,mBAAmB,GAAG,mBAAmB;IACxF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,mBAAmB,GAAG,mBAAmB;IACvF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,mBAAmB,GAAG,mBAAmB,IACtF;IAAE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;QACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;KACpD,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,mBAAmB,GAAG,mBAAmB;IAC5F,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACnG,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,IAAI,IAAI,OAAO,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AACnD,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC"}

package/dist/repositories/revisioned-repository.js

@@ -0,0 +1,2 @@
+export const REVISIONED_REPOSITORY_DOMAINS = ["agent", "settings", "graph"];
+//# sourceMappingURL=revisioned-repository.js.map

package/dist/repositories/revisioned-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisioned-repository.js","sourceRoot":"","sources":["../../src/repositories/revisioned-repository.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC"}

package/dist/repositories/settings.d.ts

@@ -0,0 +1,27 @@
+import type { RepositoryWriteResult } from "./durable-event.js";
+import type { RepositoryJsonValue } from "./repository-mutation.js";
+export interface SettingRecord {
+    readonly key: string;
+    readonly updatedAt: string;
+    readonly value: RepositoryJsonValue;
+}
+export interface SettingInput {
+    readonly key: string;
+    readonly value: RepositoryJsonValue;
+}
+export interface SettingsRepositoryEvent {
+    readonly occurredAt: string;
+    readonly payload: {
+        readonly action: "created" | "deleted" | "updated";
+        readonly entityId: string;
+        readonly entityType: "setting";
+    };
+    readonly type: "domain.entity-changed";
+}
+export interface SettingsRepository {
+    delete(key: string): Promise<RepositoryWriteResult<SettingsRepositoryEvent>>;
+    list(): Promise<readonly SettingRecord[]>;
+    read(key: string): Promise<SettingRecord | undefined>;
+    set(input: SettingInput): Promise<RepositoryWriteResult<SettingsRepositoryEvent>>;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/repositories/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/repositories/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC7E,IAAI,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IACtD,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC,CAAC;CACnF"}

package/dist/repositories/settings.js

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

package/dist/repositories/settings.js.map

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

package/dist/repositories/sync-ledger.d.ts

@@ -0,0 +1,30 @@
+import type { RepositoryWriteResult } from "./durable-event.js";
+export interface SyncLedgerInput {
+    readonly cursor: string;
+    readonly domain: string;
+}
+export interface SyncLedgerRecord extends SyncLedgerInput {
+    readonly updatedAt: string;
+}
+export interface SyncDeltaAppliedEvent {
+    readonly occurredAt: string;
+    readonly payload: SyncLedgerInput;
+    readonly type: "sync.delta-applied";
+}
+export interface SyncCursorDeletedEvent {
+    readonly occurredAt: string;
+    readonly payload: {
+        readonly action: "deleted";
+        readonly entityId: string;
+        readonly entityType: "sync-cursor";
+    };
+    readonly type: "domain.entity-changed";
+}
+export type SyncLedgerRepositoryEvent = SyncCursorDeletedEvent | SyncDeltaAppliedEvent;
+export interface SyncLedgerRepository {
+    delete(domain: string): Promise<RepositoryWriteResult<SyncLedgerRepositoryEvent>>;
+    list(): Promise<readonly SyncLedgerRecord[]>;
+    read(domain: string): Promise<SyncLedgerRecord | undefined>;
+    setCursor(input: SyncLedgerInput): Promise<RepositoryWriteResult<SyncLedgerRepositoryEvent>>;
+}
+//# sourceMappingURL=sync-ledger.d.ts.map

package/dist/repositories/sync-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-ledger.d.ts","sourceRoot":"","sources":["../../src/repositories/sync-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;KACpC,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;CACxC;AAED,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAEvF,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAClF,IAAI,IAAI,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAC5D,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAAC;CAC9F"}

package/dist/repositories/sync-ledger.js

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

package/dist/repositories/sync-ledger.js.map

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

package/dist/repositories/wallet-mirror-repository.d.ts

@@ -0,0 +1,52 @@
+export interface WalletPaymentRecord {
+    readonly amountMsat: number;
+    readonly createdAt: string;
+    readonly direction: "incoming" | "outgoing";
+    readonly failureCode?: string;
+    readonly id: string;
+    readonly paymentHash?: string;
+    readonly status: "pending" | "succeeded" | "failed" | "expired";
+    readonly updatedAt: string;
+}
+export interface WalletL402Receipt {
+    readonly amountMsat: number;
+    readonly paidAt: string;
+    readonly paymentHash?: string;
+    readonly receiptId: string;
+    readonly resource: string;
+}
+export interface WalletSnapshotValue {
+    readonly balanceMsat: number;
+    readonly l402: readonly WalletL402Receipt[];
+    readonly payments: readonly WalletPaymentRecord[];
+    readonly spendableMsat: number;
+}
+export interface WalletAuthoritativeSnapshot {
+    readonly observedAt: string;
+    readonly staleAt: string;
+    readonly value: WalletSnapshotValue;
+}
+export type WalletCommandResult = {
+    readonly amountMsat: number;
+    readonly invoiceId: string;
+    readonly kind: "invoice-created";
+    readonly paymentHash?: string;
+    readonly paymentRequest: string;
+    readonly status: "created";
+} | {
+    readonly amountMsat: number;
+    readonly kind: "payment-submitted";
+    readonly paymentHash?: string;
+    readonly paymentId: string;
+    readonly status: "pending" | "succeeded" | "failed";
+};
+export interface WalletMirrorRepository {
+    readCommandResult(idempotencyKey: string): Promise<WalletCommandResult | undefined>;
+    readSnapshot(): Promise<WalletAuthoritativeSnapshot | undefined>;
+    writeCommandResult(idempotencyKey: string, result: WalletCommandResult): Promise<void>;
+    writeSnapshot(snapshot: WalletAuthoritativeSnapshot): Promise<void>;
+}
+export declare function isWalletSnapshotValue(value: unknown): value is WalletSnapshotValue;
+export declare function isWalletAuthoritativeSnapshot(value: unknown): value is WalletAuthoritativeSnapshot;
+export declare function isWalletCommandResult(value: unknown): value is WalletCommandResult;
+//# sourceMappingURL=wallet-mirror-repository.d.ts.map

package/dist/repositories/wallet-mirror-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-mirror-repository.d.ts","sourceRoot":"","sources":["../../src/repositories/wallet-mirror-repository.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;CACrD,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IACpF,YAAY,IAAI,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAAC;IACjE,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,aAAa,CAAC,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAKlF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,2BAA2B,CAIlG;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAYlF"}

package/dist/repositories/wallet-mirror-repository.js

@@ -0,0 +1,53 @@
+export function isWalletSnapshotValue(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["balanceMsat", "l402", "payments", "spendableMsat"]) ||
+        !isNonNegativeNumber(value.balanceMsat) || !isNonNegativeNumber(value.spendableMsat))
+        return false;
+    return Array.isArray(value.payments) && value.payments.every(isWalletPaymentRecord) &&
+        Array.isArray(value.l402) && value.l402.every(isWalletL402Receipt);
+}
+export function isWalletAuthoritativeSnapshot(value) {
+    return isRecord(value) && hasOnlyKeys(value, ["observedAt", "staleAt", "value"]) &&
+        typeof value.observedAt === "string" && typeof value.staleAt === "string" &&
+        isWalletSnapshotValue(value.value);
+}
+export function isWalletCommandResult(value) {
+    if (!isRecord(value) || !isNonNegativeNumber(value.amountMsat))
+        return false;
+    if (value.kind === "invoice-created") {
+        return hasOnlyKeys(value, ["amountMsat", "invoiceId", "kind", "paymentHash", "paymentRequest", "status"]) &&
+            value.status === "created" && typeof value.invoiceId === "string" && typeof value.paymentRequest === "string" &&
+            (value.paymentHash === undefined || typeof value.paymentHash === "string");
+    }
+    return hasOnlyKeys(value, ["amountMsat", "kind", "paymentHash", "paymentId", "status"]) &&
+        value.kind === "payment-submitted" &&
+        (value.status === "pending" || value.status === "succeeded" || value.status === "failed") &&
+        typeof value.paymentId === "string" &&
+        (value.paymentHash === undefined || typeof value.paymentHash === "string");
+}
+function isWalletPaymentRecord(value) {
+    if (!isRecord(value) || !isNonNegativeNumber(value.amountMsat) || typeof value.createdAt !== "string" ||
+        typeof value.id !== "string" || typeof value.updatedAt !== "string" ||
+        !hasOnlyKeys(value, ["amountMsat", "createdAt", "direction", "failureCode", "id", "paymentHash", "status", "updatedAt"]))
+        return false;
+    return (value.direction === "incoming" || value.direction === "outgoing") &&
+        (value.status === "pending" || value.status === "succeeded" || value.status === "failed" || value.status === "expired") &&
+        (value.failureCode === undefined || typeof value.failureCode === "string") &&
+        (value.paymentHash === undefined || typeof value.paymentHash === "string");
+}
+function isWalletL402Receipt(value) {
+    return isRecord(value) && hasOnlyKeys(value, ["amountMsat", "paidAt", "paymentHash", "receiptId", "resource"]) &&
+        isNonNegativeNumber(value.amountMsat) && typeof value.paidAt === "string" &&
+        typeof value.receiptId === "string" && typeof value.resource === "string" &&
+        (value.paymentHash === undefined || typeof value.paymentHash === "string");
+}
+function isNonNegativeNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasOnlyKeys(value, allowed) {
+    const allowedKeys = new Set(allowed);
+    return Object.keys(value).every((key) => allowedKeys.has(key));
+}
+//# sourceMappingURL=wallet-mirror-repository.js.map

package/dist/repositories/wallet-mirror-repository.js.map

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

package/dist/repositories.d.ts

@@ -0,0 +1,44 @@
+export interface StageManifest {
+    readonly entry: string;
+    readonly integrity: Readonly<Record<string, string>>;
+    readonly requires: readonly string[];
+    readonly version: string;
+}
+export type StageUiKind = "stage" | "widget";
+export interface StageUiNav {
+    readonly order: number;
+    readonly section: string;
+}
+export interface StageUiMetadata {
+    readonly composes: readonly string[];
+    readonly icon?: string;
+    readonly kind: StageUiKind;
+    readonly nav?: StageUiNav;
+    readonly title: string;
+    readonly uiApi: 1;
+}
+export interface StageCatalogEntry {
+    readonly appName: string;
+    readonly assetBase: string;
+    readonly manifest: StageManifest;
+    readonly manifestSha256: string;
+    readonly ui: StageUiMetadata;
+}
+export interface StageRegistrySnapshot {
+    readonly entries: readonly StageCatalogEntry[];
+    readonly revision: string;
+}
+export interface StageRegistryPort {
+    read(): Promise<StageRegistrySnapshot | undefined>;
+    write(snapshot: StageRegistrySnapshot): Promise<void>;
+}
+export interface PreparedStageAsset {
+    readonly appName: string;
+    readonly entryUrl: string;
+    readonly manifestSha256: string;
+    readonly version: string;
+}
+export interface StageAssetPort {
+    prepare(appName: string, manifest: StageManifest): Promise<PreparedStageAsset>;
+}
+//# sourceMappingURL=repositories.d.ts.map

package/dist/repositories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../src/repositories.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;IACnD,KAAK,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChF"}

package/dist/repositories.js

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

package/dist/repositories.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,12 @@
+export interface ScheduledJob {
+    readonly cadenceMs?: number;
+    readonly dueAt: string;
+    readonly name: string;
+    run(): Promise<void>;
+}
+export interface SchedulerPort {
+    cancel(name: string): void;
+    register(job: ScheduledJob): void;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/scheduler.js

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

package/dist/scheduler.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,97 @@
+import type { StageRegistryPort } from "./repositories.js";
+import type { DurableRepositoryEventStore } from "./repositories/durable-event.js";
+import type { ConversationRepository, NotificationRepository, RepositoryEvent } from "./repositories/conversation-repository.js";
+import type { OutboxRepository, OutboxRepositoryEvent } from "./repositories/outbox.js";
+import type { SettingsRepository, SettingsRepositoryEvent } from "./repositories/settings.js";
+import type { SyncLedgerRepository, SyncLedgerRepositoryEvent } from "./repositories/sync-ledger.js";
+import type { AgentRepository, GraphRepository, RevisionedRepositoryEvent, RevisionedSettingsRepository } from "./repositories/revisioned-repository.js";
+import type { WalletMirrorRepository } from "./repositories/wallet-mirror-repository.js";
+export declare const RESET_LOCAL_STORAGE_CONFIRMATION = "RESET LOCAL CLIENT DATA";
+export type StorageRecoveryCode = "checksum-drift" | "corrupt" | "diagnostic-failed" | "identity-source-unavailable" | "migration-failed" | "opfs-unavailable" | "quota-exceeded" | "worker-operation-timeout" | "worker-preparation-timeout" | "writer-conflict";
+export declare const STORAGE_RECOVERY_MESSAGES: {
+    readonly "checksum-drift": "Local schema history does not match this client build";
+    readonly corrupt: "Local SQLite data failed its integrity check";
+    readonly "diagnostic-failed": "Encrypted storage diagnostic creation failed";
+    readonly "identity-source-unavailable": "Protected identity metadata is temporarily unavailable";
+    readonly "migration-failed": "Local SQLite schema migration failed";
+    readonly "opfs-unavailable": "Persistent browser storage is unavailable";
+    readonly "quota-exceeded": "Persistent browser storage quota is exhausted";
+    readonly "worker-operation-timeout": "Persistent storage operation timed out";
+    readonly "worker-preparation-timeout": "Protected storage request preparation timed out";
+    readonly "writer-conflict": "Another client-node storage writer is active";
+};
+export interface StorageReadyState {
+    readonly schemaVersion: number;
+    /** Changes only after a destructive local-storage replacement. */
+    readonly storageGeneration?: number;
+    readonly status: "ready";
+}
+export interface StorageStartingState {
+    readonly schemaVersion: number;
+    readonly storageGeneration?: number;
+    readonly status: "starting";
+}
+export interface StorageRecoveryRequiredState {
+    readonly actions: {
+        readonly exportDiagnostic: boolean;
+        readonly reset: true;
+        readonly retry: true;
+    };
+    readonly code: StorageRecoveryCode;
+    readonly message: string;
+    readonly schemaVersion: number;
+    readonly storageGeneration?: number;
+    readonly status: "recovery-required";
+}
+export type StorageRecoveryState = StorageReadyState | StorageRecoveryRequiredState | StorageStartingState;
+export interface EncryptedStorageDiagnostic {
+    readonly algorithm: "AES-GCM";
+    readonly ciphertextBase64: string;
+    readonly createdAt: string;
+    readonly format: "node-client-sqlite-diagnostic-v1";
+    readonly ivBase64: string;
+    readonly kdf: {
+        readonly hash: "SHA-256";
+        readonly iterations: 310_000;
+        readonly name: "PBKDF2";
+        readonly saltBase64: string;
+    };
+}
+export interface StorageDatabasePort {
+    readonly repositories: StorageRepositoryPort;
+    close(): Promise<void>;
+    exportEncryptedDiagnostic(options: {
+        readonly passphrase: string;
+    }): Promise<EncryptedStorageDiagnostic>;
+    initialize(): Promise<StorageRecoveryState>;
+    refreshIdentityMetadata(): Promise<void>;
+    recoveryState(): Promise<StorageRecoveryState>;
+    reset(options: {
+        readonly confirmation: string;
+    }): Promise<StorageRecoveryState>;
+    retry(): Promise<StorageRecoveryState>;
+    subscribeRecoveryState(listener: (state: StorageRecoveryState) => void): () => void;
+}
+export type StorageRepositoryEvent = OutboxRepositoryEvent | RepositoryEvent | RevisionedRepositoryEvent | SettingsRepositoryEvent | SyncLedgerRepositoryEvent;
+export interface StorageRepositoryPort {
+    /** Optional for compatibility with storage implementations predating P4 domain repositories. */
+    readonly conversations?: ConversationRepository;
+    readonly events: DurableRepositoryEventStore<StorageRepositoryEvent>;
+    /** Optional for compatibility with storage implementations predating P4 domain repositories. */
+    readonly notifications?: NotificationRepository;
+    /** Optional for compatibility with storage implementations predating Task 26 repositories. */
+    readonly agents?: AgentRepository;
+    /** Optional for compatibility with storage implementations predating Task 26 repositories. */
+    readonly graphs?: GraphRepository;
+    readonly outbox: OutboxRepository;
+    /** Optional for compatibility with storage implementations predating Task 26 repositories. */
+    readonly revisionedSettings?: RevisionedSettingsRepository;
+    /** Optional for compatibility with storage implementations predating Task 27 repositories. */
+    readonly wallet?: WalletMirrorRepository;
+    readonly settings: SettingsRepository;
+    readonly syncLedger: SyncLedgerRepository;
+}
+export interface StoragePort extends StorageDatabasePort {
+    readonly stages: StageRegistryPort;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,14 @@
+export const RESET_LOCAL_STORAGE_CONFIRMATION = "RESET LOCAL CLIENT DATA";
+export const STORAGE_RECOVERY_MESSAGES = {
+    "checksum-drift": "Local schema history does not match this client build",
+    corrupt: "Local SQLite data failed its integrity check",
+    "diagnostic-failed": "Encrypted storage diagnostic creation failed",
+    "identity-source-unavailable": "Protected identity metadata is temporarily unavailable",
+    "migration-failed": "Local SQLite schema migration failed",
+    "opfs-unavailable": "Persistent browser storage is unavailable",
+    "quota-exceeded": "Persistent browser storage quota is exhausted",
+    "worker-operation-timeout": "Persistent storage operation timed out",
+    "worker-preparation-timeout": "Protected storage request preparation timed out",
+    "writer-conflict": "Another client-node storage writer is active",
+};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,gCAAgC,GAAG,yBAAyB,CAAC;AAc1E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,gBAAgB,EAAE,uDAAuD;IACzE,OAAO,EAAE,8CAA8C;IACvD,mBAAmB,EAAE,8CAA8C;IACnE,6BAA6B,EAAE,wDAAwD;IACvF,kBAAkB,EAAE,sCAAsC;IAC1D,kBAAkB,EAAE,2CAA2C;IAC/D,gBAAgB,EAAE,+CAA+C;IACjE,0BAA0B,EAAE,wCAAwC;IACpE,4BAA4B,EAAE,iDAAiD;IAC/E,iBAAiB,EAAE,8CAA8C;CACD,CAAC"}

package/dist/theme.d.ts

@@ -0,0 +1,30 @@
+export type ThemePreference = "light" | "dark";
+/**
+ * Boundary port for the shell's dark-mode plumbing (`client/ui/src/shell/theme-init.ts`).
+ *
+ * `client/ui` may never call `localStorage` or `matchMedia` directly (boundary rules
+ * B2/B3, `client/scripts/check-boundaries.mjs`) — this is the narrow surface
+ * `client/adapters-web`'s `createBrowserThemeEnvironment()` implements against the real
+ * globals, and the composition root (`system/pwa/src/main.ts`) registers it (via
+ * `client/ui`'s `configureThemeEnvironment`) before the shell's first paint. Every method is
+ * synchronous and side-effect-free beyond the read/write it names — `theme-init.ts`'s
+ * anti-FOUC contract requires resolving the initial theme before the shadow tree's first
+ * paint, which is before the kernel connection (`KernelRpcClient`, itself an async
+ * `SharedWorker`/leader-tab bridge) even exists, so this can never be mediated through
+ * `@econ-v1/rpc` the way ordinary UI reads/writes are (rule S4).
+ */
+export interface ThemeEnvironmentPort {
+    /** Reads the persisted preference, or `undefined` if unset or storage is unavailable
+     * (private browsing, quota). */
+    getStoredTheme(): ThemePreference | undefined;
+    /** Persists a preference. Implementations MUST swallow storage failures (private
+     * browsing, quota) rather than throwing. */
+    setStoredTheme(preference: ThemePreference): void;
+    /** Current `(prefers-color-scheme: dark)` match; `false` if the environment doesn't
+     * support media queries. */
+    prefersDarkColorScheme(): boolean;
+    /** Subscribes to live `(prefers-color-scheme: dark)` changes. Returns an unsubscribe
+     * function, or `undefined` if the environment doesn't support live media queries. */
+    watchDarkColorScheme(onChange: (matches: boolean) => void): (() => void) | undefined;
+}
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC;oCACgC;IAChC,cAAc,IAAI,eAAe,GAAG,SAAS,CAAC;IAC9C;gDAC4C;IAC5C,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAClD;gCAC4B;IAC5B,sBAAsB,IAAI,OAAO,CAAC;IAClC;yFACqF;IACrF,oBAAoB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACtF"}

package/dist/theme.js

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

package/dist/theme.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@econ-v1/ports",
+  "version": "0.0.0",
+  "description": "Platform-neutral ports for Node client applications",
+  "license": "MIT OR Apache-2.0",
+  "author": "Node contributors",
+  "homepage": "https://github.com/econ-v1/node",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/econ-v1/node.git",
+    "directory": "client/ports"
+  },
+  "bugs": {
+    "url": "https://github.com/econ-v1/node/issues"
+  },
+  "keywords": [
+    "node-client",
+    "ports",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "rm -rf dist && tsc -b --pretty false",
+    "lint": "eslint src",
+    "prepack": "npm run build",
+    "test": "vitest run --passWithNoTests",
+    "type-check": "tsc -b --pretty false"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "!dist/**/*.test.*"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}