@quereus/quereus 0.4.11 → 0.5.1

package/dist/src/types/logical-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logical-type.js","sourceRoot":"","sources":["../../../src/types/logical-type.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACvB,+CAAQ,CAAA;IACR,qDAAW,CAAA;IACX,+CAAQ,CAAA;IACR,+CAAQ,CAAA;IACR,+CAAQ,CAAA;IACR,qDAAW,CAAA;AACZ,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAwCD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAe;IAC9C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAC5D,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC;IAC1D,OAAO,YAAY,CAAC,IAAI,CAAC;AAC1B,CAAC"}

package/dist/src/types/plugin-interface.d.ts

@@ -0,0 +1,9 @@
+import type { LogicalType } from './logical-type.js';
+/**
+ * Type plugin registration info
+ */
+export interface TypePluginInfo {
+    name: string;
+    definition: LogicalType;
+}
+//# sourceMappingURL=plugin-interface.d.ts.map

package/dist/src/types/plugin-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-interface.d.ts","sourceRoot":"","sources":["../../../src/types/plugin-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,WAAW,CAAC;CACxB"}

package/dist/src/types/plugin-interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-interface.js.map

package/dist/src/types/plugin-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-interface.js","sourceRoot":"","sources":["../../../src/types/plugin-interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,72 @@
+import type { LogicalType } from './logical-type.js';
+/**
+ * Global type registry that maps type names to logical type definitions.
+ */
+declare class TypeRegistry {
+    private types;
+    constructor();
+    /**
+     * Register a new logical type.
+     * @param type The logical type to register
+     */
+    registerType(type: LogicalType): void;
+    /**
+     * Get a logical type by name.
+     * @param name The type name (case-insensitive)
+     * @returns The logical type, or undefined if not found
+     */
+    getType(name: string): LogicalType | undefined;
+    /**
+     * Get a logical type by name, with fallback to BLOB if not found.
+     * This matches SQLite's behavior where unknown types default to BLOB affinity.
+     * @param name The type name (case-insensitive)
+     * @returns The logical type (defaults to BLOB if not found)
+     */
+    getTypeOrDefault(name: string | undefined): LogicalType;
+    /**
+     * Check if a type is registered.
+     * @param name The type name (case-insensitive)
+     * @returns True if the type is registered
+     */
+    hasType(name: string): boolean;
+    /**
+     * Get all registered type names.
+     * @returns Array of type names
+     */
+    getTypeNames(): string[];
+    /**
+     * Infer logical type from a type name string.
+     * This handles SQLite-style type affinity rules where type names can contain
+     * keywords like "INT", "CHAR", "REAL", etc.
+     *
+     * @param typeName The declared type name (e.g., "VARCHAR(100)", "UNSIGNED INT")
+     * @returns The inferred logical type
+     */
+    inferType(typeName: string | undefined): LogicalType;
+}
+export declare const typeRegistry: TypeRegistry;
+/**
+ * Register a custom logical type.
+ * @param type The logical type to register
+ */
+export declare function registerType(type: LogicalType): void;
+/**
+ * Get a logical type by name.
+ * @param name The type name (case-insensitive)
+ * @returns The logical type, or undefined if not found
+ */
+export declare function getType(name: string): LogicalType | undefined;
+/**
+ * Get a logical type by name, with fallback to BLOB if not found.
+ * @param name The type name (case-insensitive)
+ * @returns The logical type (defaults to BLOB if not found)
+ */
+export declare function getTypeOrDefault(name: string | undefined): LogicalType;
+/**
+ * Infer logical type from a type name string.
+ * @param typeName The declared type name
+ * @returns The inferred logical type
+ */
+export declare function inferType(typeName: string | undefined): LogicalType;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmBrD;;GAEG;AACH,cAAM,YAAY;IACjB,OAAO,CAAC,KAAK,CAAkC;;IAyC/C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IASrC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI9C;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW;IAKvD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;OAGG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW;CAsCpD;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAEnE"}

package/dist/src/types/registry.js

