@secondlayer/shared 0.2.0

package/dist/src/db/queries/views.js

@@ -0,0 +1,111 @@
+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/db/jsonb.ts
+import { sql } from "kysely";
+function jsonb(value) {
+  const escaped = JSON.stringify(value).replace(/'/g, "''");
+  return sql`${sql.raw(`'${escaped}'::jsonb`)}`;
+}
+function parseJsonb(value) {
+  if (typeof value === "string") {
+    try {
+      return JSON.parse(value);
+    } catch {
+      return value;
+    }
+  }
+  return value ?? {};
+}
+
+// src/db/queries/views.ts
+import { sql as sql2 } from "kysely";
+function pgSchemaName(viewName, keyPrefix) {
+  const safeName = viewName.replace(/-/g, "_");
+  if (!keyPrefix) {
+    return `view_${safeName}`;
+  }
+  const safePrefix = keyPrefix.replace(/^sk-sl_/, "").replace(/-/g, "_");
+  return `view_${safePrefix}_${safeName}`;
+}
+async function registerView(db, data) {
+  return await db.insertInto("views").values({
+    name: data.name,
+    version: data.version,
+    definition: jsonb(data.definition),
+    schema_hash: data.schemaHash,
+    handler_path: data.handlerPath,
+    api_key_id: data.apiKeyId ?? null,
+    schema_name: data.schemaName ?? null
+  }).onConflict((oc) => oc.columns(["name", "api_key_id"]).doUpdateSet({
+    version: data.version,
+    definition: jsonb(data.definition),
+    schema_hash: data.schemaHash,
+    handler_path: data.handlerPath,
+    schema_name: data.schemaName ?? null,
+    updated_at: new Date
+  })).returningAll().executeTakeFirstOrThrow();
+}
+async function getView(db, name, apiKeyId) {
+  let query = db.selectFrom("views").selectAll().where("name", "=", name);
+  if (apiKeyId) {
+    query = query.where("api_key_id", "=", apiKeyId);
+  }
+  return await query.executeTakeFirst() ?? null;
+}
+async function listViews(db, apiKeyId) {
+  let query = db.selectFrom("views").selectAll();
+  if (apiKeyId) {
+    query = query.where("api_key_id", "=", apiKeyId);
+  }
+  return query.execute();
+}
+async function updateViewStatus(db, name, status, lastProcessedBlock) {
+  await db.updateTable("views").set({
+    status,
+    ...lastProcessedBlock !== undefined ? { last_processed_block: lastProcessedBlock } : {},
+    updated_at: new Date
+  }).where("name", "=", name).execute();
+}
+async function recordViewProcessed(db, name, processed, errors, lastError) {
+  await db.updateTable("views").set({
+    total_processed: sql2`total_processed + ${processed}`,
+    total_errors: sql2`total_errors + ${errors}`,
+    ...lastError ? { last_error: lastError, last_error_at: new Date } : {},
+    updated_at: new Date
+  }).where("name", "=", name).execute();
+}
+async function updateViewHandlerPath(db, name, handlerPath) {
+  await db.updateTable("views").set({ handler_path: handlerPath, updated_at: new Date }).where("name", "=", name).execute();
+}
+async function deleteView(db, name, apiKeyId) {
+  const view = await getView(db, name, apiKeyId);
+  if (!view)
+    return null;
+  const schemaName = view.schema_name ?? pgSchemaName(name);
+  await sql2`DROP SCHEMA IF EXISTS ${sql2.raw(`"${schemaName}"`)} CASCADE`.execute(db);
+  await db.deleteFrom("views").where("id", "=", view.id).execute();
+  return view;
+}
+export {
+  updateViewStatus,
+  updateViewHandlerPath,
+  registerView,
+  recordViewProcessed,
+  pgSchemaName,
+  listViews,
+  getView,
+  deleteView
+};
+
+//# debugId=C19949368802BB4964756E2164756E21
+//# sourceMappingURL=views.js.map

package/dist/src/db/queries/views.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/db/jsonb.ts", "../src/db/queries/views.ts"],
+  "sourcesContent": [
+    "import { sql } from \"kysely\";\n\n/**\n * Safely encode a JS value as a JSONB literal for Kysely inserts/updates.\n * Kysely + postgres.js double-encodes JSON when using parameterized queries\n * with ::jsonb casts. This uses sql.raw to inline a properly escaped literal.\n */\nexport function jsonb(value: unknown) {\n  const escaped = JSON.stringify(value).replace(/'/g, \"''\");\n  return sql`${sql.raw(`'${escaped}'::jsonb`)}`;\n}\n\n/**\n * Safely parse a JSONB value from the database.\n * Handles double-encoded strings where postgres.js returns a JSON string\n * instead of a parsed object.\n */\nexport function parseJsonb<T = unknown>(value: unknown): T {\n  if (typeof value === \"string\") {\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return value as T;\n    }\n  }\n  return (value ?? {}) as T;\n}\n",
+    "import { sql, type Kysely } from \"kysely\";\nimport { jsonb } from \"../jsonb.ts\";\nimport type { Database } from \"../types.ts\";\n\n/**\n * Convert a view name to its PostgreSQL schema name.\n * With keyPrefix: \"view_{prefix}_{name}\" (tenant-isolated)\n * Without keyPrefix: \"view_{name}\" (backward compat)\n */\nexport function pgSchemaName(viewName: string, keyPrefix?: string): string {\n  const safeName = viewName.replace(/-/g, \"_\");\n  if (!keyPrefix) {\n    return `view_${safeName}`;\n  }\n  const safePrefix = keyPrefix.replace(/^sk-sl_/, \"\").replace(/-/g, \"_\");\n  return `view_${safePrefix}_${safeName}`;\n}\n\nexport async function registerView(\n  db: Kysely<Database>,\n  data: {\n    name: string;\n    version: string;\n    definition: Record<string, unknown>;\n    schemaHash: string;\n    handlerPath: string;\n    apiKeyId?: string;\n    schemaName?: string;\n  },\n) {\n  return await db\n    .insertInto(\"views\")\n    .values({\n      name: data.name,\n      version: data.version,\n      definition: jsonb(data.definition) as any,\n      schema_hash: data.schemaHash,\n      handler_path: data.handlerPath,\n      api_key_id: data.apiKeyId ?? null,\n      schema_name: data.schemaName ?? null,\n    })\n    .onConflict((oc) =>\n      oc.columns([\"name\", \"api_key_id\"]).doUpdateSet({\n        version: data.version,\n        definition: jsonb(data.definition) as any,\n        schema_hash: data.schemaHash,\n        handler_path: data.handlerPath,\n        schema_name: data.schemaName ?? null,\n        updated_at: new Date(),\n      }),\n    )\n    .returningAll()\n    .executeTakeFirstOrThrow();\n}\n\nexport async function getView(db: Kysely<Database>, name: string, apiKeyId?: string) {\n  let query = db\n    .selectFrom(\"views\")\n    .selectAll()\n    .where(\"name\", \"=\", name);\n\n  if (apiKeyId) {\n    query = query.where(\"api_key_id\", \"=\", apiKeyId);\n  }\n\n  return (await query.executeTakeFirst()) ?? null;\n}\n\nexport async function listViews(db: Kysely<Database>, apiKeyId?: string) {\n  let query = db.selectFrom(\"views\").selectAll();\n  if (apiKeyId) {\n    query = query.where(\"api_key_id\", \"=\", apiKeyId);\n  }\n  return query.execute();\n}\n\nexport async function updateViewStatus(\n  db: Kysely<Database>,\n  name: string,\n  status: string,\n  lastProcessedBlock?: number,\n) {\n  await db\n    .updateTable(\"views\")\n    .set({\n      status,\n      ...(lastProcessedBlock !== undefined ? { last_processed_block: lastProcessedBlock } : {}),\n      updated_at: new Date(),\n    })\n    .where(\"name\", \"=\", name)\n    .execute();\n}\n\nexport async function recordViewProcessed(\n  db: Kysely<Database>,\n  name: string,\n  processed: number,\n  errors: number,\n  lastError?: string,\n) {\n  await db\n    .updateTable(\"views\")\n    .set({\n      total_processed: sql`total_processed + ${processed}`,\n      total_errors: sql`total_errors + ${errors}`,\n      ...(lastError\n        ? { last_error: lastError, last_error_at: new Date() }\n        : {}),\n      updated_at: new Date(),\n    })\n    .where(\"name\", \"=\", name)\n    .execute();\n}\n\nexport async function updateViewHandlerPath(\n  db: Kysely<Database>,\n  name: string,\n  handlerPath: string,\n) {\n  await db\n    .updateTable(\"views\")\n    .set({ handler_path: handlerPath, updated_at: new Date() })\n    .where(\"name\", \"=\", name)\n    .execute();\n}\n\nexport async function deleteView(db: Kysely<Database>, name: string, apiKeyId?: string) {\n  const view = await getView(db, name, apiKeyId);\n  if (!view) return null;\n\n  // Use stored schema_name if available, otherwise compute\n  const schemaName = view.schema_name ?? pgSchemaName(name);\n\n  // Drop the view's schema (CASCADE drops all tables within)\n  await sql`DROP SCHEMA IF EXISTS ${sql.raw(`\"${schemaName}\"`)} CASCADE`.execute(db);\n\n  // Remove from registry\n  await db.deleteFrom(\"views\").where(\"id\", \"=\", view.id).execute();\n\n  return view;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C19949368802BB4964756E2164756E21",
+  "names": []
+}

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

@@ -0,0 +1,207 @@
+import { Generated, Insertable, Selectable, Updateable } from "kysely";
+interface BlocksTable {
+	height: number;
+	hash: string;
+	parent_hash: string;
+	burn_block_height: number;
+	timestamp: number;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface TransactionsTable {
+	tx_id: string;
+	block_height: number;
+	type: string;
+	sender: string;
+	status: string;
+	contract_id: string | null;
+	function_name: string | null;
+	raw_tx: string;
+	created_at: Generated<Date>;
+}
+interface EventsTable {
+	id: Generated<string>;
+	tx_id: string;
+	block_height: number;
+	event_index: number;
+	type: string;
+	data: unknown;
+	created_at: Generated<Date>;
+}
+interface StreamsTable {
+	id: Generated<string>;
+	name: string;
+	status: Generated<string>;
+	filters: unknown;
+	options: Generated<unknown>;
+	webhook_url: string;
+	webhook_secret: string | null;
+	api_key_id: string | null;
+	created_at: Generated<Date>;
+	updated_at: Generated<Date>;
+}
+interface StreamMetricsTable {
+	stream_id: string;
+	last_triggered_at: Date | null;
+	last_triggered_block: number | null;
+	total_deliveries: Generated<number>;
+	failed_deliveries: Generated<number>;
+	error_message: string | null;
+}
+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;
+}
+interface IndexProgressTable {
+	network: string;
+	last_indexed_block: Generated<number>;
+	last_contiguous_block: Generated<number>;
+	highest_seen_block: Generated<number>;
+	updated_at: Generated<Date>;
+}
+interface DeliveriesTable {
+	id: Generated<string>;
+	stream_id: string;
+	job_id: string | null;
+	block_height: number;
+	status: string;
+	status_code: number | null;
+	response_time_ms: number | null;
+	attempts: Generated<number>;
+	error: string | null;
+	payload: unknown;
+	created_at: Generated<Date>;
+}
+interface ViewsTable {
+	id: Generated<string>;
+	name: string;
+	version: Generated<string>;
+	status: Generated<string>;
+	definition: unknown;
+	schema_hash: string;
+	handler_path: string;
+	schema_name: string | null;
+	last_processed_block: Generated<number>;
+	last_error: string | null;
+	last_error_at: Date | null;
+	total_processed: Generated<number>;
+	total_errors: Generated<number>;
+	api_key_id: string | null;
+	created_at: Generated<Date>;
+	updated_at: Generated<Date>;
+}
+interface ApiKeysTable {
+	id: Generated<string>;
+	key_hash: string;
+	key_prefix: string;
+	name: string | null;
+	status: Generated<string>;
+	rate_limit: Generated<number>;
+	ip_address: string;
+	account_id: string;
+	last_used_at: Date | null;
+	revoked_at: Date | null;
+	created_at: Generated<Date>;
+}
+interface AccountsTable {
+	id: Generated<string>;
+	email: string;
+	plan: Generated<string>;
+	created_at: Generated<Date>;
+}
+interface SessionsTable {
+	id: Generated<string>;
+	token_hash: string;
+	token_prefix: string;
+	account_id: string;
+	ip_address: string;
+	expires_at: Generated<Date>;
+	revoked_at: Date | null;
+	last_used_at: Date | null;
+	created_at: Generated<Date>;
+}
+interface MagicLinksTable {
+	id: Generated<string>;
+	email: string;
+	token: string;
+	expires_at: Date;
+	used_at: Date | null;
+	created_at: Generated<Date>;
+}
+interface UsageDailyTable {
+	account_id: string;
+	date: string;
+	api_requests: Generated<number>;
+	deliveries: Generated<number>;
+}
+interface UsageSnapshotsTable {
+	id: Generated<string>;
+	account_id: string;
+	measured_at: Generated<Date>;
+	storage_bytes: Generated<number>;
+}
+interface Database {
+	blocks: BlocksTable;
+	transactions: TransactionsTable;
+	events: EventsTable;
+	streams: StreamsTable;
+	stream_metrics: StreamMetricsTable;
+	jobs: JobsTable;
+	index_progress: IndexProgressTable;
+	deliveries: DeliveriesTable;
+	views: ViewsTable;
+	api_keys: ApiKeysTable;
+	accounts: AccountsTable;
+	sessions: SessionsTable;
+	magic_links: MagicLinksTable;
+	usage_daily: UsageDailyTable;
+	usage_snapshots: UsageSnapshotsTable;
+}
+type Block = Selectable<BlocksTable>;
+type InsertBlock = Insertable<BlocksTable>;
+type UpdateBlock = Updateable<BlocksTable>;
+type Transaction = Selectable<TransactionsTable>;
+type InsertTransaction = Insertable<TransactionsTable>;
+type UpdateTransaction = Updateable<TransactionsTable>;
+type Event = Selectable<EventsTable>;
+type InsertEvent = Insertable<EventsTable>;
+type UpdateEvent = Updateable<EventsTable>;
+type Stream = Selectable<StreamsTable>;
+type InsertStream = Insertable<StreamsTable>;
+type UpdateStreamRow = Updateable<StreamsTable>;
+type StreamMetrics = Selectable<StreamMetricsTable>;
+type InsertStreamMetrics = Insertable<StreamMetricsTable>;
+type UpdateStreamMetrics = Updateable<StreamMetricsTable>;
+type Job = Selectable<JobsTable>;
+type InsertJob = Insertable<JobsTable>;
+type UpdateJob = Updateable<JobsTable>;
+type IndexProgress = Selectable<IndexProgressTable>;
+type InsertIndexProgress = Insertable<IndexProgressTable>;
+type UpdateIndexProgress = Updateable<IndexProgressTable>;
+type Delivery = Selectable<DeliveriesTable>;
+type InsertDelivery = Insertable<DeliveriesTable>;
+type UpdateDelivery = Updateable<DeliveriesTable>;
+type View = Selectable<ViewsTable>;
+type InsertView = Insertable<ViewsTable>;
+type UpdateView = Updateable<ViewsTable>;
+type ApiKey = Selectable<ApiKeysTable>;
+type InsertApiKey = Insertable<ApiKeysTable>;
+type UpdateApiKey = Updateable<ApiKeysTable>;
+type Account = Selectable<AccountsTable>;
+type InsertAccount = Insertable<AccountsTable>;
+type MagicLink = Selectable<MagicLinksTable>;
+type InsertMagicLink = Insertable<MagicLinksTable>;
+type Session = Selectable<SessionsTable>;
+type InsertSession = Insertable<SessionsTable>;
+type UsageDaily = Selectable<UsageDailyTable>;
+type UsageSnapshot = Selectable<UsageSnapshotsTable>;
+export { ViewsTable, View, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateView, UpdateTransaction, UpdateStreamRow, UpdateStreamMetrics, UpdateJob, UpdateIndexProgress, UpdateEvent, UpdateDelivery, UpdateBlock, UpdateApiKey, TransactionsTable, Transaction, StreamsTable, StreamMetricsTable, StreamMetrics, Stream, SessionsTable, Session, MagicLinksTable, MagicLink, JobsTable, Job, InsertView, InsertTransaction, InsertStreamMetrics, InsertStream, InsertSession, InsertMagicLink, InsertJob, InsertIndexProgress, InsertEvent, InsertDelivery, InsertBlock, InsertApiKey, InsertAccount, IndexProgressTable, IndexProgress, EventsTable, Event, Delivery, DeliveriesTable, Database, BlocksTable, Block, ApiKeysTable, ApiKey, AccountsTable, Account };

package/dist/src/db/schema.js

@@ -0,0 +1,3 @@
+
+//# debugId=B38FA1B18F1C526964756E2164756E21
+//# sourceMappingURL=schema.js.map

package/dist/src/db/schema.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "B38FA1B18F1C526964756E2164756E21",
+  "names": []
+}

