js-idb 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# js-idb
+
+A lightweight JSON database for TypeScript with schema validation and indexed search. Works in-memory or persisted to disk.
+
+## Install
+
+```bash
+npm install js-idb
+```
+
+## Usage
+
+```ts
+import { createDB } from "js-idb";
+
+const db = createDB({
+  collections: {
+    users: {
+      schema: {
+        name: { type: "string", index: true, indexSetting: { ignoreCase: true } },
+        age: { type: "number", index: true },
+        active: { type: "boolean" },
+        meta: { type: "object" },
+      },
+    },
+  },
+});
+
+// Add
+const doc = db.users.add({ name: "Josef", age: 30, active: true, meta: { role: "admin" } });
+// doc._id is auto-generated
+
+// Bulk insert
+db.users.addMany([
+  { name: "Karel", age: 25, active: true, meta: {} },
+  { name: "Anna", age: 35, active: false, meta: {} },
+]);
+
+// Get by ID
+db.users.get(doc._id);
+
+// Get all
+db.users.all();
+
+// Search (indexed fields only)
+db.users.find({ name: "josef" });         // exact (case-insensitive)
+db.users.find({ name: "jos%" });          // prefix
+db.users.find({ name: "%sef" });          // suffix
+db.users.find({ name: "%ose%" });         // contains
+db.users.find({ age: ">20" });            // range: >, >=, <, <=
+db.users.find({ name: "jos%", age: "<=30" }); // compound (intersection)
+
+// Update
+db.users.update(doc._id, { name: "Josef II" });
+
+// Remove
+db.users.remove(doc._id);
+
+// Clear collection
+db.users.clear();
+```
+
+## File persistence
+
+Pass a `path` to persist data as JSON files on disk. Omit it for in-memory only.
+
+```ts
+const db = createDB({
+  path: "./data",
+  collections: {
+    users: {
+      schema: {
+        name: { type: "string", index: true },
+      },
+    },
+  },
+});
+```
+
+Each collection is stored as `<name>.data.json` and `<name>.meta.json`. Indexes are rebuilt from data on load.
+
+## Schema
+
+Fields support four types: `string`, `number`, `boolean`, `object`.
+
+- `index: true` enables search on the field via `find()` (not supported for `object`)
+- `indexSetting: { ignoreCase: true }` for case-insensitive string indexes
+- `object` fields must be flat (no nesting)
+- All fields are required on `add`, partial updates are allowed on `update`
+
+## License
+
+MIT

package/dist/collection.d.ts

@@ -0,0 +1,24 @@
+import type { Schema, Document, InferDocument, StorageAdapter } from './types.js';
+export declare class Collection<S extends Schema> {
+    readonly name: string;
+    private schema;
+    private data;
+    private indexes;
+    private storage;
+    constructor(name: string, schema: S, storage: StorageAdapter);
+    private load;
+    private save;
+    private toDocument;
+    add(record: InferDocument<S>): Document<S>;
+    /** Single save at the end instead of per-record */
+    addMany(records: InferDocument<S>[]): Document<S>[];
+    get(id: string): Document<S> | undefined;
+    all(): Document<S>[];
+    /** All queried fields must be indexed. Compound queries intersect results. */
+    find(query: Record<string, string>): Document<S>[];
+    update(id: string, partial: Partial<InferDocument<S>>): Document<S>;
+    remove(id: string): void;
+    clear(): void;
+    get count(): number;
+}
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKlF,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,IAAI,CAAuC;IACnD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc;IAgB5D,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,UAAU;IAIlB,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAkB1C,mDAAmD;IACnD,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE;IAwBnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IAMxC,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE;IAIpB,8EAA8E;IAC9E,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE;IAgClD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAwBnE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAiBxB,KAAK,IAAI,IAAI;IAQb,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/collection.js

