@veruna/api-contracts 1.0.3 → 1.0.7

package/build/index.d.ts

@@ -1,3 +1,4 @@
-export * from './v1/auth';
-export * from './v1/users';
-export * from './v1/unregistered-users';
+export * from './shared';
+export * from './v1';
+export * from './locales';
+export * from './utils';

package/build/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // Export all contracts
-__exportStar(require("./v1/auth"), exports);
-__exportStar(require("./v1/users"), exports);
-__exportStar(require("./v1/unregistered-users"), exports);
+__exportStar(require("./shared"), exports);
+__exportStar(require("./v1"), exports);
+__exportStar(require("./locales"), exports);
+__exportStar(require("./utils"), exports);

package/build/locales/en.d.ts

@@ -0,0 +1,31 @@
+/**
+ * English error messages
+ */
+export declare const en: {
+    readonly EMAIL_ALREADY_EXISTS: "Email already exists";
+    readonly INVALID_CREDENTIALS: "Invalid email or password";
+    readonly USER_NOT_FOUND: "User not found";
+    readonly USER_DELETED: "User account has been deleted";
+    readonly SESSION_NOT_FOUND: "Session not found";
+    readonly SESSION_INACTIVE: "Session is inactive";
+    readonly INVALID_TOKEN: "Invalid or expired token";
+    readonly PASSWORD_TOO_WEAK: "Password is too weak";
+    readonly UNREG_USER_ALREADY_MIGRATED: "Guest user already migrated";
+    readonly SESSION_NOT_OWNED_BY_USER: "Session does not belong to user";
+    readonly DOMAIN_VALIDATION_ERROR: "Validation error";
+    readonly ENTITY_NOT_FOUND: "Resource not found";
+    readonly CONFLICT: "Resource already exists";
+    readonly BUSINESS_RULE_VIOLATION: "Business rule violation";
+    readonly UNAUTHORIZED: "Unauthorized";
+    readonly FORBIDDEN: "Access forbidden";
+    readonly VALIDATION_ERROR: "Validation failed";
+    readonly INTERNAL_SERVER_ERROR: "Internal server error";
+    readonly CATEGORY_NOT_FOUND: "Category not found";
+    readonly CATEGORY_ALIAS_EXISTS: "Category alias already exists";
+    readonly POST_NOT_FOUND: "Post not found";
+    readonly POST_ALIAS_EXISTS: "Post alias already exists";
+    readonly INVALID_CATEGORY_ID: "Invalid category ID";
+    readonly AT_LEAST_ONE_CATEGORY_REQUIRED: "At least one category required";
+    readonly UNKNOWN_ERROR: "An unexpected error occurred";
+};
+export type ErrorCode = keyof typeof en;

package/build/locales/en.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.en = void 0;
+/**
+ * English error messages
+ */
+exports.en = {
+    // Auth errors
+    EMAIL_ALREADY_EXISTS: 'Email already exists',
+    INVALID_CREDENTIALS: 'Invalid email or password',
+    USER_NOT_FOUND: 'User not found',
+    USER_DELETED: 'User account has been deleted',
+    SESSION_NOT_FOUND: 'Session not found',
+    SESSION_INACTIVE: 'Session is inactive',
+    INVALID_TOKEN: 'Invalid or expired token',
+    PASSWORD_TOO_WEAK: 'Password is too weak',
+    UNREG_USER_ALREADY_MIGRATED: 'Guest user already migrated',
+    SESSION_NOT_OWNED_BY_USER: 'Session does not belong to user',
+    // Domain errors
+    DOMAIN_VALIDATION_ERROR: 'Validation error',
+    ENTITY_NOT_FOUND: 'Resource not found',
+    CONFLICT: 'Resource already exists',
+    BUSINESS_RULE_VIOLATION: 'Business rule violation',
+    // Application errors
+    UNAUTHORIZED: 'Unauthorized',
+    FORBIDDEN: 'Access forbidden',
+    VALIDATION_ERROR: 'Validation failed',
+    INTERNAL_SERVER_ERROR: 'Internal server error',
+    // Blog errors
+    CATEGORY_NOT_FOUND: 'Category not found',
+    CATEGORY_ALIAS_EXISTS: 'Category alias already exists',
+    POST_NOT_FOUND: 'Post not found',
+    POST_ALIAS_EXISTS: 'Post alias already exists',
+    INVALID_CATEGORY_ID: 'Invalid category ID',
+    AT_LEAST_ONE_CATEGORY_REQUIRED: 'At least one category required',
+    // Generic
+    UNKNOWN_ERROR: 'An unexpected error occurred',
+};

