@secondlayer/shared 0.2.0

package/dist/src/node/hiro-client.js

@@ -0,0 +1,410 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/env.ts
+import { z } from "zod";
+var networksSchema = z.string().transform((val) => {
+  const networks = val.split(",").map((n) => n.trim()).filter(Boolean);
+  const valid = ["mainnet", "testnet"];
+  for (const n of networks) {
+    if (!valid.includes(n)) {
+      throw new Error(`Invalid network: ${n}. Must be one of: ${valid.join(", ")}`);
+    }
+  }
+  return networks;
+});
+var envSchema = z.object({
+  DATABASE_URL: z.preprocess((val) => typeof val === "string" && val.length === 0 ? undefined : val, z.string().url().optional()),
+  NETWORK: z.enum(["mainnet", "testnet"]).optional(),
+  NETWORKS: networksSchema.optional(),
+  LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
+  NODE_ENV: z.enum(["development", "production", "test"]).default("development")
+});
+var cachedEnv = null;
+function getEnv() {
+  if (cachedEnv) {
+    return cachedEnv;
+  }
+  const result = envSchema.safeParse(process.env);
+  if (!result.success) {
+    console.error("❌ Invalid environment configuration:");
+    console.error(result.error.format());
+    throw new Error("Invalid environment configuration");
+  }
+  let enabledNetworks;
+  if (result.data.NETWORKS && result.data.NETWORKS.length > 0) {
+    enabledNetworks = result.data.NETWORKS;
+  } else if (result.data.NETWORK) {
+    enabledNetworks = [result.data.NETWORK];
+  } else {
+    enabledNetworks = ["mainnet"];
+  }
+  cachedEnv = { ...result.data, enabledNetworks };
+  return cachedEnv;
+}
+// src/logger.ts
+var LOG_LEVELS = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+
+class Logger {
+  _level;
+  _isProduction;
+  _initialized = false;
+  init() {
+    if (this._initialized)
+      return;
+    this._initialized = true;
+    try {
+      const env = getEnv();
+      this._level = env.LOG_LEVEL;
+      this._isProduction = env.NODE_ENV === "production";
+    } catch {
+      this._level = "info";
+      this._isProduction = false;
+    }
+  }
+  get level() {
+    this.init();
+    return this._level;
+  }
+  get isProduction() {
+    this.init();
+    return this._isProduction;
+  }
+  shouldLog(level) {
+    return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+  }
+  formatMessage(level, message, meta) {
+    const timestamp = new Date().toISOString();
+    if (this.isProduction) {
+      return JSON.stringify({
+        timestamp,
+        level,
+        message,
+        ...meta
+      });
+    }
+    const metaStr = meta ? ` ${JSON.stringify(meta)}` : "";
+    return `[${timestamp}] ${level.toUpperCase()}: ${message}${metaStr}`;
+  }
+  debug(message, meta) {
+    if (this.shouldLog("debug")) {
+      console.debug(this.formatMessage("debug", message, meta));
+    }
+  }
+  info(message, meta) {
+    if (this.shouldLog("info")) {
+      console.info(this.formatMessage("info", message, meta));
+    }
+  }
+  warn(message, meta) {
+    if (this.shouldLog("warn")) {
+      console.warn(this.formatMessage("warn", message, meta));
+    }
+  }
+  error(message, meta) {
+    if (this.shouldLog("error")) {
+      console.error(this.formatMessage("error", message, meta));
+    }
+  }
+}
+var logger = new Logger;
+
+// src/node/hiro-client.ts
+var DEFAULT_HIRO_API_URL = "https://api.mainnet.hiro.so";
+
+class HiroClient {
+  apiUrl;
+  apiKey;
+  maxRetries;
+  constructor(apiUrl, maxRetries = 5) {
+    this.apiUrl = apiUrl || process.env.HIRO_API_URL || DEFAULT_HIRO_API_URL;
+    this.apiKey = process.env.HIRO_API_KEY;
+    this.maxRetries = maxRetries;
+  }
+  get headers() {
+    return this.apiKey ? { "x-hiro-api-key": this.apiKey } : {};
+  }
+  async fetchWithRetry(url, timeoutMs = 15000) {
+    for (let attempt = 0;attempt < this.maxRetries; attempt++) {
+      const res = await fetch(url, { headers: this.headers, signal: AbortSignal.timeout(timeoutMs) });
+      if (res.ok || res.status === 404)
+        return res;
+      if (res.status === 429 || res.status >= 500) {
+        const delay = Math.min(1000 * Math.pow(2, attempt), 1e4);
+        logger.info("Rate limited, retrying", { url: url.split("/").slice(-2).join("/"), attempt, delay });
+        await new Promise((r) => setTimeout(r, delay));
+        continue;
+      }
+      return res;
+    }
+    return fetch(url, { headers: this.headers, signal: AbortSignal.timeout(timeoutMs) });
+  }
+  async getBlockForIndexer(height) {
+    const block = await this.fetchBlock(height);
+    if (!block)
+      return null;
+    const hiroTxs = await this.fetchBlockTransactions(height);
+    const txPayloads = [];
+    const eventPayloads = [];
+    for (const hiroTx of hiroTxs) {
+      txPayloads.push({
+        txid: hiroTx.tx_id,
+        raw_tx: "0x00",
+        status: mapTxStatus(hiroTx.tx_status),
+        tx_index: hiroTx.tx_index ?? 0,
+        tx_type: mapTxType(hiroTx.tx_type),
+        sender_address: hiroTx.sender_address
+      });
+      if (hiroTx.event_count > 0) {
+        try {
+          const events = await this.fetchAllEvents(hiroTx.tx_id);
+          eventPayloads.push(...events);
+        } catch (err) {
+          logger.warn("Failed to fetch events for backfill", { txId: hiroTx.tx_id, error: String(err) });
+        }
+      }
+    }
+    return {
+      block_hash: block.hash,
+      block_height: block.height,
+      index_block_hash: block.index_block_hash,
+      parent_block_hash: block.parent_block_hash,
+      parent_index_block_hash: block.parent_index_block_hash,
+      burn_block_hash: block.burn_block_hash,
+      burn_block_height: block.burn_block_height,
+      burn_block_timestamp: block.burn_block_time,
+      miner_txid: block.miner_txid,
+      timestamp: block.block_time,
+      transactions: txPayloads,
+      events: eventPayloads
+    };
+  }
+  async fetchBlock(height) {
+    const res = await this.fetchWithRetry(`${this.apiUrl}/extended/v2/blocks/${height}`);
+    if (res.status === 404)
+      return null;
+    if (!res.ok)
+      throw new Error(`Hiro API block/${height} returned ${res.status}`);
+    return res.json();
+  }
+  async fetchBlockTransactions(height) {
+    const txs = [];
+    let offset = 0;
+    const limit = 50;
+    while (true) {
+      const res = await this.fetchWithRetry(`${this.apiUrl}/extended/v2/blocks/${height}/transactions?limit=${limit}&offset=${offset}`);
+      if (!res.ok)
+        throw new Error(`Hiro API block/${height}/transactions returned ${res.status}`);
+      const data = await res.json();
+      txs.push(...data.results);
+      if (txs.length >= data.total || data.results.length < limit)
+        break;
+      offset += limit;
+    }
+    return txs;
+  }
+  async fetchAllEvents(txId) {
+    const events = [];
+    let offset = 0;
+    const limit = 50;
+    while (true) {
+      const res = await this.fetchWithRetry(`${this.apiUrl}/extended/v1/tx/events?tx_id=${txId}&limit=${limit}&offset=${offset}`);
+      if (!res.ok) {
+        logger.warn("Failed to fetch events from Hiro", { txId, status: res.status });
+        break;
+      }
+      const data = await res.json();
+      for (const hEvent of data.events) {
+        const converted = convertHiroEvent(hEvent);
+        if (converted)
+          events.push(converted);
+      }
+      if (data.events.length < limit)
+        break;
+      offset += limit;
+    }
+    return events;
+  }
+  async isHealthy() {
+    try {
+      const res = await fetch(`${this.apiUrl}/extended/v1/status`, {
+        headers: this.headers,
+        signal: AbortSignal.timeout(5000)
+      });
+      return res.ok;
+    } catch {
+      return false;
+    }
+  }
+  getApiUrl() {
+    return this.apiUrl;
+  }
+}
+function mapTxStatus(status) {
+  switch (status) {
+    case "success":
+      return "success";
+    case "abort_by_response":
+    case "abort_by_post_condition":
+      return status;
+    default:
+      return "success";
+  }
+}
+function mapTxType(type) {
+  switch (type) {
+    case "token_transfer":
+      return "token_transfer";
+    case "contract_call":
+      return "contract_call";
+    case "smart_contract":
+      return "smart_contract";
+    case "coinbase":
+      return "coinbase";
+    case "tenure_change":
+      return "tenure_change";
+    case "poison_microblock":
+      return "poison_microblock";
+    default:
+      return type;
+  }
+}
+function convertHiroEvent(hEvent) {
+  const base = {
+    txid: hEvent.tx_id,
+    event_index: hEvent.event_index,
+    committed: true
+  };
+  if (hEvent.event_type === "stx_asset" && hEvent.asset) {
+    const a = hEvent.asset;
+    switch (a.asset_event_type) {
+      case "transfer":
+        return {
+          ...base,
+          type: "stx_transfer_event",
+          stx_transfer_event: {
+            sender: a.sender,
+            recipient: a.recipient,
+            amount: a.amount,
+            memo: a.memo
+          }
+        };
+      case "mint":
+        return {
+          ...base,
+          type: "stx_mint_event",
+          stx_mint_event: { recipient: a.recipient, amount: a.amount }
+        };
+      case "burn":
+        return {
+          ...base,
+          type: "stx_burn_event",
+          stx_burn_event: { sender: a.sender, amount: a.amount }
+        };
+      case "lock":
+        return {
+          ...base,
+          type: "stx_lock_event",
+          stx_lock_event: {
+            locked_amount: a.amount,
+            unlock_height: "0",
+            locked_address: a.sender
+          }
+        };
+    }
+  }
+  if (hEvent.event_type === "fungible_token_asset" && hEvent.asset) {
+    const a = hEvent.asset;
+    const assetId = a.asset_id || "";
+    switch (a.asset_event_type) {
+      case "transfer":
+        return {
+          ...base,
+          type: "ft_transfer_event",
+          ft_transfer_event: {
+            asset_identifier: assetId,
+            sender: a.sender,
+            recipient: a.recipient,
+            amount: a.amount
+          }
+        };
+      case "mint":
+        return {
+          ...base,
+          type: "ft_mint_event",
+          ft_mint_event: { asset_identifier: assetId, recipient: a.recipient, amount: a.amount }
+        };
+      case "burn":
+        return {
+          ...base,
+          type: "ft_burn_event",
+          ft_burn_event: { asset_identifier: assetId, sender: a.sender, amount: a.amount }
+        };
+    }
+  }
+  if (hEvent.event_type === "non_fungible_token_asset" && hEvent.asset) {
+    const a = hEvent.asset;
+    const assetId = a.asset_id || "";
+    switch (a.asset_event_type) {
+      case "transfer":
+        return {
+          ...base,
+          type: "nft_transfer_event",
+          nft_transfer_event: {
+            asset_identifier: assetId,
+            sender: a.sender,
+            recipient: a.recipient,
+            value: a.value
+          }
+        };
+      case "mint":
+        return {
+          ...base,
+          type: "nft_mint_event",
+          nft_mint_event: { asset_identifier: assetId, recipient: a.recipient, value: a.value }
+        };
+      case "burn":
+        return {
+          ...base,
+          type: "nft_burn_event",
+          nft_burn_event: { asset_identifier: assetId, sender: a.sender, value: a.value }
+        };
+    }
+  }
+  if (hEvent.event_type === "smart_contract_log" && hEvent.contract_log) {
+    return {
+      ...base,
+      type: "smart_contract_event",
+      smart_contract_event: {
+        contract_identifier: hEvent.contract_log.contract_id,
+        topic: hEvent.contract_log.topic,
+        value: hEvent.contract_log.value
+      }
+    };
+  }
+  logger.debug("Unknown Hiro event type, skipping", {
+    eventType: hEvent.event_type,
+    txId: hEvent.tx_id
+  });
+  return null;
+}
+export {
+  HiroClient
+};
+
+//# debugId=ECD1D20F327C2DE164756E2164756E21
+//# sourceMappingURL=hiro-client.js.map

