@bsb/base 9.0.4 → 9.1.0

package/lib/plugins/service-default2/index.js

@@ -0,0 +1,132 @@
+/**
+ * BSB (Better-Service-Base) is an event-bus based microservice framework.
+ * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alternatively, you may obtain a commercial license for this program.
+ * The commercial license allows you to use the Program in a closed-source manner,
+ * including the right to create derivative works that are not subject to the terms
+ * of the AGPL.
+ *
+ * To obtain a commercial license, please contact the copyright holders at
+ * https://www.bettercorp.dev. The terms and conditions of the commercial license
+ * will be provided upon request.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { ServiceClient } from "../../index.js";
+import { BSBService, createConfigSchema, bsb, optional } from "../../base/index.js";
+import { Plugin as Service1 } from "../service-default1/index.js";
+import { Plugin as Service3 } from "../service-default3/index.js";
+import { createEventSchemas, createFireAndForgetEvent, createReturnableEvent, createBroadcastEvent } from "../../interfaces/schema-events.js";
+import * as av from "@anyvali/js";
+export const Config = createConfigSchema({
+    name: 'service-default2',
+    description: 'Default service plugin 2 for testing inter-service communication',
+    image: '../docs/public/assets/images/bsb-logo.png',
+    tags: ['default', 'example', 'test'],
+}, av.optional(av.object({}, { unknownKeys: "strip" })).default({}));
+export const EventSchemas = createEventSchemas({
+    // Events this service emits (fire-and-forget, first listener receives)
+    emitEvents: {
+        'task.completed': createFireAndForgetEvent(bsb.object({
+            taskId: bsb.string({ description: 'Task identifier' }),
+            duration: bsb.number({ description: 'Task duration in milliseconds' }),
+            success: bsb.boolean('Whether the task completed successfully')
+        }, 'Task completion parameters'), 'Emitted when a task is completed')
+    },
+    // Events this service listens to (fire-and-forget)
+    onEvents: {
+        'task.assigned': createFireAndForgetEvent(bsb.object({
+            taskId: bsb.string({ description: 'Task identifier' }),
+            type: bsb.string({ description: 'Task type' }),
+            priority: bsb.enum(['low', 'medium', 'high', 'urgent'], 'Task priority level')
+        }, 'Task assignment parameters'), 'Handle new task assignments')
+    },
+    // Returnable events this service emits (requests from this service)
+    emitReturnableEvents: {
+        'resource.request': createReturnableEvent(bsb.object({
+            resourceType: bsb.string({ description: 'Type of resource requested' }),
+            amount: bsb.number({ description: 'Amount of resources needed' }),
+            timeout: optional(bsb.number({ description: 'Request timeout in milliseconds' }))
+        }, 'Resource request parameters'), bsb.object({
+            allocated: bsb.boolean('Whether resources were allocated'),
+            resourceId: optional(bsb.string({ description: 'Allocated resource identifier' })),
+            waitTime: optional(bsb.number({ description: 'Wait time in milliseconds' }))
+        }, 'Resource allocation response'), 'Request resource allocation')
+    },
+    // Returnable events this service listens to (requests to this service)
+    onReturnableEvents: {
+        calculate: createReturnableEvent(bsb.object({
+            a: bsb.number({ description: 'First number' }),
+            b: bsb.number({ description: 'Second number' })
+        }, 'Calculate input parameters'), bsb.number({ description: 'Calculation result' }), 'Calculate with two numbers'),
+        'health.check': createReturnableEvent(bsb.object({
+            includeDetails: bsb.boolean('Whether to include detailed information')
+        }, 'Health check parameters'), bsb.object({
+            status: bsb.enum(['healthy', 'degraded', 'unhealthy'], 'Service health status'),
+            uptime: bsb.number({ description: 'Service uptime in milliseconds' }),
+            details: optional(bsb.record(bsb.string({ description: 'Detail key' }), bsb.unknown('Detail value'), 'Health check details'))
+        }, 'Health check response'), 'Perform health check')
+    },
+    // Broadcast events this service emits (all listeners receive)
+    emitBroadcast: {
+        'metrics.report': createBroadcastEvent(bsb.object({
+            timestamp: bsb.datetime('Metrics timestamp'),
+            metrics: bsb.record(bsb.string({ description: 'Metric name' }), bsb.number({ description: 'Metric value' }), 'Performance metrics'),
+            period: bsb.string({ description: 'Reporting period' })
+        }, 'Metrics report parameters'), 'Broadcast performance metrics')
+    },
+    // Broadcast events this service listens to
+    onBroadcast: {
+        'emergency.stop': createBroadcastEvent(bsb.object({
+            reason: bsb.string({ description: 'Emergency stop reason' }),
+            immediate: bsb.boolean('Whether to stop immediately without cleanup')
+        }, 'Emergency stop parameters'), 'Listen for emergency stop broadcasts')
+    }
+});
+export class Plugin extends BSBService {
+    static Config = Config;
+    static EventSchemas = EventSchemas;
+    // PLUGIN_CLIENT auto-generated from Config.metadata
+    initBeforePlugins;
+    runBeforePlugins;
+    runAfterPlugins;
+    initAfterPlugins = [];
+    service1;
+    service3;
+    constructor(config) {
+        super(config);
+        this.service1 = new ServiceClient(Service1, this);
+        this.service3 = new ServiceClient(Service3, this);
+    }
+    async init(obs) {
+        this.events.onReturnableEvent("calculate", obs, async (obs, input) => {
+            obs.log.info("Calculating {a} * {b}", { a: input.a, b: input.b });
+            return input.a * input.b;
+        });
+    }
+    async run(obs) {
+        obs.log.info("Running service-default2");
+        const result = await this.service1.events.emitEventAndReturn("calculate", obs, {
+            a: 5,
+            b: 5
+        }, 5);
+        await this.service3.events.onReturnableEvent("calculate", obs, async (obs, input) => {
+            obs.log.info("Calculating {a} * {b}", { a: input.a, b: input.b });
+            return input.a * input.b;
+        });
+        obs.log.info("Calculation result: {result}", { result });
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/service-default2/index.js.map

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

package/lib/plugins/service-default3/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * BSB (Better-Service-Base) is an event-bus based microservice framework.
+ * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alternatively, you may obtain a commercial license for this program.
+ * The commercial license allows you to use the Program in a closed-source manner,
+ * including the right to create derivative works that are not subject to the terms
+ * of the AGPL.
+ *
+ * To obtain a commercial license, please contact the copyright holders at
+ * https://www.bettercorp.dev. The terms and conditions of the commercial license
+ * will be provided upon request.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import * as av from "@anyvali/js";
+import { BSBService, BSBServiceConstructor } from "../../base/index.js";
+import { Observable } from "../../interfaces/index.js";
+export declare const Config: import("../../base/PluginConfig.js").BSBPluginConfigClass<av.OptionalSchema<av.ObjectSchema<{}>>>;
+export declare const EventSchemas: {
+    readonly onReturnableEvents: {
+        readonly onReverseReturnable: {
+            input: av.ObjectSchema<{
+                text: av.StringSchema;
+            }>;
+            output: av.StringSchema;
+            description?: string;
+            defaultTimeout?: number;
+            readonly __brand: "returnable";
+        };
+    };
+    readonly emitReturnableEvents: {
+        readonly calculate: {
+            input: av.ObjectSchema<{
+                a: import("../../interfaces/schema-types.js").BSBType;
+                b: import("../../interfaces/schema-types.js").BSBType;
+            }>;
+            output: import("../../interfaces/schema-types.js").BSBType;
+            description?: string;
+            defaultTimeout?: number;
+            readonly __brand: "returnable";
+        };
+    };
+};
+export declare class Plugin extends BSBService<InstanceType<typeof Config>, typeof EventSchemas> {
+    static Config: import("../../base/PluginConfig.js").BSBPluginConfigClass<av.OptionalSchema<av.ObjectSchema<{}>>>;
+    static EventSchemas: {
+        readonly onReturnableEvents: {
+            readonly onReverseReturnable: {
+                input: av.ObjectSchema<{
+                    text: av.StringSchema;
+                }>;
+                output: av.StringSchema;
+                description?: string;
+                defaultTimeout?: number;
+                readonly __brand: "returnable";
+            };
+        };
+        readonly emitReturnableEvents: {
+            readonly calculate: {
+                input: av.ObjectSchema<{
+                    a: import("../../interfaces/schema-types.js").BSBType;
+                    b: import("../../interfaces/schema-types.js").BSBType;
+                }>;
+                output: import("../../interfaces/schema-types.js").BSBType;
+                description?: string;
+                defaultTimeout?: number;
+                readonly __brand: "returnable";
+            };
+        };
+    };
+    initBeforePlugins?: string[] | undefined;
+    runBeforePlugins?: string[] | undefined;
+    runAfterPlugins?: string[] | undefined;
+    initAfterPlugins: string[];
+    dispose?(): void;
+    constructor(config: BSBServiceConstructor<InstanceType<typeof Config>, typeof EventSchemas>);
+    init(obs: Observable): Promise<void>;
+    run(obs: Observable): Promise<void>;
+}

package/lib/plugins/service-default3/index.js

@@ -0,0 +1,83 @@
+/**
+ * BSB (Better-Service-Base) is an event-bus based microservice framework.
+ * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alternatively, you may obtain a commercial license for this program.
+ * The commercial license allows you to use the Program in a closed-source manner,
+ * including the right to create derivative works that are not subject to the terms
+ * of the AGPL.
+ *
+ * To obtain a commercial license, please contact the copyright holders at
+ * https://www.bettercorp.dev. The terms and conditions of the commercial license
+ * will be provided upon request.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import * as av from "@anyvali/js";
+import { BSBService, createConfigSchema, bsb } from "../../base/index.js";
+import { createEventSchemas, createReturnableEvent } from "../../interfaces/schema-events.js";
+export const Config = createConfigSchema({
+    name: 'service-default3',
+    description: 'Default service plugin 3 for testing',
+    image: '../docs/public/assets/images/bsb-logo.png',
+    tags: ['default', 'example', 'test'],
+    initAfterPlugins: ['service-default2'],
+}, av.optional(av.object({}, { unknownKeys: "strip" })).default({}));
+export const EventSchemas = createEventSchemas({
+    onReturnableEvents: {
+        onReverseReturnable: createReturnableEvent(bsb.object({
+            text: bsb.string({ description: 'Text to reverse' })
+        }, 'Reverse input parameters'), bsb.string({ description: 'Reversed text' }), 'Reverse a string')
+    },
+    emitReturnableEvents: {
+        calculate: createReturnableEvent(bsb.object({
+            a: bsb.number({ description: 'First number' }),
+            b: bsb.number({ description: 'Second number' })
+        }, 'Calculate input parameters'), bsb.number({ description: 'Calculation result' }), 'Calculate with two numbers')
+    }
+});
+export class Plugin extends BSBService {
+    static Config = Config;
+    static EventSchemas = EventSchemas;
+    // PLUGIN_CLIENT auto-generated from Config.metadata
+    initBeforePlugins;
+    runBeforePlugins;
+    runAfterPlugins;
+    initAfterPlugins = ["service-default2"];
+    constructor(config) {
+        super(config);
+    }
+    async init(obs) {
+        obs.log.info("Initializing service-default3");
+        await this.events.onReturnableEvent("onReverseReturnable", obs, async (obs, input) => {
+            obs.log.warn("onReverseReturnable ({text})", { text: input.text });
+            return input.text.split("").reverse().join("");
+        });
+    }
+    async run(obs) {
+        obs.log.info("Running service-default3");
+        // NEW API: Use events to calculate with object parameter
+        const result = await this.events.emitEventAndReturn("calculate", obs, {
+            a: 18,
+            b: 19
+        }, 5 // timeout
+        );
+        obs.log.info("Calculation result: {result}", { result });
+        obs.log.debug("Debug {a}", { a: "IT IS AN DEBUG!" });
+        obs.log.info("Info {a}", { a: "IT IS AN INFO!" });
+        obs.log.warn("Warning {a}", { a: "IT IS AN WARNING!" });
+        obs.log.error("Error {a}", { a: "IT IS AN ERROR!" });
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/service-default3/index.js.map

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

package/lib/plugins/service-default4/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * BSB (Better-Service-Base) is an event-bus based microservice framework.
+ * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alternatively, you may obtain a commercial license for this program.
+ * The commercial license allows you to use the Program in a closed-source manner,
+ * including the right to create derivative works that are not subject to the terms
+ * of the AGPL.
+ *
+ * To obtain a commercial license, please contact the copyright holders at
+ * https://www.bettercorp.dev. The terms and conditions of the commercial license
+ * will be provided upon request.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { Observable } from "../../index.js";
+import { BSBService, BSBServiceConstructor } from "../../base/index.js";
+import * as av from "@anyvali/js";
+export declare const Config: import("../../index.js").BSBPluginConfigClass<av.OptionalSchema<av.ObjectSchema<{}>>>;
+export declare const EventSchemas: {
+    readonly emitReturnableEvents: {
+        readonly onReverseReturnable: {
+            input: av.ObjectSchema<{
+                text: av.StringSchema;
+            }>;
+            output: av.StringSchema;
+            description?: string;
+            defaultTimeout?: number;
+            readonly __brand: "returnable";
+        };
+    };
+};
+export declare class Plugin extends BSBService<InstanceType<typeof Config>, typeof EventSchemas> {
+    static Config: import("../../index.js").BSBPluginConfigClass<av.OptionalSchema<av.ObjectSchema<{}>>>;
+    static EventSchemas: {
+        readonly emitReturnableEvents: {
+            readonly onReverseReturnable: {
+                input: av.ObjectSchema<{
+                    text: av.StringSchema;
+                }>;
+                output: av.StringSchema;
+                description?: string;
+                defaultTimeout?: number;
+                readonly __brand: "returnable";
+            };
+        };
+    };
+    initBeforePlugins?: string[] | undefined;
+    runBeforePlugins?: string[] | undefined;
+    runAfterPlugins?: string[] | undefined;
+    initAfterPlugins: string[];
+    dispose?(): void;
+    init?(): void | Promise<void>;
+    constructor(config: BSBServiceConstructor<InstanceType<typeof Config>, typeof EventSchemas>);
+    run(obs: Observable): Promise<void>;
+}

package/lib/{tests.js → plugins/service-default4/index.js}

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * BSB (Better-Service-Base) is an event-bus based microservice framework.
  * Copyright (C) 2016 - 2025 BetterCorp (PTY) Ltd
@@ -25,20 +24,35 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+import { BSBService, createConfigSchema, bsb } from "../../base/index.js";
+import { createEventSchemas, createReturnableEvent } from "../../interfaces/schema-events.js";
+import * as av from "@anyvali/js";
+export const Config = createConfigSchema({
+    name: 'service-default4',
+    description: 'Default service plugin 4 for testing',
+    image: '../docs/public/assets/images/bsb-logo.png',
+    tags: ['default', 'example', 'test'],
+}, av.optional(av.object({}, { unknownKeys: "strip" })).default({}));
+export const EventSchemas = createEventSchemas({
+    emitReturnableEvents: {
+        onReverseReturnable: createReturnableEvent(bsb.object({
+            text: bsb.string({ description: 'Text to reverse' })
+        }, 'Reverse input parameters'), bsb.string({ description: 'Reversed text' }), 'Reverse text string')
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./tests/sb/plugins/events"), exports);
-//# sourceMappingURL=tests.js.map
+});
+export class Plugin extends BSBService {
+    static Config = Config;
+    static EventSchemas = EventSchemas;
+    // PLUGIN_CLIENT auto-generated from Config.metadata
+    initBeforePlugins;
+    runBeforePlugins;
+    runAfterPlugins;
+    initAfterPlugins = [];
+    constructor(config) {
+        super(config);
+    }
+    async run(obs) {
+        obs.log.info("Running service-default4");
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/service-default4/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/service-default4/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,UAAU,EAAyB,kBAAkB,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,MAAM,GAAG,kBAAkB,CACtC;IACE,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,sCAAsC;IACnD,KAAK,EAAE,2CAA2C;IAClD,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC;CACrC,EACD,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CACjE,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;IAC7C,oBAAoB,EAAE;QACpB,mBAAmB,EAAE,qBAAqB,CACxC,GAAG,CAAC,MAAM,CAAC;YACT,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;SACrD,EAAE,0BAA0B,CAAC,EAC9B,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,EAC5C,qBAAqB,CACtB;KACF;CACF,CAAC,CAAC;AAEH,MAAM,OAAO,MAAO,SAAQ,UAA4D;IACtF,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,oDAAoD;IAE7C,iBAAiB,CAAwB;IACzC,gBAAgB,CAAwB;IACxC,eAAe,CAAwB;IAC9B,gBAAgB,GAAa,EAAE,CAAC;IAKhD,YAAY,MAA+E;QACzF,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEe,KAAK,CAAC,GAAG,CAAC,GAAe;QACvC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC3C,CAAC"}

package/lib/schemas/config-default.json

@@ -1,7 +1,7 @@
 {
   "pluginName": "config-default",
-  "version": "1.0.0",
   "events": {},
+  "version": "9.1.0",
   "pluginType": "config",
   "capabilities": {
     "configApi": {
@@ -13,22 +13,30 @@
     }
   },
   "configSchema": {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "type": "object",
-    "properties": {
-      "BSB_PROFILE": {
-        "default": "default",
-        "type": "string"
+    "anyvaliVersion": "1.0",
+    "schemaVersion": "1",
+    "root": {
+      "kind": "object",
+      "properties": {
+        "BSB_PROFILE": {
+          "kind": "optional",
+          "inner": {
+            "kind": "string"
+          },
+          "default": "default"
+        },
+        "BSB_CONFIG_FILE": {
+          "kind": "optional",
+          "inner": {
+            "kind": "string"
+          },
+          "default": "./sec-config.yaml"
+        }
       },
-      "BSB_CONFIG_FILE": {
-        "default": "./sec-config.yaml",
-        "type": "string"
-      }
+      "required": [],
+      "unknownKeys": "strip"
     },
-    "required": [
-      "BSB_PROFILE",
-      "BSB_CONFIG_FILE"
-    ],
-    "additionalProperties": false
+    "definitions": {},
+    "extensions": {}
   }
 }

package/lib/schemas/config-default.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "config-default",
   "name": "config-default",
-  "version": "9.0.4",
+  "version": "9.1.0",
   "description": "Default configuration plugin for profile and plugin resolution",
   "category": "config",
   "tags": [
@@ -16,22 +16,30 @@
   "dependencies": [],
   "image": "../docs/public/assets/images/bsb-logo.png",
   "configSchema": {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "type": "object",
-    "properties": {
-      "BSB_PROFILE": {
-        "default": "default",
-        "type": "string"
+    "anyvaliVersion": "1.0",
+    "schemaVersion": "1",
+    "root": {
+      "kind": "object",
+      "properties": {
+        "BSB_PROFILE": {
+          "kind": "optional",
+          "inner": {
+            "kind": "string"
+          },
+          "default": "default"
+        },
+        "BSB_CONFIG_FILE": {
+          "kind": "optional",
+          "inner": {
+            "kind": "string"
+          },
+          "default": "./sec-config.yaml"
+        }
       },
-      "BSB_CONFIG_FILE": {
-        "default": "./sec-config.yaml",
-        "type": "string"
-      }
+      "required": [],
+      "unknownKeys": "strip"
     },
-    "required": [
-      "BSB_PROFILE",
-      "BSB_CONFIG_FILE"
-    ],
-    "additionalProperties": false
+    "definitions": {},
+    "extensions": {}
   }
 }

package/lib/schemas/events-default.json

@@ -1,7 +1,7 @@
 {
   "pluginName": "events-default",
-  "version": "1.0.0",
   "events": {},
+  "version": "9.1.0",
   "pluginType": "events",
   "capabilities": {
     "eventsApi": {

package/lib/schemas/events-default.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "events-default",
   "name": "events-default",
-  "version": "9.0.4",
+  "version": "9.1.0",
   "description": "Default in-process events plugin for BSB event routing",
   "category": "events",
   "tags": [

package/lib/schemas/observable-default.json

@@ -1,7 +1,7 @@
 {
   "pluginName": "observable-default",
-  "version": "1.0.0",
   "events": {},
+  "version": "9.1.0",
   "pluginType": "observable",
   "capabilities": {
     "logging": {
@@ -25,9 +25,19 @@
     }
   },
   "configSchema": {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "type": "object",
-    "properties": {},
-    "additionalProperties": false
+    "anyvaliVersion": "1.0",
+    "schemaVersion": "1",
+    "root": {
+      "kind": "optional",
+      "inner": {
+        "kind": "object",
+        "properties": {},
+        "required": [],
+        "unknownKeys": "strip"
+      },
+      "default": {}
+    },
+    "definitions": {},
+    "extensions": {}
   }
 }

package/lib/schemas/observable-default.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "observable-default",
   "name": "observable-default",
-  "version": "9.0.4",
+  "version": "9.1.0",
   "description": "Default console observable plugin for logging output",
   "category": "observable",
   "tags": [
@@ -17,9 +17,19 @@
   "dependencies": [],
   "image": "../docs/public/assets/images/bsb-logo.png",
   "configSchema": {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "type": "object",
-    "properties": {},
-    "additionalProperties": false
+    "anyvaliVersion": "1.0",
+    "schemaVersion": "1",
+    "root": {
+      "kind": "optional",
+      "inner": {
+        "kind": "object",
+        "properties": {},
+        "required": [],
+        "unknownKeys": "strip"
+      },
+      "default": {}
+    },
+    "definitions": {},
+    "extensions": {}
   }
 }