package/build/locales/index.d.ts

@@ -0,0 +1,66 @@
+import { en, ErrorCode } from './en';
+import { ru } from './ru';
+export { en, ru, ErrorCode };
+/**
+ * Get localized error message
+ */
+export declare function getErrorMessage(code: string, locale?: 'en' | 'ru'): string;
+/**
+ * Type-safe error messages
+ */
+export declare const errorMessages: {
+    readonly en: {
+        readonly EMAIL_ALREADY_EXISTS: "Email already exists";
+        readonly INVALID_CREDENTIALS: "Invalid email or password";
+        readonly USER_NOT_FOUND: "User not found";
+        readonly USER_DELETED: "User account has been deleted";
+        readonly SESSION_NOT_FOUND: "Session not found";
+        readonly SESSION_INACTIVE: "Session is inactive";
+        readonly INVALID_TOKEN: "Invalid or expired token";
+        readonly PASSWORD_TOO_WEAK: "Password is too weak";
+        readonly UNREG_USER_ALREADY_MIGRATED: "Guest user already migrated";
+        readonly SESSION_NOT_OWNED_BY_USER: "Session does not belong to user";
+        readonly DOMAIN_VALIDATION_ERROR: "Validation error";
+        readonly ENTITY_NOT_FOUND: "Resource not found";
+        readonly CONFLICT: "Resource already exists";
+        readonly BUSINESS_RULE_VIOLATION: "Business rule violation";
+        readonly UNAUTHORIZED: "Unauthorized";
+        readonly FORBIDDEN: "Access forbidden";
+        readonly VALIDATION_ERROR: "Validation failed";
+        readonly INTERNAL_SERVER_ERROR: "Internal server error";
+        readonly CATEGORY_NOT_FOUND: "Category not found";
+        readonly CATEGORY_ALIAS_EXISTS: "Category alias already exists";
+        readonly POST_NOT_FOUND: "Post not found";
+        readonly POST_ALIAS_EXISTS: "Post alias already exists";
+        readonly INVALID_CATEGORY_ID: "Invalid category ID";
+        readonly AT_LEAST_ONE_CATEGORY_REQUIRED: "At least one category required";
+        readonly UNKNOWN_ERROR: "An unexpected error occurred";
+    };
+    readonly ru: {
+        readonly EMAIL_ALREADY_EXISTS: "Email уже зарегистрирован";
+        readonly INVALID_CREDENTIALS: "Неверный email или пароль";
+        readonly USER_NOT_FOUND: "Пользователь не найден";
+        readonly USER_DELETED: "Аккаунт пользователя удалён";
+        readonly SESSION_NOT_FOUND: "Сессия не найдена";
+        readonly SESSION_INACTIVE: "Сессия неактивна";
+        readonly INVALID_TOKEN: "Невалидный или истёкший токен";
+        readonly PASSWORD_TOO_WEAK: "Пароль слишком слабый";
+        readonly UNREG_USER_ALREADY_MIGRATED: "Гостевой пользователь уже мигрирован";
+        readonly SESSION_NOT_OWNED_BY_USER: "Сессия не принадлежит пользователю";
+        readonly DOMAIN_VALIDATION_ERROR: "Ошибка валидации";
+        readonly ENTITY_NOT_FOUND: "Ресурс не найден";
+        readonly CONFLICT: "Ресурс уже существует";
+        readonly BUSINESS_RULE_VIOLATION: "Нарушение бизнес-правила";
+        readonly UNAUTHORIZED: "Не авторизован";
+        readonly FORBIDDEN: "Доступ запрещён";
+        readonly VALIDATION_ERROR: "Ошибка валидации";
+        readonly INTERNAL_SERVER_ERROR: "Внутренняя ошибка сервера";
+        readonly CATEGORY_NOT_FOUND: "Категория не найдена";
+        readonly CATEGORY_ALIAS_EXISTS: "Alias категории уже существует";
+        readonly POST_NOT_FOUND: "Пост не найден";
+        readonly POST_ALIAS_EXISTS: "Alias поста уже существует";
+        readonly INVALID_CATEGORY_ID: "Невалидный ID категории";
+        readonly AT_LEAST_ONE_CATEGORY_REQUIRED: "Требуется минимум одна категория";
+        readonly UNKNOWN_ERROR: "Произошла неожиданная ошибка";
+    };
+};

