@forklaunch/core 0.5.3 → 0.5.4

package/lib/openTelemetryCollector-CWrfzmmW.d.mts

@@ -0,0 +1,44 @@
+import { Counter, Gauge, Histogram, UpDownCounter, ObservableCounter, ObservableGauge, ObservableUpDownCounter } from '@opentelemetry/api';
+import { LevelWithSilentOrString, LevelWithSilent } from 'pino';
+
+type MetricType<T extends string> = T extends 'counter' ? Counter : T extends 'gauge' ? Gauge : T extends 'histogram' ? Histogram : T extends 'upDownCounter' ? UpDownCounter : T extends 'observableCounter' ? ObservableCounter : T extends 'observableGauge' ? ObservableGauge : T extends 'observableUpDownCounter' ? ObservableUpDownCounter : undefined;
+type MetricsDefinition = Record<string, 'counter' | 'gauge' | 'histogram' | 'upDownCounter' | 'observableCounter' | 'observableGauge' | 'observableUpDownCounter'>;
+type LoggerMeta = Record<string, unknown> & {
+    _meta: true;
+};
+interface LogFn {
+    <T extends object>(obj: T | LoggerMeta, msg?: string | LoggerMeta, ...args: unknown[]): void;
+    (obj: unknown | LoggerMeta, msg?: string | LoggerMeta, ...args: unknown[]): void;
+    (msg: string | LoggerMeta, ...args: unknown[]): void;
+}
+
+declare class OpenTelemetryCollector<AppliedMetricsDefinition extends MetricsDefinition> {
+    private readonly serviceName;
+    private readonly logger;
+    private readonly metrics;
+    constructor(serviceName: string, level?: LevelWithSilentOrString, metricDefinitions?: AppliedMetricsDefinition);
+    log(level: LevelWithSilent, ...args: (string | unknown | LoggerMeta)[]): void;
+    info: LogFn;
+    error: LogFn;
+    warn: LogFn;
+    debug: LogFn;
+    trace: LogFn;
+    getMetric<T extends keyof AppliedMetricsDefinition>(metricId: T): MetricType<AppliedMetricsDefinition[T]>;
+}
+declare const httpRequestsTotalCounter: Counter<{
+    "service.name": string;
+    "api.name": string;
+    "correlation.id": string;
+    "http.request.method": string;
+    "http.route": string;
+    "http.response.status_code": number;
+}>;
+declare const httpServerDurationHistogram: Histogram<{
+    "service.name": string;
+    "api.name": string;
+    "http.request.method": string;
+    "http.route": string;
+    "http.response.status_code": number;
+}>;
+
+export { type LoggerMeta as L, type MetricsDefinition as M, OpenTelemetryCollector as O, type LogFn as a, httpServerDurationHistogram as b, type MetricType as c, httpRequestsTotalCounter as h };

package/lib/openTelemetryCollector-CWrfzmmW.d.ts

@@ -0,0 +1,44 @@
+import { Counter, Gauge, Histogram, UpDownCounter, ObservableCounter, ObservableGauge, ObservableUpDownCounter } from '@opentelemetry/api';
+import { LevelWithSilentOrString, LevelWithSilent } from 'pino';
+
+type MetricType<T extends string> = T extends 'counter' ? Counter : T extends 'gauge' ? Gauge : T extends 'histogram' ? Histogram : T extends 'upDownCounter' ? UpDownCounter : T extends 'observableCounter' ? ObservableCounter : T extends 'observableGauge' ? ObservableGauge : T extends 'observableUpDownCounter' ? ObservableUpDownCounter : undefined;
+type MetricsDefinition = Record<string, 'counter' | 'gauge' | 'histogram' | 'upDownCounter' | 'observableCounter' | 'observableGauge' | 'observableUpDownCounter'>;
+type LoggerMeta = Record<string, unknown> & {
+    _meta: true;
+};
+interface LogFn {
+    <T extends object>(obj: T | LoggerMeta, msg?: string | LoggerMeta, ...args: unknown[]): void;
+    (obj: unknown | LoggerMeta, msg?: string | LoggerMeta, ...args: unknown[]): void;
+    (msg: string | LoggerMeta, ...args: unknown[]): void;
+}
+
+declare class OpenTelemetryCollector<AppliedMetricsDefinition extends MetricsDefinition> {
+    private readonly serviceName;
+    private readonly logger;
+    private readonly metrics;
+    constructor(serviceName: string, level?: LevelWithSilentOrString, metricDefinitions?: AppliedMetricsDefinition);
+    log(level: LevelWithSilent, ...args: (string | unknown | LoggerMeta)[]): void;
+    info: LogFn;
+    error: LogFn;
+    warn: LogFn;
+    debug: LogFn;
+    trace: LogFn;
+    getMetric<T extends keyof AppliedMetricsDefinition>(metricId: T): MetricType<AppliedMetricsDefinition[T]>;
+}
+declare const httpRequestsTotalCounter: Counter<{
+    "service.name": string;
+    "api.name": string;
+    "correlation.id": string;
+    "http.request.method": string;
+    "http.route": string;
+    "http.response.status_code": number;
+}>;
+declare const httpServerDurationHistogram: Histogram<{
+    "service.name": string;
+    "api.name": string;
+    "http.request.method": string;
+    "http.route": string;
+    "http.response.status_code": number;
+}>;
+
+export { type LoggerMeta as L, type MetricsDefinition as M, OpenTelemetryCollector as O, type LogFn as a, httpServerDurationHistogram as b, type MetricType as c, httpRequestsTotalCounter as h };

package/lib/services/index.d.mts

@@ -6,9 +6,13 @@ declare enum Lifetime {
     Transient = 1,
     Scoped = 2
 }
