@quereus/quereus 0.1.0

package/dist/src/common/errors.js

@@ -0,0 +1,142 @@
+import { StatusCode } from './types.js';
+/**
+ * Base class for Quereus specific errors
+ * Provides location information and status code support
+ */
+export class QuereusError extends Error {
+    code;
+    cause;
+    line;
+    column;
+    constructor(message, code = StatusCode.ERROR, cause, line, column) {
+        super(message);
+        this.code = code;
+        this.name = 'QuereusError';
+        this.cause = cause;
+        this.line = line;
+        this.column = column;
+        // Enhance message with location if available
+        if (line !== undefined && column !== undefined) {
+            this.message = `${message} (at line ${line}, column ${column})`;
+        }
+        // Maintain stack trace in V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, QuereusError);
+        }
+    }
+}
+/**
+ * Parser-specific error that includes token information
+ * Used during SQL parsing to provide precise error locations
+ */
+export class ParseError extends QuereusError {
+    token;
+    constructor(message, token) {
+        super(message, StatusCode.ERROR, undefined, token.startLine, token.startColumn);
+        this.token = token;
+        this.name = 'ParseError';
+    }
+}
+/**
+ * Error thrown when a database constraint is violated
+ */
+export class ConstraintError extends QuereusError {
+    constructor(message, code = StatusCode.CONSTRAINT) {
+        super(message, code);
+        this.name = 'ConstraintError';
+    }
+}
+/**
+ * Error thrown for SQL syntax issues
+ */
+export class SyntaxError extends QuereusError {
+    constructor(message = "SQL syntax error") {
+        super(message, StatusCode.ERROR);
+        this.name = 'SyntaxError';
+        Object.setPrototypeOf(this, SyntaxError.prototype);
+    }
+}
+/**
+ * Error thrown when the API is used incorrectly
+ */
+export class MisuseError extends QuereusError {
+    constructor(message = "API misuse") {
+        super(message, StatusCode.MISUSE);
+        this.name = 'MisuseError';
+        Object.setPrototypeOf(this, MisuseError.prototype);
+    }
+}
+/**
+ * Helper function to throw a QuereusError with optional location information from AST nodes
+ * @param message Error message
+ * @param code Status code (defaults to ERROR)
+ * @param cause Optional underlying error
+ * @param astNode Optional AST node or object with location information
+ * @returns Never (always throws)
+ */
+export function quereusError(message, code = StatusCode.ERROR, cause, astNode) {
+    throw new QuereusError(message, code, cause, astNode?.loc?.start.line, astNode?.loc?.start.column);
+}
+/**
+ * Recursively unwraps a QuereusError (or any Error) and its causes
+ * @param error The error to unwrap
+ * @returns Array of ErrorInfo objects, with the root error first
+ */
+export function unwrapError(error) {
+    const errorChain = [];
+    let currentError = error;
+    while (currentError) {
+        const errorInfo = {
+            message: currentError.message,
+            name: currentError.name,
+            stack: currentError.stack,
+        };
+        // Add QuereusError-specific fields if available
+        if (currentError instanceof QuereusError) {
+            errorInfo.code = currentError.code;
+            errorInfo.line = currentError.line;
+            errorInfo.column = currentError.column;
+        }
+        errorChain.push(errorInfo);
+        // Move to the next error in the chain
+        currentError = currentError.cause;
+    }
+    return errorChain;
+}
+/**
+ * Formats an error chain for display
+ * @param errorChain Array of ErrorInfo objects
+ * @param includeStack Whether to include stack traces
+ * @returns Formatted error message
+ */
+export function formatErrorChain(errorChain, includeStack = false) {
+    if (errorChain.length === 0) {
+        return 'Unknown error';
+    }
+    const lines = [];
+    errorChain.forEach((errorInfo, index) => {
+        const prefix = index === 0 ? 'Error' : `Caused by`;
+        let line = `${prefix}: ${errorInfo.message}`;
+        if (errorInfo.line !== undefined && errorInfo.column !== undefined) {
+            line += ` (at line ${errorInfo.line}, column ${errorInfo.column})`;
+        }
+        lines.push(line);
+        if (includeStack && errorInfo.stack) {
+            lines.push(errorInfo.stack);
+        }
+    });
+    return lines.join('\n');
+}
+/**
+ * Gets the primary error info (the first error in the chain)
+ * @param error The error to analyze
+ * @returns ErrorInfo for the primary error
+ */
+export function getPrimaryError(error) {
+    const chain = unwrapError(error);
+    return chain[0] || {
+        message: 'Unknown error',
+        name: 'Error',
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/common/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/common/errors.ts"],"names":[],"mappings":"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"}

package/dist/src/common/logger.d.ts

@@ -0,0 +1,18 @@
+import debug from 'debug';
+/**
+ * Creates a namespaced debug logger instance.
+ *
+ * Example: createLogger('compiler') -> returns a debugger for 'quereus:compiler'
+ * Example: createLogger('vtab:memory') -> returns a debugger for 'quereus:vtab:memory'
+ *
+ * Usage:
+ * const log = createLogger('compiler');
+ * log('Compiling statement: %s', sql);
+ * const errorLog = log.extend('error'); // Creates 'quereus:compiler:error'
+ * errorLog('Compilation failed: %O', error);
+ *
+ * @param subNamespace The specific subsystem namespace (e.g., 'parser', 'vdbe:runtime', 'vtab:memory')
+ * @returns A debug instance.
+ */
+export declare function createLogger(subNamespace: string): debug.Debugger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/common/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/common/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,CAEjE"}

package/dist/src/common/logger.js

@@ -0,0 +1,22 @@
+import debug from 'debug';
+// Base namespace for the project
+const BASE_NAMESPACE = 'quereus';
+/**
+ * Creates a namespaced debug logger instance.
+ *
+ * Example: createLogger('compiler') -> returns a debugger for 'quereus:compiler'
+ * Example: createLogger('vtab:memory') -> returns a debugger for 'quereus:vtab:memory'
+ *
+ * Usage:
+ * const log = createLogger('compiler');
+ * log('Compiling statement: %s', sql);
+ * const errorLog = log.extend('error'); // Creates 'quereus:compiler:error'
+ * errorLog('Compilation failed: %O', error);
+ *
+ * @param subNamespace The specific subsystem namespace (e.g., 'parser', 'vdbe:runtime', 'vtab:memory')
+ * @returns A debug instance.
+ */
+export function createLogger(subNamespace) {
+    return debug(`${BASE_NAMESPACE}:${subNamespace}`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/common/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/common/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,iCAAiC;AACjC,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO,KAAK,CAAC,GAAG,cAAc,IAAI,YAAY,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/src/common/type-inference.d.ts

@@ -0,0 +1,11 @@
+import { SqlDataType, type SqlValue } from "./types.js";
+export declare function getLiteralSqlType(v: SqlValue): SqlDataType;
+/**
+ * Determines the column affinity in a similar way to SQLite rules.
+ * @see https://www.sqlite.org/datatype3.html#determination_of_column_affinity
+ *
+ * @param typeName The declared type name (case-insensitive)
+ * @returns The determined SqlDataType affinity
+ */
+export declare function getAffinity(typeName: string | undefined): SqlDataType;
+//# sourceMappingURL=type-inference.d.ts.map

package/dist/src/common/type-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-inference.d.ts","sourceRoot":"","sources":["../../../src/common/type-inference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,CAU1D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAkBrE"}

package/dist/src/common/type-inference.js

@@ -0,0 +1,44 @@
+import { SqlDataType } from "./types.js";
+export function getLiteralSqlType(v) {
+    if (v === null)
+        return SqlDataType.NULL;
+    if (typeof v === 'number') {
+        if (Number.isInteger(v))
+            return SqlDataType.INTEGER;
+        return SqlDataType.REAL;
+    }
+    if (typeof v === 'bigint')
+        return SqlDataType.INTEGER;
+    if (typeof v === 'string')
+        return SqlDataType.TEXT;
+    if (v instanceof Uint8Array)
+        return SqlDataType.BLOB;
+    return SqlDataType.BLOB;
+}
+/**
+ * Determines the column affinity in a similar way to SQLite rules.
+ * @see https://www.sqlite.org/datatype3.html#determination_of_column_affinity
+ *
+ * @param typeName The declared type name (case-insensitive)
+ * @returns The determined SqlDataType affinity
+ */
+export function getAffinity(typeName) {
+    if (!typeName) {
+        return SqlDataType.BLOB;
+    }
+    const typeUpper = typeName.toUpperCase();
+    if (typeUpper.includes('INT')) {
+        return SqlDataType.INTEGER;
+    }
+    if (typeUpper.includes('CHAR') || typeUpper.includes('CLOB') || typeUpper.includes('TEXT')) {
+        return SqlDataType.TEXT;
+    }
+    if (typeUpper.includes('BLOB')) {
+        return SqlDataType.BLOB;
+    }
+    if (typeUpper.includes('REAL') || typeUpper.includes('FLOA') || typeUpper.includes('DOUB')) {
+        return SqlDataType.REAL;
+    }
+    return SqlDataType.NUMERIC; // Default catch-all
+}
+//# sourceMappingURL=type-inference.js.map

package/dist/src/common/type-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-inference.js","sourceRoot":"","sources":["../../../src/common/type-inference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,CAAW;IAC5C,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC;IACxC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC;QACpD,OAAO,WAAW,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,OAAO,CAAC;IACtD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC;IACnD,IAAI,CAAC,YAAY,UAAU;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC;IACrD,OAAO,WAAW,CAAC,IAAI,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAA4B;IACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,OAAO,CAAC;IAC5B,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5F,OAAO,WAAW,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5F,OAAO,WAAW,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,oBAAoB;AACjD,CAAC"}

package/dist/src/common/types.d.ts

@@ -0,0 +1,131 @@
+import type { RuntimeContext } from '../runtime/types.js';
+export type MaybePromise<T> = T | Promise<T>;
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: DeepReadonly<T[P]>;
+};
+/**
+ * Represents the primitive scalar types Quereus can handle internally in this implementation.
+ * These are the values that can be stored in Quereus columns and passed as parameters.
+ */
+export type SqlValue = string | number | bigint | boolean | Uint8Array | null;
+/**
+ * Represents a row of data, which is an array of SqlValue.
+ */
+export type Row = SqlValue[];
+/**
+ * Represents a value that can be expected as an input in the runtime environment.
+ * This type can be a scalar value, or an async iterable of rows (cursor).
+ */
+export type RuntimeValue = SqlValue | Row | AsyncIterable<Row> | ((ctx: RuntimeContext) => OutputValue);
+/** Represents a value that can be output from an instruction or program. */
+export type OutputValue = MaybePromise<RuntimeValue>;
+export type SqlParameters = Record<string, SqlValue> | SqlValue[];
+/**
+ * Standard status/error codes that significantly match SQLite.
+ * Used for error handling and determining operation results.
+ */
+export declare enum StatusCode {
+    OK = 0,
+    ERROR = 1,
+    INTERNAL = 2,
+    PERM = 3,
+    ABORT = 4,
+    BUSY = 5,
+    LOCKED = 6,
+    NOMEM = 7,
+    READONLY = 8,
+    INTERRUPT = 9,
+    IOERR = 10,
+    CORRUPT = 11,
+    NOTFOUND = 12,
+    FULL = 13,
+    CANTOPEN = 14,
+    PROTOCOL = 15,
+    EMPTY = 16,
+    SCHEMA = 17,
+    TOOBIG = 18,
+    CONSTRAINT = 19,
+    MISMATCH = 20,
+    MISUSE = 21,
+    NOLFS = 22,
+    AUTH = 23,
+    FORMAT = 24,
+    RANGE = 25,
+    NOTADB = 26,
+    NOTICE = 27,
+    WARNING = 28,
+    SYNTAX = 29,
+    UNSUPPORTED = 30
+}
+/**
+ * Fundamental SQLite compatible datatypes/affinity types.
+ * These determine how values are stored and compared within the database.
+ */
+export declare enum SqlDataType {
+    NULL = 0,
+    INTEGER = 1,
+    REAL = 2,
+    TEXT = 3,
+    BLOB = 4,
+    NUMERIC = 6,// For DECIMAL, NUMERIC with precision/scale
+    BOOLEAN = 7
+}
+export type CompareFn = (a: SqlValue, b: SqlValue) => number;
+export interface DatabaseInfo {
+    path: string | ':memory:';
+    isOpen: boolean;
+    isReadonly: boolean;
+    inTransaction: boolean;
+    name: string;
+}
+/**
+ * Shared configuration object that can be used by multiple databases
+ */
+export interface DatabaseConfig {
+    /**
+     * Open the database in read-only mode
+     * @default false
+     */
+    readonly?: boolean;
+    /**
+     * Register default functions
+     * @default true
+     */
+    registerDefaultFunctions?: boolean;
+    /**
+     * Maximum number of retries when opening the database
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Enable WAL mode (Write-Ahead Logging)
+     * @default true for file databases, false for in-memory
+     */
+    enableWAL?: boolean;
+    /**
+     * Synchronous setting ('OFF' | 'NORMAL' | 'FULL' | 'EXTRA')
+     * @default 'NORMAL' with WAL, 'FULL' without WAL
+     */
+    synchronous?: 'OFF' | 'NORMAL' | 'FULL' | 'EXTRA';
+    /**
+     * Journal mode ('DELETE' | 'TRUNCATE' | 'PERSIST' | 'MEMORY' | 'WAL' | 'OFF')
+     * @default 'WAL' if enableWAL is true, 'DELETE' otherwise
+     */
+    journalMode?: 'DELETE' | 'TRUNCATE' | 'PERSIST' | 'MEMORY' | 'WAL' | 'OFF';
+    /**
+     * Cache size in pages (negative value = KB)
+     * @default -2048 (2MB)
+     */
+    cacheSize?: number;
+    /**
+     * Page size in bytes (must be power of 2, 512-65536)
+     * @default 4096
+     */
+    pageSize?: number;
+    /**
+     * Foreign key constraint enforcement
+     * @default true
+     */
+    foreignKeys?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":"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"}

package/dist/src/common/types.js

@@ -0,0 +1,53 @@
+/**
+ * Standard status/error codes that significantly match SQLite.
+ * Used for error handling and determining operation results.
+ */
+export var StatusCode;
+(function (StatusCode) {
+    StatusCode[StatusCode["OK"] = 0] = "OK";
+    StatusCode[StatusCode["ERROR"] = 1] = "ERROR";
+    StatusCode[StatusCode["INTERNAL"] = 2] = "INTERNAL";
+    StatusCode[StatusCode["PERM"] = 3] = "PERM";
+    StatusCode[StatusCode["ABORT"] = 4] = "ABORT";
+    StatusCode[StatusCode["BUSY"] = 5] = "BUSY";
+    StatusCode[StatusCode["LOCKED"] = 6] = "LOCKED";
+    StatusCode[StatusCode["NOMEM"] = 7] = "NOMEM";
+    StatusCode[StatusCode["READONLY"] = 8] = "READONLY";
+    StatusCode[StatusCode["INTERRUPT"] = 9] = "INTERRUPT";
+    StatusCode[StatusCode["IOERR"] = 10] = "IOERR";
+    StatusCode[StatusCode["CORRUPT"] = 11] = "CORRUPT";
+    StatusCode[StatusCode["NOTFOUND"] = 12] = "NOTFOUND";
+    StatusCode[StatusCode["FULL"] = 13] = "FULL";
+    StatusCode[StatusCode["CANTOPEN"] = 14] = "CANTOPEN";
+    StatusCode[StatusCode["PROTOCOL"] = 15] = "PROTOCOL";
+    StatusCode[StatusCode["EMPTY"] = 16] = "EMPTY";
+    StatusCode[StatusCode["SCHEMA"] = 17] = "SCHEMA";
+    StatusCode[StatusCode["TOOBIG"] = 18] = "TOOBIG";
+    StatusCode[StatusCode["CONSTRAINT"] = 19] = "CONSTRAINT";
+    StatusCode[StatusCode["MISMATCH"] = 20] = "MISMATCH";
+    StatusCode[StatusCode["MISUSE"] = 21] = "MISUSE";
+    StatusCode[StatusCode["NOLFS"] = 22] = "NOLFS";
+    StatusCode[StatusCode["AUTH"] = 23] = "AUTH";
+    StatusCode[StatusCode["FORMAT"] = 24] = "FORMAT";
+    StatusCode[StatusCode["RANGE"] = 25] = "RANGE";
+    StatusCode[StatusCode["NOTADB"] = 26] = "NOTADB";
+    StatusCode[StatusCode["NOTICE"] = 27] = "NOTICE";
+    StatusCode[StatusCode["WARNING"] = 28] = "WARNING";
+    StatusCode[StatusCode["SYNTAX"] = 29] = "SYNTAX";
+    StatusCode[StatusCode["UNSUPPORTED"] = 30] = "UNSUPPORTED";
+})(StatusCode || (StatusCode = {}));
+/**
+ * Fundamental SQLite compatible datatypes/affinity types.
+ * These determine how values are stored and compared within the database.
+ */
+export var SqlDataType;
+(function (SqlDataType) {
+    SqlDataType[SqlDataType["NULL"] = 0] = "NULL";
+    SqlDataType[SqlDataType["INTEGER"] = 1] = "INTEGER";
+    SqlDataType[SqlDataType["REAL"] = 2] = "REAL";
+    SqlDataType[SqlDataType["TEXT"] = 3] = "TEXT";
+    SqlDataType[SqlDataType["BLOB"] = 4] = "BLOB";
+    SqlDataType[SqlDataType["NUMERIC"] = 6] = "NUMERIC";
+    SqlDataType[SqlDataType["BOOLEAN"] = 7] = "BOOLEAN";
+})(SqlDataType || (SqlDataType = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,MAAM,CAAN,IAAY,UAgCX;AAhCD,WAAY,UAAU;IACrB,uCAAM,CAAA;IACN,6CAAS,CAAA;IACT,mDAAY,CAAA;IACZ,2CAAQ,CAAA;IACR,6CAAS,CAAA;IACT,2CAAQ,CAAA;IACR,+CAAU,CAAA;IACV,6CAAS,CAAA;IACT,mDAAY,CAAA;IACZ,qDAAa,CAAA;IACb,8CAAU,CAAA;IACV,kDAAY,CAAA;IACZ,oDAAa,CAAA;IACb,4CAAS,CAAA;IACT,oDAAa,CAAA;IACb,oDAAa,CAAA;IACb,8CAAU,CAAA;IACV,gDAAW,CAAA;IACX,gDAAW,CAAA;IACX,wDAAe,CAAA;IACf,oDAAa,CAAA;IACb,gDAAW,CAAA;IACX,8CAAU,CAAA;IACV,4CAAS,CAAA;IACT,gDAAW,CAAA;IACX,8CAAU,CAAA;IACV,gDAAW,CAAA;IACX,gDAAW,CAAA;IACX,kDAAY,CAAA;IACZ,gDAAW,CAAA;IACX,0DAAgB,CAAA;AACjB,CAAC,EAhCW,UAAU,KAAV,UAAU,QAgCrB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,WAQX;AARD,WAAY,WAAW;IACtB,6CAAQ,CAAA;IACR,mDAAW,CAAA;IACX,6CAAQ,CAAA;IACR,6CAAQ,CAAA;IACR,6CAAQ,CAAA;IACR,mDAAW,CAAA;IACX,mDAAW,CAAA;AACZ,CAAC,EARW,WAAW,KAAX,WAAW,QAQtB"}

package/dist/src/core/database-options.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Centralized database options management with event-driven updates
+ */
+import type { SqlValue } from '../common/types.js';
+export type OptionValue = boolean | string | number | Record<string, SqlValue>;
+export type OptionType = 'boolean' | 'string' | 'number' | 'object';
+export interface OptionDefinition {
+    type: OptionType;
+    defaultValue: OptionValue;
+    aliases?: string[];
+    description?: string;
+    onChange?: OptionChangeListener;
+}
+export interface OptionChangeEvent {
+    key: string;
+    oldValue: OptionValue;
+    newValue: OptionValue;
+}
+export type OptionChangeListener = (event: OptionChangeEvent) => void;
+/**
+ * Centralized options manager with event notifications and registration
+ */
+export declare class DatabaseOptionsManager {
+    private options;
+    private definitions;
+    private aliases;
+    /**
+     * Register an option with its definition
+     */
+    registerOption(key: string, definition: OptionDefinition): void;
+    /**
+     * Set an option value and notify listeners
+     */
+    setOption(key: string, value: any): void;
+    /**
+     * Get an option value
+     */
+    getOption(key: string): OptionValue;
+    /**
+     * Get a boolean option value with type safety
+     */
+    getBooleanOption(key: string): boolean;
+    /**
+     * Get a string option value with type safety
+     */
+    getStringOption(key: string): string;
+    /**
+     * Get an object option value with type safety
+     */
+    getObjectOption(key: string): Record<string, any>;
+    /**
+     * Get all current options
+     */
+    getAllOptions(): Record<string, OptionValue>;
+    /**
+     * Get all registered option definitions
+     */
+    getOptionDefinitions(): Record<string, OptionDefinition>;
+    private resolveKey;
+    private convertValue;
+    private convertToBoolean;
+    private convertToNumber;
+    private convertToObject;
+    private valuesEqual;
+    private notifyListener;
+}
+//# sourceMappingURL=database-options.d.ts.map

package/dist/src/core/database-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-options.d.ts","sourceRoot":"","sources":["../../../src/core/database-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC/E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEtE;;GAEG;AACH,qBAAa,sBAAsB;IAClC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,OAAO,CAA6B;IAE5C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAqB/D;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAqBxC;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IASnC;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQtC;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQpC;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAUjD;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAQ5C;;OAEG;IACH,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAQxD,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;CAWtB"}