package/build/locales/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorMessages = exports.ru = exports.en = void 0;
+exports.getErrorMessage = getErrorMessage;
+const en_1 = require("./en");
+Object.defineProperty(exports, "en", { enumerable: true, get: function () { return en_1.en; } });
+const ru_1 = require("./ru");
+Object.defineProperty(exports, "ru", { enumerable: true, get: function () { return ru_1.ru; } });
+/**
+ * Get localized error message
+ */
+function getErrorMessage(code, locale = 'en') {
+    const messages = locale === 'ru' ? ru_1.ru : en_1.en;
+    return messages[code] || messages.UNKNOWN_ERROR;
+}
+/**
+ * Type-safe error messages
+ */
+exports.errorMessages = {
+    en: en_1.en,
+    ru: ru_1.ru,
+};

package/build/locales/ru.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Russian error messages
+ */
+export declare const ru: {
+    readonly EMAIL_ALREADY_EXISTS: "Email уже зарегистрирован";
+    readonly INVALID_CREDENTIALS: "Неверный email или пароль";
+    readonly USER_NOT_FOUND: "Пользователь не найден";
+    readonly USER_DELETED: "Аккаунт пользователя удалён";
+    readonly SESSION_NOT_FOUND: "Сессия не найдена";
+    readonly SESSION_INACTIVE: "Сессия неактивна";
+    readonly INVALID_TOKEN: "Невалидный или истёкший токен";
+    readonly PASSWORD_TOO_WEAK: "Пароль слишком слабый";
+    readonly UNREG_USER_ALREADY_MIGRATED: "Гостевой пользователь уже мигрирован";
+    readonly SESSION_NOT_OWNED_BY_USER: "Сессия не принадлежит пользователю";
+    readonly DOMAIN_VALIDATION_ERROR: "Ошибка валидации";
+    readonly ENTITY_NOT_FOUND: "Ресурс не найден";
+    readonly CONFLICT: "Ресурс уже существует";
+    readonly BUSINESS_RULE_VIOLATION: "Нарушение бизнес-правила";
+    readonly UNAUTHORIZED: "Не авторизован";
+    readonly FORBIDDEN: "Доступ запрещён";
+    readonly VALIDATION_ERROR: "Ошибка валидации";
+    readonly INTERNAL_SERVER_ERROR: "Внутренняя ошибка сервера";
+    readonly CATEGORY_NOT_FOUND: "Категория не найдена";
+    readonly CATEGORY_ALIAS_EXISTS: "Alias категории уже существует";
+    readonly POST_NOT_FOUND: "Пост не найден";
+    readonly POST_ALIAS_EXISTS: "Alias поста уже существует";
+    readonly INVALID_CATEGORY_ID: "Невалидный ID категории";
+    readonly AT_LEAST_ONE_CATEGORY_REQUIRED: "Требуется минимум одна категория";
+    readonly UNKNOWN_ERROR: "Произошла неожиданная ошибка";
+};

