@spear340000/core 0.1.0

package/dist/adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapter/memory-adapter.ts","../../src/adapter/polling-adapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ChangeEvent, DatabaseAdapter } from '../types.js'\n\n/**\n * In-memory database adapter for testing and local development.\n * No real database connection is needed — changes are triggered manually via `emit()`.\n *\n * @example\n * ```ts\n * const adapter = new MemoryAdapter()\n * await adapter.connect()\n *\n * adapter.onChange('orders', (event) => console.log(event))\n *\n * adapter.emit('orders', { operation: 'INSERT', newRow: { id: 1 }, oldRow: null })\n * ```\n */\nexport class MemoryAdapter implements DatabaseAdapter {\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private connected = false\n\n  /** No-op — MemoryAdapter requires no real connection. */\n  async connect(): Promise<void> {\n    this.connected = true\n  }\n\n  /** No-op — clears all listeners on disconnect. */\n  async disconnect(): Promise<void> {\n    this.listeners.clear()\n    this.connected = false\n  }\n\n  /**\n   * Register a listener for changes on a specific table.\n   * @returns An unsubscribe function.\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    this.listeners.get(table)!.add(callback)\n\n    return () => {\n      this.listeners.get(table)?.delete(callback)\n    }\n  }\n\n  /**\n   * Manually emit a change event on a table.\n   * Useful in tests and examples to simulate DB changes without a real database.\n   *\n   * @param table - Table name to emit the event on\n   * @param event - Change event data (table and timestamp are filled in automatically)\n   */\n  emit(table: string, event: Omit<ChangeEvent, 'table' | 'timestamp'>): void {\n    const fullEvent: ChangeEvent = {\n      ...event,\n      table,\n      timestamp: Date.now(),\n    }\n\n    const callbacks = this.listeners.get(table)\n    if (!callbacks) return\n\n    for (const cb of callbacks) {\n      cb(fullEvent)\n    }\n  }\n\n  /** Returns true if connect() has been called and disconnect() has not. */\n  get isConnected(): boolean {\n    return this.connected\n  }\n}\n","import type { ChangeEvent, DatabaseAdapter } from '../types.js'\n\nexport interface PollingReadResult<T = unknown, TCursor = unknown> {\n  events: Array<Omit<ChangeEvent<T>, 'table' | 'timestamp'> & Partial<Pick<ChangeEvent<T>, 'table' | 'timestamp'>>>\n  cursor?: TCursor\n}\n\nexport interface PollingReadContext<TCursor = unknown> {\n  cursor: TCursor | undefined\n  table: string\n}\n\nexport interface PollingAdapterOptions<TCursor = unknown> {\n  intervalMs?: number\n  now?: () => number\n  onError?: (error: unknown, context: { table: string }) => void\n  readChanges: (\n    context: PollingReadContext<TCursor>,\n  ) => Promise<PollingReadResult<unknown, TCursor>>\n}\n\n/**\n * Generic polling-based adapter for databases without a native RouteFlow adapter yet.\n * It works with any backend as long as callers can periodically read a change feed.\n */\nexport class PollingAdapter<TCursor = unknown> implements DatabaseAdapter {\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly cursors: Map<string, TCursor | undefined> = new Map()\n  private readonly timers: Map<string, ReturnType<typeof setTimeout>> = new Map()\n  private readonly activeTables: Set<string> = new Set()\n  private readonly intervalMs: number\n  private readonly now: () => number\n  private readonly readChanges: PollingAdapterOptions<TCursor>['readChanges']\n  private readonly onError?: PollingAdapterOptions<TCursor>['onError']\n  private connected = false\n\n  constructor(options: PollingAdapterOptions<TCursor>) {\n    this.intervalMs = options.intervalMs ?? 1_000\n    this.now = options.now ?? (() => Date.now())\n    this.readChanges = options.readChanges\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    this.connected = true\n\n    for (const table of this.listeners.keys()) {\n      this.ensurePolling(table)\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false\n\n    for (const timer of this.timers.values()) {\n      clearTimeout(timer)\n    }\n\n    this.timers.clear()\n    this.activeTables.clear()\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    this.ensurePolling(table)\n\n    return () => {\n      const callbacks = this.listeners.get(table)\n      if (!callbacks) return\n\n      callbacks.delete(callback)\n\n      if (callbacks.size === 0) {\n        this.listeners.delete(table)\n        this.stopPolling(table)\n      }\n    }\n  }\n\n  private ensurePolling(table: string): void {\n    if (!this.connected || this.activeTables.has(table)) return\n\n    this.activeTables.add(table)\n    void this.poll(table)\n  }\n\n  private stopPolling(table: string): void {\n    const timer = this.timers.get(table)\n    if (timer) clearTimeout(timer)\n\n    this.timers.delete(table)\n    this.activeTables.delete(table)\n    this.cursors.delete(table)\n  }\n\n  private scheduleNext(table: string): void {\n    if (!this.connected || !this.listeners.has(table)) {\n      this.stopPolling(table)\n      return\n    }\n\n    const timer = setTimeout(() => {\n      void this.poll(table)\n    }, this.intervalMs)\n\n    this.timers.set(table, timer)\n  }\n\n  private async poll(table: string): Promise<void> {\n    if (!this.connected || !this.listeners.has(table)) {\n      this.stopPolling(table)\n      return\n    }\n\n    try {\n      const result = await this.readChanges({\n        table,\n        cursor: this.cursors.get(table),\n      })\n\n      this.cursors.set(table, result.cursor)\n\n      for (const event of result.events) {\n        this.emit(table, event)\n      }\n    } catch (error) {\n      this.onError?.(error, { table })\n    } finally {\n      this.activeTables.delete(table)\n      this.scheduleNext(table)\n    }\n  }\n\n  private emit(\n    defaultTable: string,\n    event: Omit<ChangeEvent, 'table' | 'timestamp'> & Partial<Pick<ChangeEvent, 'table' | 'timestamp'>>,\n  ): void {\n    const fullEvent: ChangeEvent = {\n      ...event,\n      table: event.table ?? defaultTable,\n      timestamp: event.timestamp ?? this.now(),\n    }\n\n    const callbacks = this.listeners.get(fullEvent.table)\n    if (!callbacks) return\n\n    for (const callback of callbacks) {\n      callback(fullEvent)\n    }\n  }\n}\n"]}

package/dist/adapter/index.mjs

@@ -0,0 +1,166 @@
+import { __name } from '../chunk-PAWJFY3S.mjs';
+
+// src/adapter/memory-adapter.ts
+var MemoryAdapter = class {
+  static {
+    __name(this, "MemoryAdapter");
+  }
+  listeners = /* @__PURE__ */ new Map();
+  connected = false;
+  /** No-op — MemoryAdapter requires no real connection. */
+  async connect() {
+    this.connected = true;
+  }
+  /** No-op — clears all listeners on disconnect. */
+  async disconnect() {
+    this.listeners.clear();
+    this.connected = false;
+  }
+  /**
+   * Register a listener for changes on a specific table.
+   * @returns An unsubscribe function.
+   */
+  onChange(table, callback) {
+    if (!this.listeners.has(table)) {
+      this.listeners.set(table, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(table).add(callback);
+    return () => {
+      this.listeners.get(table)?.delete(callback);
+    };
+  }
+  /**
+   * Manually emit a change event on a table.
+   * Useful in tests and examples to simulate DB changes without a real database.
+   *
+   * @param table - Table name to emit the event on
+   * @param event - Change event data (table and timestamp are filled in automatically)
+   */
+  emit(table, event) {
+    const fullEvent = {
+      ...event,
+      table,
+      timestamp: Date.now()
+    };
+    const callbacks = this.listeners.get(table);
+    if (!callbacks) return;
+    for (const cb of callbacks) {
+      cb(fullEvent);
+    }
+  }
+  /** Returns true if connect() has been called and disconnect() has not. */
+  get isConnected() {
+    return this.connected;
+  }
+};
+
+// src/adapter/polling-adapter.ts
+var PollingAdapter = class {
+  static {
+    __name(this, "PollingAdapter");
+  }
+  listeners = /* @__PURE__ */ new Map();
+  cursors = /* @__PURE__ */ new Map();
+  timers = /* @__PURE__ */ new Map();
+  activeTables = /* @__PURE__ */ new Set();
+  intervalMs;
+  now;
+  readChanges;
+  onError;
+  connected = false;
+  constructor(options) {
+    this.intervalMs = options.intervalMs ?? 1e3;
+    this.now = options.now ?? (() => Date.now());
+    this.readChanges = options.readChanges;
+    this.onError = options.onError;
+  }
+  async connect() {
+    this.connected = true;
+    for (const table of this.listeners.keys()) {
+      this.ensurePolling(table);
+    }
+  }
+  async disconnect() {
+    this.connected = false;
+    for (const timer of this.timers.values()) {
+      clearTimeout(timer);
+    }
+    this.timers.clear();
+    this.activeTables.clear();
+  }
+  onChange(table, callback) {
+    if (!this.listeners.has(table)) {
+      this.listeners.set(table, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(table).add(callback);
+    this.ensurePolling(table);
+    return () => {
+      const callbacks = this.listeners.get(table);
+      if (!callbacks) return;
+      callbacks.delete(callback);
+      if (callbacks.size === 0) {
+        this.listeners.delete(table);
+        this.stopPolling(table);
+      }
+    };
+  }
+  ensurePolling(table) {
+    if (!this.connected || this.activeTables.has(table)) return;
+    this.activeTables.add(table);
+    void this.poll(table);
+  }
+  stopPolling(table) {
+    const timer = this.timers.get(table);
+    if (timer) clearTimeout(timer);
+    this.timers.delete(table);
+    this.activeTables.delete(table);
+    this.cursors.delete(table);
+  }
+  scheduleNext(table) {
+    if (!this.connected || !this.listeners.has(table)) {
+      this.stopPolling(table);
+      return;
+    }
+    const timer = setTimeout(() => {
+      void this.poll(table);
+    }, this.intervalMs);
+    this.timers.set(table, timer);
+  }
+  async poll(table) {
+    if (!this.connected || !this.listeners.has(table)) {
+      this.stopPolling(table);
+      return;
+    }
+    try {
+      const result = await this.readChanges({
+        table,
+        cursor: this.cursors.get(table)
+      });
+      this.cursors.set(table, result.cursor);
+      for (const event of result.events) {
+        this.emit(table, event);
+      }
+    } catch (error) {
+      this.onError?.(error, { table });
+    } finally {
+      this.activeTables.delete(table);
+      this.scheduleNext(table);
+    }
+  }
+  emit(defaultTable, event) {
+    const fullEvent = {
+      ...event,
+      table: event.table ?? defaultTable,
+      timestamp: event.timestamp ?? this.now()
+    };
+    const callbacks = this.listeners.get(fullEvent.table);
+    if (!callbacks) return;
+    for (const callback of callbacks) {
+      callback(fullEvent);
+    }
+  }
+};
+
+export { MemoryAdapter, PollingAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/adapter/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapter/memory-adapter.ts","../../src/adapter/polling-adapter.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { ChangeEvent, DatabaseAdapter } from '../types.js'\n\n/**\n * In-memory database adapter for testing and local development.\n * No real database connection is needed — changes are triggered manually via `emit()`.\n *\n * @example\n * ```ts\n * const adapter = new MemoryAdapter()\n * await adapter.connect()\n *\n * adapter.onChange('orders', (event) => console.log(event))\n *\n * adapter.emit('orders', { operation: 'INSERT', newRow: { id: 1 }, oldRow: null })\n * ```\n */\nexport class MemoryAdapter implements DatabaseAdapter {\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private connected = false\n\n  /** No-op — MemoryAdapter requires no real connection. */\n  async connect(): Promise<void> {\n    this.connected = true\n  }\n\n  /** No-op — clears all listeners on disconnect. */\n  async disconnect(): Promise<void> {\n    this.listeners.clear()\n    this.connected = false\n  }\n\n  /**\n   * Register a listener for changes on a specific table.\n   * @returns An unsubscribe function.\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    this.listeners.get(table)!.add(callback)\n\n    return () => {\n      this.listeners.get(table)?.delete(callback)\n    }\n  }\n\n  /**\n   * Manually emit a change event on a table.\n   * Useful in tests and examples to simulate DB changes without a real database.\n   *\n   * @param table - Table name to emit the event on\n   * @param event - Change event data (table and timestamp are filled in automatically)\n   */\n  emit(table: string, event: Omit<ChangeEvent, 'table' | 'timestamp'>): void {\n    const fullEvent: ChangeEvent = {\n      ...event,\n      table,\n      timestamp: Date.now(),\n    }\n\n    const callbacks = this.listeners.get(table)\n    if (!callbacks) return\n\n    for (const cb of callbacks) {\n      cb(fullEvent)\n    }\n  }\n\n  /** Returns true if connect() has been called and disconnect() has not. */\n  get isConnected(): boolean {\n    return this.connected\n  }\n}\n","import type { ChangeEvent, DatabaseAdapter } from '../types.js'\n\nexport interface PollingReadResult<T = unknown, TCursor = unknown> {\n  events: Array<Omit<ChangeEvent<T>, 'table' | 'timestamp'> & Partial<Pick<ChangeEvent<T>, 'table' | 'timestamp'>>>\n  cursor?: TCursor\n}\n\nexport interface PollingReadContext<TCursor = unknown> {\n  cursor: TCursor | undefined\n  table: string\n}\n\nexport interface PollingAdapterOptions<TCursor = unknown> {\n  intervalMs?: number\n  now?: () => number\n  onError?: (error: unknown, context: { table: string }) => void\n  readChanges: (\n    context: PollingReadContext<TCursor>,\n  ) => Promise<PollingReadResult<unknown, TCursor>>\n}\n\n/**\n * Generic polling-based adapter for databases without a native RouteFlow adapter yet.\n * It works with any backend as long as callers can periodically read a change feed.\n */\nexport class PollingAdapter<TCursor = unknown> implements DatabaseAdapter {\n  private readonly listeners: Map<string, Set<(event: ChangeEvent) => void>> = new Map()\n  private readonly cursors: Map<string, TCursor | undefined> = new Map()\n  private readonly timers: Map<string, ReturnType<typeof setTimeout>> = new Map()\n  private readonly activeTables: Set<string> = new Set()\n  private readonly intervalMs: number\n  private readonly now: () => number\n  private readonly readChanges: PollingAdapterOptions<TCursor>['readChanges']\n  private readonly onError?: PollingAdapterOptions<TCursor>['onError']\n  private connected = false\n\n  constructor(options: PollingAdapterOptions<TCursor>) {\n    this.intervalMs = options.intervalMs ?? 1_000\n    this.now = options.now ?? (() => Date.now())\n    this.readChanges = options.readChanges\n    this.onError = options.onError\n  }\n\n  async connect(): Promise<void> {\n    this.connected = true\n\n    for (const table of this.listeners.keys()) {\n      this.ensurePolling(table)\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false\n\n    for (const timer of this.timers.values()) {\n      clearTimeout(timer)\n    }\n\n    this.timers.clear()\n    this.activeTables.clear()\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    this.ensurePolling(table)\n\n    return () => {\n      const callbacks = this.listeners.get(table)\n      if (!callbacks) return\n\n      callbacks.delete(callback)\n\n      if (callbacks.size === 0) {\n        this.listeners.delete(table)\n        this.stopPolling(table)\n      }\n    }\n  }\n\n  private ensurePolling(table: string): void {\n    if (!this.connected || this.activeTables.has(table)) return\n\n    this.activeTables.add(table)\n    void this.poll(table)\n  }\n\n  private stopPolling(table: string): void {\n    const timer = this.timers.get(table)\n    if (timer) clearTimeout(timer)\n\n    this.timers.delete(table)\n    this.activeTables.delete(table)\n    this.cursors.delete(table)\n  }\n\n  private scheduleNext(table: string): void {\n    if (!this.connected || !this.listeners.has(table)) {\n      this.stopPolling(table)\n      return\n    }\n\n    const timer = setTimeout(() => {\n      void this.poll(table)\n    }, this.intervalMs)\n\n    this.timers.set(table, timer)\n  }\n\n  private async poll(table: string): Promise<void> {\n    if (!this.connected || !this.listeners.has(table)) {\n      this.stopPolling(table)\n      return\n    }\n\n    try {\n      const result = await this.readChanges({\n        table,\n        cursor: this.cursors.get(table),\n      })\n\n      this.cursors.set(table, result.cursor)\n\n      for (const event of result.events) {\n        this.emit(table, event)\n      }\n    } catch (error) {\n      this.onError?.(error, { table })\n    } finally {\n      this.activeTables.delete(table)\n      this.scheduleNext(table)\n    }\n  }\n\n  private emit(\n    defaultTable: string,\n    event: Omit<ChangeEvent, 'table' | 'timestamp'> & Partial<Pick<ChangeEvent, 'table' | 'timestamp'>>,\n  ): void {\n    const fullEvent: ChangeEvent = {\n      ...event,\n      table: event.table ?? defaultTable,\n      timestamp: event.timestamp ?? this.now(),\n    }\n\n    const callbacks = this.listeners.get(fullEvent.table)\n    if (!callbacks) return\n\n    for (const callback of callbacks) {\n      callback(fullEvent)\n    }\n  }\n}\n"]}

package/dist/chunk-PAWJFY3S.mjs

@@ -0,0 +1,6 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+export { __name };
+//# sourceMappingURL=chunk-PAWJFY3S.mjs.map
+//# sourceMappingURL=chunk-PAWJFY3S.mjs.map

package/dist/chunk-PAWJFY3S.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-PAWJFY3S.mjs"}

package/dist/index.d.mts

@@ -0,0 +1,111 @@
+import { FastifyInstance } from 'fastify';
+import { H as HttpMethod, R as ReactiveOptions, A as AppOptions } from './types-tPDla8AE.mjs';
+export { C as ChangeEvent, a as Context, D as DatabaseAdapter } from './types-tPDla8AE.mjs';
+
+/**
+ * Registers a class method as an HTTP endpoint.
+ *
+ * @param method - HTTP verb
+ * @param path   - Route path, may include Fastify-style params (e.g. '/users/:id')
+ *
+ * @example
+ * ```ts
+ * @Route('GET', '/users/:id')
+ * async getUser(ctx: Context) { ... }
+ * ```
+ */
+declare function Route(method: HttpMethod, path: string): (target: object, propertyKey: string) => void;
+
+/**
+ * Marks a route handler as reactive — when the watched table(s) change,
+ * the handler is re-executed and the result is pushed to all subscribed clients.
+ *
+ * Must be used together with @Route.
+ *
+ * @param options - Reactive configuration (watch, filter, debounce)
+ *
+ * @example
+ * ```ts
+ * @Reactive({ watch: 'orders', filter: (event, ctx) => event.newRow?.userId === ctx.params.userId })
+ * @Route('GET', '/orders/:userId/live')
+ * async getLiveOrders(ctx: Context) { ... }
+ * ```
+ */
+declare function Reactive(options: ReactiveOptions): (target: object, propertyKey: string) => void;
+
+/**
+ * Base error class for all RouteFlow errors.
+ * Always use this instead of plain `Error` throughout the framework.
+ */
+declare class ReactiveApiError extends Error {
+    /** Machine-readable error code (e.g. 'ADAPTER_NOT_CONNECTED', 'INVALID_ROUTE') */
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+
+type DatabaseCategory = 'rdbms' | 'nosql' | 'time-series' | 'search-engine' | 'cloud-data-warehouse' | 'in-memory' | 'newsql';
+type DatabaseSupportMode = 'native-adapter' | 'polling-adapter' | 'external-cdc-bridge';
+type DatabaseSupportTier = 'official' | 'experimental';
+type DatabaseKey = 'postgresql' | 'mysql' | 'mariadb' | 'oracle-db' | 'ms-sql-server' | 'sqlite' | 'mongodb' | 'redis' | 'cassandra' | 'dynamodb' | 'neo4j' | 'elasticsearch' | 'hbase' | 'couchdb' | 'influxdb' | 'timescaledb' | 'prometheus' | 'opensearch' | 'solr' | 'snowflake' | 'bigquery' | 'redshift' | 'azure-synapse' | 'memcached' | 'voltdb' | 'cockroachdb' | 'tidb' | 'spanner';
+interface DatabaseSupportDescriptor {
+    key: DatabaseKey;
+    name: string;
+    aliases: string[];
+    categories: DatabaseCategory[];
+    supportedModes: DatabaseSupportMode[];
+    tier: DatabaseSupportTier;
+}
+declare const SUPPORTED_DATABASES: readonly DatabaseSupportDescriptor[];
+declare function getDatabaseSupport(name: string): DatabaseSupportDescriptor | undefined;
+declare function listSupportedDatabases(category?: DatabaseCategory): readonly DatabaseSupportDescriptor[];
+declare function listOfficialDatabases(category?: DatabaseCategory): readonly DatabaseSupportDescriptor[];
+
+/**
+ * Main application class. Use `createApp()` to instantiate.
+ */
+declare class ReactiveApp {
+    private readonly fastify;
+    private readonly engine;
+    private transport;
+    private readonly options;
+    /** Collected route patterns for reactive endpoints */
+    private readonly reactivePatterns;
+    constructor(options: AppOptions);
+    /**
+     * Register a controller class. Scans its methods for @Route and @Reactive
+     * decorators and registers HTTP routes and reactive endpoints accordingly.
+     *
+     * @param ControllerClass - A class constructor whose methods may be decorated
+     *                          with @Route and/or @Reactive.
+     */
+    register(ControllerClass: new () => object): this;
+    /**
+     * Access the underlying Fastify instance for supplemental routes such as
+     * health checks, static assets, or demo pages.
+     */
+    getFastify(): FastifyInstance;
+    /**
+     * Start the HTTP server.
+     * Connects the database adapter before accepting connections.
+     *
+     * @param port - Override the port set in AppOptions
+     */
+    listen(port?: number): Promise<void>;
+    /**
+     * Gracefully shut down the server and disconnect from the database.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a new RouteFlow application.
+ *
+ * @example
+ * ```ts
+ * const app = createApp({ adapter: new MemoryAdapter(), port: 3000 })
+ * app.register(MyController)
+ * await app.listen()
+ * ```
+ */
+declare function createApp(options: AppOptions): ReactiveApp;
+
+export { AppOptions, type DatabaseCategory, type DatabaseKey, type DatabaseSupportDescriptor, type DatabaseSupportMode, type DatabaseSupportTier, HttpMethod, Reactive, ReactiveApiError, ReactiveApp, ReactiveOptions, Route, SUPPORTED_DATABASES, createApp, getDatabaseSupport, listOfficialDatabases, listSupportedDatabases };

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+import { FastifyInstance } from 'fastify';
+import { H as HttpMethod, R as ReactiveOptions, A as AppOptions } from './types-tPDla8AE.js';
+export { C as ChangeEvent, a as Context, D as DatabaseAdapter } from './types-tPDla8AE.js';
+
+/**
+ * Registers a class method as an HTTP endpoint.
+ *
+ * @param method - HTTP verb
+ * @param path   - Route path, may include Fastify-style params (e.g. '/users/:id')
+ *
+ * @example
+ * ```ts
+ * @Route('GET', '/users/:id')
+ * async getUser(ctx: Context) { ... }
+ * ```
+ */
+declare function Route(method: HttpMethod, path: string): (target: object, propertyKey: string) => void;
+
+/**
+ * Marks a route handler as reactive — when the watched table(s) change,
+ * the handler is re-executed and the result is pushed to all subscribed clients.
+ *
+ * Must be used together with @Route.
+ *
+ * @param options - Reactive configuration (watch, filter, debounce)
+ *
+ * @example
+ * ```ts
+ * @Reactive({ watch: 'orders', filter: (event, ctx) => event.newRow?.userId === ctx.params.userId })
+ * @Route('GET', '/orders/:userId/live')
+ * async getLiveOrders(ctx: Context) { ... }
+ * ```
+ */
+declare function Reactive(options: ReactiveOptions): (target: object, propertyKey: string) => void;
+
+/**
+ * Base error class for all RouteFlow errors.
+ * Always use this instead of plain `Error` throughout the framework.
+ */
+declare class ReactiveApiError extends Error {
+    /** Machine-readable error code (e.g. 'ADAPTER_NOT_CONNECTED', 'INVALID_ROUTE') */
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+
+type DatabaseCategory = 'rdbms' | 'nosql' | 'time-series' | 'search-engine' | 'cloud-data-warehouse' | 'in-memory' | 'newsql';
+type DatabaseSupportMode = 'native-adapter' | 'polling-adapter' | 'external-cdc-bridge';
+type DatabaseSupportTier = 'official' | 'experimental';
+type DatabaseKey = 'postgresql' | 'mysql' | 'mariadb' | 'oracle-db' | 'ms-sql-server' | 'sqlite' | 'mongodb' | 'redis' | 'cassandra' | 'dynamodb' | 'neo4j' | 'elasticsearch' | 'hbase' | 'couchdb' | 'influxdb' | 'timescaledb' | 'prometheus' | 'opensearch' | 'solr' | 'snowflake' | 'bigquery' | 'redshift' | 'azure-synapse' | 'memcached' | 'voltdb' | 'cockroachdb' | 'tidb' | 'spanner';
+interface DatabaseSupportDescriptor {
+    key: DatabaseKey;
+    name: string;
+    aliases: string[];
+    categories: DatabaseCategory[];
+    supportedModes: DatabaseSupportMode[];
+    tier: DatabaseSupportTier;
+}
+declare const SUPPORTED_DATABASES: readonly DatabaseSupportDescriptor[];
+declare function getDatabaseSupport(name: string): DatabaseSupportDescriptor | undefined;
+declare function listSupportedDatabases(category?: DatabaseCategory): readonly DatabaseSupportDescriptor[];
+declare function listOfficialDatabases(category?: DatabaseCategory): readonly DatabaseSupportDescriptor[];
+
+/**
+ * Main application class. Use `createApp()` to instantiate.
+ */
+declare class ReactiveApp {
+    private readonly fastify;
+    private readonly engine;
+    private transport;
+    private readonly options;
+    /** Collected route patterns for reactive endpoints */
+    private readonly reactivePatterns;
+    constructor(options: AppOptions);
+    /**
+     * Register a controller class. Scans its methods for @Route and @Reactive
+     * decorators and registers HTTP routes and reactive endpoints accordingly.
+     *
+     * @param ControllerClass - A class constructor whose methods may be decorated
+     *                          with @Route and/or @Reactive.
+     */
+    register(ControllerClass: new () => object): this;
+    /**
+     * Access the underlying Fastify instance for supplemental routes such as
+     * health checks, static assets, or demo pages.
+     */
+    getFastify(): FastifyInstance;
+    /**
+     * Start the HTTP server.
+     * Connects the database adapter before accepting connections.
+     *
+     * @param port - Override the port set in AppOptions
+     */
+    listen(port?: number): Promise<void>;
+    /**
+     * Gracefully shut down the server and disconnect from the database.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a new RouteFlow application.
+ *
+ * @example
+ * ```ts
+ * const app = createApp({ adapter: new MemoryAdapter(), port: 3000 })
+ * app.register(MyController)
+ * await app.listen()
+ * ```
+ */
+declare function createApp(options: AppOptions): ReactiveApp;
+
+export { AppOptions, type DatabaseCategory, type DatabaseKey, type DatabaseSupportDescriptor, type DatabaseSupportMode, type DatabaseSupportTier, HttpMethod, Reactive, ReactiveApiError, ReactiveApp, ReactiveOptions, Route, SUPPORTED_DATABASES, createApp, getDatabaseSupport, listOfficialDatabases, listSupportedDatabases };