sqlite-zod-orm 3.14.0 → 3.16.0

package/dist/index.js

@@ -5147,6 +5147,16 @@ function attachMethods(ctx, entityName, entity) {
       }
     }
   }
+  const computedGetters = ctx.computed[entityName];
+  if (computedGetters) {
+    for (const [key, fn] of Object.entries(computedGetters)) {
+      Object.defineProperty(augmented, key, {
+        get: () => fn(augmented),
+        enumerable: true,
+        configurable: true
+      });
+    }
+  }
   const storableFieldNames = new Set(getStorableFields(ctx.schemas[entityName]).map((f) => f.name));
   return new Proxy(augmented, {
     set: (target, prop, value) => {
@@ -5196,7 +5206,9 @@ class _Database {
       debug: this._debug,
       timestamps: this._timestamps,
       softDeletes: this._softDeletes,
-      hooks: options.hooks ?? {}
+      hooks: options.hooks ?? {},
+      computed: options.computed ?? {},
+      cascade: options.cascade ?? {}
     };
     this.initializeTables();
     if (this._reactive)
@@ -5227,6 +5239,20 @@ class _Database {
               if (result === false)
                 return;
             }
+            const cascadeTargets = this._ctx.cascade[entityName];
+            if (cascadeTargets) {
+              for (const childTable of cascadeTargets) {
+                const rel = this._ctx.relationships.find((r) => r.type === "belongs-to" && r.from === childTable && r.to === entityName);
+                if (rel) {
+                  if (this._softDeletes) {
+                    const now = new Date().toISOString();
+                    this.db.query(`UPDATE "${childTable}" SET "deletedAt" = ? WHERE "${rel.foreignKey}" = ?`).run(now, id);
+                  } else {
+                    this.db.query(`DELETE FROM "${childTable}" WHERE "${rel.foreignKey}" = ?`).run(id);
+                  }
+                }
+              }
+            }
             if (this._softDeletes) {
               const now = new Date().toISOString();
               this.db.query(`UPDATE "${entityName}" SET "deletedAt" = ? WHERE id = ?`).run(now, id);
@@ -5246,6 +5272,10 @@ class _Database {
           this.db.query(`UPDATE "${entityName}" SET "deletedAt" = NULL WHERE id = ?`).run(id);
         },
         select: (...cols) => createQueryBuilder(this._ctx, entityName, cols),
+        count: () => {
+          const row = this.db.query(`SELECT COUNT(*) as count FROM "${entityName}"${this._softDeletes ? ' WHERE "deletedAt" IS NULL' : ""}`).get();
+          return row?.count ?? 0;
+        },
         on: (event, callback) => {
           return this._registerListener(entityName, event, callback);
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqlite-zod-orm",
-  "version": "3.14.0",
+  "version": "3.16.0",
   "description": "Type-safe SQLite ORM for Bun — Zod schemas, fluent queries, auto relationships, zero SQL",
   "type": "module",
   "main": "./dist/index.js",

package/src/builder.ts

@@ -27,7 +27,7 @@ import {
  * - Object-style: `.where({ name: 'Alice', age: { $gt: 18 } })`
  * - Callback-style (AST): `.where((c, f, op) => op.and(op.eq(c.name, 'Alice'), op.gt(c.age, 18)))`
  */
-export class QueryBuilder<T extends Record<string, any>> {
+export class QueryBuilder<T extends Record<string, any>, TResult extends Record<string, any> = T> {
     private iqo: IQO;
     private tableName: string;
     private executor: (sql: string, params: any[], raw: boolean) => any[];
@@ -69,7 +69,9 @@ export class QueryBuilder<T extends Record<string, any>> {
     }
 
     /** Specify which columns to select. If called with no arguments, defaults to `*`. */
-    select(...cols: (keyof T & string)[]): this {
+    select(): this;
+    select<K extends keyof T & string>(...cols: K[]): QueryBuilder<T, Pick<T, K>>;
+    select(...cols: string[]): any {
         this.iqo.selects.push(...cols);
         return this;
     }
@@ -264,20 +266,20 @@ export class QueryBuilder<T extends Record<string, any>> {
     // ---------- Terminal / Execution Methods ----------
 
     /** Execute the query and return all matching rows. */
-    all(): T[] {
+    all(): TResult[] {
         const { sql, params } = compileIQO(this.tableName, this.iqo);
         const results = this.executor(sql, params, this.iqo.raw);
-        return this._applyEagerLoads(results);
+        return this._applyEagerLoads(results) as unknown as TResult[];
     }
 
     /** Execute the query and return the first matching row, or null. */
-    get(): T | null {
+    get(): TResult | null {
         this.iqo.limit = 1;
         const { sql, params } = compileIQO(this.tableName, this.iqo);
         const result = this.singleExecutor(sql, params, this.iqo.raw);
         if (!result) return null;
         const [loaded] = this._applyEagerLoads([result]);
-        return loaded ?? null;
+        return (loaded ?? null) as TResult | null;
     }
 
     /** Execute the query and return the count of matching rows. */
@@ -291,7 +293,7 @@ export class QueryBuilder<T extends Record<string, any>> {
     }
 
     /** Alias for get() — returns the first matching row or null. */
-    first(): T | null {
+    first(): TResult | null {
         return this.get();
     }
 
@@ -399,7 +401,7 @@ export class QueryBuilder<T extends Record<string, any>> {
     }
 
     /** Paginate results. Returns { data, total, page, perPage, pages }. */
-    paginate(page: number = 1, perPage: number = 20): { data: T[]; total: number; page: number; perPage: number; pages: number } {
+    paginate(page: number = 1, perPage: number = 20): { data: TResult[]; total: number; page: number; perPage: number; pages: number } {
         const total = this.count();
         const pages = Math.ceil(total / perPage);
         this.iqo.limit = perPage;
@@ -434,10 +436,10 @@ export class QueryBuilder<T extends Record<string, any>> {
 
     // ---------- Thenable (async/await support) ----------
 
-    then<TResult1 = T[], TResult2 = never>(
-        onfulfilled?: ((value: T[]) => TResult1 | PromiseLike<TResult1>) | null,
-        onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null,
-    ): Promise<TResult1 | TResult2> {
+    then<TThen1 = TResult[], TThen2 = never>(
+        onfulfilled?: ((value: TResult[]) => TThen1 | PromiseLike<TThen1>) | null,
+        onrejected?: ((reason: any) => TThen2 | PromiseLike<TThen2>) | null,
+    ): Promise<TThen1 | TThen2> {
         try {
             const result = this.all();
             return Promise.resolve(result).then(onfulfilled, onrejected);

package/src/context.ts

@@ -34,4 +34,10 @@ export interface DatabaseContext {
 
     /** Lifecycle hooks keyed by table name. */
     hooks: Record<string, TableHooks>;
+
+    /** Computed/virtual getters per table. */
+    computed: Record<string, Record<string, (entity: Record<string, any>) => any>>;
+
+    /** Cascade delete config — parent table → list of child tables to auto-delete. */
+    cascade: Record<string, string[]>;
 }

package/src/database.ts

@@ -87,6 +87,8 @@ class _Database<Schemas extends SchemaMap> {
             timestamps: this._timestamps,
             softDeletes: this._softDeletes,
             hooks: options.hooks ?? {},
+            computed: options.computed ?? {},
+            cascade: options.cascade ?? {},
         };
 
         this.initializeTables();
@@ -116,8 +118,27 @@ class _Database<Schemas extends SchemaMap> {
                             const result = hooks.beforeDelete(id);
                             if (result === false) return;
                         }
+
+                        // Cascade delete children first
+                        const cascadeTargets = this._ctx.cascade[entityName];
+                        if (cascadeTargets) {
+                            for (const childTable of cascadeTargets) {
+                                // Find FK from child → this parent via relationships
+                                const rel = this._ctx.relationships.find(
+                                    r => r.type === 'belongs-to' && r.from === childTable && r.to === entityName
+                                );
+                                if (rel) {
+                                    if (this._softDeletes) {
+                                        const now = new Date().toISOString();
+                                        this.db.query(`UPDATE "${childTable}" SET "deletedAt" = ? WHERE "${rel.foreignKey}" = ?`).run(now, id);
+                                    } else {
+                                        this.db.query(`DELETE FROM "${childTable}" WHERE "${rel.foreignKey}" = ?`).run(id);
+                                    }
+                                }
+                            }
+                        }
+
                         if (this._softDeletes) {
-                            // Soft delete: set deletedAt instead of removing
                             const now = new Date().toISOString();
                             this.db.query(`UPDATE "${entityName}" SET "deletedAt" = ? WHERE id = ?`).run(now, id);
                             if (hooks?.afterDelete) hooks.afterDelete(id);
@@ -133,6 +154,10 @@ class _Database<Schemas extends SchemaMap> {
                     this.db.query(`UPDATE "${entityName}" SET "deletedAt" = NULL WHERE id = ?`).run(id);
                 }) as any,
                 select: (...cols: string[]) => createQueryBuilder(this._ctx, entityName, cols),
+                count: () => {
+                    const row = this.db.query(`SELECT COUNT(*) as count FROM "${entityName}"${this._softDeletes ? ' WHERE "deletedAt" IS NULL' : ''}`).get() as any;
+                    return row?.count ?? 0;
+                },
                 on: (event: ChangeEvent, callback: (row: any) => void | Promise<void>) => {
                     return this._registerListener(entityName, event, callback);
                 },

package/src/entity.ts

@@ -47,6 +47,18 @@ export function attachMethods<T extends Record<string, any>>(
         }
     }
 
+    // Attach computed/virtual getters from context
+    const computedGetters = ctx.computed[entityName];
+    if (computedGetters) {
+        for (const [key, fn] of Object.entries(computedGetters)) {
+            Object.defineProperty(augmented, key, {
+                get: () => fn(augmented),
+                enumerable: true,
+                configurable: true,
+            });
+        }
+    }
+
     // Auto-persist proxy: setting a field auto-updates the DB row
     const storableFieldNames = new Set(getStorableFields(ctx.schemas[entityName]!).map(f => f.name));
     return new Proxy(augmented, {

package/src/types.ts

@@ -86,6 +86,20 @@ export type DatabaseOptions<R extends RelationsConfig = RelationsConfig> = {
      * - `afterDelete(id)` — called after delete
      */
     hooks?: Record<string, TableHooks>;
+    /**
+     * Computed/virtual getters per table. Injected on every read.
+     * ```ts
+     * computed: { users: { fullName: (u) => u.first + ' ' + u.last } }
+     * ```
+     */
+    computed?: Record<string, Record<string, (entity: Record<string, any>) => any>>;
+    /**
+     * Cascade delete config per table. When a parent is deleted, children are auto-deleted.
+     * ```ts
+     * cascade: { authors: ['books'] }  // deleting author → deletes their books
+     * ```
+     */
+    cascade?: Record<string, string[]>;
 };
 
 export type Relationship = {
@@ -209,7 +223,11 @@ export type NavEntityAccessor<
     findOrCreate: (conditions: Partial<z.infer<S[Table & keyof S]>>, defaults?: Partial<z.infer<S[Table & keyof S]>>) => { entity: NavEntity<S, R, Table>; created: boolean };
     delete: ((id: number) => void) & (() => DeleteBuilder<NavEntity<S, R, Table>>);
     restore: (id: number) => void;
-    select: (...cols: (keyof z.infer<S[Table & keyof S]> & string)[]) => QueryBuilder<NavEntity<S, R, Table>>;
+    select: {
+        (): QueryBuilder<NavEntity<S, R, Table>>;
+        <K extends (keyof z.infer<S[Table & keyof S]> | 'id') & string>(...cols: K[]): QueryBuilder<NavEntity<S, R, Table>, Pick<NavEntity<S, R, Table>, K>>;
+    };
+    count: () => number;
     on: ((event: 'insert' | 'update', callback: (row: NavEntity<S, R, Table>) => void | Promise<void>) => () => void) &
     ((event: 'delete', callback: (row: { id: number }) => void | Promise<void>) => () => void);
     _tableName: string;
@@ -243,7 +261,11 @@ export type EntityAccessor<S extends z.ZodType<any>> = {
     delete: ((id: number) => void) & (() => DeleteBuilder<AugmentedEntity<S>>);
     /** Undo a soft delete by setting deletedAt = null. Requires softDeletes. */
     restore: (id: number) => void;
-    select: (...cols: (keyof InferSchema<S> & string)[]) => QueryBuilder<AugmentedEntity<S>>;
+    select: {
+        (): QueryBuilder<AugmentedEntity<S>>;
+        <K extends (keyof InferSchema<S> | 'id') & string>(...cols: K[]): QueryBuilder<AugmentedEntity<S>, Pick<AugmentedEntity<S>, K>>;
+    };
+    count: () => number;
     on: ((event: 'insert' | 'update', callback: (row: AugmentedEntity<S>) => void | Promise<void>) => () => void) &
     ((event: 'delete', callback: (row: { id: number }) => void | Promise<void>) => () => void);
     _tableName: string;