routeflow-api 0.2.0

package/dist/adapters/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts","../../src/adapters/redis/redis-adapter.ts"],"sourcesContent":["/**\n * Base error class for all RouteFlow errors.\n * Always use this instead of plain `Error` throughout the framework.\n */\nexport class ReactiveApiError extends Error {\n  /** Machine-readable error code (e.g. 'ADAPTER_NOT_CONNECTED', 'INVALID_ROUTE') */\n  readonly code: string\n\n  constructor(code: string, message: string) {\n    super(message)\n    this.name = 'ReactiveApiError'\n    this.code = code\n    // Restore prototype chain (required when extending built-ins in TS)\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","import type { ChangeEvent, DatabaseAdapter } from '../../core/types.js'\nimport { ReactiveApiError } from '../../core/errors.js'\nimport type { RedisAdapterOptions, RedisChangePayload, RedisSubscriber } from './types.js'\n\n/**\n * Redis adapter for RouteFlow.\n *\n * Each watched table maps to one Redis pub/sub channel. Publishers are expected\n * to publish JSON payloads in the RouteFlow change-event shape.\n */\nexport class RedisAdapter implements DatabaseAdapter {\n  private readonly subscriber: RedisSubscriber\n  private readonly channelPrefix: string\n  private readonly onError?: RedisAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleMessageBound = (channel: string, payload: string) => {\n    this.handleMessage(channel, payload)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: RedisAdapterOptions) {\n    this.subscriber = options.subscriber\n    this.channelPrefix = options.channelPrefix ?? 'flux'\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) return\n\n    this.subscriber.on('message', this.handleMessageBound)\n    this.subscriber.on('error', this.handleErrorBound)\n\n    for (const table of this.listeners.keys()) {\n      await this.subscriber.subscribe(channelName(this.channelPrefix, table))\n    }\n\n    this.connected = true\n  }\n\n  async disconnect(): Promise<void> {\n    if (!this.connected) return\n\n    removeListener(this.subscriber, 'message', this.handleMessageBound)\n    removeListener(this.subscriber, 'error', this.handleErrorBound)\n\n    for (const table of this.listeners.keys()) {\n      await this.subscriber.unsubscribe(channelName(this.channelPrefix, table))\n    }\n\n    await this.subscriber.quit?.()\n    await this.subscriber.disconnect?.()\n    this.listeners.clear()\n    this.connected = false\n  }\n\n  onChange(table: string, callback: (event: ChangeEvent) => void): () => void {\n    const hadTable = this.listeners.has(table)\n    if (!hadTable) {\n      this.listeners.set(table, new Set())\n    }\n\n    this.listeners.get(table)!.add(callback)\n\n    if (!hadTable && this.connected) {\n      void this.subscriber.subscribe(channelName(this.channelPrefix, table))\n    }\n\n    return () => {\n      const callbacks = this.listeners.get(table)\n      if (!callbacks) return\n\n      callbacks.delete(callback)\n      if (callbacks.size === 0) {\n        this.listeners.delete(table)\n        if (this.connected) {\n          void this.subscriber.unsubscribe(channelName(this.channelPrefix, table))\n        }\n      }\n    }\n  }\n\n  private handleMessage(channel: string, payload: string): void {\n    const table = parseChannelName(this.channelPrefix, channel)\n    if (!table) return\n\n    let data: unknown\n    try {\n      data = JSON.parse(payload)\n    } catch (error) {\n      throw new ReactiveApiError(\n        'REDIS_PAYLOAD_INVALID',\n        `Failed to parse Redis payload for \"${channel}\": ${errorMessage(error)}`,\n      )\n    }\n\n    if (!isRedisChangePayload(data)) return\n\n    const callbacks = this.listeners.get(data.table)\n    if (!callbacks) return\n\n    const event: ChangeEvent = {\n      table: data.table,\n      operation: data.operation,\n      newRow: data.newRow,\n      oldRow: data.oldRow,\n      timestamp: data.timestamp ?? Date.now(),\n    }\n\n    for (const callback of callbacks) {\n      callback(event)\n    }\n  }\n}\n\nfunction channelName(prefix: string, table: string): string {\n  return `${prefix}:${table}`\n}\n\nfunction parseChannelName(prefix: string, channel: string): string | null {\n  const expectedPrefix = `${prefix}:`\n  if (!channel.startsWith(expectedPrefix)) return null\n  return channel.slice(expectedPrefix.length)\n}\n\nfunction removeListener(\n  subscriber: RedisSubscriber,\n  event: 'message' | 'error',\n  listener: (...args: any[]) => void,\n): void {\n  if (subscriber.off) {\n    subscriber.off(event, listener)\n    return\n  }\n\n  subscriber.removeListener?.(event, listener)\n}\n\nfunction isRedisChangePayload(value: unknown): value is RedisChangePayload {\n  if (typeof value !== 'object' || value === null) return false\n  const record = value as Record<string, unknown>\n  return (\n    typeof record['table'] === 'string' &&\n    (record['operation'] === 'INSERT' ||\n      record['operation'] === 'UPDATE' ||\n      record['operation'] === 'DELETE')\n  )\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/snowflake.cjs

@@ -0,0 +1,117 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/snowflake.ts
+var snowflake_exports = {};
+__export(snowflake_exports, {
+  SnowflakeAdapter: () => SnowflakeAdapter
+});
+module.exports = __toCommonJS(snowflake_exports);
+
+// src/core/errors.ts
+var ReactiveApiError = class extends Error {
+  /** Machine-readable error code (e.g. 'ADAPTER_NOT_CONNECTED', 'INVALID_ROUTE') */
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ReactiveApiError";
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/adapters/snowflake/snowflake-adapter.ts
+var SnowflakeAdapter = class {
+  source;
+  onError;
+  listeners = /* @__PURE__ */ new Map();
+  handleChangeBound = (event) => {
+    this.handleChange(event);
+  };
+  handleErrorBound = (error) => {
+    this.onError?.(error);
+  };
+  connected = false;
+  constructor(options) {
+    this.source = options.source;
+    this.onError = options.onError;
+  }
+  async connect() {
+    if (this.connected) return;
+    this.source.on("change", this.handleChangeBound);
+    this.source.on("error", this.handleErrorBound);
+    try {
+      await this.source.start?.();
+    } catch (error) {
+      throw new ReactiveApiError(
+        "SNOWFLAKE_SOURCE_START_FAILED",
+        `Failed to start Snowflake change source: ${errorMessage(error)}`
+      );
+    }
+    this.connected = true;
+  }
+  async disconnect() {
+    if (!this.connected) return;
+    removeListener(this.source, "change", this.handleChangeBound);
+    removeListener(this.source, "error", this.handleErrorBound);
+    await this.source.stop?.();
+    this.listeners.clear();
+    this.connected = false;
+  }
+  onChange(table, callback) {
+    if (!this.listeners.has(table)) {
+      this.listeners.set(table, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(table).add(callback);
+    return () => {
+      const callbacks = this.listeners.get(table);
+      if (!callbacks) return;
+      callbacks.delete(callback);
+      if (callbacks.size === 0) {
+        this.listeners.delete(table);
+      }
+    };
+  }
+  handleChange(change) {
+    const callbacks = this.listeners.get(change.table);
+    if (!callbacks) return;
+    const event = {
+      ...change,
+      timestamp: change.timestamp ?? Date.now()
+    };
+    for (const callback of callbacks) {
+      callback(event);
+    }
+  }
+};
+function removeListener(source, event, listener) {
+  if (source.off) {
+    source.off(event, listener);
+    return;
+  }
+  source.removeListener?.(event, listener);
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SnowflakeAdapter
+});
+//# sourceMappingURL=snowflake.cjs.map

package/dist/adapters/snowflake.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/snowflake.ts","../../src/core/errors.ts","../../src/adapters/snowflake/snowflake-adapter.ts"],"sourcesContent":["export { SnowflakeAdapter } from './snowflake/snowflake-adapter.js'\nexport type { SnowflakeAdapterOptions } from './snowflake/types.js'\n","/**\n * Base error class for all RouteFlow errors.\n * Always use this instead of plain `Error` throughout the framework.\n */\nexport class ReactiveApiError extends Error {\n  /** Machine-readable error code (e.g. 'ADAPTER_NOT_CONNECTED', 'INVALID_ROUTE') */\n  readonly code: string\n\n  constructor(code: string, message: string) {\n    super(message)\n    this.name = 'ReactiveApiError'\n    this.code = code\n    // Restore prototype chain (required when extending built-ins in TS)\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","import type { ChangeEvent, DatabaseAdapter } from '../../core/types.js'\nimport { ReactiveApiError } from '../../core/errors.js'\nimport type {\n  SnowflakeAdapterOptions,\n  SnowflakeChangeEvent,\n  SnowflakeChangeSource,\n} from './types.js'\n\nexport class SnowflakeAdapter implements DatabaseAdapter {\n  private readonly source: SnowflakeChangeSource\n  private readonly onError?: SnowflakeAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleChangeBound = (event: SnowflakeChangeEvent) => {\n    this.handleChange(event)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: SnowflakeAdapterOptions) {\n    this.source = options.source\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) return\n\n    this.source.on('change', this.handleChangeBound)\n    this.source.on('error', this.handleErrorBound)\n\n    try {\n      await this.source.start?.()\n    } catch (error) {\n      throw new ReactiveApiError(\n        'SNOWFLAKE_SOURCE_START_FAILED',\n        `Failed to start Snowflake change source: ${errorMessage(error)}`,\n      )\n    }\n\n    this.connected = true\n  }\n\n  async disconnect(): Promise<void> {\n    if (!this.connected) return\n\n    removeListener(this.source, 'change', this.handleChangeBound)\n    removeListener(this.source, 'error', this.handleErrorBound)\n    await this.source.stop?.()\n    this.listeners.clear()\n    this.connected = false\n  }\n\n  onChange(table: string, callback: (event: ChangeEvent) => void): () => void {\n    if (!this.listeners.has(table)) {\n      this.listeners.set(table, new Set())\n    }\n\n    this.listeners.get(table)!.add(callback)\n\n    return () => {\n      const callbacks = this.listeners.get(table)\n      if (!callbacks) return\n\n      callbacks.delete(callback)\n      if (callbacks.size === 0) {\n        this.listeners.delete(table)\n      }\n    }\n  }\n\n  private handleChange(change: SnowflakeChangeEvent): void {\n    const callbacks = this.listeners.get(change.table)\n    if (!callbacks) return\n\n    const event: ChangeEvent = {\n      ...change,\n      timestamp: change.timestamp ?? Date.now(),\n    }\n\n    for (const callback of callbacks) {\n      callback(event)\n    }\n  }\n}\n\nfunction removeListener(\n  source: SnowflakeChangeSource,\n  event: 'change' | 'error',\n  listener: (...args: any[]) => void,\n): void {\n  if (source.off) {\n    source.off(event, listener)\n    return\n  }\n\n  source.removeListener?.(event, listener)\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,IAAM,mBAAN,cAA+B,MAAM;AAAA;AAAA,EAEjC;AAAA,EAET,YAAY,MAAc,SAAiB;AACzC,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAEZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;;;ACPO,IAAM,mBAAN,MAAkD;AAAA,EACtC;AAAA,EACA;AAAA,EACA,YAA4D,oBAAI,IAAI;AAAA,EACpE,oBAAoB,CAAC,UAAgC;AACpE,SAAK,aAAa,KAAK;AAAA,EACzB;AAAA,EACiB,mBAAmB,CAAC,UAAiB;AACpD,SAAK,UAAU,KAAK;AAAA,EACtB;AAAA,EACQ,YAAY;AAAA,EAEpB,YAAY,SAAkC;AAC5C,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ;AAAA,EACzB;AAAA,EAEA,MAAM,UAAyB;AAC7B,QAAI,KAAK,UAAW;AAEpB,SAAK,OAAO,GAAG,UAAU,KAAK,iBAAiB;AAC/C,SAAK,OAAO,GAAG,SAAS,KAAK,gBAAgB;AAE7C,QAAI;AACF,YAAM,KAAK,OAAO,QAAQ;AAAA,IAC5B,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR;AAAA,QACA,4CAA4C,aAAa,KAAK,CAAC;AAAA,MACjE;AAAA,IACF;AAEA,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,MAAM,aAA4B;AAChC,QAAI,CAAC,KAAK,UAAW;AAErB,mBAAe,KAAK,QAAQ,UAAU,KAAK,iBAAiB;AAC5D,mBAAe,KAAK,QAAQ,SAAS,KAAK,gBAAgB;AAC1D,UAAM,KAAK,OAAO,OAAO;AACzB,SAAK,UAAU,MAAM;AACrB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,SAAS,OAAe,UAAoD;AAC1E,QAAI,CAAC,KAAK,UAAU,IAAI,KAAK,GAAG;AAC9B,WAAK,UAAU,IAAI,OAAO,oBAAI,IAAI,CAAC;AAAA,IACrC;AAEA,SAAK,UAAU,IAAI,KAAK,EAAG,IAAI,QAAQ;AAEvC,WAAO,MAAM;AACX,YAAM,YAAY,KAAK,UAAU,IAAI,KAAK;AAC1C,UAAI,CAAC,UAAW;AAEhB,gBAAU,OAAO,QAAQ;AACzB,UAAI,UAAU,SAAS,GAAG;AACxB,aAAK,UAAU,OAAO,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,aAAa,QAAoC;AACvD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO,KAAK;AACjD,QAAI,CAAC,UAAW;AAEhB,UAAM,QAAqB;AAAA,MACzB,GAAG;AAAA,MACH,WAAW,OAAO,aAAa,KAAK,IAAI;AAAA,IAC1C;AAEA,eAAW,YAAY,WAAW;AAChC,eAAS,KAAK;AAAA,IAChB;AAAA,EACF;AACF;AAEA,SAAS,eACP,QACA,OACA,UACM;AACN,MAAI,OAAO,KAAK;AACd,WAAO,IAAI,OAAO,QAAQ;AAC1B;AAAA,EACF;AAEA,SAAO,iBAAiB,OAAO,QAAQ;AACzC;AAEA,SAAS,aAAa,OAAwB;AAC5C,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;","names":[]}

package/dist/adapters/snowflake.d.cts

@@ -0,0 +1,37 @@
+import { C as ChangeEvent, D as DatabaseAdapter } from '../types-tPDla8AE.cjs';
+
+interface SnowflakeChangeEvent<T = unknown> {
+    table: string;
+    operation: ChangeEvent<T>['operation'];
+    newRow: T | null;
+    oldRow: T | null;
+    timestamp?: number;
+}
+interface SnowflakeChangeSource {
+    on(event: 'change', listener: (event: SnowflakeChangeEvent) => void): void;
+    on(event: 'error', listener: (error: Error) => void): void;
+    off?(event: 'change' | 'error', listener: (...args: any[]) => void): void;
+    removeListener?(event: 'change' | 'error', listener: (...args: any[]) => void): void;
+    start?(): Promise<void> | void;
+    stop?(): Promise<void> | void;
+}
+interface SnowflakeAdapterOptions {
+    source: SnowflakeChangeSource;
+    onError?: (error: unknown) => void;
+}
+
+declare class SnowflakeAdapter implements DatabaseAdapter {
+    private readonly source;
+    private readonly onError?;
+    private readonly listeners;
+    private readonly handleChangeBound;
+    private readonly handleErrorBound;
+    private connected;
+    constructor(options: SnowflakeAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(table: string, callback: (event: ChangeEvent) => void): () => void;
+    private handleChange;
+}
+
+export { SnowflakeAdapter, type SnowflakeAdapterOptions };

package/dist/adapters/snowflake.d.ts

@@ -0,0 +1,37 @@
+import { C as ChangeEvent, D as DatabaseAdapter } from '../types-tPDla8AE.js';
+
+interface SnowflakeChangeEvent<T = unknown> {
+    table: string;
+    operation: ChangeEvent<T>['operation'];
+    newRow: T | null;
+    oldRow: T | null;
+    timestamp?: number;
+}
+interface SnowflakeChangeSource {
+    on(event: 'change', listener: (event: SnowflakeChangeEvent) => void): void;
+    on(event: 'error', listener: (error: Error) => void): void;
+    off?(event: 'change' | 'error', listener: (...args: any[]) => void): void;
+    removeListener?(event: 'change' | 'error', listener: (...args: any[]) => void): void;
+    start?(): Promise<void> | void;
+    stop?(): Promise<void> | void;
+}
+interface SnowflakeAdapterOptions {
+    source: SnowflakeChangeSource;
+    onError?: (error: unknown) => void;
+}
+
+declare class SnowflakeAdapter implements DatabaseAdapter {
+    private readonly source;
+    private readonly onError?;
+    private readonly listeners;
+    private readonly handleChangeBound;
+    private readonly handleErrorBound;
+    private connected;
+    constructor(options: SnowflakeAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(table: string, callback: (event: ChangeEvent) => void): () => void;
+    private handleChange;
+}
+
+export { SnowflakeAdapter, type SnowflakeAdapterOptions };

package/dist/adapters/snowflake.js

@@ -0,0 +1,90 @@
+// src/core/errors.ts
+var ReactiveApiError = class extends Error {
+  /** Machine-readable error code (e.g. 'ADAPTER_NOT_CONNECTED', 'INVALID_ROUTE') */
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ReactiveApiError";
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/adapters/snowflake/snowflake-adapter.ts
+var SnowflakeAdapter = class {
+  source;
+  onError;
+  listeners = /* @__PURE__ */ new Map();
+  handleChangeBound = (event) => {
+    this.handleChange(event);
+  };
+  handleErrorBound = (error) => {
+    this.onError?.(error);
+  };
+  connected = false;
+  constructor(options) {
+    this.source = options.source;
+    this.onError = options.onError;
+  }
+  async connect() {
+    if (this.connected) return;
+    this.source.on("change", this.handleChangeBound);
+    this.source.on("error", this.handleErrorBound);
+    try {
+      await this.source.start?.();
+    } catch (error) {
+      throw new ReactiveApiError(
+        "SNOWFLAKE_SOURCE_START_FAILED",
+        `Failed to start Snowflake change source: ${errorMessage(error)}`
+      );
+    }
+    this.connected = true;
+  }
+  async disconnect() {
+    if (!this.connected) return;
+    removeListener(this.source, "change", this.handleChangeBound);
+    removeListener(this.source, "error", this.handleErrorBound);
+    await this.source.stop?.();
+    this.listeners.clear();
+    this.connected = false;
+  }
+  onChange(table, callback) {
+    if (!this.listeners.has(table)) {
+      this.listeners.set(table, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(table).add(callback);
+    return () => {
+      const callbacks = this.listeners.get(table);
+      if (!callbacks) return;
+      callbacks.delete(callback);
+      if (callbacks.size === 0) {
+        this.listeners.delete(table);
+      }
+    };
+  }
+  handleChange(change) {
+    const callbacks = this.listeners.get(change.table);
+    if (!callbacks) return;
+    const event = {
+      ...change,
+      timestamp: change.timestamp ?? Date.now()
+    };
+    for (const callback of callbacks) {
+      callback(event);
+    }
+  }
+};
+function removeListener(source, event, listener) {
+  if (source.off) {
+    source.off(event, listener);
+    return;
+  }
+  source.removeListener?.(event, listener);
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export {
+  SnowflakeAdapter
+};
+//# sourceMappingURL=snowflake.js.map

package/dist/adapters/snowflake.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts","../../src/adapters/snowflake/snowflake-adapter.ts"],"sourcesContent":["/**\n * Base error class for all RouteFlow errors.\n * Always use this instead of plain `Error` throughout the framework.\n */\nexport class ReactiveApiError extends Error {\n  /** Machine-readable error code (e.g. 'ADAPTER_NOT_CONNECTED', 'INVALID_ROUTE') */\n  readonly code: string\n\n  constructor(code: string, message: string) {\n    super(message)\n    this.name = 'ReactiveApiError'\n    this.code = code\n    // Restore prototype chain (required when extending built-ins in TS)\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","import type { ChangeEvent, DatabaseAdapter } from '../../core/types.js'\nimport { ReactiveApiError } from '../../core/errors.js'\nimport type {\n  SnowflakeAdapterOptions,\n  SnowflakeChangeEvent,\n  SnowflakeChangeSource,\n} from './types.js'\n\nexport class SnowflakeAdapter implements DatabaseAdapter {\n  private readonly source: SnowflakeChangeSource\n  private readonly onError?: SnowflakeAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleChangeBound = (event: SnowflakeChangeEvent) => {\n    this.handleChange(event)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: SnowflakeAdapterOptions) {\n    this.source = options.source\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) return\n\n    this.source.on('change', this.handleChangeBound)\n    this.source.on('error', this.handleErrorBound)\n\n    try {\n      await this.source.start?.()\n    } catch (error) {\n      throw new ReactiveApiError(\n        'SNOWFLAKE_SOURCE_START_FAILED',\n        `Failed to start Snowflake change source: ${errorMessage(error)}`,\n      )\n    }\n\n    this.connected = true\n  }\n\n  async disconnect(): Promise<void> {\n    if (!this.connected) return\n\n    removeListener(this.source, 'change', this.handleChangeBound)\n    removeListener(this.source, 'error', this.handleErrorBound)\n    await this.source.stop?.()\n    this.listeners.clear()\n    this.connected = false\n  }\n\n  onChange(table: string, callback: (event: ChangeEvent) => void): () => void {\n    if (!this.listeners.has(table)) {\n      this.listeners.set(table, new Set())\n    }\n\n    this.listeners.get(table)!.add(callback)\n\n    return () => {\n      const callbacks = this.listeners.get(table)\n      if (!callbacks) return\n\n      callbacks.delete(callback)\n      if (callbacks.size === 0) {\n        this.listeners.delete(table)\n      }\n    }\n  }\n\n  private handleChange(change: SnowflakeChangeEvent): void {\n    const callbacks = this.listeners.get(change.table)\n    if (!callbacks) return\n\n    const event: ChangeEvent = {\n      ...change,\n      timestamp: change.timestamp ?? Date.now(),\n    }\n\n    for (const callback of callbacks) {\n      callback(event)\n    }\n  }\n}\n\nfunction removeListener(\n  source: SnowflakeChangeSource,\n  event: 'change' | 'error',\n  listener: (...args: any[]) => void,\n): void {\n  if (source.off) {\n    source.off(event, listener)\n    return\n  }\n\n  source.removeListener?.(event, listener)\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n"],"mappings":";AAIO,IAAM,mBAAN,cAA+B,MAAM;AAAA;AAAA,EAEjC;AAAA,EAET,YAAY,MAAc,SAAiB;AACzC,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAEZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;;;ACPO,IAAM,mBAAN,MAAkD;AAAA,EACtC;AAAA,EACA;AAAA,EACA,YAA4D,oBAAI,IAAI;AAAA,EACpE,oBAAoB,CAAC,UAAgC;AACpE,SAAK,aAAa,KAAK;AAAA,EACzB;AAAA,EACiB,mBAAmB,CAAC,UAAiB;AACpD,SAAK,UAAU,KAAK;AAAA,EACtB;AAAA,EACQ,YAAY;AAAA,EAEpB,YAAY,SAAkC;AAC5C,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ;AAAA,EACzB;AAAA,EAEA,MAAM,UAAyB;AAC7B,QAAI,KAAK,UAAW;AAEpB,SAAK,OAAO,GAAG,UAAU,KAAK,iBAAiB;AAC/C,SAAK,OAAO,GAAG,SAAS,KAAK,gBAAgB;AAE7C,QAAI;AACF,YAAM,KAAK,OAAO,QAAQ;AAAA,IAC5B,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR;AAAA,QACA,4CAA4C,aAAa,KAAK,CAAC;AAAA,MACjE;AAAA,IACF;AAEA,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,MAAM,aAA4B;AAChC,QAAI,CAAC,KAAK,UAAW;AAErB,mBAAe,KAAK,QAAQ,UAAU,KAAK,iBAAiB;AAC5D,mBAAe,KAAK,QAAQ,SAAS,KAAK,gBAAgB;AAC1D,UAAM,KAAK,OAAO,OAAO;AACzB,SAAK,UAAU,MAAM;AACrB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,SAAS,OAAe,UAAoD;AAC1E,QAAI,CAAC,KAAK,UAAU,IAAI,KAAK,GAAG;AAC9B,WAAK,UAAU,IAAI,OAAO,oBAAI,IAAI,CAAC;AAAA,IACrC;AAEA,SAAK,UAAU,IAAI,KAAK,EAAG,IAAI,QAAQ;AAEvC,WAAO,MAAM;AACX,YAAM,YAAY,KAAK,UAAU,IAAI,KAAK;AAC1C,UAAI,CAAC,UAAW;AAEhB,gBAAU,OAAO,QAAQ;AACzB,UAAI,UAAU,SAAS,GAAG;AACxB,aAAK,UAAU,OAAO,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,aAAa,QAAoC;AACvD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO,KAAK;AACjD,QAAI,CAAC,UAAW;AAEhB,UAAM,QAAqB;AAAA,MACzB,GAAG;AAAA,MACH,WAAW,OAAO,aAAa,KAAK,IAAI;AAAA,IAC1C;AAEA,eAAW,YAAY,WAAW;AAChC,eAAS,KAAK;AAAA,IAChB;AAAA,EACF;AACF;AAEA,SAAS,eACP,QACA,OACA,UACM;AACN,MAAI,OAAO,KAAK;AACd,WAAO,IAAI,OAAO,QAAQ;AAC1B;AAAA,EACF;AAEA,SAAO,iBAAiB,OAAO,QAAQ;AACzC;AAEA,SAAS,aAAa,OAAwB;AAC5C,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;","names":[]}