@scpxl/nodejs-framework 1.0.22 → 1.0.25

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": ";;AAAA,SAAS,SAAS;AAaX,MAAM,kBAAkB,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS;AAKzD,MAAM,aAAa,EAAE,OAAO,EAAE,KAAK;AAKnC,MAAM,0BAA0B,gBAAgB,SAAS;AASzD,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,MAAM,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;AAAA,EAClD,OAAO,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE;AAC/D,CAAC;AAUM,MAAM,gCAAgC,wBAAyB,eAAkB;AACtF,SAAO,EAAE,OAAO;AAAA,IACd,MAAM,EAAE,MAAM,UAAU;AAAA,IACxB,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,IAC1C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,IAChC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,IAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACnC,CAAC;AACH,GAR6C;AA4BtC,MAAM,kBAAkB,EAAE,KAAK,CAAC,OAAO,QAAQ,OAAO,MAAM,CAAC,EAAE,QAAQ,KAAK;AAK5E,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,cAAc,gBAAgB,SAAS;AACzC,CAAC;AAKM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AACrC,CAAC;AAKM,MAAM,kBAAkB,sBAAsB,MAAM,eAAe,EAAE,MAAM,iBAAiB;AAc5F,MAAM,8BAA8B,wBAAyB,eAAkB;AACpF,SAAO,EAAE,OAAO;AAAA,IACd,MAAM;AAAA,EACR,CAAC;AACH,GAJ2C;AASpC,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,OAAO,EAAE,OAAO;AAAA,EAChB,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACtC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS;AACtD,CAAC;AAUM,MAAM,0BAA0B,wBAAyB,eAAkB;AAChF,SAAO,EAAE,MAAM,CAAC,4BAA4B,UAAU,GAAG,mBAAmB,CAAC;AAC/E,GAFuC;AAWhC,MAAM,cAAc,EAAE,OAAO,EAAE,MAAM;AAKrC,MAAM,YAAY,EAAE,OAAO,EAAE,IAAI;AAKjC,MAAM,cAAc,EAAE,OAAO,EAAE,MAAM,oBAAoB;AAKzD,MAAM,mBAAmB,EAAE,OAAO,EAAE,SAAS;AAK7C,MAAM,uBAAuB,EAAE,OAAO,EAAE,IAAI,CAAC;AAK7C,MAAM,sBAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;AAKnD,MAAM,gBAAgB,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,UAAU,SAAO;AAC/E,SAAO,OAAO,QAAQ,WAAW,QAAQ,SAAS;AACpD,CAAC;AASM,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,WAAW,EAAE,KAAK;AAAA,EAClB,WAAW,EAAE,KAAK;AACpB,CAAC;AAKM,MAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,WAAW,EAAE,KAAK,EAAE,SAAS;AAAA,EAC7B,WAAW,EAAE,KAAK,EAAE,SAAS;AAC/B,CAAC;AASM,MAAM,6BAA6B,EAAE,OAAO,EAAE,UAAU,SAAO;AACpE,SAAO,IAAI,MAAM,GAAG,EAAE,IAAI,UAAQ,KAAK,KAAK,CAAC;AAC/C,CAAC;AAKM,MAAM,mBAAmB,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,SAAS;AAClE,MAAI;AACF,WAAO,KAAK,MAAM,GAAG;AAAA,EACvB,QAAQ;AACN,SAAK,SAAS,EAAE,MAAM,UAAU,SAAS,sBAAsB,CAAC;AAChE,WAAO,EAAE;AAAA,EACX;AACF,CAAC;AASM,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,QAAQ,EAAE,KAAK,CAAC,WAAW,aAAa,UAAU,CAAC;AAAA,EACnD,WAAW,EAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,UAAU,EACP;AAAA,IACC,EAAE,OAAO;AAAA,IACT,EAAE,OAAO;AAAA,MACP,QAAQ,EAAE,KAAK,CAAC,MAAM,QAAQ,UAAU,CAAC;AAAA,MACzC,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,IAC/B,CAAC;AAAA,EACH,EACC,SAAS;AACd,CAAC;",
+  "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/services/aws/index.d.ts

