tapimo 0.0.2 → 0.2.0

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

@@ -0,0 +1,120 @@
+import type { Selectable } from 'kysely';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `sponsored_transactions` table, derived from `Schema.SponsoredTransaction`. */
+export type Table = db_Schema.SponsoredTransaction;
+/** A stored sponsored-transaction row. */
+export type Record = Selectable<Table>;
+/**
+ * Records one sponsorship commitment as `pending`, keyed by its fee-payer
+ * sign payload. Written after fee-payer signing and before any broadcast, so
+ * no sponsored transaction goes unrecorded; a later recording site for the
+ * same envelope (raw submission after a fill intent) upgrades the row with
+ * its transaction hash, reopening failed rows for finalization.
+ *
+ * @param db - The database.
+ * @param input - Attribution and envelope facts captured at signing time.
+ * @returns The stored record.
+ */
+export declare function upsert(db: Db.Db, input: upsert.Input): Promise<Record>;
+export declare namespace upsert {
+    /** Attribution and envelope facts recorded at sponsorship time. */
+    type Input = {
+        /** API key id (`key_…`) that requested sponsorship. */
+        apiKeyId: string;
+        /** Whether the sponsorship accrues billable spend; false for sandbox. */
+        billable: boolean;
+        /** Chain the sponsored transaction targets. */
+        chainId: number;
+        /** Key environment the sponsorship was requested under. */
+        environment: Table['environment'];
+        /** Fee token the sponsorship resolved, when known. */
+        feeToken?: string | undefined;
+        /** Organization id (`org_…`) the spend attributes to. */
+        orgId: string;
+        /** Project id (`prj_…`) the spend attributes to. */
+        projectId: string;
+        /** Fee-payer sign payload — a stable identity for the sponsored envelope. */
+        signPayload: string;
+        /** Serialized sponsored transaction, kept for observability beyond log retention. */
+        transaction: string;
+        /** Transaction hash; omit for fill intents, whose senders have not signed yet. */
+        transactionHash?: string | undefined;
+    };
+}
+/**
+ * Reads one sponsorship row by id.
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @returns The record, or `undefined` when absent.
+ */
+export declare function get(db: Db.Db, id: string): Promise<Record | undefined>;
+/**
+ * Lists pending sponsorships, oldest first, for the finalization job.
+ *
+ * @param db - The database.
+ * @param options - Paging options.
+ * @returns The pending records.
+ */
+export declare function listPending(db: Db.Db, options?: listPending.Options): Promise<Record[]>;
+export declare namespace listPending {
+    /** Options for {@link listPending}. */
+    type Options = {
+        /** Maximum rows to return. */
+        limit?: number | undefined;
+    };
+}
+/**
+ * Lists hash-less fill intents, oldest first, for the reconciliation pass.
+ * Failed intents are included only when the caller supplies a recovery floor.
+ *
+ * @param db - The database.
+ * @param options - Paging options.
+ * @returns The pending intents.
+ */
+export declare function listIntents(db: Db.Db, options?: listIntents.Options): Promise<Record[]>;
+export declare namespace listIntents {
+    /** Options for {@link listIntents}. */
+    type Options = listPending.Options & {
+        /** Include failed intents whose terminal timestamp is at or after this ISO timestamp. */
+        failedSince?: string | undefined;
+    };
+}
+/**
+ * Fills a reconciled intent's transaction hash and reopens failed intents.
+ * A no-op once another pass already assigned the hash.
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @param transactionHash - The matched on-chain transaction hash.
+ */
+export declare function assignTransactionHash(db: Db.Db, id: string, transactionHash: string): Promise<void>;
+/**
+ * Transitions a pending sponsorship to `finalized` with the receipt's actual
+ * fee. A no-op when the row is no longer pending (idempotent re-runs).
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @param input - The finalized fee facts.
+ */
+export declare function finalize(db: Db.Db, id: string, input: finalize.Input): Promise<void>;
+export declare namespace finalize {
+    /** Fee facts resolved from the transaction receipt. */
+    type Input = {
+        /** Actual fee paid in fee-token base units. */
+        feeAmount: string;
+        /** When the sponsorship finalized (ISO 8601). */
+        finalizedAt: string;
+    };
+}
+/**
+ * Transitions a pending sponsorship to `failed` (never landed within the
+ * pending TTL). A no-op when the row is no longer pending.
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @param finalizedAt - When the sponsorship was marked failed (ISO 8601).
+ */
+export declare function fail(db: Db.Db, id: string, finalizedAt: string): Promise<void>;
+//# sourceMappingURL=sponsoredTransactions.d.ts.map

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

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

