@pdg/drizzle-mysql 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,372 @@
-# Temporary Holding Version
+# @pdg/drizzle-mysql
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Drizzle ORM과 mysql2를 사용하는 Node.js용 MySQL 보조 라이브러리입니다. `drizzle-orm@1.0.0-rc.5`를 기준으로 합니다.
+
+## 설치
+
+```sh
+npm install @pdg/drizzle-mysql drizzle-orm@1.0.0-rc.5 mysql2
+```
+
+## 사용
+
+### 연결과 스키마
+
+테이블 정의에는 Drizzle의 MySQL 스키마 API를 패키지 루트에서 가져올 수 있습니다. 연결은 `drizzleMySql`에 MySQL 연결 URL과 스키마를 전달해 만듭니다.
+
+```ts
+import {
+  drizzleMySql,
+  int,
+  mysqlTable,
+  varchar,
+} from '@pdg/drizzle-mysql';
+
+const users = mysqlTable('users', {
+  id: int('id').autoincrement().primaryKey(),
+  name: varchar('name', { length: 100 }).notNull(),
+  email: varchar('email', { length: 255 }),
+  created_at: varchar('created_at', { length: 30 }),
+  updated_at: varchar('updated_at', { length: 30 }),
+});
+const posts = mysqlTable('posts', {
+  id: int('id').autoincrement().primaryKey(),
+  user_id: int('user_id').notNull(),
+  title: varchar('title', { length: 200 }).notNull(),
+});
+
+const db = drizzleMySql({
+  url: process.env.DATABASE_URL!,
+  schema: { users, posts },
+});
+const user = db.query(users);
+```
+
+`drizzleMySql` 옵션은 `url`, `schema`, 선택 사항인 `timestamp`, `timestampColumns`입니다. `db.query(table)`은 해당 테이블에 맞춰 타입이 지정된 쿼리 객체를 반환합니다. 연결을 다 사용한 뒤 `await db.close()`로 커넥션 풀을 닫습니다.
+
+### 데이터 추가·수정·삭제
+
+자동 증가 기본 키가 있는 테이블에서 `add`는 생성된 키를 반환합니다. 여러 행을 넣으면 키 배열을 반환합니다.
+
+```ts
+const id = await user.add({ name: '홍길동', email: 'hong@example.com' });
+const ids = await user.add([
+  { name: '김민수', email: 'minsu@example.com' },
+  { name: '이서연', email: 'seoyeon@example.com' },
+]);
+
+await user.editByPrimaryKey({ name: '김민수' }, id);
+await user.removeByPrimaryKey(id);
+```
+
+조건으로 수정·삭제할 때는 반드시 SQL 조건을 전달해야 합니다. 실수로 테이블 전체를 갱신하거나 삭제하지 않도록 조건이 없으면 오류가 발생합니다.
+
+```ts
+await user.edit({ name: '수정된 이름' }, user.eq({ id }));
+await user.remove(user.eq({ id }));
+```
+
+복합 기본 키 테이블은 기본 키 컬럼명을 모두 포함한 객체를 사용합니다. 단일 기본 키는 값 하나 또는 기본 키 객체를 전달할 수 있습니다.
+
+```ts
+const found = await user.findByPrimaryKey(id);
+const exists = await user.existsByPrimaryKey(id);
+const missing = await user.notExistsByPrimaryKey(id);
+```
+
+### 조회와 컬럼 선택
+
+`select`는 Drizzle 조회 빌더를 반환하므로 `where`, `orderBy`, `limit` 등 Drizzle의 빌더 메서드를 이어서 사용할 수 있습니다. `find`는 한 행을 조회하며, 결과가 없으면 `undefined`를 반환합니다.
+
+```ts
+const rows = await user
+  .select(['id', 'name'])
+  .where(user.gt({ id: 0 }))
+  .orderBy(user.t.id)
+  .limit(20);
+
+const found = await user.find(['id', 'name'], user.eq({ id }));
+const count = await user.count(user.isNotNull('email'));
+const exists = await user.exists(user.eq({ email: 'hong@example.com' }));
+```
+
+컬럼 선택에는 컬럼명 배열, Drizzle 선택 객체, 또는 `columns()`를 사용하는 콜백을 사용할 수 있습니다. `columns()`는 전체 컬럼 또는 지정한 컬럼만 가져오며, `as`로 결과 키를 지정할 수 있습니다.
+
+```ts
+const allColumns = user.columns();
+const selectedColumns = user.columns('id', 'name as displayName');
+
+const projected = await user.find(
+  (query) => [query.columns('id', 'name as displayName')],
+  user.eq({ id })
+);
+```
+
+테이블의 TypeScript 속성명과 SQL 컬럼명을 다르게 지정하면 기본 전체 조회 결과 키와 추론된 타입이 달라질 수 있습니다. 기본 컬럼 선택을 사용할 경우 스키마 속성명과 SQL 컬럼명을 같게 작성하는 것을 권장합니다. 이름이 다르면 필요한 컬럼을 명시적으로 선택하고 별칭을 지정하세요.
+
+### 조건식
+
+조건 함수는 `db` 연결 객체나 `db.query(table)`이 반환한 쿼리 객체에서 사용할 수 있습니다. 쿼리 객체 메서드는 해당 테이블의 컬럼을 기준으로 타입을 검사하고, `db` 메서드는 테이블 객체 또는 연결 스키마에 등록된 스키마 키를 함께 받습니다.
+
+```ts
+const byName = user.eq({ name: '홍길동' });
+const bySchemaKey = db.eq('users', { name: '홍길동' });
+const byTable = db.eq(users, { name: '홍길동' });
+```
+
+`createConditions(schema)`를 직접 호출해도 같은 조건 함수를 만들 수 있습니다. 독립된 조건 빌더가 필요할 때 사용하며, 반환된 함수는 생성할 때 전달한 스키마의 키와 테이블을 기준으로 동작합니다.
+
+```ts
+import { createConditions } from '@pdg/drizzle-mysql';
+
+const condition = createConditions({ users });
+const where = condition.and('users', {
+  gte: { id: 1 },
+  isNotNull: 'email',
+});
+const rows = await user.select().where(where);
+```
+
+#### 비교 연산자
+
+`eq`, `ne`, `gt`, `gte`, `lt`, `lte`는 컬럼과 값을 비교합니다. 하나의 값 객체에 여러 컬럼을 넣으면 각 비교가 `AND`로 묶입니다. `undefined` 값은 생략되므로 선택적 검색 조건을 만들 때 유용합니다.
+
+```ts
+const filters = {
+  name: searchName,
+  email: searchEmail,
+};
+
+const rows = await user.find((query) =>
+  query.eq({
+    name: filters.name,
+    email: filters.email,
+  })
+);
+
+const changedIds = await user
+  .select(['id'])
+  .where(user.and({
+    gte: { id: 10 },
+    lte: { id: 50 },
+  }));
+```
+
+`eq({ email: null })`은 `IS NULL`, `ne({ email: null })`은 `IS NOT NULL`로 변환됩니다. `gt` 등의 비교 연산자에는 `null`을 전달할 수 없습니다.
+
+#### 배열과 범위
+
+`inArray`와 `notInArray`는 컬럼별 허용·제외 값 배열을 받고, `between`과 `notBetween`은 `[시작, 끝]` 튜플을 받습니다. 한 객체에 여러 컬럼을 지정하면 각각의 조건은 `AND`로 결합됩니다.
+
+```ts
+const selected = await user.find((query) =>
+  query.and({
+    inArray: { id: [1, 3, 5, 7] },
+    notInArray: { name: ['차단 사용자', '삭제 사용자'] },
+    between: { id: [1, 100] },
+  })
+);
+
+const recentIds = await user
+  .select(['id'])
+  .where(user.notBetween({ id: [1, 10] }));
+```
+
+범위 양 끝은 `null`이나 `undefined`가 아닌 값이어야 합니다. `inArray`와 `notInArray`의 값은 배열이어야 합니다.
+
+#### 문자열 패턴
+
+`like`, `notLike`, `ilike`, `notIlike`는 문자열 컬럼에 SQL 패턴을 적용합니다. `%`는 임의 길이 문자열, `_`는 한 문자에 대응합니다. `ilike` 계열은 대소문자를 구분하지 않는 `ILIKE` 연산자를 생성하지만, MySQL은 `ILIKE` 문법을 지원하지 않으므로 MySQL 쿼리에서는 사용하지 마세요. MySQL의 `LIKE` 대소문자 구분 여부는 컬럼 collation 설정에 따릅니다.
+
+```ts
+const matchingUsers = await user.find((query) =>
+  query.or({
+    like: { email: '%@example.com' },
+    eq: { name: 'Kim' },
+  })
+);
+
+const excludedNames = await user
+  .select()
+  .where(user.notLike({ name: '테스트_%' }));
+```
+
+패턴 연산은 문자열 컬럼에만 사용할 수 있으며, 값은 `%홍길동%`처럼 SQL 패턴 문자열로 전달합니다. `ilike` / `notIlike`는 패키지의 조건 함수 목록에는 있지만 MySQL에서는 실행할 수 없습니다.
+
+#### NULL 검사
+
+`isNull`과 `isNotNull`은 컬럼명 하나 또는 컬럼명 배열을 받습니다. 배열 안의 컬럼 검사는 `AND`로 결합됩니다. 검색 조건에 따라 컬럼 검사를 생략하려면 `undefined`를 전달할 수 있습니다.
+
+```ts
+const noEmail = await user.find((query) => query.isNull('email'));
+const hasNameAndEmail = await user.find((query) =>
+  query.isNotNull(['name', 'email'])
+);
+const optionalNullCheck = user.isNull(shouldCheckEmail ? 'email' : undefined);
+```
+
+#### AND·OR 조합
+
+`query.and({ ... })`와 `query.or({ ... })`는 여러 연산자 그룹을 객체로 구성합니다. 한 연산자 아래의 컬럼 비교는 먼저 `AND`로 묶이고, 바깥 함수가 각 연산자 그룹을 `AND` 또는 `OR`로 결합합니다. `and` / `or` 객체는 조건 그룹이며, 그 안에 다시 `and` / `or`를 중첩하는 형식은 지원하지 않습니다.
+
+```ts
+const usersMatchingEither = await user.find((query) =>
+  query.or({
+    eq: { name: '홍길동' },
+    like: { email: '%@example.com' },
+  })
+);
+
+const activeCandidates = await user.find((query) =>
+  query.and({
+    isNotNull: 'email',
+    ne: { name: '탈퇴 사용자' },
+  })
+);
+```
+
+여러 조건을 임의로 중첩하거나 이미 만든 SQL 조건을 결합할 때는 `db.and(...)` / `db.or(...)`의 Drizzle 호환 오버로드를 사용합니다. 이 형식에서는 함수 호출 인자로 SQL 조건을 직접 조합할 수 있습니다.
+
+```ts
+const nameOrEmail = db.or(
+  user.eq({ name: '홍길동' }),
+  user.like({ email: '%@example.com' }),
+);
+const condition = db.and(
+  nameOrEmail,
+  db.isNotNull(users.email),
+);
+
+const matchingUsers = await user.select().where(condition);
+```
+
+같은 함수는 테이블 객체와 조건 객체를 받아 그룹 조건을 만들 수도 있습니다.
+
+```ts
+const groupedCondition = db.and(users, {
+  gte: { id: 1 },
+  isNotNull: ['name', 'email'],
+});
+const groupedUsers = await user.select().where(groupedCondition);
+```
+
+#### Drizzle 컬럼 연산자와 함께 사용
+
+`db`의 조건 함수는 테이블/객체 형식 외에도 Drizzle의 컬럼 기반 연산자 오버로드를 그대로 사용할 수 있습니다. `SQL` 조건은 래퍼 조회 메서드에 전달하거나 Drizzle 조회 빌더에서 조합할 수 있습니다.
+
+```ts
+const columnCondition = db.and(
+  db.eq(users.name, '홍길동'),
+  db.isNotNull(users.email),
+);
+
+const rows = await user.select().where(columnCondition);
+const count = await user.count(columnCondition);
+```
+
+지원하는 객체 조건 함수는 `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `inArray`, `notInArray`, `between`, `notBetween`, `like`, `notLike`, `ilike`, `notIlike`, `isNull`, `isNotNull`, `and`, `or`입니다. 존재하지 않는 스키마 키나 컬럼, 잘못된 값 형식은 조건을 조용히 생략하지 않고 오류로 처리합니다.
+
+### 별칭과 조인
+
+`db.a`는 연결에 전달한 스키마의 테이블별 별칭 생성 함수입니다. 별칭 테이블은 선택 및 조건식에 사용할 수 있습니다. `select`가 반환하는 Drizzle 빌더에서 조인을 이어서 작성할 수 있습니다.
+
+```ts
+const u = db.a.users('u');
+const rows = await user
+  .select(u, ['id', 'name'])
+  .where(db.eq(u, { name: '홍길동' }));
+
+const userPosts = await user
+  .select()
+  .leftJoin(posts, db.eq(users.id, posts.user_id));
+```
+
+기본 별칭은 스키마 키의 첫 글자와 대문자 위치를 기준으로 만듭니다. 예를 들어 `userProfile`의 기본 별칭은 `up`이며, `db.a.userProfile('profile')`처럼 직접 지정할 수도 있습니다.
+
+### 페이지네이션
+
+`db.paginate(builder, page, limit)`은 조회 데이터와 페이지 정보를 함께 반환합니다. 페이지와 페이지 크기는 양의 정수여야 합니다. 페이지네이션에 전달하는 빌더는 사용할 트랜잭션 안에서 생성해야 합니다.
+
+```ts
+const page = await db.paginate(
+  user.select().where(user.isNotNull('email')).orderBy(user.t.id),
+  1,
+  20,
+);
+
+console.log(page.data);
+console.log(page.paging); // current_page, per_page, last_page, total, from, to
+```
+
+### 트랜잭션과 원본 Drizzle API
+
+`db.trans` 콜백 안의 쿼리 객체는 현재 트랜잭션을 자동으로 사용합니다. 중첩된 `db.trans`는 savepoint로 동작합니다. 트랜잭션 안에서 시작한 비동기 작업은 트랜잭션이 끝나기 전에 모두 `await`해야 합니다.
+
+```ts
+await db.trans(async () => {
+  const id = await user.add({ name: '트랜잭션 사용자' });
+  await user.editByPrimaryKey({ name: '이름 변경' }, id);
+
+  // 같은 트랜잭션을 사용하는 원본 Drizzle API
+  await db.current().select().from(users);
+
+  await db.trans(async () => {
+    await user.removeByPrimaryKey(id);
+  });
+});
+```
+
+`db.current()`는 현재 문맥의 Drizzle 데이터베이스 인스턴스를 반환합니다. 래퍼가 제공하지 않는 Drizzle 기능은 이 API로 직접 사용할 수 있습니다.
+
+### 생성·수정 시각
+
+시각 자동 입력 메서드를 사용하려면 `timestamp` 생성 함수를 설정합니다. 기본 컬럼 이름은 `created_at`과 `updated_at`이며, `timestampColumns`의 `createdAt`과 `updatedAt`으로 변경할 수 있습니다.
+
+```ts
+const dbWithTimestamp = drizzleMySql({
+  url: process.env.DATABASE_URL!,
+  schema: { users },
+  timestamp: () => new Date(),
+  timestampColumns: { createdAt: 'created_at', updatedAt: 'updated_at' },
+});
+const timestampedUser = dbWithTimestamp.query(users);
+
+await timestampedUser.addWithCreatedAt({ name: '생성 시각 입력' });
+await timestampedUser.addWithCreatedUpdatedAt({ name: '생성·수정 시각 입력' });
+await timestampedUser.editWithUpdatedAtByPrimaryKey({ name: '수정 시각 갱신' }, id);
+```
+
+시각 관련 메서드는 `addWithCreatedAt`, `addWithCreatedUpdatedAt`, `editWithUpdatedAt`, `editWithUpdatedAtByPrimaryKey`입니다. 직접 시각 값을 지정하는 대신 설정한 생성 함수의 값을 사용합니다.
+
+### 집계·SQL 표현식
+
+`db` 인스턴스는 `asc`, `desc`, `count`, `countDistinct`, `avg`, `avgDistinct`, `sum`, `sumDistinct`, `max`, `min`, `not`, `exists`, `notExists`, `arrayContains`, `arrayContained`, `arrayOverlaps` 등 Drizzle 함수를 제공합니다. `db.sqlNumber`, `db.sqlString`, `db.sqlBoolean`은 SQL 표현식 또는 기본 값을 해당 타입으로 매핑하는 표현식을 만듭니다.
+
+```ts
+const [summary] = await db.current()
+  .select({ total: db.count() })
+  .from(users);
+
+const numericExpression = db.sqlNumber(db.sql`1`);
+```
+
+### 공개 타입과 스키마 API
+
+스키마 정의에 필요한 다음 API를 `@pdg/drizzle-mysql`에서 직접 가져올 수 있습니다.
+
+| 구분 | 내보내기 |
+| --- | --- |
+| 테이블·스키마·뷰 | `mysqlTable`, `mysqlTableCreator`, `mysqlSchema`, `mysqlDatabase`, `mysqlView` |
+| 정수·실수 | `tinyint`, `smallint`, `mediumint`, `int`, `bigint`, `serial`, `float`, `double`, `real`, `decimal` |
+| 문자열 | `char`, `varchar`, `tinytext`, `text`, `mediumtext`, `longtext`, `mysqlEnum` |
+| 날짜·시간 | `date`, `datetime`, `time`, `timestamp`, `year` |
+| 바이너리 | `binary`, `varbinary`, `tinyblob`, `blob`, `mediumblob`, `longblob` |
+| 기타 컬럼 | `boolean`, `json`, `customType` |
+| 인덱스·제약조건 | `index`, `uniqueIndex`, `primaryKey`, `foreignKey`, `unique`, `check` |
+| 타입 (`import type`) | `InferColumnsDataTypes`, `MySqlConditions`, `MySqlInsertValues`, `MySqlUpdateValues`, `MySqlAliasTable`, `MySqlSelectedColumns`, `MySqlSelectedTableColumns`, `MySqlColumnSelectionName`, `MySqlSelectedNamedColumnUnion`, `MySqlSelectedNamedColumns`, `MySqlCompareValues`, `MySqlColumnName`, `MySqlArrayCompareValues`, `MySqlRangeCompareValues`, `MySqlPatternCompareValues`, `MySqlNullConditionInput` |
+
+`check`나 SQL 표현식 기반 기본값에 사용하는 `sql`은 `drizzle-orm`에서 가져옵니다. Drizzle의 `MySqlTable` 등 직접 필요한 타입도 `drizzle-orm/mysql-core`에서 가져올 수 있습니다.
+
+## 라이선스
+
+이 프로젝트는 [MIT 라이선스](https://opensource.org/licenses/MIT)에 따라 배포됩니다.

package/dist/@types/MySqlConditions.d.cts

@@ -0,0 +1,20 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core';
+import type { MySqlArrayCompareValues, MySqlCompareValues, MySqlNullConditionInput, MySqlPatternCompareValues, MySqlRangeCompareValues } from './common.cjs';
+export type MySqlConditions<T extends MySqlTable> = {
+    eq?: MySqlCompareValues<T>;
+    ne?: MySqlCompareValues<T>;
+    gt?: MySqlCompareValues<T>;
+    gte?: MySqlCompareValues<T>;
+    lt?: MySqlCompareValues<T>;
+    lte?: MySqlCompareValues<T>;
+    inArray?: MySqlArrayCompareValues<T>;
+    notInArray?: MySqlArrayCompareValues<T>;
+    between?: MySqlRangeCompareValues<T>;
+    notBetween?: MySqlRangeCompareValues<T>;
+    like?: MySqlPatternCompareValues<T>;
+    notLike?: MySqlPatternCompareValues<T>;
+    ilike?: MySqlPatternCompareValues<T>;
+    notIlike?: MySqlPatternCompareValues<T>;
+    isNull?: MySqlNullConditionInput<T>;
+    isNotNull?: MySqlNullConditionInput<T>;
+};

package/dist/@types/MySqlConditions.d.ts

@@ -0,0 +1,20 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core';
+import type { MySqlArrayCompareValues, MySqlCompareValues, MySqlNullConditionInput, MySqlPatternCompareValues, MySqlRangeCompareValues } from './common.js';
+export type MySqlConditions<T extends MySqlTable> = {
+    eq?: MySqlCompareValues<T>;
+    ne?: MySqlCompareValues<T>;
+    gt?: MySqlCompareValues<T>;
+    gte?: MySqlCompareValues<T>;
+    lt?: MySqlCompareValues<T>;
+    lte?: MySqlCompareValues<T>;
+    inArray?: MySqlArrayCompareValues<T>;
+    notInArray?: MySqlArrayCompareValues<T>;
+    between?: MySqlRangeCompareValues<T>;
+    notBetween?: MySqlRangeCompareValues<T>;
+    like?: MySqlPatternCompareValues<T>;
+    notLike?: MySqlPatternCompareValues<T>;
+    ilike?: MySqlPatternCompareValues<T>;
+    notIlike?: MySqlPatternCompareValues<T>;
+    isNull?: MySqlNullConditionInput<T>;
+    isNotNull?: MySqlNullConditionInput<T>;
+};

package/dist/@types/MySqlInsertValues.d.cts

@@ -0,0 +1,7 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core/table';
+import type { MySqlInsertValue as InsertValue } from 'drizzle-orm/mysql-core/query-builders/insert';
+export type MySqlInsertValues<TTable extends MySqlTable, TBlocked extends keyof InsertValue<TTable> = never> = [
+    TBlocked
+] extends [never] ? InsertValue<TTable> : Omit<InsertValue<TTable>, TBlocked> & {
+    [P in TBlocked]?: never;
+};

package/dist/@types/MySqlInsertValues.d.ts

@@ -0,0 +1,7 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core/table';
+import type { MySqlInsertValue as InsertValue } from 'drizzle-orm/mysql-core/query-builders/insert';
+export type MySqlInsertValues<TTable extends MySqlTable, TBlocked extends keyof InsertValue<TTable> = never> = [
+    TBlocked
+] extends [never] ? InsertValue<TTable> : Omit<InsertValue<TTable>, TBlocked> & {
+    [P in TBlocked]?: never;
+};

package/dist/@types/MySqlUpdateValues.d.cts

@@ -0,0 +1,7 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core/table';
+import type { MySqlUpdateSetSource } from 'drizzle-orm/mysql-core/query-builders/update';
+export type MySqlUpdateValues<TTable extends MySqlTable, TBlocked extends keyof MySqlUpdateSetSource<TTable> = never, TRequired extends Exclude<keyof MySqlUpdateSetSource<TTable>, TBlocked> = never> = Omit<MySqlUpdateSetSource<TTable>, TBlocked | TRequired> & {
+    [P in TBlocked]?: never;
+} & {
+    [P in TRequired]-?: Exclude<MySqlUpdateSetSource<TTable>[P], undefined>;
+};

package/dist/@types/MySqlUpdateValues.d.ts

@@ -0,0 +1,7 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core/table';
+import type { MySqlUpdateSetSource } from 'drizzle-orm/mysql-core/query-builders/update';
+export type MySqlUpdateValues<TTable extends MySqlTable, TBlocked extends keyof MySqlUpdateSetSource<TTable> = never, TRequired extends Exclude<keyof MySqlUpdateSetSource<TTable>, TBlocked> = never> = Omit<MySqlUpdateSetSource<TTable>, TBlocked | TRequired> & {
+    [P in TBlocked]?: never;
+} & {
+    [P in TRequired]-?: Exclude<MySqlUpdateSetSource<TTable>[P], undefined>;
+};

package/dist/@types/common.d.cts

@@ -0,0 +1,16 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core';
+import type { InferSelectModel, SQLWrapper } from 'drizzle-orm';
+export type MySqlCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T>]?: InferSelectModel<T>[P] | SQLWrapper;
+};
+export type MySqlColumnName<T extends MySqlTable> = keyof T['_']['columns'] & string;
+export type MySqlArrayCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T>]?: NonNullable<InferSelectModel<T>[P]>[];
+};
+export type MySqlRangeCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T>]?: [NonNullable<InferSelectModel<T>[P]>, NonNullable<InferSelectModel<T>[P]>];
+};
+export type MySqlPatternCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T> as NonNullable<InferSelectModel<T>[P]> extends string ? P : never]?: string;
+};
+export type MySqlNullConditionInput<T extends MySqlTable> = MySqlColumnName<T> | undefined | readonly (MySqlColumnName<T> | undefined)[];

package/dist/@types/common.d.ts

@@ -0,0 +1,16 @@
+import type { MySqlTable } from 'drizzle-orm/mysql-core';
+import type { InferSelectModel, SQLWrapper } from 'drizzle-orm';
+export type MySqlCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T>]?: InferSelectModel<T>[P] | SQLWrapper;
+};
+export type MySqlColumnName<T extends MySqlTable> = keyof T['_']['columns'] & string;
+export type MySqlArrayCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T>]?: NonNullable<InferSelectModel<T>[P]>[];
+};
+export type MySqlRangeCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T>]?: [NonNullable<InferSelectModel<T>[P]>, NonNullable<InferSelectModel<T>[P]>];
+};
+export type MySqlPatternCompareValues<T extends MySqlTable> = {
+    [P in keyof InferSelectModel<T> as NonNullable<InferSelectModel<T>[P]> extends string ? P : never]?: string;
+};
+export type MySqlNullConditionInput<T extends MySqlTable> = MySqlColumnName<T> | undefined | readonly (MySqlColumnName<T> | undefined)[];

package/dist/@types/index.d.cts

@@ -0,0 +1,4 @@
+export * from './common.cjs';
+export * from './MySqlConditions.cjs';
+export * from './MySqlInsertValues.cjs';
+export * from './MySqlUpdateValues.cjs';

package/dist/@types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './common.js';
+export * from './MySqlConditions.js';
+export * from './MySqlInsertValues.js';
+export * from './MySqlUpdateValues.js';