@@ -0,0 +1,2 @@
+export { default as AwsS3 } from './s3.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/aws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/aws/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/services/aws/s3.d.ts

@@ -0,0 +1,54 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import type { AwsS3ConstructorOptions } from './s3.interface.js';
+interface DownloadFileOptions {
+    bucketName: string;
+    key: string;
+    destinationFilePath: string;
+}
+export default class AwsS3 {
+    client: S3Client;
+    private options;
+    constructor(options: Partial<AwsS3ConstructorOptions>);
+    private getBucketUrl;
+    uploadFile({ bucketName, path, body, contentType, forceDownload, publicRead, }: {
+        bucketName: string;
+        path: string;
+        body: Buffer;
+        contentType?: string;
+        forceDownload?: boolean;
+        publicRead?: boolean;
+    }): Promise<string>;
+    startMultipartUpload({ bucketName, path, publicRead, }: {
+        bucketName: string;
+        path: string;
+        publicRead?: boolean;
+    }): Promise<string | undefined>;
+    uploadPart({ bucketName, path, partNumber, uploadId, body, }: {
+        bucketName: string;
+        path: string;
+        partNumber: number;
+        uploadId: string;
+        body: any;
+    }): Promise<string | undefined>;
+    completeMultipartUpload({ bucketName, path, uploadId, parts, }: {
+        bucketName: string;
+        path: string;
+        uploadId: string;
+        parts: {
+            PartNumber: number;
+            ETag: string;
+        }[];
+    }): Promise<string>;
+    downloadFile({ bucketName, key, destinationFilePath, onStart, onProgress, onComplete, onError, }: DownloadFileOptions & {
+        onStart?: () => void;
+        onProgress?: (progress: number) => void;
+        onComplete?: () => void;
+        onError?: (error: Error) => void;
+    }): Promise<void>;
+    generateSignedUrl({ bucket, key }: {
+        bucket: string;
+        key: string;
+    }): Promise<string>;
+}
+export {};
+//# sourceMappingURL=s3.d.ts.map

package/dist/services/aws/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../src/services/aws/s3.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,QAAQ,EAGT,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AASjE,UAAU,mBAAmB;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,OAAO,KAAK;IACjB,MAAM,EAAE,QAAQ,CAAC;IAExB,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC;IA4CrD,OAAO,CAAC,YAAY;IAYP,UAAU,CAAC,EACtB,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,aAAa,EACb,UAAU,GACX,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBN,oBAAoB,CAAC,EAChC,UAAU,EACV,IAAI,EACJ,UAAU,GACX,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB;IAYY,UAAU,CAAC,EACtB,UAAU,EACV,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,IAAI,GACL,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,GAAG,CAAC;KACX,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAclB,uBAAuB,CAAC,EACnC,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,KAAK,GACN,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC/C;IA0BK,YAAY,CAAC,EACjB,UAAU,EACV,GAAG,EACH,mBAAmB,EACnB,OAAO,EACP,UAAU,EACV,UAAU,EACV,OAAO,GACR,EAAE,mBAAmB,GAAG;QACvB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;QACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KAClC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+EJ,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BlG"}

package/dist/services/aws/s3.interface.d.ts

@@ -0,0 +1,14 @@
+export interface AwsS3LocalstackOptions {
+    enabled?: boolean;
+    port?: number;
+}
+export interface AwsS3ConstructorOptions {
+    region: string;
+    localstack: AwsS3LocalstackOptions;
+    credentials?: {
+        accessKeyId?: string;
+        secretAccessKey?: string;
+    };
+    endpoint?: string;
+}
+//# sourceMappingURL=s3.interface.d.ts.map

