@feasibleone/blong 1.22.0 → 1.23.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [1.23.0](https://github.com/feasibleone/blong/compare/blong-v1.22.0...blong-v1.23.0) (2026-07-14)
+
+
+### Features
+
+* blong-mock, blong-server ([756caca](https://github.com/feasibleone/blong/commit/756cacab712db6792bf1b93830fc1d833b396f8d))
+* check access credentials ([e6af405](https://github.com/feasibleone/blong/commit/e6af405c43921cb9c553db9c4986b7fe56154724))
+* core.resource merging ([371d3e2](https://github.com/feasibleone/blong/commit/371d3e2b3f519dfd59ca4fd480bc33317992afcd))
+* implement subjectObjectSchema ([8ca3282](https://github.com/feasibleone/blong/commit/8ca32829277b9816eb5e43ce708d2f1d0cc3ef28))
+* manifest concept ([ed3c038](https://github.com/feasibleone/blong/commit/ed3c038352644d2d8f828b3cb69cbea718e7084b))
+* object schema ([688d5d2](https://github.com/feasibleone/blong/commit/688d5d2a4a895c8feba7b898da03c46b3a3f3292))
+* schema helpers and constraints ([8409257](https://github.com/feasibleone/blong/commit/84092571f6b327c1166ef142f70cb7d91b013eaf))
+* seed ([5c76603](https://github.com/feasibleone/blong/commit/5c7660392bc1197638810e864bfd47ce1218b2e5))
+* support expressions in the configuration ([843bb58](https://github.com/feasibleone/blong/commit/843bb58c97456d85eac573874c90755bdb68bc95))
+* useBlong ([affdd67](https://github.com/feasibleone/blong/commit/affdd676db3338266d60155604e3bc9024078b5e))
+
+
+### Bug Fixes
+
+* build ([de22713](https://github.com/feasibleone/blong/commit/de2271393350945b8d793ca0ec89670465bba085))
+* core.resource merging ([f191055](https://github.com/feasibleone/blong/commit/f1910558ce0f369f556911c4c0f6397b8003fd33))
+* full stack alignment for CRUD ([8795e08](https://github.com/feasibleone/blong/commit/8795e087182402ac28c3ea03c6bee27319069625))
+* Playwright, Storybook and realm DRY ([4302512](https://github.com/feasibleone/blong/commit/43025123e613ef43e0ac5b83ab00fbc0cabfccf2))
+
 ## [1.22.0](https://github.com/feasibleone/blong/compare/blong-v1.21.0...blong-v1.22.0) (2026-05-25)
 
 

package/dist/types.d.ts

@@ -12,7 +12,7 @@ import { Level, LogFn, Logger as PinoLogger } from 'pino';
 import React$1 from 'react';
 import { Readable, Writable } from 'stream';
 import { ConnectionOptions as ConnectionOptions_2, TLSSocket, TLSSocketOptions } from 'tls';
-import { Static, TArray, TBoolean, TFunction, TIntersect, TNever, TNumber, TObject, TSchema, TString, TUnknown, Type } from 'typebox';
+import { Static, TArray, TBoolean, TFunction, TIntersect, TNever, TNumber, TNumberOptions, TObject, TSchema, TSchemaOptions, TString, TStringOptions, TUnknown, Type } from 'typebox';
 
 export type Method = "GET" | "POST" | "PUT" | "DELETE";
 export interface RequestArgs {
@@ -18762,7 +18762,7 @@ export interface IWidgetConfig {
 	type: WidgetType;
 	/** For dropdown/multiSelect — action name to fetch options */
 	fetch?: string;
-	/** Named dropdown key — loads options via portal.dropdown.list */
+	/** Named dropdown key — loads options via portalDropdownList */
 	dropdown?: string;
 	/** Options list for static select/multiSelect/select/tree widgets.
 	 * Flat options use `{value, label}`. TreeNode-style options use `{key, label, children}`. */
@@ -18984,8 +18984,10 @@ export interface IEnrichedFieldSchema {
 	maximum?: number;
 	pattern?: string;
 	enum?: unknown[];
+	anyOf?: IEnrichedFieldSchema[];
 	readOnly?: boolean;
-	required?: boolean;
+	fieldRequired?: boolean;
+	required?: string[];
 	/** Normalized widget config */
 	widget?: IWidgetConfig;
 	/** Nested object properties — for composite/grouped fields accessed via dot-notation paths */
@@ -19391,10 +19393,46 @@ export type HRTime = [
 	number,
 	number
 ];
+export type BaseConfig = {
+	name: string;
+	pkg: {
+		name: string;
+		version: string;
+	};
+	children: unknown[];
+	url: string;
+	base: string;
+	server: {
+		load: {
+			logLevel: Parameters<ILog["logger"]>[0];
+		};
+		realm: {
+			logLevel: Parameters<ILog["logger"]>[0];
+		};
+	};
+	browser: {
+		load: {
+			logLevel: Parameters<ILog["logger"]>[0];
+		};
+		realm: {
+			logLevel: Parameters<ILog["logger"]>[0];
+		};
+	};
+	kopi?: {
+		realm?: unknown;
+	};
+	watch?: {
+		configs?: object;
+	};
+	configs?: object;
+	configNames: string[];
+};
 export interface IPlatformApi {
 	platform: "server" | "browser";
-	loadConfig: (config: string | object) => Promise<{
-		loadedConfig?: object;
+	loadConfig: (baseConfig: BaseConfig, parentConfig: string | object, loadedConfigs: object[]) => Promise<{
+		loadedConfig: BaseConfig & {
+			[key: string]: unknown;
+		};
 		configRuntime?: IConfigRuntime;
 	}>;
 	readdir: (path: string) => Promise<Dirent[]>;
@@ -19423,6 +19461,7 @@ export interface IPlatformApi {
 		spare: (time: HRTime, latency?: number) => number;
 	};
 	configs: string[];
+	context: Record<string, unknown>;
 }
 export interface IErrorFactory {
 	get(type?: string): Record<string | symbol, {
@@ -19514,6 +19553,11 @@ export interface IApiSchema {
 		assets: object;
 	}, source: string): unknown;
 }
+export interface IObjectSchema {
+	[subject: string]: {
+		[object: string]: TObject;
+	};
+}
 export interface IGateway {
 	route: (validations: Record<string, GatewaySchema>, pkg: {
 		name: string;
@@ -19540,6 +19584,7 @@ export interface IRegistry {
 	ports: Map<string, IAdapterRegistry>;
 	methods: Map<string, Handlers>;
 	modules: Map<string | symbol, IRegistry[]>;
+	objectSchema: IObjectSchema;
 	createPort: (id: string) => Promise<Adapter | undefined>;
 	getPort: (id: string) => Adapter | undefined;
 	replaceHandlers: (id: string, handlers: Handlers) => Promise<void>;
@@ -19548,9 +19593,30 @@ export interface IRegistry {
 	}, source: string) => Promise<void>;
 	connected: () => Promise<boolean>;
 }
+export type BlongType = typeof Type & {
+	increment: () => TSchema;
+	integerNull: (options?: TNumberOptions) => TSchema;
+	integerNotNull: (options?: TNumberOptions) => TSchema;
+	bigIntNull: (options?: TNumberOptions) => TSchema;
+	bigIntNotNull: (options?: TNumberOptions) => TSchema;
+	stringNull: (options?: TStringOptions) => TSchema;
+	stringNotNull: (options?: TStringOptions) => TSchema;
+	numberNull: (options?: TNumberOptions) => TSchema;
+	numberNotNull: (options?: TNumberOptions) => TSchema;
+	booleanNull: (options?: TSchemaOptions) => TSchema;
+	booleanNotNull: (options?: TSchemaOptions) => TSchema;
+	dateNull: () => TSchema;
+	dateNotNull: () => TSchema;
+	dateTimeNull: () => TSchema;
+	dateTimeNotNull: () => TSchema;
+	ulid: () => TSchema;
+	uuid: () => TSchema;
+	uidNull: () => TSchema;
+	uidNotNull: () => TSchema;
+};
 export interface IApi {
 	id?: string;
-	type: typeof Type;
+	type: BlongType;
 	adapter: (id: string) => IAdapterRegistry | undefined;
 	utError: IError;
 	errors: IErrorFactory;
@@ -19559,6 +19625,7 @@ export interface IApi {
 	rpc: IRpcServer;
 	local: ILocal;
 	registry: IRegistry;
+	schema: IObjectSchema;
 	register: (methods: Record<string, (...params: unknown[]) => Promise<unknown>> | Array<(...params: unknown[]) => Promise<unknown>>, namespace: string, id: string, pkg: {
 		version: string;
 	}) => void;
@@ -19578,12 +19645,15 @@ export interface IApi {
 			namespace?: string | string[];
 		};
 	}, patterns: (string | RegExp)[] | string | RegExp, adapter?: boolean) => unknown;
+	attach: (target: object, patterns: (string | RegExp)[] | string | RegExp) => Promise<object>;
 	createLog: ILog["logger"];
 	attachCheckpoint?: (meta: IMeta) => void;
 	handlers?: (api: {
 		utError: IError;
 		remote: IRemote;
-		type: typeof Type;
+		type: BlongType;
+		schema: IObjectSchema;
+		manifest?: IManifest;
 	}) => {
 		extends?: string | ((api: {
 			utError: IError;
@@ -19591,8 +19661,13 @@ export interface IApi {
 			rpc: IRpcServer;
 			local: ILocal;
 			registry: IRegistry;
+			schema: IObjectSchema;
+			manifest?: IManifest;
 		}) => object);
 	};
+	render: (what: object[] | object) => object;
+	platform: IPlatformApi;
+	manifest?: IManifest;
 }
 export interface IErrorMap {
 	[name: string]: string | {
@@ -19601,7 +19676,7 @@ export interface IErrorMap {
 		statusCode?: number;
 	};
 }
-export type Adapter<T = Record<string, unknown>, C = Record<string, unknown>> = IAdapter<T, C> & Pick<Required<IAdapter<T, C>>, "init" | "start" | "stop" | "ready" | "config" | "imported" | "errors" | "error" | "findValidation" | "getConversion" | "dispatch">;
+export type Adapter<T = Record<string, unknown>, C = Record<string, unknown>> = IAdapter<T, C> & Pick<Required<IAdapter<T, C>>, "init" | "start" | "stop" | "ready" | "config" | "imported" | "errors" | "error" | "findValidation" | "getConversion" | "dispatch" | "platform">;
 export interface IAdapter<T, C> {
 	validation?: TSchema;
 	config?: Config<T, C>;
@@ -19612,18 +19687,13 @@ export interface IAdapter<T, C> {
 	imported?: Record<string, PortHandlerBound>;
 	importedMap?: Map<string, IRemoteHandler>;
 	extends?: object | `adapter.${string}` | `orchestrator.${string}`;
+	platform?: IPlatformApi;
 	activeConfig?(this: Adapter<T, C>): Partial<Config<T, C>>;
 	init?(this: Adapter<T, C>, ...config: unknown[]): Promise<unknown>;
 	start?(this: Adapter<T, C>, ...params: unknown[]): Promise<unknown>;
 	ready?(this: Adapter<T, C>): Promise<unknown>;
 	stop?(this: Adapter<T, C>, ...params: unknown[]): Promise<unknown>;
-	link?(this: Adapter<T, C>, patterns: (string | RegExp)[] | string | RegExp, target: object): Promise<{
-		importedMap?: Map<string, object>;
-		imported?: object;
-		config?: {
-			namespace?: string | string[];
-		};
-	}>;
+	attach?<R extends object>(this: Adapter<T, C>, patterns: (string | RegExp)[] | string | RegExp, target?: R): Promise<R>;
 	connected?(this: Adapter<T, C>): Promise<boolean>;
 	error?(error: unknown, $meta: unknown): void;
 	pack?(this: Adapter<T, C>, ...params: unknown[]): unknown;
@@ -19680,6 +19750,8 @@ export interface IAdapterRegistry {
 		rpc: IRpcServer;
 		local: ILocal;
 		registry: IRegistry;
+		schema: IObjectSchema;
+		manifest?: IManifest;
 	}): Promise<Adapter>;
 }
 export interface IMeta {
@@ -19799,18 +19871,27 @@ export type Errors<T> = {
 };
 export interface IBaseConfig extends TObject<{
 	watch: TObject<{
-		test: TArray<TString>;
+		test?: TArray<TString>;
 	}>;
 	remote: TObject<{
-		canSkipSocket: TBoolean;
+		canSkipSocket?: TBoolean;
 	}>;
-	adapter: TBoolean;
-	orchestrator: TBoolean;
-	test: TBoolean;
-	error: TBoolean;
+	adapter: TBoolean | TObject;
+	orchestrator: TBoolean | TObject;
+	test: TBoolean | TObject;
+	error: TBoolean | TObject;
 	gateway: TBoolean | TObject;
-	sim: TBoolean;
-	resolution: TBoolean;
+	sim: TBoolean | TObject;
+	resolution: TBoolean | TObject;
+	log: TBoolean | TObject;
+	apiSchema: TBoolean | TObject;
+	registry: TBoolean | TObject;
+	port: TBoolean | TObject;
+	codec: TBoolean | TObject;
+	local: TBoolean | TObject;
+	rpcServer: TBoolean | TObject;
+	restFs: TBoolean | TObject;
+	systemDebug: TBoolean | TObject;
 }> {
 	additionalProperties: false;
 }
@@ -19899,8 +19980,24 @@ export type ChainStep = ((assert: IAssert, context: {
 	$meta: IMeta;
 } & Record<string, Promise<unknown[]> & ThenableProxy>) => Promise<object>) | object;
 export type CheckpointFn = (this: IMeta, name: string, data?: unknown) => void;
+/**
+ * Manifest — a shared mutable object passed to the `load` function that allows
+ * platforms to share information such as effective ports, URLs, or other
+ * runtime-resolved values across components.
+ *
+ * Properties are typically Promises (created via `Promise.withResolvers()`) that
+ * are resolved when one platform finishes a startup step (e.g. listening on a
+ * random port), and awaited by another platform or adapter during its own
+ * initialisation (e.g. constructing a backend URL from the effective port).
+ *
+ * Manifest properties can also be provided via CLI args using the
+ * `--manifest.<key>=<value>` syntax.
+ */
+export interface IManifest {
+	[key: string]: unknown;
+}
 export interface ILib {
-	type: typeof Type;
+	type: BlongType;
 	error: <T>(errors: T) => Record<keyof T, (params?: unknown, $meta?: IMeta) => ITypedError>;
 	rename: <T extends object>(object: T, name: string) => T & {
 		name: string;
@@ -19953,22 +20050,29 @@ export interface ILib {
 	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;
+	mergeWithSymbols<T, S1>(target: T, source: S1): T & S1;
+	render: (what: object[] | object) => object;
+	crockfordEncode: (data: Uint8Array) => string;
+	crockfordDecode: (data: string) => Uint8Array;
 }
 export type ValidationFn = () => GatewaySchema;
-export interface IValidationProxy {
+export interface IValidationProxy<T> {
 	type: typeof Type;
 	handler: {
 		[name: string]: ValidationFn;
-	};
+	} & IRemoteHandler;
 	lib: ILib & {
 		[name: string]: TSchema;
 	};
 	error: {
 		[name: string]: (...params: unknown[]) => ITypedError;
 	};
+	/** Collected object schemas accumulated so far; later `schema()` exports can reference earlier ones. */
+	schema: IObjectSchema;
+	config: T;
 }
-export type ValidationDefinition = (blong: IValidationProxy) => Record<string, ValidationFn | TSchema> | ValidationFn | ValidationFn[];
-export type ApiDefinition = (blong: IValidationProxy) => {
+export type ValidationDefinition<T> = (blong: IValidationProxy<T>) => Promise<Record<string, ValidationFn | TSchema> | ValidationFn | ValidationFn[]>;
+export type ApiDefinition<T> = (blong: IValidationProxy<T>) => {
 	namespace: string[] | Record<string, string | (string | Partial<OpenAPI.Document & {
 		"x-blong-namespace": string;
 	}>)[]>;
@@ -19999,6 +20103,8 @@ export interface IHandlerProxy<T> {
 	errors: {
 		[name: string]: (...params: unknown[]) => ITypedError;
 	};
+	/** Collected object schemas from all registered `schema()` exports. */
+	schema: IObjectSchema;
 	utBus: {
 		info: () => {
 			encrypt: object;
@@ -20023,7 +20129,7 @@ export type ModuleApi = {
 	config: Record<string, unknown>;
 	parent: IAdapterFactory;
 	error: (errors: object) => ModuleApi;
-	validation: (method: ValidationDefinition | ValidationDefinition[], namespace?: string) => ModuleApi;
+	validation: <T>(method: ValidationDefinition<T> | ValidationDefinition<T>[], namespace?: string) => ModuleApi;
 	sequence: (fn: () => Sequence) => ModuleApi;
 	feature: (paths: string | string[]) => ModuleApi;
 	step: (step: Record<string, () => IStep>) => ModuleApi;
@@ -20033,6 +20139,7 @@ export type ModuleApi = {
 export interface SolutionFactory<T extends TSchema = TNever> {
 	(definition: {
 		type: typeof Type;
+		manifest?: IManifest;
 	}): IModuleConfig<T> | Promise<IModuleConfig<T>>;
 }
 declare const Kind: symbol;
@@ -20064,26 +20171,27 @@ export interface IComponent {
 	component: (params?: Record<string, unknown>) => Promise<unknown>;
 }
 export declare const library: <T = Record<string, unknown>>(definition: Lib<T>) => Lib<T>;
-export declare const validation: (validation: ValidationDefinition) => ValidationDefinition;
-export declare const api: (api: ApiDefinition) => ApiDefinition;
+export declare const validation: <T = Record<string, unknown>>(validation: ValidationDefinition<T>) => ValidationDefinition<T>;
+export declare const schema: <T = Record<string, unknown>>(schema: ValidationDefinition<T>) => ValidationDefinition<T>;
+export declare const api: <T = Record<string, unknown>>(api: ApiDefinition<T>) => ApiDefinition<T>;
 export declare const model: <T extends IModelSpec>(definition: () => () => Promise<T>) => (() => () => Promise<T>);
 export declare const fixture: <T extends IMock>(definition: () => T) => (() => T);
-export declare const validationHandlers: (handlers: Record<string, TFunction<[
+export declare const validationHandlers: <T>(handlers: Record<string, TFunction<[
 	ApiSchema
-]>>) => ValidationDefinition;
+]>>) => ValidationDefinition<T>;
 export declare const realm: <T extends TObject>(definition: SolutionFactory<T>) => SolutionFactory<T> & {};
 export declare const server: <T extends TObject>(definition: SolutionFactory<T>) => SolutionFactory<T> & {};
 export declare const browser: <T extends TObject>(definition: SolutionFactory<T>) => SolutionFactory<T> & {};
 export declare const layer: (activation: Record<string, boolean | object>) => Record<string, boolean | object> & {};
 export declare const adapter: <T, C = AdapterContext>(definition: IAdapterFactory<T, C>) => IAdapterFactory<T, C> & {};
 export declare const orchestrator: <T, C = AdapterContext>(definition: IAdapterFactory<T, C>) => IAdapterFactory<T, C> & {};
-export type Kinds = "lib" | "validation" | "api" | "solution" | "server" | "browser" | "adapter" | "orchestrator" | "handler" | "model" | "fixture" | "";
+export type Kinds = "lib" | "validation" | "schema" | "api" | "solution" | "server" | "browser" | "adapter" | "orchestrator" | "handler" | "model" | "fixture" | "";
 export declare const kind: (what: {}) => Kinds;
 declare const _default: {
 	handler: <T = Record<string, unknown>, C = AdapterContext>(definition: Definition<T, C>) => Definition<T, C>;
 	library: <T = Record<string, unknown>>(definition: Lib<T>) => Lib<T>;
-	validation: (validation: ValidationDefinition) => ValidationDefinition;
-	api: (api: ApiDefinition) => ApiDefinition;
+	validation: <T = Record<string, unknown>>(validation: ValidationDefinition<T>) => ValidationDefinition<T>;
+	api: <T = Record<string, unknown>>(api: ApiDefinition<T>) => ApiDefinition<T>;
 	realm: <T extends TObject>(definition: SolutionFactory<T>) => SolutionFactory<T> & {};
 	server: <T extends TObject>(definition: SolutionFactory<T>) => SolutionFactory<T> & {};
 	browser: <T extends TObject>(definition: SolutionFactory<T>) => SolutionFactory<T> & {};

package/dist/types.js

@@ -23,10 +23,11 @@ export class Internal {
 export const handler = (definition) => Object.defineProperty(definition, Kind, { value: 'handler' });
 export const library = (definition) => Object.defineProperty(definition, Kind, { value: 'lib' });
 export const validation = (validation) => Object.defineProperty(validation, Kind, { value: 'validation' });
+export const schema = (schema) => Object.defineProperty(schema, Kind, { value: 'schema' });
 export const api = (api) => Object.defineProperty(api, Kind, { value: 'api' });
 export const model = (definition) => Object.defineProperty(definition, Kind, { value: 'model' });
 export const fixture = (definition) => Object.defineProperty(definition, Kind, { value: 'fixture' });
-export const validationHandlers = handlers => validation(() => Object.fromEntries(Object.entries(handlers).map(([name, handler]) => [
+export const validationHandlers = handlers => validation(async () => Object.fromEntries(Object.entries(handlers).map(([name, handler]) => [
     name,
     Object.defineProperty(() => ({
         params: Type.Parameters(handler).items[0],

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}
+{"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.22.0",
+  "version": "1.23.0",
   "description": "API and DRY focused RAD framework https://feasibleone.github.io/blong-docs",
   "keywords": [
     "blong",
@@ -40,14 +40,14 @@
     "bson": "^7.2.0",
     "chokidar": "^5.0.0",
     "dts-bundle-generator": "^9.5.1",
-    "knex": "^3.1.0",
+    "knex": "^3.2.10",
     "mongodb": "^7.1.0",
     "node-vault": "^0.10.10",
     "openapi-types": "^12.1.3",
     "react": "^19.1.0",
     "tarn": "^3.0.2",
     "typescript": "^6.0.3",
-    "@feasibleone/blong-dev": "1.0.2"
+    "@feasibleone/blong-dev": "1.1.0"
   },
   "scripts": {
     "build": "heft build --clean;dts-bundle-generator --config dts-gen.config.json",

package/types.ts

@@ -19,9 +19,12 @@ import {
     type TIntersect,
     type TNever,
     type TNumber,
+    type TNumberOptions,
     type TObject,
     type TSchema,
+    type TSchemaOptions,
     type TString,
+    type TStringOptions,
     type TUnknown,
 } from 'typebox';
 // import type {client} from 'node-vault';
@@ -132,11 +135,38 @@ export interface IWatcher extends EventEmitter<FSWatcherEventMap> {
 
 export type HRTime = [number, number];
 
+type BaseConfig = {
+    name: string;
+    pkg: {name: string; version: string};
+    children: unknown[];
+    url: string;
+    base: string;
+    server: {
+        load: {logLevel: Parameters<ILog['logger']>[0]};
+        realm: {logLevel: Parameters<ILog['logger']>[0]};
+    };
+    browser: {
+        load: {logLevel: Parameters<ILog['logger']>[0]};
+        realm: {logLevel: Parameters<ILog['logger']>[0]};
+    };
+    kopi?: {realm?: unknown};
+    watch?: {configs?: object};
+    configs?: object;
+    configNames: string[];
+};
+
 export interface IPlatformApi {
     platform: 'server' | 'browser';
     loadConfig: (
-        config: string | object,
-    ) => Promise<{loadedConfig?: object; configRuntime?: IConfigRuntime}>;
+        baseConfig: BaseConfig,
+        parentConfig: string | object,
+        loadedConfigs: object[],
+    ) => Promise<{
+        loadedConfig: BaseConfig & {
+            [key: string]: unknown;
+        };
+        configRuntime?: IConfigRuntime;
+    }>;
     readdir: (path: string) => Promise<Dirent[]>;
     scan: (...path: string[]) => Promise<Dirent[]>;
     existsSync: (path: string) => boolean;
@@ -163,6 +193,7 @@ export interface IPlatformApi {
         spare: (time: HRTime, latency?: number) => number;
     };
     configs: string[];
+    context: Record<string, unknown>;
 }
 
 export interface IErrorFactory {
@@ -263,6 +294,12 @@ export interface IApiSchema {
     ): unknown;
 }
 
+export interface IObjectSchema {
+    [subject: string]: {
+        [object: string]: TObject;
+    };
+}
+
 export interface IGateway {
     route: (
         validations: Record<string, GatewaySchema>,
@@ -291,6 +328,7 @@ export interface IRegistry {
     ports: Map<string, IAdapterRegistry>;
     methods: Map<string, Handlers>;
     modules: Map<string | symbol, IRegistry[]>;
+    objectSchema: IObjectSchema;
     createPort: (id: string) => Promise<Adapter | undefined>;
     getPort: (id: string) => Adapter | undefined;
     replaceHandlers: (id: string, handlers: Handlers) => Promise<void>;
@@ -304,9 +342,31 @@ export interface IRegistry {
     connected: () => Promise<boolean>;
 }
 
+type BlongType = typeof Type & {
+    increment: () => TSchema;
+    integerNull: (options?: TNumberOptions) => TSchema;
+    integerNotNull: (options?: TNumberOptions) => TSchema;
+    bigIntNull: (options?: TNumberOptions) => TSchema;
+    bigIntNotNull: (options?: TNumberOptions) => TSchema;
+    stringNull: (options?: TStringOptions) => TSchema;
+    stringNotNull: (options?: TStringOptions) => TSchema;
+    numberNull: (options?: TNumberOptions) => TSchema;
+    numberNotNull: (options?: TNumberOptions) => TSchema;
+    booleanNull: (options?: TSchemaOptions) => TSchema;
+    booleanNotNull: (options?: TSchemaOptions) => TSchema;
+    dateNull: () => TSchema;
+    dateNotNull: () => TSchema;
+    dateTimeNull: () => TSchema;
+    dateTimeNotNull: () => TSchema;
+    ulid: () => TSchema;
+    uuid: () => TSchema;
+    uidNull: () => TSchema;
+    uidNotNull: () => TSchema;
+};
+
 export interface IApi {
     id?: string;
-    type: typeof Type;
+    type: BlongType;
     adapter: (id: string) => IAdapterRegistry | undefined;
     utError: IError;
     errors: IErrorFactory;
@@ -315,6 +375,7 @@ export interface IApi {
     rpc: IRpcServer;
     local: ILocal;
     registry: IRegistry;
+    schema: IObjectSchema;
     register: (
         methods:
             | Record<string, (...params: unknown[]) => Promise<unknown>>
@@ -349,9 +410,16 @@ export interface IApi {
         patterns: (string | RegExp)[] | string | RegExp,
         adapter?: boolean,
     ) => unknown;
+    attach: (target: object, patterns: (string | RegExp)[] | string | RegExp) => Promise<object>;
     createLog: ILog['logger'];
     attachCheckpoint?: (meta: IMeta) => void;
-    handlers?: (api: {utError: IError; remote: IRemote; type: typeof Type}) => {
+    handlers?: (api: {
+        utError: IError;
+        remote: IRemote;
+        type: BlongType;
+        schema: IObjectSchema;
+        manifest?: IManifest;
+    }) => {
         extends?:
             | string
             | ((api: {
@@ -360,8 +428,13 @@ export interface IApi {
                   rpc: IRpcServer;
                   local: ILocal;
                   registry: IRegistry;
+                  schema: IObjectSchema;
+                  manifest?: IManifest;
               }) => object);
     };
+    render: (what: object[] | object) => object;
+    platform: IPlatformApi;
+    manifest?: IManifest;
 }
 
 export interface IErrorMap {
@@ -388,6 +461,7 @@ export type Adapter<T = Record<string, unknown>, C = Record<string, unknown>> =
         | 'findValidation'
         | 'getConversion'
         | 'dispatch'
+        | 'platform'
     >;
 export interface IAdapter<T, C> {
     validation?: TSchema;
@@ -399,20 +473,17 @@ export interface IAdapter<T, C> {
     imported?: Record<string, PortHandlerBound>;
     importedMap?: Map<string, IRemoteHandler>;
     extends?: object | `adapter.${string}` | `orchestrator.${string}`;
+    platform?: IPlatformApi;
     activeConfig?(this: Adapter<T, C>): Partial<Config<T, C>>;
     init?(this: Adapter<T, C>, ...config: unknown[]): Promise<unknown>;
     start?(this: Adapter<T, C>, ...params: unknown[]): Promise<unknown>;
     ready?(this: Adapter<T, C>): Promise<unknown>;
     stop?(this: Adapter<T, C>, ...params: unknown[]): Promise<unknown>;
-    link?(
+    attach?<R extends object>(
         this: Adapter<T, C>,
         patterns: (string | RegExp)[] | string | RegExp,
-        target: object,
-    ): Promise<{
-        importedMap?: Map<string, object>;
-        imported?: object;
-        config?: {namespace?: string | string[]};
-    }>;
+        target?: R,
+    ): Promise<R>;
     connected?(this: Adapter<T, C>): Promise<boolean>;
     error?(error: unknown, $meta: unknown): void;
     pack?(this: Adapter<T, C>, ...params: unknown[]): unknown;
@@ -487,6 +558,8 @@ export interface IAdapterRegistry {
         rpc: IRpcServer;
         local: ILocal;
         registry: IRegistry;
+        schema: IObjectSchema;
+        manifest?: IManifest;
     }): Promise<Adapter>;
 }
 
@@ -605,18 +678,27 @@ export type Errors<T> = {
 
 export interface IBaseConfig extends TObject<{
     watch: TObject<{
-        test: TArray<TString>;
+        test?: TArray<TString>;
     }>;
     remote: TObject<{
-        canSkipSocket: TBoolean;
+        canSkipSocket?: TBoolean;
     }>;
-    adapter: TBoolean;
-    orchestrator: TBoolean;
-    test: TBoolean;
-    error: TBoolean;
+    adapter: TBoolean | TObject;
+    orchestrator: TBoolean | TObject;
+    test: TBoolean | TObject;
+    error: TBoolean | TObject;
     gateway: TBoolean | TObject;
-    sim: TBoolean;
-    resolution: TBoolean;
+    sim: TBoolean | TObject;
+    resolution: TBoolean | TObject;
+    log: TBoolean | TObject;
+    apiSchema: TBoolean | TObject;
+    registry: TBoolean | TObject;
+    port: TBoolean | TObject;
+    codec: TBoolean | TObject;
+    local: TBoolean | TObject;
+    rpcServer: TBoolean | TObject;
+    restFs: TBoolean | TObject;
+    systemDebug: TBoolean | TObject;
 }> {
     additionalProperties: false;
 }
@@ -725,8 +807,25 @@ export type ChainStep =
 
 export type CheckpointFn = (this: IMeta, name: string, data?: unknown) => void;
 
+/**
+ * Manifest — a shared mutable object passed to the `load` function that allows
+ * platforms to share information such as effective ports, URLs, or other
+ * runtime-resolved values across components.
+ *
+ * Properties are typically Promises (created via `Promise.withResolvers()`) that
+ * are resolved when one platform finishes a startup step (e.g. listening on a
+ * random port), and awaited by another platform or adapter during its own
+ * initialisation (e.g. constructing a backend URL from the effective port).
+ *
+ * Manifest properties can also be provided via CLI args using the
+ * `--manifest.<key>=<value>` syntax.
+ */
+export interface IManifest {
+    [key: string]: unknown;
+}
+
 export interface ILib {
-    type: typeof Type;
+    type: BlongType;
     error: <T>(errors: T) => Record<keyof T, (params?: unknown, $meta?: IMeta) => ITypedError>;
     rename: <T extends object>(object: T, name: string) => T & {name: string};
     /**
@@ -773,26 +872,33 @@ export interface ILib {
     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;
+    mergeWithSymbols<T, S1>(target: T, source: S1): T & S1;
+    render: (what: object[] | object) => object;
+    crockfordEncode: (data: Uint8Array) => string;
+    crockfordDecode: (data: string) => Uint8Array;
 }
 
 export type ValidationFn = () => GatewaySchema;
-export interface IValidationProxy {
+export interface IValidationProxy<T> {
     type: typeof Type;
     handler: {
         [name: string]: ValidationFn;
-    };
+    } & IRemoteHandler;
     lib: ILib & {
         [name: string]: TSchema;
     };
     error: {
         [name: string]: (...params: unknown[]) => ITypedError;
     };
+    /** Collected object schemas accumulated so far; later `schema()` exports can reference earlier ones. */
+    schema: IObjectSchema;
+    config: T;
 }
-export type ValidationDefinition = (
-    blong: IValidationProxy,
-) => Record<string, ValidationFn | TSchema> | ValidationFn | ValidationFn[];
+export type ValidationDefinition<T> = (
+    blong: IValidationProxy<T>,
+) => Promise<Record<string, ValidationFn | TSchema> | ValidationFn | ValidationFn[]>;
 
-export type ApiDefinition = (blong: IValidationProxy) =>
+export type ApiDefinition<T> = (blong: IValidationProxy<T>) =>
     | {
           namespace:
               | string[]
@@ -838,6 +944,8 @@ export interface IHandlerProxy<T> {
     errors: {
         [name: string]: (...params: unknown[]) => ITypedError;
     };
+    /** Collected object schemas from all registered `schema()` exports. */
+    schema: IObjectSchema;
     utBus: {
         info: () => {encrypt: object; sign: object};
     };
@@ -859,8 +967,8 @@ export type ModuleApi = {
     config: Record<string, unknown>;
     parent: IAdapterFactory;
     error: (errors: object) => ModuleApi;
-    validation: (
-        method: ValidationDefinition | ValidationDefinition[],
+    validation: <T>(
+        method: ValidationDefinition<T> | ValidationDefinition<T>[],
         namespace?: string,
     ) => ModuleApi;
     sequence: (fn: () => Sequence) => ModuleApi;
@@ -873,7 +981,10 @@ export type ModuleApi = {
 };
 
 export interface SolutionFactory<T extends TSchema = TNever> {
-    (definition: {type: typeof Type}): IModuleConfig<T> | Promise<IModuleConfig<T>>;
+    (definition: {
+        type: typeof Type;
+        manifest?: IManifest;
+    }): IModuleConfig<T> | Promise<IModuleConfig<T>>;
 }
 
 const Kind: symbol = Symbol.for('blong:kind');
@@ -921,9 +1032,13 @@ export interface IComponent {
 
 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 =>
+export const validation = <T = Record<string, unknown>>(
+    validation: ValidationDefinition<T>,
+): ValidationDefinition<T> => Object.defineProperty(validation, Kind, {value: 'validation'});
+export const schema = <T = Record<string, unknown>>(
+    schema: ValidationDefinition<T>,
+): ValidationDefinition<T> => Object.defineProperty(schema, Kind, {value: 'schema'});
+export const api = <T = Record<string, unknown>>(api: ApiDefinition<T>): ApiDefinition<T> =>
     Object.defineProperty(api, Kind, {value: 'api'});
 export const model = <T extends IModelSpec>(
     definition: () => () => Promise<T>,
@@ -931,10 +1046,10 @@ export const model = <T extends IModelSpec>(
 export const fixture = <T extends IMock>(definition: () => T): (() => T) =>
     Object.defineProperty(definition, Kind, {value: 'fixture'});
 
-export const validationHandlers: (
+export const validationHandlers: <T>(
     handlers: Record<string, TFunction<[ApiSchema]>>,
-) => ValidationDefinition = handlers =>
-    validation(() =>
+) => ValidationDefinition<T> = handlers =>
+    validation(async () =>
         Object.fromEntries(
             Object.entries(handlers).map(([name, handler]) => [
                 name,
@@ -989,6 +1104,7 @@ export const orchestrator = <T, C = AdapterContext>(
 export type Kinds =
     | 'lib'
     | 'validation'
+    | 'schema'
     | 'api'
     | 'solution'
     | 'server'