@secondlayer/shared 6.14.0 → 6.15.0

package/dist/src/index-http.d.ts

@@ -0,0 +1,110 @@
+type IndexBlockRow = {
+	block_height: number
+	block_hash: string
+	parent_hash: string
+	burn_block_height: number
+	burn_block_hash: string | null
+	block_time: string | null
+};
+type IndexEventCommon = {
+	block_height: number
+	tx_id: string
+	event_index: number
+	contract_id: string | null
+};
+type IndexEventRow = IndexEventCommon & ({
+	event_type: "ft_transfer" | "ft_mint" | "ft_burn"
+	asset_identifier: string
+	sender?: string
+	recipient?: string
+	amount: string
+} | {
+	event_type: "nft_transfer" | "nft_mint" | "nft_burn"
+	asset_identifier: string
+	sender?: string
+	recipient?: string
+	value: string
+} | {
+	event_type: "stx_transfer" | "stx_mint" | "stx_burn"
+	sender?: string
+	recipient?: string
+	amount: string
+	memo?: string | null
+} | {
+	event_type: "stx_lock"
+	sender: string
+	amount: string
+	payload: {
+		unlock_height: string | null
+	}
+} | {
+	event_type: "print"
+	payload: {
+		topic: string | null
+		value: unknown
+		raw_value: string | null
+	}
+});
+type IndexTransactionRow = {
+	tx_id: string
+	block_height: number
+	tx_index: number
+	tx_type: string
+	sender: string
+	status: string
+	contract_call?: {
+		contract_id: string
+		function_name: string
+		function_args_hex?: string[] | null
+		result_hex?: string | null
+	} | null
+	smart_contract?: {
+		contract_id: string | null
+	} | null
+};
+type StreamsReorgRow = {
+	detected_at: string
+	fork_point_height: number
+	orphaned_range: {
+		from: string
+		to: string
+	}
+	new_canonical_tip: string
+};
+type IndexHttpOptions = {
+	/** Base URL for /v1/index (the decoded data plane). */
+	indexBaseUrl: string
+	/** Bearer for /v1/index. Defaults to the internal enterprise key. */
+	indexApiKey?: string
+	/** Base URL for /v1/streams (the canonical clock). */
+	streamsBaseUrl: string
+	/** Bearer for /v1/streams (internal enterprise key). */
+	streamsApiKey: string
+};
+declare class IndexHttpClient {
+	private readonly indexBaseUrl;
+	private readonly indexApiKey;
+	private readonly streamsBaseUrl;
+	private readonly streamsApiKey;
+	constructor(opts: IndexHttpOptions);
+	private get;
+	/** Drain a cursor-paginated Index collection over [fromHeight, toHeight]. */
+	private walk;
+	walkBlocks(fromHeight: number, toHeight: number): Promise<IndexBlockRow[]>;
+	walkEvents(eventType: string, fromHeight: number, toHeight: number): Promise<IndexEventRow[]>;
+	walkTransactions(fromHeight: number, toHeight: number): Promise<IndexTransactionRow[]>;
+	/** Canonical tip height from the Streams clock. */
+	getStreamsTip(): Promise<number>;
+	/**
+	* Highest block height the Index data plane can serve (tip is inline in every
+	* envelope). This is the data-availability bound — a consumer must not
+	* process past it, even if the Streams clock is ahead.
+	*/
+	getIndexTip(): Promise<number>;
+	/** Reorgs since a resume token (wall-clock `detected_at`-keyed). */
+	listReorgs(since: string): Promise<{
+		reorgs: StreamsReorgRow[]
+		next_since: string | null
+	}>;
+}
+export { StreamsReorgRow, IndexTransactionRow, IndexHttpOptions, IndexHttpClient, IndexEventRow, IndexBlockRow };

package/dist/src/index-http.js

