@congruent-stack/congruent-api 0.11.3 → 0.12.0

package/dist/index.cjs

@@ -73,6 +73,9 @@ class ApiContract {
   cloneInitDef() {
     return ApiContract._deepCloneInitDef(this.definition, []);
   }
+  createRegistry() {
+    throw new Error("Not adapted yet");
+  }
   static _deepCloneInitDef(definition, path) {
     const result = {};
     for (const key in definition) {
@@ -835,7 +838,9 @@ function clientParseRequestDefinitionField(definition, key, requestObject) {
 }
 
 class DIContainerBase {
+  /** @internal */
   _map = /* @__PURE__ */ new Map();
+  /** @internal */
   _singletonInstances = /* @__PURE__ */ new Map();
   createScope() {
     const proxy = new Proxy({

package/dist/index.d.cts

@@ -1,5 +1,28 @@
 import z, { z as z$1 } from 'zod';
 
+type StringLiteral<T extends string> = string extends T ? never : T;
+type CapitalizedStringLiteral<T extends string> = string extends T ? never : T extends `${Uppercase<infer F>}${infer _}` ? F extends Lowercase<F> ? never : T : `❌ ERROR: Must start with uppercase letter`;
+type DILifetime = 'singleton' | 'transient' | 'scoped';
+type DIRegistryEntry<T> = {
+    factory: (scope: any) => T;
+    lifetime: DILifetime;
+};
+type DIRegistry = Record<string, DIRegistryEntry<any>>;
+type DIScope<R extends DIRegistry> = {
+    [K in keyof R as `get${string & K}`]: () => R[K] extends DIRegistryEntry<infer T> ? T : never;
+};
+declare class DIContainerBase<R extends DIRegistry> {
+    createScope(): DIScope<R>;
+}
+declare class DIContainer<R extends DIRegistry = {}> extends DIContainerBase<R> {
+    register<K extends string, T>(serviceNameCapitalizedLiteral: CapitalizedStringLiteral<K>, factory: (scope: DIScope<R>) => T, lifetime: DILifetime): DIContainer<R & Record<K, DIRegistryEntry<T>>>;
+    createTestClone(): DIContainerTestClone<R, this>;
+}
+declare class DIContainerTestClone<R extends DIRegistry, TDIContainer extends DIContainer<R>> extends DIContainerBase<R> {
+    constructor(original: TDIContainer);
+    override<K extends keyof R & string>(serviceNameLiteral: K, factory: (scope: DIScope<R>) => R[K] extends DIRegistryEntry<infer T> ? T : never): this;
+}
+
 declare enum HttpStatusCode {
     Continue_100 = 100,
     SwitchingProtocols_101 = 101,
@@ -64,20 +87,6 @@ declare class HttpMethodEndpoint<const TDef extends IHttpMethodEndpointDefinitio
     constructor(definition: TDef);
 }
 
-declare function apiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>>(definition: TDef): ApiContract<TDef>;
-interface IApiContractDefinition {
-    readonly [key: string]: IApiContractDefinition | HttpMethodEndpoint<any>;
-}
-type ValidateApiContractDefinition<T> = {
-    [K in keyof T]: T[K] extends HttpMethodEndpoint<infer TEndpDef> ? K extends HttpMethod ? HttpMethodEndpoint<TEndpDef> : "❌ ERROR: HttpMethodEndpoint only allowed on HttpMethod key" : K extends HttpMethod ? " ❌ ERROR: method key must hold an HttpMethodEndpoint" : T[K] extends object ? ValidateApiContractDefinition<T[K]> : T[K];
-};
-declare class ApiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>> {
-    readonly definition: TDef;
-    constructor(definition: TDef);
-    cloneInitDef(): TDef;
-    private static _deepCloneInitDef;
-}
-
 /**
  * Extracts typed path parameters from a path string.
  * For example, given a path string like ":p1:p2:...:pn", it will return an object type with properties for each parameter.
@@ -131,6 +140,11 @@ type HttpRequestObject = {
     body: object;
 };
 
+interface ICanTriggerAsync {
+    triggerNoStaticTypeCheck(diScope: DIScope<any>, requestObject: HttpRequestObject, context: any): Promise<any>;
+    get genericPath(): string;
+}
+
 type HttpMethodEndpointHandlerOutput<TEndpointDefinition extends IHttpMethodEndpointDefinition> = {
     [THttpStatusCode in keyof TEndpointDefinition['responses'] & HttpStatusCode]: TEndpointDefinition['responses'][THttpStatusCode] extends HttpMethodEndpointResponse<THttpStatusCode, infer TRespDef> ? CreateHandlerOutput<THttpStatusCode, TRespDef> : never;
 }[keyof TEndpointDefinition['responses'] & HttpStatusCode];
@@ -200,36 +214,6 @@ type DecoratorHandlerContext = {
 type HttpMethodEndpointHandler<TDef extends IHttpMethodEndpointDefinition, TPathParams extends string, TInjected> = (input: HttpMethodEndpointHandlerInput<TDef, TPathParams>, context: EndpointHandlerContext<TInjected>) => Promise<HttpMethodEndpointHandlerOutput<TDef>>;
 type ClientHttpMethodEndpointHandler = (input: ClientHttpMethodEndpointHandlerInput) => Promise<ClientHttpMethodEndpointHandlerOutput>;
 
-type StringLiteral<T extends string> = string extends T ? never : T;
-type CapitalizedStringLiteral<T extends string> = string extends T ? never : T extends `${Uppercase<infer F>}${infer _}` ? F extends Lowercase<F> ? never : T : `❌ ERROR: Must start with uppercase letter`;
-type DILifetime = 'singleton' | 'transient' | 'scoped';
-type DIRegistryEntry<T> = {
-    factory: (scope: any) => T;
-    lifetime: DILifetime;
-};
-type DIRegistry = Record<string, DIRegistryEntry<any>>;
-type DIScope<R extends DIRegistry> = {
-    [K in keyof R as `get${string & K}`]: () => R[K] extends DIRegistryEntry<infer T> ? T : never;
-};
-declare class DIContainerBase<R extends DIRegistry> {
-    protected _map: Map<string, DIRegistryEntry<any>>;
-    protected _singletonInstances: Map<string, any>;
-    createScope(): DIScope<R>;
-}
-declare class DIContainer<R extends DIRegistry = {}> extends DIContainerBase<R> {
-    register<K extends string, T>(serviceNameCapitalizedLiteral: CapitalizedStringLiteral<K>, factory: (scope: DIScope<R>) => T, lifetime: DILifetime): DIContainer<R & Record<K, DIRegistryEntry<T>>>;
-    createTestClone(): DIContainerTestClone<R, this>;
-}
-declare class DIContainerTestClone<R extends DIRegistry, TDIContainer extends DIContainer<R>> extends DIContainerBase<R> {
-    constructor(original: TDIContainer);
-    override<K extends keyof R & string>(serviceNameLiteral: K, factory: (scope: DIScope<R>) => R[K] extends DIRegistryEntry<infer T> ? T : never): this;
-}
-
-interface ICanTriggerAsync {
-    triggerNoStaticTypeCheck(diScope: DIScope<any>, requestObject: HttpRequestObject, context: any): Promise<any>;
-    get genericPath(): string;
-}
-
 type MiddlewareHandlerSchemas = {
     headers?: z$1.ZodType;
     query?: z$1.ZodType;
@@ -454,6 +438,21 @@ type ApiHandlersRegistryDef<ObjType extends object, TDIContainer extends DIConta
 type ApiHandlersRegistry<TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>, TDIContainer extends DIContainer, TPathParams extends string = ""> = Omit<ApiHandlersRegistryDef<InnerApiHandlersRegistry<TDef, TDIContainer> & TDef, TDIContainer, TPathParams>, '_middlewareRegistry'>;
 declare const ApiHandlersRegistry: new <TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>, TDIContainer extends DIContainer, TPathParams extends string = "">(dicontainer: TDIContainer, contract: ApiContract<TDef>, settings: IRegistrySettings<TDIContainer>) => ApiHandlersRegistry<TDef, TDIContainer, TPathParams>;
 
+declare function apiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>>(definition: TDef): ApiContract<TDef>;
+interface IApiContractDefinition {
+    readonly [key: string]: IApiContractDefinition | HttpMethodEndpoint<any>;
+}
+type ValidateApiContractDefinition<T> = {
+    [K in keyof T]: T[K] extends HttpMethodEndpoint<infer TEndpDef> ? K extends HttpMethod ? HttpMethodEndpoint<TEndpDef> : "❌ ERROR: HttpMethodEndpoint only allowed on HttpMethod key" : K extends HttpMethod ? " ❌ ERROR: method key must hold an HttpMethodEndpoint" : T[K] extends object ? ValidateApiContractDefinition<T[K]> : T[K];
+};
+declare class ApiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>> {
+    readonly definition: TDef;
+    constructor(definition: TDef);
+    cloneInitDef(): TDef;
+    createRegistry<TDIContainer extends DIContainer>(): ApiHandlersRegistry<TDef, TDIContainer>;
+    private static _deepCloneInitDef;
+}
+
 declare function partialPathString<TApiDef extends IApiContractDefinition & ValidateApiContractDefinition<TApiDef>, TPathParams extends string, const TPath extends PartialPath<TApiDef>>(_apiReg: ApiHandlersRegistry<TApiDef, any, TPathParams>, path: TPath): string;
 type PartialPath<TDef, BasePath extends string = ""> = (BasePath extends "" ? "" : never) | {
     [K in keyof TDef & string]: TDef[K] extends HttpMethodEndpoint<infer _TEndpointDef> ? never : TDef[K] extends object ? `${BasePath}/${K}` | PartialPath<TDef[K], `${BasePath}/${K}`> : never;

package/dist/index.d.mts

@@ -1,5 +1,28 @@
 import z, { z as z$1 } from 'zod';
 
+type StringLiteral<T extends string> = string extends T ? never : T;
+type CapitalizedStringLiteral<T extends string> = string extends T ? never : T extends `${Uppercase<infer F>}${infer _}` ? F extends Lowercase<F> ? never : T : `❌ ERROR: Must start with uppercase letter`;
+type DILifetime = 'singleton' | 'transient' | 'scoped';
+type DIRegistryEntry<T> = {
+    factory: (scope: any) => T;
+    lifetime: DILifetime;
+};
+type DIRegistry = Record<string, DIRegistryEntry<any>>;
+type DIScope<R extends DIRegistry> = {
+    [K in keyof R as `get${string & K}`]: () => R[K] extends DIRegistryEntry<infer T> ? T : never;
+};
+declare class DIContainerBase<R extends DIRegistry> {
+    createScope(): DIScope<R>;
+}
+declare class DIContainer<R extends DIRegistry = {}> extends DIContainerBase<R> {
+    register<K extends string, T>(serviceNameCapitalizedLiteral: CapitalizedStringLiteral<K>, factory: (scope: DIScope<R>) => T, lifetime: DILifetime): DIContainer<R & Record<K, DIRegistryEntry<T>>>;
+    createTestClone(): DIContainerTestClone<R, this>;
+}
+declare class DIContainerTestClone<R extends DIRegistry, TDIContainer extends DIContainer<R>> extends DIContainerBase<R> {
+    constructor(original: TDIContainer);
+    override<K extends keyof R & string>(serviceNameLiteral: K, factory: (scope: DIScope<R>) => R[K] extends DIRegistryEntry<infer T> ? T : never): this;
+}
+
 declare enum HttpStatusCode {
     Continue_100 = 100,
     SwitchingProtocols_101 = 101,
@@ -64,20 +87,6 @@ declare class HttpMethodEndpoint<const TDef extends IHttpMethodEndpointDefinitio
     constructor(definition: TDef);
 }
 
-declare function apiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>>(definition: TDef): ApiContract<TDef>;
-interface IApiContractDefinition {
-    readonly [key: string]: IApiContractDefinition | HttpMethodEndpoint<any>;
-}
-type ValidateApiContractDefinition<T> = {
-    [K in keyof T]: T[K] extends HttpMethodEndpoint<infer TEndpDef> ? K extends HttpMethod ? HttpMethodEndpoint<TEndpDef> : "❌ ERROR: HttpMethodEndpoint only allowed on HttpMethod key" : K extends HttpMethod ? " ❌ ERROR: method key must hold an HttpMethodEndpoint" : T[K] extends object ? ValidateApiContractDefinition<T[K]> : T[K];
-};
-declare class ApiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>> {
-    readonly definition: TDef;
-    constructor(definition: TDef);
-    cloneInitDef(): TDef;
-    private static _deepCloneInitDef;
-}
-
 /**
  * Extracts typed path parameters from a path string.
  * For example, given a path string like ":p1:p2:...:pn", it will return an object type with properties for each parameter.
@@ -131,6 +140,11 @@ type HttpRequestObject = {
     body: object;
 };
 
+interface ICanTriggerAsync {
+    triggerNoStaticTypeCheck(diScope: DIScope<any>, requestObject: HttpRequestObject, context: any): Promise<any>;
+    get genericPath(): string;
+}
+
 type HttpMethodEndpointHandlerOutput<TEndpointDefinition extends IHttpMethodEndpointDefinition> = {
     [THttpStatusCode in keyof TEndpointDefinition['responses'] & HttpStatusCode]: TEndpointDefinition['responses'][THttpStatusCode] extends HttpMethodEndpointResponse<THttpStatusCode, infer TRespDef> ? CreateHandlerOutput<THttpStatusCode, TRespDef> : never;
 }[keyof TEndpointDefinition['responses'] & HttpStatusCode];
@@ -200,36 +214,6 @@ type DecoratorHandlerContext = {
 type HttpMethodEndpointHandler<TDef extends IHttpMethodEndpointDefinition, TPathParams extends string, TInjected> = (input: HttpMethodEndpointHandlerInput<TDef, TPathParams>, context: EndpointHandlerContext<TInjected>) => Promise<HttpMethodEndpointHandlerOutput<TDef>>;
 type ClientHttpMethodEndpointHandler = (input: ClientHttpMethodEndpointHandlerInput) => Promise<ClientHttpMethodEndpointHandlerOutput>;
 
-type StringLiteral<T extends string> = string extends T ? never : T;
-type CapitalizedStringLiteral<T extends string> = string extends T ? never : T extends `${Uppercase<infer F>}${infer _}` ? F extends Lowercase<F> ? never : T : `❌ ERROR: Must start with uppercase letter`;
-type DILifetime = 'singleton' | 'transient' | 'scoped';
-type DIRegistryEntry<T> = {
-    factory: (scope: any) => T;
-    lifetime: DILifetime;
-};
-type DIRegistry = Record<string, DIRegistryEntry<any>>;
-type DIScope<R extends DIRegistry> = {
-    [K in keyof R as `get${string & K}`]: () => R[K] extends DIRegistryEntry<infer T> ? T : never;
-};
-declare class DIContainerBase<R extends DIRegistry> {
-    protected _map: Map<string, DIRegistryEntry<any>>;
-    protected _singletonInstances: Map<string, any>;
-    createScope(): DIScope<R>;
-}
-declare class DIContainer<R extends DIRegistry = {}> extends DIContainerBase<R> {
-    register<K extends string, T>(serviceNameCapitalizedLiteral: CapitalizedStringLiteral<K>, factory: (scope: DIScope<R>) => T, lifetime: DILifetime): DIContainer<R & Record<K, DIRegistryEntry<T>>>;
-    createTestClone(): DIContainerTestClone<R, this>;
-}
-declare class DIContainerTestClone<R extends DIRegistry, TDIContainer extends DIContainer<R>> extends DIContainerBase<R> {
-    constructor(original: TDIContainer);
-    override<K extends keyof R & string>(serviceNameLiteral: K, factory: (scope: DIScope<R>) => R[K] extends DIRegistryEntry<infer T> ? T : never): this;
-}
-
-interface ICanTriggerAsync {
-    triggerNoStaticTypeCheck(diScope: DIScope<any>, requestObject: HttpRequestObject, context: any): Promise<any>;
-    get genericPath(): string;
-}
-
 type MiddlewareHandlerSchemas = {
     headers?: z$1.ZodType;
     query?: z$1.ZodType;
@@ -454,6 +438,21 @@ type ApiHandlersRegistryDef<ObjType extends object, TDIContainer extends DIConta
 type ApiHandlersRegistry<TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>, TDIContainer extends DIContainer, TPathParams extends string = ""> = Omit<ApiHandlersRegistryDef<InnerApiHandlersRegistry<TDef, TDIContainer> & TDef, TDIContainer, TPathParams>, '_middlewareRegistry'>;
 declare const ApiHandlersRegistry: new <TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>, TDIContainer extends DIContainer, TPathParams extends string = "">(dicontainer: TDIContainer, contract: ApiContract<TDef>, settings: IRegistrySettings<TDIContainer>) => ApiHandlersRegistry<TDef, TDIContainer, TPathParams>;
 
+declare function apiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>>(definition: TDef): ApiContract<TDef>;
+interface IApiContractDefinition {
+    readonly [key: string]: IApiContractDefinition | HttpMethodEndpoint<any>;
+}
+type ValidateApiContractDefinition<T> = {
+    [K in keyof T]: T[K] extends HttpMethodEndpoint<infer TEndpDef> ? K extends HttpMethod ? HttpMethodEndpoint<TEndpDef> : "❌ ERROR: HttpMethodEndpoint only allowed on HttpMethod key" : K extends HttpMethod ? " ❌ ERROR: method key must hold an HttpMethodEndpoint" : T[K] extends object ? ValidateApiContractDefinition<T[K]> : T[K];
+};
+declare class ApiContract<const TDef extends IApiContractDefinition & ValidateApiContractDefinition<TDef>> {
+    readonly definition: TDef;
+    constructor(definition: TDef);
+    cloneInitDef(): TDef;
+    createRegistry<TDIContainer extends DIContainer>(): ApiHandlersRegistry<TDef, TDIContainer>;
+    private static _deepCloneInitDef;
+}
+
 declare function partialPathString<TApiDef extends IApiContractDefinition & ValidateApiContractDefinition<TApiDef>, TPathParams extends string, const TPath extends PartialPath<TApiDef>>(_apiReg: ApiHandlersRegistry<TApiDef, any, TPathParams>, path: TPath): string;
 type PartialPath<TDef, BasePath extends string = ""> = (BasePath extends "" ? "" : never) | {
     [K in keyof TDef & string]: TDef[K] extends HttpMethodEndpoint<infer _TEndpointDef> ? never : TDef[K] extends object ? `${BasePath}/${K}` | PartialPath<TDef[K], `${BasePath}/${K}`> : never;

package/dist/index.mjs

@@ -71,6 +71,9 @@ class ApiContract {
   cloneInitDef() {
     return ApiContract._deepCloneInitDef(this.definition, []);
   }
+  createRegistry() {
+    throw new Error("Not adapted yet");
+  }
   static _deepCloneInitDef(definition, path) {
     const result = {};
     for (const key in definition) {
@@ -833,7 +836,9 @@ function clientParseRequestDefinitionField(definition, key, requestObject) {
 }
 
 class DIContainerBase {
+  /** @internal */
   _map = /* @__PURE__ */ new Map();
+  /** @internal */
   _singletonInstances = /* @__PURE__ */ new Map();
   createScope() {
     const proxy = new Proxy({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@congruent-stack/congruent-api",
   "type": "module",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "description": "Typescript schema-first tooling for agnostic REST APIs.",
   "keywords": [],
   "author": "congruent-stack",