-type Singleton<Value> = {
+type Singleton<Args, Value> = {
     lifetime: Lifetime.Singleton;
     value: Value;
+} | ConstructedSingleton<Args, Value>;
+type ConstructedSingleton<Args, Return> = {
+    lifetime: Lifetime.Singleton;
+    factory: (args: Args, resolve: <T extends keyof Args>(token: T, context?: Record<string, unknown>) => Args[T], context: Record<string, unknown>) => Return;
 };
 type Constructed<Args, Return> = {
     lifetime: Lifetime.Transient | Lifetime.Scoped;
@@ -34,7 +38,9 @@ declare class ConfigInjector<SV extends AnySchemaValidator, CV extends ConfigVal
     private loadSingletons;
     private resolveInstance;
     constructor(schemaValidator: SV, configShapes: CV, dependenciesDefinition: {
-        [K in keyof CV]: Singleton<ResolvedConfigValidator<SV, CV>[K]> | Constructed<Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>;
+        [K in keyof CV]: Singleton<Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]> | Constructed<Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>;
+    }, inheritedScopeInstances?: {
+        [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];
     });
     safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>>;
     validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV>;
@@ -67,4 +73,4 @@ type EntityManager = {
     fork: <Options>(options?: Options) => EntityManager;
 };
 
-export { type BaseService, ConfigInjector, type ConfigValidator, type Constructed, type Constructor, type EntityManager, type Function, Lifetime, type ResolvedConfigValidator, type SchemaConstructor, type SchemaFunction, type ScopedDependencyFactory, type Singleton, ValidConfigInjector, getEnvVar };
+export { type BaseService, ConfigInjector, type ConfigValidator, type Constructed, type ConstructedSingleton, type Constructor, type EntityManager, type Function, Lifetime, type ResolvedConfigValidator, type SchemaConstructor, type SchemaFunction, type ScopedDependencyFactory, type Singleton, ValidConfigInjector, getEnvVar };

package/lib/services/index.d.ts

@@ -6,9 +6,13 @@ declare enum Lifetime {
     Transient = 1,
     Scoped = 2
 }
-type Singleton<Value> = {
+type Singleton<Args, Value> = {
     lifetime: Lifetime.Singleton;
     value: Value;
+} | ConstructedSingleton<Args, Value>;
+type ConstructedSingleton<Args, Return> = {
+    lifetime: Lifetime.Singleton;
+    factory: (args: Args, resolve: <T extends keyof Args>(token: T, context?: Record<string, unknown>) => Args[T], context: Record<string, unknown>) => Return;
 };
 type Constructed<Args, Return> = {
     lifetime: Lifetime.Transient | Lifetime.Scoped;
@@ -34,7 +38,9 @@ declare class ConfigInjector<SV extends AnySchemaValidator, CV extends ConfigVal
     private loadSingletons;
     private resolveInstance;
     constructor(schemaValidator: SV, configShapes: CV, dependenciesDefinition: {
-        [K in keyof CV]: Singleton<ResolvedConfigValidator<SV, CV>[K]> | Constructed<Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>;
+        [K in keyof CV]: Singleton<Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]> | Constructed<Omit<ResolvedConfigValidator<SV, CV>, K>, ResolvedConfigValidator<SV, CV>[K]>;
+    }, inheritedScopeInstances?: {
+        [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];
     });
     safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>>;
     validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV>;
@@ -67,4 +73,4 @@ type EntityManager = {
     fork: <Options>(options?: Options) => EntityManager;
 };
 
-export { type BaseService, ConfigInjector, type ConfigValidator, type Constructed, type Constructor, type EntityManager, type Function, Lifetime, type ResolvedConfigValidator, type SchemaConstructor, type SchemaFunction, type ScopedDependencyFactory, type Singleton, ValidConfigInjector, getEnvVar };
+export { type BaseService, ConfigInjector, type ConfigValidator, type Constructed, type ConstructedSingleton, type Constructor, type EntityManager, type Function, Lifetime, type ResolvedConfigValidator, type SchemaConstructor, type SchemaFunction, type ScopedDependencyFactory, type Singleton, ValidConfigInjector, getEnvVar };

package/lib/services/index.js

@@ -36,11 +36,6 @@ function isConstructed(value) {
   return typeof value === "object" && value != null && "constructor" in value && value.constructor != null;
 }
 
-// src/services/guards/isConstructor.ts
-function isConstructor(value) {
-  return typeof value === "function" && value.constructor != null && value.prototype != null;
-}
-
 // src/services/types/configInjector.types.ts
 var Lifetime = /* @__PURE__ */ ((Lifetime2) => {
   Lifetime2[Lifetime2["Singleton"] = 0] = "Singleton";
@@ -49,20 +44,39 @@ var Lifetime = /* @__PURE__ */ ((Lifetime2) => {
   return Lifetime2;
 })(Lifetime || {});
 
+// src/services/guards/isConstructedSingleton.ts
+function isConstructedSingleton(value) {
+  return typeof value === "object" && value != null && "lifetime" in value && value.lifetime === 0 /* Singleton */ && "factory" in value;
+}
+
+// src/services/guards/isConstructor.ts
+function isConstructor(value) {
+  return typeof value === "function" && value.constructor != null && value.prototype != null;
+}
+
 // src/services/configInjector.ts
 var ConfigInjector = class _ConfigInjector {
-  constructor(schemaValidator, configShapes, dependenciesDefinition) {
+  constructor(schemaValidator, configShapes, dependenciesDefinition, inheritedScopeInstances) {
     this.schemaValidator = schemaValidator;
     this.configShapes = configShapes;
     this.dependenciesDefinition = dependenciesDefinition;
-    this.loadSingletons();
+    this.loadSingletons(inheritedScopeInstances);
   }
   instances = {};
-  loadSingletons() {
+  loadSingletons(inheritedScopeInstances) {
     for (const token in this.dependenciesDefinition) {
       const definition = this.dependenciesDefinition[token];
       if (definition.lifetime === 0 /* Singleton */) {
-        this.instances[token] = definition.value;
+        if (inheritedScopeInstances && inheritedScopeInstances[token]) {
+          this.instances[token] = inheritedScopeInstances[token];
+        } else if (isConstructedSingleton(definition)) {
+          this.instances[token] = this.resolveInstance(
+            token,
+            definition
+          );
+        } else {
+          this.instances[token] = definition.value;
+        }
       }
     }
   }
@@ -106,9 +120,9 @@ var ConfigInjector = class _ConfigInjector {
     const validNonSchemaSingletons = Object.entries(this.configShapes).reduce(
       (acc, [key, value]) => {
         if (this.dependenciesDefinition[key].lifetime === 0 /* Singleton */ && !this.schemaValidator.isSchema(value) && isConstructor(value)) {
-          if (!(this.dependenciesDefinition[key].value instanceof value)) {
+          if (!(this.instances[key] instanceof value)) {
             const expected = value.name;
-            const receivedValue = this.dependenciesDefinition[key].value;
+            const receivedValue = this.instances[key];
             const received = isConstructed(receivedValue) ? receivedValue.constructor.name : typeof receivedValue;
             if (acc.ok) {
               acc = {
@@ -126,7 +140,7 @@ var ConfigInjector = class _ConfigInjector {
                 ok: true,
                 value: {
                   ...acc.value,
-                  [key]: this.dependenciesDefinition[key].value
+                  [key]: this.instances[key]
                 }
               };
             }
@@ -152,7 +166,7 @@ var ConfigInjector = class _ConfigInjector {
           const dependency = this.dependenciesDefinition[key];
           return [
             key,
-            dependency.lifetime === 0 /* Singleton */ ? dependency.value : void 0
+            dependency.lifetime === 0 /* Singleton */ ? this.instances[key] : void 0
           ];
         })
       )
@@ -163,7 +177,8 @@ var ConfigInjector = class _ConfigInjector {
       value: new ValidConfigInjector(
         this.schemaValidator,
         this.configShapes,
-        this.dependenciesDefinition
+        this.dependenciesDefinition,
+        this.instances
       )
     } : {
       ok: false,
@@ -193,7 +208,7 @@ var ConfigInjector = class _ConfigInjector {
       }
       switch (definition.lifetime) {
         case 0 /* Singleton */: {
-          return definition.value;
+          return this.instances[token];
         }
         case 2 /* Scoped */: {
           const scopedInstance = this.resolveInstance(
@@ -233,7 +248,8 @@ var ConfigInjector = class _ConfigInjector {
     return new _ConfigInjector(
       this.schemaValidator,
       this.configShapes,
-      this.dependenciesDefinition
+      this.dependenciesDefinition,
+      this.instances
     );
   }
   dispose() {

package/lib/services/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/services/index.ts","../../src/services/configInjector.ts","../../src/services/guards/isConstructed.ts","../../src/services/guards/isConstructor.ts","../../src/services/types/configInjector.types.ts","../../src/services/getEnvVar.ts"],"sourcesContent":["export * from './configInjector';\nexport * from './getEnvVar';\nexport * from './interfaces/baseService';\nexport * from './types/configInjector.types';\nexport * from './types/entityManager.types';\n","import { extractArgumentNames, isNever } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  ParseResult,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { isConstructed } from './guards/isConstructed';\nimport { isConstructor } from './guards/isConstructor';\nimport {\n  ConfigValidator,\n  Constructed,\n  Lifetime,\n  ResolvedConfigValidator,\n  SchemaConstructor,\n  SchemaFunction,\n  Singleton\n} from './types/configInjector.types';\n\nexport class ConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> {\n  instances: {\n    [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n  } = {};\n\n  private loadSingletons(): void {\n    for (const token in this.dependenciesDefinition) {\n      const definition = this.dependenciesDefinition[token];\n      if (definition.lifetime === Lifetime.Singleton) {\n        this.instances[token] = definition.value;\n      }\n    }\n  }\n\n  private resolveInstance<T extends keyof CV>(\n    token: T,\n    definition: Constructed<\n      Omit<ResolvedConfigValidator<SV, CV>, T>,\n      ResolvedConfigValidator<SV, CV>[T]\n    >,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const injectorArgument = extractArgumentNames(definition.factory)[0];\n    // short circuit as no args\n    if (injectorArgument === '_args') {\n      return definition.factory(\n        {} as Omit<ResolvedConfigValidator<SV, CV>, T>,\n        this.resolve.bind(this),\n        context ?? ({} as Record<string, unknown>)\n      );\n    }\n\n    if (!injectorArgument.startsWith('{') || !injectorArgument.endsWith('}')) {\n      throw new Error(\n        `Invalid injector argument for ${String(\n          token\n        )}: ${injectorArgument}. Please use object destructuring syntax: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment.`\n      );\n    }\n    const resolvedArguments = Object.fromEntries(\n      injectorArgument\n        .replace('{', '')\n        .replace('}', '')\n        .split(',')\n        .map((arg) => arg.split(':')[0].trim())\n        .map((arg) => {\n          const newResolutionPath = [...resolutionPath, token];\n          if (resolutionPath.includes(arg)) {\n            throw new Error(\n              `Circular dependency detected: ${newResolutionPath.join(\n                ' -> '\n              )} -> ${arg}`\n            );\n          }\n          const resolvedArg = this.resolve(arg, context, newResolutionPath);\n          return [arg, resolvedArg];\n        })\n    ) as unknown as Omit<ResolvedConfigValidator<SV, CV>, T>;\n    return definition.factory(\n      resolvedArguments,\n      this.resolve.bind(this),\n      context ?? ({} as Record<string, unknown>)\n    );\n  }\n\n  constructor(\n    private schemaValidator: SV,\n    private configShapes: CV,\n    private dependenciesDefinition: {\n      [K in keyof CV]:\n        | Singleton<ResolvedConfigValidator<SV, CV>[K]>\n        | Constructed<\n            Omit<ResolvedConfigValidator<SV, CV>, K>,\n            ResolvedConfigValidator<SV, CV>[K]\n          >;\n    }\n  ) {\n    this.loadSingletons();\n  }\n\n  safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>> {\n    const validNonSchemaSingletons = Object.entries(this.configShapes).reduce<\n      ParseResult<ResolvedConfigValidator<SV, CV>>\n    >(\n      (acc, [key, value]) => {\n        if (\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          !(this.schemaValidator as SchemaValidator).isSchema<\n            SchemaFunction<SV> | SchemaConstructor<SV> | IdiomaticSchema<SV>\n          >(value) &&\n          isConstructor(value)\n        ) {\n          if (!(this.dependenciesDefinition[key].value instanceof value)) {\n            const expected = value.name;\n            const receivedValue: unknown =\n              this.dependenciesDefinition[key].value;\n            const received = isConstructed(receivedValue)\n              ? receivedValue.constructor.name\n              : typeof receivedValue;\n\n            if (acc.ok) {\n              acc = {\n                ok: false,\n                errors: []\n              };\n            }\n            acc.errors?.push({\n              message: `Expected ${expected}, received ${received}`,\n              path: [key]\n            });\n          } else {\n            if (acc.ok) {\n              acc = {\n                ok: true,\n                value: {\n                  ...acc.value,\n                  [key]: this.dependenciesDefinition[key].value\n                }\n              };\n            }\n          }\n          return acc;\n        }\n        return acc;\n      },\n      {\n        ok: true,\n        value: {} as ResolvedConfigValidator<SV, CV>\n      }\n    );\n\n    const singletons = Object.fromEntries(\n      Object.entries(this.configShapes).filter(\n        ([key, value]) =>\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          (this.schemaValidator as SchemaValidator).isSchema(value)\n      )\n    );\n    const schemaSingletonParseResult = (\n      this.schemaValidator as SchemaValidator\n    ).parse(\n      (this.schemaValidator as SchemaValidator).schemify(singletons),\n      Object.fromEntries(\n        Object.keys(singletons).map((key) => {\n          const dependency = this.dependenciesDefinition[key];\n          return [\n            key,\n            dependency.lifetime === Lifetime.Singleton\n              ? dependency.value\n              : undefined\n          ];\n        })\n      )\n    );\n\n    const configKeys = Object.keys(this.configShapes);\n\n    return validNonSchemaSingletons.ok && schemaSingletonParseResult.ok\n      ? {\n          ok: true as const,\n          value: new ValidConfigInjector<SV, CV>(\n            this.schemaValidator,\n            this.configShapes,\n            this.dependenciesDefinition\n          )\n        }\n      : {\n          ok: false as const,\n          errors: [\n            ...(!validNonSchemaSingletons.ok && validNonSchemaSingletons.errors\n              ? validNonSchemaSingletons.errors\n              : []),\n            ...(!schemaSingletonParseResult.ok &&\n            schemaSingletonParseResult.errors\n              ? schemaSingletonParseResult.errors\n              : [])\n          ].sort(\n            (a, b) =>\n              configKeys.indexOf(a.path[0]) - configKeys.indexOf(b.path[0])\n          )\n        };\n  }\n\n  validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV> {\n    const safeValidateResult = this.safeValidateConfigSingletons();\n\n    if (safeValidateResult.ok) {\n      return safeValidateResult.value;\n    }\n\n    throw new Error(\n      prettyPrintParseErrors(safeValidateResult.errors, configName)\n    );\n  }\n\n  resolve<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const instance = this.instances[token];\n    if (!instance) {\n      const definition = this.dependenciesDefinition[token];\n\n      if (!definition) {\n        throw new Error(`Unable to resolve dependency ${String(token)}`);\n      }\n\n      switch (definition.lifetime) {\n        case Lifetime.Singleton: {\n          return definition.value;\n        }\n        case Lifetime.Scoped: {\n          const scopedInstance = this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n          this.instances[token] = scopedInstance;\n          return scopedInstance;\n        }\n        case Lifetime.Transient: {\n          return this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n        }\n        default: {\n          isNever(definition);\n          throw new Error(\n            `Unable to resolve lifetime for dependency ${String(\n              token\n            )}, ${resolutionPath}`\n          );\n        }\n      }\n    } else {\n      return instance;\n    }\n  }\n\n  scopedResolver<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[T] {\n    return (scope) =>\n      (scope ?? this.createScope()).resolve<T>(token, context, resolutionPath);\n  }\n\n  createScope(): ConfigInjector<SV, CV> {\n    return new ConfigInjector<SV, CV>(\n      this.schemaValidator,\n      this.configShapes,\n      this.dependenciesDefinition\n    );\n  }\n\n  dispose(): void {\n    this.instances = {};\n    this.loadSingletons();\n  }\n}\n\nexport class ValidConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> extends ConfigInjector<SV, CV> {\n  validConfigInjector!: void;\n}\n","import { Constructed } from '../types/configInjector.types';\n\nexport function isConstructed(\n  value: unknown\n): value is Constructed<unknown, unknown> {\n  return (\n    typeof value === 'object' &&\n    value != null &&\n    'constructor' in value &&\n    value.constructor != null\n  );\n}\n","import { Constructor } from '../types/configInjector.types';\n\nexport function isConstructor(value: unknown): value is Constructor {\n  return (\n    typeof value === 'function' &&\n    value.constructor != null &&\n    value.prototype != null\n  );\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  Schema\n} from '@forklaunch/validator';\nimport { ConfigInjector } from '../configInjector';\n\nexport enum Lifetime {\n  Singleton,\n  Transient,\n  Scoped\n}\n\nexport type Singleton<Value> = {\n  lifetime: Lifetime.Singleton;\n  value: Value;\n};\n\nexport type Constructed<Args, Return> = {\n  lifetime: Lifetime.Transient | Lifetime.Scoped;\n  factory: (\n    args: Args,\n    resolve: <T extends keyof Args>(\n      token: T,\n      context?: Record<string, unknown>\n    ) => Args[T],\n    context: Record<string, unknown>\n  ) => Return;\n};\n\nexport type Constructor = new (...args: never[]) => unknown;\nexport type SchemaConstructor<SV extends AnySchemaValidator> = new (\n  ...args: unknown[]\n) => IdiomaticSchema<SV>;\nexport type Function = (...args: never[]) => unknown;\nexport type SchemaFunction<SV extends AnySchemaValidator> = (\n  args: unknown\n) => IdiomaticSchema<SV>;\n\nexport type ConfigValidator<SV extends AnySchemaValidator> = Record<\n  string,\n  | Function\n  | SchemaFunction<SV>\n  | Constructor\n  | SchemaConstructor<SV>\n  | IdiomaticSchema<SV>\n>;\n\nexport type ResolvedConfigValidator<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> = {\n  [M in keyof CV]: CV[M] extends SchemaConstructor<SV>\n    ? Schema<InstanceType<CV[M]>, SV>\n    : CV[M] extends SchemaFunction<SV>\n      ? Schema<ReturnType<CV[M]>, SV>\n      : CV[M] extends Function\n        ? ReturnType<CV[M]>\n        : CV[M] extends Constructor\n          ? InstanceType<CV[M]>\n          : Schema<CV[M], SV>;\n};\n\nexport type ScopedDependencyFactory<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>,\n  M extends keyof CV\n> = (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[M];\n","// This is a simple function that returns the value of an environment variable.\n// It casts a potentially undefined value to a string, since it will be validated in order to be bootstrapped.\n\nexport function getEnvVar(name: string): string {\n  const value = process.env[name];\n  return value as string;\n}\n"],"mappings":"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","names":["Lifetime"]}
+{"version":3,"sources":["../../src/services/index.ts","../../src/services/configInjector.ts","../../src/services/guards/isConstructed.ts","../../src/services/types/configInjector.types.ts","../../src/services/guards/isConstructedSingleton.ts","../../src/services/guards/isConstructor.ts","../../src/services/getEnvVar.ts"],"sourcesContent":["export * from './configInjector';\nexport * from './getEnvVar';\nexport * from './interfaces/baseService';\nexport * from './types/configInjector.types';\nexport * from './types/entityManager.types';\n","import { extractArgumentNames, isNever } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  ParseResult,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { isConstructed } from './guards/isConstructed';\nimport { isConstructedSingleton } from './guards/isConstructedSingleton';\nimport { isConstructor } from './guards/isConstructor';\nimport {\n  ConfigValidator,\n  Constructed,\n  ConstructedSingleton,\n  Lifetime,\n  ResolvedConfigValidator,\n  SchemaConstructor,\n  SchemaFunction,\n  Singleton\n} from './types/configInjector.types';\n\nexport class ConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> {\n  instances: {\n    [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n  } = {};\n\n  private loadSingletons(inheritedScopeInstances?: {\n    [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n  }): void {\n    for (const token in this.dependenciesDefinition) {\n      const definition = this.dependenciesDefinition[token];\n      if (definition.lifetime === Lifetime.Singleton) {\n        if (inheritedScopeInstances && inheritedScopeInstances[token]) {\n          this.instances[token] = inheritedScopeInstances[token];\n        } else if (\n          isConstructedSingleton<\n            Omit<ResolvedConfigValidator<SV, CV>, typeof token>,\n            ResolvedConfigValidator<SV, CV>[typeof token]\n          >(definition)\n        ) {\n          this.instances[token] = this.resolveInstance<typeof token>(\n            token,\n            definition\n          );\n        } else {\n          this.instances[token] = definition.value;\n        }\n      }\n    }\n  }\n\n  private resolveInstance<T extends keyof CV>(\n    token: T,\n    definition:\n      | ConstructedSingleton<\n          Omit<ResolvedConfigValidator<SV, CV>, T>,\n          ResolvedConfigValidator<SV, CV>[T]\n        >\n      | Constructed<\n          Omit<ResolvedConfigValidator<SV, CV>, T>,\n          ResolvedConfigValidator<SV, CV>[T]\n        >,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const injectorArgument = extractArgumentNames(definition.factory)[0];\n    // short circuit as no args\n    if (injectorArgument === '_args') {\n      return definition.factory(\n        {} as Omit<ResolvedConfigValidator<SV, CV>, T>,\n        this.resolve.bind(this),\n        context ?? ({} as Record<string, unknown>)\n      );\n    }\n\n    if (!injectorArgument.startsWith('{') || !injectorArgument.endsWith('}')) {\n      throw new Error(\n        `Invalid injector argument for ${String(\n          token\n        )}: ${injectorArgument}. Please use object destructuring syntax: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment.`\n      );\n    }\n    const resolvedArguments = Object.fromEntries(\n      injectorArgument\n        .replace('{', '')\n        .replace('}', '')\n        .split(',')\n        .map((arg) => arg.split(':')[0].trim())\n        .map((arg) => {\n          const newResolutionPath = [...resolutionPath, token];\n          if (resolutionPath.includes(arg)) {\n            throw new Error(\n              `Circular dependency detected: ${newResolutionPath.join(\n                ' -> '\n              )} -> ${arg}`\n            );\n          }\n          const resolvedArg = this.resolve(arg, context, newResolutionPath);\n          return [arg, resolvedArg];\n        })\n    ) as unknown as Omit<ResolvedConfigValidator<SV, CV>, T>;\n    return definition.factory(\n      resolvedArguments,\n      this.resolve.bind(this),\n      context ?? ({} as Record<string, unknown>)\n    );\n  }\n\n  constructor(\n    private schemaValidator: SV,\n    private configShapes: CV,\n    private dependenciesDefinition: {\n      [K in keyof CV]:\n        | Singleton<\n            Omit<ResolvedConfigValidator<SV, CV>, K>,\n            ResolvedConfigValidator<SV, CV>[K]\n          >\n        | Constructed<\n            Omit<ResolvedConfigValidator<SV, CV>, K>,\n            ResolvedConfigValidator<SV, CV>[K]\n          >;\n    },\n    inheritedScopeInstances?: {\n      [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n    }\n  ) {\n    this.loadSingletons(inheritedScopeInstances);\n  }\n\n  safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>> {\n    const validNonSchemaSingletons = Object.entries(this.configShapes).reduce<\n      ParseResult<ResolvedConfigValidator<SV, CV>>\n    >(\n      (acc, [key, value]) => {\n        if (\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          !(this.schemaValidator as SchemaValidator).isSchema<\n            SchemaFunction<SV> | SchemaConstructor<SV> | IdiomaticSchema<SV>\n          >(value) &&\n          isConstructor(value)\n        ) {\n          if (!(this.instances[key] instanceof value)) {\n            const expected = value.name;\n            const receivedValue: unknown = this.instances[key];\n            const received = isConstructed(receivedValue)\n              ? receivedValue.constructor.name\n              : typeof receivedValue;\n\n            if (acc.ok) {\n              acc = {\n                ok: false,\n                errors: []\n              };\n            }\n            acc.errors?.push({\n              message: `Expected ${expected}, received ${received}`,\n              path: [key]\n            });\n          } else {\n            if (acc.ok) {\n              acc = {\n                ok: true,\n                value: {\n                  ...acc.value,\n                  [key]: this.instances[key]\n                }\n              };\n            }\n          }\n          return acc;\n        }\n        return acc;\n      },\n      {\n        ok: true,\n        value: {} as ResolvedConfigValidator<SV, CV>\n      }\n    );\n\n    const singletons = Object.fromEntries(\n      Object.entries(this.configShapes).filter(\n        ([key, value]) =>\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          (this.schemaValidator as SchemaValidator).isSchema(value)\n      )\n    );\n    const schemaSingletonParseResult = (\n      this.schemaValidator as SchemaValidator\n    ).parse(\n      (this.schemaValidator as SchemaValidator).schemify(singletons),\n      Object.fromEntries(\n        Object.keys(singletons).map((key) => {\n          const dependency = this.dependenciesDefinition[key];\n          return [\n            key,\n            dependency.lifetime === Lifetime.Singleton\n              ? this.instances[key]\n              : undefined\n          ];\n        })\n      )\n    );\n\n    const configKeys = Object.keys(this.configShapes);\n\n    return validNonSchemaSingletons.ok && schemaSingletonParseResult.ok\n      ? {\n          ok: true as const,\n          value: new ValidConfigInjector<SV, CV>(\n            this.schemaValidator,\n            this.configShapes,\n            this.dependenciesDefinition,\n            this.instances\n          )\n        }\n      : {\n          ok: false as const,\n          errors: [\n            ...(!validNonSchemaSingletons.ok && validNonSchemaSingletons.errors\n              ? validNonSchemaSingletons.errors\n              : []),\n            ...(!schemaSingletonParseResult.ok &&\n            schemaSingletonParseResult.errors\n              ? schemaSingletonParseResult.errors\n              : [])\n          ].sort(\n            (a, b) =>\n              configKeys.indexOf(a.path[0]) - configKeys.indexOf(b.path[0])\n          )\n        };\n  }\n\n  validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV> {\n    const safeValidateResult = this.safeValidateConfigSingletons();\n\n    if (safeValidateResult.ok) {\n      return safeValidateResult.value;\n    }\n\n    throw new Error(\n      prettyPrintParseErrors(safeValidateResult.errors, configName)\n    );\n  }\n\n  resolve<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const instance = this.instances[token];\n    if (!instance) {\n      const definition = this.dependenciesDefinition[token];\n\n      if (!definition) {\n        throw new Error(`Unable to resolve dependency ${String(token)}`);\n      }\n\n      switch (definition.lifetime) {\n        case Lifetime.Singleton: {\n          // return definition.value;\n          return this.instances[token] as ResolvedConfigValidator<SV, CV>[T];\n        }\n        case Lifetime.Scoped: {\n          const scopedInstance = this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n          this.instances[token] = scopedInstance;\n          return scopedInstance;\n        }\n        case Lifetime.Transient: {\n          return this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n        }\n        default: {\n          isNever(definition);\n          throw new Error(\n            `Unable to resolve lifetime for dependency ${String(\n              token\n            )}, ${resolutionPath}`\n          );\n        }\n      }\n    } else {\n      return instance;\n    }\n  }\n\n  scopedResolver<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[T] {\n    return (scope) =>\n      (scope ?? this.createScope()).resolve<T>(token, context, resolutionPath);\n  }\n\n  createScope(): ConfigInjector<SV, CV> {\n    return new ConfigInjector<SV, CV>(\n      this.schemaValidator,\n      this.configShapes,\n      this.dependenciesDefinition,\n      this.instances\n    );\n  }\n\n  dispose(): void {\n    this.instances = {};\n    this.loadSingletons();\n  }\n}\n\nexport class ValidConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> extends ConfigInjector<SV, CV> {\n  validConfigInjector!: void;\n}\n","import { Constructed } from '../types/configInjector.types';\n\nexport function isConstructed(\n  value: unknown\n): value is Constructed<unknown, unknown> {\n  return (\n    typeof value === 'object' &&\n    value != null &&\n    'constructor' in value &&\n    value.constructor != null\n  );\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  Schema\n} from '@forklaunch/validator';\nimport { ConfigInjector } from '../configInjector';\n\nexport enum Lifetime {\n  Singleton,\n  Transient,\n  Scoped\n}\n\nexport type Singleton<Args, Value> =\n  | {\n      lifetime: Lifetime.Singleton;\n      value: Value;\n    }\n  | ConstructedSingleton<Args, Value>;\n\nexport type ConstructedSingleton<Args, Return> = {\n  lifetime: Lifetime.Singleton;\n  factory: (\n    args: Args,\n    resolve: <T extends keyof Args>(\n      token: T,\n      context?: Record<string, unknown>\n    ) => Args[T],\n    context: Record<string, unknown>\n  ) => Return;\n};\n\nexport type Constructed<Args, Return> = {\n  lifetime: Lifetime.Transient | Lifetime.Scoped;\n  factory: (\n    args: Args,\n    resolve: <T extends keyof Args>(\n      token: T,\n      context?: Record<string, unknown>\n    ) => Args[T],\n    context: Record<string, unknown>\n  ) => Return;\n};\n\nexport type Constructor = new (...args: never[]) => unknown;\nexport type SchemaConstructor<SV extends AnySchemaValidator> = new (\n  ...args: unknown[]\n) => IdiomaticSchema<SV>;\nexport type Function = (...args: never[]) => unknown;\nexport type SchemaFunction<SV extends AnySchemaValidator> = (\n  args: unknown\n) => IdiomaticSchema<SV>;\n\nexport type ConfigValidator<SV extends AnySchemaValidator> = Record<\n  string,\n  | Function\n  | SchemaFunction<SV>\n  | Constructor\n  | SchemaConstructor<SV>\n  | IdiomaticSchema<SV>\n>;\n\nexport type ResolvedConfigValidator<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> = {\n  [M in keyof CV]: CV[M] extends SchemaConstructor<SV>\n    ? Schema<InstanceType<CV[M]>, SV>\n    : CV[M] extends SchemaFunction<SV>\n      ? Schema<ReturnType<CV[M]>, SV>\n      : CV[M] extends Function\n        ? ReturnType<CV[M]>\n        : CV[M] extends Constructor\n          ? InstanceType<CV[M]>\n          : Schema<CV[M], SV>;\n};\n\nexport type ScopedDependencyFactory<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>,\n  M extends keyof CV\n> = (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[M];\n","import { ConstructedSingleton, Lifetime } from '../types/configInjector.types';\n\nexport function isConstructedSingleton<Args, Return>(\n  value: unknown\n): value is ConstructedSingleton<Args, Return> {\n  return (\n    typeof value === 'object' &&\n    value != null &&\n    'lifetime' in value &&\n    value.lifetime === Lifetime.Singleton &&\n    'factory' in value\n  );\n}\n","import { Constructor } from '../types/configInjector.types';\n\nexport function isConstructor(value: unknown): value is Constructor {\n  return (\n    typeof value === 'function' &&\n    value.constructor != null &&\n    value.prototype != null\n  );\n}\n","// This is a simple function that returns the value of an environment variable.\n// It casts a potentially undefined value to a string, since it will be validated in order to be bootstrapped.\n\nexport function getEnvVar(name: string): string {\n  const value = process.env[name];\n  return value as string;\n}\n"],"mappings":"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","names":["Lifetime"]}

package/lib/services/index.mjs

@@ -9,11 +9,6 @@ function isConstructed(value) {
   return typeof value === "object" && value != null && "constructor" in value && value.constructor != null;
 }
 
-// src/services/guards/isConstructor.ts
-function isConstructor(value) {
-  return typeof value === "function" && value.constructor != null && value.prototype != null;
-}
-
 // src/services/types/configInjector.types.ts
 var Lifetime = /* @__PURE__ */ ((Lifetime2) => {
   Lifetime2[Lifetime2["Singleton"] = 0] = "Singleton";
@@ -22,20 +17,39 @@ var Lifetime = /* @__PURE__ */ ((Lifetime2) => {
   return Lifetime2;
 })(Lifetime || {});
 
+// src/services/guards/isConstructedSingleton.ts
+function isConstructedSingleton(value) {
+  return typeof value === "object" && value != null && "lifetime" in value && value.lifetime === 0 /* Singleton */ && "factory" in value;
+}
+
+// src/services/guards/isConstructor.ts
+function isConstructor(value) {
+  return typeof value === "function" && value.constructor != null && value.prototype != null;
+}
+
 // src/services/configInjector.ts
 var ConfigInjector = class _ConfigInjector {
-  constructor(schemaValidator, configShapes, dependenciesDefinition) {
+  constructor(schemaValidator, configShapes, dependenciesDefinition, inheritedScopeInstances) {
     this.schemaValidator = schemaValidator;
     this.configShapes = configShapes;
     this.dependenciesDefinition = dependenciesDefinition;
-    this.loadSingletons();
+    this.loadSingletons(inheritedScopeInstances);
   }
   instances = {};
-  loadSingletons() {
+  loadSingletons(inheritedScopeInstances) {
     for (const token in this.dependenciesDefinition) {
       const definition = this.dependenciesDefinition[token];
       if (definition.lifetime === 0 /* Singleton */) {
-        this.instances[token] = definition.value;
+        if (inheritedScopeInstances && inheritedScopeInstances[token]) {
+          this.instances[token] = inheritedScopeInstances[token];
+        } else if (isConstructedSingleton(definition)) {
+          this.instances[token] = this.resolveInstance(
+            token,
+            definition
+          );
+        } else {
+          this.instances[token] = definition.value;
+        }
       }
     }
   }
@@ -79,9 +93,9 @@ var ConfigInjector = class _ConfigInjector {
     const validNonSchemaSingletons = Object.entries(this.configShapes).reduce(
       (acc, [key, value]) => {
         if (this.dependenciesDefinition[key].lifetime === 0 /* Singleton */ && !this.schemaValidator.isSchema(value) && isConstructor(value)) {
-          if (!(this.dependenciesDefinition[key].value instanceof value)) {
+          if (!(this.instances[key] instanceof value)) {
             const expected = value.name;
-            const receivedValue = this.dependenciesDefinition[key].value;
+            const receivedValue = this.instances[key];
             const received = isConstructed(receivedValue) ? receivedValue.constructor.name : typeof receivedValue;
             if (acc.ok) {
               acc = {
@@ -99,7 +113,7 @@ var ConfigInjector = class _ConfigInjector {
                 ok: true,
                 value: {
                   ...acc.value,
-                  [key]: this.dependenciesDefinition[key].value
+                  [key]: this.instances[key]
                 }
               };
             }
@@ -125,7 +139,7 @@ var ConfigInjector = class _ConfigInjector {
           const dependency = this.dependenciesDefinition[key];
           return [
             key,
-            dependency.lifetime === 0 /* Singleton */ ? dependency.value : void 0
+            dependency.lifetime === 0 /* Singleton */ ? this.instances[key] : void 0
           ];
         })
       )
@@ -136,7 +150,8 @@ var ConfigInjector = class _ConfigInjector {
       value: new ValidConfigInjector(
         this.schemaValidator,
         this.configShapes,
-        this.dependenciesDefinition
+        this.dependenciesDefinition,
+        this.instances
       )
     } : {
       ok: false,
@@ -166,7 +181,7 @@ var ConfigInjector = class _ConfigInjector {
       }
       switch (definition.lifetime) {
         case 0 /* Singleton */: {
-          return definition.value;
+          return this.instances[token];
         }
         case 2 /* Scoped */: {
           const scopedInstance = this.resolveInstance(
@@ -206,7 +221,8 @@ var ConfigInjector = class _ConfigInjector {
     return new _ConfigInjector(
       this.schemaValidator,
       this.configShapes,
-      this.dependenciesDefinition
+      this.dependenciesDefinition,
+      this.instances
     );
   }
   dispose() {

package/lib/services/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/services/configInjector.ts","../../src/services/guards/isConstructed.ts","../../src/services/guards/isConstructor.ts","../../src/services/types/configInjector.types.ts","../../src/services/getEnvVar.ts"],"sourcesContent":["import { extractArgumentNames, isNever } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  ParseResult,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { isConstructed } from './guards/isConstructed';\nimport { isConstructor } from './guards/isConstructor';\nimport {\n  ConfigValidator,\n  Constructed,\n  Lifetime,\n  ResolvedConfigValidator,\n  SchemaConstructor,\n  SchemaFunction,\n  Singleton\n} from './types/configInjector.types';\n\nexport class ConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> {\n  instances: {\n    [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n  } = {};\n\n  private loadSingletons(): void {\n    for (const token in this.dependenciesDefinition) {\n      const definition = this.dependenciesDefinition[token];\n      if (definition.lifetime === Lifetime.Singleton) {\n        this.instances[token] = definition.value;\n      }\n    }\n  }\n\n  private resolveInstance<T extends keyof CV>(\n    token: T,\n    definition: Constructed<\n      Omit<ResolvedConfigValidator<SV, CV>, T>,\n      ResolvedConfigValidator<SV, CV>[T]\n    >,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const injectorArgument = extractArgumentNames(definition.factory)[0];\n    // short circuit as no args\n    if (injectorArgument === '_args') {\n      return definition.factory(\n        {} as Omit<ResolvedConfigValidator<SV, CV>, T>,\n        this.resolve.bind(this),\n        context ?? ({} as Record<string, unknown>)\n      );\n    }\n\n    if (!injectorArgument.startsWith('{') || !injectorArgument.endsWith('}')) {\n      throw new Error(\n        `Invalid injector argument for ${String(\n          token\n        )}: ${injectorArgument}. Please use object destructuring syntax: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment.`\n      );\n    }\n    const resolvedArguments = Object.fromEntries(\n      injectorArgument\n        .replace('{', '')\n        .replace('}', '')\n        .split(',')\n        .map((arg) => arg.split(':')[0].trim())\n        .map((arg) => {\n          const newResolutionPath = [...resolutionPath, token];\n          if (resolutionPath.includes(arg)) {\n            throw new Error(\n              `Circular dependency detected: ${newResolutionPath.join(\n                ' -> '\n              )} -> ${arg}`\n            );\n          }\n          const resolvedArg = this.resolve(arg, context, newResolutionPath);\n          return [arg, resolvedArg];\n        })\n    ) as unknown as Omit<ResolvedConfigValidator<SV, CV>, T>;\n    return definition.factory(\n      resolvedArguments,\n      this.resolve.bind(this),\n      context ?? ({} as Record<string, unknown>)\n    );\n  }\n\n  constructor(\n    private schemaValidator: SV,\n    private configShapes: CV,\n    private dependenciesDefinition: {\n      [K in keyof CV]:\n        | Singleton<ResolvedConfigValidator<SV, CV>[K]>\n        | Constructed<\n            Omit<ResolvedConfigValidator<SV, CV>, K>,\n            ResolvedConfigValidator<SV, CV>[K]\n          >;\n    }\n  ) {\n    this.loadSingletons();\n  }\n\n  safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>> {\n    const validNonSchemaSingletons = Object.entries(this.configShapes).reduce<\n      ParseResult<ResolvedConfigValidator<SV, CV>>\n    >(\n      (acc, [key, value]) => {\n        if (\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          !(this.schemaValidator as SchemaValidator).isSchema<\n            SchemaFunction<SV> | SchemaConstructor<SV> | IdiomaticSchema<SV>\n          >(value) &&\n          isConstructor(value)\n        ) {\n          if (!(this.dependenciesDefinition[key].value instanceof value)) {\n            const expected = value.name;\n            const receivedValue: unknown =\n              this.dependenciesDefinition[key].value;\n            const received = isConstructed(receivedValue)\n              ? receivedValue.constructor.name\n              : typeof receivedValue;\n\n            if (acc.ok) {\n              acc = {\n                ok: false,\n                errors: []\n              };\n            }\n            acc.errors?.push({\n              message: `Expected ${expected}, received ${received}`,\n              path: [key]\n            });\n          } else {\n            if (acc.ok) {\n              acc = {\n                ok: true,\n                value: {\n                  ...acc.value,\n                  [key]: this.dependenciesDefinition[key].value\n                }\n              };\n            }\n          }\n          return acc;\n        }\n        return acc;\n      },\n      {\n        ok: true,\n        value: {} as ResolvedConfigValidator<SV, CV>\n      }\n    );\n\n    const singletons = Object.fromEntries(\n      Object.entries(this.configShapes).filter(\n        ([key, value]) =>\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          (this.schemaValidator as SchemaValidator).isSchema(value)\n      )\n    );\n    const schemaSingletonParseResult = (\n      this.schemaValidator as SchemaValidator\n    ).parse(\n      (this.schemaValidator as SchemaValidator).schemify(singletons),\n      Object.fromEntries(\n        Object.keys(singletons).map((key) => {\n          const dependency = this.dependenciesDefinition[key];\n          return [\n            key,\n            dependency.lifetime === Lifetime.Singleton\n              ? dependency.value\n              : undefined\n          ];\n        })\n      )\n    );\n\n    const configKeys = Object.keys(this.configShapes);\n\n    return validNonSchemaSingletons.ok && schemaSingletonParseResult.ok\n      ? {\n          ok: true as const,\n          value: new ValidConfigInjector<SV, CV>(\n            this.schemaValidator,\n            this.configShapes,\n            this.dependenciesDefinition\n          )\n        }\n      : {\n          ok: false as const,\n          errors: [\n            ...(!validNonSchemaSingletons.ok && validNonSchemaSingletons.errors\n              ? validNonSchemaSingletons.errors\n              : []),\n            ...(!schemaSingletonParseResult.ok &&\n            schemaSingletonParseResult.errors\n              ? schemaSingletonParseResult.errors\n              : [])\n          ].sort(\n            (a, b) =>\n              configKeys.indexOf(a.path[0]) - configKeys.indexOf(b.path[0])\n          )\n        };\n  }\n\n  validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV> {\n    const safeValidateResult = this.safeValidateConfigSingletons();\n\n    if (safeValidateResult.ok) {\n      return safeValidateResult.value;\n    }\n\n    throw new Error(\n      prettyPrintParseErrors(safeValidateResult.errors, configName)\n    );\n  }\n\n  resolve<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const instance = this.instances[token];\n    if (!instance) {\n      const definition = this.dependenciesDefinition[token];\n\n      if (!definition) {\n        throw new Error(`Unable to resolve dependency ${String(token)}`);\n      }\n\n      switch (definition.lifetime) {\n        case Lifetime.Singleton: {\n          return definition.value;\n        }\n        case Lifetime.Scoped: {\n          const scopedInstance = this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n          this.instances[token] = scopedInstance;\n          return scopedInstance;\n        }\n        case Lifetime.Transient: {\n          return this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n        }\n        default: {\n          isNever(definition);\n          throw new Error(\n            `Unable to resolve lifetime for dependency ${String(\n              token\n            )}, ${resolutionPath}`\n          );\n        }\n      }\n    } else {\n      return instance;\n    }\n  }\n\n  scopedResolver<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[T] {\n    return (scope) =>\n      (scope ?? this.createScope()).resolve<T>(token, context, resolutionPath);\n  }\n\n  createScope(): ConfigInjector<SV, CV> {\n    return new ConfigInjector<SV, CV>(\n      this.schemaValidator,\n      this.configShapes,\n      this.dependenciesDefinition\n    );\n  }\n\n  dispose(): void {\n    this.instances = {};\n    this.loadSingletons();\n  }\n}\n\nexport class ValidConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> extends ConfigInjector<SV, CV> {\n  validConfigInjector!: void;\n}\n","import { Constructed } from '../types/configInjector.types';\n\nexport function isConstructed(\n  value: unknown\n): value is Constructed<unknown, unknown> {\n  return (\n    typeof value === 'object' &&\n    value != null &&\n    'constructor' in value &&\n    value.constructor != null\n  );\n}\n","import { Constructor } from '../types/configInjector.types';\n\nexport function isConstructor(value: unknown): value is Constructor {\n  return (\n    typeof value === 'function' &&\n    value.constructor != null &&\n    value.prototype != null\n  );\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  Schema\n} from '@forklaunch/validator';\nimport { ConfigInjector } from '../configInjector';\n\nexport enum Lifetime {\n  Singleton,\n  Transient,\n  Scoped\n}\n\nexport type Singleton<Value> = {\n  lifetime: Lifetime.Singleton;\n  value: Value;\n};\n\nexport type Constructed<Args, Return> = {\n  lifetime: Lifetime.Transient | Lifetime.Scoped;\n  factory: (\n    args: Args,\n    resolve: <T extends keyof Args>(\n      token: T,\n      context?: Record<string, unknown>\n    ) => Args[T],\n    context: Record<string, unknown>\n  ) => Return;\n};\n\nexport type Constructor = new (...args: never[]) => unknown;\nexport type SchemaConstructor<SV extends AnySchemaValidator> = new (\n  ...args: unknown[]\n) => IdiomaticSchema<SV>;\nexport type Function = (...args: never[]) => unknown;\nexport type SchemaFunction<SV extends AnySchemaValidator> = (\n  args: unknown\n) => IdiomaticSchema<SV>;\n\nexport type ConfigValidator<SV extends AnySchemaValidator> = Record<\n  string,\n  | Function\n  | SchemaFunction<SV>\n  | Constructor\n  | SchemaConstructor<SV>\n  | IdiomaticSchema<SV>\n>;\n\nexport type ResolvedConfigValidator<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> = {\n  [M in keyof CV]: CV[M] extends SchemaConstructor<SV>\n    ? Schema<InstanceType<CV[M]>, SV>\n    : CV[M] extends SchemaFunction<SV>\n      ? Schema<ReturnType<CV[M]>, SV>\n      : CV[M] extends Function\n        ? ReturnType<CV[M]>\n        : CV[M] extends Constructor\n          ? InstanceType<CV[M]>\n          : Schema<CV[M], SV>;\n};\n\nexport type ScopedDependencyFactory<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>,\n  M extends keyof CV\n> = (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[M];\n","// This is a simple function that returns the value of an environment variable.\n// It casts a potentially undefined value to a string, since it will be validated in order to be bootstrapped.\n\nexport function getEnvVar(name: string): string {\n  const value = process.env[name];\n  return value as string;\n}\n"],"mappings":"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","names":["Lifetime"]}
+{"version":3,"sources":["../../src/services/configInjector.ts","../../src/services/guards/isConstructed.ts","../../src/services/types/configInjector.types.ts","../../src/services/guards/isConstructedSingleton.ts","../../src/services/guards/isConstructor.ts","../../src/services/getEnvVar.ts"],"sourcesContent":["import { extractArgumentNames, isNever } from '@forklaunch/common';\nimport {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  ParseResult,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { isConstructed } from './guards/isConstructed';\nimport { isConstructedSingleton } from './guards/isConstructedSingleton';\nimport { isConstructor } from './guards/isConstructor';\nimport {\n  ConfigValidator,\n  Constructed,\n  ConstructedSingleton,\n  Lifetime,\n  ResolvedConfigValidator,\n  SchemaConstructor,\n  SchemaFunction,\n  Singleton\n} from './types/configInjector.types';\n\nexport class ConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> {\n  instances: {\n    [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n  } = {};\n\n  private loadSingletons(inheritedScopeInstances?: {\n    [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n  }): void {\n    for (const token in this.dependenciesDefinition) {\n      const definition = this.dependenciesDefinition[token];\n      if (definition.lifetime === Lifetime.Singleton) {\n        if (inheritedScopeInstances && inheritedScopeInstances[token]) {\n          this.instances[token] = inheritedScopeInstances[token];\n        } else if (\n          isConstructedSingleton<\n            Omit<ResolvedConfigValidator<SV, CV>, typeof token>,\n            ResolvedConfigValidator<SV, CV>[typeof token]\n          >(definition)\n        ) {\n          this.instances[token] = this.resolveInstance<typeof token>(\n            token,\n            definition\n          );\n        } else {\n          this.instances[token] = definition.value;\n        }\n      }\n    }\n  }\n\n  private resolveInstance<T extends keyof CV>(\n    token: T,\n    definition:\n      | ConstructedSingleton<\n          Omit<ResolvedConfigValidator<SV, CV>, T>,\n          ResolvedConfigValidator<SV, CV>[T]\n        >\n      | Constructed<\n          Omit<ResolvedConfigValidator<SV, CV>, T>,\n          ResolvedConfigValidator<SV, CV>[T]\n        >,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const injectorArgument = extractArgumentNames(definition.factory)[0];\n    // short circuit as no args\n    if (injectorArgument === '_args') {\n      return definition.factory(\n        {} as Omit<ResolvedConfigValidator<SV, CV>, T>,\n        this.resolve.bind(this),\n        context ?? ({} as Record<string, unknown>)\n      );\n    }\n\n    if (!injectorArgument.startsWith('{') || !injectorArgument.endsWith('}')) {\n      throw new Error(\n        `Invalid injector argument for ${String(\n          token\n        )}: ${injectorArgument}. Please use object destructuring syntax: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment.`\n      );\n    }\n    const resolvedArguments = Object.fromEntries(\n      injectorArgument\n        .replace('{', '')\n        .replace('}', '')\n        .split(',')\n        .map((arg) => arg.split(':')[0].trim())\n        .map((arg) => {\n          const newResolutionPath = [...resolutionPath, token];\n          if (resolutionPath.includes(arg)) {\n            throw new Error(\n              `Circular dependency detected: ${newResolutionPath.join(\n                ' -> '\n              )} -> ${arg}`\n            );\n          }\n          const resolvedArg = this.resolve(arg, context, newResolutionPath);\n          return [arg, resolvedArg];\n        })\n    ) as unknown as Omit<ResolvedConfigValidator<SV, CV>, T>;\n    return definition.factory(\n      resolvedArguments,\n      this.resolve.bind(this),\n      context ?? ({} as Record<string, unknown>)\n    );\n  }\n\n  constructor(\n    private schemaValidator: SV,\n    private configShapes: CV,\n    private dependenciesDefinition: {\n      [K in keyof CV]:\n        | Singleton<\n            Omit<ResolvedConfigValidator<SV, CV>, K>,\n            ResolvedConfigValidator<SV, CV>[K]\n          >\n        | Constructed<\n            Omit<ResolvedConfigValidator<SV, CV>, K>,\n            ResolvedConfigValidator<SV, CV>[K]\n          >;\n    },\n    inheritedScopeInstances?: {\n      [K in keyof CV]?: ResolvedConfigValidator<SV, CV>[K];\n    }\n  ) {\n    this.loadSingletons(inheritedScopeInstances);\n  }\n\n  safeValidateConfigSingletons(): ParseResult<ValidConfigInjector<SV, CV>> {\n    const validNonSchemaSingletons = Object.entries(this.configShapes).reduce<\n      ParseResult<ResolvedConfigValidator<SV, CV>>\n    >(\n      (acc, [key, value]) => {\n        if (\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          !(this.schemaValidator as SchemaValidator).isSchema<\n            SchemaFunction<SV> | SchemaConstructor<SV> | IdiomaticSchema<SV>\n          >(value) &&\n          isConstructor(value)\n        ) {\n          if (!(this.instances[key] instanceof value)) {\n            const expected = value.name;\n            const receivedValue: unknown = this.instances[key];\n            const received = isConstructed(receivedValue)\n              ? receivedValue.constructor.name\n              : typeof receivedValue;\n\n            if (acc.ok) {\n              acc = {\n                ok: false,\n                errors: []\n              };\n            }\n            acc.errors?.push({\n              message: `Expected ${expected}, received ${received}`,\n              path: [key]\n            });\n          } else {\n            if (acc.ok) {\n              acc = {\n                ok: true,\n                value: {\n                  ...acc.value,\n                  [key]: this.instances[key]\n                }\n              };\n            }\n          }\n          return acc;\n        }\n        return acc;\n      },\n      {\n        ok: true,\n        value: {} as ResolvedConfigValidator<SV, CV>\n      }\n    );\n\n    const singletons = Object.fromEntries(\n      Object.entries(this.configShapes).filter(\n        ([key, value]) =>\n          this.dependenciesDefinition[key].lifetime === Lifetime.Singleton &&\n          (this.schemaValidator as SchemaValidator).isSchema(value)\n      )\n    );\n    const schemaSingletonParseResult = (\n      this.schemaValidator as SchemaValidator\n    ).parse(\n      (this.schemaValidator as SchemaValidator).schemify(singletons),\n      Object.fromEntries(\n        Object.keys(singletons).map((key) => {\n          const dependency = this.dependenciesDefinition[key];\n          return [\n            key,\n            dependency.lifetime === Lifetime.Singleton\n              ? this.instances[key]\n              : undefined\n          ];\n        })\n      )\n    );\n\n    const configKeys = Object.keys(this.configShapes);\n\n    return validNonSchemaSingletons.ok && schemaSingletonParseResult.ok\n      ? {\n          ok: true as const,\n          value: new ValidConfigInjector<SV, CV>(\n            this.schemaValidator,\n            this.configShapes,\n            this.dependenciesDefinition,\n            this.instances\n          )\n        }\n      : {\n          ok: false as const,\n          errors: [\n            ...(!validNonSchemaSingletons.ok && validNonSchemaSingletons.errors\n              ? validNonSchemaSingletons.errors\n              : []),\n            ...(!schemaSingletonParseResult.ok &&\n            schemaSingletonParseResult.errors\n              ? schemaSingletonParseResult.errors\n              : [])\n          ].sort(\n            (a, b) =>\n              configKeys.indexOf(a.path[0]) - configKeys.indexOf(b.path[0])\n          )\n        };\n  }\n\n  validateConfigSingletons(configName: string): ValidConfigInjector<SV, CV> {\n    const safeValidateResult = this.safeValidateConfigSingletons();\n\n    if (safeValidateResult.ok) {\n      return safeValidateResult.value;\n    }\n\n    throw new Error(\n      prettyPrintParseErrors(safeValidateResult.errors, configName)\n    );\n  }\n\n  resolve<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): ResolvedConfigValidator<SV, CV>[T] {\n    const instance = this.instances[token];\n    if (!instance) {\n      const definition = this.dependenciesDefinition[token];\n\n      if (!definition) {\n        throw new Error(`Unable to resolve dependency ${String(token)}`);\n      }\n\n      switch (definition.lifetime) {\n        case Lifetime.Singleton: {\n          // return definition.value;\n          return this.instances[token] as ResolvedConfigValidator<SV, CV>[T];\n        }\n        case Lifetime.Scoped: {\n          const scopedInstance = this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n          this.instances[token] = scopedInstance;\n          return scopedInstance;\n        }\n        case Lifetime.Transient: {\n          return this.resolveInstance<T>(\n            token,\n            definition,\n            context,\n            resolutionPath\n          );\n        }\n        default: {\n          isNever(definition);\n          throw new Error(\n            `Unable to resolve lifetime for dependency ${String(\n              token\n            )}, ${resolutionPath}`\n          );\n        }\n      }\n    } else {\n      return instance;\n    }\n  }\n\n  scopedResolver<T extends keyof CV>(\n    token: T,\n    context?: Record<string, unknown>,\n    resolutionPath: (keyof CV)[] = []\n  ): (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[T] {\n    return (scope) =>\n      (scope ?? this.createScope()).resolve<T>(token, context, resolutionPath);\n  }\n\n  createScope(): ConfigInjector<SV, CV> {\n    return new ConfigInjector<SV, CV>(\n      this.schemaValidator,\n      this.configShapes,\n      this.dependenciesDefinition,\n      this.instances\n    );\n  }\n\n  dispose(): void {\n    this.instances = {};\n    this.loadSingletons();\n  }\n}\n\nexport class ValidConfigInjector<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> extends ConfigInjector<SV, CV> {\n  validConfigInjector!: void;\n}\n","import { Constructed } from '../types/configInjector.types';\n\nexport function isConstructed(\n  value: unknown\n): value is Constructed<unknown, unknown> {\n  return (\n    typeof value === 'object' &&\n    value != null &&\n    'constructor' in value &&\n    value.constructor != null\n  );\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  Schema\n} from '@forklaunch/validator';\nimport { ConfigInjector } from '../configInjector';\n\nexport enum Lifetime {\n  Singleton,\n  Transient,\n  Scoped\n}\n\nexport type Singleton<Args, Value> =\n  | {\n      lifetime: Lifetime.Singleton;\n      value: Value;\n    }\n  | ConstructedSingleton<Args, Value>;\n\nexport type ConstructedSingleton<Args, Return> = {\n  lifetime: Lifetime.Singleton;\n  factory: (\n    args: Args,\n    resolve: <T extends keyof Args>(\n      token: T,\n      context?: Record<string, unknown>\n    ) => Args[T],\n    context: Record<string, unknown>\n  ) => Return;\n};\n\nexport type Constructed<Args, Return> = {\n  lifetime: Lifetime.Transient | Lifetime.Scoped;\n  factory: (\n    args: Args,\n    resolve: <T extends keyof Args>(\n      token: T,\n      context?: Record<string, unknown>\n    ) => Args[T],\n    context: Record<string, unknown>\n  ) => Return;\n};\n\nexport type Constructor = new (...args: never[]) => unknown;\nexport type SchemaConstructor<SV extends AnySchemaValidator> = new (\n  ...args: unknown[]\n) => IdiomaticSchema<SV>;\nexport type Function = (...args: never[]) => unknown;\nexport type SchemaFunction<SV extends AnySchemaValidator> = (\n  args: unknown\n) => IdiomaticSchema<SV>;\n\nexport type ConfigValidator<SV extends AnySchemaValidator> = Record<\n  string,\n  | Function\n  | SchemaFunction<SV>\n  | Constructor\n  | SchemaConstructor<SV>\n  | IdiomaticSchema<SV>\n>;\n\nexport type ResolvedConfigValidator<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>\n> = {\n  [M in keyof CV]: CV[M] extends SchemaConstructor<SV>\n    ? Schema<InstanceType<CV[M]>, SV>\n    : CV[M] extends SchemaFunction<SV>\n      ? Schema<ReturnType<CV[M]>, SV>\n      : CV[M] extends Function\n        ? ReturnType<CV[M]>\n        : CV[M] extends Constructor\n          ? InstanceType<CV[M]>\n          : Schema<CV[M], SV>;\n};\n\nexport type ScopedDependencyFactory<\n  SV extends AnySchemaValidator,\n  CV extends ConfigValidator<SV>,\n  M extends keyof CV\n> = (scope?: ConfigInjector<SV, CV>) => ResolvedConfigValidator<SV, CV>[M];\n","import { ConstructedSingleton, Lifetime } from '../types/configInjector.types';\n\nexport function isConstructedSingleton<Args, Return>(\n  value: unknown\n): value is ConstructedSingleton<Args, Return> {\n  return (\n    typeof value === 'object' &&\n    value != null &&\n    'lifetime' in value &&\n    value.lifetime === Lifetime.Singleton &&\n    'factory' in value\n  );\n}\n","import { Constructor } from '../types/configInjector.types';\n\nexport function isConstructor(value: unknown): value is Constructor {\n  return (\n    typeof value === 'function' &&\n    value.constructor != null &&\n    value.prototype != null\n  );\n}\n","// This is a simple function that returns the value of an environment variable.\n// It casts a potentially undefined value to a string, since it will be validated in order to be bootstrapped.\n\nexport function getEnvVar(name: string): string {\n  const value = process.env[name];\n  return value as string;\n}\n"],"mappings":"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","names":["Lifetime"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/core",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "forklaunch-js core package. Contains useful building blocks.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {