flint-orm 0.1.0 → 0.2.0

package/dist/entries/table.d.ts

@@ -1,4 +0,0 @@
-export { text, integer, boolean, json, date, real } from '../schema/columns';
-export type { ColumnDef, IntegerColumnDef, DateColumnDef, DateColumnDefWithDefault } from '../schema/columns';
-export { table, snakeCase } from '../schema/table';
-export type { InferRow, InsertRow, TableDef, AnyTable } from '../schema/table';

package/dist/entries/table.js

@@ -1,302 +0,0 @@
-// @bun
-// src/schema/columns.ts
-function nullCast() {
-  return null;
-}
-function makeColumn(config) {
-  const base = {
-    name: config.name,
-    __internal: {
-      _type: undefined,
-      sqlType: config.sqlType,
-      isPrimaryKey: false,
-      isNotNull: false,
-      isUnique: false,
-      hasDefault: false,
-      defaultValue: undefined,
-      defaultFn: undefined,
-      isAutoIncrement: false,
-      hasDefaultNow: false,
-      hasOnUpdate: false,
-      referencesTable: null,
-      referencesColumn: null,
-      encode: config.encode,
-      decode: config.decode,
-      tableName: null
-    }
-  };
-  const col = {
-    ...base,
-    primaryKey() {
-      return { ...this, __internal: { ...this.__internal, isPrimaryKey: true } };
-    },
-    notNull() {
-      return { ...this, __internal: { ...this.__internal, isNotNull: true } };
-    },
-    unique() {
-      return { ...this, __internal: { ...this.__internal, isUnique: true } };
-    },
-    default(value) {
-      return { ...this, __internal: { ...this.__internal, hasDefault: true, defaultValue: value } };
-    },
-    defaultFn(fn) {
-      return { ...this, __internal: { ...this.__internal, hasDefault: true, defaultFn: fn } };
-    },
-    references(target) {
-      return {
-        ...this,
-        __internal: {
-          ...this.__internal,
-          referencesTable: target.__internal.tableName,
-          referencesColumn: target.name
-        }
-      };
-    }
-  };
-  return col;
-}
-function text(name) {
-  return makeColumn({
-    name: name ?? "",
-    sqlType: "text",
-    encode: (v) => v,
-    decode: (v) => v == null ? nullCast() : v
-  });
-}
-function integer(name) {
-  const base = makeColumn({
-    name: name ?? "",
-    sqlType: "integer",
-    encode: (v) => v,
-    decode: (v) => v == null ? nullCast() : Number(v)
-  });
-  const intCol = {
-    ...base,
-    primaryKey() {
-      return {
-        ...this,
-        __internal: { ...this.__internal, isPrimaryKey: true }
-      };
-    },
-    notNull() {
-      return {
-        ...this,
-        __internal: { ...this.__internal, isNotNull: true }
-      };
-    },
-    unique() {
-      return {
-        ...this,
-        __internal: { ...this.__internal, isUnique: true }
-      };
-    },
-    default(value) {
-      return {
-        ...this,
-        __internal: { ...this.__internal, hasDefault: true, defaultValue: value }
-      };
-    },
-    defaultFn(fn) {
-      return {
-        ...this,
-        __internal: { ...this.__internal, hasDefault: true, defaultFn: fn }
-      };
-    },
-    autoIncrement() {
-      return {
-        ...this,
-        __internal: { ...this.__internal, isAutoIncrement: true }
-      };
-    }
-  };
-  return intCol;
-}
-function boolean(name) {
-  return makeColumn({
-    name: name ?? "",
-    sqlType: "integer",
-    encode: (v) => v ? 1 : 0,
-    decode: (v) => v == null ? nullCast() : Boolean(v)
-  });
-}
-function json(name) {
-  return makeColumn({
-    name: name ?? "",
-    sqlType: "text",
-    encode: (v) => v == null ? null : JSON.stringify(v),
-    decode: (v) => v == null ? nullCast() : JSON.parse(v)
-  });
-}
-function date(name) {
-  const base = makeColumn({
-    name: name ?? "",
-    sqlType: "integer",
-    encode: (v) => v == null ? null : v.getTime(),
-    decode: (v) => v == null ? nullCast() : new Date(v)
-  });
-  const dateCol = {
-    ...base,
-    primaryKey() {
-      return { ...this, __internal: { ...this.__internal, isPrimaryKey: true } };
-    },
-    notNull() {
-      return { ...this, __internal: { ...this.__internal, isNotNull: true } };
-    },
-    unique() {
-      return { ...this, __internal: { ...this.__internal, isUnique: true } };
-    },
-    default(value) {
-      return { ...this, __internal: { ...this.__internal, hasDefault: true, defaultValue: value } };
-    },
-    defaultFn(fn) {
-      return { ...this, __internal: { ...this.__internal, hasDefault: true, defaultFn: fn } };
-    },
-    defaultNow() {
-      return { ...this, __internal: { ...this.__internal, hasDefaultNow: true } };
-    },
-    onUpdate() {
-      return { ...this, __internal: { ...this.__internal, hasOnUpdate: true } };
-    }
-  };
-  return dateCol;
-}
-function real(name) {
-  return makeColumn({
-    name: name ?? "",
-    sqlType: "real",
-    encode: (v) => v,
-    decode: (v) => v == null ? nullCast() : Number(v)
-  });
-}
-// src/schema/table.ts
-function table(name, columns) {
-  const stamped = Object.create(null);
-  for (const [key, col] of Object.entries(columns)) {
-    const columnName = col.name || key;
-    const stampedInternal = { ...col.__internal, name: columnName, tableName: name };
-    const stampedCol = {
-      name: columnName,
-      __internal: stampedInternal,
-      primaryKey() {
-        return { ...this, __internal: { ...stampedInternal, isPrimaryKey: true } };
-      },
-      notNull() {
-        return { ...this, __internal: { ...stampedInternal, isNotNull: true } };
-      },
-      unique() {
-        return { ...this, __internal: { ...stampedInternal, isUnique: true } };
-      },
-      default(value) {
-        return {
-          ...this,
-          __internal: { ...stampedInternal, hasDefault: true, defaultValue: value }
-        };
-      },
-      defaultFn(fn) {
-        return { ...this, __internal: { ...stampedInternal, hasDefault: true, defaultFn: fn } };
-      },
-      references(target) {
-        return {
-          ...this,
-          __internal: {
-            ...stampedInternal,
-            referencesTable: target.__internal.tableName,
-            referencesColumn: target.name
-          }
-        };
-      }
-    };
-    if ("autoIncrement" in col) {
-      stampedCol.autoIncrement = function() {
-        return { ...this, __internal: { ...stampedInternal, isAutoIncrement: true } };
-      };
-    }
-    if ("defaultNow" in col) {
-      stampedCol.defaultNow = function() {
-        return { ...this, __internal: { ...stampedInternal, hasDefaultNow: true } };
-      };
-    }
-    if ("onUpdate" in col) {
-      stampedCol.onUpdate = function() {
-        return { ...this, __internal: { ...stampedInternal, hasOnUpdate: true } };
-      };
-    }
-    stamped[key] = stampedCol;
-  }
-  return Object.assign(stamped, {
-    _: { name }
-  });
-}
-function toSnakeCase(str) {
-  return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
-}
-function snakeCaseTable(tableName, columns) {
-  const converted = {};
-  for (const [key, col] of Object.entries(columns)) {
-    const sqlName = toSnakeCase(key);
-    const columnName = col.name || sqlName;
-    const stampedInternal = { ...col.__internal, name: columnName, tableName };
-    const stampedCol = {
-      name: columnName,
-      __internal: stampedInternal,
-      primaryKey() {
-        return { ...this, __internal: { ...stampedInternal, isPrimaryKey: true } };
-      },
-      notNull() {
-        return { ...this, __internal: { ...stampedInternal, isNotNull: true } };
-      },
-      unique() {
-        return { ...this, __internal: { ...stampedInternal, isUnique: true } };
-      },
-      default(value) {
-        return {
-          ...this,
-          __internal: { ...stampedInternal, hasDefault: true, defaultValue: value }
-        };
-      },
-      defaultFn(fn) {
-        return { ...this, __internal: { ...stampedInternal, hasDefault: true, defaultFn: fn } };
-      },
-      references(target) {
-        return {
-          ...this,
-          __internal: {
-            ...stampedInternal,
-            referencesTable: target.__internal.tableName,
-            referencesColumn: target.name
-          }
-        };
-      }
-    };
-    if ("autoIncrement" in col) {
-      stampedCol.autoIncrement = function() {
-        return { ...this, __internal: { ...stampedInternal, isAutoIncrement: true } };
-      };
-    }
-    if ("defaultNow" in col) {
-      stampedCol.defaultNow = function() {
-        return { ...this, __internal: { ...stampedInternal, hasDefaultNow: true } };
-      };
-    }
-    if ("onUpdate" in col) {
-      stampedCol.onUpdate = function() {
-        return { ...this, __internal: { ...stampedInternal, hasOnUpdate: true } };
-      };
-    }
-    converted[key] = stampedCol;
-  }
-  return table(tableName, converted);
-}
-var snakeCase = {
-  table: snakeCaseTable
-};
-export {
-  text,
-  table,
-  snakeCase,
-  real,
-  json,
-  integer,
-  date,
-  boolean
-};

