@scpxl/nodejs-framework 1.0.49 → 1.0.56

package/dist/request-context/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/request-context/index.ts"],
-  "sourcesContent": ["export type { RequestContext, RunWithContextOptions } from './request-context.interface.js';\nexport {\n  getRequestContext,\n  getRequestId,\n  getUserId,\n  setUserId,\n  getContextMetadata,\n  setContextMetadata,\n  runWithContext,\n  runWithContextAsync,\n  enterRequestContext,\n  requestContextStorage,\n} from './request-context.js';\n"],
+  "sourcesContent": ["export type { RequestContext, RunWithContextOptions } from './request-context.interface.js';\nexport {\n  enterRequestContext,\n  getContextMetadata,\n  getRequestContext,\n  getRequestId,\n  getUserId,\n  requestContextStorage,\n  runWithContext,\n  runWithContextAsync,\n  setContextMetadata,\n  setUserId,\n} from './request-context.js';\n"],
   "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
   "names": []
 }

package/dist/schemas/entity-builder.d.ts

@@ -6,7 +6,7 @@ import { z } from 'zod';
  * - readAugment: additional fields present on the persisted/read model (e.g. id, timestamps)
  * - strict: apply .strict() to objects (defaults true)
  */
-export interface BuildEntitySchemasOptions<Shape extends z.ZodRawShape, Updatable extends keyof Shape = keyof Shape, ReadAugment extends z.ZodRawShape = {}> {
+export interface BuildEntitySchemasOptions<Shape extends z.ZodRawShape, Updatable extends keyof Shape = keyof Shape, ReadAugment extends z.ZodRawShape = Record<string, never>> {
     shape: Shape;
     updatableFields?: readonly Updatable[];
     readAugment?: ReadAugment;
@@ -21,7 +21,7 @@ export interface BuiltEntitySchemas<Shape extends z.ZodRawShape, Updatable exten
     keys: (keyof Shape)[];
     updatableKeys: Updatable[];
 }
-export declare function buildEntitySchemas<Shape extends z.ZodRawShape, Updatable extends keyof Shape = keyof Shape, ReadAugment extends z.ZodRawShape = {}>(options: BuildEntitySchemasOptions<Shape, Updatable, ReadAugment>): BuiltEntitySchemas<Shape, Updatable, ReadAugment>;
+export declare function buildEntitySchemas<Shape extends z.ZodRawShape, Updatable extends keyof Shape = keyof Shape, ReadAugment extends z.ZodRawShape = Record<string, never>>(options: BuildEntitySchemasOptions<Shape, Updatable, ReadAugment>): BuiltEntitySchemas<Shape, Updatable, ReadAugment>;
 export declare const HttpMethodSchema: z.ZodEnum<{
     GET: "GET";
     POST: "POST";
@@ -31,5 +31,5 @@ export declare const HttpMethodSchema: z.ZodEnum<{
     PATCH: "PATCH";
     OPTIONS: "OPTIONS";
 }>;
-export declare const HttpStatusCodeSchema: z.core.$ZodBranded<z.ZodNumber, "HttpStatusCode">;
+export declare const HttpStatusCodeSchema: z.core.$ZodBranded<z.ZodNumber, "HttpStatusCode", "out">;
 //# sourceMappingURL=entity-builder.d.ts.map

package/dist/schemas/entity-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-builder.d.ts","sourceRoot":"","sources":["../../src/schemas/entity-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB,CACxC,KAAK,SAAS,CAAC,CAAC,WAAW,EAC3B,SAAS,SAAS,MAAM,KAAK,GAAG,MAAM,KAAK,EAC3C,WAAW,SAAS,CAAC,CAAC,WAAW,GAAG,EAAE;IAEtC,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB,CACjC,KAAK,SAAS,CAAC,CAAC,WAAW,EAC3B,SAAS,SAAS,MAAM,KAAK,EAC7B,WAAW,SAAS,CAAC,CAAC,WAAW;IAEjC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3B,+DAA+D;IAC/D,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC;IACvC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACtB,aAAa,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,SAAS,CAAC,CAAC,WAAW,EAC3B,SAAS,SAAS,MAAM,KAAK,GAAG,MAAM,KAAK,EAC3C,WAAW,SAAS,CAAC,CAAC,WAAW,GAAG,EAAE,EAEtC,OAAO,EAAE,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,GAChE,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAoCnD;AAGD,eAAO,MAAM,gBAAgB;;;;;;;;EAAuE,CAAC;AACrG,eAAO,MAAM,oBAAoB,mDAA+D,CAAC"}
+{"version":3,"file":"entity-builder.d.ts","sourceRoot":"","sources":["../../src/schemas/entity-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB,CACxC,KAAK,SAAS,CAAC,CAAC,WAAW,EAC3B,SAAS,SAAS,MAAM,KAAK,GAAG,MAAM,KAAK,EAC3C,WAAW,SAAS,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEzD,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB,CACjC,KAAK,SAAS,CAAC,CAAC,WAAW,EAC3B,SAAS,SAAS,MAAM,KAAK,EAC7B,WAAW,SAAS,CAAC,CAAC,WAAW;IAEjC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3B,+DAA+D;IAC/D,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC;IACvC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACtB,aAAa,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,SAAS,CAAC,CAAC,WAAW,EAC3B,SAAS,SAAS,MAAM,KAAK,GAAG,MAAM,KAAK,EAC3C,WAAW,SAAS,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEzD,OAAO,EAAE,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,GAChE,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAoCnD;AAGD,eAAO,MAAM,gBAAgB;;;;;;;;EAAuE,CAAC;AACrG,eAAO,MAAM,oBAAoB,0DAA+D,CAAC"}

package/dist/schemas/entity-builder.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/schemas/entity-builder.ts"],
-  "sourcesContent": ["import { z } from 'zod';\n\n/**\n * Options for building standardized entity schemas.\n * - shape: base create shape (required fields for creation)\n * - updatableFields: subset of keys allowed in updates (defaults to all keys of shape)\n * - readAugment: additional fields present on the persisted/read model (e.g. id, timestamps)\n * - strict: apply .strict() to objects (defaults true)\n */\nexport interface BuildEntitySchemasOptions<\n  Shape extends z.ZodRawShape,\n  Updatable extends keyof Shape = keyof Shape,\n  ReadAugment extends z.ZodRawShape = {},\n> {\n  shape: Shape;\n  updatableFields?: readonly Updatable[];\n  readAugment?: ReadAugment; // fields that exist after persistence (e.g. id, createdAt)\n  strict?: boolean;\n  requireAtLeastOneOnUpdate?: boolean; // default true\n}\n\nexport interface BuiltEntitySchemas<\n  Shape extends z.ZodRawShape,\n  Updatable extends keyof Shape,\n  ReadAugment extends z.ZodRawShape,\n> {\n  create: z.ZodObject<Shape>;\n  /** Update schema is a partial over selected updatable keys. */\n  update: z.ZodTypeAny;\n  read: z.ZodObject<Shape & ReadAugment>;\n  keys: (keyof Shape)[];\n  updatableKeys: Updatable[];\n}\n\nexport function buildEntitySchemas<\n  Shape extends z.ZodRawShape,\n  Updatable extends keyof Shape = keyof Shape,\n  ReadAugment extends z.ZodRawShape = {},\n>(\n  options: BuildEntitySchemasOptions<Shape, Updatable, ReadAugment>,\n): BuiltEntitySchemas<Shape, Updatable, ReadAugment> {\n  const { shape, updatableFields, readAugment, strict = true, requireAtLeastOneOnUpdate = true } = options;\n\n  // Freeze to avoid accidental mutation\n  Object.freeze(shape);\n\n  const create = strict ? z.object(shape).strict() : z.object(shape);\n\n  const updatableKeys = updatableFields ? [...updatableFields] : (Object.keys(shape) as Updatable[]);\n  // Build pick mask for updatable keys\n  const pickMask = updatableKeys.reduce<Record<string, true>>((acc, key) => {\n    acc[String(key)] = true;\n    return acc;\n  }, {});\n\n  const updateBase = updatableFields ? (create as z.ZodObject<any>).pick(pickMask) : (create as z.ZodObject<any>);\n  let updateObject: z.ZodTypeAny = updateBase.partial();\n\n  if (requireAtLeastOneOnUpdate) {\n    updateObject = updateObject.refine(\n      (value: unknown) =>\n        !!value && typeof value === 'object' && Object.keys(value as Record<string, unknown>).length > 0,\n      'At least one field must be provided for update',\n    );\n  }\n\n  const readShape = { ...shape, ...(readAugment ?? {}) } as Shape & ReadAugment;\n  const read = strict ? z.object(readShape).strict() : z.object(readShape);\n\n  return {\n    create,\n    update: updateObject,\n    read: read as z.ZodObject<Shape & ReadAugment>,\n    keys: Object.keys(shape) as (keyof Shape)[],\n    updatableKeys,\n  };\n}\n\n// Common atoms for reuse in entity schemas\nexport const HttpMethodSchema = z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']);\nexport const HttpStatusCodeSchema = z.number().int().min(100).max(599).brand<'HttpStatusCode'>();\n"],
+  "sourcesContent": ["import { z } from 'zod';\n\n/**\n * Options for building standardized entity schemas.\n * - shape: base create shape (required fields for creation)\n * - updatableFields: subset of keys allowed in updates (defaults to all keys of shape)\n * - readAugment: additional fields present on the persisted/read model (e.g. id, timestamps)\n * - strict: apply .strict() to objects (defaults true)\n */\nexport interface BuildEntitySchemasOptions<\n  Shape extends z.ZodRawShape,\n  Updatable extends keyof Shape = keyof Shape,\n  ReadAugment extends z.ZodRawShape = Record<string, never>,\n> {\n  shape: Shape;\n  updatableFields?: readonly Updatable[];\n  readAugment?: ReadAugment; // fields that exist after persistence (e.g. id, createdAt)\n  strict?: boolean;\n  requireAtLeastOneOnUpdate?: boolean; // default true\n}\n\nexport interface BuiltEntitySchemas<\n  Shape extends z.ZodRawShape,\n  Updatable extends keyof Shape,\n  ReadAugment extends z.ZodRawShape,\n> {\n  create: z.ZodObject<Shape>;\n  /** Update schema is a partial over selected updatable keys. */\n  update: z.ZodTypeAny;\n  read: z.ZodObject<Shape & ReadAugment>;\n  keys: (keyof Shape)[];\n  updatableKeys: Updatable[];\n}\n\nexport function buildEntitySchemas<\n  Shape extends z.ZodRawShape,\n  Updatable extends keyof Shape = keyof Shape,\n  ReadAugment extends z.ZodRawShape = Record<string, never>,\n>(\n  options: BuildEntitySchemasOptions<Shape, Updatable, ReadAugment>,\n): BuiltEntitySchemas<Shape, Updatable, ReadAugment> {\n  const { shape, updatableFields, readAugment, strict = true, requireAtLeastOneOnUpdate = true } = options;\n\n  // Freeze to avoid accidental mutation\n  Object.freeze(shape);\n\n  const create = strict ? z.object(shape).strict() : z.object(shape);\n\n  const updatableKeys = updatableFields ? [...updatableFields] : (Object.keys(shape) as Updatable[]);\n  // Build pick mask for updatable keys\n  const pickMask = updatableKeys.reduce<Record<string, true>>((acc, key) => {\n    acc[String(key)] = true;\n    return acc;\n  }, {});\n\n  const updateBase = updatableFields ? (create as z.ZodObject<any>).pick(pickMask) : (create as z.ZodObject<any>);\n  let updateObject: z.ZodTypeAny = updateBase.partial();\n\n  if (requireAtLeastOneOnUpdate) {\n    updateObject = updateObject.refine(\n      (value: unknown) =>\n        !!value && typeof value === 'object' && Object.keys(value as Record<string, unknown>).length > 0,\n      'At least one field must be provided for update',\n    );\n  }\n\n  const readShape = { ...shape, ...(readAugment ?? {}) } as Shape & ReadAugment;\n  const read = strict ? z.object(readShape).strict() : z.object(readShape);\n\n  return {\n    create,\n    update: updateObject,\n    read: read as z.ZodObject<Shape & ReadAugment>,\n    keys: Object.keys(shape) as (keyof Shape)[],\n    updatableKeys,\n  };\n}\n\n// Common atoms for reuse in entity schemas\nexport const HttpMethodSchema = z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']);\nexport const HttpStatusCodeSchema = z.number().int().min(100).max(599).brand<'HttpStatusCode'>();\n"],
   "mappings": ";;AAAA,SAAS,SAAS;AAkCX,SAAS,mBAKd,SACmD;AACnD,QAAM,EAAE,OAAO,iBAAiB,aAAa,SAAS,MAAM,4BAA4B,KAAK,IAAI;AAGjG,SAAO,OAAO,KAAK;AAEnB,QAAM,SAAS,SAAS,EAAE,OAAO,KAAK,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AAEjE,QAAM,gBAAgB,kBAAkB,CAAC,GAAG,eAAe,IAAK,OAAO,KAAK,KAAK;AAEjF,QAAM,WAAW,cAAc,OAA6B,CAAC,KAAK,QAAQ;AACxE,QAAI,OAAO,GAAG,CAAC,IAAI;AACnB,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,QAAM,aAAa,kBAAmB,OAA4B,KAAK,QAAQ,IAAK;AACpF,MAAI,eAA6B,WAAW,QAAQ;AAEpD,MAAI,2BAA2B;AAC7B,mBAAe,aAAa;AAAA,MAC1B,CAAC,UACC,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,OAAO,KAAK,KAAgC,EAAE,SAAS;AAAA,MACjG;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAAY,EAAE,GAAG,OAAO,GAAI,eAAe,CAAC,EAAG;AACrD,QAAM,OAAO,SAAS,EAAE,OAAO,SAAS,EAAE,OAAO,IAAI,EAAE,OAAO,SAAS;AAEvE,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,OAAO,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AACF;AA1CgB;AA6CT,MAAM,mBAAmB,EAAE,KAAK,CAAC,OAAO,QAAQ,OAAO,UAAU,SAAS,QAAQ,SAAS,CAAC;AAC5F,MAAM,uBAAuB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,GAAG,EAAE,MAAwB;",
   "names": []
 }

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

@@ -1 +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"}
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../src/services/aws/s3.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,QAAQ,EAGT,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAIjE,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;IAQP,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.js

@@ -1,5 +1,9 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { createWriteStream } from "node:fs";
+import { dirname } from "node:path";
+import { pipeline, Readable } from "node:stream";
+import { promisify } from "node:util";
 import {
   CompleteMultipartUploadCommand,
   CreateMultipartUploadCommand,
@@ -9,12 +13,8 @@ import {
   UploadPartCommand
 } from "@aws-sdk/client-s3";
 import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
-import { File, Helper } from "../../util/index.js";
-import { createWriteStream } from "fs";
-import { Readable, pipeline } from "stream";
-import { promisify } from "node:util";
 import { Logger } from "../../logger/index.js";
-import { dirname } from "path";
+import { File, Helper } from "../../util/index.js";
 const asyncPipeline = promisify(pipeline);
 class AwsS3 {
   static {
@@ -55,13 +55,10 @@ class AwsS3 {
     this.client = new S3Client(s3ClientConfig);
   }
   getBucketUrl({ bucketName, path }) {
-    let url;
     if (this.options.localstack.enabled) {
-      url = `http://localhost:${this.options.localstack.port}/${bucketName}/${path}`;
-    } else {
-      url = `https://${bucketName}.s3.amazonaws.com/${path}`;
+      return `http://localhost:${this.options.localstack.port}/${bucketName}/${path}`;
     }
-    return url;
+    return `https://${bucketName}.s3.amazonaws.com/${path}`;
   }
   async uploadFile({
     bucketName,

package/dist/services/aws/s3.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/services/aws/s3.ts"],
-  "sourcesContent": ["import {\n  CompleteMultipartUploadCommand,\n  CreateMultipartUploadCommand,\n  GetObjectCommand,\n  PutObjectCommand,\n  type PutObjectCommandInput,\n  S3Client,\n  type S3ClientConfig,\n  UploadPartCommand,\n} from '@aws-sdk/client-s3';\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner';\nimport { File, Helper } from '../../util/index.js';\nimport type { AwsS3ConstructorOptions } from './s3.interface.js';\nimport { createWriteStream } from 'fs';\nimport { Readable, pipeline } from 'stream';\nimport { promisify } from 'node:util';\nimport { Logger } from '../../logger/index.js';\nimport { dirname } from 'path';\n\nconst asyncPipeline = promisify(pipeline);\n\ninterface DownloadFileOptions {\n  bucketName: string;\n  key: string;\n  destinationFilePath: string;\n}\n\nexport default class AwsS3 {\n  public client: S3Client;\n\n  private options: AwsS3ConstructorOptions;\n\n  constructor(options: Partial<AwsS3ConstructorOptions>) {\n    // Define default options\n    const defaultOptions: AwsS3ConstructorOptions = {\n      region: 'us-east-1',\n      localstack: {\n        enabled: false,\n        port: 4566,\n      },\n    };\n\n    this.options = Helper.defaultsDeep(options, defaultOptions) as AwsS3ConstructorOptions;\n\n    const s3ClientConfig: S3ClientConfig = {\n      region: this.options.region,\n    };\n\n    if (this.options.localstack.enabled) {\n      s3ClientConfig.forcePathStyle = true;\n\n      if (!this.options.endpoint) {\n        throw new Error('Endpoint is required when using LocalStack');\n      }\n\n      // s3ClientConfig.endpoint = `http://s3.localhost.localstack.cloud:${this.options.localstack.port}`; // Works when the Node.js API is calling from within the Docker container\n      // s3ClientConfig.endpoint = `http://localhost:${this.options.localstack.port}`; // works out side of the container (media generator example)\n\n      s3ClientConfig.endpoint = this.options.endpoint;\n\n      s3ClientConfig.credentials = {\n        accessKeyId: 'test',\n        secretAccessKey: 'test',\n      };\n    } else {\n      if (this.options.credentials?.accessKeyId && this.options.credentials?.secretAccessKey) {\n        s3ClientConfig.credentials = {\n          accessKeyId: this.options.credentials.accessKeyId,\n          secretAccessKey: this.options.credentials.secretAccessKey,\n        };\n      }\n    }\n\n    this.client = new S3Client(s3ClientConfig);\n  }\n\n  private getBucketUrl({ bucketName, path }: { bucketName: string; path: string }) {\n    let url;\n\n    if (this.options.localstack.enabled) {\n      url = `http://localhost:${this.options.localstack.port}/${bucketName}/${path}`;\n    } else {\n      url = `https://${bucketName}.s3.amazonaws.com/${path}`;\n    }\n\n    return url;\n  }\n\n  public async uploadFile({\n    bucketName,\n    path,\n    body,\n    contentType,\n    forceDownload,\n    publicRead,\n  }: {\n    bucketName: string;\n    path: string;\n    body: Buffer;\n    contentType?: string;\n    forceDownload?: boolean;\n    publicRead?: boolean;\n  }): Promise<string> {\n    let contentDisposition = forceDownload ? 'attachment' : 'inline';\n    contentDisposition += `; filename=\"${path.split('/').pop()}\"`;\n\n    const putObjectOptions: PutObjectCommandInput = {\n      Bucket: bucketName,\n      Key: path,\n      Body: body,\n      ContentDisposition: contentDisposition,\n      ACL: publicRead ? 'public-read' : 'private',\n    };\n\n    if (contentType) {\n      putObjectOptions.ContentType = contentType;\n    }\n\n    const command = new PutObjectCommand(putObjectOptions);\n\n    await this.client.send(command);\n\n    return this.getBucketUrl({ bucketName, path });\n  }\n\n  public async startMultipartUpload({\n    bucketName,\n    path,\n    publicRead,\n  }: {\n    bucketName: string;\n    path: string;\n    publicRead?: boolean;\n  }) {\n    const command = new CreateMultipartUploadCommand({\n      Bucket: bucketName,\n      Key: path,\n      ACL: publicRead ? 'public-read' : 'private',\n    });\n\n    const response = await this.client.send(command);\n\n    return response.UploadId;\n  }\n\n  public async uploadPart({\n    bucketName,\n    path,\n    partNumber,\n    uploadId,\n    body,\n  }: {\n    bucketName: string;\n    path: string;\n    partNumber: number;\n    uploadId: string;\n    body: any;\n  }): Promise<string | undefined> {\n    const command = new UploadPartCommand({\n      Bucket: bucketName,\n      Key: path,\n      PartNumber: partNumber,\n      UploadId: uploadId,\n      Body: body,\n    });\n\n    const response = await this.client.send(command);\n\n    return response.ETag;\n  }\n\n  public async completeMultipartUpload({\n    bucketName,\n    path,\n    uploadId,\n    parts,\n  }: {\n    bucketName: string;\n    path: string;\n    uploadId: string;\n    parts: { PartNumber: number; ETag: string }[];\n  }) {\n    // Sort parts by PartNumber\n    parts.sort((a, b) => a.PartNumber - b.PartNumber);\n\n    const command = new CompleteMultipartUploadCommand({\n      Bucket: bucketName,\n      Key: path,\n      UploadId: uploadId,\n      MultipartUpload: {\n        Parts: parts,\n      },\n    });\n\n    const response = await this.client.send(command);\n\n    if (!response.Location) {\n      throw new Error('Failed to complete multipart upload');\n    }\n\n    // return response.Location;\n    return this.getBucketUrl({\n      bucketName,\n      path,\n    });\n  }\n\n  async downloadFile({\n    bucketName,\n    key,\n    destinationFilePath,\n    onStart,\n    onProgress,\n    onComplete,\n    onError,\n  }: DownloadFileOptions & {\n    onStart?: () => void;\n    onProgress?: (progress: number) => void;\n    onComplete?: () => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> {\n    const decodedKey = decodeURIComponent(key);\n    const bucketKey = decodedKey;\n\n    Logger.info({\n      message: 'Downloading file from S3',\n      meta: {\n        bucketName,\n        Key: bucketKey,\n      },\n    });\n\n    const getObjectParams = {\n      Bucket: bucketName,\n      Key: bucketKey,\n    };\n\n    try {\n      const command = new GetObjectCommand(getObjectParams);\n\n      const response = await this.client.send(command);\n\n      if (!response.Body || !(response.Body instanceof Readable)) {\n        throw new Error('Expected Body to be a readable stream!');\n      }\n\n      if (onStart) {\n        onStart();\n      }\n\n      const directoryPath = dirname(destinationFilePath);\n\n      // Ensure directory exists\n      await File.ensureDir(directoryPath);\n\n      const fileStream = createWriteStream(destinationFilePath);\n      const totalSize = parseInt(response.ContentLength?.toString() ?? '0', 10);\n\n      let bytesRead = 0;\n\n      response.Body.on('data', (chunk: Buffer) => {\n        bytesRead += chunk.length;\n\n        if (onProgress && totalSize > 0) {\n          const progress = Math.min((bytesRead / totalSize) * 100, 100);\n          const formattedProgress = parseFloat(progress.toFixed(1));\n\n          onProgress(formattedProgress);\n        }\n      });\n\n      await asyncPipeline(response.Body, fileStream);\n\n      // Verify file was written\n      if (!(await File.pathExists(destinationFilePath))) {\n        throw new Error(`Could not find downloaded file at ${destinationFilePath}`);\n      }\n\n      Logger.info({\n        message: 'File successfully downloaded',\n        meta: {\n          Path: destinationFilePath,\n        },\n      });\n\n      if (onComplete) {\n        onComplete();\n      }\n    } catch (error) {\n      Logger.error({ error });\n\n      if (onError) {\n        onError(error as Error);\n      }\n\n      throw error as Error;\n    }\n  }\n\n  public async generateSignedUrl({ bucket, key }: { bucket: string; key: string }): Promise<string> {\n    try {\n      const command = new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n      });\n\n      // Set the expiration for the signed URL to 1 hour\n      const signedUrl = await getSignedUrl(this.client, command, {\n        expiresIn: 3600,\n      });\n\n      // Log the signed URL\n      Logger.info({\n        message: 'Generated signed URL',\n        meta: {\n          URL: signedUrl,\n        },\n      });\n\n      return signedUrl;\n    } catch (error) {\n      Logger.error({ error });\n\n      throw error;\n    }\n  }\n}\n"],
-  "mappings": ";;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EAEA;AAAA,OACK;AACP,SAAS,oBAAoB;AAC7B,SAAS,MAAM,cAAc;AAE7B,SAAS,yBAAyB;AAClC,SAAS,UAAU,gBAAgB;AACnC,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,SAAS,eAAe;AAExB,MAAM,gBAAgB,UAAU,QAAQ;AAQxC,MAAO,MAAoB;AAAA,EA3B3B,OA2B2B;AAAA;AAAA;AAAA,EAClB;AAAA,EAEC;AAAA,EAER,YAAY,SAA2C;AAErD,UAAM,iBAA0C;AAAA,MAC9C,QAAQ;AAAA,MACR,YAAY;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,OAAO,aAAa,SAAS,cAAc;AAE1D,UAAM,iBAAiC;AAAA,MACrC,QAAQ,KAAK,QAAQ;AAAA,IACvB;AAEA,QAAI,KAAK,QAAQ,WAAW,SAAS;AACnC,qBAAe,iBAAiB;AAEhC,UAAI,CAAC,KAAK,QAAQ,UAAU;AAC1B,cAAM,IAAI,MAAM,4CAA4C;AAAA,MAC9D;AAKA,qBAAe,WAAW,KAAK,QAAQ;AAEvC,qBAAe,cAAc;AAAA,QAC3B,aAAa;AAAA,QACb,iBAAiB;AAAA,MACnB;AAAA,IACF,OAAO;AACL,UAAI,KAAK,QAAQ,aAAa,eAAe,KAAK,QAAQ,aAAa,iBAAiB;AACtF,uBAAe,cAAc;AAAA,UAC3B,aAAa,KAAK,QAAQ,YAAY;AAAA,UACtC,iBAAiB,KAAK,QAAQ,YAAY;AAAA,QAC5C;AAAA,MACF;AAAA,IACF;AAEA,SAAK,SAAS,IAAI,SAAS,cAAc;AAAA,EAC3C;AAAA,EAEQ,aAAa,EAAE,YAAY,KAAK,GAAyC;AAC/E,QAAI;AAEJ,QAAI,KAAK,QAAQ,WAAW,SAAS;AACnC,YAAM,oBAAoB,KAAK,QAAQ,WAAW,IAAI,IAAI,UAAU,IAAI,IAAI;AAAA,IAC9E,OAAO;AACL,YAAM,WAAW,UAAU,qBAAqB,IAAI;AAAA,IACtD;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAa,WAAW;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAOoB;AAClB,QAAI,qBAAqB,gBAAgB,eAAe;AACxD,0BAAsB,eAAe,KAAK,MAAM,GAAG,EAAE,IAAI,CAAC;AAE1D,UAAM,mBAA0C;AAAA,MAC9C,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,MAAM;AAAA,MACN,oBAAoB;AAAA,MACpB,KAAK,aAAa,gBAAgB;AAAA,IACpC;AAEA,QAAI,aAAa;AACf,uBAAiB,cAAc;AAAA,IACjC;AAEA,UAAM,UAAU,IAAI,iBAAiB,gBAAgB;AAErD,UAAM,KAAK,OAAO,KAAK,OAAO;AAE9B,WAAO,KAAK,aAAa,EAAE,YAAY,KAAK,CAAC;AAAA,EAC/C;AAAA,EAEA,MAAa,qBAAqB;AAAA,IAChC;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIG;AACD,UAAM,UAAU,IAAI,6BAA6B;AAAA,MAC/C,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,KAAK,aAAa,gBAAgB;AAAA,IACpC,CAAC;AAED,UAAM,WAAW,MAAM,KAAK,OAAO,KAAK,OAAO;AAE/C,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAa,WAAW;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAMgC;AAC9B,UAAM,UAAU,IAAI,kBAAkB;AAAA,MACpC,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,YAAY;AAAA,MACZ,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC;AAED,UAAM,WAAW,MAAM,KAAK,OAAO,KAAK,OAAO;AAE/C,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAa,wBAAwB;AAAA,IACnC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAKG;AAED,UAAM,KAAK,CAAC,GAAG,MAAM,EAAE,aAAa,EAAE,UAAU;AAEhD,UAAM,UAAU,IAAI,+BAA+B;AAAA,MACjD,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,UAAU;AAAA,MACV,iBAAiB;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF,CAAC;AAED,UAAM,WAAW,MAAM,KAAK,OAAO,KAAK,OAAO;AAE/C,QAAI,CAAC,SAAS,UAAU;AACtB,YAAM,IAAI,MAAM,qCAAqC;AAAA,IACvD;AAGA,WAAO,KAAK,aAAa;AAAA,MACvB;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,aAAa;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAKkB;AAChB,UAAM,aAAa,mBAAmB,GAAG;AACzC,UAAM,YAAY;AAElB,WAAO,KAAK;AAAA,MACV,SAAS;AAAA,MACT,MAAM;AAAA,QACJ;AAAA,QACA,KAAK;AAAA,MACP;AAAA,IACF,CAAC;AAED,UAAM,kBAAkB;AAAA,MACtB,QAAQ;AAAA,MACR,KAAK;AAAA,IACP;AAEA,QAAI;AACF,YAAM,UAAU,IAAI,iBAAiB,eAAe;AAEpD,YAAM,WAAW,MAAM,KAAK,OAAO,KAAK,OAAO;AAE/C,UAAI,CAAC,SAAS,QAAQ,EAAE,SAAS,gBAAgB,WAAW;AAC1D,cAAM,IAAI,MAAM,wCAAwC;AAAA,MAC1D;AAEA,UAAI,SAAS;AACX,gBAAQ;AAAA,MACV;AAEA,YAAM,gBAAgB,QAAQ,mBAAmB;AAGjD,YAAM,KAAK,UAAU,aAAa;AAElC,YAAM,aAAa,kBAAkB,mBAAmB;AACxD,YAAM,YAAY,SAAS,SAAS,eAAe,SAAS,KAAK,KAAK,EAAE;AAExE,UAAI,YAAY;AAEhB,eAAS,KAAK,GAAG,QAAQ,CAAC,UAAkB;AAC1C,qBAAa,MAAM;AAEnB,YAAI,cAAc,YAAY,GAAG;AAC/B,gBAAM,WAAW,KAAK,IAAK,YAAY,YAAa,KAAK,GAAG;AAC5D,gBAAM,oBAAoB,WAAW,SAAS,QAAQ,CAAC,CAAC;AAExD,qBAAW,iBAAiB;AAAA,QAC9B;AAAA,MACF,CAAC;AAED,YAAM,cAAc,SAAS,MAAM,UAAU;AAG7C,UAAI,CAAE,MAAM,KAAK,WAAW,mBAAmB,GAAI;AACjD,cAAM,IAAI,MAAM,qCAAqC,mBAAmB,EAAE;AAAA,MAC5E;AAEA,aAAO,KAAK;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,UACJ,MAAM;AAAA,QACR;AAAA,MACF,CAAC;AAED,UAAI,YAAY;AACd,mBAAW;AAAA,MACb;AAAA,IACF,SAAS,OAAO;AACd,aAAO,MAAM,EAAE,MAAM,CAAC;AAEtB,UAAI,SAAS;AACX,gBAAQ,KAAc;AAAA,MACxB;AAEA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAa,kBAAkB,EAAE,QAAQ,IAAI,GAAqD;AAChG,QAAI;AACF,YAAM,UAAU,IAAI,iBAAiB;AAAA,QACnC,QAAQ;AAAA,QACR,KAAK;AAAA,MACP,CAAC;AAGD,YAAM,YAAY,MAAM,aAAa,KAAK,QAAQ,SAAS;AAAA,QACzD,WAAW;AAAA,MACb,CAAC;AAGD,aAAO,KAAK;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,UACJ,KAAK;AAAA,QACP;AAAA,MACF,CAAC;AAED,aAAO;AAAA,IACT,SAAS,OAAO;AACd,aAAO,MAAM,EAAE,MAAM,CAAC;AAEtB,YAAM;AAAA,IACR;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { createWriteStream } from 'node:fs';\nimport { dirname } from 'node:path';\nimport { pipeline, Readable } from 'node:stream';\nimport { promisify } from 'node:util';\nimport {\n  CompleteMultipartUploadCommand,\n  CreateMultipartUploadCommand,\n  GetObjectCommand,\n  PutObjectCommand,\n  type PutObjectCommandInput,\n  S3Client,\n  type S3ClientConfig,\n  UploadPartCommand,\n} from '@aws-sdk/client-s3';\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner';\nimport { Logger } from '../../logger/index.js';\nimport { File, Helper } from '../../util/index.js';\nimport type { AwsS3ConstructorOptions } from './s3.interface.js';\n\nconst asyncPipeline = promisify(pipeline);\n\ninterface DownloadFileOptions {\n  bucketName: string;\n  key: string;\n  destinationFilePath: string;\n}\n\nexport default class AwsS3 {\n  public client: S3Client;\n\n  private options: AwsS3ConstructorOptions;\n\n  constructor(options: Partial<AwsS3ConstructorOptions>) {\n    // Define default options\n    const defaultOptions: AwsS3ConstructorOptions = {\n      region: 'us-east-1',\n      localstack: {\n        enabled: false,\n        port: 4566,\n      },\n    };\n\n    this.options = Helper.defaultsDeep(options, defaultOptions) as AwsS3ConstructorOptions;\n\n    const s3ClientConfig: S3ClientConfig = {\n      region: this.options.region,\n    };\n\n    if (this.options.localstack.enabled) {\n      s3ClientConfig.forcePathStyle = true;\n\n      if (!this.options.endpoint) {\n        throw new Error('Endpoint is required when using LocalStack');\n      }\n\n      // s3ClientConfig.endpoint = `http://s3.localhost.localstack.cloud:${this.options.localstack.port}`; // Works when the Node.js API is calling from within the Docker container\n      // s3ClientConfig.endpoint = `http://localhost:${this.options.localstack.port}`; // works out side of the container (media generator example)\n\n      s3ClientConfig.endpoint = this.options.endpoint;\n\n      s3ClientConfig.credentials = {\n        accessKeyId: 'test',\n        secretAccessKey: 'test',\n      };\n    } else {\n      if (this.options.credentials?.accessKeyId && this.options.credentials?.secretAccessKey) {\n        s3ClientConfig.credentials = {\n          accessKeyId: this.options.credentials.accessKeyId,\n          secretAccessKey: this.options.credentials.secretAccessKey,\n        };\n      }\n    }\n\n    this.client = new S3Client(s3ClientConfig);\n  }\n\n  private getBucketUrl({ bucketName, path }: { bucketName: string; path: string }) {\n    if (this.options.localstack.enabled) {\n      return `http://localhost:${this.options.localstack.port}/${bucketName}/${path}`;\n    }\n\n    return `https://${bucketName}.s3.amazonaws.com/${path}`;\n  }\n\n  public async uploadFile({\n    bucketName,\n    path,\n    body,\n    contentType,\n    forceDownload,\n    publicRead,\n  }: {\n    bucketName: string;\n    path: string;\n    body: Buffer;\n    contentType?: string;\n    forceDownload?: boolean;\n    publicRead?: boolean;\n  }): Promise<string> {\n    let contentDisposition = forceDownload ? 'attachment' : 'inline';\n    contentDisposition += `; filename=\"${path.split('/').pop()}\"`;\n\n    const putObjectOptions: PutObjectCommandInput = {\n      Bucket: bucketName,\n      Key: path,\n      Body: body,\n      ContentDisposition: contentDisposition,\n      ACL: publicRead ? 'public-read' : 'private',\n    };\n\n    if (contentType) {\n      putObjectOptions.ContentType = contentType;\n    }\n\n    const command = new PutObjectCommand(putObjectOptions);\n\n    await this.client.send(command);\n\n    return this.getBucketUrl({ bucketName, path });\n  }\n\n  public async startMultipartUpload({\n    bucketName,\n    path,\n    publicRead,\n  }: {\n    bucketName: string;\n    path: string;\n    publicRead?: boolean;\n  }) {\n    const command = new CreateMultipartUploadCommand({\n      Bucket: bucketName,\n      Key: path,\n      ACL: publicRead ? 'public-read' : 'private',\n    });\n\n    const response = await this.client.send(command);\n\n    return response.UploadId;\n  }\n\n  public async uploadPart({\n    bucketName,\n    path,\n    partNumber,\n    uploadId,\n    body,\n  }: {\n    bucketName: string;\n    path: string;\n    partNumber: number;\n    uploadId: string;\n    body: any;\n  }): Promise<string | undefined> {\n    const command = new UploadPartCommand({\n      Bucket: bucketName,\n      Key: path,\n      PartNumber: partNumber,\n      UploadId: uploadId,\n      Body: body,\n    });\n\n    const response = await this.client.send(command);\n\n    return response.ETag;\n  }\n\n  public async completeMultipartUpload({\n    bucketName,\n    path,\n    uploadId,\n    parts,\n  }: {\n    bucketName: string;\n    path: string;\n    uploadId: string;\n    parts: { PartNumber: number; ETag: string }[];\n  }) {\n    // Sort parts by PartNumber\n    parts.sort((a, b) => a.PartNumber - b.PartNumber);\n\n    const command = new CompleteMultipartUploadCommand({\n      Bucket: bucketName,\n      Key: path,\n      UploadId: uploadId,\n      MultipartUpload: {\n        Parts: parts,\n      },\n    });\n\n    const response = await this.client.send(command);\n\n    if (!response.Location) {\n      throw new Error('Failed to complete multipart upload');\n    }\n\n    // return response.Location;\n    return this.getBucketUrl({\n      bucketName,\n      path,\n    });\n  }\n\n  async downloadFile({\n    bucketName,\n    key,\n    destinationFilePath,\n    onStart,\n    onProgress,\n    onComplete,\n    onError,\n  }: DownloadFileOptions & {\n    onStart?: () => void;\n    onProgress?: (progress: number) => void;\n    onComplete?: () => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> {\n    const decodedKey = decodeURIComponent(key);\n    const bucketKey = decodedKey;\n\n    Logger.info({\n      message: 'Downloading file from S3',\n      meta: {\n        bucketName,\n        Key: bucketKey,\n      },\n    });\n\n    const getObjectParams = {\n      Bucket: bucketName,\n      Key: bucketKey,\n    };\n\n    try {\n      const command = new GetObjectCommand(getObjectParams);\n\n      const response = await this.client.send(command);\n\n      if (!response.Body || !(response.Body instanceof Readable)) {\n        throw new Error('Expected Body to be a readable stream!');\n      }\n\n      if (onStart) {\n        onStart();\n      }\n\n      const directoryPath = dirname(destinationFilePath);\n\n      // Ensure directory exists\n      await File.ensureDir(directoryPath);\n\n      const fileStream = createWriteStream(destinationFilePath);\n      const totalSize = parseInt(response.ContentLength?.toString() ?? '0', 10);\n\n      let bytesRead = 0;\n\n      response.Body.on('data', (chunk: Buffer) => {\n        bytesRead += chunk.length;\n\n        if (onProgress && totalSize > 0) {\n          const progress = Math.min((bytesRead / totalSize) * 100, 100);\n          const formattedProgress = parseFloat(progress.toFixed(1));\n\n          onProgress(formattedProgress);\n        }\n      });\n\n      await asyncPipeline(response.Body, fileStream);\n\n      // Verify file was written\n      if (!(await File.pathExists(destinationFilePath))) {\n        throw new Error(`Could not find downloaded file at ${destinationFilePath}`);\n      }\n\n      Logger.info({\n        message: 'File successfully downloaded',\n        meta: {\n          Path: destinationFilePath,\n        },\n      });\n\n      if (onComplete) {\n        onComplete();\n      }\n    } catch (error) {\n      Logger.error({ error });\n\n      if (onError) {\n        onError(error as Error);\n      }\n\n      throw error as Error;\n    }\n  }\n\n  public async generateSignedUrl({ bucket, key }: { bucket: string; key: string }): Promise<string> {\n    try {\n      const command = new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n      });\n\n      // Set the expiration for the signed URL to 1 hour\n      const signedUrl = await getSignedUrl(this.client, command, {\n        expiresIn: 3600,\n      });\n\n      // Log the signed URL\n      Logger.info({\n        message: 'Generated signed URL',\n        meta: {\n          URL: signedUrl,\n        },\n      });\n\n      return signedUrl;\n    } catch (error) {\n      Logger.error({ error });\n\n      throw error;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/util/file.d.ts

@@ -9,13 +9,13 @@ declare function pathExists(pathToCheck: string): Promise<boolean>;
  * @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
+ * Copy a file or directory synchronously.
+ *
+ * **Note**: This function uses synchronous file system operations which block
+ * the event loop. It is intended for use during application initialization,
+ * build scripts, or CLI tools where blocking is acceptable.
+ * For production runtime code with high concurrency, consider using async alternatives.
  *
  * @param src The source path
  * @param dest The destination path
@@ -40,13 +40,18 @@ declare function formatFileSize({ bytes }: {
     bytes: number;
 }): string;
 /**
- * Remove a file or directory synchronously
+ * Remove a file or directory synchronously.
+ *
+ * **Note**: This function uses synchronous file system operations which block
+ * the event loop. It is intended for use during application cleanup, build scripts,
+ * or CLI tools where blocking is acceptable.
+ * For production runtime code with high concurrency, consider using async alternatives
+ * like `fs.promises.rm(target, { recursive: true, force: true })`.
  *
  * @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;

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

@@ -1 +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"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/util/file.ts"],"names":[],"mappings":"AASA;;;;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;;;;;;;;;;GAUG;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;;;;;;;;;;GAUG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoBxC;;;;;;;;;AAED,wBAOE"}

package/dist/util/file.js

@@ -1,12 +1,11 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-import * as fs from "fs";
-import { access, mkdir } from "fs/promises";
-import * as path from "path";
-import * as https from "https";
-import { pipeline } from "stream";
+import * as fs from "node:fs";
+import { access, mkdir } from "node:fs/promises";
+import * as https from "node:https";
+import * as path from "node:path";
+import { pipeline } from "node:stream";
 import { promisify } from "node:util";
-import ffmpeg from "fluent-ffmpeg";
 const pipelineAsync = promisify(pipeline);
 async function pathExists(pathToCheck) {
   try {
@@ -25,26 +24,6 @@ async function ensureDir(dirPath) {
   }
 }
 __name(ensureDir, "ensureDir");
-async function convertFile({
-  inputFilePath,
-  outputFilePath,
-  format
-}) {
-  return new Promise((resolve, reject) => {
-    console.log(`Starting conversion: ${inputFilePath} -> ${outputFilePath} (format: ${format})`);
-    const command = ffmpeg(inputFilePath).output(outputFilePath).outputFormat(format === "jpg" ? "mjpeg" : format).on("progress", (progress) => {
-      console.log(`Processing: ${Math.round(progress.percent)}% done`);
-    }).on("end", () => {
-      console.log("Conversion finished successfully");
-      resolve();
-    }).on("error", (err) => {
-      console.error("Error during conversion:", err);
-      reject(err);
-    });
-    command.run();
-  });
-}
-__name(convertFile, "convertFile");
 function copySync(src, dest) {
   const stats = fs.statSync(src);
   if (stats.isDirectory()) {
@@ -89,7 +68,7 @@ function formatFileSize({ bytes }) {
   let idx = Math.floor(Math.log(bytes) / Math.log(1024));
   if (idx < 0) idx = 0;
   if (idx >= units.length) idx = units.length - 1;
-  const fileSize = (bytes / Math.pow(1024, idx)).toFixed(1);
+  const fileSize = (bytes / 1024 ** idx).toFixed(1);
   let unit;
   switch (idx) {
     case 0:
@@ -128,7 +107,6 @@ function removeSync(target) {
 }
 __name(removeSync, "removeSync");
 var file_default = {
-  convertFile,
   copySync,
   downloadFile,
   formatFileSize,

package/dist/util/file.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/file.ts"],
-  "sourcesContent": ["import * as fs from 'fs';\nimport { access, mkdir } from 'fs/promises';\nimport * as path from 'path';\nimport * as https from 'https';\nimport { pipeline } from 'stream';\nimport { promisify } from 'node:util';\nimport ffmpeg from 'fluent-ffmpeg';\n\nconst pipelineAsync = promisify(pipeline);\n\n/**\n * Check if a file or directory exists asynchronously\n * @param pathToCheck - Path to check\n * @returns Promise<boolean> - true if exists, false otherwise\n */\nasync function pathExists(pathToCheck: string): Promise<boolean> {\n  try {\n    await access(pathToCheck);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Ensure directory exists, create if it doesn't\n * @param dirPath - Directory path to ensure\n */\nasync function ensureDir(dirPath: string): Promise<void> {\n  try {\n    await access(dirPath);\n  } catch {\n    await mkdir(dirPath, { recursive: true });\n  }\n}\n\nasync function convertFile({\n  inputFilePath,\n  outputFilePath,\n  format,\n}: {\n  inputFilePath: string;\n  outputFilePath: string;\n  format: string;\n}): Promise<void> {\n  return new Promise((resolve, reject) => {\n    console.log(`Starting conversion: ${inputFilePath} -> ${outputFilePath} (format: ${format})`);\n\n    const command = ffmpeg(inputFilePath)\n      .output(outputFilePath)\n      .outputFormat(format === 'jpg' ? 'mjpeg' : format) // Using 'mjpeg' for jpg\n      .on('progress', (progress: any) => {\n        console.log(`Processing: ${Math.round(progress.percent)}% done`);\n      })\n      .on('end', () => {\n        console.log('Conversion finished successfully');\n        resolve();\n      })\n      .on('error', (err: Error) => {\n        console.error('Error during conversion:', err);\n        reject(err);\n      });\n\n    // Start processing\n    command.run();\n  });\n}\n\n/**\n * Copy a file or directory synchronously\n *\n * @param src The source path\n * @param dest The destination path\n */\nfunction copySync(src: string, dest: string): void {\n  const stats = fs.statSync(src);\n\n  if (stats.isDirectory()) {\n    // Create destination directory if it doesn't exist\n    if (!fs.existsSync(dest)) {\n      fs.mkdirSync(dest);\n    }\n\n    // Read directory contents\n    for (const entry of fs.readdirSync(src)) {\n      const srcPath = path.join(src, entry);\n      const destPath = path.join(dest, entry);\n      copySync(srcPath, destPath);\n    }\n  } else {\n    // Copy file\n    fs.copyFileSync(src, dest);\n  }\n}\n\n/**\n * Download file from URL\n *\n * @param url The URL to download the file from\n * @param destinationPath The path to save the downloaded file\n */\nasync function downloadFile({ url, destinationPath }: { url: string; destinationPath: string }): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const file = fs.createWriteStream(destinationPath);\n\n    https\n      .get(url, response => {\n        // Check if response status is OK (200\u2013299)\n        if (response.statusCode && response.statusCode >= 200 && response.statusCode < 300) {\n          pipelineAsync(response, file)\n            .then(() => resolve())\n            .catch(err => {\n              fs.unlink(destinationPath, () => reject(err)); // Clean up partially written file on error\n            });\n        } else {\n          fs.unlink(destinationPath, () => {\n            reject(new Error(`Failed to download file, status code: ${response.statusCode}`));\n          });\n        }\n      })\n      .on('error', err => {\n        fs.unlink(destinationPath, () => reject(err)); // Handle request errors\n      });\n\n    // Handle file stream errors\n    file.on('error', err => {\n      fs.unlink(destinationPath, () => reject(err));\n    });\n  });\n}\n\n/**\n * Format file size.\n *\n * @param bytes The file size in bytes\n */\nfunction formatFileSize({ bytes }: { bytes: number }): string {\n  if (bytes === 0) return '0 bytes';\n  const units = ['bytes', 'kB', 'MB', 'GB', 'TB'] as const;\n  let idx = Math.floor(Math.log(bytes) / Math.log(1024));\n  if (idx < 0) idx = 0;\n  if (idx >= units.length) idx = units.length - 1;\n  const fileSize = (bytes / Math.pow(1024, idx)).toFixed(1);\n  let unit: string;\n  switch (idx) {\n    case 0:\n      unit = 'bytes';\n      break;\n    case 1:\n      unit = 'kB';\n      break;\n    case 2:\n      unit = 'MB';\n      break;\n    case 3:\n      unit = 'GB';\n      break;\n    default:\n      unit = 'TB';\n  }\n  return `${fileSize} ${unit}`;\n}\n\n/**\n * Remove a file or directory synchronously\n *\n * @param target The path to the file or directory to remove\n */\nfunction removeSync(target: string): void {\n  if (fs.existsSync(target)) {\n    const stats = fs.statSync(target);\n\n    if (stats.isDirectory()) {\n      // Read the directory contents\n      for (const entry of fs.readdirSync(target)) {\n        const entryPath = path.join(target, entry);\n        removeSync(entryPath);\n      }\n\n      // Remove the directory itself\n      fs.rmdirSync(target);\n    } else {\n      // Remove the file\n      fs.unlinkSync(target);\n    }\n  } else {\n    console.warn(`Path ${target} does not exist.`);\n  }\n}\n\nexport default {\n  convertFile,\n  copySync,\n  downloadFile,\n  formatFileSize,\n  removeSync,\n  pathExists,\n  ensureDir,\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as fs from 'node:fs';\nimport { access, mkdir } from 'node:fs/promises';\nimport * as https from 'node:https';\nimport * as path from 'node:path';\nimport { pipeline } from 'node:stream';\nimport { promisify } from 'node:util';\n\nconst pipelineAsync = promisify(pipeline);\n\n/**\n * Check if a file or directory exists asynchronously\n * @param pathToCheck - Path to check\n * @returns Promise<boolean> - true if exists, false otherwise\n */\nasync function pathExists(pathToCheck: string): Promise<boolean> {\n  try {\n    await access(pathToCheck);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Ensure directory exists, create if it doesn't\n * @param dirPath - Directory path to ensure\n */\nasync function ensureDir(dirPath: string): Promise<void> {\n  try {\n    await access(dirPath);\n  } catch {\n    await mkdir(dirPath, { recursive: true });\n  }\n}\n\n/**\n * Copy a file or directory synchronously.\n *\n * **Note**: This function uses synchronous file system operations which block\n * the event loop. It is intended for use during application initialization,\n * build scripts, or CLI tools where blocking is acceptable.\n * For production runtime code with high concurrency, consider using async alternatives.\n *\n * @param src The source path\n * @param dest The destination path\n */\nfunction copySync(src: string, dest: string): void {\n  const stats = fs.statSync(src);\n\n  if (stats.isDirectory()) {\n    // Create destination directory if it doesn't exist\n    if (!fs.existsSync(dest)) {\n      fs.mkdirSync(dest);\n    }\n\n    // Read directory contents\n    for (const entry of fs.readdirSync(src)) {\n      const srcPath = path.join(src, entry);\n      const destPath = path.join(dest, entry);\n      copySync(srcPath, destPath);\n    }\n  } else {\n    // Copy file\n    fs.copyFileSync(src, dest);\n  }\n}\n\n/**\n * Download file from URL\n *\n * @param url The URL to download the file from\n * @param destinationPath The path to save the downloaded file\n */\nasync function downloadFile({ url, destinationPath }: { url: string; destinationPath: string }): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const file = fs.createWriteStream(destinationPath);\n\n    https\n      .get(url, response => {\n        // Check if response status is OK (200\u2013299)\n        if (response.statusCode && response.statusCode >= 200 && response.statusCode < 300) {\n          pipelineAsync(response, file)\n            .then(() => resolve())\n            .catch(err => {\n              fs.unlink(destinationPath, () => reject(err)); // Clean up partially written file on error\n            });\n        } else {\n          fs.unlink(destinationPath, () => {\n            reject(new Error(`Failed to download file, status code: ${response.statusCode}`));\n          });\n        }\n      })\n      .on('error', err => {\n        fs.unlink(destinationPath, () => reject(err)); // Handle request errors\n      });\n\n    // Handle file stream errors\n    file.on('error', err => {\n      fs.unlink(destinationPath, () => reject(err));\n    });\n  });\n}\n\n/**\n * Format file size.\n *\n * @param bytes The file size in bytes\n */\nfunction formatFileSize({ bytes }: { bytes: number }): string {\n  if (bytes === 0) return '0 bytes';\n  const units = ['bytes', 'kB', 'MB', 'GB', 'TB'] as const;\n  let idx = Math.floor(Math.log(bytes) / Math.log(1024));\n  if (idx < 0) idx = 0;\n  if (idx >= units.length) idx = units.length - 1;\n  const fileSize = (bytes / 1024 ** idx).toFixed(1);\n  let unit: string;\n  switch (idx) {\n    case 0:\n      unit = 'bytes';\n      break;\n    case 1:\n      unit = 'kB';\n      break;\n    case 2:\n      unit = 'MB';\n      break;\n    case 3:\n      unit = 'GB';\n      break;\n    default:\n      unit = 'TB';\n  }\n  return `${fileSize} ${unit}`;\n}\n\n/**\n * Remove a file or directory synchronously.\n *\n * **Note**: This function uses synchronous file system operations which block\n * the event loop. It is intended for use during application cleanup, build scripts,\n * or CLI tools where blocking is acceptable.\n * For production runtime code with high concurrency, consider using async alternatives\n * like `fs.promises.rm(target, { recursive: true, force: true })`.\n *\n * @param target The path to the file or directory to remove\n */\nfunction removeSync(target: string): void {\n  if (fs.existsSync(target)) {\n    const stats = fs.statSync(target);\n\n    if (stats.isDirectory()) {\n      // Read the directory contents\n      for (const entry of fs.readdirSync(target)) {\n        const entryPath = path.join(target, entry);\n        removeSync(entryPath);\n      }\n\n      // Remove the directory itself\n      fs.rmdirSync(target);\n    } else {\n      // Remove the file\n      fs.unlinkSync(target);\n    }\n  } else {\n    console.warn(`Path ${target} does not exist.`);\n  }\n}\n\nexport default {\n  copySync,\n  downloadFile,\n  formatFileSize,\n  removeSync,\n  pathExists,\n  ensureDir,\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/util/helper.js

@@ -45,7 +45,7 @@ function mergeObjects(target, source) {
     if (key === "__proto__" || key === "constructor" || key === "prototype") {
       continue;
     }
-    if (!Object.prototype.hasOwnProperty.call(source, key)) {
+    if (!Object.hasOwn(source, key)) {
       continue;
     }
     const sourceValue = source[key];
@@ -84,7 +84,7 @@ function getValueFromObject(obj, path) {
   let current = obj;
   for (const part of parts) {
     if (part === "__proto__" || part === "constructor" || part === "prototype") return void 0;
-    if (!current || !Object.prototype.hasOwnProperty.call(current, part)) return void 0;
+    if (!current || !Object.hasOwn(current, part)) return void 0;
     current = current[part];
   }
   return current;

package/dist/util/helper.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/helper.ts"],
-  "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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",
+  "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.hasOwn(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.hasOwn(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/index.d.ts

@@ -1,5 +1,3 @@
-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';
@@ -7,5 +5,7 @@ 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 Time } from './time.js';
+export { default as Timing } from './timing.js';
 export { default as URL } from './url.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,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,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/util/index.js

@@ -1,23 +1,23 @@
-import { default as default2 } from "./time.js";
-import { default as default3 } from "./timing.js";
-import { default as default4 } from "./file.js";
-import { default as default5 } from "./helper.js";
-import { default as default6 } from "./image.js";
-import { default as default7 } from "./loader.js";
-import { default as default8 } from "./num.js";
-import { default as default9 } from "./os.js";
-import { default as default10 } from "./str.js";
+import { default as default2 } from "./file.js";
+import { default as default3 } from "./helper.js";
+import { default as default4 } from "./image.js";
+import { default as default5 } from "./loader.js";
+import { default as default6 } from "./num.js";
+import { default as default7 } from "./os.js";
+import { default as default8 } from "./str.js";
+import { default as default9 } from "./time.js";
+import { default as default10 } from "./timing.js";
 import { default as default11 } from "./url.js";
 export {
-  default4 as File,
-  default5 as Helper,
-  default6 as Image,
-  default7 as Loader,
-  default8 as Num,
-  default9 as OS,
-  default10 as Str,
-  default2 as Time,
-  default3 as Timing,
+  default2 as File,
+  default3 as Helper,
+  default4 as Image,
+  default5 as Loader,
+  default6 as Num,
+  default7 as OS,
+  default8 as Str,
+  default9 as Time,
+  default10 as Timing,
   default11 as URL
 };
 //# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/index.ts"],
-  "sourcesContent": ["export { default as Time } from './time.js';\nexport { default as Timing } from './timing.js';\nexport { default as File } from './file.js';\nexport { default as Helper } from './helper.js';\nexport { default as Image } from './image.js';\nexport { default as Loader } from './loader.js';\nexport { default as Num } from './num.js';\nexport { default as OS } from './os.js';\nexport { default as Str } from './str.js';\nexport { default as URL } from './url.js';\n"],
-  "mappings": "AAAA,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,gBAAyB;AAClC,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,gBAAyB;AAClC,SAAoB,WAAXA,gBAAwB;AACjC,SAAoB,WAAXA,gBAAyB;AAClC,SAAoB,WAAXA,gBAAsB;AAC/B,SAAoB,WAAXA,gBAAqB;AAC9B,SAAoB,WAAXA,iBAAsB;AAC/B,SAAoB,WAAXA,iBAAsB;",
+  "sourcesContent": ["export { default as File } from './file.js';\nexport { default as Helper } from './helper.js';\nexport { default as Image } from './image.js';\nexport { default as Loader } from './loader.js';\nexport { default as Num } from './num.js';\nexport { default as OS } from './os.js';\nexport { default as Str } from './str.js';\nexport { default as Time } from './time.js';\nexport { default as Timing } from './timing.js';\nexport { default as URL } from './url.js';\n"],
+  "mappings": "AAAA,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,gBAAyB;AAClC,SAAoB,WAAXA,gBAAwB;AACjC,SAAoB,WAAXA,gBAAyB;AAClC,SAAoB,WAAXA,gBAAsB;AAC/B,SAAoB,WAAXA,gBAAqB;AAC9B,SAAoB,WAAXA,gBAAsB;AAC/B,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,iBAAyB;AAClC,SAAoB,WAAXA,iBAAsB;",
   "names": ["default"]
 }

package/dist/util/loader.js

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-import fs from "fs";
-import path from "path";
+import fs from "node:fs";
+import path from "node:path";
 import { LRUCache } from "lru-cache";
 import { Helper } from "./index.js";
 const moduleCache = new LRUCache({
@@ -69,7 +69,7 @@ const loadEntityModule = /* @__PURE__ */ __name(async ({
   if (entityName === "__proto__" || entityName === "constructor" || entityName === "prototype") {
     throw new Error(`Invalid entity name (Entity: ${entityName})`);
   }
-  if (!entityModule || !Object.prototype.hasOwnProperty.call(entityModule, entityName)) {
+  if (!entityModule || !Object.hasOwn(entityModule, entityName)) {
     throw new Error(`Entity not found (Entity: ${entityName})`);
   }
   const EntityClass = Reflect.get(entityModule, entityName);

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      // 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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",
+  "sourcesContent": ["import fs from 'node:fs';\nimport path from 'node: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.hasOwn(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;AAEd,cAAQ,MAAM,2BAA2B,QAAQ,KAAK,KAAK;AAAA,IAC7D;AAAA,EACF;AAGA,cAAY,IAAI,UAAU,aAAa;AAEvC,SAAO;AACT,GAhE+B;AAqE/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,OAAO,cAAc,UAAU,GAAG;AAC7D,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;",
   "names": []
 }

package/dist/util/os.js

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-import os from "os";
-import crypto from "crypto";
+import crypto from "node:crypto";
+import os from "node:os";
 function getUniqueComputerId() {
   const interfaces = Object.values(os.networkInterfaces()).filter(Boolean);
   let macAddress = "";

package/dist/util/os.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/os.ts"],
-  "sourcesContent": ["import os from 'os';\nimport crypto from 'crypto';\n\nfunction getUniqueComputerId(): string {\n  const interfaces = Object.values(os.networkInterfaces()).filter(Boolean) as os.NetworkInterfaceInfo[][];\n  let macAddress = '';\n  for (const ifaceList of interfaces) {\n    for (const details of ifaceList) {\n      if (details.mac) {\n        macAddress = details.mac;\n        break;\n      }\n    }\n    if (macAddress) break;\n  }\n  return crypto.createHash('sha256').update(macAddress).digest('hex');\n}\n\nexport default {\n  getUniqueComputerId,\n};\n"],
-  "mappings": ";;AAAA,OAAO,QAAQ;AACf,OAAO,YAAY;AAEnB,SAAS,sBAA8B;AACrC,QAAM,aAAa,OAAO,OAAO,GAAG,kBAAkB,CAAC,EAAE,OAAO,OAAO;AACvE,MAAI,aAAa;AACjB,aAAW,aAAa,YAAY;AAClC,eAAW,WAAW,WAAW;AAC/B,UAAI,QAAQ,KAAK;AACf,qBAAa,QAAQ;AACrB;AAAA,MACF;AAAA,IACF;AACA,QAAI,WAAY;AAAA,EAClB;AACA,SAAO,OAAO,WAAW,QAAQ,EAAE,OAAO,UAAU,EAAE,OAAO,KAAK;AACpE;AAbS;AAeT,IAAO,aAAQ;AAAA,EACb;AACF;",
+  "sourcesContent": ["import crypto from 'node:crypto';\nimport os from 'node:os';\n\nfunction getUniqueComputerId(): string {\n  const interfaces = Object.values(os.networkInterfaces()).filter(Boolean) as os.NetworkInterfaceInfo[][];\n  let macAddress = '';\n  for (const ifaceList of interfaces) {\n    for (const details of ifaceList) {\n      if (details.mac) {\n        macAddress = details.mac;\n        break;\n      }\n    }\n    if (macAddress) break;\n  }\n  return crypto.createHash('sha256').update(macAddress).digest('hex');\n}\n\nexport default {\n  getUniqueComputerId,\n};\n"],
+  "mappings": ";;AAAA,OAAO,YAAY;AACnB,OAAO,QAAQ;AAEf,SAAS,sBAA8B;AACrC,QAAM,aAAa,OAAO,OAAO,GAAG,kBAAkB,CAAC,EAAE,OAAO,OAAO;AACvE,MAAI,aAAa;AACjB,aAAW,aAAa,YAAY;AAClC,eAAW,WAAW,WAAW;AAC/B,UAAI,QAAQ,KAAK;AACf,qBAAa,QAAQ;AACrB;AAAA,MACF;AAAA,IACF;AACA,QAAI,WAAY;AAAA,EAClB;AACA,SAAO,OAAO,WAAW,QAAQ,EAAE,OAAO,UAAU,EAAE,OAAO,KAAK;AACpE;AAbS;AAeT,IAAO,aAAQ;AAAA,EACb;AACF;",
   "names": []
 }

package/dist/webserver/controller/auth-middleware.d.ts

@@ -17,5 +17,5 @@ export declare function withAuth(handler: AuthenticatedRouteHandler, authenticat
  * Method decorator for class-based controllers
  * Usage: @requiresAuth()
  */
-export declare function requiresAuth(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function requiresAuth(): (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 //# sourceMappingURL=auth-middleware.d.ts.map