@bsv/wallet-toolbox-mobile 2.1.24 → 3.0.0-alpha.0

package/out/src/storage/schema/monitorLease.d.ts

@@ -0,0 +1,57 @@
+import { Knex } from 'knex';
+import { TableMonitorLease } from './tables';
+/**
+ * monitor lease primitive.
+ *
+ * A `monitor_lease` row records the owner that may currently execute a named
+ * task. Acquisition is opportunistic: a Monitor calls `tryClaimLease()` to
+ * insert or take over a stale row; if it succeeds it owns the task until
+ * `expiresAt`. While running it calls `renewLease()` to extend the deadline.
+ * On clean shutdown it calls `releaseLease()`.
+ *
+ * The Knex driver expresses claim + takeover as a single conditional UPDATE
+ * so that two contending Monitors cannot both believe they own the task — at
+ * most one row write will succeed per (task, expiry) pair.
+ */
+export interface MonitorLeaseClaim {
+    taskName: string;
+    ownerId: string;
+    ttlMs: number;
+    note?: string;
+}
+export interface MonitorLeaseRenew {
+    taskName: string;
+    ownerId: string;
+    ttlMs: number;
+    note?: string;
+}
+export interface MonitorLeaseRelease {
+    taskName: string;
+    ownerId: string;
+}
+export interface MonitorLeaseResult {
+    acquired: boolean;
+    lease?: TableMonitorLease;
+}
+/**
+ * Try to claim a lease on `taskName`. Succeeds iff:
+ *   - no row exists for the task, OR
+ *   - the existing row has `expiresAt <= now`, OR
+ *   - the existing row's `ownerId` already equals the requested owner.
+ *
+ * On success the row is upserted with `expiresAt = now + ttlMs` and
+ * `renewCount = renewCount + 1` (0 for fresh rows).
+ */
+export declare function tryClaimLease(knex: Knex, claim: MonitorLeaseClaim, now?: Date): Promise<MonitorLeaseResult>;
+/**
+ * Extend the current owner's lease. Fails (returns `acquired: false`) when the
+ * row does not exist, is owned by someone else, or has already expired.
+ */
+export declare function renewLease(knex: Knex, renew: MonitorLeaseRenew, now?: Date): Promise<MonitorLeaseResult>;
+/**
+ * Release the lease (no-op when not owned by the caller).
+ * The row is deleted so subsequent claimants do not see an inherited
+ * `renew_count`.
+ */
+export declare function releaseLease(knex: Knex, release: MonitorLeaseRelease): Promise<boolean>;
+//# sourceMappingURL=monitorLease.d.ts.map

package/out/src/storage/schema/monitorLease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitorLease.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/monitorLease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,iBAAiB,CAAA;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,iBAAiB,EACxB,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAmC7B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,iBAAiB,EACxB,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAK9F"}

