routeflow-api 0.2.0

package/dist/adapters/mysql.d.ts

@@ -0,0 +1,63 @@
+import { D as DatabaseAdapter, C as ChangeEvent } from '../types-tPDla8AE.js';
+
+interface MySqlBinlogTableMap {
+    parentSchema?: string;
+    schemaName?: string;
+    tableName?: string;
+}
+interface MySqlWriteRowsEvent {
+    getTypeName?: () => string;
+    tableMap?: MySqlBinlogTableMap;
+    rows: Array<Record<string, unknown>>;
+}
+interface MySqlDeleteRowsEvent {
+    getTypeName?: () => string;
+    tableMap?: MySqlBinlogTableMap;
+    rows: Array<Record<string, unknown>>;
+}
+interface MySqlUpdateRowsEvent {
+    getTypeName?: () => string;
+    tableMap?: MySqlBinlogTableMap;
+    rows: Array<{
+        before: Record<string, unknown>;
+        after: Record<string, unknown>;
+    }>;
+}
+type MySqlBinlogEvent = MySqlWriteRowsEvent | MySqlDeleteRowsEvent | MySqlUpdateRowsEvent;
+interface MySqlBinlogSource {
+    on(event: 'binlog', listener: (event: MySqlBinlogEvent) => void): void;
+    on(event: 'error', listener: (error: Error) => void): void;
+    off?(event: 'binlog' | 'error', listener: (...args: any[]) => void): void;
+    removeListener?(event: 'binlog' | 'error', listener: (...args: any[]) => void): void;
+    start?(options?: Record<string, unknown>): Promise<void> | void;
+    stop?(): Promise<void> | void;
+}
+interface MySqlAdapterOptions {
+    source: MySqlBinlogSource;
+    schema?: string;
+    startOptions?: Record<string, unknown>;
+    onError?: (error: unknown) => void;
+}
+
+/**
+ * MySQL adapter for RouteFlow.
+ *
+ * It consumes a binlog event source compatible with libraries such as ZongJi.
+ */
+declare class MySqlAdapter implements DatabaseAdapter {
+    private readonly source;
+    private readonly schema?;
+    private readonly startOptions?;
+    private readonly onError?;
+    private readonly listeners;
+    private readonly handleBinlogBound;
+    private readonly handleErrorBound;
+    private connected;
+    constructor(options: MySqlAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(table: string, callback: (event: ChangeEvent) => void): () => void;
+    private handleBinlog;
+}
+
+export { MySqlAdapter, type MySqlAdapterOptions };

package/dist/adapters/mysql.js

@@ -0,0 +1,132 @@
+// 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/mysql/mysql-adapter.ts
+var MySqlAdapter = class {
+  source;
+  schema;
+  startOptions;
+  onError;
+  listeners = /* @__PURE__ */ new Map();
+  handleBinlogBound = (event) => {
+    this.handleBinlog(event);
+  };
+  handleErrorBound = (error) => {
+    this.onError?.(error);
+  };
+  connected = false;
+  constructor(options) {
+    this.source = options.source;
+    this.schema = options.schema;
+    this.startOptions = options.startOptions;
+    this.onError = options.onError;
+  }
+  async connect() {
+    if (this.connected) return;
+    this.source.on("binlog", this.handleBinlogBound);
+    this.source.on("error", this.handleErrorBound);
+    try {
+      await this.source.start?.(this.startOptions);
+    } catch (error) {
+      throw new ReactiveApiError(
+        "MYSQL_BINLOG_START_FAILED",
+        `Failed to start MySQL binlog source: ${errorMessage(error)}`
+      );
+    }
+    this.connected = true;
+  }
+  async disconnect() {
+    if (!this.connected) return;
+    removeListener(this.source, "binlog", this.handleBinlogBound);
+    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);
+      }
+    };
+  }
+  handleBinlog(event) {
+    const changes = normaliseBinlogEvent(event);
+    if (changes.length === 0) return;
+    for (const change of changes) {
+      if (this.schema && readSchemaName(event) !== this.schema) continue;
+      const callbacks = this.listeners.get(change.table);
+      if (!callbacks) continue;
+      const fluxEvent = {
+        ...change,
+        timestamp: Date.now()
+      };
+      for (const callback of callbacks) {
+        callback(fluxEvent);
+      }
+    }
+  }
+};
+function normaliseBinlogEvent(event) {
+  const typeName = event.getTypeName?.().toLowerCase() ?? "";
+  const table = event.tableMap?.tableName;
+  if (!table) return [];
+  if (typeName.includes("write")) {
+    return event.rows.map((row) => ({
+      table,
+      operation: "INSERT",
+      newRow: row,
+      oldRow: null
+    }));
+  }
+  if (typeName.includes("delete")) {
+    return event.rows.map((row) => ({
+      table,
+      operation: "DELETE",
+      newRow: null,
+      oldRow: row
+    }));
+  }
+  if (typeName.includes("update")) {
+    return event.rows.map((row) => ({
+      table,
+      operation: "UPDATE",
+      newRow: row.after,
+      oldRow: row.before
+    }));
+  }
+  return [];
+}
+function readSchemaName(event) {
+  return event.tableMap?.parentSchema ?? event.tableMap?.schemaName;
+}
+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 {
+  MySqlAdapter
+};
+//# sourceMappingURL=mysql.js.map

