@nest-native/drizzle 0.3.2 → 0.5.0

package/dist/errors/drizzle-error.mapper.d.ts

@@ -2,9 +2,57 @@ export interface DrizzleErrorMappingOptions {
     uniqueMessage?: string;
     foreignKeyMessage?: string;
     notNullMessage?: string;
+    checkMessage?: string;
     fallbackMessage?: string;
 }
+/** The constraint families this package recognises across all supported drivers. */
+export declare const DRIZZLE_VIOLATION_KINDS: readonly ["unique", "foreignKey", "notNull", "check"];
+export type DrizzleViolationKind = (typeof DRIZZLE_VIOLATION_KINDS)[number];
+/**
+ * What a failed write actually said, normalised across drivers.
+ *
+ * Drizzle wraps driver errors (`DrizzleQueryError`) and the useful parts —
+ * SQLSTATE, the constraint name, the offending column — end up nested on
+ * `cause` in a driver-specific shape. This is that information, flattened, so a
+ * caller can build a field-level response without re-parsing the driver error.
+ *
+ * Everything except `kind` is **best-effort**: drivers disagree about what they
+ * report, so `table`/`constraint`/`column` are populated when the driver
+ * volunteers them and left `undefined` otherwise. Never branch on their
+ * presence for correctness — branch on `kind`.
+ */
+export interface DrizzleViolation {
+    kind: DrizzleViolationKind;
+    /** The raw driver code that identified it (`'23505'`, `'ER_DUP_ENTRY'`, …). */
+    code: string;
+    table?: string;
+    constraint?: string;
+    /**
+     * The offending column, when the driver names it. `pg` does not, so this is
+     * typically only present on MySQL/SQLite; deriving it from the constraint
+     * name is deliberately NOT attempted (see the note in `readColumn`).
+     */
+    column?: string;
+    /** The driver's own detail line, when it has one. */
+    detail?: string;
+}
+/**
+ * Maps a Drizzle/driver error to the Nest exception that fits it, or returns
+ * the error unchanged when it is not a constraint violation.
+ *
+ * This is opt-in by design — the package never installs global error mapping
+ * for you. Call it in a `catch`, or register {@link DrizzleExceptionFilter} if
+ * you would rather stop writing `catch` blocks.
+ */
 export declare function mapDrizzleError(error: unknown, options?: DrizzleErrorMappingOptions): Error;
+/**
+ * The structured view of a constraint violation, or `undefined` when the error
+ * is not one. Use it when the Nest exception alone is not enough — building a
+ * `{ field: message }` response, deciding which retry to attempt, or logging
+ * the constraint that actually fired.
+ */
+export declare function describeDrizzleError(error: unknown): DrizzleViolation | undefined;
 export declare function isUniqueConstraintError(error: unknown): boolean;
 export declare function isForeignKeyConstraintError(error: unknown): boolean;
 export declare function isNotNullConstraintError(error: unknown): boolean;
+export declare function isCheckConstraintError(error: unknown): boolean;

package/dist/errors/drizzle-error.mapper.js

@@ -1,52 +1,126 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DRIZZLE_VIOLATION_KINDS = void 0;
 exports.mapDrizzleError = mapDrizzleError;
+exports.describeDrizzleError = describeDrizzleError;
 exports.isUniqueConstraintError = isUniqueConstraintError;
 exports.isForeignKeyConstraintError = isForeignKeyConstraintError;
 exports.isNotNullConstraintError = isNotNullConstraintError;
+exports.isCheckConstraintError = isCheckConstraintError;
 const common_1 = require("@nestjs/common");