@@ -0,0 +1,163 @@
+import { Index } from './index-store.js';
+import { generateId } from './id.js';
+import { validateRecord } from './validation.js';
+export class Collection {
+    name;
+    schema;
+    data;
+    indexes;
+    storage;
+    constructor(name, schema, storage) {
+        this.name = name;
+        this.schema = schema;
+        this.storage = storage;
+        this.data = new Map();
+        this.indexes = new Map();
+        for (const [field, def] of Object.entries(schema)) {
+            if (def.index) {
+                this.indexes.set(field, new Index(field, def.type, def.indexSetting?.ignoreCase));
+            }
+        }
+        this.load();
+    }
+    load() {
+        const rawData = this.storage.readData(this.name);
+        if (!rawData)
+            return;
+        for (const [id, record] of Object.entries(rawData)) {
+            this.data.set(id, record);
+            for (const [field, index] of this.indexes) {
+                const val = record[field];
+                if (val !== undefined) {
+                    index.add(id, val);
+                }
+            }
+        }
+    }
+    save() {
+        const obj = {};
+        for (const [id, record] of this.data) {
+            obj[id] = record;
+        }
+        this.storage.writeData(this.name, obj);
+        this.storage.writeMeta(this.name, { schema: this.schema });
+    }
+    toDocument(id, record) {
+        return { _id: id, ...record };
+    }
+    add(record) {
+        validateRecord(record, this.schema, false);
+        const id = generateId();
+        const raw = { ...record };
+        this.data.set(id, raw);
+        for (const [field, index] of this.indexes) {
+            const val = raw[field];
+            if (val !== undefined) {
+                index.add(id, val);
+            }
+        }
+        this.save();
+        return this.toDocument(id, raw);
+    }
+    /** Single save at the end instead of per-record */
+    addMany(records) {
+        const docs = [];
+        for (const record of records) {
+            validateRecord(record, this.schema, false);
+            const id = generateId();
+            const raw = { ...record };
+            this.data.set(id, raw);
+            for (const [field, index] of this.indexes) {
+                const val = raw[field];
+                if (val !== undefined) {
+                    index.add(id, val);
+                }
+            }
+            docs.push(this.toDocument(id, raw));
+        }
+        this.save();
+        return docs;
+    }
+    get(id) {
+        const record = this.data.get(id);
+        if (!record)
+            return undefined;
+        return this.toDocument(id, record);
+    }
+    all() {
+        return [...this.data.entries()].map(([id, record]) => this.toDocument(id, record));
+    }
+    /** All queried fields must be indexed. Compound queries intersect results. */
+    find(query) {
+        const queryEntries = Object.entries(query);
+        if (queryEntries.length === 0) {
+            return this.all();
+        }
+        let resultIds = null;
+        for (const [field, queryStr] of queryEntries) {
+            const index = this.indexes.get(field);
+            if (!index) {
+                throw new Error(`Field "${field}" is not indexed. Add "index: true" to the schema to enable search.`);
+            }
+            const ids = new Set(index.find(queryStr));
+            if (resultIds === null) {
+                resultIds = ids;
+            }
+            else {
+                for (const id of resultIds) {
+                    if (!ids.has(id)) {
+                        resultIds.delete(id);
+                    }
+                }
+            }
+            if (resultIds.size === 0)
+                return [];
+        }
+        return [...resultIds].map(id => this.get(id));
+    }
+    update(id, partial) {
+        const existing = this.data.get(id);
+        if (!existing) {
+            throw new Error(`Record "${id}" not found`);
+        }
+        validateRecord(partial, this.schema, true);
+        for (const [field, index] of this.indexes) {
+            const newVal = partial[field];
+            if (newVal === undefined)
+                continue;
+            const oldVal = existing[field];
+            if (oldVal !== undefined) {
+                index.remove(id, oldVal);
+            }
+            index.add(id, newVal);
+        }
+        Object.assign(existing, partial);
+        this.save();
+        return this.toDocument(id, existing);
+    }
+    remove(id) {
+        const existing = this.data.get(id);
+        if (!existing) {
+            throw new Error(`Record "${id}" not found`);
+        }
+        for (const [field, index] of this.indexes) {
+            const val = existing[field];
+            if (val !== undefined) {
+                index.remove(id, val);
+            }
+        }
+        this.data.delete(id);
+        this.save();
+    }
+    clear() {
+        this.data.clear();
+        for (const index of this.indexes.values()) {
+            index.clear();
+        }
+        this.save();
+    }
+    get count() {
+        return this.data.size;
+    }
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

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

package/dist/database.d.ts

@@ -0,0 +1,14 @@
+import type { CollectionConfig } from './types.js';
+import { Collection } from './collection.js';
+type DBCollections<T extends Record<string, CollectionConfig>> = {
+    [K in keyof T]: Collection<T[K]['schema']>;
+};
+type DBInstance<T extends Record<string, CollectionConfig>> = DBCollections<T> & {
+    collection<K extends keyof T & string>(name: K): Collection<T[K]['schema']>;
+};
+export declare function createDB<T extends Record<string, CollectionConfig>>(options: {
+    path?: string;
+    collections: T;
+}): DBInstance<T>;
+export {};
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC3C,CAAC;AAEF,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IAC/E,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC7E,CAAC;AAEF,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACjE,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,CAAC,CAAA;CAAE,GACzC,UAAU,CAAC,CAAC,CAAC,CA4Bf"}

package/dist/database.js

@@ -0,0 +1,27 @@
+import { Collection } from './collection.js';
+import { MemoryAdapter, FileAdapter } from './storage.js';
+import { validateSchema } from './validation.js';
+export function createDB(options) {
+    const storage = options.path
+        ? new FileAdapter(options.path)
+        : new MemoryAdapter();
+    const collections = new Map();
+    for (const [name, config] of Object.entries(options.collections)) {
+        validateSchema(config.schema);
+        const col = new Collection(name, config.schema, storage);
+        collections.set(name, col);
+    }
+    const db = {};
+    for (const [name, col] of collections) {
+        db[name] = col;
+    }
+    db['collection'] = (name) => {
+        const col = collections.get(name);
+        if (!col) {
+            throw new Error(`Collection "${name}" does not exist`);
+        }
+        return col;
+    };
+    return db;
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUjD,MAAM,UAAU,QAAQ,CACtB,OAA0C;IAE1C,MAAM,OAAO,GAAmB,OAAO,CAAC,IAAI;QAC1C,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC;IAExB,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE1D,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACjE,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzD,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,EAAE,GAAG,EAA6B,CAAC;IAEzC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC;QACtC,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,kBAAkB,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,OAAO,EAAmB,CAAC;AAC7B,CAAC"}

package/dist/id.d.ts

@@ -0,0 +1,2 @@
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,IAAI,MAAM,CAOnC"}

package/dist/id.js

@@ -0,0 +1,7 @@
+export function generateId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return Array.from({ length: 32 }, () => Math.floor(Math.random() * 16).toString(16)).join('');
+}
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7E,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAC5C,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC"}

package/dist/index-store.d.ts

@@ -0,0 +1,33 @@
+import type { FieldType } from './types.js';
+/** Sorted array + binary search index over a single field */
+export declare class Index {
+    readonly field: string;
+    readonly fieldType: FieldType;
+    readonly ignoreCase: boolean;
+    private entries;
+    constructor(field: string, fieldType: FieldType, ignoreCase?: boolean);
+    private normalize;
+    /** Returns index of first entry with value >= target */
+    private lowerBound;
+    private compare;
+    add(id: string, value: string | number | boolean): void;
+    remove(id: string, value: string | number | boolean): void;
+    /**
+     * Query patterns:
+     *   Strings: 'josef' (exact), 'josef%' (prefix), '%josef' (suffix), '%josef%' (contains)
+     *   Numbers: '30' (exact), '>10', '>=20', '<50', '<=30'
+     *   Booleans: 'true', 'false'
+     */
+    find(query: string): string[];
+    private exactQuery;
+    /** O(log n + k) — binary search to prefix start, scan forward */
+    private prefixQuery;
+    /** O(n) — must scan all entries */
+    private suffixQuery;
+    /** O(n) — must scan all entries */
+    private containsQuery;
+    private rangeQuery;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=index-store.d.ts.map

package/dist/index-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-store.d.ts","sourceRoot":"","sources":["../src/index-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAO5C,6DAA6D;AAC7D,qBAAa,KAAK;IAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,UAAQ;IAMnE,OAAO,CAAC,SAAS;IAOjB,wDAAwD;IACxD,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,OAAO;IAMf,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;IAOvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;IAa1D;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAyC7B,OAAO,CAAC,UAAU;IAWlB,iEAAiE;IACjE,OAAO,CAAC,WAAW;IAanB,mCAAmC;IACnC,OAAO,CAAC,WAAW;IAOnB,mCAAmC;IACnC,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,UAAU;IA4BlB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/index-store.js

@@ -0,0 +1,177 @@
+/** Sorted array + binary search index over a single field */
+export class Index {
+    field;
+    fieldType;
+    ignoreCase;
+    entries = [];
+    constructor(field, fieldType, ignoreCase = false) {
+        this.field = field;
+        this.fieldType = fieldType;
+        this.ignoreCase = ignoreCase;
+    }
+    normalize(value) {
+        if (this.ignoreCase && typeof value === 'string') {
+            return value.toLowerCase();
+        }
+        return value;
+    }
+    /** Returns index of first entry with value >= target */
+    lowerBound(target) {
+        let lo = 0;
+        let hi = this.entries.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >>> 1;
+            if (this.compare(this.entries[mid].value, target) < 0) {
+                lo = mid + 1;
+            }
+            else {
+                hi = mid;
+            }
+        }
+        return lo;
+    }
+    compare(a, b) {
+        if (a < b)
+            return -1;
+        if (a > b)
+            return 1;
+        return 0;
+    }
+    add(id, value) {
+        const normalized = this.normalize(value);
+        const entry = { value: normalized, id };
+        const idx = this.lowerBound(normalized);
+        this.entries.splice(idx, 0, entry);
+    }
+    remove(id, value) {
+        const normalized = this.normalize(value);
+        const idx = this.lowerBound(normalized);
+        for (let i = idx; i < this.entries.length; i++) {
+            const entry = this.entries[i];
+            if (entry.value !== normalized)
+                break;
+            if (entry.id === id) {
+                this.entries.splice(i, 1);
+                return;
+            }
+        }
+    }
+    /**
+     * Query patterns:
+     *   Strings: 'josef' (exact), 'josef%' (prefix), '%josef' (suffix), '%josef%' (contains)
+     *   Numbers: '30' (exact), '>10', '>=20', '<50', '<=30'
+     *   Booleans: 'true', 'false'
+     */
+    find(query) {
+        if (this.fieldType === 'number') {
+            const rangeMatch = query.match(/^(>=?|<=?)(.+)$/);
+            if (rangeMatch) {
+                const op = rangeMatch[1];
+                const num = Number(rangeMatch[2]);
+                if (Number.isNaN(num)) {
+                    throw new Error(`Invalid numeric query: "${query}"`);
+                }
+                return this.rangeQuery(op, num);
+            }
+            const num = Number(query);
+            if (!Number.isNaN(num)) {
+                return this.exactQuery(num);
+            }
+            throw new Error(`Invalid query for number field: "${query}"`);
+        }
+        if (this.fieldType === 'boolean') {
+            if (query === 'true')
+                return this.exactQuery(true);
+            if (query === 'false')
+                return this.exactQuery(false);
+            throw new Error(`Invalid query for boolean field: "${query}" (use "true" or "false")`);
+        }
+        const startsWithWild = query.startsWith('%');
+        const endsWithWild = query.endsWith('%');
+        if (startsWithWild && endsWithWild && query.length > 1) {
+            return this.containsQuery(query.slice(1, -1));
+        }
+        if (endsWithWild) {
+            return this.prefixQuery(query.slice(0, -1));
+        }
+        if (startsWithWild) {
+            return this.suffixQuery(query.slice(1));
+        }
+        const normalized = this.ignoreCase ? query.toLowerCase() : query;
+        return this.exactQuery(normalized);
+    }
+    exactQuery(target) {
+        const idx = this.lowerBound(target);
+        const results = [];
+        for (let i = idx; i < this.entries.length; i++) {
+            const entry = this.entries[i];
+            if (entry.value !== target)
+                break;
+            results.push(entry.id);
+        }
+        return results;
+    }
+    /** O(log n + k) — binary search to prefix start, scan forward */
+    prefixQuery(prefix) {
+        const normalized = this.ignoreCase ? prefix.toLowerCase() : prefix;
+        const idx = this.lowerBound(normalized);
+        const results = [];
+        for (let i = idx; i < this.entries.length; i++) {
+            const entry = this.entries[i];
+            const val = String(entry.value);
+            if (!val.startsWith(normalized))
+                break;
+            results.push(entry.id);
+        }
+        return results;
+    }
+    /** O(n) — must scan all entries */
+    suffixQuery(suffix) {
+        const normalized = this.ignoreCase ? suffix.toLowerCase() : suffix;
+        return this.entries
+            .filter(e => String(e.value).endsWith(normalized))
+            .map(e => e.id);
+    }
+    /** O(n) — must scan all entries */
+    containsQuery(sub) {
+        const normalized = this.ignoreCase ? sub.toLowerCase() : sub;
+        return this.entries
+            .filter(e => String(e.value).includes(normalized))
+            .map(e => e.id);
+    }
+    rangeQuery(op, target) {
+        const results = [];
+        if (op === '>' || op === '>=') {
+            const idx = this.lowerBound(target);
+            for (let i = idx; i < this.entries.length; i++) {
+                const entry = this.entries[i];
+                const val = entry.value;
+                if (op === '>' && val === target)
+                    continue;
+                results.push(entry.id);
+            }
+        }
+        else {
+            const idx = this.lowerBound(target);
+            for (let i = 0; i < idx; i++) {
+                results.push(this.entries[i].id);
+            }
+            if (op === '<=') {
+                for (let i = idx; i < this.entries.length; i++) {
+                    const entry = this.entries[i];
+                    if (entry.value !== target)
+                        break;
+                    results.push(entry.id);
+                }
+            }
+        }
+        return results;
+    }
+    clear() {
+        this.entries = [];
+    }
+    get size() {
+        return this.entries.length;
+    }
+}
+//# sourceMappingURL=index-store.js.map

package/dist/index-store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createDB } from './database.js';
+export { Collection } from './collection.js';
+export { Index } from './index-store.js';
+export { MemoryAdapter, FileAdapter } from './storage.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createDB } from './database.js';
+export { Collection } from './collection.js';
+export { Index } from './index-store.js';
+export { MemoryAdapter, FileAdapter } from './storage.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,20 @@
+import type { StorageAdapter, CollectionMeta } from './types.js';
+export declare class MemoryAdapter implements StorageAdapter {
+    private dataStore;
+    private metaStore;
+    readData(collection: string): Record<string, Record<string, unknown>> | null;
+    writeData(collection: string, data: Record<string, Record<string, unknown>>): void;
+    readMeta(collection: string): CollectionMeta | null;
+    writeMeta(collection: string, meta: CollectionMeta): void;
+}
+export declare class FileAdapter implements StorageAdapter {
+    private basePath;
+    constructor(basePath: string);
+    private dataPath;
+    private metaPath;
+    readData(collection: string): Record<string, Record<string, unknown>> | null;
+    writeData(collection: string, data: Record<string, Record<string, unknown>>): void;
+    readMeta(collection: string): CollectionMeta | null;
+    writeMeta(collection: string, meta: CollectionMeta): void;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,SAAS,CAA8D;IAC/E,OAAO,CAAC,SAAS,CAAqC;IAEtD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAI5E,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAIlF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAInD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;CAG1D;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAO5B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,QAAQ;IAIhB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAM5E,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAIlF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAMnD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;CAG1D"}

package/dist/storage.js

@@ -0,0 +1,52 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+export class MemoryAdapter {
+    dataStore = new Map();
+    metaStore = new Map();
+    readData(collection) {
+        return this.dataStore.get(collection) ?? null;
+    }
+    writeData(collection, data) {
+        this.dataStore.set(collection, data);
+    }
+    readMeta(collection) {
+        return this.metaStore.get(collection) ?? null;
+    }
+    writeMeta(collection, meta) {
+        this.metaStore.set(collection, meta);
+    }
+}
+export class FileAdapter {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+        if (!existsSync(basePath)) {
+            mkdirSync(basePath, { recursive: true });
+        }
+    }
+    dataPath(collection) {
+        return join(this.basePath, `${collection}.data.json`);
+    }
+    metaPath(collection) {
+        return join(this.basePath, `${collection}.meta.json`);
+    }
+    readData(collection) {
+        const p = this.dataPath(collection);
+        if (!existsSync(p))
+            return null;
+        return JSON.parse(readFileSync(p, 'utf-8'));
+    }
+    writeData(collection, data) {
+        writeFileSync(this.dataPath(collection), JSON.stringify(data, null, 2));
+    }
+    readMeta(collection) {
+        const p = this.metaPath(collection);
+        if (!existsSync(p))
+            return null;
+        return JSON.parse(readFileSync(p, 'utf-8'));
+    }
+    writeMeta(collection, meta) {
+        writeFileSync(this.metaPath(collection), JSON.stringify(meta, null, 2));
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,OAAO,aAAa;IAChB,SAAS,GAAG,IAAI,GAAG,EAAmD,CAAC;IACvE,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEtD,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,IAA6C;QACzE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,IAAoB;QAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IACd,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,UAAkB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,UAAU,YAAY,CAAC,CAAC;IACxD,CAAC;IAEO,QAAQ,CAAC,UAAkB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,UAAU,YAAY,CAAC,CAAC;IACxD,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAA4C,CAAC;IACzF,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,IAA6C;QACzE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAmB,CAAC;IAChE,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,IAAoB;QAChD,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+export type FieldType = 'string' | 'number' | 'boolean' | 'object';
+export interface IndexSetting {
+    ignoreCase?: boolean;
+}
+export interface FieldDefinition {
+    type: FieldType;
+    index?: boolean;
+    /** Only valid for string fields with index: true */
+    indexSetting?: IndexSetting;
+}
+export type Schema = Record<string, FieldDefinition>;
+export type InferFieldType<T extends FieldType> = T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : T extends 'object' ? Record<string, unknown> : never;
+export type InferDocument<S extends Schema> = {
+    [K in keyof S]: InferFieldType<S[K]['type']>;
+};
+export type Document<S extends Schema> = InferDocument<S> & {
+    _id: string;
+};
+export interface CollectionConfig {
+    schema: Schema;
+}
+export interface DatabaseOptions<T extends Record<string, CollectionConfig> = Record<string, CollectionConfig>> {
+    /** Omit for in-memory (browser). Provide for file persistence (Node.js). */
+    path?: string;
+    collections: T;
+}
+export interface StorageAdapter {
+    readData(collection: string): Record<string, Record<string, unknown>> | null;
+    writeData(collection: string, data: Record<string, Record<string, unknown>>): void;
+    readMeta(collection: string): CollectionMeta | null;
+    writeMeta(collection: string, meta: CollectionMeta): void;
+}
+/** Indexes are rebuilt from data on load, so meta only stores the schema */
+export interface CollectionMeta {
+    schema: Schema;
+}
+//# 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":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAErD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,IAC5C,CAAC,SAAS,QAAQ,GAAG,MAAM,GAC3B,CAAC,SAAS,QAAQ,GAAG,MAAM,GAC3B,CAAC,SAAS,SAAS,GAAG,OAAO,GAC7B,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C,KAAK,CAAC;AAER,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI;KAC3C,CAAC,IAAI,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAC5G,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,CAAC,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7E,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACpD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CAC3D;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB"}

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,7 @@
+import type { Schema } from './types.js';
+export declare function validateSchema(schema: Schema): void;
+/**
+ * @param isPartial - true for update (missing fields allowed), false for add (all required)
+ */
+export declare function validateRecord(record: Record<string, unknown>, schema: Schema, isPartial: boolean): 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":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,GACjB,IAAI,CAgDN"}

package/dist/validation.js

@@ -0,0 +1,62 @@
+export function validateSchema(schema) {
+    for (const [field, def] of Object.entries(schema)) {
+        if (def.index && def.type === 'object') {
+            throw new Error(`Field "${field}": cannot index 'object' type fields`);
+        }
+        if (def.indexSetting && !def.index) {
+            throw new Error(`Field "${field}": indexSetting requires index: true`);
+        }
+        if (def.indexSetting && def.type !== 'string') {
+            throw new Error(`Field "${field}": indexSetting is only valid for 'string' type fields`);
+        }
+    }
+}
+/**
+ * @param isPartial - true for update (missing fields allowed), false for add (all required)
+ */
+export function validateRecord(record, schema, isPartial) {
+    const schemaKeys = new Set(Object.keys(schema));
+    for (const key of Object.keys(record)) {
+        if (!schemaKeys.has(key)) {
+            throw new Error(`Unknown field "${key}" is not defined in the schema`);
+        }
+    }
+    for (const [field, def] of Object.entries(schema)) {
+        const value = record[field];
+        if (value === undefined) {
+            if (!isPartial) {
+                throw new Error(`Missing required field "${field}"`);
+            }
+            continue;
+        }
+        switch (def.type) {
+            case 'string':
+                if (typeof value !== 'string') {
+                    throw new Error(`Field "${field}" must be of type string, got ${typeof value}`);
+                }
+                break;
+            case 'number':
+                if (typeof value !== 'number' || Number.isNaN(value)) {
+                    throw new Error(`Field "${field}" must be of type number`);
+                }
+                break;
+            case 'boolean':
+                if (typeof value !== 'boolean') {
+                    throw new Error(`Field "${field}" must be of type boolean, got ${typeof value}`);
+                }
+                break;
+            case 'object':
+                if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+                    throw new Error(`Field "${field}" must be a plain object`);
+                }
+                // Flat only — no nested objects allowed
+                for (const [k, v] of Object.entries(value)) {
+                    if (typeof v === 'object' && v !== null) {
+                        throw new Error(`Field "${field}.${k}" contains a nested object — only flat objects are allowed`);
+                    }
+                }
+                break;
+        }
+    }
+}
+//# 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,35 @@
+{
+  "name": "js-idb",
+  "version": "0.1.0",
+  "description": "Simple JSON database with fast search over data via indexes and type checking",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "prepublishOnly": "npm run build",
+    "preversion": "npm test && npm run build",
+    "version": "conventional-changelog -p angular -i CHANGELOG.md -s && git add CHANGELOG.md"
+  },
+  "keywords": [
+    "database",
+    "json",
+    "index",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.13",
+    "conventional-changelog-cli": "^5.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  }
+}