@gennext/lb-infra 0.1.0 → 0.1.3

package/dist/utilities/model.utility.js

@@ -1,41 +1,60 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIdType = exports.getIdSchema = void 0;
-const metadata_1 = require("@loopback/metadata");
-const rest_1 = require("@loopback/rest");
-/**
- * Extracts the JSON schema of the ID property from a LoopBack entity
- * @param entity - The LoopBack entity class (must extend BaseEntity)
- * @returns The SchemaObject representing the ID property
- * @example
- * const schema = getIdSchema(User);
- * // { type: 'number', minimum: 1 }
- */
-const getIdSchema = (entity) => {
-    const idProp = entity.getIdProperties()[0];
-    const modelSchema = (0, rest_1.jsonToSchemaObject)((0, rest_1.getJsonSchema)(entity));
-    return modelSchema.properties?.[idProp];
+exports.buildPaginationResponse = exports.buildArrayResponse = exports.buildResponse = exports.buildRequestBody = void 0;
+const lb_rest_1 = require("@gennext/lb-infra/lb-rest");
+const buildModelSchema = (model, options = {}) => (0, lb_rest_1.getModelSchemaRef)(model, {
+    title: options.title,
+    exclude: options.exclude,
+    partial: options.partial,
+    optional: options.optional,
+    includeRelations: options.includeRelations,
+});
+const buildArraySchema = (items) => ({
+    type: 'array',
+    items,
+});
+const buildRequestBody = (model, options = {}) => {
+    const { title = `${model.name} - Request body`, exclude = ['id'], required: isRequired = false, isConvertToArray = false, } = options;
+    const schema = isConvertToArray
+        ? buildArraySchema(buildModelSchema(model, { title, exclude }))
+        : buildModelSchema(model, { title, exclude });
+    return {
+        required: isRequired,
+        content: {
+            'application/json': { schema },
+        },
+    };
 };
-exports.getIdSchema = getIdSchema;
-/**
- * Inspects the metadata of a LoopBack entity to determine the ID type
- * @param entity - The LoopBack entity class
- * @returns 'string' or 'number' (default: 'number')
- * @example
- * const type = getIdType(User); // 'number'
- */
-const getIdType = (entity) => {
-    let idType = 'number';
-    try {
-        const idMetadata = metadata_1.MetadataInspector.getPropertyMetadata('loopback:model-properties', entity, 'id');
-        idType = idMetadata?.type ?? 'number';
-    }
-    catch (e) {
-        console.error("[getIdType] Failed to inspect entity id type! Use 'number' by default | Error: ", e);
-        idType = 'number';
-        return idType;
-    }
-    return idType;
-};
-exports.getIdType = getIdType;
+exports.buildRequestBody = buildRequestBody;
+const buildResponse = (model, options = {}) => buildModelSchema(model, {
+    title: options.title ?? `${model.name} - Response`,
+    ...options,
+});
+exports.buildResponse = buildResponse;
+const buildArrayResponse = (model, options = {}) => ({
+    title: options.title ?? `${model.name} - List response`,
+    type: 'array',
+    items: buildModelSchema(model, options),
+});
+exports.buildArrayResponse = buildArrayResponse;
+const buildPaginationResponse = (model, options = {}) => ({
+    content: {
+        'application/json': {
+            schema: {
+                title: options.title ?? `${model.name} - Pagination response`,
+                type: 'object',
+                properties: {
+                    count: { type: 'number' },
+                    offset: { type: 'number' },
+                    limit: { type: 'number' },
+                    data: {
+                        type: 'array',
+                        items: buildModelSchema(model, options),
+                    },
+                },
+            },
+        },
+    },
+});
+exports.buildPaginationResponse = buildPaginationResponse;
 //# sourceMappingURL=model.utility.js.map

package/dist/utilities/model.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.utility.js","sourceRoot":"","sources":["../../src/utilities/model.utility.ts"],"names":[],"mappings":";;;AAAA,iDAAuD;AACvD,yCAAiF;AAIjF;;;;;;;GAOG;AACI,MAAM,WAAW,GAAG,CACzB,MAA4C,EAC9B,EAAE;IAChB,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAA,yBAAkB,EAAC,IAAA,oBAAa,EAAC,MAAM,CAAC,CAAiB,CAAC;IAC9E,OAAO,WAAW,CAAC,UAAU,EAAE,CAAC,MAAM,CAAiB,CAAC;AAC1D,CAAC,CAAC;AANW,QAAA,WAAW,eAMtB;AAEF;;;;;;GAMG;AACI,MAAM,SAAS,GAAG,CACvB,MAA8C,EACzB,EAAE;IACvB,IAAI,MAAM,GAAwB,QAAQ,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,4BAAiB,CAAC,mBAAmB,CAErD,2BAA2B,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAE9C,MAAM,GAAG,UAAU,EAAE,IAAI,IAAI,QAAQ,CAAC;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,iFAAiF,EACjF,CAAC,CACF,CAAC;QAEF,MAAM,GAAG,QAAQ,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAtBW,QAAA,SAAS,aAsBpB"}
+{"version":3,"file":"model.utility.js","sourceRoot":"","sources":["../../src/utilities/model.utility.ts"],"names":[],"mappings":";;;AAAA,uDAA+F;AAiB/F,MAAM,gBAAgB,GAAG,CACvB,KAAoB,EACpB,UAA8B,EAAE,EAClB,EAAE,CAChB,IAAA,2BAAiB,EAAC,KAAK,EAAE;IACvB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,OAAO,EAAE,OAAO,CAAC,OAAO;IACxB,OAAO,EAAE,OAAO,CAAC,OAAO;IACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;CAC3C,CAAC,CAAC;AAEL,MAAM,gBAAgB,GAAG,CAAC,KAAmB,EAAgB,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,OAAO;IACb,KAAK;CACN,CAAC,CAAC;AAEI,MAAM,gBAAgB,GAAG,CAC9B,KAAoB,EACpB,UAA+B,EAAE,EACd,EAAE;IACrB,MAAM,EACJ,KAAK,GAAG,GAAG,KAAK,CAAC,IAAI,iBAAiB,EACtC,OAAO,GAAG,CAAC,IAAI,CAAC,EAChB,QAAQ,EAAE,UAAU,GAAG,KAAK,EAC5B,gBAAgB,GAAG,KAAK,GACzB,GAAG,OAAO,CAAC;IAEZ,MAAM,MAAM,GAAG,gBAAgB;QAC7B,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAEhD,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE;YACP,kBAAkB,EAAE,EAAE,MAAM,EAAE;SAC/B;KACF,CAAC;AACJ,CAAC,CAAC;AArBW,QAAA,gBAAgB,oBAqB3B;AAEK,MAAM,aAAa,GAAG,CAC3B,KAAoB,EACpB,UAA8B,EAAE,EAClB,EAAE,CAChB,gBAAgB,CAAC,KAAK,EAAE;IACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,aAAa;IAClD,GAAG,OAAO;CACX,CAAC,CAAC;AAPQ,QAAA,aAAa,iBAOrB;AAEE,MAAM,kBAAkB,GAAG,CAChC,KAAoB,EACpB,UAA8B,EAAE,EAClB,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,kBAAkB;IACvD,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC;CACxC,CAAC,CAAC;AAPU,QAAA,kBAAkB,sBAO5B;AAEI,MAAM,uBAAuB,GAAG,CACrC,KAAoB,EACpB,UAA8B,EAAE,EAChC,EAAE,CAAC,CAAC;IACJ,OAAO,EAAE;QACP,kBAAkB,EAAE;YAClB,MAAM,EAAE;gBACN,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,wBAAwB;gBAC7D,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,IAAI,EAAE;wBACJ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC;qBACxC;iBACF;aACF;SACF;KACF;CACF,CAAC,CAAC;AArBU,QAAA,uBAAuB,2BAqBjC"}

package/dist/validators/base.schema.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+/**
+ * Common validation patterns designed for reuse across the application.
+ * Build domain-specific schemas by composing these primitives.
+ */
+export declare const BaseSchemas: {
+    /** Standard UUID v4 */
+    UUID: z.ZodUUID;
+    /** Flexible ID – accepts UUID string or positive integer */
+    ID: z.ZodUnion<readonly [z.ZodUUID, z.ZodNumber]>;
+    Email: z.ZodEmail;
+    Username: z.ZodString;
+    Password: z.ZodString;
+    PhoneNumber: z.ZodString;
+    URL: z.ZodURL;
+    /** Non-empty, trimmed string */
+    NonEmptyString: z.ZodString;
+    /** Short description / label field */
+    Description: z.ZodOptional<z.ZodString>;
+    Port: z.ZodNumber;
+    PositiveInt: z.ZodNumber;
+    NonNegativeInt: z.ZodNumber;
+    SafeInt: z.ZodNumber;
+    /** ISO-8601 datetime string */
+    UnixTimestamp: z.ZodNumber;
+    Tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    Pagination: z.ZodObject<{
+        page: z.ZodDefault<z.ZodNumber>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+};
+/**
+ * Wraps a shape in a standard auditable entity object.
+ *
+ * @example
+ * const UserSchema = createEntitySchema({ name: z.string() });
+ * type User = z.infer<typeof UserSchema>;
+ */
+export declare const createEntitySchema: <T extends z.ZodRawShape>(shape: T) => z.ZodObject<{
+    id: z.ZodUUID;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    deletedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+} & T extends infer T_1 ? { -readonly [P in keyof T_1]: T_1[P]; } : never, z.core.$strip>;
+/**
+ * Wraps a shape using numeric primary-key convention (mirrors
+ * the {@link TBaseIdEntity} pattern used in lb-infra models).
+ */
+export declare const createNumericEntitySchema: <T extends z.ZodRawShape>(shape: T) => z.ZodObject<{
+    id: z.ZodNumber;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    deletedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+} & T extends infer T_1 ? { -readonly [P in keyof T_1]: T_1[P]; } : never, z.core.$strip>;
+//# sourceMappingURL=base.schema.d.ts.map

package/dist/validators/base.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.schema.d.ts","sourceRoot":"","sources":["../../src/validators/base.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,WAAW;IAEtB,uBAAuB;;IAEvB,4DAA4D;;;;;;;IAkB5D,gCAAgC;;IAEhC,sCAAsC;;;;;;IAUtC,+BAA+B;;;;;;;;CAiBhC,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC;;;;;yFAOhE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC;;;;;yFAOvE,CAAC"}

package/dist/validators/base.schema.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNumericEntitySchema = exports.createEntitySchema = exports.BaseSchemas = void 0;
+const zod_1 = require("zod");
+/**
+ * Common validation patterns designed for reuse across the application.
+ * Build domain-specific schemas by composing these primitives.
+ */
+exports.BaseSchemas = {
+    // ─── Identity ────────────────────────────────────────────────────────────
+    /** Standard UUID v4 */
+    UUID: zod_1.z.uuid('Invalid UUID format'),
+    /** Flexible ID – accepts UUID string or positive integer */
+    ID: zod_1.z.union([
+        zod_1.z.uuid('Invalid UUID format'),
+        zod_1.z.number().int().positive('ID must be a positive integer'),
+    ]),
+    // ─── Strings ─────────────────────────────────────────────────────────────
+    Email: zod_1.z.email('Invalid email format'),
+    Username: zod_1.z
+        .string()
+        .min(3, 'Username must be at least 3 characters')
+        .max(50, 'Username must be at most 50 characters'),
+    Password: zod_1.z
+        .string()
+        .min(8, 'Password must be at least 8 characters')
+        .max(128, 'Password must be at most 128 characters'),
+    PhoneNumber: zod_1.z.string().regex(/^\+?[\d\s\-()\\.]{7,}$/, 'Invalid phone number format'),
+    URL: zod_1.z.url('Invalid URL format'),
+    /** Non-empty, trimmed string */
+    NonEmptyString: zod_1.z.string().trim().min(1, 'Value must not be empty'),
+    /** Short description / label field */
+    Description: zod_1.z.string().max(500, 'Description must be at most 500 characters').optional(),
+    // ─── Numbers ─────────────────────────────────────────────────────────────
+    Port: zod_1.z.number().int().min(1, 'Port must be >= 1').max(65535, 'Port must be <= 65535'),
+    PositiveInt: zod_1.z.number().int().positive('Must be a positive integer'),
+    NonNegativeInt: zod_1.z.number().int().min(0, 'Must be >= 0'),
+    SafeInt: zod_1.z.number().int(),
+    // ─── Dates ───────────────────────────────────────────────────────────────
+    /** ISO-8601 datetime string */
+    UnixTimestamp: zod_1.z.number().int().positive('Unix timestamp must be positive'),
+    // ─── Collections ─────────────────────────────────────────────────────────
+    Tags: zod_1.z.array(zod_1.z.string()).default([]),
+    // ─── Pagination ──────────────────────────────────────────────────────────
+    Pagination: zod_1.z.object({
+        page: zod_1.z.number().int().min(1, 'Page must be >= 1').default(1),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1, 'Limit must be >= 1')
+            .max(1000, 'Limit must be <= 1000')
+            .default(20),
+        offset: zod_1.z.number().int().min(0).optional(),
+    }),
+};
+// ─── Entity Helpers ──────────────────────────────────────────────────────────
+/**
+ * Wraps a shape in a standard auditable entity object.
+ *
+ * @example
+ * const UserSchema = createEntitySchema({ name: z.string() });
+ * type User = z.infer<typeof UserSchema>;
+ */
+const createEntitySchema = (shape) => zod_1.z.object({
+    id: exports.BaseSchemas.UUID,
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+    deletedAt: zod_1.z.date().nullable().optional(),
+    ...shape,
+});
+exports.createEntitySchema = createEntitySchema;
+/**
+ * Wraps a shape using numeric primary-key convention (mirrors
+ * the {@link TBaseIdEntity} pattern used in lb-infra models).
+ */
+const createNumericEntitySchema = (shape) => zod_1.z.object({
+    id: exports.BaseSchemas.PositiveInt,
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+    deletedAt: zod_1.z.date().nullable().optional(),
+    ...shape,
+});
+exports.createNumericEntitySchema = createNumericEntitySchema;
+//# sourceMappingURL=base.schema.js.map

package/dist/validators/base.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.schema.js","sourceRoot":"","sources":["../../src/validators/base.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;GAGG;AACU,QAAA,WAAW,GAAG;IACzB,4EAA4E;IAC5E,uBAAuB;IACvB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;IACnC,4DAA4D;IAC5D,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC;QACV,OAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;QAC7B,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KAC3D,CAAC;IAEF,4EAA4E;IAC5E,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IACtC,QAAQ,EAAE,OAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,wCAAwC,CAAC;SAChD,GAAG,CAAC,EAAE,EAAE,wCAAwC,CAAC;IACpD,QAAQ,EAAE,OAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,wCAAwC,CAAC;SAChD,GAAG,CAAC,GAAG,EAAE,yCAAyC,CAAC;IACtD,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,EAAE,6BAA6B,CAAC;IACtF,GAAG,EAAE,OAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChC,gCAAgC;IAChC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACnE,sCAAsC;IACtC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,4CAA4C,CAAC,CAAC,QAAQ,EAAE;IAEzF,4EAA4E;IAC5E,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACtF,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpE,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC;IACvD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAEzB,4EAA4E;IAC5E,+BAA+B;IAC/B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAE3E,4EAA4E;IAC5E,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAErC,4EAA4E;IAC5E,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,KAAK,EAAE,OAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC;aAC5B,GAAG,CAAC,IAAI,EAAE,uBAAuB,CAAC;aAClC,OAAO,CAAC,EAAE,CAAC;QACd,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC3C,CAAC;CACH,CAAC;AAEF,gFAAgF;AAEhF;;;;;;GAMG;AACI,MAAM,kBAAkB,GAAG,CAA0B,KAAQ,EAAE,EAAE,CACtE,OAAC,CAAC,MAAM,CAAC;IACP,EAAE,EAAE,mBAAW,CAAC,IAAI;IACpB,SAAS,EAAE,OAAC,CAAC,IAAI,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,IAAI,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzC,GAAG,KAAK;CACT,CAAC,CAAC;AAPQ,QAAA,kBAAkB,sBAO1B;AAEL;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAA0B,KAAQ,EAAE,EAAE,CAC7E,OAAC,CAAC,MAAM,CAAC;IACP,EAAE,EAAE,mBAAW,CAAC,WAAW;IAC3B,SAAS,EAAE,OAAC,CAAC,IAAI,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,IAAI,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzC,GAAG,KAAK;CACT,CAAC,CAAC;AAPQ,QAAA,yBAAyB,6BAOjC"}

package/dist/validators/common.schema.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const ListQuerySchema: z.ZodObject<{
+    sortBy: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodEnum<{
+        desc: "desc";
+        asc: "asc";
+    }>>;
+    search: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TListQuery = z.infer<typeof ListQuerySchema>;
+/**
+ * Wraps any Zod schema in the standard API response envelope.
+ *
+ * @example
+ * const UserResponseSchema = ApiResponseSchema(UserEntitySchema);
+ */
+export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    success: z.ZodBoolean;
+    code: z.ZodString;
+    message: z.ZodString;
+    data: z.ZodOptional<T>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const PaginatedResponseSchema: <T extends z.ZodTypeAny>(itemSchema: T) => z.ZodObject<{
+    items: z.ZodArray<T>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    limit: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const DatabaseConfigSchema: z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodString;
+    username: z.ZodString;
+    password: z.ZodString;
+    ssl: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TDatabaseConfig = z.infer<typeof DatabaseConfigSchema>;
+export declare const RedisConfigSchema: z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type TRedisConfig = z.infer<typeof RedisConfigSchema>;
+//# sourceMappingURL=common.schema.d.ts.map

package/dist/validators/common.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.schema.d.ts","sourceRoot":"","sources":["../../src/validators/common.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,eAAe;;;;;;;;;;iBAK1B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIzD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC;;;;;;iBAOnE,CAAC;AAEL,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC;;;;;;iBAOzE,CAAC;AAIL,eAAO,MAAM,oBAAoB;;;;;;;iBAO/B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEnE,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/validators/common.schema.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisConfigSchema = exports.DatabaseConfigSchema = exports.PaginatedResponseSchema = exports.ApiResponseSchema = exports.ListQuerySchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("./base.schema");
+// ─── Pagination & Query ──────────────────────────────────────────────────────
+exports.ListQuerySchema = zod_1.z.object({
+    ...base_schema_1.BaseSchemas.Pagination.shape,
+    sortBy: zod_1.z.string().optional(),
+    sortOrder: zod_1.z.enum(['asc', 'desc']).default('asc'),
+    search: zod_1.z.string().optional(),
+});
+// ─── Generic API Response Wrappers ───────────────────────────────────────────
+/**
+ * Wraps any Zod schema in the standard API response envelope.
+ *
+ * @example
+ * const UserResponseSchema = ApiResponseSchema(UserEntitySchema);
+ */
+const ApiResponseSchema = (dataSchema) => zod_1.z.object({
+    success: zod_1.z.boolean(),
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    data: dataSchema.optional(),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+exports.ApiResponseSchema = ApiResponseSchema;
+const PaginatedResponseSchema = (itemSchema) => zod_1.z.object({
+    items: zod_1.z.array(itemSchema),
+    total: zod_1.z.number().int().min(0),
+    page: zod_1.z.number().int().min(1),
+    limit: zod_1.z.number().int().min(1),
+    hasMore: zod_1.z.boolean(),
+});
+exports.PaginatedResponseSchema = PaginatedResponseSchema;
+// ─── Environment / Config ────────────────────────────────────────────────────
+exports.DatabaseConfigSchema = zod_1.z.object({
+    host: zod_1.z.string().min(1, 'DB host is required'),
+    port: base_schema_1.BaseSchemas.Port.default(5432),
+    database: zod_1.z.string().min(1, 'DB name is required'),
+    username: zod_1.z.string().min(1, 'DB username is required'),
+    password: zod_1.z.string().min(1, 'DB password is required'),
+    ssl: zod_1.z.boolean().default(false),
+});
+exports.RedisConfigSchema = zod_1.z.object({
+    host: zod_1.z.string().min(1, 'Redis host is required'),
+    port: base_schema_1.BaseSchemas.Port.default(6379),
+    password: zod_1.z.string().optional(),
+    db: zod_1.z.number().int().min(0).default(0),
+});
+//# sourceMappingURL=common.schema.js.map

package/dist/validators/common.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.schema.js","sourceRoot":"","sources":["../../src/validators/common.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAA4C;AAE5C,gFAAgF;AAEnE,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,GAAG,yBAAW,CAAC,UAAU,CAAC,KAAK;IAC/B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACjD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAGH,gFAAgF;AAEhF;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAyB,UAAa,EAAE,EAAE,CACzE,OAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAPQ,QAAA,iBAAiB,qBAOzB;AAEE,MAAM,uBAAuB,GAAG,CAAyB,UAAa,EAAE,EAAE,CAC/E,OAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAPQ,QAAA,uBAAuB,2BAO/B;AAEL,gFAAgF;AAEnE,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAC9C,IAAI,EAAE,yBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACpC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAClD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACtD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACtD,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAChC,CAAC,CAAC;AAGU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACjD,IAAI,EAAE,yBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACpC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACvC,CAAC,CAAC"}

package/dist/validators/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module validators
+ *
+ * Zod-based validation layer for @gennext/lb-infra.
+ *
+ * @example
+ * import { safeParse, LoginSchema, BaseSchemas } from '@gennext/lb-infra/validators';
+ *
+ * const loginData = safeParse(LoginSchema, req.body, 'Login');
+ */
+export { BaseSchemas, createEntitySchema, createNumericEntitySchema } from './base.schema';
+export { ListQuerySchema, ApiResponseSchema, PaginatedResponseSchema, DatabaseConfigSchema, RedisConfigSchema, } from './common.schema';
+export type { TListQuery, TDatabaseConfig, TRedisConfig } from './common.schema';
+export { TInfer, zodToValidationError, safeParse, safeParseAsync, validate, createValidationMiddleware, } from './with-zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAG3F,OAAO,EAEL,eAAe,EAEf,iBAAiB,EACjB,uBAAuB,EAEvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EACL,MAAM,EACN,oBAAoB,EACpB,SAAS,EACT,cAAc,EACd,QAAQ,EACR,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}

package/dist/validators/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * @module validators
+ *
+ * Zod-based validation layer for @gennext/lb-infra.
+ *
+ * @example
+ * import { safeParse, LoginSchema, BaseSchemas } from '@gennext/lb-infra/validators';
+ *
+ * const loginData = safeParse(LoginSchema, req.body, 'Login');
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createValidationMiddleware = exports.validate = exports.safeParseAsync = exports.safeParse = exports.zodToValidationError = exports.RedisConfigSchema = exports.DatabaseConfigSchema = exports.PaginatedResponseSchema = exports.ApiResponseSchema = exports.ListQuerySchema = exports.createNumericEntitySchema = exports.createEntitySchema = exports.BaseSchemas = void 0;
+// Base schemas & entity builders
+var base_schema_1 = require("./base.schema");
+Object.defineProperty(exports, "BaseSchemas", { enumerable: true, get: function () { return base_schema_1.BaseSchemas; } });
+Object.defineProperty(exports, "createEntitySchema", { enumerable: true, get: function () { return base_schema_1.createEntitySchema; } });
+Object.defineProperty(exports, "createNumericEntitySchema", { enumerable: true, get: function () { return base_schema_1.createNumericEntitySchema; } });
+// Application-level schemas
+var common_schema_1 = require("./common.schema");
+// Query & Pagination
+Object.defineProperty(exports, "ListQuerySchema", { enumerable: true, get: function () { return common_schema_1.ListQuerySchema; } });
+// Response wrappers
+Object.defineProperty(exports, "ApiResponseSchema", { enumerable: true, get: function () { return common_schema_1.ApiResponseSchema; } });
+Object.defineProperty(exports, "PaginatedResponseSchema", { enumerable: true, get: function () { return common_schema_1.PaginatedResponseSchema; } });
+// Config
+Object.defineProperty(exports, "DatabaseConfigSchema", { enumerable: true, get: function () { return common_schema_1.DatabaseConfigSchema; } });
+Object.defineProperty(exports, "RedisConfigSchema", { enumerable: true, get: function () { return common_schema_1.RedisConfigSchema; } });
+// Zod integration utilities
+var with_zod_1 = require("./with-zod");
+Object.defineProperty(exports, "zodToValidationError", { enumerable: true, get: function () { return with_zod_1.zodToValidationError; } });
+Object.defineProperty(exports, "safeParse", { enumerable: true, get: function () { return with_zod_1.safeParse; } });
+Object.defineProperty(exports, "safeParseAsync", { enumerable: true, get: function () { return with_zod_1.safeParseAsync; } });
+Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return with_zod_1.validate; } });
+Object.defineProperty(exports, "createValidationMiddleware", { enumerable: true, get: function () { return with_zod_1.createValidationMiddleware; } });
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,iCAAiC;AACjC,6CAA2F;AAAlF,0GAAA,WAAW,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAAE,wHAAA,yBAAyB,OAAA;AAEnE,4BAA4B;AAC5B,iDASyB;AARvB,qBAAqB;AACrB,gHAAA,eAAe,OAAA;AACf,oBAAoB;AACpB,kHAAA,iBAAiB,OAAA;AACjB,wHAAA,uBAAuB,OAAA;AACvB,SAAS;AACT,qHAAA,oBAAoB,OAAA;AACpB,kHAAA,iBAAiB,OAAA;AAKnB,4BAA4B;AAC5B,uCAOoB;AALlB,gHAAA,oBAAoB,OAAA;AACpB,qGAAA,SAAS,OAAA;AACT,0GAAA,cAAc,OAAA;AACd,oGAAA,QAAQ,OAAA;AACR,sHAAA,0BAA0B,OAAA"}

package/dist/validators/with-zod.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { ValidationError } from '../utilities/error.utility';
+/** Shorthand for `z.infer<typeof schema>` */
+export type TInfer<T extends z.ZodTypeAny> = z.infer<T>;
+/**
+ * Flatten a {@link z.ZodError} into a field-keyed record and wrap it
+ * in the project's {@link ValidationError}.
+ *
+ * @param error   - The raw Zod validation error
+ * @param context - Optional human-readable context label (e.g. "Login validation")
+ *
+ * @example
+ * try {
+ *   LoginSchema.parse(body);
+ * } catch (err) {
+ *   if (err instanceof z.ZodError) {
+ *     throw zodToValidationError(err, 'Login');
+ *   }
+ * }
+ */
+export declare function zodToValidationError(error: z.ZodError, context?: string): ValidationError;
+/**
+ * Parse `data` against `schema`, converting any ZodError into a
+ * {@link ValidationError} automatically.
+ *
+ * @throws {@link ValidationError} when validation fails
+ *
+ * @example
+ * const loginInput = safeParse(LoginSchema, req.body, 'Login');
+ */
+export declare function safeParse<T>(schema: z.ZodSchema<T>, data: unknown, context?: string): T;
+/**
+ * Async variant of {@link safeParse} – necessary when the schema uses
+ * `.refine()` with an async callback.
+ *
+ * @throws {@link ValidationError} when validation fails
+ */
+export declare function safeParseAsync<T>(schema: z.ZodSchema<T>, data: unknown, context?: string): Promise<T>;
+/**
+ * Method decorator that validates the **first argument** of the decorated
+ * method against `schema` before the original method body executes.
+ *
+ * @example
+ * class UserService {
+ *   \@validate(LoginSchema)
+ *   async login(data: LoginInput) { ... }
+ * }
+ */
+export declare function validate<T>(schema: z.ZodSchema<T>, context?: string): (_target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Builds an Express-compatible middleware that validates `req.body` against
+ * `schema`. On success, the parsed + transformed data is assigned to
+ * `req.validatedBody`. On failure, a `400` JSON response is returned.
+ *
+ * @example
+ * router.post('/login', createValidationMiddleware(LoginSchema), loginHandler);
+ */
+export declare function createValidationMiddleware<T>(schema: z.ZodSchema<T>, context?: string): (req: {
+    body: unknown;
+    validatedBody?: T;
+}, res: {
+    status: (c: number) => {
+        json: (b: unknown) => void;
+    };
+}, next: (err?: unknown) => void) => void;
+//# sourceMappingURL=with-zod.d.ts.map

package/dist/validators/with-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-zod.d.ts","sourceRoot":"","sources":["../../src/validators/with-zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAI5D,6CAA6C;AAC7C,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAIxD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAgBzF;AAID;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAMvF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC,CAMZ;AAID;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,IACjD,SAAS,MAAM,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAUtF;AAID;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,IAElF,KAAK;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,CAAC,CAAA;CAAE,EACzC,KAAK;IAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,EAC9D,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,UAiBhC"}

package/dist/validators/with-zod.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodToValidationError = zodToValidationError;
+exports.safeParse = safeParse;
+exports.safeParseAsync = safeParseAsync;
+exports.validate = validate;
+exports.createValidationMiddleware = createValidationMiddleware;
+const error_utility_1 = require("../utilities/error.utility");
+// ─── Error Conversion ────────────────────────────────────────────────────────
+/**
+ * Flatten a {@link z.ZodError} into a field-keyed record and wrap it
+ * in the project's {@link ValidationError}.
+ *
+ * @param error   - The raw Zod validation error
+ * @param context - Optional human-readable context label (e.g. "Login validation")
+ *
+ * @example
+ * try {
+ *   LoginSchema.parse(body);
+ * } catch (err) {
+ *   if (err instanceof z.ZodError) {
+ *     throw zodToValidationError(err, 'Login');
+ *   }
+ * }
+ */
+function zodToValidationError(error, context) {
+    const fieldErrors = {};
+    for (const issue of error.issues) {
+        const path = issue.path.join('.') || '_root';
+        const msg = issue.message;
+        const existing = fieldErrors[path];
+        if (existing !== undefined) {
+            fieldErrors[path] = Array.isArray(existing) ? [...existing, msg] : [existing, msg];
+        }
+        else {
+            fieldErrors[path] = msg;
+        }
+    }
+    return new error_utility_1.ValidationError(context ?? 'Validation failed', fieldErrors);
+}
+// ─── Safe Parse ──────────────────────────────────────────────────────────────
+/**
+ * Parse `data` against `schema`, converting any ZodError into a
+ * {@link ValidationError} automatically.
+ *
+ * @throws {@link ValidationError} when validation fails
+ *
+ * @example
+ * const loginInput = safeParse(LoginSchema, req.body, 'Login');
+ */
+function safeParse(schema, data, context) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        throw zodToValidationError(result.error, context);
+    }
+    return result.data;
+}
+/**
+ * Async variant of {@link safeParse} – necessary when the schema uses
+ * `.refine()` with an async callback.
+ *
+ * @throws {@link ValidationError} when validation fails
+ */
+async function safeParseAsync(schema, data, context) {
+    const result = await schema.safeParseAsync(data);
+    if (!result.success) {
+        throw zodToValidationError(result.error, context);
+    }
+    return result.data;
+}
+// ─── Method Decorator ────────────────────────────────────────────────────────
+/**
+ * Method decorator that validates the **first argument** of the decorated
+ * method against `schema` before the original method body executes.
+ *
+ * @example
+ * class UserService {
+ *   \@validate(LoginSchema)
+ *   async login(data: LoginInput) { ... }
+ * }
+ */
+function validate(schema, context) {
+    return function (_target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (data, ...rest) {
+            const validated = safeParse(schema, data, context ?? propertyKey);
+            return originalMethod.call(this, validated, ...rest);
+        };
+        return descriptor;
+    };
+}
+// ─── Express / LoopBack Middleware ───────────────────────────────────────────
+/**
+ * Builds an Express-compatible middleware that validates `req.body` against
+ * `schema`. On success, the parsed + transformed data is assigned to
+ * `req.validatedBody`. On failure, a `400` JSON response is returned.
+ *
+ * @example
+ * router.post('/login', createValidationMiddleware(LoginSchema), loginHandler);
+ */
+function createValidationMiddleware(schema, context) {
+    return (req, res, next) => {
+        const result = schema.safeParse(req.body);
+        if (!result.success) {
+            const validationError = zodToValidationError(result.error, context);
+            res.status(400).json({
+                code: 'VALIDATION_ERROR',
+                message: validationError.message,
+                details: validationError.context,
+            });
+            return;
+        }
+        req.validatedBody = result.data;
+        next();
+    };
+}
+//# sourceMappingURL=with-zod.js.map

package/dist/validators/with-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-zod.js","sourceRoot":"","sources":["../../src/validators/with-zod.ts"],"names":[],"mappings":"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"}