@stacksjs/database 0.70.86 → 0.70.88

package/dist/unique-audit.d.ts

@@ -1,60 +0,0 @@
-/**
- * Walk every model file (user + framework defaults) and return the
- * full list of declared unique constraints — both single-column
- * `unique: true` attributes and `unique: true` composite indexes.
- */
-export declare function getDeclaredUniques(): Promise<DeclaredUnique[]>;
-/**
- * Query the live database for every UNIQUE index, returning a
- * normalised `{ table, name, columns }` shape. Dialect-aware: PRAGMA
- * on SQLite, information_schema / pg_index on MySQL / PostgreSQL.
- *
- * The optional `dialect` parameter is the test seam — production code
- * leaves it undefined so it's derived from `DB_CONNECTION`.
- */
-export declare function getLiveUniqueIndexes(dialect?: Dialect): Promise<LiveUniqueIndex[]>;
-/**
- * Diff declared unique constraints against live UNIQUE indexes. A
- * declared entry is satisfied iff some live unique index on the same
- * table has an equal column SET (sorted, case-insensitive). Declared
- * entries whose table is absent from the live DB go to `skippedTables`
- * (feature-gated commerce/CMS models legitimately have no table yet)
- * rather than `missing`.
- */
-export declare function auditUniqueIndexes(dialect?: Dialect): Promise<UniqueAuditResult>;
-// stacksjs/stacks#1952 — Unique-index drift audit. Compares each
-// model's declared uniqueness (`unique: true` attributes and
-// `unique: true` composite indexes) against the UNIQUE indexes that
-// actually exist in the live database.
-//
-// This is the `buddy doctor` companion to the migrate-side self-heal
-// (#1952): `buddy migrate` already re-queues missing unique-index
-// migrations, but that only fires when you run migrate, doesn't help
-// apps scaffolded during the stub era (whose own repos carry
-// `SELECT 1;` stub migrations), and hard-fails mid-migrate on
-// pre-existing duplicate rows instead of reporting first. This audit
-// surfaces the drift read-only, before you migrate.
-//
-// Matching is by COLUMN SET, never by index name — the generator
-// emits names like `users_users_email_unique` while migration
-// filenames say `users_email_unique`, so names are not stable.
-export declare interface DeclaredUnique {
-  table: string
-  columns: string[]
-  model: string
-  source: 'attribute' | 'index'
-  indexName?: string
-}
-export declare interface LiveUniqueIndex {
-  table: string
-  name: string
-  columns: string[]
-}
-export declare interface UniqueAuditResult {
-  supported: boolean
-  declared: DeclaredUnique[]
-  live: LiveUniqueIndex[]
-  missing: DeclaredUnique[]
-  skippedTables: string[]
-}
-declare type Dialect = 'sqlite' | 'mysql' | 'postgres' | 'other';

package/dist/utils.d.ts