@@ -0,0 +1,93 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/index-internal-auth.ts
+var INDEX_INTERNAL_TENANT_ID = "tenant_index_internal";
+var DEFAULT_INDEX_INTERNAL_API_KEY = "sk-sl_index_internal";
+function defaultInternalIndexApiKey() {
+  return process.env.INDEX_INTERNAL_API_KEY || DEFAULT_INDEX_INTERNAL_API_KEY;
+}
+
+// src/index-http.ts
+var PAGE_LIMIT = 1000;
+
+class IndexHttpClient {
+  indexBaseUrl;
+  indexApiKey;
+  streamsBaseUrl;
+  streamsApiKey;
+  constructor(opts) {
+    this.indexBaseUrl = opts.indexBaseUrl.replace(/\/+$/, "");
+    this.indexApiKey = opts.indexApiKey ?? defaultInternalIndexApiKey();
+    this.streamsBaseUrl = opts.streamsBaseUrl.replace(/\/+$/, "");
+    this.streamsApiKey = opts.streamsApiKey;
+  }
+  async get(url, apiKey) {
+    const res = await fetch(url, {
+      headers: apiKey ? { authorization: `Bearer ${apiKey}` } : {}
+    });
+    if (!res.ok) {
+      throw new Error(`GET ${url} → ${res.status} ${await res.text()}`);
+    }
+    return await res.json();
+  }
+  async walk(path, key, fromHeight, toHeight, extraParams = {}) {
+    const out = [];
+    let cursor = null;
+    do {
+      const params = new URLSearchParams({
+        to_height: String(toHeight),
+        limit: String(PAGE_LIMIT),
+        ...extraParams
+      });
+      if (cursor)
+        params.set("cursor", cursor);
+      else
+        params.set("from_height", String(fromHeight));
+      const env = await this.get(`${this.indexBaseUrl}${path}?${params}`, this.indexApiKey);
+      out.push(...env[key]);
+      cursor = env.next_cursor;
+    } while (cursor);
+    return out;
+  }
+  walkBlocks(fromHeight, toHeight) {
+    return this.walk("/v1/index/blocks", "blocks", fromHeight, toHeight);
+  }
+  walkEvents(eventType, fromHeight, toHeight) {
+    return this.walk("/v1/index/events", "events", fromHeight, toHeight, { event_type: eventType });
+  }
+  walkTransactions(fromHeight, toHeight) {
+    return this.walk("/v1/index/transactions", "transactions", fromHeight, toHeight);
+  }
+  async getStreamsTip() {
+    const tip = await this.get(`${this.streamsBaseUrl}/v1/streams/tip`, this.streamsApiKey);
+    return Number(tip.block_height) || 0;
+  }
+  async getIndexTip() {
+    const env = await this.get(`${this.indexBaseUrl}/v1/index/blocks?limit=1`, this.indexApiKey);
+    return Number(env.tip?.block_height) || 0;
+  }
+  async listReorgs(since) {
+    const params = new URLSearchParams({ since });
+    return this.get(`${this.streamsBaseUrl}/v1/streams/reorgs?${params}`, this.streamsApiKey);
+  }
+}
+export {
+  IndexHttpClient
+};
+
+//# debugId=E1C3D9E21DD5904564756E2164756E21
+//# sourceMappingURL=index-http.js.map

