tenzro-wallet 0.1.0

package/dist/ports/agent/adapters/insurance-adapter.js

@@ -0,0 +1,103 @@
+/**
+ * InsuranceSdkAdapter — wraps `InsuranceClient` so the kernel can file
+ * insurance claims and read pool state without owning the RPC params
+ * shape.
+ *
+ * Wire:
+ *   fileClaim    → InsuranceClient.fileInsuranceClaim(params)
+ *   get          → InsuranceClient.getInsuranceClaim(claimId)
+ *   list         → InsuranceClient.listInsuranceClaims()
+ *   poolBalance  → InsuranceClient.getInsurancePoolBalance()
+ *
+ * The SDK's `fileInsuranceClaim` takes an opaque `Record<string,
+ * unknown>` because the node-side params shape evolves with
+ * governance — we serialise our typed `FileInsuranceClaimRequest` to
+ * the snake_case keys the RPC expects.
+ */
+export class InsuranceSdkAdapter {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async fileClaim(req) {
+        const params = {
+            claimant_did: req.claimantDid,
+            claimant_address: req.claimantAddress,
+            against_agent_did: req.againstAgentDid,
+            amount_requested: req.amountRequested.toString(),
+            receipt_refs: [...req.receiptRefs],
+        };
+        if (req.narrative !== undefined) {
+            params.narrative = req.narrative;
+        }
+        const raw = (await this.client.fileInsuranceClaim(params));
+        const decoded = decodeClaim(raw);
+        if (decoded === null) {
+            throw new Error('insurance.fileClaim: node returned a claim without claim_id');
+        }
+        return decoded;
+    }
+    async get(claimId) {
+        const raw = (await this.client.getInsuranceClaim(claimId));
+        return raw === null || raw === undefined ? null : decodeClaim(raw);
+    }
+    async list() {
+        const raws = (await this.client.listInsuranceClaims());
+        if (!Array.isArray(raws))
+            return [];
+        const out = [];
+        for (const raw of raws) {
+            const rec = decodeClaim(raw);
+            if (rec !== null)
+                out.push(rec);
+        }
+        return out;
+    }
+    async poolBalance() {
+        const raw = await this.client.getInsurancePoolBalance();
+        return raw === undefined || raw === null ? 0n : BigInt(raw);
+    }
+}
+function decodeClaim(raw) {
+    const claimId = raw.claim_id ?? raw.claimId;
+    if (claimId === undefined)
+        return null;
+    const refs = raw.receipt_refs ?? raw.receiptRefs ?? [];
+    const paidRaw = raw.paid_amount ?? raw.paidAmount;
+    const govRef = raw.governance_ref ?? raw.governanceRef;
+    const narrative = raw.narrative === null ? undefined : raw.narrative;
+    const governanceRef = govRef === null ? undefined : govRef;
+    const paidAmount = paidRaw === null || paidRaw === undefined ? undefined : BigInt(paidRaw);
+    return {
+        claimId,
+        claimantDid: raw.claimant_did ?? raw.claimantDid ?? '',
+        claimantAddress: raw.claimant_address ?? raw.claimantAddress ?? '',
+        againstAgentDid: raw.against_agent_did ?? raw.againstAgentDid ?? '',
+        amountRequested: raw.amount_requested !== undefined
+            ? BigInt(raw.amount_requested)
+            : raw.amountRequested !== undefined
+                ? BigInt(raw.amountRequested)
+                : 0n,
+        receiptRefs: Object.freeze([...refs]),
+        ...(narrative !== undefined ? { narrative } : {}),
+        status: normaliseStatus(raw.status),
+        ...(governanceRef !== undefined ? { governanceRef } : {}),
+        ...(paidAmount !== undefined ? { paidAmount } : {}),
+        filedAt: raw.filed_at ?? raw.filedAt ?? 0,
+    };
+}
+function normaliseStatus(raw) {
+    switch ((raw ?? '').toLowerCase()) {
+        case 'open':
+            return 'open';
+        case 'approved':
+            return 'approved';
+        case 'rejected':
+            return 'rejected';
+        case 'paid':
+            return 'paid';
+        default:
+            return 'open';
+    }
+}
+//# sourceMappingURL=insurance-adapter.js.map

