@powerdata/pd4 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -111,6 +111,8 @@ var PD4Client = class {
   constructor(url, db, options) {
     this.eventSource = null;
     this.handlers = /* @__PURE__ */ new Map();
+    this.wildcardHandlers = { insert: [], update: [], delete: [] };
+    this.anyHandlers = [];
     this.statusHandlers = [];
     this._status = "connecting";
     this.url = url.replace(/\/$/, "");
@@ -305,6 +307,14 @@ var PD4Client = class {
   }
   on(table, event, handler) {
     if (!this.eventSource) this.connect();
+    if (table === "*") {
+      const list2 = this.wildcardHandlers[event];
+      list2.push(handler);
+      return () => {
+        const idx = list2.indexOf(handler);
+        if (idx >= 0) list2.splice(idx, 1);
+      };
+    }
     let tableHandlers = this.handlers.get(table);
     if (!tableHandlers) {
       tableHandlers = { insert: [], update: [], delete: [] };
@@ -317,6 +327,19 @@ var PD4Client = class {
       if (idx >= 0) list.splice(idx, 1);
     };
   }
+  /**
+   * Subscribe to all SSE events on all tables.
+   * Handler receives (table, event, keys, newValues, oldValues).
+   * Auto-connects on first call. Returns an unsubscribe function.
+   */
+  onAny(handler) {
+    if (!this.eventSource) this.connect();
+    this.anyHandlers.push(handler);
+    return () => {
+      const idx = this.anyHandlers.indexOf(handler);
+      if (idx >= 0) this.anyHandlers.splice(idx, 1);
+    };
+  }
   /** Subscribe to connection status changes. Returns an unsubscribe function. */
   onStatus(handler) {
     this.statusHandlers.push(handler);
@@ -334,13 +357,24 @@ var PD4Client = class {
   }
   _dispatch(table, event, keys, newValues, oldValues) {
     const tableHandlers = this.handlers.get(table);
-    if (!tableHandlers) return;
+    if (tableHandlers) {
+      if (event === "insert") {
+        for (const h of tableHandlers.insert) h(keys, newValues);
+      } else if (event === "update") {
+        for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      } else {
+        for (const h of tableHandlers.delete) h(keys);
+      }
+    }
     if (event === "insert") {
-      for (const h of tableHandlers.insert) h(keys, newValues);
+      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues);
     } else if (event === "update") {
-      for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues);
     } else {
-      for (const h of tableHandlers.delete) h(keys);
+      for (const h of this.wildcardHandlers.delete) h(table, keys);
+    }
+    for (const h of this.anyHandlers) {
+      h(table, event, keys, newValues, oldValues);
     }
   }
 };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/utils.ts","../src/buffer.ts","../src/client.ts"],"sourcesContent":["export { PD4Client } from './client'\nexport { PD4Buffer } from './buffer'\nexport { PD4Error } from './errors'\nexport { flattenRow, toColumnar, toColumnValues } from './utils'\nexport type {\n  ColumnInfo,\n  TableInfo,\n  ColumnValue,\n  PD4Row,\n  Row,\n  SseEventType,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  StatusHandler,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  BufferInfo,\n  ViewInfo,\n  PD4ClientOptions,\n} from './types'\n","/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a table.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler: InsertHandler | UpdateHandler | DeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    const tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) return\n\n    if (event === 'insert') {\n      for (const h of tableHandlers.insert) h(keys, newValues)\n    } else if (event === 'update') {\n      for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n    } else {\n      for (const h of tableHandlers.delete) h(keys)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type { ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult }\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/utils.ts","../src/buffer.ts","../src/client.ts"],"sourcesContent":["export { PD4Client } from './client'\nexport { PD4Buffer } from './buffer'\nexport { PD4Error } from './errors'\nexport { flattenRow, toColumnar, toColumnValues } from './utils'\nexport type {\n  ColumnInfo,\n  TableInfo,\n  ColumnValue,\n  PD4Row,\n  Row,\n  SseEventType,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  WildcardInsertHandler,\n  WildcardUpdateHandler,\n  WildcardDeleteHandler,\n  AnyEventHandler,\n  StatusHandler,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  BufferInfo,\n  ViewInfo,\n  PD4ClientOptions,\n} from './types'\n","/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  WildcardInsertHandler,\n  WildcardUpdateHandler,\n  WildcardDeleteHandler,\n  AnyEventHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\ninterface WildcardHandlers {\n  insert: WildcardInsertHandler[]\n  update: WildcardUpdateHandler[]\n  delete: WildcardDeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private wildcardHandlers: WildcardHandlers = { insert: [], update: [], delete: [] }\n  private anyHandlers: AnyEventHandler[] = []\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a specific table, or use '*' for all tables.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   *\n   * Table-specific: handler receives (keys, rows/newValues/oldValues)\n   * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)\n   */\n  on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void\n  on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void\n  on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler:\n      | InsertHandler | UpdateHandler | DeleteHandler\n      | WildcardInsertHandler | WildcardUpdateHandler | WildcardDeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    // Wildcard: register in wildcardHandlers\n    if (table === '*') {\n      const list = this.wildcardHandlers[event] as unknown[]\n      list.push(handler)\n      return () => {\n        const idx = list.indexOf(handler)\n        if (idx >= 0) list.splice(idx, 1)\n      }\n    }\n\n    // Table-specific\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /**\n   * Subscribe to all SSE events on all tables.\n   * Handler receives (table, event, keys, newValues, oldValues).\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  onAny(handler: AnyEventHandler): () => void {\n    if (!this.eventSource) this.connect()\n\n    this.anyHandlers.push(handler)\n    return () => {\n      const idx = this.anyHandlers.indexOf(handler)\n      if (idx >= 0) this.anyHandlers.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    // Table-specific handlers\n    const tableHandlers = this.handlers.get(table)\n    if (tableHandlers) {\n      if (event === 'insert') {\n        for (const h of tableHandlers.insert) h(keys, newValues)\n      } else if (event === 'update') {\n        for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n      } else {\n        for (const h of tableHandlers.delete) h(keys)\n      }\n    }\n\n    // Wildcard handlers (on('*', ...))\n    if (event === 'insert') {\n      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues)\n    } else if (event === 'update') {\n      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues)\n    } else {\n      for (const h of this.wildcardHandlers.delete) h(table, keys)\n    }\n\n    // onAny handlers\n    for (const h of this.anyHandlers) {\n      h(table, event, keys, newValues, oldValues)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type {\n  ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult,\n  WildcardInsertHandler, WildcardUpdateHandler, WildcardDeleteHandler, AnyEventHandler,\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCO,IAAM,WAAN,cAAuB,MAAM;AAAA,EAIlC,YAAY,SAAiB,QAAiB,KAAc;AAC1D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,MAAM;AAAA,EACb;AACF;;;ACRO,SAAS,WAAW,KAAkB;AAC3C,QAAM,OAAY,EAAE,KAAK,IAAI,IAAI;AACjC,aAAW,MAAM,IAAI,QAAQ;AAC3B,SAAK,GAAG,MAAM,IAAI,GAAG;AAAA,EACvB;AACA,SAAO;AACT;AAMO,SAAS,WACd,UACA,aACqE;AACrE,MAAI,SAAS,WAAW,EAAG,QAAO,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,EAAE;AAC1D,QAAM,OAAO,eAAe,OAAO,KAAK,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,MAAM,KAAK;AAC9E,QAAM,OAAO,SAAS,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC;AAClE,SAAO,EAAE,SAAS,MAAM,KAAK;AAC/B;AAMO,SAAS,eACd,MAC+D;AAC/D,SAAO,OAAO,QAAQ,IAAI,EACvB,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,KAAK,EAC3B,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE,QAAQ,MAAM,EAAE;AACjD;;;AC1BO,IAAM,YAAN,MAAgB;AAAA,EAKrB,YAAY,QAAmB,QAAgB,OAAe;AAC5D,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA,EAGA,MAAM,OAAO,KAAa,QAA4B;AACpD,UAAM,QAAQ,eAAe,MAAM;AACnC,UAAM,KAAK,SAAS,SAAS,KAAK,MAAM,gBAAgB;AAAA,MACtD,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,KAAK,QAAQ,MAAM,CAAC;AAAA,IAC7C,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAM,SAAS,GAAG,QAAQ,KAA2B;AACzD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,SAAS,KAAK,MAAM,gBAAgB,MAAM,UAAU,KAAK;AAAA,IAC3D;AACA,WAAO;AAAA,MACL,MAAM,KAAK,KAAK,IAAI,UAAU;AAAA,MAC9B,OAAO,KAAK;AAAA,IACd;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,SAAwB;AAC5B,UAAM,KAAK,SAAS,SAAS,KAAK,MAAM,WAAW,EAAE,QAAQ,OAAO,CAAC;AAAA,EACvE;AAAA;AAAA,EAGA,MAAM,WAA0B;AAC9B,UAAM,KAAK,SAAS,SAAS,KAAK,MAAM,aAAa,EAAE,QAAQ,OAAO,CAAC;AAAA,EACzE;AAAA;AAAA,EAIA,MAAc,SAAY,MAAc,MAAgC;AACtE,UAAM,MAAM,GAAG,KAAK,OAAO,GAAG,OAAO,KAAK,OAAO,EAAE,IAAI,IAAI;AAC3D,UAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC3B,GAAG;AAAA,MACH,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,MAAM,QAAQ;AAAA,IAClE,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAM,IAAI,MAAM,cAAc,MAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,MAAM,IAAI,IAAI,EAAE;AAAA,IACrF;AACA,QAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,WAAO,IAAI,KAAK;AAAA,EAClB;AACF;;;ACtBO,IAAM,YAAN,MAAgB;AAAA,EAYrB,YAAY,KAAa,IAAY,SAA4B;AAPjE,SAAQ,cAAkC;AAC1C,SAAQ,WAAW,oBAAI,IAA2B;AAClD,SAAQ,mBAAqC,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE;AAClF,SAAQ,cAAiC,CAAC;AAC1C,SAAQ,iBAAkC,CAAC;AAC3C,SAAQ,UAA4B;AAGlC,SAAK,MAAM,IAAI,QAAQ,OAAO,EAAE;AAChC,SAAK,KAAK;AACV,SAAK,kBAAkB,SAAS,gBAC1B,OAAO,eAAe,eAAe,WAAW,cAChD,WAAW,cACX;AAAA,EACR;AAAA;AAAA,EAIA,IAAY,KAAK;AACf,WAAO,GAAG,KAAK,GAAG,OAAO,KAAK,EAAE;AAAA,EAClC;AAAA,EAEA,IAAY,MAAM;AAChB,WAAO,GAAG,KAAK,GAAG,QAAQ,KAAK,EAAE;AAAA,EACnC;AAAA;AAAA,EAIA,MAAc,QAAW,KAAa,MAAgC;AACpE,UAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC3B,GAAG;AAAA,MACH,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,MAAM,QAAQ;AAAA,IAClE,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAM,IAAI;AAAA,QACR,OAAO,MAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,MAAM,IAAI,IAAI;AAAA,QAC1D,IAAI;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AACA,QAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,WAAO,IAAI,KAAK;AAAA,EAClB;AAAA;AAAA;AAAA,EAKA,MAAM,OAAyB;AAC7B,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,SAAS;AAC5C,aAAO,IAAI;AAAA,IACb,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,MAAM,iBAAgC;AACpC,UAAM,KAAK,QAAQ,GAAG,KAAK,GAAG,UAAU;AAAA,MACtC,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,KAAK,GAAG,CAAC;AAAA,IACxC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA,EAKA,MAAM,aAAgC;AACpC,UAAM,OAAO,MAAM,KAAK,QAA8B,GAAG,KAAK,EAAE,SAAS;AACzE,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,SAAS,MAAkC;AAC/C,WAAO,KAAK,QAAmB,GAAG,KAAK,EAAE,WAAW,IAAI,EAAE;AAAA,EAC5D;AAAA;AAAA,EAGA,MAAM,YAAY,MAA6B;AAC7C,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,WAAW;AAAA,MACtC,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,SAAS,KAAK,CAAC;AAAA,IAC9C,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,UAAU,MAA6B;AAC3C,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,QAAQ,SAAS,CAAC;AAAA,EACtE;AAAA;AAAA,EAGA,MAAM,UAAU,OAAe,MAAc,OAA8B;AACzE,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,WAAW,KAAK,YAAY;AAAA,MACvD,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAAA,IACtC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAe,MAA0C;AACpE,UAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,UAAM,EAAE,SAAS,MAAM,QAAQ,IAAI,WAAW,GAAG;AACjD,WAAO,KAAK,QAAsB,GAAG,KAAK,EAAE,WAAW,KAAK,SAAS;AAAA,MACnE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,SAAS,MAAM,QAAQ,CAAC;AAAA,IACjD,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,OAAO,OAAe,KAAa,QAA4B;AACnE,UAAM,QAAQ,eAAe,MAAM;AACnC,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB;AAAA,MAC1D,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,KAAK,QAAQ,MAAM,CAAC;AAAA,IAC7C,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,OAAO,OAAe,MAAwC;AAClE,UAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB;AAAA,MAC1D,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,IAAI,CAAC;AAAA,IACpC,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAM,OAAe,MAA2C;AACpE,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,QAAQ,MAAM,SAAS;AAC7B,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB,MAAM,UAAU,KAAK;AAAA,IAChE;AACA,WAAO;AAAA,MACL,MAAM,KAAK,KAAK,IAAI,UAAU;AAAA,MAC9B,OAAO,KAAK;AAAA,IACd;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,MAAM,eACJ,OACA,SACA,MACuB;AACvB,WAAO,KAAK,QAAsB,GAAG,KAAK,EAAE,WAAW,KAAK,SAAS;AAAA,MACnE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,SAAS,KAAK,CAAC;AAAA,IACxC,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,UACJ,OACA,KACA,QACe;AACf,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB;AAAA,MAC1D,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,KAAK,OAAO,CAAC;AAAA,IACtC,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,SACJ,OACA,SAAS,GACT,QAAQ,KACoC;AAC5C,WAAO,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB,MAAM,UAAU,KAAK,EAAE;AAAA,EACtF;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAmC;AAC9C,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,GAAG,KAAK,EAAE,UAAU,KAAK;AAAA,MACzB,EAAE,QAAQ,OAAO;AAAA,IACnB;AACA,WAAO,IAAI,UAAU,MAAM,KAAK,QAAQ,KAAK;AAAA,EAC/C;AAAA;AAAA;AAAA,EAKA,IAAI,SAA2B;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,UAAgB;AACd,QAAI,KAAK,YAAa;AACtB,QAAI,CAAC,KAAK,iBAAiB;AACzB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,SAAK,WAAW,YAAY;AAC5B,UAAM,MAAM,IAAI,KAAK,gBAAgB,GAAG,KAAK,GAAG,SAAS;AACzD,SAAK,cAAc;AAEnB,QAAI,iBAAiB,WAAW,MAAM;AACpC,WAAK,WAAW,WAAW;AAAA,IAC7B,CAAC;AAED,QAAI,iBAAiB,UAAU,CAAC,MAAoB;AAClD,YAAM,OAAO,KAAK,MAAM,EAAE,IAAI;AAC9B,YAAM,QAAQ,KAAK;AACnB,YAAM,OAAiB,KAAK,QAAQ,CAAC;AACrC,YAAM,YAAmB,KAAK,cAAc,CAAC;AAC7C,WAAK,UAAU,OAAO,UAAU,MAAM,WAAW,CAAC,CAAC;AAAA,IACrD,CAAC;AAED,QAAI,iBAAiB,UAAU,CAAC,MAAoB;AAClD,YAAM,OAAO,KAAK,MAAM,EAAE,IAAI;AAC9B,YAAM,QAAQ,KAAK;AACnB,YAAM,OAAiB,KAAK,QAAQ,CAAC;AACrC,YAAM,YAAmB,KAAK,cAAc,CAAC;AAC7C,YAAM,YAAmB,KAAK,cAAc,CAAC;AAC7C,WAAK,UAAU,OAAO,UAAU,MAAM,WAAW,SAAS;AAAA,IAC5D,CAAC;AAED,QAAI,iBAAiB,UAAU,CAAC,MAAoB;AAClD,YAAM,OAAO,KAAK,MAAM,EAAE,IAAI;AAC9B,YAAM,QAAQ,KAAK;AACnB,YAAM,OAAiB,KAAK,QAAQ,CAAC;AACrC,WAAK,UAAU,OAAO,UAAU,MAAM,CAAC,GAAG,CAAC,CAAC;AAAA,IAC9C,CAAC;AAED,QAAI,UAAU,MAAM;AAClB,WAAK,WAAW,OAAO;AAAA,IACzB;AAAA,EACF;AAAA;AAAA,EAGA,aAAmB;AACjB,SAAK,aAAa,MAAM;AACxB,SAAK,cAAc;AACnB,SAAK,WAAW,YAAY;AAAA,EAC9B;AAAA,EAeA,GACE,OACA,OACA,SAGY;AAEZ,QAAI,CAAC,KAAK,YAAa,MAAK,QAAQ;AAGpC,QAAI,UAAU,KAAK;AACjB,YAAMA,QAAO,KAAK,iBAAiB,KAAK;AACxC,MAAAA,MAAK,KAAK,OAAO;AACjB,aAAO,MAAM;AACX,cAAM,MAAMA,MAAK,QAAQ,OAAO;AAChC,YAAI,OAAO,EAAG,CAAAA,MAAK,OAAO,KAAK,CAAC;AAAA,MAClC;AAAA,IACF;AAGA,QAAI,gBAAgB,KAAK,SAAS,IAAI,KAAK;AAC3C,QAAI,CAAC,eAAe;AAClB,sBAAgB,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE;AACrD,WAAK,SAAS,IAAI,OAAO,aAAa;AAAA,IACxC;AAEA,UAAM,OAAO,cAAc,KAAK;AAChC,SAAK,KAAK,OAAO;AAEjB,WAAO,MAAM;AACX,YAAM,MAAM,KAAK,QAAQ,OAAO;AAChC,UAAI,OAAO,EAAG,MAAK,OAAO,KAAK,CAAC;AAAA,IAClC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAsC;AAC1C,QAAI,CAAC,KAAK,YAAa,MAAK,QAAQ;AAEpC,SAAK,YAAY,KAAK,OAAO;AAC7B,WAAO,MAAM;AACX,YAAM,MAAM,KAAK,YAAY,QAAQ,OAAO;AAC5C,UAAI,OAAO,EAAG,MAAK,YAAY,OAAO,KAAK,CAAC;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA,EAGA,SAAS,SAAoC;AAC3C,SAAK,eAAe,KAAK,OAAO;AAChC,WAAO,MAAM;AACX,YAAM,MAAM,KAAK,eAAe,QAAQ,OAAO;AAC/C,UAAI,OAAO,EAAG,MAAK,eAAe,OAAO,KAAK,CAAC;AAAA,IACjD;AAAA,EACF;AAAA;AAAA,EAIQ,WAAW,QAA0B;AAC3C,SAAK,UAAU;AACf,eAAW,WAAW,KAAK,gBAAgB;AACzC,cAAQ,MAAM;AAAA,IAChB;AAAA,EACF;AAAA,EAEQ,UACN,OACA,OACA,MACA,WACA,WACA;AAEA,UAAM,gBAAgB,KAAK,SAAS,IAAI,KAAK;AAC7C,QAAI,eAAe;AACjB,UAAI,UAAU,UAAU;AACtB,mBAAW,KAAK,cAAc,OAAQ,GAAE,MAAM,SAAS;AAAA,MACzD,WAAW,UAAU,UAAU;AAC7B,mBAAW,KAAK,cAAc,OAAQ,GAAE,MAAM,WAAW,SAAS;AAAA,MACpE,OAAO;AACL,mBAAW,KAAK,cAAc,OAAQ,GAAE,IAAI;AAAA,MAC9C;AAAA,IACF;AAGA,QAAI,UAAU,UAAU;AACtB,iBAAW,KAAK,KAAK,iBAAiB,OAAQ,GAAE,OAAO,MAAM,SAAS;AAAA,IACxE,WAAW,UAAU,UAAU;AAC7B,iBAAW,KAAK,KAAK,iBAAiB,OAAQ,GAAE,OAAO,MAAM,WAAW,SAAS;AAAA,IACnF,OAAO;AACL,iBAAW,KAAK,KAAK,iBAAiB,OAAQ,GAAE,OAAO,IAAI;AAAA,IAC7D;AAGA,eAAW,KAAK,KAAK,aAAa;AAChC,QAAE,OAAO,OAAO,MAAM,WAAW,SAAS;AAAA,IAC5C;AAAA,EACF;AACF;","names":["list"]}

package/dist/index.d.cts

@@ -31,6 +31,12 @@ type InsertHandler = (keys: number[], rows: Row[]) => void;
 type UpdateHandler = (keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for delete events: (keys) */
 type DeleteHandler = (keys: number[]) => void;
+/** Wildcard callbacks: same as above but with table name as first arg */
+type WildcardInsertHandler = (table: string, keys: number[], rows: Row[]) => void;
+type WildcardUpdateHandler = (table: string, keys: number[], newValues: Row[], oldValues: Row[]) => void;
+type WildcardDeleteHandler = (table: string, keys: number[]) => void;
+/** Callback for onAny: fires for every event on every table */
+type AnyEventHandler = (table: string, event: SseEventType, keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for status changes */
 type StatusHandler = (status: ConnectionStatus) => void;
 /** Options for fetch */
@@ -95,6 +101,8 @@ declare class PD4Client {
     private EventSourceCtor;
     private eventSource;
     private handlers;
+    private wildcardHandlers;
+    private anyHandlers;
     private statusHandlers;
     private _status;
     constructor(url: string, db: string, options?: PD4ClientOptions);
@@ -144,12 +152,24 @@ declare class PD4Client {
     /** Disconnect from the SSE event stream. */
     disconnect(): void;
     /**
-     * Subscribe to SSE events for a table.
+     * Subscribe to SSE events for a specific table, or use '*' for all tables.
      * Auto-connects on first call. Returns an unsubscribe function.
+     *
+     * Table-specific: handler receives (keys, rows/newValues/oldValues)
+     * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)
      */
+    on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void;
+    on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void;
+    on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void;
     on(table: string, event: 'insert', handler: InsertHandler): () => void;
     on(table: string, event: 'update', handler: UpdateHandler): () => void;
     on(table: string, event: 'delete', handler: DeleteHandler): () => void;
+    /**
+     * Subscribe to all SSE events on all tables.
+     * Handler receives (table, event, keys, newValues, oldValues).
+     * Auto-connects on first call. Returns an unsubscribe function.
+     */
+    onAny(handler: AnyEventHandler): () => void;
     /** Subscribe to connection status changes. Returns an unsubscribe function. */
     onStatus(handler: StatusHandler): () => void;
     private _setStatus;
@@ -182,4 +202,4 @@ declare function toColumnValues(flat: Row): {
     value: string | number | boolean | null;
 }[];
 
-export { type BufferInfo, type ColumnInfo, type ColumnValue, type ConnectionStatus, type DeleteHandler, type FetchOptions, type FetchResult, type InsertHandler, type InsertResult, PD4Buffer, PD4Client, type PD4ClientOptions, PD4Error, type PD4Row, type Row, type SseEventType, type StatusHandler, type TableInfo, type UpdateHandler, type ViewInfo, flattenRow, toColumnValues, toColumnar };
+export { type AnyEventHandler, type BufferInfo, type ColumnInfo, type ColumnValue, type ConnectionStatus, type DeleteHandler, type FetchOptions, type FetchResult, type InsertHandler, type InsertResult, PD4Buffer, PD4Client, type PD4ClientOptions, PD4Error, type PD4Row, type Row, type SseEventType, type StatusHandler, type TableInfo, type UpdateHandler, type ViewInfo, type WildcardDeleteHandler, type WildcardInsertHandler, type WildcardUpdateHandler, flattenRow, toColumnValues, toColumnar };

package/dist/index.d.ts

@@ -31,6 +31,12 @@ type InsertHandler = (keys: number[], rows: Row[]) => void;
 type UpdateHandler = (keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for delete events: (keys) */
 type DeleteHandler = (keys: number[]) => void;
+/** Wildcard callbacks: same as above but with table name as first arg */
+type WildcardInsertHandler = (table: string, keys: number[], rows: Row[]) => void;
+type WildcardUpdateHandler = (table: string, keys: number[], newValues: Row[], oldValues: Row[]) => void;
+type WildcardDeleteHandler = (table: string, keys: number[]) => void;
+/** Callback for onAny: fires for every event on every table */
+type AnyEventHandler = (table: string, event: SseEventType, keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for status changes */
 type StatusHandler = (status: ConnectionStatus) => void;
 /** Options for fetch */
@@ -95,6 +101,8 @@ declare class PD4Client {
     private EventSourceCtor;
     private eventSource;
     private handlers;
+    private wildcardHandlers;
+    private anyHandlers;
     private statusHandlers;
     private _status;
     constructor(url: string, db: string, options?: PD4ClientOptions);
@@ -144,12 +152,24 @@ declare class PD4Client {
     /** Disconnect from the SSE event stream. */
     disconnect(): void;
     /**
-     * Subscribe to SSE events for a table.
+     * Subscribe to SSE events for a specific table, or use '*' for all tables.
      * Auto-connects on first call. Returns an unsubscribe function.
+     *
+     * Table-specific: handler receives (keys, rows/newValues/oldValues)
+     * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)
      */
+    on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void;
+    on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void;
+    on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void;
     on(table: string, event: 'insert', handler: InsertHandler): () => void;
     on(table: string, event: 'update', handler: UpdateHandler): () => void;
     on(table: string, event: 'delete', handler: DeleteHandler): () => void;
+    /**
+     * Subscribe to all SSE events on all tables.
+     * Handler receives (table, event, keys, newValues, oldValues).
+     * Auto-connects on first call. Returns an unsubscribe function.
+     */
+    onAny(handler: AnyEventHandler): () => void;
     /** Subscribe to connection status changes. Returns an unsubscribe function. */
     onStatus(handler: StatusHandler): () => void;
     private _setStatus;
@@ -182,4 +202,4 @@ declare function toColumnValues(flat: Row): {
     value: string | number | boolean | null;
 }[];
 
-export { type BufferInfo, type ColumnInfo, type ColumnValue, type ConnectionStatus, type DeleteHandler, type FetchOptions, type FetchResult, type InsertHandler, type InsertResult, PD4Buffer, PD4Client, type PD4ClientOptions, PD4Error, type PD4Row, type Row, type SseEventType, type StatusHandler, type TableInfo, type UpdateHandler, type ViewInfo, flattenRow, toColumnValues, toColumnar };
+export { type AnyEventHandler, type BufferInfo, type ColumnInfo, type ColumnValue, type ConnectionStatus, type DeleteHandler, type FetchOptions, type FetchResult, type InsertHandler, type InsertResult, PD4Buffer, PD4Client, type PD4ClientOptions, PD4Error, type PD4Row, type Row, type SseEventType, type StatusHandler, type TableInfo, type UpdateHandler, type ViewInfo, type WildcardDeleteHandler, type WildcardInsertHandler, type WildcardUpdateHandler, flattenRow, toColumnValues, toColumnar };

package/dist/index.js

@@ -80,6 +80,8 @@ var PD4Client = class {
   constructor(url, db, options) {
     this.eventSource = null;
     this.handlers = /* @__PURE__ */ new Map();
+    this.wildcardHandlers = { insert: [], update: [], delete: [] };
+    this.anyHandlers = [];
     this.statusHandlers = [];
     this._status = "connecting";
     this.url = url.replace(/\/$/, "");
@@ -274,6 +276,14 @@ var PD4Client = class {
   }
   on(table, event, handler) {
     if (!this.eventSource) this.connect();
+    if (table === "*") {
+      const list2 = this.wildcardHandlers[event];
+      list2.push(handler);
+      return () => {
+        const idx = list2.indexOf(handler);
+        if (idx >= 0) list2.splice(idx, 1);
+      };
+    }
     let tableHandlers = this.handlers.get(table);
     if (!tableHandlers) {
       tableHandlers = { insert: [], update: [], delete: [] };
@@ -286,6 +296,19 @@ var PD4Client = class {
       if (idx >= 0) list.splice(idx, 1);
     };
   }
+  /**
+   * Subscribe to all SSE events on all tables.
+   * Handler receives (table, event, keys, newValues, oldValues).
+   * Auto-connects on first call. Returns an unsubscribe function.
+   */
+  onAny(handler) {
+    if (!this.eventSource) this.connect();
+    this.anyHandlers.push(handler);
+    return () => {
+      const idx = this.anyHandlers.indexOf(handler);
+      if (idx >= 0) this.anyHandlers.splice(idx, 1);
+    };
+  }
   /** Subscribe to connection status changes. Returns an unsubscribe function. */
   onStatus(handler) {
     this.statusHandlers.push(handler);
@@ -303,13 +326,24 @@ var PD4Client = class {
   }
   _dispatch(table, event, keys, newValues, oldValues) {
     const tableHandlers = this.handlers.get(table);
-    if (!tableHandlers) return;
+    if (tableHandlers) {
+      if (event === "insert") {
+        for (const h of tableHandlers.insert) h(keys, newValues);
+      } else if (event === "update") {
+        for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      } else {
+        for (const h of tableHandlers.delete) h(keys);
+      }
+    }
     if (event === "insert") {
-      for (const h of tableHandlers.insert) h(keys, newValues);
+      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues);
     } else if (event === "update") {
-      for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues);
     } else {
-      for (const h of tableHandlers.delete) h(keys);
+      for (const h of this.wildcardHandlers.delete) h(table, keys);
+    }
+    for (const h of this.anyHandlers) {
+      h(table, event, keys, newValues, oldValues);
     }
   }
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/buffer.ts","../src/client.ts"],"sourcesContent":["/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a table.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler: InsertHandler | UpdateHandler | DeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    const tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) return\n\n    if (event === 'insert') {\n      for (const h of tableHandlers.insert) h(keys, newValues)\n    } else if (event === 'update') {\n      for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n    } else {\n      for (const h of tableHandlers.delete) h(keys)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type { ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult }\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/buffer.ts","../src/client.ts"],"sourcesContent":["/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  WildcardInsertHandler,\n  WildcardUpdateHandler,\n  WildcardDeleteHandler,\n  AnyEventHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\ninterface WildcardHandlers {\n  insert: WildcardInsertHandler[]\n  update: WildcardUpdateHandler[]\n  delete: WildcardDeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private wildcardHandlers: WildcardHandlers = { insert: [], update: [], delete: [] }\n  private anyHandlers: AnyEventHandler[] = []\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a specific table, or use '*' for all tables.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   *\n   * Table-specific: handler receives (keys, rows/newValues/oldValues)\n   * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)\n   */\n  on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void\n  on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void\n  on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler:\n      | InsertHandler | UpdateHandler | DeleteHandler\n      | WildcardInsertHandler | WildcardUpdateHandler | WildcardDeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    // Wildcard: register in wildcardHandlers\n    if (table === '*') {\n      const list = this.wildcardHandlers[event] as unknown[]\n      list.push(handler)\n      return () => {\n        const idx = list.indexOf(handler)\n        if (idx >= 0) list.splice(idx, 1)\n      }\n    }\n\n    // Table-specific\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /**\n   * Subscribe to all SSE events on all tables.\n   * Handler receives (table, event, keys, newValues, oldValues).\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  onAny(handler: AnyEventHandler): () => void {\n    if (!this.eventSource) this.connect()\n\n    this.anyHandlers.push(handler)\n    return () => {\n      const idx = this.anyHandlers.indexOf(handler)\n      if (idx >= 0) this.anyHandlers.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    // Table-specific handlers\n    const tableHandlers = this.handlers.get(table)\n    if (tableHandlers) {\n      if (event === 'insert') {\n        for (const h of tableHandlers.insert) h(keys, newValues)\n      } else if (event === 'update') {\n        for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n      } else {\n        for (const h of tableHandlers.delete) h(keys)\n      }\n    }\n\n    // Wildcard handlers (on('*', ...))\n    if (event === 'insert') {\n      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues)\n    } else if (event === 'update') {\n      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues)\n    } else {\n      for (const h of this.wildcardHandlers.delete) h(table, keys)\n    }\n\n    // onAny handlers\n    for (const h of this.anyHandlers) {\n      h(table, event, keys, newValues, oldValues)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type {\n  ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult,\n  WildcardInsertHandler, WildcardUpdateHandler, WildcardDeleteHandler, AnyEventHandler,\n}\n"],"mappings":"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","names":["list"]}

package/dist/react/index.cjs

@@ -113,6 +113,8 @@ var PD4Client = class {
   constructor(url, db, options) {
     this.eventSource = null;
     this.handlers = /* @__PURE__ */ new Map();
+    this.wildcardHandlers = { insert: [], update: [], delete: [] };
+    this.anyHandlers = [];
     this.statusHandlers = [];
     this._status = "connecting";
     this.url = url.replace(/\/$/, "");
@@ -307,6 +309,14 @@ var PD4Client = class {
   }
   on(table, event, handler) {
     if (!this.eventSource) this.connect();
+    if (table === "*") {
+      const list2 = this.wildcardHandlers[event];
+      list2.push(handler);
+      return () => {
+        const idx = list2.indexOf(handler);
+        if (idx >= 0) list2.splice(idx, 1);
+      };
+    }
     let tableHandlers = this.handlers.get(table);
     if (!tableHandlers) {
       tableHandlers = { insert: [], update: [], delete: [] };
@@ -319,6 +329,19 @@ var PD4Client = class {
       if (idx >= 0) list.splice(idx, 1);
     };
   }
+  /**
+   * Subscribe to all SSE events on all tables.
+   * Handler receives (table, event, keys, newValues, oldValues).
+   * Auto-connects on first call. Returns an unsubscribe function.
+   */
+  onAny(handler) {
+    if (!this.eventSource) this.connect();
+    this.anyHandlers.push(handler);
+    return () => {
+      const idx = this.anyHandlers.indexOf(handler);
+      if (idx >= 0) this.anyHandlers.splice(idx, 1);
+    };
+  }
   /** Subscribe to connection status changes. Returns an unsubscribe function. */
   onStatus(handler) {
     this.statusHandlers.push(handler);
@@ -336,13 +359,24 @@ var PD4Client = class {
   }
   _dispatch(table, event, keys, newValues, oldValues) {
     const tableHandlers = this.handlers.get(table);
-    if (!tableHandlers) return;
+    if (tableHandlers) {
+      if (event === "insert") {
+        for (const h of tableHandlers.insert) h(keys, newValues);
+      } else if (event === "update") {
+        for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      } else {
+        for (const h of tableHandlers.delete) h(keys);
+      }
+    }
     if (event === "insert") {
-      for (const h of tableHandlers.insert) h(keys, newValues);
+      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues);
     } else if (event === "update") {
-      for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues);
     } else {
-      for (const h of tableHandlers.delete) h(keys);
+      for (const h of this.wildcardHandlers.delete) h(table, keys);
+    }
+    for (const h of this.anyHandlers) {
+      h(table, event, keys, newValues, oldValues);
     }
   }
 };

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/index.ts","../../src/react/context.tsx","../../src/errors.ts","../../src/utils.ts","../../src/buffer.ts","../../src/client.ts","../../src/react/usePD4Subscribe.ts","../../src/react/usePD4Table.ts","../../src/react/usePD4Query.ts"],"sourcesContent":["export { PD4Provider, usePD4 } from './context'\nexport type { PD4ProviderProps } from './context'\nexport { usePD4Subscribe } from './usePD4Subscribe'\nexport { usePD4Table } from './usePD4Table'\nexport type { UsePD4TableOptions, UsePD4TableResult } from './usePD4Table'\nexport { usePD4Query } from './usePD4Query'\nexport type { UsePD4QueryResult } from './usePD4Query'\n","import { createContext, useContext, useRef } from 'react'\nimport { PD4Client } from '../client'\n\nconst PD4Context = createContext<PD4Client | null>(null)\n\nexport interface PD4ProviderProps {\n  url: string\n  db: string\n  children: React.ReactNode\n}\n\nexport function PD4Provider({ url, db, children }: PD4ProviderProps) {\n  const clientRef = useRef<PD4Client | null>(null)\n  if (!clientRef.current) {\n    clientRef.current = new PD4Client(url, db)\n  }\n  return <PD4Context.Provider value={clientRef.current}>{children}</PD4Context.Provider>\n}\n\nexport function usePD4(): PD4Client {\n  const client = useContext(PD4Context)\n  if (!client) {\n    throw new Error('usePD4() must be used within a <PD4Provider>')\n  }\n  return client\n}\n","/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a table.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler: InsertHandler | UpdateHandler | DeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    const tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) return\n\n    if (event === 'insert') {\n      for (const h of tableHandlers.insert) h(keys, newValues)\n    } else if (event === 'update') {\n      for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n    } else {\n      for (const h of tableHandlers.delete) h(keys)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type { ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult }\n","import { useEffect, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { InsertHandler, UpdateHandler, DeleteHandler } from '../types'\n\n/**\n * Subscribe to SSE events for a table. Auto-cleans up on unmount.\n *\n * Usage:\n *   usePD4Subscribe('metrics', 'insert', (keys, rows) => { ... })\n *   usePD4Subscribe('metrics', 'update', (keys, newVals, oldVals) => { ... })\n *   usePD4Subscribe('metrics', 'delete', (keys) => { ... })\n */\nexport function usePD4Subscribe(table: string, event: 'insert', handler: InsertHandler): void\nexport function usePD4Subscribe(table: string, event: 'update', handler: UpdateHandler): void\nexport function usePD4Subscribe(table: string, event: 'delete', handler: DeleteHandler): void\nexport function usePD4Subscribe(\n  table: string,\n  event: 'insert' | 'update' | 'delete',\n  handler: InsertHandler | UpdateHandler | DeleteHandler,\n): void {\n  const db = usePD4()\n  const handlerRef = useRef(handler)\n  handlerRef.current = handler\n\n  useEffect(() => {\n    const wrapper = (...args: unknown[]) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(handlerRef.current as any)(...args)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return db.on(table, event as any, wrapper as any)\n  }, [db, table, event])\n}\n","import { useState, useEffect, useCallback, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { Row, ColumnInfo, ConnectionStatus } from '../types'\n\nconst HIGHLIGHT_MS = 1500\n\nexport interface UsePD4TableOptions {\n  limit?: number\n  deleteDelay?: number\n}\n\nexport interface UsePD4TableResult {\n  rows: Row[]\n  total: number\n  columns: ColumnInfo[]\n  status: ConnectionStatus\n  highlights: Record<number, string>\n}\n\n/**\n * Full table state management hook.\n * Handles: initial fetch, SSE subscriptions for insert/update/delete,\n * row state management, highlight tracking, and buffer-commit edge cases.\n */\nexport function usePD4Table(\n  table: string,\n  opts?: UsePD4TableOptions,\n): UsePD4TableResult {\n  const db = usePD4()\n  const limit = opts?.limit ?? 1000\n  const deleteDelay = opts?.deleteDelay ?? HIGHLIGHT_MS\n\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [columns, setColumns] = useState<ColumnInfo[]>([])\n  const [status, setStatus] = useState<ConnectionStatus>('connecting')\n  const [highlights, setHighlights] = useState<Record<number, string>>({})\n\n  // Refs for stable callback access\n  const tableRef = useRef(table)\n  tableRef.current = table\n\n  const highlightKeys = useCallback((keys: number[], type: string) => {\n    if (keys.length === 0) return\n    setHighlights((prev) => {\n      const next = { ...prev }\n      for (const k of keys) next[k] = type\n      return next\n    })\n    setTimeout(() => {\n      setHighlights((prev) => {\n        const next = { ...prev }\n        for (const k of keys) {\n          if (next[k] === type) delete next[k]\n        }\n        return next\n      })\n    }, HIGHLIGHT_MS)\n  }, [])\n\n  const fetchRows = useCallback(async () => {\n    try {\n      const { rows: fetched, total: t } = await db.fetch(tableRef.current, { offset: 0, limit })\n      setRows(fetched)\n      setTotal(t)\n    } catch {\n      // Non-fatal\n    }\n  }, [db, limit])\n\n  useEffect(() => {\n    let cancelled = false\n    const unsubs: (() => void)[] = []\n\n    ;(async () => {\n      try {\n        // 1. Get column info\n        const info = await db.getTable(table)\n        if (cancelled) return\n        setColumns(info.columns.filter((c) => c.name !== '_pk'))\n\n        // 2. Fetch initial rows\n        await fetchRows()\n        if (cancelled) return\n        setStatus('connected')\n\n        // 3. SSE subscriptions\n        unsubs.push(db.on(table, 'insert', (keys, newValues) => {\n          if (cancelled) return\n          const newRows = keys.map((k, i) => ({ _pk: k, ...newValues[i] }))\n          setRows((prev) => [...prev, ...newRows])\n          setTotal((prev) => prev + newRows.length)\n          highlightKeys(keys, 'insert')\n        }))\n\n        unsubs.push(db.on(table, 'update', (keys, newValues) => {\n          if (cancelled) return\n\n          // Buffer commits send raw scalar values, not flat objects — fall back to refetch\n          if (\n            newValues.length === 0 ||\n            typeof newValues[0] !== 'object' ||\n            newValues[0] === null\n          ) {\n            fetchRows()\n            highlightKeys(keys, 'update')\n            return\n          }\n\n          const updateMap = new Map(keys.map((k, i) => [k, newValues[i]]))\n          setRows((prev) =>\n            prev.map((row) => {\n              const changes = updateMap.get(row._pk as number)\n              if (!changes) return row\n              return { ...row, ...changes }\n            }),\n          )\n          highlightKeys(keys, 'update')\n        }))\n\n        unsubs.push(db.on(table, 'delete', (keys) => {\n          if (cancelled) return\n          const keySet = new Set(keys)\n          highlightKeys(keys, 'delete')\n          setTimeout(() => {\n            setRows((prev) => prev.filter((row) => !keySet.has(row._pk as number)))\n            setTotal((prev) => Math.max(0, prev - keys.length))\n          }, deleteDelay)\n        }))\n      } catch {\n        if (!cancelled) {\n          setStatus('error')\n        }\n      }\n    })()\n\n    return () => {\n      cancelled = true\n      for (const unsub of unsubs) unsub()\n    }\n  }, [db, table, limit, fetchRows, highlightKeys, deleteDelay])\n\n  return { rows, total, columns, status, highlights }\n}\n","import { useState, useEffect } from 'react'\nimport { usePD4 } from './context'\nimport type { Row } from '../types'\n\nexport interface UsePD4QueryResult {\n  rows: Row[]\n  total: number\n  loading: boolean\n  error: string | null\n  refetch: () => void\n}\n\n/**\n * One-shot query hook. Fetches rows from a table once (or on refetch).\n */\nexport function usePD4Query(\n  table: string,\n  offset = 0,\n  limit = 1000,\n): UsePD4QueryResult {\n  const db = usePD4()\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState<string | null>(null)\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n\n    db.fetch(table, { offset, limit })\n      .then((result) => {\n        if (cancelled) return\n        setRows(result.rows)\n        setTotal(result.total)\n        setLoading(false)\n      })\n      .catch((err) => {\n        if (cancelled) return\n        setError(err instanceof Error ? err.message : 'Query failed')\n        setLoading(false)\n      })\n\n    return () => { cancelled = true }\n  }, [db, table, offset, limit, attempt])\n\n  return {\n    rows,\n    total,\n    loading,\n    error,\n    refetch: () => setAttempt((a) => a + 1),\n  }\n}\n"],"mappings":"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","names":["import_react","import_react","import_react"]}
+{"version":3,"sources":["../../src/react/index.ts","../../src/react/context.tsx","../../src/errors.ts","../../src/utils.ts","../../src/buffer.ts","../../src/client.ts","../../src/react/usePD4Subscribe.ts","../../src/react/usePD4Table.ts","../../src/react/usePD4Query.ts"],"sourcesContent":["export { PD4Provider, usePD4 } from './context'\nexport type { PD4ProviderProps } from './context'\nexport { usePD4Subscribe } from './usePD4Subscribe'\nexport { usePD4Table } from './usePD4Table'\nexport type { UsePD4TableOptions, UsePD4TableResult } from './usePD4Table'\nexport { usePD4Query } from './usePD4Query'\nexport type { UsePD4QueryResult } from './usePD4Query'\n","import { createContext, useContext, useRef } from 'react'\nimport { PD4Client } from '../client'\n\nconst PD4Context = createContext<PD4Client | null>(null)\n\nexport interface PD4ProviderProps {\n  url: string\n  db: string\n  children: React.ReactNode\n}\n\nexport function PD4Provider({ url, db, children }: PD4ProviderProps) {\n  const clientRef = useRef<PD4Client | null>(null)\n  if (!clientRef.current) {\n    clientRef.current = new PD4Client(url, db)\n  }\n  return <PD4Context.Provider value={clientRef.current}>{children}</PD4Context.Provider>\n}\n\nexport function usePD4(): PD4Client {\n  const client = useContext(PD4Context)\n  if (!client) {\n    throw new Error('usePD4() must be used within a <PD4Provider>')\n  }\n  return client\n}\n","/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  WildcardInsertHandler,\n  WildcardUpdateHandler,\n  WildcardDeleteHandler,\n  AnyEventHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\ninterface WildcardHandlers {\n  insert: WildcardInsertHandler[]\n  update: WildcardUpdateHandler[]\n  delete: WildcardDeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private wildcardHandlers: WildcardHandlers = { insert: [], update: [], delete: [] }\n  private anyHandlers: AnyEventHandler[] = []\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a specific table, or use '*' for all tables.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   *\n   * Table-specific: handler receives (keys, rows/newValues/oldValues)\n   * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)\n   */\n  on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void\n  on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void\n  on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler:\n      | InsertHandler | UpdateHandler | DeleteHandler\n      | WildcardInsertHandler | WildcardUpdateHandler | WildcardDeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    // Wildcard: register in wildcardHandlers\n    if (table === '*') {\n      const list = this.wildcardHandlers[event] as unknown[]\n      list.push(handler)\n      return () => {\n        const idx = list.indexOf(handler)\n        if (idx >= 0) list.splice(idx, 1)\n      }\n    }\n\n    // Table-specific\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /**\n   * Subscribe to all SSE events on all tables.\n   * Handler receives (table, event, keys, newValues, oldValues).\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  onAny(handler: AnyEventHandler): () => void {\n    if (!this.eventSource) this.connect()\n\n    this.anyHandlers.push(handler)\n    return () => {\n      const idx = this.anyHandlers.indexOf(handler)\n      if (idx >= 0) this.anyHandlers.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    // Table-specific handlers\n    const tableHandlers = this.handlers.get(table)\n    if (tableHandlers) {\n      if (event === 'insert') {\n        for (const h of tableHandlers.insert) h(keys, newValues)\n      } else if (event === 'update') {\n        for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n      } else {\n        for (const h of tableHandlers.delete) h(keys)\n      }\n    }\n\n    // Wildcard handlers (on('*', ...))\n    if (event === 'insert') {\n      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues)\n    } else if (event === 'update') {\n      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues)\n    } else {\n      for (const h of this.wildcardHandlers.delete) h(table, keys)\n    }\n\n    // onAny handlers\n    for (const h of this.anyHandlers) {\n      h(table, event, keys, newValues, oldValues)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type {\n  ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult,\n  WildcardInsertHandler, WildcardUpdateHandler, WildcardDeleteHandler, AnyEventHandler,\n}\n","import { useEffect, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { InsertHandler, UpdateHandler, DeleteHandler } from '../types'\n\n/**\n * Subscribe to SSE events for a table. Auto-cleans up on unmount.\n *\n * Usage:\n *   usePD4Subscribe('metrics', 'insert', (keys, rows) => { ... })\n *   usePD4Subscribe('metrics', 'update', (keys, newVals, oldVals) => { ... })\n *   usePD4Subscribe('metrics', 'delete', (keys) => { ... })\n */\nexport function usePD4Subscribe(table: string, event: 'insert', handler: InsertHandler): void\nexport function usePD4Subscribe(table: string, event: 'update', handler: UpdateHandler): void\nexport function usePD4Subscribe(table: string, event: 'delete', handler: DeleteHandler): void\nexport function usePD4Subscribe(\n  table: string,\n  event: 'insert' | 'update' | 'delete',\n  handler: InsertHandler | UpdateHandler | DeleteHandler,\n): void {\n  const db = usePD4()\n  const handlerRef = useRef(handler)\n  handlerRef.current = handler\n\n  useEffect(() => {\n    const wrapper = (...args: unknown[]) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(handlerRef.current as any)(...args)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return db.on(table, event as any, wrapper as any)\n  }, [db, table, event])\n}\n","import { useState, useEffect, useCallback, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { Row, ColumnInfo, ConnectionStatus } from '../types'\n\nconst HIGHLIGHT_MS = 1500\n\nexport interface UsePD4TableOptions {\n  limit?: number\n  deleteDelay?: number\n}\n\nexport interface UsePD4TableResult {\n  rows: Row[]\n  total: number\n  columns: ColumnInfo[]\n  status: ConnectionStatus\n  highlights: Record<number, string>\n}\n\n/**\n * Full table state management hook.\n * Handles: initial fetch, SSE subscriptions for insert/update/delete,\n * row state management, highlight tracking, and buffer-commit edge cases.\n */\nexport function usePD4Table(\n  table: string,\n  opts?: UsePD4TableOptions,\n): UsePD4TableResult {\n  const db = usePD4()\n  const limit = opts?.limit ?? 1000\n  const deleteDelay = opts?.deleteDelay ?? HIGHLIGHT_MS\n\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [columns, setColumns] = useState<ColumnInfo[]>([])\n  const [status, setStatus] = useState<ConnectionStatus>('connecting')\n  const [highlights, setHighlights] = useState<Record<number, string>>({})\n\n  // Refs for stable callback access\n  const tableRef = useRef(table)\n  tableRef.current = table\n\n  const highlightKeys = useCallback((keys: number[], type: string) => {\n    if (keys.length === 0) return\n    setHighlights((prev) => {\n      const next = { ...prev }\n      for (const k of keys) next[k] = type\n      return next\n    })\n    setTimeout(() => {\n      setHighlights((prev) => {\n        const next = { ...prev }\n        for (const k of keys) {\n          if (next[k] === type) delete next[k]\n        }\n        return next\n      })\n    }, HIGHLIGHT_MS)\n  }, [])\n\n  const fetchRows = useCallback(async () => {\n    try {\n      const { rows: fetched, total: t } = await db.fetch(tableRef.current, { offset: 0, limit })\n      setRows(fetched)\n      setTotal(t)\n    } catch {\n      // Non-fatal\n    }\n  }, [db, limit])\n\n  useEffect(() => {\n    let cancelled = false\n    const unsubs: (() => void)[] = []\n\n    ;(async () => {\n      try {\n        // 1. Get column info\n        const info = await db.getTable(table)\n        if (cancelled) return\n        setColumns(info.columns.filter((c) => c.name !== '_pk'))\n\n        // 2. Fetch initial rows\n        await fetchRows()\n        if (cancelled) return\n        setStatus('connected')\n\n        // 3. SSE subscriptions\n        unsubs.push(db.on(table, 'insert', (keys, newValues) => {\n          if (cancelled) return\n          const newRows = keys.map((k, i) => ({ _pk: k, ...newValues[i] }))\n          setRows((prev) => [...prev, ...newRows])\n          setTotal((prev) => prev + newRows.length)\n          highlightKeys(keys, 'insert')\n        }))\n\n        unsubs.push(db.on(table, 'update', (keys, newValues) => {\n          if (cancelled) return\n\n          // Buffer commits send raw scalar values, not flat objects — fall back to refetch\n          if (\n            newValues.length === 0 ||\n            typeof newValues[0] !== 'object' ||\n            newValues[0] === null\n          ) {\n            fetchRows()\n            highlightKeys(keys, 'update')\n            return\n          }\n\n          const updateMap = new Map(keys.map((k, i) => [k, newValues[i]]))\n          setRows((prev) =>\n            prev.map((row) => {\n              const changes = updateMap.get(row._pk as number)\n              if (!changes) return row\n              return { ...row, ...changes }\n            }),\n          )\n          highlightKeys(keys, 'update')\n        }))\n\n        unsubs.push(db.on(table, 'delete', (keys) => {\n          if (cancelled) return\n          const keySet = new Set(keys)\n          highlightKeys(keys, 'delete')\n          setTimeout(() => {\n            setRows((prev) => prev.filter((row) => !keySet.has(row._pk as number)))\n            setTotal((prev) => Math.max(0, prev - keys.length))\n          }, deleteDelay)\n        }))\n      } catch {\n        if (!cancelled) {\n          setStatus('error')\n        }\n      }\n    })()\n\n    return () => {\n      cancelled = true\n      for (const unsub of unsubs) unsub()\n    }\n  }, [db, table, limit, fetchRows, highlightKeys, deleteDelay])\n\n  return { rows, total, columns, status, highlights }\n}\n","import { useState, useEffect } from 'react'\nimport { usePD4 } from './context'\nimport type { Row } from '../types'\n\nexport interface UsePD4QueryResult {\n  rows: Row[]\n  total: number\n  loading: boolean\n  error: string | null\n  refetch: () => void\n}\n\n/**\n * One-shot query hook. Fetches rows from a table once (or on refetch).\n */\nexport function usePD4Query(\n  table: string,\n  offset = 0,\n  limit = 1000,\n): UsePD4QueryResult {\n  const db = usePD4()\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState<string | null>(null)\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n\n    db.fetch(table, { offset, limit })\n      .then((result) => {\n        if (cancelled) return\n        setRows(result.rows)\n        setTotal(result.total)\n        setLoading(false)\n      })\n      .catch((err) => {\n        if (cancelled) return\n        setError(err instanceof Error ? err.message : 'Query failed')\n        setLoading(false)\n      })\n\n    return () => { cancelled = true }\n  }, [db, table, offset, limit, attempt])\n\n  return {\n    rows,\n    total,\n    loading,\n    error,\n    refetch: () => setAttempt((a) => a + 1),\n  }\n}\n"],"mappings":"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","names":["list","import_react","import_react","import_react"]}

package/dist/react/index.d.cts

@@ -23,6 +23,8 @@ interface PD4Row {
 }
 /** Flat row for display: column name -> value, plus _pk */
 type Row = Record<string, string | number | boolean | null>;
+/** SSE event types */
+type SseEventType = 'insert' | 'update' | 'delete';
 /** SSE connection status */
 type ConnectionStatus = 'connecting' | 'connected' | 'error';
 /** Callback for insert events: (keys, rows) */
@@ -31,6 +33,12 @@ type InsertHandler = (keys: number[], rows: Row[]) => void;
 type UpdateHandler = (keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for delete events: (keys) */
 type DeleteHandler = (keys: number[]) => void;
+/** Wildcard callbacks: same as above but with table name as first arg */
+type WildcardInsertHandler = (table: string, keys: number[], rows: Row[]) => void;
+type WildcardUpdateHandler = (table: string, keys: number[], newValues: Row[], oldValues: Row[]) => void;
+type WildcardDeleteHandler = (table: string, keys: number[]) => void;
+/** Callback for onAny: fires for every event on every table */
+type AnyEventHandler = (table: string, event: SseEventType, keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for status changes */
 type StatusHandler = (status: ConnectionStatus) => void;
 /** Options for fetch */
@@ -84,6 +92,8 @@ declare class PD4Client {
     private EventSourceCtor;
     private eventSource;
     private handlers;
+    private wildcardHandlers;
+    private anyHandlers;
     private statusHandlers;
     private _status;
     constructor(url: string, db: string, options?: PD4ClientOptions);
@@ -133,12 +143,24 @@ declare class PD4Client {
     /** Disconnect from the SSE event stream. */
     disconnect(): void;
     /**
-     * Subscribe to SSE events for a table.
+     * Subscribe to SSE events for a specific table, or use '*' for all tables.
      * Auto-connects on first call. Returns an unsubscribe function.
+     *
+     * Table-specific: handler receives (keys, rows/newValues/oldValues)
+     * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)
      */
+    on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void;
+    on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void;
+    on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void;
     on(table: string, event: 'insert', handler: InsertHandler): () => void;
     on(table: string, event: 'update', handler: UpdateHandler): () => void;
     on(table: string, event: 'delete', handler: DeleteHandler): () => void;
+    /**
+     * Subscribe to all SSE events on all tables.
+     * Handler receives (table, event, keys, newValues, oldValues).
+     * Auto-connects on first call. Returns an unsubscribe function.
+     */
+    onAny(handler: AnyEventHandler): () => void;
     /** Subscribe to connection status changes. Returns an unsubscribe function. */
     onStatus(handler: StatusHandler): () => void;
     private _setStatus;

package/dist/react/index.d.ts

@@ -23,6 +23,8 @@ interface PD4Row {
 }
 /** Flat row for display: column name -> value, plus _pk */
 type Row = Record<string, string | number | boolean | null>;
+/** SSE event types */
+type SseEventType = 'insert' | 'update' | 'delete';
 /** SSE connection status */
 type ConnectionStatus = 'connecting' | 'connected' | 'error';
 /** Callback for insert events: (keys, rows) */
@@ -31,6 +33,12 @@ type InsertHandler = (keys: number[], rows: Row[]) => void;
 type UpdateHandler = (keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for delete events: (keys) */
 type DeleteHandler = (keys: number[]) => void;
+/** Wildcard callbacks: same as above but with table name as first arg */
+type WildcardInsertHandler = (table: string, keys: number[], rows: Row[]) => void;
+type WildcardUpdateHandler = (table: string, keys: number[], newValues: Row[], oldValues: Row[]) => void;
+type WildcardDeleteHandler = (table: string, keys: number[]) => void;
+/** Callback for onAny: fires for every event on every table */
+type AnyEventHandler = (table: string, event: SseEventType, keys: number[], newValues: Row[], oldValues: Row[]) => void;
 /** Callback for status changes */
 type StatusHandler = (status: ConnectionStatus) => void;
 /** Options for fetch */
@@ -84,6 +92,8 @@ declare class PD4Client {
     private EventSourceCtor;
     private eventSource;
     private handlers;
+    private wildcardHandlers;
+    private anyHandlers;
     private statusHandlers;
     private _status;
     constructor(url: string, db: string, options?: PD4ClientOptions);
@@ -133,12 +143,24 @@ declare class PD4Client {
     /** Disconnect from the SSE event stream. */
     disconnect(): void;
     /**
-     * Subscribe to SSE events for a table.
+     * Subscribe to SSE events for a specific table, or use '*' for all tables.
      * Auto-connects on first call. Returns an unsubscribe function.
+     *
+     * Table-specific: handler receives (keys, rows/newValues/oldValues)
+     * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)
      */
+    on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void;
+    on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void;
+    on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void;
     on(table: string, event: 'insert', handler: InsertHandler): () => void;
     on(table: string, event: 'update', handler: UpdateHandler): () => void;
     on(table: string, event: 'delete', handler: DeleteHandler): () => void;
+    /**
+     * Subscribe to all SSE events on all tables.
+     * Handler receives (table, event, keys, newValues, oldValues).
+     * Auto-connects on first call. Returns an unsubscribe function.
+     */
+    onAny(handler: AnyEventHandler): () => void;
     /** Subscribe to connection status changes. Returns an unsubscribe function. */
     onStatus(handler: StatusHandler): () => void;
     private _setStatus;

package/dist/react/index.js

@@ -83,6 +83,8 @@ var PD4Client = class {
   constructor(url, db, options) {
     this.eventSource = null;
     this.handlers = /* @__PURE__ */ new Map();
+    this.wildcardHandlers = { insert: [], update: [], delete: [] };
+    this.anyHandlers = [];
     this.statusHandlers = [];
     this._status = "connecting";
     this.url = url.replace(/\/$/, "");
@@ -277,6 +279,14 @@ var PD4Client = class {
   }
   on(table, event, handler) {
     if (!this.eventSource) this.connect();
+    if (table === "*") {
+      const list2 = this.wildcardHandlers[event];
+      list2.push(handler);
+      return () => {
+        const idx = list2.indexOf(handler);
+        if (idx >= 0) list2.splice(idx, 1);
+      };
+    }
     let tableHandlers = this.handlers.get(table);
     if (!tableHandlers) {
       tableHandlers = { insert: [], update: [], delete: [] };
@@ -289,6 +299,19 @@ var PD4Client = class {
       if (idx >= 0) list.splice(idx, 1);
     };
   }
+  /**
+   * Subscribe to all SSE events on all tables.
+   * Handler receives (table, event, keys, newValues, oldValues).
+   * Auto-connects on first call. Returns an unsubscribe function.
+   */
+  onAny(handler) {
+    if (!this.eventSource) this.connect();
+    this.anyHandlers.push(handler);
+    return () => {
+      const idx = this.anyHandlers.indexOf(handler);
+      if (idx >= 0) this.anyHandlers.splice(idx, 1);
+    };
+  }
   /** Subscribe to connection status changes. Returns an unsubscribe function. */
   onStatus(handler) {
     this.statusHandlers.push(handler);
@@ -306,13 +329,24 @@ var PD4Client = class {
   }
   _dispatch(table, event, keys, newValues, oldValues) {
     const tableHandlers = this.handlers.get(table);
-    if (!tableHandlers) return;
+    if (tableHandlers) {
+      if (event === "insert") {
+        for (const h of tableHandlers.insert) h(keys, newValues);
+      } else if (event === "update") {
+        for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      } else {
+        for (const h of tableHandlers.delete) h(keys);
+      }
+    }
     if (event === "insert") {
-      for (const h of tableHandlers.insert) h(keys, newValues);
+      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues);
     } else if (event === "update") {
-      for (const h of tableHandlers.update) h(keys, newValues, oldValues);
+      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues);
     } else {
-      for (const h of tableHandlers.delete) h(keys);
+      for (const h of this.wildcardHandlers.delete) h(table, keys);
+    }
+    for (const h of this.anyHandlers) {
+      h(table, event, keys, newValues, oldValues);
     }
   }
 };

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/context.tsx","../../src/errors.ts","../../src/utils.ts","../../src/buffer.ts","../../src/client.ts","../../src/react/usePD4Subscribe.ts","../../src/react/usePD4Table.ts","../../src/react/usePD4Query.ts"],"sourcesContent":["import { createContext, useContext, useRef } from 'react'\nimport { PD4Client } from '../client'\n\nconst PD4Context = createContext<PD4Client | null>(null)\n\nexport interface PD4ProviderProps {\n  url: string\n  db: string\n  children: React.ReactNode\n}\n\nexport function PD4Provider({ url, db, children }: PD4ProviderProps) {\n  const clientRef = useRef<PD4Client | null>(null)\n  if (!clientRef.current) {\n    clientRef.current = new PD4Client(url, db)\n  }\n  return <PD4Context.Provider value={clientRef.current}>{children}</PD4Context.Provider>\n}\n\nexport function usePD4(): PD4Client {\n  const client = useContext(PD4Context)\n  if (!client) {\n    throw new Error('usePD4() must be used within a <PD4Provider>')\n  }\n  return client\n}\n","/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a table.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler: InsertHandler | UpdateHandler | DeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    const tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) return\n\n    if (event === 'insert') {\n      for (const h of tableHandlers.insert) h(keys, newValues)\n    } else if (event === 'update') {\n      for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n    } else {\n      for (const h of tableHandlers.delete) h(keys)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type { ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult }\n","import { useEffect, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { InsertHandler, UpdateHandler, DeleteHandler } from '../types'\n\n/**\n * Subscribe to SSE events for a table. Auto-cleans up on unmount.\n *\n * Usage:\n *   usePD4Subscribe('metrics', 'insert', (keys, rows) => { ... })\n *   usePD4Subscribe('metrics', 'update', (keys, newVals, oldVals) => { ... })\n *   usePD4Subscribe('metrics', 'delete', (keys) => { ... })\n */\nexport function usePD4Subscribe(table: string, event: 'insert', handler: InsertHandler): void\nexport function usePD4Subscribe(table: string, event: 'update', handler: UpdateHandler): void\nexport function usePD4Subscribe(table: string, event: 'delete', handler: DeleteHandler): void\nexport function usePD4Subscribe(\n  table: string,\n  event: 'insert' | 'update' | 'delete',\n  handler: InsertHandler | UpdateHandler | DeleteHandler,\n): void {\n  const db = usePD4()\n  const handlerRef = useRef(handler)\n  handlerRef.current = handler\n\n  useEffect(() => {\n    const wrapper = (...args: unknown[]) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(handlerRef.current as any)(...args)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return db.on(table, event as any, wrapper as any)\n  }, [db, table, event])\n}\n","import { useState, useEffect, useCallback, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { Row, ColumnInfo, ConnectionStatus } from '../types'\n\nconst HIGHLIGHT_MS = 1500\n\nexport interface UsePD4TableOptions {\n  limit?: number\n  deleteDelay?: number\n}\n\nexport interface UsePD4TableResult {\n  rows: Row[]\n  total: number\n  columns: ColumnInfo[]\n  status: ConnectionStatus\n  highlights: Record<number, string>\n}\n\n/**\n * Full table state management hook.\n * Handles: initial fetch, SSE subscriptions for insert/update/delete,\n * row state management, highlight tracking, and buffer-commit edge cases.\n */\nexport function usePD4Table(\n  table: string,\n  opts?: UsePD4TableOptions,\n): UsePD4TableResult {\n  const db = usePD4()\n  const limit = opts?.limit ?? 1000\n  const deleteDelay = opts?.deleteDelay ?? HIGHLIGHT_MS\n\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [columns, setColumns] = useState<ColumnInfo[]>([])\n  const [status, setStatus] = useState<ConnectionStatus>('connecting')\n  const [highlights, setHighlights] = useState<Record<number, string>>({})\n\n  // Refs for stable callback access\n  const tableRef = useRef(table)\n  tableRef.current = table\n\n  const highlightKeys = useCallback((keys: number[], type: string) => {\n    if (keys.length === 0) return\n    setHighlights((prev) => {\n      const next = { ...prev }\n      for (const k of keys) next[k] = type\n      return next\n    })\n    setTimeout(() => {\n      setHighlights((prev) => {\n        const next = { ...prev }\n        for (const k of keys) {\n          if (next[k] === type) delete next[k]\n        }\n        return next\n      })\n    }, HIGHLIGHT_MS)\n  }, [])\n\n  const fetchRows = useCallback(async () => {\n    try {\n      const { rows: fetched, total: t } = await db.fetch(tableRef.current, { offset: 0, limit })\n      setRows(fetched)\n      setTotal(t)\n    } catch {\n      // Non-fatal\n    }\n  }, [db, limit])\n\n  useEffect(() => {\n    let cancelled = false\n    const unsubs: (() => void)[] = []\n\n    ;(async () => {\n      try {\n        // 1. Get column info\n        const info = await db.getTable(table)\n        if (cancelled) return\n        setColumns(info.columns.filter((c) => c.name !== '_pk'))\n\n        // 2. Fetch initial rows\n        await fetchRows()\n        if (cancelled) return\n        setStatus('connected')\n\n        // 3. SSE subscriptions\n        unsubs.push(db.on(table, 'insert', (keys, newValues) => {\n          if (cancelled) return\n          const newRows = keys.map((k, i) => ({ _pk: k, ...newValues[i] }))\n          setRows((prev) => [...prev, ...newRows])\n          setTotal((prev) => prev + newRows.length)\n          highlightKeys(keys, 'insert')\n        }))\n\n        unsubs.push(db.on(table, 'update', (keys, newValues) => {\n          if (cancelled) return\n\n          // Buffer commits send raw scalar values, not flat objects — fall back to refetch\n          if (\n            newValues.length === 0 ||\n            typeof newValues[0] !== 'object' ||\n            newValues[0] === null\n          ) {\n            fetchRows()\n            highlightKeys(keys, 'update')\n            return\n          }\n\n          const updateMap = new Map(keys.map((k, i) => [k, newValues[i]]))\n          setRows((prev) =>\n            prev.map((row) => {\n              const changes = updateMap.get(row._pk as number)\n              if (!changes) return row\n              return { ...row, ...changes }\n            }),\n          )\n          highlightKeys(keys, 'update')\n        }))\n\n        unsubs.push(db.on(table, 'delete', (keys) => {\n          if (cancelled) return\n          const keySet = new Set(keys)\n          highlightKeys(keys, 'delete')\n          setTimeout(() => {\n            setRows((prev) => prev.filter((row) => !keySet.has(row._pk as number)))\n            setTotal((prev) => Math.max(0, prev - keys.length))\n          }, deleteDelay)\n        }))\n      } catch {\n        if (!cancelled) {\n          setStatus('error')\n        }\n      }\n    })()\n\n    return () => {\n      cancelled = true\n      for (const unsub of unsubs) unsub()\n    }\n  }, [db, table, limit, fetchRows, highlightKeys, deleteDelay])\n\n  return { rows, total, columns, status, highlights }\n}\n","import { useState, useEffect } from 'react'\nimport { usePD4 } from './context'\nimport type { Row } from '../types'\n\nexport interface UsePD4QueryResult {\n  rows: Row[]\n  total: number\n  loading: boolean\n  error: string | null\n  refetch: () => void\n}\n\n/**\n * One-shot query hook. Fetches rows from a table once (or on refetch).\n */\nexport function usePD4Query(\n  table: string,\n  offset = 0,\n  limit = 1000,\n): UsePD4QueryResult {\n  const db = usePD4()\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState<string | null>(null)\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n\n    db.fetch(table, { offset, limit })\n      .then((result) => {\n        if (cancelled) return\n        setRows(result.rows)\n        setTotal(result.total)\n        setLoading(false)\n      })\n      .catch((err) => {\n        if (cancelled) return\n        setError(err instanceof Error ? err.message : 'Query failed')\n        setLoading(false)\n      })\n\n    return () => { cancelled = true }\n  }, [db, table, offset, limit, attempt])\n\n  return {\n    rows,\n    total,\n    loading,\n    error,\n    refetch: () => setAttempt((a) => a + 1),\n  }\n}\n"],"mappings":"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","names":["useRef","useRef","useEffect","useRef","useRef","useEffect","useState","useEffect","useState","useEffect"]}
+{"version":3,"sources":["../../src/react/context.tsx","../../src/errors.ts","../../src/utils.ts","../../src/buffer.ts","../../src/client.ts","../../src/react/usePD4Subscribe.ts","../../src/react/usePD4Table.ts","../../src/react/usePD4Query.ts"],"sourcesContent":["import { createContext, useContext, useRef } from 'react'\nimport { PD4Client } from '../client'\n\nconst PD4Context = createContext<PD4Client | null>(null)\n\nexport interface PD4ProviderProps {\n  url: string\n  db: string\n  children: React.ReactNode\n}\n\nexport function PD4Provider({ url, db, children }: PD4ProviderProps) {\n  const clientRef = useRef<PD4Client | null>(null)\n  if (!clientRef.current) {\n    clientRef.current = new PD4Client(url, db)\n  }\n  return <PD4Context.Provider value={clientRef.current}>{children}</PD4Context.Provider>\n}\n\nexport function usePD4(): PD4Client {\n  const client = useContext(PD4Context)\n  if (!client) {\n    throw new Error('usePD4() must be used within a <PD4Provider>')\n  }\n  return client\n}\n","/** Base error class for PD4 client errors */\nexport class PD4Error extends Error {\n  readonly status: number | undefined\n  readonly url: string | undefined\n\n  constructor(message: string, status?: number, url?: string) {\n    super(message)\n    this.name = 'PD4Error'\n    this.status = status\n    this.url = url\n  }\n}\n","import type { PD4Row, Row } from './types'\n\n/** Convert PD4 row format to flat record */\nexport function flattenRow(row: PD4Row): Row {\n  const flat: Row = { _pk: row.key }\n  for (const cv of row.values) {\n    flat[cv.column] = cv.value\n  }\n  return flat\n}\n\n/**\n * Convert flat row objects to PD4's columnar insert format.\n * Returns { columns, rows } suitable for the insert endpoint.\n */\nexport function toColumnar(\n  flatRows: Row[],\n  columnNames?: string[],\n): { columns: string[]; rows: (string | number | boolean | null)[][] } {\n  if (flatRows.length === 0) return { columns: [], rows: [] }\n  const cols = columnNames ?? Object.keys(flatRows[0]).filter((k) => k !== '_pk')\n  const rows = flatRows.map((row) => cols.map((c) => row[c] ?? null))\n  return { columns: cols, rows }\n}\n\n/**\n * Convert a flat row object to PD4's column-value pairs for update.\n * Filters out the _pk field.\n */\nexport function toColumnValues(\n  flat: Row,\n): { column: string; value: string | number | boolean | null }[] {\n  return Object.entries(flat)\n    .filter(([k]) => k !== '_pk')\n    .map(([column, value]) => ({ column, value }))\n}\n","import type { PD4Client } from './client'\nimport { flattenRow, toColumnValues } from './utils'\nimport type { Row, FetchResult, PD4Row } from './types'\n\n/**\n * A buffered view wrapping a PD4 table.\n * Changes are accumulated locally and only become visible\n * to other clients after commit().\n */\nexport class PD4Buffer {\n  private client: PD4Client\n  readonly handle: string\n  readonly table: string\n\n  constructor(client: PD4Client, handle: string, table: string) {\n    this.client = client\n    this.handle = handle\n    this.table = table\n  }\n\n  /** Update a row within the buffer (not visible to others until commit). */\n  async update(key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this._request(`views/${this.handle}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Fetch rows from the buffer (sees uncommitted changes). */\n  async fetch(offset = 0, limit = 100): Promise<FetchResult> {\n    const data = await this._request<{ rows: PD4Row[]; total: number }>(\n      `views/${this.handle}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  /** Commit all buffered writes atomically. Fires SSE events. */\n  async commit(): Promise<void> {\n    await this._request(`views/${this.handle}/commit`, { method: 'POST' })\n  }\n\n  /** Rollback all buffered writes (discard pending changes). */\n  async rollback(): Promise<void> {\n    await this._request(`views/${this.handle}/rollback`, { method: 'POST' })\n  }\n\n  // --- Internal ----------------------------------------------------------\n\n  private async _request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.client.url}/v1/${this.client.db}/${path}`\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new Error(`PD4 Buffer ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`)\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n}\n","import { PD4Error } from './errors'\nimport { flattenRow, toColumnar, toColumnValues } from './utils'\nimport { PD4Buffer } from './buffer'\nimport type {\n  ColumnInfo,\n  TableInfo,\n  PD4Row,\n  Row,\n  FetchOptions,\n  FetchResult,\n  InsertResult,\n  ConnectionStatus,\n  InsertHandler,\n  UpdateHandler,\n  DeleteHandler,\n  WildcardInsertHandler,\n  WildcardUpdateHandler,\n  WildcardDeleteHandler,\n  AnyEventHandler,\n  StatusHandler,\n  PD4ClientOptions,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal types for SSE handler registry\n// ---------------------------------------------------------------------------\n\ninterface TableHandlers {\n  insert: InsertHandler[]\n  update: UpdateHandler[]\n  delete: DeleteHandler[]\n}\n\ninterface WildcardHandlers {\n  insert: WildcardInsertHandler[]\n  update: WildcardUpdateHandler[]\n  delete: WildcardDeleteHandler[]\n}\n\n// ---------------------------------------------------------------------------\n// PD4Client\n// ---------------------------------------------------------------------------\n\nexport class PD4Client {\n  readonly url: string\n  readonly db: string\n\n  private EventSourceCtor: (new (url: string) => EventSource) | null\n  private eventSource: EventSource | null = null\n  private handlers = new Map<string, TableHandlers>()\n  private wildcardHandlers: WildcardHandlers = { insert: [], update: [], delete: [] }\n  private anyHandlers: AnyEventHandler[] = []\n  private statusHandlers: StatusHandler[] = []\n  private _status: ConnectionStatus = 'connecting'\n\n  constructor(url: string, db: string, options?: PD4ClientOptions) {\n    this.url = url.replace(/\\/$/, '')\n    this.db = db\n    this.EventSourceCtor = options?.EventSource\n      ?? (typeof globalThis !== 'undefined' && globalThis.EventSource\n        ? globalThis.EventSource\n        : null)\n  }\n\n  // --- URL helpers -------------------------------------------------------\n\n  private get v1() {\n    return `${this.url}/v1/${this.db}`\n  }\n\n  private get api() {\n    return `${this.url}/api/${this.db}`\n  }\n\n  // --- HTTP helper -------------------------------------------------------\n\n  private async request<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await fetch(url, {\n      ...init,\n      headers: { 'Content-Type': 'application/json', ...init?.headers },\n    })\n    if (!res.ok) {\n      const text = await res.text()\n      throw new PD4Error(\n        `PD4 ${init?.method ?? 'GET'} ${url}: ${res.status} ${text}`,\n        res.status,\n        url,\n      )\n    }\n    if (res.status === 204) return undefined as T\n    return res.json()\n  }\n\n  // --- Health ------------------------------------------------------------\n\n  /** Check if PD4 is reachable */\n  async ping(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.url}/health`)\n      return res.ok\n    } catch {\n      return false\n    }\n  }\n\n  // --- Database ----------------------------------------------------------\n\n  /** Ensure the database is open */\n  async ensureDatabase(): Promise<void> {\n    await this.request(`${this.url}/v1/db`, {\n      method: 'POST',\n      body: JSON.stringify({ name: this.db }),\n    })\n  }\n\n  // --- Tables ------------------------------------------------------------\n\n  /** List all table names */\n  async listTables(): Promise<string[]> {\n    const data = await this.request<{ tables: string[] }>(`${this.v1}/tables`)\n    return data.tables\n  }\n\n  /** Get table info */\n  async getTable(name: string): Promise<TableInfo> {\n    return this.request<TableInfo>(`${this.v1}/tables/${name}`)\n  }\n\n  /** Create a table (with auto_pk) */\n  async createTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables`, {\n      method: 'POST',\n      body: JSON.stringify({ name, auto_pk: true }),\n    })\n  }\n\n  /** Drop a table */\n  async dropTable(name: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${name}`, { method: 'DELETE' })\n  }\n\n  /** Add a column to a table */\n  async addColumn(table: string, name: string, dtype: string): Promise<void> {\n    await this.request(`${this.v1}/tables/${table}/columns`, {\n      method: 'POST',\n      body: JSON.stringify({ name, dtype }),\n    })\n  }\n\n  // --- Rows (flat objects in, flat objects out) ---------------------------\n\n  /** Insert one or more rows (flat objects). Returns keys and count. */\n  async insert(table: string, rows: Row | Row[]): Promise<InsertResult> {\n    const arr = Array.isArray(rows) ? rows : [rows]\n    const { columns, rows: colRows } = toColumnar(arr)\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows: colRows }),\n    })\n  }\n\n  /** Update a single row by key with a flat object of changed columns. */\n  async update(table: string, key: number, values: Row): Promise<void> {\n    const pairs = toColumnValues(values)\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values: pairs }),\n    })\n  }\n\n  /** Delete rows by keys. */\n  async delete(table: string, keys: number | number[]): Promise<void> {\n    const arr = Array.isArray(keys) ? keys : [keys]\n    await this.request(`${this.v1}/views/${table}/rows/delete`, {\n      method: 'POST',\n      body: JSON.stringify({ keys: arr }),\n    })\n  }\n\n  /** Fetch rows from a table/view. Returns flat Row objects. */\n  async fetch(table: string, opts?: FetchOptions): Promise<FetchResult> {\n    const offset = opts?.offset ?? 0\n    const limit = opts?.limit ?? 1000\n    const data = await this.request<{ rows: PD4Row[]; total: number }>(\n      `${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`,\n    )\n    return {\n      rows: data.rows.map(flattenRow),\n      total: data.total,\n    }\n  }\n\n  // --- Raw row access (PD4 wire format) ----------------------------------\n\n  /** Insert rows in columnar format (low-level). */\n  async insertColumnar(\n    table: string,\n    columns: string[],\n    rows: (string | number | boolean | null)[][],\n  ): Promise<InsertResult> {\n    return this.request<InsertResult>(`${this.v1}/tables/${table}/rows`, {\n      method: 'POST',\n      body: JSON.stringify({ columns, rows }),\n    })\n  }\n\n  /** Update a row by key with column-value pairs (low-level). */\n  async updateRaw(\n    table: string,\n    key: number,\n    values: { column: string; value: string | number | boolean | null }[],\n  ): Promise<void> {\n    await this.request(`${this.v1}/views/${table}/rows/update`, {\n      method: 'POST',\n      body: JSON.stringify({ key, values }),\n    })\n  }\n\n  /** Fetch rows in PD4 wire format (low-level). */\n  async fetchRaw(\n    table: string,\n    offset = 0,\n    limit = 1000,\n  ): Promise<{ rows: PD4Row[]; total: number }> {\n    return this.request(`${this.v1}/views/${table}/rows?offset=${offset}&limit=${limit}`)\n  }\n\n  // --- Buffer ------------------------------------------------------------\n\n  /** Create a buffered view wrapping a table. */\n  async buffer(table: string): Promise<PD4Buffer> {\n    const info = await this.request<{ handle: string; source: string; row_count: number }>(\n      `${this.v1}/views/${table}/buffer`,\n      { method: 'POST' },\n    )\n    return new PD4Buffer(this, info.handle, table)\n  }\n\n  // --- SSE ---------------------------------------------------------------\n\n  /** Get current SSE connection status. */\n  get status(): ConnectionStatus {\n    return this._status\n  }\n\n  /** Connect to the SSE event stream. Called automatically on first on(). */\n  connect(): void {\n    if (this.eventSource) return\n    if (!this.EventSourceCtor) {\n      throw new Error(\n        'EventSource is not available. In Node.js, pass { EventSource } from the \"eventsource\" package to the PD4Client constructor.',\n      )\n    }\n\n    this._setStatus('connecting')\n    const sse = new this.EventSourceCtor(`${this.api}/events`)\n    this.eventSource = sse\n\n    sse.addEventListener('session', () => {\n      this._setStatus('connected')\n    })\n\n    sse.addEventListener('insert', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      this._dispatch(table, 'insert', keys, newValues, [])\n    })\n\n    sse.addEventListener('update', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      const newValues: Row[] = data.new_values ?? []\n      const oldValues: Row[] = data.old_values ?? []\n      this._dispatch(table, 'update', keys, newValues, oldValues)\n    })\n\n    sse.addEventListener('delete', (e: MessageEvent) => {\n      const data = JSON.parse(e.data)\n      const table = data.handle as string\n      const keys: number[] = data.keys ?? []\n      this._dispatch(table, 'delete', keys, [], [])\n    })\n\n    sse.onerror = () => {\n      this._setStatus('error')\n    }\n  }\n\n  /** Disconnect from the SSE event stream. */\n  disconnect(): void {\n    this.eventSource?.close()\n    this.eventSource = null\n    this._setStatus('connecting')\n  }\n\n  /**\n   * Subscribe to SSE events for a specific table, or use '*' for all tables.\n   * Auto-connects on first call. Returns an unsubscribe function.\n   *\n   * Table-specific: handler receives (keys, rows/newValues/oldValues)\n   * Wildcard '*': handler receives (table, keys, rows/newValues/oldValues)\n   */\n  on(table: '*', event: 'insert', handler: WildcardInsertHandler): () => void\n  on(table: '*', event: 'update', handler: WildcardUpdateHandler): () => void\n  on(table: '*', event: 'delete', handler: WildcardDeleteHandler): () => void\n  on(table: string, event: 'insert', handler: InsertHandler): () => void\n  on(table: string, event: 'update', handler: UpdateHandler): () => void\n  on(table: string, event: 'delete', handler: DeleteHandler): () => void\n  on(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    handler:\n      | InsertHandler | UpdateHandler | DeleteHandler\n      | WildcardInsertHandler | WildcardUpdateHandler | WildcardDeleteHandler,\n  ): () => void {\n    // Auto-connect\n    if (!this.eventSource) this.connect()\n\n    // Wildcard: register in wildcardHandlers\n    if (table === '*') {\n      const list = this.wildcardHandlers[event] as unknown[]\n      list.push(handler)\n      return () => {\n        const idx = list.indexOf(handler)\n        if (idx >= 0) list.splice(idx, 1)\n      }\n    }\n\n    // Table-specific\n    let tableHandlers = this.handlers.get(table)\n    if (!tableHandlers) {\n      tableHandlers = { insert: [], update: [], delete: [] }\n      this.handlers.set(table, tableHandlers)\n    }\n\n    const list = tableHandlers[event] as unknown[]\n    list.push(handler)\n\n    return () => {\n      const idx = list.indexOf(handler)\n      if (idx >= 0) list.splice(idx, 1)\n    }\n  }\n\n  /**\n   * Subscribe to all SSE events on all tables.\n   * Handler receives (table, event, keys, newValues, oldValues).\n   * Auto-connects on first call. Returns an unsubscribe function.\n   */\n  onAny(handler: AnyEventHandler): () => void {\n    if (!this.eventSource) this.connect()\n\n    this.anyHandlers.push(handler)\n    return () => {\n      const idx = this.anyHandlers.indexOf(handler)\n      if (idx >= 0) this.anyHandlers.splice(idx, 1)\n    }\n  }\n\n  /** Subscribe to connection status changes. Returns an unsubscribe function. */\n  onStatus(handler: StatusHandler): () => void {\n    this.statusHandlers.push(handler)\n    return () => {\n      const idx = this.statusHandlers.indexOf(handler)\n      if (idx >= 0) this.statusHandlers.splice(idx, 1)\n    }\n  }\n\n  // --- SSE internals -----------------------------------------------------\n\n  private _setStatus(status: ConnectionStatus) {\n    this._status = status\n    for (const handler of this.statusHandlers) {\n      handler(status)\n    }\n  }\n\n  private _dispatch(\n    table: string,\n    event: 'insert' | 'update' | 'delete',\n    keys: number[],\n    newValues: Row[],\n    oldValues: Row[],\n  ) {\n    // Table-specific handlers\n    const tableHandlers = this.handlers.get(table)\n    if (tableHandlers) {\n      if (event === 'insert') {\n        for (const h of tableHandlers.insert) h(keys, newValues)\n      } else if (event === 'update') {\n        for (const h of tableHandlers.update) h(keys, newValues, oldValues)\n      } else {\n        for (const h of tableHandlers.delete) h(keys)\n      }\n    }\n\n    // Wildcard handlers (on('*', ...))\n    if (event === 'insert') {\n      for (const h of this.wildcardHandlers.insert) h(table, keys, newValues)\n    } else if (event === 'update') {\n      for (const h of this.wildcardHandlers.update) h(table, keys, newValues, oldValues)\n    } else {\n      for (const h of this.wildcardHandlers.delete) h(table, keys)\n    }\n\n    // onAny handlers\n    for (const h of this.anyHandlers) {\n      h(table, event, keys, newValues, oldValues)\n    }\n  }\n}\n\n// Re-export for convenience\nexport type {\n  ColumnInfo, TableInfo, PD4Row, Row, FetchOptions, FetchResult, InsertResult,\n  WildcardInsertHandler, WildcardUpdateHandler, WildcardDeleteHandler, AnyEventHandler,\n}\n","import { useEffect, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { InsertHandler, UpdateHandler, DeleteHandler } from '../types'\n\n/**\n * Subscribe to SSE events for a table. Auto-cleans up on unmount.\n *\n * Usage:\n *   usePD4Subscribe('metrics', 'insert', (keys, rows) => { ... })\n *   usePD4Subscribe('metrics', 'update', (keys, newVals, oldVals) => { ... })\n *   usePD4Subscribe('metrics', 'delete', (keys) => { ... })\n */\nexport function usePD4Subscribe(table: string, event: 'insert', handler: InsertHandler): void\nexport function usePD4Subscribe(table: string, event: 'update', handler: UpdateHandler): void\nexport function usePD4Subscribe(table: string, event: 'delete', handler: DeleteHandler): void\nexport function usePD4Subscribe(\n  table: string,\n  event: 'insert' | 'update' | 'delete',\n  handler: InsertHandler | UpdateHandler | DeleteHandler,\n): void {\n  const db = usePD4()\n  const handlerRef = useRef(handler)\n  handlerRef.current = handler\n\n  useEffect(() => {\n    const wrapper = (...args: unknown[]) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(handlerRef.current as any)(...args)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return db.on(table, event as any, wrapper as any)\n  }, [db, table, event])\n}\n","import { useState, useEffect, useCallback, useRef } from 'react'\nimport { usePD4 } from './context'\nimport type { Row, ColumnInfo, ConnectionStatus } from '../types'\n\nconst HIGHLIGHT_MS = 1500\n\nexport interface UsePD4TableOptions {\n  limit?: number\n  deleteDelay?: number\n}\n\nexport interface UsePD4TableResult {\n  rows: Row[]\n  total: number\n  columns: ColumnInfo[]\n  status: ConnectionStatus\n  highlights: Record<number, string>\n}\n\n/**\n * Full table state management hook.\n * Handles: initial fetch, SSE subscriptions for insert/update/delete,\n * row state management, highlight tracking, and buffer-commit edge cases.\n */\nexport function usePD4Table(\n  table: string,\n  opts?: UsePD4TableOptions,\n): UsePD4TableResult {\n  const db = usePD4()\n  const limit = opts?.limit ?? 1000\n  const deleteDelay = opts?.deleteDelay ?? HIGHLIGHT_MS\n\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [columns, setColumns] = useState<ColumnInfo[]>([])\n  const [status, setStatus] = useState<ConnectionStatus>('connecting')\n  const [highlights, setHighlights] = useState<Record<number, string>>({})\n\n  // Refs for stable callback access\n  const tableRef = useRef(table)\n  tableRef.current = table\n\n  const highlightKeys = useCallback((keys: number[], type: string) => {\n    if (keys.length === 0) return\n    setHighlights((prev) => {\n      const next = { ...prev }\n      for (const k of keys) next[k] = type\n      return next\n    })\n    setTimeout(() => {\n      setHighlights((prev) => {\n        const next = { ...prev }\n        for (const k of keys) {\n          if (next[k] === type) delete next[k]\n        }\n        return next\n      })\n    }, HIGHLIGHT_MS)\n  }, [])\n\n  const fetchRows = useCallback(async () => {\n    try {\n      const { rows: fetched, total: t } = await db.fetch(tableRef.current, { offset: 0, limit })\n      setRows(fetched)\n      setTotal(t)\n    } catch {\n      // Non-fatal\n    }\n  }, [db, limit])\n\n  useEffect(() => {\n    let cancelled = false\n    const unsubs: (() => void)[] = []\n\n    ;(async () => {\n      try {\n        // 1. Get column info\n        const info = await db.getTable(table)\n        if (cancelled) return\n        setColumns(info.columns.filter((c) => c.name !== '_pk'))\n\n        // 2. Fetch initial rows\n        await fetchRows()\n        if (cancelled) return\n        setStatus('connected')\n\n        // 3. SSE subscriptions\n        unsubs.push(db.on(table, 'insert', (keys, newValues) => {\n          if (cancelled) return\n          const newRows = keys.map((k, i) => ({ _pk: k, ...newValues[i] }))\n          setRows((prev) => [...prev, ...newRows])\n          setTotal((prev) => prev + newRows.length)\n          highlightKeys(keys, 'insert')\n        }))\n\n        unsubs.push(db.on(table, 'update', (keys, newValues) => {\n          if (cancelled) return\n\n          // Buffer commits send raw scalar values, not flat objects — fall back to refetch\n          if (\n            newValues.length === 0 ||\n            typeof newValues[0] !== 'object' ||\n            newValues[0] === null\n          ) {\n            fetchRows()\n            highlightKeys(keys, 'update')\n            return\n          }\n\n          const updateMap = new Map(keys.map((k, i) => [k, newValues[i]]))\n          setRows((prev) =>\n            prev.map((row) => {\n              const changes = updateMap.get(row._pk as number)\n              if (!changes) return row\n              return { ...row, ...changes }\n            }),\n          )\n          highlightKeys(keys, 'update')\n        }))\n\n        unsubs.push(db.on(table, 'delete', (keys) => {\n          if (cancelled) return\n          const keySet = new Set(keys)\n          highlightKeys(keys, 'delete')\n          setTimeout(() => {\n            setRows((prev) => prev.filter((row) => !keySet.has(row._pk as number)))\n            setTotal((prev) => Math.max(0, prev - keys.length))\n          }, deleteDelay)\n        }))\n      } catch {\n        if (!cancelled) {\n          setStatus('error')\n        }\n      }\n    })()\n\n    return () => {\n      cancelled = true\n      for (const unsub of unsubs) unsub()\n    }\n  }, [db, table, limit, fetchRows, highlightKeys, deleteDelay])\n\n  return { rows, total, columns, status, highlights }\n}\n","import { useState, useEffect } from 'react'\nimport { usePD4 } from './context'\nimport type { Row } from '../types'\n\nexport interface UsePD4QueryResult {\n  rows: Row[]\n  total: number\n  loading: boolean\n  error: string | null\n  refetch: () => void\n}\n\n/**\n * One-shot query hook. Fetches rows from a table once (or on refetch).\n */\nexport function usePD4Query(\n  table: string,\n  offset = 0,\n  limit = 1000,\n): UsePD4QueryResult {\n  const db = usePD4()\n  const [rows, setRows] = useState<Row[]>([])\n  const [total, setTotal] = useState(0)\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState<string | null>(null)\n  const [attempt, setAttempt] = useState(0)\n\n  useEffect(() => {\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n\n    db.fetch(table, { offset, limit })\n      .then((result) => {\n        if (cancelled) return\n        setRows(result.rows)\n        setTotal(result.total)\n        setLoading(false)\n      })\n      .catch((err) => {\n        if (cancelled) return\n        setError(err instanceof Error ? err.message : 'Query failed')\n        setLoading(false)\n      })\n\n    return () => { cancelled = true }\n  }, [db, table, offset, limit, attempt])\n\n  return {\n    rows,\n    total,\n    loading,\n    error,\n    refetch: () => setAttempt((a) => a + 1),\n  }\n}\n"],"mappings":";AAAA,SAAS,eAAe,YAAY,cAAc;;;ACC3C,IAAM,WAAN,cAAuB,MAAM;AAAA,EAIlC,YAAY,SAAiB,QAAiB,KAAc;AAC1D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,MAAM;AAAA,EACb;AACF;;;ACRO,SAAS,WAAW,KAAkB;AAC3C,QAAM,OAAY,EAAE,KAAK,IAAI,IAAI;AACjC,aAAW,MAAM,IAAI,QAAQ;AAC3B,SAAK,GAAG,MAAM,IAAI,GAAG;AAAA,EACvB;AACA,SAAO;AACT;AAMO,SAAS,WACd,UACA,aACqE;AACrE,MAAI,SAAS,WAAW,EAAG,QAAO,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,EAAE;AAC1D,QAAM,OAAO,eAAe,OAAO,KAAK,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,MAAM,KAAK;AAC9E,QAAM,OAAO,SAAS,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC;AAClE,SAAO,EAAE,SAAS,MAAM,KAAK;AAC/B;AAMO,SAAS,eACd,MAC+D;AAC/D,SAAO,OAAO,QAAQ,IAAI,EACvB,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,KAAK,EAC3B,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE,QAAQ,MAAM,EAAE;AACjD;;;AC1BO,IAAM,YAAN,MAAgB;AAAA,EAKrB,YAAY,QAAmB,QAAgB,OAAe;AAC5D,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA,EAGA,MAAM,OAAO,KAAa,QAA4B;AACpD,UAAM,QAAQ,eAAe,MAAM;AACnC,UAAM,KAAK,SAAS,SAAS,KAAK,MAAM,gBAAgB;AAAA,MACtD,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,KAAK,QAAQ,MAAM,CAAC;AAAA,IAC7C,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAM,SAAS,GAAG,QAAQ,KAA2B;AACzD,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,SAAS,KAAK,MAAM,gBAAgB,MAAM,UAAU,KAAK;AAAA,IAC3D;AACA,WAAO;AAAA,MACL,MAAM,KAAK,KAAK,IAAI,UAAU;AAAA,MAC9B,OAAO,KAAK;AAAA,IACd;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,SAAwB;AAC5B,UAAM,KAAK,SAAS,SAAS,KAAK,MAAM,WAAW,EAAE,QAAQ,OAAO,CAAC;AAAA,EACvE;AAAA;AAAA,EAGA,MAAM,WAA0B;AAC9B,UAAM,KAAK,SAAS,SAAS,KAAK,MAAM,aAAa,EAAE,QAAQ,OAAO,CAAC;AAAA,EACzE;AAAA;AAAA,EAIA,MAAc,SAAY,MAAc,MAAgC;AACtE,UAAM,MAAM,GAAG,KAAK,OAAO,GAAG,OAAO,KAAK,OAAO,EAAE,IAAI,IAAI;AAC3D,UAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC3B,GAAG;AAAA,MACH,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,MAAM,QAAQ;AAAA,IAClE,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAM,IAAI,MAAM,cAAc,MAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,MAAM,IAAI,IAAI,EAAE;AAAA,IACrF;AACA,QAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,WAAO,IAAI,KAAK;AAAA,EAClB;AACF;;;ACtBO,IAAM,YAAN,MAAgB;AAAA,EAYrB,YAAY,KAAa,IAAY,SAA4B;AAPjE,SAAQ,cAAkC;AAC1C,SAAQ,WAAW,oBAAI,IAA2B;AAClD,SAAQ,mBAAqC,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE;AAClF,SAAQ,cAAiC,CAAC;AAC1C,SAAQ,iBAAkC,CAAC;AAC3C,SAAQ,UAA4B;AAGlC,SAAK,MAAM,IAAI,QAAQ,OAAO,EAAE;AAChC,SAAK,KAAK;AACV,SAAK,kBAAkB,SAAS,gBAC1B,OAAO,eAAe,eAAe,WAAW,cAChD,WAAW,cACX;AAAA,EACR;AAAA;AAAA,EAIA,IAAY,KAAK;AACf,WAAO,GAAG,KAAK,GAAG,OAAO,KAAK,EAAE;AAAA,EAClC;AAAA,EAEA,IAAY,MAAM;AAChB,WAAO,GAAG,KAAK,GAAG,QAAQ,KAAK,EAAE;AAAA,EACnC;AAAA;AAAA,EAIA,MAAc,QAAW,KAAa,MAAgC;AACpE,UAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC3B,GAAG;AAAA,MACH,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,MAAM,QAAQ;AAAA,IAClE,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAM,IAAI;AAAA,QACR,OAAO,MAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,MAAM,IAAI,IAAI;AAAA,QAC1D,IAAI;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AACA,QAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,WAAO,IAAI,KAAK;AAAA,EAClB;AAAA;AAAA;AAAA,EAKA,MAAM,OAAyB;AAC7B,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,SAAS;AAC5C,aAAO,IAAI;AAAA,IACb,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,MAAM,iBAAgC;AACpC,UAAM,KAAK,QAAQ,GAAG,KAAK,GAAG,UAAU;AAAA,MACtC,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,KAAK,GAAG,CAAC;AAAA,IACxC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA,EAKA,MAAM,aAAgC;AACpC,UAAM,OAAO,MAAM,KAAK,QAA8B,GAAG,KAAK,EAAE,SAAS;AACzE,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,SAAS,MAAkC;AAC/C,WAAO,KAAK,QAAmB,GAAG,KAAK,EAAE,WAAW,IAAI,EAAE;AAAA,EAC5D;AAAA;AAAA,EAGA,MAAM,YAAY,MAA6B;AAC7C,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,WAAW;AAAA,MACtC,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,SAAS,KAAK,CAAC;AAAA,IAC9C,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,UAAU,MAA6B;AAC3C,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,QAAQ,SAAS,CAAC;AAAA,EACtE;AAAA;AAAA,EAGA,MAAM,UAAU,OAAe,MAAc,OAA8B;AACzE,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,WAAW,KAAK,YAAY;AAAA,MACvD,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAAA,IACtC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAe,MAA0C;AACpE,UAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,UAAM,EAAE,SAAS,MAAM,QAAQ,IAAI,WAAW,GAAG;AACjD,WAAO,KAAK,QAAsB,GAAG,KAAK,EAAE,WAAW,KAAK,SAAS;AAAA,MACnE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,SAAS,MAAM,QAAQ,CAAC;AAAA,IACjD,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,OAAO,OAAe,KAAa,QAA4B;AACnE,UAAM,QAAQ,eAAe,MAAM;AACnC,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB;AAAA,MAC1D,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,KAAK,QAAQ,MAAM,CAAC;AAAA,IAC7C,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,OAAO,OAAe,MAAwC;AAClE,UAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB;AAAA,MAC1D,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,MAAM,IAAI,CAAC;AAAA,IACpC,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAM,OAAe,MAA2C;AACpE,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,QAAQ,MAAM,SAAS;AAC7B,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB,MAAM,UAAU,KAAK;AAAA,IAChE;AACA,WAAO;AAAA,MACL,MAAM,KAAK,KAAK,IAAI,UAAU;AAAA,MAC9B,OAAO,KAAK;AAAA,IACd;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,MAAM,eACJ,OACA,SACA,MACuB;AACvB,WAAO,KAAK,QAAsB,GAAG,KAAK,EAAE,WAAW,KAAK,SAAS;AAAA,MACnE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,SAAS,KAAK,CAAC;AAAA,IACxC,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,UACJ,OACA,KACA,QACe;AACf,UAAM,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB;AAAA,MAC1D,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,EAAE,KAAK,OAAO,CAAC;AAAA,IACtC,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,SACJ,OACA,SAAS,GACT,QAAQ,KACoC;AAC5C,WAAO,KAAK,QAAQ,GAAG,KAAK,EAAE,UAAU,KAAK,gBAAgB,MAAM,UAAU,KAAK,EAAE;AAAA,EACtF;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAmC;AAC9C,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,GAAG,KAAK,EAAE,UAAU,KAAK;AAAA,MACzB,EAAE,QAAQ,OAAO;AAAA,IACnB;AACA,WAAO,IAAI,UAAU,MAAM,KAAK,QAAQ,KAAK;AAAA,EAC/C;AAAA;AAAA;AAAA,EAKA,IAAI,SAA2B;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,UAAgB;AACd,QAAI,KAAK,YAAa;AACtB,QAAI,CAAC,KAAK,iBAAiB;AACzB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,SAAK,WAAW,YAAY;AAC5B,UAAM,MAAM,IAAI,KAAK,gBAAgB,GAAG,KAAK,GAAG,SAAS;AACzD,SAAK,cAAc;AAEnB,QAAI,iBAAiB,WAAW,MAAM;AACpC,WAAK,WAAW,WAAW;AAAA,IAC7B,CAAC;AAED,QAAI,iBAAiB,UAAU,CAAC,MAAoB;AAClD,YAAM,OAAO,KAAK,MAAM,EAAE,IAAI;AAC9B,YAAM,QAAQ,KAAK;AACnB,YAAM,OAAiB,KAAK,QAAQ,CAAC;AACrC,YAAM,YAAmB,KAAK,cAAc,CAAC;AAC7C,WAAK,UAAU,OAAO,UAAU,MAAM,WAAW,CAAC,CAAC;AAAA,IACrD,CAAC;AAED,QAAI,iBAAiB,UAAU,CAAC,MAAoB;AAClD,YAAM,OAAO,KAAK,MAAM,EAAE,IAAI;AAC9B,YAAM,QAAQ,KAAK;AACnB,YAAM,OAAiB,KAAK,QAAQ,CAAC;AACrC,YAAM,YAAmB,KAAK,cAAc,CAAC;AAC7C,YAAM,YAAmB,KAAK,cAAc,CAAC;AAC7C,WAAK,UAAU,OAAO,UAAU,MAAM,WAAW,SAAS;AAAA,IAC5D,CAAC;AAED,QAAI,iBAAiB,UAAU,CAAC,MAAoB;AAClD,YAAM,OAAO,KAAK,MAAM,EAAE,IAAI;AAC9B,YAAM,QAAQ,KAAK;AACnB,YAAM,OAAiB,KAAK,QAAQ,CAAC;AACrC,WAAK,UAAU,OAAO,UAAU,MAAM,CAAC,GAAG,CAAC,CAAC;AAAA,IAC9C,CAAC;AAED,QAAI,UAAU,MAAM;AAClB,WAAK,WAAW,OAAO;AAAA,IACzB;AAAA,EACF;AAAA;AAAA,EAGA,aAAmB;AACjB,SAAK,aAAa,MAAM;AACxB,SAAK,cAAc;AACnB,SAAK,WAAW,YAAY;AAAA,EAC9B;AAAA,EAeA,GACE,OACA,OACA,SAGY;AAEZ,QAAI,CAAC,KAAK,YAAa,MAAK,QAAQ;AAGpC,QAAI,UAAU,KAAK;AACjB,YAAMA,QAAO,KAAK,iBAAiB,KAAK;AACxC,MAAAA,MAAK,KAAK,OAAO;AACjB,aAAO,MAAM;AACX,cAAM,MAAMA,MAAK,QAAQ,OAAO;AAChC,YAAI,OAAO,EAAG,CAAAA,MAAK,OAAO,KAAK,CAAC;AAAA,MAClC;AAAA,IACF;AAGA,QAAI,gBAAgB,KAAK,SAAS,IAAI,KAAK;AAC3C,QAAI,CAAC,eAAe;AAClB,sBAAgB,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE;AACrD,WAAK,SAAS,IAAI,OAAO,aAAa;AAAA,IACxC;AAEA,UAAM,OAAO,cAAc,KAAK;AAChC,SAAK,KAAK,OAAO;AAEjB,WAAO,MAAM;AACX,YAAM,MAAM,KAAK,QAAQ,OAAO;AAChC,UAAI,OAAO,EAAG,MAAK,OAAO,KAAK,CAAC;AAAA,IAClC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAsC;AAC1C,QAAI,CAAC,KAAK,YAAa,MAAK,QAAQ;AAEpC,SAAK,YAAY,KAAK,OAAO;AAC7B,WAAO,MAAM;AACX,YAAM,MAAM,KAAK,YAAY,QAAQ,OAAO;AAC5C,UAAI,OAAO,EAAG,MAAK,YAAY,OAAO,KAAK,CAAC;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA,EAGA,SAAS,SAAoC;AAC3C,SAAK,eAAe,KAAK,OAAO;AAChC,WAAO,MAAM;AACX,YAAM,MAAM,KAAK,eAAe,QAAQ,OAAO;AAC/C,UAAI,OAAO,EAAG,MAAK,eAAe,OAAO,KAAK,CAAC;AAAA,IACjD;AAAA,EACF;AAAA;AAAA,EAIQ,WAAW,QAA0B;AAC3C,SAAK,UAAU;AACf,eAAW,WAAW,KAAK,gBAAgB;AACzC,cAAQ,MAAM;AAAA,IAChB;AAAA,EACF;AAAA,EAEQ,UACN,OACA,OACA,MACA,WACA,WACA;AAEA,UAAM,gBAAgB,KAAK,SAAS,IAAI,KAAK;AAC7C,QAAI,eAAe;AACjB,UAAI,UAAU,UAAU;AACtB,mBAAW,KAAK,cAAc,OAAQ,GAAE,MAAM,SAAS;AAAA,MACzD,WAAW,UAAU,UAAU;AAC7B,mBAAW,KAAK,cAAc,OAAQ,GAAE,MAAM,WAAW,SAAS;AAAA,MACpE,OAAO;AACL,mBAAW,KAAK,cAAc,OAAQ,GAAE,IAAI;AAAA,MAC9C;AAAA,IACF;AAGA,QAAI,UAAU,UAAU;AACtB,iBAAW,KAAK,KAAK,iBAAiB,OAAQ,GAAE,OAAO,MAAM,SAAS;AAAA,IACxE,WAAW,UAAU,UAAU;AAC7B,iBAAW,KAAK,KAAK,iBAAiB,OAAQ,GAAE,OAAO,MAAM,WAAW,SAAS;AAAA,IACnF,OAAO;AACL,iBAAW,KAAK,KAAK,iBAAiB,OAAQ,GAAE,OAAO,IAAI;AAAA,IAC7D;AAGA,eAAW,KAAK,KAAK,aAAa;AAChC,QAAE,OAAO,OAAO,MAAM,WAAW,SAAS;AAAA,IAC5C;AAAA,EACF;AACF;;;AJ7YS;AAbT,IAAM,aAAa,cAAgC,IAAI;AAQhD,SAAS,YAAY,EAAE,KAAK,IAAI,SAAS,GAAqB;AACnE,QAAM,YAAY,OAAyB,IAAI;AAC/C,MAAI,CAAC,UAAU,SAAS;AACtB,cAAU,UAAU,IAAI,UAAU,KAAK,EAAE;AAAA,EAC3C;AACA,SAAO,oBAAC,WAAW,UAAX,EAAoB,OAAO,UAAU,SAAU,UAAS;AAClE;AAEO,SAAS,SAAoB;AAClC,QAAM,SAAS,WAAW,UAAU;AACpC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,SAAO;AACT;;;AKzBA,SAAS,WAAW,UAAAC,eAAc;AAe3B,SAAS,gBACd,OACA,OACA,SACM;AACN,QAAM,KAAK,OAAO;AAClB,QAAM,aAAaC,QAAO,OAAO;AACjC,aAAW,UAAU;AAErB,YAAU,MAAM;AACd,UAAM,UAAU,IAAI,SAAoB;AAEtC;AAAC,MAAC,WAAW,QAAgB,GAAG,IAAI;AAAA,IACtC;AAEA,WAAO,GAAG,GAAG,OAAO,OAAc,OAAc;AAAA,EAClD,GAAG,CAAC,IAAI,OAAO,KAAK,CAAC;AACvB;;;AChCA,SAAS,UAAU,aAAAC,YAAW,aAAa,UAAAC,eAAc;AAIzD,IAAM,eAAe;AAoBd,SAAS,YACd,OACA,MACmB;AACnB,QAAM,KAAK,OAAO;AAClB,QAAM,QAAQ,MAAM,SAAS;AAC7B,QAAM,cAAc,MAAM,eAAe;AAEzC,QAAM,CAAC,MAAM,OAAO,IAAI,SAAgB,CAAC,CAAC;AAC1C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,CAAC;AACpC,QAAM,CAAC,SAAS,UAAU,IAAI,SAAuB,CAAC,CAAC;AACvD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAA2B,YAAY;AACnE,QAAM,CAAC,YAAY,aAAa,IAAI,SAAiC,CAAC,CAAC;AAGvE,QAAM,WAAWC,QAAO,KAAK;AAC7B,WAAS,UAAU;AAEnB,QAAM,gBAAgB,YAAY,CAAC,MAAgB,SAAiB;AAClE,QAAI,KAAK,WAAW,EAAG;AACvB,kBAAc,CAAC,SAAS;AACtB,YAAM,OAAO,EAAE,GAAG,KAAK;AACvB,iBAAW,KAAK,KAAM,MAAK,CAAC,IAAI;AAChC,aAAO;AAAA,IACT,CAAC;AACD,eAAW,MAAM;AACf,oBAAc,CAAC,SAAS;AACtB,cAAM,OAAO,EAAE,GAAG,KAAK;AACvB,mBAAW,KAAK,MAAM;AACpB,cAAI,KAAK,CAAC,MAAM,KAAM,QAAO,KAAK,CAAC;AAAA,QACrC;AACA,eAAO;AAAA,MACT,CAAC;AAAA,IACH,GAAG,YAAY;AAAA,EACjB,GAAG,CAAC,CAAC;AAEL,QAAM,YAAY,YAAY,YAAY;AACxC,QAAI;AACF,YAAM,EAAE,MAAM,SAAS,OAAO,EAAE,IAAI,MAAM,GAAG,MAAM,SAAS,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAC;AACzF,cAAQ,OAAO;AACf,eAAS,CAAC;AAAA,IACZ,QAAQ;AAAA,IAER;AAAA,EACF,GAAG,CAAC,IAAI,KAAK,CAAC;AAEd,EAAAC,WAAU,MAAM;AACd,QAAI,YAAY;AAChB,UAAM,SAAyB,CAAC;AAE/B,KAAC,YAAY;AACZ,UAAI;AAEF,cAAM,OAAO,MAAM,GAAG,SAAS,KAAK;AACpC,YAAI,UAAW;AACf,mBAAW,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC;AAGvD,cAAM,UAAU;AAChB,YAAI,UAAW;AACf,kBAAU,WAAW;AAGrB,eAAO,KAAK,GAAG,GAAG,OAAO,UAAU,CAAC,MAAM,cAAc;AACtD,cAAI,UAAW;AACf,gBAAM,UAAU,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,KAAK,GAAG,GAAG,UAAU,CAAC,EAAE,EAAE;AAChE,kBAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC;AACvC,mBAAS,CAAC,SAAS,OAAO,QAAQ,MAAM;AACxC,wBAAc,MAAM,QAAQ;AAAA,QAC9B,CAAC,CAAC;AAEF,eAAO,KAAK,GAAG,GAAG,OAAO,UAAU,CAAC,MAAM,cAAc;AACtD,cAAI,UAAW;AAGf,cACE,UAAU,WAAW,KACrB,OAAO,UAAU,CAAC,MAAM,YACxB,UAAU,CAAC,MAAM,MACjB;AACA,sBAAU;AACV,0BAAc,MAAM,QAAQ;AAC5B;AAAA,UACF;AAEA,gBAAM,YAAY,IAAI,IAAI,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAC/D;AAAA,YAAQ,CAAC,SACP,KAAK,IAAI,CAAC,QAAQ;AAChB,oBAAM,UAAU,UAAU,IAAI,IAAI,GAAa;AAC/C,kBAAI,CAAC,QAAS,QAAO;AACrB,qBAAO,EAAE,GAAG,KAAK,GAAG,QAAQ;AAAA,YAC9B,CAAC;AAAA,UACH;AACA,wBAAc,MAAM,QAAQ;AAAA,QAC9B,CAAC,CAAC;AAEF,eAAO,KAAK,GAAG,GAAG,OAAO,UAAU,CAAC,SAAS;AAC3C,cAAI,UAAW;AACf,gBAAM,SAAS,IAAI,IAAI,IAAI;AAC3B,wBAAc,MAAM,QAAQ;AAC5B,qBAAW,MAAM;AACf,oBAAQ,CAAC,SAAS,KAAK,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,GAAa,CAAC,CAAC;AACtE,qBAAS,CAAC,SAAS,KAAK,IAAI,GAAG,OAAO,KAAK,MAAM,CAAC;AAAA,UACpD,GAAG,WAAW;AAAA,QAChB,CAAC,CAAC;AAAA,MACJ,QAAQ;AACN,YAAI,CAAC,WAAW;AACd,oBAAU,OAAO;AAAA,QACnB;AAAA,MACF;AAAA,IACF,GAAG;AAEH,WAAO,MAAM;AACX,kBAAY;AACZ,iBAAW,SAAS,OAAQ,OAAM;AAAA,IACpC;AAAA,EACF,GAAG,CAAC,IAAI,OAAO,OAAO,WAAW,eAAe,WAAW,CAAC;AAE5D,SAAO,EAAE,MAAM,OAAO,SAAS,QAAQ,WAAW;AACpD;;;AC/IA,SAAS,YAAAC,WAAU,aAAAC,kBAAiB;AAe7B,SAAS,YACd,OACA,SAAS,GACT,QAAQ,KACW;AACnB,QAAM,KAAK,OAAO;AAClB,QAAM,CAAC,MAAM,OAAO,IAAIC,UAAgB,CAAC,CAAC;AAC1C,QAAM,CAAC,OAAO,QAAQ,IAAIA,UAAS,CAAC;AACpC,QAAM,CAAC,SAAS,UAAU,IAAIA,UAAS,IAAI;AAC3C,QAAM,CAAC,OAAO,QAAQ,IAAIA,UAAwB,IAAI;AACtD,QAAM,CAAC,SAAS,UAAU,IAAIA,UAAS,CAAC;AAExC,EAAAC,WAAU,MAAM;AACd,QAAI,YAAY;AAChB,eAAW,IAAI;AACf,aAAS,IAAI;AAEb,OAAG,MAAM,OAAO,EAAE,QAAQ,MAAM,CAAC,EAC9B,KAAK,CAAC,WAAW;AAChB,UAAI,UAAW;AACf,cAAQ,OAAO,IAAI;AACnB,eAAS,OAAO,KAAK;AACrB,iBAAW,KAAK;AAAA,IAClB,CAAC,EACA,MAAM,CAAC,QAAQ;AACd,UAAI,UAAW;AACf,eAAS,eAAe,QAAQ,IAAI,UAAU,cAAc;AAC5D,iBAAW,KAAK;AAAA,IAClB,CAAC;AAEH,WAAO,MAAM;AAAE,kBAAY;AAAA,IAAK;AAAA,EAClC,GAAG,CAAC,IAAI,OAAO,QAAQ,OAAO,OAAO,CAAC;AAEtC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,MAAM,WAAW,CAAC,MAAM,IAAI,CAAC;AAAA,EACxC;AACF;","names":["list","useRef","useRef","useEffect","useRef","useRef","useEffect","useState","useEffect","useState","useEffect"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerdata/pd4",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "JavaScript client library for PD4 — REST, SSE, and React hooks",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -18,7 +18,9 @@
       "require": "./dist/react/index.cjs"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch"
@@ -27,7 +29,9 @@
     "react": ">=18"
   },
   "peerDependenciesMeta": {
-    "react": { "optional": true }
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "react": "^18.2.0",