@@ -0,0 +1,168 @@
+import { NULL_TYPE, INTEGER_TYPE, REAL_TYPE, TEXT_TYPE, BLOB_TYPE, BOOLEAN_TYPE, NUMERIC_TYPE, ANY_TYPE, } from './builtin-types.js';
+import { DATE_TYPE, TIME_TYPE, DATETIME_TYPE } from './temporal-types.js';
+import { JSON_TYPE } from './json-type.js';
+import { createLogger } from '../common/logger.js';
+const log = createLogger('types:registry');
+const warnLog = log.extend('warn');
+const debugLog = log.extend('debug');
+/**
+ * Global type registry that maps type names to logical type definitions.
+ */
+class TypeRegistry {
+    types = new Map();
+    constructor() {
+        // Register built-in types
+        this.registerType(NULL_TYPE);
+        this.registerType(INTEGER_TYPE);
+        this.registerType(REAL_TYPE);
+        this.registerType(TEXT_TYPE);
+        this.registerType(BLOB_TYPE);
+        this.registerType(BOOLEAN_TYPE);
+        this.registerType(NUMERIC_TYPE);
+        this.registerType(ANY_TYPE);
+        this.registerType(DATE_TYPE);
+        this.registerType(TIME_TYPE);
+        this.registerType(DATETIME_TYPE);
+        this.registerType(JSON_TYPE);
+        // Register common aliases
+        this.types.set('INT', INTEGER_TYPE);
+        this.types.set('BIGINT', INTEGER_TYPE);
+        this.types.set('SMALLINT', INTEGER_TYPE);
+        this.types.set('TINYINT', INTEGER_TYPE);
+        this.types.set('MEDIUMINT', INTEGER_TYPE);
+        this.types.set('FLOAT', REAL_TYPE);
+        this.types.set('DOUBLE', REAL_TYPE);
+        this.types.set('DECIMAL', NUMERIC_TYPE);
+        this.types.set('VARCHAR', TEXT_TYPE);
+        this.types.set('CHAR', TEXT_TYPE);
+        this.types.set('CHARACTER', TEXT_TYPE);
+        this.types.set('CLOB', TEXT_TYPE);
+        this.types.set('STRING', TEXT_TYPE);
+        this.types.set('BOOL', BOOLEAN_TYPE);
+        this.types.set('BYTES', BLOB_TYPE);
+        this.types.set('BINARY', BLOB_TYPE);
+        this.types.set('VARBINARY', BLOB_TYPE);
+    }
+    /**
+     * Register a new logical type.
+     * @param type The logical type to register
+     */
+    registerType(type) {
+        const upperName = type.name.toUpperCase();
+        if (this.types.has(upperName)) {
+            warnLog(`Overwriting existing type: ${upperName}`);
+        }
+        this.types.set(upperName, type);
+        debugLog(`Registered type: ${upperName}`);
+    }
+    /**
+     * Get a logical type by name.
+     * @param name The type name (case-insensitive)
+     * @returns The logical type, or undefined if not found
+     */
+    getType(name) {
+        return this.types.get(name.toUpperCase());
+    }
+    /**
+     * Get a logical type by name, with fallback to BLOB if not found.
+     * This matches SQLite's behavior where unknown types default to BLOB affinity.
+     * @param name The type name (case-insensitive)
+     * @returns The logical type (defaults to BLOB if not found)
+     */
+    getTypeOrDefault(name) {
+        if (!name)
+            return BLOB_TYPE;
+        return this.getType(name) ?? BLOB_TYPE;
+    }
+    /**
+     * Check if a type is registered.
+     * @param name The type name (case-insensitive)
+     * @returns True if the type is registered
+     */
+    hasType(name) {
+        return this.types.has(name.toUpperCase());
+    }
+    /**
+     * Get all registered type names.
+     * @returns Array of type names
+     */
+    getTypeNames() {
+        return Array.from(this.types.keys());
+    }
+    /**
+     * Infer logical type from a type name string.
+     * This handles SQLite-style type affinity rules where type names can contain
+     * keywords like "INT", "CHAR", "REAL", etc.
+     *
+     * @param typeName The declared type name (e.g., "VARCHAR(100)", "UNSIGNED INT")
+     * @returns The inferred logical type
+     */
+    inferType(typeName) {
+        if (!typeName)
+            return BLOB_TYPE;
+        const upperName = typeName.toUpperCase();
+        // First try exact match
+        const exactMatch = this.types.get(upperName);
+        if (exactMatch)
+            return exactMatch;
+        // SQLite-style affinity rules
+        // INTEGER affinity: INT
+        if (upperName.includes('INT'))
+            return INTEGER_TYPE;
+        // TEXT affinity: CHAR, CLOB, TEXT
+        if (upperName.includes('CHAR') || upperName.includes('CLOB') || upperName.includes('TEXT')) {
+            return TEXT_TYPE;
+        }
+        // BLOB affinity: BLOB
+        if (upperName.includes('BLOB'))
+            return BLOB_TYPE;
+        // REAL affinity: REAL, FLOA, DOUB
+        if (upperName.includes('REAL') || upperName.includes('FLOA') || upperName.includes('DOUB')) {
+            return REAL_TYPE;
+        }
+        // BOOLEAN affinity: BOOL
+        if (upperName.includes('BOOL'))
+            return BOOLEAN_TYPE;
+        // NUMERIC affinity: everything else with NUMERIC, DECIMAL
+        if (upperName.includes('NUMERIC') || upperName.includes('DECIMAL')) {
+            return NUMERIC_TYPE;
+        }
+        // Default to BLOB (SQLite behavior)
+        debugLog(`Unknown type '${typeName}', defaulting to BLOB`);
+        return BLOB_TYPE;
+    }
+}
+// Global singleton instance
+export const typeRegistry = new TypeRegistry();
+/**
+ * Register a custom logical type.
+ * @param type The logical type to register
+ */
+export function registerType(type) {
+    typeRegistry.registerType(type);
+}
+/**
+ * Get a logical type by name.
+ * @param name The type name (case-insensitive)
+ * @returns The logical type, or undefined if not found
+ */
+export function getType(name) {
+    return typeRegistry.getType(name);
+}
+/**
+ * Get a logical type by name, with fallback to BLOB if not found.
+ * @param name The type name (case-insensitive)
+ * @returns The logical type (defaults to BLOB if not found)
+ */
+export function getTypeOrDefault(name) {
+    return typeRegistry.getTypeOrDefault(name);
+}
+/**
+ * Infer logical type from a type name string.
+ * @param typeName The declared type name
+ * @returns The inferred logical type
+ */
+export function inferType(typeName) {
+    return typeRegistry.inferType(typeName);
+}
+//# sourceMappingURL=registry.js.map

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

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

