tapimo 0.7.1 → 0.7.2

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

@@ -0,0 +1,56 @@
+import type { JSONColumnType } from 'kysely';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `funding_catalogs` table. */
+export type CatalogTable = db_Schema.FundingCatalog;
+/** Columns of the `funding_chains` table. */
+export type ChainTable = Omit<db_Schema.FundingChain, 'aliases' | 'rpcUrls'> & {
+    /** Caller-facing chain aliases stored as JSON. */
+    aliases: JSONColumnType<db_Schema.FundingChain['aliases'], string, string>;
+    /** Public RPC endpoints stored as JSON. */
+    rpcUrls: JSONColumnType<db_Schema.FundingChain['rpcUrls'], string, string>;
+};
+/** Columns of the `funding_tokens` table. */
+export type TokenTable = db_Schema.FundingToken;
+/** Columns of the `funding_chain_tokens` table. */
+export type ChainTokenTable = db_Schema.FundingChainToken;
+/** Columns of the `funding_routes` table. */
+export type RouteTable = db_Schema.FundingRoute;
+/** A route row whose `capabilities` may be absent (validated input, fixtures). */
+export type RouteRow = Omit<db_Schema.FundingRoute, 'capabilities'> & {
+    /** Executable capability; absent and null both mean indicative-only. */
+    capabilities?: db_Schema.FundingRoute['capabilities'] | undefined;
+};
+/** Stored funding catalog rows and version metadata. */
+export type Rows = {
+    /** Current catalog metadata, or undefined before the first publish. */
+    catalog: db_Schema.FundingCatalog | undefined;
+    /** Chain-scoped funding token rows. */
+    chainTokens: readonly db_Schema.FundingChainToken[];
+    /** Funding chain rows. */
+    chains: readonly db_Schema.FundingChain[];
+    /** Funding provider route rows. */
+    routes: readonly RouteRow[];
+    /** Funding token rows. */
+    tokens: readonly db_Schema.FundingToken[];
+};
+/** Reads the current funding catalog version metadata. */
+export declare function head(db: Db.Db): Promise<db_Schema.FundingCatalog | undefined>;
+/** Reads every row in the current funding catalog. */
+export declare function read(db: Db.Db): Promise<Rows>;
+/** Replaces the complete funding catalog and advances its version. */
+export declare function publish(db: Db.Db, input: publish.Input): Promise<db_Schema.FundingCatalog>;
+export declare namespace publish {
+    /** Complete validated funding catalog rows. */
+    type Input = {
+        /** Chain-scoped funding token rows. */
+        chainTokens: readonly db_Schema.FundingChainToken[];
+        /** Funding chain rows. */
+        chains: readonly db_Schema.FundingChain[];
+        /** Funding provider route rows. */
+        routes: readonly RouteRow[];
+        /** Funding token rows. */
+        tokens: readonly db_Schema.FundingToken[];
+    };
+}
+//# sourceMappingURL=fundingCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fundingCatalog.d.ts","sourceRoot":"","sources":["../../../src/db/tables/fundingCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAI5C,OAAO,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,KAAK,KAAK,SAAS,MAAM,cAAc,CAAA;AAK9C,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,cAAc,CAAA;AAEnD,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG;IAC7E,kDAAkD;IAClD,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1E,2CAA2C;IAC3C,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3E,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,CAAA;AAE/C,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,iBAAiB,CAAA;AAEzD,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,CAAA;AAE/C,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,cAAc,CAAC,GAAG;IACpE,wEAAwE;IACxE,YAAY,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;CAClE,CAAA;AAED,wDAAwD;AACxD,MAAM,MAAM,IAAI,GAAG;IACjB,uEAAuE;IACvE,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,SAAS,CAAA;IAC7C,uCAAuC;IACvC,WAAW,EAAE,SAAS,SAAS,CAAC,iBAAiB,EAAE,CAAA;IACnD,0BAA0B;IAC1B,MAAM,EAAE,SAAS,SAAS,CAAC,YAAY,EAAE,CAAA;IACzC,mCAAmC;IACnC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,SAAS,SAAS,CAAC,YAAY,EAAE,CAAA;CAC1C,CAAA;AAED,0DAA0D;AAC1D,wBAAsB,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,CAMnF;AAED,sDAAsD;AACtD,wBAAgB,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7C;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAiD1F;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,+CAA+C;IAC/C,KAAK,KAAK,GAAG;QACX,uCAAuC;QACvC,WAAW,EAAE,SAAS,SAAS,CAAC,iBAAiB,EAAE,CAAA;QACnD,0BAA0B;QAC1B,MAAM,EAAE,SAAS,SAAS,CAAC,YAAY,EAAE,CAAA;QACzC,mCAAmC;QACnC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAA;QAC3B,0BAA0B;QAC1B,MAAM,EAAE,SAAS,SAAS,CAAC,YAAY,EAAE,CAAA;KAC1C,CAAA;CACF"}