package/dist/db/tables/sponsoredTransactions.js

@@ -0,0 +1,161 @@
+import { sql } from 'kysely';
+import { nanoid } from 'nanoid';
+/**
+ * Records one sponsorship commitment as `pending`, keyed by its fee-payer
+ * sign payload. Written after fee-payer signing and before any broadcast, so
+ * no sponsored transaction goes unrecorded; a later recording site for the
+ * same envelope (raw submission after a fill intent) upgrades the row with
+ * its transaction hash, reopening failed rows for finalization.
+ *
+ * @param db - The database.
+ * @param input - Attribution and envelope facts captured at signing time.
+ * @returns The stored record.
+ */
+export async function upsert(db, input) {
+    const record = {
+        apiKeyId: input.apiKeyId,
+        billable: input.billable,
+        chainId: input.chainId,
+        createdAt: new Date().toISOString(),
+        environment: input.environment,
+        feeAmount: null,
+        feeToken: input.feeToken ?? null,
+        finalizedAt: null,
+        id: `stx_${nanoid()}`,
+        orgId: input.orgId,
+        projectId: input.projectId,
+        signPayload: input.signPayload,
+        status: 'pending',
+        transaction: input.transaction,
+        transactionHash: input.transactionHash ?? null,
+    };
+    return await db.kysely
+        .insertInto('sponsored_transactions')
+        .values(record)
+        .onConflict((oc) => oc.column('signPayload').doUpdateSet((eb) => ({
+        // A raw submission fills the intent's hash; a duplicate intent never
+        // clears an already-known hash.
+        transactionHash: eb.fn.coalesce(eb.ref('excluded.transactionHash'), eb.ref('sponsored_transactions.transactionHash')),
+        createdAt: sql `CASE WHEN ${eb.ref('sponsored_transactions.status')} = 'failed' THEN ${eb.ref('excluded.createdAt')} ELSE ${eb.ref('sponsored_transactions.createdAt')} END`,
+        finalizedAt: sql `CASE WHEN ${eb.ref('sponsored_transactions.status')} = 'failed' THEN NULL ELSE ${eb.ref('sponsored_transactions.finalizedAt')} END`,
+        status: sql `CASE WHEN ${eb.ref('sponsored_transactions.status')} = 'failed' THEN 'pending' ELSE ${eb.ref('sponsored_transactions.status')} END`,
+    })))
+        .returningAll()
+        .executeTakeFirstOrThrow();
+}
+/**
+ * Reads one sponsorship row by id.
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @returns The record, or `undefined` when absent.
+ */
+export function get(db, id) {
+    return db.kysely
+        .selectFrom('sponsored_transactions')
+        .selectAll()
+        .where('id', '=', id)
+        .executeTakeFirst();
+}
+/**
+ * Lists pending sponsorships, oldest first, for the finalization job.
+ *
+ * @param db - The database.
+ * @param options - Paging options.
+ * @returns The pending records.
+ */
+export function listPending(db, options = {}) {
+    let query = db.kysely
+        .selectFrom('sponsored_transactions')
+        .selectAll()
+        .where('status', '=', 'pending')
+        // `id` breaks same-millisecond `createdAt` ties for a deterministic scan.
+        .orderBy('createdAt', 'asc')
+        .orderBy('id', 'asc');
+    if (options.limit !== undefined)
+        query = query.limit(options.limit);
+    return query.execute();
+}
+/**
+ * Lists hash-less fill intents, oldest first, for the reconciliation pass.
+ * Failed intents are included only when the caller supplies a recovery floor.
+ *
+ * @param db - The database.
+ * @param options - Paging options.
+ * @returns The pending intents.
+ */
+export function listIntents(db, options = {}) {
+    let query = db.kysely
+        .selectFrom('sponsored_transactions')
+        .selectAll()
+        .where(intentStatus(options.failedSince))
+        .where('transactionHash', 'is', null)
+        // `pending` sorts after `failed`; descending keeps active intents first.
+        .orderBy('status', 'desc')
+        .orderBy('createdAt', 'asc')
+        .orderBy('id', 'asc');
+    if (options.limit !== undefined)
+        query = query.limit(options.limit);
+    return query.execute();
+}
+/**
+ * Fills a reconciled intent's transaction hash and reopens failed intents.
+ * A no-op once another pass already assigned the hash.
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @param transactionHash - The matched on-chain transaction hash.
+ */
+export async function assignTransactionHash(db, id, transactionHash) {
+    await db.kysely
+        .updateTable('sponsored_transactions')
+        .set({ finalizedAt: null, status: 'pending', transactionHash })
+        .where('id', '=', id)
+        .where('status', 'in', ['failed', 'pending'])
+        .where('transactionHash', 'is', null)
+        .execute();
+}
+/**
+ * Transitions a pending sponsorship to `finalized` with the receipt's actual
+ * fee. A no-op when the row is no longer pending (idempotent re-runs).
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @param input - The finalized fee facts.
+ */
+export async function finalize(db, id, input) {
+    await db.kysely
+        .updateTable('sponsored_transactions')
+        .set({ feeAmount: input.feeAmount, finalizedAt: input.finalizedAt, status: 'finalized' })
+        .where('id', '=', id)
+        .where('status', '=', 'pending')
+        .execute();
+}
+/**
+ * Transitions a pending sponsorship to `failed` (never landed within the
+ * pending TTL). A no-op when the row is no longer pending.
+ *
+ * @param db - The database.
+ * @param id - The sponsored-transaction id (`stx_…`).
+ * @param finalizedAt - When the sponsorship was marked failed (ISO 8601).
+ */
+export async function fail(db, id, finalizedAt) {
+    await db.kysely
+        .updateTable('sponsored_transactions')
+        .set({ finalizedAt, status: 'failed' })
+        .where('id', '=', id)
+        .where('status', '=', 'pending')
+        .execute();
+}
+/** Intent status predicate; failed rows are recovery candidates only briefly. */
+function intentStatus(failedSince) {
+    return (eb) => {
+        if (failedSince === undefined)
+            return eb('status', '=', 'pending');
+        return eb.or([
+            eb('status', '=', 'pending'),
+            eb.and([eb('status', '=', 'failed'), eb('finalizedAt', '>=', failedSince)]),
+        ]);
+    };
+}
+//# sourceMappingURL=sponsoredTransactions.js.map

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

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

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

