routeflow-api 0.2.0

package/README.md

@@ -0,0 +1,93 @@
+# routeflow
+
+RouteFlow — REST API with real-time database push subscriptions
+
+## Install
+
+```bash
+npm install routeflow
+```
+
+For PostgreSQL:
+```bash
+npm install routeflow pg
+```
+
+## Usage
+
+### Server
+
+```typescript
+import 'reflect-metadata'
+import { createApp, MemoryAdapter, Route, Reactive } from 'routeflow'
+import type { Context } from 'routeflow'
+
+const adapter = new MemoryAdapter()
+const items = [{ id: 1, name: 'Apple' }]
+
+class ItemController {
+  @Route('GET', '/items')
+  async listItems(_ctx: Context) {
+    return items
+  }
+
+  @Reactive({ watch: 'items' })
+  @Route('GET', '/items/live')
+  async listLiveItems(_ctx: Context) {
+    return items
+  }
+}
+
+const app = createApp({ adapter, port: 3000 })
+app.register(ItemController)
+await app.listen()
+```
+
+### Client
+
+```typescript
+import { createClient } from 'routeflow/client'
+
+const client = createClient('http://localhost:3000')
+
+const snapshot = await client.get('/items')
+
+const unsubscribe = client.subscribe('/items/live', (items) => {
+  console.log('live update', items)
+})
+```
+
+### Database Adapters
+
+```typescript
+// PostgreSQL
+import { PostgresAdapter } from 'routeflow/adapters/postgres'
+
+// MongoDB
+import { MongoDbAdapter } from 'routeflow/adapters/mongodb'
+
+// MySQL
+import { MySqlAdapter } from 'routeflow/adapters/mysql'
+
+// Redis
+import { RedisAdapter } from 'routeflow/adapters/redis'
+
+// DynamoDB
+import { DynamoDbAdapter } from 'routeflow/adapters/dynamodb'
+
+// Elasticsearch
+import { ElasticsearchAdapter } from 'routeflow/adapters/elasticsearch'
+
+// OpenSearch
+import { OpenSearchAdapter } from 'routeflow/adapters/opensearch'
+
+// Snowflake
+import { SnowflakeAdapter } from 'routeflow/adapters/snowflake'
+
+// Cassandra
+import { CassandraAdapter } from 'routeflow/adapters/cassandra'
+```
+
+## License
+
+MIT

