@visorcraft/mongreldb-kit 0.7.0

package/dist/tsv.js

@@ -0,0 +1,102 @@
+// TSV codec matching the Rust/Python kit: header row of column names,
+// tab-separated cells, NULL = empty field, `\t \n \r \\` backslash-escaped.
+// Numbers/bools render as literal text; arrays/objects render as escaped JSON.
+// (An empty string round-trips as null — the documented limitation.)
+function escape(s) {
+    let o = '';
+    for (const c of s) {
+        if (c === '\\')
+            o += '\\\\';
+        else if (c === '\t')
+            o += '\\t';
+        else if (c === '\n')
+            o += '\\n';
+        else if (c === '\r')
+            o += '\\r';
+        else
+            o += c;
+    }
+    return o;
+}
+function unescape(s) {
+    let o = '';
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (c === '\\' && i + 1 < s.length) {
+            const n = s[++i];
+            o += n === 't' ? '\t' : n === 'n' ? '\n' : n === 'r' ? '\r' : n === '\\' ? '\\' : '\\' + n;
+        }
+        else {
+            o += c;
+        }
+    }
+    return o;
+}
+function cellToTsv(v) {
+    if (v === null || v === undefined)
+        return '';
+    if (typeof v === 'string')
+        return escape(v);
+    if (typeof v === 'boolean')
+        return v ? 'true' : 'false';
+    if (typeof v === 'number' || typeof v === 'bigint')
+        return String(v);
+    return escape(JSON.stringify(v));
+}
+export function rowsToTsv(table, rows) {
+    const cols = table.columns.map((c) => c.name);
+    const lines = [cols.join('\t')];
+    for (const row of rows) {
+        lines.push(cols.map((n) => cellToTsv(row[n] ?? null)).join('\t'));
+    }
+    return lines.join('\n') + '\n';
+}
+function parseCell(raw, ty) {
+    if (raw === '')
+        return null;
+    const text = unescape(raw);
+    switch (ty) {
+        case 'bool':
+            return text === 'true';
+        case 'int64':
+            return BigInt(text);
+        case 'float64':
+            return Number(text);
+        case 'embedding':
+        case 'sparse':
+        case 'bytes':
+            // These insert as arrays/buffers; json is carried as a JSON string.
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                return text;
+            }
+        default:
+            return text; // text, date, timestamp, json (JSON string)
+    }
+}
+export function tsvToRows(table, text) {
+    const lines = text.split('\n');
+    if (lines.length === 0 || lines[0] === '')
+        return [];
+    const names = lines[0].split('\t');
+    const types = names.map((n) => table.columns.find((c) => c.name === n)?.applicationType);
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i] === '')
+            continue;
+        const fields = lines[i].split('\t');
+        const row = {};
+        fields.forEach((f, j) => {
+            const name = names[j];
+            const ty = types[j];
+            if (name === undefined || ty === undefined)
+                return;
+            row[name] = parseCell(f, ty);
+        });
+        rows.push(row);
+    }
+    return rows;
+}
+//# sourceMappingURL=tsv.js.map