@@ -0,0 +1,48 @@
+import type { Selectable } from 'kysely';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `users` table, derived from `Schema.User`. */
+export type Table = db_Schema.User;
+/** A stored user row. */
+export type Record = Selectable<Table>;
+/**
+ * Reads a user by id (`usr_…`).
+ *
+ * @param db - The database.
+ * @param id - The user id.
+ * @returns The record, or `undefined` when absent.
+ */
+export declare function get(db: Db.Db, id: string): Promise<Record | undefined>;
+/**
+ * Reads a user by wallet address (compared lowercase).
+ *
+ * @param db - The database.
+ * @param address - The wallet address.
+ * @returns The record, or `undefined` when absent.
+ */
+export declare function getByAddress(db: Db.Db, address: string): Promise<Record | undefined>;
+/**
+ * Inserts a user for `address` when absent and returns the stored record.
+ * Existing users are returned unchanged, so repeated sign-ins are idempotent.
+ *
+ * @param db - The database.
+ * @param input - The user to ensure.
+ * @returns The stored record.
+ */
+export declare function upsertByAddress(db: Db.Db, input: upsertByAddress.Input): Promise<Record>;
+export declare namespace upsertByAddress {
+    /** Fields accepted when ensuring a user. */
+    type Input = {
+        /** Wallet address that signed in (stored lowercase). */
+        address: string;
+    };
+}
+/**
+ * Sets a user's verified email, bumping `updatedAt`.
+ *
+ * @param db - The database.
+ * @param id - The user id (`usr_…`).
+ * @param email - The verified email.
+ */
+export declare function setEmail(db: Db.Db, id: string, email: string): Promise<void>;
+//# sourceMappingURL=users.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../src/db/tables/users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAGxC,OAAO,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,KAAK,KAAK,SAAS,MAAM,cAAc,CAAA;AAE9C,gEAAgE;AAChE,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAA;AAElC,yBAAyB;AACzB,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;AAEtC;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEtE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMpF;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F;AAED,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,4CAA4C;IAC5C,KAAK,KAAK,GAAG;QACX,wDAAwD;QACxD,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF"}

