@feasibleone/blong 1.16.0 → 1.17.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [1.17.0](https://github.com/feasibleone/blong/compare/blong-v1.16.1...blong-v1.17.0) (2026-04-26)
+
+
+### Features
+
+* add support for the browser platform ([f483e14](https://github.com/feasibleone/blong/commit/f483e149711acdeebcf9ee5afa3bf7ac7a6b669c))
+* implement wiring pipeline simplifications ([0a3dc01](https://github.com/feasibleone/blong/commit/0a3dc01e97c158d30491e8b76bef7d6bb4987529))
+* model handling ([168e77e](https://github.com/feasibleone/blong/commit/168e77ec3284bbcebf5d7d6bb07cc624d0d1a56e))
+* model init ([7e18e00](https://github.com/feasibleone/blong/commit/7e18e002e3d9d9d2e996762d3ce7dd70d6a7d0be))
+* model mocks ([118a142](https://github.com/feasibleone/blong/commit/118a14254f87b8d1cf0b4d217939a9d49942f93e))
+
+
+### Bug Fixes
+
+* dependencies ([dd785c4](https://github.com/feasibleone/blong/commit/dd785c49c20045a804df0527638191f5d7d32a49))
+* dependencies ([a21d8eb](https://github.com/feasibleone/blong/commit/a21d8ebe4ce9b476060dec8eeb9017a5eb7f07b5))
+* dependencies ([705b2f7](https://github.com/feasibleone/blong/commit/705b2f7a72ac2dc93aea0f586394dde71192c1b6))
+* eslint ([a3b9f2b](https://github.com/feasibleone/blong/commit/a3b9f2bed4f958abfb378d97d372b3e7a6cd5a21))
+* optimize browser loading ([0aac985](https://github.com/feasibleone/blong/commit/0aac985a24520810dc05eb34d314ed7dec4f1962))
+* remove heft lint ([c4d0eaa](https://github.com/feasibleone/blong/commit/c4d0eaa81714c04e9f9adec01c6ae7fa068f1948))
+* types ([b7f0b57](https://github.com/feasibleone/blong/commit/b7f0b57159019dbeb80b9021b04e04eee57468ba))
+
+## [1.16.1](https://github.com/feasibleone/blong/compare/blong-v1.16.0...blong-v1.16.1) (2026-04-10)
+
+
+### Bug Fixes
+
+* build ([32951e4](https://github.com/feasibleone/blong/commit/32951e46561648651ee4e032545655007c05e274))
+
 ## [1.16.0](https://github.com/feasibleone/blong/compare/blong-v1.15.0...blong-v1.16.0) (2026-04-10)
 
 

package/dist/model.js

@@ -0,0 +1,10 @@
+/**
+ * Model system types.
+ *
+ * A ModelSpec describes one "subject.object" domain entity and drives:
+ * - automatic Browse / New / Open / Report page generation
+ * - schema enrichment (server OpenAPI merged with browser overlay)
+ * - dropdown dependency tracking and caching
+ */
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/types.d.ts

@@ -1,10 +1,11 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import { ChokidarOptions, FSWatcherEventMap } from 'chokidar';
 import { SrvRecord } from 'dns';
 import { EventEmitter } from 'events';
 import { Socket, TcpNetConnectOpts } from 'net';
 import Assert from 'node:assert';
-import { Dirent } from 'node:fs';
+import { Dirent, StatSyncFn } from 'node:fs';
 import { Agent } from 'node:http';
 import { Duplex } from 'node:stream';
 import { Level, LogFn, Logger as PinoLogger } from 'pino';
@@ -17573,6 +17574,207 @@ declare namespace DeferredKeySelection {
 }
 export type AggregationQueryResult<TResult, TIntersectProps2 extends {}> = ArrayIfAlready<TResult, UnwrapArrayMember<TResult> extends DeferredKeySelection<infer TBase, infer TKeys, infer THasSelect, infer TAliasMapping, infer TSingle, infer TIntersectProps, infer TUnionProps> ? true extends THasSelect ? DeferredKeySelection<TBase, TKeys, THasSelect, TAliasMapping, TSingle, TIntersectProps & TIntersectProps2, TUnionProps> : DeferredKeySelection<{}, never, true, {}, false, TIntersectProps2> : TIntersectProps2>;
 export type ResolveResult<S> = DeferredKeySelection.Resolve<S>;
+/**
+ * Model system types.
+ *
+ * A ModelSpec describes one "subject.object" domain entity and drives:
+ * - automatic Browse / New / Open / Report page generation
+ * - schema enrichment (server OpenAPI merged with browser overlay)
+ * - dropdown dependency tracking and caching
+ */
+/** {value, label} pair used in all dropdown and select widgets */
+export interface IDropdownOption {
+	value: unknown;
+	label: string;
+	[key: string]: unknown;
+}
+/** Widget metadata overlay  */
+export interface IWidgetOverride {
+	type?: string;
+	/** Named dropdown: 'rule.country', 'marine.species', etc. */
+	dropdown?: string;
+	options?: Array<{
+		value: unknown;
+		label: string;
+	}>;
+	keyValue?: boolean;
+	fieldClass?: string;
+	itemClassName?: string;
+	label?: string;
+	master?: Record<string, string>;
+	parent?: string;
+	autoSelect?: boolean;
+	selectionMode?: "single" | "multiple";
+	hidden?: string[];
+	widgets?: string[];
+	params?: Record<string, unknown>;
+	[key: string]: unknown;
+}
+/** JSON Schema property overlay — the browser model adds/overrides field metadata */
+export interface IPropertyOverride {
+	title?: string;
+	type?: string;
+	filter?: boolean;
+	sort?: boolean;
+	required?: boolean;
+	default?: unknown;
+	widget?: IWidgetOverride;
+	validation?: unknown;
+	properties?: Record<string, IPropertyOverride>;
+	items?: {
+		properties?: Record<string, IPropertyOverride>;
+	};
+	[key: string]: unknown;
+}
+/** Schema overlay — top-level properties map per subject.object */
+export interface ISchemaOverlay {
+	properties?: Record<string, IPropertyOverride>;
+	[key: string]: unknown;
+}
+/** Named card layout — a group of fields rendered as one collapsible card */
+export interface ICardOverride {
+	className?: string;
+	label?: string;
+	title?: string;
+	hidden?: boolean;
+	widgets: Array<string | IInlineWidget>;
+}
+/** Inline widget descriptor (used inside card.widgets arrays) */
+export interface IInlineWidget {
+	name: string;
+	type: string;
+	page?: string;
+	params?: Record<string, unknown>;
+}
+/** Tab in the editor layout */
+export interface ILayoutTab {
+	id: string;
+	label?: string;
+	icon?: string;
+	widgets: Array<string | string[]>;
+}
+/** Permission names for each CRUD action */
+export interface IBrowserPermissions {
+	browse: string;
+	add: string;
+	edit: string;
+	delete: string;
+}
+/** Browse page configuration */
+export interface IBrowserConfig {
+	title?: string;
+	icon?: string;
+	permission?: IBrowserPermissions;
+	/** Column transformation applied to server fetch params */
+	fetch?: (params: Record<string, unknown>) => Record<string, unknown>;
+	/** Default filter applied on page open */
+	filter?: Record<string, unknown>;
+	/** Result set key to use from server response */
+	resultSet?: string;
+	/** Whether to show "Create" button */
+	create?: Array<{
+		title?: string;
+		type?: string;
+		permission?: string;
+	}>;
+	/** Extra toolbar buttons */
+	toolbar?: unknown[];
+}
+/** Editor page configuration */
+export interface IEditorConfig {
+	resultSet?: string;
+}
+/** Report page configuration */
+export interface IReportConfig {
+	title?: string;
+	permission?: string;
+}
+/** Method name overrides — defaults to semantic triple naming */
+export interface IMethodsConfig {
+	find?: string;
+	get?: string;
+	add?: string;
+	edit?: string;
+	remove?: string;
+	report?: string;
+}
+/**
+ * ModelSpec — the browser-side description of one "subject.object" domain entity.
+ *
+ * Used by modelFactory() to auto-generate Browse/New/Open/Report pages.
+ */
+export interface IModelSpec {
+	/** Namespace / subject, e.g. 'marine', 'rule' */
+	subject: string;
+	/** Entity name, e.g. 'coral', 'condition' */
+	object: string;
+	/** Human-readable title, e.g. 'Coral'. Defaults to capitalized object. */
+	objectTitle?: string;
+	/** Primary key field path, e.g. 'coralId'. Defaults to `${object}Id`. */
+	keyField?: string;
+	/** Name field path (dotted), e.g. 'coral.coralName'. Defaults to `${object}.${object}Name`. */
+	nameField?: string;
+	/** JSON Schema overlay merged on top of server OpenAPI schema */
+	schema?: ISchemaOverlay;
+	/** Named card layout definitions */
+	cards?: Record<string, ICardOverride>;
+	/** Browse page configuration */
+	browser?: IBrowserConfig;
+	/** Editor page configuration */
+	editor?: IEditorConfig;
+	/** Report page configuration */
+	report?: IReportConfig;
+	/** Tab layouts for editor */
+	layouts?: {
+		edit?: ILayoutTab[] | string[];
+		[key: string]: unknown;
+	};
+	/** Method name overrides */
+	methods?: IMethodsConfig;
+}
+/** Model spec as accepted by modelFactory — objectTitle/keyField/nameField are optional */
+export type IPartialModelSpec = IModelSpec;
+/** Fully resolved model spec — all defaults filled in */
+export interface IResolvedModelSpec extends Required<IModelSpec> {
+	objectTitle: string;
+	keyField: string;
+	nameField: string;
+	browser: Required<IBrowserConfig> & {
+		permission: IBrowserPermissions;
+	};
+	editor: Required<IEditorConfig>;
+	report: Required<IReportConfig>;
+	methods: Required<IMethodsConfig>;
+}
+/** Mock OpenAPI document (minimal shape used by schemaFetcher) */
+export interface IMockOpenApiDoc {
+	paths?: Record<string, Record<string, {
+		operationId?: string;
+		requestBody?: {
+			content?: {
+				"application/json"?: {
+					schema?: Record<string, unknown>;
+				};
+			};
+		};
+		responses?: {
+			"200"?: {
+				content?: {
+					"application/json"?: {
+						schema?: Record<string, unknown>;
+					};
+				};
+			};
+		};
+	}>>;
+	"x-ui-customizations"?: Record<string, Record<string, unknown>>;
+}
+export interface IMock {
+	/** Mock OpenAPI documents keyed by subject name */
+	subjects?: Record<string, object[]>;
+	/** Pre-populated dropdown data keyed by dropdown name */
+	dropdowns?: Record<string, IDropdownOption[]>;
+}
 export type ServerContext = {
 	queryBuilder?: Knex;
 	kcAdminClient?: KeycloakAdminClient;
@@ -17591,6 +17793,82 @@ export interface ILog {
 	logger: (level: Level, bindings: object) => ILogger;
 	child: PinoLogger["child"];
 }
+/** A flat map of dotted-path → [prev, next] pairs that represent changed keys */
+export type ConfigDiff = Map<string, {
+	prev: unknown;
+	next: unknown;
+}>;
+/** Subscriber callback invoked after a successful reload */
+export type ConfigSubscriber = (diff: ConfigDiff, next: object, prev: object) => void | Promise<void>;
+/**
+ * Mode used when the config proxy is queried during handler factory initialisation.
+ *
+ * - `'throw'`   — throw immediately (default; keeps misuse from going unnoticed)
+ * - `'collect'` — accumulate errors and return them from exitConfigFactoryPhase()
+ *                 (useful in tests that explicitly verify the anti-pattern is caught)
+ */
+export type FactoryPhaseMode = "throw" | "collect";
+export interface IConfigRuntime {
+	/** Current effective config, exposed as a live proxy */
+	readonly snapshot: object;
+	/** Raw (non-proxy) snapshot of the current effective config */
+	readonly rawSnapshot: object;
+	/** Load (or reload) config from all sources; returns the updated snapshot */
+	load(params?: object): Promise<object>;
+	/**
+	 * Reload config in-place.  The backing store of the proxy is updated so all
+	 * existing proxy references automatically reflect the new values.
+	 * Returns the computed diff.
+	 */
+	reload(): Promise<ConfigDiff>;
+	/** Compute the diff between two plain config objects without modifying state */
+	diff(prev: object, next: object): ConfigDiff;
+	/** Register a subscriber to be called after every successful reload */
+	subscribe(fn: ConfigSubscriber): () => void;
+	/** Enter the config factory phase */
+	enterConfig(mode?: FactoryPhaseMode): void;
+	/** Exit the config factory phase */
+	exitConfig(): Error[];
+}
+export interface IWatcher extends EventEmitter<FSWatcherEventMap> {
+	close(): Promise<void>;
+}
+export type HRTime = [
+	number,
+	number
+];
+export interface IPlatformApi {
+	platform: "server" | "browser";
+	loadConfig: (config: string | object) => Promise<{
+		loadedConfig?: object;
+		configRuntime?: IConfigRuntime;
+	}>;
+	readdir: (path: string) => Promise<Dirent[]>;
+	scan: (...path: string[]) => Promise<Dirent[]>;
+	existsSync: (path: string) => boolean;
+	createRequire?: (path: string | URL) => NodeJS.Require;
+	join: (...paths: string[]) => string;
+	dirname: (path: string) => string;
+	basename: (path: string, ext?: string) => string;
+	relative: (from: string, to: string) => string;
+	extname: (path: string) => string;
+	resolve: (...paths: string[]) => string;
+	readFileSync: (path: string, options?: {
+		encoding: BufferEncoding;
+	}) => string | Buffer;
+	writeFileSync: (path: string, data: string | Buffer, options?: {
+		encoding: BufferEncoding;
+	}) => void;
+	statSync: StatSyncFn;
+	watch?: (path: string | string[], options?: ChokidarOptions) => IWatcher;
+	timing: {
+		diff: (time: HRTime, newTime: HRTime) => number;
+		after: (milliseconds: number) => HRTime;
+		now: (previous?: HRTime) => HRTime;
+		isAfter: (time: HRTime, timeout: HRTime) => boolean;
+		spare: (time: HRTime, latency?: number) => number;
+	};
+}
 export interface IErrorFactory {
 	get(type?: string): unknown;
 	fetch(type: string): object;
@@ -17674,6 +17952,9 @@ export interface IApiSchema {
 	}, source: string): Promise<Record<string, GatewaySchema>>;
 	generateFile(file: string): Promise<boolean>;
 	generateDir(dir: string, files: Dirent[]): Promise<boolean>;
+	loadApi(locations: string | string[] | object | object[] | {
+		assets: object;
+	}, source: string): unknown;
 }
 export interface IGateway {
 	route: (validations: Record<string, GatewaySchema>, pkg: {
@@ -17691,6 +17972,7 @@ export type Handlers = ((params: {
 	local: object;
 	literals: object[];
 	gateway: IGateway;
+	apiSchema: IApiSchema;
 }) => void)[];
 export interface IRegistry {
 	start: (configOverride?: object) => Promise<IRegistry>;
@@ -17724,25 +18006,20 @@ export interface IApi {
 	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"];
-	};
+	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;
+	createLog: ILog["logger"];
 	attachCheckpoint?: (meta: IMeta) => void;
 	handlers?: (api: {
 		utError: IError;
@@ -17773,6 +18050,7 @@ export interface IAdapter<T, C> {
 	log?: ILogger;
 	errors?: Errors<IErrorMap>;
 	imported?: ReturnType<IAdapterFactory<T, C>>;
+	importedMap?: Map<string, IRemoteHandler>;
 	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>;
@@ -17794,7 +18072,7 @@ export interface IAdapter<T, C> {
 	}) => 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>;
+	request?: (...params: unknown[]) => Promise<unknown>;
 	publish?: () => Promise<unknown>;
 	drain?: () => void;
 	findValidation?: (this: ReturnType<IAdapterFactory<T, C>>, $meta: IMeta) => () => object;
@@ -17920,10 +18198,6 @@ export interface IMeta {
 		timestamp: number;
 	}>;
 }
-export type HRTime = [
-	number,
-	number
-];
 export interface IContext {
 	trace: number;
 	session?: {
@@ -17992,6 +18266,7 @@ export interface IModuleConfig<T extends TSchema = TNever> {
 	config?: IActivationConfig<Partial<Static<T>> & Partial<Static<IBaseConfig>>>;
 	validation?: T;
 	children?: (string | (() => Promise<object>))[] | ((layer: ModuleApi) => unknown)[];
+	glob?: Record<string, () => Promise<object>>;
 }
 export interface ILogger {
 	trace?: LogFn;
@@ -18054,9 +18329,16 @@ export interface ILib {
 		name: string;
 	};
 	assert: typeof Assert | undefined;
+	yaml: {
+		parse: <T>(source: string, options?: unknown) => T;
+		parseAllDocuments: <T>(source: string, options?: unknown) => T;
+		parseDocument: <T>(source: string, options?: unknown) => T;
+		stringify: (value: unknown, options?: unknown) => string;
+	};
 	ulid: () => string;
 	uuid4: () => string;
 	uuid7: () => string;
+	timing: IPlatformApi["timing"];
 	setProperty: (obj: Record<string, unknown>, path: string, value: unknown) => void;
 	merge<T, S1>(target: T, source: S1): T & S1;
 	merge<T, S1, S2>(target: T, source1: S1, source2: S2): T & S1 & S2;
@@ -18120,6 +18402,7 @@ export interface IHandlerProxy<T> {
 			};
 		};
 	};
+	apiSchema: IApiSchema;
 }
 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>[];
@@ -18162,21 +18445,13 @@ export declare const handler: <T = Record<string, unknown>, C = AdapterContext>(
  * The inner function should return a map whose keys are dot-notation method names
  * (e.g. `'coral.browse'`) and values are async functions that return component
  * metadata `{title, permission, icon, component: async () => ReactComponent}`.
- *
- * @example
- * ```ts
- * export default componentHandler(blong => function coralBrowse() {
- *   return {
- *     'coral.browse': async () => ({
- *       title: 'Browse Corals',
- *       permission: 'marine.coral.browse',
- *       component: async () => (await import('./CoralBrowse.js')).default,
- *     }),
- *   };
- * });
- * ```
  */
-export declare const componentHandler: <T = Record<string, unknown>, C = AdapterContext>(definition: Definition<T, C>) => Definition<T, C>;
+export interface IComponent {
+	title?: string;
+	permission?: string;
+	icon?: string;
+	component: (params?: Record<string, unknown>) => Promise<unknown>;
+}
 /** Action definition for use with `defineActions`. */
 export interface IActionDef {
 	title?: string;
@@ -18216,6 +18491,8 @@ export declare const defineActions: (actions: Record<string, IActionDef>) => ((_
 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 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<[
 	ApiSchema
 ]>>) => ValidationDefinition;
@@ -18225,11 +18502,10 @@ export declare const browser: <T extends TObject>(definition: 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";
-export declare const kind: (what: {}) => Kinds | undefined;
+export type Kinds = "lib" | "validation" | "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>;
-	componentHandler: <T = Record<string, unknown>, C = AdapterContext>(definition: Definition<T, C>) => Definition<T, C>;
 	defineActions: (actions: Record<string, IActionDef>) => ((_blong: unknown) => Record<string, () => IActionDef>);
 	library: <T = Record<string, unknown>>(definition: Lib<T>) => Lib<T>;
 	validation: (validation: ValidationDefinition) => ValidationDefinition;
@@ -18239,7 +18515,8 @@ declare const _default: {
 	browser: <T extends TObject>(definition: SolutionFactory<T>) => SolutionFactory<T>;
 	adapter: <T, C = AdapterContext>(definition: IAdapterFactory<T, C>) => IAdapterFactory<T, C>;
 	orchestrator: <T, C = AdapterContext>(definition: IAdapterFactory<T, C>) => IAdapterFactory<T, C>;
-	kind: (what: {}) => Kinds | undefined;
+	fixture: <T extends IMock>(definition: () => T) => (() => T);
+	kind: (what: {}) => Kinds;
 };
 
 export {

package/dist/types.js

@@ -21,29 +21,6 @@ export class Internal {
     }
 }
 export const handler = (definition) => Object.defineProperty(definition, Kind, { value: 'handler' });
-/**
- * Browser-side equivalent of `handler`.  Use this to define a component handler
- * in a realm's `component/` layer.  Functionally identical to `handler` — the
- * distinction is semantic and makes intent clear in code review.
- *
- * The inner function should return a map whose keys are dot-notation method names
- * (e.g. `'coral.browse'`) and values are async functions that return component
- * metadata `{title, permission, icon, component: async () => ReactComponent}`.
- *
- * @example
- * ```ts
- * export default componentHandler(blong => function coralBrowse() {
- *   return {
- *     'coral.browse': async () => ({
- *       title: 'Browse Corals',
- *       permission: 'marine.coral.browse',
- *       component: async () => (await import('./CoralBrowse.js')).default,
- *     }),
- *   };
- * });
- * ```
- */
-export const componentHandler = (definition) => Object.defineProperty(definition, Kind, { value: 'handler' });
 /**
  * Register action metadata for a realm's browser layer.
  *
@@ -67,6 +44,8 @@ export const defineActions = (actions) => Object.defineProperty((_blong) => Obje
 export const library = (definition) => Object.defineProperty(definition, Kind, { value: 'lib' });
 export const validation = (validation) => Object.defineProperty(validation, Kind, { value: 'validation' });
 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]) => [
     name,
     Object.defineProperty(() => ({
@@ -81,10 +60,9 @@ export const browser = (definition) => Object.defineProperty(definition, Kind, {
 export const layer = (activation) => Object.defineProperty(activation, Kind, { value: 'layer' });
 export const adapter = (definition) => Object.defineProperty(definition, Kind, { value: 'adapter' });
 export const orchestrator = (definition) => Object.defineProperty(definition, Kind, { value: 'orchestrator' });
-export const kind = (what) => what[Kind];
+export const kind = (what) => what[Kind] || '';
 export default {
     handler,
-    componentHandler,
     defineActions,
     library,
     validation,
@@ -94,6 +72,7 @@ export default {
     browser,
     adapter,
     orchestrator,
+    fixture,
     kind,
 };
 //# sourceMappingURL=types.js.map

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.16.0",
+  "version": "1.17.0",
   "description": "API and DRY focused RAD framework https://feasibleone.github.io/blong-docs",
   "keywords": [
     "blong",
@@ -12,8 +12,11 @@
   },
   "type": "module",
   "exports": {
-    ".": "./dist/types.js",
-    "./dev": "./types.ts",
+    ".": {
+      "blong-dev": "./types.ts",
+      "types": "./types.ts",
+      "default": "./dist/types.js"
+    },
     "./types": "./types.ts"
   },
   "dependencies": {
@@ -23,10 +26,9 @@
     "ut-function.merge": "^1.5.6"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "^3.1003.0",
+    "@aws-sdk/client-s3": "^3.1037.0",
     "@keycloak/keycloak-admin-client": "^26.5.4",
     "@kubernetes/client-node": "^1.4.0",
-    "@rushstack/eslint-config": "^4.6.4",
     "@rushstack/heft": "^1.2.6",
     "@rushstack/heft-lint-plugin": "^1.2.6",
     "@rushstack/heft-typescript-plugin": "^1.3.1",
@@ -35,8 +37,8 @@
     "@types/request": "^2.48.13",
     "@types/ut-function.merge": "file:./types/ut-function.merge",
     "bson": "^7.2.0",
+    "chokidar": "^5.0.0",
     "dts-bundle-generator": "^9.5.1",
-    "eslint": "~9.39.2",
     "knex": "^3.1.0",
     "mongodb": "^7.1.0",
     "node-vault": "^0.10.10",

package/types.ts

@@ -24,12 +24,15 @@ import {
     type TUnknown,
 } from 'typebox';
 // import type {client} from 'node-vault';
-import type {Dirent} from 'node:fs';
+import type {ChokidarOptions, FSWatcherEventMap} from 'chokidar';
+import type {EventEmitter} from 'events';
+import type {Dirent, StatSyncFn} 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';
+import type {IMock, IModelSpec} from './model.ts';
 
 // export {
 //     AppsV1Api,
@@ -45,6 +48,7 @@ export type * from 'mongodb';
 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 * from './model.ts';
 
 export type ServerContext = {
     queryBuilder?: Knex;
@@ -75,6 +79,89 @@ export interface ILog {
     child: PinoLogger['child'];
 }
 
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** A flat map of dotted-path → [prev, next] pairs that represent changed keys */
+export type ConfigDiff = Map<string, {prev: unknown; next: unknown}>;
+
+/** Subscriber callback invoked after a successful reload */
+export type ConfigSubscriber = (
+    diff: ConfigDiff,
+    next: object,
+    prev: object,
+) => void | Promise<void>;
+
+/**
+ * Mode used when the config proxy is queried during handler factory initialisation.
+ *
+ * - `'throw'`   — throw immediately (default; keeps misuse from going unnoticed)
+ * - `'collect'` — accumulate errors and return them from exitConfigFactoryPhase()
+ *                 (useful in tests that explicitly verify the anti-pattern is caught)
+ */
+export type FactoryPhaseMode = 'throw' | 'collect';
+export interface IConfigRuntime {
+    /** Current effective config, exposed as a live proxy */
+    readonly snapshot: object;
+    /** Raw (non-proxy) snapshot of the current effective config */
+    readonly rawSnapshot: object;
+    /** Load (or reload) config from all sources; returns the updated snapshot */
+    load(params?: object): Promise<object>;
+    /**
+     * Reload config in-place.  The backing store of the proxy is updated so all
+     * existing proxy references automatically reflect the new values.
+     * Returns the computed diff.
+     */
+    reload(): Promise<ConfigDiff>;
+    /** Compute the diff between two plain config objects without modifying state */
+    diff(prev: object, next: object): ConfigDiff;
+    /** Register a subscriber to be called after every successful reload */
+    subscribe(fn: ConfigSubscriber): () => void;
+    /** Enter the config factory phase */
+    enterConfig(mode?: FactoryPhaseMode): void;
+    /** Exit the config factory phase */
+    exitConfig(): Error[];
+}
+
+export interface IWatcher extends EventEmitter<FSWatcherEventMap> {
+    close(): Promise<void>;
+}
+
+export type HRTime = [number, number];
+
+export interface IPlatformApi {
+    platform: 'server' | 'browser';
+    loadConfig: (
+        config: string | object,
+    ) => Promise<{loadedConfig?: object; configRuntime?: IConfigRuntime}>;
+    readdir: (path: string) => Promise<Dirent[]>;
+    scan: (...path: string[]) => Promise<Dirent[]>;
+    existsSync: (path: string) => boolean;
+    createRequire?: (path: string | URL) => NodeJS.Require;
+    join: (...paths: string[]) => string;
+    dirname: (path: string) => string;
+    basename: (path: string, ext?: string) => string;
+    relative: (from: string, to: string) => string;
+    extname: (path: string) => string;
+    resolve: (...paths: string[]) => string;
+    readFileSync: (path: string, options?: {encoding: BufferEncoding}) => string | Buffer;
+    writeFileSync: (
+        path: string,
+        data: string | Buffer,
+        options?: {encoding: BufferEncoding},
+    ) => void;
+    statSync: StatSyncFn;
+    watch?: (path: string | string[], options?: ChokidarOptions) => IWatcher;
+    timing: {
+        diff: (time: HRTime, newTime: HRTime) => number;
+        after: (milliseconds: number) => HRTime;
+        now: (previous?: HRTime) => HRTime;
+        isAfter: (time: HRTime, timeout: HRTime) => boolean;
+        spare: (time: HRTime, latency?: number) => number;
+    };
+}
+
 export interface IErrorFactory {
     get(type?: string): unknown;
     fetch(type: string): object;
@@ -160,6 +247,10 @@ export interface IApiSchema {
     ): Promise<Record<string, GatewaySchema>>;
     generateFile(file: string): Promise<boolean>;
     generateDir(dir: string, files: Dirent[]): Promise<boolean>;
+    loadApi(
+        locations: string | string[] | object | object[] | {assets: object},
+        source: string,
+    ): unknown;
 }
 
 export interface IGateway {
@@ -179,6 +270,7 @@ export type Handlers = ((params: {
     local: object;
     literals: object[];
     gateway: IGateway;
+    apiSchema: IApiSchema;
 }) => void)[];
 
 export interface IRegistry {
@@ -220,24 +312,19 @@ export interface IApi {
     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'];
-    };
+    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;
+    createLog: ILog['logger'];
     attachCheckpoint?: (meta: IMeta) => void;
     handlers?: (api: {utError: IError; remote: IRemote; type: typeof Type}) => {
         extends?:
@@ -270,6 +357,7 @@ export interface IAdapter<T, C> {
     log?: ILogger;
     errors?: Errors<IErrorMap>;
     imported?: ReturnType<IAdapterFactory<T, C>>;
+    importedMap?: Map<string, IRemoteHandler>;
     extends?: object | `adapter.${string}` | `orchestrator.${string}`;
     activeConfig?: (this: ReturnType<IAdapterFactory<T, C>>) => Partial<Config<T, C>>;
     init?: (
@@ -296,7 +384,7 @@ export interface IAdapter<T, C> {
     ) => 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>;
+    request?: (...params: unknown[]) => Promise<unknown>;
     publish?: () => Promise<unknown>;
     drain?: () => void;
     findValidation?: (this: ReturnType<IAdapterFactory<T, C>>, $meta: IMeta) => () => object;
@@ -422,8 +510,6 @@ export interface IMeta {
     checkpoints?: Array<{name: string; data?: unknown; timestamp: number}>;
 }
 
-export type HRTime = [number, number];
-
 export interface IContext {
     trace: number;
     session?: {
@@ -493,6 +579,7 @@ export interface IModuleConfig<T extends TSchema = TNever> {
     config?: IActivationConfig<Partial<Static<T>> & Partial<Static<IBaseConfig>>>;
     validation?: T;
     children?: (string | (() => Promise<object>))[] | ((layer: ModuleApi) => unknown)[];
+    glob?: Record<string, () => Promise<object>>;
 }
 
 export interface ILogger {
@@ -567,9 +654,16 @@ export interface ILib {
     /** @deprecated The framework now auto-names step arrays from handler names. */
     group: (name: string) => (handlers: ChainStep[]) => ChainStep[] & {name: string};
     assert: typeof Assert | undefined;
+    yaml: {
+        parse: <T>(source: string, options?: unknown) => T;
+        parseAllDocuments: <T>(source: string, options?: unknown) => T;
+        parseDocument: <T>(source: string, options?: unknown) => T;
+        stringify: (value: unknown, options?: unknown) => string;
+    };
     ulid: () => string;
     uuid4: () => string;
     uuid7: () => string;
+    timing: IPlatformApi['timing'];
     setProperty: (obj: Record<string, unknown>, path: string, value: unknown) => void;
     merge<T, S1>(target: T, source: S1): T & S1;
     merge<T, S1, S2>(target: T, source1: S1, source2: S2): T & S1 & S2;
@@ -639,6 +733,7 @@ export interface IHandlerProxy<T> {
     gateway: {
         config: () => {public: {sign: object; encrypt: object}};
     };
+    apiSchema: IApiSchema;
 }
 
 export type ImportProxyCallback<T, C> = (
@@ -705,23 +800,13 @@ export const handler = <T = Record<string, unknown>, C = AdapterContext>(
  * The inner function should return a map whose keys are dot-notation method names
  * (e.g. `'coral.browse'`) and values are async functions that return component
  * metadata `{title, permission, icon, component: async () => ReactComponent}`.
- *
- * @example
- * ```ts
- * export default componentHandler(blong => function coralBrowse() {
- *   return {
- *     'coral.browse': async () => ({
- *       title: 'Browse Corals',
- *       permission: 'marine.coral.browse',
- *       component: async () => (await import('./CoralBrowse.js')).default,
- *     }),
- *   };
- * });
- * ```
  */
-export const componentHandler = <T = Record<string, unknown>, C = AdapterContext>(
-    definition: Definition<T, C>,
-): Definition<T, C> => Object.defineProperty(definition, Kind, {value: 'handler'});
+export interface IComponent {
+    title?: string;
+    permission?: string;
+    icon?: string;
+    component: (params?: Record<string, unknown>) => Promise<unknown>;
+}
 
 /** Action definition for use with `defineActions`. */
 export interface IActionDef {
@@ -737,7 +822,9 @@ export interface IActionDef {
     /** Action names whose query caches should be invalidated on success. */
     invalidates?: string[];
     /** Static params merged into every invocation. */
-    params?: Record<string, unknown> | ((params: Record<string, unknown>) => Record<string, unknown>);
+    params?:
+        | Record<string, unknown>
+        | ((params: Record<string, unknown>) => Record<string, unknown>);
 }
 
 /**
@@ -764,9 +851,7 @@ export const defineActions = (
 ): ((_blong: unknown) => Record<string, () => IActionDef>) =>
     Object.defineProperty(
         (_blong: unknown) =>
-            Object.fromEntries(
-                Object.entries(actions).map(([key, value]) => [key, () => value]),
-            ),
+            Object.fromEntries(Object.entries(actions).map(([key, value]) => [key, () => value])),
         Kind,
         {value: 'handler'},
     );
@@ -777,6 +862,11 @@ export const validation = (validation: ValidationDefinition): ValidationDefiniti
     Object.defineProperty(validation, Kind, {value: 'validation'});
 export const api = (api: ApiDefinition): ApiDefinition =>
     Object.defineProperty(api, Kind, {value: 'api'});
+export const model = <T extends IModelSpec>(
+    definition: () => () => Promise<T>,
+): (() => () => Promise<T>) => Object.defineProperty(definition, Kind, {value: 'model'});
+export const fixture = <T extends IMock>(definition: () => T): (() => T) =>
+    Object.defineProperty(definition, Kind, {value: 'fixture'});
 
 export const validationHandlers: (
     handlers: Record<string, TFunction<[ApiSchema]>>,
@@ -813,6 +903,7 @@ export const adapter = <T, C = AdapterContext>(
 export const orchestrator = <T, C = AdapterContext>(
     definition: IAdapterFactory<T, C>,
 ): IAdapterFactory<T, C> => Object.defineProperty(definition, Kind, {value: 'orchestrator'});
+
 export type Kinds =
     | 'lib'
     | 'validation'
@@ -822,12 +913,14 @@ export type Kinds =
     | 'browser'
     | 'adapter'
     | 'orchestrator'
-    | 'handler';
-export const kind = (what: {[Kind]: Kinds | undefined}): Kinds | undefined => what[Kind];
+    | 'handler'
+    | 'model'
+    | 'fixture'
+    | '';
+export const kind = (what: {[Kind]: Kinds | undefined}): Kinds => what[Kind] || '';
 
 export default {
     handler,
-    componentHandler,
     defineActions,
     library,
     validation,
@@ -837,5 +930,6 @@ export default {
     browser,
     adapter,
     orchestrator,
+    fixture,
     kind,
 };