package/dist/src/index-http.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/index-internal-auth.ts", "../src/index-http.ts"],
+  "sourcesContent": [
+    "// Internal service credential for first-party consumers of /v1/index over HTTP\n// (e.g. the subgraph processor's PublicApiBlockSource). Seeded into the Index\n// token store as an enterprise tenant with NO account_id, so these reads are\n// unmetered (Index metering gates on account_id). Mirrors the Streams internal\n// key (packages/indexer/src/l2/internal-auth.ts). Lives in shared so both the\n// API (seed) and the subgraph processor (consumer) import it without a cycle.\nexport const INDEX_INTERNAL_TENANT_ID = \"tenant_index_internal\";\n\nconst DEFAULT_INDEX_INTERNAL_API_KEY = \"sk-sl_index_internal\";\n\nexport function defaultInternalIndexApiKey(): string {\n\treturn process.env.INDEX_INTERNAL_API_KEY || DEFAULT_INDEX_INTERNAL_API_KEY;\n}\n",
+    "import { defaultInternalIndexApiKey } from \"./index-internal-auth.ts\";\n\n/**\n * Low-level transport for the public Index (`/v1/index`) + Streams clock\n * (`/v1/streams`) HTTP APIs: cursor-paginated reads, tip, reorgs. Lives in\n * `shared` (a leaf both the SDK and the subgraph runtime depend on) so the wire\n * format has one home and no package cycle. The SDK's ergonomic client should\n * eventually consume these row types too (see the plan's convergence task).\n *\n * This is intentionally minimal — just the GETs the subgraph runtime's\n * PublicApiBlockSource needs. It is NOT the SDK's full client (walk/consume/\n * retries/auth resolution).\n */\n\nconst PAGE_LIMIT = 1000;\n\ntype Envelope<K extends string, T> = {\n\t[P in K]: T[];\n} & { next_cursor: string | null };\n\n// ── Index API wire shapes (single source of truth) ─────────────────────────\nexport type IndexBlockRow = {\n\tblock_height: number;\n\tblock_hash: string;\n\tparent_hash: string;\n\tburn_block_height: number;\n\tburn_block_hash: string | null;\n\tblock_time: string | null;\n};\n\ntype IndexEventCommon = {\n\tblock_height: number;\n\ttx_id: string;\n\tevent_index: number;\n\tcontract_id: string | null;\n};\n\nexport type IndexEventRow = IndexEventCommon &\n\t(\n\t\t| {\n\t\t\t\tevent_type: \"ft_transfer\" | \"ft_mint\" | \"ft_burn\";\n\t\t\t\tasset_identifier: string;\n\t\t\t\tsender?: string;\n\t\t\t\trecipient?: string;\n\t\t\t\tamount: string;\n\t\t  }\n\t\t| {\n\t\t\t\tevent_type: \"nft_transfer\" | \"nft_mint\" | \"nft_burn\";\n\t\t\t\tasset_identifier: string;\n\t\t\t\tsender?: string;\n\t\t\t\trecipient?: string;\n\t\t\t\tvalue: string;\n\t\t  }\n\t\t| {\n\t\t\t\tevent_type: \"stx_transfer\" | \"stx_mint\" | \"stx_burn\";\n\t\t\t\tsender?: string;\n\t\t\t\trecipient?: string;\n\t\t\t\tamount: string;\n\t\t\t\tmemo?: string | null;\n\t\t  }\n\t\t| {\n\t\t\t\tevent_type: \"stx_lock\";\n\t\t\t\tsender: string;\n\t\t\t\tamount: string;\n\t\t\t\tpayload: { unlock_height: string | null };\n\t\t  }\n\t\t| {\n\t\t\t\tevent_type: \"print\";\n\t\t\t\tpayload: {\n\t\t\t\t\ttopic: string | null;\n\t\t\t\t\tvalue: unknown;\n\t\t\t\t\traw_value: string | null;\n\t\t\t\t};\n\t\t  }\n\t);\n\nexport type IndexTransactionRow = {\n\ttx_id: string;\n\tblock_height: number;\n\ttx_index: number;\n\ttx_type: string;\n\tsender: string;\n\tstatus: string;\n\tcontract_call?: {\n\t\tcontract_id: string;\n\t\tfunction_name: string;\n\t\tfunction_args_hex?: string[] | null;\n\t\tresult_hex?: string | null;\n\t} | null;\n\tsmart_contract?: { contract_id: string | null } | null;\n};\n\nexport type StreamsReorgRow = {\n\tdetected_at: string;\n\tfork_point_height: number;\n\torphaned_range: { from: string; to: string };\n\tnew_canonical_tip: string;\n};\n\nexport type IndexHttpOptions = {\n\t/** Base URL for /v1/index (the decoded data plane). */\n\tindexBaseUrl: string;\n\t/** Bearer for /v1/index. Defaults to the internal enterprise key. */\n\tindexApiKey?: string;\n\t/** Base URL for /v1/streams (the canonical clock). */\n\tstreamsBaseUrl: string;\n\t/** Bearer for /v1/streams (internal enterprise key). */\n\tstreamsApiKey: string;\n};\n\nexport class IndexHttpClient {\n\tprivate readonly indexBaseUrl: string;\n\tprivate readonly indexApiKey: string;\n\tprivate readonly streamsBaseUrl: string;\n\tprivate readonly streamsApiKey: string;\n\n\tconstructor(opts: IndexHttpOptions) {\n\t\tthis.indexBaseUrl = opts.indexBaseUrl.replace(/\\/+$/, \"\");\n\t\tthis.indexApiKey = opts.indexApiKey ?? defaultInternalIndexApiKey();\n\t\tthis.streamsBaseUrl = opts.streamsBaseUrl.replace(/\\/+$/, \"\");\n\t\tthis.streamsApiKey = opts.streamsApiKey;\n\t}\n\n\tprivate async get<T>(url: string, apiKey: string): Promise<T> {\n\t\t// Index reads are anon — omit the header entirely when no key is set, so\n\t\t// an empty key reads anonymously rather than 401-ing as an invalid bearer.\n\t\tconst res = await fetch(url, {\n\t\t\theaders: apiKey ? { authorization: `Bearer ${apiKey}` } : {},\n\t\t});\n\t\tif (!res.ok) {\n\t\t\tthrow new Error(`GET ${url} → ${res.status} ${await res.text()}`);\n\t\t}\n\t\treturn (await res.json()) as T;\n\t}\n\n\t/** Drain a cursor-paginated Index collection over [fromHeight, toHeight]. */\n\tprivate async walk<K extends string, T>(\n\t\tpath: string,\n\t\tkey: K,\n\t\tfromHeight: number,\n\t\ttoHeight: number,\n\t\textraParams: Record<string, string> = {},\n\t): Promise<T[]> {\n\t\tconst out: T[] = [];\n\t\tlet cursor: string | null = null;\n\t\tdo {\n\t\t\tconst params = new URLSearchParams({\n\t\t\t\tto_height: String(toHeight),\n\t\t\t\tlimit: String(PAGE_LIMIT),\n\t\t\t\t...extraParams,\n\t\t\t});\n\t\t\t// from_height and cursor are mutually exclusive — anchor the first page\n\t\t\t// by height, then page forward by cursor only.\n\t\t\tif (cursor) params.set(\"cursor\", cursor);\n\t\t\telse params.set(\"from_height\", String(fromHeight));\n\t\t\tconst env: Envelope<K, T> = await this.get(\n\t\t\t\t`${this.indexBaseUrl}${path}?${params}`,\n\t\t\t\tthis.indexApiKey,\n\t\t\t);\n\t\t\tout.push(...env[key]);\n\t\t\tcursor = env.next_cursor;\n\t\t} while (cursor);\n\t\treturn out;\n\t}\n\n\twalkBlocks(fromHeight: number, toHeight: number): Promise<IndexBlockRow[]> {\n\t\treturn this.walk<\"blocks\", IndexBlockRow>(\n\t\t\t\"/v1/index/blocks\",\n\t\t\t\"blocks\",\n\t\t\tfromHeight,\n\t\t\ttoHeight,\n\t\t);\n\t}\n\n\twalkEvents(\n\t\teventType: string,\n\t\tfromHeight: number,\n\t\ttoHeight: number,\n\t): Promise<IndexEventRow[]> {\n\t\treturn this.walk<\"events\", IndexEventRow>(\n\t\t\t\"/v1/index/events\",\n\t\t\t\"events\",\n\t\t\tfromHeight,\n\t\t\ttoHeight,\n\t\t\t{ event_type: eventType },\n\t\t);\n\t}\n\n\twalkTransactions(\n\t\tfromHeight: number,\n\t\ttoHeight: number,\n\t): Promise<IndexTransactionRow[]> {\n\t\treturn this.walk<\"transactions\", IndexTransactionRow>(\n\t\t\t\"/v1/index/transactions\",\n\t\t\t\"transactions\",\n\t\t\tfromHeight,\n\t\t\ttoHeight,\n\t\t);\n\t}\n\n\t/** Canonical tip height from the Streams clock. */\n\tasync getStreamsTip(): Promise<number> {\n\t\tconst tip = await this.get<{ block_height: number }>(\n\t\t\t`${this.streamsBaseUrl}/v1/streams/tip`,\n\t\t\tthis.streamsApiKey,\n\t\t);\n\t\treturn Number(tip.block_height) || 0;\n\t}\n\n\t/**\n\t * Highest block height the Index data plane can serve (tip is inline in every\n\t * envelope). This is the data-availability bound — a consumer must not\n\t * process past it, even if the Streams clock is ahead.\n\t */\n\tasync getIndexTip(): Promise<number> {\n\t\tconst env = await this.get<{ tip: { block_height: number } }>(\n\t\t\t`${this.indexBaseUrl}/v1/index/blocks?limit=1`,\n\t\t\tthis.indexApiKey,\n\t\t);\n\t\treturn Number(env.tip?.block_height) || 0;\n\t}\n\n\t/** Reorgs since a resume token (wall-clock `detected_at`-keyed). */\n\tasync listReorgs(\n\t\tsince: string,\n\t): Promise<{ reorgs: StreamsReorgRow[]; next_since: string | null }> {\n\t\tconst params = new URLSearchParams({ since });\n\t\treturn this.get(\n\t\t\t`${this.streamsBaseUrl}/v1/streams/reorgs?${params}`,\n\t\t\tthis.streamsApiKey,\n\t\t);\n\t}\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;AAMO,IAAM,2BAA2B;AAExC,IAAM,iCAAiC;AAEhC,SAAS,0BAA0B,GAAW;AAAA,EACpD,OAAO,QAAQ,IAAI,0BAA0B;AAAA;;;ACG9C,IAAM,aAAa;AAAA;AAgGZ,MAAM,gBAAgB;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,WAAW,CAAC,MAAwB;AAAA,IACnC,KAAK,eAAe,KAAK,aAAa,QAAQ,QAAQ,EAAE;AAAA,IACxD,KAAK,cAAc,KAAK,eAAe,2BAA2B;AAAA,IAClE,KAAK,iBAAiB,KAAK,eAAe,QAAQ,QAAQ,EAAE;AAAA,IAC5D,KAAK,gBAAgB,KAAK;AAAA;AAAA,OAGb,IAAM,CAAC,KAAa,QAA4B;AAAA,IAG7D,MAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC5B,SAAS,SAAS,EAAE,eAAe,UAAU,SAAS,IAAI,CAAC;AAAA,IAC5D,CAAC;AAAA,IACD,IAAI,CAAC,IAAI,IAAI;AAAA,MACZ,MAAM,IAAI,MAAM,OAAO,SAAQ,IAAI,UAAU,MAAM,IAAI,KAAK,GAAG;AAAA,IAChE;AAAA,IACA,OAAQ,MAAM,IAAI,KAAK;AAAA;AAAA,OAIV,KAAyB,CACtC,MACA,KACA,YACA,UACA,cAAsC,CAAC,GACxB;AAAA,IACf,MAAM,MAAW,CAAC;AAAA,IAClB,IAAI,SAAwB;AAAA,IAC5B,GAAG;AAAA,MACF,MAAM,SAAS,IAAI,gBAAgB;AAAA,QAClC,WAAW,OAAO,QAAQ;AAAA,QAC1B,OAAO,OAAO,UAAU;AAAA,WACrB;AAAA,MACJ,CAAC;AAAA,MAGD,IAAI;AAAA,QAAQ,OAAO,IAAI,UAAU,MAAM;AAAA,MAClC;AAAA,eAAO,IAAI,eAAe,OAAO,UAAU,CAAC;AAAA,MACjD,MAAM,MAAsB,MAAM,KAAK,IACtC,GAAG,KAAK,eAAe,QAAQ,UAC/B,KAAK,WACN;AAAA,MACA,IAAI,KAAK,GAAG,IAAI,IAAI;AAAA,MACpB,SAAS,IAAI;AAAA,IACd,SAAS;AAAA,IACT,OAAO;AAAA;AAAA,EAGR,UAAU,CAAC,YAAoB,UAA4C;AAAA,IAC1E,OAAO,KAAK,KACX,oBACA,UACA,YACA,QACD;AAAA;AAAA,EAGD,UAAU,CACT,WACA,YACA,UAC2B;AAAA,IAC3B,OAAO,KAAK,KACX,oBACA,UACA,YACA,UACA,EAAE,YAAY,UAAU,CACzB;AAAA;AAAA,EAGD,gBAAgB,CACf,YACA,UACiC;AAAA,IACjC,OAAO,KAAK,KACX,0BACA,gBACA,YACA,QACD;AAAA;AAAA,OAIK,cAAa,GAAoB;AAAA,IACtC,MAAM,MAAM,MAAM,KAAK,IACtB,GAAG,KAAK,iCACR,KAAK,aACN;AAAA,IACA,OAAO,OAAO,IAAI,YAAY,KAAK;AAAA;AAAA,OAQ9B,YAAW,GAAoB;AAAA,IACpC,MAAM,MAAM,MAAM,KAAK,IACtB,GAAG,KAAK,wCACR,KAAK,WACN;AAAA,IACA,OAAO,OAAO,IAAI,KAAK,YAAY,KAAK;AAAA;AAAA,OAInC,WAAU,CACf,OACoE;AAAA,IACpE,MAAM,SAAS,IAAI,gBAAgB,EAAE,MAAM,CAAC;AAAA,IAC5C,OAAO,KAAK,IACX,GAAG,KAAK,oCAAoC,UAC5C,KAAK,aACN;AAAA;AAEF;",
+  "debugId": "E1C3D9E21DD5904564756E2164756E21",
+  "names": []
+}