package/dist/src/node/hiro-client.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/env.ts", "../src/logger.ts", "../src/node/hiro-client.ts"],
+  "sourcesContent": [
+    "import { z } from \"zod\";\n\n// Parse comma-separated networks\nconst networksSchema = z.string().transform((val) => {\n  const networks = val.split(\",\").map((n) => n.trim()).filter(Boolean);\n  const valid = [\"mainnet\", \"testnet\"];\n  for (const n of networks) {\n    if (!valid.includes(n)) {\n      throw new Error(`Invalid network: ${n}. Must be one of: ${valid.join(\", \")}`);\n    }\n  }\n  return networks as (\"mainnet\" | \"testnet\")[];\n});\n\nconst envSchema = z.object({\n  // DATABASE_URL is optional - consumers must provide their own\n  DATABASE_URL: z.preprocess(\n    (val) => (typeof val === \"string\" && val.length === 0) ? undefined : val,\n    z.string().url().optional(),\n  ),\n  // Single network (deprecated, for backwards compatibility)\n  NETWORK: z.enum([\"mainnet\", \"testnet\"]).optional(),\n  // Multiple networks (comma-separated)\n  NETWORKS: networksSchema.optional(),\n  LOG_LEVEL: z.enum([\"debug\", \"info\", \"warn\", \"error\"]).default(\"info\"),\n  NODE_ENV: z.enum([\"development\", \"production\", \"test\"]).default(\"development\"),\n});\n\nexport type Env = z.infer<typeof envSchema> & {\n  enabledNetworks: (\"mainnet\" | \"testnet\")[];\n};\n\nlet cachedEnv: Env | null = null;\n\nexport function getEnv(): Env {\n  if (cachedEnv) {\n    return cachedEnv;\n  }\n\n  const result = envSchema.safeParse(process.env);\n\n  if (!result.success) {\n    console.error(\"❌ Invalid environment configuration:\");\n    console.error(result.error.format());\n    throw new Error(\"Invalid environment configuration\");\n  }\n\n  // Compute enabled networks from NETWORKS or NETWORK\n  let enabledNetworks: (\"mainnet\" | \"testnet\")[];\n  if (result.data.NETWORKS && result.data.NETWORKS.length > 0) {\n    enabledNetworks = result.data.NETWORKS;\n  } else if (result.data.NETWORK) {\n    enabledNetworks = [result.data.NETWORK];\n  } else {\n    enabledNetworks = [\"mainnet\"]; // Default\n  }\n\n  cachedEnv = { ...result.data, enabledNetworks };\n  return cachedEnv;\n}\n\n// Export for testing\nexport { envSchema };\n",
+    "import { getEnv } from \"./env.ts\";\n\ntype LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst LOG_LEVELS: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nclass Logger {\n  private _level?: LogLevel;\n  private _isProduction?: boolean;\n  private _initialized = false;\n\n  private init() {\n    if (this._initialized) return;\n    this._initialized = true;\n    try {\n      const env = getEnv();\n      this._level = env.LOG_LEVEL;\n      this._isProduction = env.NODE_ENV === \"production\";\n    } catch {\n      // Fallback when env is unavailable (e.g. tests without DATABASE_URL)\n      this._level = \"info\";\n      this._isProduction = false;\n    }\n  }\n\n  private get level(): LogLevel {\n    this.init();\n    return this._level!;\n  }\n\n  private get isProduction(): boolean {\n    this.init();\n    return this._isProduction!;\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    return LOG_LEVELS[level] >= LOG_LEVELS[this.level];\n  }\n\n  private formatMessage(level: LogLevel, message: string, meta?: Record<string, any>) {\n    const timestamp = new Date().toISOString();\n\n    if (this.isProduction) {\n      // JSON output for production\n      return JSON.stringify({\n        timestamp,\n        level,\n        message,\n        ...meta,\n      });\n    }\n\n    // Human-readable output for development\n    const metaStr = meta ? ` ${JSON.stringify(meta)}` : \"\";\n    return `[${timestamp}] ${level.toUpperCase()}: ${message}${metaStr}`;\n  }\n\n  debug(message: string, meta?: Record<string, any>) {\n    if (this.shouldLog(\"debug\")) {\n      console.debug(this.formatMessage(\"debug\", message, meta));\n    }\n  }\n\n  info(message: string, meta?: Record<string, any>) {\n    if (this.shouldLog(\"info\")) {\n      console.info(this.formatMessage(\"info\", message, meta));\n    }\n  }\n\n  warn(message: string, meta?: Record<string, any>) {\n    if (this.shouldLog(\"warn\")) {\n      console.warn(this.formatMessage(\"warn\", message, meta));\n    }\n  }\n\n  error(message: string, meta?: Record<string, any>) {\n    if (this.shouldLog(\"error\")) {\n      console.error(this.formatMessage(\"error\", message, meta));\n    }\n  }\n}\n\n// Export singleton instance\nexport const logger = new Logger();\n",
+    "/**\n * Hiro public API client for backfilling historical block data.\n *\n * The stacks-node RPC `/v2/blocks/{height}` only returns block headers + tx IDs,\n * not full transaction data or events. The Hiro API serves complete block data\n * that we can transform into the NewBlockPayload format our indexer expects.\n */\n\nimport { logger } from \"../logger.ts\";\n\nconst DEFAULT_HIRO_API_URL = \"https://api.mainnet.hiro.so\";\n\n/** v2 /extended/v2/blocks/{height} response */\nexport interface HiroBlockResponse {\n  canonical: boolean;\n  height: number;\n  hash: string;\n  block_time: number;\n  block_time_iso: string;\n  index_block_hash: string;\n  parent_block_hash: string;\n  parent_index_block_hash: string;\n  burn_block_hash: string;\n  burn_block_height: number;\n  burn_block_time: number;\n  miner_txid: string;\n  tx_count: number;\n}\n\n/** v2 /extended/v2/blocks/{height}/transactions response */\nexport interface HiroBlockTxsResponse {\n  limit: number;\n  offset: number;\n  total: number;\n  results: HiroTxResponse[];\n}\n\nexport interface HiroTxResponse {\n  tx_id: string;\n  tx_type: string;\n  tx_status: string;\n  sender_address: string;\n  fee_rate: string;\n  nonce: number;\n  block_hash: string;\n  block_height: number;\n  burn_block_height: number;\n  tx_index: number;\n  event_count: number;\n  token_transfer?: {\n    recipient_address: string;\n    amount: string;\n    memo: string;\n  };\n  contract_call?: {\n    contract_id: string;\n    function_name: string;\n    function_args: unknown[];\n  };\n  smart_contract?: {\n    contract_id: string;\n    source_code: string;\n  };\n}\n\nexport interface HiroEvent {\n  event_index: number;\n  event_type: string; // \"stx_asset\" | \"fungible_token_asset\" | \"non_fungible_token_asset\" | \"smart_contract_log\"\n  tx_id: string;\n  asset?: {\n    asset_event_type: string; // \"transfer\" | \"mint\" | \"burn\"\n    sender?: string;\n    recipient?: string;\n    amount?: string;\n    memo?: string;\n    asset_id?: string;\n    value?: unknown;\n  };\n  contract_log?: {\n    contract_id: string;\n    topic: string;\n    value: unknown;\n  };\n}\n\nexport interface HiroEventsResponse {\n  limit: number;\n  offset: number;\n  events: HiroEvent[];\n}\n\n/** Shape our indexer expects at POST /new_block */\nexport interface NewBlockPayload {\n  block_hash: string;\n  block_height: number;\n  index_block_hash: string;\n  parent_block_hash: string;\n  parent_index_block_hash: string;\n  burn_block_hash: string;\n  burn_block_height: number;\n  burn_block_timestamp: number;\n  miner_txid: string;\n  timestamp: number;\n  transactions: TransactionPayload[];\n  events: TransactionEventPayload[];\n}\n\ninterface TransactionPayload {\n  txid: string;\n  raw_tx: string;\n  status: string;\n  tx_index: number;\n  tx_type?: string;\n  sender_address?: string;\n}\n\ninterface TransactionEventPayload {\n  txid: string;\n  event_index: number;\n  committed: boolean;\n  type: string;\n  stx_transfer_event?: { sender: string; recipient: string; amount: string; memo?: string };\n  stx_mint_event?: { recipient: string; amount: string };\n  stx_burn_event?: { sender: string; amount: string };\n  stx_lock_event?: { locked_amount: string; unlock_height: string; locked_address: string };\n  ft_transfer_event?: { asset_identifier: string; sender: string; recipient: string; amount: string };\n  ft_mint_event?: { asset_identifier: string; recipient: string; amount: string };\n  ft_burn_event?: { asset_identifier: string; sender: string; amount: string };\n  nft_transfer_event?: { asset_identifier: string; sender: string; recipient: string; value: unknown };\n  nft_mint_event?: { asset_identifier: string; recipient: string; value: unknown };\n  nft_burn_event?: { asset_identifier: string; sender: string; value: unknown };\n  smart_contract_event?: { contract_identifier: string; topic: string; value: unknown };\n}\n\nexport class HiroClient {\n  private apiUrl: string;\n  private apiKey: string | undefined;\n  private maxRetries: number;\n\n  constructor(apiUrl?: string, maxRetries = 5) {\n    this.apiUrl = apiUrl || process.env.HIRO_API_URL || DEFAULT_HIRO_API_URL;\n    this.apiKey = process.env.HIRO_API_KEY;\n    this.maxRetries = maxRetries;\n  }\n\n  private get headers(): Record<string, string> {\n    return this.apiKey ? { \"x-hiro-api-key\": this.apiKey } : {};\n  }\n\n  /** Fetch with retry on 429/5xx using exponential backoff */\n  private async fetchWithRetry(url: string, timeoutMs = 15_000): Promise<Response> {\n    for (let attempt = 0; attempt < this.maxRetries; attempt++) {\n      const res = await fetch(url, { headers: this.headers, signal: AbortSignal.timeout(timeoutMs) });\n\n      if (res.ok || res.status === 404) return res;\n\n      if (res.status === 429 || res.status >= 500) {\n        const delay = Math.min(1000 * Math.pow(2, attempt), 10_000);\n        logger.info(\"Rate limited, retrying\", { url: url.split(\"/\").slice(-2).join(\"/\"), attempt, delay });\n        await new Promise((r) => setTimeout(r, delay));\n        continue;\n      }\n\n      // 4xx (not 404/429) — don't retry\n      return res;\n    }\n\n    // Final attempt\n    return fetch(url, { headers: this.headers, signal: AbortSignal.timeout(timeoutMs) });\n  }\n\n  /**\n   * Fetch a complete block by height, including all transactions and events,\n   * transformed into the NewBlockPayload format our indexer expects.\n   *\n   * Uses 3-step approach:\n   *   1. GET /extended/v2/blocks/{height} — block metadata\n   *   2. GET /extended/v2/blocks/{height}/transactions — all txs (paginated)\n   *   3. GET /extended/v1/tx/events?tx_id={txId} — events per tx (only for txs with events)\n   */\n  async getBlockForIndexer(height: number): Promise<NewBlockPayload | null> {\n    // 1. Fetch block metadata\n    const block = await this.fetchBlock(height);\n    if (!block) return null;\n\n    // 2. Fetch all transactions via v2 block/transactions endpoint\n    const hiroTxs = await this.fetchBlockTransactions(height);\n\n    const txPayloads: TransactionPayload[] = [];\n    const eventPayloads: TransactionEventPayload[] = [];\n\n    for (const hiroTx of hiroTxs) {\n      txPayloads.push({\n        txid: hiroTx.tx_id,\n        raw_tx: \"0x00\",\n        status: mapTxStatus(hiroTx.tx_status),\n        tx_index: hiroTx.tx_index ?? 0,\n        tx_type: mapTxType(hiroTx.tx_type),\n        sender_address: hiroTx.sender_address,\n      });\n\n      // 3. Fetch events only for txs that have them\n      if (hiroTx.event_count > 0) {\n        try {\n          const events = await this.fetchAllEvents(hiroTx.tx_id);\n          eventPayloads.push(...events);\n        } catch (err) {\n          logger.warn(\"Failed to fetch events for backfill\", { txId: hiroTx.tx_id, error: String(err) });\n        }\n      }\n    }\n\n    return {\n      block_hash: block.hash,\n      block_height: block.height,\n      index_block_hash: block.index_block_hash,\n      parent_block_hash: block.parent_block_hash,\n      parent_index_block_hash: block.parent_index_block_hash,\n      burn_block_hash: block.burn_block_hash,\n      burn_block_height: block.burn_block_height,\n      burn_block_timestamp: block.burn_block_time,\n      miner_txid: block.miner_txid,\n      timestamp: block.block_time,\n      transactions: txPayloads,\n      events: eventPayloads,\n    };\n  }\n\n  /** v2 block metadata */\n  private async fetchBlock(height: number): Promise<HiroBlockResponse | null> {\n    const res = await this.fetchWithRetry(`${this.apiUrl}/extended/v2/blocks/${height}`);\n    if (res.status === 404) return null;\n    if (!res.ok) throw new Error(`Hiro API block/${height} returned ${res.status}`);\n    return res.json() as Promise<HiroBlockResponse>;\n  }\n\n  /** v2 block transactions (paginated) */\n  private async fetchBlockTransactions(height: number): Promise<HiroTxResponse[]> {\n    const txs: HiroTxResponse[] = [];\n    let offset = 0;\n    const limit = 50;\n\n    while (true) {\n      const res = await this.fetchWithRetry(\n        `${this.apiUrl}/extended/v2/blocks/${height}/transactions?limit=${limit}&offset=${offset}`\n      );\n      if (!res.ok) throw new Error(`Hiro API block/${height}/transactions returned ${res.status}`);\n\n      const data = (await res.json()) as HiroBlockTxsResponse;\n      txs.push(...data.results);\n\n      if (txs.length >= data.total || data.results.length < limit) break;\n      offset += limit;\n    }\n\n    return txs;\n  }\n\n  private async fetchAllEvents(txId: string): Promise<TransactionEventPayload[]> {\n    const events: TransactionEventPayload[] = [];\n    let offset = 0;\n    const limit = 50;\n\n    while (true) {\n      const res = await this.fetchWithRetry(\n        `${this.apiUrl}/extended/v1/tx/events?tx_id=${txId}&limit=${limit}&offset=${offset}`\n      );\n      if (!res.ok) {\n        logger.warn(\"Failed to fetch events from Hiro\", { txId, status: res.status });\n        break;\n      }\n\n      const data = (await res.json()) as HiroEventsResponse;\n      for (const hEvent of data.events) {\n        const converted = convertHiroEvent(hEvent);\n        if (converted) events.push(converted);\n      }\n\n      if (data.events.length < limit) break;\n      offset += limit;\n    }\n\n    return events;\n  }\n\n  async isHealthy(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.apiUrl}/extended/v1/status`, {\n        headers: this.headers,\n        signal: AbortSignal.timeout(5_000),\n      });\n      return res.ok;\n    } catch {\n      return false;\n    }\n  }\n\n  getApiUrl(): string {\n    return this.apiUrl;\n  }\n}\n\n/** Map Hiro tx_status to our indexer's expected format */\nfunction mapTxStatus(status: string): string {\n  switch (status) {\n    case \"success\":\n      return \"success\";\n    case \"abort_by_response\":\n    case \"abort_by_post_condition\":\n      return status;\n    default:\n      return \"success\";\n  }\n}\n\n/** Map Hiro tx_type to node event tx_type */\nfunction mapTxType(type: string): string {\n  switch (type) {\n    case \"token_transfer\":\n      return \"token_transfer\";\n    case \"contract_call\":\n      return \"contract_call\";\n    case \"smart_contract\":\n      return \"smart_contract\";\n    case \"coinbase\":\n      return \"coinbase\";\n    case \"tenure_change\":\n      return \"tenure_change\";\n    case \"poison_microblock\":\n      return \"poison_microblock\";\n    default:\n      return type;\n  }\n}\n\n/**\n * Convert a Hiro API event to our indexer's TransactionEvent format.\n *\n * Hiro uses:\n *   event_type: \"stx_asset\" | \"fungible_token_asset\" | \"non_fungible_token_asset\" | \"smart_contract_log\"\n *   asset.asset_event_type: \"transfer\" | \"mint\" | \"burn\" | \"lock\"\n *\n * Our indexer expects:\n *   type: \"stx_transfer_event\" | \"stx_mint_event\" | \"ft_transfer_event\" | \"smart_contract_event\" | ...\n */\nfunction convertHiroEvent(hEvent: HiroEvent): TransactionEventPayload | null {\n  const base = {\n    txid: hEvent.tx_id,\n    event_index: hEvent.event_index,\n    committed: true,\n  };\n\n  if (hEvent.event_type === \"stx_asset\" && hEvent.asset) {\n    const a = hEvent.asset;\n    switch (a.asset_event_type) {\n      case \"transfer\":\n        return {\n          ...base,\n          type: \"stx_transfer_event\",\n          stx_transfer_event: {\n            sender: a.sender!,\n            recipient: a.recipient!,\n            amount: a.amount!,\n            memo: a.memo,\n          },\n        };\n      case \"mint\":\n        return {\n          ...base,\n          type: \"stx_mint_event\",\n          stx_mint_event: { recipient: a.recipient!, amount: a.amount! },\n        };\n      case \"burn\":\n        return {\n          ...base,\n          type: \"stx_burn_event\",\n          stx_burn_event: { sender: a.sender!, amount: a.amount! },\n        };\n      case \"lock\":\n        return {\n          ...base,\n          type: \"stx_lock_event\",\n          stx_lock_event: {\n            locked_amount: a.amount!,\n            unlock_height: \"0\",\n            locked_address: a.sender!,\n          },\n        };\n    }\n  }\n\n  if (hEvent.event_type === \"fungible_token_asset\" && hEvent.asset) {\n    const a = hEvent.asset;\n    const assetId = a.asset_id || \"\";\n    switch (a.asset_event_type) {\n      case \"transfer\":\n        return {\n          ...base,\n          type: \"ft_transfer_event\",\n          ft_transfer_event: {\n            asset_identifier: assetId,\n            sender: a.sender!,\n            recipient: a.recipient!,\n            amount: a.amount!,\n          },\n        };\n      case \"mint\":\n        return {\n          ...base,\n          type: \"ft_mint_event\",\n          ft_mint_event: { asset_identifier: assetId, recipient: a.recipient!, amount: a.amount! },\n        };\n      case \"burn\":\n        return {\n          ...base,\n          type: \"ft_burn_event\",\n          ft_burn_event: { asset_identifier: assetId, sender: a.sender!, amount: a.amount! },\n        };\n    }\n  }\n\n  if (hEvent.event_type === \"non_fungible_token_asset\" && hEvent.asset) {\n    const a = hEvent.asset;\n    const assetId = a.asset_id || \"\";\n    switch (a.asset_event_type) {\n      case \"transfer\":\n        return {\n          ...base,\n          type: \"nft_transfer_event\",\n          nft_transfer_event: {\n            asset_identifier: assetId,\n            sender: a.sender!,\n            recipient: a.recipient!,\n            value: a.value,\n          },\n        };\n      case \"mint\":\n        return {\n          ...base,\n          type: \"nft_mint_event\",\n          nft_mint_event: { asset_identifier: assetId, recipient: a.recipient!, value: a.value },\n        };\n      case \"burn\":\n        return {\n          ...base,\n          type: \"nft_burn_event\",\n          nft_burn_event: { asset_identifier: assetId, sender: a.sender!, value: a.value },\n        };\n    }\n  }\n\n  if (hEvent.event_type === \"smart_contract_log\" && hEvent.contract_log) {\n    return {\n      ...base,\n      type: \"smart_contract_event\",\n      smart_contract_event: {\n        contract_identifier: hEvent.contract_log.contract_id,\n        topic: hEvent.contract_log.topic,\n        value: hEvent.contract_log.value,\n      },\n    };\n  }\n\n  logger.debug(\"Unknown Hiro event type, skipping\", {\n    eventType: hEvent.event_type,\n    txId: hEvent.tx_id,\n  });\n  return null;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "ECD1D20F327C2DE164756E2164756E21",
+  "names": []
+}

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