package/dist/errors.d.ts

@@ -1,13 +0,0 @@
-/** Base error class for all flint-orm errors. */
-export declare class FlintError extends Error {
-    constructor(message: string);
-}
-/** Thrown when a value violates a column constraint or a validation rule fails. */
-export declare class FlintValidationError extends FlintError {
-    constructor(message: string);
-}
-/** Thrown when a SQL query fails to execute. */
-export declare class FlintQueryError extends FlintError {
-    readonly originalError?: Error;
-    constructor(message: string, originalError?: Error);
-}

package/dist/flint.d.ts

@@ -1,128 +0,0 @@
-import { Database } from 'bun:sqlite';
-import { DeleteBuilder } from './query/builder';
-import type { Executable, SelectStage1, InsertStage1, UpdateStage1, JoinSelectStage1 } from './query/builder';
-import type { AnyTable } from './schema/table';
-import type { Condition } from './query/conditions';
-import type { ColumnDef } from './schema/columns';
-export type { Executable, SelectStage1, InsertStage1, UpdateStage1, JoinSelectStage1, JoinBuilder, SingleJoinBuilder } from './query/builder';
-export type { JoinResult } from './query/builder';
-export interface ConnectionDetails {
-    /** Connection details for the SQLite database. */
-    url: string;
-}
-/**
- * Create a flint database client.
- *
- * @example
- * const db = flint({ url: "app.db" });
- */
-export declare function flint(details: ConnectionDetails): {
-    /**
-     * Start a SELECT query — call `.from(table)` next.
-     *
-     * @example
-     * const rows = db.select().from(users).execute()
-     */
-    select: () => SelectStage1;
-    /**
-     * Start an INSERT — call `.values(row)` next.
-     *
-     * @example
-     * db.insert(users).values({ id: "u1", name: "Alice" }).execute()
-     */
-    insert: <T extends AnyTable>(table: T) => InsertStage1<T>;
-    /**
-     * Start an UPDATE — call `.set(partial)` next.
-     *
-     * @example
-     * db.update(users).set({ name: "Bob" }).where(eq(users.id, "u1")).execute()
-     */
-    update: <T extends AnyTable>(table: T) => UpdateStage1<T>;
-    /**
-     * Start a DELETE — call `.where(condition)` next.
-     *
-     * @example
-     * db.delete(users).where(eq(users.id, "u1")).execute()
-     */
-    delete: <T extends AnyTable>(table: T) => DeleteBuilder<T, false, keyof import(".").InferRow<T>>;
-    /**
-     * Start a LEFT JOIN — call `.on(child)` next.
-     *
-     * @example
-     * db.leftJoin(users).on(posts).execute()
-     */
-    leftJoin: <Parent extends AnyTable>(parent: Parent) => JoinSelectStage1<Parent>;
-    /**
-     * Start an INNER JOIN — call `.on(child)` next.
-     *
-     * @example
-     * db.innerJoin(users).on(posts).execute()
-     */
-    innerJoin: <Parent extends AnyTable>(parent: Parent) => JoinSelectStage1<Parent>;
-    /**
-     * Run multiple queries atomically in a single transaction.
-     *
-     * @example
-     * db.batch([
-     *   db.insert(users).values({ id: "u1", name: "Alice" }),
-     *   db.insert(posts).values({ id: "p1", userId: "u1", title: "Hello" }),
-     * ])
-     */
-    batch: (queries: Executable[]) => void;
-    /**
-     * Count all rows in a table, optionally filtered by a condition.
-     *
-     * @example
-     * db.count(users)
-     */
-    count: <T extends AnyTable>(table: T, condition?: Condition) => number;
-    /**
-     * Count non-null values of a column, optionally filtered by a condition.
-     *
-     * @example
-     * db.countColumn(users, users.email)
-     */
-    countColumn: <T extends AnyTable, C extends ColumnDef<any, any>>(table: T, column: C, condition?: Condition) => number;
-    /**
-     * Sum non-null values of a column, optionally filtered by a condition.
-     *
-     * @example
-     * db.sum(orders, orders.amount)
-     */
-    sum: <T extends AnyTable, C extends ColumnDef<any, any>>(table: T, column: C, condition?: Condition) => number | null;
-    /**
-     * Average non-null values of a column, optionally filtered by a condition.
-     *
-     * @example
-     * db.avg(users, users.age)
-     */
-    avg: <T extends AnyTable, C extends ColumnDef<any, any>>(table: T, column: C, condition?: Condition) => number | null;
-    /**
-     * Find the minimum non-null value of a column, optionally filtered by a condition.
-     *
-     * @example
-     * db.min(users, users.age)
-     */
-    min: <T extends AnyTable, C extends ColumnDef<any, any>>(table: T, column: C, condition?: Condition) => number | null;
-    /**
-     * Find the maximum non-null value of a column, optionally filtered by a condition.
-     *
-     * @example
-     * db.max(users, users.age)
-     */
-    max: <T extends AnyTable, C extends ColumnDef<any, any>>(table: T, column: C, condition?: Condition) => number | null;
-    /** Direct access to the underlying `bun:sqlite` client. */
-    $client: Database;
-};
-/** A raw SQL expression with parameters. */
-export interface SQLExpression {
-    sql: string;
-    params: unknown[];
-}
-/**
- * Tagged template for building parameterized SQL expressions.
- *
- * @example
- * const expr = sql`name = ${"Alice"} AND age > ${18}`
- */
-export declare function sql(strings: TemplateStringsArray, ...values: unknown[]): SQLExpression;