package/dist/db/tables/users.js

@@ -0,0 +1,65 @@
+import { nanoid } from 'nanoid';
+/**
+ * Reads a user by id (`usr_…`).
+ *
+ * @param db - The database.
+ * @param id - The user id.
+ * @returns The record, or `undefined` when absent.
+ */
+export function get(db, id) {
+    return db.kysely.selectFrom('users').selectAll().where('id', '=', id).executeTakeFirst();
+}
+/**
+ * Reads a user by wallet address (compared lowercase).
+ *
+ * @param db - The database.
+ * @param address - The wallet address.
+ * @returns The record, or `undefined` when absent.
+ */
+export function getByAddress(db, address) {
+    return db.kysely
+        .selectFrom('users')
+        .selectAll()
+        .where('address', '=', address.toLowerCase())
+        .executeTakeFirst();
+}
+/**
+ * Inserts a user for `address` when absent and returns the stored record.
+ * Existing users are returned unchanged, so repeated sign-ins are idempotent.
+ *
+ * @param db - The database.
+ * @param input - The user to ensure.
+ * @returns The stored record.
+ */
+export async function upsertByAddress(db, input) {
+    const address = input.address.toLowerCase();
+    const now = new Date().toISOString();
+    const inserted = await db.kysely
+        .insertInto('users')
+        .values({ address, createdAt: now, email: null, id: `usr_${nanoid()}`, updatedAt: now })
+        .onConflict((oc) => oc.column('address').doNothing())
+        .returningAll()
+        .executeTakeFirst();
+    if (inserted)
+        return inserted;
+    return db.kysely
+        .selectFrom('users')
+        .selectAll()
+        .where('address', '=', address)
+        .executeTakeFirstOrThrow();
+}
+/**
+ * Sets a user's verified email, bumping `updatedAt`.
+ *
+ * @param db - The database.
+ * @param id - The user id (`usr_…`).
+ * @param email - The verified email.
+ */
+export async function setEmail(db, id, email) {
+    await db.kysely
+        .updateTable('users')
+        .set({ email, updatedAt: new Date().toISOString() })
+        .where('id', '=', id)
+        .execute();
+}
+//# sourceMappingURL=users.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../../src/db/tables/users.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAW/B;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,EAAS,EAAE,EAAU;IACvC,OAAO,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,gBAAgB,EAAE,CAAA;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,EAAS,EAAE,OAAe;IACrD,OAAO,EAAE,CAAC,MAAM;SACb,UAAU,CAAC,OAAO,CAAC;SACnB,SAAS,EAAE;SACX,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;SAC5C,gBAAgB,EAAE,CAAA;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAS,EAAE,KAA4B;IAC3E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;IAC3C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,MAAM;SAC7B,UAAU,CAAC,OAAO,CAAC;SACnB,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;SACvF,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,CAAC;SACpD,YAAY,EAAE;SACd,gBAAgB,EAAE,CAAA;IACrB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,OAAO,EAAE,CAAC,MAAM;SACb,UAAU,CAAC,OAAO,CAAC;SACnB,SAAS,EAAE;SACX,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC;SAC9B,uBAAuB,EAAE,CAAA;AAC9B,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAS,EAAE,EAAU,EAAE,KAAa;IACjE,MAAM,EAAE,CAAC,MAAM;SACZ,WAAW,CAAC,OAAO,CAAC;SACpB,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;SACnD,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;SACpB,OAAO,EAAE,CAAA;AACd,CAAC"}

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

