@forklaunch/core 1.5.2 → 1.5.4

package/lib/http/types/sdk.types.d.ts

@@ -0,0 +1,259 @@
+import { Prettify, TypeSafeFunction, UnionToIntersection } from '@forklaunch/common';
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { LiveSdkFunction, LiveTypeFunction } from './apiDefinition.types';
+import { AuthMethodsBase, Body, HeadersObject, Method, ParamsObject, QueryObject, ResponsesObject, VersionSchema } from './contractDetails.types';
+/**
+ * Creates a type-safe fetch function based on a provided fetch map.
+ * This type generates a function that provides compile-time type safety for HTTP requests,
+ * ensuring that the correct path and request parameters are used for each endpoint.
+ *
+ * @template FetchMap - A record mapping paths to their corresponding TypeSafeFunction signatures
+ * @param FetchMap[Path] - Each path should map to a TypeSafeFunction that defines the request/response contract
+ *
+ * @returns A generic function that:
+ * - Takes a path parameter constrained to keys of FetchMap
+ * - Takes optional request initialization parameters based on the function signature
+ * - Returns a Promise of the expected response type
+ *
+ * @remarks
+ * The function parameters are conditionally typed:
+ * - If the mapped function expects body, query, params, or headers, reqInit is required
+ * - Otherwise, reqInit is optional
+ * - If the path doesn't map to a TypeSafeFunction, reqInit is never
+ **/
+export type FetchFunction<FetchMap> = <const Path extends keyof FetchMap, const Method extends keyof FetchMap[Path], const Version extends keyof FetchMap[Path][Method]>(path: Path, ...reqInit: FetchMap[Path][Method] extends TypeSafeFunction ? 'GET' extends keyof FetchMap[Path] ? FetchMap[Path]['GET'] extends TypeSafeFunction ? Parameters<FetchMap[Path]['GET']>[1] extends {
+    body: unknown;
+} | {
+    query: unknown;
+} | {
+    params: unknown;
+} | {
+    headers: unknown;
+} | {
+    version: unknown;
+} ? [
+    reqInit: Omit<Parameters<FetchMap[Path][Method]>[1], 'method'> & {
+        method: Method;
+    }
+] : [
+    reqInit?: Omit<Parameters<FetchMap[Path][Method]>[1], 'method'> & {
+        method: Method;
+    }
+] : [
+    reqInit: Omit<Parameters<FetchMap[Path][Method]>[1], 'method'> & {
+        method: Method;
+    }
+] : [
+    reqInit: Omit<Parameters<FetchMap[Path][Method]>[1], 'method'> & {
+        method: Method;
+    }
+] : FetchMap[Path][Method] extends Record<string, TypeSafeFunction> ? [
+    reqInit: Omit<Parameters<FetchMap[Path][Method][Version]>[0], 'method' | 'version'> & {
+        method: Method;
+        version: Version;
+    }
+] : [{
+    method: Method;
+}]) => Promise<FetchMap[Path][Method] extends TypeSafeFunction ? Awaited<ReturnType<FetchMap[Path][Method]>> : FetchMap[Path][Method] extends Record<string, TypeSafeFunction> ? Awaited<ReturnType<FetchMap[Path][Method][Version]>> : never>;
+/**
+ * Represents the structure of a SDK router.
+ *
+ * @property sdk - The SDK object containing all the SDK functions.
+ * @property _fetchMap - The fetch map object containing all the fetch functions.
+ * @property sdkPaths - The SDK paths object containing all the SDK paths.
+ */
+export type SdkRouter = {
+    sdk: Record<string, unknown>;
+    _fetchMap: Record<string, unknown>;
+    sdkPaths: Record<string, string>;
+};
+/**
+ * Recursive interface representing a hierarchical map of router configurations.
+ * Each entry can either be a leaf node with SDK and fetch map configurations,
+ * or a nested RouterMap for deeper routing structures.
+ *
+ * @template SV - The schema validator type that constrains the router structure
+ * @param SV - Must extend AnySchemaValidator to ensure type safety
+ *
+ * @example
+ * ```typescript
+ * const routerMap: RouterMap<ZodValidator> = {
+ *   api: {
+ *     users: {
+ *       sdk: { getUser: () => Promise.resolve({}) },
+ *       _fetchMap: { getUser: { get: () => fetch('/api/users') } }
+ *     },
+ *     posts: {
+ *       sdk: { getPosts: () => Promise.resolve([]) },
+ *       _fetchMap: { getPosts: { get: () => fetch('/api/posts') } }
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export type RouterMap<SV extends AnySchemaValidator> = {
+    [K: string]: SdkRouter | RouterMap<SV>;
+};
+/**
+ * Recursive type representing a hierarchical map of SDK handlers.
+ * Each key can either be a leaf node containing a SdkHandler, or a nested SdkHandlerObject for deeper structures.
+ *
+ * @template SV - The schema validator type that constrains the handler structure.
+ *
+ * @example
+ * ```typescript
+ * const handlers: SdkHandlerObject<ZodValidator> = {
+ *   users: {
+ *     getUser: someSdkHandler,
+ *     posts: {
+ *       getPosts: anotherSdkHandler
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export type SdkHandlerObject<SV extends AnySchemaValidator> = {
+    [K: string]: SdkHandler | SdkHandlerObject<SV>;
+};
+/**
+ * @deprecated
+ * Tail-recursive type that extracts and flattens fetch map interfaces from a RouterMap structure.
+ * This version uses an accumulator pattern to avoid deep recursion and improve performance.
+ * Similar to MapToSdk but focuses on _fetchMap properties and merges all fetch maps into a single intersection type.
+ *
+ * @template SV - The schema validator type
+ * @template T - The RouterMap to extract fetch maps from
+ * @template Acc - The accumulator type for collecting fetch maps (defaults to empty object)
+ * @param SV - Must extend AnySchemaValidator
+ * @param T - Must extend RouterMap<SV>
+ * @param Acc - The accumulated fetch maps so far
+ *
+ * @returns An intersection type containing all fetch map interfaces from the router structure,
+ *         flattened into a single type for unified fetch functionality
+ *
+ * @example
+ * ```typescript
+ * // Given a RouterMap with nested fetch maps
+ * type ExtractedFetch = MapToFetch<ZodValidator, typeof routerMap>;
+ * // Results in: { getUser: { get: () => Promise<Response> } } & { getPosts: { get: () => Promise<Response> } }
+ * ```
+ */
+export type MapToFetch<SV extends AnySchemaValidator, T extends RouterMap<SV>> = UnionToIntersection<Prettify<{
+    [K in keyof T]: T[K] extends RouterMap<SV> ? MapToFetch<SV, T[K]> : T[K] extends {
+        _fetchMap: unknown;
+    } ? T[K]['_fetchMap'] extends Record<string, unknown> ? T[K]['_fetchMap'] : never : never;
+}[keyof T]>>;
+/**
+ * Base interface for controller entries that defines the structure
+ * of each controller method with its path, HTTP method, and contract details.
+ * This type serves as the foundation for type-safe SDK generation by ensuring
+ * all controller entries follow a consistent structure.
+ *
+ * @example
+ * ```typescript
+ * const controller: Record<string, SdkHandler> = {
+ *   createUser: {
+ *     _path: '/users',
+ *     _method: 'post',
+ *     contractDetails: {
+ *       name: 'createUser',
+ *       body: { name: string, email: string },
+ *       responses: { 201: { id: string, name: string } }
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export type SdkHandler = {
+    /** The HTTP path for this endpoint, must start with '/' */
+    _path?: `/${string}`;
+    /** The HTTP method for this endpoint (get, post, put, etc.) */
+    _method?: Method;
+    /** Contract details defining the request/response schema for this endpoint */
+    contractDetails: {
+        /** The name of this endpoint/method */
+        name: string;
+        /** URL parameters schema */
+        params?: unknown;
+        /** Response schemas for different status codes */
+        responses?: unknown;
+        /** Query parameters schema */
+        query?: unknown;
+        /** Request body schema */
+        body?: unknown;
+        /** Request headers schema */
+        requestHeaders?: unknown;
+        /** Response headers schema */
+        responseHeaders?: unknown;
+        /** Authentication requirements */
+        auth?: unknown;
+        /** API versioning information */
+        versions?: unknown;
+    };
+};
+/**
+ * Recursively maps a client controller definition to its corresponding live SDK function types.
+ *
+ * This utility type traverses the structure of a client controller object, replacing each
+ * {@link SdkHandler} with its corresponding {@link MapHandlerToLiveSdk} type, while recursively
+ * processing nested objects. This enables type-safe SDK generation for complex controller hierarchies.
+ *
+ * @template SV - The schema validator type (e.g., zod, typebox).
+ * @template Client - The client controller object to map.
+ *
+ * @example
+ * type MySdk = MapToSdk<typeof z, typeof myController>;
+ */
+export type MapToSdk<SV extends AnySchemaValidator, Client> = {
+    [K in keyof Client]: Client[K] extends SdkHandler ? MapHandlerToLiveSdk<SV, Client[K]> : MapToSdk<SV, Client[K]>;
+};
+export type MapHandlerToLiveSdk<SV extends AnySchemaValidator, T extends SdkHandler> = LiveSdkFunction<SV, T['contractDetails']['params'] extends infer Params | undefined ? Params extends ParamsObject<SV> ? Params : ParamsObject<SV> : ParamsObject<SV>, T['contractDetails']['responses'] extends infer Responses | undefined ? Responses extends ResponsesObject<SV> ? Responses : ResponsesObject<SV> : ResponsesObject<SV>, T['contractDetails']['body'] extends infer B | undefined ? B extends Body<SV> ? B : Body<SV> : Body<SV>, T['contractDetails']['query'] extends infer Q | undefined ? Q extends QueryObject<SV> ? Q : QueryObject<SV> : QueryObject<SV>, T['contractDetails']['requestHeaders'] extends infer RequestHeaders | undefined ? RequestHeaders extends HeadersObject<SV> ? RequestHeaders : HeadersObject<SV> : HeadersObject<SV>, T['contractDetails']['responseHeaders'] extends infer ResponseHeaders | undefined ? ResponseHeaders extends HeadersObject<SV> ? ResponseHeaders : HeadersObject<SV> : HeadersObject<SV>, T['contractDetails']['versions'] extends infer Versions | undefined ? Versions extends VersionSchema<SV, Method> ? Versions : VersionSchema<SV, Method> : VersionSchema<SV, Method>, T['contractDetails']['auth'] extends infer Auth | undefined ? Auth extends AuthMethodsBase ? Auth : AuthMethodsBase : AuthMethodsBase>;
+/**
+ * @deprecated
+ * Extracts and constructs a LiveTypeFunction from an SdkHandler object.
+ * This optimized version reduces redundant type inference while maintaining type safety.
+ *
+ * @template Entry - The controller entry containing path, method, and contract details
+ * @template SV - The schema validator type that constrains the contract details
+ * @template BasePath - The base path prefix to prepend to the entry's path
+ *
+ * @example
+ * ```typescript
+ * type UserCreateFunction = ExtractLiveTypeFn<
+ *   { _path: '/users', _method: 'post', contractDetails: { body: { name: string } } },
+ *   SchemaValidator,
+ *   '/api/v1'
+ * >;
+ * ```
+ */
+export type ExtractLiveTypeFn<Entry extends SdkHandler, SV extends AnySchemaValidator, BasePath extends `/${string}`> = LiveTypeFunction<SV, Entry['_path'] extends infer Path | undefined ? Path extends `/${string}` ? `${BasePath}${Path}` : never : never, Entry['contractDetails']['params'] extends infer Params | undefined ? Params extends ParamsObject<SV> ? Params : ParamsObject<SV> : ParamsObject<SV>, Entry['contractDetails']['responses'] extends infer Responses | undefined ? Responses extends ResponsesObject<SV> ? Responses : ResponsesObject<SV> : ResponsesObject<SV>, Entry['contractDetails']['body'] extends infer B | undefined ? B extends Body<SV> ? B : Body<SV> : Body<SV>, Entry['contractDetails']['query'] extends infer Q | undefined ? Q extends QueryObject<SV> ? Q : QueryObject<SV> : QueryObject<SV>, Entry['contractDetails']['requestHeaders'] extends infer RequestHeaders | undefined ? RequestHeaders extends HeadersObject<SV> ? RequestHeaders : HeadersObject<SV> : HeadersObject<SV>, Entry['contractDetails']['responseHeaders'] extends infer ResponseHeaders | undefined ? ResponseHeaders extends HeadersObject<SV> ? ResponseHeaders : HeadersObject<SV> : HeadersObject<SV>, Entry['_method'] extends Method ? Entry['_method'] : never, Entry['contractDetails']['versions'] extends infer Versions | undefined ? Versions extends VersionSchema<SV, Method> ? Versions : VersionSchema<SV, Method> : VersionSchema<SV, Method>, Entry['contractDetails']['auth'] extends infer Auth | undefined ? Auth extends AuthMethodsBase ? Auth : AuthMethodsBase : AuthMethodsBase>;
+/**
+ * @deprecated
+ * Transforms a controller object into a fetch map structure that provides
+ * type-safe access to HTTP endpoints. This optimized version reduces complexity
+ * while maintaining full type safety and discriminated union behavior.
+ *
+ * @template T - The controller object type containing all endpoint definitions
+ * @template SV - The schema validator type that constrains the contract details
+ * @template RouterBasePath - The base path prefix for the router
+ *
+ * @example
+ * ```typescript
+ * const controller = {
+ *   createUser: { _path: '/users', _method: 'post', contractDetails: { body: { name: string } } },
+ *   getUser: { _path: '/users/:id', _method: 'get', contractDetails: { params: { id: string } } }
+ * } as const;
+ *
+ * type FetchMap = ToFetchMap<typeof controller, SchemaValidator, '/api/v1'>;
+ * // Results in properly typed fetch map with discriminated methods per path
+ * ```
+ */
+export type ToFetchMap<T extends Record<string, SdkHandler>, SV extends AnySchemaValidator, RouterBasePath extends `/${string}`> = Prettify<{
+    [K in keyof T as T[K]['_path'] extends infer P | undefined ? P extends `/${string}` ? `${RouterBasePath}${P}` : never : never]: {
+        [M in T[K]['_method'] as M extends Method ? Uppercase<M> : never]: ExtractLiveTypeFn<Extract<T[K], {
+            _path: T[K]['_path'];
+            _method: M;
+        }>, SV, RouterBasePath>;
+    };
+}>;
+//# sourceMappingURL=sdk.types.d.ts.map