package/dist/src/env.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+declare const envSchema: unknown;
+type Env = z.infer<typeof envSchema> & {
+	enabledNetworks: ("mainnet" | "testnet")[]
+};
+declare function getEnv(): Env;
+export { getEnv, envSchema, Env };

package/dist/src/env.js

@@ -0,0 +1,60 @@
+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;
+}
+export {
+  getEnv,
+  envSchema
+};
+
+//# debugId=36753D595F72E07A64756E2164756E21
+//# sourceMappingURL=env.js.map

package/dist/src/env.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/env.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"
+  ],
+  "mappings": ";;;;;;;;;;;;;AAAA;AAGA,IAAM,iBAAiB,EAAE,OAAO,EAAE,UAAU,CAAC,QAAQ;AAAA,EACnD,MAAM,WAAW,IAAI,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO;AAAA,EACnE,MAAM,QAAQ,CAAC,WAAW,SAAS;AAAA,EACnC,WAAW,KAAK,UAAU;AAAA,IACxB,IAAI,CAAC,MAAM,SAAS,CAAC,GAAG;AAAA,MACtB,MAAM,IAAI,MAAM,oBAAoB,sBAAsB,MAAM,KAAK,IAAI,GAAG;AAAA,IAC9E;AAAA,EACF;AAAA,EACA,OAAO;AAAA,CACR;AAED,IAAM,YAAY,EAAE,OAAO;AAAA,EAEzB,cAAc,EAAE,WACd,CAAC,QAAS,OAAO,QAAQ,YAAY,IAAI,WAAW,IAAK,YAAY,KACrE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAC5B;AAAA,EAEA,SAAS,EAAE,KAAK,CAAC,WAAW,SAAS,CAAC,EAAE,SAAS;AAAA,EAEjD,UAAU,eAAe,SAAS;AAAA,EAClC,WAAW,EAAE,KAAK,CAAC,SAAS,QAAQ,QAAQ,OAAO,CAAC,EAAE,QAAQ,MAAM;AAAA,EACpE,UAAU,EAAE,KAAK,CAAC,eAAe,cAAc,MAAM,CAAC,EAAE,QAAQ,aAAa;AAC/E,CAAC;AAMD,IAAI,YAAwB;AAErB,SAAS,MAAM,GAAQ;AAAA,EAC5B,IAAI,WAAW;AAAA,IACb,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAS,UAAU,UAAU,QAAQ,GAAG;AAAA,EAE9C,IAAI,CAAC,OAAO,SAAS;AAAA,IACnB,QAAQ,MAAM,sCAAqC;AAAA,IACnD,QAAQ,MAAM,OAAO,MAAM,OAAO,CAAC;AAAA,IACnC,MAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AAAA,EAGA,IAAI;AAAA,EACJ,IAAI,OAAO,KAAK,YAAY,OAAO,KAAK,SAAS,SAAS,GAAG;AAAA,IAC3D,kBAAkB,OAAO,KAAK;AAAA,EAChC,EAAO,SAAI,OAAO,KAAK,SAAS;AAAA,IAC9B,kBAAkB,CAAC,OAAO,KAAK,OAAO;AAAA,EACxC,EAAO;AAAA,IACL,kBAAkB,CAAC,SAAS;AAAA;AAAA,EAG9B,YAAY,KAAK,OAAO,MAAM,gBAAgB;AAAA,EAC9C,OAAO;AAAA;",
+  "debugId": "36753D595F72E07A64756E2164756E21",
+  "names": []
+}