package/dist/src/index-internal-auth.d.ts

@@ -0,0 +1,3 @@
+declare const INDEX_INTERNAL_TENANT_ID = "tenant_index_internal";
+declare function defaultInternalIndexApiKey(): string;
+export { defaultInternalIndexApiKey, INDEX_INTERNAL_TENANT_ID };

package/dist/src/index-internal-auth.js

@@ -0,0 +1,29 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/index-internal-auth.ts
+var INDEX_INTERNAL_TENANT_ID = "tenant_index_internal";
+var DEFAULT_INDEX_INTERNAL_API_KEY = "sk-sl_index_internal";
+function defaultInternalIndexApiKey() {
+  return process.env.INDEX_INTERNAL_API_KEY || DEFAULT_INDEX_INTERNAL_API_KEY;
+}
+export {
+  defaultInternalIndexApiKey,
+  INDEX_INTERNAL_TENANT_ID
+};
+
+//# debugId=27171696725F807764756E2164756E21
+//# sourceMappingURL=index-internal-auth.js.map

package/dist/src/index-internal-auth.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index-internal-auth.ts"],
+  "sourcesContent": [
+    "// Internal service credential for first-party consumers of /v1/index over HTTP\n// (e.g. the subgraph processor's PublicApiBlockSource). Seeded into the Index\n// token store as an enterprise tenant with NO account_id, so these reads are\n// unmetered (Index metering gates on account_id). Mirrors the Streams internal\n// key (packages/indexer/src/l2/internal-auth.ts). Lives in shared so both the\n// API (seed) and the subgraph processor (consumer) import it without a cycle.\nexport const INDEX_INTERNAL_TENANT_ID = \"tenant_index_internal\";\n\nconst DEFAULT_INDEX_INTERNAL_API_KEY = \"sk-sl_index_internal\";\n\nexport function defaultInternalIndexApiKey(): string {\n\treturn process.env.INDEX_INTERNAL_API_KEY || DEFAULT_INDEX_INTERNAL_API_KEY;\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;AAMO,IAAM,2BAA2B;AAExC,IAAM,iCAAiC;AAEhC,SAAS,0BAA0B,GAAW;AAAA,EACpD,OAAO,QAAQ,IAAI,0BAA0B;AAAA;",
+  "debugId": "27171696725F807764756E2164756E21",
+  "names": []
+}

