@secondlayer/shared 11.15.0 → 11.15.2

package/dist/src/archive/disk-guard.d.ts

@@ -33,6 +33,11 @@ type DiskGuardOptions = {
 	sleep?: (ms: number) => Promise<void>
 	readSpace?: (path: string) => Promise<DiskSpace>
 };
+/** 100GB: comfortably above the ~39GB an needs plus the backup spike.
+*  Exported as the fallback threshold for callers (the canonical exporter)
+*  that derive a tighter, size-aware requirement once they have a previous
+*  snapshot to measure, and only fall back to this fixed number cold. */
+declare const DEFAULT_MIN_FREE_BYTES: number;
 declare class DiskSpaceExhausted extends Error {
 	constructor(free: number, required: number, waitedMs: number);
 }
@@ -43,4 +48,4 @@ declare class DiskSpaceExhausted extends Error {
 * start — because the pressure that matters arrives mid-job.
 */
 declare function waitForDiskSpace(options: DiskGuardOptions): Promise<void>;
-export { DiskGuardOptions, DiskSpace, DiskSpaceExhausted, readDiskSpace, waitForDiskSpace };
+export { DEFAULT_MIN_FREE_BYTES, DiskGuardOptions, DiskSpace, DiskSpaceExhausted, readDiskSpace, waitForDiskSpace };

package/dist/src/archive/disk-guard.js

@@ -44,10 +44,11 @@ async function waitForDiskSpace(options) {
   }
 }
 export {
+  DEFAULT_MIN_FREE_BYTES,
   DiskSpaceExhausted,
   readDiskSpace,
   waitForDiskSpace
 };
 
-//# debugId=F4103F3B5631788664756E2164756E21
+//# debugId=4DC8DC7AB2DD7E6F64756E2164756E21
 //# sourceMappingURL=disk-guard.js.map