package/lib/http/types/sdk.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.types.d.ts","sourceRoot":"","sources":["../../../src/http/types/sdk.types.ts"],"names":[],"mappings":"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"}

package/lib/http/types/typedHandler.types.d.ts

@@ -0,0 +1,18 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ExpressLikeSchemaHandler } from './apiDefinition.types';
+import { Body, ContractDetails, HeadersObject, Method, ParamsObject, QueryObject, ResolvedSessionObject, ResponsesObject, SchemaAuthMethods, SessionObject, VersionSchema } from './contractDetails.types';
+export type ContractDetailsExpressLikeSchemaHandler<SV extends AnySchemaValidator, ContractMethod extends Method, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>, VersionedApi extends VersionSchema<SV, ContractMethod>, BaseRequest, BaseResponse, NextFunction, Auth extends SchemaAuthMethods<SV, P, ReqBody, ReqQuery, ReqHeaders, VersionedApi, BaseRequest>> = ExpressLikeSchemaHandler<SV, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, VersionedApi, ResolvedSessionObject<SV, Auth, SessionObject<SV>>, BaseRequest, BaseResponse, NextFunction>;
+export type TypedHandler<SV extends AnySchemaValidator, Name extends string, ContractMethod extends Method, Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>, VersionedApi extends VersionSchema<SV, ContractMethod>, BaseRequest, BaseResponse, NextFunction, Auth extends SchemaAuthMethods<SV, P, ReqBody, ReqQuery, ReqHeaders, VersionedApi, BaseRequest>> = {
+    _typedHandler: true;
+    _path: Path | undefined;
+    contractDetails: ContractDetails<SV, Name, ContractMethod, Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, VersionedApi, BaseRequest, Auth>;
+    handlers: ContractDetailsExpressLikeSchemaHandler<SV, ContractMethod, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, VersionedApi, BaseRequest, BaseResponse, NextFunction, Auth>[];
+};
+export type ExpressLikeTypedHandler<SV extends AnySchemaValidator, Name extends string, ContractMethod extends Method, Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>, VersionedApi extends VersionSchema<SV, ContractMethod>, BaseRequest, BaseResponse, NextFunction, Auth extends SchemaAuthMethods<SV, P, ReqBody, ReqQuery, ReqHeaders, VersionedApi, BaseRequest>> = {
+    _typedHandler: true;
+    _path: Path | undefined;
+    _method: ContractMethod;
+    contractDetails: ContractDetails<SV, Name, ContractMethod, Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, VersionedApi, BaseRequest, Auth>;
+    handlers: ExpressLikeSchemaHandler<SV, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, VersionedApi, ResolvedSessionObject<SV, Auth, SessionObject<SV>>, BaseRequest, BaseResponse, NextFunction>[];
+};
+//# sourceMappingURL=typedHandler.types.d.ts.map