package/build/locales/ru.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ru = void 0;
+/**
+ * Russian error messages
+ */
+exports.ru = {
+    // Auth errors
+    EMAIL_ALREADY_EXISTS: 'Email уже зарегистрирован',
+    INVALID_CREDENTIALS: 'Неверный email или пароль',
+    USER_NOT_FOUND: 'Пользователь не найден',
+    USER_DELETED: 'Аккаунт пользователя удалён',
+    SESSION_NOT_FOUND: 'Сессия не найдена',
+    SESSION_INACTIVE: 'Сессия неактивна',
+    INVALID_TOKEN: 'Невалидный или истёкший токен',
+    PASSWORD_TOO_WEAK: 'Пароль слишком слабый',
+    UNREG_USER_ALREADY_MIGRATED: 'Гостевой пользователь уже мигрирован',
+    SESSION_NOT_OWNED_BY_USER: 'Сессия не принадлежит пользователю',
+    // Domain errors
+    DOMAIN_VALIDATION_ERROR: 'Ошибка валидации',
+    ENTITY_NOT_FOUND: 'Ресурс не найден',
+    CONFLICT: 'Ресурс уже существует',
+    BUSINESS_RULE_VIOLATION: 'Нарушение бизнес-правила',
+    // Application errors
+    UNAUTHORIZED: 'Не авторизован',
+    FORBIDDEN: 'Доступ запрещён',
+    VALIDATION_ERROR: 'Ошибка валидации',
+    INTERNAL_SERVER_ERROR: 'Внутренняя ошибка сервера',
+    // Blog errors
+    CATEGORY_NOT_FOUND: 'Категория не найдена',
+    CATEGORY_ALIAS_EXISTS: 'Alias категории уже существует',
+    POST_NOT_FOUND: 'Пост не найден',
+    POST_ALIAS_EXISTS: 'Alias поста уже существует',
+    INVALID_CATEGORY_ID: 'Невалидный ID категории',
+    AT_LEAST_ONE_CATEGORY_REQUIRED: 'Требуется минимум одна категория',
+    // Generic
+    UNKNOWN_ERROR: 'Произошла неожиданная ошибка',
+};

package/build/rest-api.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Centralized REST API URLs
+ * Used by frontend for API calls
+ */
+export declare const ROOT: "/api";
+export declare const REST_API: {
+    readonly V1: {
+        readonly AUTH: {
+            readonly SIGNUP: "/api/v1/auth/signup";
+            readonly LOGIN: "/api/v1/auth/login";
+            readonly LOGOUT: "/api/v1/auth/logout";
+            readonly LOGOUT_ALL: "/api/v1/auth/logout-all";
+            readonly SESSIONS: "/api/v1/auth/sessions";
+            readonly SESSION_BY_ID: (id: string) => string;
+        };
+        readonly USERS: {
+            readonly ME: "/api/v1/users/me";
+            readonly ME_MARKETING_CONSENT: "/api/v1/users/me/marketing-consent";
+            readonly ME_PASSWORD: "/api/v1/users/me/password";
+        };
+        readonly UNREG: {
+            readonly AUTHENTICATE: "/api/v1/unreg/";
+        };
+        readonly BLOG: {
+            readonly ADMIN: {
+                readonly CATEGORIES: {
+                    readonly CREATE: "/api/v1/admin/blog/categories/";
+                    readonly GET_ALL: "/api/v1/admin/blog/categories/";
+                    readonly GET_BY_UUID: (uuid: string) => string;
+                    readonly UPDATE: (uuid: string) => string;
+                    readonly DELETE: (uuid: string) => string;
+                };
+                readonly POSTS: {
+                    readonly CREATE: "/api/v1/admin/blog/posts/";
+                    readonly GET_ALL: "/api/v1/admin/blog/posts/";
+                    readonly GET_BY_UUID: (uuid: string) => string;
+                    readonly UPDATE: (uuid: string) => string;
+                    readonly DELETE: (uuid: string) => string;
+                };
+            };
+            readonly PUBLIC: {
+                readonly CATEGORIES: {
+                    readonly GET_ALL: "/api/v1/blog/categories/";
+                };
+                readonly POSTS: {
+                    readonly GET_ALL: "/api/v1/blog/posts/";
+                    readonly GET_BY_ALIAS: (alias: string) => string;
+                };
+            };
+        };
+    };
+};

