@feasibleone/blong 1.24.0 → 1.25.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.24.0",
+  "version": "1.25.0",
   "description": "API and DRY focused RAD framework https://feasibleone.github.io/blong-docs",
   "keywords": [
     "blong",

package/types.ts

@@ -586,6 +586,7 @@ export interface IMeta {
         redirect?: string;
         code?: number;
         state?: unknown[];
+        unstate?: unknown[];
         header?: string[] | [string, unknown][];
     };
     httpRequest?: {
@@ -599,6 +600,10 @@ export interface IMeta {
         permissionMap?: Buffer;
         actorId?: string | number;
         sessionId?: string;
+        /** Audit record id of the access-check audit recorded for this request. */
+        auditId?: string;
+        /** Allowed action methodIds — populated by the gateway authorize handler. */
+        actions?: string[];
     };
     language?: {
         languageId?: string | number;
@@ -667,6 +672,7 @@ export interface ITypedError extends Error {
     method?: string | string[];
     params?: object;
     code?: string;
+    silent?: boolean;
     req?: {
         httpVersion: string;
         url: URL;
@@ -806,6 +812,19 @@ export type GatewaySchema = (
     bundle?: string;
     creditCost?: number;
     meter?: boolean;
+    /**
+     * Opt this route OUT of the gateway access-check audit (`gateway.audit`).
+     * Use for operations that record their own audit trail (e.g. payments)
+     * or that must not generate audit noise (e.g. integration-test probes).
+     */
+    audit?: boolean;
+    /**
+     * Authenticate the route (bearer) but skip the RBAC action-list check.
+     * Use ONLY for self-service methods that operate on the caller's own
+     * session (e.g. `login.token.revoke`) — the action is scoped by the
+     * token's own `ses` claim, so no cross-user action is possible.
+     */
+    skipAuthorize?: boolean;
 };
 
 export type SchemaObject = OpenAPIV3_1.SchemaObject | OpenAPIV2.SchemaObject;
@@ -919,6 +938,16 @@ export interface ILib {
             level?: 'info' | 'warn';
         },
     ) => Promise<T>;
+    /**
+     * Optional map of configurable method/handler bindings that a library may
+     * expose under the conventional `methods` member — the idiomatic way to
+     * bundle soft dependencies (e.g. the access-realm methods that blong-login's
+     * `sessionLib` resolves from config).  Handlers read the resolved handlers
+     * through `lib.methods.<name>`; each value is a bound handler or `undefined`
+     * when the binding is disabled.  See the blong-handler skill →
+     * "Library as a configurable-bindings bundle (soft dependencies)".
+     */
+    methods?: LibMethods;
 }
 
 export type ValidationFn = () => GatewaySchema;
@@ -968,6 +997,15 @@ export type PortHandlerBound = (<T>(
     [name: string]: PortHandlerBound;
 };
 export type LibFn = <T>(...params: unknown[]) => T;
+/**
+ * A map of configurable handler/method bindings exposed by a library under the
+ * conventional `methods` member (see the blong-handler skill).  Values are
+ * bound handlers (usually resolved from config against the `handler` proxy);
+ * `undefined` when the binding is disabled.
+ */
+export type LibMethods = {
+    [method: string]: LibFn | undefined;
+};
 export interface IRemoteHandler {
     [name: string]: PortHandlerBound;
 }