feat: add uuidv7 support for pgsql

W1ckh3ad · W1ckh3ad · commit f964a62eecf1 · 2026-03-31T14:05:05.000+02:00
diff --git a/packages/db-d1-sqlite/src/index.ts b/packages/db-d1-sqlite/src/index.ts
@@ -64,7 +64,7 @@ const filename = fileURLToPath(import.meta.url)
 
 export function sqliteD1Adapter(args: Args): DatabaseAdapterObj<SQLiteD1Adapter> {
   const sqliteIDType = args.idType || 'number'
-  const payloadIDType = sqliteIDType === 'uuid' ? 'text' : 'number'
+  const payloadIDType = sqliteIDType === 'uuid' || sqliteIDType === 'uuidv7' ? 'text' : 'number'
   const allowIDOnCreate = args.allowIDOnCreate ?? false
 
   function adapter({ payload }: { payload: Payload }) {
diff --git a/packages/db-postgres/src/types.ts b/packages/db-postgres/src/types.ts
@@ -53,7 +53,7 @@ export type Args = {
   extensions?: string[]
   /** Generated schema from payload generate:db-schema file path */
   generateSchemaOutputFile?: string
-  idType?: 'serial' | 'uuid'
+  idType?: 'serial' | 'uuid' | 'uuidv7'
   localesSuffix?: string
   logger?: DrizzleConfig['logger']
   migrationDir?: string
diff --git a/packages/db-sqlite/src/index.ts b/packages/db-sqlite/src/index.ts
@@ -66,7 +66,7 @@ const filename = fileURLToPath(import.meta.url)
 
 export function sqliteAdapter(args: Args): DatabaseAdapterObj<SQLiteAdapter> {
   const sqliteIDType = args.idType || 'number'
-  const payloadIDType = sqliteIDType === 'uuid' ? 'text' : 'number'
+  const payloadIDType = sqliteIDType === 'uuid' || sqliteIDType === 'uuidv7' ? 'text' : 'number'
   const allowIDOnCreate = args.allowIDOnCreate ?? false
 
   function adapter({ payload }: { payload: Payload }) {
diff --git a/packages/db-vercel-postgres/src/types.ts b/packages/db-vercel-postgres/src/types.ts
@@ -53,7 +53,7 @@ export type Args = {
   forceUseVercelPostgres?: boolean
   /** Generated schema from payload generate:db-schema file path */
   generateSchemaOutputFile?: string
-  idType?: 'serial' | 'uuid'
+  idType?: 'serial' | 'uuid' | 'uuidv7'
   localesSuffix?: string
   logger?: DrizzleConfig['logger']
   migrationDir?: string
diff --git a/packages/drizzle/package.json b/packages/drizzle/package.json
@@ -62,7 +62,7 @@
     "drizzle-orm": "0.44.7",
     "prompts": "2.4.2",
     "to-snake-case": "1.0.0",
-    "uuid": "9.0.0"
+    "uuid": "^11.1.0"
   },
   "devDependencies": {
     "@libsql/client": "0.14.0",
diff --git a/packages/drizzle/src/postgres/columnToCodeConverter.ts b/packages/drizzle/src/postgres/columnToCodeConverter.ts
@@ -68,6 +68,11 @@ export const columnToCodeConverter: ColumnToCodeConverter = ({
     code = `${code}.defaultRandom()`
   }
 
+  if (column.type === 'uuid' && column.defaultV7) {
+    addImport('uuid', 'v7 as uuidv7')
+    code = `${code}.$defaultFn(() => uuidv7())`
+  }
+
   if (column.notNull) {
     code = `${code}.notNull()`
   }
diff --git a/packages/drizzle/src/postgres/schema/buildDrizzleTable.ts b/packages/drizzle/src/postgres/schema/buildDrizzleTable.ts
@@ -18,6 +18,7 @@ import {
   varchar,
   vector,
 } from 'drizzle-orm/pg-core'
+import { v7 as uuidv7 } from 'uuid'
 
 import type { RawColumn, RawTable } from '../../types.js'
 import type { BasePostgresAdapter } from '../types.js'
@@ -109,6 +110,10 @@ export const buildDrizzleTable = ({
           builder = builder.defaultRandom()
         }
 
+        if (column.defaultV7) {
+          builder = builder.$defaultFn(() => uuidv7())
+        }
+
         columns[key] = builder
         break
       }
diff --git a/packages/drizzle/src/postgres/schema/setColumnID.ts b/packages/drizzle/src/postgres/schema/setColumnID.ts
@@ -34,6 +34,17 @@ export const setColumnID: SetColumnID = ({ adapter, columns, fields }) => {
     return 'uuid'
   }
 
+  if (adapter.idType === 'uuidv7') {
+    columns.id = {
+      name: 'id',
+      type: 'uuid',
+      defaultV7: true,
+      primaryKey: true,
+    }
+
+    return 'uuid'
+  }
+
   columns.id = {
     name: 'id',
     type: 'serial',
diff --git a/packages/drizzle/src/postgres/types.ts b/packages/drizzle/src/postgres/types.ts
@@ -147,7 +147,7 @@ export type BasePostgresAdapter = {
    * Used for returning properly formed errors from unique fields
    */
   fieldConstraints: Record<string, Record<string, string>>
-  idType: 'serial' | 'uuid'
+  idType: 'serial' | 'uuid' | 'uuidv7'
   initializing: Promise<void>
   insert: Insert
   localesSuffix?: string
diff --git a/packages/drizzle/src/queries/getTableColumnFromPath.ts b/packages/drizzle/src/queries/getTableColumnFromPath.ts
@@ -19,6 +19,7 @@ import type { DrizzleAdapter, GenericColumn } from '../types.js'
 import type { BuildQueryJoinAliases } from './buildQuery.js'
 
 import { isPolymorphicRelationship } from '../utilities/isPolymorphicRelationship.js'
+import { isUUIDType } from '../utilities/isUUIDType.js'
 import { jsonBuildObject } from '../utilities/json.js'
 import { DistinctSymbol } from '../utilities/rawConstraint.js'
 import { resolveBlockTableName } from '../utilities/validateExistingBlockIsIdentical.js'
@@ -111,7 +112,7 @@ export const getTableColumnFromPath = ({
       constraints,
       field: {
         name: 'id',
-        type: adapter.idType === 'uuid' ? 'text' : 'number',
+        type: isUUIDType(adapter.idType) ? 'text' : 'number',
       } as NumberField | TextField,
       table: adapter.tables[newTableName],
     }
@@ -414,7 +415,7 @@ export const getTableColumnFromPath = ({
               constraints,
               field: {
                 name: 'id',
-                type: adapter.idType === 'uuid' ? 'text' : 'number',
+                type: isUUIDType(adapter.idType) ? 'text' : 'number',
               } as NumberField | TextField,
               table: aliasRelationshipTable,
             }
@@ -531,7 +532,7 @@ export const getTableColumnFromPath = ({
             constraints,
             field: {
               name: 'id',
-              type: adapter.idType === 'uuid' ? 'text' : 'number',
+              type: isUUIDType(adapter.idType) ? 'text' : 'number',
             } as NumberField | TextField,
             table: newAliasTable,
           }
@@ -706,8 +707,9 @@ export const getTableColumnFromPath = ({
 
             const columns: TableColumn['columns'] = field.relationTo
               .map((relationTo) => {
-                let idType: 'number' | 'text' | 'uuid' =
-                  adapter.idType === 'uuid' ? 'uuid' : 'number'
+                let idType: 'number' | 'text' | 'uuid' = isUUIDType(adapter.idType)
+                  ? 'uuid'
+                  : 'number'
 
                 const { customIDType } = adapter.payload.collections[relationTo]
 
diff --git a/packages/drizzle/src/queries/sanitizeQueryValue.ts b/packages/drizzle/src/queries/sanitizeQueryValue.ts
@@ -8,6 +8,7 @@ import type { DrizzleAdapter } from '../types.js'
 
 import { getCollectionIdType } from '../utilities/getCollectionIdType.js'
 import { isPolymorphicRelationship } from '../utilities/isPolymorphicRelationship.js'
+import { isUUIDType } from '../utilities/isUUIDType.js'
 import { isRawConstraint } from '../utilities/rawConstraint.js'
 
 type SanitizeQueryValueArgs = {
@@ -59,7 +60,7 @@ export const sanitizeQueryValue = ({
   ) {
     const allPossibleIDTypes: (number | string)[] = []
     formattedValue.forEach((val) => {
-      if (adapter.idType !== 'uuid' && typeof val === 'string') {
+      if (!isUUIDType(adapter.idType) && typeof val === 'string') {
         allPossibleIDTypes.push(val, parseInt(val))
       } else if (typeof val === 'string') {
         allPossibleIDTypes.push(val)
diff --git a/packages/drizzle/src/schema/build.ts b/packages/drizzle/src/schema/build.ts
@@ -18,6 +18,7 @@ import type {
 import { createTableName } from '../createTableName.js'
 import { buildForeignKeyName } from '../utilities/buildForeignKeyName.js'
 import { buildIndexName } from '../utilities/buildIndexName.js'
+import { isUUIDType } from '../utilities/isUUIDType.js'
 import { traverseFields } from './traverseFields.js'
 
 type Args = {
@@ -619,8 +620,9 @@ export const buildTable = ({
           config: relationshipConfig,
           throwValidationError: true,
         })
-        let colType: 'integer' | 'numeric' | 'uuid' | 'varchar' =
-          adapter.idType === 'uuid' ? 'uuid' : 'integer'
+        let colType: 'integer' | 'numeric' | 'uuid' | 'varchar' = isUUIDType(adapter.idType)
+          ? 'uuid'
+          : 'integer'
         const relatedCollectionCustomIDType =
           adapter.payload.collections[relationshipConfig.slug]?.customIDType
 
diff --git a/packages/drizzle/src/schema/traverseFields.ts b/packages/drizzle/src/schema/traverseFields.ts
@@ -24,6 +24,7 @@ import { createTableName } from '../createTableName.js'
 import { buildIndexName } from '../utilities/buildIndexName.js'
 import { getArrayRelationName } from '../utilities/getArrayRelationName.js'
 import { hasLocalesTable } from '../utilities/hasLocalesTable.js'
+import { isUUIDType } from '../utilities/isUUIDType.js'
 import {
   InternalBlockTableNameIndex,
   setInternalBlockIndex,
@@ -945,7 +946,7 @@ export const traverseFields = ({
           const tableName = adapter.tableNameMap.get(toSnakeCase(field.relationTo))
 
           // get the id type of the related collection
-          let colType: IDType = adapter.idType === 'uuid' ? 'uuid' : 'integer'
+          let colType: IDType = isUUIDType(adapter.idType) ? 'uuid' : 'integer'
           const relatedCollectionCustomID = relationshipConfig.fields.find(
             (field) => fieldAffectsData(field) && field.name === 'id',
           )
diff --git a/packages/drizzle/src/sqlite/columnToCodeConverter.ts b/packages/drizzle/src/sqlite/columnToCodeConverter.ts
@@ -69,6 +69,11 @@ export const columnToCodeConverter: ColumnToCodeConverter = ({
         defaultStatement = `$defaultFn(() => randomUUID())`
       }
 
+      if (column.defaultV7) {
+        addImport('uuid', 'v7 as uuidv7')
+        defaultStatement = `$defaultFn(() => uuidv7())`
+      }
+
       break
     }
 
diff --git a/packages/drizzle/src/sqlite/schema/buildDrizzleTable.ts b/packages/drizzle/src/sqlite/schema/buildDrizzleTable.ts
@@ -10,7 +10,7 @@ import {
   text,
   uniqueIndex,
 } from 'drizzle-orm/sqlite-core'
-import { v4 as uuidv4 } from 'uuid'
+import { v4 as uuidv4, v7 as uuidv7 } from 'uuid'
 
 import type { BuildDrizzleTable, RawColumn } from '../../types.js'
 
@@ -72,6 +72,10 @@ export const buildDrizzleTable: BuildDrizzleTable = ({ adapter, locales, rawTabl
           builder = builder.$defaultFn(() => uuidv4())
         }
 
+        if (column.defaultV7) {
+          builder = builder.$defaultFn(() => uuidv7())
+        }
+
         columns[key] = builder
         break
       }
diff --git a/packages/drizzle/src/sqlite/schema/setColumnID.ts b/packages/drizzle/src/sqlite/schema/setColumnID.ts
@@ -34,6 +34,17 @@ export const setColumnID: SetColumnID = ({ adapter, columns, fields }) => {
     return 'uuid'
   }
 
+  if (adapter.idType === 'uuidv7') {
+    columns.id = {
+      name: 'id',
+      type: 'uuid',
+      defaultV7: true,
+      primaryKey: true,
+    }
+
+    return 'uuid'
+  }
+
   columns.id = {
     name: 'id',
     type: 'integer',
diff --git a/packages/drizzle/src/sqlite/types.ts b/packages/drizzle/src/sqlite/types.ts
@@ -60,7 +60,7 @@ export type BaseSQLiteArgs = {
   blocksAsJSON?: boolean
   /** Generated schema from payload generate:db-schema file path */
   generateSchemaOutputFile?: string
-  idType?: 'number' | 'uuid'
+  idType?: 'number' | 'uuid' | 'uuidv7'
   localesSuffix?: string
   logger?: DrizzleConfig['logger']
   migrationDir?: string
diff --git a/packages/drizzle/src/types.ts b/packages/drizzle/src/types.ts
@@ -248,6 +248,8 @@ export type TimestampRawColumn = {
  */
 export type UUIDRawColumn = {
   defaultRandom?: boolean
+  /** App-side UUID v7 default (Postgres & SQLite); mutually exclusive with defaultRandom in practice */
+  defaultV7?: boolean
   type: 'uuid'
 } & BaseRawColumn
 
@@ -404,7 +406,7 @@ export interface DrizzleAdapter extends BaseDatabaseAdapter {
   fieldConstraints: Record<string, Record<string, string>>
 
   foreignKeys: Set<string>
-  idType: 'serial' | 'uuid'
+  idType: 'serial' | 'uuid' | 'uuidv7'
   indexes: Set<string>
   initializing: Promise<void>
   insert: Insert
diff --git a/packages/drizzle/src/utilities/getCollectionIdType.ts b/packages/drizzle/src/utilities/getCollectionIdType.ts
@@ -7,6 +7,7 @@ const typeMap: Record<string, 'number' | 'text'> = {
   serial: 'number',
   text: 'text',
   uuid: 'text',
+  uuidv7: 'text',
 }
 
 export const getCollectionIdType = ({
diff --git a/packages/drizzle/src/utilities/isUUIDType.ts b/packages/drizzle/src/utilities/isUUIDType.ts
@@ -0,0 +1 @@
+export const isUUIDType = (idType: string): boolean => idType === 'uuid' || idType === 'uuidv7'
diff --git a/payload-types.ts b/payload-types.ts
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/test/database/int.spec.ts b/test/database/int.spec.ts
diff --git a/test/generateDatabaseAdapter.ts b/test/generateDatabaseAdapter.ts
diff --git a/test/relationships/int.spec.ts b/test/relationships/int.spec.ts
diff --git a/test/uuid-v7/config.ts b/test/uuid-v7/config.ts
diff --git a/test/uuid-v7/int.spec.ts b/test/uuid-v7/int.spec.ts

Original file line number	Diff line number	Diff line change
`@@ -68,6 +68,11 @@ export const columnToCodeConverter: ColumnToCodeConverter = ({`
`68`	`68`	code = `${code}.defaultRandom()`
`69`	`69`	`}`
`70`	`70`
	`71`	`+ if (column.type === 'uuid' && column.defaultV7) {`
	`72`	`+ addImport('uuid', 'v7 as uuidv7')`
	`73`	+ code = `${code}.$defaultFn(() => uuidv7())`
	`74`	`+ }`
	`75`	`+`
`71`	`76`	`if (column.notNull) {`
`72`	`77`	code = `${code}.notNull()`
`73`	`78`	`}`