@forklaunch/core 0.14.4 → 0.14.6

package/lib/mappers/index.d.mts

@@ -14,27 +14,43 @@ declare function responseMapper<SV extends AnySchemaValidator, DomainSchema exte
 } & typeof mapperDefinition>;
 
 /**
- * Maps a set of service schema factory functions to their instantiated schemas using the provided validator.
+ * A function type that, given an options object, returns a schema or schema-like object.
  *
- * @template T - An object whose values are functions that accept an options object containing a validator and return a schema.
- * @template SV - The type of the schema validator.
+ * @template Args - The type of the options object, typically an object with configuration or dependencies.
+ * @param {Args} options - The options to use for schema resolution (e.g., validator, uuidId, etc.).
+ * @returns {unknown} The resolved schema or schema-like object.
+ */
+type SchemaResolutionFunction<Args extends Record<string, unknown>> = (options: Args) => unknown;
+
+/**
+ * Maps a set of service schema factories or pre-instantiated schemas to their resolved schemas using the provided arguments.
+ *
+ * This utility allows you to provide an object whose values are either:
+ *   - Schema factory functions (SchemaResolutionFunction) that accept an options object (Args) and return a schema or schema group.
+ *   - Already-instantiated schemas (IdiomaticSchema).
+ *
+ * Each factory function will be called with the provided `args` object, and the result will be included in the returned mapping.
+ * If a value is already a schema (not a function), it is returned as-is.
+ *
+ * @template SV - The schema validator type.
+ * @template T - An object whose values are either schema factory functions or instantiated schemas.
+ * @template Args - The type of the options object passed to each factory function (e.g., { validator, uuidId, ... }).
  *
- * @param {T} schemas - An object mapping schema names to factory functions. Each factory function should accept an object with a `validator` property.
- * @param {SV} validator - The schema validator instance to be passed to each schema factory function.
- * @returns {{ [K in keyof T]: ReturnType<T[K]> }} An object mapping each schema name to its instantiated schema.
+ * @param {T} schemas - An object mapping schema names to either factory functions (SchemaResolutionFunction) or instantiated schemas (IdiomaticSchema).
+ * @param {Args} args - The options object to be passed to each schema factory function.
+ * @returns {{ [K in keyof T]: T[K] extends SchemaResolutionFunction<Args> ? ReturnType<T[K]> : T[K] }} An object mapping each schema name to its resolved schema.
  *
  * @example
  * const schemas = {
- *   UserSchemas: ({ validator }) => createUserSchemas(validator),
- *   ProductSchemas: ({ validator }) => createProductSchemas(validator)
+ *   UserSchemas: (opts) => createUserSchemas(opts),
+ *   ProductSchemas: (opts) => createProductSchemas(opts),
+ *   AlreadyInstantiated: someSchemaObject
  * };
- * const mapped = mapServiceSchemas(schemas, myValidator);
- * // mapped.UserSchemas, mapped.ProductSchemas now contain the instantiated schemas
+ * const mapped = mapServiceSchemas(schemas, { validator: myValidator });
+ * // mapped.UserSchemas and mapped.ProductSchemas are instantiated, mapped.AlreadyInstantiated is passed through
  */
