@forinda/kickjs-drizzle 1.2.9 → 1.2.11

package/dist/index.d.ts

@@ -193,6 +193,23 @@ interface DrizzleQueryParamsConfig {
     /** Optional base condition for scoping (tenant, workspace, etc.) */
     baseCondition?: any;
 }
+/**
+ * Convert a DrizzleQueryParamsConfig into a string-based QueryFieldConfig.
+ * Useful for passing to `@ApiQueryParams()` or other APIs that expect string arrays.
+ *
+ * @example
+ * ```ts
+ * import { toQueryFieldConfig } from '@forinda/kickjs-drizzle'
+ *
+ * const fieldConfig = toQueryFieldConfig(TASK_QUERY_CONFIG)
+ * // → { filterable: ['status', 'priority'], sortable: ['title', 'createdAt'], searchable: [] }
+ * ```
+ */
+declare function toQueryFieldConfig(config: DrizzleQueryParamsConfig): {
+    filterable: string[];
+    sortable: string[];
+    searchable: string[];
+};
 /**
  * Result shape compatible with Drizzle's query builder.
  * Use with `db.select().from(table).where(result.where).orderBy(...result.orderBy).limit(result.limit).offset(result.offset)`
@@ -314,4 +331,4 @@ declare class DrizzleQueryAdapter implements QueryBuilderAdapter<DrizzleQueryRes
     private coerceByDataType;
 }
 
-export { DRIZZLE_DB, DrizzleAdapter, type DrizzleAdapterOptions, type DrizzleColumnQueryConfig, type DrizzleOps, DrizzleQueryAdapter, type DrizzleQueryConfig, type DrizzleQueryParamsConfig, type DrizzleQueryResult };
+export { DRIZZLE_DB, DrizzleAdapter, type DrizzleAdapterOptions, type DrizzleColumnQueryConfig, type DrizzleOps, DrizzleQueryAdapter, type DrizzleQueryConfig, type DrizzleQueryParamsConfig, type DrizzleQueryResult, toQueryFieldConfig };

package/dist/index.js

@@ -40,6 +40,14 @@ var DrizzleAdapter = class {
 };
 
 // src/query-adapter.ts
+function toQueryFieldConfig(config) {
+  return {
+    filterable: Object.keys(config.columns),
+    sortable: config.sortable ? Object.keys(config.sortable) : [],
+    searchable: config.searchColumns ? config.searchColumns.map((col) => col.name ?? "").filter(Boolean) : []
+  };
+}
+__name(toQueryFieldConfig, "toQueryFieldConfig");
 var DrizzleQueryAdapter = class {
   static {
     __name(this, "DrizzleQueryAdapter");
@@ -251,6 +259,7 @@ var DrizzleQueryAdapter = class {
 export {
   DRIZZLE_DB,
   DrizzleAdapter,
-  DrizzleQueryAdapter
+  DrizzleQueryAdapter,
+  toQueryFieldConfig
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/drizzle.adapter.ts","../src/types.ts","../src/query-adapter.ts"],"sourcesContent":["import { Logger, type AppAdapter, type Container, Scope } from '@forinda/kickjs-core'\nimport { DRIZZLE_DB, type DrizzleAdapterOptions } from './types'\n\nconst log = Logger.for('DrizzleAdapter')\n\n/**\n * Drizzle ORM adapter — registers a Drizzle database instance in the DI\n * container and manages its lifecycle.\n *\n * Works with any Drizzle driver: `drizzle-orm/postgres-js`, `drizzle-orm/node-postgres`,\n * `drizzle-orm/mysql2`, `drizzle-orm/better-sqlite3`, `drizzle-orm/libsql`, etc.\n *\n * The adapter is generic — the db type is inferred from what you pass in,\n * so services can inject the fully-typed database instance.\n *\n * @example\n * ```ts\n * import { drizzle } from 'drizzle-orm/better-sqlite3'\n * import * as schema from './schema'\n * import { DrizzleAdapter } from '@forinda/kickjs-drizzle'\n *\n * const db = drizzle({ client: sqlite, schema })\n *\n * bootstrap({\n *   modules,\n *   adapters: [\n *     new DrizzleAdapter({ db, onShutdown: () => sqlite.close() }),\n *   ],\n * })\n * ```\n *\n * Inject the typed db instance in services:\n * ```ts\n * import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3'\n * import * as schema from './schema'\n *\n * @Service()\n * class UserService {\n *   constructor(@Inject(DRIZZLE_DB) private db: BetterSQLite3Database<typeof schema>) {}\n * }\n * ```\n */\nexport class DrizzleAdapter<TDb = unknown> implements AppAdapter {\n  name = 'DrizzleAdapter'\n  private db: TDb\n  private onShutdown?: () => void | Promise<void>\n\n  constructor(private options: DrizzleAdapterOptions<TDb>) {\n    this.db = options.db\n    this.onShutdown = options.onShutdown\n  }\n\n  /** Register the Drizzle db instance in the DI container */\n  beforeStart(_app: unknown, container: Container): void {\n    if (this.options.logging) {\n      log.info('Query logging enabled')\n    }\n\n    container.registerFactory(DRIZZLE_DB, () => this.db, Scope.SINGLETON)\n\n    log.info('Drizzle database registered in DI container')\n  }\n\n  /** Close the underlying connection on shutdown */\n  async shutdown(): Promise<void> {\n    if (this.onShutdown) {\n      await this.onShutdown()\n      log.info('Drizzle connection closed')\n    }\n  }\n}\n","import type { MaybePromise } from '@forinda/kickjs-core'\n\n/** DI token for resolving the Drizzle database instance from the container */\nexport const DRIZZLE_DB = Symbol('DrizzleDB')\n\nexport interface DrizzleAdapterOptions<TDb = unknown> {\n  /**\n   * Drizzle database instance — the return value of `drizzle()`.\n   * Preserves the full type so services can inject it type-safely.\n   *\n   * @example\n   * ```ts\n   * import { drizzle } from 'drizzle-orm/better-sqlite3'\n   * import * as schema from './schema'\n   *\n   * const db = drizzle({ client: sqlite, schema })\n   * // db is BetterSQLite3Database<typeof schema>\n   *\n   * new DrizzleAdapter({ db })\n   * // TDb is inferred as BetterSQLite3Database<typeof schema>\n   * ```\n   */\n  db: TDb\n\n  /** Enable query logging (default: false) */\n  logging?: boolean\n\n  /**\n   * Optional shutdown function to close the underlying connection pool.\n   * Drizzle doesn't expose a universal disconnect — this lets you pass your\n   * driver's cleanup (e.g., `pool.end()` for postgres, `client.close()` for libsql).\n   *\n   * @example\n   * ```ts\n   * const pool = new Pool({ connectionString: '...' })\n   * const db = drizzle(pool)\n   *\n   * new DrizzleAdapter({\n   *   db,\n   *   onShutdown: () => pool.end(),\n   * })\n   * ```\n   */\n  onShutdown?: () => MaybePromise<any>\n}\n","import type { QueryBuilderAdapter, ParsedQuery, FilterItem, SortItem } from '@forinda/kickjs-http'\n\n/**\n * Configuration for the Drizzle query builder adapter.\n *\n * Unlike Prisma which uses its own query builder API, Drizzle uses SQL-like\n * operators (`eq`, `gt`, `like`, etc.) from `drizzle-orm`. This adapter\n * produces a config object that can be spread into Drizzle's `select().from().where()`.\n */\nexport interface DrizzleQueryConfig {\n  /** The Drizzle table schema object (e.g., `users` from your schema) */\n  table: Record<string, any>\n  /** Columns to search across when a search string is provided */\n  searchColumns?: string[]\n}\n\n/**\n * Type-safe Drizzle query configuration using Column objects.\n *\n * Use this instead of `DrizzleQueryConfig` for type-safe column references\n * that are validated at compile time. Column objects carry `dataType` metadata\n * enabling automatic type coercion of filter values.\n *\n * @example\n * ```ts\n * import { users } from './schema'\n * import type { DrizzleColumnQueryConfig } from '@forinda/kickjs-drizzle'\n *\n * const config: DrizzleColumnQueryConfig = {\n *   columns: {\n *     status: users.status,\n *     isActive: users.isActive,\n *     createdAt: users.createdAt,\n *   },\n *   sortable: {\n *     name: users.name,\n *     createdAt: users.createdAt,\n *   },\n *   searchColumns: [users.firstName, users.lastName, users.email],\n *   baseCondition: eq(users.tenantId, tenantId),\n * }\n * ```\n */\nexport interface DrizzleColumnQueryConfig {\n  /**\n   * Map of filterable field names to Drizzle Column objects.\n   * Keys are the query parameter names, values are the actual schema columns.\n   * The column's `dataType` is used for automatic type coercion.\n   */\n  columns: Record<string, any>\n\n  /**\n   * Map of sortable field names to Drizzle Column objects.\n   * If not provided, falls back to `columns` for sort lookups.\n   */\n  sortable?: Record<string, any>\n\n  /**\n   * Column objects to search across when a search string is provided.\n   * Each entry should be a Drizzle Column (not a string).\n   */\n  searchColumns?: any[]\n\n  /**\n   * A pre-built SQL condition that is always prepended to the WHERE clause.\n   * Use for scoping queries by tenant, workspace, or other invariants.\n   *\n   * @example\n   * ```ts\n   * baseCondition: and(eq(tasks.tenantId, tid), eq(tasks.workspaceId, wid))\n   * ```\n   */\n  baseCondition?: any\n}\n\n/**\n * Configuration type for defining query param schemas with Drizzle Column objects.\n *\n * Used in constants files to define which columns are filterable, sortable, and searchable.\n * This type is consumed by both `DrizzleQueryAdapter.buildFromColumns()` and `@ApiQueryParams()`.\n *\n * @example\n * ```ts\n * import type { DrizzleQueryParamsConfig } from '@forinda/kickjs-drizzle'\n * import { tasks } from '@/db/schema'\n *\n * export const TASK_QUERY_CONFIG: DrizzleQueryParamsConfig = {\n *   columns: {\n *     status: tasks.status,\n *     priority: tasks.priority,\n *   },\n *   sortable: {\n *     title: tasks.title,\n *     createdAt: tasks.createdAt,\n *   },\n *   searchColumns: [tasks.title, tasks.key],\n * }\n * ```\n */\nexport interface DrizzleQueryParamsConfig {\n  /** Filterable columns: keys are query param names, values are Drizzle Column objects */\n  columns: Record<string, any>\n  /** Sortable columns: keys are query param names, values are Drizzle Column objects */\n  sortable?: Record<string, any>\n  /** Columns for text search */\n  searchColumns?: any[]\n  /** Optional base condition for scoping (tenant, workspace, etc.) */\n  baseCondition?: any\n}\n\n/**\n * Result shape compatible with Drizzle's query builder.\n * Use with `db.select().from(table).where(result.where).orderBy(...result.orderBy).limit(result.limit).offset(result.offset)`\n */\nexport interface DrizzleQueryResult {\n  /** SQL condition — pass to `.where()` */\n  where?: any\n  /** Array of order expressions — spread into `.orderBy()` */\n  orderBy: any[]\n  /** Row limit — pass to `.limit()` */\n  limit: number\n  /** Row offset — pass to `.offset()` */\n  offset: number\n}\n\n/**\n * Drizzle operator functions required by the query adapter.\n * Pass these from your `drizzle-orm` import to avoid version coupling.\n *\n * @example\n * ```ts\n * import { eq, ne, gt, gte, lt, lte, ilike, inArray, between, and, or, asc, desc } from 'drizzle-orm'\n *\n * const adapter = new DrizzleQueryAdapter({\n *   eq, ne, gt, gte, lt, lte, ilike, inArray, between, and, or, asc, desc,\n * })\n * ```\n */\nexport interface DrizzleOps {\n  eq: (column: any, value: any) => any\n  ne: (column: any, value: any) => any\n  gt: (column: any, value: any) => any\n  gte: (column: any, value: any) => any\n  lt: (column: any, value: any) => any\n  lte: (column: any, value: any) => any\n  ilike: (column: any, value: string) => any\n  inArray: (column: any, values: any[]) => any\n  between?: (column: any, min: any, max: any) => any\n  and: (...conditions: any[]) => any\n  or: (...conditions: any[]) => any\n  asc: (column: any) => any\n  desc: (column: any) => any\n}\n\n/**\n * Translates a ParsedQuery into Drizzle-compatible query parts.\n *\n * Supports two modes:\n * 1. **String-based** (legacy): `build(parsed, { table, searchColumns })` — looks up columns by string name\n * 2. **Column-based** (recommended): `buildFromColumns(parsed, config)` — uses actual Column objects for type safety\n *\n * @example\n * ```ts\n * // String-based (legacy)\n * const query = adapter.build(parsed, { table: users, searchColumns: ['name', 'email'] })\n *\n * // Column-based (recommended)\n * const query = adapter.buildFromColumns(parsed, {\n *   columns: { status: users.status, isActive: users.isActive },\n *   searchColumns: [users.name, users.email],\n *   baseCondition: eq(users.tenantId, tid),\n * })\n *\n * const results = await db\n *   .select().from(users)\n *   .where(query.where)\n *   .orderBy(...query.orderBy)\n *   .limit(query.limit)\n *   .offset(query.offset)\n * ```\n */\nexport class DrizzleQueryAdapter implements QueryBuilderAdapter<\n  DrizzleQueryResult,\n  DrizzleQueryConfig\n> {\n  readonly name = 'DrizzleQueryAdapter'\n\n  constructor(private ops: DrizzleOps) {}\n\n  /**\n   * Build query from string-based config (legacy API).\n   * Prefer `buildFromColumns()` for type safety.\n   */\n  build(\n    parsed: ParsedQuery,\n    config: DrizzleQueryConfig = {} as DrizzleQueryConfig,\n  ): DrizzleQueryResult {\n    const result: DrizzleQueryResult = {\n      orderBy: [],\n      limit: parsed.pagination.limit,\n      offset: parsed.pagination.offset,\n    }\n\n    // Build where conditions\n    const conditions: any[] = []\n\n    // Filters\n    for (const filter of parsed.filters) {\n      const condition = this.buildFilter(config.table, filter)\n      if (condition) conditions.push(condition)\n    }\n\n    // Search\n    if (parsed.search && config.searchColumns && config.searchColumns.length > 0) {\n      const searchConditions = config.searchColumns\n        .filter((col) => config.table[col])\n        .map((col) => this.ops.ilike(config.table[col], `%${parsed.search}%`))\n\n      if (searchConditions.length > 0) {\n        conditions.push(this.ops.or(...searchConditions))\n      }\n    }\n\n    // Combine conditions\n    if (conditions.length === 1) {\n      result.where = conditions[0]\n    } else if (conditions.length > 1) {\n      result.where = this.ops.and(...conditions)\n    }\n\n    // Sort\n    result.orderBy = this.buildSort(config.table, parsed.sort)\n\n    return result\n  }\n\n  /**\n   * Build query using Column objects for type-safe filtering, sorting, and search.\n   *\n   * Features over `build()`:\n   * - Column references validated at compile time\n   * - Automatic type coercion based on `column.dataType` (boolean, number, date)\n   * - `baseCondition` support for tenant/workspace scoping\n   * - Native `between` operator support\n   * - Separate `sortable` map so filterable and sortable columns can differ\n   *\n   * @example\n   * ```ts\n   * const query = adapter.buildFromColumns(parsed, {\n   *   columns: { status: tasks.status, priority: tasks.priority },\n   *   sortable: { title: tasks.title, createdAt: tasks.createdAt },\n   *   searchColumns: [tasks.title, tasks.key],\n   *   baseCondition: eq(tasks.workspaceId, wid),\n   * })\n   * ```\n   */\n  buildFromColumns(parsed: ParsedQuery, config: DrizzleColumnQueryConfig): DrizzleQueryResult {\n    const result: DrizzleQueryResult = {\n      orderBy: [],\n      limit: parsed.pagination.limit,\n      offset: parsed.pagination.offset,\n    }\n\n    const conditions: any[] = []\n\n    // Prepend base condition (tenant/workspace scoping)\n    if (config.baseCondition) {\n      conditions.push(config.baseCondition)\n    }\n\n    // Filters — resolve column from the columns map\n    for (const filter of parsed.filters) {\n      const column = config.columns[filter.field]\n      if (!column) continue\n      const condition = this.buildColumnFilter(column, filter)\n      if (condition) conditions.push(condition)\n    }\n\n    // Search — use Column objects directly\n    if (parsed.search && config.searchColumns && config.searchColumns.length > 0) {\n      const searchConditions = config.searchColumns.map((col) =>\n        this.ops.ilike(col, `%${parsed.search}%`),\n      )\n      if (searchConditions.length > 0) {\n        conditions.push(this.ops.or(...searchConditions))\n      }\n    }\n\n    // Combine conditions\n    if (conditions.length === 1) {\n      result.where = conditions[0]\n    } else if (conditions.length > 1) {\n      result.where = this.ops.and(...conditions)\n    }\n\n    // Sort — use sortable map, falling back to columns\n    const sortMap = config.sortable ?? config.columns\n    result.orderBy = parsed.sort\n      .filter((item) => sortMap[item.field])\n      .map((item) =>\n        item.direction === 'desc'\n          ? this.ops.desc(sortMap[item.field])\n          : this.ops.asc(sortMap[item.field]),\n      )\n\n    return result\n  }\n\n  /** Map a single FilterItem to a Drizzle condition using string-based table lookup */\n  private buildFilter(table: Record<string, any>, filter: FilterItem): any {\n    const column = table[filter.field]\n    if (!column) return null\n\n    const value = this.coerce(filter.value)\n\n    switch (filter.operator) {\n      case 'eq':\n        return this.ops.eq(column, value)\n      case 'neq':\n        return this.ops.ne(column, value)\n      case 'gt':\n        return this.ops.gt(column, value)\n      case 'gte':\n        return this.ops.gte(column, value)\n      case 'lt':\n        return this.ops.lt(column, value)\n      case 'lte':\n        return this.ops.lte(column, value)\n      case 'contains':\n        return this.ops.ilike(column, `%${filter.value}%`)\n      case 'starts':\n        return this.ops.ilike(column, `${filter.value}%`)\n      case 'ends':\n        return this.ops.ilike(column, `%${filter.value}`)\n      case 'in': {\n        const values = filter.value.split(',').map((v) => this.coerce(v.trim()))\n        return this.ops.inArray(column, values)\n      }\n      case 'between': {\n        const [min, max] = filter.value.split(',').map((v) => this.coerce(v.trim()))\n        return this.ops.and(this.ops.gte(column, min), this.ops.lte(column, max))\n      }\n      default:\n        return this.ops.eq(column, value)\n    }\n  }\n\n  /**\n   * Map a FilterItem to a Drizzle condition using a Column object.\n   * Coerces values based on `column.dataType` for type-safe filtering.\n   */\n  private buildColumnFilter(column: any, filter: FilterItem): any {\n    const value = this.coerceByDataType(filter.value, column.dataType)\n\n    switch (filter.operator) {\n      case 'eq':\n        return this.ops.eq(column, value)\n      case 'neq':\n        return this.ops.ne(column, value)\n      case 'gt':\n        return this.ops.gt(column, value)\n      case 'gte':\n        return this.ops.gte(column, value)\n      case 'lt':\n        return this.ops.lt(column, value)\n      case 'lte':\n        return this.ops.lte(column, value)\n      case 'contains':\n        return this.ops.ilike(column, `%${filter.value}%`)\n      case 'starts':\n        return this.ops.ilike(column, `${filter.value}%`)\n      case 'ends':\n        return this.ops.ilike(column, `%${filter.value}`)\n      case 'in': {\n        const values = filter.value\n          .split(',')\n          .map((v) => this.coerceByDataType(v.trim(), column.dataType))\n        return this.ops.inArray(column, values)\n      }\n      case 'between': {\n        const [minStr, maxStr] = filter.value.split(',').map((v) => v.trim())\n        const min = this.coerceByDataType(minStr, column.dataType)\n        const max = this.coerceByDataType(maxStr, column.dataType)\n        if (this.ops.between) {\n          return this.ops.between(column, min, max)\n        }\n        return this.ops.and(this.ops.gte(column, min), this.ops.lte(column, max))\n      }\n      default:\n        return this.ops.eq(column, value)\n    }\n  }\n\n  /** Build Drizzle orderBy from SortItem[] */\n  private buildSort(table: Record<string, any>, sort: SortItem[]): any[] {\n    return sort\n      .filter((item) => table[item.field])\n      .map((item) =>\n        item.direction === 'desc'\n          ? this.ops.desc(table[item.field])\n          : this.ops.asc(table[item.field]),\n      )\n  }\n\n  /** Attempt to coerce a string value to a number or boolean if appropriate */\n  private coerce(value: string): string | number | boolean {\n    if (value === 'true') return true\n    if (value === 'false') return false\n    const num = Number(value)\n    if (!Number.isNaN(num) && value.trim() !== '') return num\n    return value\n  }\n\n  /**\n   * Coerce a string value based on the column's dataType.\n   *\n   * - `'boolean'` → `true`/`false`\n   * - `'number'` / `'bigint'` → `Number(value)`\n   * - `'date'` → `new Date(value)` (ISO 8601 strings)\n   * - Everything else → original string\n   */\n  private coerceByDataType(value: string, dataType?: string): string | number | boolean | Date {\n    if (!dataType) return this.coerce(value)\n\n    switch (dataType) {\n      case 'boolean':\n        return value === 'true' || value === '1'\n      case 'number':\n      case 'bigint': {\n        const num = Number(value)\n        return Number.isNaN(num) ? value : num\n      }\n      case 'date':\n      case 'localDate':\n      case 'localDateTime': {\n        const date = new Date(value)\n        return Number.isNaN(date.getTime()) ? value : date\n      }\n      default:\n        return value\n    }\n  }\n}\n"],"mappings":";;;;AAAA,SAASA,QAAyCC,aAAa;;;ACGxD,IAAMC,aAAaC,uBAAO,WAAA;;;ADAjC,IAAMC,MAAMC,OAAOC,IAAI,gBAAA;AAuChB,IAAMC,iBAAN,MAAMA;EA1Cb,OA0CaA;;;;EACXC,OAAO;EACCC;EACAC;EAER,YAAoBC,SAAqC;SAArCA,UAAAA;AAClB,SAAKF,KAAKE,QAAQF;AAClB,SAAKC,aAAaC,QAAQD;EAC5B;;EAGAE,YAAYC,MAAeC,WAA4B;AACrD,QAAI,KAAKH,QAAQI,SAAS;AACxBX,UAAIY,KAAK,uBAAA;IACX;AAEAF,cAAUG,gBAAgBC,YAAY,MAAM,KAAKT,IAAIU,MAAMC,SAAS;AAEpEhB,QAAIY,KAAK,6CAAA;EACX;;EAGA,MAAMK,WAA0B;AAC9B,QAAI,KAAKX,YAAY;AACnB,YAAM,KAAKA,WAAU;AACrBN,UAAIY,KAAK,2BAAA;IACX;EACF;AACF;;;AE+GO,IAAMM,sBAAN,MAAMA;EA3Bb,OA2BaA;;;;EAIFC,OAAO;EAEhB,YAAoBC,KAAiB;SAAjBA,MAAAA;EAAkB;;;;;EAMtCC,MACEC,QACAC,SAA6B,CAAC,GACV;AACpB,UAAMC,SAA6B;MACjCC,SAAS,CAAA;MACTC,OAAOJ,OAAOK,WAAWD;MACzBE,QAAQN,OAAOK,WAAWC;IAC5B;AAGA,UAAMC,aAAoB,CAAA;AAG1B,eAAWC,UAAUR,OAAOS,SAAS;AACnC,YAAMC,YAAY,KAAKC,YAAYV,OAAOW,OAAOJ,MAAAA;AACjD,UAAIE,UAAWH,YAAWM,KAAKH,SAAAA;IACjC;AAGA,QAAIV,OAAOc,UAAUb,OAAOc,iBAAiBd,OAAOc,cAAcC,SAAS,GAAG;AAC5E,YAAMC,mBAAmBhB,OAAOc,cAC7BP,OAAO,CAACU,QAAQjB,OAAOW,MAAMM,GAAAA,CAAI,EACjCC,IAAI,CAACD,QAAQ,KAAKpB,IAAIsB,MAAMnB,OAAOW,MAAMM,GAAAA,GAAM,IAAIlB,OAAOc,MAAM,GAAG,CAAA;AAEtE,UAAIG,iBAAiBD,SAAS,GAAG;AAC/BT,mBAAWM,KAAK,KAAKf,IAAIuB,GAAE,GAAIJ,gBAAAA,CAAAA;MACjC;IACF;AAGA,QAAIV,WAAWS,WAAW,GAAG;AAC3Bd,aAAOoB,QAAQf,WAAW,CAAA;IAC5B,WAAWA,WAAWS,SAAS,GAAG;AAChCd,aAAOoB,QAAQ,KAAKxB,IAAIyB,IAAG,GAAIhB,UAAAA;IACjC;AAGAL,WAAOC,UAAU,KAAKqB,UAAUvB,OAAOW,OAAOZ,OAAOyB,IAAI;AAEzD,WAAOvB;EACT;;;;;;;;;;;;;;;;;;;;;EAsBAwB,iBAAiB1B,QAAqBC,QAAsD;AAC1F,UAAMC,SAA6B;MACjCC,SAAS,CAAA;MACTC,OAAOJ,OAAOK,WAAWD;MACzBE,QAAQN,OAAOK,WAAWC;IAC5B;AAEA,UAAMC,aAAoB,CAAA;AAG1B,QAAIN,OAAO0B,eAAe;AACxBpB,iBAAWM,KAAKZ,OAAO0B,aAAa;IACtC;AAGA,eAAWnB,UAAUR,OAAOS,SAAS;AACnC,YAAMmB,SAAS3B,OAAO4B,QAAQrB,OAAOsB,KAAK;AAC1C,UAAI,CAACF,OAAQ;AACb,YAAMlB,YAAY,KAAKqB,kBAAkBH,QAAQpB,MAAAA;AACjD,UAAIE,UAAWH,YAAWM,KAAKH,SAAAA;IACjC;AAGA,QAAIV,OAAOc,UAAUb,OAAOc,iBAAiBd,OAAOc,cAAcC,SAAS,GAAG;AAC5E,YAAMC,mBAAmBhB,OAAOc,cAAcI,IAAI,CAACD,QACjD,KAAKpB,IAAIsB,MAAMF,KAAK,IAAIlB,OAAOc,MAAM,GAAG,CAAA;AAE1C,UAAIG,iBAAiBD,SAAS,GAAG;AAC/BT,mBAAWM,KAAK,KAAKf,IAAIuB,GAAE,GAAIJ,gBAAAA,CAAAA;MACjC;IACF;AAGA,QAAIV,WAAWS,WAAW,GAAG;AAC3Bd,aAAOoB,QAAQf,WAAW,CAAA;IAC5B,WAAWA,WAAWS,SAAS,GAAG;AAChCd,aAAOoB,QAAQ,KAAKxB,IAAIyB,IAAG,GAAIhB,UAAAA;IACjC;AAGA,UAAMyB,UAAU/B,OAAOgC,YAAYhC,OAAO4B;AAC1C3B,WAAOC,UAAUH,OAAOyB,KACrBjB,OAAO,CAAC0B,SAASF,QAAQE,KAAKJ,KAAK,CAAC,EACpCX,IAAI,CAACe,SACJA,KAAKC,cAAc,SACf,KAAKrC,IAAIsC,KAAKJ,QAAQE,KAAKJ,KAAK,CAAC,IACjC,KAAKhC,IAAIuC,IAAIL,QAAQE,KAAKJ,KAAK,CAAC,CAAA;AAGxC,WAAO5B;EACT;;EAGQS,YAAYC,OAA4BJ,QAAyB;AACvE,UAAMoB,SAAShB,MAAMJ,OAAOsB,KAAK;AACjC,QAAI,CAACF,OAAQ,QAAO;AAEpB,UAAMU,QAAQ,KAAKC,OAAO/B,OAAO8B,KAAK;AAEtC,YAAQ9B,OAAOgC,UAAQ;MACrB,KAAK;AACH,eAAO,KAAK1C,IAAI2C,GAAGb,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAI4C,GAAGd,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAI6C,GAAGf,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAI8C,IAAIhB,QAAQU,KAAAA;MAC9B,KAAK;AACH,eAAO,KAAKxC,IAAI+C,GAAGjB,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAIgD,IAAIlB,QAAQU,KAAAA;MAC9B,KAAK;AACH,eAAO,KAAKxC,IAAIsB,MAAMQ,QAAQ,IAAIpB,OAAO8B,KAAK,GAAG;MACnD,KAAK;AACH,eAAO,KAAKxC,IAAIsB,MAAMQ,QAAQ,GAAGpB,OAAO8B,KAAK,GAAG;MAClD,KAAK;AACH,eAAO,KAAKxC,IAAIsB,MAAMQ,QAAQ,IAAIpB,OAAO8B,KAAK,EAAE;MAClD,KAAK,MAAM;AACT,cAAMS,SAASvC,OAAO8B,MAAMU,MAAM,GAAA,EAAK7B,IAAI,CAAC8B,MAAM,KAAKV,OAAOU,EAAEC,KAAI,CAAA,CAAA;AACpE,eAAO,KAAKpD,IAAIqD,QAAQvB,QAAQmB,MAAAA;MAClC;MACA,KAAK,WAAW;AACd,cAAM,CAACK,KAAKC,GAAAA,IAAO7C,OAAO8B,MAAMU,MAAM,GAAA,EAAK7B,IAAI,CAAC8B,MAAM,KAAKV,OAAOU,EAAEC,KAAI,CAAA,CAAA;AACxE,eAAO,KAAKpD,IAAIyB,IAAI,KAAKzB,IAAI8C,IAAIhB,QAAQwB,GAAAA,GAAM,KAAKtD,IAAIgD,IAAIlB,QAAQyB,GAAAA,CAAAA;MACtE;MACA;AACE,eAAO,KAAKvD,IAAI2C,GAAGb,QAAQU,KAAAA;IAC/B;EACF;;;;;EAMQP,kBAAkBH,QAAapB,QAAyB;AAC9D,UAAM8B,QAAQ,KAAKgB,iBAAiB9C,OAAO8B,OAAOV,OAAO2B,QAAQ;AAEjE,YAAQ/C,OAAOgC,UAAQ;MACrB,KAAK;AACH,eAAO,KAAK1C,IAAI2C,GAAGb,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAI4C,GAAGd,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAI6C,GAAGf,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAI8C,IAAIhB,QAAQU,KAAAA;MAC9B,KAAK;AACH,eAAO,KAAKxC,IAAI+C,GAAGjB,QAAQU,KAAAA;MAC7B,KAAK;AACH,eAAO,KAAKxC,IAAIgD,IAAIlB,QAAQU,KAAAA;MAC9B,KAAK;AACH,eAAO,KAAKxC,IAAIsB,MAAMQ,QAAQ,IAAIpB,OAAO8B,KAAK,GAAG;MACnD,KAAK;AACH,eAAO,KAAKxC,IAAIsB,MAAMQ,QAAQ,GAAGpB,OAAO8B,KAAK,GAAG;MAClD,KAAK;AACH,eAAO,KAAKxC,IAAIsB,MAAMQ,QAAQ,IAAIpB,OAAO8B,KAAK,EAAE;MAClD,KAAK,MAAM;AACT,cAAMS,SAASvC,OAAO8B,MACnBU,MAAM,GAAA,EACN7B,IAAI,CAAC8B,MAAM,KAAKK,iBAAiBL,EAAEC,KAAI,GAAItB,OAAO2B,QAAQ,CAAA;AAC7D,eAAO,KAAKzD,IAAIqD,QAAQvB,QAAQmB,MAAAA;MAClC;MACA,KAAK,WAAW;AACd,cAAM,CAACS,QAAQC,MAAAA,IAAUjD,OAAO8B,MAAMU,MAAM,GAAA,EAAK7B,IAAI,CAAC8B,MAAMA,EAAEC,KAAI,CAAA;AAClE,cAAME,MAAM,KAAKE,iBAAiBE,QAAQ5B,OAAO2B,QAAQ;AACzD,cAAMF,MAAM,KAAKC,iBAAiBG,QAAQ7B,OAAO2B,QAAQ;AACzD,YAAI,KAAKzD,IAAI4D,SAAS;AACpB,iBAAO,KAAK5D,IAAI4D,QAAQ9B,QAAQwB,KAAKC,GAAAA;QACvC;AACA,eAAO,KAAKvD,IAAIyB,IAAI,KAAKzB,IAAI8C,IAAIhB,QAAQwB,GAAAA,GAAM,KAAKtD,IAAIgD,IAAIlB,QAAQyB,GAAAA,CAAAA;MACtE;MACA;AACE,eAAO,KAAKvD,IAAI2C,GAAGb,QAAQU,KAAAA;IAC/B;EACF;;EAGQd,UAAUZ,OAA4Ba,MAAyB;AACrE,WAAOA,KACJjB,OAAO,CAAC0B,SAAStB,MAAMsB,KAAKJ,KAAK,CAAC,EAClCX,IAAI,CAACe,SACJA,KAAKC,cAAc,SACf,KAAKrC,IAAIsC,KAAKxB,MAAMsB,KAAKJ,KAAK,CAAC,IAC/B,KAAKhC,IAAIuC,IAAIzB,MAAMsB,KAAKJ,KAAK,CAAC,CAAA;EAExC;;EAGQS,OAAOD,OAA0C;AACvD,QAAIA,UAAU,OAAQ,QAAO;AAC7B,QAAIA,UAAU,QAAS,QAAO;AAC9B,UAAMqB,MAAMC,OAAOtB,KAAAA;AACnB,QAAI,CAACsB,OAAOC,MAAMF,GAAAA,KAAQrB,MAAMY,KAAI,MAAO,GAAI,QAAOS;AACtD,WAAOrB;EACT;;;;;;;;;EAUQgB,iBAAiBhB,OAAeiB,UAAqD;AAC3F,QAAI,CAACA,SAAU,QAAO,KAAKhB,OAAOD,KAAAA;AAElC,YAAQiB,UAAAA;MACN,KAAK;AACH,eAAOjB,UAAU,UAAUA,UAAU;MACvC,KAAK;MACL,KAAK,UAAU;AACb,cAAMqB,MAAMC,OAAOtB,KAAAA;AACnB,eAAOsB,OAAOC,MAAMF,GAAAA,IAAOrB,QAAQqB;MACrC;MACA,KAAK;MACL,KAAK;MACL,KAAK,iBAAiB;AACpB,cAAMG,OAAO,IAAIC,KAAKzB,KAAAA;AACtB,eAAOsB,OAAOC,MAAMC,KAAKE,QAAO,CAAA,IAAM1B,QAAQwB;MAChD;MACA;AACE,eAAOxB;IACX;EACF;AACF;","names":["Logger","Scope","DRIZZLE_DB","Symbol","log","Logger","for","DrizzleAdapter","name","db","onShutdown","options","beforeStart","_app","container","logging","info","registerFactory","DRIZZLE_DB","Scope","SINGLETON","shutdown","DrizzleQueryAdapter","name","ops","build","parsed","config","result","orderBy","limit","pagination","offset","conditions","filter","filters","condition","buildFilter","table","push","search","searchColumns","length","searchConditions","col","map","ilike","or","where","and","buildSort","sort","buildFromColumns","baseCondition","column","columns","field","buildColumnFilter","sortMap","sortable","item","direction","desc","asc","value","coerce","operator","eq","ne","gt","gte","lt","lte","values","split","v","trim","inArray","min","max","coerceByDataType","dataType","minStr","maxStr","between","num","Number","isNaN","date","Date","getTime"]}
+{"version":3,"sources":["../src/drizzle.adapter.ts","../src/types.ts","../src/query-adapter.ts"],"sourcesContent":["import { Logger, type AppAdapter, type Container, Scope } from '@forinda/kickjs-core'\nimport { DRIZZLE_DB, type DrizzleAdapterOptions } from './types'\n\nconst log = Logger.for('DrizzleAdapter')\n\n/**\n * Drizzle ORM adapter — registers a Drizzle database instance in the DI\n * container and manages its lifecycle.\n *\n * Works with any Drizzle driver: `drizzle-orm/postgres-js`, `drizzle-orm/node-postgres`,\n * `drizzle-orm/mysql2`, `drizzle-orm/better-sqlite3`, `drizzle-orm/libsql`, etc.\n *\n * The adapter is generic — the db type is inferred from what you pass in,\n * so services can inject the fully-typed database instance.\n *\n * @example\n * ```ts\n * import { drizzle } from 'drizzle-orm/better-sqlite3'\n * import * as schema from './schema'\n * import { DrizzleAdapter } from '@forinda/kickjs-drizzle'\n *\n * const db = drizzle({ client: sqlite, schema })\n *\n * bootstrap({\n *   modules,\n *   adapters: [\n *     new DrizzleAdapter({ db, onShutdown: () => sqlite.close() }),\n *   ],\n * })\n * ```\n *\n * Inject the typed db instance in services:\n * ```ts\n * import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3'\n * import * as schema from './schema'\n *\n * @Service()\n * class UserService {\n *   constructor(@Inject(DRIZZLE_DB) private db: BetterSQLite3Database<typeof schema>) {}\n * }\n * ```\n */\nexport class DrizzleAdapter<TDb = unknown> implements AppAdapter {\n  name = 'DrizzleAdapter'\n  private db: TDb\n  private onShutdown?: () => void | Promise<void>\n\n  constructor(private options: DrizzleAdapterOptions<TDb>) {\n    this.db = options.db\n    this.onShutdown = options.onShutdown\n  }\n\n  /** Register the Drizzle db instance in the DI container */\n  beforeStart(_app: unknown, container: Container): void {\n    if (this.options.logging) {\n      log.info('Query logging enabled')\n    }\n\n    container.registerFactory(DRIZZLE_DB, () => this.db, Scope.SINGLETON)\n\n    log.info('Drizzle database registered in DI container')\n  }\n\n  /** Close the underlying connection on shutdown */\n  async shutdown(): Promise<void> {\n    if (this.onShutdown) {\n      await this.onShutdown()\n      log.info('Drizzle connection closed')\n    }\n  }\n}\n","import type { MaybePromise } from '@forinda/kickjs-core'\n\n/** DI token for resolving the Drizzle database instance from the container */\nexport const DRIZZLE_DB = Symbol('DrizzleDB')\n\nexport interface DrizzleAdapterOptions<TDb = unknown> {\n  /**\n   * Drizzle database instance — the return value of `drizzle()`.\n   * Preserves the full type so services can inject it type-safely.\n   *\n   * @example\n   * ```ts\n   * import { drizzle } from 'drizzle-orm/better-sqlite3'\n   * import * as schema from './schema'\n   *\n   * const db = drizzle({ client: sqlite, schema })\n   * // db is BetterSQLite3Database<typeof schema>\n   *\n   * new DrizzleAdapter({ db })\n   * // TDb is inferred as BetterSQLite3Database<typeof schema>\n   * ```\n   */\n  db: TDb\n\n  /** Enable query logging (default: false) */\n  logging?: boolean\n\n  /**\n   * Optional shutdown function to close the underlying connection pool.\n   * Drizzle doesn't expose a universal disconnect — this lets you pass your\n   * driver's cleanup (e.g., `pool.end()` for postgres, `client.close()` for libsql).\n   *\n   * @example\n   * ```ts\n   * const pool = new Pool({ connectionString: '...' })\n   * const db = drizzle(pool)\n   *\n   * new DrizzleAdapter({\n   *   db,\n   *   onShutdown: () => pool.end(),\n   * })\n   * ```\n   */\n  onShutdown?: () => MaybePromise<any>\n}\n","import type { QueryBuilderAdapter, ParsedQuery, FilterItem, SortItem } from '@forinda/kickjs-http'\n\n/**\n * Configuration for the Drizzle query builder adapter.\n *\n * Unlike Prisma which uses its own query builder API, Drizzle uses SQL-like\n * operators (`eq`, `gt`, `like`, etc.) from `drizzle-orm`. This adapter\n * produces a config object that can be spread into Drizzle's `select().from().where()`.\n */\nexport interface DrizzleQueryConfig {\n  /** The Drizzle table schema object (e.g., `users` from your schema) */\n  table: Record<string, any>\n  /** Columns to search across when a search string is provided */\n  searchColumns?: string[]\n}\n\n/**\n * Type-safe Drizzle query configuration using Column objects.\n *\n * Use this instead of `DrizzleQueryConfig` for type-safe column references\n * that are validated at compile time. Column objects carry `dataType` metadata\n * enabling automatic type coercion of filter values.\n *\n * @example\n * ```ts\n * import { users } from './schema'\n * import type { DrizzleColumnQueryConfig } from '@forinda/kickjs-drizzle'\n *\n * const config: DrizzleColumnQueryConfig = {\n *   columns: {\n *     status: users.status,\n *     isActive: users.isActive,\n *     createdAt: users.createdAt,\n *   },\n *   sortable: {\n *     name: users.name,\n *     createdAt: users.createdAt,\n *   },\n *   searchColumns: [users.firstName, users.lastName, users.email],\n *   baseCondition: eq(users.tenantId, tenantId),\n * }\n * ```\n */\nexport interface DrizzleColumnQueryConfig {\n  /**\n   * Map of filterable field names to Drizzle Column objects.\n   * Keys are the query parameter names, values are the actual schema columns.\n   * The column's `dataType` is used for automatic type coercion.\n   */\n  columns: Record<string, any>\n\n  /**\n   * Map of sortable field names to Drizzle Column objects.\n   * If not provided, falls back to `columns` for sort lookups.\n   */\n  sortable?: Record<string, any>\n\n  /**\n   * Column objects to search across when a search string is provided.\n   * Each entry should be a Drizzle Column (not a string).\n   */\n  searchColumns?: any[]\n\n  /**\n   * A pre-built SQL condition that is always prepended to the WHERE clause.\n   * Use for scoping queries by tenant, workspace, or other invariants.\n   *\n   * @example\n   * ```ts\n   * baseCondition: and(eq(tasks.tenantId, tid), eq(tasks.workspaceId, wid))\n   * ```\n   */\n  baseCondition?: any\n}\n\n/**\n * Configuration type for defining query param schemas with Drizzle Column objects.\n *\n * Used in constants files to define which columns are filterable, sortable, and searchable.\n * This type is consumed by both `DrizzleQueryAdapter.buildFromColumns()` and `@ApiQueryParams()`.\n *\n * @example\n * ```ts\n * import type { DrizzleQueryParamsConfig } from '@forinda/kickjs-drizzle'\n * import { tasks } from '@/db/schema'\n *\n * export const TASK_QUERY_CONFIG: DrizzleQueryParamsConfig = {\n *   columns: {\n *     status: tasks.status,\n *     priority: tasks.priority,\n *   },\n *   sortable: {\n *     title: tasks.title,\n *     createdAt: tasks.createdAt,\n *   },\n *   searchColumns: [tasks.title, tasks.key],\n * }\n * ```\n */\nexport interface DrizzleQueryParamsConfig {\n  /** Filterable columns: keys are query param names, values are Drizzle Column objects */\n  columns: Record<string, any>\n  /** Sortable columns: keys are query param names, values are Drizzle Column objects */\n  sortable?: Record<string, any>\n  /** Columns for text search */\n  searchColumns?: any[]\n  /** Optional base condition for scoping (tenant, workspace, etc.) */\n  baseCondition?: any\n}\n\n/**\n * Convert a DrizzleQueryParamsConfig into a string-based QueryFieldConfig.\n * Useful for passing to `@ApiQueryParams()` or other APIs that expect string arrays.\n *\n * @example\n * ```ts\n * import { toQueryFieldConfig } from '@forinda/kickjs-drizzle'\n *\n * const fieldConfig = toQueryFieldConfig(TASK_QUERY_CONFIG)\n * // → { filterable: ['status', 'priority'], sortable: ['title', 'createdAt'], searchable: [] }\n * ```\n */\nexport function toQueryFieldConfig(config: DrizzleQueryParamsConfig): {\n  filterable: string[]\n  sortable: string[]\n  searchable: string[]\n} {\n  return {\n    filterable: Object.keys(config.columns),\n    sortable: config.sortable ? Object.keys(config.sortable) : [],\n    searchable: config.searchColumns\n      ? config.searchColumns.map((col) => col.name ?? '').filter(Boolean)\n      : [],\n  }\n}\n\n/**\n * Result shape compatible with Drizzle's query builder.\n * Use with `db.select().from(table).where(result.where).orderBy(...result.orderBy).limit(result.limit).offset(result.offset)`\n */\nexport interface DrizzleQueryResult {\n  /** SQL condition — pass to `.where()` */\n  where?: any\n  /** Array of order expressions — spread into `.orderBy()` */\n  orderBy: any[]\n  /** Row limit — pass to `.limit()` */\n  limit: number\n  /** Row offset — pass to `.offset()` */\n  offset: number\n}\n\n/**\n * Drizzle operator functions required by the query adapter.\n * Pass these from your `drizzle-orm` import to avoid version coupling.\n *\n * @example\n * ```ts\n * import { eq, ne, gt, gte, lt, lte, ilike, inArray, between, and, or, asc, desc } from 'drizzle-orm'\n *\n * const adapter = new DrizzleQueryAdapter({\n *   eq, ne, gt, gte, lt, lte, ilike, inArray, between, and, or, asc, desc,\n * })\n * ```\n */\nexport interface DrizzleOps {\n  eq: (column: any, value: any) => any\n  ne: (column: any, value: any) => any\n  gt: (column: any, value: any) => any\n  gte: (column: any, value: any) => any\n  lt: (column: any, value: any) => any\n  lte: (column: any, value: any) => any\n  ilike: (column: any, value: string) => any\n  inArray: (column: any, values: any[]) => any\n  between?: (column: any, min: any, max: any) => any\n  and: (...conditions: any[]) => any\n  or: (...conditions: any[]) => any\n  asc: (column: any) => any\n  desc: (column: any) => any\n}\n\n/**\n * Translates a ParsedQuery into Drizzle-compatible query parts.\n *\n * Supports two modes:\n * 1. **String-based** (legacy): `build(parsed, { table, searchColumns })` — looks up columns by string name\n * 2. **Column-based** (recommended): `buildFromColumns(parsed, config)` — uses actual Column objects for type safety\n *\n * @example\n * ```ts\n * // String-based (legacy)\n * const query = adapter.build(parsed, { table: users, searchColumns: ['name', 'email'] })\n *\n * // Column-based (recommended)\n * const query = adapter.buildFromColumns(parsed, {\n *   columns: { status: users.status, isActive: users.isActive },\n *   searchColumns: [users.name, users.email],\n *   baseCondition: eq(users.tenantId, tid),\n * })\n *\n * const results = await db\n *   .select().from(users)\n *   .where(query.where)\n *   .orderBy(...query.orderBy)\n *   .limit(query.limit)\n *   .offset(query.offset)\n * ```\n */\nexport class DrizzleQueryAdapter implements QueryBuilderAdapter<\n  DrizzleQueryResult,\n  DrizzleQueryConfig\n> {\n  readonly name = 'DrizzleQueryAdapter'\n\n  constructor(private ops: DrizzleOps) {}\n\n  /**\n   * Build query from string-based config (legacy API).\n   * Prefer `buildFromColumns()` for type safety.\n   */\n  build(\n    parsed: ParsedQuery,\n    config: DrizzleQueryConfig = {} as DrizzleQueryConfig,\n  ): DrizzleQueryResult {\n    const result: DrizzleQueryResult = {\n      orderBy: [],\n      limit: parsed.pagination.limit,\n      offset: parsed.pagination.offset,\n    }\n\n    // Build where conditions\n    const conditions: any[] = []\n\n    // Filters\n    for (const filter of parsed.filters) {\n      const condition = this.buildFilter(config.table, filter)\n      if (condition) conditions.push(condition)\n    }\n\n    // Search\n    if (parsed.search && config.searchColumns && config.searchColumns.length > 0) {\n      const searchConditions = config.searchColumns\n        .filter((col) => config.table[col])\n        .map((col) => this.ops.ilike(config.table[col], `%${parsed.search}%`))\n\n      if (searchConditions.length > 0) {\n        conditions.push(this.ops.or(...searchConditions))\n      }\n    }\n\n    // Combine conditions\n    if (conditions.length === 1) {\n      result.where = conditions[0]\n    } else if (conditions.length > 1) {\n      result.where = this.ops.and(...conditions)\n    }\n\n    // Sort\n    result.orderBy = this.buildSort(config.table, parsed.sort)\n\n    return result\n  }\n\n  /**\n   * Build query using Column objects for type-safe filtering, sorting, and search.\n   *\n   * Features over `build()`:\n   * - Column references validated at compile time\n   * - Automatic type coercion based on `column.dataType` (boolean, number, date)\n   * - `baseCondition` support for tenant/workspace scoping\n   * - Native `between` operator support\n   * - Separate `sortable` map so filterable and sortable columns can differ\n   *\n   * @example\n   * ```ts\n   * const query = adapter.buildFromColumns(parsed, {\n   *   columns: { status: tasks.status, priority: tasks.priority },\n   *   sortable: { title: tasks.title, createdAt: tasks.createdAt },\n   *   searchColumns: [tasks.title, tasks.key],\n   *   baseCondition: eq(tasks.workspaceId, wid),\n   * })\n   * ```\n   */\n  buildFromColumns(parsed: ParsedQuery, config: DrizzleColumnQueryConfig): DrizzleQueryResult {\n    const result: DrizzleQueryResult = {\n      orderBy: [],\n      limit: parsed.pagination.limit,\n      offset: parsed.pagination.offset,\n    }\n\n    const conditions: any[] = []\n\n    // Prepend base condition (tenant/workspace scoping)\n    if (config.baseCondition) {\n      conditions.push(config.baseCondition)\n    }\n\n    // Filters — resolve column from the columns map\n    for (const filter of parsed.filters) {\n      const column = config.columns[filter.field]\n      if (!column) continue\n      const condition = this.buildColumnFilter(column, filter)\n      if (condition) conditions.push(condition)\n    }\n\n    // Search — use Column objects directly\n    if (parsed.search && config.searchColumns && config.searchColumns.length > 0) {\n      const searchConditions = config.searchColumns.map((col) =>\n        this.ops.ilike(col, `%${parsed.search}%`),\n      )\n      if (searchConditions.length > 0) {\n        conditions.push(this.ops.or(...searchConditions))\n      }\n    }\n\n    // Combine conditions\n    if (conditions.length === 1) {\n      result.where = conditions[0]\n    } else if (conditions.length > 1) {\n      result.where = this.ops.and(...conditions)\n    }\n\n    // Sort — use sortable map, falling back to columns\n    const sortMap = config.sortable ?? config.columns\n    result.orderBy = parsed.sort\n      .filter((item) => sortMap[item.field])\n      .map((item) =>\n        item.direction === 'desc'\n          ? this.ops.desc(sortMap[item.field])\n          : this.ops.asc(sortMap[item.field]),\n      )\n\n    return result\n  }\n\n  /** Map a single FilterItem to a Drizzle condition using string-based table lookup */\n  private buildFilter(table: Record<string, any>, filter: FilterItem): any {\n    const column = table[filter.field]\n    if (!column) return null\n\n    const value = this.coerce(filter.value)\n\n    switch (filter.operator) {\n      case 'eq':\n        return this.ops.eq(column, value)\n      case 'neq':\n        return this.ops.ne(column, value)\n      case 'gt':\n        return this.ops.gt(column, value)\n      case 'gte':\n        return this.ops.gte(column, value)\n      case 'lt':\n        return this.ops.lt(column, value)\n      case 'lte':\n        return this.ops.lte(column, value)\n      case 'contains':\n        return this.ops.ilike(column, `%${filter.value}%`)\n      case 'starts':\n        return this.ops.ilike(column, `${filter.value}%`)\n      case 'ends':\n        return this.ops.ilike(column, `%${filter.value}`)\n      case 'in': {\n        const values = filter.value.split(',').map((v) => this.coerce(v.trim()))\n        return this.ops.inArray(column, values)\n      }\n      case 'between': {\n        const [min, max] = filter.value.split(',').map((v) => this.coerce(v.trim()))\n        return this.ops.and(this.ops.gte(column, min), this.ops.lte(column, max))\n      }\n      default:\n        return this.ops.eq(column, value)\n    }\n  }\n\n  /**\n   * Map a FilterItem to a Drizzle condition using a Column object.\n   * Coerces values based on `column.dataType` for type-safe filtering.\n   */\n  private buildColumnFilter(column: any, filter: FilterItem): any {\n    const value = this.coerceByDataType(filter.value, column.dataType)\n\n    switch (filter.operator) {\n      case 'eq':\n        return this.ops.eq(column, value)\n      case 'neq':\n        return this.ops.ne(column, value)\n      case 'gt':\n        return this.ops.gt(column, value)\n      case 'gte':\n        return this.ops.gte(column, value)\n      case 'lt':\n        return this.ops.lt(column, value)\n      case 'lte':\n        return this.ops.lte(column, value)\n      case 'contains':\n        return this.ops.ilike(column, `%${filter.value}%`)\n      case 'starts':\n        return this.ops.ilike(column, `${filter.value}%`)\n      case 'ends':\n        return this.ops.ilike(column, `%${filter.value}`)\n      case 'in': {\n        const values = filter.value\n          .split(',')\n          .map((v) => this.coerceByDataType(v.trim(), column.dataType))\n        return this.ops.inArray(column, values)\n      }\n      case 'between': {\n        const [minStr, maxStr] = filter.value.split(',').map((v) => v.trim())\n        const min = this.coerceByDataType(minStr, column.dataType)\n        const max = this.coerceByDataType(maxStr, column.dataType)\n        if (this.ops.between) {\n          return this.ops.between(column, min, max)\n        }\n        return this.ops.and(this.ops.gte(column, min), this.ops.lte(column, max))\n      }\n      default:\n        return this.ops.eq(column, value)\n    }\n  }\n\n  /** Build Drizzle orderBy from SortItem[] */\n  private buildSort(table: Record<string, any>, sort: SortItem[]): any[] {\n    return sort\n      .filter((item) => table[item.field])\n      .map((item) =>\n        item.direction === 'desc'\n          ? this.ops.desc(table[item.field])\n          : this.ops.asc(table[item.field]),\n      )\n  }\n\n  /** Attempt to coerce a string value to a number or boolean if appropriate */\n  private coerce(value: string): string | number | boolean {\n    if (value === 'true') return true\n    if (value === 'false') return false\n    const num = Number(value)\n    if (!Number.isNaN(num) && value.trim() !== '') return num\n    return value\n  }\n\n  /**\n   * Coerce a string value based on the column's dataType.\n   *\n   * - `'boolean'` → `true`/`false`\n   * - `'number'` / `'bigint'` → `Number(value)`\n   * - `'date'` → `new Date(value)` (ISO 8601 strings)\n   * - Everything else → original string\n   */\n  private coerceByDataType(value: string, dataType?: string): string | number | boolean | Date {\n    if (!dataType) return this.coerce(value)\n\n    switch (dataType) {\n      case 'boolean':\n        return value === 'true' || value === '1'\n      case 'number':\n      case 'bigint': {\n        const num = Number(value)\n        return Number.isNaN(num) ? value : num\n      }\n      case 'date':\n      case 'localDate':\n      case 'localDateTime': {\n        const date = new Date(value)\n        return Number.isNaN(date.getTime()) ? value : date\n      }\n      default:\n        return value\n    }\n  }\n}\n"],"mappings":"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","names":["Logger","Scope","DRIZZLE_DB","Symbol","log","Logger","for","DrizzleAdapter","name","db","onShutdown","options","beforeStart","_app","container","logging","info","registerFactory","DRIZZLE_DB","Scope","SINGLETON","shutdown","toQueryFieldConfig","config","filterable","Object","keys","columns","sortable","searchable","searchColumns","map","col","name","filter","Boolean","DrizzleQueryAdapter","ops","build","parsed","result","orderBy","limit","pagination","offset","conditions","filters","condition","buildFilter","table","push","search","length","searchConditions","ilike","or","where","and","buildSort","sort","buildFromColumns","baseCondition","column","field","buildColumnFilter","sortMap","item","direction","desc","asc","value","coerce","operator","eq","ne","gt","gte","lt","lte","values","split","v","trim","inArray","min","max","coerceByDataType","dataType","minStr","maxStr","between","num","Number","isNaN","date","Date","getTime"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-drizzle",
-  "version": "1.2.9",
+  "version": "1.2.11",
   "description": "Drizzle ORM adapter with DI integration, transaction support, and query building for KickJS",
   "keywords": [
     "kickjs",
@@ -44,8 +44,8 @@
   ],
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "1.2.9",
-    "@forinda/kickjs-http": "1.2.9"
+    "@forinda/kickjs-core": "1.2.11",
+    "@forinda/kickjs-http": "1.2.11"
   },
   "peerDependencies": {
     "drizzle-orm": ">=0.30.0"