litedbmodel 1.0.1 → 1.1.0

package/docs/api/classes/LimitExceededError.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/classes/Middleware.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/classes/SqlRaw.md

@@ -0,0 +1,53 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / SqlRaw
+
+# Class: SqlRaw
+
+Defined in: SqlFragment.ts:59
+
+Raw SQL string that bypasses parameterization.
+Created via `sql.raw()`. Only usable inside `sql` tagged templates.
+
+## Constructors
+
+### Constructor
+
+```ts
+new SqlRaw(value: string): SqlRaw;
+```
+
+Defined in: SqlFragment.ts:61
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `string` |
+
+#### Returns
+
+`SqlRaw`
+
+## Properties
+
+| Property | Modifier | Type | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="_tag"></a> `_tag` | `readonly` | `"SqlRaw"` | SqlFragment.ts:60 |
+| <a id="value"></a> `value` | `readonly` | `string` | SqlFragment.ts:61 |
+
+## Methods
+
+### toString()
+
+```ts
+toString(): string;
+```
+
+Defined in: SqlFragment.ts:62
+
+#### Returns
+
+`string`

package/docs/api/classes/SqlRef.md

@@ -0,0 +1,59 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / SqlRef
+
+# Class: SqlRef
+
+Defined in: SqlFragment.ts:71
+
+Table-qualified column reference (e.g., `users.id`).
+Created via `sql.ref()`. Only usable inside `sql` tagged templates.
+
+## Constructors
+
+### Constructor
+
+```ts
+new SqlRef(column: {
+  tableName: string;
+  columnName: string;
+}): SqlRef;
+```
+
+Defined in: SqlFragment.ts:76
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `column` | \{ `tableName`: `string`; `columnName`: `string`; \} |
+| `column.tableName` | `string` |
+| `column.columnName` | `string` |
+
+#### Returns
+
+`SqlRef`
+
+## Properties
+
+| Property | Modifier | Type | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="_tag"></a> `_tag` | `readonly` | `"SqlRef"` | SqlFragment.ts:72 |
+| <a id="tablename"></a> `tableName` | `readonly` | `string` | SqlFragment.ts:73 |
+| <a id="columnname"></a> `columnName` | `readonly` | `string` | SqlFragment.ts:74 |
+
+## Methods
+
+### toString()
+
+```ts
+toString(): string;
+```
+
+Defined in: SqlFragment.ts:81
+
+#### Returns
+
+`string`

package/docs/api/classes/Values.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -6,7 +6,7 @@
 
 # Class: Values\<Model\>
 
-Defined in: Column.ts:565
+Defined in: Column.ts:566
 
 Type-safe builder for update/create value pairs.
 Use array literals for static values, builder for dynamic construction.
@@ -48,7 +48,7 @@ await User.create(values.build());
 new Values<Model>(initial?: readonly readonly [Column<any, Model>, unknown][]): Values<Model>;
 ```
 
-Defined in: Column.ts:571
+Defined in: Column.ts:572
 
 Create a Values builder, optionally with initial pairs.
 
@@ -72,7 +72,7 @@ Create a Values builder, optionally with initial pairs.
 get length(): number;
 ```
 
-Defined in: Column.ts:595
+Defined in: Column.ts:596
 
 Get the number of pairs.
 
@@ -88,7 +88,7 @@ Get the number of pairs.
 add<V>(column: Column<V, Model>, value: V | null | undefined): this;
 ```
 
-Defined in: Column.ts:580
+Defined in: Column.ts:581
 
 Add a type-safe column-value pair.
 
@@ -117,7 +117,7 @@ Add a type-safe column-value pair.
 build(): readonly readonly [Column<any, any>, unknown][];
 ```
 
-Defined in: Column.ts:588
+Defined in: Column.ts:589
 
 Build the final array for use with update/create.
 

package/docs/api/classes/WriteInReadOnlyContextError.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/classes/WriteOutsideTransactionError.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/belongsTo.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function belongsTo(keys: KeysFactory, options?: RelationDecoratorOptions): PropertyDecorator;
 ```
 
-Defined in: decorators.ts:687
+Defined in: decorators.ts:830
 
 BelongsTo relation decorator (N:1).
 Defines a many-to-one relationship where this model belongs to a parent record.

package/docs/api/functions/closeAllPools.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/condsToRecord.md

@@ -0,0 +1,23 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / condsToRecord
+
+# Function: condsToRecord()
+
+```ts
+function condsToRecord(conditions: Conds): Record<string, unknown>;
+```
+
+Defined in: Column.ts:1006
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `conditions` | `Conds` |
+
+## Returns
+
+`Record`\<`string`, `unknown`\>

package/docs/api/functions/createMiddleware.md

@@ -0,0 +1,68 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / createMiddleware
+
+# Function: createMiddleware()
+
+```ts
+function createMiddleware<S>(config: MiddlewareConfig<S>): CreatedMiddlewareClass<S>;
+```
+
+Defined in: Middleware.ts:482
+
+Create a middleware class from a configuration object.
+
+This is a simpler alternative to extending the Middleware class directly.
+Each request gets its own copy of the state object via AsyncLocalStorage.
+
+## Type Parameters
+
+| Type Parameter | Default type |
+| ------ | ------ |
+| `S` *extends* `object` | `Record`\<`string`, `never`\> |
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `config` | [`MiddlewareConfig`](../interfaces/MiddlewareConfig.md)\<`S`\> | Middleware configuration with state and hook functions |
+
+## Returns
+
+[`CreatedMiddlewareClass`](../interfaces/CreatedMiddlewareClass.md)\<`S`\>
+
+A middleware class that can be passed to DBModel.use()
+
+## Example
+
+```typescript
+// Simple logger (no state)
+const LoggerMiddleware = createMiddleware({
+  execute: async function(next, sql, params) {
+    console.log('SQL:', sql);
+    return next(sql, params);
+  }
+});
+
+// With per-request state
+const TenantMiddleware = createMiddleware({
+  state: { tenantId: 0 },
+  
+  // Hook signature: (model, next, ...args) for method-level hooks
+  find: async function(model, next, conditions, options) {
+    // `this` is typed as { tenantId: number }
+    if (model.tenant_id) {
+      conditions = [[model.tenant_id, this.tenantId], ...conditions];
+    }
+    return next(conditions, options);
+  }
+});
+
+// Register and use
+DBModel.use(TenantMiddleware);
+
+// Set tenant for current request
+TenantMiddleware.getCurrentContext().tenantId = 123;
+```

package/docs/api/functions/createPostgresDriver.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function createPostgresDriver(options: DBDriverOptions): PostgresDriver;
 ```
 