package/dist/src/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+* Base error class for all Stacks Streams errors
+*/
+declare class StreamsError extends Error {
+	code: string;
+	cause?: unknown;
+	constructor(code: string, message: string, cause?: unknown);
+	toJSON(): {};
+}
+/**
+* Stream not found error
+*/
+declare class StreamNotFoundError extends StreamsError {
+	constructor(streamId: string);
+}
+/**
+* Validation error for invalid input
+*/
+declare class ValidationError extends StreamsError {
+	constructor(message: string, cause?: unknown);
+}
+/**
+* Database operation error
+*/
+declare class DatabaseError extends StreamsError {
+	constructor(message: string, cause?: unknown);
+}
+/**
+* Webhook delivery error
+*/
+declare class WebhookDeliveryError extends StreamsError {
+	statusCode?: number;
+	constructor(message: string, statusCode?: number, cause?: unknown);
+	toJSON(): {};
+}
+/**
+* Filter evaluation error
+*/
+declare class FilterEvaluationError extends StreamsError {
+	constructor(message: string, cause?: unknown);
+}
+declare class AuthenticationError extends StreamsError {
+	constructor(message: string);
+}
+declare class AuthorizationError extends StreamsError {
+	constructor(message: string);
+}
+declare class RateLimitError extends StreamsError {
+	constructor(message: string);
+}
+export { WebhookDeliveryError, ValidationError, StreamsError, StreamNotFoundError, RateLimitError, FilterEvaluationError, DatabaseError, AuthorizationError, AuthenticationError };