@@ -1,189 +0,0 @@
-import { createQueryBuilder, setConfig } from '@stacksjs/query-builder';
-export declare function acquireDbConfigLock(): Promise<() => void>;
-// Function to initialize the config when it's available
-export declare function initializeDbConfig(config: any): void;
-export declare function ensureDatabaseConfigLoaded(): Promise<void>;
-declare function getDb(): ReturnType<typeof createQueryBuilder>;
-/**
- * Lazy proxy for the query builder - connection is only made when first used.
- * This is the main entry point for database operations.
- */
-export declare const db: Proxy;
-/**
- * Fluent chain returned by entry-point methods like `selectFrom`/`updateTable`.
- *
- * bun-query-builder marks legacy chain methods (e.g. `selectAll`, `whereILike`,
- * `selectAllRelations`) as optional in its declarations even though they're
- * always present at runtime. Re-typing them here avoids forcing every call
- * site to use `?.()` or `!` on the chain.
- *
- * Returns are typed as `any` deliberately — typing each variant precisely
- * would re-introduce the optional methods, and we already lose strict column
- * typing one step into a chain (the underlying query builder is constructed
- * with no schema). Tests cover the runtime semantics.
- */
-export declare interface FluentChain {
-  where(callback: (eb: import('./types').StacksExpressionBuilder) => unknown): FluentChain
-  where(...args: any[]): FluentChain
-  whereNull: (...args: any[]) => FluentChain
-  whereNotNull: (...args: any[]) => FluentChain
-  whereIn: (...args: any[]) => FluentChain
-  whereNotIn: (...args: any[]) => FluentChain
-  whereLike: (...args: any[]) => FluentChain
-  whereNotLike: (...args: any[]) => FluentChain
-  whereILike: (...args: any[]) => FluentChain
-  whereNotILike: (...args: any[]) => FluentChain
-  whereBetween: (...args: any[]) => FluentChain
-  whereNotBetween: (...args: any[]) => FluentChain
-  whereRaw: (...args: any[]) => FluentChain
-  whereColumn: (...args: any[]) => FluentChain
-  orWhere: (...args: any[]) => FluentChain
-  orWhereNull: (...args: any[]) => FluentChain
-  orWhereNotNull: (...args: any[]) => FluentChain
-  orWhereIn: (...args: any[]) => FluentChain
-  orWhereNotIn: (...args: any[]) => FluentChain
-  orWhereLike: (...args: any[]) => FluentChain
-  orWhereNotLike: (...args: any[]) => FluentChain
-  orWhereILike: (...args: any[]) => FluentChain
-  orWhereColumn: (...args: any[]) => FluentChain
-  andWhere: (...args: any[]) => FluentChain
-  having: (...args: any[]) => FluentChain
-  groupBy: (...args: any[]) => FluentChain
-  orderBy: (...args: any[]) => FluentChain
-  limit: (...args: any[]) => FluentChain
-  offset: (...args: any[]) => FluentChain
-  select(selection: ((eb: import('./types').StacksExpressionBuilder) => unknown) | ReadonlyArray<string | ((eb: import('./types').StacksExpressionBuilder) => unknown) | unknown>): FluentChain
-  select(...args: any[]): FluentChain
-  selectAll: () => FluentChain
-  selectAllRelations: () => FluentChain
-  selectRaw: (...args: any[]) => FluentChain
-  distinct: () => FluentChain
-  distinctOn: (...args: any[]) => FluentChain
-  innerJoin: (...args: any[]) => FluentChain
-  leftJoin: (...args: any[]) => FluentChain
-  rightJoin: (...args: any[]) => FluentChain
-  fullJoin: (...args: any[]) => FluentChain
-  crossJoin: (...args: any[]) => FluentChain
-  with: (...args: any[]) => FluentChain
-  union: (...args: any[]) => FluentChain
-  unionAll: (...args: any[]) => FluentChain
-  values: (...args: any[]) => FluentChain
-  set: (...args: any[]) => FluentChain
-  returning: (...args: any[]) => FluentChain
-  returningAll: () => FluentChain
-  onConflict: (...args: any[]) => FluentChain
-  onDuplicateKeyUpdate: (...args: any[]) => FluentChain
-  onConflictDoNothing: (...args: any[]) => FluentChain
-  onDuplicateKeyIgnore: () => FluentChain
-  forUpdate: () => FluentChain
-  forShare: () => FluentChain
-  toSQL: () => string
-  execute: () => Promise<any>
-  executeTakeFirst: () => Promise<any>
-  executeTakeFirstOrThrow: () => Promise<any>
-  pluck: (...args: any[]) => Promise<any>
-  count: (...args: any[]) => Promise<number>
-  sum: (...args: any[]) => Promise<number>
-  avg: (...args: any[]) => Promise<number>
-  min: (...args: any[]) => Promise<any>
-  max: (...args: any[]) => Promise<any>
-  exists: () => Promise<boolean>
-  doesntExist: () => Promise<boolean>
-  $call: (callback: (query: FluentChain) => FluentChain) => FluentChain
-  [key: string]: any
-}
-/*.ts` and
- * emits `database/types.d.ts` containing:
- *
- * ```ts
- * declare module '@stacksjs/database' {
- *   interface DatabaseSchema {
- *     court_houses: { columns: { id: number; name: string; ... } }
- *     judges:       { columns: { id: number; name: string; court_id: number; ... } }
- *   }
- * }
- * ```
- *
- * Once that file is loaded into the TS project, `db.selectFrom('co|')`
- * autocompletes to known table names. Apps without a generated file
- * still compile — the `(string & {})` branch on `TableName` keeps the
- * type as a literal-union+escape-hatch, so any string is accepted
- * but known keys are surfaced first by the language server.
- */
-// eslint-disable-next-line ts/no-empty-object-type
-export declare interface DatabaseSchema {}
-declare interface Db extends Pick<Required<RawQueryBuilder>, GenericPassthroughKeys> {
-  fn: import('./types').ExpressionFunctions
-  selectFrom: (table: TableName) => FluentChain
-  insertInto: (table: TableName) => FluentChain
-  updateTable: (table: TableName) => FluentChain
-  deleteFrom: (table: TableName) => FluentChain
-  table: (table: TableName) => FluentChain
-  selectFromSub: (sub: any, alias: string) => FluentChain
-  select: (table: TableName, ...columns: string[]) => FluentChain
-  unsafe: (query: string, params?: any[]) => UnsafeReturn
-}
-// The bun-query-builder types `unsafe()` as returning `Promise<any>`, but at
-// runtime it returns a Bun SQL Statement that has `.execute()`. This interface
-// corrects the return type so callers can chain `.execute()` without type errors.
-declare type UnsafeReturn = Promise<any> & { execute: () => Promise<any> }
-/**
- * Top-level surface of the lazy `db` proxy. Methods that return a chainable
- * builder are typed as `FluentChain` to flatten the optional-method noise
- * inherent in bun-query-builder's declarations. Methods that introduce their
- * own generics (`transaction<T>`, etc.) are kept as their original signatures
- * via the underlying QueryBuilder type so call-site inference still works.
- */
-declare type RawQueryBuilder = ReturnType<typeof createQueryBuilder>;
-declare type GenericPassthroughKeys = | 'transaction'
-  | 'savepoint'
-  | 'beginDistributed'
-  | 'transactional'
-  | 'configure'
-  | 'reserve'
-  | 'commitDistributed'
-  | 'rollbackDistributed'
-  | 'setTransactionDefaults'
-  | 'close'
-  | 'listen'
-  | 'unlisten'
-  | 'notify'
-  | 'copyTo'
-  | 'copyFrom'
-  | 'ping'
-  | 'waitForReady'
-  | 'count'
-  | 'sum'
-  | 'avg'
-  | 'min'
-  | 'max'
-  | 'insertOrIgnore'
-  | 'insertGetId'
-  | 'updateOrInsert'
-  | 'upsert'
-  | 'create'
-  | 'createMany'
-  | 'sql'
-  | 'raw'
-  | 'simple'
-  | 'file';
-/**
- * Accept either a registered table name (from augmented
- * `DatabaseSchema`) for autocomplete, or any other string for apps
- * that haven't generated types yet / tables not in a model file.
- *
- * The `(string & {})` branch prevents TS from collapsing the union
- * back to `string` and losing the autocomplete narrowing — a
- * well-documented LiteralUnion trick.
- */
-// eslint-disable-next-line ts/no-empty-object-type
-export type TableName = (keyof DatabaseSchema & string) | (string & {});
-// SQLite bootstrap pragmas (stacksjs/stacks#1951) now live in
-// @stacksjs/query-builder — the one chokepoint every framework
-// query-builder instance is created through — so EVERY fresh sqlite
-// connection gets `foreign_keys = ON`, including builders created outside
-// this module (e.g. the ORM auto-CRUD routes). Re-exported here for
-// backwards compatibility with existing imports.
-export { applySqlitePragmas, SQLITE_BOOTSTRAP_PRAGMAS } from '@stacksjs/query-builder';
-// Export setConfig if available
-export { setConfig };

