@scpxl/nodejs-framework 1.0.24 → 1.0.25

package/dist/schemas/common.d.ts

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+/**
+ * Common Zod schemas for reuse across the framework
+ */
+/**
+ * Numeric ID schema (positive integer)
+ */
+export declare const NumericIdSchema: z.ZodCoercedNumber<unknown>;
+/**
+ * UUID v4 schema
+ */
+export declare const UuidSchema: z.ZodString;
+/**
+ * Optional numeric ID (for updates where ID may not be required)
+ */
+export declare const OptionalNumericIdSchema: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+/**
+ * Pagination query parameters schema
+ */
+export declare const PaginationQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/**
+ * Inferred type for pagination query
+ */
+export type PaginationQuery = z.infer<typeof PaginationQuerySchema>;
+/**
+ * Paginated response wrapper schema
+ */
+export declare const createPaginatedResponseSchema: <T extends z.ZodTypeAny>(itemSchema: T) => z.ZodObject<{
+    data: z.ZodArray<T>;
+    total_items: z.ZodNumber;
+    page: z.ZodNumber;
+    total_pages: z.ZodNumber;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Helper type for paginated response
+ */
+export type PaginatedResponse<T> = {
+    data: T[];
+    total_items: number;
+    page: number;
+    total_pages: number;
+    limit: number;
+};
+/**
+ * Sort order schema
+ */
+export declare const SortOrderSchema: z.ZodDefault<z.ZodEnum<{
+    ASC: "ASC";
+    DESC: "DESC";
+    asc: "asc";
+    desc: "desc";
+}>>;
+/**
+ * Generic sort query schema
+ */
+export declare const SortQuerySchema: z.ZodObject<{
+    sort: z.ZodOptional<z.ZodString>;
+    'sort-order': z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        ASC: "ASC";
+        DESC: "DESC";
+        asc: "asc";
+        desc: "desc";
+    }>>>;
+}, z.core.$strip>;
+/**
+ * Search query schema
+ */
+export declare const SearchQuerySchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Combined list query schema (pagination + sorting + search)
+ */
+export declare const ListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    sort: z.ZodOptional<z.ZodString>;
+    'sort-order': z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        ASC: "ASC";
+        DESC: "DESC";
+        asc: "asc";
+        desc: "desc";
+    }>>>;
+    search: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Inferred type for list query
+ */
+export type ListQuery = z.infer<typeof ListQuerySchema>;
+/**
+ * Success response wrapper schema
+ */
+export declare const createSuccessResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    data: T;
+}, z.core.$strip>;
+/**
+ * Error response schema
+ */
+export declare const ErrorResponseSchema: z.ZodObject<{
+    error: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    statusCode: z.ZodOptional<z.ZodNumber>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Inferred type for error response
+ */
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+/**
+ * Generic API response schema (success or error)
+ */
+export declare const createApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodUnion<readonly [z.ZodObject<{
+    data: T;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    statusCode: z.ZodOptional<z.ZodNumber>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>;
+/**
+ * Email schema
+ */
+export declare const EmailSchema: z.ZodString;
+/**
+ * URL schema
+ */
+export declare const UrlSchema: z.ZodString;
+/**
+ * Phone number schema (basic validation)
+ */
+export declare const PhoneSchema: z.ZodString;
+/**
+ * Date string schema (ISO 8601)
+ */
+export declare const DateStringSchema: z.ZodString;
+/**
+ * Non-empty string schema
+ */
+export declare const NonEmptyStringSchema: z.ZodString;
+/**
+ * Trimmed non-empty string schema
+ */
+export declare const TrimmedStringSchema: z.ZodString;
+/**
+ * Boolean schema with string coercion
+ */
+export declare const BooleanSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>, z.ZodTransform<boolean, string | boolean>>;
+/**
+ * Created/Updated timestamp schema
+ */
+export declare const TimestampSchema: z.ZodObject<{
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, z.core.$strip>;
+/**
+ * Optional timestamp schema
+ */
+export declare const OptionalTimestampSchema: z.ZodObject<{
+    createdAt: z.ZodOptional<z.ZodDate>;
+    updatedAt: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+/**
+ * Comma-separated string to array transformer
+ */
+export declare const CommaSeparatedStringSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>;
+/**
+ * JSON string schema (parses JSON string to object)
+ */
+export declare const JsonStringSchema: z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>;
+/**
+ * Health check response schema
+ */
+export declare const HealthCheckResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        healthy: "healthy";
+        unhealthy: "unhealthy";
+        degraded: "degraded";
+    }>;
+    timestamp: z.ZodString;
+    services: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            up: "up";
+            down: "down";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Inferred type for health check response
+ */
+export type HealthCheckResponse = z.infer<typeof HealthCheckResponseSchema>;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAqC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,UAAU,aAAoB,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,uBAAuB,4CAA6B,CAAC;AAMlE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC;;;;;;iBAQlF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;GAAwD,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;iBAG1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;iBAAwE,CAAC;AAErG;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD;;GAEG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC;;iBAIhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC;;;;;;;mBAE5E,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,WAAW,aAAqB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,SAAS,aAAmB,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,WAAW,aAAyC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAAwB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,oBAAoB,aAAoB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAA2B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,aAAa,wGAExB,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,0BAA0B,0DAErC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,qDAO3B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;iBAYpC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,108 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { z } from "zod";
+const NumericIdSchema = z.coerce.number().int().positive();
+const UuidSchema = z.string().uuid();
+const OptionalNumericIdSchema = NumericIdSchema.optional();
+const PaginationQuerySchema = z.object({
+  page: z.coerce.number().int().positive().default(1),
+  limit: z.coerce.number().int().positive().max(100).default(20)
+});
+const createPaginatedResponseSchema = /* @__PURE__ */ __name((itemSchema) => {
+  return z.object({
+    data: z.array(itemSchema),
+    total_items: z.number().int().nonnegative(),
+    page: z.number().int().positive(),
+    total_pages: z.number().int().nonnegative(),
+    limit: z.number().int().positive()
+  });
+}, "createPaginatedResponseSchema");
+const SortOrderSchema = z.enum(["ASC", "DESC", "asc", "desc"]).default("ASC");
+const SortQuerySchema = z.object({
+  sort: z.string().optional(),
+  "sort-order": SortOrderSchema.optional()
+});
+const SearchQuerySchema = z.object({
+  search: z.string().min(1).optional()
+});
+const ListQuerySchema = PaginationQuerySchema.merge(SortQuerySchema).merge(SearchQuerySchema);
+const createSuccessResponseSchema = /* @__PURE__ */ __name((dataSchema) => {
+  return z.object({
+    data: dataSchema
+  });
+}, "createSuccessResponseSchema");
+const ErrorResponseSchema = z.object({
+  error: z.string(),
+  message: z.string().optional(),
+  statusCode: z.number().int().optional(),
+  details: z.record(z.string(), z.unknown()).optional()
+});
+const createApiResponseSchema = /* @__PURE__ */ __name((dataSchema) => {
+  return z.union([createSuccessResponseSchema(dataSchema), ErrorResponseSchema]);
+}, "createApiResponseSchema");
+const EmailSchema = z.string().email();
+const UrlSchema = z.string().url();
+const PhoneSchema = z.string().regex(/^\+?[1-9]\d{1,14}$/);
+const DateStringSchema = z.string().datetime();
+const NonEmptyStringSchema = z.string().min(1);
+const TrimmedStringSchema = z.string().trim().min(1);
+const BooleanSchema = z.union([z.boolean(), z.string()]).transform((val) => {
+  return typeof val === "string" ? val === "true" : val;
+});
+const TimestampSchema = z.object({
+  createdAt: z.date(),
+  updatedAt: z.date()
+});
+const OptionalTimestampSchema = z.object({
+  createdAt: z.date().optional(),
+  updatedAt: z.date().optional()
+});
+const CommaSeparatedStringSchema = z.string().transform((val) => {
+  return val.split(",").map((item) => item.trim());
+});
+const JsonStringSchema = z.string().transform((str, _ctx) => {
+  try {
+    return JSON.parse(str);
+  } catch {
+    _ctx.addIssue({ code: "custom", message: "Invalid JSON string" });
+    return z.NEVER;
+  }
+});
+const HealthCheckResponseSchema = z.object({
+  status: z.enum(["healthy", "unhealthy", "degraded"]),
+  timestamp: z.string().datetime(),
+  services: z.record(
+    z.string(),
+    z.object({
+      status: z.enum(["up", "down", "degraded"]),
+      message: z.string().optional()
+    })
+  ).optional()
+});
+export {
+  BooleanSchema,
+  CommaSeparatedStringSchema,
+  DateStringSchema,
+  EmailSchema,
+  ErrorResponseSchema,
+  HealthCheckResponseSchema,
+  JsonStringSchema,
+  ListQuerySchema,
+  NonEmptyStringSchema,
+  NumericIdSchema,
+  OptionalNumericIdSchema,
+  OptionalTimestampSchema,
+  PaginationQuerySchema,
+  PhoneSchema,
+  SearchQuerySchema,
+  SortOrderSchema,
+  SortQuerySchema,
+  TimestampSchema,
+  TrimmedStringSchema,
+  UrlSchema,
+  UuidSchema,
+  createApiResponseSchema,
+  createPaginatedResponseSchema,
+  createSuccessResponseSchema
+};
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/schemas/common.ts"],
+  "sourcesContent": ["import { z } from 'zod';\n\n/**\n * Common Zod schemas for reuse across the framework\n */\n\n// ============================================================================\n// ID Schemas\n// ============================================================================\n\n/**\n * Numeric ID schema (positive integer)\n */\nexport const NumericIdSchema = z.coerce.number().int().positive();\n\n/**\n * UUID v4 schema\n */\nexport const UuidSchema = z.string().uuid();\n\n/**\n * Optional numeric ID (for updates where ID may not be required)\n */\nexport const OptionalNumericIdSchema = NumericIdSchema.optional();\n\n// ============================================================================\n// Pagination Schemas\n// ============================================================================\n\n/**\n * Pagination query parameters schema\n */\nexport const PaginationQuerySchema = z.object({\n  page: z.coerce.number().int().positive().default(1),\n  limit: z.coerce.number().int().positive().max(100).default(20),\n});\n\n/**\n * Inferred type for pagination query\n */\nexport type PaginationQuery = z.infer<typeof PaginationQuerySchema>;\n\n/**\n * Paginated response wrapper schema\n */\nexport const createPaginatedResponseSchema = <T extends z.ZodTypeAny>(itemSchema: T) => {\n  return z.object({\n    data: z.array(itemSchema),\n    total_items: z.number().int().nonnegative(),\n    page: z.number().int().positive(),\n    total_pages: z.number().int().nonnegative(),\n    limit: z.number().int().positive(),\n  });\n};\n\n/**\n * Helper type for paginated response\n */\nexport type PaginatedResponse<T> = {\n  data: T[];\n  total_items: number;\n  page: number;\n  total_pages: number;\n  limit: number;\n};\n\n// ============================================================================\n// Sorting & Filtering Schemas\n// ============================================================================\n\n/**\n * Sort order schema\n */\nexport const SortOrderSchema = z.enum(['ASC', 'DESC', 'asc', 'desc']).default('ASC');\n\n/**\n * Generic sort query schema\n */\nexport const SortQuerySchema = z.object({\n  sort: z.string().optional(),\n  'sort-order': SortOrderSchema.optional(),\n});\n\n/**\n * Search query schema\n */\nexport const SearchQuerySchema = z.object({\n  search: z.string().min(1).optional(),\n});\n\n/**\n * Combined list query schema (pagination + sorting + search)\n */\nexport const ListQuerySchema = PaginationQuerySchema.merge(SortQuerySchema).merge(SearchQuerySchema);\n\n/**\n * Inferred type for list query\n */\nexport type ListQuery = z.infer<typeof ListQuerySchema>;\n\n// ============================================================================\n// Response Schemas\n// ============================================================================\n\n/**\n * Success response wrapper schema\n */\nexport const createSuccessResponseSchema = <T extends z.ZodTypeAny>(dataSchema: T) => {\n  return z.object({\n    data: dataSchema,\n  });\n};\n\n/**\n * Error response schema\n */\nexport const ErrorResponseSchema = z.object({\n  error: z.string(),\n  message: z.string().optional(),\n  statusCode: z.number().int().optional(),\n  details: z.record(z.string(), z.unknown()).optional(),\n});\n\n/**\n * Inferred type for error response\n */\nexport type ErrorResponse = z.infer<typeof ErrorResponseSchema>;\n\n/**\n * Generic API response schema (success or error)\n */\nexport const createApiResponseSchema = <T extends z.ZodTypeAny>(dataSchema: T) => {\n  return z.union([createSuccessResponseSchema(dataSchema), ErrorResponseSchema]);\n};\n\n// ============================================================================\n// Common Field Schemas\n// ============================================================================\n\n/**\n * Email schema\n */\nexport const EmailSchema = z.string().email();\n\n/**\n * URL schema\n */\nexport const UrlSchema = z.string().url();\n\n/**\n * Phone number schema (basic validation)\n */\nexport const PhoneSchema = z.string().regex(/^\\+?[1-9]\\d{1,14}$/);\n\n/**\n * Date string schema (ISO 8601)\n */\nexport const DateStringSchema = z.string().datetime();\n\n/**\n * Non-empty string schema\n */\nexport const NonEmptyStringSchema = z.string().min(1);\n\n/**\n * Trimmed non-empty string schema\n */\nexport const TrimmedStringSchema = z.string().trim().min(1);\n\n/**\n * Boolean schema with string coercion\n */\nexport const BooleanSchema = z.union([z.boolean(), z.string()]).transform(val => {\n  return typeof val === 'string' ? val === 'true' : val;\n});\n\n// ============================================================================\n// Timestamp Schemas\n// ============================================================================\n\n/**\n * Created/Updated timestamp schema\n */\nexport const TimestampSchema = z.object({\n  createdAt: z.date(),\n  updatedAt: z.date(),\n});\n\n/**\n * Optional timestamp schema\n */\nexport const OptionalTimestampSchema = z.object({\n  createdAt: z.date().optional(),\n  updatedAt: z.date().optional(),\n});\n\n// ============================================================================\n// Utility Schemas\n// ============================================================================\n\n/**\n * Comma-separated string to array transformer\n */\nexport const CommaSeparatedStringSchema = z.string().transform(val => {\n  return val.split(',').map(item => item.trim());\n});\n\n/**\n * JSON string schema (parses JSON string to object)\n */\nexport const JsonStringSchema = z.string().transform((str, _ctx) => {\n  try {\n    return JSON.parse(str);\n  } catch {\n    _ctx.addIssue({ code: 'custom', message: 'Invalid JSON string' });\n    return z.NEVER;\n  }\n});\n\n// ============================================================================\n// Health Check Schemas\n// ============================================================================\n\n/**\n * Health check response schema\n */\nexport const HealthCheckResponseSchema = z.object({\n  status: z.enum(['healthy', 'unhealthy', 'degraded']),\n  timestamp: z.string().datetime(),\n  services: z\n    .record(\n      z.string(),\n      z.object({\n        status: z.enum(['up', 'down', 'degraded']),\n        message: z.string().optional(),\n      }),\n    )\n    .optional(),\n});\n\n/**\n * Inferred type for health check response\n */\nexport type HealthCheckResponse = z.infer<typeof HealthCheckResponseSchema>;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/schemas/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Common Zod schemas for validation and type inference
+ * @module schemas
+ */
+export * from './common.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,2 @@
+export * from "./common.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/schemas/index.ts"],
+  "sourcesContent": ["/**\n * Common Zod schemas for validation and type inference\n * @module schemas\n */\n\nexport * from './common.js';\n"],
+  "mappings": "AAKA,cAAc;",
+  "names": []
+}

package/dist/util/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/util/loader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;CAClB;AAgFD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;;6BAlE/B,CAAC,wCAGpC;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,KAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;uBA8DO,CAAC,gDAG9B;QACD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;4BAkCE,IAAI;yBAKP;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;;AAO3E,wBAKE"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/util/loader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;CAClB;AAiFD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;;6BAnE/B,CAAC,wCAGpC;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,KAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;uBA+DO,CAAC,gDAG9B;QACD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;4BAkCE,IAAI;yBAKP;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;;AAO3E,wBAKE"}

package/dist/util/loader.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/loader.ts"],
-  "sourcesContent": ["import fs from 'fs';\nimport path from 'path';\nimport { LRUCache } from 'lru-cache';\nimport { Helper } from './index.js';\n\n// Type for a map of loaded modules\nexport interface ModuleMap<T = unknown> {\n  [key: string]: T;\n}\n\n// Cache for loaded modules to avoid repeated imports\n// Using LRU cache to prevent unbounded memory growth in long-running processes\nconst moduleCache = new LRUCache<string, ModuleMap>({\n  max: 100, // Max 100 directories cached\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst entityCache = new LRUCache<string, EntityClass>({\n  max: 500, // Max 500 entities cached (accessed more frequently than modules)\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst loadModulesInDirectory = async <T = unknown>({\n  directory,\n  extensions,\n}: {\n  directory: string;\n  extensions?: string[];\n}): Promise<ModuleMap<T>> => {\n  // Create cache key based on directory and extensions\n  const cacheKey = `${directory}:${extensions?.join(',') ?? 'all'}`;\n\n  // Check cache first\n  if (moduleCache.has(cacheKey)) {\n    const cachedModule = moduleCache.get(cacheKey);\n    if (cachedModule) {\n      return cachedModule as ModuleMap<T>;\n    }\n  }\n\n  const loadedModules: ModuleMap<T> = {};\n\n  // Use readdir with withFileTypes option to avoid separate stat calls\n  const dirents = await fs.promises.readdir(directory, { withFileTypes: true });\n\n  for (const dirent of dirents) {\n    // Skip directories without needing stat call\n    if (dirent.isDirectory()) {\n      continue;\n    }\n\n    const file = dirent.name;\n    const ext = path.extname(file);\n    const isDeclarationFile = file.endsWith('.d.ts');\n\n    // Skip files that are not in the specified extensions or are .d.ts files\n    if ((extensions && extensions.length > 0 && !extensions.includes(ext)) || isDeclarationFile) {\n      continue;\n    }\n\n    const moduleName = path.basename(file, ext);\n    const filePath = path.join(directory, file);\n    // Convert to absolute path for ESM import\n    const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);\n    // Use file:// URL for Windows compatibility\n    const fileUrl = `file://${absolutePath.replace(/\\\\/g, '/')}`;\n\n    try {\n      const importedModule = await import(fileUrl);\n\n      // Use safe property assignment to prevent prototype pollution\n      if (moduleName !== '__proto__' && moduleName !== 'constructor' && moduleName !== 'prototype') {\n        // Prefer default export, but fall back to the entire module if no default\n        const moduleExport = importedModule.default ?? importedModule;\n        Reflect.set(loadedModules, moduleName, moduleExport);\n      }\n    } catch (error) {\n      console.error(`Failed to import module ${filePath}:`, error);\n    }\n  }\n\n  // Cache the results for future use\n  moduleCache.set(cacheKey, loadedModules);\n\n  return loadedModules;\n};\n\n// Type constraint for entity classes (must be constructable)\nexport type EntityClass<T = unknown> = new (...args: unknown[]) => T;\n\nconst loadEntityModule = async <T = unknown>({\n  entitiesDirectory,\n  entityName,\n}: {\n  entitiesDirectory: string;\n  entityName: string;\n}): Promise<EntityClass<T>> => {\n  // Create cache key based on directory and entity name\n  const cacheKey = `${entitiesDirectory}:${entityName}`;\n\n  // Check cache first\n  if (entityCache.has(cacheKey)) {\n    return entityCache.get(cacheKey) as EntityClass<T>;\n  }\n\n  // Define entity module path\n  const entityModulePath = path.join(entitiesDirectory, `${entityName}.${Helper.getScriptFileExtension()}`);\n\n  // Import entity module\n  const entityModule = await import(entityModulePath);\n\n  // Safe property access to prevent prototype pollution\n  if (entityName === '__proto__' || entityName === 'constructor' || entityName === 'prototype') {\n    throw new Error(`Invalid entity name (Entity: ${entityName})`);\n  }\n\n  if (!entityModule || !Object.prototype.hasOwnProperty.call(entityModule, entityName)) {\n    throw new Error(`Entity not found (Entity: ${entityName})`);\n  }\n\n  // Get entity class\n  const EntityClass = Reflect.get(entityModule, entityName);\n\n  // Cache the entity for future use\n  entityCache.set(cacheKey, EntityClass);\n\n  return EntityClass;\n};\n\n// Cache management functions for development/testing\nconst clearModuleCache = (): void => {\n  moduleCache.clear();\n  entityCache.clear();\n};\n\nconst getCacheStats = (): { modulesCached: number; entitiesCached: number } => {\n  return {\n    modulesCached: moduleCache.size,\n    entitiesCached: entityCache.size,\n  };\n};\n\nexport default {\n  loadModulesInDirectory,\n  loadEntityModule,\n  clearModuleCache,\n  getCacheStats,\n};\n"],
-  "mappings": ";;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,gBAAgB;AACzB,SAAS,cAAc;AASvB,MAAM,cAAc,IAAI,SAA4B;AAAA,EAClD,KAAK;AAAA;AAAA,EACL,KAAK,MAAO,KAAK;AAAA;AACnB,CAAC;AAED,MAAM,cAAc,IAAI,SAA8B;AAAA,EACpD,KAAK;AAAA;AAAA,EACL,KAAK,MAAO,KAAK;AAAA;AACnB,CAAC;AAED,MAAM,yBAAyB,8BAAoB;AAAA,EACjD;AAAA,EACA;AACF,MAG6B;AAE3B,QAAM,WAAW,GAAG,SAAS,IAAI,YAAY,KAAK,GAAG,KAAK,KAAK;AAG/D,MAAI,YAAY,IAAI,QAAQ,GAAG;AAC7B,UAAM,eAAe,YAAY,IAAI,QAAQ;AAC7C,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,gBAA8B,CAAC;AAGrC,QAAM,UAAU,MAAM,GAAG,SAAS,QAAQ,WAAW,EAAE,eAAe,KAAK,CAAC;AAE5E,aAAW,UAAU,SAAS;AAE5B,QAAI,OAAO,YAAY,GAAG;AACxB;AAAA,IACF;AAEA,UAAM,OAAO,OAAO;AACpB,UAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,UAAM,oBAAoB,KAAK,SAAS,OAAO;AAG/C,QAAK,cAAc,WAAW,SAAS,KAAK,CAAC,WAAW,SAAS,GAAG,KAAM,mBAAmB;AAC3F;AAAA,IACF;AAEA,UAAM,aAAa,KAAK,SAAS,MAAM,GAAG;AAC1C,UAAM,WAAW,KAAK,KAAK,WAAW,IAAI;AAE1C,UAAM,eAAe,KAAK,WAAW,QAAQ,IAAI,WAAW,KAAK,QAAQ,QAAQ;AAEjF,UAAM,UAAU,UAAU,aAAa,QAAQ,OAAO,GAAG,CAAC;AAE1D,QAAI;AACF,YAAM,iBAAiB,MAAM,OAAO;AAGpC,UAAI,eAAe,eAAe,eAAe,iBAAiB,eAAe,aAAa;AAE5F,cAAM,eAAe,eAAe,WAAW;AAC/C,gBAAQ,IAAI,eAAe,YAAY,YAAY;AAAA,MACrD;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,2BAA2B,QAAQ,KAAK,KAAK;AAAA,IAC7D;AAAA,EACF;AAGA,cAAY,IAAI,UAAU,aAAa;AAEvC,SAAO;AACT,GA/D+B;AAoE/B,MAAM,mBAAmB,8BAAoB;AAAA,EAC3C;AAAA,EACA;AACF,MAG+B;AAE7B,QAAM,WAAW,GAAG,iBAAiB,IAAI,UAAU;AAGnD,MAAI,YAAY,IAAI,QAAQ,GAAG;AAC7B,WAAO,YAAY,IAAI,QAAQ;AAAA,EACjC;AAGA,QAAM,mBAAmB,KAAK,KAAK,mBAAmB,GAAG,UAAU,IAAI,OAAO,uBAAuB,CAAC,EAAE;AAGxG,QAAM,eAAe,MAAM,OAAO;AAGlC,MAAI,eAAe,eAAe,eAAe,iBAAiB,eAAe,aAAa;AAC5F,UAAM,IAAI,MAAM,gCAAgC,UAAU,GAAG;AAAA,EAC/D;AAEA,MAAI,CAAC,gBAAgB,CAAC,OAAO,UAAU,eAAe,KAAK,cAAc,UAAU,GAAG;AACpF,UAAM,IAAI,MAAM,6BAA6B,UAAU,GAAG;AAAA,EAC5D;AAGA,QAAM,cAAc,QAAQ,IAAI,cAAc,UAAU;AAGxD,cAAY,IAAI,UAAU,WAAW;AAErC,SAAO;AACT,GArCyB;AAwCzB,MAAM,mBAAmB,6BAAY;AACnC,cAAY,MAAM;AAClB,cAAY,MAAM;AACpB,GAHyB;AAKzB,MAAM,gBAAgB,6BAAyD;AAC7E,SAAO;AAAA,IACL,eAAe,YAAY;AAAA,IAC3B,gBAAgB,YAAY;AAAA,EAC9B;AACF,GALsB;AAOtB,IAAO,iBAAQ;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "sourcesContent": ["import fs from 'fs';\nimport path from 'path';\nimport { LRUCache } from 'lru-cache';\nimport { Helper } from './index.js';\n\n// Type for a map of loaded modules\nexport interface ModuleMap<T = unknown> {\n  [key: string]: T;\n}\n\n// Cache for loaded modules to avoid repeated imports\n// Using LRU cache to prevent unbounded memory growth in long-running processes\nconst moduleCache = new LRUCache<string, ModuleMap>({\n  max: 100, // Max 100 directories cached\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst entityCache = new LRUCache<string, EntityClass>({\n  max: 500, // Max 500 entities cached (accessed more frequently than modules)\n  ttl: 1000 * 60 * 10, // 10 minutes\n});\n\nconst loadModulesInDirectory = async <T = unknown>({\n  directory,\n  extensions,\n}: {\n  directory: string;\n  extensions?: string[];\n}): Promise<ModuleMap<T>> => {\n  // Create cache key based on directory and extensions\n  const cacheKey = `${directory}:${extensions?.join(',') ?? 'all'}`;\n\n  // Check cache first\n  if (moduleCache.has(cacheKey)) {\n    const cachedModule = moduleCache.get(cacheKey);\n    if (cachedModule) {\n      return cachedModule as ModuleMap<T>;\n    }\n  }\n\n  const loadedModules: ModuleMap<T> = {};\n\n  // Use readdir with withFileTypes option to avoid separate stat calls\n  const dirents = await fs.promises.readdir(directory, { withFileTypes: true });\n\n  for (const dirent of dirents) {\n    // Skip directories without needing stat call\n    if (dirent.isDirectory()) {\n      continue;\n    }\n\n    const file = dirent.name;\n    const ext = path.extname(file);\n    const isDeclarationFile = file.endsWith('.d.ts');\n\n    // Skip files that are not in the specified extensions or are .d.ts files\n    if ((extensions && extensions.length > 0 && !extensions.includes(ext)) || isDeclarationFile) {\n      continue;\n    }\n\n    const moduleName = path.basename(file, ext);\n    const filePath = path.join(directory, file);\n    // Convert to absolute path for ESM import\n    const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);\n    // Use file:// URL for Windows compatibility\n    const fileUrl = `file://${absolutePath.replace(/\\\\/g, '/')}`;\n\n    try {\n      const importedModule = await import(fileUrl);\n\n      // Use safe property assignment to prevent prototype pollution\n      if (moduleName !== '__proto__' && moduleName !== 'constructor' && moduleName !== 'prototype') {\n        // Prefer default export, but fall back to the entire module if no default\n        const moduleExport = importedModule.default ?? importedModule;\n        Reflect.set(loadedModules, moduleName, moduleExport);\n      }\n    } catch (error) {\n      // Note: console.error used here as Logger may not be initialized during early bootstrap\n      console.error(`Failed to import module ${filePath}:`, error);\n    }\n  }\n\n  // Cache the results for future use\n  moduleCache.set(cacheKey, loadedModules);\n\n  return loadedModules;\n};\n\n// Type constraint for entity classes (must be constructable)\nexport type EntityClass<T = unknown> = new (...args: unknown[]) => T;\n\nconst loadEntityModule = async <T = unknown>({\n  entitiesDirectory,\n  entityName,\n}: {\n  entitiesDirectory: string;\n  entityName: string;\n}): Promise<EntityClass<T>> => {\n  // Create cache key based on directory and entity name\n  const cacheKey = `${entitiesDirectory}:${entityName}`;\n\n  // Check cache first\n  if (entityCache.has(cacheKey)) {\n    return entityCache.get(cacheKey) as EntityClass<T>;\n  }\n\n  // Define entity module path\n  const entityModulePath = path.join(entitiesDirectory, `${entityName}.${Helper.getScriptFileExtension()}`);\n\n  // Import entity module\n  const entityModule = await import(entityModulePath);\n\n  // Safe property access to prevent prototype pollution\n  if (entityName === '__proto__' || entityName === 'constructor' || entityName === 'prototype') {\n    throw new Error(`Invalid entity name (Entity: ${entityName})`);\n  }\n\n  if (!entityModule || !Object.prototype.hasOwnProperty.call(entityModule, entityName)) {\n    throw new Error(`Entity not found (Entity: ${entityName})`);\n  }\n\n  // Get entity class\n  const EntityClass = Reflect.get(entityModule, entityName);\n\n  // Cache the entity for future use\n  entityCache.set(cacheKey, EntityClass);\n\n  return EntityClass;\n};\n\n// Cache management functions for development/testing\nconst clearModuleCache = (): void => {\n  moduleCache.clear();\n  entityCache.clear();\n};\n\nconst getCacheStats = (): { modulesCached: number; entitiesCached: number } => {\n  return {\n    modulesCached: moduleCache.size,\n    entitiesCached: entityCache.size,\n  };\n};\n\nexport default {\n  loadModulesInDirectory,\n  loadEntityModule,\n  clearModuleCache,\n  getCacheStats,\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/webserver/controller/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAc,CAC1C,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,cAAc,SAAS,aAAa,GAAG,aAAa,EACpD,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,iBAAiB,SAAS,gBAAgB,GAAG,gBAAgB;IAE7D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC/C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC;IACxC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;IACtC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;IACtC,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC9C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEjC,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,wCAAwC,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,CAAC;IAa5G,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,EACzC,KAAK,EACL,IAAI,EACJ,UAA2B,EAC3B,IAAI,GACL,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC;QACR,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;KAC/B;IAYD,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,MAA6B;IAW1F,SAAS,CAAC,iBAAiB,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,UAAoC,EACpC,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC9B;IA6CD,OAAO,CAAC,YAAY;cAoBJ,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAwErH"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/webserver/controller/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAI7E,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAc,CAC1C,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,cAAc,SAAS,aAAa,GAAG,aAAa,EACpD,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,iBAAiB,SAAS,gBAAgB,GAAG,gBAAgB;IAE7D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC/C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC;IACxC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;IACtC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC;IACtC,SAAS,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC9C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEjC,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,wCAAwC,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,CAAC;IAa5G,SAAS,CAAC,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,EACzC,KAAK,EACL,IAAI,EACJ,UAA2B,EAC3B,IAAI,GACL,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC;QACR,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;KAC/B;IAYD,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,MAA6B;IAW1F,SAAS,CAAC,iBAAiB,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,UAAoC,EACpC,SAAS,GACV,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC9B;IA4CD,OAAO,CAAC,YAAY;cAoBJ,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAwErH"}

package/dist/webserver/controller/base.js

@@ -4,6 +4,7 @@ import { StatusCodes } from "http-status-codes";
 import { Logger } from "../../logger/index.js";
 import cluster from "cluster";
 import Jwt from "../../auth/jwt.js";
+import { safeSerializeError } from "../../error/error-reporter.js";
 class BaseController {
   static {
     __name(this, "BaseController");
@@ -73,7 +74,7 @@ class BaseController {
         publicErrorMessage = error.stack ?? error.message;
         errorDetails = { stack: error.stack, name: error.name };
       } else {
-        publicErrorMessage = String(error);
+        publicErrorMessage = safeSerializeError(error);
       }
     } else {
       if (process.env.NODE_ENV === "production") {
@@ -89,12 +90,11 @@ class BaseController {
           publicErrorMessage = error.stack ?? error.message;
           errorDetails = { stack: error.stack, name: error.name };
         } else {
-          publicErrorMessage = String(error);
+          publicErrorMessage = safeSerializeError(error);
         }
       }
     }
-    Logger.custom({ level: "webServer", message: error });
-    console.error(error);
+    Logger.error({ error });
     const apiError = {
       message: publicErrorMessage,
       type: errorType ?? this.getErrorType(statusCode),

package/dist/webserver/controller/base.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/webserver/controller/base.ts"],
-  "sourcesContent": ["import { StatusCodes } from 'http-status-codes';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { QueueManager } from '../../queue/index.js';\nimport type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\nimport type EventManager from '../../event/manager.js';\nimport cluster from 'cluster';\nimport type { WebServerOptions } from '../webserver.interface.js';\nimport type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';\nimport Jwt from '../../auth/jwt.js';\n\nexport interface AuthenticatedUser<TPayload = Record<string, unknown>> {\n  userId: number;\n  payload: TPayload;\n}\n\nexport default abstract class BaseController<\n  TQueueManager extends QueueManager = QueueManager,\n  TRedisInstance extends RedisInstance = RedisInstance,\n  TEventManager extends EventManager = EventManager,\n  TDatabaseInstance extends DatabaseInstance = DatabaseInstance,\n> {\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n  protected webServerOptions: WebServerOptions;\n\n  protected redisInstance: TRedisInstance;\n  protected queueManager: TQueueManager;\n  protected eventManager: TEventManager;\n  protected databaseInstance: TDatabaseInstance;\n  protected lifecycleManager: LifecycleManager;\n\n  constructor({\n    applicationConfig,\n    webServerOptions,\n    redisInstance,\n    queueManager,\n    eventManager,\n    databaseInstance,\n    lifecycleManager,\n  }: WebServerBaseControllerConstructorParams<TQueueManager, TRedisInstance, TEventManager, TDatabaseInstance>) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n    this.webServerOptions = webServerOptions;\n\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.eventManager = eventManager;\n    this.databaseInstance = databaseInstance;\n    this.lifecycleManager = lifecycleManager;\n  }\n\n  protected sendSuccessResponse<T = unknown>({\n    reply,\n    data,\n    statusCode = StatusCodes.OK,\n    meta,\n  }: {\n    reply: FastifyReply;\n    data: T;\n    statusCode?: StatusCodes;\n    meta?: ApiResponse<T>['meta'];\n  }) {\n    const response: ApiResponse<T> = {\n      data,\n      meta: {\n        timestamp: new Date().toISOString(),\n        requestId: reply.request.id || 'unknown',\n        ...meta,\n      },\n    };\n    reply.status(statusCode).send(response);\n  }\n\n  protected sendNotFoundResponse(reply: FastifyReply, message: string = 'Resource not found') {\n    const error: ApiError = {\n      message,\n      type: 'not_found',\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n    };\n    const response: ApiResponse = { error };\n    reply.status(StatusCodes.NOT_FOUND).send(response);\n  }\n\n  protected sendErrorResponse({\n    reply,\n    error,\n    statusCode = StatusCodes.BAD_REQUEST,\n    errorType,\n  }: {\n    reply: FastifyReply;\n    error: unknown;\n    statusCode?: StatusCodes;\n    errorType?: ApiError['type'];\n  }) {\n    let publicErrorMessage: string;\n    let errorDetails: Record<string, unknown> | undefined = undefined;\n\n    if (this.webServerOptions.errors?.verbose === true) {\n      if (error instanceof Error) {\n        publicErrorMessage = error.stack ?? error.message;\n        errorDetails = { stack: error.stack, name: error.name };\n      } else {\n        publicErrorMessage = String(error);\n      }\n    } else {\n      if (process.env.NODE_ENV === 'production') {\n        if (error instanceof Error) {\n          publicErrorMessage = 'Something went wrong';\n        } else if (typeof error === 'string') {\n          publicErrorMessage = error;\n        } else {\n          publicErrorMessage = 'An unknown error occurred';\n        }\n      } else {\n        if (error instanceof Error) {\n          publicErrorMessage = error.stack ?? error.message;\n          errorDetails = { stack: error.stack, name: error.name };\n        } else {\n          publicErrorMessage = String(error);\n        }\n      }\n    }\n\n    Logger.custom({ level: 'webServer', message: error });\n    console.error(error);\n\n    const apiError: ApiError = {\n      message: publicErrorMessage,\n      type: errorType ?? this.getErrorType(statusCode),\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n      ...(errorDetails && { details: errorDetails }),\n    };\n\n    const response: ApiResponse = { error: apiError };\n    reply.status(statusCode).send(response);\n  }\n\n  private getErrorType(statusCode: StatusCodes): ApiError['type'] {\n    switch (statusCode) {\n      case StatusCodes.UNAUTHORIZED:\n        return 'authentication';\n      case StatusCodes.FORBIDDEN:\n        return 'authorization';\n      case StatusCodes.NOT_FOUND:\n        return 'not_found';\n      case StatusCodes.BAD_REQUEST:\n      case StatusCodes.UNPROCESSABLE_ENTITY:\n        return 'validation';\n      case StatusCodes.INTERNAL_SERVER_ERROR:\n      case StatusCodes.BAD_GATEWAY:\n      case StatusCodes.SERVICE_UNAVAILABLE:\n        return 'server_error';\n      default:\n        return 'client_error';\n    }\n  }\n\n  protected async authenticateRequest(request: FastifyRequest, reply: FastifyReply): Promise<AuthenticatedUser | null> {\n    // Get JWT secret key from application config\n    const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;\n\n    if (!jwtSecretKey) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Authentication not configured.',\n        statusCode: StatusCodes.INTERNAL_SERVER_ERROR,\n        errorType: 'server_error',\n      });\n      return null;\n    }\n\n    const authHeader = request.headers.authorization;\n\n    if (!authHeader) {\n      this.sendErrorResponse({\n        reply,\n        error: 'No token provided.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    if (!authHeader.startsWith('Bearer ')) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    try {\n      const importedJwtSecretKey = await Jwt.importJwtSecretKey({\n        jwtSecretKey,\n      });\n\n      // Remove \"Bearer \" from token\n      const jwtAccessToken = authHeader.substring(7);\n\n      const { payload } = await Jwt.jwtVerify(jwtAccessToken, importedJwtSecretKey);\n\n      if (!payload.sub) {\n        this.sendErrorResponse({\n          reply,\n          error: 'Invalid token payload.',\n          statusCode: StatusCodes.UNAUTHORIZED,\n          errorType: 'authentication',\n        });\n        return null;\n      }\n\n      const userId = parseInt(payload.sub);\n\n      return {\n        userId,\n        payload,\n      };\n    } catch {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid or expired token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { StatusCodes } from 'http-status-codes';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport type { DatabaseInstance } from '../../database/index.js';\nimport type { RedisInstance } from '../../redis/index.js';\nimport type { QueueManager } from '../../queue/index.js';\nimport type { ApiError, ApiResponse, WebServerBaseControllerConstructorParams } from './base.interface.js';\nimport { Logger } from '../../logger/index.js';\nimport type { ApplicationConfig } from '../../application/base-application.interface.js';\nimport type EventManager from '../../event/manager.js';\nimport cluster from 'cluster';\nimport type { WebServerOptions } from '../webserver.interface.js';\nimport type { LifecycleManager } from '../../lifecycle/lifecycle-manager.js';\nimport Jwt from '../../auth/jwt.js';\nimport { safeSerializeError } from '../../error/error-reporter.js';\n\nexport interface AuthenticatedUser<TPayload = Record<string, unknown>> {\n  userId: number;\n  payload: TPayload;\n}\n\nexport default abstract class BaseController<\n  TQueueManager extends QueueManager = QueueManager,\n  TRedisInstance extends RedisInstance = RedisInstance,\n  TEventManager extends EventManager = EventManager,\n  TDatabaseInstance extends DatabaseInstance = DatabaseInstance,\n> {\n  protected workerId: number | undefined;\n\n  protected applicationConfig: ApplicationConfig;\n  protected webServerOptions: WebServerOptions;\n\n  protected redisInstance: TRedisInstance;\n  protected queueManager: TQueueManager;\n  protected eventManager: TEventManager;\n  protected databaseInstance: TDatabaseInstance;\n  protected lifecycleManager: LifecycleManager;\n\n  constructor({\n    applicationConfig,\n    webServerOptions,\n    redisInstance,\n    queueManager,\n    eventManager,\n    databaseInstance,\n    lifecycleManager,\n  }: WebServerBaseControllerConstructorParams<TQueueManager, TRedisInstance, TEventManager, TDatabaseInstance>) {\n    this.workerId = cluster.worker?.id;\n\n    this.applicationConfig = applicationConfig;\n    this.webServerOptions = webServerOptions;\n\n    this.redisInstance = redisInstance;\n    this.queueManager = queueManager;\n    this.eventManager = eventManager;\n    this.databaseInstance = databaseInstance;\n    this.lifecycleManager = lifecycleManager;\n  }\n\n  protected sendSuccessResponse<T = unknown>({\n    reply,\n    data,\n    statusCode = StatusCodes.OK,\n    meta,\n  }: {\n    reply: FastifyReply;\n    data: T;\n    statusCode?: StatusCodes;\n    meta?: ApiResponse<T>['meta'];\n  }) {\n    const response: ApiResponse<T> = {\n      data,\n      meta: {\n        timestamp: new Date().toISOString(),\n        requestId: reply.request.id || 'unknown',\n        ...meta,\n      },\n    };\n    reply.status(statusCode).send(response);\n  }\n\n  protected sendNotFoundResponse(reply: FastifyReply, message: string = 'Resource not found') {\n    const error: ApiError = {\n      message,\n      type: 'not_found',\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n    };\n    const response: ApiResponse = { error };\n    reply.status(StatusCodes.NOT_FOUND).send(response);\n  }\n\n  protected sendErrorResponse({\n    reply,\n    error,\n    statusCode = StatusCodes.BAD_REQUEST,\n    errorType,\n  }: {\n    reply: FastifyReply;\n    error: unknown;\n    statusCode?: StatusCodes;\n    errorType?: ApiError['type'];\n  }) {\n    let publicErrorMessage: string;\n    let errorDetails: Record<string, unknown> | undefined = undefined;\n\n    if (this.webServerOptions.errors?.verbose === true) {\n      if (error instanceof Error) {\n        publicErrorMessage = error.stack ?? error.message;\n        errorDetails = { stack: error.stack, name: error.name };\n      } else {\n        publicErrorMessage = safeSerializeError(error);\n      }\n    } else {\n      if (process.env.NODE_ENV === 'production') {\n        if (error instanceof Error) {\n          publicErrorMessage = 'Something went wrong';\n        } else if (typeof error === 'string') {\n          publicErrorMessage = error;\n        } else {\n          publicErrorMessage = 'An unknown error occurred';\n        }\n      } else {\n        if (error instanceof Error) {\n          publicErrorMessage = error.stack ?? error.message;\n          errorDetails = { stack: error.stack, name: error.name };\n        } else {\n          publicErrorMessage = safeSerializeError(error);\n        }\n      }\n    }\n\n    Logger.error({ error });\n\n    const apiError: ApiError = {\n      message: publicErrorMessage,\n      type: errorType ?? this.getErrorType(statusCode),\n      timestamp: new Date().toISOString(),\n      requestId: reply.request.id || 'unknown',\n      ...(errorDetails && { details: errorDetails }),\n    };\n\n    const response: ApiResponse = { error: apiError };\n    reply.status(statusCode).send(response);\n  }\n\n  private getErrorType(statusCode: StatusCodes): ApiError['type'] {\n    switch (statusCode) {\n      case StatusCodes.UNAUTHORIZED:\n        return 'authentication';\n      case StatusCodes.FORBIDDEN:\n        return 'authorization';\n      case StatusCodes.NOT_FOUND:\n        return 'not_found';\n      case StatusCodes.BAD_REQUEST:\n      case StatusCodes.UNPROCESSABLE_ENTITY:\n        return 'validation';\n      case StatusCodes.INTERNAL_SERVER_ERROR:\n      case StatusCodes.BAD_GATEWAY:\n      case StatusCodes.SERVICE_UNAVAILABLE:\n        return 'server_error';\n      default:\n        return 'client_error';\n    }\n  }\n\n  protected async authenticateRequest(request: FastifyRequest, reply: FastifyReply): Promise<AuthenticatedUser | null> {\n    // Get JWT secret key from application config\n    const jwtSecretKey = this.applicationConfig.auth?.jwtSecretKey;\n\n    if (!jwtSecretKey) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Authentication not configured.',\n        statusCode: StatusCodes.INTERNAL_SERVER_ERROR,\n        errorType: 'server_error',\n      });\n      return null;\n    }\n\n    const authHeader = request.headers.authorization;\n\n    if (!authHeader) {\n      this.sendErrorResponse({\n        reply,\n        error: 'No token provided.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    if (!authHeader.startsWith('Bearer ')) {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n\n    try {\n      const importedJwtSecretKey = await Jwt.importJwtSecretKey({\n        jwtSecretKey,\n      });\n\n      // Remove \"Bearer \" from token\n      const jwtAccessToken = authHeader.substring(7);\n\n      const { payload } = await Jwt.jwtVerify(jwtAccessToken, importedJwtSecretKey);\n\n      if (!payload.sub) {\n        this.sendErrorResponse({\n          reply,\n          error: 'Invalid token payload.',\n          statusCode: StatusCodes.UNAUTHORIZED,\n          errorType: 'authentication',\n        });\n        return null;\n      }\n\n      const userId = parseInt(payload.sub);\n\n      return {\n        userId,\n        payload,\n      };\n    } catch {\n      this.sendErrorResponse({\n        reply,\n        error: 'Invalid or expired token.',\n        statusCode: StatusCodes.UNAUTHORIZED,\n        errorType: 'authentication',\n      });\n      return null;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }