tapimo 0.7.1 → 0.8.0

package/dist/db/tables/fundingDepositRequestObservations.js

@@ -0,0 +1,46 @@
+import { sql } from 'kysely';
+/** Gets observation timestamps for one provider request. */
+export function get(db, options) {
+    return db.kysely
+        .selectFrom('funding_deposit_request_observations')
+        .selectAll()
+        .where('depositAddressId', '=', options.depositAddressId)
+        .where('providerRequestId', '=', options.providerRequestId)
+        .executeTakeFirst();
+}
+/** Records when polling first observed each provider request. */
+export async function observePoll(db, options) {
+    const providerRequestIds = [...new Set(options.providerRequestIds)];
+    if (providerRequestIds.length === 0)
+        return [];
+    return db.kysely
+        .insertInto('funding_deposit_request_observations')
+        .values(providerRequestIds.map((providerRequestId) => ({
+        depositAddressId: options.depositAddressId,
+        pollObservedAt: options.observedAt,
+        providerRequestId,
+        webhookReceivedAt: null,
+    })))
+        .onConflict((oc) => oc.columns(['depositAddressId', 'providerRequestId']).doUpdateSet({
+        pollObservedAt: sql `LEAST(COALESCE(funding_deposit_request_observations.poll_observed_at, excluded.poll_observed_at), excluded.poll_observed_at)`,
+    }))
+        .returningAll()
+        .execute();
+}
+/** Records when Tempo first received an authenticated webhook for a provider request. */
+export function observeWebhook(db, options) {
+    return db.kysely
+        .insertInto('funding_deposit_request_observations')
+        .values({
+        depositAddressId: options.depositAddressId,
+        pollObservedAt: null,
+        providerRequestId: options.providerRequestId,
+        webhookReceivedAt: options.receivedAt,
+    })
+        .onConflict((oc) => oc.columns(['depositAddressId', 'providerRequestId']).doUpdateSet({
+        webhookReceivedAt: sql `LEAST(COALESCE(funding_deposit_request_observations.webhook_received_at, excluded.webhook_received_at), excluded.webhook_received_at)`,
+    }))
+        .returningAll()
+        .executeTakeFirst();
+}
+//# sourceMappingURL=fundingDepositRequestObservations.js.map

package/dist/db/tables/fundingDepositRequestObservations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fundingDepositRequestObservations.js","sourceRoot":"","sources":["../../../src/db/tables/fundingDepositRequestObservations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAmB,MAAM,QAAQ,CAAA;AAW7C,4DAA4D;AAC5D,MAAM,UAAU,GAAG,CAAC,EAAS,EAAE,OAAoB;IACjD,OAAO,EAAE,CAAC,MAAM;SACb,UAAU,CAAC,sCAAsC,CAAC;SAClD,SAAS,EAAE;SACX,KAAK,CAAC,kBAAkB,EAAE,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC;SACxD,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,OAAO,CAAC,iBAAiB,CAAC;SAC1D,gBAAgB,EAAE,CAAA;AACvB,CAAC;AAYD,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAS,EAAE,OAA4B;IACvE,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAA;IACnE,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC9C,OAAO,EAAE,CAAC,MAAM;SACb,UAAU,CAAC,sCAAsC,CAAC;SAClD,MAAM,CACL,kBAAkB,CAAC,GAAG,CAAC,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAC7C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,cAAc,EAAE,OAAO,CAAC,UAAU;QAClC,iBAAiB;QACjB,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC,CACJ;SACA,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CACjB,EAAE,CAAC,OAAO,CAAC,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,CAAC,WAAW,CAAC;QAChE,cAAc,EAAE,GAAG,CAAQ,8HAA8H;KAC1J,CAAC,CACH;SACA,YAAY,EAAE;SACd,OAAO,EAAE,CAAA;AACd,CAAC;AAcD,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAC5B,EAAS,EACT,OAA+B;IAE/B,OAAO,EAAE,CAAC,MAAM;SACb,UAAU,CAAC,sCAAsC,CAAC;SAClD,MAAM,CAAC;QACN,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,cAAc,EAAE,IAAI;QACpB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,iBAAiB,EAAE,OAAO,CAAC,UAAU;KACtC,CAAC;SACD,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CACjB,EAAE,CAAC,OAAO,CAAC,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,CAAC,WAAW,CAAC;QAChE,iBAAiB,EAAE,GAAG,CAAQ,uIAAuI;KACtK,CAAC,CACH;SACA,YAAY,EAAE;SACd,gBAAgB,EAAE,CAAA;AACvB,CAAC"}

