@forklaunch/core 1.5.2 → 1.5.4

package/lib/services/configInjector.d.ts

@@ -0,0 +1,43 @@
+import { AnySchemaValidator, ParseResult } from '@forklaunch/validator';
+import { ConfigValidator, Constructed, ResolvedConfigValidator, Singleton } from './types/configInjector.types';
+export declare function createConfigInjector<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>>(schemaValidator: SV, dependenciesDefinition: {
+    [K in keyof CV]: Singleton<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]> | Constructed<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>;
+}): ConfigInjector<SV, CV>;
+export declare class ConfigInjector<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>> {
+    private schemaValidator;
+    private dependenciesDefinition;
+    instances: {
+        [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];
+    };
+    readonly configShapes: CV;
+    load(inheritedScopeInstances?: {
+        [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];
+    }): this;
+    private resolveInstance;
+    constructor(schemaValidator: SV, dependenciesDefinition: {
+        [K in keyof CV]: (Singleton<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]> | Constructed<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>) & {
+            type: CV[K];
+        };
+    });
+    safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>>;
+    validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV>;
+    resolve<T extends keyof CV>(token: T, context?: Record<string, unknown>, resolutionPath?: (keyof CV)[]): ResolvedConfigValidator<SV, CV>[T];
+    scopedResolver<T extends keyof CV>(token: T, context?: Record<string, unknown>, resolutionPath?: (keyof CV)[]): (options?: {
+        scope?: ConfigInjector<SV, CV>;
+        context?: Record<string, unknown>;
+    }) => ResolvedConfigValidator<SV, CV>[T];
+    createScope(): ConfigInjector<SV, CV>;
+    dispose(): void;
+    chain<ChainedCV extends ConfigValidator<SV>>(dependenciesDefinition: {
+        [K in keyof ChainedCV]: {
+            type: ChainedCV[K];
+        } & (Singleton<ChainedCV[K], Omit<ResolvedConfigValidator<SV, CV & ChainedCV>, K>, ResolvedConfigValidator<SV, ChainedCV>[K]> | Constructed<ChainedCV[K], Omit<ResolvedConfigValidator<SV, CV & ChainedCV>, K>, ResolvedConfigValidator<SV, ChainedCV>[K]>);
+    }): ConfigInjector<SV, CV & ChainedCV>;
+    tokens(): {
+        [K in keyof CV]: K;
+    };
+}
+export declare class ValidConfigInjector<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>> extends ConfigInjector<SV, CV> {
+    validConfigInjector: void;
+}
+//# sourceMappingURL=configInjector.d.ts.map

package/lib/services/configInjector.d.ts.map

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

package/lib/services/guards/isConstructed.d.ts

@@ -0,0 +1,3 @@
+import { Constructed } from '../types/configInjector.types';
+export declare function isConstructed<Type, Args, Return>(value: unknown): value is Constructed<Type, Args, Return>;
+//# sourceMappingURL=isConstructed.d.ts.map

package/lib/services/guards/isConstructed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isConstructed.d.ts","sourceRoot":"","sources":["../../../src/services/guards/isConstructed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAC9C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAO1C"}

package/lib/services/guards/isConstructedSingleton.d.ts

@@ -0,0 +1,3 @@
+import { ConstructedSingleton } from '../types/configInjector.types';
+export declare function isConstructedSingleton<Type, Args, Return>(value: unknown): value is ConstructedSingleton<Type, Args, Return>;
+//# sourceMappingURL=isConstructedSingleton.d.ts.map

package/lib/services/guards/isConstructedSingleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isConstructedSingleton.d.ts","sourceRoot":"","sources":["../../../src/services/guards/isConstructedSingleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAY,MAAM,+BAA+B,CAAC;AAE/E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EACvD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAQnD"}

package/lib/services/guards/isConstructor.d.ts

@@ -0,0 +1,3 @@
+import { Constructor } from '../types/configInjector.types';
+export declare function isConstructor(value: unknown): value is Constructor;
+//# sourceMappingURL=isConstructor.d.ts.map

package/lib/services/guards/isConstructor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isConstructor.d.ts","sourceRoot":"","sources":["../../../src/services/guards/isConstructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAMlE"}

package/lib/services/index.d.ts

@@ -1,185 +1,11 @@
 export { getEnvVar } from '@forklaunch/common';