+/** The constraint families this package recognises across all supported drivers. */
+exports.DRIZZLE_VIOLATION_KINDS = [
+    'unique',
+    'foreignKey',
+    'notNull',
+    'check',
+];
+const CODES = {
+    unique: ['23505', 'ER_DUP_ENTRY', '1062', 'SQLITE_CONSTRAINT_UNIQUE', 'SQLITE_CONSTRAINT_PRIMARYKEY'],
+    foreignKey: ['23503', 'ER_NO_REFERENCED_ROW_2', '1452', 'SQLITE_CONSTRAINT_FOREIGNKEY'],
+    notNull: ['23502', 'ER_BAD_NULL_ERROR', '1048', 'SQLITE_CONSTRAINT_NOTNULL'],
+    check: ['23514', 'ER_CHECK_CONSTRAINT_VIOLATED', '3819', 'SQLITE_CONSTRAINT_CHECK'],
+};
+/**
+ * Maps a Drizzle/driver error to the Nest exception that fits it, or returns
+ * the error unchanged when it is not a constraint violation.
+ *
+ * This is opt-in by design — the package never installs global error mapping
+ * for you. Call it in a `catch`, or register {@link DrizzleExceptionFilter} if
+ * you would rather stop writing `catch` blocks.
+ */
 function mapDrizzleError(error, options = {}) {
-    if (isUniqueConstraintError(error)) {
+    const violation = describeDrizzleError(error);
+    if (violation?.kind === 'unique') {
         return new common_1.ConflictException(options.uniqueMessage ?? 'Resource already exists.');
     }
-    if (isForeignKeyConstraintError(error)) {
+    if (violation?.kind === 'foreignKey') {
         return new common_1.BadRequestException(options.foreignKeyMessage ?? 'Related resource does not exist.');
     }
-    if (isNotNullConstraintError(error)) {
+    if (violation?.kind === 'notNull') {
         return new common_1.BadRequestException(options.notNullMessage ?? 'Required value is missing.');
     }
+    if (violation?.kind === 'check') {
+        return new common_1.BadRequestException(options.checkMessage ?? 'Value violates a database constraint.');
+    }
     return error instanceof Error
         ? error
         : new common_1.InternalServerErrorException(options.fallbackMessage ?? 'Database operation failed.');
 }
+/**
+ * The structured view of a constraint violation, or `undefined` when the error
+ * is not one. Use it when the Nest exception alone is not enough — building a
+ * `{ field: message }` response, deciding which retry to attempt, or logging
+ * the constraint that actually fired.
+ */
+function describeDrizzleError(error) {
+    const chain = collectErrorChain(error);
+    for (const kind of exports.DRIZZLE_VIOLATION_KINDS) {
+        const match = chain.find((link) => link.codes.some((code) => CODES[kind].includes(code)));
+        if (match) {
+            return {
+                kind,
+                code: match.codes[0],
+                ...pickDefined('table', readString(match.source, ['table', 'table_name'])),
+                ...pickDefined('constraint', readString(match.source, ['constraint', 'constraint_name'])),
+                ...pickDefined('column', readColumn(match.source)),
+                ...pickDefined('detail', readString(match.source, ['detail', 'sqlMessage'])),
+            };
+        }
+    }
+    return undefined;
+}
 function isUniqueConstraintError(error) {
-    return errorHasAnyCode(error, ['23505', 'ER_DUP_ENTRY', 'SQLITE_CONSTRAINT_UNIQUE']);
+    return describeDrizzleError(error)?.kind === 'unique';
 }
 function isForeignKeyConstraintError(error) {
-    return errorHasAnyCode(error, ['23503', 'ER_NO_REFERENCED_ROW_2', 'SQLITE_CONSTRAINT_FOREIGNKEY']);
+    return describeDrizzleError(error)?.kind === 'foreignKey';
 }
 function isNotNullConstraintError(error) {
-    return errorHasAnyCode(error, ['23502', 'ER_BAD_NULL_ERROR', 'SQLITE_CONSTRAINT_NOTNULL']);
+    return describeDrizzleError(error)?.kind === 'notNull';
 }
-function errorHasAnyCode(error, expectedCodes) {
-    const codes = collectErrorCodes(error);
-    return codes.some(code => expectedCodes.includes(code));
+function isCheckConstraintError(error) {
+    return describeDrizzleError(error)?.kind === 'check';
 }
-function collectErrorCodes(error) {
+/**
+ * Every error in the `cause` chain that carries an identifying code, nearest
+ * first. Walking the chain matters because Drizzle wraps driver errors: the
+ * SQLSTATE lives on `error.cause`, and adapters sometimes wrap once more.
+ */
+function collectErrorChain(error) {
     if (typeof error !== 'object' || error === null) {
         return [];
     }
-    const maybeError = error;
-    const currentCodes = [
-        maybeError.code,
-        maybeError.errno,
-        maybeError.extendedCode,
-    ]
+    const source = error;
+    const codes = [source.code, source.errno, source.extendedCode]
         .filter((code) => typeof code === 'string' || typeof code === 'number')
-        .map(code => String(code));
-    return [
-        ...currentCodes,
-        ...collectErrorCodes(maybeError.cause),
-    ];
+        .map(String);
+    const here = codes.length > 0 ? [{ source, codes }] : [];
+    return [...here, ...collectErrorChain(source.cause)];
+}
+/**
+ * The offending column, only when the driver actually names it.
+ *
+ * Deliberately does NOT infer the column from the constraint name: that only
+ * works for drizzle-kit's generated naming and is silently wrong on
+ * hand-written migrations, renamed constraints, legacy schemas, and composite
+ * or expression indexes. A wrong field name in a validation response is worse
+ * than no field name.
+ */
+function readColumn(source) {
+    return readString(source, ['column', 'column_name']);
+}
+function readString(source, keys) {
+    for (const key of keys) {
+        const value = source[key];
+        if (typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/** Keeps optional keys absent rather than explicitly `undefined`. */
+function pickDefined(key, value) {
+    return value === undefined ? {} : { [key]: value };
 }
 //# sourceMappingURL=drizzle-error.mapper.js.map

package/dist/errors/drizzle-error.mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"drizzle-error.mapper.js","sourceRoot":"","sources":["../../errors/drizzle-error.mapper.ts"],"names":[],"mappings":";;AAaA,0CA2BC;AAED,0DAEC;AAED,kEAEC;AAED,4DAEC;AApDD,2CAIwB;AASxB,SAAgB,eAAe,CAC7B,KAAc,EACd,UAAsC,EAAE;IAExC,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,0BAAiB,CAC1B,OAAO,CAAC,aAAa,IAAI,0BAA0B,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,4BAAmB,CAC5B,OAAO,CAAC,iBAAiB,IAAI,kCAAkC,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,4BAAmB,CAC5B,OAAO,CAAC,cAAc,IAAI,4BAA4B,CACvD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,YAAY,KAAK;QAC3B,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,qCAA4B,CAChC,OAAO,CAAC,eAAe,IAAI,4BAA4B,CACxD,CAAC;AACN,CAAC;AAED,SAAgB,uBAAuB,CAAC,KAAc;IACpD,OAAO,eAAe,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,0BAA0B,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,SAAgB,2BAA2B,CAAC,KAAc;IACxD,OAAO,eAAe,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,SAAgB,wBAAwB,CAAC,KAAc;IACrD,OAAO,eAAe,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,aAAuB;IAC9D,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,KAAgC,CAAC;IACpD,MAAM,YAAY,GAAG;QACnB,UAAU,CAAC,IAAI;QACf,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,YAAY;KACxB;SACE,MAAM,CAAC,CAAC,IAAI,EAA2B,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC;SAC/F,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7B,OAAO;QACL,GAAG,YAAY;QACf,GAAG,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC;KACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"drizzle-error.mapper.js","sourceRoot":"","sources":["../../errors/drizzle-error.mapper.ts"],"names":[],"mappings":"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"}

package/dist/errors/drizzle-exception.filter.d.ts

@@ -0,0 +1,29 @@
+import { type ArgumentsHost, type ExceptionFilter } from '@nestjs/common';
+import { BaseExceptionFilter } from '@nestjs/core';
+import { type DrizzleErrorMappingOptions } from './drizzle-error.mapper';
+/**
+ * Turns database constraint violations into the HTTP responses they deserve,
+ * so services stop wrapping every write in `try { … } catch { mapDrizzleError }`.
+ *
+ * **Opt-in, never automatic** — the package does not register it for you (the
+ * project constitution: error mapping is offered, not imposed). Register it
+ * where you want it:
+ *
+ * ```ts
+ * // one controller
+ * @UseFilters(new DrizzleExceptionFilter())
+ *
+ * // or app-wide, in main.ts — needs the HTTP adapter, since anything that is
+ * // NOT a constraint violation is delegated to Nest's own handling
+ * app.useGlobalFilters(new DrizzleExceptionFilter(app.get(HttpAdapterHost).httpAdapter));
+ * ```
+ *
+ * It only claims errors {@link describeDrizzleError} recognises; everything
+ * else falls through to `BaseExceptionFilter` exactly as if this filter were
+ * not installed, so adding it cannot change how your other errors behave.
+ */
+export declare class DrizzleExceptionFilter extends BaseExceptionFilter implements ExceptionFilter {
+    private readonly options;
+    constructor(applicationRef?: ConstructorParameters<typeof BaseExceptionFilter>[0], options?: DrizzleErrorMappingOptions);
+    catch(exception: unknown, host: ArgumentsHost): void;
+}

package/dist/errors/drizzle-exception.filter.js

@@ -0,0 +1,56 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const drizzle_error_mapper_1 = require("./drizzle-error.mapper");
+/**
+ * Turns database constraint violations into the HTTP responses they deserve,
+ * so services stop wrapping every write in `try { … } catch { mapDrizzleError }`.
+ *
+ * **Opt-in, never automatic** — the package does not register it for you (the
+ * project constitution: error mapping is offered, not imposed). Register it
+ * where you want it:
+ *
+ * ```ts
+ * // one controller
+ * @UseFilters(new DrizzleExceptionFilter())
+ *
+ * // or app-wide, in main.ts — needs the HTTP adapter, since anything that is
+ * // NOT a constraint violation is delegated to Nest's own handling
+ * app.useGlobalFilters(new DrizzleExceptionFilter(app.get(HttpAdapterHost).httpAdapter));
+ * ```
+ *
+ * It only claims errors {@link describeDrizzleError} recognises; everything
+ * else falls through to `BaseExceptionFilter` exactly as if this filter were
+ * not installed, so adding it cannot change how your other errors behave.
+ */
+let DrizzleExceptionFilter = class DrizzleExceptionFilter extends core_1.BaseExceptionFilter {
+    constructor(applicationRef, options = {}) {
+        super(applicationRef);
+        this.options = options;
+    }
+    catch(exception, host) {
+        if ((0, drizzle_error_mapper_1.describeDrizzleError)(exception) === undefined) {
+            // Not ours — let Nest handle it unchanged.
+            super.catch(exception, host);
+            return;
+        }
+        super.catch((0, drizzle_error_mapper_1.mapDrizzleError)(exception, this.options), host);
+    }
+};
+exports.DrizzleExceptionFilter = DrizzleExceptionFilter;
+exports.DrizzleExceptionFilter = DrizzleExceptionFilter = __decorate([
+    (0, common_1.Catch)(),
+    __metadata("design:paramtypes", [Object, Object])
+], DrizzleExceptionFilter);
+//# sourceMappingURL=drizzle-exception.filter.js.map

package/dist/errors/drizzle-exception.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-exception.filter.js","sourceRoot":"","sources":["../../errors/drizzle-exception.filter.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAiF;AACjF,uCAAmD;AACnD,iEAIgC;AAEhC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBACX,SAAQ,0BAAmB;IAI3B,YACE,cAAqE,EACrE,UAAsC,EAAE;QAExC,KAAK,CAAC,cAAc,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,SAAkB,EAAE,IAAmB;QAC3C,IAAI,IAAA,2CAAoB,EAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;YAClD,2CAA2C;YAC3C,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,IAAA,sCAAe,EAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;CACF,CAAA;AAtBY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,cAAK,GAAE;;GACK,sBAAsB,CAsBlC"}

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './decorators/inject-transaction.decorator';
 export * from './decorators/transactional.decorator';
 export * from './drizzle.module';
 export * from './errors/drizzle-error.mapper';
+export * from './errors/drizzle-exception.filter';
 export * from './interfaces';
 export * from './testing/drizzle-test.module';
 export * from './testing/mock-client';

package/dist/index.js

@@ -22,6 +22,7 @@ __exportStar(require("./decorators/inject-transaction.decorator"), exports);
 __exportStar(require("./decorators/transactional.decorator"), exports);
 __exportStar(require("./drizzle.module"), exports);
 __exportStar(require("./errors/drizzle-error.mapper"), exports);
+__exportStar(require("./errors/drizzle-exception.filter"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./testing/drizzle-test.module"), exports);
 __exportStar(require("./testing/mock-client"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sEAAoD;AACpD,8CAA4B;AAC5B,4EAA0D;AAC1D,wEAAsD;AACtD,4EAA0D;AAC1D,uEAAqD;AACrD,mDAAiC;AACjC,gEAA8C;AAC9C,+CAA6B;AAC7B,gEAA8C;AAC9C,wDAAsC;AACtC,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sEAAoD;AACpD,8CAA4B;AAC5B,4EAA0D;AAC1D,wEAAsD;AACtD,4EAA0D;AAC1D,uEAAqD;AACrD,mDAAiC;AACjC,gEAA8C;AAC9C,oEAAkD;AAClD,+CAA6B;AAC7B,gEAA8C;AAC9C,wDAAsC;AACtC,2CAAyB"}

package/dist/tokens.js

@@ -8,10 +8,11 @@ exports.getDrizzleSchemaToken = getDrizzleSchemaToken;
 exports.getDrizzleTransactionToken = getDrizzleTransactionToken;
 const constants_1 = require("./constants");
 function normalizeDrizzleConnectionName(connectionName) {
-    const normalized = connectionName?.trim();
-    return normalized && normalized.length > 0
-        ? normalized
-        : constants_1.DEFAULT_DRIZZLE_CONNECTION_NAME;
+    // A non-empty trimmed string is truthy and an empty one is falsy, so `||`
+    // covers undefined, empty, and whitespace-only names in one step — an
+    // explicit `.length > 0` check would be an unreachable (equivalent-mutant)
+    // branch on top of that.
+    return connectionName?.trim() || constants_1.DEFAULT_DRIZZLE_CONNECTION_NAME;
 }
 function getDrizzleClientToken(connectionName) {
     return buildDrizzleToken(constants_1.DRIZZLE_CLIENT, connectionName);

package/dist/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../tokens.ts"],"names":[],"mappings":";;AASA,wEAKC;AAED,sDAEC;AAED,4EAEC;AAED,wDAEC;AAED,sDAEC;AAED,gEAEC;AAlCD,2CAOqB;AAErB,SAAgB,8BAA8B,CAAC,cAAuB;IACpE,MAAM,UAAU,GAAG,cAAc,EAAE,IAAI,EAAE,CAAC;IAC1C,OAAO,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QACxC,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,2CAA+B,CAAC;AACtC,CAAC;AAED,SAAgB,qBAAqB,CAAC,cAAuB;IAC3D,OAAO,iBAAiB,CAAC,0BAAc,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,gCAAgC,CAAC,cAAuB;IACtE,OAAO,iBAAiB,CAAC,sCAA0B,EAAE,cAAc,CAAC,CAAC;AACvE,CAAC;AAED,SAAgB,sBAAsB,CAAC,cAAuB;IAC5D,OAAO,iBAAiB,CAAC,kCAAsB,EAAE,cAAc,CAAC,CAAC;AACnE,CAAC;AAED,SAAgB,qBAAqB,CAAC,cAAuB;IAC3D,OAAO,iBAAiB,CAAC,0BAAc,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,0BAA0B,CAAC,cAAuB;IAChE,OAAO,iBAAiB,CAAC,+BAAmB,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc,EAAE,cAAuB;IAChE,MAAM,UAAU,GAAG,8BAA8B,CAAC,cAAc,CAAC,CAAC;IAClE,OAAO,UAAU,KAAK,2CAA+B;QACnD,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;AAChC,CAAC"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../tokens.ts"],"names":[],"mappings":";;AASA,wEAMC;AAED,sDAEC;AAED,4EAEC;AAED,wDAEC;AAED,sDAEC;AAED,gEAEC;AAnCD,2CAOqB;AAErB,SAAgB,8BAA8B,CAAC,cAAuB;IACpE,0EAA0E;IAC1E,sEAAsE;IACtE,2EAA2E;IAC3E,yBAAyB;IACzB,OAAO,cAAc,EAAE,IAAI,EAAE,IAAI,2CAA+B,CAAC;AACnE,CAAC;AAED,SAAgB,qBAAqB,CAAC,cAAuB;IAC3D,OAAO,iBAAiB,CAAC,0BAAc,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,gCAAgC,CAAC,cAAuB;IACtE,OAAO,iBAAiB,CAAC,sCAA0B,EAAE,cAAc,CAAC,CAAC;AACvE,CAAC;AAED,SAAgB,sBAAsB,CAAC,cAAuB;IAC5D,OAAO,iBAAiB,CAAC,kCAAsB,EAAE,cAAc,CAAC,CAAC;AACnE,CAAC;AAED,SAAgB,qBAAqB,CAAC,cAAuB;IAC3D,OAAO,iBAAiB,CAAC,0BAAc,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,0BAA0B,CAAC,cAAuB;IAChE,OAAO,iBAAiB,CAAC,+BAAmB,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc,EAAE,cAAuB;IAChE,MAAM,UAAU,GAAG,8BAA8B,CAAC,cAAc,CAAC,CAAC;IAClE,OAAO,UAAU,KAAK,2CAA+B;QACnD,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;AAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nest-native/drizzle",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "Nest-native Drizzle ORM integration with DI, repositories, and transaction decorators",
   "keywords": [
     "nestjs",
@@ -43,7 +43,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "scripts": {
     "clean": "rimraf dist tsconfig.tsbuildinfo",
@@ -53,12 +53,12 @@
   "peerDependencies": {
     "@libsql/client": "*",
     "@nestjs-cls/transactional": "*",
-    "@nestjs/common": "^11.0.0",
-    "@nestjs/core": "^11.0.0",
-    "@nestjs/swagger": "^11.4.4",
+    "@nestjs/common": "^11.0.0 || ^12.0.0",
+    "@nestjs/core": "^11.0.0 || ^12.0.0",
+    "@nestjs/swagger": "^11.4.7 || ^12.0.0",
     "better-sqlite3": "*",
     "class-validator": "^0.15.1",
-    "drizzle-orm": ">=0.30.0 <2.0.0",
+    "drizzle-orm": ">=0.30.0 <2.0.0 || >=1.0.0-rc.1 <2.0.0",
     "drizzle-zod": "*",
     "mysql2": "*",
     "pg": "*",
@@ -92,8 +92,8 @@
     }
   },
   "devDependencies": {
-    "@nestjs/common": "^11.1.26",
-    "@nestjs/core": "^11.1.26",
+    "@nestjs/common": "^11.2.1",
+    "@nestjs/core": "^11.2.1",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.1",
     "typescript": "^6.0.3"