package/dist/ports/agent/adapters/insurance-adapter.js.map

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

package/dist/ports/agent/adapters/lifecycle-adapter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * LifecycleSdkAdapter — wraps `LifecycleClient` so the kernel can read
+ * agent lifecycle state and the kill-switch audit trail without owning
+ * the RPC field shape.
+ *
+ * Wire:
+ *   getLifecycle              → LifecycleClient.getAgentLifecycle(agentId)
+ *   getKillSwitchReceipt      → LifecycleClient.getKillSwitchReceipt(receiptId)
+ *   listKillSwitchByAgent     → LifecycleClient.listKillSwitchByAgent(agentId)
+ *   listKillSwitchByController → LifecycleClient.listKillSwitchByController(controllerDid)
+ *
+ * All four are read-only; mutations land via `TerminateAgent` etc. typed
+ * transactions and are out of scope for this port.
+ */
+import type { LifecycleClient } from 'tenzro-sdk';
+import type { AgentLifecycleRecord, KillSwitchReceiptRecord, LifecyclePort } from '../lifecycle.js';
+export type LifecycleClientLike = Pick<LifecycleClient, 'getAgentLifecycle' | 'getKillSwitchReceipt' | 'listKillSwitchByAgent' | 'listKillSwitchByController'>;
+export declare class LifecycleSdkAdapter implements LifecyclePort {
+    private readonly client;
+    constructor(client: LifecycleClientLike);
+    getLifecycle(agentId: string): Promise<AgentLifecycleRecord | null>;
+    getKillSwitchReceipt(receiptId: string): Promise<KillSwitchReceiptRecord | null>;
+    listKillSwitchByAgent(agentId: string): Promise<KillSwitchReceiptRecord[]>;
+    listKillSwitchByController(controllerDid: string): Promise<KillSwitchReceiptRecord[]>;
+}
+//# sourceMappingURL=lifecycle-adapter.d.ts.map

package/dist/ports/agent/adapters/lifecycle-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-adapter.d.ts","sourceRoot":"","sources":["../../../../src/ports/agent/adapters/lifecycle-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EACV,oBAAoB,EAGpB,uBAAuB,EACvB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,eAAe,EACb,mBAAmB,GACnB,sBAAsB,GACtB,uBAAuB,GACvB,4BAA4B,CAC/B,CAAC;AAsCF,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAElD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAKnE,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAKhF,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAQ1E,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAO5F"}

package/dist/ports/agent/adapters/lifecycle-adapter.js