package/dist/src/types/temporal-types.d.ts

@@ -0,0 +1,17 @@
+import { type LogicalType } from './logical-type.js';
+/**
+ * DATE type - stores ISO 8601 date strings (YYYY-MM-DD)
+ * Uses Temporal.PlainDate for validation and parsing
+ */
+export declare const DATE_TYPE: LogicalType;
+/**
+ * TIME type - stores ISO 8601 time strings (HH:MM:SS or HH:MM:SS.sss)
+ * Uses Temporal.PlainTime for validation and parsing
+ */
+export declare const TIME_TYPE: LogicalType;
+/**
+ * DATETIME type - stores ISO 8601 datetime strings (YYYY-MM-DDTHH:MM:SS or with timezone)
+ * Uses Temporal.PlainDateTime for validation and parsing
+ */
+export declare const DATETIME_TYPE: LogicalType;
+//# sourceMappingURL=temporal-types.d.ts.map

package/dist/src/types/temporal-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-types.d.ts","sourceRoot":"","sources":["../../../src/types/temporal-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGnE;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,WA2CvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,WA8CvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,WAyD3B,CAAC"}

package/dist/src/types/temporal-types.js

@@ -0,0 +1,178 @@
+import { PhysicalType } from './logical-type.js';
+import { Temporal } from 'temporal-polyfill';
+/**
+ * DATE type - stores ISO 8601 date strings (YYYY-MM-DD)
+ * Uses Temporal.PlainDate for validation and parsing
+ */
+export const DATE_TYPE = {
+    name: 'DATE',
+    physicalType: PhysicalType.TEXT,
+    isTemporal: true,
+    validate: (v) => {
+        if (v === null)
+            return true;
+        if (typeof v !== 'string')
+            return false;
+        try {
+            Temporal.PlainDate.from(v);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    parse: (v) => {
+        if (v === null)
+            return null;
+        if (typeof v === 'string') {
+            try {
+                const date = Temporal.PlainDate.from(v);
+                return date.toString(); // ISO 8601 format: YYYY-MM-DD
+            }
+            catch (e) {
+                throw new TypeError(`Cannot convert '${v}' to DATE: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        if (typeof v === 'number') {
+            // Unix timestamp (milliseconds)
+            const instant = Temporal.Instant.fromEpochMilliseconds(v);
+            return instant.toZonedDateTimeISO('UTC').toPlainDate().toString();
+        }
+        throw new TypeError(`Cannot convert ${typeof v} to DATE`);
+    },
+    compare: (a, b) => {
+        if (a === null && b === null)
+            return 0;
+        if (a === null)
+            return -1;
+        if (b === null)
+            return 1;
+        // ISO 8601 dates can be compared lexicographically
+        return a.localeCompare(b);
+    },
+    supportedCollations: [],
+};
+/**
+ * TIME type - stores ISO 8601 time strings (HH:MM:SS or HH:MM:SS.sss)
+ * Uses Temporal.PlainTime for validation and parsing
+ */
+export const TIME_TYPE = {
+    name: 'TIME',
+    physicalType: PhysicalType.TEXT,
+    isTemporal: true,
+    validate: (v) => {
+        if (v === null)
+            return true;
+        if (typeof v !== 'string')
+            return false;
+        try {
+            Temporal.PlainTime.from(v);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    parse: (v) => {
+        if (v === null)
+            return null;
+        if (typeof v === 'string') {
+            try {
+                const time = Temporal.PlainTime.from(v);
+                return time.toString(); // ISO 8601 format: HH:MM:SS or HH:MM:SS.sss
+            }
+            catch (e) {
+                throw new TypeError(`Cannot convert '${v}' to TIME: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        if (typeof v === 'number') {
+            // Seconds since midnight
+            const hours = Math.floor(v / 3600) % 24;
+            const minutes = Math.floor((v % 3600) / 60);
+            const seconds = v % 60;
+            const time = new Temporal.PlainTime(hours, minutes, seconds);
+            return time.toString();
+        }
+        throw new TypeError(`Cannot convert ${typeof v} to TIME`);
+    },
+    compare: (a, b) => {
+        if (a === null && b === null)
+            return 0;
+        if (a === null)
+            return -1;
+        if (b === null)
+            return 1;
+        // ISO 8601 times can be compared lexicographically
+        return a.localeCompare(b);
+    },
+    supportedCollations: [],
+};
+/**
+ * DATETIME type - stores ISO 8601 datetime strings (YYYY-MM-DDTHH:MM:SS or with timezone)
+ * Uses Temporal.PlainDateTime for validation and parsing
+ */
+export const DATETIME_TYPE = {
+    name: 'DATETIME',
+    physicalType: PhysicalType.TEXT,
+    isTemporal: true,
+    validate: (v) => {
+        if (v === null)
+            return true;
+        if (typeof v !== 'string')
+            return false;
+        try {
+            // Try PlainDateTime first
+            Temporal.PlainDateTime.from(v);
+            return true;
+        }
+        catch {
+            try {
+                // Also accept ZonedDateTime
+                Temporal.ZonedDateTime.from(v);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    },
+    parse: (v) => {
+        if (v === null)
+            return null;
+        if (typeof v === 'string') {
+            try {
+                // Try PlainDateTime first
+                const dt = Temporal.PlainDateTime.from(v);
+                return dt.toString(); // ISO 8601 format: YYYY-MM-DDTHH:MM:SS
+            }
+            catch {
+                try {
+                    // Try ZonedDateTime
+                    const zdt = Temporal.ZonedDateTime.from(v);
+                    return zdt.toString(); // ISO 8601 with timezone
+                }
+                catch (e) {
+                    throw new TypeError(`Cannot convert '${v}' to DATETIME: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+        }
+        if (typeof v === 'number') {
+            // Unix timestamp (milliseconds)
+            const instant = Temporal.Instant.fromEpochMilliseconds(v);
+            return instant.toZonedDateTimeISO('UTC').toString();
+        }
+        throw new TypeError(`Cannot convert ${typeof v} to DATETIME`);
+    },
+    compare: (a, b) => {
+        if (a === null && b === null)
+            return 0;
+        if (a === null)
+            return -1;
+        if (b === null)
+            return 1;
+        // ISO 8601 datetimes can be compared lexicographically
+        return a.localeCompare(b);
+    },
+    supportedCollations: [],
+};
+//# sourceMappingURL=temporal-types.js.map

package/dist/src/types/temporal-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-types.js","sourceRoot":"","sources":["../../../src/types/temporal-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB;IACrC,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,YAAY,CAAC,IAAI;IAC/B,UAAU,EAAE,IAAI;IAEhB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;QACf,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC;YACJ,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAED,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;QACZ,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACJ,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACxC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,8BAA8B;YACvD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,cAAc,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrG,CAAC;QACF,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,gCAAgC;YAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC1D,OAAO,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;QACnE,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,kBAAkB,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QACzB,mDAAmD;QACnD,OAAQ,CAAY,CAAC,aAAa,CAAC,CAAW,CAAC,CAAC;IACjD,CAAC;IAED,mBAAmB,EAAE,EAAE;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB;IACrC,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,YAAY,CAAC,IAAI;IAC/B,UAAU,EAAE,IAAI;IAEhB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;QACf,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC;YACJ,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAED,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;QACZ,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACJ,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACxC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,4CAA4C;YACrE,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,cAAc,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrG,CAAC;QACF,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,yBAAyB;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,kBAAkB,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QACzB,mDAAmD;QACnD,OAAQ,CAAY,CAAC,aAAa,CAAC,CAAW,CAAC,CAAC;IACjD,CAAC;IAED,mBAAmB,EAAE,EAAE;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACzC,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,YAAY,CAAC,IAAI;IAC/B,UAAU,EAAE,IAAI;IAEhB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;QACf,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC;YACJ,0BAA0B;YAC1B,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC;gBACJ,4BAA4B;gBAC5B,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;IACF,CAAC;IAED,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;QACZ,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACJ,0BAA0B;gBAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC1C,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,uCAAuC;YAC9D,CAAC;YAAC,MAAM,CAAC;gBACR,IAAI,CAAC;oBACJ,oBAAoB;oBACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAC3C,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,yBAAyB;gBACjD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACzG,CAAC;YACF,CAAC;QACF,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3B,gCAAgC;YAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC1D,OAAO,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QACrD,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,kBAAkB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QACzB,uDAAuD;QACvD,OAAQ,CAAY,CAAC,aAAa,CAAC,CAAW,CAAC,CAAC;IACjD,CAAC;IAED,mBAAmB,EAAE,EAAE;CACvB,CAAC"}

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

@@ -0,0 +1,52 @@
+import type { SqlValue } from '../common/types.js';
+import type { LogicalType } from './logical-type.js';
+/**
+ * Validate a value against a logical type.
+ * Throws an error if the value is invalid.
+ *
+ * @param value The value to validate
+ * @param type The logical type to validate against
+ * @param columnName Optional column name for better error messages
+ * @returns The validated value
+ * @throws QuereusError if validation fails
+ */
+export declare function validateValue(value: SqlValue, type: LogicalType, columnName?: string): SqlValue;
+/**
+ * Parse/convert a value to match a logical type.
+ * This performs type conversion and normalization.
+ *
+ * @param value The value to parse
+ * @param type The logical type to convert to
+ * @param columnName Optional column name for better error messages
+ * @returns The parsed/converted value
+ * @throws QuereusError if conversion fails
+ */
+export declare function parseValue(value: SqlValue, type: LogicalType, columnName?: string): SqlValue;
+/**
+ * Validate and parse a value in one step.
+ * This is the main entry point for type checking at INSERT/UPDATE boundaries.
+ *
+ * @param value The value to validate and parse
+ * @param type The logical type
+ * @param columnName Optional column name for better error messages
+ * @returns The validated and parsed value
+ * @throws QuereusError if validation or parsing fails
+ */
+export declare function validateAndParse(value: SqlValue, type: LogicalType, columnName?: string): SqlValue;
+/**
+ * Check if a value is compatible with a logical type without throwing.
+ *
+ * @param value The value to check
+ * @param type The logical type
+ * @returns True if the value is valid for the type
+ */
+export declare function isValidForType(value: SqlValue, type: LogicalType): boolean;
+/**
+ * Try to parse a value, returning null if parsing fails.
+ *
+ * @param value The value to parse
+ * @param type The logical type
+ * @returns The parsed value, or null if parsing fails
+ */
+export declare function tryParse(value: SqlValue, type: LogicalType): SqlValue | null;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/types/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,MAAM,GACjB,QAAQ,CAcV;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,MAAM,GACjB,QAAQ,CAmBV;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,MAAM,GACjB,QAAQ,CAMV;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAI1E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI,CAM5E"}

package/dist/src/types/validation.js

@@ -0,0 +1,96 @@
+import { StatusCode } from '../common/types.js';
+import { QuereusError } from '../common/errors.js';
+/**
+ * Validate a value against a logical type.
+ * Throws an error if the value is invalid.
+ *
+ * @param value The value to validate
+ * @param type The logical type to validate against
+ * @param columnName Optional column name for better error messages
+ * @returns The validated value
+ * @throws QuereusError if validation fails
+ */
+export function validateValue(value, type, columnName) {
+    // NULL is always valid
+    if (value === null)
+        return null;
+    // Type-specific validation
+    if (type.validate && !type.validate(value)) {
+        const colInfo = columnName ? ` for column '${columnName}'` : '';
+        throw new QuereusError(`Type mismatch${colInfo}: expected ${type.name}, got ${typeof value}`, StatusCode.MISMATCH);
+    }
+    return value;
+}
+/**
+ * Parse/convert a value to match a logical type.
+ * This performs type conversion and normalization.
+ *
+ * @param value The value to parse
+ * @param type The logical type to convert to
+ * @param columnName Optional column name for better error messages
+ * @returns The parsed/converted value
+ * @throws QuereusError if conversion fails
+ */
+export function parseValue(value, type, columnName) {
+    // NULL is always valid
+    if (value === null)
+        return null;
+    // Type-specific parsing
+    if (type.parse) {
+        try {
+            return type.parse(value);
+        }
+        catch (error) {
+            const colInfo = columnName ? ` for column '${columnName}'` : '';
+            const message = error instanceof Error ? error.message : String(error);
+            throw new QuereusError(`Type conversion failed${colInfo}: ${message}`, StatusCode.MISMATCH);
+        }
+    }
+    return value;
+}
+/**
+ * Validate and parse a value in one step.
+ * This is the main entry point for type checking at INSERT/UPDATE boundaries.
+ *
+ * @param value The value to validate and parse
+ * @param type The logical type
+ * @param columnName Optional column name for better error messages
+ * @returns The validated and parsed value
+ * @throws QuereusError if validation or parsing fails
+ */
+export function validateAndParse(value, type, columnName) {
+    // Parse first (which may convert the value)
+    const parsed = parseValue(value, type, columnName);
+    // Then validate the parsed result
+    return validateValue(parsed, type, columnName);
+}
+/**
+ * Check if a value is compatible with a logical type without throwing.
+ *
+ * @param value The value to check
+ * @param type The logical type
+ * @returns True if the value is valid for the type
+ */
+export function isValidForType(value, type) {
+    if (value === null)
+        return true;
+    if (!type.validate)
+        return true;
+    return type.validate(value);
+}
+/**
+ * Try to parse a value, returning null if parsing fails.
+ *
+ * @param value The value to parse
+ * @param type The logical type
+ * @returns The parsed value, or null if parsing fails
+ */
+export function tryParse(value, type) {
+    try {
+        return parseValue(value, type);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/types/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC5B,KAAe,EACf,IAAiB,EACjB,UAAmB;IAEnB,uBAAuB;IACvB,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,2BAA2B;IAC3B,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,gBAAgB,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,YAAY,CACrB,gBAAgB,OAAO,cAAc,IAAI,CAAC,IAAI,SAAS,OAAO,KAAK,EAAE,EACrE,UAAU,CAAC,QAAQ,CACnB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACzB,KAAe,EACf,IAAiB,EACjB,UAAmB;IAEnB,uBAAuB;IACvB,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,wBAAwB;IACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,gBAAgB,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,YAAY,CACrB,yBAAyB,OAAO,KAAK,OAAO,EAAE,EAC9C,UAAU,CAAC,QAAQ,CACnB,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC/B,KAAe,EACf,IAAiB,EACjB,UAAmB;IAEnB,4CAA4C;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAEnD,kCAAkC;IAClC,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,IAAiB;IAChE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAe,EAAE,IAAiB;IAC1D,IAAI,CAAC;QACJ,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}