package/lib/http/types/typedHandler.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedHandler.types.d.ts","sourceRoot":"","sources":["../../../src/http/types/typedHandler.types.ts"],"names":[],"mappings":"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"}

package/lib/mappers/guards/isSchemaResolutionFunction.d.ts

@@ -0,0 +1,10 @@
+import { SchemaResolutionFunction } from '../types/schemaResolution.types';
+/**
+ * Type guard to determine if a value is a SchemaResolutionFunction.
+ *
+ * @template Args - The type of the options object expected by the schema resolution function.
+ * @param {unknown} value - The value to check.
+ * @returns {value is SchemaResolutionFunction<Args>} True if the value is a function (assumed to be a SchemaResolutionFunction), false otherwise.
+ */
+export declare function isSchemaResolutionFunction<Args extends Record<string, unknown>>(value: unknown): value is SchemaResolutionFunction<Args>;
+//# sourceMappingURL=isSchemaResolutionFunction.d.ts.map

package/lib/mappers/guards/isSchemaResolutionFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSchemaResolutionFunction.d.ts","sourceRoot":"","sources":["../../../src/mappers/guards/isSchemaResolutionFunction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAEzD"}

package/lib/mappers/index.d.ts

@@ -1,68 +1,3 @@
-import { Prettify } from '@forklaunch/common';
-import { AnySchemaValidator, IdiomaticSchema, Schema } from '@forklaunch/validator';
-import { EntitySchema, InferEntity } from '@mikro-orm/core';
-
-declare function requestMapper<SV extends AnySchemaValidator, DomainSchema extends IdiomaticSchema<SV>, Entity extends EntitySchema, AdditionalArgs extends unknown[] = []>({ schemaValidator, schema, entity, mapperDefinition }: {
-    schemaValidator: SV;
-    schema: DomainSchema;
-    entity: Entity;
-    mapperDefinition: {
-        toEntity: (dto: Schema<DomainSchema, SV>, ...args: AdditionalArgs) => Promise<InferEntity<Entity>>;
-    };
-}): {
-    entity: Entity;
-    schema: DomainSchema;
-} & typeof mapperDefinition;
-declare function responseMapper<SV extends AnySchemaValidator, DomainSchema extends IdiomaticSchema<SV>, Entity extends EntitySchema, AdditionalArgs extends unknown[] = []>({ schemaValidator, schema, entity, mapperDefinition }: {
-    schemaValidator: SV;
-    schema: DomainSchema;
-    entity: Entity;
-    mapperDefinition: {
-        toDto: (entity: InferEntity<Entity>, ...args: AdditionalArgs) => Promise<Schema<DomainSchema, SV>>;
-    };
-}): Prettify<{
-    entity: Entity;
-    schema: DomainSchema;
-} & typeof mapperDefinition>;
-
-/**
- * A function type that, given an options object, returns a schema or schema-like object.
- *
- * @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 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: (opts) => createUserSchemas(opts),
- *   ProductSchemas: (opts) => createProductSchemas(opts),
- *   AlreadyInstantiated: someSchemaObject
- * };
- * const mapped = mapServiceSchemas(schemas, { validator: myValidator });
- * // mapped.UserSchemas and mapped.ProductSchemas are instantiated, mapped.AlreadyInstantiated is passed through
- */
-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 };
+export * from './mapper';
+export * from './mapServiceSchemas';
+//# sourceMappingURL=index.d.ts.map