package/dist/src/archive/disk-guard.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/archive/disk-guard.ts"],
   "sourcesContent": [
-    "import { statfs } from \"node:fs/promises\";\n\n/**\n * Free-space guard for bulk archive jobs.\n *\n * Twice on 2026-08-12 a bulk job filled the disk that production Postgres\n * shares: a backfill died at 9.2M/14.4M rows on ENOSPC, and a restore died at\n * 86% of events. Prod survived both, but only just — 2.9GB free with the\n * indexer still ingesting.\n *\n * The failure mode that makes this worth guarding rather than monitoring: the\n * nightly `pg_basebackup` transiently consumes ~150GB, so a job that starts\n * with comfortable headroom can still hit the wall an hour later. Checking\n * once at startup is not enough; the check has to be repeated as the job runs.\n *\n * Waiting is the right response, not failing. The spike passes, and an\n * archive job that pauses for twenty minutes is strictly better than one that\n * dies at 86% or, worse, takes the database down with it.\n */\n\nexport type DiskSpace = { freeBytes: number; totalBytes: number };\n\nexport async function readDiskSpace(path: string): Promise<DiskSpace> {\n\tconst stats = await statfs(path);\n\treturn {\n\t\tfreeBytes: stats.bavail * stats.bsize,\n\t\ttotalBytes: stats.blocks * stats.bsize,\n\t};\n}\n\nexport type DiskGuardOptions = {\n\t/** Any path on the filesystem to watch. */\n\tpath: string;\n\t/** Pause below this many bytes free. */\n\tminFreeBytes?: number;\n\t/** How long to wait between re-checks while paused. */\n\tpollMs?: number;\n\t/** Give up after this long rather than pausing forever. */\n\tmaxWaitMs?: number;\n\tonPause?: (free: DiskSpace, waitedMs: number) => void;\n\tsleep?: (ms: number) => Promise<void>;\n\treadSpace?: (path: string) => Promise<DiskSpace>;\n};\n\n/** 100GB: comfortably above the ~39GB an export needs plus the backup spike. */\nconst DEFAULT_MIN_FREE_BYTES = 100 * 1024 ** 3;\nconst DEFAULT_POLL_MS = 60_000;\nconst DEFAULT_MAX_WAIT_MS = 2 * 3_600_000;\n/**\n * A threshold larger than a share of the whole disk is unsatisfiable, not\n * protective: on a 14GB CI runner or a modest VPS, demanding 100GB free would\n * block forever waiting for space that machine can never have. The absolute\n * default is tuned for the production host; this keeps it from becoming a wall\n * everywhere else.\n */\nconst MAX_THRESHOLD_FRACTION_OF_DISK = 0.25;\n\nfunction effectiveThreshold(configured: number, totalBytes: number): number {\n\tif (!Number.isFinite(totalBytes) || totalBytes <= 0) return configured;\n\treturn Math.min(configured, totalBytes * MAX_THRESHOLD_FRACTION_OF_DISK);\n}\n\nexport class DiskSpaceExhausted extends Error {\n\tconstructor(free: number, required: number, waitedMs: number) {\n\t\tsuper(\n\t\t\t`only ${(free / 1024 ** 3).toFixed(1)}GB free (need ${(required / 1024 ** 3).toFixed(1)}GB) after waiting ${Math.round(waitedMs / 60_000)}m`,\n\t\t);\n\t\tthis.name = \"DiskSpaceExhausted\";\n\t}\n}\n\n/**\n * Block until there is enough headroom, or throw after `maxWaitMs`.\n *\n * Call this between units of work — before each partition, not once at the\n * start — because the pressure that matters arrives mid-job.\n */\nexport async function waitForDiskSpace(\n\toptions: DiskGuardOptions,\n): Promise<void> {\n\tconst minFree = options.minFreeBytes ?? DEFAULT_MIN_FREE_BYTES;\n\tconst pollMs = options.pollMs ?? DEFAULT_POLL_MS;\n\tconst maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;\n\tconst readSpace = options.readSpace ?? readDiskSpace;\n\tconst sleep =\n\t\toptions.sleep ??\n\t\t((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));\n\n\tlet waited = 0;\n\twhile (true) {\n\t\tconst space = await readSpace(options.path);\n\t\tconst threshold = effectiveThreshold(minFree, space.totalBytes);\n\t\tif (space.freeBytes >= threshold) return;\n\t\tif (waited >= maxWaitMs) {\n\t\t\tthrow new DiskSpaceExhausted(space.freeBytes, threshold, waited);\n\t\t}\n\t\toptions.onPause?.(space, waited);\n\t\tawait sleep(pollMs);\n\t\twaited += pollMs;\n\t}\n}\n"
+    "import { statfs } from \"node:fs/promises\";\n\n/**\n * Free-space guard for bulk archive jobs.\n *\n * Twice on 2026-08-12 a bulk job filled the disk that production Postgres\n * shares: a backfill died at 9.2M/14.4M rows on ENOSPC, and a restore died at\n * 86% of events. Prod survived both, but only just — 2.9GB free with the\n * indexer still ingesting.\n *\n * The failure mode that makes this worth guarding rather than monitoring: the\n * nightly `pg_basebackup` transiently consumes ~150GB, so a job that starts\n * with comfortable headroom can still hit the wall an hour later. Checking\n * once at startup is not enough; the check has to be repeated as the job runs.\n *\n * Waiting is the right response, not failing. The spike passes, and an\n * archive job that pauses for twenty minutes is strictly better than one that\n * dies at 86% or, worse, takes the database down with it.\n */\n\nexport type DiskSpace = { freeBytes: number; totalBytes: number };\n\nexport async function readDiskSpace(path: string): Promise<DiskSpace> {\n\tconst stats = await statfs(path);\n\treturn {\n\t\tfreeBytes: stats.bavail * stats.bsize,\n\t\ttotalBytes: stats.blocks * stats.bsize,\n\t};\n}\n\nexport type DiskGuardOptions = {\n\t/** Any path on the filesystem to watch. */\n\tpath: string;\n\t/** Pause below this many bytes free. */\n\tminFreeBytes?: number;\n\t/** How long to wait between re-checks while paused. */\n\tpollMs?: number;\n\t/** Give up after this long rather than pausing forever. */\n\tmaxWaitMs?: number;\n\tonPause?: (free: DiskSpace, waitedMs: number) => void;\n\tsleep?: (ms: number) => Promise<void>;\n\treadSpace?: (path: string) => Promise<DiskSpace>;\n};\n\n/** 100GB: comfortably above the ~39GB an export needs plus the backup spike.\n *  Exported as the fallback threshold for callers (the canonical exporter)\n *  that derive a tighter, size-aware requirement once they have a previous\n *  snapshot to measure, and only fall back to this fixed number cold. */\nexport const DEFAULT_MIN_FREE_BYTES: number = 100 * 1024 ** 3;\nconst DEFAULT_POLL_MS = 60_000;\nconst DEFAULT_MAX_WAIT_MS = 2 * 3_600_000;\n/**\n * A threshold larger than a share of the whole disk is unsatisfiable, not\n * protective: on a 14GB CI runner or a modest VPS, demanding 100GB free would\n * block forever waiting for space that machine can never have. The absolute\n * default is tuned for the production host; this keeps it from becoming a wall\n * everywhere else.\n */\nconst MAX_THRESHOLD_FRACTION_OF_DISK = 0.25;\n\nfunction effectiveThreshold(configured: number, totalBytes: number): number {\n\tif (!Number.isFinite(totalBytes) || totalBytes <= 0) return configured;\n\treturn Math.min(configured, totalBytes * MAX_THRESHOLD_FRACTION_OF_DISK);\n}\n\nexport class DiskSpaceExhausted extends Error {\n\tconstructor(free: number, required: number, waitedMs: number) {\n\t\tsuper(\n\t\t\t`only ${(free / 1024 ** 3).toFixed(1)}GB free (need ${(required / 1024 ** 3).toFixed(1)}GB) after waiting ${Math.round(waitedMs / 60_000)}m`,\n\t\t);\n\t\tthis.name = \"DiskSpaceExhausted\";\n\t}\n}\n\n/**\n * Block until there is enough headroom, or throw after `maxWaitMs`.\n *\n * Call this between units of work — before each partition, not once at the\n * start — because the pressure that matters arrives mid-job.\n */\nexport async function waitForDiskSpace(\n\toptions: DiskGuardOptions,\n): Promise<void> {\n\tconst minFree = options.minFreeBytes ?? DEFAULT_MIN_FREE_BYTES;\n\tconst pollMs = options.pollMs ?? DEFAULT_POLL_MS;\n\tconst maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;\n\tconst readSpace = options.readSpace ?? readDiskSpace;\n\tconst sleep =\n\t\toptions.sleep ??\n\t\t((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));\n\n\tlet waited = 0;\n\twhile (true) {\n\t\tconst space = await readSpace(options.path);\n\t\tconst threshold = effectiveThreshold(minFree, space.totalBytes);\n\t\tif (space.freeBytes >= threshold) return;\n\t\tif (waited >= maxWaitMs) {\n\t\t\tthrow new DiskSpaceExhausted(space.freeBytes, threshold, waited);\n\t\t}\n\t\toptions.onPause?.(space, waited);\n\t\tawait sleep(pollMs);\n\t\twaited += pollMs;\n\t}\n}\n"
   ],