package/out/src/storage/schema/monitorLease.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryClaimLease = tryClaimLease;
+exports.renewLease = renewLease;
+exports.releaseLease = releaseLease;
+/**
+ * Try to claim a lease on `taskName`. Succeeds iff:
+ *   - no row exists for the task, OR
+ *   - the existing row has `expiresAt <= now`, OR
+ *   - the existing row's `ownerId` already equals the requested owner.
+ *
+ * On success the row is upserted with `expiresAt = now + ttlMs` and
+ * `renewCount = renewCount + 1` (0 for fresh rows).
+ */
+async function tryClaimLease(knex, claim, now = new Date()) {
+    const expiresAt = new Date(now.getTime() + claim.ttlMs);
+    return await knex.transaction(async (trx) => {
+        var _a, _b;
+        const existing = await trx('monitor_lease').where({ task_name: claim.taskName }).forUpdate().first();
+        const canClaim = existing == null ||
+            new Date(existing.expires_at).getTime() <= now.getTime() ||
+            existing.owner_id === claim.ownerId;
+        if (!canClaim)
+            return { acquired: false };
+        if (existing == null) {
+            await trx('monitor_lease').insert({
+                task_name: claim.taskName,
+                owner_id: claim.ownerId,
+                expires_at: expiresAt,
+                renew_count: 0,
+                note: (_a = claim.note) !== null && _a !== void 0 ? _a : null,
+                created_at: now,
+                updated_at: now
+            });
+        }
+        else {
+            await trx('monitor_lease')
+                .where({ task_name: claim.taskName })
+                .update({
+                owner_id: claim.ownerId,
+                expires_at: expiresAt,
+                renew_count: existing.owner_id === claim.ownerId ? existing.renew_count + 1 : 0,
+                note: (_b = claim.note) !== null && _b !== void 0 ? _b : existing.note,
+                updated_at: now
+            });
+        }
+        const row = await trx('monitor_lease').where({ task_name: claim.taskName }).first();
+        return { acquired: true, lease: mapRow(row) };
+    });
+}
+/**
+ * Extend the current owner's lease. Fails (returns `acquired: false`) when the
+ * row does not exist, is owned by someone else, or has already expired.
+ */
+async function renewLease(knex, renew, now = new Date()) {
+    const expiresAt = new Date(now.getTime() + renew.ttlMs);
+    return await knex.transaction(async (trx) => {
+        var _a;
+        const existing = await trx('monitor_lease').where({ task_name: renew.taskName }).forUpdate().first();
+        if (existing == null)
+            return { acquired: false };
+        if (existing.owner_id !== renew.ownerId)
+            return { acquired: false };
+        if (new Date(existing.expires_at).getTime() <= now.getTime())
+            return { acquired: false };
+        await trx('monitor_lease')
+            .where({ task_name: renew.taskName })
+            .update({
+            expires_at: expiresAt,
+            renew_count: existing.renew_count + 1,
+            note: (_a = renew.note) !== null && _a !== void 0 ? _a : existing.note,
+            updated_at: now
+        });
+        const row = await trx('monitor_lease').where({ task_name: renew.taskName }).first();
+        return { acquired: true, lease: mapRow(row) };
+    });
+}
+/**
+ * Release the lease (no-op when not owned by the caller).
+ * The row is deleted so subsequent claimants do not see an inherited
+ * `renew_count`.
+ */
+async function releaseLease(knex, release) {
+    const deleted = await knex('monitor_lease')
+        .where({ task_name: release.taskName, owner_id: release.ownerId })
+        .delete();
+    return deleted > 0;
+}
+function mapRow(row) {
+    var _a;
+    return {
+        created_at: new Date(row.created_at),
+        updated_at: new Date(row.updated_at),
+        taskName: row.task_name,
+        ownerId: row.owner_id,
+        expiresAt: new Date(row.expires_at),
+        renewCount: row.renew_count,
+        note: (_a = row.note) !== null && _a !== void 0 ? _a : undefined
+    };
+}
+//# sourceMappingURL=monitorLease.js.map

package/out/src/storage/schema/monitorLease.js.map

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

package/out/src/storage/schema/processingFsm.d.ts