package/build/rest-api.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Centralized REST API URLs
+ * Used by frontend for API calls
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REST_API = exports.ROOT = void 0;
+const controllers_1 = require("./v1/blog/controllers");
+const routes_1 = require("./v1/blog/routes");
+const controllers_2 = require("./v1/auth/controllers");
+const auth_routes_1 = require("./v1/auth/routes/auth.routes");
+const controllers_3 = require("./v1/users/controllers");
+const users_routes_1 = require("./v1/users/routes/users.routes");
+const controllers_4 = require("./v1/unregistered-users/controllers");
+const unreg_users_routes_1 = require("./v1/unregistered-users/routes/unreg-users.routes");
+exports.ROOT = '/api';
+exports.REST_API = {
+    V1: {
+        // Auth module
+        AUTH: {
+            SIGNUP: `${exports.ROOT}/${controllers_2.AUTH_CONTROLLER}/${auth_routes_1.AUTH_ROUTES.SIGNUP}`,
+            LOGIN: `${exports.ROOT}/${controllers_2.AUTH_CONTROLLER}/${auth_routes_1.AUTH_ROUTES.LOGIN}`,
+            LOGOUT: `${exports.ROOT}/${controllers_2.AUTH_CONTROLLER}/${auth_routes_1.AUTH_ROUTES.LOGOUT}`,
+            LOGOUT_ALL: `${exports.ROOT}/${controllers_2.AUTH_CONTROLLER}/${auth_routes_1.AUTH_ROUTES.LOGOUT_ALL}`,
+            SESSIONS: `${exports.ROOT}/${controllers_2.AUTH_CONTROLLER}/${auth_routes_1.AUTH_ROUTES.SESSIONS}`,
+            SESSION_BY_ID: (id) => `${exports.ROOT}/${controllers_2.AUTH_CONTROLLER}/sessions/${id}`,
+        },
+        // Users module
+        USERS: {
+            ME: `${exports.ROOT}/${controllers_3.USERS_CONTROLLER}/${users_routes_1.USERS_ROUTES.ME}`,
+            ME_MARKETING_CONSENT: `${exports.ROOT}/${controllers_3.USERS_CONTROLLER}/${users_routes_1.USERS_ROUTES.ME_MARKETING_CONSENT}`,
+            ME_PASSWORD: `${exports.ROOT}/${controllers_3.USERS_CONTROLLER}/${users_routes_1.USERS_ROUTES.ME_PASSWORD}`,
+        },
+        // Unregistered Users
+        UNREG: {
+            AUTHENTICATE: `${exports.ROOT}/${controllers_4.UNREG_USERS_CONTROLLER}/${unreg_users_routes_1.UNREG_USERS_ROUTES.AUTHENTICATE}`,
+        },
+        // Blog module
+        BLOG: {
+            ADMIN: {
+                CATEGORIES: {
+                    CREATE: `${exports.ROOT}/${controllers_1.BLOG_ADMIN_CATEGORIES_CONTROLLER}/${routes_1.BLOG_ADMIN_CATEGORIES_ROUTES.CREATE}`,
+                    GET_ALL: `${exports.ROOT}/${controllers_1.BLOG_ADMIN_CATEGORIES_CONTROLLER}/${routes_1.BLOG_ADMIN_CATEGORIES_ROUTES.GET_ALL}`,
+                    GET_BY_UUID: (uuid) => `${exports.ROOT}/${controllers_1.BLOG_ADMIN_CATEGORIES_CONTROLLER}/${uuid}`,
+                    UPDATE: (uuid) => `${exports.ROOT}/${controllers_1.BLOG_ADMIN_CATEGORIES_CONTROLLER}/${uuid}`,
+                    DELETE: (uuid) => `${exports.ROOT}/${controllers_1.BLOG_ADMIN_CATEGORIES_CONTROLLER}/${uuid}`,
+                },
+                POSTS: {
+                    CREATE: `${exports.ROOT}/${controllers_1.BLOG_ADMIN_POSTS_CONTROLLER}/${routes_1.BLOG_ADMIN_POSTS_ROUTES.CREATE}`,
+                    GET_ALL: `${exports.ROOT}/${controllers_1.BLOG_ADMIN_POSTS_CONTROLLER}/${routes_1.BLOG_ADMIN_POSTS_ROUTES.GET_ALL}`,
+                    GET_BY_UUID: (uuid) => `${exports.ROOT}/${controllers_1.BLOG_ADMIN_POSTS_CONTROLLER}/${uuid}`,
+                    UPDATE: (uuid) => `${exports.ROOT}/${controllers_1.BLOG_ADMIN_POSTS_CONTROLLER}/${uuid}`,
+                    DELETE: (uuid) => `${exports.ROOT}/${controllers_1.BLOG_ADMIN_POSTS_CONTROLLER}/${uuid}`,
+                },
+            },
+            PUBLIC: {
+                CATEGORIES: {
+                    GET_ALL: `${exports.ROOT}/${controllers_1.BLOG_PUBLIC_CATEGORIES_CONTROLLER}/${routes_1.BLOG_PUBLIC_CATEGORIES_ROUTES.GET_ALL}`,
+                },
+                POSTS: {
+                    GET_ALL: `${exports.ROOT}/${controllers_1.BLOG_PUBLIC_POSTS_CONTROLLER}/${routes_1.BLOG_PUBLIC_POSTS_ROUTES.GET_ALL}`,
+                    GET_BY_ALIAS: (alias) => `${exports.ROOT}/${controllers_1.BLOG_PUBLIC_POSTS_CONTROLLER}/${alias}`,
+                },
+            },
+        },
+    },
+};