package/dist/tsv.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+import type { DefaultValue } from './defaults.js';
+export type ColumnStorageType = 'bool' | 'int64' | 'float64' | 'timestamp' | 'date' | 'text' | 'bytes' | 'json' | 'embedding' | 'sparse';
+export type PkValue = string | bigint | (string | bigint | null)[];
+export type ColumnApplicationType = ColumnStorageType;
+export interface ColumnSpec<TName extends string = string, TApp extends ColumnApplicationType = ColumnApplicationType, TNull extends boolean = boolean, TDefault extends DefaultValue | null = DefaultValue | null, TGenerated extends 'uuid' | 'now' | null = 'uuid' | 'now' | null> {
+    id: number;
+    name: TName;
+    storageType: ColumnStorageType;
+    applicationType: TApp;
+    nullable: TNull;
+    primaryKey: boolean;
+    default: TDefault;
+    generated: TGenerated;
+    /** Vector dimension for an `embedding` column (required for ANN). */
+    embeddingDim?: number;
+    /** Encrypt this column at rest (requires an encrypted database). */
+    encrypted?: boolean;
+    /** Encrypt but keep queryable via deterministic tokens. */
+    encryptedIndexable?: boolean;
+    enumValues?: string[];
+    check?: (value: unknown) => boolean | string;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    regex?: RegExp;
+}
+export interface IndexSpec {
+    name: string;
+    columns: string[];
+    unique: boolean;
+    /** Index kind; defaults to `bitmap`. `fm` enables FM substring search so
+     * `contains(col, needle)` pushes down to the engine instead of scanning. */
+    kind?: 'bitmap' | 'fm' | 'ann' | 'sparse' | 'minhash';
+}
+export interface ForeignKeySpec {
+    name: string;
+    columns: string[];
+    referencesTable: string;
+    referencesColumns: string[];
+    onDelete: 'cascade' | 'set null' | 'restrict';
+}
+export interface UniqueSpec {
+    name: string;
+    columns: string[];
+}
+export interface CheckSpec {
+    name: string;
+    expr: (row: Record<string, unknown>) => boolean | string;
+}
+export interface TableSpec<TColumns extends readonly ColumnSpec[] = readonly ColumnSpec[]> {
+    tableId: number;
+    name: string;
+    columns: TColumns;
+    primaryKey: string[];
+    indexes: IndexSpec[];
+    foreignKeys: ForeignKeySpec[];
+    unique: UniqueSpec[];
+    checks: CheckSpec[];
+    /**
+     * Look up a column spec by name. Use this for columns whose name shadows a
+     * table property (e.g. a column literally named `name`), which are not
+     * reachable as a direct `table.<column>` accessor.
+     */
+    column(name: string): ColumnSpec;
+}
+type ApplicationTypeMap = {
+    bool: boolean;
+    int64: bigint;
+    float64: number;
+    timestamp: string;
+    date: string;
+    text: string;
+    bytes: unknown;
+    json: unknown;
+    embedding: number[];
+    sparse: [number, number][];
+};
+type ApplicationType<T extends ColumnApplicationType> = ApplicationTypeMap[T];
+export type Row<T extends TableSpec> = {
+    [K in T['columns'][number] as K['name']]: K['nullable'] extends true ? ApplicationType<K['applicationType']> | null : ApplicationType<K['applicationType']>;
+};
+type ColumnToDefaultName<C> = C extends {
+    name: infer N;
+    nullable: infer Null;
+    default: infer D;
+    generated: infer G;
+} ? N extends string ? Null extends true ? never : D extends DefaultValue ? N : G extends 'uuid' | 'now' ? N : never : never : never;
+type ColumnsWithDefault<T extends TableSpec> = ColumnToDefaultName<T['columns'][number]>;
+type NullableColumnName<C> = C extends {
+    name: infer N;
+    nullable: infer Null;
+} ? N extends string ? Null extends true ? N : never : never : never;
+type NullableColumns<T extends TableSpec> = NullableColumnName<T['columns'][number]>;
+type OptionalInsertColumns<T extends TableSpec> = Extract<NullableColumns<T> | ColumnsWithDefault<T>, keyof Row<T>>;
+export type Insert<T extends TableSpec> = Omit<Row<T>, ColumnsWithDefault<T> | NullableColumns<T>> & Partial<Pick<Row<T>, OptionalInsertColumns<T>>>;
+export type Update<T extends TableSpec> = Partial<Row<T>>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,3 @@
+import type { TableSpec } from './types.js';
+export declare function validateRow(table: TableSpec, row: Record<string, unknown>): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,YAAY,CAAC;AAsI3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAchF"}

package/dist/validation.js