-declare function mapServiceSchemas<T extends Record<string, (options: {
-    validator: SV;
-}) => unknown>, SV extends AnySchemaValidator>(schemas: T, validator: SV): {
-    [K in keyof T]: ReturnType<T[K]>;
+declare function mapServiceSchemas<SV extends AnySchemaValidator, T extends Record<string, SchemaResolutionFunction<Args> | IdiomaticSchema<SV>>, Args extends Record<string, unknown>>(schemas: T, args: Args): {
+    [K in keyof T]: T[K] extends SchemaResolutionFunction<Args> ? ReturnType<T[K]> : T[K];
 };
 
 export { mapServiceSchemas, requestMapper, responseMapper };

package/lib/mappers/index.d.ts

@@ -14,27 +14,43 @@ declare function responseMapper<SV extends AnySchemaValidator, DomainSchema exte
 } & typeof mapperDefinition>;
 
 /**
- * Maps a set of service schema factory functions to their instantiated schemas using the provided validator.
+ * A function type that, given an options object, returns a schema or schema-like object.
  *
- * @template T - An object whose values are functions that accept an options object containing a validator and return a schema.
- * @template SV - The type of the schema validator.
+ * @template Args - The type of the options object, typically an object with configuration or dependencies.
+ * @param {Args} options - The options to use for schema resolution (e.g., validator, uuidId, etc.).
+ * @returns {unknown} The resolved schema or schema-like object.
+ */
+type SchemaResolutionFunction<Args extends Record<string, unknown>> = (options: Args) => unknown;
+
+/**
+ * Maps a set of service schema factories or pre-instantiated schemas to their resolved schemas using the provided arguments.
+ *
+ * This utility allows you to provide an object whose values are either:
+ *   - Schema factory functions (SchemaResolutionFunction) that accept an options object (Args) and return a schema or schema group.
+ *   - Already-instantiated schemas (IdiomaticSchema).
+ *
+ * Each factory function will be called with the provided `args` object, and the result will be included in the returned mapping.
+ * If a value is already a schema (not a function), it is returned as-is.
+ *
+ * @template SV - The schema validator type.
+ * @template T - An object whose values are either schema factory functions or instantiated schemas.
+ * @template Args - The type of the options object passed to each factory function (e.g., { validator, uuidId, ... }).
  *
- * @param {T} schemas - An object mapping schema names to factory functions. Each factory function should accept an object with a `validator` property.
- * @param {SV} validator - The schema validator instance to be passed to each schema factory function.
- * @returns {{ [K in keyof T]: ReturnType<T[K]> }} An object mapping each schema name to its instantiated schema.
+ * @param {T} schemas - An object mapping schema names to either factory functions (SchemaResolutionFunction) or instantiated schemas (IdiomaticSchema).
+ * @param {Args} args - The options object to be passed to each schema factory function.
+ * @returns {{ [K in keyof T]: T[K] extends SchemaResolutionFunction<Args> ? ReturnType<T[K]> : T[K] }} An object mapping each schema name to its resolved schema.
  *
  * @example
  * const schemas = {
- *   UserSchemas: ({ validator }) => createUserSchemas(validator),
- *   ProductSchemas: ({ validator }) => createProductSchemas(validator)
+ *   UserSchemas: (opts) => createUserSchemas(opts),
+ *   ProductSchemas: (opts) => createProductSchemas(opts),
+ *   AlreadyInstantiated: someSchemaObject
  * };
- * const mapped = mapServiceSchemas(schemas, myValidator);
- * // mapped.UserSchemas, mapped.ProductSchemas now contain the instantiated schemas
+ * const mapped = mapServiceSchemas(schemas, { validator: myValidator });
+ * // mapped.UserSchemas and mapped.ProductSchemas are instantiated, mapped.AlreadyInstantiated is passed through
  */
-declare function mapServiceSchemas<T extends Record<string, (options: {
-    validator: SV;
-}) => unknown>, SV extends AnySchemaValidator>(schemas: T, validator: SV): {
-    [K in keyof T]: ReturnType<T[K]>;
+declare function mapServiceSchemas<SV extends AnySchemaValidator, T extends Record<string, SchemaResolutionFunction<Args> | IdiomaticSchema<SV>>, Args extends Record<string, unknown>>(schemas: T, args: Args): {
+    [K in keyof T]: T[K] extends SchemaResolutionFunction<Args> ? ReturnType<T[K]> : T[K];
 };
 
 export { mapServiceSchemas, requestMapper, responseMapper };

package/lib/mappers/index.js

@@ -61,10 +61,18 @@ function responseMapper(schemaValidator, domainSchema, _entityConstructor, mappe
   };
 }
 
+// src/mappers/guards/isSchemaResolutionFunction.ts
+function isSchemaResolutionFunction(value) {
+  return typeof value === "function";
+}
+
 // src/mappers/mapServiceSchemas.ts
