@lakeql/query-builder 0.2.0 → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
 # @lakeql/query-builder
 
-SQL query builder for Trino using Kysely, supporting dynamic filters (AND/OR), sorting, pagination, and field transformations.
+SQL query builder using Kysely, supporting dynamic filters (AND/OR), sorting, pagination, and field transformations across adapters.
 
 ## Installation
 

package/dist/index.d.mts

@@ -1,10 +1,47 @@
+/**
+ * Special thanks goes to https://github.com/igalklebanov
+ * for solving our edge case issue with multiple schematas <3
+ * https://www.answeroverflow.com/m/1227929774144618598
+ * and also with helping to solve the type issues <3
+ * https://www.answeroverflow.com/m/1228457827572645908
+ */
 import { GraphQLResolveInfo } from "graphql";
-import { CompiledQuery, ExpressionBuilder, ExpressionWrapper, SelectExpression, SqlBool } from "kysely";
-//#region src/index.d.ts
+import { DatabaseIntrospector, DialectAdapter, ExpressionBuilder, ExpressionWrapper, Kysely, QueryCompiler, RawBuilder, SelectExpression, SqlBool } from "kysely";
+import { AdapterName, SourceConfig } from "@lakeql/datasource";
+/**
+ * Engine-specific SQL generation strategy for Kysely.
+ *
+ * Each adapter provides a dialect that handles identifier quoting,
+ * pagination syntax, date functions, and sql-formatter language selection.
+ * The dialect is injected into the query builder — the query builder
+ * itself contains no adapter-specific SQL logic.
+ */
+interface QueryDialect {
+  /** Open adapter name identifying the backend this dialect targets. */
+  readonly adapterName: AdapterName;
+  /** Creates the Kysely dialect adapter (e.g. PostgresAdapter, MssqlAdapter). */
+  createAdapter: () => DialectAdapter;
+  /** Creates the Kysely query compiler for the target backend. */
+  createQueryCompiler: () => QueryCompiler;
+  /** Creates the Kysely database introspector for the target backend. */
+  createIntrospector: (db: Kysely<unknown>) => DatabaseIntrospector;
+  /** Wraps a column name in the backend-specific timestamp-to-unix conversion function. */
+  toUnixTimestamp: (field: string) => RawBuilder<unknown>;
+  /** Returns a raw SQL fragment for limit/offset pagination. */
+  pagination: (limit: number, offset?: number) => RawBuilder<unknown>;
+  /**
+   * Backend-specific boolean "true" literal used for the record-present
+   * sentinel column in the `records` CTE. Trino uses `TRUE`; T-SQL backends
+   * (e.g. Fabric) have no boolean literal and use `1`.
+   */
+  trueLiteral: () => RawBuilder<unknown>;
+  /** Returns the fully-qualified table name with backend-specific quoting. */
+  qualifiedTable: (config: SourceConfig) => string;
+}
 /**
  * Logical operators for combining filter conditions.
  */