@@ -0,0 +1,98 @@
+import { KitValidationError } from './errors.js';
+function typeError(value, storageType) {
+    switch (storageType) {
+        case 'bool':
+            return typeof value === 'boolean' ? undefined : 'must be a boolean';
+        case 'int64':
+            return typeof value === 'bigint' ? undefined : 'must be a bigint';
+        case 'float64':
+            return typeof value === 'number' ? undefined : 'must be a number';
+        case 'text':
+            return typeof value === 'string' ? undefined : 'must be a string';
+        case 'bytes':
+            return value instanceof Uint8Array ? undefined : 'must be a Uint8Array';
+        case 'json': {
+            try {
+                JSON.stringify(value);
+                return undefined;
+            }
+            catch {
+                return 'must be JSON serializable';
+            }
+        }
+        case 'timestamp':
+            return typeof value === 'string' ? undefined : 'must be an ISO timestamp string';
+        case 'date':
+            return typeof value === 'string' ? undefined : 'must be a date string';
+    }
+}
+function validateColumn(tableName, column, value) {
+    if (value === null || value === undefined) {
+        if (!column.nullable) {
+            throw new KitValidationError(`Column "${column.name}" cannot be null`, tableName, column.name);
+        }
+        return;
+    }
+    const typeErr = typeError(value, column.storageType);
+    if (typeErr) {
+        throw new KitValidationError(`Column "${column.name}" ${typeErr}`, tableName, column.name);
+    }
+    if (column.enumValues && typeof value === 'string' && !column.enumValues.includes(value)) {
+        throw new KitValidationError(`Value "${value}" for "${column.name}" must be one of ${column.enumValues.join(', ')}`, tableName, column.name);
+    }
+    if (column.min !== undefined) {
+        if (typeof value === 'bigint') {
+            const min = BigInt(column.min);
+            if (value < min) {
+                throw new KitValidationError(`Value for "${column.name}" must be at least ${column.min}`, tableName, column.name);
+            }
+        }
+        else if (typeof value === 'number' && value < column.min) {
+            throw new KitValidationError(`Value for "${column.name}" must be at least ${column.min}`, tableName, column.name);
+        }
+    }
+    if (column.max !== undefined) {
+        if (typeof value === 'bigint') {
+            const max = BigInt(column.max);
+            if (value > max) {
+                throw new KitValidationError(`Value for "${column.name}" must be at most ${column.max}`, tableName, column.name);
+            }
+        }
+        else if (typeof value === 'number' && value > column.max) {
+            throw new KitValidationError(`Value for "${column.name}" must be at most ${column.max}`, tableName, column.name);
+        }
+    }
+    if (column.minLength !== undefined) {
+        const length = typeof value === 'string' ? value.length : value instanceof Uint8Array ? value.length : null;
+        if (length !== null && length < column.minLength) {
+            throw new KitValidationError(`Value for "${column.name}" must have length at least ${column.minLength}`, tableName, column.name);
+        }
+    }
+    if (column.maxLength !== undefined) {
+        const length = typeof value === 'string' ? value.length : value instanceof Uint8Array ? value.length : null;
+        if (length !== null && length > column.maxLength) {
+            throw new KitValidationError(`Value for "${column.name}" must have length at most ${column.maxLength}`, tableName, column.name);
+        }
+    }
+    if (column.regex && typeof value === 'string' && !column.regex.test(value)) {
+        throw new KitValidationError(`Value for "${column.name}" does not match required pattern`, tableName, column.name);
+    }
+    if (column.check) {
+        const result = column.check(value);
+        if (result !== true) {
+            throw new KitValidationError(typeof result === 'string' ? result : `Value for "${column.name}" failed custom check`, tableName, column.name);
+        }
+    }
+}
+export function validateRow(table, row) {
+    for (const column of table.columns) {
+        validateColumn(table.name, column, row[column.name]);
+    }
+    for (const check of table.checks) {
+        const result = check.expr(row);
+        if (result !== true) {
+            throw new KitValidationError(typeof result === 'string' ? result : `Table check "${check.name}" failed`, table.name);
+        }
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@visorcraft/mongreldb-kit",
+	"version": "0.7.0",
+	"description": "Application persistence layer for MongrelDB: schema DSL, typed query builder, migrations, and relational constraints (unique, foreign keys, cascade/set-null/restrict).",
+	"license": "MIT OR Apache-2.0",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"!dist/**/*.test.*"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/visorcraft/MongrelDB-Kit.git",
+		"directory": "packages/kit"
+	},
+	"homepage": "https://github.com/visorcraft/MongrelDB-Kit#readme",
+	"keywords": ["mongreldb", "database", "orm", "query-builder", "migrations", "schema"],
+	"sideEffects": false,
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	},
+	"scripts": {
+		"build": "tsc",
+		"check": "tsc --noEmit",
+		"test": "vitest run"
+	},
+	"engines": {
+		"node": ">=22.0.0"
+	},
+	"dependencies": {
+		"apache-arrow": "^21.1.0"
+	},
+	"peerDependencies": {
+		"@visorcraft/mongreldb": "*"
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"typescript": "^5.6.0",
+		"vitest": "^2.1.0"
+	}
+}