@@ -0,0 +1,136 @@
+/**
+ * LifecycleSdkAdapter — wraps `LifecycleClient` so the kernel can read
+ * agent lifecycle state and the kill-switch audit trail without owning
+ * the RPC field shape.
+ *
+ * Wire:
+ *   getLifecycle              → LifecycleClient.getAgentLifecycle(agentId)
+ *   getKillSwitchReceipt      → LifecycleClient.getKillSwitchReceipt(receiptId)
+ *   listKillSwitchByAgent     → LifecycleClient.listKillSwitchByAgent(agentId)
+ *   listKillSwitchByController → LifecycleClient.listKillSwitchByController(controllerDid)
+ *
+ * All four are read-only; mutations land via `TerminateAgent` etc. typed
+ * transactions and are out of scope for this port.
+ */
+export class LifecycleSdkAdapter {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async getLifecycle(agentId) {
+        const raw = (await this.client.getAgentLifecycle(agentId));
+        return raw === null || raw === undefined ? null : decodeLifecycle(raw);
+    }
+    async getKillSwitchReceipt(receiptId) {
+        const raw = (await this.client.getKillSwitchReceipt(receiptId));
+        return raw === null || raw === undefined ? null : decodeReceipt(raw);
+    }
+    async listKillSwitchByAgent(agentId) {
+        const raws = (await this.client.listKillSwitchByAgent(agentId));
+        return decodeReceiptList(raws);
+    }
+    async listKillSwitchByController(controllerDid) {
+        const raws = (await this.client.listKillSwitchByController(controllerDid));
+        return decodeReceiptList(raws);
+    }
+}
+function decodeLifecycle(raw) {
+    const agentId = raw.agent_id ?? raw.agentId;
+    if (agentId === undefined)
+        return null;
+    const lastChange = raw.last_state_change ?? raw.lastStateChange ?? '';
+    const heartbeat = raw.last_heartbeat ?? raw.lastHeartbeat;
+    const historyRaw = raw.state_history ?? raw.stateHistory ?? [];
+    const stateHistory = [];
+    for (const entry of historyRaw) {
+        if (Array.isArray(entry)) {
+            stateHistory.push({ state: normaliseState(entry[0]), at: entry[1] ?? '' });
+        }
+        else {
+            stateHistory.push({ state: normaliseState(entry.state), at: entry.at ?? '' });
+        }
+    }
+    const lastHeartbeat = heartbeat === null ? undefined : heartbeat;
+    return {
+        agentId,
+        state: normaliseState(raw.state),
+        lastStateChange: lastChange,
+        ...(lastHeartbeat !== undefined ? { lastHeartbeat } : {}),
+        stateHistory: Object.freeze(stateHistory),
+    };
+}
+function decodeReceiptList(raws) {
+    if (!Array.isArray(raws))
+        return [];
+    const out = [];
+    for (const raw of raws) {
+        const rec = decodeReceipt(raw);
+        if (rec !== null)
+            out.push(rec);
+    }
+    return out;
+}
+function decodeReceipt(raw) {
+    const receiptId = raw.receipt_id ?? raw.receiptId;
+    const action = normaliseAction(raw.action);
+    if (receiptId === undefined || action === null)
+        return null;
+    const reasonTextRaw = raw.reason_text ?? raw.reasonText;
+    const evidenceHashRaw = raw.evidence_hash ?? raw.evidenceHash;
+    const slashBpsRaw = raw.slash_bps ?? raw.slashBps;
+    const cascadeRaw = raw.cascade;
+    const pauseUntilRaw = raw.pause_until ?? raw.pauseUntil;
+    const frozenAtRaw = raw.frozen_at_block ?? raw.frozenAtBlock;
+    const reasonText = reasonTextRaw === null ? undefined : reasonTextRaw;
+    const evidenceHash = evidenceHashRaw === null ? undefined : evidenceHashRaw;
+    const slashBps = slashBpsRaw === null || slashBpsRaw === undefined ? undefined : slashBpsRaw;
+    const cascade = cascadeRaw === null || cascadeRaw === undefined ? undefined : cascadeRaw;
+    const pauseUntil = pauseUntilRaw === null || pauseUntilRaw === undefined ? undefined : pauseUntilRaw;
+    return {
+        receiptId,
+        action,
+        agentDid: raw.agent_did ?? raw.agentDid ?? '',
+        controllerDid: raw.controller_did ?? raw.controllerDid ?? '',
+        reasonCode: raw.reason_code ?? raw.reasonCode ?? 0,
+        ...(reasonText !== undefined ? { reasonText } : {}),
+        ...(evidenceHash !== undefined ? { evidenceHash } : {}),
+        ...(slashBps !== undefined ? { slashBps } : {}),
+        ...(cascade !== undefined ? { cascade } : {}),
+        ...(pauseUntil !== undefined ? { pauseUntil } : {}),
+        frozenAtBlock: frozenAtRaw !== undefined ? BigInt(frozenAtRaw) : 0n,
+        timestamp: raw.timestamp ?? 0,
+    };
+}
+function normaliseState(raw) {
+    switch ((raw ?? '').toLowerCase()) {
+        case 'created':
+            return 'created';
+        case 'initializing':
+            return 'initializing';
+        case 'active':
+            return 'active';
+        case 'suspended':
+            return 'suspended';
+        case 'paused':
+            return 'paused';
+        case 'quarantined':
+            return 'quarantined';
+        case 'terminated':
+            return 'terminated';
+        default:
+            return 'created';
+    }
+}
+function normaliseAction(raw) {
+    switch ((raw ?? '').toLowerCase()) {
+        case 'pause':
+            return 'pause';
+        case 'quarantine':
+            return 'quarantine';
+        case 'terminate':
+            return 'terminate';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=lifecycle-adapter.js.map

package/dist/ports/agent/adapters/lifecycle-adapter.js.map

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

package/dist/ports/agent/adapters/nanopayment-adapter.d.ts

@@ -0,0 +1,62 @@
+/**
+ * NanopaymentSdkAdapter — wraps the SDK's `NanopaymentClient`.
+ *
+ * snake_case + decimal-string ↔ camelCase + bigint shape mapping. The
+ * channel cryptography (signed off-chain receipts, dispute path) all lives
+ * server-side; the wallet just originates open / send / flush / close calls.
+ */
+import type { NanopaymentClient } from 'tenzro-sdk';
+import type { BatchSettlement, CloseChannelResult, NanoChannel, NanopaymentPort, NanopaymentReceipt, OpenChannelRequest, SendNanopaymentRequest } from '../nanopayment.js';
+interface RawChannelInfo {
+    channel_id: string;
+    payer: string;
+    payee: string;
+    deposit: string;
+    balance: string;
+    total_paid: string;
+    asset: string;
+    payment_count: number;
+    status: 'open' | 'closing' | 'closed' | 'disputed';
+}
+interface RawNanopaymentReceipt {
+    payment_id: string;
+    channel_id: string;
+    amount: string;
+    memo?: string;
+    sequence: number;
+}
+interface RawBatchSettlement {
+    channel_id: string;
+    payment_count: number;
+    total_amount: string;
+    tx_hash: string;
+    status: string;
+}
+interface RawCloseResult {
+    channel_id: string;
+    final_amount: string;
+    refunded: string;
+    tx_hash: string;
+    status: string;
+}
+export interface NanopaymentClientLike {
+    openChannel(payer: string, payee: string, deposit: string, asset?: string): Promise<RawChannelInfo>;
+    sendNanopayment(channelId: string, amount: string, memo?: string): Promise<RawNanopaymentReceipt>;
+    flushBatch(channelId: string): Promise<RawBatchSettlement>;
+    closeChannel(channelId: string): Promise<RawCloseResult>;
+    getChannel(channelId: string): Promise<RawChannelInfo>;
+    listChannels(address: string): Promise<RawChannelInfo[]>;
+}
+export declare class NanopaymentSdkAdapter implements NanopaymentPort {
+    private readonly client;
+    constructor(client: NanopaymentClientLike);
+    static fromClient(client: NanopaymentClient): NanopaymentSdkAdapter;
+    openChannel(req: OpenChannelRequest): Promise<NanoChannel>;
+    sendNanopayment(req: SendNanopaymentRequest): Promise<NanopaymentReceipt>;
+    flushBatch(channelId: string): Promise<BatchSettlement>;
+    closeChannel(channelId: string): Promise<CloseChannelResult>;
+    getChannel(channelId: string): Promise<NanoChannel | null>;
+    listChannels(participant: string): Promise<readonly NanoChannel[]>;
+}
+export {};
+//# sourceMappingURL=nanopayment-adapter.d.ts.map

package/dist/ports/agent/adapters/nanopayment-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nanopayment-adapter.d.ts","sourceRoot":"","sources":["../../../../src/ports/agent/adapters/nanopayment-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;CACpD;AAED,UAAU,qBAAqB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,kBAAkB;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACzD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC1D;AAgBD,qBAAa,qBAAsB,YAAW,eAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,qBAAqB;IAE1D,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB;IAI7D,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAU1D,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWzE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAWvD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAW5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQ1D,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;CAIzE"}

package/dist/ports/agent/adapters/nanopayment-adapter.js

@@ -0,0 +1,76 @@
+/**
+ * NanopaymentSdkAdapter — wraps the SDK's `NanopaymentClient`.
+ *
+ * snake_case + decimal-string ↔ camelCase + bigint shape mapping. The
+ * channel cryptography (signed off-chain receipts, dispute path) all lives
+ * server-side; the wallet just originates open / send / flush / close calls.
+ */
+function mapChannel(raw) {
+    return {
+        channelId: raw.channel_id,
+        payer: raw.payer,
+        payee: raw.payee,
+        deposit: BigInt(raw.deposit),
+        balance: BigInt(raw.balance),
+        totalPaid: BigInt(raw.total_paid),
+        asset: raw.asset,
+        paymentCount: raw.payment_count,
+        status: raw.status,
+    };
+}
+export class NanopaymentSdkAdapter {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    static fromClient(client) {
+        return new NanopaymentSdkAdapter(client);
+    }
+    async openChannel(req) {
+        const raw = await this.client.openChannel(req.payer, req.payee, req.deposit.toString(), req.asset ?? 'TNZO');
+        return mapChannel(raw);
+    }
+    async sendNanopayment(req) {
+        const raw = await this.client.sendNanopayment(req.channelId, req.amount.toString(), req.memo);
+        return {
+            paymentId: raw.payment_id,
+            channelId: raw.channel_id,
+            amount: BigInt(raw.amount),
+            ...(raw.memo !== undefined ? { memo: raw.memo } : {}),
+            sequence: raw.sequence,
+        };
+    }
+    async flushBatch(channelId) {
+        const raw = await this.client.flushBatch(channelId);
+        return {
+            channelId: raw.channel_id,
+            paymentCount: raw.payment_count,
+            totalAmount: BigInt(raw.total_amount),
+            txHash: raw.tx_hash,
+            status: raw.status,
+        };
+    }
+    async closeChannel(channelId) {
+        const raw = await this.client.closeChannel(channelId);
+        return {
+            channelId: raw.channel_id,
+            finalAmount: BigInt(raw.final_amount),
+            refunded: BigInt(raw.refunded),
+            txHash: raw.tx_hash,
+            status: raw.status,
+        };
+    }
+    async getChannel(channelId) {
+        try {
+            return mapChannel(await this.client.getChannel(channelId));
+        }
+        catch {
+            return null;
+        }
+    }
+    async listChannels(participant) {
+        const raw = await this.client.listChannels(participant);
+        return raw.map(mapChannel);
+    }
+}
+//# sourceMappingURL=nanopayment-adapter.js.map

package/dist/ports/agent/adapters/nanopayment-adapter.js.map

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

package/dist/ports/agent/adapters/payment-rails-adapter.d.ts

@@ -0,0 +1,67 @@
+/**
+ * PaymentRailsSdkAdapter — wraps `PaymentClient` (MPP / x402 / AP2 /
+ * Visa TAP / Mastercard) behind one port. Each method maps 1:1 to an
+ * RPC the SDK already exposes.
+ *
+ * The SDK currently types Visa TAP and Mastercard return values as `any`
+ * because the gateway's response shape is rail-specific and still
+ * stabilising. The adapter normalises into the common `PaymentReceipt`
+ * shape: receipt id + status + tx hash + opaque meta.
+ */
+import type { PaymentClient } from 'tenzro-sdk';
+import type { CreateChallengeRequest, IssueMastercardTokenRequest, MastercardToken, PayAp2Request, PayMastercardRequest, PayMppRequest, PayVisaTapRequest, PayX402Request, PaymentChallenge, PaymentRailsPort, PaymentReceipt, SignVisaTapRequest, VisaTapSignedRequest } from '../payment-rails.js';
+interface RawVisaTapSigned {
+    headers?: Readonly<Record<string, string>>;
+    url?: string;
+    method?: string;
+    [k: string]: unknown;
+}
+interface RawMastercardToken {
+    token_id?: string;
+    tokenId?: string;
+    kind?: string;
+    cap?: string;
+    expires_at?: number;
+    expiresAt?: number;
+    [k: string]: unknown;
+}
+/**
+ * Slice of `PaymentClient` the adapter relies on. Anchored to the SDK
+ * via `Pick<>` for the methods that ship; `signVisaTap` and
+ * `issueMastercardToken` are SDK-pending and use detect-via-presence.
+ */
+export type PaymentClientLike = Pick<PaymentClient, 'createChallenge' | 'payMpp' | 'payX402' | 'payAp2' | 'payVisaTap' | 'payMastercard' | 'getReceipt'> & {
+    /**
+     * SDK-pending. Present in `PaymentClientLike` so adapters can detect support
+     * via `'signVisaTap' in client`. The current SDK build doesn't expose it;
+     * the adapter's wrapper throws "SDK pending" until it does.
+     */
+    signVisaTap?(body: {
+        method: string;
+        url: string;
+        headers: Readonly<Record<string, string>>;
+        body?: string;
+        agent_did: string;
+    }): Promise<RawVisaTapSigned>;
+    /** SDK-pending. Same detect-via-presence pattern as `signVisaTap`. */
+    issueMastercardToken?(body: {
+        agent_did: string;
+        kind: string;
+        params: Readonly<Record<string, unknown>>;
+    }): Promise<RawMastercardToken>;
+};
+export declare class PaymentRailsSdkAdapter implements PaymentRailsPort {
+    private readonly client;
+    constructor(client: PaymentClientLike);
+    createChallenge(req: CreateChallengeRequest): Promise<PaymentChallenge>;
+    payMpp(req: PayMppRequest): Promise<PaymentReceipt>;
+    payX402(req: PayX402Request): Promise<PaymentReceipt>;
+    payAp2(req: PayAp2Request): Promise<PaymentReceipt>;
+    payVisaTap(req: PayVisaTapRequest): Promise<PaymentReceipt>;
+    payMastercard(req: PayMastercardRequest): Promise<PaymentReceipt>;
+    getReceipt(receiptId: string): Promise<PaymentReceipt | null>;
+    signVisaTap(req: SignVisaTapRequest): Promise<VisaTapSignedRequest>;
+    issueMastercardToken(req: IssueMastercardTokenRequest): Promise<MastercardToken>;
+}
+export {};
+//# sourceMappingURL=payment-rails-adapter.d.ts.map

package/dist/ports/agent/adapters/payment-rails-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-rails-adapter.d.ts","sourceRoot":"","sources":["../../../../src/ports/agent/adapters/payment-rails-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,aAAa,EACX,iBAAiB,GACjB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,eAAe,GACf,YAAY,CACf,GAAG;IACF;;;;OAIG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE9B,sEAAsE;IACtE,oBAAoB,CAAC,CAAC,IAAI,EAAE;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAC3C,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjC,CAAC;AAEF,qBAAa,sBAAuB,YAAW,gBAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEhD,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBvE,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAInD,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAIrD,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAInD,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3D,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAW7D,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoBnE,oBAAoB,CAAC,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;CAoBvF"}

package/dist/ports/agent/adapters/payment-rails-adapter.js

@@ -0,0 +1,108 @@
+/**
+ * PaymentRailsSdkAdapter — wraps `PaymentClient` (MPP / x402 / AP2 /
+ * Visa TAP / Mastercard) behind one port. Each method maps 1:1 to an
+ * RPC the SDK already exposes.
+ *
+ * The SDK currently types Visa TAP and Mastercard return values as `any`
+ * because the gateway's response shape is rail-specific and still
+ * stabilising. The adapter normalises into the common `PaymentReceipt`
+ * shape: receipt id + status + tx hash + opaque meta.
+ */
+export class PaymentRailsSdkAdapter {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async createChallenge(req) {
+        const raw = await this.client.createChallenge(req.resource, req.amount, req.asset, req.protocol);
+        return {
+            challengeId: raw.challengeId,
+            resource: raw.resource,
+            amount: raw.amount,
+            asset: raw.asset,
+            protocol: raw.protocol,
+            raw: raw,
+        };
+    }
+    async payMpp(req) {
+        return normaliseReceipt(await this.client.payMpp(req.url, req.payerDid));
+    }
+    async payX402(req) {
+        return normaliseReceipt(await this.client.payX402(req.url, req.payerDid));
+    }
+    async payAp2(req) {
+        return normaliseReceipt(await this.client.payAp2(req.agentDid, req.url, req.amount));
+    }
+    async payVisaTap(req) {
+        return normaliseReceipt(await this.client.payVisaTap(req.credential));
+    }
+    async payMastercard(req) {
+        return normaliseReceipt(await this.client.payMastercard(req.credential));
+    }
+    async getReceipt(receiptId) {
+        try {
+            const raw = await this.client.getReceipt(receiptId);
+            if (raw === null || raw === undefined)
+                return null;
+            return normaliseReceipt(raw);
+        }
+        catch {
+            // SDK throws on 404; the port semantics return null instead.
+            return null;
+        }
+    }
+    async signVisaTap(req) {
+        if (!this.client.signVisaTap) {
+            throw new Error('PaymentRailsSdkAdapter.signVisaTap: SDK pending — tenzro-sdk PaymentClient does not yet expose signVisaTap (DESIGN.md §11.1)');
+        }
+        const raw = await this.client.signVisaTap({
+            method: req.request.method,
+            url: req.request.url,
+            headers: req.request.headers,
+            ...(req.request.body !== undefined ? { body: req.request.body } : {}),
+            agent_did: req.agentDid,
+        });
+        return {
+            headers: raw.headers ?? req.request.headers,
+            url: raw.url ?? req.request.url,
+            method: raw.method ?? req.request.method,
+        };
+    }
+    async issueMastercardToken(req) {
+        if (!this.client.issueMastercardToken) {
+            throw new Error('PaymentRailsSdkAdapter.issueMastercardToken: SDK pending — tenzro-sdk PaymentClient does not yet expose issueMastercardToken (DESIGN.md §11.1)');
+        }
+        const raw = await this.client.issueMastercardToken({
+            agent_did: req.agentDid,
+            kind: req.kind,
+            params: req.params,
+        });
+        const kind = raw.kind ?? req.kind;
+        return {
+            tokenId: raw.token_id ?? raw.tokenId ?? '',
+            kind,
+            cap: raw.cap ?? '0',
+            expiresAt: raw.expires_at ?? raw.expiresAt ?? 0,
+            raw,
+        };
+    }
+}
+function normaliseReceipt(raw) {
+    // Real SDK PaymentReceipt is camelCase + decimal `amount`. Visa/Mastercard
+    // are typed `any` server-side and may include `txHash` / `tx_hash` on the
+    // gateway path; we accept both.
+    const r = (raw ?? {});
+    return {
+        receiptId: r.receiptId ?? r.receipt_id ?? r.id ?? '',
+        status: r.status ?? r.state ?? 'unknown',
+        ...(r.txHash !== undefined
+            ? { txHash: r.txHash }
+            : r.tx_hash !== undefined
+                ? { txHash: r.tx_hash }
+                : r.transaction_hash !== undefined
+                    ? { txHash: r.transaction_hash }
+                    : {}),
+        meta: r,
+    };
+}
+//# sourceMappingURL=payment-rails-adapter.js.map

package/dist/ports/agent/adapters/payment-rails-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-rails-adapter.js","sourceRoot":"","sources":["../../../../src/ports/agent/adapters/payment-rails-adapter.ts"],"names":[],"mappings":"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"}

package/dist/ports/agent/adapters/principal-chain-adapter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PrincipalChainSdkAdapter — wraps `PrincipalChainClient` for read-only
+ * access to receipt principal-chains (Spec 5) and controller activity
+ * aggregates.
+ *
+ * Wire:
+ *   getReceiptPrincipalChain  → PrincipalChainClient.getReceiptPrincipalChain(receiptId)
+ *   listReceiptsByActor       → PrincipalChainClient.listReceiptsByActor(actorDid)
+ *   listReceiptsByController  → PrincipalChainClient.listReceiptsByController(controllerDid)
+ *   summarizeController       → PrincipalChainClient.summarizeController(controllerDid)
+ */
+import type { PrincipalChainClient } from 'tenzro-sdk';
+import type { ControllerActivitySummaryRecord, PrincipalChainPort, PrincipalChainRecord, PrincipalChainSummaryRecord } from '../principal-chain.js';
+export type PrincipalChainClientLike = Pick<PrincipalChainClient, 'getReceiptPrincipalChain' | 'listReceiptsByActor' | 'listReceiptsByController' | 'summarizeController'>;
+export declare class PrincipalChainSdkAdapter implements PrincipalChainPort {
+    private readonly client;
+    constructor(client: PrincipalChainClientLike);
+    getReceiptPrincipalChain(receiptId: string): Promise<PrincipalChainRecord | null>;
+    listReceiptsByActor(actorDid: string): Promise<PrincipalChainSummaryRecord[]>;
+    listReceiptsByController(controllerDid: string): Promise<PrincipalChainSummaryRecord[]>;
+    summarizeController(controllerDid: string): Promise<ControllerActivitySummaryRecord | null>;
+}
+//# sourceMappingURL=principal-chain-adapter.d.ts.map