-declare enum WhereOperator {
+export declare enum WhereOperator {
   AND = "and",
   OR = "or"
 }
@@ -15,7 +52,7 @@ declare enum WhereOperator {
  * String operators compare the field value against the provided string.
  * Boolean operators (`is`/`isNot`) check for equality with `true`/`false`.
  */
-interface FieldOptions {
+export interface FieldOptions {
   eq?: string;
   neq?: string;
   in?: string;
@@ -32,9 +69,9 @@ interface FieldOptions {
 /**
  * Defines the sort order for a query result.
  *
- * @template TableDefinition - The table type used to constrain the `field` to valid column names. See [Introduction](/docs/query-builder/overview/introduction) for details.
+ * @template TableDefinition - The table type used to constrain the `field` to valid column names. See [query-builder](/docs/packages/query-builder) for details.
  */
-interface SortInput<TableDefinition> {
+export interface SortInput<TableDefinition> {
   /**
    * Column name to sort by. Constrained to valid column names from the table type.
    *
@@ -47,7 +84,7 @@ interface SortInput<TableDefinition> {
 /**
  * Controls offset-based pagination.
  */
-interface PagingInput {
+export interface PagingInput {
   /**
    * Maximum number of rows to return.
    * @default 100
@@ -60,12 +97,12 @@ interface PagingInput {
  * A single field condition — a record where the key is the field name
  * and the value is a [FieldOptions](#field-options) object describing the comparison.
  */
-type Field = Record<string, FieldOptions>;
+export type Field = Record<string, FieldOptions>;
 /**
  * A recursive filter structure that can contain AND/OR groups,
  * each holding field conditions or further nested groups.
  */
-type Where = Partial<Record<WhereOperator, (Where | Field)[]>>;
+export type Where = Partial<Record<WhereOperator, (Where | Field)[]>>;
 /**
  * KyselyDatabase is our generic interface which simulates
  * the normal kysely table definition
@@ -74,23 +111,26 @@ interface KyselyDatabase<TableDefinition> {
   tablename: TableDefinition;
 }
 /**
- * Parameters for generating a Trino-compatible SQL query from GraphQL resolve info.
+ * Parameters for generating an adapter-aware SQL query from GraphQL resolve info.
  *
- * @template TableDefinition - The table type definition used by Kysely for type-safe column references. See [Introduction](/docs/query-builder/overview/introduction) for details.
+ * @template TableDefinition - The table type definition used by Kysely for type-safe column references. See [query-builder](/docs/packages/query-builder) for details.
  */
-interface GenerateQueryProps<TableDefinition> {
-  /** The Trino catalog name (e.g. "hive"). */
+export interface GenerateQueryProps<TableDefinition> {
+  /** The query dialect providing adapter-specific SQL generation. */
+  dialect: QueryDialect;
+  /** The catalog name (e.g. "hive"). */
   catalog: string;
-  /** The Trino schema name (e.g. "sales"). */
+  /** The schema name (e.g. "sales"). */
   schema: string;
   /** The table name to query. */
   table: string;
   /**
-   * The columns to select, derived from GraphQL field selections.
+   * The column names to select, derived from GraphQL field selections.
    *
-   * @see {@link https://kysely-org.github.io/kysely-apidoc/types/SelectExpression.html | Kysely API Docs - SelectExpression}
+   * These are plain field-name strings (as returned by {@link getSelectFields});
+   * they are resolved against the table definition when the query is built.
    */
-  selectFields: SelectExpression<KyselyDatabase<TableDefinition>, keyof KyselyDatabase<TableDefinition>>[];
+  selectFields: readonly string[];
   /** The user-provided filter query (WHERE clause). */
   userQuery: Where;
   /** Pagination parameters (limit and offset). */
@@ -99,15 +139,15 @@ interface GenerateQueryProps<TableDefinition> {
   sorting: SortInput<TableDefinition>[];
   /** Maps GraphQL field names to database column names. */
   transformFields?: Record<string, string>;
-  /** Fields that should be wrapped in `to_unixtime()` for date conversion. */
+  /** Fields that should be wrapped in adapter-specific timestamp conversion. */
   dateFields?: string[];
 }
 /**
  * Parameters for building a single field comparison expression.
  *
- * @template TableDefinition - The table type definition. See [Introduction](/docs/query-builder/overview/introduction) for details.
+ * @template TableDefinition - The table type definition. See [query-builder](/docs/packages/query-builder) for details.
  */
-interface GetFieldQueryProps<TableDefinition> {
+export interface GetFieldQueryProps<TableDefinition> {
   /**
    * The Kysely expression builder for constructing SQL expressions.
    *
@@ -128,7 +168,7 @@ interface GetFieldQueryProps<TableDefinition> {
  * @param props - The field query parameters.
  * @returns A Kysely [ExpressionWrapper](https://kysely-org.github.io/kysely-apidoc/classes/ExpressionWrapper.html) representing the comparison.
  */
-declare function getFieldQuery<TableDefinition>({ eb, fieldName, operator, value }: GetFieldQueryProps<TableDefinition>): ExpressionWrapper<KyselyDatabase<TableDefinition>, "tablename", SqlBool>;
+export declare function getFieldQuery<TableDefinition>({ eb, fieldName, operator, value }: GetFieldQueryProps<TableDefinition>): ExpressionWrapper<KyselyDatabase<TableDefinition>, "tablename", SqlBool>;
 /**
  * Normalizes filter objects by ensuring each field is in its own object within and/or arrays.
  *
@@ -138,7 +178,7 @@ declare function getFieldQuery<TableDefinition>({ eb, fieldName, operator, value
  * @param filter - The filter object to normalize.
  * @returns A normalized filter with individual field entries.
  */
-declare function normalizeFilter(filter: Where): Where;
+export declare function normalizeFilter(filter: Where): Where;
 /**
  * Wraps bare field-level filters into an AND-rooted structure.
  *
@@ -148,42 +188,22 @@ declare function normalizeFilter(filter: Where): Where;
  * @param userQuery - The user-provided filter query.
  * @returns A normalized query with a logical operator at the root.
  */
-declare function normalizeUserQuery(userQuery: Where): Where;
+export declare function normalizeUserQuery(userQuery: Where): Where;
 /**
- * Generates a compiled SQL query with pagination metadata for Trino.
+ * Generates a compiled SQL query with pagination metadata using the injected dialect.
  *
  * The query uses two CTEs internally:
  * - `total_count` — provides `total_records` (total matching rows before paging)
  * - `records` — the actual rows based on `selectFields`, filtering, sorting, and paging
  *
- * The compiled query is executed by the Trino client which returns the row data.
+ * The compiled query is executed by the DataSource adapter which returns the row data.
  *
- * @returns A [CompiledQuery](https://kysely-org.github.io/kysely-apidoc/interfaces/CompiledQuery.html) ready for execution via the Trino client.
+ * @returns A [CompiledQuery](https://kysely-org.github.io/kysely-apidoc/interfaces/CompiledQuery.html) ready for execution via the DataSource adapter.
  */
-declare function generateQuery<TableDefinition>({ catalog, schema, table, selectFields, userQuery, sorting, paging, transformFields, dateFields }: GenerateQueryProps<TableDefinition>): CompiledQuery<{
+export declare function generateQuery<TableDefinition>({ dialect, catalog, schema, table, selectFields, userQuery, sorting, paging, transformFields, dateFields }: GenerateQueryProps<TableDefinition>): import("kysely").CompiledQuery<{
   total_records: number;
 }>;
-/**
- * Parameters for formatting a compiled SQL query.
- */
-interface FormatQueryProps<T> {
-  /**
-   * The compiled Kysely query to format.
-   *
-   * @see {@link https://kysely-org.github.io/kysely-apidoc/interfaces/CompiledQuery.html | Kysely API Docs - CompiledQuery}
-   */
-  query: CompiledQuery<T>;
-}
-/**
- * Formats a compiled SQL query for readability.
- *
- * Applies uppercase keywords, PostgreSQL dialect, and interpolates parameters.
- *
- * @param props - The format query parameters.
- * @returns The formatted SQL string with interpolated parameters.
- */
-declare function formatQuery<T>({ query }: FormatQueryProps<T>): string;
-interface GetSelectFieldProps {
+export interface GetSelectFieldProps {
   /**
    * The GraphQL resolve info from the resolver.
    *
@@ -201,6 +221,5 @@ interface GetSelectFieldProps {
  *
  * @returns An array of field names to use as SELECT columns.
  */
-declare function getSelectFields<T>({ graphqlInfo, withNodes }: GetSelectFieldProps): GenerateQueryProps<T>["selectFields"];
-//#endregion
-export { Field, FieldOptions, FormatQueryProps, GenerateQueryProps, GetFieldQueryProps, GetSelectFieldProps, PagingInput, SortInput, Where, WhereOperator, formatQuery, generateQuery, getFieldQuery, getSelectFields, normalizeFilter, normalizeUserQuery };
+export declare function getSelectFields({ graphqlInfo, withNodes }: GetSelectFieldProps): string[];
+export type { QueryDialect };

package/dist/index.mjs

@@ -1 +1,5 @@
-import{GraphQLError as e}from"graphql";import{DummyDriver as t,Kysely as n,PostgresAdapter as r,PostgresIntrospector as i,PostgresQueryCompiler as a,sql as o}from"kysely";import{format as s}from"sql-formatter";const c=()=>new n({dialect:{createAdapter(){return new r},createDriver(){return new t},createIntrospector(e){return new i(e)},createQueryCompiler(){return new a}}});let l=function(e){return e.AND=`and`,e.OR=`or`,e}({});const u={eq:`=`,gt:`>`,gte:`>=`,in:`in`,is:`=`,isnot:`!=`,lt:`<`,lte:`<=`,neq:`!=`,notin:`not in`};function d({eb:e,fieldName:t,operator:n,value:r}){let i=t,a=n.toLowerCase();switch(a){case`eq`:case`neq`:case`lt`:case`lte`:case`gt`:case`gte`:case`is`:case`isnot`:return e(o.id(i),u[a]??`=`,r);case`in`:case`notin`:return e(o.id(i),u[a]??`=`,r);case`like`:return e(o.id(i),`like`,`%${r}%`);case`notlike`:return e.not(e(o.id(i),`like`,`%${r}%`));case`startswith`:return e(o.id(i),`like`,`${r}%`);case`notstartswith`:return e.not(e(o.id(i),`like`,`${r}%`));case`endswith`:return e(o.id(i),`like`,`%${r}`);case`notendswith`:return e.not(e(o.id(i),`like`,`%${r}`));default:return e(o.id(i),`=`,r)}}function f({eb:e,query:t,transformFields:n}){let r=[];for(let[i,a]of Object.entries(t))switch(i.toLowerCase()){case`and`:for(let t of a){let i=f({eb:e,query:t,transformFields:n});i!==void 0&&r.push(i)}return e.and(r);case`or`:for(let t of a){let i=f({eb:e,query:t,transformFields:n});i&&r.push(i)}return e.or(r);default:{let[t,r]=Object.entries(a).flat();return d({eb:e,fieldName:n?.[i]??i,operator:t,value:r})}}}function p(e){if(!e)return e;let t={...e};return t.and&&Array.isArray(t.and)&&(t.and=t.and.flatMap(e=>{let t=e,n=Object.keys(t),r=n.filter(e=>e===`and`||e===`or`),i=n.filter(e=>e!==`and`&&e!==`or`);if(i.length>0&&r.length>0){let e=i.map(e=>({[e]:t[e]})),n=r.map(e=>({[e]:p({[e]:t[e]})[e]}));return[...e,...n]}if(i.length>1&&r.length===0)return i.map(e=>({[e]:t[e]}));if(r.length>0){let e={...t};for(let n of r)e[n]=p({[n]:t[n]})[n];return e}return e})),t.or&&Array.isArray(t.or)&&(t.or=t.or.flatMap(e=>{let t=e,n=Object.keys(t),r=n.filter(e=>e===`and`||e===`or`),i=n.filter(e=>e!==`and`&&e!==`or`);if(i.length>0&&r.length>0){let e=i.map(e=>({[e]:t[e]})),n=r.map(e=>({[e]:p({[e]:t[e]})[e]}));return[...e,...n]}if(i.length>1&&r.length===0)return i.map(e=>({[e]:t[e]}));if(r.length>0){let e={...t};for(let n of r)e[n]=p({[n]:t[n]})[n];return e}return e})),t}function m(e){let t=Object.keys(e);return t.length===1&&(t[0]===`and`||t[0]===`or`)?e:{and:Object.entries(e).map(([e,t])=>({[e]:t}))}}function h({catalog:e,schema:t,table:n,selectFields:r,userQuery:i,sorting:a,paging:s,transformFields:l,dateFields:u=[]}){let d=c(),{ref:h}=d.dynamic;return d.with(`total_count`,r=>r.selectFrom(o.id(e,t,n)).select(({fn:e})=>e.countAll().as(`total_records`)).$if(Object.keys(i).length>0,e=>e.where(e=>f({eb:e,query:p(m(i)),transformFields:l})??e.and([])))).with(`records`,c=>{let d=c.selectFrom(o.id(e,t,n)).select(r.map(e=>u.includes(e)?l?.[e]?o.raw(`to_unixtime(${l[e]})`).as(l[e]):o.raw(`to_unixtime(${e})`).as(e):l?.[e]?o.id(l[e]).as(l[e]):typeof e==`string`?h(e):e)).$if(Object.keys(i).length>0,e=>e.where(e=>f({eb:e,query:p(m(i)),transformFields:l})??e.and([])));for(let e of a){let t=l?.[e.field]||e.field;d=d.orderBy(t,e.direction.toLowerCase())}return d=!s?.offset||s.offset<=0?d.modifyEnd(o.raw(`FETCH FIRST ${s?.limit??100} ROWS ONLY`)):d.offset(s.offset??100).modifyEnd(o.raw(`FETCH NEXT ${s.limit??100} ROWS ONLY`)),d}).selectFrom(`total_count`).selectAll().fullJoin(`records`,e=>e.onTrue()).compile()}function g({query:e}){let t={};for(let[n,r]of e.parameters.entries())t[n+1]=String(typeof r==`string`?`'${r}'`:r);return s(e.sql,{keywordCase:`upper`,language:`postgresql`,params:t,tabWidth:0,useTabs:!1})}function _({graphqlInfo:t,withNodes:n=!1}){return t.fieldNodes.flatMap(t=>{let r=t.selectionSet?.selections,i=[];if(n){let t=r.find(e=>e.name.value===`nodes`);if(!t)throw new e("No fields to return defined. Please specify at least one field inside `nodes`.");i=t.selectionSet?.selections??[]}else i=t.selectionSet?.selections??[];return i.flatMap(e=>e.name.value)})}export{l as WhereOperator,g as formatQuery,h as generateQuery,d as getFieldQuery,_ as getSelectFields,p as normalizeFilter,m as normalizeUserQuery};
+import{GraphQLError as e}from"graphql";import{DummyDriver as t,Kysely as n,sql as r}from"kysely";const i=e=>new n({dialect:{...e,createDriver:()=>new t}});let a=/* @__PURE__ */ function(e){return e.AND=`and`,e.OR=`or`,e}({});const o={eq:`=`,gt:`>`,gte:`>=`,in:`in`,is:`=`,isnot:`!=`,lt:`<`,lte:`<=`,neq:`!=`,notin:`not in`};function s({eb:e,fieldName:t,operator:n,value:i}){let a=t,s=n.toLowerCase();switch(s){case`eq`:case`neq`:case`lt`:case`lte`:case`gt`:case`gte`:case`is`:case`isnot`:return e(r.id(a),o[s]??`=`,i);case`in`:case`notin`:return e(r.id(a),o[s]??`=`,i);case`like`:return e(r.id(a),`like`,`%${i}%`);case`notlike`:return e.not(e(r.id(a),`like`,`%${i}%`));case`startswith`:return e(r.id(a),`like`,`${i}%`);case`notstartswith`:return e.not(e(r.id(a),`like`,`${i}%`));case`endswith`:return e(r.id(a),`like`,`%${i}`);case`notendswith`:return e.not(e(r.id(a),`like`,`%${i}`));default:return e(r.id(a),`=`,i)}}function c({eb:e,query:t,transformFields:n}){let r=[];for(let[i,a]of Object.entries(t))switch(i.toLowerCase()){case`and`:for(let t of a){let i=c({eb:e,query:t,transformFields:n});i!==void 0&&r.push(i)}return e.and(r);case`or`:for(let t of a){let i=c({eb:e,query:t,transformFields:n});i&&r.push(i)}return e.or(r);default:{let[t,r]=Object.entries(a).flat();return s({eb:e,fieldName:n?.[i]??i,operator:t,value:r})}}}function l(e){if(!e)return e;let t={...e};return t.and&&Array.isArray(t.and)&&(t.and=t.and.flatMap(e=>{let t=e,n=Object.keys(t),r=n.filter(e=>e===`and`||e===`or`),i=n.filter(e=>e!==`and`&&e!==`or`);
+/* c8 ignore next 6 */
+if(i.length>0&&r.length>0){let e=i.map(e=>({[e]:t[e]})),n=r.map(e=>({[e]:l({[e]:t[e]})[e]}));return[...e,...n]}if(i.length>1&&r.length===0)return i.map(e=>({[e]:t[e]}));if(r.length>0){let e={...t};for(let n of r)e[n]=l({[n]:t[n]})[n];return e}return e})),t.or&&Array.isArray(t.or)&&(t.or=t.or.flatMap(e=>{let t=e,n=Object.keys(t),r=n.filter(e=>e===`and`||e===`or`),i=n.filter(e=>e!==`and`&&e!==`or`);
+/* c8 ignore next 6 */
+if(i.length>0&&r.length>0){let e=i.map(e=>({[e]:t[e]})),n=r.map(e=>({[e]:l({[e]:t[e]})[e]}));return[...e,...n]}if(i.length>1&&r.length===0)return i.map(e=>({[e]:t[e]}));if(r.length>0){let e={...t};for(let n of r)e[n]=l({[n]:t[n]})[n];return e}return e})),t}function u(e){let t=Object.keys(e);return t.length===1&&(t[0]===`and`||t[0]===`or`)?e:{and:Object.entries(e).map(([e,t])=>({[e]:t}))}}function d({dialect:e,catalog:t,schema:n,table:a,selectFields:o,userQuery:s,sorting:d,paging:f,transformFields:p,dateFields:m=[]}){let h=i(e),g=e.qualifiedTable({dataSource:``,adapter:e.adapterName,catalog:t,schema:n,tableName:a}),{ref:_}=h.dynamic;return h.with(`total_count`,e=>e.selectFrom(r.raw(g)).select(({fn:e})=>e.countAll().as(`total_records`)).$if(Object.keys(s).length>0,e=>e.where(e=>c({eb:e,query:l(u(s)),transformFields:p})??e.and([])))).with(`records`,t=>{let n=t.selectFrom(r.raw(g)).select(o.map(t=>{if(m.includes(t)){if(p?.[t]){let n=p[t];return e.toUnixTimestamp(n).as(n)}return e.toUnixTimestamp(t).as(t)}return p?.[t]?r.id(p[t]).as(p[t]):typeof t==`string`?_(t):t})).select(e.trueLiteral().as(`__lakeql_record_present`)).$if(Object.keys(s).length>0,e=>e.where(e=>c({eb:e,query:l(u(s)),transformFields:p})??e.and([])));for(let e of d){let t=p?.[e.field]||e.field;n=n.orderBy(t,e.direction.toLowerCase())}let i=f?.limit??100,a=f?.offset;return n=!a||a<=0?n.modifyEnd(e.pagination(i)):n.offset(a).modifyEnd(e.pagination(i,a)),n}).selectFrom(`total_count`).selectAll().fullJoin(`records`,e=>e.on(r`1=1`)).compile()}function f({graphqlInfo:t,withNodes:n=!1}){return t.fieldNodes.flatMap(t=>{let r=t.selectionSet?.selections,i=[];if(n){let t=r.find(e=>e.name.value===`nodes`);if(!t)throw new e("No fields to return defined. Please specify at least one field inside `nodes`.");i=t.selectionSet?.selections??[]}else i=t.selectionSet?.selections??[];return i.flatMap(e=>e.name.value)})}export{a as WhereOperator,d as generateQuery,s as getFieldQuery,f as getSelectFields,l as normalizeFilter,u as normalizeUserQuery};

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@lakeql/query-builder",
-  "version": "0.2.0",
-  "description": "Kysely-based SQL query builder that translates GraphQL queries into Trino SQL",
+  "version": "1.0.1",
+  "description": "Kysely-based SQL query builder that translates GraphQL queries into adapter SQL",
   "keywords": [
     "graphql",
     "kysely",
     "lakeql",
     "query-builder",
     "sql",
-    "trino"
+    "typescript"
   ],
   "homepage": "https://lakeql.dev",
   "license": "Apache-2.0",
@@ -39,19 +39,22 @@
       "import": "./dist/index.mjs"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
-    "date-fns": "4.4.0",
-    "kysely": "0.29.4",
-    "sql-formatter": "15.8.2"
+    "@lakeql/datasource": "1.0.1",
+    "kysely": "0.29.8"
   },
   "devDependencies": {
-    "@pothos/core": "4.13.1",
-    "@types/node": "24.13.3",
-    "graphql": "16.14.2",
-    "tsdown": "0.22.13",
+    "@lakeql/tsconfig": "0.1.0",
+    "@lakeql/vitest-config": "0.1.0",
+    "@pothos/core": "4.16.0",
+    "@types/node": "24.19.2",
+    "graphql": "17.1.0",
+    "tsdown": "0.23.7",
     "typescript": "6.0.3",
-    "vitest": "4.1.10",
-    "@lakeql/tsconfig": "0.1.0"
+    "vitest": "5.1.0"
   },
   "scripts": {
     "build": "tsdown",
@@ -59,6 +62,7 @@
     "clean:cache": "git clean -xdf .cache .turbo",
     "clean:dist": "git clean -xdf dist",
     "dev": "tsdown --watch",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit"
   }
 }