-  "mappings": ";AAAA;AAsBA,eAAsB,aAAa,CAAC,MAAkC;AAAA,EACrE,MAAM,QAAQ,MAAM,OAAO,IAAI;AAAA,EAC/B,OAAO;AAAA,IACN,WAAW,MAAM,SAAS,MAAM;AAAA,IAChC,YAAY,MAAM,SAAS,MAAM;AAAA,EAClC;AAAA;AAkBD,IAAM,yBAAyB,MAAM,QAAQ;AAC7C,IAAM,kBAAkB;AACxB,IAAM,sBAAsB,IAAI;AAQhC,IAAM,iCAAiC;AAEvC,SAAS,kBAAkB,CAAC,YAAoB,YAA4B;AAAA,EAC3E,IAAI,CAAC,OAAO,SAAS,UAAU,KAAK,cAAc;AAAA,IAAG,OAAO;AAAA,EAC5D,OAAO,KAAK,IAAI,YAAY,aAAa,8BAA8B;AAAA;AAAA;AAGjE,MAAM,2BAA2B,MAAM;AAAA,EAC7C,WAAW,CAAC,MAAc,UAAkB,UAAkB;AAAA,IAC7D,MACC,SAAS,OAAO,QAAQ,GAAG,QAAQ,CAAC,mBAAmB,WAAW,QAAQ,GAAG,QAAQ,CAAC,sBAAsB,KAAK,MAAM,WAAW,KAAM,IACzI;AAAA,IACA,KAAK,OAAO;AAAA;AAEd;AAQA,eAAsB,gBAAgB,CACrC,SACgB;AAAA,EAChB,MAAM,UAAU,QAAQ,gBAAgB;AAAA,EACxC,MAAM,SAAS,QAAQ,UAAU;AAAA,EACjC,MAAM,YAAY,QAAQ,aAAa;AAAA,EACvC,MAAM,YAAY,QAAQ,aAAa;AAAA,EACvC,MAAM,QACL,QAAQ,UACP,CAAC,OAAe,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA,EAExE,IAAI,SAAS;AAAA,EACb,OAAO,MAAM;AAAA,IACZ,MAAM,QAAQ,MAAM,UAAU,QAAQ,IAAI;AAAA,IAC1C,MAAM,YAAY,mBAAmB,SAAS,MAAM,UAAU;AAAA,IAC9D,IAAI,MAAM,aAAa;AAAA,MAAW;AAAA,IAClC,IAAI,UAAU,WAAW;AAAA,MACxB,MAAM,IAAI,mBAAmB,MAAM,WAAW,WAAW,MAAM;AAAA,IAChE;AAAA,IACA,QAAQ,UAAU,OAAO,MAAM;AAAA,IAC/B,MAAM,MAAM,MAAM;AAAA,IAClB,UAAU;AAAA,EACX;AAAA;",
-  "debugId": "F4103F3B5631788664756E2164756E21",
+  "mappings": ";AAAA;AAsBA,eAAsB,aAAa,CAAC,MAAkC;AAAA,EACrE,MAAM,QAAQ,MAAM,OAAO,IAAI;AAAA,EAC/B,OAAO;AAAA,IACN,WAAW,MAAM,SAAS,MAAM;AAAA,IAChC,YAAY,MAAM,SAAS,MAAM;AAAA,EAClC;AAAA;AAqBM,IAAM,yBAAiC,MAAM,QAAQ;AAC5D,IAAM,kBAAkB;AACxB,IAAM,sBAAsB,IAAI;AAQhC,IAAM,iCAAiC;AAEvC,SAAS,kBAAkB,CAAC,YAAoB,YAA4B;AAAA,EAC3E,IAAI,CAAC,OAAO,SAAS,UAAU,KAAK,cAAc;AAAA,IAAG,OAAO;AAAA,EAC5D,OAAO,KAAK,IAAI,YAAY,aAAa,8BAA8B;AAAA;AAAA;AAGjE,MAAM,2BAA2B,MAAM;AAAA,EAC7C,WAAW,CAAC,MAAc,UAAkB,UAAkB;AAAA,IAC7D,MACC,SAAS,OAAO,QAAQ,GAAG,QAAQ,CAAC,mBAAmB,WAAW,QAAQ,GAAG,QAAQ,CAAC,sBAAsB,KAAK,MAAM,WAAW,KAAM,IACzI;AAAA,IACA,KAAK,OAAO;AAAA;AAEd;AAQA,eAAsB,gBAAgB,CACrC,SACgB;AAAA,EAChB,MAAM,UAAU,QAAQ,gBAAgB;AAAA,EACxC,MAAM,SAAS,QAAQ,UAAU;AAAA,EACjC,MAAM,YAAY,QAAQ,aAAa;AAAA,EACvC,MAAM,YAAY,QAAQ,aAAa;AAAA,EACvC,MAAM,QACL,QAAQ,UACP,CAAC,OAAe,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA,EAExE,IAAI,SAAS;AAAA,EACb,OAAO,MAAM;AAAA,IACZ,MAAM,QAAQ,MAAM,UAAU,QAAQ,IAAI;AAAA,IAC1C,MAAM,YAAY,mBAAmB,SAAS,MAAM,UAAU;AAAA,IAC9D,IAAI,MAAM,aAAa;AAAA,MAAW;AAAA,IAClC,IAAI,UAAU,WAAW;AAAA,MACxB,MAAM,IAAI,mBAAmB,MAAM,WAAW,WAAW,MAAM;AAAA,IAChE;AAAA,IACA,QAAQ,UAAU,OAAO,MAAM;AAAA,IAC/B,MAAM,MAAM,MAAM;AAAA,IAClB,UAAU;AAAA,EACX;AAAA;",
+  "debugId": "4DC8DC7AB2DD7E6F64756E2164756E21",
   "names": []
 }