-export { findApplicationRoot, getCascadingEnvPaths, loadCascadingEnv } from '../environment/index.js';
-import { AnySchemaValidator, IdiomaticSchema, Schema, ParseResult } from '@forklaunch/validator';
-import { Collection, MikroORM } from '@mikro-orm/core';
-import { O as OpenTelemetryCollector, M as MetricsDefinition } from '../openTelemetryCollector-BS-ej09T.js';
-import '@opentelemetry/api';
-import 'pino';
-import '@opentelemetry/api-logs';
-
-declare const Lifetime: {
-    readonly Singleton: 0;
-    readonly Transient: 1;
-    readonly Scoped: 2;
-};
-type Lifetime = (typeof Lifetime)[keyof typeof Lifetime];
-type Singleton<Type, Args, Value> = {
-    lifetime: typeof Lifetime.Singleton;
-    type: Type;
-    value: Value;
-} | ConstructedSingleton<Type, Args, Value>;
-type ConstructedSingleton<Type, Args, Return> = {
-    lifetime: typeof Lifetime.Singleton;
-    type: Type;
-    factory: (args: Args, context: Record<string, unknown>, resolve: <T extends keyof Args>(token: T, context?: Record<string, unknown>) => Args[T]) => Return;
-};
-type Constructed<Type, Args, Return> = {
-    lifetime: typeof Lifetime.Transient | typeof Lifetime.Scoped;
-    type: Type;
-    factory: (args: Args, context: Record<string, unknown>, resolve: <T extends keyof Args>(token: T, context?: Record<string, unknown>) => Args[T]) => Return;
-};
-type Constructor = new (...args: never[]) => unknown;
-type SchemaConstructor<SV extends AnySchemaValidator> = new (...args: unknown[]) => IdiomaticSchema<SV>;
-type Function = (...args: never[]) => unknown;
-type FunctionToConstructor = (...args: never[]) => new (...args: never[]) => unknown;
-type SchemaFunction<SV extends AnySchemaValidator> = (args: unknown) => IdiomaticSchema<SV>;
-type ConfigTypes<SV extends AnySchemaValidator> = Function | SchemaFunction<SV> | Constructor | SchemaConstructor<SV> | IdiomaticSchema<SV>;
-type ConfigValidator<SV extends AnySchemaValidator> = Record<string, ConfigTypes<SV> | Record<string, ConfigTypes<SV>>>;
-type ResolveConfigValue<SV extends AnySchemaValidator, T> = T extends SchemaConstructor<SV> ? Schema<InstanceType<T>, SV> : T extends SchemaFunction<SV> ? (...args: Parameters<T>) => Schema<ReturnType<T>, SV> : T extends FunctionToConstructor ? (...args: Parameters<T>) => InstanceType<ReturnType<T>> : T extends Function ? (...args: Parameters<T>) => ReturnType<T> : T extends Constructor ? InstanceType<T> : T extends IdiomaticSchema<SV> ? Schema<T, SV> : T extends Record<string, ConfigTypes<SV>> ? {
-    [K in keyof T]: ResolveConfigValue<SV, T[K]>;
-} : Schema<T, SV>;
-type ResolvedConfigValidator<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>> = {
-    [M in keyof CV]: ResolveConfigValue<SV, CV[M]>;
-};
-type ScopedDependencyFactory<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>, M extends keyof CV> = (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[M];
-
-declare function createConfigInjector<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>>(schemaValidator: SV, dependenciesDefinition: {
-    [K in keyof CV]: Singleton<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]> | Constructed<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>;
-}): ConfigInjector<SV, CV>;
-declare class ConfigInjector<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>> {
-    private schemaValidator;
-    private dependenciesDefinition;
-    instances: {
-        [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];
-    };
-    readonly configShapes: CV;
-    load(inheritedScopeInstances?: {
-        [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];
-    }): this;
-    private resolveInstance;
-    constructor(schemaValidator: SV, dependenciesDefinition: {
-        [K in keyof CV]: (Singleton<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]> | Constructed<CV[K], Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>) & {
-            type: CV[K];
-        };
-    });
-    safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>>;
-    validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV>;
-    resolve<T extends keyof CV>(token: T, context?: Record<string, unknown>, resolutionPath?: (keyof CV)[]): ResolvedConfigValidator<SV, CV>[T];
-    scopedResolver<T extends keyof CV>(token: T, context?: Record<string, unknown>, resolutionPath?: (keyof CV)[]): (options?: {
-        scope?: ConfigInjector<SV, CV>;
-        context?: Record<string, unknown>;
-    }) => ResolvedConfigValidator<SV, CV>[T];
-    createScope(): ConfigInjector<SV, CV>;
-    dispose(): void;
-    chain<ChainedCV extends ConfigValidator<SV>>(dependenciesDefinition: {
-        [K in keyof ChainedCV]: {
-            type: ChainedCV[K];
-        } & (Singleton<ChainedCV[K], Omit<ResolvedConfigValidator<SV, CV & ChainedCV>, K>, ResolvedConfigValidator<SV, ChainedCV>[K]> | Constructed<ChainedCV[K], Omit<ResolvedConfigValidator<SV, CV & ChainedCV>, K>, ResolvedConfigValidator<SV, ChainedCV>[K]>);
-    }): ConfigInjector<SV, CV & ChainedCV>;
-    tokens(): {
-        [K in keyof CV]: K;
-    };
-}
-declare class ValidConfigInjector<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>> extends ConfigInjector<SV, CV> {
-    validConfigInjector: void;
-}
-
-type EntityManager = {
-    fork: <Options>(options?: Options) => EntityManager;
-};
-
-type MapNestedDtoArraysToCollections<Dto, Keys extends string> = Omit<Dto, Keys> & {
-    [K in Keys]: Collection<object>;
-};
-
-interface EnforcementOptions {
-    /** Filter to specific entity names (default: all with retention policies) */
-    entities?: string[];
-    /** Records per batch (default: 1000) */
-    batchSize?: number;
-    /** Log what would happen without mutating */
-    dryRun?: boolean;
-}
-interface EnforcementResult {
-    processed: number;
-    deleted: number;
-    anonymized: number;
-    errors: number;
-    byEntity: Record<string, {
-        deleted: number;
-        anonymized: number;
-        errors: number;
-    }>;
-    durationMs: number;
-}
-declare class RetentionService {
-    private readonly orm;
-    private readonly otel;
-    private readonly DEFAULT_BATCH_SIZE;
-    constructor(orm: MikroORM, otel: OpenTelemetryCollector<any>);
-    enforce(options?: EnforcementOptions): Promise<EnforcementResult>;
-    private enforceEntity;
-}
-
-interface EraseResult {
-    entitiesAffected: string[];
-    recordsDeleted: number;
-}
-interface ExportResult {
-    userId: string;
-    entities: Record<string, unknown[]>;
-}
-/**
- * Per-entity userIdField overrides.
- * Keys are entity names, values are the field name linking records to a user.
- *
- * @example
- * {
- *   User: 'id',              // the User entity IS the user record
- *   Subscription: 'partyId', // billing links via partyId
- *   Account: 'userId',       // default, can be omitted
- * }
- */
-type UserIdFieldOverrides = Record<string, string>;
-/**
- * Generic compliance data service that walks all compliance-registered entities
- * and erases or exports PII/PHI/PCI data for a given user.
- *
- * Resolution order for userIdField per entity:
- * 1. Constructor overrides (highest priority)
- * 2. defineComplianceEntity({ userIdField }) registry
- * 3. Optimistic search: first CANDIDATE_USER_FIELDS match in entity metadata
- * 4. Skip entity (no user link found)
- */
-declare class ComplianceDataService {
-    private readonly orm;
-    private readonly otel;
-    private readonly userIdFieldOverrides;
-    constructor(orm: MikroORM, otel: OpenTelemetryCollector<MetricsDefinition>, userIdFieldOverrides?: UserIdFieldOverrides);
-    /**
-     * Resolve the field linking an entity to a user.
-     * Returns undefined if no link can be determined.
-     */
-    private resolveUserIdField;
-    erase(userId: string): Promise<EraseResult>;
-    export(userId: string): Promise<ExportResult>;
-}
-
-/**
- * Shared retention enforcement runner.
- * Designed to be called from a one-shot script (ECS RunTask / cron).
- *
- * @example
- * ```ts
- * import { ci, tokens } from '../bootstrapper';
- * import { runRetentionEnforcement } from '@myapp/core';
- *
- * runRetentionEnforcement(
- *   ci.resolve(tokens.RetentionService),
- *   ci.resolve(tokens.OtelCollector)
- * );
- * ```
- */
-declare function runRetentionEnforcement(retentionService: RetentionService, otel: OpenTelemetryCollector<any>): Promise<void>;
-
-export { ComplianceDataService, ConfigInjector, type ConfigTypes, type ConfigValidator, type Constructed, type ConstructedSingleton, type Constructor, type EnforcementOptions, type EnforcementResult, type EntityManager, type EraseResult, type ExportResult, type Function, type FunctionToConstructor, Lifetime, type MapNestedDtoArraysToCollections, type ResolvedConfigValidator, RetentionService, type SchemaConstructor, type SchemaFunction, type ScopedDependencyFactory, type Singleton, type UserIdFieldOverrides, ValidConfigInjector, createConfigInjector, runRetentionEnforcement };
+export * from '../environment';
+export { createConfigInjector } from './configInjector';
+export type { ConfigInjector, ValidConfigInjector } from './configInjector';
+export * from './types/configInjector.types';
+export * from './types/entityManager.types';
+export * from './types/service.types';
+export { RetentionService, type EnforcementOptions, type EnforcementResult } from './retentionService';
+export { ComplianceDataService, type EraseResult, type ExportResult, type UserIdFieldOverrides } from './complianceDataService';
+export { runRetentionEnforcement } from './runRetentionEnforcement';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/lib/services/retentionService.d.ts

