bun-query-builder 0.1.2 → 0.1.5

package/dist/meta.d.ts

@@ -9,6 +9,13 @@ export declare interface SchemaMeta {
     hasMany?: Record<string, string>
     belongsTo?: Record<string, string>
     belongsToMany?: Record<string, string>
+    hasOneThrough?: Record<string, { through: string, target: string }>
+    hasManyThrough?: Record<string, { through: string, target: string }>
+    morphOne?: Record<string, string>
+    morphMany?: Record<string, string>
+    morphTo?: Record<string, unknown>
+    morphToMany?: Record<string, string>
+    morphedByMany?: Record<string, string>
   }>
   scopes?: Record<string, Record<string, (qb: any, value?: any) => any>>
 }

package/dist/migrations.d.ts

@@ -15,11 +15,14 @@ export declare function generateDiffSqlString(previous: MigrationPlan | undefine
  */
 export declare function hashMigrationPlan(plan: MigrationPlan): string;
 /**
- * Generate safe, additive-only SQL to migrate from a previous plan to a new plan.
+ * Generate comprehensive SQL to migrate from a previous plan to a new plan.
  * - Creates new tables
- * - Adds new columns (no drops or type/nullable/default changes)
+ * - Drops removed tables
+ * - Adds new columns
+ * - Drops removed columns
+ * - Adds new indexes
+ * - Drops removed indexes
  * - Adds new foreign keys for newly added columns
- * - Adds new indexes and unique indexes
  *
  * If there is no previous plan or the dialect changed, generates full SQL.
  */
@@ -33,6 +36,7 @@ export declare interface ColumnPlan {
   hasDefault: boolean
   defaultValue?: PrimitiveDefault
   references?: { table: string, column: string }
+  enumValues?: string[]
 }
 export declare interface IndexPlan {
   name: string
@@ -62,4 +66,5 @@ export type NormalizedColumnType = | 'string'
   | 'decimal'
   | 'date'
   | 'datetime'
-  | 'json'
+  | 'json'
+  | 'enum'

package/dist/schema.d.ts

@@ -108,10 +108,13 @@ export declare interface ModelOptions extends Base {
   hasMany?: HasMany<ModelNames> | ModelNames[]
   belongsTo?: BelongsTo<ModelNames> | ModelNames[]
   belongsToMany?: BelongsToMany<ModelNames> | ModelNames[]
-  hasOneThrough?: HasOneThrough<ModelNames> | ModelNames[]
-  morphOne?: MorphOne<ModelNames> | ModelNames
-  morphMany?: MorphMany<ModelNames>[] | ModelNames[]
+  hasOneThrough?: HasOneThrough<ModelNames>
+  hasManyThrough?: HasManyThrough<ModelNames>
+  morphOne?: MorphOne<ModelNames>
+  morphMany?: MorphMany<ModelNames>
   morphTo?: MorphTo
+  morphToMany?: MorphToMany<ModelNames>
+  morphedByMany?: MorphedByMany<ModelNames>
   scopes?: {
     [key: string]: (value: any) => any
   }
@@ -146,10 +149,13 @@ export type HasOne<T extends string> = Record<string, T>
 export type HasMany<T extends string> = Record<string, T>
 export type BelongsTo<T extends string> = Record<string, T>
 export type BelongsToMany<T extends string> = Record<string, T>
-export type HasOneThrough<T extends string> = Record<string, T>
+export type HasOneThrough<T extends string> = Record<string, { through: T, target: T }>
+export type HasManyThrough<T extends string> = Record<string, { through: T, target: T }>
 export type MorphOne<T extends string> = Record<string, T>
 export type MorphMany<T extends string> = Record<string, T>
 export type MorphTo = Record<string, unknown>
+export type MorphToMany<T extends string> = Record<string, T>
+export type MorphedByMany<T extends string> = Record<string, T>
 export type ModelDefinition = Readonly<ModelOptions>
 /**
  * # `ModelRecord`

package/dist/seeder.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Helper function to create a seeder
+ */
+export declare function defineSeeder(seederClass: new () => Seeder): new () => Seeder;
+/**
+ * Seeder configuration options
+ */
+export declare interface SeederConfig {
+  seedersDir?: string
+  seeders?: string[]
+  verbose?: boolean
+}
+/**
+ * Options for running seeders
+ */
+export declare interface RunSeederOptions {
+  class?: string
+  verbose?: boolean
+}
+/**
+ * Base seeder class that all seeders should extend.
+ * Provides access to query builder and faker for generating test data.
+ */
+export declare abstract class Seeder {
+  abstract run(qb: any): Promise<void>;
+}

package/dist/types.d.ts

@@ -91,6 +91,9 @@ export declare interface AliasingConfig {
 export declare interface RelationsConfig {
   foreignKeyFormat: 'singularParent_id' | 'parentId'
   singularizeStrategy?: 'stripTrailingS' | 'none'
+  maxDepth?: number
+  maxEagerLoad?: number
+  detectCycles?: boolean
 }
 /**
  * # `SqlConfig`
@@ -123,6 +126,12 @@ export declare interface QueryHooks {
   onQueryEnd?: (event: { sql: string, params?: any[], durationMs: number, rowCount?: number, kind?: 'select' | 'insert' | 'update' | 'delete' | 'raw' }) => void
   onQueryError?: (event: { sql: string, params?: any[], error: any, durationMs: number, kind?: 'select' | 'insert' | 'update' | 'delete' | 'raw' }) => void
   startSpan?: (event: { sql: string, params?: any[], kind?: 'select' | 'insert' | 'update' | 'delete' | 'raw' }) => { end: (error?: any) => void }
+  beforeCreate?: (event: { table: string, data: any }) => void | Promise<void>
+  afterCreate?: (event: { table: string, data: any, result: any }) => void | Promise<void>
+  beforeUpdate?: (event: { table: string, data: any, where?: any }) => void | Promise<void>
+  afterUpdate?: (event: { table: string, data: any, where?: any, result: any }) => void | Promise<void>
+  beforeDelete?: (event: { table: string, where?: any }) => void | Promise<void>
+  afterDelete?: (event: { table: string, where?: any, result: any }) => void | Promise<void>
 }
 /**
  * # `FeatureToggles`
@@ -134,6 +143,14 @@ export declare interface QueryHooks {
 export declare interface FeatureToggles {
   distinctOn: boolean
 }
+export declare interface DatabaseConfig {
+  database: string
+  username: string
+  password: string
+  host: string
+  url?: string
+  port: number
+}
 /**
  * # `QueryBuilderConfig`
  *
@@ -153,6 +170,7 @@ export declare interface FeatureToggles {
 export declare interface QueryBuilderConfig {
   verbose: boolean
   dialect: SupportedDialect
+  database: DatabaseConfig
   timestamps: TimestampConfig
   pagination: PaginationConfig
   aliasing: AliasingConfig

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bun-query-builder",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "A simple yet performant query builder for TypeScript. Built with Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -41,20 +41,20 @@
   ],
   "scripts": {
     "build": "bun --bun build.ts && bun run compile",
-    "compile": "bun build ./bin/cli.ts --compile --minify --outfile bin/query-builder",
+    "compile": "bun build ./bin/cli.ts --compile --minify --outfile bin/qbx",
     "compile:all": "bun run compile:linux-x64 && bun run compile:linux-arm64 && bun run compile:windows-x64 && bun run compile:darwin-x64 && bun run compile:darwin-arm64",
-    "compile:linux-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-linux-x64 --outfile bin/query-builder-linux-x64",
-    "compile:linux-arm64": "bun build ./bin/cli.ts --compile --minify --target=bun-linux-arm64 --outfile bin/query-builder-linux-arm64",
-    "compile:windows-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-windows-x64 --outfile bin/query-builder-windows-x64.exe",
-    "compile:darwin-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-darwin-x64 --outfile bin/query-builder-darwin-x64",
-    "compile:darwin-arm64": "bun build ./bin/cli.ts --compile --minify --target=bun-darwin-arm64 --outfile bin/query-builder-darwin-arm64",
+    "compile:linux-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-linux-x64 --outfile bin/qbx-linux-x64",
+    "compile:linux-arm64": "bun build ./bin/cli.ts --compile --minify --target=bun-linux-arm64 --outfile bin/qbx-linux-arm64",
+    "compile:windows-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-windows-x64 --outfile bin/qbx-windows-x64.exe",
+    "compile:darwin-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-darwin-x64 --outfile bin/qbx-darwin-x64",
+    "compile:darwin-arm64": "bun build ./bin/cli.ts --compile --minify --target=bun-darwin-arm64 --outfile bin/qbx-darwin-arm64",
     "zip": "bun run zip:all",
     "zip:all": "bun run zip:linux-x64 && bun run zip:linux-arm64 && bun run zip:windows-x64 && bun run zip:darwin-x64 && bun run zip:darwin-arm64",
-    "zip:linux-x64": "zip -j bin/query-builder-linux-x64.zip bin/query-builder-linux-x64",
-    "zip:linux-arm64": "zip -j bin/query-builder-linux-arm64.zip bin/query-builder-linux-arm64",
-    "zip:windows-x64": "zip -j bin/query-builder-windows-x64.zip bin/query-builder-windows-x64.exe",
-    "zip:darwin-x64": "zip -j bin/query-builder-darwin-x64.zip bin/query-builder-darwin-x64",
-    "zip:darwin-arm64": "zip -j bin/query-builder-darwin-arm64.zip bin/query-builder-darwin-arm64",
+    "zip:linux-x64": "zip -j bin/qbx-linux-x64.zip bin/qbx-linux-x64",
+    "zip:linux-arm64": "zip -j bin/qbx-linux-arm64.zip bin/qbx-linux-arm64",
+    "zip:windows-x64": "zip -j bin/qbx-windows-x64.zip bin/qbx-windows-x64.exe",
+    "zip:darwin-x64": "zip -j bin/qbx-darwin-x64.zip bin/qbx-darwin-x64",
+    "zip:darwin-arm64": "zip -j bin/qbx-darwin-arm64.zip bin/qbx-darwin-arm64",
     "fresh": "bunx rimraf node_modules/ bun.lock && bun i",
     "prepublishOnly": "bun --bun run build && bun run compile:all && bun run zip",
     "test": "bun test",
@@ -63,27 +63,17 @@
     "changelog": "bunx logsmith --verbose",
     "changelog:generate": "bunx logsmith --output CHANGELOG.md",
     "release": "bun run changelog:generate && bunx bumpx prompt --recursive",
-    "postinstall": "bunx git-hooks",
     "dev:docs": "bun --bun vitepress dev docs",
     "build:docs": "bun --bun vitepress build docs",
     "preview:docs": "bun --bun vitepress preview docs",
-    "typecheck": "bun --bun tsc --noEmit"
+    "typecheck": "bun --bun tsc"
   },
   "dependencies": {
-    "@stacksjs/launchpad": "^0.6.4"
+    "@stacksjs/ts-validation": "^0.4.7",
+    "ts-mocker": "^0.1.3"
   },
   "devDependencies": {
-    "@stacksjs/bumpx": "^0.1.61",
-    "@stacksjs/docs": "^0.70.23",
-    "@stacksjs/eslint-config": "^4.14.0-beta.3",
-    "@stacksjs/gitlint": "^0.1.5",
-    "@stacksjs/logsmith": "^0.1.15",
-    "@types/bun": "^1.2.21",
-    "buddy-bot": "^0.8.10",
-    "bun-git-hooks": "^0.2.19",
-    "bun-plugin-dtsx": "0.9.5",
-    "bunfig": "^0.15.0",
-    "typescript": "^5.9.2"
+    "bunfig": "^0.15.0"
   },
   "overrides": {
     "unconfig": "0.3.10"

package/LICENSE.md

@@ -1,21 +0,0 @@
-# MIT License
-
-Copyright (c) 2024 Open Web Foundation
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,150 +0,0 @@
-<p align="center"><img src=".github/art/cover.jpg" alt="Social Card of this repo"></p>
-
-[![npm version][npm-version-src]][npm-version-href]
-[![GitHub Actions][github-actions-src]][github-actions-href]
-[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
-<!-- [![npm downloads][npm-downloads-src]][npm-downloads-href] -->
-<!-- [![Codecov][codecov-src]][codecov-href] -->
-
-# bun-query-builder
-
-Fully-typed, model-driven Query Builder for Bun’s native `sql`.
-
-Define your data model once and get a type-safe query experience _(a la Kysely/Laravel)_, powered by Bun’s tagged templates for safety and performance.
-
-## Features
-
-- **Typed from Models**: Infer tables/columns/PKs from your model files; `selectFrom('users')` and `where({ active: true })` are typed.
-- **Fluent Builder**: `select/insert/update/delete`, `where/andWhere/orWhere`, `join/leftJoin/rightJoin/crossJoin`, `groupBy/having`, `union/unionAll`.
-- **Relations**: `with(...)`, `withCount(...)`, `whereHas(...)`, `selectAllRelations()` with configurable aliasing.
-- **Utilities**: `distinct/distinctOn`, `orderByDesc/latest/oldest/inRandomOrder`, `whereColumn/whereRaw/groupByRaw/havingRaw`, JSON/date helpers.
-- **Pagination**: `paginate`, `simplePaginate`, `cursorPaginate`, plus `chunk/chunkById/eachById`.
-- **Transactions**: `transaction` with retries/backoff/isolation/onRetry/afterCommit; `savepoint`; distributed tx helpers.
-- **Configurable**: Dialect hints, timestamps, alias strategies, relation FK formats, JSON mode, random function, shared lock syntax.
-- **Bun API passthroughs**: `unsafe`, `file`, `simple`, pool `reserve/release`, `close`, `ping/waitForReady`.
-- **CLI**: Introspection, query printing, connectivity checks, file/unsafe execution, explain.
-
-> Note: LISTEN/NOTIFY and COPY helpers are scaffolded and will be wired as Bun exposes native APIs.
-
-## Get Started
-
-### Installation
-
-```bash
-bun add bun-query-builder
-```
-
-### Usage
-
-```ts
-import { buildDatabaseSchema, buildSchemaMeta, createQueryBuilder } from 'bun-query-builder'
-
-// Load or define your model files (see docs for model shape)
-const models = {
-  User: { name: 'User', table: 'users', primaryKey: 'id', attributes: { id: { validation: { rule: {} } }, name: { validation: { rule: {} } }, active: { validation: { rule: {} } } } },
-} as const
-
-const schema = buildDatabaseSchema(models as any)
-const meta = buildSchemaMeta(models as any)
-const db = createQueryBuilder<typeof schema>({ schema, meta })
-
-// Fully-typed query
-const q = db
-  .selectFrom('users')
-  .where({ active: true })
-  .orderBy('created_at', 'desc')
-  .limit(10)
-
-const rows = await q.execute()
-```
-
-## Migrations
-
-Generate and execute migrations from your models:
-
-```ts
-import { generateMigration, executeMigration } from 'bun-query-builder'
-
-// Generate migration from models directory
-const migration = await generateMigration('./models', { 
-  dialect: 'postgres', 
-  apply: true, 
-  full: true 
-})
-
-// Execute the migration
-await executeMigration(migration)
-```
-
-### CLI
-
-```bash
-# Print inferred schema from model dir
-query-builder introspect ./app/Models --verbose
-
-# Print a sample SQL (text) for a table
-query-builder sql ./app/Models users --limit 5
-
-# Connectivity:
-query-builder ping
-query-builder wait-ready --attempts 30 --delay 250
-
-# Execute a file or unsafe string (be careful!)
-query-builder file ./migrations/seed.sql
-query-builder unsafe "SELECT * FROM users WHERE id = $1" --params "[1]"
-
-# Explain a query
-query-builder explain "SELECT * FROM users WHERE active = true"
-```
-
-## Testing
-
-```bash
-bun test
-```
-
-## Changelog
-
-Please see our [releases](https://github.com/stackjs/bun-query-builder/releases) page for more information on what has changed recently.
-
-## Contributing
-
-Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.
-
-## Community
-
-For help, discussion about best practices, or any other conversation that would benefit from being searchable:
-
-[Discussions on GitHub](https://github.com/stacksjs/ts-starter/discussions)
-
-For casual chit-chat with others using this package:
-
-[Join the Stacks Discord Server](https://discord.gg/stacksjs)
-
-## Postcardware
-
-“Software that is free, but hopes for a postcard.” We love receiving postcards from around the world showing where Stacks is being used! We showcase them on our website too.
-
-Our address: Stacks.js, 12665 Village Ln #2306, Playa Vista, CA 90094, United States 🌎
-
-## Sponsors
-
-We would like to extend our thanks to the following sponsors for funding Stacks development. If you are interested in becoming a sponsor, please reach out to us.
-
-- [JetBrains](https://www.jetbrains.com/)
-- [The Solana Foundation](https://solana.com/)
-
-## License
-
-The MIT License (MIT). Please see [LICENSE](LICENSE.md) for more information.
-
-Made with 💙
-
-<!-- Badges -->
-[npm-version-src]: https://img.shields.io/npm/v/bun-query-builder?style=flat-square
-[npm-version-href]: https://npmjs.com/package/bun-query-builder
-[github-actions-src]: https://img.shields.io/github/actions/workflow/status/stacksjs/ts-starter/ci.yml?style=flat-square&branch=main
-[github-actions-href]: https://github.com/stacksjs/ts-starter/actions?query=workflow%3Aci
-
-<!-- [codecov-src]: https://img.shields.io/codecov/c/gh/stacksjs/ts-starter/main?style=flat-square
-[codecov-href]: https://codecov.io/gh/stacksjs/ts-starter -->