@@ -0,0 +1,27 @@
+import * as sdk from '../../sdk';
+export interface FsmTransitionResult {
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * Returns true when `from -> to` is a permitted processing transition.
+ * Identity transitions (`from === to`) are always allowed — they represent a
+ * status refresh without state change.
+ */
+export declare function isValidProcessingTransition(from: sdk.ProcessingStatus, to: sdk.ProcessingStatus): boolean;
+/**
+ * As `isValidProcessingTransition` but returns a structured result with a
+ * human-readable reason for any rejection. Useful for `tx_audit` payloads.
+ */
+export declare function validateProcessingTransition(from: sdk.ProcessingStatus, to: sdk.ProcessingStatus): FsmTransitionResult;
+/** Snapshot of the transition table for documentation + tests. */
+export declare function processingTransitionMap(): Readonly<Record<sdk.ProcessingStatus, readonly sdk.ProcessingStatus[]>>;
+/**
+ * True when the given state implies the transaction has been seen / accepted
+ * by at least one network provider — the precondition for output spendability
+ * in §4.
+ */
+export declare function isProcessingSpendable(s: sdk.ProcessingStatus): boolean;
+/** True when the state is terminal (no further automatic transitions). */
+export declare function isProcessingTerminal(s: sdk.ProcessingStatus): boolean;
+//# sourceMappingURL=processingFsm.d.ts.map

package/out/src/storage/schema/processingFsm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processingFsm.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/processingFsm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAuDhC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,GACvB,mBAAmB,CAMrB;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,IAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAElH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAE,CAAC,EAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAEtE"}

package/out/src/storage/schema/processingFsm.js

@@ -0,0 +1,132 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidProcessingTransition = isValidProcessingTransition;
+exports.validateProcessingTransition = validateProcessingTransition;
+exports.processingTransitionMap = processingTransitionMap;
+exports.isProcessingSpendable = isProcessingSpendable;
+exports.isProcessingTerminal = isProcessingTerminal;
+const sdk = __importStar(require("../../sdk"));
+/**
+ * processing-state machine.
+ *
+ * Maps each `ProcessingStatus` to the set of states it may legally transition
+ * to. Terminal states (`confirmed`, `invalid`, `doubleSpend`) have no outgoing
+ * transitions except via the `unfail` operator override.
+ *
+ * The transition table is intentionally permissive — the goal is to *reject
+ * impossible* moves (e.g. `queued -> confirmed` without ever broadcasting) rather
+ * than to enumerate the happy path. Stateful preconditions (proof present,
+ * provider acknowledged) are enforced at the call site.
+ */
+const TRANSITIONS = {
+    // `queued -> doubleSpend`: a tx queued locally may be reported as a
+    // double-spend by the network before our first send attempt (e.g. another
+    // wallet broadcast the same outpoint first). See STORAGE_METHOD_WIRING §4
+    // legacy mapping `* -> doubleSpend (rejection)`.
+    queued: ['sending', 'sent', 'nosend', 'frozen', 'nonfinal', 'invalid', 'doubleSpend'],
+    sending: ['sent', 'seen', 'seen_multi', 'invalid', 'doubleSpend', 'frozen', 'queued'],
+    sent: ['seen', 'seen_multi', 'unconfirmed', 'confirmed', 'invalid', 'doubleSpend', 'frozen', 'sending'],
+    // `seen -> sending`: provider re-acknowledgment lost; legacy mapping
+    // `* -> sending (serviceError retry)` from STORAGE_METHOD_WIRING §4.
+    seen: ['seen_multi', 'unconfirmed', 'confirmed', 'invalid', 'doubleSpend', 'reorging', 'frozen', 'sending'],
+    // `seen_multi -> sending`: same retry semantics as `seen -> sending`.
+    seen_multi: ['unconfirmed', 'confirmed', 'invalid', 'doubleSpend', 'reorging', 'frozen', 'sending'],
+    // `unconfirmed -> doubleSpend`: a provider's proof candidate may be retracted
+    // when a competing tx is mined. `unconfirmed -> sending`: candidate failed
+    // chaintracks validation, restart broadcast attempts. Both per §4.
+    unconfirmed: ['confirmed', 'invalid', 'reorging', 'frozen', 'seen', 'seen_multi', 'doubleSpend', 'sending'],
+    confirmed: ['reorging'],
+    // Reorg rule (bsv_wallet_transaction_requirements v1.0 §5):
+    // "A reorg SHALL never cause a transaction to be marked Invalid or
+    // DoubleSpend." The reorging state is therefore restricted to recovery
+    // edges only — back to a confirmation-class state or to frozen for
+    // operator review. Callers that later determine the tx is genuinely
+    // invalid or a doubleSpend must first transition through `unconfirmed`
+    // (where the standard FSM edges to `invalid`/`doubleSpend` apply) so the
+    // rejection is recorded against a non-reorg cause in `tx_audit`.
+    reorging: ['confirmed', 'seen', 'seen_multi', 'unconfirmed', 'frozen'],
+    invalid: ['unfail'],
+    doubleSpend: ['unfail'],
+    unfail: ['queued', 'sending', 'sent', 'seen', 'seen_multi', 'unconfirmed', 'confirmed', 'invalid', 'doubleSpend'],
+    frozen: ['queued', 'sending', 'sent', 'seen', 'seen_multi', 'unconfirmed', 'invalid', 'doubleSpend'],
+    // `nosend -> sending`: operator (or processAction promotion) moves a
+    // never-broadcast tx into the active broadcast pipeline. `nosend ->
+    // doubleSpend`: an externally-broadcast nosend tx may be reported as a
+    // double-spend. Both per §4 legacy mapping.
+    nosend: ['queued', 'sending', 'sent', 'seen', 'invalid', 'doubleSpend', 'frozen'],
+    // `nonfinal -> doubleSpend`: a live-nLockTime tx may be replaced by a
+    // confirmed competing tx and reported as a double-spend.
+    nonfinal: ['queued', 'sending', 'sent', 'invalid', 'doubleSpend', 'frozen']
+};
+/**
+ * Returns true when `from -> to` is a permitted processing transition.
+ * Identity transitions (`from === to`) are always allowed — they represent a
+ * status refresh without state change.
+ */
+function isValidProcessingTransition(from, to) {
+    if (from === to)
+        return true;
+    return TRANSITIONS[from].includes(to);
+}
+/**
+ * As `isValidProcessingTransition` but returns a structured result with a
+ * human-readable reason for any rejection. Useful for `tx_audit` payloads.
+ */
+function validateProcessingTransition(from, to) {
+    if (isValidProcessingTransition(from, to))
+        return { ok: true };
+    return {
+        ok: false,
+        reason: `illegal transition ${from} -> ${to}; legal next: ${TRANSITIONS[from].join(', ')}`
+    };
+}
+/** Snapshot of the transition table for documentation + tests. */
+function processingTransitionMap() {
+    return TRANSITIONS;
+}
+/**
+ * True when the given state implies the transaction has been seen / accepted
+ * by at least one network provider — the precondition for output spendability
+ * in §4.
+ */
+function isProcessingSpendable(s) {
+    return sdk.ProcessingSpendableStatus.includes(s);
+}
+/** True when the state is terminal (no further automatic transitions). */
+function isProcessingTerminal(s) {
+    return sdk.ProcessingTerminalStatus.includes(s);
+}
+//# sourceMappingURL=processingFsm.js.map

package/out/src/storage/schema/processingFsm.js.map

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

package/out/src/storage/schema/tables/TableAction.d.ts

@@ -0,0 +1,38 @@
+import * as sdk from '../../../sdk';
+/**
+ * per-user view of a transaction.
+ *
+ * Migrated from the legacy `transactions` table. Holds everything that is truly
+ * per-user (description, labels via tx_labels_map -> actionId, soft-delete flags,
+ * notification subscribers). All on-chain status lives in the new `transactions`
+ * table addressed by `transactionId`.
+ *
+ * UNIQUE(userId, transactionId).
+ */
+export interface TableAction extends sdk.EntityTimeStamp {
+    created_at: Date;
+    updated_at: Date;
+    /** PK */
+    actionId: number;
+    userId: number;
+    /** FK -> new transactions.transactionId (per-txid record) */
+    transactionId: number;
+    /** Application reference, hex/Base64, max 64 chars */
+    reference: string;
+    description: string;
+    /** true if originated in this wallet (change returns to it) */
+    isOutgoing: boolean;
+    /** Signed net change to this user's balance from this action */
+    satoshisDelta: number;
+    /** Per-user nosend override */
+    userNosend: boolean;
+    /** Soft-delete flag — hide from default queries */
+    hidden: boolean;
+    /** Per-user abort flag */
+    userAborted: boolean;
+    /** JSON string of per-user notification subscribers (mirrors legacy notify) */
+    notifyJson?: string;
+    /** Optimistic concurrency token */
+    rowVersion: number;
+}
+//# sourceMappingURL=TableAction.d.ts.map

package/out/src/storage/schema/tables/TableAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableAction.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAY,SAAQ,GAAG,CAAC,eAAe;IACtD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAA;IACnB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAA;IACnB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAA;IACf,0BAA0B;IAC1B,WAAW,EAAE,OAAO,CAAA;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/out/src/storage/schema/tables/TableAction.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TableAction.js.map

package/out/src/storage/schema/tables/TableAction.js.map

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

package/out/src/storage/schema/tables/TableCertificate.d.ts

@@ -1,5 +1,6 @@
 import { Base64String, HexString, OutpointString, PubKeyHex } from '@bsv/sdk';
-import { sdk, TableCertificateField } from '../../../index.client';
+import * as sdk from '../../../sdk';
+import { TableCertificateField } from './TableCertificateField';
 export interface TableCertificate extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;

package/out/src/storage/schema/tables/TableCertificate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableCertificate.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableCertificate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC7E,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,MAAM,WAAW,gBAAiB,SAAQ,GAAG,CAAC,eAAe;IAC3D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,SAAS,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,kBAAkB,EAAE,cAAc,CAAA;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACjC"}
+{"version":3,"file":"TableCertificate.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableCertificate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC7E,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,MAAM,WAAW,gBAAiB,SAAQ,GAAG,CAAC,eAAe;IAC3D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,SAAS,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,kBAAkB,EAAE,cAAc,CAAA;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACjC"}

package/out/src/storage/schema/tables/TableCertificateField.d.ts

@@ -1,5 +1,5 @@
 import { Base64String } from '@bsv/sdk';
-import { sdk } from '../../../index.client';
+import * as sdk from '../../../sdk';
 export interface TableCertificateField extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;

package/out/src/storage/schema/tables/TableCertificateField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableCertificateField.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableCertificateField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,MAAM,WAAW,qBAAsB,SAAQ,GAAG,CAAC,eAAe;IAChE,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,YAAY,CAAA;CACxB"}
+{"version":3,"file":"TableCertificateField.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableCertificateField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,qBAAsB,SAAQ,GAAG,CAAC,eAAe;IAChE,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,YAAY,CAAA;CACxB"}

package/out/src/storage/schema/tables/TableChainTip.d.ts

@@ -0,0 +1,17 @@
+import * as sdk from '../../../sdk';
+/**
+ * singleton row tracking the most recently observed chain tip.
+ * Used by spendability checks and coinbase maturity calculations.
+ */
+export interface TableChainTip extends sdk.EntityTimeStamp {
+    created_at: Date;
+    updated_at: Date;
+    /** Always 1 — singleton enforced by storage layer */
+    id: number;
+    height: number;
+    blockHash: string;
+    merkleRoot?: string;
+    /** Wall-clock of the observation */
+    observedAt: Date;
+}
+//# sourceMappingURL=TableChainTip.d.ts.map

package/out/src/storage/schema/tables/TableChainTip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableChainTip.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableChainTip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,GAAG,CAAC,eAAe;IACxD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,UAAU,EAAE,IAAI,CAAA;CACjB"}

package/out/src/storage/schema/tables/TableChainTip.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TableChainTip.js.map

package/out/src/storage/schema/tables/TableChainTip.js.map

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

package/out/src/storage/schema/tables/TableCommission.d.ts

@@ -1,4 +1,4 @@
-import { sdk } from '../../../index.client';
+import * as sdk from '../../../sdk';
 export interface TableCommission extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;

package/out/src/storage/schema/tables/TableCommission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableCommission.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableCommission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,MAAM,WAAW,eAAgB,SAAQ,GAAG,CAAC,eAAe;IAC1D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB"}
+{"version":3,"file":"TableCommission.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableCommission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,eAAgB,SAAQ,GAAG,CAAC,eAAe;IAC1D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB"}

package/out/src/storage/schema/tables/TableMonitorEvent.d.ts

@@ -1,4 +1,4 @@
-import { sdk } from '../../../index.client';
+import * as sdk from '../../../sdk';
 export interface TableMonitorEvent extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;

package/out/src/storage/schema/tables/TableMonitorEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableMonitorEvent.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableMonitorEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,eAAe;IAC5D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}
+{"version":3,"file":"TableMonitorEvent.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableMonitorEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,eAAe;IAC5D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/out/src/storage/schema/tables/TableMonitorLease.d.ts

@@ -0,0 +1,23 @@
+import * as sdk from '../../../sdk';
+/**
+ * monitor_lease record so at most one Monitor daemon owns a given task at a time.
+ *
+ * The Monitor acquires a lease by upserting `(taskName, ownerId, expiresAt)`
+ * and renews periodically. Stale leases (`expiresAt < now`) may be claimed by
+ * another instance.
+ */
+export interface TableMonitorLease extends sdk.EntityTimeStamp {
+    created_at: Date;
+    updated_at: Date;
+    /** Logical task name, e.g. 'proof-acquisition' */
+    taskName: string;
+    /** Stable identifier for the owning Monitor instance */
+    ownerId: string;
+    /** Lease expiry — claimants treat any row with expiresAt <= now() as free */
+    expiresAt: Date;
+    /** Monotonic counter incremented on each successful renew */
+    renewCount: number;
+    /** Optional free-text description of current activity */
+    note?: string;
+}
+//# sourceMappingURL=TableMonitorLease.d.ts.map

package/out/src/storage/schema/tables/TableMonitorLease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableMonitorLease.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableMonitorLease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,eAAe;IAC5D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,SAAS,EAAE,IAAI,CAAA;IACf,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd"}

package/out/src/storage/schema/tables/TableMonitorLease.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TableMonitorLease.js.map

package/out/src/storage/schema/tables/TableMonitorLease.js.map

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

package/out/src/storage/schema/tables/TableOutput.d.ts

@@ -1,6 +1,7 @@
 import { Base64String, DescriptionString5to50Bytes, PubKeyHex } from '@bsv/sdk';
-import { TableOutputBasket, TableOutputTag } from '.';
-import { sdk } from '../../../index.client';
+import { TableOutputBasket } from './TableOutputBasket';
+import { TableOutputTag } from './TableOutputTag';
+import * as sdk from '../../../sdk';
 export interface TableOutput extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;
@@ -27,6 +28,13 @@ export interface TableOutput extends sdk.EntityTimeStamp {
     scriptLength?: number;
     scriptOffset?: number;
     lockingScript?: number[];
+    /**
+     * new-schema: minimum block height at which a coinbase output becomes spendable.
+     * NULL for non-coinbase outputs and for pre-new schema rows that have not yet been
+     * backfilled. The §4 spendability rule treats a non-coinbase output as
+     * mature regardless of this column.
+     */
+    maturesAtHeight?: number;
 }
 export interface TableOutputX extends TableOutput {
     basket?: TableOutputBasket;

package/out/src/storage/schema/tables/TableOutput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableOutput.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,GAAG,CAAA;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,MAAM,WAAW,WAAY,SAAQ,GAAG,CAAC,eAAe;IACtD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,iBAAiB,EAAE,2BAA2B,CAAA;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,GAAG,CAAC,iBAAiB,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB,CAAC,EAAE,SAAS,CAAA;IAC7B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,IAAI,CAAC,EAAE,cAAc,EAAE,CAAA;CACxB;AAED,eAAO,MAAM,iCAAiC,UA0B7C,CAAA"}
+{"version":3,"file":"TableOutput.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,WAAY,SAAQ,GAAG,CAAC,eAAe;IACtD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,iBAAiB,EAAE,2BAA2B,CAAA;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,GAAG,CAAC,iBAAiB,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB,CAAC,EAAE,SAAS,CAAA;IAC7B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,IAAI,CAAC,EAAE,cAAc,EAAE,CAAA;CACxB;AAED,eAAO,MAAM,iCAAiC,UA0B7C,CAAA"}

package/out/src/storage/schema/tables/TableOutput.js

@@ -26,6 +26,6 @@ exports.outputColumnsWithoutLockingScript = [
     'spendingDescription',
     'scriptLength',
     'scriptOffset'
-    //'lockingScript',
+    // 'lockingScript',
 ];
 //# sourceMappingURL=TableOutput.js.map

package/out/src/storage/schema/tables/TableOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"TableOutput.js","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":";;;AAqCa,QAAA,iCAAiC,GAAG;IAC/C,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,eAAe;IACf,UAAU;IACV,WAAW;IACX,QAAQ;IACR,MAAM;IACN,UAAU;IACV,YAAY;IACZ,SAAS;IACT,MAAM;IACN,mBAAmB;IACnB,MAAM;IACN,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,SAAS;IACT,gBAAgB;IAChB,qBAAqB;IACrB,cAAc;IACd,cAAc;IACd,kBAAkB;CACnB,CAAA"}
+{"version":3,"file":"TableOutput.js","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":";;;AA6Ca,QAAA,iCAAiC,GAAG;IAC/C,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,eAAe;IACf,UAAU;IACV,WAAW;IACX,QAAQ;IACR,MAAM;IACN,UAAU;IACV,YAAY;IACZ,SAAS;IACT,MAAM;IACN,mBAAmB;IACnB,MAAM;IACN,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,SAAS;IACT,gBAAgB;IAChB,qBAAqB;IACrB,cAAc;IACd,cAAc;IACd,mBAAmB;CACpB,CAAA"}

package/out/src/storage/schema/tables/TableOutputBasket.d.ts

@@ -1,4 +1,4 @@
-import { sdk } from '../../../index.client';
+import * as sdk from '../../../sdk';
 export interface TableOutputBasket extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;

package/out/src/storage/schema/tables/TableOutputBasket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableOutputBasket.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutputBasket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,eAAe;IAC5D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB,EAAE,MAAM,CAAA;IAC5B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,SAAS,EAAE,OAAO,CAAA;CACnB"}
+{"version":3,"file":"TableOutputBasket.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutputBasket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,eAAe;IAC5D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB,EAAE,MAAM,CAAA;IAC5B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,SAAS,EAAE,OAAO,CAAA;CACnB"}

package/out/src/storage/schema/tables/TableOutputTag.d.ts

@@ -1,4 +1,4 @@
-import { sdk } from '../../../index.client';
+import * as sdk from '../../../sdk';
 export interface TableOutputTag extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;

package/out/src/storage/schema/tables/TableOutputTag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableOutputTag.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutputTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,MAAM,WAAW,cAAe,SAAQ,GAAG,CAAC,eAAe;IACzD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,OAAO,CAAA;CACnB"}
+{"version":3,"file":"TableOutputTag.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutputTag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,cAAe,SAAQ,GAAG,CAAC,eAAe;IACzD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,OAAO,CAAA;CACnB"}

package/out/src/storage/schema/tables/TableOutputTagMap.d.ts

@@ -1,4 +1,4 @@
-import { sdk } from '../../../index.client';
+import * as sdk from '../../../sdk';
 export interface TableOutputTagMap extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;

package/out/src/storage/schema/tables/TableOutputTagMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableOutputTagMap.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutputTagMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,eAAe;IAC5D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;CACnB"}
+{"version":3,"file":"TableOutputTagMap.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableOutputTagMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,eAAe;IAC5D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;CACnB"}

package/out/src/storage/schema/tables/TableProvenTx.d.ts

@@ -1,4 +1,4 @@
-import { sdk } from '../../../index.client';
+import * as sdk from '../../../sdk';
 export interface TableProvenTx extends sdk.EntityTimeStamp {
     created_at: Date;
     updated_at: Date;