package/dist/src/errors.js

@@ -0,0 +1,103 @@
+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/errors.ts
+class StreamsError extends Error {
+  code;
+  cause;
+  constructor(code, message, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = this.constructor.name;
+    Error.captureStackTrace?.(this, this.constructor);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      stack: this.stack,
+      cause: this.cause
+    };
+  }
+}
+
+class StreamNotFoundError extends StreamsError {
+  constructor(streamId) {
+    super("STREAM_NOT_FOUND", `Stream not found: ${streamId}`);
+  }
+}
+
+class ValidationError extends StreamsError {
+  constructor(message, cause) {
+    super("VALIDATION_ERROR", message, cause);
+  }
+}
+
+class DatabaseError extends StreamsError {
+  constructor(message, cause) {
+    super("DATABASE_ERROR", message, cause);
+  }
+}
+
+class WebhookDeliveryError extends StreamsError {
+  statusCode;
+  constructor(message, statusCode, cause) {
+    super("WEBHOOK_DELIVERY_ERROR", message, cause);
+    this.statusCode = statusCode;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      statusCode: this.statusCode
+    };
+  }
+}
+
+class FilterEvaluationError extends StreamsError {
+  constructor(message, cause) {
+    super("FILTER_EVALUATION_ERROR", message, cause);
+  }
+}
+
+class AuthenticationError extends StreamsError {
+  constructor(message) {
+    super("AUTHENTICATION_ERROR", message);
+  }
+}
+
+class AuthorizationError extends StreamsError {
+  constructor(message) {
+    super("AUTHORIZATION_ERROR", message);
+  }
+}
+
+class RateLimitError extends StreamsError {
+  constructor(message) {
+    super("RATE_LIMIT_ERROR", message);
+  }
+}
+export {
+  WebhookDeliveryError,
+  ValidationError,
+  StreamsError,
+  StreamNotFoundError,
+  RateLimitError,
+  FilterEvaluationError,
+  DatabaseError,
+  AuthorizationError,
+  AuthenticationError
+};
+
+//# debugId=6ACA7F80BF720CB464756E2164756E21
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts"],
+  "sourcesContent": [
+    "/**\n * Base error class for all Stacks Streams errors\n */\nexport class StreamsError extends Error {\n  public code: string;\n  public override cause?: unknown;\n\n  constructor(\n    code: string,\n    message: string,\n    cause?: unknown\n  ) {\n    super(message);\n    this.code = code;\n    this.cause = cause;\n    this.name = this.constructor.name;\n    Error.captureStackTrace?.(this, this.constructor);\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      stack: this.stack,\n      cause: this.cause,\n    };\n  }\n}\n\n/**\n * Stream not found error\n */\nexport class StreamNotFoundError extends StreamsError {\n  constructor(streamId: string) {\n    super(\"STREAM_NOT_FOUND\", `Stream not found: ${streamId}`);\n  }\n}\n\n/**\n * Validation error for invalid input\n */\nexport class ValidationError extends StreamsError {\n  constructor(message: string, cause?: unknown) {\n    super(\"VALIDATION_ERROR\", message, cause);\n  }\n}\n\n/**\n * Database operation error\n */\nexport class DatabaseError extends StreamsError {\n  constructor(message: string, cause?: unknown) {\n    super(\"DATABASE_ERROR\", message, cause);\n  }\n}\n\n/**\n * Webhook delivery error\n */\nexport class WebhookDeliveryError extends StreamsError {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    cause?: unknown\n  ) {\n    super(\"WEBHOOK_DELIVERY_ERROR\", message, cause);\n  }\n\n  override toJSON() {\n    return {\n      ...super.toJSON(),\n      statusCode: this.statusCode,\n    };\n  }\n}\n\n/**\n * Filter evaluation error\n */\nexport class FilterEvaluationError extends StreamsError {\n  constructor(message: string, cause?: unknown) {\n    super(\"FILTER_EVALUATION_ERROR\", message, cause);\n  }\n}\n\nexport class AuthenticationError extends StreamsError {\n  constructor(message: string) {\n    super(\"AUTHENTICATION_ERROR\", message);\n  }\n}\n\nexport class AuthorizationError extends StreamsError {\n  constructor(message: string) {\n    super(\"AUTHORIZATION_ERROR\", message);\n  }\n}\n\nexport class RateLimitError extends StreamsError {\n  constructor(message: string) {\n    super(\"RATE_LIMIT_ERROR\", message);\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;AAGO,MAAM,qBAAqB,MAAM;AAAA,EAC/B;AAAA,EACS;AAAA,EAEhB,WAAW,CACT,MACA,SACA,OACA;AAAA,IACA,MAAM,OAAO;AAAA,IACb,KAAK,OAAO;AAAA,IACZ,KAAK,QAAQ;AAAA,IACb,KAAK,OAAO,KAAK,YAAY;AAAA,IAC7B,MAAM,oBAAoB,MAAM,KAAK,WAAW;AAAA;AAAA,EAGlD,MAAM,GAAG;AAAA,IACP,OAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,OAAO,KAAK;AAAA,MACZ,OAAO,KAAK;AAAA,IACd;AAAA;AAEJ;AAAA;AAKO,MAAM,4BAA4B,aAAa;AAAA,EACpD,WAAW,CAAC,UAAkB;AAAA,IAC5B,MAAM,oBAAoB,qBAAqB,UAAU;AAAA;AAE7D;AAAA;AAKO,MAAM,wBAAwB,aAAa;AAAA,EAChD,WAAW,CAAC,SAAiB,OAAiB;AAAA,IAC5C,MAAM,oBAAoB,SAAS,KAAK;AAAA;AAE5C;AAAA;AAKO,MAAM,sBAAsB,aAAa;AAAA,EAC9C,WAAW,CAAC,SAAiB,OAAiB;AAAA,IAC5C,MAAM,kBAAkB,SAAS,KAAK;AAAA;AAE1C;AAAA;AAKO,MAAM,6BAA6B,aAAa;AAAA,EAG5C;AAAA,EAFT,WAAW,CACT,SACO,YACP,OACA;AAAA,IACA,MAAM,0BAA0B,SAAS,KAAK;AAAA,IAHvC;AAAA;AAAA,EAMA,MAAM,GAAG;AAAA,IAChB,OAAO;AAAA,SACF,MAAM,OAAO;AAAA,MAChB,YAAY,KAAK;AAAA,IACnB;AAAA;AAEJ;AAAA;AAKO,MAAM,8BAA8B,aAAa;AAAA,EACtD,WAAW,CAAC,SAAiB,OAAiB;AAAA,IAC5C,MAAM,2BAA2B,SAAS,KAAK;AAAA;AAEnD;AAAA;AAEO,MAAM,4BAA4B,aAAa;AAAA,EACpD,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,wBAAwB,OAAO;AAAA;AAEzC;AAAA;AAEO,MAAM,2BAA2B,aAAa;AAAA,EACnD,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,uBAAuB,OAAO;AAAA;AAExC;AAAA;AAEO,MAAM,uBAAuB,aAAa;AAAA,EAC/C,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,oBAAoB,OAAO;AAAA;AAErC;",
+  "debugId": "6ACA7F80BF720CB464756E2164756E21",
+  "names": []
+}