-Defined in: drivers/postgres.ts:236
+Defined in: drivers/postgres.ts:291
 
 Create a PostgreSQL driver instance
 

package/docs/api/functions/createSqliteDriver.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbCast.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbCastIn.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbDynamic.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbFalse.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbImmediate.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbIn.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbNotNull.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbNow.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbNull.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbRaw.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbTrue.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbUuid.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/dbUuidIn.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/getDBConfig.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/getDBHandler.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/getTransactionConnection.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function getTransactionConnection(): DBConnection | undefined;
 ```
 
-Defined in: DBModel.ts:45
+Defined in: DBModel.ts:48
 
 Get current transaction connection (if in a transaction)
 

package/docs/api/functions/getTransactionContext.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function getTransactionContext(): TransactionContext | undefined;
 ```
 
-Defined in: DBModel.ts:38
+Defined in: DBModel.ts:41
 
 Get current transaction context (if in a transaction)
 

package/docs/api/functions/hasMany.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function hasMany(keys: KeysFactory, options?: RelationDecoratorOptions): PropertyDecorator;
 ```
 
-Defined in: decorators.ts:655
+Defined in: decorators.ts:798
 
 HasMany relation decorator (1:N).
 Defines a one-to-many relationship where this model has many related records.

package/docs/api/functions/hasOne.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 function hasOne(keys: KeysFactory, options?: RelationDecoratorOptions): PropertyDecorator;
 ```
 
-Defined in: decorators.ts:719
+Defined in: decorators.ts:862
 
 HasOne relation decorator (1:1).
 Defines a one-to-one relationship where this model has one related record.

package/docs/api/functions/initDBHandler.md

@@ -1,4 +1,4 @@
-[**litedbmodel v0.20.1**](../README.md)
+[**litedbmodel v1.0.1**](../README.md)
 
 ***
 

package/docs/api/functions/isAnySqlFragment.md

@@ -0,0 +1,25 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / isAnySqlFragment
+
+# Function: isAnySqlFragment()
+
+```ts
+function isAnySqlFragment(value: unknown): value is SqlFragment | SqlTypedFragment<unknown, unknown> | SqlCondition<unknown>;
+```
+
+Defined in: SqlFragment.ts:148
+
+Matches any of SqlFragment, SqlTypedFragment, or SqlCondition.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `unknown` |
+
+## Returns
+
+value is SqlFragment \| SqlTypedFragment\<unknown, unknown\> \| SqlCondition\<unknown\>

package/docs/api/functions/isSqlCondition.md

@@ -0,0 +1,23 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / isSqlCondition
+
+# Function: isSqlCondition()
+
+```ts
+function isSqlCondition(value: unknown): value is SqlCondition<unknown>;
+```
+
+Defined in: SqlFragment.ts:136
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `unknown` |
+
+## Returns
+
+`value is SqlCondition<unknown>`

package/docs/api/functions/isSqlFragment.md

@@ -0,0 +1,23 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / isSqlFragment
+
+# Function: isSqlFragment()
+
+```ts
+function isSqlFragment(value: unknown): value is SqlFragment;
+```
+
+Defined in: SqlFragment.ts:118
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `unknown` |
+
+## Returns
+
+`value is SqlFragment`

package/docs/api/functions/isSqlRaw.md

@@ -0,0 +1,23 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / isSqlRaw
+
+# Function: isSqlRaw()
+
+```ts
+function isSqlRaw(value: unknown): value is SqlRaw;
+```
+
+Defined in: SqlFragment.ts:154
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `unknown` |
+
+## Returns
+
+`value is SqlRaw`

package/docs/api/functions/isSqlRef.md

@@ -0,0 +1,23 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / isSqlRef
+
+# Function: isSqlRef()
+
+```ts
+function isSqlRef(value: unknown): value is SqlRef;
+```
+
+Defined in: SqlFragment.ts:158
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `unknown` |
+
+## Returns
+
+`value is SqlRef`

package/docs/api/functions/isSqlTypedFragment.md

@@ -0,0 +1,23 @@
+[**litedbmodel v1.0.1**](../README.md)
+
+***
+
+[litedbmodel](../globals.md) / isSqlTypedFragment
+
+# Function: isSqlTypedFragment()
+
+```ts
+function isSqlTypedFragment(value: unknown): value is SqlTypedFragment<unknown, unknown>;
+```
+
+Defined in: SqlFragment.ts:127
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `unknown` |
+
+## Returns
+
+`value is SqlTypedFragment<unknown, unknown>`