@kysera/timestamps 0.7.2 → 0.7.4

package/README.md

@@ -1,6 +1,6 @@
 # @kysera/timestamps
 
-> Automatic timestamp management plugin for Kysera - Zero-configuration `created_at` and `updated_at` tracking with powerful query helpers.
+> Automatic timestamp management plugin for Kysera (v0.7.3) - Zero-configuration `created_at` and `updated_at` tracking through @kysera/executor's Unified Execution Layer with powerful query helpers.
 
 [![Version](https://img.shields.io/npm/v/@kysera/timestamps.svg)](https://www.npmjs.com/package/@kysera/timestamps)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -9,14 +9,14 @@
 ## 🎯 Features
 
 - ✅ **Zero Configuration** - Works out of the box with sensible defaults
-- ✅ **Automatic Timestamps** - `created_at` on insert, `updated_at` on update
+- ✅ **Automatic Timestamps** - `created_at` on insert, `updated_at` on update via @kysera/executor
 - ✅ **Batch Operations** - Efficient `createMany`, `updateMany`, `touchMany` methods
 - ✅ **Custom Column Names** - Use any column names you want
 - ✅ **Table Filtering** - Whitelist or blacklist specific tables
 - ✅ **Date Formats** - ISO strings, Unix timestamps, or Date objects
 - ✅ **Query Helpers** - 13+ methods for timestamp-based queries
 - ✅ **Type-Safe** - Full TypeScript support with inference
-- ✅ **Plugin Architecture** - Integrates seamlessly with @kysera/repository
+- ✅ **Plugin Architecture** - Integrates seamlessly via @kysera/executor's Unified Execution Layer
 - ✅ **Production Ready** - Battle-tested with comprehensive test coverage
 
 ## 📥 Installation
@@ -59,6 +59,7 @@ CREATE TABLE users (
 ```typescript
 import { Kysely, PostgresDialect } from 'kysely'
 import { Pool } from 'pg'
+import { createExecutor } from '@kysera/executor'
 import { createORM, createRepositoryFactory } from '@kysera/repository'
 import { timestampsPlugin } from '@kysera/timestamps'
 import { z } from 'zod'
@@ -77,21 +78,26 @@ interface Database {
 // Create database connection
 const db = new Kysely<Database>({
   dialect: new PostgresDialect({
-    pool: new Pool({ /* config */ })
+    pool: new Pool({
+      /* config */
+    })
   })
 })
 
-// Create plugin container with timestamps plugin
-const orm = await createORM(db, [
-  timestampsPlugin()  // ✨ That's it!
+// Step 1: Register timestamps plugin with Unified Execution Layer
+const executor = await createExecutor(db, [
+  timestampsPlugin() // ✨ That's it!
 ])
 
-// Create repository
-const userRepo = orm.createRepository((executor) => {
+// Step 2: Create ORM with plugin-enabled executor
+const orm = await createORM(executor, [])
+
+// Step 3: Create repository
+const userRepo = orm.createRepository(executor => {
   const factory = createRepositoryFactory(executor)
   return factory.create<'users', User>({
     tableName: 'users',
-    mapRow: (row) => row as User,
+    mapRow: row => row as User,
     schemas: {
       create: z.object({
         email: z.string().email(),
@@ -107,15 +113,15 @@ const user = await userRepo.create({
   name: 'Alice'
 })
 
-console.log(user.created_at)  // ✅ 2024-01-15T10:30:00.000Z
-console.log(user.updated_at)  // null (only set on update)
+console.log(user.created_at) // ✅ 2024-01-15T10:30:00.000Z
+console.log(user.updated_at) // null (only set on update)
 
 // Update - updated_at set automatically!
 const updated = await userRepo.update(user.id, {
   name: 'Alice Smith'
 })
 
-console.log(updated.updated_at)  // ✅ 2024-01-15T10:35:00.000Z
+console.log(updated.updated_at) // ✅ 2024-01-15T10:35:00.000Z
 ```
 
 ---
@@ -167,9 +173,9 @@ const plugin = timestampsPlugin({
   updatedAtColumn: 'updated_at',
   setUpdatedAtOnInsert: false,
   dateFormat: 'iso',
-  tables: undefined,        // All tables
+  tables: undefined, // All tables
   excludeTables: undefined, // No exclusions
-  primaryKeyColumn: 'id'    // Default primary key
+  primaryKeyColumn: 'id' // Default primary key
 })
 ```
 
@@ -195,8 +201,8 @@ interface Database {
   posts: {
     id: Generated<number>
     title: string
-    created: Generated<Date>      // ✅ Custom name
-    modified: Date | null          // ✅ Custom name
+    created: Generated<Date> // ✅ Custom name
+    modified: Date | null // ✅ Custom name
   }
 }
 ```
@@ -230,11 +236,13 @@ const plugin = timestampsPlugin({
 #### When to Use Each
 
 **Use Whitelist (`tables`) when:**
+
 - You have many tables but only a few need timestamps
 - You want explicit control over timestamp tables
 - You're migrating incrementally
 
 **Use Blacklist (`excludeTables`) when:**
+
 - Most tables need timestamps
 - Only a few system tables should be excluded
 - You want timestamps by default
@@ -317,12 +325,12 @@ const user = await userRepo.create({
   name: 'Alice'
 })
 
-console.log(user.created_at)  // 2024-01-15T10:30:00.000Z
-console.log(user.updated_at)  // 2024-01-15T10:30:00.000Z (same!)
+console.log(user.created_at) // 2024-01-15T10:30:00.000Z
+console.log(user.updated_at) // 2024-01-15T10:30:00.000Z (same!)
 
 // On update, updated_at changes
 const updated = await userRepo.update(user.id, { name: 'Alice Smith' })
-console.log(updated.updated_at)  // 2024-01-15T10:35:00.000Z (different)
+console.log(updated.updated_at) // 2024-01-15T10:35:00.000Z (different)
 ```
 
 ### Custom Primary Key Column
@@ -346,7 +354,7 @@ const plugin = timestampsPlugin({
 // Database schema
 interface Database {
   users: {
-    user_id: Generated<number>  // Custom primary key
+    user_id: Generated<number> // Custom primary key
     email: string
     name: string
     created_at: Generated<Date>
@@ -364,6 +372,8 @@ await userRepo.touch(userId)
 
 ## 🤖 Automatic Behavior
 
+The timestamps plugin works through @kysera/executor's Unified Execution Layer to automatically manage timestamps on all operations.
+
 ### On Create
 
 When you call `repository.create()`, the plugin automatically adds `created_at`:
@@ -378,8 +388,8 @@ const user = await userRepo.create({
 // INSERT INTO users (email, name, created_at)
 // VALUES ('bob@example.com', 'Bob', '2024-01-15T10:30:00.000Z')
 
-console.log(user.created_at)  // ✅ 2024-01-15T10:30:00.000Z
-console.log(user.updated_at)  // null (default behavior)
+console.log(user.created_at) // ✅ 2024-01-15T10:30:00.000Z
+console.log(user.updated_at) // null (default behavior)
 ```
 
 **Manual Override:**
@@ -389,10 +399,10 @@ console.log(user.updated_at)  // null (default behavior)
 const user = await userRepo.create({
   email: 'charlie@example.com',
   name: 'Charlie',
-  created_at: '2020-01-01T00:00:00.000Z'  // ✅ Uses this instead
+  created_at: '2020-01-01T00:00:00.000Z' // ✅ Uses this instead
 })
 
-console.log(user.created_at)  // 2020-01-01T00:00:00.000Z
+console.log(user.created_at) // 2020-01-01T00:00:00.000Z
 ```
 
 ### On Update
@@ -409,7 +419,7 @@ const updated = await userRepo.update(userId, {
 // SET name = 'New Name', updated_at = '2024-01-15T10:35:00.000Z'
 // WHERE id = 1
 
-console.log(updated.updated_at)  // ✅ 2024-01-15T10:35:00.000Z
+console.log(updated.updated_at) // ✅ 2024-01-15T10:35:00.000Z
 ```
 
 **Manual Override:**
@@ -418,7 +428,7 @@ console.log(updated.updated_at)  // ✅ 2024-01-15T10:35:00.000Z
 // Provide your own updated_at
 const updated = await userRepo.update(userId, {
   name: 'New Name',
-  updated_at: '2024-01-01T00:00:00.000Z'  // ✅ Uses this instead
+  updated_at: '2024-01-01T00:00:00.000Z' // ✅ Uses this instead
 })
 ```
 
@@ -433,18 +443,19 @@ const user = await userRepo.createWithoutTimestamps({
   name: 'System User'
 })
 
-console.log(user.created_at)  // null (not set)
-console.log(user.updated_at)  // null (not set)
+console.log(user.created_at) // null (not set)
+console.log(user.updated_at) // null (not set)
 
 // Update without modifying updated_at
 const updated = await userRepo.updateWithoutTimestamp(userId, {
   name: 'Silent Update'
 })
 
-console.log(updated.updated_at)  // null (unchanged)
+console.log(updated.updated_at) // null (unchanged)
 ```
 
 **Use Cases:**
+
 - Migrating historical data with specific timestamps
 - System operations that shouldn't update timestamps
 - Preserving original timestamps when copying records
@@ -542,7 +553,7 @@ const latest50 = await userRepo.findRecentlyCreated(50)
 
 // Get latest user
 const latestUser = await userRepo.findRecentlyCreated(1)
-console.log(latestUser[0])  // Most recent user
+console.log(latestUser[0]) // Most recent user
 ```
 
 #### findRecentlyUpdated
@@ -605,15 +616,16 @@ const users = await userRepo.createMany([
 
 // All records created with the same timestamp
 users.forEach(user => {
-  console.log(user.created_at)  // Same timestamp for all
+  console.log(user.created_at) // Same timestamp for all
 })
 
 // Empty arrays are handled gracefully
 const empty = await userRepo.createMany([])
-console.log(empty.length)  // 0
+console.log(empty.length) // 0
 ```
 
 **Performance Benefits:**
+
 - Single database roundtrip instead of N queries
 - All records get the same timestamp (consistent)
 - ~10-100x faster than individual creates for large batches
@@ -646,8 +658,8 @@ const updated = await userRepo.updateMany(userIds, {
 
 // All records updated with same timestamp
 updated.forEach(user => {
-  console.log(user.status)       // 'active'
-  console.log(user.updated_at)   // Same timestamp for all
+  console.log(user.status) // 'active'
+  console.log(user.updated_at) // Same timestamp for all
 })
 
 // Works with string IDs too
@@ -656,10 +668,11 @@ await userRepo.updateMany(stringIds, { verified: true })
 
 // Empty arrays are handled gracefully
 const empty = await userRepo.updateMany([], { status: 'inactive' })
-console.log(empty.length)  // 0
+console.log(empty.length) // 0
 ```
 
 **Performance Benefits:**
+
 - Single UPDATE query with WHERE id IN clause
 - Single SELECT to fetch updated records
 - Much faster than individual updates
@@ -692,21 +705,18 @@ const userIds = [1, 2, 3, 4, 5]
 await userRepo.touchMany(userIds)
 
 // Verify all were touched
-const touched = await db
-  .selectFrom('users')
-  .selectAll()
-  .where('id', 'in', userIds)
-  .execute()
+const touched = await db.selectFrom('users').selectAll().where('id', 'in', userIds).execute()
 
 touched.forEach(user => {
-  console.log(user.updated_at)  // All have same new timestamp
+  console.log(user.updated_at) // All have same new timestamp
 })
 
 // Empty arrays are handled gracefully
-await userRepo.touchMany([])  // No-op
+await userRepo.touchMany([]) // No-op
 ```
 
 **Performance Benefits:**
+
 - Single UPDATE query setting only timestamp column
 - No data fetched or returned
 - Extremely fast even for large batches
@@ -821,20 +831,24 @@ console.log(columns)
 
 ### Multiple Plugins
 
-Combine timestamps with other plugins:
+Combine timestamps with other plugins via @kysera/executor's Unified Execution Layer:
 
 ```typescript
+import { createExecutor } from '@kysera/executor'
 import { timestampsPlugin } from '@kysera/timestamps'
 import { softDeletePlugin } from '@kysera/soft-delete'
 import { auditPlugin } from '@kysera/audit'
 
-const orm = await createORM(db, [
+// Register all plugins with Unified Execution Layer
+const executor = await createExecutor(db, [
   timestampsPlugin(),
   softDeletePlugin(),
-  auditPlugin({ userId: currentUserId })
+  auditPlugin({ getUserId: () => currentUserId })
 ])
 
-// All plugins work together:
+const orm = await createORM(executor, [])
+
+// All plugins work together seamlessly:
 const user = await userRepo.create({ email: 'test@example.com', name: 'Test' })
 // ✅ created_at added by timestamps plugin
 // ✅ deleted_at set to null by soft-delete plugin
@@ -846,7 +860,7 @@ const user = await userRepo.create({ email: 'test@example.com', name: 'Test' })
 Timestamps work seamlessly with transactions:
 
 ```typescript
-await db.transaction().execute(async (trx) => {
+await db.transaction().execute(async trx => {
   const txRepo = userRepo.withTransaction(trx)
 
   const user = await txRepo.create({
@@ -897,11 +911,11 @@ function createUserRepository(executor: Executor<Database>) {
   const factory = createRepositoryFactory(executor)
   return factory.create<'users', User>({
     tableName: 'users',
-    mapRow: (row) => ({
+    mapRow: row => ({
       id: row.id,
       email: row.email,
       name: row.name,
-      createdAt: new Date(row.created_at),      // Convert to Date
+      createdAt: new Date(row.created_at), // Convert to Date
       updatedAt: row.updated_at ? new Date(row.updated_at) : null
     }),
     schemas: {
@@ -1035,10 +1049,10 @@ const after: User[] = await userRepo.findCreatedAfter('2024-01-01')
 const between: User[] = await userRepo.findCreatedBetween('2024-01-01', '2024-12-31')
 
 // ❌ Type error: wrong argument type
-await userRepo.findCreatedAfter(12345)  // Error: number not assignable
+await userRepo.findCreatedAfter(12345) // Error: number not assignable
 
 // ❌ Type error: method doesn't exist
-await userRepo.nonExistentMethod()  // Error: method doesn't exist
+await userRepo.nonExistentMethod() // Error: method doesn't exist
 ```
 
 ### Database Schema Types
@@ -1051,15 +1065,15 @@ interface Database {
     id: Generated<number>
     email: string
     name: string
-    created_at: Generated<Date>  // Auto-generated
-    updated_at: Date | null       // Nullable
+    created_at: Generated<Date> // Auto-generated
+    updated_at: Date | null // Nullable
   }
 }
 
 // TypeScript ensures correct column types
 const plugin = timestampsPlugin({
-  createdAtColumn: 'created_at',  // ✅ Must match schema
-  updatedAtColumn: 'updated_at'   // ✅ Must match schema
+  createdAtColumn: 'created_at', // ✅ Must match schema
+  updatedAtColumn: 'updated_at' // ✅ Must match schema
 })
 ```
 
@@ -1075,20 +1089,21 @@ Creates a timestamps plugin instance.
 
 ```typescript
 interface TimestampsOptions {
-  createdAtColumn?: string          // Default: 'created_at'
-  updatedAtColumn?: string          // Default: 'updated_at'
-  setUpdatedAtOnInsert?: boolean    // Default: false
-  tables?: string[]                 // Default: undefined (all tables)
-  excludeTables?: string[]          // Default: undefined
-  getTimestamp?: () => Date | string | number  // Custom generator
-  dateFormat?: 'iso' | 'unix' | 'date'  // Default: 'iso'
-  primaryKeyColumn?: string         // Default: 'id'
+  createdAtColumn?: string // Default: 'created_at'
+  updatedAtColumn?: string // Default: 'updated_at'
+  setUpdatedAtOnInsert?: boolean // Default: false
+  tables?: string[] // Default: undefined (all tables)
+  excludeTables?: string[] // Default: undefined
+  getTimestamp?: () => Date | string | number // Custom generator
+  dateFormat?: 'iso' | 'unix' | 'date' // Default: 'iso'
+  primaryKeyColumn?: string // Default: 'id'
 }
 ```
 
 **Returns:** `Plugin` instance
 
 **Example:**
+
 ```typescript
 const plugin = timestampsPlugin({
   createdAtColumn: 'created',
@@ -1106,6 +1121,7 @@ const plugin = timestampsPlugin({
 Find records created after a date.
 
 **Parameters:**
+
 - `date: Date | string | number` - Date to compare against
 
 **Returns:** `Promise<T[]>`
@@ -1117,6 +1133,7 @@ Find records created after a date.
 Find records created before a date.
 
 **Parameters:**
+
 - `date: Date | string | number` - Date to compare against
 
 **Returns:** `Promise<T[]>`
@@ -1128,6 +1145,7 @@ Find records created before a date.
 Find records created between two dates (inclusive).
 
 **Parameters:**
+
 - `startDate: Date | string | number` - Start date
 - `endDate: Date | string | number` - End date
 
@@ -1140,6 +1158,7 @@ Find records created between two dates (inclusive).
 Find records updated after a date.
 
 **Parameters:**
+
 - `date: Date | string | number` - Date to compare against
 
 **Returns:** `Promise<T[]>`
@@ -1151,6 +1170,7 @@ Find records updated after a date.
 Get most recently created records.
 
 **Parameters:**
+
 - `limit?: number` - Number of records (default: 10)
 
 **Returns:** `Promise<T[]>`
@@ -1162,6 +1182,7 @@ Get most recently created records.
 Get most recently updated records.
 
 **Parameters:**
+
 - `limit?: number` - Number of records (default: 10)
 
 **Returns:** `Promise<T[]>`
@@ -1173,6 +1194,7 @@ Get most recently updated records.
 Create a record without adding timestamps.
 
 **Parameters:**
+
 - `input: unknown` - Create data
 
 **Returns:** `Promise<T>`
@@ -1184,6 +1206,7 @@ Create a record without adding timestamps.
 Update a record without modifying updated_at.
 
 **Parameters:**
+
 - `id: number` - Record ID
 - `input: unknown` - Update data
 
@@ -1196,6 +1219,7 @@ Update a record without modifying updated_at.
 Update only the updated_at timestamp.
 
 **Parameters:**
+
 - `id: number` - Record ID
 
 **Returns:** `Promise<void>`
@@ -1215,11 +1239,13 @@ Get configured column names.
 Create multiple records with timestamps in a single bulk INSERT operation.
 
 **Parameters:**
+
 - `inputs: unknown[]` - Array of create data objects
 
 **Returns:** `Promise<T[]>` - Array of created records
 
 **Example:**
+
 ```typescript
 const users = await userRepo.createMany([
   { name: 'Alice', email: 'alice@example.com' },
@@ -1234,12 +1260,14 @@ const users = await userRepo.createMany([
 Update multiple records with the same data, automatically setting updated_at.
 
 **Parameters:**
+
 - `ids: (number | string)[]` - Array of record IDs to update
 - `input: unknown` - Update data (applied to all records)
 
 **Returns:** `Promise<T[]>` - Array of updated records
 
 **Example:**
+
 ```typescript
 const updated = await userRepo.updateMany([1, 2, 3], {
   status: 'active'
@@ -1253,11 +1281,13 @@ const updated = await userRepo.updateMany([1, 2, 3], {
 Update only the updated_at timestamp for multiple records.
 
 **Parameters:**
+
 - `ids: (number | string)[]` - Array of record IDs to touch
 
 **Returns:** `Promise<void>`
 
 **Example:**
+
 ```typescript
 await userRepo.touchMany([1, 2, 3, 4, 5])
 ```
@@ -1274,14 +1304,14 @@ interface Database {
   users: {
     id: Generated<number>
     created_at: Generated<Date>
-    updated_at: Date | null  // ✅ Null until first update
+    updated_at: Date | null // ✅ Null until first update
   }
 }
 
 // ❌ Bad: updated_at not nullable
 interface Database {
   users: {
-    updated_at: Date  // ❌ What value on insert?
+    updated_at: Date // ❌ What value on insert?
   }
 }
 ```
@@ -1292,14 +1322,14 @@ interface Database {
 // ✅ Good: created_at is generated
 interface Database {
   users: {
-    created_at: Generated<Date>  // ✅ Auto-generated
+    created_at: Generated<Date> // ✅ Auto-generated
   }
 }
 
 // ⚠️ OK but verbose: created_at is optional
 interface Database {
   users: {
-    created_at: Date  // Must be provided or plugin adds it
+    created_at: Date // Must be provided or plugin adds it
   }
 }
 ```
@@ -1336,12 +1366,12 @@ const plugin = timestampsPlugin({
 ```typescript
 // ✅ Good: ISO strings work everywhere
 const plugin = timestampsPlugin({
-  dateFormat: 'iso'  // Portable across databases
+  dateFormat: 'iso' // Portable across databases
 })
 
 // ⚠️ OK: Unix timestamps for performance
 const plugin = timestampsPlugin({
-  dateFormat: 'unix'  // Good for INTEGER columns
+  dateFormat: 'unix' // Good for INTEGER columns
 })
 ```
 
@@ -1362,11 +1392,11 @@ CREATE INDEX idx_users_updated_at ON users(updated_at);
 
 ```typescript
 // ✅ Good: Lightweight activity tracking
-await userRepo.touch(userId)  // Only updates timestamp
+await userRepo.touch(userId) // Only updates timestamp
 
 // ❌ Bad: Unnecessary data transfer
 const user = await userRepo.findById(userId)
-await userRepo.update(userId, user)  // Fetches + updates all fields
+await userRepo.update(userId, user) // Fetches + updates all fields
 ```
 
 ### 8. Use Batch Operations for Multiple Records
@@ -1413,20 +1443,20 @@ for (const id of [1, 2, 3, 4, 5]) {
 
 ### Plugin Overhead
 
-| Operation | Base | With Timestamps | Overhead |
-|-----------|------|----------------|----------|
-| **create** | 2ms | 2.05ms | +0.05ms |
-| **update** | 2ms | 2.05ms | +0.05ms |
-| **findById** | 1ms | 1ms | 0ms |
-| **findRecentlyCreated** | - | 5ms | N/A |
+| Operation               | Base | With Timestamps | Overhead |
+| ----------------------- | ---- | --------------- | -------- |
+| **create**              | 2ms  | 2.05ms          | +0.05ms  |
+| **update**              | 2ms  | 2.05ms          | +0.05ms  |
+| **findById**            | 1ms  | 1ms             | 0ms      |
+| **findRecentlyCreated** | -    | 5ms             | N/A      |
 
 ### Timestamp Format Performance
 
-| Format | Generation Time | Storage Size | Query Performance |
-|--------|----------------|--------------|-------------------|
-| **ISO** | ~0.001ms | 24-27 bytes | Medium |
-| **Unix** | ~0.0005ms | 4-8 bytes | Fast |
-| **Date** | ~0.001ms | Varies | Medium |
+| Format   | Generation Time | Storage Size | Query Performance |
+| -------- | --------------- | ------------ | ----------------- |
+| **ISO**  | ~0.001ms        | 24-27 bytes  | Medium            |
+| **Unix** | ~0.0005ms       | 4-8 bytes    | Fast              |
+| **Date** | ~0.001ms        | Varies       | Medium            |
 
 **Recommendation:** Use `unix` for high-performance time-series data, `iso` for general use.
 
@@ -1468,6 +1498,7 @@ const sorted = all.sort((a, b) => b.createdAt - a.createdAt)
 **Solutions:**
 
 1. **Check plugin is registered:**
+
 ```typescript
 // ❌ Plugin not registered
 const orm = await createORM(db, [])
@@ -1477,19 +1508,21 @@ const orm = await createORM(db, [timestampsPlugin()])
 ```
 
 2. **Check table is not excluded:**
+
 ```typescript
 // Check configuration
 const plugin = timestampsPlugin({
-  excludeTables: ['users']  // ❌ Users excluded!
+  excludeTables: ['users'] // ❌ Users excluded!
 })
 
 // Fix: Remove from exclusions
 const plugin = timestampsPlugin({
-  excludeTables: []  // ✅ No exclusions
+  excludeTables: [] // ✅ No exclusions
 })
 ```
 
 3. **Check column exists in database:**
+
 ```sql
 -- Check schema
 DESCRIBE users;
@@ -1507,17 +1540,17 @@ WHERE table_name = 'users';
 ```typescript
 // For TIMESTAMP/DATETIME columns
 const plugin = timestampsPlugin({
-  dateFormat: 'iso'  // ✅ ISO string
+  dateFormat: 'iso' // ✅ ISO string
 })
 
 // For INTEGER columns
 const plugin = timestampsPlugin({
-  dateFormat: 'unix'  // ✅ Unix timestamp
+  dateFormat: 'unix' // ✅ Unix timestamp
 })
 
 // For DATE columns
 const plugin = timestampsPlugin({
-  dateFormat: 'date'  // ✅ Date object
+  dateFormat: 'date' // ✅ Date object
 })
 ```
 
@@ -1531,15 +1564,15 @@ const plugin = timestampsPlugin({
 // ❌ Wrong: Direct factory (no plugin extensions)
 const factory = createRepositoryFactory(db)
 const userRepo = factory.create(/* ... */)
-await userRepo.findRecentlyCreated()  // ❌ Undefined
+await userRepo.findRecentlyCreated() // ❌ Undefined
 
 // ✅ Correct: Plugin container with plugins
 const orm = await createORM(db, [timestampsPlugin()])
-const userRepo = orm.createRepository((executor) => {
+const userRepo = orm.createRepository(executor => {
   const factory = createRepositoryFactory(executor)
   return factory.create(/* ... */)
 })
-await userRepo.findRecentlyCreated()  // ✅ Works!
+await userRepo.findRecentlyCreated() // ✅ Works!
 ```
 
 ### Timestamps in Transactions
@@ -1549,13 +1582,17 @@ await userRepo.findRecentlyCreated()  // ✅ Works!
 **Solution:** Use `withTransaction`:
 
 ```typescript
-await db.transaction().execute(async (trx) => {
+await db.transaction().execute(async trx => {
   // ❌ Wrong: Using original repo
-  await userRepo.create({ /* ... */ })
+  await userRepo.create({
+    /* ... */
+  })
 
   // ✅ Correct: Use transaction repo
   const txRepo = userRepo.withTransaction(trx)
-  await txRepo.create({ /* ... */ })  // ✅ Timestamps added
+  await txRepo.create({
+    /* ... */
+  }) // ✅ Timestamps added
 })
 ```
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { Repository, Plugin } from '@kysera/repository';
+import { Plugin } from '@kysera/executor';
+import { Repository } from '@kysera/repository';
 import { KyseraLogger } from '@kysera/core';
 import { z } from 'zod';
 
@@ -108,6 +109,7 @@ type TimestampsRepository<Entity, DB> = Repository<Entity, DB> & TimestampMethod
  * - Configurable timestamp format (ISO, Unix, Date)
  * - Query helpers: findCreatedAfter, findUpdatedAfter, etc.
  * - Bulk operations: createMany, updateMany, touchMany
+ * - **Cross-database support**: Works with PostgreSQL, MySQL, SQLite, and MSSQL
  *
  * ## Transaction Behavior
  *

package/dist/index.js

@@ -1,2 +1,2 @@
-import {silentLogger}from'@kysera/core';import {z}from'zod';var N=z.object({createdAtColumn:z.string().optional(),updatedAtColumn:z.string().optional(),setUpdatedAtOnInsert:z.boolean().optional(),tables:z.array(z.string()).optional(),excludeTables:z.array(z.string()).optional(),getTimestamp:z.function().optional(),dateFormat:z.enum(["iso","unix","date"]).optional(),primaryKeyColumn:z.string().optional()});function d(s){if(s.getTimestamp)return s.getTimestamp();let r=new Date;switch(s.dateFormat){case "unix":return Math.floor(r.getTime()/1e3);case "date":return r;case "iso":default:return r.toISOString()}}function k(s,r){return r.excludeTables?.includes(s)?false:r.tables?r.tables.includes(s):true}function w(s,r,i){return {select(){return s.selectFrom(r)},where(g,b){return s.selectFrom(r).where(i,g,b)}}}var R=(s={})=>{let{createdAtColumn:r="created_at",updatedAtColumn:i="updated_at",setUpdatedAtOnInsert:g=false,primaryKeyColumn:b="id",logger:u=silentLogger}=s;return {name:"@kysera/timestamps",version:"0.5.1",interceptQuery(c,t){return c},extendRepository(c){if(!("tableName"in c)||!("executor"in c))return c;let t=c;if(!k(t.tableName,s))return u.debug(`Table ${t.tableName} excluded from timestamps, skipping extension`),c;u.debug(`Extending repository for table ${t.tableName} with timestamp methods`);let T=t.create.bind(t),f=t.update.bind(t),o=t.executor;return {...t,async create(e){let n=e,a=d(s),l={...n,[r]:n[r]??a};return g&&(l[i]=n[i]??a),u.debug(`Creating record in ${t.tableName} with timestamp ${a}`),await T(l)},async update(e,n){let a=n,l=d(s),p={...a,[i]:a[i]??l};return u.debug(`Updating record ${e} in ${t.tableName} with timestamp ${l}`),await f(e,p)},async findCreatedAfter(e){return await w(o,t.tableName,r).where(">",String(e)).selectAll().execute()},async findCreatedBefore(e){return await w(o,t.tableName,r).where("<",String(e)).selectAll().execute()},async findCreatedBetween(e,n){return await o.selectFrom(t.tableName).selectAll().where(r,">=",e).where(r,"<=",n).execute()},async findUpdatedAfter(e){return await w(o,t.tableName,i).where(">",String(e)).selectAll().execute()},async findRecentlyUpdated(e=10){return await o.selectFrom(t.tableName).selectAll().orderBy(i,"desc").limit(e).execute()},async findRecentlyCreated(e=10){return await o.selectFrom(t.tableName).selectAll().orderBy(r,"desc").limit(e).execute()},async createWithoutTimestamps(e){return u.debug(`Creating record in ${t.tableName} without timestamps`),await T(e)},async updateWithoutTimestamp(e,n){return u.debug(`Updating record ${e} in ${t.tableName} without timestamp`),await f(e,n)},async touch(e){let n=d(s),a={[i]:n};u.info(`Touching record ${e} in ${t.tableName}`),await o.updateTable(t.tableName).set(a).where(b,"=",e).execute();},getTimestampColumns(){return {createdAt:r,updatedAt:i}},async createMany(e){if(!e||e.length===0)return [];let n=d(s),a=e.map(p=>{let y=p,h={...y,[r]:y[r]??n};return g&&(h[i]=y[i]??n),h});return u.info(`Creating ${e.length} records in ${t.tableName} with timestamp ${n}`),await o.insertInto(t.tableName).values(a).returningAll().execute()},async updateMany(e,n){if(!e||e.length===0)return [];let a=n,l=d(s),p={...a,[i]:a[i]??l};return u.info(`Updating ${e.length} records in ${t.tableName} with timestamp ${l}`),await o.updateTable(t.tableName).set(p).where("id","in",e).execute(),await o.selectFrom(t.tableName).selectAll().where("id","in",e).execute()},async touchMany(e){if(!e||e.length===0)return;let n=d(s),a={[i]:n};u.info(`Touching ${e.length} records in ${t.tableName}`),await o.updateTable(t.tableName).set(a).where("id","in",e).execute();}}}}};export{N as TimestampsOptionsSchema,R as timestampsPlugin};//# sourceMappingURL=index.js.map
+import {silentLogger,detectDialect}from'@kysera/core';import {z}from'zod';var h="__VERSION__",v=h.startsWith("__")?"0.0.0-dev":h;var B=z.object({createdAtColumn:z.string().optional(),updatedAtColumn:z.string().optional(),setUpdatedAtOnInsert:z.boolean().optional(),tables:z.array(z.string()).optional(),excludeTables:z.array(z.string()).optional(),getTimestamp:z.function().optional(),dateFormat:z.enum(["iso","unix","date"]).optional(),primaryKeyColumn:z.string().optional()});function p(s){if(s.getTimestamp)return s.getTimestamp();let n=new Date;switch(s.dateFormat){case "unix":return Math.floor(n.getTime()/1e3);case "date":return n;case "iso":default:return n.toISOString()}}function A(s,n){return n.excludeTables?.includes(s)?false:n.tables?n.tables.includes(s):true}function w(s,n,i){return {select(){return s.selectFrom(n)},where(y,d){return s.selectFrom(n).where(i,y,d)}}}function N(s){let n=detectDialect(s);return n!=="mysql"&&n!=="mssql"}var O=(s={})=>{let{createdAtColumn:n="created_at",updatedAtColumn:i="updated_at",setUpdatedAtOnInsert:y=false,primaryKeyColumn:d="id",logger:u=silentLogger}=s;return {name:"@kysera/timestamps",version:v,priority:50,onInit(){},async onDestroy(){u.debug("Timestamps plugin destroyed");},extendRepository(g){if(!("tableName"in g)||!("executor"in g))return g;let t=g;if(!A(t.tableName,s))return u.debug(`Table ${t.tableName} excluded from timestamps, skipping extension`),g;u.debug(`Extending repository for table ${t.tableName} with timestamp methods`);let T=t.create.bind(t),f=t.update.bind(t),o=t.executor;return {...t,async create(e){let r=e,a=p(s),m={...r,[n]:r[n]??a};return y&&(m[i]=r[i]??a),u.debug(`Creating record in ${t.tableName} with timestamp ${a}`),await T(m)},async update(e,r){let a=r,m=p(s),c={...a,[i]:a[i]??m};return u.debug(`Updating record ${e} in ${t.tableName} with timestamp ${m}`),await f(e,c)},async findCreatedAfter(e){return await w(o,t.tableName,n).where(">",String(e)).selectAll().execute()},async findCreatedBefore(e){return await w(o,t.tableName,n).where("<",String(e)).selectAll().execute()},async findCreatedBetween(e,r){return await o.selectFrom(t.tableName).selectAll().where(n,">=",e).where(n,"<=",r).execute()},async findUpdatedAfter(e){return await w(o,t.tableName,i).where(">",String(e)).selectAll().execute()},async findRecentlyUpdated(e=10){return await o.selectFrom(t.tableName).selectAll().orderBy(i,"desc").limit(e).execute()},async findRecentlyCreated(e=10){return await o.selectFrom(t.tableName).selectAll().orderBy(n,"desc").limit(e).execute()},async createWithoutTimestamps(e){return u.debug(`Creating record in ${t.tableName} without timestamps`),await T(e)},async updateWithoutTimestamp(e,r){return u.debug(`Updating record ${e} in ${t.tableName} without timestamp`),await f(e,r)},async touch(e){let r=p(s),a={[i]:r};u.info(`Touching record ${e} in ${t.tableName}`),await o.updateTable(t.tableName).set(a).where(d,"=",e).execute();},getTimestampColumns(){return {createdAt:n,updatedAt:i}},async createMany(e){if(!e||e.length===0)return [];let r=p(s),a=e.map(m=>{let c=m,b={...c,[n]:c[n]??r};return y&&(b[i]=c[i]??r),b});if(u.info(`Creating ${e.length} records in ${t.tableName} with timestamp ${r}`),N(o))return await o.insertInto(t.tableName).values(a).returningAll().execute();{await o.insertInto(t.tableName).values(a).execute();let m=a.length;return (await o.selectFrom(t.tableName).selectAll().where(n,"=",r).orderBy(d,"desc").limit(m).execute()).reverse()}},async updateMany(e,r){if(!e||e.length===0)return [];let a=r,m=p(s),c={...a,[i]:a[i]??m};return u.info(`Updating ${e.length} records in ${t.tableName} with timestamp ${m}`),await o.updateTable(t.tableName).set(c).where(d,"in",e).execute(),await o.selectFrom(t.tableName).selectAll().where(d,"in",e).execute()},async touchMany(e){if(!e||e.length===0)return;let r=p(s),a={[i]:r};u.info(`Touching ${e.length} records in ${t.tableName}`),await o.updateTable(t.tableName).set(a).where(d,"in",e).execute();}}}}};export{B as TimestampsOptionsSchema,O as timestampsPlugin};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["TimestampsOptionsSchema","z","getTimestamp","options","now","shouldApplyTimestamps","tableName","createTimestampQuery","executor","column","operator","value","timestampsPlugin","createdAtColumn","updatedAtColumn","setUpdatedAtOnInsert","primaryKeyColumn","logger","silentLogger","qb","_context","repo","baseRepo","originalCreate","originalUpdate","input","data","timestamp","dataWithTimestamps","id","dataWithTimestamp","date","startDate","endDate","limit","updateData","inputs","result","ids"],"mappings":"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","file":"index.js","sourcesContent":["import type { Plugin, Repository } from '@kysera/repository';\nimport type { Kysely, SelectQueryBuilder } from 'kysely';\nimport { silentLogger } from '@kysera/core';\nimport type { KyseraLogger } from '@kysera/core';\nimport { z } from 'zod';\n\n/**\n * Database schema with timestamp columns\n */\ntype TimestampedTable = Record<string, unknown>;\n\n/**\n * Timestamp methods added to repositories\n */\nexport interface TimestampMethods<T> {\n  findCreatedAfter(date: Date | string): Promise<T[]>;\n  findCreatedBefore(date: Date | string): Promise<T[]>;\n  findCreatedBetween(startDate: Date | string, endDate: Date | string): Promise<T[]>;\n  findUpdatedAfter(date: Date | string): Promise<T[]>;\n  findRecentlyUpdated(limit?: number): Promise<T[]>;\n  findRecentlyCreated(limit?: number): Promise<T[]>;\n  createWithoutTimestamps(input: unknown): Promise<T>;\n  updateWithoutTimestamp(id: number, input: unknown): Promise<T>;\n  touch(id: number): Promise<void>;\n  getTimestampColumns(): { createdAt: string; updatedAt: string };\n  createMany(inputs: unknown[]): Promise<T[]>;\n  updateMany(ids: (number | string)[], input: unknown): Promise<T[]>;\n  touchMany(ids: (number | string)[]): Promise<void>;\n}\n\n/**\n * Options for the timestamps plugin\n */\nexport interface TimestampsOptions {\n  /**\n   * Name of the created_at column\n   * @default 'created_at'\n   */\n  createdAtColumn?: string;\n\n  /**\n   * Name of the updated_at column\n   * @default 'updated_at'\n   */\n  updatedAtColumn?: string;\n\n  /**\n   * Whether to set updated_at on insert\n   * @default false\n   */\n  setUpdatedAtOnInsert?: boolean;\n\n  /**\n   * List of tables that should have timestamps\n   * If not specified, all tables will have timestamps\n   */\n  tables?: string[];\n\n  /**\n   * Tables that should be excluded from timestamps\n   */\n  excludeTables?: string[];\n\n  /**\n   * Custom timestamp function (defaults to new Date().toISOString())\n   */\n  getTimestamp?: () => Date | string | number;\n\n  /**\n   * Date format for database (ISO string by default)\n   */\n  dateFormat?: 'iso' | 'unix' | 'date';\n\n  /**\n   * Name of the primary key column used by touch() method\n   * @default 'id'\n   */\n  primaryKeyColumn?: string;\n\n  /**\n   * Logger for plugin operations.\n   * Uses KyseraLogger interface from @kysera/core.\n   *\n   * @default silentLogger (no output)\n   */\n  logger?: KyseraLogger;\n}\n\n/**\n * Zod schema for TimestampsOptions\n * Used for validation and configuration in the kysera-cli\n */\nexport const TimestampsOptionsSchema = z.object({\n  createdAtColumn: z.string().optional(),\n  updatedAtColumn: z.string().optional(),\n  setUpdatedAtOnInsert: z.boolean().optional(),\n  tables: z.array(z.string()).optional(),\n  excludeTables: z.array(z.string()).optional(),\n  getTimestamp: z.function().optional(),\n  dateFormat: z.enum(['iso', 'unix', 'date']).optional(),\n  primaryKeyColumn: z.string().optional(),\n});\n\n/**\n * Repository extended with timestamp methods\n */\nexport type TimestampsRepository<Entity, DB> = Repository<Entity, DB> & TimestampMethods<Entity>;\n\n/**\n * Get the current timestamp based on options\n */\nfunction getTimestamp(options: TimestampsOptions): Date | string | number {\n  if (options.getTimestamp) {\n    return options.getTimestamp();\n  }\n\n  const now = new Date();\n\n  switch (options.dateFormat) {\n    case 'unix':\n      return Math.floor(now.getTime() / 1000);\n    case 'date':\n      return now;\n    case 'iso':\n    default:\n      return now.toISOString();\n  }\n}\n\n/**\n * Check if a table should have timestamps\n */\nfunction shouldApplyTimestamps(tableName: string, options: TimestampsOptions): boolean {\n  if (options.excludeTables?.includes(tableName)) {\n    return false;\n  }\n\n  if (options.tables) {\n    return options.tables.includes(tableName);\n  }\n\n  return true;\n}\n\n/**\n * Type-safe query builder for timestamp operations\n */\nfunction createTimestampQuery(\n  executor: Kysely<Record<string, TimestampedTable>>,\n  tableName: string,\n  column: string\n): {\n  select(): SelectQueryBuilder<Record<string, TimestampedTable>, typeof tableName, {}>;\n  where<V>(operator: string, value: V): SelectQueryBuilder<Record<string, TimestampedTable>, typeof tableName, {}>;\n} {\n  return {\n    select() {\n      return executor.selectFrom(tableName as never);\n    },\n    where<V>(operator: string, value: V) {\n      return executor.selectFrom(tableName as never).where(column as never, operator as never, value as never);\n    },\n  };\n}\n\n/**\n * Timestamps Plugin\n *\n * Automatically manages created_at and updated_at timestamps for database records.\n * Works by overriding repository methods to add timestamp values.\n *\n * ## Features\n *\n * - Automatic `created_at` on insert\n * - Automatic `updated_at` on every update\n * - Configurable column names\n * - Configurable timestamp format (ISO, Unix, Date)\n * - Query helpers: findCreatedAfter, findUpdatedAfter, etc.\n * - Bulk operations: createMany, updateMany, touchMany\n *\n * ## Transaction Behavior\n *\n * **IMPORTANT**: Timestamp operations respect ACID properties and work correctly with transactions:\n *\n * - ✅ **Commits with transaction**: Timestamps are set using the same executor as the\n *   repository operation, so they commit together\n * - ✅ **Rolls back with transaction**: If a transaction is rolled back, all timestamp\n *   changes are also rolled back\n * - ✅ **Consistent timestamps**: All operations within a transaction can use the same\n *   timestamp by providing a custom `getTimestamp` function\n *\n * ### Correct Transaction Usage\n *\n * ```typescript\n * // ✅ CORRECT: Timestamps are part of transaction\n * await db.transaction().execute(async (trx) => {\n *   const repos = createRepositories(trx)  // Use transaction executor\n *   await repos.users.create({ email: 'test@example.com' })  // created_at auto-set\n *   await repos.posts.createMany([...])  // All created_at set consistently\n *   // If transaction rolls back, all changes including timestamps roll back\n * })\n * ```\n *\n * ### Consistent Timestamps Across Operations\n *\n * ```typescript\n * // Use shared timestamp for all operations in a transaction\n * const now = new Date()\n * const timestampsWithFixedTime = timestampsPlugin({\n *   getTimestamp: () => now\n * })\n *\n * await db.transaction().execute(async (trx) => {\n *   // All operations will have the exact same timestamp\n *   await repos.users.create(...)  // created_at = now\n *   await repos.posts.update(...)  // updated_at = now\n * })\n * ```\n *\n * @example\n * ```typescript\n * import { timestampsPlugin } from '@kysera/timestamps'\n *\n * const plugin = timestampsPlugin({\n *   createdAtColumn: 'created_at',\n *   updatedAtColumn: 'updated_at',\n *   tables: ['users', 'posts', 'comments']\n * })\n *\n * const orm = createORM(db, [plugin])\n * ```\n */\nexport const timestampsPlugin = (options: TimestampsOptions = {}): Plugin => {\n  const {\n    createdAtColumn = 'created_at',\n    updatedAtColumn = 'updated_at',\n    setUpdatedAtOnInsert = false,\n    primaryKeyColumn = 'id',\n    logger = silentLogger,\n  } = options;\n\n  return {\n    name: '@kysera/timestamps',\n    version: '0.5.1',\n\n    interceptQuery(qb, _context) {\n      // The interceptQuery method can't modify INSERT/UPDATE values in Kysely\n      // We handle timestamps through repository method overrides instead\n      return qb;\n    },\n\n    extendRepository<T extends object>(repo: T): T {\n      // Check if it's actually a repository (has required properties)\n      if (!('tableName' in repo) || !('executor' in repo)) {\n        return repo;\n      }\n\n      // Type assertion is safe here as we've checked for properties\n      const baseRepo = repo as T & { tableName: string; executor: unknown; create: Function; update: Function };\n\n      // Skip if table doesn't support timestamps\n      if (!shouldApplyTimestamps(baseRepo.tableName, options)) {\n        logger.debug(`Table ${baseRepo.tableName} excluded from timestamps, skipping extension`);\n        return repo;\n      }\n\n      logger.debug(`Extending repository for table ${baseRepo.tableName} with timestamp methods`);\n\n      // Save original methods\n      const originalCreate = baseRepo.create.bind(baseRepo);\n      const originalUpdate = baseRepo.update.bind(baseRepo);\n      const executor = baseRepo.executor as Kysely<Record<string, TimestampedTable>>;\n\n      const extendedRepo = {\n        ...baseRepo,\n\n        // Override create to add timestamps\n        async create(input: unknown): Promise<unknown> {\n          const data = input as Record<string, unknown>;\n          const timestamp = getTimestamp(options);\n          const dataWithTimestamps: Record<string, unknown> = {\n            ...data,\n            [createdAtColumn]: data[createdAtColumn] ?? timestamp,\n          };\n\n          if (setUpdatedAtOnInsert) {\n            dataWithTimestamps[updatedAtColumn] = data[updatedAtColumn] ?? timestamp;\n          }\n\n          logger.debug(`Creating record in ${baseRepo.tableName} with timestamp ${timestamp}`);\n          return await originalCreate(dataWithTimestamps);\n        },\n\n        // Override update to set updated_at\n        async update(id: number, input: unknown): Promise<unknown> {\n          const data = input as Record<string, unknown>;\n          const timestamp = getTimestamp(options);\n          const dataWithTimestamp: Record<string, unknown> = {\n            ...data,\n            [updatedAtColumn]: data[updatedAtColumn] ?? timestamp,\n          };\n\n          logger.debug(`Updating record ${id} in ${baseRepo.tableName} with timestamp ${timestamp}`);\n          return await originalUpdate(id, dataWithTimestamp);\n        },\n\n        /**\n         * Find records created after a specific date\n         */\n        async findCreatedAfter(date: Date | string | number): Promise<unknown[]> {\n          const query = createTimestampQuery(executor, baseRepo.tableName, createdAtColumn);\n          const result = await query.where('>', String(date)).selectAll().execute();\n          return result;\n        },\n\n        /**\n         * Find records created before a specific date\n         */\n        async findCreatedBefore(date: Date | string | number): Promise<unknown[]> {\n          const query = createTimestampQuery(executor, baseRepo.tableName, createdAtColumn);\n          const result = await query.where('<', String(date)).selectAll().execute();\n          return result;\n        },\n\n        /**\n         * Find records created between two dates\n         */\n        async findCreatedBetween(\n          startDate: Date | string | number,\n          endDate: Date | string | number\n        ): Promise<unknown[]> {\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .where(createdAtColumn as never, '>=', startDate as never)\n            .where(createdAtColumn as never, '<=', endDate as never)\n            .execute();\n          return result;\n        },\n\n        /**\n         * Find records updated after a specific date\n         */\n        async findUpdatedAfter(date: Date | string | number): Promise<unknown[]> {\n          const query = createTimestampQuery(executor, baseRepo.tableName, updatedAtColumn);\n          const result = await query.where('>', String(date)).selectAll().execute();\n          return result;\n        },\n\n        /**\n         * Find recently updated records\n         */\n        async findRecentlyUpdated(limit = 10): Promise<unknown[]> {\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .orderBy(updatedAtColumn as never, 'desc')\n            .limit(limit)\n            .execute();\n          return result;\n        },\n\n        /**\n         * Find recently created records\n         */\n        async findRecentlyCreated(limit = 10): Promise<unknown[]> {\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .orderBy(createdAtColumn as never, 'desc')\n            .limit(limit)\n            .execute();\n          return result;\n        },\n\n        /**\n         * Create without adding timestamps\n         */\n        async createWithoutTimestamps(input: unknown): Promise<unknown> {\n          logger.debug(`Creating record in ${baseRepo.tableName} without timestamps`);\n          return await originalCreate(input);\n        },\n\n        /**\n         * Update without modifying timestamp\n         */\n        async updateWithoutTimestamp(id: number, input: unknown): Promise<unknown> {\n          logger.debug(`Updating record ${id} in ${baseRepo.tableName} without timestamp`);\n          return await originalUpdate(id, input);\n        },\n\n        /**\n         * Touch a record (update its timestamp)\n         */\n        async touch(id: number): Promise<void> {\n          const timestamp = getTimestamp(options);\n          const updateData = { [updatedAtColumn]: timestamp };\n\n          logger.info(`Touching record ${id} in ${baseRepo.tableName}`);\n          await executor\n            .updateTable(baseRepo.tableName as never)\n            .set(updateData as never)\n            .where(primaryKeyColumn as never, '=', id as never)\n            .execute();\n        },\n\n        /**\n         * Get the timestamp column names\n         */\n        getTimestampColumns(): { createdAt: string; updatedAt: string } {\n          return {\n            createdAt: createdAtColumn,\n            updatedAt: updatedAtColumn,\n          };\n        },\n\n        /**\n         * Create multiple records with timestamps\n         * Uses efficient bulk INSERT with automatic timestamp injection\n         */\n        async createMany(inputs: unknown[]): Promise<unknown[]> {\n          // Handle empty arrays gracefully\n          if (!inputs || inputs.length === 0) {\n            return [];\n          }\n\n          const timestamp = getTimestamp(options);\n          const dataWithTimestamps = inputs.map((input) => {\n            const data = input as Record<string, unknown>;\n            const result: Record<string, unknown> = {\n              ...data,\n              [createdAtColumn]: data[createdAtColumn] ?? timestamp,\n            };\n\n            if (setUpdatedAtOnInsert) {\n              result[updatedAtColumn] = data[updatedAtColumn] ?? timestamp;\n            }\n\n            return result;\n          });\n\n          logger.info(`Creating ${inputs.length} records in ${baseRepo.tableName} with timestamp ${timestamp}`);\n\n          // Use Kysely's insertInto for efficient bulk insert\n          const result = await executor\n            .insertInto(baseRepo.tableName as never)\n            .values(dataWithTimestamps as never)\n            .returningAll()\n            .execute();\n\n          return result;\n        },\n\n        /**\n         * Update multiple records (sets updated_at for all)\n         * Updates all specified records with the same data\n         */\n        async updateMany(ids: (number | string)[], input: unknown): Promise<unknown[]> {\n          // Handle empty arrays gracefully\n          if (!ids || ids.length === 0) {\n            return [];\n          }\n\n          const data = input as Record<string, unknown>;\n          const timestamp = getTimestamp(options);\n          const dataWithTimestamp: Record<string, unknown> = {\n            ...data,\n            [updatedAtColumn]: data[updatedAtColumn] ?? timestamp,\n          };\n\n          logger.info(`Updating ${ids.length} records in ${baseRepo.tableName} with timestamp ${timestamp}`);\n\n          // Use Kysely's update with IN clause for efficient bulk update\n          await executor\n            .updateTable(baseRepo.tableName as never)\n            .set(dataWithTimestamp as never)\n            .where('id' as never, 'in', ids as never)\n            .execute();\n\n          // Fetch and return updated records\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .where('id' as never, 'in', ids as never)\n            .execute();\n\n          return result;\n        },\n\n        /**\n         * Touch multiple records (update updated_at only)\n         * Efficiently updates only the timestamp column\n         */\n        async touchMany(ids: (number | string)[]): Promise<void> {\n          // Handle empty arrays gracefully\n          if (!ids || ids.length === 0) {\n            return;\n          }\n\n          const timestamp = getTimestamp(options);\n          const updateData = { [updatedAtColumn]: timestamp };\n\n          logger.info(`Touching ${ids.length} records in ${baseRepo.tableName}`);\n          await executor\n            .updateTable(baseRepo.tableName as never)\n            .set(updateData as never)\n            .where('id' as never, 'in', ids as never)\n            .execute();\n        },\n      };\n\n      return extendedRepo as T;\n    },\n  };\n};\n"]}
+{"version":3,"sources":["../src/version.ts","../src/index.ts"],"names":["RAW_VERSION","VERSION","TimestampsOptionsSchema","z","getTimestamp","options","now","shouldApplyTimestamps","tableName","createTimestampQuery","executor","column","operator","value","supportsReturning","dialect","detectDialect","timestampsPlugin","createdAtColumn","updatedAtColumn","setUpdatedAtOnInsert","primaryKeyColumn","logger","silentLogger","repo","baseRepo","originalCreate","originalUpdate","input","data","timestamp","dataWithTimestamps","id","dataWithTimestamp","date","startDate","endDate","limit","updateData","inputs","result","insertedCount","ids"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Package version - injected at build time by tsup\n * Falls back to development version if not replaced\n * @internal\n */\nconst RAW_VERSION = '__VERSION__'\nexport const VERSION = RAW_VERSION.startsWith('__') ? '0.0.0-dev' : RAW_VERSION\n","import type { Plugin } from '@kysera/executor'\nimport type { Repository } from '@kysera/repository'\nimport type { Kysely, SelectQueryBuilder } from 'kysely'\nimport { silentLogger, detectDialect } from '@kysera/core'\nimport type { KyseraLogger } from '@kysera/core'\nimport { z } from 'zod'\nimport { VERSION } from './version.js'\n\n/**\n * Database schema with timestamp columns\n */\ntype TimestampedTable = Record<string, unknown>\n\n/**\n * Timestamp methods added to repositories\n */\nexport interface TimestampMethods<T> {\n  findCreatedAfter(date: Date | string): Promise<T[]>\n  findCreatedBefore(date: Date | string): Promise<T[]>\n  findCreatedBetween(startDate: Date | string, endDate: Date | string): Promise<T[]>\n  findUpdatedAfter(date: Date | string): Promise<T[]>\n  findRecentlyUpdated(limit?: number): Promise<T[]>\n  findRecentlyCreated(limit?: number): Promise<T[]>\n  createWithoutTimestamps(input: unknown): Promise<T>\n  updateWithoutTimestamp(id: number, input: unknown): Promise<T>\n  touch(id: number): Promise<void>\n  getTimestampColumns(): { createdAt: string; updatedAt: string }\n  createMany(inputs: unknown[]): Promise<T[]>\n  updateMany(ids: (number | string)[], input: unknown): Promise<T[]>\n  touchMany(ids: (number | string)[]): Promise<void>\n}\n\n/**\n * Options for the timestamps plugin\n */\nexport interface TimestampsOptions {\n  /**\n   * Name of the created_at column\n   * @default 'created_at'\n   */\n  createdAtColumn?: string\n\n  /**\n   * Name of the updated_at column\n   * @default 'updated_at'\n   */\n  updatedAtColumn?: string\n\n  /**\n   * Whether to set updated_at on insert\n   * @default false\n   */\n  setUpdatedAtOnInsert?: boolean\n\n  /**\n   * List of tables that should have timestamps\n   * If not specified, all tables will have timestamps\n   */\n  tables?: string[]\n\n  /**\n   * Tables that should be excluded from timestamps\n   */\n  excludeTables?: string[]\n\n  /**\n   * Custom timestamp function (defaults to new Date().toISOString())\n   */\n  getTimestamp?: () => Date | string | number\n\n  /**\n   * Date format for database (ISO string by default)\n   */\n  dateFormat?: 'iso' | 'unix' | 'date'\n\n  /**\n   * Name of the primary key column used by touch() method\n   * @default 'id'\n   */\n  primaryKeyColumn?: string\n\n  /**\n   * Logger for plugin operations.\n   * Uses KyseraLogger interface from @kysera/core.\n   *\n   * @default silentLogger (no output)\n   */\n  logger?: KyseraLogger\n}\n\n/**\n * Zod schema for TimestampsOptions\n * Used for validation and configuration in the kysera-cli\n */\nexport const TimestampsOptionsSchema = z.object({\n  createdAtColumn: z.string().optional(),\n  updatedAtColumn: z.string().optional(),\n  setUpdatedAtOnInsert: z.boolean().optional(),\n  tables: z.array(z.string()).optional(),\n  excludeTables: z.array(z.string()).optional(),\n  getTimestamp: z.function().optional(),\n  dateFormat: z.enum(['iso', 'unix', 'date']).optional(),\n  primaryKeyColumn: z.string().optional()\n})\n\n/**\n * Repository extended with timestamp methods\n */\nexport type TimestampsRepository<Entity, DB> = Repository<Entity, DB> & TimestampMethods<Entity>\n\n/**\n * Get the current timestamp based on options\n */\nfunction getTimestamp(options: TimestampsOptions): Date | string | number {\n  if (options.getTimestamp) {\n    return options.getTimestamp()\n  }\n\n  const now = new Date()\n\n  switch (options.dateFormat) {\n    case 'unix':\n      return Math.floor(now.getTime() / 1000)\n    case 'date':\n      return now\n    case 'iso':\n    default:\n      return now.toISOString()\n  }\n}\n\n/**\n * Check if a table should have timestamps\n */\nfunction shouldApplyTimestamps(tableName: string, options: TimestampsOptions): boolean {\n  if (options.excludeTables?.includes(tableName)) {\n    return false\n  }\n\n  if (options.tables) {\n    return options.tables.includes(tableName)\n  }\n\n  return true\n}\n\n/**\n * Type-safe query builder for timestamp operations\n */\nfunction createTimestampQuery(\n  executor: Kysely<Record<string, TimestampedTable>>,\n  tableName: string,\n  column: string\n): {\n  select(): SelectQueryBuilder<Record<string, TimestampedTable>, typeof tableName, {}>\n  where<V>(\n    operator: string,\n    value: V\n  ): SelectQueryBuilder<Record<string, TimestampedTable>, typeof tableName, {}>\n} {\n  return {\n    select() {\n      return executor.selectFrom(tableName as never)\n    },\n    where<V>(operator: string, value: V) {\n      return executor\n        .selectFrom(tableName as never)\n        .where(column as never, operator as never, value as never)\n    }\n  }\n}\n\n/**\n * Check if dialect supports RETURNING clause\n *\n * Database compatibility:\n * - PostgreSQL: Full RETURNING support ✅\n * - SQLite: RETURNING supported in 3.35+ ✅ (most modern versions)\n * - MySQL: No RETURNING support ❌\n * - MSSQL: Uses OUTPUT clause ❌ (different syntax, not compatible with returningAll())\n *\n * **Implementation Notes:**\n * - We only check for MySQL since it's the only major dialect without RETURNING\n * - SQLite 3.35+ is widely deployed (released 2021-03-12)\n * - MSSQL support is minimal in Kysera ecosystem, treated as unsupported here\n * - If MSSQL full support is needed, this function should be extended to detect MSSQL\n *\n * @param executor - Kysely database executor\n * @returns true if RETURNING clause is supported\n */\nfunction supportsReturning<DB>(executor: Kysely<DB>): boolean {\n  const dialect = detectDialect(executor)\n  // Return false for MySQL (doesn't support RETURNING)\n  // Return false for MSSQL (uses OUTPUT, not RETURNING)\n  // Return true for PostgreSQL and SQLite\n  return dialect !== 'mysql' && dialect !== 'mssql'\n}\n\n/**\n * Timestamps Plugin\n *\n * Automatically manages created_at and updated_at timestamps for database records.\n * Works by overriding repository methods to add timestamp values.\n *\n * ## Features\n *\n * - Automatic `created_at` on insert\n * - Automatic `updated_at` on every update\n * - Configurable column names\n * - Configurable timestamp format (ISO, Unix, Date)\n * - Query helpers: findCreatedAfter, findUpdatedAfter, etc.\n * - Bulk operations: createMany, updateMany, touchMany\n * - **Cross-database support**: Works with PostgreSQL, MySQL, SQLite, and MSSQL\n *\n * ## Transaction Behavior\n *\n * **IMPORTANT**: Timestamp operations respect ACID properties and work correctly with transactions:\n *\n * - ✅ **Commits with transaction**: Timestamps are set using the same executor as the\n *   repository operation, so they commit together\n * - ✅ **Rolls back with transaction**: If a transaction is rolled back, all timestamp\n *   changes are also rolled back\n * - ✅ **Consistent timestamps**: All operations within a transaction can use the same\n *   timestamp by providing a custom `getTimestamp` function\n *\n * ### Correct Transaction Usage\n *\n * ```typescript\n * // ✅ CORRECT: Timestamps are part of transaction\n * await db.transaction().execute(async (trx) => {\n *   const repos = createRepositories(trx)  // Use transaction executor\n *   await repos.users.create({ email: 'test@example.com' })  // created_at auto-set\n *   await repos.posts.createMany([...])  // All created_at set consistently\n *   // If transaction rolls back, all changes including timestamps roll back\n * })\n * ```\n *\n * ### Consistent Timestamps Across Operations\n *\n * ```typescript\n * // Use shared timestamp for all operations in a transaction\n * const now = new Date()\n * const timestampsWithFixedTime = timestampsPlugin({\n *   getTimestamp: () => now\n * })\n *\n * await db.transaction().execute(async (trx) => {\n *   // All operations will have the exact same timestamp\n *   await repos.users.create(...)  // created_at = now\n *   await repos.posts.update(...)  // updated_at = now\n * })\n * ```\n *\n * @example\n * ```typescript\n * import { timestampsPlugin } from '@kysera/timestamps'\n *\n * const plugin = timestampsPlugin({\n *   createdAtColumn: 'created_at',\n *   updatedAtColumn: 'updated_at',\n *   tables: ['users', 'posts', 'comments']\n * })\n *\n * const orm = createORM(db, [plugin])\n * ```\n */\nexport const timestampsPlugin = (options: TimestampsOptions = {}): Plugin => {\n  const {\n    createdAtColumn = 'created_at',\n    updatedAtColumn = 'updated_at',\n    setUpdatedAtOnInsert = false,\n    primaryKeyColumn = 'id',\n    logger = silentLogger\n  } = options\n\n  return {\n    name: '@kysera/timestamps',\n    version: VERSION,\n    priority: 50, // Run in the middle, after filtering but before audit\n\n    /**\n     * Lifecycle: No initialization needed for timestamps plugin\n     */\n    onInit() {\n      // No initialization required\n    },\n\n    /**\n     * Lifecycle: Cleanup resources when executor is destroyed\n     */\n    async onDestroy() {\n      // No cleanup required - timestamps plugin has no persistent resources\n      logger.debug('Timestamps plugin destroyed')\n    },\n\n    extendRepository<T extends object>(repo: T): T {\n      // Check if it's actually a repository (has required properties)\n      if (!('tableName' in repo) || !('executor' in repo)) {\n        return repo\n      }\n\n      // Type assertion is safe here as we've checked for properties\n      const baseRepo = repo as T & {\n        tableName: string\n        executor: unknown\n        create: Function\n        update: Function\n      }\n\n      // Skip if table doesn't support timestamps\n      if (!shouldApplyTimestamps(baseRepo.tableName, options)) {\n        logger.debug(`Table ${baseRepo.tableName} excluded from timestamps, skipping extension`)\n        return repo\n      }\n\n      logger.debug(`Extending repository for table ${baseRepo.tableName} with timestamp methods`)\n\n      // Save original methods\n      const originalCreate = baseRepo.create.bind(baseRepo)\n      const originalUpdate = baseRepo.update.bind(baseRepo)\n      const executor = baseRepo.executor as Kysely<Record<string, TimestampedTable>>\n\n      const extendedRepo = {\n        ...baseRepo,\n\n        // Override create to add timestamps\n        async create(input: unknown): Promise<unknown> {\n          const data = input as Record<string, unknown>\n          const timestamp = getTimestamp(options)\n          const dataWithTimestamps: Record<string, unknown> = {\n            ...data,\n            [createdAtColumn]: data[createdAtColumn] ?? timestamp\n          }\n\n          if (setUpdatedAtOnInsert) {\n            dataWithTimestamps[updatedAtColumn] = data[updatedAtColumn] ?? timestamp\n          }\n\n          logger.debug(`Creating record in ${baseRepo.tableName} with timestamp ${timestamp}`)\n          return await originalCreate(dataWithTimestamps)\n        },\n\n        // Override update to set updated_at\n        async update(id: number, input: unknown): Promise<unknown> {\n          const data = input as Record<string, unknown>\n          const timestamp = getTimestamp(options)\n          const dataWithTimestamp: Record<string, unknown> = {\n            ...data,\n            [updatedAtColumn]: data[updatedAtColumn] ?? timestamp\n          }\n\n          logger.debug(`Updating record ${id} in ${baseRepo.tableName} with timestamp ${timestamp}`)\n          return await originalUpdate(id, dataWithTimestamp)\n        },\n\n        /**\n         * Find records created after a specific date\n         */\n        async findCreatedAfter(date: Date | string | number): Promise<unknown[]> {\n          const query = createTimestampQuery(executor, baseRepo.tableName, createdAtColumn)\n          const result = await query.where('>', String(date)).selectAll().execute()\n          return result\n        },\n\n        /**\n         * Find records created before a specific date\n         */\n        async findCreatedBefore(date: Date | string | number): Promise<unknown[]> {\n          const query = createTimestampQuery(executor, baseRepo.tableName, createdAtColumn)\n          const result = await query.where('<', String(date)).selectAll().execute()\n          return result\n        },\n\n        /**\n         * Find records created between two dates\n         */\n        async findCreatedBetween(\n          startDate: Date | string | number,\n          endDate: Date | string | number\n        ): Promise<unknown[]> {\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .where(createdAtColumn as never, '>=', startDate as never)\n            .where(createdAtColumn as never, '<=', endDate as never)\n            .execute()\n          return result\n        },\n\n        /**\n         * Find records updated after a specific date\n         */\n        async findUpdatedAfter(date: Date | string | number): Promise<unknown[]> {\n          const query = createTimestampQuery(executor, baseRepo.tableName, updatedAtColumn)\n          const result = await query.where('>', String(date)).selectAll().execute()\n          return result\n        },\n\n        /**\n         * Find recently updated records\n         */\n        async findRecentlyUpdated(limit = 10): Promise<unknown[]> {\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .orderBy(updatedAtColumn as never, 'desc')\n            .limit(limit)\n            .execute()\n          return result\n        },\n\n        /**\n         * Find recently created records\n         */\n        async findRecentlyCreated(limit = 10): Promise<unknown[]> {\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .orderBy(createdAtColumn as never, 'desc')\n            .limit(limit)\n            .execute()\n          return result\n        },\n\n        /**\n         * Create without adding timestamps\n         */\n        async createWithoutTimestamps(input: unknown): Promise<unknown> {\n          logger.debug(`Creating record in ${baseRepo.tableName} without timestamps`)\n          return await originalCreate(input)\n        },\n\n        /**\n         * Update without modifying timestamp\n         */\n        async updateWithoutTimestamp(id: number, input: unknown): Promise<unknown> {\n          logger.debug(`Updating record ${id} in ${baseRepo.tableName} without timestamp`)\n          return await originalUpdate(id, input)\n        },\n\n        /**\n         * Touch a record (update its timestamp)\n         */\n        async touch(id: number): Promise<void> {\n          const timestamp = getTimestamp(options)\n          const updateData = { [updatedAtColumn]: timestamp }\n\n          logger.info(`Touching record ${id} in ${baseRepo.tableName}`)\n          await executor\n            .updateTable(baseRepo.tableName as never)\n            .set(updateData as never)\n            .where(primaryKeyColumn as never, '=', id as never)\n            .execute()\n        },\n\n        /**\n         * Get the timestamp column names\n         */\n        getTimestampColumns(): { createdAt: string; updatedAt: string } {\n          return {\n            createdAt: createdAtColumn,\n            updatedAt: updatedAtColumn\n          }\n        },\n\n        /**\n         * Create multiple records with timestamps\n         * Uses efficient bulk INSERT with automatic timestamp injection.\n         * Supports PostgreSQL, MySQL, SQLite, and MSSQL with appropriate fallbacks.\n         */\n        async createMany(inputs: unknown[]): Promise<unknown[]> {\n          // Handle empty arrays gracefully\n          if (!inputs || inputs.length === 0) {\n            return []\n          }\n\n          const timestamp = getTimestamp(options)\n          const dataWithTimestamps = inputs.map(input => {\n            const data = input as Record<string, unknown>\n            const result: Record<string, unknown> = {\n              ...data,\n              [createdAtColumn]: data[createdAtColumn] ?? timestamp\n            }\n\n            if (setUpdatedAtOnInsert) {\n              result[updatedAtColumn] = data[updatedAtColumn] ?? timestamp\n            }\n\n            return result\n          })\n\n          logger.info(\n            `Creating ${inputs.length} records in ${baseRepo.tableName} with timestamp ${timestamp}`\n          )\n\n          // Check if dialect supports RETURNING\n          if (supportsReturning(executor)) {\n            // Use RETURNING for PostgreSQL/SQLite - most efficient\n            const result = await executor\n              .insertInto(baseRepo.tableName as never)\n              .values(dataWithTimestamps as never)\n              .returningAll()\n              .execute()\n\n            return result\n          } else {\n            // Fallback for MySQL/MSSQL - insert then select\n            // This approach works for auto-increment primary keys\n            await executor\n              .insertInto(baseRepo.tableName as never)\n              .values(dataWithTimestamps as never)\n              .execute()\n\n            // Fetch inserted records by matching on unique columns\n            // For simplicity, we fetch the most recently created records\n            // This works well when created_at is set to the same timestamp\n            const insertedCount = dataWithTimestamps.length\n            const result = await executor\n              .selectFrom(baseRepo.tableName as never)\n              .selectAll()\n              .where(createdAtColumn as never, '=', timestamp as never)\n              .orderBy(primaryKeyColumn as never, 'desc')\n              .limit(insertedCount)\n              .execute()\n\n            // Reverse to maintain insertion order\n            return result.reverse()\n          }\n        },\n\n        /**\n         * Update multiple records (sets updated_at for all)\n         * Updates all specified records with the same data\n         */\n        async updateMany(ids: (number | string)[], input: unknown): Promise<unknown[]> {\n          // Handle empty arrays gracefully\n          if (!ids || ids.length === 0) {\n            return []\n          }\n\n          const data = input as Record<string, unknown>\n          const timestamp = getTimestamp(options)\n          const dataWithTimestamp: Record<string, unknown> = {\n            ...data,\n            [updatedAtColumn]: data[updatedAtColumn] ?? timestamp\n          }\n\n          logger.info(\n            `Updating ${ids.length} records in ${baseRepo.tableName} with timestamp ${timestamp}`\n          )\n\n          // Use Kysely's update with IN clause for efficient bulk update\n          await executor\n            .updateTable(baseRepo.tableName as never)\n            .set(dataWithTimestamp as never)\n            .where(primaryKeyColumn as never, 'in', ids as never)\n            .execute()\n\n          // Fetch and return updated records\n          const result = await executor\n            .selectFrom(baseRepo.tableName as never)\n            .selectAll()\n            .where(primaryKeyColumn as never, 'in', ids as never)\n            .execute()\n\n          return result\n        },\n\n        /**\n         * Touch multiple records (update updated_at only)\n         * Efficiently updates only the timestamp column\n         */\n        async touchMany(ids: (number | string)[]): Promise<void> {\n          // Handle empty arrays gracefully\n          if (!ids || ids.length === 0) {\n            return\n          }\n\n          const timestamp = getTimestamp(options)\n          const updateData = { [updatedAtColumn]: timestamp }\n\n          logger.info(`Touching ${ids.length} records in ${baseRepo.tableName}`)\n          await executor\n            .updateTable(baseRepo.tableName as never)\n            .set(updateData as never)\n            .where(primaryKeyColumn as never, 'in', ids as never)\n            .execute()\n        }\n      }\n\n      return extendedRepo as T\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kysera/timestamps",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Automatic timestamp management plugin for Kysely repositories",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,24 +27,25 @@
   "author": "Kysera Team",
   "license": "MIT",
   "dependencies": {
-    "@kysera/core": "0.7.2"
+    "@kysera/core": "0.7.4"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^4.0.15",
+    "@vitest/coverage-v8": "^4.0.16",
     "better-sqlite3": "^12.5.0",
     "kysely": "^0.28.9",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15",
+    "vitest": "^4.0.16",
     "zod": "^4.1.13",
-    "@kysera/repository": "0.7.2"
+    "@kysera/repository": "0.7.4"
   },
   "peerDependencies": {
     "kysely": ">=0.28.8",
     "zod": "^4.1.13",
-    "@kysera/repository": "0.7.2"
+    "@kysera/repository": "0.7.4",
+    "@kysera/executor": "0.7.4"
   },
   "peerDependenciesMeta": {
     "zod": {
@@ -63,6 +64,6 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src test --ext .ts"
+    "lint": "eslint src"
   }
 }