package/dist/uuid-columns.d.ts

@@ -1,22 +0,0 @@
-import { sqlHelpers } from './sql-helpers';
-/** Pure builder so tests can assert per-dialect DDL without a live DB. */
-export declare function uuidColumnSql(table: string, sql: SqlHelpers): string;
-/**
- * Resolve every table backing a model with `useUuid: true`, across both
- * userland (`app/Models`) and framework-default (`defaults/app/Models`)
- * model directories. Exported so tests (and `doctor`-style diagnostics) can
- * inspect the resolved set without touching a live database.
- */
-export declare function findUuidTables(): Promise<string[]>;
-/**
- * Guarantee-ALTER `uuid` onto every table whose model declares
- * `useUuid: true`, independently try/catch-swallowed per table so one
- * already-having-the-column (or not-yet-existing) table never skips the
- * rest. Exported so `buddy migrate`/`migrate:fresh` can call it after model
- * migrations run, same pattern as {@link ensureUsersAuthColumns} — see the
- * call sites in buddy/src/commands/migrate.ts.
- */
-export declare function ensureUuidColumns(sql: SqlHelpers, options?: { verbose?: boolean }): Promise<void>;
-/** Convenience wrapper resolving dialect helpers from `DB_CONNECTION`, for call sites that don't already have a `SqlHelpers` instance. */
-export declare function ensureUuidColumnsForCurrentDriver(options?: { verbose?: boolean }): Promise<void>;
-declare type SqlHelpers = ReturnType<typeof sqlHelpers>;