package/lib/mappers/index.d.ts.map

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

package/lib/mappers/mapServiceSchemas.d.ts

@@ -0,0 +1,33 @@
+import { AnySchemaValidator, IdiomaticSchema } from '@forklaunch/validator';
+import { SchemaResolutionFunction } from './types/schemaResolution.types';
+/**
+ * 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 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: (opts) => createUserSchemas(opts),
+ *   ProductSchemas: (opts) => createProductSchemas(opts),
+ *   AlreadyInstantiated: someSchemaObject
+ * };
+ * const mapped = mapServiceSchemas(schemas, { validator: myValidator });
+ * // mapped.UserSchemas and mapped.ProductSchemas are instantiated, mapped.AlreadyInstantiated is passed through
+ */
+export 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];
+};
+//# sourceMappingURL=mapServiceSchemas.d.ts.map

package/lib/mappers/mapServiceSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapServiceSchemas.d.ts","sourceRoot":"","sources":["../../src/mappers/mapServiceSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,SAAS,kBAAkB,EAC7B,CAAC,SAAS,MAAM,CACd,MAAM,EACN,wBAAwB,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CACrD,EACD,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEpC,OAAO,EAAE,CAAC,EACV,IAAI,EAAE,IAAI,GACT;KACA,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,wBAAwB,CAAC,IAAI,CAAC,GACvD,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAChB,CAAC,CAAC,CAAC,CAAC;CACT,CAWA"}