package/build/shared/common-schemas.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/**
+ * Empty Response (for void operations)
+ */
+export declare const EmptyResponseSchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * Error Response Schema
+ */
+export declare const ErrorResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;

package/build/shared/common-schemas.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorResponseSchema = exports.EmptyResponseSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Empty Response (for void operations)
+ */
+exports.EmptyResponseSchema = zod_1.z.object({});
+/**
+ * Error Response Schema
+ */
+exports.ErrorResponseSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    details: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+});

package/build/shared/error-response.schema.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+/**
+ * Base error response schema
+ */
+export declare const ErrorResponseSchema: z.ZodObject<{
+    statusCode: z.ZodNumber;
+    message: z.ZodString;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+/**
+ * Validation error response schema
+ */
+export declare const ValidationErrorResponseSchema: z.ZodObject<{
+    statusCode: z.ZodNumber;
+    message: z.ZodString;
+    error: z.ZodString;
+    timestamp: z.ZodString;
+    code: z.ZodLiteral<"VALIDATION_ERROR">;
+    details: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ValidationErrorResponse = z.infer<typeof ValidationErrorResponseSchema>;

package/build/shared/error-response.schema.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationErrorResponseSchema = exports.ErrorResponseSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Base error response schema
+ */
+exports.ErrorResponseSchema = zod_1.z.object({
+    statusCode: zod_1.z.number(),
+    message: zod_1.z.string(),
+    error: zod_1.z.string(),
+    code: zod_1.z.string().optional(),
+    details: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+    timestamp: zod_1.z.string(),
+});
+/**
+ * Validation error response schema
+ */
+exports.ValidationErrorResponseSchema = exports.ErrorResponseSchema.extend({
+    code: zod_1.z.literal('VALIDATION_ERROR'),
+    details: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())),
+});

package/build/shared/index.d.ts

@@ -0,0 +1,2 @@
+export * from './error-response.schema';
+export * from './pagination.schema';

package/build/shared/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./error-response.schema"), exports);
+__exportStar(require("./pagination.schema"), exports);