@@ -0,0 +1,53 @@
+import type { Selectable } from 'kysely';
+import type * as VerifiedTokens from '../../internal/VerifiedTokens.js';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `verified_tokens` table, derived from `Schema.VerifiedToken`. */
+export type Table = db_Schema.VerifiedToken;
+/** Columns of the `verified_token_lists` table, derived from `Schema.VerifiedTokenList`. */
+export type ListTable = db_Schema.VerifiedTokenList;
+/** A stored verified-token row. */
+export type Row = Selectable<Table>;
+/** A chain's list-level metadata. */
+export type Meta = Selectable<ListTable>;
+/**
+ * Reads a chain's list metadata — the "head" the soft-refresh cache compares
+ * versions against.
+ *
+ * @param db - The database.
+ * @param chainId - The chain id.
+ * @returns The metadata, or `undefined` when the chain has no list yet.
+ */
+export declare function head(db: Db.Db, chainId: number): Promise<Meta | undefined>;
+/**
+ * Reads a chain's tokens in canonical list order.
+ *
+ * @param db - The database.
+ * @param chainId - The chain id.
+ * @returns The rows.
+ */
+export declare function list(db: Db.Db, chainId: number): Promise<Row[]>;
+/**
+ * Publishes a chain's whole list: replaces its token rows (positions rewritten
+ * wholesale) and bumps the list metadata. Callers run this inside the
+ * per-chain publish lock/transaction, so the rewrite is atomic.
+ *
+ * @param db - The database (a transaction-scoped handle).
+ * @param chainId - The chain id.
+ * @param input - The validated list and its new version metadata.
+ */
+export declare function publish(db: Db.Db, chainId: number, input: publish.Input): Promise<void>;
+export declare namespace publish {
+    /** A validated list to publish. */
+    type Input = {
+        /** Tokens in canonical order (addresses lowercased by the domain layer). */
+        tokens: readonly VerifiedTokens.Token[];
+        /** ISO timestamp of the publish. */
+        updatedAt: string;
+        /** New opaque list version. */
+        version: string;
+    };
+}
+/** Maps a stored row to the domain token (null `logoUri` → absent field). */
+export declare function toToken(row: Row): VerifiedTokens.Token;
+//# sourceMappingURL=verifiedTokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifiedTokens.d.ts","sourceRoot":"","sources":["../../../src/db/tables/verifiedTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAGxC,OAAO,KAAK,KAAK,cAAc,MAAM,kCAAkC,CAAA;AACvE,OAAO,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,KAAK,KAAK,SAAS,MAAM,cAAc,CAAA;AAE9C,mFAAmF;AACnF,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAA;AAE3C,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAA;AAEnD,mCAAmC;AACnC,MAAM,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;AAEnC,qCAAqC;AACrC,MAAM,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;AAExC;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAM1E;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAO/D;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB7F;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,mCAAmC;IACnC,KAAK,KAAK,GAAG;QACX,4EAA4E;QAC5E,MAAM,EAAE,SAAS,cAAc,CAAC,KAAK,EAAE,CAAA;QACvC,oCAAoC;QACpC,SAAS,EAAE,MAAM,CAAA;QACjB,+BAA+B;QAC/B,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAAC,KAAK,CAUtD"}

package/dist/db/tables/verifiedTokens.js