package/migrations/0087_decoded_events_type_height_event_idx.ts

@@ -0,0 +1,26 @@
+import { type Kysely, sql } from "kysely";
+
+// Composite index backing /v1/index/events keyset pagination for a bare
+// event-type source (no contract/sender/recipient filter). The reader paginates
+// with `event_type = ? AND (block_height, event_index) > (?, ?)
+// ORDER BY block_height, event_index`. Without a leading-event_type composite,
+// Postgres bitmap-ANDs the single-column event_type index — re-scanning the
+// ENTIRE event-type partition (e.g. ~4.2M `print` rows) on every cursor page,
+// turning a backfill into O(n²) (measured ~6.8s/page vs ~50ms for page one).
+// With this index each page is an index range scan. Mirrors the existing
+// (contract_id|sender|recipient, block_height, event_index) composites that
+// already make filtered queries fast.
+//
+// Already created CONCURRENTLY on prod; IF NOT EXISTS makes this a no-op there
+// and a cheap build on fresh/dev databases (small data).
+export async function up(db: Kysely<unknown>): Promise<void> {
+	await sql`CREATE INDEX IF NOT EXISTS decoded_events_type_height_event_idx ON decoded_events (event_type, block_height, event_index) WHERE canonical`.execute(
+		db,
+	);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+	await sql`DROP INDEX IF EXISTS decoded_events_type_height_event_idx`.execute(
+		db,
+	);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/shared",
-	"version": "6.14.0",
+	"version": "6.15.0",
 	"license": "MIT",
 	"repository": {
 		"type": "git",
@@ -80,6 +80,14 @@
 			"types": "./dist/src/mode.d.ts",
 			"import": "./dist/src/mode.js"
 		},
+		"./index-internal-auth": {
+			"types": "./dist/src/index-internal-auth.d.ts",
+			"import": "./dist/src/index-internal-auth.js"
+		},
+		"./index-http": {
+			"types": "./dist/src/index-http.d.ts",
+			"import": "./dist/src/index-http.js"
+		},
 		"./logger": {
 			"types": "./dist/src/logger.d.ts",
 			"import": "./dist/src/logger.js"