package/dist/adapters/cassandra.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/cassandra.ts
+var cassandra_exports = {};
+__export(cassandra_exports, {
+  CassandraAdapter: () => CassandraAdapter
+});
+module.exports = __toCommonJS(cassandra_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/cassandra/cassandra-adapter.ts
+var CassandraAdapter = 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(
+        "CASSANDRA_SOURCE_START_FAILED",
+        `Failed to start Cassandra CDC 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 = {
+  CassandraAdapter
+});
+//# sourceMappingURL=cassandra.cjs.map

package/dist/adapters/cassandra.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/cassandra.ts","../../src/core/errors.ts","../../src/adapters/cassandra/cassandra-adapter.ts"],"sourcesContent":["export { CassandraAdapter } from './cassandra/cassandra-adapter.js'\nexport type { CassandraAdapterOptions } from './cassandra/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  CassandraAdapterOptions,\n  CassandraCdcEvent,\n  CassandraCdcSource,\n} from './types.js'\n\nexport class CassandraAdapter implements DatabaseAdapter {\n  private readonly source: CassandraCdcSource\n  private readonly onError?: CassandraAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleChangeBound = (event: CassandraCdcEvent) => {\n    this.handleChange(event)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: CassandraAdapterOptions) {\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        'CASSANDRA_SOURCE_START_FAILED',\n        `Failed to start Cassandra CDC 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: CassandraCdcEvent): 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: CassandraCdcSource,\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,UAA6B;AACjE,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,yCAAyC,aAAa,KAAK,CAAC;AAAA,MAC9D;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,QAAiC;AACpD,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/cassandra.d.cts

@@ -0,0 +1,37 @@
+import { C as ChangeEvent, D as DatabaseAdapter } from '../types-tPDla8AE.cjs';
+
+interface CassandraCdcEvent<T = unknown> {
+    table: string;
+    operation: ChangeEvent<T>['operation'];
+    newRow: T | null;
+    oldRow: T | null;
+    timestamp?: number;
+}
+interface CassandraCdcSource {
+    on(event: 'change', listener: (event: CassandraCdcEvent) => 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 CassandraAdapterOptions {
+    source: CassandraCdcSource;
+    onError?: (error: unknown) => void;
+}
+
+declare class CassandraAdapter implements DatabaseAdapter {
+    private readonly source;
+    private readonly onError?;
+    private readonly listeners;
+    private readonly handleChangeBound;
+    private readonly handleErrorBound;
+    private connected;
+    constructor(options: CassandraAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(table: string, callback: (event: ChangeEvent) => void): () => void;
+    private handleChange;
+}
+
+export { CassandraAdapter, type CassandraAdapterOptions };

package/dist/adapters/cassandra.d.ts

@@ -0,0 +1,37 @@
+import { C as ChangeEvent, D as DatabaseAdapter } from '../types-tPDla8AE.js';
+
+interface CassandraCdcEvent<T = unknown> {
+    table: string;
+    operation: ChangeEvent<T>['operation'];
+    newRow: T | null;
+    oldRow: T | null;
+    timestamp?: number;
+}
+interface CassandraCdcSource {
+    on(event: 'change', listener: (event: CassandraCdcEvent) => 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 CassandraAdapterOptions {
+    source: CassandraCdcSource;
+    onError?: (error: unknown) => void;
+}
+
+declare class CassandraAdapter implements DatabaseAdapter {
+    private readonly source;
+    private readonly onError?;
+    private readonly listeners;
+    private readonly handleChangeBound;
+    private readonly handleErrorBound;
+    private connected;
+    constructor(options: CassandraAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(table: string, callback: (event: ChangeEvent) => void): () => void;
+    private handleChange;
+}
+
+export { CassandraAdapter, type CassandraAdapterOptions };

package/dist/adapters/cassandra.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/cassandra/cassandra-adapter.ts
+var CassandraAdapter = 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(
+        "CASSANDRA_SOURCE_START_FAILED",
+        `Failed to start Cassandra CDC 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 {
+  CassandraAdapter
+};
+//# sourceMappingURL=cassandra.js.map

package/dist/adapters/cassandra.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts","../../src/adapters/cassandra/cassandra-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  CassandraAdapterOptions,\n  CassandraCdcEvent,\n  CassandraCdcSource,\n} from './types.js'\n\nexport class CassandraAdapter implements DatabaseAdapter {\n  private readonly source: CassandraCdcSource\n  private readonly onError?: CassandraAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleChangeBound = (event: CassandraCdcEvent) => {\n    this.handleChange(event)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: CassandraAdapterOptions) {\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        'CASSANDRA_SOURCE_START_FAILED',\n        `Failed to start Cassandra CDC 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: CassandraCdcEvent): 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: CassandraCdcSource,\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,UAA6B;AACjE,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,yCAAyC,aAAa,KAAK,CAAC;AAAA,MAC9D;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,QAAiC;AACpD,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/dynamodb.cjs

@@ -0,0 +1,180 @@
+"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/dynamodb.ts
+var dynamodb_exports = {};
+__export(dynamodb_exports, {
+  DynamoDbAdapter: () => DynamoDbAdapter
+});
+module.exports = __toCommonJS(dynamodb_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/dynamodb/dynamodb-adapter.ts
+var DynamoDbAdapter = class {
+  source;
+  unmarshall;
+  onError;
+  listeners = /* @__PURE__ */ new Map();
+  handleRecordBound = (record) => {
+    this.handleRecord(record);
+  };
+  handleErrorBound = (error) => {
+    this.onError?.(error);
+  };
+  connected = false;
+  constructor(options) {
+    this.source = options.source;
+    this.unmarshall = options.unmarshall ?? defaultUnmarshall;
+    this.onError = options.onError;
+  }
+  async connect() {
+    if (this.connected) return;
+    this.source.on("record", this.handleRecordBound);
+    this.source.on("error", this.handleErrorBound);
+    try {
+      await this.source.start?.();
+    } catch (error) {
+      throw new ReactiveApiError(
+        "DYNAMODB_STREAM_START_FAILED",
+        `Failed to start DynamoDB stream source: ${errorMessage(error)}`
+      );
+    }
+    this.connected = true;
+  }
+  async disconnect() {
+    if (!this.connected) return;
+    removeListener(this.source, "record", this.handleRecordBound);
+    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);
+      }
+    };
+  }
+  handleRecord(record) {
+    const normalised = normaliseRecord(record, this.unmarshall);
+    if (!normalised) return;
+    const callbacks = this.listeners.get(normalised.table);
+    if (!callbacks) return;
+    const event = {
+      ...normalised,
+      timestamp: Date.now()
+    };
+    for (const callback of callbacks) {
+      callback(event);
+    }
+  }
+};
+function normaliseRecord(record, unmarshall) {
+  const table = extractTableName(record.eventSourceARN);
+  if (!table || !record.eventName) return null;
+  if (record.eventName === "INSERT") {
+    return {
+      table,
+      operation: "INSERT",
+      newRow: unmarshall(record.dynamodb?.NewImage),
+      oldRow: null
+    };
+  }
+  if (record.eventName === "MODIFY") {
+    return {
+      table,
+      operation: "UPDATE",
+      newRow: unmarshall(record.dynamodb?.NewImage),
+      oldRow: unmarshall(record.dynamodb?.OldImage)
+    };
+  }
+  if (record.eventName === "REMOVE") {
+    return {
+      table,
+      operation: "DELETE",
+      newRow: null,
+      oldRow: unmarshall(record.dynamodb?.OldImage)
+    };
+  }
+  return null;
+}
+function extractTableName(arn) {
+  if (!arn) return null;
+  const match = arn.match(/table\/([^/]+)/);
+  return match?.[1] ?? null;
+}
+function defaultUnmarshall(image) {
+  if (!image) return null;
+  const result = {};
+  for (const [key, value] of Object.entries(image)) {
+    result[key] = decodeAttributeValue(value);
+  }
+  return result;
+}
+function decodeAttributeValue(value) {
+  if (typeof value !== "object" || value === null) return value;
+  const record = value;
+  if ("S" in record) return record["S"];
+  if ("N" in record) return Number(record["N"]);
+  if ("BOOL" in record) return record["BOOL"];
+  if ("NULL" in record) return null;
+  if ("M" in record && typeof record["M"] === "object" && record["M"] !== null) {
+    return defaultUnmarshall(record["M"]);
+  }
+  if ("L" in record && Array.isArray(record["L"])) {
+    return record["L"].map((item) => decodeAttributeValue(item));
+  }
+  if ("SS" in record) return record["SS"];
+  if ("NS" in record) return Array.isArray(record["NS"]) ? record["NS"].map(Number) : record["NS"];
+  return value;
+}
+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 = {
+  DynamoDbAdapter
+});
+//# sourceMappingURL=dynamodb.cjs.map

package/dist/adapters/dynamodb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/dynamodb.ts","../../src/core/errors.ts","../../src/adapters/dynamodb/dynamodb-adapter.ts"],"sourcesContent":["export { DynamoDbAdapter } from './dynamodb/dynamodb-adapter.js'\nexport type { DynamoDbAdapterOptions } from './dynamodb/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  DynamoDbAdapterOptions,\n  DynamoDbAttributeMap,\n  DynamoDbStreamRecord,\n  DynamoDbStreamSource,\n  NormalisedDynamoDbRecord,\n} from './types.js'\n\n/**\n * DynamoDB adapter for RouteFlow.\n *\n * Consumes DynamoDB Streams-style records from an external source.\n */\nexport class DynamoDbAdapter implements DatabaseAdapter {\n  private readonly source: DynamoDbStreamSource\n  private readonly unmarshall: NonNullable<DynamoDbAdapterOptions['unmarshall']>\n  private readonly onError?: DynamoDbAdapterOptions['onError']\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly handleRecordBound = (record: DynamoDbStreamRecord) => {\n    this.handleRecord(record)\n  }\n  private readonly handleErrorBound = (error: Error) => {\n    this.onError?.(error)\n  }\n  private connected = false\n\n  constructor(options: DynamoDbAdapterOptions) {\n    this.source = options.source\n    this.unmarshall = options.unmarshall ?? defaultUnmarshall\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) return\n\n    this.source.on('record', this.handleRecordBound)\n    this.source.on('error', this.handleErrorBound)\n\n    try {\n      await this.source.start?.()\n    } catch (error) {\n      throw new ReactiveApiError(\n        'DYNAMODB_STREAM_START_FAILED',\n        `Failed to start DynamoDB stream 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, 'record', this.handleRecordBound)\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 handleRecord(record: DynamoDbStreamRecord): void {\n    const normalised = normaliseRecord(record, this.unmarshall)\n    if (!normalised) return\n\n    const callbacks = this.listeners.get(normalised.table)\n    if (!callbacks) return\n\n    const event: ChangeEvent = {\n      ...normalised,\n      timestamp: Date.now(),\n    }\n\n    for (const callback of callbacks) {\n      callback(event)\n    }\n  }\n}\n\nfunction normaliseRecord(\n  record: DynamoDbStreamRecord,\n  unmarshall: (image: DynamoDbAttributeMap | undefined) => Record<string, unknown> | null,\n): NormalisedDynamoDbRecord | null {\n  const table = extractTableName(record.eventSourceARN)\n  if (!table || !record.eventName) return null\n\n  if (record.eventName === 'INSERT') {\n    return {\n      table,\n      operation: 'INSERT',\n      newRow: unmarshall(record.dynamodb?.NewImage),\n      oldRow: null,\n    }\n  }\n\n  if (record.eventName === 'MODIFY') {\n    return {\n      table,\n      operation: 'UPDATE',\n      newRow: unmarshall(record.dynamodb?.NewImage),\n      oldRow: unmarshall(record.dynamodb?.OldImage),\n    }\n  }\n\n  if (record.eventName === 'REMOVE') {\n    return {\n      table,\n      operation: 'DELETE',\n      newRow: null,\n      oldRow: unmarshall(record.dynamodb?.OldImage),\n    }\n  }\n\n  return null\n}\n\nfunction extractTableName(arn: string | undefined): string | null {\n  if (!arn) return null\n  const match = arn.match(/table\\/([^/]+)/)\n  return match?.[1] ?? null\n}\n\nfunction defaultUnmarshall(\n  image: DynamoDbAttributeMap | undefined,\n): Record<string, unknown> | null {\n  if (!image) return null\n\n  const result: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(image)) {\n    result[key] = decodeAttributeValue(value)\n  }\n  return result\n}\n\nfunction decodeAttributeValue(value: unknown): unknown {\n  if (typeof value !== 'object' || value === null) return value\n\n  const record = value as Record<string, unknown>\n  if ('S' in record) return record['S']\n  if ('N' in record) return Number(record['N'])\n  if ('BOOL' in record) return record['BOOL']\n  if ('NULL' in record) return null\n  if ('M' in record && typeof record['M'] === 'object' && record['M'] !== null) {\n    return defaultUnmarshall(record['M'] as DynamoDbAttributeMap)\n  }\n  if ('L' in record && Array.isArray(record['L'])) {\n    return record['L'].map((item) => decodeAttributeValue(item))\n  }\n  if ('SS' in record) return record['SS']\n  if ('NS' in record) return Array.isArray(record['NS']) ? record['NS'].map(Number) : record['NS']\n\n  return value\n}\n\nfunction removeListener(\n  source: DynamoDbStreamSource,\n  event: 'record' | '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/dynamodb.d.cts

@@ -0,0 +1,48 @@
+import { D as DatabaseAdapter, C as ChangeEvent } from '../types-tPDla8AE.cjs';
+
+interface DynamoDbAttributeMap {
+    [key: string]: unknown;
+}
+interface DynamoDbStreamRecord {
+    eventName?: 'INSERT' | 'MODIFY' | 'REMOVE';
+    dynamodb?: {
+        NewImage?: DynamoDbAttributeMap;
+        OldImage?: DynamoDbAttributeMap;
+    };
+    eventSourceARN?: string;
+}
+interface DynamoDbStreamSource {
+    on(event: 'record', listener: (record: DynamoDbStreamRecord) => void): void;
+    on(event: 'error', listener: (error: Error) => void): void;
+    off?(event: 'record' | 'error', listener: (...args: any[]) => void): void;
+    removeListener?(event: 'record' | 'error', listener: (...args: any[]) => void): void;
+    start?(): Promise<void> | void;
+    stop?(): Promise<void> | void;
+}
+interface DynamoDbAdapterOptions {
+    source: DynamoDbStreamSource;
+    unmarshall?: (image: DynamoDbAttributeMap | undefined) => Record<string, unknown> | null;
+    onError?: (error: unknown) => void;
+}
+
+/**
+ * DynamoDB adapter for RouteFlow.
+ *
+ * Consumes DynamoDB Streams-style records from an external source.
+ */
+declare class DynamoDbAdapter implements DatabaseAdapter {
+    private readonly source;
+    private readonly unmarshall;
+    private readonly onError?;
+    private readonly listeners;
+    private readonly handleRecordBound;
+    private readonly handleErrorBound;
+    private connected;
+    constructor(options: DynamoDbAdapterOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onChange(table: string, callback: (event: ChangeEvent) => void): () => void;
+    private handleRecord;
+}
+
+export { DynamoDbAdapter, type DynamoDbAdapterOptions };