package/dist/src/archive/range-digest.d.ts

@@ -417,6 +417,39 @@ interface Pox5EventsTable {
 	source_cursor: string;
 	created_at: Generated<Date>;
 }
+interface Pox5CyclesTable {
+	reward_cycle: number;
+	start_burn_height: number;
+	prepare_start_burn_height: number;
+	end_burn_height: number;
+	total_stacked_ustx: string;
+	reward_eligible_ustx: string;
+	stakers: number;
+	signers_in_set: number;
+	/** bond index (as string) -> sats staked for this cycle. */
+	bond_sats: unknown;
+	bond_total_sats: string;
+	sbtc_custodied_sats: string;
+	rewards_allocated_stx: string;
+	rewards_allocated_bond: string;
+	reserve_deposit: string;
+	rewards_per_token_stx: string | null;
+	/** bond index (as string) -> cumulative rewards-per-sat for this cycle. */
+	rewards_per_token_bond: unknown;
+	distributions: number;
+	rewards_claimed: string;
+	computed_through_height: number;
+	updated_at: Generated<Date>;
+}
+interface Pox5CycleSignersTable {
+	reward_cycle: number;
+	signer: string;
+	delegated_ustx: string;
+	stx_only_ustx: string;
+	reward_shares_ustx: string;
+	in_set: boolean;
+	rewards_claimed: string;
+}
 interface BurnBlockRewardsTable {
 	cursor: string;
 	burn_block_height: number;
@@ -764,6 +797,8 @@ interface Database {
 	chain_reorgs: ChainReorgsTable;
 	pox4_calls: Pox4CallsTable;
 	pox5_events: Pox5EventsTable;
+	pox5_cycles: Pox5CyclesTable;
+	pox5_cycle_signers: Pox5CycleSignersTable;
 	burn_block_rewards: BurnBlockRewardsTable;
 	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;

package/dist/src/archive/semantic-digest-builder.d.ts

@@ -417,6 +417,39 @@ interface Pox5EventsTable {
 	source_cursor: string;
 	created_at: Generated<Date>;
 }
+interface Pox5CyclesTable {
+	reward_cycle: number;
+	start_burn_height: number;
+	prepare_start_burn_height: number;
+	end_burn_height: number;
+	total_stacked_ustx: string;
+	reward_eligible_ustx: string;
+	stakers: number;
+	signers_in_set: number;
+	/** bond index (as string) -> sats staked for this cycle. */
+	bond_sats: unknown;
+	bond_total_sats: string;
+	sbtc_custodied_sats: string;
+	rewards_allocated_stx: string;
+	rewards_allocated_bond: string;
+	reserve_deposit: string;
+	rewards_per_token_stx: string | null;
+	/** bond index (as string) -> cumulative rewards-per-sat for this cycle. */
+	rewards_per_token_bond: unknown;
+	distributions: number;
+	rewards_claimed: string;
+	computed_through_height: number;
+	updated_at: Generated<Date>;
+}
+interface Pox5CycleSignersTable {
+	reward_cycle: number;
+	signer: string;
+	delegated_ustx: string;
+	stx_only_ustx: string;
+	reward_shares_ustx: string;
+	in_set: boolean;
+	rewards_claimed: string;
+}
 interface BurnBlockRewardsTable {
 	cursor: string;
 	burn_block_height: number;
@@ -764,6 +797,8 @@ interface Database {
 	chain_reorgs: ChainReorgsTable;
 	pox4_calls: Pox4CallsTable;
 	pox5_events: Pox5EventsTable;
+	pox5_cycles: Pox5CyclesTable;
+	pox5_cycle_signers: Pox5CycleSignersTable;
 	burn_block_rewards: BurnBlockRewardsTable;
 	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;

package/dist/src/coverage/index.d.ts

@@ -734,6 +734,39 @@ interface Pox5EventsTable {
 	source_cursor: string;
 	created_at: Generated<Date>;
 }
+interface Pox5CyclesTable {
+	reward_cycle: number;
+	start_burn_height: number;
+	prepare_start_burn_height: number;
+	end_burn_height: number;
+	total_stacked_ustx: string;
+	reward_eligible_ustx: string;
+	stakers: number;
+	signers_in_set: number;
+	/** bond index (as string) -> sats staked for this cycle. */
+	bond_sats: unknown;
+	bond_total_sats: string;
+	sbtc_custodied_sats: string;
+	rewards_allocated_stx: string;
+	rewards_allocated_bond: string;
+	reserve_deposit: string;
+	rewards_per_token_stx: string | null;
+	/** bond index (as string) -> cumulative rewards-per-sat for this cycle. */
+	rewards_per_token_bond: unknown;
+	distributions: number;
+	rewards_claimed: string;
+	computed_through_height: number;
+	updated_at: Generated<Date>;
+}
+interface Pox5CycleSignersTable {
+	reward_cycle: number;
+	signer: string;
+	delegated_ustx: string;
+	stx_only_ustx: string;
+	reward_shares_ustx: string;
+	in_set: boolean;
+	rewards_claimed: string;
+}
 interface BurnBlockRewardsTable {
 	cursor: string;
 	burn_block_height: number;
@@ -1081,6 +1114,8 @@ interface Database {
 	chain_reorgs: ChainReorgsTable;
 	pox4_calls: Pox4CallsTable;
 	pox5_events: Pox5EventsTable;
+	pox5_cycles: Pox5CyclesTable;
+	pox5_cycle_signers: Pox5CycleSignersTable;
 	burn_block_rewards: BurnBlockRewardsTable;
 	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;

package/dist/src/db/index.d.ts

@@ -418,6 +418,39 @@ interface Pox5EventsTable {
 	source_cursor: string;
 	created_at: Generated<Date>;
 }
+interface Pox5CyclesTable {
+	reward_cycle: number;
+	start_burn_height: number;
+	prepare_start_burn_height: number;
+	end_burn_height: number;
+	total_stacked_ustx: string;
+	reward_eligible_ustx: string;
+	stakers: number;
+	signers_in_set: number;
+	/** bond index (as string) -> sats staked for this cycle. */
+	bond_sats: unknown;
+	bond_total_sats: string;
+	sbtc_custodied_sats: string;
+	rewards_allocated_stx: string;
+	rewards_allocated_bond: string;
+	reserve_deposit: string;
+	rewards_per_token_stx: string | null;
+	/** bond index (as string) -> cumulative rewards-per-sat for this cycle. */
+	rewards_per_token_bond: unknown;
+	distributions: number;
+	rewards_claimed: string;
+	computed_through_height: number;
+	updated_at: Generated<Date>;
+}
+interface Pox5CycleSignersTable {
+	reward_cycle: number;
+	signer: string;
+	delegated_ustx: string;
+	stx_only_ustx: string;
+	reward_shares_ustx: string;
+	in_set: boolean;
+	rewards_claimed: string;
+}
 interface BurnBlockRewardsTable {
 	cursor: string;
 	burn_block_height: number;
@@ -765,6 +798,8 @@ interface Database {
 	chain_reorgs: ChainReorgsTable;
 	pox4_calls: Pox4CallsTable;
 	pox5_events: Pox5EventsTable;
+	pox5_cycles: Pox5CyclesTable;
+	pox5_cycle_signers: Pox5CycleSignersTable;
 	burn_block_rewards: BurnBlockRewardsTable;
 	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
@@ -1963,6 +1998,8 @@ declare const TABLE_TO_DB: {
 	decoder_checkpoints: string
 	pox4_calls: string
 	pox5_events: string
+	pox5_cycles: string
+	pox5_cycle_signers: string
 	burn_block_rewards: string
 	burn_block_reward_slots: string
 	sbtc_events: string
@@ -2083,4 +2120,15 @@ declare function getRawClient(role?: "source" | "target"): ReturnType<typeof pos
 declare function getRawClientFor(url: string): ReturnType<typeof postgres>;
 /** Close all DB connection pools. Call in CLI commands to allow process exit. */
 declare function closeDb(): Promise<void>;
-export { Account, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiKey, ApiKeysTable, ArchiveFetch, ArchiveFetchesTable, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, ChainReadCacheTable, ChainReorgsTable, Contract, ContractsTable, CoverageSegmentsTable, Database, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DecodedEventsTable, DecoderCheckpointsTable, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountCredits, InsertAccountSpendCap, InsertApiKey, InsertArchiveFetch, InsertBlock, InsertContract, InsertEvent, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RepairMode, RetryState, RunStatus, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, Subgraph, SubgraphGap, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UsageLedgerRow, UsageLedgerTable, VmEvent, VmEventsArchiveTable, VmEventsTable, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookFormat, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookRuntime, WebhookStatus, WebhooksTable, applicationDatabaseUrl, assertDbSplit, closeDb, describeDbUrl, getDb, getDbSplitStatus, getMigrationRole, getRawClient, getRawClientFor, getSourceDb, getTargetDb, jsonb, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql };
+/**
+* `closeDb()`, but never let it block process exit past `timeoutMs`.
+*
+* 2026-09-28: a canonical printed its summary and then sat idle for 20
+* minutes — 0% CPU, `wchan=ep_poll`, one open socket — stuck in `await
+* closeDb()`. Only the wrapper's own 6h timeout moved things along. A driver
+* holding a socket open past `.destroy()`/`.end()` finishing (or never
+* finishing at all) must not stop a one-shot script from exiting once its
+* actual work is done.
+*/
+declare function closeDbOrTimeout(timeoutMs?: number, closeFn?: () => Promise<void>): Promise<void>;
+export { Account, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiKey, ApiKeysTable, ArchiveFetch, ArchiveFetchesTable, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, ChainReadCacheTable, ChainReorgsTable, Contract, ContractsTable, CoverageSegmentsTable, Database, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DecodedEventsTable, DecoderCheckpointsTable, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountCredits, InsertAccountSpendCap, InsertApiKey, InsertArchiveFetch, InsertBlock, InsertContract, InsertEvent, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RepairMode, RetryState, RunStatus, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, Subgraph, SubgraphGap, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UsageLedgerRow, UsageLedgerTable, VmEvent, VmEventsArchiveTable, VmEventsTable, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookFormat, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookRuntime, WebhookStatus, WebhooksTable, applicationDatabaseUrl, assertDbSplit, closeDb, closeDbOrTimeout, describeDbUrl, getDb, getDbSplitStatus, getMigrationRole, getRawClient, getRawClientFor, getSourceDb, getTargetDb, jsonb, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql };

package/dist/src/db/index.js

@@ -744,6 +744,8 @@ var TABLE_TO_DB = {
   decoder_checkpoints: "source",
   pox4_calls: "source",
   pox5_events: "source",
+  pox5_cycles: "source",
+  pox5_cycle_signers: "source",
   burn_block_rewards: "source",
   burn_block_reward_slots: "source",
   sbtc_events: "source",
@@ -955,6 +957,13 @@ async function closeDb() {
   }
   pools.clear();
 }
+var DEFAULT_CLOSE_DB_TIMEOUT_MS = 30000;
+async function closeDbOrTimeout(timeoutMs = DEFAULT_CLOSE_DB_TIMEOUT_MS, closeFn = closeDb) {
+  await Promise.race([
+    closeFn(),
+    new Promise((resolve) => setTimeout(resolve, timeoutMs))
+  ]);
+}
 export {
   SOURCE_READ_COLUMNS,
   SOURCE_READ_PKS,
@@ -963,6 +972,7 @@ export {
   applicationDatabaseUrl,
   assertDbSplit,
   closeDb,
+  closeDbOrTimeout,
   describeDbUrl,
   getDb,
   getDbSplitStatus,
@@ -981,5 +991,5 @@ export {
   sql2 as sql
 };
 
-//# debugId=AD548AB47C78322F64756E2164756E21
+//# debugId=DDB2C25F2D54E63664756E2164756E21
 //# sourceMappingURL=index.js.map