@@ -0,0 +1,31 @@
+import type { MikroORM } from '@mikro-orm/core';
+import type { OpenTelemetryCollector } from '../http/telemetry/openTelemetryCollector';
+export interface EnforcementOptions {
+    /** Filter to specific entity names (default: all with retention policies) */
+    entities?: string[];
+    /** Records per batch (default: 1000) */
+    batchSize?: number;
+    /** Log what would happen without mutating */
+    dryRun?: boolean;
+}
+export interface EnforcementResult {
+    processed: number;
+    deleted: number;
+    anonymized: number;
+    errors: number;
+    byEntity: Record<string, {
+        deleted: number;
+        anonymized: number;
+        errors: number;
+    }>;
+    durationMs: number;
+}
+export declare class RetentionService {
+    private readonly orm;
+    private readonly otel;
+    private readonly DEFAULT_BATCH_SIZE;
+    constructor(orm: MikroORM, otel: OpenTelemetryCollector<any>);
+    enforce(options?: EnforcementOptions): Promise<EnforcementResult>;
+    private enforceEntity;
+}
+//# sourceMappingURL=retentionService.d.ts.map

package/lib/services/retentionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionService.d.ts","sourceRoot":"","sources":["../../src/services/retentionService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AASvF,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CACd,MAAM,EACN;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CACxD,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAEpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAE3C,YACmB,GAAG,EAAE,QAAQ,EAEb,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC,EAChD;IAEE,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgEtE;YAEa,aAAa;CAwH5B"}

package/lib/services/runRetentionEnforcement.d.ts

@@ -0,0 +1,19 @@
+import type { OpenTelemetryCollector } from '../http/telemetry/openTelemetryCollector';
+import type { RetentionService } from './retentionService';
+/**
+ * Shared retention enforcement runner.
+ * Designed to be called from a one-shot script (ECS RunTask / cron).
+ *
+ * @example
+ * ```ts
+ * import { ci, tokens } from '../bootstrapper';
+ * import { runRetentionEnforcement } from '@myapp/core';
+ *
+ * runRetentionEnforcement(
+ *   ci.resolve(tokens.RetentionService),
+ *   ci.resolve(tokens.OtelCollector)
+ * );
+ * ```
+ */
+export declare function runRetentionEnforcement(retentionService: RetentionService, otel: OpenTelemetryCollector<any>): Promise<void>;
+//# sourceMappingURL=runRetentionEnforcement.d.ts.map