-function mapServiceSchemas(schemas, validator) {
+function mapServiceSchemas(schemas, args) {
   return Object.fromEntries(
-    Object.entries(schemas).map(([key, value]) => [key, value({ validator })])
+    Object.entries(schemas).map(([key, value]) => [
+      key,
+      isSchemaResolutionFunction(value) ? value(args) : value
+    ])
   );
 }
 // Annotate the CommonJS export names for ESM import in node:

package/lib/mappers/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mappers/index.ts","../../src/mappers/mapper.ts","../../src/mappers/mapServiceSchemas.ts"],"sourcesContent":["export * from './mapper';\nexport * from './mapServiceSchemas';\n","import { Prettify } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { Constructor } from '@mikro-orm/core';\n\nexport function requestMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toEntity: (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => Promise<Entity>;\n  }\n): {\n  schema: DomainSchema;\n} & typeof mapperDefinition {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toEntity: async (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => {\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), dto);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return mapperDefinition.toEntity(\n        dto as Schema<DomainSchema, SV>,\n        ...(args as AdditionalArgs)\n      );\n    }\n  };\n}\n\nexport function responseMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toDto: (\n      entity: Entity,\n      ...args: AdditionalArgs\n    ) => Promise<Schema<DomainSchema, SV>>;\n  }\n): Prettify<\n  {\n    schema: DomainSchema;\n  } & typeof mapperDefinition\n> {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toDto: async (entity: Entity, ...args: AdditionalArgs) => {\n      const domain = await mapperDefinition.toDto(entity, ...args);\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), domain);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return domain;\n    }\n  };\n}\n","import { AnySchemaValidator } from '@forklaunch/validator';\n\n/**\n * Maps a set of service schema factory functions to their instantiated schemas using the provided validator.\n *\n * @template T - An object whose values are functions that accept an options object containing a validator and return a schema.\n * @template SV - The type of the schema validator.\n *\n * @param {T} schemas - An object mapping schema names to factory functions. Each factory function should accept an object with a `validator` property.\n * @param {SV} validator - The schema validator instance to be passed to each schema factory function.\n * @returns {{ [K in keyof T]: ReturnType<T[K]> }} An object mapping each schema name to its instantiated schema.\n *\n * @example\n * const schemas = {\n *   UserSchemas: ({ validator }) => createUserSchemas(validator),\n *   ProductSchemas: ({ validator }) => createProductSchemas(validator)\n * };\n * const mapped = mapServiceSchemas(schemas, myValidator);\n * // mapped.UserSchemas, mapped.ProductSchemas now contain the instantiated schemas\n */\nexport function mapServiceSchemas<\n  T extends Record<string, (options: { validator: SV }) => unknown>,\n  SV extends AnySchemaValidator\n>(\n  schemas: T,\n  validator: SV\n): {\n  [K in keyof T]: ReturnType<T[K]>;\n} {\n  return Object.fromEntries(\n    Object.entries(schemas).map(([key, value]) => [key, value({ validator })])\n  ) as {\n    [K in keyof T]: ReturnType<T[K]>;\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,uBAMO;AAGA,SAAS,cAMd,iBACA,cACA,oBACA,kBAQ0B;AAC1B,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,UAAU,OACR,QACG,SACA;AACH,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,GAAG;AAC5D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,UAAM,yCAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO,iBAAiB;AAAA,QACtB;AAAA,QACA,GAAI;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,eAMd,iBACA,cACA,oBACA,kBAUA;AACA,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,OAAO,OAAO,WAAmB,SAAyB;AACxD,YAAM,SAAS,MAAM,iBAAiB,MAAM,QAAQ,GAAG,IAAI;AAC3D,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,MAAM;AAC/D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,UAAM,yCAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AC/DO,SAAS,kBAId,SACA,WAGA;AACA,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAAA,EAC3E;AAGF;","names":[]}
+{"version":3,"sources":["../../src/mappers/index.ts","../../src/mappers/mapper.ts","../../src/mappers/guards/isSchemaResolutionFunction.ts","../../src/mappers/mapServiceSchemas.ts"],"sourcesContent":["export * from './mapper';\nexport * from './mapServiceSchemas';\n","import { Prettify } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { Constructor } from '@mikro-orm/core';\n\nexport function requestMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toEntity: (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => Promise<Entity>;\n  }\n): {\n  schema: DomainSchema;\n} & typeof mapperDefinition {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toEntity: async (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => {\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), dto);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return mapperDefinition.toEntity(\n        dto as Schema<DomainSchema, SV>,\n        ...(args as AdditionalArgs)\n      );\n    }\n  };\n}\n\nexport function responseMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toDto: (\n      entity: Entity,\n      ...args: AdditionalArgs\n    ) => Promise<Schema<DomainSchema, SV>>;\n  }\n): Prettify<\n  {\n    schema: DomainSchema;\n  } & typeof mapperDefinition\n> {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toDto: async (entity: Entity, ...args: AdditionalArgs) => {\n      const domain = await mapperDefinition.toDto(entity, ...args);\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), domain);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return domain;\n    }\n  };\n}\n","import { SchemaResolutionFunction } from '../types/schemaResolution.types';\n\n/**\n * Type guard to determine if a value is a SchemaResolutionFunction.\n *\n * @template Args - The type of the options object expected by the schema resolution function.\n * @param {unknown} value - The value to check.\n * @returns {value is SchemaResolutionFunction<Args>} True if the value is a function (assumed to be a SchemaResolutionFunction), false otherwise.\n */\nexport function isSchemaResolutionFunction<\n  Args extends Record<string, unknown>\n>(value: unknown): value is SchemaResolutionFunction<Args> {\n  return typeof value === 'function';\n}\n","import { AnySchemaValidator, IdiomaticSchema } from '@forklaunch/validator';\nimport { isSchemaResolutionFunction } from './guards/isSchemaResolutionFunction';\nimport { SchemaResolutionFunction } from './types/schemaResolution.types';\n\n/**\n * Maps a set of service schema factories or pre-instantiated schemas to their resolved schemas using the provided arguments.\n *\n * This utility allows you to provide an object whose values are either:\n *   - Schema factory functions (SchemaResolutionFunction) that accept an options object (Args) and return a schema or schema group.\n *   - Already-instantiated schemas (IdiomaticSchema).\n *\n * Each factory function will be called with the provided `args` object, and the result will be included in the returned mapping.\n * If a value is already a schema (not a function), it is returned as-is.\n *\n * @template SV - The schema validator type.\n * @template T - An object whose values are either schema factory functions or instantiated schemas.\n * @template Args - The type of the options object passed to each factory function (e.g., { validator, uuidId, ... }).\n *\n * @param {T} schemas - An object mapping schema names to either factory functions (SchemaResolutionFunction) or instantiated schemas (IdiomaticSchema).\n * @param {Args} args - The options object to be passed to each schema factory function.\n * @returns {{ [K in keyof T]: T[K] extends SchemaResolutionFunction<Args> ? ReturnType<T[K]> : T[K] }} An object mapping each schema name to its resolved schema.\n *\n * @example\n * const schemas = {\n *   UserSchemas: (opts) => createUserSchemas(opts),\n *   ProductSchemas: (opts) => createProductSchemas(opts),\n *   AlreadyInstantiated: someSchemaObject\n * };\n * const mapped = mapServiceSchemas(schemas, { validator: myValidator });\n * // mapped.UserSchemas and mapped.ProductSchemas are instantiated, mapped.AlreadyInstantiated is passed through\n */\nexport function mapServiceSchemas<\n  SV extends AnySchemaValidator,\n  T extends Record<\n    string,\n    SchemaResolutionFunction<Args> | IdiomaticSchema<SV>\n  >,\n  Args extends Record<string, unknown>\n>(\n  schemas: T,\n  args: Args\n): {\n  [K in keyof T]: T[K] extends SchemaResolutionFunction<Args>\n    ? ReturnType<T[K]>\n    : T[K];\n} {\n  return Object.fromEntries(\n    Object.entries(schemas).map(([key, value]) => [\n      key,\n      isSchemaResolutionFunction(value) ? value(args) : value\n    ])\n  ) as {\n    [K in keyof T]: T[K] extends SchemaResolutionFunction<Args>\n      ? ReturnType<T[K]>\n      : T[K];\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,uBAMO;AAGA,SAAS,cAMd,iBACA,cACA,oBACA,kBAQ0B;AAC1B,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,UAAU,OACR,QACG,SACA;AACH,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,GAAG;AAC5D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,UAAM,yCAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO,iBAAiB;AAAA,QACtB;AAAA,QACA,GAAI;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,eAMd,iBACA,cACA,oBACA,kBAUA;AACA,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,OAAO,OAAO,WAAmB,SAAyB;AACxD,YAAM,SAAS,MAAM,iBAAiB,MAAM,QAAQ,GAAG,IAAI;AAC3D,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,MAAM;AAC/D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,UAAM,yCAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AC1EO,SAAS,2BAEd,OAAyD;AACzD,SAAO,OAAO,UAAU;AAC1B;;;ACkBO,SAAS,kBAQd,SACA,MAKA;AACA,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAAA,MAC5C;AAAA,MACA,2BAA2B,KAAK,IAAI,MAAM,IAAI,IAAI;AAAA,IACpD,CAAC;AAAA,EACH;AAKF;","names":[]}

package/lib/mappers/index.mjs

@@ -35,10 +35,18 @@ function responseMapper(schemaValidator, domainSchema, _entityConstructor, mappe
   };
 }
 
+// src/mappers/guards/isSchemaResolutionFunction.ts
+function isSchemaResolutionFunction(value) {
+  return typeof value === "function";
+}
+
 // src/mappers/mapServiceSchemas.ts
-function mapServiceSchemas(schemas, validator) {
+function mapServiceSchemas(schemas, args) {
   return Object.fromEntries(
-    Object.entries(schemas).map(([key, value]) => [key, value({ validator })])
+    Object.entries(schemas).map(([key, value]) => [
+      key,
+      isSchemaResolutionFunction(value) ? value(args) : value
+    ])
   );
 }
 export {

package/lib/mappers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mappers/mapper.ts","../../src/mappers/mapServiceSchemas.ts"],"sourcesContent":["import { Prettify } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { Constructor } from '@mikro-orm/core';\n\nexport function requestMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toEntity: (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => Promise<Entity>;\n  }\n): {\n  schema: DomainSchema;\n} & typeof mapperDefinition {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toEntity: async (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => {\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), dto);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return mapperDefinition.toEntity(\n        dto as Schema<DomainSchema, SV>,\n        ...(args as AdditionalArgs)\n      );\n    }\n  };\n}\n\nexport function responseMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toDto: (\n      entity: Entity,\n      ...args: AdditionalArgs\n    ) => Promise<Schema<DomainSchema, SV>>;\n  }\n): Prettify<\n  {\n    schema: DomainSchema;\n  } & typeof mapperDefinition\n> {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toDto: async (entity: Entity, ...args: AdditionalArgs) => {\n      const domain = await mapperDefinition.toDto(entity, ...args);\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), domain);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return domain;\n    }\n  };\n}\n","import { AnySchemaValidator } from '@forklaunch/validator';\n\n/**\n * Maps a set of service schema factory functions to their instantiated schemas using the provided validator.\n *\n * @template T - An object whose values are functions that accept an options object containing a validator and return a schema.\n * @template SV - The type of the schema validator.\n *\n * @param {T} schemas - An object mapping schema names to factory functions. Each factory function should accept an object with a `validator` property.\n * @param {SV} validator - The schema validator instance to be passed to each schema factory function.\n * @returns {{ [K in keyof T]: ReturnType<T[K]> }} An object mapping each schema name to its instantiated schema.\n *\n * @example\n * const schemas = {\n *   UserSchemas: ({ validator }) => createUserSchemas(validator),\n *   ProductSchemas: ({ validator }) => createProductSchemas(validator)\n * };\n * const mapped = mapServiceSchemas(schemas, myValidator);\n * // mapped.UserSchemas, mapped.ProductSchemas now contain the instantiated schemas\n */\nexport function mapServiceSchemas<\n  T extends Record<string, (options: { validator: SV }) => unknown>,\n  SV extends AnySchemaValidator\n>(\n  schemas: T,\n  validator: SV\n): {\n  [K in keyof T]: ReturnType<T[K]>;\n} {\n  return Object.fromEntries(\n    Object.entries(schemas).map(([key, value]) => [key, value({ validator })])\n  ) as {\n    [K in keyof T]: ReturnType<T[K]>;\n  };\n}\n"],"mappings":";AACA;AAAA,EAGE;AAAA,OAGK;AAGA,SAAS,cAMd,iBACA,cACA,oBACA,kBAQ0B;AAC1B,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,UAAU,OACR,QACG,SACA;AACH,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,GAAG;AAC5D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,MAAM,uBAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO,iBAAiB;AAAA,QACtB;AAAA,QACA,GAAI;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,eAMd,iBACA,cACA,oBACA,kBAUA;AACA,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,OAAO,OAAO,WAAmB,SAAyB;AACxD,YAAM,SAAS,MAAM,iBAAiB,MAAM,QAAQ,GAAG,IAAI;AAC3D,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,MAAM;AAC/D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,MAAM,uBAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AC/DO,SAAS,kBAId,SACA,WAGA;AACA,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAAA,EAC3E;AAGF;","names":[]}
+{"version":3,"sources":["../../src/mappers/mapper.ts","../../src/mappers/guards/isSchemaResolutionFunction.ts","../../src/mappers/mapServiceSchemas.ts"],"sourcesContent":["import { Prettify } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { Constructor } from '@mikro-orm/core';\n\nexport function requestMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toEntity: (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => Promise<Entity>;\n  }\n): {\n  schema: DomainSchema;\n} & typeof mapperDefinition {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toEntity: async (\n      dto: Schema<DomainSchema, SV>,\n      ...args: AdditionalArgs\n    ) => {\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), dto);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return mapperDefinition.toEntity(\n        dto as Schema<DomainSchema, SV>,\n        ...(args as AdditionalArgs)\n      );\n    }\n  };\n}\n\nexport function responseMapper<\n  SV extends AnySchemaValidator,\n  DomainSchema extends IdiomaticSchema<SV>,\n  Entity,\n  AdditionalArgs extends unknown[] = []\n>(\n  schemaValidator: SV,\n  domainSchema: DomainSchema,\n  _entityConstructor: Constructor<Entity>,\n  mapperDefinition: {\n    toDto: (\n      entity: Entity,\n      ...args: AdditionalArgs\n    ) => Promise<Schema<DomainSchema, SV>>;\n  }\n): Prettify<\n  {\n    schema: DomainSchema;\n  } & typeof mapperDefinition\n> {\n  const sv = schemaValidator as SchemaValidator;\n  return {\n    ...mapperDefinition,\n    schema: domainSchema,\n\n    toDto: async (entity: Entity, ...args: AdditionalArgs) => {\n      const domain = await mapperDefinition.toDto(entity, ...args);\n      const parsedSchema = sv.parse(sv.schemify(domainSchema), domain);\n      if (!parsedSchema.ok) {\n        throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n      }\n      return domain;\n    }\n  };\n}\n","import { SchemaResolutionFunction } from '../types/schemaResolution.types';\n\n/**\n * Type guard to determine if a value is a SchemaResolutionFunction.\n *\n * @template Args - The type of the options object expected by the schema resolution function.\n * @param {unknown} value - The value to check.\n * @returns {value is SchemaResolutionFunction<Args>} True if the value is a function (assumed to be a SchemaResolutionFunction), false otherwise.\n */\nexport function isSchemaResolutionFunction<\n  Args extends Record<string, unknown>\n>(value: unknown): value is SchemaResolutionFunction<Args> {\n  return typeof value === 'function';\n}\n","import { AnySchemaValidator, IdiomaticSchema } from '@forklaunch/validator';\nimport { isSchemaResolutionFunction } from './guards/isSchemaResolutionFunction';\nimport { SchemaResolutionFunction } from './types/schemaResolution.types';\n\n/**\n * Maps a set of service schema factories or pre-instantiated schemas to their resolved schemas using the provided arguments.\n *\n * This utility allows you to provide an object whose values are either:\n *   - Schema factory functions (SchemaResolutionFunction) that accept an options object (Args) and return a schema or schema group.\n *   - Already-instantiated schemas (IdiomaticSchema).\n *\n * Each factory function will be called with the provided `args` object, and the result will be included in the returned mapping.\n * If a value is already a schema (not a function), it is returned as-is.\n *\n * @template SV - The schema validator type.\n * @template T - An object whose values are either schema factory functions or instantiated schemas.\n * @template Args - The type of the options object passed to each factory function (e.g., { validator, uuidId, ... }).\n *\n * @param {T} schemas - An object mapping schema names to either factory functions (SchemaResolutionFunction) or instantiated schemas (IdiomaticSchema).\n * @param {Args} args - The options object to be passed to each schema factory function.\n * @returns {{ [K in keyof T]: T[K] extends SchemaResolutionFunction<Args> ? ReturnType<T[K]> : T[K] }} An object mapping each schema name to its resolved schema.\n *\n * @example\n * const schemas = {\n *   UserSchemas: (opts) => createUserSchemas(opts),\n *   ProductSchemas: (opts) => createProductSchemas(opts),\n *   AlreadyInstantiated: someSchemaObject\n * };\n * const mapped = mapServiceSchemas(schemas, { validator: myValidator });\n * // mapped.UserSchemas and mapped.ProductSchemas are instantiated, mapped.AlreadyInstantiated is passed through\n */\nexport function mapServiceSchemas<\n  SV extends AnySchemaValidator,\n  T extends Record<\n    string,\n    SchemaResolutionFunction<Args> | IdiomaticSchema<SV>\n  >,\n  Args extends Record<string, unknown>\n>(\n  schemas: T,\n  args: Args\n): {\n  [K in keyof T]: T[K] extends SchemaResolutionFunction<Args>\n    ? ReturnType<T[K]>\n    : T[K];\n} {\n  return Object.fromEntries(\n    Object.entries(schemas).map(([key, value]) => [\n      key,\n      isSchemaResolutionFunction(value) ? value(args) : value\n    ])\n  ) as {\n    [K in keyof T]: T[K] extends SchemaResolutionFunction<Args>\n      ? ReturnType<T[K]>\n      : T[K];\n  };\n}\n"],"mappings":";AACA;AAAA,EAGE;AAAA,OAGK;AAGA,SAAS,cAMd,iBACA,cACA,oBACA,kBAQ0B;AAC1B,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,UAAU,OACR,QACG,SACA;AACH,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,GAAG;AAC5D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,MAAM,uBAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO,iBAAiB;AAAA,QACtB;AAAA,QACA,GAAI;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,eAMd,iBACA,cACA,oBACA,kBAUA;AACA,QAAM,KAAK;AACX,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IAER,OAAO,OAAO,WAAmB,SAAyB;AACxD,YAAM,SAAS,MAAM,iBAAiB,MAAM,QAAQ,GAAG,IAAI;AAC3D,YAAM,eAAe,GAAG,MAAM,GAAG,SAAS,YAAY,GAAG,MAAM;AAC/D,UAAI,CAAC,aAAa,IAAI;AACpB,cAAM,IAAI,MAAM,uBAAuB,aAAa,QAAQ,KAAK,CAAC;AAAA,MACpE;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AC1EO,SAAS,2BAEd,OAAyD;AACzD,SAAO,OAAO,UAAU;AAC1B;;;ACkBO,SAAS,kBAQd,SACA,MAKA;AACA,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAAA,MAC5C;AAAA,MACA,2BAA2B,KAAK,IAAI,MAAM,IAAI,IAAI;AAAA,IACpD,CAAC;AAAA,EACH;AAKF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/core",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "description": "forklaunch-js core package. Contains useful building blocks.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -91,8 +91,8 @@
     "pino-pretty": "^13.1.1",
     "redis": "^5.8.2",
     "uuid": "^11.1.0",
-    "@forklaunch/common": "0.6.4",
-    "@forklaunch/validator": "0.10.4"
+    "@forklaunch/common": "0.6.5",
+    "@forklaunch/validator": "0.10.5"
   },
   "devDependencies": {
     "@eslint/js": "^9.34.0",