@orkestrel/database 0.0.18 → 0.0.19

package/dist/src/server/index.d.cts

@@ -6,6 +6,7 @@ import type { DriverInterface } from '@orkestrel/database';
 import type { DriverMetadata } from '@orkestrel/database';
 import type { FieldPath } from '@orkestrel/contract';
 import type { Key } from '@orkestrel/database';
+import type { MemoryDriver } from '@orkestrel/database';
 import type { MigrationInput } from '@orkestrel/database';
 import type { MigrationStep } from '@orkestrel/database';
 import type { OperationOptions } from '@orkestrel/database';
@@ -26,6 +27,17 @@ import type { TableSchema } from '@orkestrel/database';
  */
 export declare function compileAggregateSQL(operation: AggregateOperation, column: FieldPath): string;
 
+/**
+ * Encodes condition operands for a SQL fragment using their declared or inferred storage.
+ *
+ * @example
+ * ```ts
+ * compileBoundSQL('"age" > ?', [18], false, undefined)
+ * // { sql: '"age" > ?', parameters: ['18'] }
+ * ```
+ */
+export declare function compileBoundSQL(sql: string, values: readonly unknown[], nested: boolean, declared: ColumnSchema | undefined): CompiledSQL;
+
 /**
  * Maps a portable {@link ColumnStorage} to its SQLite column type.
  *
@@ -621,6 +633,26 @@ export declare class JSONDriver implements DriverInterface {
     migrate(input: MigrationInput): Promise<void>;
 }
 
+/**
+ * Owns the isolated memory store and schema of one JSON transaction.
+ *
+ * @example
+ * ```ts
+ * const transaction = new JSONTransaction(new MemoryDriver(), [], new Map())
+ * transaction.stop()
+ * // transaction.memory throws CONFLICT after settlement.
+ * ```
+ */
+export declare class JSONTransaction {
+    #private;
+    constructor(memory: MemoryDriver, schema: readonly TableSchema[], identities: ReadonlyMap<string, object>);
+    get memory(): MemoryDriver;
+    get schema(): readonly TableSchema[];
+    get identities(): ReadonlyMap<string, object>;
+    project(schema: readonly TableSchema[], identities: ReadonlyMap<string, object>): void;
+    stop(): void;
+}
+
 /**
  * Reports whether a caught filesystem error says that nothing is there to read.
  *
@@ -955,6 +987,23 @@ export declare interface SQLiteDriverOptions {
     readonly pragmas?: Readonly<Record<string, string | number>>;
 }
 
+/**
+ * Owns the candidate schema and table identities of one SQLite transaction.
+ *
+ * @example
+ * ```ts
+ * const transaction = new SQLiteTransaction(new Map(), new Map())
+ * transaction.schema.size // 0
+ * ```
+ */
+export declare class SQLiteTransaction {
+    #private;
+    constructor(schema: ReadonlyMap<string, TableSchema>, identities: ReadonlyMap<string, object>);
+    get schema(): ReadonlyMap<string, TableSchema>;
+    get identities(): ReadonlyMap<string, object>;
+    project(schema: readonly TableSchema[], identities: ReadonlyMap<string, object>): void;
+}
+
 /**
  * Projects one {@link MigrationStep} to SQLite DDL.
  *

package/dist/src/server/index.d.ts

@@ -6,6 +6,7 @@ import type { DriverInterface } from '@orkestrel/database';
 import type { DriverMetadata } from '@orkestrel/database';
 import type { FieldPath } from '@orkestrel/contract';
 import type { Key } from '@orkestrel/database';
+import type { MemoryDriver } from '@orkestrel/database';
 import type { MigrationInput } from '@orkestrel/database';
 import type { MigrationStep } from '@orkestrel/database';
 import type { OperationOptions } from '@orkestrel/database';
@@ -26,6 +27,17 @@ import type { TableSchema } from '@orkestrel/database';
  */
 export declare function compileAggregateSQL(operation: AggregateOperation, column: FieldPath): string;
 
+/**
+ * Encodes condition operands for a SQL fragment using their declared or inferred storage.
+ *
+ * @example
+ * ```ts
+ * compileBoundSQL('"age" > ?', [18], false, undefined)
+ * // { sql: '"age" > ?', parameters: ['18'] }
+ * ```
+ */
+export declare function compileBoundSQL(sql: string, values: readonly unknown[], nested: boolean, declared: ColumnSchema | undefined): CompiledSQL;
+
 /**
  * Maps a portable {@link ColumnStorage} to its SQLite column type.
  *
@@ -621,6 +633,26 @@ export declare class JSONDriver implements DriverInterface {
     migrate(input: MigrationInput): Promise<void>;
 }
 
+/**
+ * Owns the isolated memory store and schema of one JSON transaction.
+ *
+ * @example
+ * ```ts
+ * const transaction = new JSONTransaction(new MemoryDriver(), [], new Map())
+ * transaction.stop()
+ * // transaction.memory throws CONFLICT after settlement.
+ * ```
+ */
+export declare class JSONTransaction {
+    #private;
+    constructor(memory: MemoryDriver, schema: readonly TableSchema[], identities: ReadonlyMap<string, object>);
+    get memory(): MemoryDriver;
+    get schema(): readonly TableSchema[];
+    get identities(): ReadonlyMap<string, object>;
+    project(schema: readonly TableSchema[], identities: ReadonlyMap<string, object>): void;
+    stop(): void;
+}
+
 /**
  * Reports whether a caught filesystem error says that nothing is there to read.
  *
@@ -955,6 +987,23 @@ export declare interface SQLiteDriverOptions {
     readonly pragmas?: Readonly<Record<string, string | number>>;
 }
 
+/**
+ * Owns the candidate schema and table identities of one SQLite transaction.
+ *
+ * @example
+ * ```ts
+ * const transaction = new SQLiteTransaction(new Map(), new Map())
+ * transaction.schema.size // 0
+ * ```
+ */
+export declare class SQLiteTransaction {
+    #private;
+    constructor(schema: ReadonlyMap<string, TableSchema>, identities: ReadonlyMap<string, object>);
+    get schema(): ReadonlyMap<string, TableSchema>;
+    get identities(): ReadonlyMap<string, object>;
+    project(schema: readonly TableSchema[], identities: ReadonlyMap<string, object>): void;
+}
+
 /**
  * Projects one {@link MigrationStep} to SQLite DDL.
  *