@feasibleone/blong 1.21.0 → 1.23.0

package/dist/types.js

@@ -0,0 +1,68 @@
+import { Type, } from 'typebox';
+import merge from 'ut-function.merge';
+const Kind = Symbol.for('blong:kind');
+export class Internal {
+    #log;
+    log;
+    constructor(api) {
+        this.#log = api?.log;
+    }
+    merge = (...args) => {
+        const result = merge(...args);
+        if (result.logLevel && this.#log)
+            this.log = this.#log.logger(result.logLevel, { name: this.constructor.name });
+        return result;
+    };
+    async stop() {
+        return this;
+    }
+    async start(..._args) {
+        return this;
+    }
+}
+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(async () => 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 = (definition) => Object.defineProperty(definition, Kind, {
+    value: 'solution',
+});
+export const server = (definition) => Object.defineProperty(definition, Kind, {
+    value: 'server',
+});
+export const browser = (definition) => Object.defineProperty(definition, Kind, {
+    value: 'browser',
+});
+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 default {
+    handler,
+    library,
+    validation,
+    api,
+    realm,
+    server,
+    browser,
+    adapter,
+    orchestrator,
+    fixture,
+    kind,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}

package/dist/widget.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=widget.js.map

package/dist/widget.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feasibleone/blong",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "API and DRY focused RAD framework https://feasibleone.github.io/blong-docs",
   "keywords": [
     "blong",
@@ -27,7 +27,7 @@
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.1037.0",
-    "@keycloak/keycloak-admin-client": "^26.5.4",
+    "@keycloak/keycloak-admin-client": "^26.6.2",
     "@kubernetes/client-node": "^1.4.0",
     "@rushstack/heft": "^1.2.6",
     "@rushstack/heft-lint-plugin": "^1.2.6",
@@ -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.1"
+    "@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');
@@ -919,58 +1030,15 @@ export interface IComponent {
     component: (params?: Record<string, unknown>) => Promise<unknown>;
 }
 
-/** Action definition for use with `defineActions`. */
-export interface IActionDef {
-    title?: string;
-    permission?: string;
-    icon?: string;
-    /** Lazy-load a page component (page action). */
-    component?: () => Promise<unknown>;
-    /** Bus method name to invoke (query or mutation action). */
-    method?: string;
-    /** When true the action mutates data and should invalidate related caches. */
-    mutates?: boolean;
-    /** 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>);
-}
-
-/**
- * Register action metadata for a realm's browser layer.
- *
- * Returns a handler-compatible function that the blong framework loads from
- * the realm's `actions/` or `action/` folder.  Each entry in `actions` is
- * wrapped in a no-argument function so the framework can call it as a method.
- *
- * @example
- * ```ts
- * // marine/actions/index.ts
- * export default defineActions({
- *   'marine.coral.browse': {
- *     title: 'Browse Corals',
- *     permission: 'marine.coral.browse',
- *     component: () => import('./components/CoralBrowse.js'),
- *   },
- * });
- * ```
- */
-export const defineActions = (
-    actions: Record<string, IActionDef>,
-): ((_blong: unknown) => Record<string, () => IActionDef>) =>
-    Object.defineProperty(
-        () => Object.fromEntries(Object.entries(actions).map(([key, value]) => [key, () => value])),
-        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 =>
+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>,
@@ -978,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,
@@ -1036,6 +1104,7 @@ export const orchestrator = <T, C = AdapterContext>(
 export type Kinds =
     | 'lib'
     | 'validation'
+    | 'schema'
     | 'api'
     | 'solution'
     | 'server'
@@ -1050,7 +1119,6 @@ export const kind = (what: {[Kind]: Kinds | undefined}): Kinds => what[Kind] ||
 
 export default {
     handler,
-    defineActions,
     library,
     validation,
     api,