package/dist/db/tables/fundingDeposits.d.ts

@@ -0,0 +1,171 @@
+import { type JSONColumnType, type Selectable } from 'kysely';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `funding_deposits` table. */
+export type Table = Omit<db_Schema.FundingDeposit, 'providerRequestIds' | 'providerTransactionHashes'> & {
+    /** Private provider request identifiers stored as JSON. */
+    providerRequestIds: JSONColumnType<readonly string[], string, string>;
+    /** Private provider transaction references stored as JSON. */
+    providerTransactionHashes: JSONColumnType<readonly string[], string, string>;
+};
+/** A stored funding deposit. */
+export type Record = Selectable<Table>;
+/** Ownership filter inherited from the deposit address. */
+export type Owner = {
+    /** Key environment. */
+    environment: Record['environment'];
+    /** Owning organization id (`org_…`). */
+    orgId: string;
+    /** Attributed project id for project-scoped API keys. */
+    projectId?: string | undefined;
+};
+/** Inserts one provider-observed source transfer as a funding deposit. */
+export declare function insert(db: Db.Db, record: Record): Promise<Record>;
+/** Inserts a chain-observed source transfer or returns its existing deposit. */
+export declare function insertOrGetSource(db: Db.Db, record: Record & {
+    sourceTransferIndex: number;
+}): Promise<insertOrGetSource.Result>;
+export declare namespace insertOrGetSource {
+    /** Result of idempotently persisting one verified source transfer. */
+    type Result = {
+        record: Record;
+        type: 'created' | 'existing';
+    };
+}
+/** Serializes source attribution for one address and transaction. */
+export declare function withSourceTransaction<const result>(db: Db.Db, options: withSourceTransaction.Options<result>): Promise<result>;
+export declare namespace withSourceTransaction {
+    /** Source identity and transaction-scoped work protected by its advisory lock. */
+    type Options<result> = {
+        /** Funding deposit address that received the transfer. */
+        depositAddressId: string;
+        /** Database work serialized for the source transaction. */
+        fn: (db: Db.Db) => Promise<result>;
+        /** Source transaction whose deposit attribution must not race. */
+        sourceTransactionHash: string;
+    };
+}
+/** Gets deposits created from one provider-observed source transaction. */
+export declare function listByProviderObservation(db: Db.Db, options: listByProviderObservation.Options): Promise<Record[]>;
+export declare namespace listByProviderObservation {
+    /** Provider observation fields that identify one source transaction. */
+    type Options = {
+        /** Funding deposit address that received the transfer. */
+        depositAddressId: string;
+        /** Provider request that reported the transfer. */
+        providerRequestId: string;
+        /** Provider-observed source transaction reference. */
+        sourceTransactionHash: string;
+    };
+}
+/** Attaches first-observation timestamps to every deposit from one provider request. */
+export declare function recordRequestObservation(db: Db.Db, options: recordRequestObservation.Options): Promise<Record[]>;
+export declare namespace recordRequestObservation {
+    /** First observations associated with one provider request. */
+    type Options = {
+        /** Funding deposit address id (`fda_…`). */
+        depositAddressId: string;
+        /** When polling first observed the provider request. */
+        pollObservedAt?: string | undefined;
+        /** Provider request identifier. */
+        providerRequestId: string;
+        /** When Tempo first received an authenticated provider webhook. */
+        webhookReceivedAt?: string | undefined;
+    };
+}
+/** Gets deposits associated with one address and source transaction. */
+export declare function listBySourceTransaction(db: Db.Db, options: listBySourceTransaction.Options): Promise<Record[]>;
+export declare namespace listBySourceTransaction {
+    /** Source transaction fields scoped to one deposit address. */
+    type Options = {
+        /** Funding deposit address that received the transfer. */
+        depositAddressId: string;
+        /** Provider-observed source transaction reference. */
+        sourceTransactionHash: string;
+    };
+}
+/** Returns whether an address has a nonterminal source transfer awaiting provider attribution. */
+export declare function hasUnattributed(db: Db.Db, depositAddressId: string): Promise<boolean>;
+/** Gets a funding deposit without ownership scoping. */
+export declare function get(db: Db.Db, id: string): Promise<Record | undefined>;
+/** Gets an owner-visible funding deposit. */
+export declare function getOwned(db: Db.Db, owner: Owner, id: string): Promise<Record | undefined>;
+/** Lists one owner-visible address's deposits newest-first. */
+export declare function listByAddress(db: Db.Db, owner: Owner, addressId: string, options: listByAddress.Options): Promise<Record[]>;
+export declare namespace listByAddress {
+    /** Cursor fields for the last deposit returned by the previous page. */
+    type Cursor = {
+        /** Deposit creation time. */
+        createdAt: string;
+        /** Deposit id, used as a deterministic tie-breaker. */
+        id: string;
+    };
+    /** Paging options for one address's deposits. */
+    type Options = {
+        /** Exclusive lower bound from the previous page. */
+        cursor?: Cursor | undefined;
+        /** Maximum rows to return. */
+        limit: number;
+    };
+}
+/** Lists one recipient's owner-visible deposits newest-first. */
+export declare function listByRecipient(db: Db.Db, options: listByRecipient.Options): Promise<Record[]>;
+export declare namespace listByRecipient {
+    /** Recipient filter, ownership, and paging options. */
+    type Options = {
+        /** Exclusive lower bound from the previous page. */
+        cursor?: listByAddress.Cursor | undefined;
+        /** Maximum rows to return. */
+        limit: number;
+        /** Ownership filter derived from the authenticated API key. */
+        owner: Owner;
+        /** Tempo account that receives completed deposits. */
+        recipient: string;
+    };
+}
+/** Applies a version-guarded deposit update. */
+export declare function update(db: Db.Db, options: update.Options): Promise<Record | undefined>;
+export declare namespace update {
+    /** Guarded deposit update fields. */
+    type Options = {
+        /** Stored version required for the update. */
+        expectedVersion: number;
+        /** Funding deposit id (`fdp_…`). */
+        id: string;
+        /** Provider output amount confirmed on Tempo. */
+        providerOutputAmount: Record['providerOutputAmount'];
+        /** Provider request that first reported the deposit. */
+        providerRequestId: Record['providerRequestId'];
+        /** Private provider request identifiers. */
+        providerRequestIds: Record['providerRequestIds'];
+        /** Bounded private provider state. */
+        providerState: Record['providerState'];
+        /** Provider-leg transaction references. */
+        providerTransactionHashes: Record['providerTransactionHashes'];
+        /** Deposit position within the provider request. */
+        providerTransferIndex: Record['providerTransferIndex'];
+        /** Bounded private retry state. */
+        retryState: Record['retryState'];
+        /** Persisted settlement transaction bytes for exactly-once rebroadcast. */
+        settlementTransaction: Record['settlementTransaction'];
+        /** Persisted settlement transaction hash. */
+        settlementTransactionHash: Record['settlementTransactionHash'];
+        /** Replacement public snapshot. */
+        snapshot: Record['snapshot'];
+        /** Verified transfer position in the source transaction, or null. */
+        sourceTransferIndex: Record['sourceTransferIndex'];
+        /** Replacement lifecycle status. */
+        status: Record['status'];
+        /** Replacement customer-safe reason. */
+        statusReason: Record['statusReason'];
+        /** Destination token amount supplied by Tempo. */
+        subsidyAmount: Record['subsidyAmount'];
+        /** Tempo gas paid for settlement, in base units. */
+        tempoGasPaid: Record['tempoGasPaid'];
+        /** New material update time. */
+        updatedAt: string;
+        /** New material version. */
+        version: number;
+    };
+}
+//# sourceMappingURL=fundingDeposits.d.ts.map