package/lib/mappers/mapper.d.ts

@@ -0,0 +1,26 @@
+import { Prettify } from '@forklaunch/common';
+import { AnySchemaValidator, IdiomaticSchema, Schema } from '@forklaunch/validator';
+import { EntitySchema, InferEntity } from '@mikro-orm/core';
+export declare function requestMapper<SV extends AnySchemaValidator, DomainSchema extends IdiomaticSchema<SV>, Entity extends EntitySchema, AdditionalArgs extends unknown[] = []>({ schemaValidator, schema, entity, mapperDefinition }: {
+    schemaValidator: SV;
+    schema: DomainSchema;
+    entity: Entity;
+    mapperDefinition: {
+        toEntity: (dto: Schema<DomainSchema, SV>, ...args: AdditionalArgs) => Promise<InferEntity<Entity>>;
+    };
+}): {
+    entity: Entity;
+    schema: DomainSchema;
+} & typeof mapperDefinition;
+export declare function responseMapper<SV extends AnySchemaValidator, DomainSchema extends IdiomaticSchema<SV>, Entity extends EntitySchema, AdditionalArgs extends unknown[] = []>({ schemaValidator, schema, entity, mapperDefinition }: {
+    schemaValidator: SV;
+    schema: DomainSchema;
+    entity: Entity;
+    mapperDefinition: {
+        toDto: (entity: InferEntity<Entity>, ...args: AdditionalArgs) => Promise<Schema<DomainSchema, SV>>;
+    };
+}): Prettify<{
+    entity: Entity;
+    schema: DomainSchema;
+} & typeof mapperDefinition>;
+//# sourceMappingURL=mapper.d.ts.map

