@visorcraft/mongreldb 0.20.0 → 0.21.0

package/README.md

@@ -29,6 +29,13 @@ class Database {
   createTable(name: string, schema: SchemaSpec): bigint
   table(name: string): TableHandle
   begin(): Transaction
+  createProcedure(spec: ProcedureSpec): bigint
+  createOrReplaceProcedure(spec: ProcedureSpec): bigint
+  dropProcedure(name: string): void
+  procedures(): ProcedureInfo[]
+  procedure(name: string): ProcedureInfo | null
+  callProcedure(name: string, opts?: ProcedureCallOptions): ProcedureCallResult
+  callProcedureAsync(name: string, opts?: ProcedureCallOptions): Promise<ProcedureCallResult>
   sql(sql: string): Promise<Buffer>
   close(): void
 }

package/native.d.ts

@@ -53,10 +53,31 @@ export interface IndexSpec {
   columnId: number
   kind: IndexKindSpec
 }
+/** Result of a `compactAll` operation. */
+export interface CompactStats {
+  /** Number of tables that were merged into a single run. */
+  compacted: number
+  /** Number of tables skipped (fewer than 2 runs, or compaction failed). */
+  skipped: number
+}
 export interface SchemaSpec {
   columns: Array<ColumnSpec>
   indexes: Array<IndexSpec>
 }
+export interface ProcedureSpec {
+  json: string
+}
+export interface ProcedureInfo {
+  json: string
+}
+export interface ProcedureCallOptions {
+  argsJson?: string
+  idempotencyKey?: string
+}
+export interface ProcedureCallResult {
+  epoch?: bigint
+  resultJson: string
+}
 /**
  * A single cell value. Only the field matching the column type is read; the
  * rest are ignored. `bytes` is raw; `text` is UTF-8 (use for `Bytes` columns
@@ -191,6 +212,13 @@ export declare class Database {
   snapshotEpoch(): bigint
   /** List all live table names. */
   tableNames(): Array<string>
+  createProcedure(spec: ProcedureSpec): bigint
+  createOrReplaceProcedure(spec: ProcedureSpec): bigint
+  dropProcedure(name: string): void
+  procedures(): Array<ProcedureInfo>
+  procedure(name: string): ProcedureInfo | null
+  callProcedure(name: string, opts?: ProcedureCallOptions | undefined | null): ProcedureCallResult
+  callProcedureAsync(name: string, opts?: ProcedureCallOptions | undefined | null): Promise<ProcedureCallResult>
   /**
    * Return the column names of a table as it exists in the **database**
    * (not the code-defined schema). Lets migrations check whether a column
@@ -212,6 +240,16 @@ export declare class Database {
   check(): string
   /** Repair/quarantine corrupt tables. Returns a JSON-string summary. */
   doctor(): string
+  /**
+   * Compact every table: merge sorted runs into one clean run each so
+   * query latency stays flat. Tables with fewer than two runs are skipped.
+   */
+  compactAll(): CompactStats
+  /**
+   * Compact a single table by name. Returns `true` if compacted, `false`
+   * if skipped (fewer than two runs).
+   */
+  compactTable(name: string): boolean
   /** Return the path passed to `withPath` / `open`. */
   directory(): string
   /** Run a cross-table SQL query. Returns Arrow IPC bytes. */
@@ -423,4 +461,7 @@ export declare class RemoteDatabase {
   count(table: string): number
   sql(sql: string): Buffer
   commit(table: string): bigint
+  createProcedure(spec: ProcedureSpec): string
+  dropProcedure(name: string): void
+  callProcedure(name: string, opts?: ProcedureCallOptions | undefined | null): string
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visorcraft/mongreldb",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "High-performance Node.js bindings for MongrelDB with native in-process storage, sub-ms writes, and hybrid indexing.",
   "main": "index.js",
   "types": "index.d.ts",