package/dist/db/tables/fundingDeposits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fundingDeposits.d.ts","sourceRoot":"","sources":["../../../src/db/tables/fundingDeposits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AAElE,OAAO,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,KAAK,KAAK,SAAS,MAAM,cAAc,CAAA;AAE9C,+CAA+C;AAC/C,MAAM,MAAM,KAAK,GAAG,IAAI,CACtB,SAAS,CAAC,cAAc,EACxB,oBAAoB,GAAG,2BAA2B,CACnD,GAAG;IACF,2DAA2D;IAC3D,kBAAkB,EAAE,cAAc,CAAC,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACrE,8DAA8D;IAC9D,yBAAyB,EAAE,cAAc,CAAC,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7E,CAAA;AAED,gCAAgC;AAChC,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;AAEtC,2DAA2D;AAC3D,MAAM,MAAM,KAAK,GAAG;IAClB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;IAClC,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUjE;AAED,gFAAgF;AAChF,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,MAAM,EAAE,MAAM,GAAG;IAAE,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAsBnC;AAED,MAAM,CAAC,OAAO,WAAW,iBAAiB,CAAC;IACzC,sEAAsE;IACtE,KAAK,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,CAAA;CAC/D;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAChD,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,GAC7C,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,MAAM,CAAC,OAAO,WAAW,qBAAqB,CAAC;IAC7C,kFAAkF;IAClF,KAAK,OAAO,CAAC,MAAM,IAAI;QACrB,0DAA0D;QAC1D,gBAAgB,EAAE,MAAM,CAAA;QACxB,2DAA2D;QAC3D,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QAClC,kEAAkE;QAClE,qBAAqB,EAAE,MAAM,CAAA;KAC9B,CAAA;CACF;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,yBAAyB,CAAC,OAAO,GACzC,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB;AAED,MAAM,CAAC,OAAO,WAAW,yBAAyB,CAAC;IACjD,wEAAwE;IACxE,KAAK,OAAO,GAAG;QACb,0DAA0D;QAC1D,gBAAgB,EAAE,MAAM,CAAA;QACxB,mDAAmD;QACnD,iBAAiB,EAAE,MAAM,CAAA;QACzB,sDAAsD;QACtD,qBAAqB,EAAE,MAAM,CAAA;KAC9B,CAAA;CACF;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,wBAAwB,CAAC,OAAO,GACxC,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBnB;AAED,MAAM,CAAC,OAAO,WAAW,wBAAwB,CAAC;IAChD,+DAA+D;IAC/D,KAAK,OAAO,GAAG;QACb,4CAA4C;QAC5C,gBAAgB,EAAE,MAAM,CAAA;QACxB,wDAAwD;QACxD,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACnC,mCAAmC;QACnC,iBAAiB,EAAE,MAAM,CAAA;QACzB,mEAAmE;QACnE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACvC,CAAA;CACF;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,uBAAuB,CAAC,OAAO,GACvC,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAED,MAAM,CAAC,OAAO,WAAW,uBAAuB,CAAC;IAC/C,+DAA+D;IAC/D,KAAK,OAAO,GAAG;QACb,0DAA0D;QAC1D,gBAAgB,EAAE,MAAM,CAAA;QACxB,sDAAsD;QACtD,qBAAqB,EAAE,MAAM,CAAA;KAC9B,CAAA;CACF;AAED,kGAAkG;AAClG,wBAAsB,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW3F;AAED,wDAAwD;AACxD,wBAAgB,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMtE;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CASzF;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,CAAC,OAAO,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AAED,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,wEAAwE;IACxE,KAAK,MAAM,GAAG;QACZ,6BAA6B;QAC7B,SAAS,EAAE,MAAM,CAAA;QACjB,uDAAuD;QACvD,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;IAED,iDAAiD;IACjD,KAAK,OAAO,GAAG;QACb,oDAAoD;QACpD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,8BAA8B;QAC9B,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiB9F;AAED,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,uDAAuD;IACvD,KAAK,OAAO,GAAG;QACb,oDAAoD;QACpD,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAA;QACzC,8BAA8B;QAC9B,KAAK,EAAE,MAAM,CAAA;QACb,+DAA+D;QAC/D,KAAK,EAAE,KAAK,CAAA;QACZ,sDAAsD;QACtD,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAED,gDAAgD;AAChD,wBAAgB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA0BtF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,qCAAqC;IACrC,KAAK,OAAO,GAAG;QACb,8CAA8C;QAC9C,eAAe,EAAE,MAAM,CAAA;QACvB,oCAAoC;QACpC,EAAE,EAAE,MAAM,CAAA;QACV,iDAAiD;QACjD,oBAAoB,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAA;QACpD,wDAAwD;QACxD,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAA;QAC9C,4CAA4C;QAC5C,kBAAkB,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAA;QAChD,sCAAsC;QACtC,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,CAAA;QACtC,2CAA2C;QAC3C,yBAAyB,EAAE,MAAM,CAAC,2BAA2B,CAAC,CAAA;QAC9D,oDAAoD;QACpD,qBAAqB,EAAE,MAAM,CAAC,uBAAuB,CAAC,CAAA;QACtD,mCAAmC;QACnC,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QAChC,2EAA2E;QAC3E,qBAAqB,EAAE,MAAM,CAAC,uBAAuB,CAAC,CAAA;QACtD,6CAA6C;QAC7C,yBAAyB,EAAE,MAAM,CAAC,2BAA2B,CAAC,CAAA;QAC9D,mCAAmC;QACnC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QAC5B,qEAAqE;QACrE,mBAAmB,EAAE,MAAM,CAAC,qBAAqB,CAAC,CAAA;QAClD,oCAAoC;QACpC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QACxB,wCAAwC;QACxC,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;QACpC,kDAAkD;QAClD,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,CAAA;QACtC,oDAAoD;QACpD,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;QACpC,gCAAgC;QAChC,SAAS,EAAE,MAAM,CAAA;QACjB,4BAA4B;QAC5B,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF"}

