@stacksjs/database 0.72.25 → 0.72.27

package/dist/utils.d.ts

@@ -198,6 +198,91 @@ export declare interface BaseFluentChain<TRow = Record<string, unknown>, TKind e
   exists: () => Promise<boolean>
   doesntExist: () => Promise<boolean>
   $call: (callback: (query: FluentChain<TRow, TKind>) => FluentChain<TRow, TKind>) => FluentChain<TRow, TKind>
+  abort: (...args: unknown[]) => FluentChain<TRow, TKind>
+  addSelect: (...args: unknown[]) => FluentChain<TRow, TKind>
+  applyPivotColumns: (...args: unknown[]) => FluentChain<TRow, TKind>
+  cache: (...args: unknown[]) => FluentChain<TRow, TKind>
+  clone: (...args: unknown[]) => FluentChain<TRow, TKind>
+  crossJoinSub: (...args: unknown[]) => FluentChain<TRow, TKind>
+  denseRank: (...args: unknown[]) => FluentChain<TRow, TKind>
+  doesntHave: (...args: unknown[]) => FluentChain<TRow, TKind>
+  dump: (...args: unknown[]) => FluentChain<TRow, TKind>
+  forPage: (...args: unknown[]) => FluentChain<TRow, TKind>
+  groupByRaw: (...args: unknown[]) => FluentChain<TRow, TKind>
+  has: (...args: unknown[]) => FluentChain<TRow, TKind>
+  havingRaw: (...args: unknown[]) => FluentChain<TRow, TKind>
+  inRandomOrder: (...args: unknown[]) => FluentChain<TRow, TKind>
+  join: (...args: unknown[]) => FluentChain<TRow, TKind>
+  joinSub: (...args: unknown[]) => FluentChain<TRow, TKind>
+  latest: (...args: unknown[]) => FluentChain<TRow, TKind>
+  leftJoinSub: (...args: unknown[]) => FluentChain<TRow, TKind>
+  lockForUpdate: (...args: unknown[]) => FluentChain<TRow, TKind>
+  oldest: (...args: unknown[]) => FluentChain<TRow, TKind>
+  onlyTrashed: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orWhereBetween: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orWhereExists: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orWhereGroup: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orWhereNested: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orWhereNotILike: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orWhereRaw: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orderByDesc: (...args: unknown[]) => FluentChain<TRow, TKind>
+  orderByRaw: (...args: unknown[]) => FluentChain<TRow, TKind>
+  pipe: (...args: unknown[]) => FluentChain<TRow, TKind>
+  reorder: (...args: unknown[]) => FluentChain<TRow, TKind>
+  rowNumber: (...args: unknown[]) => FluentChain<TRow, TKind>
+  scope: (...args: unknown[]) => FluentChain<TRow, TKind>
+  sharedLock: (...args: unknown[]) => FluentChain<TRow, TKind>
+  tap: (...args: unknown[]) => FluentChain<TRow, TKind>
+  when: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereDate: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereDoesntHave: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereExists: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereGroup: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereHas: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereJsonContains: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereJsonContainsKey: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereJsonDoesntContain: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereJsonDoesntContainKey: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereJsonLength: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereJsonPath: (...args: unknown[]) => FluentChain<TRow, TKind>
+  whereNested: (...args: unknown[]) => FluentChain<TRow, TKind>
+  wherePivot: (...args: unknown[]) => FluentChain<TRow, TKind>
+  wherePivotIn: (...args: unknown[]) => FluentChain<TRow, TKind>
+  wherePivotNotIn: (...args: unknown[]) => FluentChain<TRow, TKind>
+  wherePivotNotNull: (...args: unknown[]) => FluentChain<TRow, TKind>
+  wherePivotNull: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withAvg: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withCTE: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withCount: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withMax: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withMin: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withPivot: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withRecursive: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withSum: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withTimeout: (...args: unknown[]) => FluentChain<TRow, TKind>
+  withTrashed: (...args: unknown[]) => FluentChain<TRow, TKind>
+  get: () => Promise<TRow[]>
+  first: () => Promise<TRow | undefined>
+  firstOrFail: () => Promise<TRow>
+  find: (id: number | string) => Promise<TRow | undefined>
+  findMany: (ids: Array<number | string>) => Promise<TRow[]>
+  findOrFail: (id: number | string) => Promise<TRow>
+  value: <K extends keyof TRow & string>(column: K) => Promise<TRow[K]>
+  lazy: () => AsyncIterable<TRow>
+  lazyById: () => AsyncIterable<TRow>
+  chunk: (size: number, handler: (rows: TRow[]) => Promise<void> | void) => Promise<void>
+  chunkById: (size: number, column?: keyof TRow & string, handler?: (rows: TRow[]) => Promise<void> | void) => Promise<void>
+  eachById: (size: number, column?: keyof TRow & string, handler?: (row: TRow) => Promise<void> | void) => Promise<void>
+  paginate: (perPage: number, page?: number, opts?: unknown) => Promise<{ data: TRow[], meta: Record<string, unknown> }>
+  simplePaginate: (perPage: number, page?: number) => Promise<{ data: TRow[], meta: Record<string, unknown> }>
+  cursorPaginate: (perPage: number, cursor?: string | number, column?: string, direction?: 'asc' | 'desc') => Promise<{ data: TRow[], meta: Record<string, unknown> }>
+  explain: () => Promise<Record<string, unknown>[]>
+  raw: () => Promise<unknown[][]>
+  toParams: () => unknown[]
+  toText: () => string
+  simple: () => unknown
+  cancel: () => void
+  dd: () => never
 }
 /*.ts` and
  * emits `database/types.d.ts` containing:
@@ -231,10 +316,20 @@ declare interface Db extends Pick<Required<RawQueryBuilder>, GenericPassthroughK
   unsafe: (query: string, params?: unknown[]) => UnsafeReturn
   read: Omit<Db, 'read'>
 }
-// 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> }
+/**
+ * What raw SQL answers: rows whose shape only the SQL knows.
+ *
+ * The query builder types `unsafe()` as `Promise<any>`, and at runtime it hands
+ * back a Bun SQL statement that also has `.execute()`. Both halves are declared
+ * here - and the rows are `Record<string, unknown>` rather than `any`, because
+ * that is the truth about a hand-written `SELECT`: it has aliases this code
+ * cannot see, and every column wants reading out.
+ *
+ * `any` was worse than useless here: it made `rows.map(row => …)` an implicit
+ * any at every call site, which is the error `noImplicitAny` exists to raise.
+ */
+declare type UnsafeRow = Record<string, unknown>;
+declare type UnsafeReturn = Promise<UnsafeRow[]> & { execute: () => Promise<UnsafeRow[]> }
 /**
  * The keys a row type actually declares, or `never` for a loose record.
  *

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/database",
   "type": "module",
   "sideEffects": false,
-  "version": "0.72.25",
+  "version": "0.72.27",
   "description": "The Stacks database integration.",
   "author": "Chris Breuer",
   "contributors": [
@@ -65,15 +65,15 @@
     "dynamodb-tooling": "^0.3.2"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.72.25",
-    "@stacksjs/config": "0.72.25",
-    "@stacksjs/logging": "0.72.25",
-    "@stacksjs/router": "0.72.25",
+    "@stacksjs/cli": "0.72.27",
+    "@stacksjs/config": "0.72.27",
+    "@stacksjs/logging": "0.72.27",
+    "@stacksjs/router": "0.72.27",
     "better-dx": "^0.2.23",
-    "@stacksjs/path": "0.72.25",
-    "@stacksjs/query-builder": "0.72.25",
-    "@stacksjs/storage": "0.72.25",
-    "@stacksjs/strings": "0.72.25",
-    "@stacksjs/utils": "0.72.25"
+    "@stacksjs/path": "0.72.27",
+    "@stacksjs/query-builder": "0.72.27",
+    "@stacksjs/storage": "0.72.27",
+    "@stacksjs/strings": "0.72.27",
+    "@stacksjs/utils": "0.72.27"
   }
 }