package/build/shared/pagination.schema.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+/**
+ * Pagination query params schema
+ */
+export declare const PaginationQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type PaginationQuery = z.infer<typeof PaginationQuerySchema>;
+/**
+ * Pagination metadata schema
+ */
+export declare const PaginationMetaSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    limit: z.ZodNumber;
+    total: z.ZodNumber;
+    totalPages: z.ZodNumber;
+    hasNext: z.ZodBoolean;
+    hasPrev: z.ZodBoolean;
+}, z.core.$strip>;
+export type PaginationMeta = z.infer<typeof PaginationMetaSchema>;
+/**
+ * Paginated response schema
+ */
+export declare const createPaginatedResponseSchema: <T extends z.ZodType>(itemSchema: T) => z.ZodObject<{
+    data: z.ZodArray<T>;
+    meta: z.ZodObject<{
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasNext: z.ZodBoolean;
+        hasPrev: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/build/shared/pagination.schema.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPaginatedResponseSchema = exports.PaginationMetaSchema = exports.PaginationQuerySchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Pagination query params schema
+ */
+exports.PaginationQuerySchema = zod_1.z.object({
+    page: zod_1.z.coerce.number().int().positive().default(1),
+    limit: zod_1.z.coerce.number().int().positive().max(100).default(10),
+});
+/**
+ * Pagination metadata schema
+ */
+exports.PaginationMetaSchema = zod_1.z.object({
+    page: zod_1.z.number().int().positive(),
+    limit: zod_1.z.number().int().positive(),
+    total: zod_1.z.number().int().nonnegative(),
+    totalPages: zod_1.z.number().int().nonnegative(),
+    hasNext: zod_1.z.boolean(),
+    hasPrev: zod_1.z.boolean(),
+});
+/**
+ * Paginated response schema
+ */
+const createPaginatedResponseSchema = (itemSchema) => zod_1.z.object({
+    data: zod_1.z.array(itemSchema),
+    meta: exports.PaginationMetaSchema,
+});
+exports.createPaginatedResponseSchema = createPaginatedResponseSchema;

package/build/shared/regex.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Common regex patterns for validation
+ */
+export declare const EMAIL_REGEX: RegExp;
+export declare const UUID_REGEX: RegExp;
+export declare const DATETIME_REGEX: RegExp;
+export declare const PASSWORD_STRENGTH_REGEX: RegExp;
+export declare const SLUG_REGEX: RegExp;

package/build/shared/regex.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Common regex patterns for validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLUG_REGEX = exports.PASSWORD_STRENGTH_REGEX = exports.DATETIME_REGEX = exports.UUID_REGEX = exports.EMAIL_REGEX = void 0;
+// RFC 5322 email regex (simplified)
+exports.EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+// UUID v4 regex
+exports.UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+// ISO 8601 datetime regex
+exports.DATETIME_REGEX = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
+// Password strength regex (at least one number or special character)
+exports.PASSWORD_STRENGTH_REGEX = /[0-9!@#$%^&*(),.?":{}|<>]/;
+// Slug/alias regex (lowercase letters, numbers, hyphens)
+exports.SLUG_REGEX = /^[a-z0-9-]+$/;

package/build/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './path-builder';

package/build/utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./path-builder"), exports);

package/build/utils/path-builder.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Build URL path with parameters
+ * @example
+ * buildPath('/users/:id', { id: '123' }) // '/users/123'
+ * buildPath('/users/:id/posts/:postId', { id: '1', postId: '2' }) // '/users/1/posts/2'
+ */
+export declare function buildPath(pattern: string, params?: Record<string, string | number>): string;
+/**
+ * Build URL with query parameters
+ * @example
+ * buildUrl('/users', { page: 1, limit: 10 }) // '/users?page=1&limit=10'
+ */
+export declare function buildUrl(path: string, queryParams?: Record<string, string | number | boolean | undefined>): string;
+/**
+ * Build full URL with path params and query params
+ * @example
+ * buildFullUrl('/users/:id', { id: '123' }, { include: 'posts' })
+ * // '/users/123?include=posts'
+ */
+export declare function buildFullUrl(pattern: string, pathParams?: Record<string, string | number>, queryParams?: Record<string, string | number | boolean | undefined>): string;