routeflow-api 0.2.0

package/dist/adapters/mongodb.cjs

@@ -0,0 +1,159 @@
+"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/mongodb.ts
+var mongodb_exports = {};
+__export(mongodb_exports, {
+  MongoDbAdapter: () => MongoDbAdapter
+});
+module.exports = __toCommonJS(mongodb_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/mongodb/mongodb-adapter.ts
+var MongoDbAdapter = class {
+  db;
+  watchOptions;
+  onError;
+  collections = /* @__PURE__ */ new Map();
+  connected = false;
+  constructor(options) {
+    this.db = options.db;
+    this.watchOptions = {
+      fullDocument: "updateLookup",
+      fullDocumentBeforeChange: "whenAvailable",
+      ...options.watchOptions
+    };
+    this.onError = options.onError;
+  }
+  async connect() {
+    this.connected = true;
+    for (const collection of this.collections.keys()) {
+      this.ensureCollectionStream(collection);
+    }
+  }
+  async disconnect() {
+    this.connected = false;
+    await Promise.all(
+      Array.from(this.collections.values(), async (state) => {
+        await state.stream.close();
+      })
+    );
+  }
+  onChange(collection, callback) {
+    const state = this.collections.get(collection);
+    if (state) {
+      state.listeners.add(callback);
+    } else {
+      this.collections.set(collection, {
+        stream: null,
+        listeners: /* @__PURE__ */ new Set([callback])
+      });
+    }
+    this.ensureCollectionStream(collection);
+    return () => {
+      const current = this.collections.get(collection);
+      if (!current) return;
+      current.listeners.delete(callback);
+      if (current.listeners.size === 0) {
+        void current.stream?.close();
+        this.collections.delete(collection);
+      }
+    };
+  }
+  ensureCollectionStream(collection) {
+    if (!this.connected) return;
+    const state = this.collections.get(collection);
+    if (!state || state.stream) return;
+    try {
+      const stream = this.db.collection(collection).watch([], this.watchOptions);
+      stream.on("change", (change) => {
+        this.handleChange(collection, change);
+      });
+      stream.on("error", (error) => {
+        this.onError?.(error, { collection });
+      });
+      state.stream = stream;
+    } catch (error) {
+      throw new ReactiveApiError(
+        "MONGODB_STREAM_FAILED",
+        `Failed to open MongoDB change stream for "${collection}": ${errorMessage(error)}`
+      );
+    }
+  }
+  handleChange(collection, change) {
+    const event = mapMongoChangeToEvent(collection, change);
+    if (!event) return;
+    const state = this.collections.get(collection);
+    if (!state) return;
+    for (const listener of state.listeners) {
+      listener(event);
+    }
+  }
+};
+function mapMongoChangeToEvent(collection, change) {
+  const timestamp = Date.now();
+  switch (change.operationType) {
+    case "insert":
+      return {
+        table: collection,
+        operation: "INSERT",
+        newRow: change.fullDocument ?? null,
+        oldRow: null,
+        timestamp
+      };
+    case "replace":
+    case "update":
+      return {
+        table: collection,
+        operation: "UPDATE",
+        newRow: change.fullDocument ?? null,
+        oldRow: change.fullDocumentBeforeChange ?? null,
+        timestamp
+      };
+    case "delete":
+      return {
+        table: collection,
+        operation: "DELETE",
+        newRow: null,
+        oldRow: change.fullDocumentBeforeChange ?? (change.documentKey ? { _id: change.documentKey._id } : null),
+        timestamp
+      };
+    default:
+      return null;
+  }
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MongoDbAdapter
+});
+//# sourceMappingURL=mongodb.cjs.map

