@forklaunch/core 1.5.2 → 1.5.3

package/lib/services/index.d.mts

@@ -1,185 +0,0 @@
-export { getEnvVar } from '@forklaunch/common';
-export { findApplicationRoot, getCascadingEnvPaths, loadCascadingEnv } from '../environment/index.mjs';
-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.mjs';
-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 };

package/lib/ttlCache.interface-CEOkrt8d.d.mts

@@ -1,77 +0,0 @@
-import { T as TtlCacheRecord, C as ComplianceContext } from './ttlCacheRecord.types-oX0ti5SP.mjs';
-
-/**
- * Interface representing a TTL (Time-To-Live) cache.
- *
- * Methods that read or write values accept an optional `compliance` parameter.
- * When provided, values are encrypted on write and decrypted on read using
- * the tenant ID for key derivation. When omitted, values are stored as plaintext.
- */
-interface TtlCache {
-    /**
-     * Puts a record into the cache.
-     */
-    putRecord<T>(cacheRecord: TtlCacheRecord<T>, compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Puts a batch of records into the cache.
-     */
-    putBatchRecords<T>(cacheRecords: TtlCacheRecord<T>[], compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Enqueues a record into a list.
-     */
-    enqueueRecord<T>(queueName: string, cacheRecord: T, compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Enqueues a batch of records into a list.
-     */
-    enqueueBatchRecords<T>(queueName: string, cacheRecords: T[], compliance?: ComplianceContext): Promise<void>;
-    /**
-     * Deletes a record from the cache.
-     */
-    deleteRecord(cacheRecordKey: string): Promise<void>;
-    /**
-     * Deletes a batch of records from the cache.
-     */
-    deleteBatchRecords(cacheRecordKeys: string[]): Promise<void>;
-    /**
-     * Dequeues a record from a list.
-     */
-    dequeueRecord<T>(queueName: string, compliance?: ComplianceContext): Promise<T>;
-    /**
-     * Dequeues a batch of records from a list.
-     */
-    dequeueBatchRecords<T>(queueName: string, pageSize: number, compliance?: ComplianceContext): Promise<T[]>;
-    /**
-     * Reads a record from the cache.
-     */
-    readRecord<T>(cacheRecordKey: string, compliance?: ComplianceContext): Promise<TtlCacheRecord<T>>;
-    /**
-     * Reads a batch of records from the cache.
-     */
-    readBatchRecords<T>(cacheRecordKeysOrPrefix: string[] | string, compliance?: ComplianceContext): Promise<TtlCacheRecord<T>[]>;
-    /**
-     * Checks if a record exists in the cache.
-     */
-    peekRecord(cacheRecordKey: string): Promise<boolean>;
-    /**
-     * Checks if a batch of records exist in the cache.
-     */
-    peekBatchRecords(cacheRecordKeysOrPrefix: string[] | string): Promise<boolean[]>;
-    /**
-     * Peeks at the front of a queue without removing.
-     */
-    peekQueueRecord<T>(queueName: string, compliance?: ComplianceContext): Promise<T>;
-    /**
-     * Peeks at multiple records from a queue without removing.
-     */
-    peekQueueRecords<T>(queueName: string, pageSize: number, compliance?: ComplianceContext): Promise<T[]>;
-    /**
-     * Gets the default TTL in milliseconds.
-     */
-    getTtlMilliseconds(): number;
-    /**
-     * Lists keys matching a prefix.
-     */
-    listKeys(pattern_prefix: string): Promise<string[]>;
-}
-
-export type { TtlCache as T };

package/lib/ttlCacheRecord.types-oX0ti5SP.d.ts

@@ -1,25 +0,0 @@
-/**
- * Type representing a TTL (Time-To-Live) cache record.
- *
- * @typedef {Object} TtlCacheRecord
- * @property {string} key - The key of the cache record.
- * @property {any} value - The value of the cache record.
- * @property {number} ttlMilliseconds - The time-to-live of the cache record in milliseconds.
- */
-type TtlCacheRecord<T> = {
-    key: string;
-    value: T;
-    ttlMilliseconds: number;
-};
-/**
- * Optional compliance context for operations that require tenant-scoped encryption.
- * When provided, values are encrypted/decrypted using the tenantId for key derivation.
- * When omitted, values are stored/read as plaintext.
- *
- * Used by both TtlCache (Redis) and ObjectStore (S3).
- */
-interface ComplianceContext {
-    tenantId: string;
-}
-
-export type { ComplianceContext as C, TtlCacheRecord as T };

package/lib/ws/index.d.mts

@@ -1,67 +0,0 @@
-import { AsyncAPIObject } from '@asyncapi/parser/esm/spec-types/v3';
-import { AnySchemaValidator, IdiomaticSchema, SchemaValidator } from '@forklaunch/validator';
-import { S as StringOnlyObject } from '../apiDefinition.types-DF_crhB0.mjs';
-import '@forklaunch/common';
-import '@opentelemetry/api';
-import 'jose';
-import 'qs';
-import 'stream';
-import '../openTelemetryCollector-BS-ej09T.mjs';
-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 };