package/dist/adapters/mysql.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts","../../src/adapters/mysql/mysql-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  MySqlAdapterOptions,\n  MySqlBinlogEvent,\n  MySqlBinlogSource,\n  NormalisedMySqlChange,\n} from './types.js'\n\n/**\n * MySQL adapter for RouteFlow.\n *\n * It consumes a binlog event source compatible with libraries such as ZongJi.\n */\nexport class MySqlAdapter implements DatabaseAdapter {\n  private readonly source: MySqlBinlogSource\n  private readonly schema?: string\n  private readonly startOptions?: Record<string, unknown>\n  private readonly onError?: (error: unknown) => void\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleBinlogBound = (event: MySqlBinlogEvent) => {\n    this.handleBinlog(event)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: MySqlAdapterOptions) {\n    this.source = options.source\n    this.schema = options.schema\n    this.startOptions = options.startOptions\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) return\n\n    this.source.on('binlog', this.handleBinlogBound)\n    this.source.on('error', this.handleErrorBound)\n\n    try {\n      await this.source.start?.(this.startOptions)\n    } catch (error) {\n      throw new ReactiveApiError(\n        'MYSQL_BINLOG_START_FAILED',\n        `Failed to start MySQL binlog 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, 'binlog', this.handleBinlogBound)\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 handleBinlog(event: MySqlBinlogEvent): void {\n    const changes = normaliseBinlogEvent(event)\n    if (changes.length === 0) return\n\n    for (const change of changes) {\n      if (this.schema && readSchemaName(event) !== this.schema) continue\n\n      const callbacks = this.listeners.get(change.table)\n      if (!callbacks) continue\n\n      const fluxEvent: ChangeEvent = {\n        ...change,\n        timestamp: Date.now(),\n      }\n\n      for (const callback of callbacks) {\n        callback(fluxEvent)\n      }\n    }\n  }\n}\n\nfunction normaliseBinlogEvent(event: MySqlBinlogEvent): NormalisedMySqlChange[] {\n  const typeName = event.getTypeName?.().toLowerCase() ?? ''\n  const table = event.tableMap?.tableName\n  if (!table) return []\n\n  if (typeName.includes('write')) {\n    return event.rows.map((row) => ({\n      table,\n      operation: 'INSERT',\n      newRow: row,\n      oldRow: null,\n    }))\n  }\n\n  if (typeName.includes('delete')) {\n    return event.rows.map((row) => ({\n      table,\n      operation: 'DELETE',\n      newRow: null,\n      oldRow: row,\n    }))\n  }\n\n  if (typeName.includes('update')) {\n    return event.rows.map((row) => ({\n      table,\n      operation: 'UPDATE',\n      newRow: row.after,\n      oldRow: row.before,\n    }))\n  }\n\n  return []\n}\n\nfunction readSchemaName(event: MySqlBinlogEvent): string | undefined {\n  return event.tableMap?.parentSchema ?? event.tableMap?.schemaName\n}\n\nfunction removeListener(\n  source: MySqlBinlogSource,\n  event: 'binlog' | '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":"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","names":[]}

package/dist/adapters/opensearch.cjs

@@ -0,0 +1,120 @@
+"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/opensearch.ts
+var opensearch_exports = {};
+__export(opensearch_exports, {
+  OpenSearchAdapter: () => ElasticsearchAdapter
+});
+module.exports = __toCommonJS(opensearch_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/elasticsearch/elasticsearch-adapter.ts
+var ElasticsearchAdapter = class {
+  source;
+  onError;
+  listeners = /* @__PURE__ */ new Map();
+  handleChangeBound = (change) => {
+    this.handleChange(change);
+  };
+  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(
+        "ELASTICSEARCH_SOURCE_START_FAILED",
+        `Failed to start Elasticsearch 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(index, callback) {
+    if (!this.listeners.has(index)) {
+      this.listeners.set(index, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(index).add(callback);
+    return () => {
+      const callbacks = this.listeners.get(index);
+      if (!callbacks) return;
+      callbacks.delete(callback);
+      if (callbacks.size === 0) {
+        this.listeners.delete(index);
+      }
+    };
+  }
+  handleChange(change) {
+    const callbacks = this.listeners.get(change.index);
+    if (!callbacks) return;
+    const event = {
+      table: change.index,
+      operation: change.operation,
+      newRow: change.newDocument,
+      oldRow: change.oldDocument,
+      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 = {
+  OpenSearchAdapter
+});
+//# sourceMappingURL=opensearch.cjs.map

package/dist/adapters/opensearch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/opensearch.ts","../../src/core/errors.ts","../../src/adapters/elasticsearch/elasticsearch-adapter.ts"],"sourcesContent":["export { ElasticsearchAdapter as OpenSearchAdapter } from './elasticsearch/elasticsearch-adapter.js'\nexport type {\n  ElasticsearchAdapterOptions as OpenSearchAdapterOptions,\n  ElasticsearchChangeSource as OpenSearchChangeSource,\n  ElasticsearchSourceEvent as OpenSearchSourceEvent,\n} from './elasticsearch/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  ElasticsearchAdapterOptions,\n  ElasticsearchChangeSource,\n  ElasticsearchSourceEvent,\n} from './types.js'\n\n/**\n * Elasticsearch adapter for RouteFlow.\n *\n * Elasticsearch does not provide a built-in change stream, so this adapter\n * consumes an external source that emits index-level change events.\n */\nexport class ElasticsearchAdapter implements DatabaseAdapter {\n  private readonly source: ElasticsearchChangeSource\n  private readonly onError?: ElasticsearchAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleChangeBound = (change: ElasticsearchSourceEvent) => {\n    this.handleChange(change)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: ElasticsearchAdapterOptions) {\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        'ELASTICSEARCH_SOURCE_START_FAILED',\n        `Failed to start Elasticsearch 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(index: string, callback: (event: ChangeEvent) => void): () => void {\n    if (!this.listeners.has(index)) {\n      this.listeners.set(index, new Set())\n    }\n\n    this.listeners.get(index)!.add(callback)\n\n    return () => {\n      const callbacks = this.listeners.get(index)\n      if (!callbacks) return\n\n      callbacks.delete(callback)\n      if (callbacks.size === 0) {\n        this.listeners.delete(index)\n      }\n    }\n  }\n\n  private handleChange(change: ElasticsearchSourceEvent): void {\n    const callbacks = this.listeners.get(change.index)\n    if (!callbacks) return\n\n    const event: ChangeEvent = {\n      table: change.index,\n      operation: change.operation,\n      newRow: change.newDocument,\n      oldRow: change.oldDocument,\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: ElasticsearchChangeSource,\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;;;ACDO,IAAM,uBAAN,MAAsD;AAAA,EAC1C;AAAA,EACA;AAAA,EACA,YAA4D,oBAAI,IAAI;AAAA,EACpE,oBAAoB,CAAC,WAAqC;AACzE,SAAK,aAAa,MAAM;AAAA,EAC1B;AAAA,EACiB,mBAAmB,CAAC,UAAiB;AACpD,SAAK,UAAU,KAAK;AAAA,EACtB;AAAA,EACQ,YAAY;AAAA,EAEpB,YAAY,SAAsC;AAChD,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,gDAAgD,aAAa,KAAK,CAAC;AAAA,MACrE;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,QAAwC;AAC3D,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO,KAAK;AACjD,QAAI,CAAC,UAAW;AAEhB,UAAM,QAAqB;AAAA,MACzB,OAAO,OAAO;AAAA,MACd,WAAW,OAAO;AAAA,MAClB,QAAQ,OAAO;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,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/opensearch.d.cts

@@ -0,0 +1,2 @@
+export { ElasticsearchAdapter as OpenSearchAdapter, ElasticsearchAdapterOptions as OpenSearchAdapterOptions, ElasticsearchChangeSource as OpenSearchChangeSource, ElasticsearchSourceEvent as OpenSearchSourceEvent } from './elasticsearch.cjs';
+import '../types-tPDla8AE.cjs';

package/dist/adapters/opensearch.d.ts

@@ -0,0 +1,2 @@
+export { ElasticsearchAdapter as OpenSearchAdapter, ElasticsearchAdapterOptions as OpenSearchAdapterOptions, ElasticsearchChangeSource as OpenSearchChangeSource, ElasticsearchSourceEvent as OpenSearchSourceEvent } from './elasticsearch.js';
+import '../types-tPDla8AE.js';

package/dist/adapters/opensearch.js

@@ -0,0 +1,93 @@
+// 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/elasticsearch/elasticsearch-adapter.ts
+var ElasticsearchAdapter = class {
+  source;
+  onError;
+  listeners = /* @__PURE__ */ new Map();
+  handleChangeBound = (change) => {
+    this.handleChange(change);
+  };
+  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(
+        "ELASTICSEARCH_SOURCE_START_FAILED",
+        `Failed to start Elasticsearch 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(index, callback) {
+    if (!this.listeners.has(index)) {
+      this.listeners.set(index, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(index).add(callback);
+    return () => {
+      const callbacks = this.listeners.get(index);
+      if (!callbacks) return;
+      callbacks.delete(callback);
+      if (callbacks.size === 0) {
+        this.listeners.delete(index);
+      }
+    };
+  }
+  handleChange(change) {
+    const callbacks = this.listeners.get(change.index);
+    if (!callbacks) return;
+    const event = {
+      table: change.index,
+      operation: change.operation,
+      newRow: change.newDocument,
+      oldRow: change.oldDocument,
+      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 {
+  ElasticsearchAdapter as OpenSearchAdapter
+};
+//# sourceMappingURL=opensearch.js.map

package/dist/adapters/opensearch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts","../../src/adapters/elasticsearch/elasticsearch-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  ElasticsearchAdapterOptions,\n  ElasticsearchChangeSource,\n  ElasticsearchSourceEvent,\n} from './types.js'\n\n/**\n * Elasticsearch adapter for RouteFlow.\n *\n * Elasticsearch does not provide a built-in change stream, so this adapter\n * consumes an external source that emits index-level change events.\n */\nexport class ElasticsearchAdapter implements DatabaseAdapter {\n  private readonly source: ElasticsearchChangeSource\n  private readonly onError?: ElasticsearchAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleChangeBound = (change: ElasticsearchSourceEvent) => {\n    this.handleChange(change)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: ElasticsearchAdapterOptions) {\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        'ELASTICSEARCH_SOURCE_START_FAILED',\n        `Failed to start Elasticsearch 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(index: string, callback: (event: ChangeEvent) => void): () => void {\n    if (!this.listeners.has(index)) {\n      this.listeners.set(index, new Set())\n    }\n\n    this.listeners.get(index)!.add(callback)\n\n    return () => {\n      const callbacks = this.listeners.get(index)\n      if (!callbacks) return\n\n      callbacks.delete(callback)\n      if (callbacks.size === 0) {\n        this.listeners.delete(index)\n      }\n    }\n  }\n\n  private handleChange(change: ElasticsearchSourceEvent): void {\n    const callbacks = this.listeners.get(change.index)\n    if (!callbacks) return\n\n    const event: ChangeEvent = {\n      table: change.index,\n      operation: change.operation,\n      newRow: change.newDocument,\n      oldRow: change.oldDocument,\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: ElasticsearchChangeSource,\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;;;ACDO,IAAM,uBAAN,MAAsD;AAAA,EAC1C;AAAA,EACA;AAAA,EACA,YAA4D,oBAAI,IAAI;AAAA,EACpE,oBAAoB,CAAC,WAAqC;AACzE,SAAK,aAAa,MAAM;AAAA,EAC1B;AAAA,EACiB,mBAAmB,CAAC,UAAiB;AACpD,SAAK,UAAU,KAAK;AAAA,EACtB;AAAA,EACQ,YAAY;AAAA,EAEpB,YAAY,SAAsC;AAChD,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,gDAAgD,aAAa,KAAK,CAAC;AAAA,MACrE;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,QAAwC;AAC3D,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO,KAAK;AACjD,QAAI,CAAC,UAAW;AAEhB,UAAM,QAAqB;AAAA,MACzB,OAAO,OAAO;AAAA,MACd,WAAW,OAAO;AAAA,MAClB,QAAQ,OAAO;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,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":[]}