package/dist/db/tables/fundingDeposits.js

@@ -0,0 +1,182 @@
+import { sql } from 'kysely';
+/** Inserts one provider-observed source transfer as a funding deposit. */
+export function insert(db, record) {
+    return db.kysely
+        .insertInto('funding_deposits')
+        .values({
+        ...record,
+        providerRequestIds: JSON.stringify(record.providerRequestIds),
+        providerTransactionHashes: JSON.stringify(record.providerTransactionHashes),
+    })
+        .returningAll()
+        .executeTakeFirstOrThrow();
+}
+/** Inserts a chain-observed source transfer or returns its existing deposit. */
+export async function insertOrGetSource(db, record) {
+    const inserted = await db.kysely
+        .insertInto('funding_deposits')
+        .values({
+        ...record,
+        providerRequestIds: JSON.stringify(record.providerRequestIds),
+        providerTransactionHashes: JSON.stringify(record.providerTransactionHashes),
+    })
+        .onConflict((oc) => oc.columns(['depositAddressId', 'sourceTransactionHash', 'sourceTransferIndex']).doNothing())
+        .returningAll()
+        .executeTakeFirst();
+    if (inserted)
+        return { record: inserted, type: 'created' };
+    const existing = await db.kysely
+        .selectFrom('funding_deposits')
+        .selectAll()
+        .where('depositAddressId', '=', record.depositAddressId)
+        .where('sourceTransactionHash', '=', record.sourceTransactionHash)
+        .where('sourceTransferIndex', '=', record.sourceTransferIndex)
+        .executeTakeFirstOrThrow();
+    return { record: existing, type: 'existing' };
+}
+/** Serializes source attribution for one address and transaction. */
+export function withSourceTransaction(db, options) {
+    return db.transaction(async (tx) => {
+        const key = `${options.depositAddressId}:${options.sourceTransactionHash.toLowerCase()}`;
+        await sql `SELECT pg_advisory_xact_lock(hashtextextended(${key}, 0))`.execute(tx.kysely);
+        return options.fn(tx);
+    });
+}
+/** Gets deposits created from one provider-observed source transaction. */
+export function listByProviderObservation(db, options) {
+    return db.kysely
+        .selectFrom('funding_deposits')
+        .selectAll()
+        .where('depositAddressId', '=', options.depositAddressId)
+        .where('providerRequestId', '=', options.providerRequestId)
+        .where('sourceTransactionHash', '=', options.sourceTransactionHash)
+        .orderBy('providerTransferIndex', 'asc')
+        .execute();
+}
+/** Attaches first-observation timestamps to every deposit from one provider request. */
+export function recordRequestObservation(db, options) {
+    return db.kysely
+        .updateTable('funding_deposits')
+        .set({
+        ...(options.pollObservedAt
+            ? {
+                pollObservedAt: sql `LEAST(COALESCE(poll_observed_at, ${options.pollObservedAt}), ${options.pollObservedAt})`,
+            }
+            : {}),
+        ...(options.webhookReceivedAt
+            ? {
+                webhookReceivedAt: sql `LEAST(COALESCE(webhook_received_at, ${options.webhookReceivedAt}), ${options.webhookReceivedAt})`,
+            }
+            : {}),
+    })
+        .where('depositAddressId', '=', options.depositAddressId)
+        .where('providerRequestId', '=', options.providerRequestId)
+        .returningAll()
+        .execute();
+}
+/** Gets deposits associated with one address and source transaction. */
+export function listBySourceTransaction(db, options) {
+    return db.kysely
+        .selectFrom('funding_deposits')
+        .selectAll()
+        .where('depositAddressId', '=', options.depositAddressId)
+        .where('sourceTransactionHash', '=', options.sourceTransactionHash)
+        .orderBy('sourceTransferIndex', 'asc')
+        .execute();
+}
+/** Returns whether an address has a nonterminal source transfer awaiting provider attribution. */
+export async function hasUnattributed(db, depositAddressId) {
+    return Boolean(await db.kysely
+        .selectFrom('funding_deposits')
+        .select('id')
+        .where('depositAddressId', '=', depositAddressId)
+        .where('providerRequestId', 'is', null)
+        .where('status', 'not in', ['completed', 'refunded'])
+        .limit(1)
+        .executeTakeFirst());
+}
+/** Gets a funding deposit without ownership scoping. */
+export function get(db, id) {
+    return db.kysely
+        .selectFrom('funding_deposits')
+        .selectAll()
+        .where('id', '=', id)
+        .executeTakeFirst();
+}
+/** Gets an owner-visible funding deposit. */
+export function getOwned(db, owner, id) {
+    let query = db.kysely
+        .selectFrom('funding_deposits')
+        .selectAll()
+        .where('environment', '=', owner.environment)
+        .where('id', '=', id)
+        .where('orgId', '=', owner.orgId);
+    if (owner.projectId !== undefined)
+        query = query.where('projectId', '=', owner.projectId);
+    return query.executeTakeFirst();
+}
+/** Lists one owner-visible address's deposits newest-first. */
+export function listByAddress(db, owner, addressId, options) {
+    const { cursor, limit } = options;
+    let query = db.kysely
+        .selectFrom('funding_deposits')
+        .selectAll()
+        .where('depositAddressId', '=', addressId)
+        .where('environment', '=', owner.environment)
+        .where('orgId', '=', owner.orgId);
+    if (owner.projectId !== undefined)
+        query = query.where('projectId', '=', owner.projectId);
+    if (cursor)
+        query = query.where((eb) => eb.or([
+            eb('createdAt', '<', cursor.createdAt),
+            eb.and([eb('createdAt', '=', cursor.createdAt), eb('id', '<', cursor.id)]),
+        ]));
+    return query.orderBy('createdAt', 'desc').orderBy('id', 'desc').limit(limit).execute();
+}
+/** Lists one recipient's owner-visible deposits newest-first. */
+export function listByRecipient(db, options) {
+    const { cursor, limit, owner, recipient } = options;
+    let query = db.kysely
+        .selectFrom('funding_deposits')
+        .selectAll()
+        .where('environment', '=', owner.environment)
+        .where('orgId', '=', owner.orgId)
+        .where(sql `lower(snapshot->>'recipient') = ${recipient.toLowerCase()}`);
+    if (owner.projectId !== undefined)
+        query = query.where('projectId', '=', owner.projectId);
+    if (cursor)
+        query = query.where((eb) => eb.or([
+            eb('createdAt', '<', cursor.createdAt),
+            eb.and([eb('createdAt', '=', cursor.createdAt), eb('id', '<', cursor.id)]),
+        ]));
+    return query.orderBy('createdAt', 'desc').orderBy('id', 'desc').limit(limit).execute();
+}
+/** Applies a version-guarded deposit update. */
+export function update(db, options) {
+    return db.kysely
+        .updateTable('funding_deposits')
+        .set({
+        providerOutputAmount: options.providerOutputAmount,
+        providerRequestId: options.providerRequestId,
+        providerRequestIds: JSON.stringify(options.providerRequestIds),
+        providerState: options.providerState,
+        providerTransactionHashes: JSON.stringify(options.providerTransactionHashes),
+        providerTransferIndex: options.providerTransferIndex,
+        retryState: options.retryState,
+        settlementTransaction: options.settlementTransaction,
+        settlementTransactionHash: options.settlementTransactionHash,
+        snapshot: options.snapshot,
+        sourceTransferIndex: options.sourceTransferIndex,
+        status: options.status,
+        statusReason: options.statusReason,
+        subsidyAmount: options.subsidyAmount,
+        tempoGasPaid: options.tempoGasPaid,
+        updatedAt: options.updatedAt,
+        version: options.version,
+    })
+        .where('id', '=', options.id)
+        .where('version', '=', options.expectedVersion)
+        .returningAll()
+        .executeTakeFirst();
+}
+//# sourceMappingURL=fundingDeposits.js.map

