@minnowdb/core 0.3.0 → 0.4.0

package/dist/engine/memory.d.ts

@@ -3,6 +3,8 @@ export interface QueryMemoryUsage {
     readonly usedBytes: number;
     readonly peakBytes: number;
 }
+/** Finite default for every public engine execution path. */
+export declare const DEFAULT_QUERY_MEMORY_BUDGET_BYTES: number;
 export declare class QueryMemoryBudgetError extends Error {
     readonly label: string;
     readonly requestedBytes: number;
@@ -34,4 +36,3 @@ export declare class QueryMemoryReservation {
     constructor(context: QueryMemoryContext, bytes: number);
     release(): void;
 }
-//# sourceMappingURL=memory.d.ts.map

package/dist/engine/memory.js

@@ -1,3 +1,5 @@
+/** Finite default for every public engine execution path. */
+export const DEFAULT_QUERY_MEMORY_BUDGET_BYTES = 64 * 1024 * 1024;
 export class QueryMemoryBudgetError extends Error {
     label;
     requestedBytes;
@@ -19,7 +21,7 @@ export class QueryMemoryContext {
     #reservations = new Set();
     #talliedBytes = 0;
     #closed = false;
-    constructor(budgetBytes = Number.MAX_SAFE_INTEGER, parent) {
+    constructor(budgetBytes = DEFAULT_QUERY_MEMORY_BUDGET_BYTES, parent) {
         if (!Number.isSafeInteger(budgetBytes) || budgetBytes < 0) {
             throw new RangeError("Query memory budget must be a non-negative safe integer");
         }
@@ -116,4 +118,3 @@ function validateMemoryBytes(bytes, label) {
         throw new RangeError(`${label} must be a non-negative safe integer`);
     }
 }
-//# sourceMappingURL=memory.js.map

package/dist/engine/optimizer.d.ts

@@ -17,4 +17,3 @@ export declare function chooseJoinOrder(plan: CompiledQuery, inputs: ReadonlyMap
 }>): CompiledQuery;
 /** Renders a stable, human-readable plan for snapshot tests and explain(). */
 export declare function renderPlan(plan: CompiledQuery): string;
-//# sourceMappingURL=optimizer.d.ts.map

package/dist/engine/optimizer.js

@@ -1,3 +1,4 @@
+import { dateIsoString, dateMilliseconds } from "../date-value.js";
 import { childExpressions, expressionAliases, forEachBlockExpression, forEachNestedBlock, isScalarFunctionName, scalarFunctionNames, scalarFunctionValue, splitCondition, volatileScalarFunctionNames, } from "./query.js";
 import { isSqlDomainValue } from "./sql-domains.js";
 /**
@@ -976,8 +977,8 @@ function foldBinary(operator, leftValue, rightValue) {
         return undefined;
     if (typeof leftValue === "string" || typeof rightValue === "string")
         return undefined;
-    const left = leftValue instanceof Date ? leftValue.getTime() : leftValue;
-    const right = rightValue instanceof Date ? rightValue.getTime() : rightValue;
+    const left = leftValue instanceof Date ? dateMilliseconds(leftValue) : leftValue;
+    const right = rightValue instanceof Date ? dateMilliseconds(rightValue) : rightValue;
     if ((operator === "/" || operator === "%") && right === 0)
         return null;
     const result = operator === "+"
@@ -1360,7 +1361,7 @@ function renderExpression(expression) {
         if (value === null)
             return "null";
         if (value instanceof Date)
-            return `date ${value.toISOString()}`;
+            return `date ${dateIsoString(value)}`;
         if (typeof value === "string")
             return `'${value}'`;
         return String(value);
@@ -1402,4 +1403,3 @@ function renderExpression(expression) {
     }
     return `${expression.name}(...) over (...)`;
 }
-//# sourceMappingURL=optimizer.js.map

package/dist/engine/query-api.d.ts

@@ -0,0 +1,3 @@
+/** SQL compilation, standalone execution, and plan inspection for tooling and adapters. */
+export { bindPlanParameters, bindStatementParameters, compileQuery, compileStatement, executeQuery, referencedColumns, type InsertValue, type CompiledQuery, type CompiledStatement, type QueryResult, type QueryRow, type QueryExecutionOptions, type QueryValue, type SqlColumnSchema, type SqlColumnType, } from "./query.js";
+export { optimizePlan, renderPlan } from "./optimizer.js";

package/dist/engine/query-api.js

@@ -0,0 +1,3 @@
+/** SQL compilation, standalone execution, and plan inspection for tooling and adapters. */
+export { bindPlanParameters, bindStatementParameters, compileQuery, compileStatement, executeQuery, referencedColumns, } from "./query.js";
+export { optimizePlan, renderPlan } from "./optimizer.js";

package/dist/engine/query-cache.d.ts

@@ -19,4 +19,3 @@ export declare function planMemoKey(plan: unknown): string;
 export declare function copyQueryResult(result: QueryResult): QueryResult;
 /** Modeled retained payload for one cached query result. */
 export declare function queryResultRetainedBytes(result: QueryResult): number;
-//# sourceMappingURL=query-cache.d.ts.map

package/dist/engine/query-cache.js

@@ -1,3 +1,4 @@
+import { copyDate, dateMilliseconds } from "../date-value.js";
 import { copyQueryResultExternalization } from "./query.js";
 import { defineSqlResultProperty } from "./sql-semantics.js";
 /** Modest per-entry cap so one giant result cannot thrash the shared artifact cache. */
@@ -14,7 +15,7 @@ export function queryResultMemoKey(sql, params) {
 export function planMemoKey(plan) {
     return JSON.stringify(plan, (_key, value) => {
         if (value instanceof Date)
-            return { $date: value.getTime() };
+            return { $date: dateMilliseconds(value) };
         if (typeof value === "bigint")
             return { $bigint: value.toString() };
         if (typeof value === "number") {
@@ -42,7 +43,7 @@ export function copyQueryResult(result) {
             for (const name of columns) {
                 const value = copy[name];
                 if (value instanceof Date)
-                    defineSqlResultProperty(copy, name, new Date(value.getTime()));
+                    defineSqlResultProperty(copy, name, copyDate(value));
             }
             return copy;
         }),
@@ -83,7 +84,6 @@ function encodeParameter(value) {
     if (typeof value === "string")
         return [3, value];
     if (value instanceof Date)
-        return [4, value.getTime()];
+        return [4, dateMilliseconds(value)];
     throw new TypeError("Query parameter has an unsupported value");
 }
-//# sourceMappingURL=query-cache.js.map

package/dist/engine/query.d.ts

@@ -2,7 +2,7 @@ import type { DatabaseRow } from "./database.js";
 import type { ColumnDefault, SqlDomain } from "../storage/types.js";
 import { type FtsStats } from "./fts.js";
 import { QueryMemoryContext, type QueryMemoryUsage } from "./memory.js";
-import { type ColumnarTable, type AsyncQueryExecutionOptions } from "./vector.js";
+import { type ColumnarTable, type AsyncQueryExecutionOptions, type QueryBatchExecutionOptions } from "./vector.js";
 export type QueryValue = boolean | number | string | Date | null;
 export type QueryRow = Record<string, QueryValue>;
 export interface QueryResult {
@@ -19,6 +19,7 @@ export interface PreparedQuery {
     readonly memoryUsage: QueryMemoryUsage;
     execute(): QueryResult;
     executeAsync(options?: AsyncQueryExecutionOptions): Promise<QueryResult>;
+    executeBatches(options: QueryBatchExecutionOptions, consume: (batch: QueryResult) => void | Promise<void>): Promise<readonly string[]>;
     close(): void;
 }
 export interface QueryExecutionOptions {
@@ -818,12 +819,9 @@ export interface ListMembership {
 export declare function cachedListMembership(node: object, items: ReadonlyArray<{
     kind: string;
 }>): ListMembership | null;
-/** Compiles a LIKE pattern (% = any run, _ = any character) to an anchored RegExp, cached. */
-export declare function likeRegExp(pattern: string, caseInsensitive?: boolean, escape?: string): RegExp;
 /**
- * A compiled LIKE matcher. Patterns shaped `abc%`, `%abc`, `%abc%`, and `abc` skip the regular
- * expression entirely — prefix/suffix/containment string scans are several times faster and
- * dominate real workloads — and everything else falls back to the anchored RegExp.
+ * Shared bounded LIKE matcher. Compilation and the common literal prefix/suffix/containment
+ * fast paths are cached in sql-semantics; complex wildcard shapes have deterministic work caps.
  */
 export declare function likeMatches(pattern: string, value: string, caseInsensitive?: boolean, escape?: string): boolean;
 /** Splits a quantified operator like "> ANY" into its comparison and quantifier. */
@@ -961,4 +959,3 @@ export declare function validateOffset(offset: number): number;
  */
 export declare function splitCondition(expression: Expression): Predicate[];
 export {};
-//# sourceMappingURL=query.d.ts.map