package/dist/db/tables/fundingCatalog.js

@@ -0,0 +1,85 @@
+import { sql } from 'kysely';
+import { Hex } from 'ox';
+const catalogId = 'default';
+const publishLockKey = 0x66636174;
+/** Reads the current funding catalog version metadata. */
+export async function head(db) {
+    return db.kysely
+        .selectFrom('funding_catalogs')
+        .selectAll()
+        .where('id', '=', catalogId)
+        .executeTakeFirst();
+}
+/** Reads every row in the current funding catalog. */
+export function read(db) {
+    return db.transaction(async (tx) => {
+        await sql `SELECT pg_advisory_xact_lock(${publishLockKey})`.execute(tx.kysely);
+        const catalog = await head(tx);
+        const chains = await tx.kysely.selectFrom('funding_chains').selectAll().orderBy('id').execute();
+        const tokens = await tx.kysely.selectFrom('funding_tokens').selectAll().orderBy('id').execute();
+        const chainTokens = await tx.kysely
+            .selectFrom('funding_chain_tokens')
+            .selectAll()
+            .orderBy('chainId')
+            .orderBy('tokenId')
+            .execute();
+        const routes = await tx.kysely
+            .selectFrom('funding_routes')
+            .selectAll()
+            .orderBy('providerId')
+            .orderBy('sourceChainId')
+            .orderBy('sourceTokenId')
+            .orderBy('destinationChainId')
+            .orderBy('destinationTokenId')
+            .execute();
+        return { catalog, chainTokens, chains, routes, tokens };
+    });
+}
+/** Replaces the complete funding catalog and advances its version. */
+export function publish(db, input) {
+    return db.transaction(async (tx) => {
+        await sql `SELECT pg_advisory_xact_lock(${publishLockKey})`.execute(tx.kysely);
+        const catalog = {
+            id: catalogId,
+            updatedAt: new Date().toISOString(),
+            version: nextVersion(),
+        };
+        await tx.kysely.deleteFrom('funding_routes').execute();
+        await tx.kysely.deleteFrom('funding_chain_tokens').execute();
+        await tx.kysely.deleteFrom('funding_tokens').execute();
+        await tx.kysely.deleteFrom('funding_chains').execute();
+        if (input.chains.length > 0)
+            await tx.kysely
+                .insertInto('funding_chains')
+                .values(input.chains.map((chain) => ({
+                ...chain,
+                aliases: JSON.stringify(chain.aliases),
+                rpcUrls: JSON.stringify(chain.rpcUrls),
+            })))
+                .execute();
+        if (input.tokens.length > 0)
+            await tx.kysely.insertInto('funding_tokens').values(input.tokens).execute();
+        if (input.chainTokens.length > 0)
+            await tx.kysely.insertInto('funding_chain_tokens').values(input.chainTokens).execute();
+        if (input.routes.length > 0)
+            await tx.kysely
+                .insertInto('funding_routes')
+                .values(input.routes.map((route) => ({ ...route, capabilities: route.capabilities ?? null })))
+                .execute();
+        await tx.kysely
+            .insertInto('funding_catalogs')
+            .values(catalog)
+            .onConflict((oc) => oc.column('id').doUpdateSet({
+            updatedAt: catalog.updatedAt,
+            version: catalog.version,
+        }))
+            .execute();
+        return catalog;
+    });
+}
+let lastVersionMs = 0;
+function nextVersion() {
+    lastVersionMs = Math.max(Date.now(), lastVersionMs + 1);
+    return `${lastVersionMs.toString().padStart(15, '0')}_${Hex.random(4).slice(2)}`;
+}
+//# sourceMappingURL=fundingCatalog.js.map

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

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

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