package/dist/db/tables/fundingDeposits.js.map

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

package/dist/db/tables/fundingIdempotency.d.ts

@@ -0,0 +1,91 @@
+import type { Selectable } from 'kysely';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `funding_idempotency_requests` table. */
+export type Table = db_Schema.FundingIdempotencyRequest;
+/** A stored idempotency claim. */
+export type Record = Selectable<Table>;
+/**
+ * Claims `(apiKeyId, keyHash)` for one creation attempt. A live claim rejects
+ * mismatches, blocks pending work, resumes checkpoints, or replays completion.
+ */
+export declare function claim(db: Db.Db, input: claim.Input): Promise<claim.Result>;
+export declare namespace claim {
+    /** Claim identity and retention. */
+    type Input = {
+        /** API key id (`key_…`) the claim is scoped to. */
+        apiKeyId: string;
+        /** SHA-256 of the caller Idempotency-Key. */
+        keyHash: string;
+        /** SHA-256 fingerprint of the canonical validated request. */
+        requestHash: string;
+        /** Lease duration for the pending execution, in milliseconds. */
+        ttlMs: number;
+    };
+    /** Outcome of a claim attempt. */
+    type Result = {
+        createdAt: string;
+        type: 'claimed';
+    } | {
+        type: 'mismatch';
+    } | {
+        type: 'pending';
+    } | {
+        response: string;
+        type: 'replay';
+    } | {
+        createdAt: string;
+        response: string;
+        type: 'resume';
+    };
+}
+/** Stores a provider result before committing its API resource and replay response. */
+export declare function checkpoint(db: Db.Db, input: checkpoint.Input): Promise<Record | undefined>;
+export declare namespace checkpoint {
+    /** Provider result and owned claim required for durable recovery. */
+    type Input = {
+        /** API key id (`key_…`) the claim is scoped to. */
+        apiKeyId: string;
+        /** Creation time returned by the successful claim. */
+        createdAt: string;
+        /** SHA-256 of the caller Idempotency-Key. */
+        keyHash: string;
+        /** Recovery checkpoint retention in milliseconds. */
+        replayTtlMs: number;
+        /** Serialized provider result required to resume resource creation. */
+        response: string;
+    };
+}
+/** Completes an owned pending or provisioned claim with its replay response. */
+export declare function complete(db: Db.Db, input: complete.Input): Promise<Record | undefined>;
+export declare namespace complete {
+    /** Completion fields. */
+    type Input = {
+        /** API key id (`key_…`) the claim is scoped to. */
+        apiKeyId: string;
+        /** Creation time returned by the successful claim. */
+        createdAt: string;
+        /** SHA-256 of the caller Idempotency-Key. */
+        keyHash: string;
+        /** Successful-response replay retention from completion, in milliseconds. */
+        replayTtlMs: number;
+        /** Serialized success response replayed for the retention window. */
+        response: string;
+        /** Transfer id (`ftr_…`) when the request created a funding transfer. */
+        transferId?: string | undefined;
+    };
+}
+/** Releases a pending claim after a retryable failure. */
+export declare function release(db: Db.Db, input: release.Input): Promise<void>;
+export declare namespace release {
+    /** Pending claim identity. */
+    type Input = {
+        /** API key id (`key_…`) the claim is scoped to. */
+        apiKeyId: string;
+        /** Creation time returned by the successful claim. */
+        createdAt: string;
+        /** SHA-256 of the caller Idempotency-Key. */
+        keyHash: string;
+    };
+}
+//# sourceMappingURL=fundingIdempotency.d.ts.map