package/dist/services/aws/s3.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.interface.d.ts","sourceRoot":"","sources":["../../../src/services/aws/s3.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,sBAAsB,CAAC;IACnC,WAAW,CAAC,EAAE;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './aws/index.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/util/file.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Check if a file or directory exists asynchronously
+ * @param pathToCheck - Path to check
+ * @returns Promise<boolean> - true if exists, false otherwise
+ */
+declare function pathExists(pathToCheck: string): Promise<boolean>;
+/**
+ * Ensure directory exists, create if it doesn't
+ * @param dirPath - Directory path to ensure
+ */
+declare function ensureDir(dirPath: string): Promise<void>;
+declare function convertFile({ inputFilePath, outputFilePath, format, }: {
+    inputFilePath: string;
+    outputFilePath: string;
+    format: string;
+}): Promise<void>;
+/**
+ * Copy a file or directory synchronously
+ *
+ * @param src The source path
+ * @param dest The destination path
+ */
+declare function copySync(src: string, dest: string): void;
+/**
+ * Download file from URL
+ *
+ * @param url The URL to download the file from
+ * @param destinationPath The path to save the downloaded file
+ */
+declare function downloadFile({ url, destinationPath }: {
+    url: string;
+    destinationPath: string;
+}): Promise<void>;
+/**
+ * Format file size.
+ *
+ * @param bytes The file size in bytes
+ */
+declare function formatFileSize({ bytes }: {
+    bytes: number;
+}): string;
+/**
+ * Remove a file or directory synchronously
+ *
+ * @param target The path to the file or directory to remove
+ */
+declare function removeSync(target: string): void;
+declare const _default: {
+    convertFile: typeof convertFile;
+    copySync: typeof copySync;
+    downloadFile: typeof downloadFile;
+    formatFileSize: typeof formatFileSize;
+    removeSync: typeof removeSync;
+    pathExists: typeof pathExists;
+    ensureDir: typeof ensureDir;
+};
+export default _default;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/util/file.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,iBAAe,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;;GAGG;AACH,iBAAe,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED,iBAAe,WAAW,CAAC,EACzB,aAAa,EACb,cAAc,EACd,MAAM,GACP,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhB;AAED;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBjD;AAED;;;;;GAKG;AACH,iBAAe,YAAY,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B7G;AAED;;;;GAIG;AACH,iBAAS,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAyB5D;AAED;;;;GAIG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoBxC;;;;;;;;;;AAED,wBAQE"}

package/dist/util/helper.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Deep merge objects with defaults, preventing prototype pollution.
+ *
+ * This function:
+ * - Recursively merges source objects into the target
+ * - Preserves existing values in target (acts like defaults)
+ * - Sanitizes sources to remove dangerous keys (__proto__, constructor, prototype)
+ * - Prevents prototype pollution attacks
+ *
+ * @param target - The target object to merge into
+ * @param sources - Source objects providing default values
+ * @returns The merged target object (mutated)
+ *
+ * @example
+ * const userConfig = { host: 'localhost' };
+ * const defaults = { host: '0.0.0.0', port: 3001 };
+ * const merged = defaultsDeep(userConfig, defaults);
+ * // merged = { host: 'localhost', port: 3001 }
+ */
+declare function defaultsDeep<T extends object>(target: T, ...sources: Array<Partial<T>>): T;
+/**
+ * Check if a value is an object.
+ */
+declare function isObject(item: unknown): item is Record<string, unknown>;
+type AnyObject = Record<string, unknown>;
+/**
+ * Retrieves the value from an object using a dotted key path safely.
+ *
+ * @param obj - The object to retrieve the value from.
+ * @param path - The dotted key path (e.g., 'user.email').
+ * @returns The value at the specified key path or undefined if not found.
+ */
+declare function getValueFromObject(obj: AnyObject, path: string): unknown;
+/**
+ * Retrieves the value from an array of objects using a dotted key path.
+ *
+ * @param arr - The array of objects.
+ * @param path - The dotted key path (e.g., 'user.email').
+ * @returns An array of values at the specified key path from each object.
+ */
+declare function getValueFromArray(arr: AnyObject[], path: string): unknown[];
+declare function getScriptFileExtension(): string;
+declare const _default: {
+    defaultsDeep: typeof defaultsDeep;
+    isObject: typeof isObject;
+    getValueFromArray: typeof getValueFromArray;
+    getValueFromObject: typeof getValueFromObject;
+    getScriptFileExtension: typeof getScriptFileExtension;
+};
+export default _default;
+//# sourceMappingURL=helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/util/helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAgBnF;AA0HD;;GAEG;AACH,iBAAS,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhE;AAED,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,iBAAS,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAWjE;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAEpE;AAED,iBAAS,sBAAsB,IAAI,MAAM,CAExC;;;;;;;;AAED,wBAME"}