@@ -0,0 +1,74 @@
+/**
+ * Reads a chain's list metadata — the "head" the soft-refresh cache compares
+ * versions against.
+ *
+ * @param db - The database.
+ * @param chainId - The chain id.
+ * @returns The metadata, or `undefined` when the chain has no list yet.
+ */
+export function head(db, chainId) {
+    return db.kysely
+        .selectFrom('verified_token_lists')
+        .selectAll()
+        .where('chainId', '=', chainId)
+        .executeTakeFirst();
+}
+/**
+ * Reads a chain's tokens in canonical list order.
+ *
+ * @param db - The database.
+ * @param chainId - The chain id.
+ * @returns The rows.
+ */
+export function list(db, chainId) {
+    return db.kysely
+        .selectFrom('verified_tokens')
+        .selectAll()
+        .where('chainId', '=', chainId)
+        .orderBy('position')
+        .execute();
+}
+/**
+ * Publishes a chain's whole list: replaces its token rows (positions rewritten
+ * wholesale) and bumps the list metadata. Callers run this inside the
+ * per-chain publish lock/transaction, so the rewrite is atomic.
+ *
+ * @param db - The database (a transaction-scoped handle).
+ * @param chainId - The chain id.
+ * @param input - The validated list and its new version metadata.
+ */
+export async function publish(db, chainId, input) {
+    await db.kysely.deleteFrom('verified_tokens').where('chainId', '=', chainId).execute();
+    if (input.tokens.length > 0)
+        await db.kysely
+            .insertInto('verified_tokens')
+            .values(input.tokens.map((token, position) => ({
+            address: token.address,
+            chainId,
+            currency: token.currency,
+            decimals: token.decimals,
+            logoUri: token.logoUri ?? null,
+            name: token.name,
+            position,
+            symbol: token.symbol,
+        })))
+            .execute();
+    await db.kysely
+        .insertInto('verified_token_lists')
+        .values({ chainId, updatedAt: input.updatedAt, version: input.version })
+        .onConflict((oc) => oc.column('chainId').doUpdateSet({ updatedAt: input.updatedAt, version: input.version }))
+        .execute();
+}
+/** Maps a stored row to the domain token (null `logoUri` → absent field). */
+export function toToken(row) {
+    return {
+        address: row.address,
+        currency: row.currency,
+        decimals: row.decimals,
+        id: row.address,
+        name: row.name,
+        symbol: row.symbol,
+        ...(row.logoUri === null ? {} : { logoUri: row.logoUri }),
+    };
+}
+//# sourceMappingURL=verifiedTokens.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifiedTokens.js","sourceRoot":"","sources":["../../../src/db/tables/verifiedTokens.ts"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAC,EAAS,EAAE,OAAe;IAC7C,OAAO,EAAE,CAAC,MAAM;SACb,UAAU,CAAC,sBAAsB,CAAC;SAClC,SAAS,EAAE;SACX,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC;SAC9B,gBAAgB,EAAE,CAAA;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,EAAS,EAAE,OAAe;IAC7C,OAAO,EAAE,CAAC,MAAM;SACb,UAAU,CAAC,iBAAiB,CAAC;SAC7B,SAAS,EAAE;SACX,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC;SAC9B,OAAO,CAAC,UAAU,CAAC;SACnB,OAAO,EAAE,CAAA;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAS,EAAE,OAAe,EAAE,KAAoB;IAC5E,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAA;IACtF,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACzB,MAAM,EAAE,CAAC,MAAM;aACZ,UAAU,CAAC,iBAAiB,CAAC;aAC7B,MAAM,CACL,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YACrC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ;YACR,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC,CACJ;aACA,OAAO,EAAE,CAAA;IACd,MAAM,EAAE,CAAC,MAAM;SACZ,UAAU,CAAC,sBAAsB,CAAC;SAClC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACvE,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CACjB,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CACzF;SACA,OAAO,EAAE,CAAA;AACd,CAAC;AAcD,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,GAAQ;IAC9B,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAkB;QAC/B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,EAAE,EAAE,GAAG,CAAC,OAAkB;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;KAC1D,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,71 @@
+import type { Selectable } from 'kysely';
+import type * as Webhooks from '../../internal/Webhooks.js';
+import type * as Db from '../Db.js';
+import type * as db_Schema from '../Schema.js';
+/** Columns of the `webhook_deliveries` table, derived from `Schema.WebhookDelivery`. */
+export type Table = db_Schema.WebhookDelivery;
+/** A stored webhook-delivery row. */
+export type Record = Selectable<Table>;
+/** Maps a stored row to the domain delivery (null columns → absent fields). */
+export declare function toDelivery(row: Record): Webhooks.Delivery;
+/**
+ * Inserts a delivery row from its domain value.
+ *
+ * @param db - The database.
+ * @param delivery - The delivery to insert.
+ * @param expiresAt - Retention deadline (ISO); the row is invisible past it.
+ */
+export declare function insert(db: Db.Db, delivery: Webhooks.Delivery, expiresAt: string): Promise<void>;
+/**
+ * Lists a subscription's unexpired deliveries, newest first, with keyset
+ * paging (`id < cursor` — ids embed a zero-padded timestamp, so lexical order
+ * is chronological).
+ *
+ * @param db - The database.
+ * @param subscriptionId - The owning subscription id (`wh_…`).
+ * @param options - Paging options plus the retention timestamp.
+ * @returns The deliveries.
+ */
+export declare function list(db: Db.Db, subscriptionId: string, options: list.Options): Promise<Webhooks.Delivery[]>;
+export declare namespace list {
+    /** Options for {@link list}. */
+    type Options = {
+        /** Return deliveries whose id sorts before this one (older entries). */
+        cursor?: string | undefined;
+        /** Maximum deliveries to return. */
+        limit?: number | undefined;
+        /** ISO timestamp retention is evaluated against. */
+        now: string;
+        /** Rows to skip from the head (positional pagination; exclusive with `cursor`). */
+        offset?: number | undefined;
+    };
+}
+/**
+ * Counts a subscription's unexpired deliveries.
+ *
+ * @param db - The database.
+ * @param subscriptionId - The owning subscription id (`wh_…`).
+ * @param now - ISO timestamp retention is evaluated against.
+ * @returns The count.
+ */
+export declare function count(db: Db.Db, subscriptionId: string, now: string): Promise<number>;
+/**
+ * Reads a single unexpired delivery scoped to its subscription.
+ *
+ * @param db - The database.
+ * @param subscriptionId - The owning subscription id (`wh_…`).
+ * @param deliveryId - The delivery id (`whd_…`).
+ * @param now - ISO timestamp retention is evaluated against.
+ * @returns The delivery, or `null` when absent.
+ */
+export declare function get(db: Db.Db, subscriptionId: string, deliveryId: string, now: string): Promise<Webhooks.Delivery | null>;
+/**
+ * Deletes deliveries past their retention deadline. Called best-effort from
+ * the poller tick.
+ *
+ * @param db - The database.
+ * @param now - ISO timestamp retention is evaluated against.
+ * @returns The number of rows deleted.
+ */
+export declare function pruneExpired(db: Db.Db, now: string): Promise<number>;
+//# sourceMappingURL=webhookDeliveries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhookDeliveries.d.ts","sourceRoot":"","sources":["../../../src/db/tables/webhookDeliveries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAExC,OAAO,KAAK,KAAK,QAAQ,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,KAAK,KAAK,SAAS,MAAM,cAAc,CAAA;AAE9C,wFAAwF;AACxF,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAA;AAE7C,qCAAqC;AACrC,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;AAEtC,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAczD;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CACxB,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,IAAI,CAAC,OAAO,GACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAW9B;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,gCAAgC;IAChC,KAAK,OAAO,GAAG;QACb,wEAAwE;QACxE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,oCAAoC;QACpC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1B,oDAAoD;QACpD,GAAG,EAAE,MAAM,CAAA;QACX,mFAAmF;QACnF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC5B,CAAA;CACF;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,GAAG,CACvB,EAAE,EAAE,EAAE,CAAC,EAAE,EACT,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,CASnC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM1E"}