@cyberismo/backend 1.1.1 → 1.2.0

package/dist/project-errors.js

@@ -0,0 +1,25 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2026
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  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/>.
+*/
+/** Formats errors as one block per project, capping each at `limit` lines. */
+export function formatProjectErrors(groups, limit = 10) {
+    const heading = `${groups.length} ${groups.length === 1 ? 'project has' : 'projects have'} errors:`;
+    const blocks = groups.map(({ prefix, errors }) => {
+        const lines = errors.slice(0, limit).map((e) => `  ${e}`);
+        if (errors.length > limit) {
+            lines.push(`  … ${errors.length - limit} more`);
+        }
+        return `${prefix} (${errors.length}):\n${lines.join('\n')}`;
+    });
+    return [heading, ...blocks].join('\n\n');
+}
+//# sourceMappingURL=project-errors.js.map

package/dist/project-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-errors.js","sourceRoot":"","sources":["../src/project-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAOF,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CACjC,MAAuB,EACvB,QAAgB,EAAE;IAElB,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,UAAU,CAAC;IACpG,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,KAAK,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/project-registry.d.ts

@@ -11,6 +11,8 @@
   License along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
 import { CommandManager, type ProjectProvider } from '@cyberismo/data-handler';
+import { ProjectEvents } from './domain/events/project-events.js';
+import type { ProjectErrors } from './project-errors.js';
 export type ProjectRegistryEntry = {
     prefix: string;
     commands: CommandManager;
@@ -29,11 +31,13 @@ export interface ScannedProject {
 }
 export declare class ProjectRegistry implements ProjectProvider {
     private projects;
+    private events;
     readonly options: ConstructorParameters<typeof CommandManager>[1];
     constructor(entries?: ProjectRegistryEntry[], options?: ConstructorParameters<typeof CommandManager>[1]);
     get(prefix: string): CommandManager | undefined;
     has(prefix: string): boolean;
     add(prefix: string, commands: CommandManager): void;
+    eventsFor(commands: CommandManager): ProjectEvents;
     list(): ProjectListItem[];
     /** Iterate over all registered CommandManagers. */
     values(): IterableIterator<CommandManager>;
@@ -52,6 +56,10 @@ export declare class ProjectRegistry implements ProjectProvider {
     static fromCommandManager(commands: CommandManager): ProjectRegistry;
     /**
      * Build a registry from scanned project entries, initializing each CommandManager.
+     * A project that fails to load is left out and reported in `failed`.
      */
-    static fromScannedProjects(projects: ScannedProject[], options?: ConstructorParameters<typeof CommandManager>[1]): Promise<ProjectRegistry>;
+    static fromScannedProjects(projects: ScannedProject[], options?: ConstructorParameters<typeof CommandManager>[1]): Promise<{
+        registry: ProjectRegistry;
+        failed: ProjectErrors[];
+    }>;
 }

package/dist/project-registry.js

@@ -11,8 +11,10 @@
   License along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
 import { CommandManager } from '@cyberismo/data-handler';
+import { ProjectEvents } from './domain/events/project-events.js';
 export class ProjectRegistry {
     projects = new Map();
+    events = new Map();
     options;
     constructor(entries = [], options) {
         this.options = options;
@@ -32,6 +34,17 @@ export class ProjectRegistry {
         }
         this.projects.set(prefix, commands);
     }
+    eventsFor(commands) {
+        let events = this.events.get(commands);
+        if (!events) {
+            if (![...this.projects.values()].includes(commands)) {
+                throw new Error('Project is not registered');
+            }
+            events = new ProjectEvents();
+            this.events.set(commands, events);
+        }
+        return events;
+    }
     list() {
         return Array.from(this.projects.entries()).map(([prefix, commands]) => ({
             prefix,
@@ -49,6 +62,10 @@ export class ProjectRegistry {
         return first;
     }
     dispose() {
+        for (const events of this.events.values()) {
+            events.dispose();
+        }
+        this.events.clear();
         for (const commands of this.projects.values()) {
             commands.project.dispose();
         }
@@ -60,12 +77,9 @@ export class ProjectRegistry {
      * reset endpoint to swap project state without restarting the Hono app.
      */
     async replace(entries) {
-        for (const commands of this.projects.values()) {
-            commands.project.dispose();
-        }
-        this.projects.clear();
+        this.dispose();
         for (const entry of entries) {
-            this.projects.set(entry.prefix, entry.commands);
+            this.add(entry.prefix, entry.commands);
         }
     }
     /**
@@ -79,15 +93,29 @@ export class ProjectRegistry {
     }
     /**
      * Build a registry from scanned project entries, initializing each CommandManager.
+     * A project that fails to load is left out and reported in `failed`.
      */
     static async fromScannedProjects(projects, options) {
         const entries = [];
+        const failed = [];
         for (const project of projects) {
-            const commands = new CommandManager(project.path, options);
-            await commands.initialize();
-            entries.push({ prefix: project.prefix, commands });
+            let commands;
+            try {
+                commands = new CommandManager(project.path, options);
+                await commands.initialize();
+                entries.push({ prefix: project.prefix, commands });
+            }
+            catch (error) {
+                commands?.project.dispose();
+                failed.push({
+                    prefix: project.prefix,
+                    errors: [
+                        `Failed to load project (${project.path}): ${error instanceof Error ? error.message : String(error)}`,
+                    ],
+                });
+            }
         }
-        return new ProjectRegistry(entries, options);
+        return { registry: new ProjectRegistry(entries, options), failed };
     }
 }
 //# sourceMappingURL=project-registry.js.map

package/dist/project-registry.js.map

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