package/dist/util/helper.js

@@ -1,18 +1,80 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-import lodashDefaultsDeep from "lodash.defaultsdeep";
 function defaultsDeep(target, ...sources) {
-  const sanitizedSources = sources.map((source) => {
-    if (!isObject(source)) return source;
-    const sanitized = { ...source };
-    delete sanitized["__proto__"];
-    delete sanitized["constructor"];
-    delete sanitized["prototype"];
-    return sanitized;
-  });
-  return lodashDefaultsDeep(target, ...sanitizedSources);
+  let result = target;
+  if (target === null || target === void 0) {
+    result = {};
+  }
+  for (const source of sources) {
+    if (!isObject(source) && !Array.isArray(source)) continue;
+    mergeObjects(result, source);
+  }
+  return result;
 }
 __name(defaultsDeep, "defaultsDeep");
+function mergeObjects(target, source) {
+  if (Array.isArray(source)) {
+    if (!Array.isArray(target)) {
+      for (let i = 0; i < source.length; i++) {
+        const key = String(i);
+        if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
+        const sourceValue = source[i];
+        const targetValue = target[key];
+        const keyExists = key in target;
+        if (keyExists && isObject(targetValue) && isObject(sourceValue)) {
+          mergeObjects(targetValue, sourceValue);
+        } else if (!keyExists || targetValue === void 0) {
+          target[key] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;
+        }
+      }
+      return;
+    }
+    for (let i = 0; i < source.length; i++) {
+      const sourceValue = source[i];
+      const targetValue = target[i];
+      const indexExists = i in target;
+      if (indexExists && isObject(targetValue) && isObject(sourceValue)) {
+        mergeObjects(targetValue, sourceValue);
+      } else if (!indexExists || targetValue === void 0) {
+        target[i] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;
+      }
+    }
+    return;
+  }
+  for (const key of Object.keys(source)) {
+    if (key === "__proto__" || key === "constructor" || key === "prototype") {
+      continue;
+    }
+    if (!Object.prototype.hasOwnProperty.call(source, key)) {
+      continue;
+    }
+    const sourceValue = source[key];
+    const targetValue = target[key];
+    if (Array.isArray(targetValue) && Array.isArray(sourceValue)) {
+      mergeObjects(targetValue, sourceValue);
+    } else if (isObject(targetValue) && Array.isArray(sourceValue)) {
+      mergeObjects(targetValue, sourceValue);
+    } else if (targetValue !== void 0 && isObject(targetValue) && isObject(sourceValue)) {
+      mergeObjects(targetValue, sourceValue);
+    } else if (targetValue === void 0) {
+      target[key] = isObject(sourceValue) || Array.isArray(sourceValue) ? deepClone(sourceValue) : sourceValue;
+    }
+  }
+}
+__name(mergeObjects, "mergeObjects");
+function deepClone(obj) {
+  if (!isObject(obj)) return obj;
+  const cloned = Array.isArray(obj) ? [] : {};
+  for (const key of Object.keys(obj)) {
+    if (key === "__proto__" || key === "constructor" || key === "prototype") {
+      continue;
+    }
+    const value = obj[key];
+    cloned[key] = isObject(value) ? deepClone(value) : value;
+  }
+  return cloned;
+}
+__name(deepClone, "deepClone");
 function isObject(item) {
   return item !== null && typeof item === "object" && !Array.isArray(item);
 }

