@feasibleone/blong 1.12.0 → 1.12.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.12.2](https://github.com/feasibleone/blong/compare/blong-v1.12.1...blong-v1.12.2) (2026-03-23)
+
+
+### Bug Fixes
+
+* types and remove duplicated code ([cb5eb2b](https://github.com/feasibleone/blong/commit/cb5eb2bc7898cee6256317667a39d95e05186316))
+
+## [1.12.1](https://github.com/feasibleone/blong/compare/blong-v1.12.0...blong-v1.12.1) (2026-03-15)
+
+
+### Bug Fixes
+
+* missing types.ts ([9903425](https://github.com/feasibleone/blong/commit/9903425a4f54e8f9c935b00b2e30e26ddcb11483))
+
 ## [1.12.0](https://github.com/feasibleone/blong/compare/blong-v1.11.0...blong-v1.12.0) (2026-03-15)
 
 

package/dist/types.d.ts

@@ -10,7 +10,7 @@ import { Duplex } from 'node:stream';
 import { Level, LogFn, Logger as PinoLogger } from 'pino';
 import { Readable, Writable } from 'stream';
 import { ConnectionOptions as ConnectionOptions_2, TLSSocket, TLSSocketOptions } from 'tls';
-import { Static, TArray, TBoolean, TFunction, TNever, TObject, TSchema, TString, Type } from 'typebox';
+import { Static, TArray, TBoolean, TFunction, TNever, TNumber, TObject, TSchema, TString, TUnknown, Type } from 'typebox';
 
 export type Method = "GET" | "POST" | "PUT" | "DELETE";
 export interface RequestArgs {
@@ -17625,16 +17625,16 @@ export type RemoteMethod = (...params: unknown[]) => Promise<unknown>;
 export interface IRemote {
 	remote: (methodName: string, options?: object) => RemoteMethod;
 	dispatch: (...params: unknown[]) => boolean | Promise<unknown>;
-	start: () => Promise<void>;
-	stop: () => Promise<void>;
+	start: () => Promise<IRemote>;
+	stop: () => Promise<IRemote>;
 }
 export interface IRpcServer {
 	register: (methods: object, namespace: string, reply: boolean, pkg: {
 		version: string;
 	}) => void;
 	unregister: (methods: string[], namespace: string, reply: boolean) => void;
-	start: () => Promise<void>;
-	stop: () => Promise<void>;
+	start: () => Promise<IRpcServer>;
+	stop: () => Promise<IRpcServer>;
 }
 export interface ILocal {
 	register: (methods: object, namespace: string, reply: boolean, pkg: {
@@ -17647,7 +17647,8 @@ export interface ILocal {
 }
 export interface IApiSchema {
 	schema(def: {
-		namespace: Record<string, string | string[]>;
+		namespace?: Record<string, string | string[]> | string[];
+		url?: string;
 	}, source: string): Promise<Record<string, GatewaySchema>>;
 	generateFile(file: string): Promise<boolean>;
 	generateDir(dir: string, files: Dirent[]): Promise<boolean>;
@@ -17657,8 +17658,8 @@ export interface IGateway {
 		name: string;
 		version: string;
 	}) => void;
-	start: () => Promise<void>;
-	stop: () => Promise<void>;
+	start: () => Promise<IGateway>;
+	stop: () => Promise<IGateway>;
 }
 export type Handlers = ((params: {
 	remote: unknown;
@@ -17669,9 +17670,9 @@ export type Handlers = ((params: {
 	gateway: IGateway;
 }) => void)[];
 export interface IRegistry {
-	start: () => Promise<void>;
+	start: (configOverride?: object) => Promise<IRegistry>;
 	test: (tester?: unknown) => Promise<void>;
-	stop: () => Promise<void>;
+	stop: () => Promise<IRegistry>;
 	ports: Map<string, IAdapterFactory>;
 	methods: Map<string, Handlers>;
 	modules: Map<string | symbol, IRegistry[]>;
@@ -17750,7 +17751,7 @@ export interface IAdapter<T, C> {
 	extends?: object | `adapter.${string}` | `orchestrator.${string}`;
 	activeConfig?: (this: ReturnType<IAdapterFactory<T, C>>) => Partial<Config<T, C>>;
 	init?: (this: ReturnType<IAdapterFactory<T, C>>, ...config: Partial<Config<T, C>>[]) => Promise<void>;
-	start?: (this: ReturnType<IAdapterFactory<T, C>>) => Promise<object>;
+	start?: (this: ReturnType<IAdapterFactory<T, C>>, configOverride: object) => Promise<object>;
 	ready?: (this: ReturnType<IAdapterFactory<T, C>>) => Promise<object>;
 	stop?: (this: ReturnType<IAdapterFactory<T, C>>) => Promise<object>;
 	connected?: (this: ReturnType<IAdapterFactory<T, C>>) => Promise<boolean>;
@@ -17824,7 +17825,7 @@ export interface IMeta {
 	httpRequest?: {
 		url: URL | string;
 		state?: object;
-		headers: Record<string, string>;
+		headers: Record<string, string | string[]>;
 	};
 	auth?: {
 		mlek?: object | "header";
@@ -17958,16 +17959,19 @@ export interface IStep {
 	method?: string;
 }
 export type Sequence = (boolean | string | IStep)[];
+export type ApiSchema = TObject | TArray | TBoolean | TString | TNumber | TUnknown;
 export type GatewaySchema = ({
-	params: TSchema;
-	result: TSchema;
+	params: ApiSchema;
+	result: ApiSchema;
 } | {
-	body: TSchema;
-	response: TSchema;
+	body: {
+		schema: ApiSchema;
+	};
+	response: ApiSchema;
 } | {
 	method: "GET" | "POST" | "PUT" | "DELETE";
 	path?: string;
-	response?: TSchema;
+	response?: ApiSchema;
 } | {
 	auth: false | "basic" | "login";
 } | {
@@ -18026,6 +18030,8 @@ export type ApiDefinition = (blong: IValidationProxy) => {
 	namespace: Record<string, string | (string | Partial<OpenAPI.Document & {
 		"x-blong-namespace": string;
 	}>)[]>;
+} | {
+	url: string;
 };
 export type PortHandler<T, C> = <R>(this: ReturnType<IAdapterFactory<T, C>>, params: {}, $meta: IMeta, context?: IContext) => Promise<R> | R;
 export type PortHandlerBound = <T>(params: {}, $meta: IMeta, context?: IContext) => Promise<T> | T;
@@ -18082,6 +18088,8 @@ export interface SolutionFactory<T extends TSchema = TNever> {
 		type: typeof Type;
 	}): IModuleConfig<T> | Promise<IModuleConfig<T>>;
 }
+declare const Kind: symbol;
+type Kind$1 = typeof Kind;
 export declare abstract class Internal {
 	#private;
 	protected log?: ReturnType<ILog["logger"]>;
@@ -18089,8 +18097,8 @@ export declare abstract class Internal {
 		log: ILog;
 	});
 	protected merge: ILib["merge"];
-	stop(): Promise<void>;
-	start(...params: unknown[]): Promise<void>;
+	stop(): Promise<unknown>;
+	start(...params: unknown[]): Promise<unknown>;
 }
 export declare const handler: <T = Record<string, unknown>, C = AdapterContext>(definition: Definition<T, C>) => Definition<T, C>;
 export declare const library: <T = Record<string, unknown>>(definition: Lib<T>) => Lib<T>;
@@ -18122,6 +18130,7 @@ declare const _default: {
 
 export {
 	Document$1 as Document,
+	Kind$1 as Kind,
 	_default as default,
 };
 

package/dist/types.js

@@ -13,8 +13,12 @@ export class Internal {
             this.log = this.#log.logger(result.logLevel, { name: this.constructor.name });
         return result;
     };
-    async stop() { }
-    async start(...params) { }
+    async stop() {
+        return this;
+    }
+    async start(...params) {
+        return this;
+    }
 }
 export const handler = (definition) => Object.defineProperty(definition, Kind, { value: 'handler' });
 export const library = (definition) => Object.defineProperty(definition, Kind, { value: 'lib' });

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAYA,OAAO,EACH,IAAI,GASP,MAAM,SAAS,CAAC;AAMjB,OAAO,KAAK,MAAM,mBAAmB,CAAC;AAqkBtC,MAAM,IAAI,GAAW,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAE9C,MAAM,OAAgB,QAAQ;IAC1B,IAAI,CAAQ;IACF,GAAG,CAA8B;IAC3C,YAAmB,GAAiB;QAChC,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC;IACzB,CAAC;IACS,KAAK,GAAkB,CAAC,GAAG,IAA+B,EAAE,EAAE;QACpE,MAAM,MAAM,GAAG,KAAK,CAAqB,GAAG,IAAI,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI;YAC5B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAC,CAAC,CAAC;QAChF,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IACK,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,KAAK,CAAC,GAAG,MAAiB,IAAkB,CAAC;CAC7D;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CACnB,UAA4B,EACZ,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,OAAO,GAAG,CAA8B,UAAkB,EAAU,EAAE,CAC/E,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAgC,EAAwB,EAAE,CACjF,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,YAAY,EAAC,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAkB,EAAiB,EAAE,CACrD,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAEH,QAAQ,CAAC,EAAE,CACnC,UAAU,CAAC,GAAG,EAAE,CACZ,MAAM,CAAC,WAAW,CACd,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;IAC9C,IAAI;IACJ,MAAM,CAAC,cAAc,CACjB,GAAG,EAAE,CAAC,CAAC;QACH,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC9C,WAAW,EAAE,aAAa,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC1E,CAAC,EACF,MAAM,EACN,EAAC,KAAK,EAAE,IAAI,EAAC,CAChB;CACJ,CAAC,CACL,CACJ,CAAC;AAEN,MAAM,CAAC,MAAM,KAAK,GAAG,CAAoB,UAA8B,EAAsB,EAAE,CAC3F,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,UAAU,EAAC,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAoB,UAA8B,EAAsB,EAAE,CAC5F,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,QAAQ,EAAC,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAoB,UAA8B,EAAsB,EAAE,CAC7F,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,KAAK,GAAG,CACjB,UAA4C,EACZ,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,EAAC,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,OAAO,GAAG,CACnB,UAAiC,EACZ,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,CACxB,UAAiC,EACZ,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,cAAc,EAAC,CAAC,CAAC;AAW7F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAiC,EAAqB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEzF,eAAe;IACX,OAAO;IACP,OAAO;IACP,UAAU;IACV,GAAG;IACH,KAAK;IACL,MAAM;IACN,OAAO;IACP,OAAO;IACP,YAAY;IACZ,IAAI;CACP,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feasibleone/blong",
-  "version": "1.12.0",
+  "version": "1.12.2",
   "description": "API and DRY focused RAD framework https://feasibleone.github.io/blong-docs",
   "keywords": [
     "blong",

package/types.ts

@@ -0,0 +1,713 @@
+// import type {S3Client} from '@aws-sdk/client-s3';
+import type KeycloakAdminClient from '@keycloak/keycloak-admin-client';
+// import {
+//     AppsV1Api,
+//     CoreV1Api,
+//     NetworkingV1Api,
+//     RbacAuthorizationV1Api,
+//     Watch,
+// } from '@kubernetes/client-node';
+import type {IncomingWebhook} from '@slack/webhook';
+import type {MongoClient} from 'mongodb';
+import type Assert from 'node:assert';
+import {
+    Type,
+    type Static,
+    type TArray,
+    type TBoolean,
+    type TFunction,
+    type TNever,
+    type TNumber,
+    type TObject,
+    type TSchema,
+    type TString,
+    type TUnknown,
+} from 'typebox';
+// import type {client} from 'node-vault';
+import type {Dirent} from 'node:fs';
+import type {Duplex} from 'node:stream';
+import type {OpenAPI, OpenAPIV2, OpenAPIV3_1} from 'openapi-types';
+import type {Level, LogFn, Logger as PinoLogger} from 'pino';
+import merge from 'ut-function.merge';
+import type {Knex} from './knex.js';
+
+// export {
+//     AppsV1Api,
+//     CoreV1Api,
+//     NetworkingV1Api,
+//     RbacAuthorizationV1Api,
+//     Watch,
+// } from '@kubernetes/client-node';
+export type * from '@slack/webhook';
+export type * from 'bson';
+export type * from 'mongodb';
+// export type {client} from 'node-vault';
+export type {IJsonSchema, OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1} from 'openapi-types';
+// export type {Level, LogFn, Logger as PinoLogger} from 'pino';
+export type {Knex} from './knex.js';
+
+export type ServerContext = {
+    queryBuilder?: Knex;
+    // coreV1Api?: CoreV1Api;
+    // appsV1Api?: AppsV1Api;
+    // networkingV1Api?: NetworkingV1Api;
+    // rbacV1Api?: RbacAuthorizationV1Api;
+    // watcher?: Watch;
+    kcAdminClient?: KeycloakAdminClient;
+    kafkaStream?: Duplex;
+    mongodb?: MongoClient;
+    // s3?: S3Client;
+    slack?: IncomingWebhook;
+    // vault?: client;
+};
+
+export type BrowserContext = {};
+
+export type AdapterContext = ServerContext & BrowserContext;
+
+export interface ILog {
+    logger: (level: Level, bindings: object) => ILogger;
+    child: PinoLogger['child'];
+}
+
+export interface IErrorFactory {
+    get(type?: string): unknown;
+    fetch(type: string): object;
+    define(
+        id: string,
+        superType: string | {type: string},
+        message: string,
+    ): (params?: unknown, $meta?: IMeta) => ITypedError;
+    register<T>(errorsMap: T): Record<keyof T, (params?: unknown, $meta?: IMeta) => ITypedError>;
+}
+
+export interface IError {
+    getError: IErrorFactory['get'];
+    fetchErrors: IErrorFactory['fetch'];
+    defineError: IErrorFactory['define'];
+    register: IErrorFactory['register'];
+}
+
+export type Config<T, C> = {
+    id: string;
+    type: string;
+    pkg: {
+        name: string;
+        version: string;
+    };
+    format?: {
+        sizeAdjust?: number;
+    };
+    context: C;
+    debug: boolean;
+    test: boolean;
+    disconnectOnError: boolean;
+    concurrency: number;
+    log: object;
+    maxReceiveBuffer: number;
+    logLevel: Parameters<ILog['logger']>[0];
+    namespace: string | string[];
+    imports: string | RegExp | (string | RegExp)[];
+} & T;
+
+export type RemoteMethod = (...params: unknown[]) => Promise<unknown>;
+export interface IRemote {
+    remote: (methodName: string, options?: object) => RemoteMethod;
+    dispatch: (...params: unknown[]) => boolean | Promise<unknown>;
+    start: () => Promise<IRemote>;
+    stop: () => Promise<IRemote>;
+}
+
+export interface IRpcServer {
+    register: (methods: object, namespace: string, reply: boolean, pkg: {version: string}) => void;
+    unregister: (methods: string[], namespace: string, reply: boolean) => void;
+    start: () => Promise<IRpcServer>;
+    stop: () => Promise<IRpcServer>;
+}
+
+export interface ILocal {
+    register: (methods: object, namespace: string, reply: boolean, pkg: {version: string}) => void;
+    unregister: (methods: string[], namespace: string) => void;
+    get: (name: string) => {method: (...params: unknown[]) => Promise<unknown[]>};
+}
+
+export interface IApiSchema {
+    schema(
+        def: {namespace?: Record<string, string | string[]> | string[]; url?: string},
+        source: string,
+    ): Promise<Record<string, GatewaySchema>>;
+    generateFile(file: string): Promise<boolean>;
+    generateDir(dir: string, files: Dirent[]): Promise<boolean>;
+}
+
+export interface IGateway {
+    route: (
+        validations: Record<string, GatewaySchema>,
+        pkg: {name: string; version: string},
+    ) => void;
+    start: () => Promise<IGateway>;
+    stop: () => Promise<IGateway>;
+}
+
+export type Handlers = ((params: {
+    remote: unknown;
+    lib: object;
+    port: object;
+    local: object;
+    literals: object[];
+    gateway: IGateway;
+}) => void)[];
+
+export interface IRegistry {
+    start: (configOverride?: object) => Promise<IRegistry>;
+    test: (tester?: unknown) => Promise<void>;
+    stop: () => Promise<IRegistry>;
+    ports: Map<string, IAdapterFactory>;
+    methods: Map<string, Handlers>;
+    modules: Map<string | symbol, IRegistry[]>;
+    createPort: (id: string) => Promise<ReturnType<IAdapterFactory>>;
+    replaceHandlers: (id: string, handlers: object) => Promise<void>;
+    loadApi: (
+        id: string,
+        def: {
+            namespace: Record<string, string | string[]>;
+        },
+        source?: string,
+    ) => Promise<void>;
+    connected: () => Promise<boolean>;
+}
+
+export interface IApi {
+    id?: string;
+    type: typeof Type;
+    adapter: (
+        id: string,
+    ) => (api: {
+        utError: IError;
+        remote: IRemote;
+        rpc: IRpcServer;
+        local: ILocal;
+        registry: IRegistry;
+    }) => object;
+    utError: IError;
+    errors: IErrorFactory;
+    gateway: unknown;
+    remote: IRemote;
+    rpc: IRpcServer;
+    local: ILocal;
+    registry: IRegistry;
+    utBus: {
+        config: object;
+        register: (methods: object, namespace: string, id: string, pkg: {version: string}) => void;
+        unregister: (methods: string[], namespace: string) => void;
+        subscribe: (methods: object, namespace: string, id: string, pkg: {version: string}) => void;
+        unsubscribe: (methods: string[], namespace: string) => void;
+        dispatch: (...params: unknown[]) => boolean | Promise<unknown>;
+        methodId: (name: string) => string;
+        getPath: (name: string) => string;
+        importMethod: (
+            methodName: string,
+            options?: object,
+        ) => (...params: unknown[]) => Promise<unknown>;
+        attachHandlers: (target: object, patterns: unknown, adapter?: boolean) => unknown;
+    };
+    utLog: {
+        createLog: ILog['logger'];
+    };
+    handlers?: (api: {utError: IError; remote: IRemote; type: typeof Type}) => {
+        extends?:
+            | string
+            | ((api: {
+                  utError: IError;
+                  remote: IRemote;
+                  rpc: IRpcServer;
+                  local: ILocal;
+                  registry: IRegistry;
+              }) => object);
+    };
+}
+
+export interface IErrorMap {
+    [name: string]:
+        | string
+        | {
+              message: string;
+              print?: string;
+              statusCode?: number;
+          };
+}
+
+export interface IAdapter<T, C> {
+    validation?: TSchema;
+    config?: Config<T, C>;
+    activation?: IActivationConfig<Partial<Config<T, C>>>;
+    configBase?: string;
+    log?: ILogger;
+    errors?: Errors<IErrorMap>;
+    imported?: ReturnType<IAdapterFactory<T, C>>;
+    extends?: object | `adapter.${string}` | `orchestrator.${string}`;
+    activeConfig?: (this: ReturnType<IAdapterFactory<T, C>>) => Partial<Config<T, C>>;
+    init?: (
+        this: ReturnType<IAdapterFactory<T, C>>,
+        ...config: Partial<Config<T, C>>[]
+    ) => Promise<void>;
+    start?: (this: ReturnType<IAdapterFactory<T, C>>, configOverride: object) => Promise<object>;
+    ready?: (this: ReturnType<IAdapterFactory<T, C>>) => Promise<object>;
+    stop?: (this: ReturnType<IAdapterFactory<T, C>>) => Promise<object>;
+    connected?: (this: ReturnType<IAdapterFactory<T, C>>) => Promise<boolean>;
+    error?: (error: Error, $meta: IMeta) => void;
+    pack?: (
+        this: ReturnType<IAdapterFactory<T, C>>,
+        packet: {size: number; data: Buffer},
+    ) => Buffer;
+    unpackSize?: (
+        this: ReturnType<IAdapterFactory<T, C>>,
+        buffer: Buffer,
+    ) => {size: number; data: Buffer};
+    unpack?: (
+        this: ReturnType<IAdapterFactory<T, C>>,
+        buffer: Buffer,
+        options?: {size: number},
+    ) => Buffer;
+    encode?: (data: unknown, $meta: IMeta, context: object, log: ILogger) => string | Buffer;
+    decode?: (buff: string | Buffer, $meta: IMeta, context: object, log: ILogger) => object[];
+    request?: () => Promise<unknown>;
+    publish?: () => Promise<unknown>;
+    drain?: () => void;
+    findValidation?: (this: ReturnType<IAdapterFactory<T, C>>, $meta: IMeta) => () => object;
+    getConversion?: (
+        this: ReturnType<IAdapterFactory<T, C>>,
+        $meta: IMeta,
+        type: 'send' | 'receive',
+    ) => {name: string; fn: () => object};
+    findHandler?: (this: ReturnType<IAdapterFactory<T, C>>, name: string) => () => unknown;
+    handles?: (this: ReturnType<IAdapterFactory<T, C>>, name: string) => boolean;
+    forNamespaces?: <T>(reducer: (prev: T, current: unknown) => T, initial: T) => T;
+    methodPath?: (name: string) => string;
+    dispatch?: (...params: unknown[]) => Promise<unknown>;
+    exec?: (this: ReturnType<IAdapterFactory<T, C>>, ...params: unknown[]) => Promise<unknown>;
+    bytesSent?: (count: number) => void;
+    bytesReceived?: (count: number) => void;
+    msgSent?: (count: number) => void;
+    msgReceived?: (count: number) => void;
+    isConnected?: Promise<boolean>;
+    event?: (name: string, params?: unknown) => Promise<object>;
+    handle?: (...params: unknown[]) => Promise<unknown>;
+    connect?: (
+        what: unknown,
+        context: {requests: unknown; waiting: unknown; buffer: unknown},
+    ) => void;
+}
+
+export interface IAdapterFactory<T = Record<string, unknown>, C = Record<string, unknown>> {
+    config?: Config<T, C> | false;
+    (api: IApi): IAdapter<T, C>;
+}
+
+export interface IMeta {
+    mtid?: 'request' | 'response' | 'error' | 'notification' | 'discard' | 'event';
+    request?: IMeta;
+    stream?: unknown;
+    headers?: object;
+    trace?: string;
+    retry?: number;
+    method?: string;
+    expect?: string[] | string;
+    opcode?: string;
+    source?: string;
+    forward?: object;
+    httpResponse?: {
+        type?: string;
+        redirect?: string;
+        code?: number;
+        state?: unknown[];
+        header?: string[] | [string, unknown][];
+    };
+    httpRequest?: {
+        url: URL | string;
+        state?: object;
+        headers: Record<string, string | string[]>;
+    };
+    auth?: {
+        mlek?: object | 'header';
+        mlsk?: object | 'header';
+        permissionMap?: Buffer;
+        actorId?: string | number;
+        sessionId?: string;
+    };
+    language?: {
+        languageId?: string | number;
+    };
+    cache?: {
+        port: string;
+        optional: boolean;
+        instead: boolean;
+        before: boolean;
+        key: unknown;
+        ttl: number;
+        after: boolean;
+    };
+    errorCode?: string;
+    errorMessage?: string;
+    hostName?: string | string[];
+    ipAddress?: string;
+    machineName?: string;
+    os?: string;
+    version?: string;
+    serviceName?: string;
+    frontEnd?: string;
+    localAddress?: string;
+    localPort?: number;
+    deviceId?: string | string[];
+    latitude?: string | string[];
+    longitude?: string | string[];
+    conId?: number;
+    dispatch?: (
+        msg?: object,
+        $meta?: IMeta,
+    ) => [msg: object, $meta: IMeta] | boolean | void | Promise<boolean>;
+    reply?: unknown;
+    timeout?: number;
+    timer?: (
+        name?: string,
+        newTime?: HRTime | false,
+    ) => {
+        [name: string]: number;
+    };
+    gateway?: object;
+    validation?: unknown;
+}
+
+export type HRTime = [number, number];
+
+export interface IContext {
+    trace: number;
+    session?: {
+        [name: string]: unknown;
+    };
+    conId?: string;
+    requests: Map<
+        string,
+        {$meta: IMeta; end: (error: Error) => {local: object; literals: object[]}}
+    >;
+    waiting: Set<(error: Error) => void>;
+}
+
+export interface ITypedError extends Error {
+    type: string;
+    cause?: Error;
+    print?: string;
+    method?: string | string[];
+    params?: object;
+    code?: string;
+    req?: {
+        httpVersion: string;
+        url: URL;
+        method: string;
+    };
+    res?: {
+        httpVersion: string;
+        statusCode: number;
+    };
+}
+
+export type Errors<T> = {
+    [name in keyof T]: (params?: unknown, $meta?: IMeta) => ITypedError;
+};
+
+export interface IBaseConfig extends TObject<{
+    watch: TObject<{
+        test: TArray<TString>;
+    }>;
+    remote: TObject<{
+        canSkipSocket: TBoolean;
+    }>;
+    adapter: TBoolean;
+    orchestrator: TBoolean;
+    test: TBoolean;
+    error: TBoolean;
+    gateway: TBoolean | TObject;
+    sim: TBoolean;
+    resolution: TBoolean;
+}> {
+    additionalProperties: false;
+}
+export interface IActivationConfig<T> {
+    default: T;
+    integration?: T;
+    deployment?: T;
+    microservice?: T;
+    dev?: T;
+}
+
+export interface IModuleConfig<T extends TSchema = TNever> {
+    pkg?: {
+        name: string;
+        version: string;
+    };
+    url: string;
+    config?: IActivationConfig<Partial<Static<T>> & Partial<Static<IBaseConfig>>>;
+    validation?: T;
+    children?: (string | (() => Promise<object>))[] | ((layer: ModuleApi) => unknown)[];
+}
+
+export interface ILogger {
+    trace?: LogFn;
+    debug?: LogFn;
+    info?: LogFn;
+    warn?: LogFn;
+    error?: LogFn;
+    fatal?: LogFn;
+}
+
+export interface IStep {
+    name: string;
+    method?: string;
+}
+export type Sequence = (boolean | string | IStep)[];
+
+export type ApiSchema = TObject | TArray | TBoolean | TString | TNumber | TUnknown;
+
+export type GatewaySchema = (
+    | {
+          params: ApiSchema;
+          result: ApiSchema;
+      }
+    | {
+          body: {
+              schema: ApiSchema;
+          };
+          response: ApiSchema;
+      }
+    | {
+          method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+          path?: string;
+          response?: ApiSchema;
+      }
+    | {
+          auth: false | 'basic' | 'login';
+      }
+    | {
+          namespace: Record<string, string | string[]>;
+      }
+) & {
+    auth?: false | 'basic' | 'login';
+    rpc?: boolean;
+    description?: string;
+    summary?: string;
+    security?: true;
+    basePath?: string;
+    subject?: string;
+    destination?: string;
+    operation?: OpenAPIV3_1.OperationObject | OpenAPIV2.OperationObject;
+};
+
+export type SchemaObject = OpenAPIV3_1.SchemaObject | OpenAPIV2.SchemaObject;
+export type PathItemObject = OpenAPIV3_1.PathItemObject | OpenAPIV2.PathItemObject;
+export type ThenableProxy = Promise<unknown> & {[key: string]: ThenableProxy};
+export type ChainStep =
+    | ((
+          assert: typeof Assert,
+          context: {
+              $meta: IMeta;
+          } & Record<string, Promise<unknown[]> & ThenableProxy>,
+      ) => Promise<object>)
+    | object;
+
+export interface ILib {
+    type: typeof Type;
+    error: <T>(errors: T) => Record<keyof T, (params?: unknown, $meta?: IMeta) => ITypedError>;
+    rename: <T extends object>(object: T, name: string) => T & {name: string};
+    group: (name: string) => (handlers: ChainStep[]) => ChainStep[] & {name: string};
+    ulid: () => string;
+    uuid4: () => string;
+    uuid7: () => string;
+    merge<T, S1>(target: T, source: S1): T & S1;
+    merge<T, S1, S2>(target: T, source1: S1, source2: S2): T & S1 & S2;
+    merge<T, S1, S2, S3>(target: T, source1: S1, source2: S2, source3: S3): T & S1 & S2 & S3;
+    merge<T>(...args: unknown[]): T;
+}
+
+export type ValidationFn = () => GatewaySchema;
+export interface IValidationProxy {
+    type: typeof Type;
+    handler: {
+        [name: string]: ValidationFn;
+    };
+    lib: ILib & {
+        [name: string]: TSchema;
+    };
+    error: {
+        [name: string]: (...params: unknown[]) => ITypedError;
+    };
+}
+export type ValidationDefinition = (
+    blong: IValidationProxy,
+) => Record<string, ValidationFn | TSchema> | ValidationFn | ValidationFn[];
+
+export type ApiDefinition = (blong: IValidationProxy) =>
+    | {
+          namespace:
+              | string[]
+              | Record<
+                    string,
+                    string | (string | Partial<OpenAPI.Document & {'x-blong-namespace': string}>)[]
+                >;
+      }
+    | {
+          url: string;
+      };
+
+export type PortHandler<T, C> = <R>(
+    this: ReturnType<IAdapterFactory<T, C>>,
+    params: {},
+    $meta: IMeta,
+    context?: IContext,
+) => Promise<R> | R;
+export type PortHandlerBound = <T>(params: {}, $meta: IMeta, context?: IContext) => Promise<T> | T;
+export type LibFn = <T>(...params: unknown[]) => T;
+export interface IRemoteHandler {
+    [name: string]: PortHandlerBound;
+}
+export interface IHandlerProxy<T> {
+    config: T;
+    handler: {
+        [name: `error${string}`]: (
+            message?: string | {params?: object; cause?: Error},
+        ) => ITypedError;
+    } & IRemoteHandler;
+    lib: ILib & {
+        [name: string]: LibFn;
+    };
+    errors: {
+        [name: string]: (...params: unknown[]) => ITypedError;
+    };
+    utBus: {
+        info: () => {encrypt: object; sign: object};
+    };
+    gateway: {
+        config: () => {public: {sign: object; encrypt: object}};
+    };
+}
+
+export type ImportProxyCallback<T, C> = (
+    blong: IHandlerProxy<T>,
+) => PortHandler<T, C> | IAdapterFactory<T, C> | Record<string, PortHandler<T, C>>;
+export type Definition<T, C> = object | ImportProxyCallback<T, C> | ImportProxyCallback<T, C>[];
+
+export type LibProxyCallback<T> = (blong: IHandlerProxy<T>) => Record<string, LibFn> | LibFn;
+export type Lib<T> = object | LibProxyCallback<T> | LibProxyCallback<T>[];
+
+export type ModuleApi = {
+    config: Record<string, unknown>;
+    parent: IAdapterFactory;
+    error: (errors: object) => ModuleApi;
+    validation: (
+        method: ValidationDefinition | ValidationDefinition[],
+        namespace?: string,
+    ) => ModuleApi;
+    sequence: (fn: () => Sequence) => ModuleApi;
+    feature: (paths: string | string[]) => ModuleApi;
+    step: (step: Record<string, () => IStep>) => ModuleApi;
+} & {
+    [name: string]: (
+        blong: Definition<Record<string, unknown>, Record<string, unknown>>,
+    ) => ModuleApi;
+};
+
+export interface SolutionFactory<T extends TSchema = TNever> {
+    (definition: {type: typeof Type}): IModuleConfig<T> | Promise<IModuleConfig<T>>;
+}
+
+const Kind: symbol = Symbol.for('blong:kind');
+export type Kind = typeof Kind;
+
+export abstract class Internal {
+    #log?: ILog;
+    protected log?: ReturnType<ILog['logger']>;
+    public constructor(api?: {log: ILog}) {
+        this.#log = api?.log;
+    }
+    protected merge: ILib['merge'] = (...args: Parameters<ILib['merge']>) => {
+        const result = merge<{logLevel?: Level}>(...args);
+        if (result.logLevel && this.#log)
+            this.log = this.#log.logger(result.logLevel, {name: this.constructor.name});
+        return result;
+    };
+    public async stop(): Promise<unknown> {
+        return this;
+    }
+    public async start(...params: unknown[]): Promise<unknown> {
+        return this;
+    }
+}
+
+export const handler = <T = Record<string, unknown>, C = AdapterContext>(
+    definition: Definition<T, C>,
+): Definition<T, C> => Object.defineProperty(definition, Kind, {value: 'handler'});
+export const library = <T = Record<string, unknown>>(definition: Lib<T>): Lib<T> =>
+    Object.defineProperty(definition, Kind, {value: 'lib'});
+export const validation = (validation: ValidationDefinition): ValidationDefinition =>
+    Object.defineProperty(validation, Kind, {value: 'validation'});
+export const api = (api: ApiDefinition): ApiDefinition =>
+    Object.defineProperty(api, Kind, {value: 'api'});
+
+export const validationHandlers: (
+    handlers: Record<string, TFunction<[TObject<{}>]>>,
+) => ValidationDefinition = handlers =>
+    validation(() =>
+        Object.fromEntries(
+            Object.entries(handlers).map(([name, handler]) => [
+                name,
+                Object.defineProperty(
+                    () => ({
+                        params: Type.Parameters(handler).items[0],
+                        result: Type.Awaited(Type.ReturnType(handler)),
+                        description: 'description' in handler ? handler.description : undefined,
+                    }),
+                    'name',
+                    {value: name},
+                ),
+            ]),
+        ),
+    );
+
+export const realm = <T extends TObject>(definition: SolutionFactory<T>): SolutionFactory<T> =>
+    Object.defineProperty(definition, Kind, {value: 'solution'});
+export const server = <T extends TObject>(definition: SolutionFactory<T>): SolutionFactory<T> =>
+    Object.defineProperty(definition, Kind, {value: 'server'});
+export const browser = <T extends TObject>(definition: SolutionFactory<T>): SolutionFactory<T> =>
+    Object.defineProperty(definition, Kind, {value: 'browser'});
+export const layer = (
+    activation: Record<string, boolean | object>,
+): Record<string, boolean | object> => Object.defineProperty(activation, Kind, {value: 'layer'});
+export const adapter = <T, C = AdapterContext>(
+    definition: IAdapterFactory<T, C>,
+): IAdapterFactory<T, C> => Object.defineProperty(definition, Kind, {value: 'adapter'});
+export const orchestrator = <T, C = AdapterContext>(
+    definition: IAdapterFactory<T, C>,
+): IAdapterFactory<T, C> => Object.defineProperty(definition, Kind, {value: 'orchestrator'});
+export type Kinds =
+    | 'lib'
+    | 'validation'
+    | 'api'
+    | 'solution'
+    | 'server'
+    | 'browser'
+    | 'adapter'
+    | 'orchestrator'
+    | 'handler';
+export const kind = (what: {[Kind]: Kinds | undefined}): Kinds | undefined => what[Kind];
+
+export default {
+    handler,
+    library,
+    validation,
+    api,
+    realm,
+    server,
+    browser,
+    adapter,
+    orchestrator,
+    kind,
+};