@@ -0,0 +1,50 @@
+import { Generated, Selectable } from "kysely";
+interface JobsTable {
+	id: Generated<string>;
+	stream_id: string;
+	block_height: number;
+	status: Generated<string>;
+	attempts: Generated<number>;
+	locked_at: Date | null;
+	locked_by: string | null;
+	error: string | null;
+	backfill: Generated<boolean>;
+	created_at: Generated<Date>;
+	completed_at: Date | null;
+}
+type Job = Selectable<JobsTable>;
+interface QueueStats {
+	pending: number;
+	processing: number;
+	completed: number;
+	failed: number;
+	total: number;
+}
+declare const WORKER_ID: unknown;
+/**
+* Enqueue a new job for stream evaluation
+*/
+declare function enqueue(streamId: string, blockHeight: number, backfill?: boolean): Promise<string>;
+/**
+* Claim a pending job using SKIP LOCKED to prevent concurrent access
+* Returns null if no jobs available
+*/
+declare function claim(): Promise<Job | null>;
+/**
+* Mark a job as completed
+*/
+declare function complete(jobId: string): Promise<void>;
+/**
+* Mark a job as failed
+* Re-queues if under max attempts, otherwise marks as permanently failed
+*/
+declare function fail(jobId: string, error: string, maxAttempts?: number): Promise<void>;
+/**
+* Get queue statistics
+*/
+declare function stats(): Promise<QueueStats>;
+/**
+* Get worker ID for this process
+*/
+declare function getWorkerId(): string;
+export { stats, getWorkerId, fail, enqueue, complete, claim, WORKER_ID, QueueStats };