package/dist/adapters/mongodb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/mongodb.ts","../../src/core/errors.ts","../../src/adapters/mongodb/mongodb-adapter.ts"],"sourcesContent":["export { MongoDbAdapter } from './mongodb/mongodb-adapter.js'\nexport type {\n  MongoAdapterOptions,\n  MongoChangeStreamDocument,\n  MongoChangeStreamLike,\n  MongoCollectionLike,\n  MongoDatabaseLike,\n} from './mongodb/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  MongoAdapterOptions,\n  MongoChangeStreamDocument,\n  MongoCollectionState,\n} from './types.js'\n\n/**\n * MongoDB adapter for RouteFlow.\n *\n * The adapter expects a MongoDB driver's `Db`-compatible object and opens\n * one Change Stream per watched collection.\n */\nexport class MongoDbAdapter implements DatabaseAdapter {\n  private readonly db: MongoAdapterOptions['db']\n  private readonly watchOptions: Record<string, unknown>\n  private readonly onError?: MongoAdapterOptions['onError']\n  private readonly collections: Map<string, MongoCollectionState> = new Map()\n  private connected = false\n\n  constructor(options: MongoAdapterOptions) {\n    this.db = options.db\n    this.watchOptions = {\n      fullDocument: 'updateLookup',\n      fullDocumentBeforeChange: 'whenAvailable',\n      ...options.watchOptions,\n    }\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    this.connected = true\n\n    for (const collection of this.collections.keys()) {\n      this.ensureCollectionStream(collection)\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false\n\n    await Promise.all(\n      Array.from(this.collections.values(), async (state) => {\n        await state.stream.close()\n      }),\n    )\n  }\n\n  onChange(collection: string, callback: (event: ChangeEvent) => void): () => void {\n    const state = this.collections.get(collection)\n    if (state) {\n      state.listeners.add(callback)\n    } else {\n      this.collections.set(collection, {\n        stream: null as never,\n        listeners: new Set([callback]),\n      })\n    }\n\n    this.ensureCollectionStream(collection)\n\n    return () => {\n      const current = this.collections.get(collection)\n      if (!current) return\n\n      current.listeners.delete(callback)\n\n      if (current.listeners.size === 0) {\n        void current.stream?.close()\n        this.collections.delete(collection)\n      }\n    }\n  }\n\n  private ensureCollectionStream(collection: string): void {\n    if (!this.connected) return\n\n    const state = this.collections.get(collection)\n    if (!state || state.stream) return\n\n    try {\n      const stream = this.db.collection(collection).watch([], this.watchOptions)\n      stream.on('change', (change) => {\n        this.handleChange(collection, change)\n      })\n      stream.on('error', (error) => {\n        this.onError?.(error, { collection })\n      })\n      state.stream = stream\n    } catch (error) {\n      throw new ReactiveApiError(\n        'MONGODB_STREAM_FAILED',\n        `Failed to open MongoDB change stream for \"${collection}\": ${errorMessage(error)}`,\n      )\n    }\n  }\n\n  private handleChange(\n    collection: string,\n    change: MongoChangeStreamDocument<Record<string, unknown>>,\n  ): void {\n    const event = mapMongoChangeToEvent(collection, change)\n    if (!event) return\n\n    const state = this.collections.get(collection)\n    if (!state) return\n\n    for (const listener of state.listeners) {\n      listener(event)\n    }\n  }\n}\n\nfunction mapMongoChangeToEvent(\n  collection: string,\n  change: MongoChangeStreamDocument<Record<string, unknown>>,\n): ChangeEvent | null {\n  const timestamp = Date.now()\n\n  switch (change.operationType) {\n    case 'insert':\n      return {\n        table: collection,\n        operation: 'INSERT',\n        newRow: change.fullDocument ?? null,\n        oldRow: null,\n        timestamp,\n      }\n    case 'replace':\n    case 'update':\n      return {\n        table: collection,\n        operation: 'UPDATE',\n        newRow: change.fullDocument ?? null,\n        oldRow: change.fullDocumentBeforeChange ?? null,\n        timestamp,\n      }\n    case 'delete':\n      return {\n        table: collection,\n        operation: 'DELETE',\n        newRow: null,\n        oldRow:\n          change.fullDocumentBeforeChange ??\n          (change.documentKey ? { _id: change.documentKey._id } : null),\n        timestamp,\n      }\n    default:\n      return null\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/mongodb.d.cts

@@ -0,0 +1,54 @@
+import { D as DatabaseAdapter, C as ChangeEvent } from '../types-tPDla8AE.cjs';
+
+interface MongoChangeStreamDocument<TSchema = Record<string, unknown>> {
+    operationType: 'insert' | 'update' | 'replace' | 'delete';
+    fullDocument?: TSchema | null;
+    fullDocumentBeforeChange?: TSchema | null;
+    documentKey?: {
+        _id?: unknown;
+    };
+    ns?: {
+        db?: string;
+        coll?: string;
+    };
+}
+interface MongoChangeStreamLike<TSchema = Record<string, unknown>> {
+    on(event: 'change', listener: (change: MongoChangeStreamDocument<TSchema>) => void): this;
+    on(event: 'error', listener: (error: Error) => void): this;
+    close(): Promise<void> | void;
+}
+interface MongoCollectionLike<TSchema = Record<string, unknown>> {
+    watch(pipeline?: Array<Record<string, unknown>>, options?: Record<string, unknown>): MongoChangeStreamLike<TSchema>;
+}
+interface MongoDatabaseLike {
+    collection<TSchema = Record<string, unknown>>(name: string): MongoCollectionLike<TSchema>;
+}
+interface MongoAdapterOptions {
+    db: MongoDatabaseLike;
+    watchOptions?: Record<string, unknown>;
+    onError?: (error: unknown, context: {
+        collection: string;
+    }) => void;
+}
+
+/**
+ * MongoDB adapter for RouteFlow.
+ *
+ * The adapter expects a MongoDB driver's `Db`-compatible object and opens
+ * one Change Stream per watched collection.
+ */
+declare class MongoDbAdapter implements DatabaseAdapter {
+    private readonly db;
+    private readonly watchOptions;
+    private readonly onError?;
+    private readonly collections;
+    private connected;
+    constructor(options: MongoAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(collection: string, callback: (event: ChangeEvent) => void): () => void;
+    private ensureCollectionStream;
+    private handleChange;
+}
+
+export { type MongoAdapterOptions, type MongoChangeStreamDocument, type MongoChangeStreamLike, type MongoCollectionLike, type MongoDatabaseLike, MongoDbAdapter };

package/dist/adapters/mongodb.d.ts

@@ -0,0 +1,54 @@
+import { D as DatabaseAdapter, C as ChangeEvent } from '../types-tPDla8AE.js';
+
+interface MongoChangeStreamDocument<TSchema = Record<string, unknown>> {
+    operationType: 'insert' | 'update' | 'replace' | 'delete';
+    fullDocument?: TSchema | null;
+    fullDocumentBeforeChange?: TSchema | null;
+    documentKey?: {
+        _id?: unknown;
+    };
+    ns?: {
+        db?: string;
+        coll?: string;
+    };
+}
+interface MongoChangeStreamLike<TSchema = Record<string, unknown>> {
+    on(event: 'change', listener: (change: MongoChangeStreamDocument<TSchema>) => void): this;
+    on(event: 'error', listener: (error: Error) => void): this;
+    close(): Promise<void> | void;
+}
+interface MongoCollectionLike<TSchema = Record<string, unknown>> {
+    watch(pipeline?: Array<Record<string, unknown>>, options?: Record<string, unknown>): MongoChangeStreamLike<TSchema>;
+}
+interface MongoDatabaseLike {
+    collection<TSchema = Record<string, unknown>>(name: string): MongoCollectionLike<TSchema>;
+}
+interface MongoAdapterOptions {
+    db: MongoDatabaseLike;
+    watchOptions?: Record<string, unknown>;
+    onError?: (error: unknown, context: {
+        collection: string;
+    }) => void;
+}
+
+/**
+ * MongoDB adapter for RouteFlow.
+ *
+ * The adapter expects a MongoDB driver's `Db`-compatible object and opens
+ * one Change Stream per watched collection.
+ */
+declare class MongoDbAdapter implements DatabaseAdapter {
+    private readonly db;
+    private readonly watchOptions;
+    private readonly onError?;
+    private readonly collections;
+    private connected;
+    constructor(options: MongoAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(collection: string, callback: (event: ChangeEvent) => void): () => void;
+    private ensureCollectionStream;
+    private handleChange;
+}
+
+export { type MongoAdapterOptions, type MongoChangeStreamDocument, type MongoChangeStreamLike, type MongoCollectionLike, type MongoDatabaseLike, MongoDbAdapter };

package/dist/adapters/mongodb.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/mongodb/mongodb-adapter.ts
+var MongoDbAdapter = class {
+  db;
+  watchOptions;
+  onError;
+  collections = /* @__PURE__ */ new Map();
+  connected = false;
+  constructor(options) {
+    this.db = options.db;
+    this.watchOptions = {
+      fullDocument: "updateLookup",
+      fullDocumentBeforeChange: "whenAvailable",
+      ...options.watchOptions
+    };
+    this.onError = options.onError;
+  }
+  async connect() {
+    this.connected = true;
+    for (const collection of this.collections.keys()) {
+      this.ensureCollectionStream(collection);
+    }
+  }
+  async disconnect() {
+    this.connected = false;
+    await Promise.all(
+      Array.from(this.collections.values(), async (state) => {
+        await state.stream.close();
+      })
+    );
+  }
+  onChange(collection, callback) {
+    const state = this.collections.get(collection);
+    if (state) {
+      state.listeners.add(callback);
+    } else {
+      this.collections.set(collection, {
+        stream: null,
+        listeners: /* @__PURE__ */ new Set([callback])
+      });
+    }
+    this.ensureCollectionStream(collection);
+    return () => {
+      const current = this.collections.get(collection);
+      if (!current) return;
+      current.listeners.delete(callback);
+      if (current.listeners.size === 0) {
+        void current.stream?.close();
+        this.collections.delete(collection);
+      }
+    };
+  }
+  ensureCollectionStream(collection) {
+    if (!this.connected) return;
+    const state = this.collections.get(collection);
+    if (!state || state.stream) return;
+    try {
+      const stream = this.db.collection(collection).watch([], this.watchOptions);
+      stream.on("change", (change) => {
+        this.handleChange(collection, change);
+      });
+      stream.on("error", (error) => {
+        this.onError?.(error, { collection });
+      });
+      state.stream = stream;
+    } catch (error) {
+      throw new ReactiveApiError(
+        "MONGODB_STREAM_FAILED",
+        `Failed to open MongoDB change stream for "${collection}": ${errorMessage(error)}`
+      );
+    }
+  }
+  handleChange(collection, change) {
+    const event = mapMongoChangeToEvent(collection, change);
+    if (!event) return;
+    const state = this.collections.get(collection);
+    if (!state) return;
+    for (const listener of state.listeners) {
+      listener(event);
+    }
+  }
+};
+function mapMongoChangeToEvent(collection, change) {
+  const timestamp = Date.now();
+  switch (change.operationType) {
+    case "insert":
+      return {
+        table: collection,
+        operation: "INSERT",
+        newRow: change.fullDocument ?? null,
+        oldRow: null,
+        timestamp
+      };
+    case "replace":
+    case "update":
+      return {
+        table: collection,
+        operation: "UPDATE",
+        newRow: change.fullDocument ?? null,
+        oldRow: change.fullDocumentBeforeChange ?? null,
+        timestamp
+      };
+    case "delete":
+      return {
+        table: collection,
+        operation: "DELETE",
+        newRow: null,
+        oldRow: change.fullDocumentBeforeChange ?? (change.documentKey ? { _id: change.documentKey._id } : null),
+        timestamp
+      };
+    default:
+      return null;
+  }
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export {
+  MongoDbAdapter
+};
+//# sourceMappingURL=mongodb.js.map

package/dist/adapters/mongodb.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts","../../src/adapters/mongodb/mongodb-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  MongoAdapterOptions,\n  MongoChangeStreamDocument,\n  MongoCollectionState,\n} from './types.js'\n\n/**\n * MongoDB adapter for RouteFlow.\n *\n * The adapter expects a MongoDB driver's `Db`-compatible object and opens\n * one Change Stream per watched collection.\n */\nexport class MongoDbAdapter implements DatabaseAdapter {\n  private readonly db: MongoAdapterOptions['db']\n  private readonly watchOptions: Record<string, unknown>\n  private readonly onError?: MongoAdapterOptions['onError']\n  private readonly collections: Map<string, MongoCollectionState> = new Map()\n  private connected = false\n\n  constructor(options: MongoAdapterOptions) {\n    this.db = options.db\n    this.watchOptions = {\n      fullDocument: 'updateLookup',\n      fullDocumentBeforeChange: 'whenAvailable',\n      ...options.watchOptions,\n    }\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    this.connected = true\n\n    for (const collection of this.collections.keys()) {\n      this.ensureCollectionStream(collection)\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false\n\n    await Promise.all(\n      Array.from(this.collections.values(), async (state) => {\n        await state.stream.close()\n      }),\n    )\n  }\n\n  onChange(collection: string, callback: (event: ChangeEvent) => void): () => void {\n    const state = this.collections.get(collection)\n    if (state) {\n      state.listeners.add(callback)\n    } else {\n      this.collections.set(collection, {\n        stream: null as never,\n        listeners: new Set([callback]),\n      })\n    }\n\n    this.ensureCollectionStream(collection)\n\n    return () => {\n      const current = this.collections.get(collection)\n      if (!current) return\n\n      current.listeners.delete(callback)\n\n      if (current.listeners.size === 0) {\n        void current.stream?.close()\n        this.collections.delete(collection)\n      }\n    }\n  }\n\n  private ensureCollectionStream(collection: string): void {\n    if (!this.connected) return\n\n    const state = this.collections.get(collection)\n    if (!state || state.stream) return\n\n    try {\n      const stream = this.db.collection(collection).watch([], this.watchOptions)\n      stream.on('change', (change) => {\n        this.handleChange(collection, change)\n      })\n      stream.on('error', (error) => {\n        this.onError?.(error, { collection })\n      })\n      state.stream = stream\n    } catch (error) {\n      throw new ReactiveApiError(\n        'MONGODB_STREAM_FAILED',\n        `Failed to open MongoDB change stream for \"${collection}\": ${errorMessage(error)}`,\n      )\n    }\n  }\n\n  private handleChange(\n    collection: string,\n    change: MongoChangeStreamDocument<Record<string, unknown>>,\n  ): void {\n    const event = mapMongoChangeToEvent(collection, change)\n    if (!event) return\n\n    const state = this.collections.get(collection)\n    if (!state) return\n\n    for (const listener of state.listeners) {\n      listener(event)\n    }\n  }\n}\n\nfunction mapMongoChangeToEvent(\n  collection: string,\n  change: MongoChangeStreamDocument<Record<string, unknown>>,\n): ChangeEvent | null {\n  const timestamp = Date.now()\n\n  switch (change.operationType) {\n    case 'insert':\n      return {\n        table: collection,\n        operation: 'INSERT',\n        newRow: change.fullDocument ?? null,\n        oldRow: null,\n        timestamp,\n      }\n    case 'replace':\n    case 'update':\n      return {\n        table: collection,\n        operation: 'UPDATE',\n        newRow: change.fullDocument ?? null,\n        oldRow: change.fullDocumentBeforeChange ?? null,\n        timestamp,\n      }\n    case 'delete':\n      return {\n        table: collection,\n        operation: 'DELETE',\n        newRow: null,\n        oldRow:\n          change.fullDocumentBeforeChange ??\n          (change.documentKey ? { _id: change.documentKey._id } : null),\n        timestamp,\n      }\n    default:\n      return null\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/mysql.cjs

@@ -0,0 +1,159 @@
+"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/mysql.ts
+var mysql_exports = {};
+__export(mysql_exports, {
+  MySqlAdapter: () => MySqlAdapter
+});
+module.exports = __toCommonJS(mysql_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/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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MySqlAdapter
+});
+//# sourceMappingURL=mysql.cjs.map

package/dist/adapters/mysql.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/mysql.ts","../../src/core/errors.ts","../../src/adapters/mysql/mysql-adapter.ts"],"sourcesContent":["export { MySqlAdapter } from './mysql/mysql-adapter.js'\nexport type { MySqlAdapterOptions } from './mysql/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  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/mysql.d.cts

@@ -0,0 +1,63 @@
+import { D as DatabaseAdapter, C as ChangeEvent } from '../types-tPDla8AE.cjs';
+
+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 };