package/lib/mappers/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/mappers/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,eAAe,EAEf,MAAM,EAEP,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE5D,wBAAgB,aAAa,CAC3B,EAAE,SAAS,kBAAkB,EAC7B,YAAY,SAAS,eAAe,CAAC,EAAE,CAAC,EACxC,MAAM,SAAS,YAAY,EAC3B,cAAc,SAAS,OAAO,EAAE,GAAG,EAAE,EACrC,EACA,eAAe,EACf,MAAM,EACN,MAAM,EACN,gBAAgB,EACjB,EAAE;IACD,eAAe,EAAE,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE;QAChB,QAAQ,EAAE,CACR,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC,EAC7B,GAAG,IAAI,EAAE,cAAc,KACpB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;KACnC,CAAC;CACH,GAAG;IACF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,OAAO,gBAAgB,CAqB1B;AAED,wBAAgB,cAAc,CAC5B,EAAE,SAAS,kBAAkB,EAC7B,YAAY,SAAS,eAAe,CAAC,EAAE,CAAC,EACxC,MAAM,SAAS,YAAY,EAC3B,cAAc,SAAS,OAAO,EAAE,GAAG,EAAE,EACrC,EACA,eAAe,EACf,MAAM,EACN,MAAM,EACN,gBAAgB,EACjB,EAAE;IACD,eAAe,EAAE,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE;QAChB,KAAK,EAAE,CACL,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,GAAG,IAAI,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;KACxC,CAAC;CACH,GAAG,QAAQ,CACV;IACE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,OAAO,gBAAgB,CAC5B,CAgBA"}