package/lib/services/runRetentionEnforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runRetentionEnforcement.d.ts","sourceRoot":"","sources":["../../src/services/runRetentionEnforcement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,gBAAgB,EAAE,gBAAgB,EAElC,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/lib/services/types/configInjector.types.d.ts

@@ -0,0 +1,39 @@
+import { AnySchemaValidator, IdiomaticSchema, Schema } from '@forklaunch/validator';
+import { ConfigInjector } from '../configInjector';
+export declare const Lifetime: {
+    readonly Singleton: 0;
+    readonly Transient: 1;
+    readonly Scoped: 2;
+};
+export type Lifetime = (typeof Lifetime)[keyof typeof Lifetime];
+export type Singleton<Type, Args, Value> = {
+    lifetime: typeof Lifetime.Singleton;
+    type: Type;
+    value: Value;
+} | ConstructedSingleton<Type, Args, Value>;
+export type ConstructedSingleton<Type, Args, Return> = {
+    lifetime: typeof Lifetime.Singleton;
+    type: Type;
+    factory: (args: Args, context: Record<string, unknown>, resolve: <T extends keyof Args>(token: T, context?: Record<string, unknown>) => Args[T]) => Return;
+};
+export type Constructed<Type, Args, Return> = {
+    lifetime: typeof Lifetime.Transient | typeof Lifetime.Scoped;
+    type: Type;
+    factory: (args: Args, context: Record<string, unknown>, resolve: <T extends keyof Args>(token: T, context?: Record<string, unknown>) => Args[T]) => Return;
+};
+export type Constructor = new (...args: never[]) => unknown;
+export type SchemaConstructor<SV extends AnySchemaValidator> = new (...args: unknown[]) => IdiomaticSchema<SV>;
+export type Function = (...args: never[]) => unknown;
+export type FunctionToConstructor = (...args: never[]) => new (...args: never[]) => unknown;
+export type SchemaFunction<SV extends AnySchemaValidator> = (args: unknown) => IdiomaticSchema<SV>;
+export type ConfigTypes<SV extends AnySchemaValidator> = Function | SchemaFunction<SV> | Constructor | SchemaConstructor<SV> | IdiomaticSchema<SV>;
+export type ConfigValidator<SV extends AnySchemaValidator> = Record<string, ConfigTypes<SV> | Record<string, ConfigTypes<SV>>>;
+type ResolveConfigValue<SV extends AnySchemaValidator, T> = T extends SchemaConstructor<SV> ? Schema<InstanceType<T>, SV> : T extends SchemaFunction<SV> ? (...args: Parameters<T>) => Schema<ReturnType<T>, SV> : T extends FunctionToConstructor ? (...args: Parameters<T>) => InstanceType<ReturnType<T>> : T extends Function ? (...args: Parameters<T>) => ReturnType<T> : T extends Constructor ? InstanceType<T> : T extends IdiomaticSchema<SV> ? Schema<T, SV> : T extends Record<string, ConfigTypes<SV>> ? {
+    [K in keyof T]: ResolveConfigValue<SV, T[K]>;
+} : Schema<T, SV>;
+export type ResolvedConfigValidator<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>> = {
+    [M in keyof CV]: ResolveConfigValue<SV, CV[M]>;
+};
+export type ScopedDependencyFactory<SV extends AnySchemaValidator, CV extends ConfigValidator<SV>, M extends keyof CV> = (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[M];
+export {};
+//# sourceMappingURL=configInjector.types.d.ts.map

package/lib/services/types/configInjector.types.d.ts.map

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

package/lib/services/types/entityManager.types.d.ts

@@ -0,0 +1,4 @@
+export type EntityManager = {
+    fork: <Options>(options?: Options) => EntityManager;
+};
+//# sourceMappingURL=entityManager.types.d.ts.map

package/lib/services/types/entityManager.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityManager.types.d.ts","sourceRoot":"","sources":["../../../src/services/types/entityManager.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,aAAa,CAAC;CACrD,CAAC"}

package/lib/services/types/service.types.d.ts

@@ -0,0 +1,5 @@
+import { Collection } from '@mikro-orm/core';
+export type MapNestedDtoArraysToCollections<Dto, Keys extends string> = Omit<Dto, Keys> & {
+    [K in Keys]: Collection<object>;
+};
+//# sourceMappingURL=service.types.d.ts.map

package/lib/services/types/service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.types.d.ts","sourceRoot":"","sources":["../../../src/services/types/service.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,MAAM,+BAA+B,CAAC,GAAG,EAAE,IAAI,SAAS,MAAM,IAAI,IAAI,CAC1E,GAAG,EACH,IAAI,CACL,GAAG;KACD,CAAC,IAAI,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC;CAChC,CAAC"}

package/lib/ws/asyncApiV3Generator/asyncApiV3Generator.d.ts

@@ -0,0 +1,12 @@
+import type { AsyncAPIObject } from '@asyncapi/parser/esm/spec-types/v3';
+import type { AnySchemaValidator } from '@forklaunch/validator';
+import { EventSchema } from '../types/eventSchema.types';
+export type AsyncApiDocument = AsyncAPIObject;
+export declare function generateAsyncApi<SV extends AnySchemaValidator>(eventSchemas: EventSchema<SV>, options?: {
+    title?: string;
+    version?: string;
+    description?: string;
+    id?: AsyncApiDocument['id'];
+    defaultContentType?: AsyncApiDocument['defaultContentType'];
+}): AsyncApiDocument;
+//# sourceMappingURL=asyncApiV3Generator.d.ts.map

package/lib/ws/asyncApiV3Generator/asyncApiV3Generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncApiV3Generator.d.ts","sourceRoot":"","sources":["../../../src/ws/asyncApiV3Generator/asyncApiV3Generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAQf,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAoB,MAAM,4BAA4B,CAAC;AAE3E,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAC5D,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC,EAC7B,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5B,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;CAC7D,GACA,gBAAgB,CAuIlB"}

package/lib/ws/index.d.ts

@@ -1,67 +1,4 @@
-import { AsyncAPIObject } from '@asyncapi/parser/esm/spec-types/v3';
-import { AnySchemaValidator, IdiomaticSchema, SchemaValidator } from '@forklaunch/validator';
-import { S as StringOnlyObject } from '../apiDefinition.types-DW4lfZqy.js';
-import '@forklaunch/common';
-import '@opentelemetry/api';
-import 'jose';
-import 'qs';
-import 'stream';
-import '../openTelemetryCollector-BS-ej09T.js';
-import 'pino';
-import '@opentelemetry/api-logs';
-import 'cors';
-import 'fastmcp';
-import 'http';
-import '@scalar/express-api-reference';
-
-type AsyncApiEnrichment = {
-    channel?: string;
-    channels?: string[];
-    operation?: string;
-    operations?: string[];
-};
-type EventSchemaEntry<SV extends AnySchemaValidator> = {
-    shape: IdiomaticSchema<SV>;
-} & AsyncApiEnrichment;
-type EventSchema<SV extends AnySchemaValidator> = {
-    ping?: EventSchemaEntry<SV>;
-    pong?: EventSchemaEntry<SV>;
-    clientMessages: Record<string, EventSchemaEntry<SV>>;
-    serverMessages: Record<string, EventSchemaEntry<SV>>;
-    errors?: Record<string, EventSchemaEntry<SV>>;
-    closeReason?: Record<string, EventSchemaEntry<SV>>;
-    context?: StringOnlyObject<SV>;
-    userData?: StringOnlyObject<SV>;
-};
-type ServerEventSchema<SV extends AnySchemaValidator, ES extends EventSchema<SV>> = Omit<ES, 'serverMessages' | 'clientMessages'> & {
-    serverMessages: ES['clientMessages'];
-    clientMessages: ES['serverMessages'];
-};
-type ExtractSchemaFromEntry<SV extends AnySchemaValidator, Entry extends EventSchemaEntry<SV> | undefined> = Entry extends EventSchemaEntry<SV> ? Entry['shape'] : never;
-type ExtractSchemaFromRecord<SV extends AnySchemaValidator, RecordType extends Record<string, EventSchemaEntry<SV>> | undefined> = RecordType extends Record<string, EventSchemaEntry<SV>> ? RecordType[keyof RecordType]['shape'] : never;
-
-type AsyncApiDocument = AsyncAPIObject;
-declare function generateAsyncApi<SV extends AnySchemaValidator>(eventSchemas: EventSchema<SV>, options?: {
-    title?: string;
-    version?: string;
-    description?: string;
-    id?: AsyncApiDocument['id'];
-    defaultContentType?: AsyncApiDocument['defaultContentType'];
-}): AsyncApiDocument;
-
-type SchemaRecord<SV extends AnySchemaValidator> = Record<string, EventSchemaEntry<SV>> | undefined;
-declare function buildUnionSchema<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, record: SchemaRecord<SV>): IdiomaticSchema<SV> | undefined;
-declare function parseSchemaValue<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, value: unknown, schema: IdiomaticSchema<SV> | undefined, context: string): unknown;
-declare function encodeSchemaValue<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, value: unknown, schema: IdiomaticSchema<SV> | undefined, context: string): unknown;
-declare function decodeSchemaValue<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, data: unknown, schema: IdiomaticSchema<SV> | undefined, context: string): unknown;
-declare function normalizeEncodedValue(encoded: unknown, context: string, allowUndefined?: boolean): Buffer | undefined;
-declare function createWebSocketSchemas<SV extends AnySchemaValidator, ES extends EventSchema<SV>>(schemaValidator: SchemaValidator, eventSchemas: ES): {
-    clientMessagesSchema: IdiomaticSchema<SV> | undefined;
-    serverMessagesSchema: IdiomaticSchema<SV> | undefined;
-    errorsSchema: IdiomaticSchema<SV> | undefined;
-    pingSchema: IdiomaticSchema<SV> | undefined;
-    pongSchema: IdiomaticSchema<SV> | undefined;
-    closeReasonSchema: IdiomaticSchema<SV> | undefined;
-};
-
-export { type AsyncApiDocument, type AsyncApiEnrichment, type EventSchema, type EventSchemaEntry, type ExtractSchemaFromEntry, type ExtractSchemaFromRecord, type ServerEventSchema, buildUnionSchema, createWebSocketSchemas, decodeSchemaValue, encodeSchemaValue, generateAsyncApi, normalizeEncodedValue, parseSchemaValue };
+export * from './asyncApiV3Generator/asyncApiV3Generator';
+export * from './types/eventSchema.types';
+export * from './webSocketLike';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ws/index.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}