package/dist/index.d.ts

@@ -1,9 +0,0 @@
-export { flint, sql } from './flint';
-export type { ConnectionDetails, SQLExpression, Executable, SelectStage1, InsertStage1, UpdateStage1 } from './flint';
-export { text, integer, boolean, json, date, real } from './schema/columns';
-export type { ColumnDef, IntegerColumnDef, DateColumnDef, DateColumnDefWithDefault } from './schema/columns';
-export { table, snakeCase } from './schema/table';
-export type { InferRow, InsertRow, TableDef, AnyTable } from './schema/table';
-export { eq, and, or, gt, gte, lt, lte, neq, isIn, isNotIn, isNull, isNotNull, like, glob, between } from './query/conditions';
-export type { Condition } from './query/conditions';
-export { count, countColumn, sum, avg, min, max } from './query/aggregates';

package/dist/query/aggregates.d.ts

@@ -1,47 +0,0 @@
-import type { Database } from 'bun:sqlite';
-import type { ColumnDef } from '../schema/columns';
-import type { AnyTable } from '../schema/table';
-import type { Condition } from './conditions';
-/**
- * Count all rows in a table, optionally filtered by a condition.
- *
- * @example
- * const total = db.count(users);
- * const active = db.count(users, eq(users.active, true));
- */
-export declare function count<T extends AnyTable>(client: Database, table: T, condition?: Condition): number;
-/**
- * Count non-null values of a column, optionally filtered by a condition.
- *
- * @example
- * const count = db.countColumn(users, users.email);
- */
-export declare function countColumn<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number;
-/**
- * Sum non-null values of a column, optionally filtered by a condition.
- *
- * @example
- * const total = db.sum(orders, orders.amount);
- */
-export declare function sum<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;
-/**
- * Average non-null values of a column, optionally filtered by a condition.
- *
- * @example
- * const avgAge = db.avg(users, users.age);
- */
-export declare function avg<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;
-/**
- * Find the minimum non-null value of a column, optionally filtered by a condition.
- *
- * @example
- * const minAge = db.min(users, users.age);
- */
-export declare function min<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;
-/**
- * Find the maximum non-null value of a column, optionally filtered by a condition.
- *
- * @example
- * const maxAge = db.max(users, users.age);
- */
-export declare function max<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;