package/lib/mappers/types/schemaResolution.types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A function type that, given an options object, returns a schema or schema-like object.
+ *
+ * @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.
+ */
+export type SchemaResolutionFunction<Args extends Record<string, unknown>> = (options: Args) => unknown;
+//# sourceMappingURL=schemaResolution.types.d.ts.map

package/lib/mappers/types/schemaResolution.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaResolution.types.d.ts","sourceRoot":"","sources":["../../../src/mappers/types/schemaResolution.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAC3E,OAAO,EAAE,IAAI,KACV,OAAO,CAAC"}

package/lib/objectstore/index.d.ts

@@ -1,71 +1,3 @@
-import { Readable } from 'stream';
-import { C as ComplianceContext } from '../ttlCacheRecord.types-oX0ti5SP.js';
-
-/**
- * Interface representing an object store.
- *
- * Methods that read or write object bodies accept an optional `compliance` parameter.
- * When provided, bodies are encrypted on write and decrypted on read using
- * the tenant ID for key derivation. When omitted, bodies are stored as plaintext.
- */
-interface ObjectStore<Client> {
-    /**
-     * Puts a record into the objectstore.
-     */
-    putObject<T>(object: T, compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Puts a batch of records into the objectstore.
-     */
-    putBatchObjects<T>(objects: T[], compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Streams an object upload to the objectstore.
-     */
-    streamUploadObject<T>(object: T, compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Streams a batch of object uploads to the objectstore.
-     */
-    streamUploadBatchObjects<T>(objects: T[], compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Deletes a record from the objectstore.
-     */
-    deleteObject(objectKey: string): Promise<void>;
-    /**
-     * Deletes a batch of records from the objectstore.
-     */
-    deleteBatchObjects(objectKeys: string[]): Promise<void>;
-    /**
-     * Reads a record from the objectstore.
-     */
-    readObject<T>(objectKey: string, compliance?: ComplianceContext): Promise<T>;
-    /**
-     * Reads a batch of records from the objectstore.
-     */
-    readBatchObjects<T>(objectKeys: string[], compliance?: ComplianceContext): Promise<T[]>;
-    /**
-     * Streams a download from the objectstore.
-     * Note: Streaming bypasses application-level encryption/decryption.
-     */
-    streamDownloadObject(objectKey: string): Promise<Readable>;
-    /**
-     * Streams multiple downloads from the objectstore.
-     * Note: Streaming bypasses application-level encryption/decryption.
-     */
-    streamDownloadBatchObjects(objectKeys: string[]): Promise<Readable[]>;
-    /**
-     * Gets the underlying objectstore client instance.
-     */
-    getClient(): Client;
-}
-
-/**
- * Creates a function that generates objectstore keys with a given prefix.
- *
- * @param {string} objectStoreKeyPrefix - The prefix to use for all objectstore keys
- * @returns {Function} A function that takes an ID and returns a formatted objectstore key
- * @example
- * const createUserObjectStoreKey = createObjectStoreKey('user');
- * const key = createUserObjectStoreKey('123'); // Returns 'user:123'
- */
-declare const createObjectStoreKey: (objectStoreKeyPrefix: string) => (id: string | string[]) => string;
-
-export { type ObjectStore, createObjectStoreKey };
+export * from './interfaces/objectstore.interface';
+export * from './objectstoreKey';
+//# sourceMappingURL=index.d.ts.map

package/lib/objectstore/index.d.ts.map

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

package/lib/objectstore/{index.d.mts → interfaces/objectstore.interface.d.ts}

@@ -1,6 +1,5 @@
 import { Readable } from 'stream';
-import { C as ComplianceContext } from '../ttlCacheRecord.types-oX0ti5SP.mjs';
-
+import type { ComplianceContext } from '../../cache/types/ttlCacheRecord.types';
 /**
  * Interface representing an object store.
  *
@@ -8,7 +7,7 @@ import { C as ComplianceContext } from '../ttlCacheRecord.types-oX0ti5SP.mjs';
  * When provided, bodies are encrypted on write and decrypted on read using
  * the tenant ID for key derivation. When omitted, bodies are stored as plaintext.
  */
-interface ObjectStore<Client> {
+export interface ObjectStore<Client> {
     /**
      * Puts a record into the objectstore.
      */
@@ -56,16 +55,4 @@ interface ObjectStore<Client> {
      */
     getClient(): Client;
 }
-
-/**
- * Creates a function that generates objectstore keys with a given prefix.
- *
- * @param {string} objectStoreKeyPrefix - The prefix to use for all objectstore keys
- * @returns {Function} A function that takes an ID and returns a formatted objectstore key
- * @example
- * const createUserObjectStoreKey = createObjectStoreKey('user');
- * const key = createUserObjectStoreKey('123'); // Returns 'user:123'
- */
-declare const createObjectStoreKey: (objectStoreKeyPrefix: string) => (id: string | string[]) => string;
-
-export { type ObjectStore, createObjectStoreKey };
+//# sourceMappingURL=objectstore.interface.d.ts.map

package/lib/objectstore/interfaces/objectstore.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectstore.interface.d.ts","sourceRoot":"","sources":["../../../src/objectstore/interfaces/objectstore.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,WAAW,WAAW,CAAC,MAAM;IACjC;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE;;OAEG;IACH,eAAe,CAAC,CAAC,EACf,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,kBAAkB,CAAC,CAAC,EAClB,MAAM,EAAE,CAAC,EACT,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,wBAAwB,CAAC,CAAC,EACxB,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7E;;OAEG;IACH,gBAAgB,CAAC,CAAC,EAChB,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhB;;;OAGG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3D;;;OAGG;IACH,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEtE;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC;CACrB"}

package/lib/objectstore/objectstoreKey.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a function that generates objectstore keys with a given prefix.
+ *
+ * @param {string} objectStoreKeyPrefix - The prefix to use for all objectstore keys
+ * @returns {Function} A function that takes an ID and returns a formatted objectstore key
+ * @example
+ * const createUserObjectStoreKey = createObjectStoreKey('user');
+ * const key = createUserObjectStoreKey('123'); // Returns 'user:123'
+ */
+export declare const createObjectStoreKey: (objectStoreKeyPrefix: string) => (id: string | string[]) => string;
+//# sourceMappingURL=objectstoreKey.d.ts.map

package/lib/objectstore/objectstoreKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectstoreKey.d.ts","sourceRoot":"","sources":["../../src/objectstore/objectstoreKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,yBACR,MAAM,UAAU,MAAM,GAAG,MAAM,EAAE,WAGvD,CAAC"}

package/lib/persistence/complianceEventSubscriber.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Wraps an EntityManager to block `nativeInsert`, `nativeUpdate`, and
+ * `nativeDelete` on entities that have PII, PHI, or PCI compliance fields.
+ *
+ * This prevents bypassing the EncryptedType's encryption by using raw
+ * queries. Call this in the tenant context middleware when creating the
+ * request-scoped EM.
+ *
+ * @returns A Proxy-wrapped EntityManager that throws on native query
+ *          operations targeting compliance entities.
+ */
+export declare function wrapEmWithNativeQueryBlocking<T extends object>(em: T): T;
+//# sourceMappingURL=complianceEventSubscriber.d.ts.map