package/lib/ws/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ws/index.ts","../../src/ws/asyncApiV3Generator/asyncApiV3Generator.ts","../../src/ws/webSocketLike.ts"],"sourcesContent":["export * from './asyncApiV3Generator/asyncApiV3Generator';\nexport * from './types/eventSchema.types';\nexport * from './webSocketLike';\n","import type {\n  AsyncAPIObject,\n  ChannelObject,\n  ChannelsObject,\n  MessageObject,\n  MessagesObject,\n  OperationObject,\n  OperationsObject,\n  ReferenceObject\n} from '@asyncapi/parser/esm/spec-types/v3';\n\nimport type { AnySchemaValidator } from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from '../types/eventSchema.types';\n\nexport type AsyncApiDocument = AsyncAPIObject;\n\nexport function generateAsyncApi<SV extends AnySchemaValidator>(\n  eventSchemas: EventSchema<SV>,\n  options?: {\n    title?: string;\n    version?: string;\n    description?: string;\n    id?: AsyncApiDocument['id'];\n    defaultContentType?: AsyncApiDocument['defaultContentType'];\n  }\n): AsyncApiDocument {\n  const channels: ChannelsObject = {};\n\n  const appendMessageToChannel = (\n    collection?: Record<string, EventSchemaEntry<SV>>\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n      const schema = entry.shape;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Add message to all specified channels\n      channelNames.forEach((channelName) => {\n        const existingChannel = channels[channelName];\n        if (!existingChannel || '$ref' in existingChannel) {\n          channels[channelName] = {\n            address: channelName,\n            messages: {}\n          };\n        }\n\n        const channelEntry = channels[channelName] as ChannelObject;\n        channelEntry.messages = (channelEntry.messages ?? {}) as MessagesObject;\n        const messages = channelEntry.messages as MessagesObject;\n\n        const message: MessageObject = {\n          name: messageName,\n          payload: schema\n        };\n\n        messages[messageName] = message;\n      });\n    });\n  };\n\n  appendMessageToChannel(eventSchemas.clientMessages);\n  appendMessageToChannel(eventSchemas.serverMessages);\n  appendMessageToChannel(eventSchemas.errors);\n\n  const operations: OperationsObject = {};\n\n  const addOperationsForCollection = (\n    collection: Record<string, EventSchemaEntry<SV>> | undefined,\n    action: 'send' | 'receive'\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Create operations for all specified channels\n      channelNames.forEach((channelName) => {\n        const operationKey = `${action}-${channelName}-${messageName}`;\n\n        const operation: OperationObject = {\n          action,\n          channel: {\n            $ref: `#/channels/${channelName}`\n          } as ReferenceObject,\n          messages: [\n            {\n              $ref: `#/channels/${channelName}/messages/${messageName}`\n            } as ReferenceObject\n          ]\n        };\n\n        operations[operationKey] = operation;\n      });\n    });\n  };\n\n  addOperationsForCollection(eventSchemas.clientMessages, 'receive');\n  addOperationsForCollection(eventSchemas.serverMessages, 'send');\n\n  const { title, version, description } = options ?? {};\n\n  const asyncApiDocument: AsyncApiDocument = {\n    asyncapi: '3.0.0',\n    info: {\n      title: title || process.env.API_TITLE || 'Forklaunch WebSocket API',\n      version: version || '1.0.0',\n      ...(description ? { description } : {})\n    },\n    ...(options?.id ? { id: options.id } : {}),\n    ...(options?.defaultContentType\n      ? { defaultContentType: options.defaultContentType }\n      : {}),\n    ...(Object.keys(channels).length > 0 ? { channels } : {}),\n    ...(Object.keys(operations).length > 0 ? { operations } : {})\n  };\n\n  return asyncApiDocument;\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from './types/eventSchema.types';\n\ntype SchemaRecord<SV extends AnySchemaValidator> =\n  | Record<string, EventSchemaEntry<SV>>\n  | undefined;\n\nexport function buildUnionSchema<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  record: SchemaRecord<SV>\n): IdiomaticSchema<SV> | undefined {\n  if (!record) {\n    return undefined;\n  }\n\n  const schemas = Object.values(record)\n    .filter((entry): entry is EventSchemaEntry<SV> => Boolean(entry))\n    .map((entry) => entry.shape);\n\n  if (schemas.length === 0) {\n    return undefined;\n  }\n\n  if (schemas.length === 1) {\n    return schemas[0];\n  }\n\n  return schemaValidator.union(schemas) as IdiomaticSchema<SV>;\n}\n\nexport function parseSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  if (!schema) {\n    return value;\n  }\n\n  const result = schemaValidator.parse(schema, value);\n  if (result.ok) {\n    return result.value;\n  }\n\n  const errors = 'errors' in result ? result.errors || [] : [];\n  throw new Error(prettyPrintParseErrors(errors, context));\n}\n\nexport function encodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  const validated = parseSchemaValue(schemaValidator, value, schema, context);\n\n  if (\n    Buffer.isBuffer(validated) ||\n    validated instanceof ArrayBuffer ||\n    ArrayBuffer.isView(validated)\n  ) {\n    if (Buffer.isBuffer(validated)) {\n      return validated;\n    }\n\n    if (validated instanceof ArrayBuffer) {\n      return Buffer.from(validated);\n    }\n\n    const view = validated as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    const typed = new Uint8Array(view.buffer, view.byteOffset, view.byteLength);\n    return Buffer.from(typed);\n  }\n\n  if (typeof validated === 'string') {\n    return Buffer.from(validated, 'utf-8');\n  }\n\n  if (validated === null || validated === undefined) {\n    return validated;\n  }\n\n  return Buffer.from(JSON.stringify(validated), 'utf-8');\n}\n\nexport function decodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  data: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  let decoded: string;\n  let parsed: unknown;\n\n  if (Buffer.isBuffer(data)) {\n    decoded = data.toString('utf-8');\n  } else if (data instanceof ArrayBuffer) {\n    decoded = Buffer.from(data).toString('utf-8');\n  } else if (ArrayBuffer.isView(data)) {\n    const view = data as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    decoded = Buffer.from(\n      view.buffer,\n      view.byteOffset,\n      view.byteLength\n    ).toString('utf-8');\n  } else if (typeof data === 'string') {\n    decoded = data;\n  } else {\n    parsed = data;\n    return parseSchemaValue(schemaValidator, parsed, schema, context);\n  }\n\n  try {\n    parsed = JSON.parse(decoded);\n  } catch {\n    parsed = decoded;\n  }\n\n  return parseSchemaValue(schemaValidator, parsed, schema, context);\n}\n\nexport function normalizeEncodedValue(\n  encoded: unknown,\n  context: string,\n  allowUndefined = false\n): Buffer | undefined {\n  if (encoded === null || encoded === undefined) {\n    if (allowUndefined) {\n      return undefined;\n    }\n    throw new Error(`Invalid ${context}`);\n  }\n\n  if (Buffer.isBuffer(encoded)) {\n    return encoded;\n  }\n\n  if (encoded instanceof ArrayBuffer) {\n    return Buffer.from(encoded);\n  }\n\n  if (ArrayBuffer.isView(encoded)) {\n    const view = encoded as ArrayBufferView;\n    return Buffer.from(view.buffer, view.byteOffset, view.byteLength);\n  }\n\n  if (typeof encoded === 'string') {\n    return Buffer.from(encoded, 'utf-8');\n  }\n\n  if (\n    typeof encoded === 'number' ||\n    typeof encoded === 'boolean' ||\n    typeof encoded === 'bigint'\n  ) {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  if (typeof encoded === 'object') {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  throw new Error(`Unsupported payload type for ${context}`);\n}\n\nexport function createWebSocketSchemas<\n  SV extends AnySchemaValidator,\n  ES extends EventSchema<SV>\n>(schemaValidator: SchemaValidator, eventSchemas: ES) {\n  const clientMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.clientMessages\n  );\n  const serverMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.serverMessages\n  );\n  const errorsSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.errors\n  );\n  const pingSchema = eventSchemas.ping?.shape;\n  const pongSchema = eventSchemas.pong?.shape;\n  const closeReasonSchema = eventSchemas.closeReason\n    ? buildUnionSchema<SV>(schemaValidator, eventSchemas.closeReason)\n    : undefined;\n\n  return {\n    clientMessagesSchema,\n    serverMessagesSchema,\n    errorsSchema,\n    pingSchema,\n    pongSchema,\n    closeReasonSchema\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/ws/index.ts","../../src/ws/asyncApiV3Generator/asyncApiV3Generator.ts","../../src/ws/webSocketLike.ts"],"sourcesContent":["export * from './asyncApiV3Generator/asyncApiV3Generator';\nexport * from './types/eventSchema.types';\nexport * from './webSocketLike';\n","import type {\n  AsyncAPIObject,\n  ChannelObject,\n  ChannelsObject,\n  MessageObject,\n  MessagesObject,\n  OperationObject,\n  OperationsObject,\n  ReferenceObject\n} from '@asyncapi/parser/esm/spec-types/v3';\n\nimport type { AnySchemaValidator } from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from '../types/eventSchema.types';\n\nexport type AsyncApiDocument = AsyncAPIObject;\n\nexport function generateAsyncApi<SV extends AnySchemaValidator>(\n  eventSchemas: EventSchema<SV>,\n  options?: {\n    title?: string;\n    version?: string;\n    description?: string;\n    id?: AsyncApiDocument['id'];\n    defaultContentType?: AsyncApiDocument['defaultContentType'];\n  }\n): AsyncApiDocument {\n  const channels: ChannelsObject = {};\n\n  const appendMessageToChannel = (\n    collection?: Record<string, EventSchemaEntry<SV>>\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n      const schema = entry.shape;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Add message to all specified channels\n      channelNames.forEach((channelName) => {\n        const existingChannel = channels[channelName];\n        if (!existingChannel || '$ref' in existingChannel) {\n          channels[channelName] = {\n            address: channelName,\n            messages: {}\n          };\n        }\n\n        const channelEntry = channels[channelName] as ChannelObject;\n        channelEntry.messages = (channelEntry.messages ?? {}) as MessagesObject;\n        const messages = channelEntry.messages as MessagesObject;\n\n        const message: MessageObject = {\n          name: messageName,\n          payload: schema\n        };\n\n        messages[messageName] = message;\n      });\n    });\n  };\n\n  appendMessageToChannel(eventSchemas.clientMessages);\n  appendMessageToChannel(eventSchemas.serverMessages);\n  appendMessageToChannel(eventSchemas.errors);\n\n  const operations: OperationsObject = {};\n\n  const addOperationsForCollection = (\n    collection: Record<string, EventSchemaEntry<SV>> | undefined,\n    action: 'send' | 'receive'\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Create operations for all specified channels\n      channelNames.forEach((channelName) => {\n        const operationKey = `${action}-${channelName}-${messageName}`;\n\n        const operation: OperationObject = {\n          action,\n          channel: {\n            $ref: `#/channels/${channelName}`\n          } as ReferenceObject,\n          messages: [\n            {\n              $ref: `#/channels/${channelName}/messages/${messageName}`\n            } as ReferenceObject\n          ]\n        };\n\n        operations[operationKey] = operation;\n      });\n    });\n  };\n\n  addOperationsForCollection(eventSchemas.clientMessages, 'receive');\n  addOperationsForCollection(eventSchemas.serverMessages, 'send');\n\n  const { title, version, description } = options ?? {};\n\n  const asyncApiDocument: AsyncApiDocument = {\n    asyncapi: '3.0.0',\n    info: {\n      title: title || process.env.API_TITLE || 'Forklaunch WebSocket API',\n      version: version || '1.0.0',\n      ...(description ? { description } : {})\n    },\n    ...(options?.id ? { id: options.id } : {}),\n    ...(options?.defaultContentType\n      ? { defaultContentType: options.defaultContentType }\n      : {}),\n    ...(Object.keys(channels).length > 0 ? { channels } : {}),\n    ...(Object.keys(operations).length > 0 ? { operations } : {})\n  };\n\n  return asyncApiDocument;\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from './types/eventSchema.types';\n\ntype SchemaRecord<SV extends AnySchemaValidator> =\n  Record<string, EventSchemaEntry<SV>> | undefined;\n\nexport function buildUnionSchema<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  record: SchemaRecord<SV>\n): IdiomaticSchema<SV> | undefined {\n  if (!record) {\n    return undefined;\n  }\n\n  const schemas = Object.values(record)\n    .filter((entry): entry is EventSchemaEntry<SV> => Boolean(entry))\n    .map((entry) => entry.shape);\n\n  if (schemas.length === 0) {\n    return undefined;\n  }\n\n  if (schemas.length === 1) {\n    return schemas[0];\n  }\n\n  return schemaValidator.union(schemas) as IdiomaticSchema<SV>;\n}\n\nexport function parseSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  if (!schema) {\n    return value;\n  }\n\n  const result = schemaValidator.parse(schema, value);\n  if (result.ok) {\n    return result.value;\n  }\n\n  const errors = 'errors' in result ? result.errors || [] : [];\n  throw new Error(prettyPrintParseErrors(errors, context));\n}\n\nexport function encodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  const validated = parseSchemaValue(schemaValidator, value, schema, context);\n\n  if (\n    Buffer.isBuffer(validated) ||\n    validated instanceof ArrayBuffer ||\n    ArrayBuffer.isView(validated)\n  ) {\n    if (Buffer.isBuffer(validated)) {\n      return validated;\n    }\n\n    if (validated instanceof ArrayBuffer) {\n      return Buffer.from(validated);\n    }\n\n    const view = validated as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    const typed = new Uint8Array(view.buffer, view.byteOffset, view.byteLength);\n    return Buffer.from(typed);\n  }\n\n  if (typeof validated === 'string') {\n    return Buffer.from(validated, 'utf-8');\n  }\n\n  if (validated === null || validated === undefined) {\n    return validated;\n  }\n\n  return Buffer.from(JSON.stringify(validated), 'utf-8');\n}\n\nexport function decodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  data: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  let decoded: string;\n  let parsed: unknown;\n\n  if (Buffer.isBuffer(data)) {\n    decoded = data.toString('utf-8');\n  } else if (data instanceof ArrayBuffer) {\n    decoded = Buffer.from(data).toString('utf-8');\n  } else if (ArrayBuffer.isView(data)) {\n    const view = data as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    decoded = Buffer.from(\n      view.buffer,\n      view.byteOffset,\n      view.byteLength\n    ).toString('utf-8');\n  } else if (typeof data === 'string') {\n    decoded = data;\n  } else {\n    parsed = data;\n    return parseSchemaValue(schemaValidator, parsed, schema, context);\n  }\n\n  try {\n    parsed = JSON.parse(decoded);\n  } catch {\n    parsed = decoded;\n  }\n\n  return parseSchemaValue(schemaValidator, parsed, schema, context);\n}\n\nexport function normalizeEncodedValue(\n  encoded: unknown,\n  context: string,\n  allowUndefined = false\n): Buffer | undefined {\n  if (encoded === null || encoded === undefined) {\n    if (allowUndefined) {\n      return undefined;\n    }\n    throw new Error(`Invalid ${context}`);\n  }\n\n  if (Buffer.isBuffer(encoded)) {\n    return encoded;\n  }\n\n  if (encoded instanceof ArrayBuffer) {\n    return Buffer.from(encoded);\n  }\n\n  if (ArrayBuffer.isView(encoded)) {\n    const view = encoded as ArrayBufferView;\n    return Buffer.from(view.buffer, view.byteOffset, view.byteLength);\n  }\n\n  if (typeof encoded === 'string') {\n    return Buffer.from(encoded, 'utf-8');\n  }\n\n  if (\n    typeof encoded === 'number' ||\n    typeof encoded === 'boolean' ||\n    typeof encoded === 'bigint'\n  ) {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  if (typeof encoded === 'object') {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  throw new Error(`Unsupported payload type for ${context}`);\n}\n\nexport function createWebSocketSchemas<\n  SV extends AnySchemaValidator,\n  ES extends EventSchema<SV>\n>(schemaValidator: SchemaValidator, eventSchemas: ES) {\n  const clientMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.clientMessages\n  );\n  const serverMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.serverMessages\n  );\n  const errorsSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.errors\n  );\n  const pingSchema = eventSchemas.ping?.shape;\n  const pongSchema = eventSchemas.pong?.shape;\n  const closeReasonSchema = eventSchemas.closeReason\n    ? buildUnionSchema<SV>(schemaValidator, eventSchemas.closeReason)\n    : undefined;\n\n  return {\n    clientMessagesSchema,\n    serverMessagesSchema,\n    errorsSchema,\n    pingSchema,\n    pongSchema,\n    closeReasonSchema\n  };\n}\n"],"mappings":"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","names":[]}