package/dist/util/helper.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/helper.ts"],
-  "sourcesContent": ["import lodashDefaultsDeep from 'lodash.defaultsdeep';\n\n/**\n * Deep merge objects with defaults, preventing prototype pollution.\n *\n * This is a secure wrapper around lodash.defaultsdeep that:\n * - Sanitizes sources to remove dangerous keys (__proto__, constructor, prototype)\n * - Delegates to battle-tested lodash.defaultsdeep for merge logic\n * - Maintains backward compatibility with existing usage\n *\n * @param target - The target object to merge into\n * @param sources - Source objects providing default values\n * @returns The merged target object (mutated)\n *\n * @example\n * const userConfig = { host: 'localhost' };\n * const defaults = { host: '0.0.0.0', port: 3001 };\n * const merged = defaultsDeep(userConfig, defaults);\n * // merged = { host: 'localhost', port: 3001 }\n */\nfunction defaultsDeep<T extends object>(target: T, ...sources: Array<Partial<T>>): T {\n  // Sanitize sources to prevent prototype pollution\n  const sanitizedSources = sources.map(source => {\n    if (!isObject(source)) return source;\n\n    // Create a copy and remove dangerous properties\n    const sanitized: Record<string, unknown> = { ...source };\n    delete sanitized['__proto__'];\n    delete sanitized['constructor'];\n    delete sanitized['prototype'];\n    return sanitized;\n  });\n\n  // Delegate to lodash.defaultsdeep with sanitized sources\n  return lodashDefaultsDeep(target, ...sanitizedSources) as T;\n}\n\n/**\n * Check if a value is an object.\n */\nfunction isObject(item: unknown): item is Record<string, unknown> {\n  return item !== null && typeof item === 'object' && !Array.isArray(item);\n}\n\ntype AnyObject = Record<string, unknown>;\n\n/**\n * Retrieves the value from an object using a dotted key path safely.\n *\n * @param obj - The object to retrieve the value from.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns The value at the specified key path or undefined if not found.\n */\nfunction getValueFromObject(obj: AnyObject, path: string): unknown {\n  const parts = path.split('.');\n  let current: any = obj;\n  for (const part of parts) {\n    if (part === '__proto__' || part === 'constructor' || part === 'prototype') return undefined;\n    if (!current || !Object.prototype.hasOwnProperty.call(current, part)) return undefined;\n    // Access guarded by ownProperty check and blocked prototype keys\n    // eslint-disable-next-line security/detect-object-injection\n    current = (current as Record<string, any>)[part];\n  }\n  return current;\n}\n\n/**\n * Retrieves the value from an array of objects using a dotted key path.\n *\n * @param arr - The array of objects.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns An array of values at the specified key path from each object.\n */\nfunction getValueFromArray(arr: AnyObject[], path: string): unknown[] {\n  return arr.map(obj => getValueFromObject(obj, path));\n}\n\nfunction getScriptFileExtension(): string {\n  return process.env.NODE_ENV === 'development' ? 'ts' : 'js';\n}\n\nexport default {\n  defaultsDeep,\n  isObject,\n  getValueFromArray,\n  getValueFromObject,\n  getScriptFileExtension,\n};\n"],
-  "mappings": ";;AAAA,OAAO,wBAAwB;AAoB/B,SAAS,aAA+B,WAAc,SAA+B;AAEnF,QAAM,mBAAmB,QAAQ,IAAI,YAAU;AAC7C,QAAI,CAAC,SAAS,MAAM,EAAG,QAAO;AAG9B,UAAM,YAAqC,EAAE,GAAG,OAAO;AACvD,WAAO,UAAU,WAAW;AAC5B,WAAO,UAAU,aAAa;AAC9B,WAAO,UAAU,WAAW;AAC5B,WAAO;AAAA,EACT,CAAC;AAGD,SAAO,mBAAmB,QAAQ,GAAG,gBAAgB;AACvD;AAfS;AAoBT,SAAS,SAAS,MAAgD;AAChE,SAAO,SAAS,QAAQ,OAAO,SAAS,YAAY,CAAC,MAAM,QAAQ,IAAI;AACzE;AAFS;AAaT,SAAS,mBAAmB,KAAgB,MAAuB;AACjE,QAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,MAAI,UAAe;AACnB,aAAW,QAAQ,OAAO;AACxB,QAAI,SAAS,eAAe,SAAS,iBAAiB,SAAS,YAAa,QAAO;AACnF,QAAI,CAAC,WAAW,CAAC,OAAO,UAAU,eAAe,KAAK,SAAS,IAAI,EAAG,QAAO;AAG7E,cAAW,QAAgC,IAAI;AAAA,EACjD;AACA,SAAO;AACT;AAXS;AAoBT,SAAS,kBAAkB,KAAkB,MAAyB;AACpE,SAAO,IAAI,IAAI,SAAO,mBAAmB,KAAK,IAAI,CAAC;AACrD;AAFS;AAIT,SAAS,yBAAiC;AACxC,SAAO,QAAQ,IAAI,aAAa,gBAAgB,OAAO;AACzD;AAFS;AAIT,IAAO,iBAAQ;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "sourcesContent": ["/**\n * Deep merge objects with defaults, preventing prototype pollution.\n *\n * This function:\n * - Recursively merges source objects into the target\n * - Preserves existing values in target (acts like defaults)\n * - Sanitizes sources to remove dangerous keys (__proto__, constructor, prototype)\n * - Prevents prototype pollution attacks\n *\n * @param target - The target object to merge into\n * @param sources - Source objects providing default values\n * @returns The merged target object (mutated)\n *\n * @example\n * const userConfig = { host: 'localhost' };\n * const defaults = { host: '0.0.0.0', port: 3001 };\n * const merged = defaultsDeep(userConfig, defaults);\n * // merged = { host: 'localhost', port: 3001 }\n */\nfunction defaultsDeep<T extends object>(target: T, ...sources: Array<Partial<T>>): T {\n  // Handle null/undefined target by converting to empty object\n  let result = target;\n  if (target === null || target === undefined) {\n    result = {} as T;\n  }\n\n  // Process each source\n  for (const source of sources) {\n    if (!isObject(source) && !Array.isArray(source)) continue;\n\n    // Recursively merge source into target\n    mergeObjects(result, source);\n  }\n\n  return result;\n}\n\n/**\n * Recursively merge source into target, preserving target values.\n * This acts like defaultsDeep - only fills in missing values from source.\n */\nfunction mergeObjects(target: any, source: any): void {\n  // Handle arrays specially - merge by index\n  if (Array.isArray(source)) {\n    // If target is not an array but source is, treat target as object with numeric keys\n    if (!Array.isArray(target)) {\n      // Merge array into object-like target\n      for (let i = 0; i < source.length; i++) {\n        const key = String(i);\n        if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue;\n\n        // eslint-disable-next-line security/detect-object-injection\n        const sourceValue = source[i];\n        // eslint-disable-next-line security/detect-object-injection\n        const targetValue = target[key];\n\n        // Check if key exists in target\n        const keyExists = key in target;\n\n        if (keyExists && isObject(targetValue) && isObject(sourceValue)) {\n          mergeObjects(targetValue, sourceValue);\n        } else if (!keyExists || targetValue === undefined) {\n          // eslint-disable-next-line security/detect-object-injection\n          target[key] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;\n        }\n      }\n      return;\n    }\n\n    // Both are arrays - merge by index\n    for (let i = 0; i < source.length; i++) {\n      // eslint-disable-next-line security/detect-object-injection\n      const sourceValue = source[i];\n      // eslint-disable-next-line security/detect-object-injection\n      const targetValue = target[i];\n\n      // Check if index exists in target (not just if value is undefined)\n      const indexExists = i in target;\n\n      // If index exists and both values are objects, merge them\n      if (indexExists && isObject(targetValue) && isObject(sourceValue)) {\n        mergeObjects(targetValue, sourceValue);\n      }\n      // If index doesn't exist or value is undefined, fill from source\n      else if (!indexExists || targetValue === undefined) {\n        // eslint-disable-next-line security/detect-object-injection\n        target[i] = isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;\n      }\n      // Otherwise, keep target's existing value\n    }\n    return;\n  }\n\n  // Regular object merging\n  for (const key of Object.keys(source)) {\n    // Block dangerous keys to prevent prototype pollution\n    if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n      continue;\n    }\n\n    // Only use hasOwnProperty for safer property access\n    if (!Object.prototype.hasOwnProperty.call(source, key)) {\n      continue;\n    }\n\n    // Access guarded by ownProperty check and blocked prototype keys\n    // eslint-disable-next-line security/detect-object-injection\n    const sourceValue = source[key];\n\n    // eslint-disable-next-line security/detect-object-injection\n    const targetValue = target[key];\n\n    // If both are arrays, merge them by index\n    if (Array.isArray(targetValue) && Array.isArray(sourceValue)) {\n      mergeObjects(targetValue, sourceValue);\n    }\n    // If target is object and source is array, merge array into object by numeric keys\n    else if (isObject(targetValue) && Array.isArray(sourceValue)) {\n      mergeObjects(targetValue, sourceValue);\n    }\n    // If target value exists and both are objects (not arrays), recurse\n    else if (targetValue !== undefined && isObject(targetValue) && isObject(sourceValue)) {\n      mergeObjects(targetValue, sourceValue);\n    }\n    // If target doesn't have this key, set it from source\n    else if (targetValue === undefined) {\n      // eslint-disable-next-line security/detect-object-injection\n      target[key] = isObject(sourceValue) || Array.isArray(sourceValue) ? deepClone(sourceValue) : sourceValue;\n    }\n    // Otherwise, keep target's existing value (defaultsDeep behavior)\n  }\n}\n\n/**\n * Deep clone an object to avoid reference sharing.\n */\nfunction deepClone<T>(obj: T): T {\n  if (!isObject(obj)) return obj;\n\n  const cloned: any = Array.isArray(obj) ? [] : {};\n\n  for (const key of Object.keys(obj)) {\n    // Block dangerous keys\n    if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n      continue;\n    }\n\n    // eslint-disable-next-line security/detect-object-injection\n    const value = (obj as any)[key];\n\n    // eslint-disable-next-line security/detect-object-injection\n    cloned[key] = isObject(value) ? deepClone(value) : value;\n  }\n\n  return cloned;\n}\n\n/**\n * Check if a value is an object.\n */\nfunction isObject(item: unknown): item is Record<string, unknown> {\n  return item !== null && typeof item === 'object' && !Array.isArray(item);\n}\n\ntype AnyObject = Record<string, unknown>;\n\n/**\n * Retrieves the value from an object using a dotted key path safely.\n *\n * @param obj - The object to retrieve the value from.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns The value at the specified key path or undefined if not found.\n */\nfunction getValueFromObject(obj: AnyObject, path: string): unknown {\n  const parts = path.split('.');\n  let current: any = obj;\n  for (const part of parts) {\n    if (part === '__proto__' || part === 'constructor' || part === 'prototype') return undefined;\n    if (!current || !Object.prototype.hasOwnProperty.call(current, part)) return undefined;\n    // Access guarded by ownProperty check and blocked prototype keys\n    // eslint-disable-next-line security/detect-object-injection\n    current = (current as Record<string, any>)[part];\n  }\n  return current;\n}\n\n/**\n * Retrieves the value from an array of objects using a dotted key path.\n *\n * @param arr - The array of objects.\n * @param path - The dotted key path (e.g., 'user.email').\n * @returns An array of values at the specified key path from each object.\n */\nfunction getValueFromArray(arr: AnyObject[], path: string): unknown[] {\n  return arr.map(obj => getValueFromObject(obj, path));\n}\n\nfunction getScriptFileExtension(): string {\n  return process.env.NODE_ENV === 'development' ? 'ts' : 'js';\n}\n\nexport default {\n  defaultsDeep,\n  isObject,\n  getValueFromArray,\n  getValueFromObject,\n  getScriptFileExtension,\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/util/image.d.ts

@@ -0,0 +1,12 @@
+declare function extractMimeType({ base64 }: {
+    base64: string;
+}): string | undefined;
+declare function mimeTypeToExtension({ mimeType }: {
+    mimeType: string;
+}): string | undefined;
+declare const _default: {
+    extractMimeType: typeof extractMimeType;
+    mimeTypeToExtension: typeof mimeTypeToExtension;
+};
+export default _default;
+//# sourceMappingURL=image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/util/image.ts"],"names":[],"mappings":"AAAA,iBAAS,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAO3E;AAED,iBAAS,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAenF;;;;;AAED,wBAGE"}

package/dist/util/index.d.ts

@@ -0,0 +1,11 @@
+export { default as Time } from './time.js';
+export { default as Timing } from './timing.js';
+export { default as File } from './file.js';
+export { default as Helper } from './helper.js';
+export { default as Image } from './image.js';
+export { default as Loader } from './loader.js';
+export { default as Num } from './num.js';
+export { default as OS } from './os.js';
+export { default as Str } from './str.js';
+export { default as URL } from './url.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/util/loader.d.ts

@@ -0,0 +1,21 @@
+export interface ModuleMap<T = unknown> {
+    [key: string]: T;
+}
+export type EntityClass<T = unknown> = new (...args: unknown[]) => T;
+declare const _default: {
+    loadModulesInDirectory: <T = unknown>({ directory, extensions, }: {
+        directory: string;
+        extensions?: string[];
+    }) => Promise<ModuleMap<T>>;
+    loadEntityModule: <T = unknown>({ entitiesDirectory, entityName, }: {
+        entitiesDirectory: string;
+        entityName: string;
+    }) => Promise<EntityClass<T>>;
+    clearModuleCache: () => void;
+    getCacheStats: () => {
+        modulesCached: number;
+        entitiesCached: number;
+    };
+};
+export default _default;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +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;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

@@ -41,10 +41,13 @@ const loadModulesInDirectory = /* @__PURE__ */ __name(async ({
     }
     const moduleName = path.basename(file, ext);
     const filePath = path.join(directory, file);
+    const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+    const fileUrl = `file://${absolutePath.replace(/\\/g, "/")}`;
     try {
-      const importedModule = await import(filePath);
+      const importedModule = await import(fileUrl);
       if (moduleName !== "__proto__" && moduleName !== "constructor" && moduleName !== "prototype") {
-        Reflect.set(loadedModules, moduleName, importedModule.default);
+        const moduleExport = importedModule.default ?? importedModule;
+        Reflect.set(loadedModules, moduleName, moduleExport);
       }
     } catch (error) {
       console.error(`Failed to import module ${filePath}:`, error);

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\n    try {\n      const importedModule = await import(filePath);\n\n      // Use safe property assignment to prevent prototype pollution\n      if (moduleName !== '__proto__' && moduleName !== 'constructor' && moduleName !== 'prototype') {\n        Reflect.set(loadedModules, moduleName, importedModule.default);\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,QAAI;AACF,YAAM,iBAAiB,MAAM,OAAO;AAGpC,UAAI,eAAe,eAAe,eAAe,iBAAiB,eAAe,aAAa;AAC5F,gBAAQ,IAAI,eAAe,YAAY,eAAe,OAAO;AAAA,MAC/D;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,2BAA2B,QAAQ,KAAK,KAAK;AAAA,IAC7D;AAAA,EACF;AAGA,cAAY,IAAI,UAAU,aAAa;AAEvC,SAAO;AACT,GAzD+B;AA8D/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": []
 }