package/dist/db/tables/fundingIdempotency.d.ts.map

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

package/dist/db/tables/fundingIdempotency.js

@@ -0,0 +1,103 @@
+/**
+ * Claims `(apiKeyId, keyHash)` for one creation attempt. A live claim rejects
+ * mismatches, blocks pending work, resumes checkpoints, or replays completion.
+ */
+export async function claim(db, input) {
+    const now = new Date();
+    const record = {
+        apiKeyId: input.apiKeyId,
+        createdAt: now.toISOString(),
+        expiresAt: new Date(now.getTime() + input.ttlMs).toISOString(),
+        keyHash: input.keyHash,
+        requestHash: input.requestHash,
+        response: null,
+        status: 'pending',
+        transferId: null,
+    };
+    const inserted = await db.kysely
+        .insertInto('funding_idempotency_requests')
+        .values(record)
+        .onConflict((oc) => oc.columns(['apiKeyId', 'keyHash']).doNothing())
+        .returningAll()
+        .executeTakeFirst();
+    if (inserted)
+        return { createdAt: inserted.createdAt, type: 'claimed' };
+    // Reclaim an expired row in place; the guard keeps two callers from both
+    // reclaiming (only one UPDATE matches the still-expired predicate).
+    const reclaimed = await db.kysely
+        .updateTable('funding_idempotency_requests')
+        .set(record)
+        .where('apiKeyId', '=', input.apiKeyId)
+        .where('keyHash', '=', input.keyHash)
+        .where('expiresAt', '<=', now.toISOString())
+        .returningAll()
+        .executeTakeFirst();
+    if (reclaimed)
+        return { createdAt: reclaimed.createdAt, type: 'claimed' };
+    const existing = await db.kysely
+        .selectFrom('funding_idempotency_requests')
+        .selectAll()
+        .where('apiKeyId', '=', input.apiKeyId)
+        .where('keyHash', '=', input.keyHash)
+        .executeTakeFirst();
+    // The row vanished between the insert and the read (released claim); retry.
+    if (!existing)
+        return claim(db, input);
+    if (existing.requestHash !== input.requestHash)
+        return { type: 'mismatch' };
+    if (existing.status === 'pending')
+        return { type: 'pending' };
+    if (existing.status === 'provisioned')
+        return {
+            createdAt: existing.createdAt,
+            response: existing.response ?? '',
+            type: 'resume',
+        };
+    return { response: existing.response ?? '', type: 'replay' };
+}
+/** Stores a provider result before committing its API resource and replay response. */
+export function checkpoint(db, input) {
+    const now = new Date();
+    return db.kysely
+        .updateTable('funding_idempotency_requests')
+        .set({
+        expiresAt: new Date(now.getTime() + input.replayTtlMs).toISOString(),
+        response: input.response,
+        status: 'provisioned',
+    })
+        .where('apiKeyId', '=', input.apiKeyId)
+        .where('createdAt', '=', input.createdAt)
+        .where('keyHash', '=', input.keyHash)
+        .where('status', '=', 'pending')
+        .returningAll()
+        .executeTakeFirst();
+}
+/** Completes an owned pending or provisioned claim with its replay response. */
+export function complete(db, input) {
+    const now = new Date();
+    return db.kysely
+        .updateTable('funding_idempotency_requests')
+        .set({
+        expiresAt: new Date(now.getTime() + input.replayTtlMs).toISOString(),
+        response: input.response,
+        status: 'completed',
+        transferId: input.transferId ?? null,
+    })
+        .where('apiKeyId', '=', input.apiKeyId)
+        .where('createdAt', '=', input.createdAt)
+        .where('keyHash', '=', input.keyHash)
+        .where('status', 'in', ['pending', 'provisioned'])
+        .returningAll()
+        .executeTakeFirst();
+}
+/** Releases a pending claim after a retryable failure. */
+export async function release(db, input) {
+    await db.kysely
+        .deleteFrom('funding_idempotency_requests')
+        .where('apiKeyId', '=', input.apiKeyId)
+        .where('createdAt', '=', input.createdAt)
+        .where('keyHash', '=', input.keyHash)
+        .where('status', '=', 'pending')
+        .execute();
+}
+//# sourceMappingURL=fundingIdempotency.js.map

package/dist/db/tables/fundingIdempotency.js.map

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

package/dist/db/tables/fundingTransferEvents.d.ts

@@ -0,0 +1,12 @@
+import type { Selectable } from 'kysely';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `funding_transfer_events` table. */
+export type Table = db_Schema.FundingTransferEvent;
+/** One immutable public snapshot at a material version. */
+export type Record = Selectable<Table>;
+/** Inserts an event row. Callers commit it with its transfer row in one transaction. */
+export declare function insert(db: Db.Db, record: Record): Promise<Record>;
+/** Lists a transfer's events, oldest version first. */
+export declare function listByTransfer(db: Db.Db, transferId: string): Promise<Record[]>;
+//# sourceMappingURL=fundingTransferEvents.d.ts.map