@gennext/lb-infra 0.1.0 → 0.1.1

package/README.md

@@ -95,12 +95,6 @@ await executePromiseWithLimit({
 - `src/helpers`: Các module bổ trợ quan trọng (Logger, Redis).
 - `src/utilities`: Các hàm tiện ích dùng chung.
 
-## 📖 Tài liệu chi tiết
-
-- [Tài liệu cấu hình Logger](docs/ENHANCED_LOGGER_USAGE.md)
-- [Hướng dẫn cấu hình chung](docs/CONFIG_USAGE.md)
-- [Chi tiết hệ thống xử lý lỗi](docs/ERROR_HANDLING.md)
-
 ## 🛠️ Scripts hỗ trợ (Maintainer)
 
 - `bun run build`: Biên dịch mã nguồn sang thư mục `dist`.

package/dist/index.d.ts

@@ -7,4 +7,5 @@ export * from './common';
 export * from './datasources';
 export * from './helpers';
 export * from './utilities';
+export * from './validators';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -23,4 +23,5 @@ __exportStar(require("./common"), exports);
 __exportStar(require("./datasources"), exports);
 __exportStar(require("./helpers"), exports);
 __exportStar(require("./utilities"), exports);
+__exportStar(require("./validators"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,4CAA0B;AAC1B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B"}

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

@@ -0,0 +1,57 @@
+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.ZodString;
+    /** Flexible ID – accepts UUID string or positive integer */
+    ID: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    Email: z.ZodString;
+    Username: z.ZodString;
+    Password: z.ZodString;
+    PhoneNumber: z.ZodString;
+    URL: z.ZodString;
+    /** 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 */
+    ISODate: z.ZodString;
+    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.ZodString;
+    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;;;;;;;;;CAkBhC,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,85 @@
+"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.string().uuid('Invalid UUID format'),
+    /** Flexible ID – accepts UUID string or positive integer */
+    ID: zod_1.z.union([
+        zod_1.z.string().uuid('Invalid UUID format'),
+        zod_1.z.number().int().positive('ID must be a positive integer'),
+    ]),
+    // ─── Strings ─────────────────────────────────────────────────────────────
+    Email: zod_1.z.string().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.string().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().safe(),
+    // ─── Dates ───────────────────────────────────────────────────────────────
+    /** ISO-8601 datetime string */
+    ISODate: zod_1.z.string().datetime({ message: 'Must be a valid 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":"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"}

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

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+export declare const LoginSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+    rememberMe: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TLoginInput = z.infer<typeof LoginSchema>;
+export declare const RegisterSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+    confirmPassword: z.ZodString;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+}, z.core.$strip>;
+export type TRegisterInput = z.infer<typeof RegisterSchema>;
+export declare const ChangePasswordSchema: z.ZodObject<{
+    currentPassword: z.ZodString;
+    newPassword: z.ZodString;
+    confirmPassword: z.ZodString;
+}, z.core.$strip>;
+export type TChangePasswordInput = z.infer<typeof ChangePasswordSchema>;
+export declare const UserEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    deletedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    email: z.ZodString;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type TUserEntity = z.infer<typeof UserEntitySchema>;
+/** Partial update – id, createdAt, deletedAt are immutable */
+export declare const UpdateUserSchema: z.ZodObject<{
+    email: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodDate>;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    metadata: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type TUpdateUserInput = z.infer<typeof UpdateUserSchema>;
+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,WAAW;;;;iBAItB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc;;;;;;iBAWvB,CAAC;AACL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;iBAa7B,CAAC;AACL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIxE,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAO3B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3D,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB;;;;;;;;iBAI3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAIhE,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,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisConfigSchema = exports.DatabaseConfigSchema = exports.PaginatedResponseSchema = exports.ApiResponseSchema = exports.ListQuerySchema = exports.UpdateUserSchema = exports.UserEntitySchema = exports.ChangePasswordSchema = exports.RegisterSchema = exports.LoginSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("./base.schema");
+// ─── Auth ────────────────────────────────────────────────────────────────────
+exports.LoginSchema = zod_1.z.object({
+    email: base_schema_1.BaseSchemas.Email,
+    password: zod_1.z.string().min(1, 'Password is required'),
+    rememberMe: zod_1.z.boolean().default(false),
+});
+exports.RegisterSchema = zod_1.z
+    .object({
+    email: base_schema_1.BaseSchemas.Email,
+    password: base_schema_1.BaseSchemas.Password,
+    confirmPassword: zod_1.z.string(),
+    firstName: base_schema_1.BaseSchemas.NonEmptyString,
+    lastName: base_schema_1.BaseSchemas.NonEmptyString,
+})
+    .refine(data => data.password === data.confirmPassword, {
+    message: 'Passwords do not match',
+    path: ['confirmPassword'],
+});
+exports.ChangePasswordSchema = zod_1.z
+    .object({
+    currentPassword: zod_1.z.string().min(1, 'Current password is required'),
+    newPassword: base_schema_1.BaseSchemas.Password,
+    confirmPassword: zod_1.z.string(),
+})
+    .refine(data => data.newPassword !== data.currentPassword, {
+    message: 'New password must differ from current password',
+    path: ['newPassword'],
+})
+    .refine(data => data.newPassword === data.confirmPassword, {
+    message: 'Passwords do not match',
+    path: ['confirmPassword'],
+});
+// ─── User ────────────────────────────────────────────────────────────────────
+exports.UserEntitySchema = (0, base_schema_1.createEntitySchema)({
+    email: base_schema_1.BaseSchemas.Email,
+    firstName: zod_1.z.string(),
+    lastName: zod_1.z.string(),
+    phone: base_schema_1.BaseSchemas.PhoneNumber.optional(),
+    isActive: zod_1.z.boolean().default(true),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+/** Partial update – id, createdAt, deletedAt are immutable */
+exports.UpdateUserSchema = exports.UserEntitySchema.partial().omit({
+    id: true,
+    createdAt: true,
+    deletedAt: true,
+});
+// ─── 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":"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"}

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 { LoginSchema, RegisterSchema, ChangePasswordSchema, UserEntitySchema, UpdateUserSchema, ListQuerySchema, ApiResponseSchema, PaginatedResponseSchema, DatabaseConfigSchema, RedisConfigSchema, } from './common.schema';
+export type { TLoginInput, TRegisterInput, TChangePasswordInput, TUserEntity, TUpdateUserInput, 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,WAAW,EACX,cAAc,EACd,oBAAoB,EAEpB,gBAAgB,EAChB,gBAAgB,EAEhB,eAAe,EAEf,iBAAiB,EACjB,uBAAuB,EAEvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,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,43 @@
+"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.UpdateUserSchema = exports.UserEntitySchema = exports.ChangePasswordSchema = exports.RegisterSchema = exports.LoginSchema = 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");
+// Auth
+Object.defineProperty(exports, "LoginSchema", { enumerable: true, get: function () { return common_schema_1.LoginSchema; } });
+Object.defineProperty(exports, "RegisterSchema", { enumerable: true, get: function () { return common_schema_1.RegisterSchema; } });
+Object.defineProperty(exports, "ChangePasswordSchema", { enumerable: true, get: function () { return common_schema_1.ChangePasswordSchema; } });
+// User
+Object.defineProperty(exports, "UserEntitySchema", { enumerable: true, get: function () { return common_schema_1.UserEntitySchema; } });
+Object.defineProperty(exports, "UpdateUserSchema", { enumerable: true, get: function () { return common_schema_1.UpdateUserSchema; } });
+// 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,iDAgByB;AAfvB,OAAO;AACP,4GAAA,WAAW,OAAA;AACX,+GAAA,cAAc,OAAA;AACd,qHAAA,oBAAoB,OAAA;AACpB,OAAO;AACP,iHAAA,gBAAgB,OAAA;AAChB,iHAAA,gBAAgB,OAAA;AAChB,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;AAcnB,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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gennext/lb-infra",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "dependencies": {
     "@gennext/dev-configs": "^0.0.3",
     "@loopback/authentication": "^12.0.6",
@@ -25,7 +25,8 @@
     "uuid": "^13.0.0",
     "winston": "^3.19.0",
     "winston-daily-rotate-file": "^5.0.0",
-    "winston-transport": "^4.9.0"
+    "winston-transport": "^4.9.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@gennext/eslint-node": "^0.0.2",