package/dist/validators.d.ts

@@ -1,26 +0,0 @@
-import type { BigintValidatorType, BinaryValidatorType, BlobValidatorType, BooleanValidatorType, DatetimeValidatorType, DateValidatorType, DecimalValidatorType, EnumValidatorType, FloatValidatorType, IntegerValidatorType, JsonValidatorType, NumberValidatorType, SmallintValidatorType, StringValidatorType, TimestampTzValidatorType, TimestampValidatorType, UnixValidatorType, ValidationType } from '@stacksjs/ts-validation';
-export declare function isStringValidator(v: ValidationType): v is StringValidatorType;
-export declare function isNumberValidator(v: ValidationType): v is NumberValidatorType;
-export declare function enumValidator(v: ValidationType): v is EnumValidatorType;
-export declare function isBooleanValidator(v: ValidationType): v is BooleanValidatorType;
-export declare function isDateValidator(v: ValidationType): v is DateValidatorType;
-export declare function isUnixValidator(v: ValidationType): v is UnixValidatorType;
-export declare function isFloatValidator(v: ValidationType): v is FloatValidatorType;
-export declare function isDatetimeValidator(v: ValidationType): v is DatetimeValidatorType;
-export declare function isTimestampValidator(v: ValidationType): v is TimestampValidatorType;
-export declare function isTimestampTzValidator(v: ValidationType): v is TimestampTzValidatorType;
-export declare function isDecimalValidator(v: ValidationType): v is DecimalValidatorType;
-export declare function isSmallintValidator(v: ValidationType): v is SmallintValidatorType;
-export declare function isIntegerValidator(v: ValidationType): v is IntegerValidatorType;
-export declare function isBigintValidator(v: ValidationType): v is BigintValidatorType;
-export declare function isBinaryValidator(v: ValidationType): v is BinaryValidatorType;
-export declare function isBlobValidator(v: ValidationType): v is BlobValidatorType;
-export declare function isJsonValidator(v: ValidationType): v is JsonValidatorType;
-export declare function checkValidator(validator: ValidationType, driver: string): string;
-export declare function prepareNumberColumnType(validator: NumberValidatorType, driver?: string): string;
-// Add new function for enum column types
-export declare function prepareEnumColumnType(validator: EnumValidatorType, driver?: string): string;
-export declare function prepareTextColumnType(validator: StringValidatorType, driver?: string): string;
-// Add new function for date/time column types
-export declare function prepareDateTimeColumnType(validator: DateValidatorType, driver?: string): string;
-export declare function findCharacterLength(validator: ValidationType): number;