@@ -0,0 +1,159 @@
+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_deposit_addresses` table. */
+export type Table = Omit<db_Schema.FundingDepositAddress, 'providerRequestIds'> & {
+    /** Private provider request identifiers stored as JSON. */
+    providerRequestIds: JSONColumnType<readonly string[], string, string>;
+};
+/** A stored funding deposit address. */
+export type Record = Selectable<Table>;
+/** Ownership filter derived from the authenticated API key. */
+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;
+};
+/** Identity fields that make one reusable address match a caller request. */
+export type Match = Owner & {
+    /** Customer destination token key. */
+    destinationTokenKey: string;
+    /** Tempo account that receives completed deposits. */
+    recipient: string;
+    /** Source-chain account that receives refunds. */
+    refundAddress: string;
+    /** Source chain CAIP-2 id. */
+    sourceChainId: string;
+    /** Source token key. */
+    sourceTokenKey: string;
+    /** Whether Tempo guarantees normalized 1:1 delivery. */
+    subsidize: boolean;
+};
+/** Inserts a provisioned funding deposit address. */
+export declare function insert(db: Db.Db, record: Record): Promise<Record>;
+/** Inserts an address or returns the concurrently-created matching resource. */
+export declare function insertOrGet(db: Db.Db, options: insertOrGet.Options): Promise<Record>;
+export declare namespace insertOrGet {
+    /** Record and stable identity used by create-or-get. */
+    type Options = {
+        /** Stable customer-visible address identity. */
+        match: Match;
+        /** Provisioned address record to insert. */
+        record: Record;
+    };
+}
+/** Gets a funding deposit address without ownership scoping. */
+export declare function get(db: Db.Db, id: string): Promise<Record | undefined>;
+/** Gets a funding deposit address by its provider-owned address. */
+export declare function getByProviderAddress(db: Db.Db, options: getByProviderAddress.Options): Promise<Record | undefined>;
+export declare namespace getByProviderAddress {
+    /** Provider address identity received from a reconciliation trigger. */
+    type Options = {
+        /** Provider-owned reusable deposit address. */
+        address: string;
+        /** Funding provider id. */
+        providerId: string;
+    };
+}
+/** Gets an owner-visible funding deposit address. */
+export declare function getOwned(db: Db.Db, owner: Owner, id: string): Promise<Record | undefined>;
+/** Gets the reusable address that matches one owner and route identity. */
+export declare function getMatching(db: Db.Db, match: Match): Promise<Record | undefined>;
+/** Claims a bounded batch of active addresses due for provider reconciliation. */
+export declare function claimDue(db: Db.Db, options: claimDue.Options): Promise<readonly Record[]>;
+export declare namespace claimDue {
+    /** Provider and lease bounds for one reconciliation claim. */
+    type Options = {
+        /** Exclusive upper bound on rows claimed in one tick. */
+        limit: number;
+        /** Expiry time assigned to each claimed lease. */
+        leaseUntil: string;
+        /** Current time used for due and expired-lease comparisons. */
+        now: string;
+        /** Funding provider whose addresses should be claimed. */
+        providerId: string;
+    };
+}
+/** Claims one active address unless another reconciliation owns its lease. */
+export declare function claim(db: Db.Db, options: claim.Options): Promise<Record | undefined>;
+export declare namespace claim {
+    /** Identity and lease bounds for one reconciliation claim. */
+    type Options = {
+        /** Funding deposit address id (`fda_…`). */
+        id: string;
+        /** Expiry time assigned to the claimed lease. */
+        leaseUntil: string;
+        /** Current time used for expired-lease comparison. */
+        now: string;
+    };
+}
+/** Extends an active reconciliation lease without changing its fence. */
+export declare function renewPoll(db: Db.Db, options: renewPoll.Options): Promise<boolean>;
+export declare namespace renewPoll {
+    /** Lease identity and renewed expiry guarded by the current fence. */
+    type Options = {
+        /** Funding deposit address id (`fda_…`). */
+        id: string;
+        /** Replacement reconciliation lease expiry. */
+        leaseUntil: string;
+        /** Fencing token returned by the claim operation. */
+        pollLeaseVersion: number;
+    };
+}
+/** Completes an owned reconciliation lease and schedules the address again. */
+export declare function completePoll(db: Db.Db, options: completePoll.Options): Promise<Record | undefined>;
+export declare namespace completePoll {
+    /** Successful reconciliation result guarded by the claimed lease version. */
+    type Options = {
+        /** Funding deposit address id (`fda_…`). */
+        id: string;
+        /** Time when provider reconciliation completed. */
+        lastPolledAt: string;
+        /** Time when this address becomes due again. */
+        nextPollAt: string;
+        /** Fencing token returned by {@link claimDue}. */
+        pollLeaseVersion: number;
+        /** Provider request identifiers retained from address provisioning. */
+        providerRequestIds: readonly string[];
+        /** Bounded provider reconciliation state. */
+        providerState: Record['providerState'];
+    };
+}
+/** Releases an owned reconciliation lease after failure and schedules a retry. */
+export declare function failPoll(db: Db.Db, options: failPoll.Options): Promise<Record | undefined>;
+export declare namespace failPoll {
+    /** Failed reconciliation result guarded by the claimed lease version. */
+    type Options = {
+        /** Funding deposit address id (`fda_…`). */
+        id: string;
+        /** Time when this address becomes eligible for retry. */
+        nextPollAt: string;
+        /** Fencing token returned by {@link claimDue}. */
+        pollLeaseVersion: number;
+    };
+}
+/** Applies a version-guarded deposit address status update. */
+export declare function update(db: Db.Db, options: update.Options): Promise<Record | undefined>;
+export declare namespace update {
+    /** Guarded address update fields. */
+    type Options = {
+        /** Stored version required for the update. */
+        expectedVersion: number;
+        /** Funding deposit address id (`fda_…`). */
+        id: string;
+        /** Replacement lifecycle status. */
+        status: Record['status'];
+        /** New material update time. */
+        updatedAt: string;
+        /** New material version. */
+        version: number;
+    };
+}
+/** Provider address conflicted with a different customer-visible identity. */
+export declare class ConflictError extends Error {
+    name: string;
+}
+//# sourceMappingURL=fundingDepositAddresses.d.ts.map

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

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

package/dist/db/tables/fundingDepositAddresses.js

@@ -0,0 +1,206 @@
+import { sql } from 'kysely';
+import * as pg from 'pg';
+/** Inserts a provisioned funding deposit address. */
+export function insert(db, record) {
+    return db.kysely
+        .insertInto('funding_deposit_addresses')
+        .values({
+        ...record,
+        providerRequestIds: JSON.stringify(record.providerRequestIds),
+    })
+        .returningAll()
+        .executeTakeFirstOrThrow();
+}
+/** Inserts an address or returns the concurrently-created matching resource. */
+export async function insertOrGet(db, options) {
+    const record = await db.kysely
+        .insertInto('funding_deposit_addresses')
+        .values({
+        ...options.record,
+        providerRequestIds: JSON.stringify(options.record.providerRequestIds),
+    })
+        .onConflict((oc) => oc
+        .columns([
+        'orgId',
+        'environment',
+        'projectId',
+        'sourceChainId',
+        'sourceTokenKey',
+        'destinationTokenKey',
+        'recipient',
+        'refundAddress',
+        'subsidize',
+    ])
+        .doNothing())
+        .returningAll()
+        .executeTakeFirst()
+        .catch((cause) => {
+        if (cause instanceof pg.DatabaseError &&
+            cause.code === '23505' &&
+            cause.constraint === 'funding_deposit_addresses_provider_address_key')
+            throw new ConflictError();
+        throw cause;
+    });
+    if (record)
+        return record;
+    const existing = await getMatching(db, options.match);
+    if (existing)
+        return existing;
+    throw new ConflictError();
+}
+/** Gets a funding deposit address without ownership scoping. */
+export function get(db, id) {
+    return db.kysely
+        .selectFrom('funding_deposit_addresses')
+        .selectAll()
+        .where('id', '=', id)
+        .executeTakeFirst();
+}
+/** Gets a funding deposit address by its provider-owned address. */
+export function getByProviderAddress(db, options) {
+    const address = /^0x[0-9a-fA-F]{40}$/.test(options.address)
+        ? options.address.toLowerCase()
+        : options.address;
+    return db.kysely
+        .selectFrom('funding_deposit_addresses')
+        .selectAll()
+        .where('address', '=', address)
+        .where('providerId', '=', options.providerId)
+        .executeTakeFirst();
+}
+/** Gets an owner-visible funding deposit address. */
+export function getOwned(db, owner, id) {
+    let query = db.kysely
+        .selectFrom('funding_deposit_addresses')
+        .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();
+}
+/** Gets the reusable address that matches one owner and route identity. */
+export function getMatching(db, match) {
+    let query = db.kysely
+        .selectFrom('funding_deposit_addresses')
+        .selectAll()
+        .where('destinationTokenKey', '=', match.destinationTokenKey)
+        .where('environment', '=', match.environment)
+        .where('orgId', '=', match.orgId)
+        .where('recipient', '=', match.recipient)
+        .where('refundAddress', '=', match.refundAddress)
+        .where('sourceChainId', '=', match.sourceChainId)
+        .where('sourceTokenKey', '=', match.sourceTokenKey)
+        .where('subsidize', '=', match.subsidize);
+    query =
+        match.projectId === undefined
+            ? query.where('projectId', 'is', null)
+            : query.where('projectId', '=', match.projectId);
+    return query.executeTakeFirst();
+}
+/** Claims a bounded batch of active addresses due for provider reconciliation. */
+export function claimDue(db, options) {
+    return db.transaction(async (tx) => {
+        const due = await tx.kysely
+            .selectFrom('funding_deposit_addresses')
+            .select('id')
+            .where('nextPollAt', '<=', options.now)
+            .where('providerId', '=', options.providerId)
+            .where('status', '=', 'active')
+            .where((eb) => eb.or([eb('pollLeaseUntil', 'is', null), eb('pollLeaseUntil', '<=', options.now)]))
+            .orderBy('nextPollAt', 'asc')
+            .orderBy('id', 'asc')
+            .limit(options.limit)
+            .forUpdate()
+            .skipLocked()
+            .execute();
+        if (due.length === 0)
+            return [];
+        return tx.kysely
+            .updateTable('funding_deposit_addresses')
+            .set({
+            pollLeaseUntil: options.leaseUntil,
+            pollLeaseVersion: sql `poll_lease_version + 1`,
+        })
+            .where('id', 'in', due.map((record) => record.id))
+            .returningAll()
+            .execute();
+    });
+}
+/** Claims one active address unless another reconciliation owns its lease. */
+export function claim(db, options) {
+    return db.kysely
+        .updateTable('funding_deposit_addresses')
+        .set({
+        pollLeaseUntil: options.leaseUntil,
+        pollLeaseVersion: sql `poll_lease_version + 1`,
+    })
+        .where('id', '=', options.id)
+        .where('status', '=', 'active')
+        .where((eb) => eb.or([eb('pollLeaseUntil', 'is', null), eb('pollLeaseUntil', '<=', options.now)]))
+        .returningAll()
+        .executeTakeFirst();
+}
+/** Extends an active reconciliation lease without changing its fence. */
+export async function renewPoll(db, options) {
+    return Boolean(await db.kysely
+        .updateTable('funding_deposit_addresses')
+        .set({ pollLeaseUntil: options.leaseUntil })
+        .where('id', '=', options.id)
+        .where('pollLeaseUntil', 'is not', null)
+        .where('pollLeaseVersion', '=', options.pollLeaseVersion)
+        .where('status', '=', 'active')
+        .returning('id')
+        .executeTakeFirst());
+}
+/** Completes an owned reconciliation lease and schedules the address again. */
+export function completePoll(db, options) {
+    return db.kysely
+        .updateTable('funding_deposit_addresses')
+        .set({
+        lastPolledAt: options.lastPolledAt,
+        nextPollAt: options.nextPollAt,
+        pollFailureCount: 0,
+        pollLeaseUntil: null,
+        providerRequestIds: JSON.stringify(options.providerRequestIds),
+        providerState: options.providerState,
+    })
+        .where('id', '=', options.id)
+        .where('pollLeaseVersion', '=', options.pollLeaseVersion)
+        .returningAll()
+        .executeTakeFirst();
+}
+/** Releases an owned reconciliation lease after failure and schedules a retry. */
+export function failPoll(db, options) {
+    return db.kysely
+        .updateTable('funding_deposit_addresses')
+        .set({
+        nextPollAt: options.nextPollAt,
+        pollFailureCount: sql `poll_failure_count + 1`,
+        pollLeaseUntil: null,
+    })
+        .where('id', '=', options.id)
+        .where('pollLeaseVersion', '=', options.pollLeaseVersion)
+        .returningAll()
+        .executeTakeFirst();
+}
+/** Applies a version-guarded deposit address status update. */
+export function update(db, options) {
+    return db.kysely
+        .updateTable('funding_deposit_addresses')
+        .set({
+        status: options.status,
+        updatedAt: options.updatedAt,
+        version: options.version,
+    })
+        .where('id', '=', options.id)
+        .where('version', '=', options.expectedVersion)
+        .returningAll()
+        .executeTakeFirst();
+}
+/** Provider address conflicted with a different customer-visible identity. */
+export class ConflictError extends Error {
+    name = 'FundingDepositAddresses.ConflictError';
+}
+//# sourceMappingURL=fundingDepositAddresses.js.map

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

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

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

@@ -0,0 +1,115 @@
+import type { JSONColumnType, 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>;
+/** 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;
+    };
+}
+/** 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;
+    };
+}
+/** 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;
+    };
+}
+/** 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