@bluelibs/runner 4.3.0 → 4.4.1

package/AI.md

@@ -24,7 +24,8 @@ This is the foundation of trust for any DI framework.
 - **Resources**: Managed singletons (init/dispose).
 - **Events**: Decoupled communication. Flow: `emit → validation → find & order hooks → run hooks (stoppable)`
 - **Hooks**: Lightweight event listeners. Async and awaited by default.
-- **Middleware**: Cross-cutting concerns. Async and awaited by default.
+- **Middleware**: Cross-cutting concerns. Async and awaited by default. Optionally contract-enforcing for input/output.
+- **Tags**: Metadata for organizing, filtering, enforcing input/output contracts to tasks or resources.
 
 ## Quick Start
 
@@ -234,8 +235,8 @@ const auth = taskMiddleware<
 // of a resource and replaces it with a non-destructive update.
 const softDelete = resourceMiddleware({
   id: "app.middleware.softDelete",
-  run: async ({ next }) => {
-    const resourceInstance = await next(); // The original resource instance
+  run: async ({ resource, next }) => {
+    const resourceInstance = await next(resource.config); // The original resource instance
 
     // This example assumes the resource has `update` and `delete` methods.
     // A more robust implementation would check for their existence.
@@ -305,7 +306,12 @@ const globalTaskMiddleware = taskMiddleware({
   // if you have dependencies as task, exclude them via everywhere filter.
 });
 
-// Similar behavior for resourceMiddleware({ ... });
+// Global resource middleware (same everywhere semantics)
+const globalResourceMiddleware = resourceMiddleware({
+  id: "...",
+  everywhere: true, // or: (resource) => boolean
+  run: async ({ next }) => next(),
+});
 ```
 
 ## Context (request-scoped values)
@@ -376,15 +382,20 @@ const app = resource({
 
 ## Namespacing
 
-As your app grows, use a consistent naming convention. This is the recommended format:
+As your app grows, you'll want consistent naming. Here's the convention that won't drive you crazy:
+
+| Type                | Format                                           |
+| ------------------- | ------------------------------------------------ |
+| Resources           | `{domain}.resources.{resource-name}`             |
+| Tasks               | `{domain}.tasks.{task-name}`                     |
+| Events              | `{domain}.events.{event-name}`                   |
+| Hooks               | `{domain}.hooks.on-{event-name}`                 |
+| Task Middleware     | `{domain}.middleware.task.{middleware-name}`     |
+| Resource Middleware | `{domain}.middleware.resource.{middleware-name}` |
+
+We recommend kebab-case for file names and ids. Suffix files with their primitive type: `*.task.ts`, `*.task-middleware.ts`, `*.hook.ts`, etc.
 
-| Type       | Format                                 |
-| ---------- | -------------------------------------- |
-| Tasks      | `{domain}.tasks.{taskName}`            |
-| Hooks      | `{domain}.hooks.on{EventName}`         |
-| Resources  | `{domain}.resources.{resourceName}`    |
-| Events     | `{domain}.events.{eventName}`          |
-| Middleware | `{domain}.middleware.{middlewareName}` |
+Folders can look something like this: `src/app/users/tasks/create-user.task.ts`. For domain: `app.users` and a task. Use `middleware/task|resource` for middleware files.
 
 ## Factory Pattern
 

package/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2024-present Theodor Diaconu <theodor.diaconu@cultofcoders.com>
+Copyright (c) 2024-present Theodor Diaconu <theodor@bluelibs.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/README.md

@@ -9,11 +9,17 @@ _Or: How I Learned to Stop Worrying and Love Dependency Injection_
 <a href="https://github.com/bluelibs/runner" target="_blank"><img src="https://img.shields.io/badge/github-blue" alt="GitHub" /></a>
 </p>
 
-- [UX Friendly Docs](https://bluelibs.github.io/runner/)
-- [AI Friendly Docs (<4500 tokens)](https://github.com/bluelibs/runner/blob/main/AI.md)
-- [Migrate from 3.x.x to 4.x.x](https://github.com/bluelibs/runner/blob/main/readmes/MIGRATION.md)
-- [Runner Lore](https://github.com/bluelibs/runner/blob/main/readmes)
-- [Example: Express + OpenAPI + SQLite](https://github.com/bluelibs/runner/tree/main/examples/express-openapi-sqlite)
+| Resource                                                                                                            | Type    | Notes                                                         |
+| ------------------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------- |
+| [Presentation Website](https://runner.bluelibs.com/)                                                                | Website | Overview, features, and highlights                            |
+| [BlueLibs Runner GitHub](https://github.com/bluelibs/runner)                                                        | GitHub  | Source code, issues, and releases                             |
+| [BlueLibs Runner Dev](https://github.com/bluelibs/runner-dev)                                                       | GitHub  | Development tools and CLI for BlueLibs Runner                 |
+| [UX Friendly Docs](https://bluelibs.github.io/runner/)                                                              | Docs    | Clean, navigable documentation                                |
+| [AI Friendly Docs (<5000 tokens)](https://github.com/bluelibs/runner/blob/main/AI.md)                               | Docs    | Short, token-friendly summary (<5000 tokens)                  |
+| [Migrate from 3.x.x to 4.x.x](https://github.com/bluelibs/runner/blob/main/readmes/MIGRATION.md)                    | Guide   | Step-by-step upgrade from v3 to v4                            |
+| [Runner Lore](https://github.com/bluelibs/runner/blob/main/readmes)                                                 | Docs    | Design notes, deep dives, and context                         |
+| [Example: Express + OpenAPI + SQLite](https://github.com/bluelibs/runner/tree/main/examples/express-openapi-sqlite) | Example | Full Express + OpenAPI + SQLite demo                          |
+| [OpenAI Runner Chatbot](https://chatgpt.com/g/g-68b756abec648191aa43eaa1ea7a7945-runner?model=gpt-5-thinking)       | Chatbot | Ask questions interactively, or feed README.md to your own AI |
 
 Welcome to BlueLibs Runner, where we've taken the chaos of modern application architecture and turned it into something that won't make you question your life choices at 3am. This isn't just another framework – it's your new best friend who actually understands that code should be readable, testable, and not require a PhD in abstract nonsense to maintain.
 
@@ -90,9 +96,9 @@ const { dispose } = await run(app, { debug: "verbose" });
 
 > **runtime:** "'Less lines than Hello World.' Incredible. All you had to do was externalize 90% of the work into `express`, Node, and me. But please, bask in the brevity. I’ll be over here negotiating a peace treaty between your dependency tree and reality."
 
-## The Big Four
+## The Big Five
 
-The framework is built around four core concepts: Tasks, Resources, Events, and Middleware. Understanding them is key to using the runner effectively.
+The framework is built around five core concepts: Tasks, Resources, Events, Middleware, and Tags. Understanding them is key to using the runner effectively.
 
 ### Tasks
 
@@ -569,7 +575,149 @@ const loggedTask = task({
 });
 ```
 
-> **runtime:** "Ah, the onion pattern. A matryoshka doll made of promises. Every peel reveals… another logger. Another tracer. Another 'just a tiny wrapper'. I’ll keep unwrapping until we hit the single lonely `return` you were hiding like state secrets."
+> **runtime:** "Ah, the onion pattern. A matryoshka doll made of promises. Every peel reveals… another logger. Another tracer. Another 'just a tiny wrapper'. I'll keep unwrapping until we hit the single lonely `return` you were hiding like state secrets."
+
+### Tags
+
+Tags are metadata that can influence system behavior. Unlike meta properties, tags can be queried at runtime to build dynamic functionality. They can be simple strings or structured configuration objects.
+
+#### Basic Usage
+
+```typescript
+import { tag, task, hook, globals } from "@bluelibs/runner";
+
+// Simple string tags
+const apiTask = task({
+  id: "app.tasks.getUserData",
+  tags: ["api", "public", "cacheable"],
+  run: async (userId) => getUserFromDatabase(userId),
+});
+
+// Structured tags with configuration
+const httpTag = tag<{ method: string; path: string }>({
+  id: "http.route",
+});
+
+const getUserTask = task({
+  id: "app.tasks.getUser",
+  tags: ["api", httpTag.with({ method: "GET", path: "/users/:id" })],
+  run: async ({ id }) => getUserFromDatabase(id),
+});
+```
+
+#### Discovering Components by Tags
+
+The core power of tags is runtime discovery. Use `store.getTasksWithTag()` to find components:
+
+```typescript
+import { hook, globals } from "@bluelibs/runner";
+
+// Auto-register HTTP routes based on tags
+const routeRegistration = hook({
+  id: "app.hooks.registerRoutes",
+  on: globals.events.ready,
+  dependencies: {
+    store: globals.resources.store,
+    server: expressServer,
+  },
+  run: async (_, { store, server }) => {
+    // Find all tasks with HTTP tags
+    const apiTasks = store.getTasksWithTag(httpTag);
+
+    apiTasks.forEach((taskDef) => {
+      const config = httpTag.extract(taskDef);
+      if (!config) return;
+
+      const { method, path } = config;
+      server.app[method.toLowerCase()](path, async (req, res) => {
+        const result = await taskDef({ ...req.params, ...req.body });
+        res.json(result);
+      });
+    });
+
+    // Also find by string tags
+    const cacheableTasks = store.getTasksWithTag("cacheable");
+    console.log(`Found ${cacheableTasks.length} cacheable tasks`);
+  },
+});
+```
+
+#### Tag Extraction and Processing
+
+```typescript
+// Check if a tag exists and extract its configuration
+const performanceTag = tag<{ warnAboveMs: number }>({
+  id: "performance.monitor",
+});
+
+const performanceMiddleware = taskMiddleware({
+  id: "app.middleware.performance",
+  run: async ({ task, next }) => {
+    // Check if task has performance monitoring enabled
+    if (!performanceTag.exists(task.definition)) {
+      return next(task.input);
+    }
+
+    // Extract the configuration
+    const config = performanceTag.extract(task.definition);
+    const startTime = Date.now();
+
+    try {
+      const result = await next(task.input);
+      const duration = Date.now() - startTime;
+
+      if (duration > config.warnAboveMs) {
+        console.warn(`Task ${task.definition.id} took ${duration}ms`);
+      }
+
+      return result;
+    } catch (error) {
+      const duration = Date.now() - startTime;
+      console.error(`Task failed after ${duration}ms`, error);
+      throw error;
+    }
+  },
+});
+```
+
+#### System Tags
+
+Built-in tags for framework behavior:
+
+```typescript
+import { globals } from "@bluelibs/runner";
+
+const internalTask = task({
+  id: "app.internal.cleanup",
+  tags: [
+    globals.tags.system, // Excludes from debug logs
+    globals.tags.debug.with({ logTaskInput: true }), // Per-component debug config
+  ],
+  run: async () => performCleanup(),
+});
+
+const internalEvent = event({
+  id: "app.events.internal",
+  tags: [globals.tags.excludeFromGlobalHooks], // Won't trigger wildcard listeners
+});
+```
+
+#### Contract Tags
+
+Enforce return value shapes at compile time:
+
+```typescript
+// Tags that enforce type contracts
+const userContract = tag<void, void, { name: string }>({
+  id: "contract.user",
+});
+
+const profileTask = task({
+  id: "app.tasks.getProfile",
+  tags: [userContract], // Must return { name: string }
+  run: async () => ({ name: "Ada" }), // ✅ Satisfies contract
+});
+```
 
 ## run() and RunOptions
 
@@ -887,7 +1035,7 @@ const databaseResource = resource({
   },
   dispose: async (connection) => {
     await connection.close();
-    console.log("Database connection closed");
+    // console.log("Database connection closed");
   },
 });
 
@@ -1310,6 +1458,7 @@ const app = resource({
     logger.trace("Very detailed trace"); // ❌ Hidden by default
 
     logger.onLog(async (log) => {
+      // Sub-loggers instantiated .with() share the same log listeners.
       // Catch logs
     })
   },
@@ -1765,203 +1914,6 @@ const sendWelcomeEmail = task({
 });
 ```
 
-### Tags
-
-Tags are a way to describe your element, however, unlike meta, tags may influence behaviour in the system. They can be simple strings or sophisticated configuration objects that control component behavior. They have to be registered for it to work, to understand their ownership.
-
-#### Tags with Configuration
-
-For more sophisticated control, you can create structured tags that carry configuration:
-
-```typescript
-import { tag } from "@bluelibs/runner";
-
-// Define a reusable tag with configuration
-const performanceTag = tag<{ alertAboveMs: number; criticalAboveMs: number }>({
-  id: "performance.monitoring",
-});
-
-const rateLimitTag = tag<{ maxRequestsPerMinute: number; burstLimit?: number }>(
-  {
-    id: "rate.limit",
-  },
-);
-
-const cacheTag = tag<{ ttl: number; keyPattern?: string }>({
-  id: "cache.strategy",
-});
-
-// Use structured tags in your components
-const expensiveTask = task({
-  id: "app.tasks.expensiveCalculation",
-  tags: [
-    "computation",
-    "background",
-    performanceTag.with({
-      alertAboveMs: 5000,
-      criticalAboveMs: 15000,
-    }),
-    cacheTag.with({
-      ttl: 300000, // 5 minutes
-      keyPattern: "calc-{userId}-{datasetId}",
-    }),
-  ],
-  run: async (input) => {
-    // Heavy computation here
-  },
-});
-
-const apiEndpoint = task({
-  id: "app.tasks.api.getUserProfile",
-  tags: [
-    "api",
-    "public",
-    rateLimitTag.with({
-      maxRequestsPerMinute: 100,
-      burstLimit: 20,
-    }),
-    cacheTag.with({ ttl: 60000 }), // 1 minute cache
-  ],
-  run: async (userId) => {
-    // API logic
-  },
-});
-```
-
-### Global Tags System
-
-The framework now includes a sophisticated global tagging system for better component organization and control:
-
-```typescript
-import { globals } from "@bluelibs/runner";
-
-// System components (automatically excluded from debug logs)
-const internalTask = task({
-  id: "app.tasks.internal",
-  tags: [globals.tags.system], // Marks as system component
-  run: async () => "internal work",
-});
-
-// Debug-specific configuration
-const debugTask = task({
-  id: "app.tasks.debug",
-  tags: [
-    globals.tags.debug.with({
-      logTaskInput: true,
-      logTaskResult: true,
-    }),
-  ],
-  run: async (input) => processInput(input),
-});
-
-// Events that should not be sent to global listeners
-const internalEvent = event({
-  id: "app.events.internal",
-  tags: [globals.tags.excludeFromGlobalHooks],
-});
-```
-
-To process these tags you can hook into `globals.events.ready`, use the global store as dependency and use the `getTasksWithTag()` and `getResourcesWithTag()` functionality.
-
-#### Structured Tags
-
-```typescript
-const performanceMiddleware = taskMiddleware({
-  id: "app.middleware.performance",
-  run: async ({ task, next }) => {
-    const perfConfiguration = performanceTag.extract(task.definition); // you can just use .exists() if you want to check for presence
-
-    if (perfConfiguration) {
-      const startTime = Date.now();
-
-      try {
-        const result = await next(task?.input);
-        const duration = Date.now() - startTime;
-
-        if (duration > perfConfiguration.criticalAboveMs) {
-          await alerting.critical(
-            `Task ${task.definition.id} took ${duration}ms`,
-          );
-        } else if (duration > perfConfiguration.alertAboveMs) {
-          await alerting.warn(`Task ${task.definition.id} took ${duration}ms`);
-        }
-
-        return result;
-      } catch (error) {
-        const duration = Date.now() - startTime;
-        await alerting.error(
-          `Task ${task.definition.id} failed after ${duration}ms`,
-          error,
-        );
-        throw error;
-      }
-    }
-
-    return next(task?.input);
-  },
-});
-```
-
-#### Contract Tags
-
-You can attach contracts to tags to enforce the shape of a task's returned value and a resource's `init()` value at compile time. Contracts are specified via the third generic of `defineTag<TConfig, TUnused, TOutput>`.
-
-```typescript
-// A tag that enforces the returned value to include { name: string }
-const userContract = tag<void, void, { name: string }>({ id: "contract.user" });
-
-// Another tag that enforces { age: number }
-const ageContract = tag<void, void, { age: number }>({ id: "contract.age" });
-
-// Works with configured tags too
-const preferenceContract = tag<
-  { locale: string },
-  void,
-  { preferredLocale: string }
->({
-  id: "contract.preferences",
-});
-```
-
-The return value must return a union of all tags with return contracts.
-
-```typescript
-// Task: the awaited return value must satisfy { name: string } & { age: number }
-const getProfile = task({
-  id: "app.tasks.getProfile",
-  tags: [userContract, ageContract, preferenceContract.with({ locale: "en" })],
-  run: async () => {
-    return { name: "Ada", age: 37, preferredLocale: "en" }; // OK
-  },
-});
-
-// Resource: init() return must satisfy the same intersection
-const profileService = resource({
-  id: "app.resources.profileService",
-  tags: [userContract, ageContract],
-  init: async () => {
-    return { name: "Ada", age: 37 }; // OK
-  },
-});
-```
-
-If the returned value does not satisfy the intersection, TypeScript surfaces a readable, verbose type error that includes what was expected and what was received.
-
-```typescript
-const badTask = task({
-  id: "app.tasks.bad",
-  tags: [userContract, ageContract],
-  //    vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
-  run: async () => ({ name: "Ada" }), // Missing { age: number }
-  // Type error includes a helpful shape similar to:
-  // ContractViolationError<
-  //   { message: "Value does not satisfy all tag contracts";
-  //     expected: { name: string } & { age: number };
-  //     received: { name: string } }
-  // >
-});
-```
-
 ### Extending Metadata: Custom Properties
 
 For advanced use cases, you can extend the metadata interfaces to add your own properties:
@@ -2102,14 +2054,18 @@ Overrides are applied after everything is registered. If multiple overrides targ
 
 As your app grows, you'll want consistent naming. Here's the convention that won't drive you crazy:
 
-| Type                | Format                                          |
-| ------------------- | ----------------------------------------------- |
-| Resources           | `{domain}.resources.{resourceName}`             |
-| Tasks               | `{domain}.tasks.{taskName}`                     |
-| Events              | `{domain}.events.{eventName}`                   |
-| Hooks               | `{domain}.hooks.on{EventName}`                  |
-| Task Middleware     | `{domain}.middleware.task.{middlewareName}`     |
-| Resource Middleware | `{domain}.middleware.resource.{middlewareName}` |
+| Type                | Format                                           |
+| ------------------- | ------------------------------------------------ |
+| Resources           | `{domain}.resources.{resource-name}`             |
+| Tasks               | `{domain}.tasks.{task-name}`                     |
+| Events              | `{domain}.events.{event-name}`                   |
+| Hooks               | `{domain}.hooks.on-{event-name}`                 |
+| Task Middleware     | `{domain}.middleware.task.{middleware-name}`     |
+| Resource Middleware | `{domain}.middleware.resource.{middleware-name}` |
+
+We recommend kebab-case for file names and ids. Suffix files with their primitive type: `*.task.ts`, `*.task-middleware.ts`, `*.hook.ts`, etc.
+
+Folders can look something like this: `src/app/users/tasks/create-user.task.ts`. For domain: `app.users` and a task. Use `middleware/task|resource` for middleware files.
 
 ```typescript
 // Helper function for consistency
@@ -2118,7 +2074,7 @@ function namespaced(id: string) {
 }
 
 const userTask = task({
-  id: namespaced("tasks.user.create"),
+  id: namespaced("tasks.user.create-user"),
   // ...
 });
 ```

package/dist/globals/resources/debug/executionTracker.middleware.js

@@ -7,7 +7,7 @@ const globalResources_1 = require("../../globalResources");
 const globalTags_1 = require("../../globalTags");
 const types_1 = require("./types");
 exports.tasksTrackerMiddleware = (0, define_1.defineTaskMiddleware)({
-    id: "debug.middleware.tracker.task",
+    id: "globals.debug.middleware.task.executionTracker",
     everywhere: (task) => !globalTags_1.globalTags.system.exists(task),
     dependencies: {
         logger: globalResources_1.globalResources.logger,
@@ -25,20 +25,14 @@ exports.tasksTrackerMiddleware = (0, define_1.defineTaskMiddleware)({
         await logger.info(taskStartMessage, {
             data: shouldShowData ? { input: task.input } : undefined,
         });
-        try {
-            const result = await next(task.input);
-            const duration = Date.now() - start;
-            const taskCompleteMessage = `Task ${task.definition.id} completed in ${duration}ms`;
-            const shouldShowResult = debugConfig.logTaskOutput && result;
-            await logger.info(taskCompleteMessage, {
-                data: shouldShowResult ? { result } : undefined,
-            });
-            return result;
-        }
-        catch (error) {
-            await logger.error(error);
-            throw error;
-        }
+        const result = await next(task.input);
+        const duration = Date.now() - start;
+        const taskCompleteMessage = `Task ${task.definition.id} completed in ${duration}ms`;
+        const shouldShowResult = debugConfig.logTaskOutput && result;
+        await logger.info(taskCompleteMessage, {
+            data: shouldShowResult ? { result } : undefined,
+        });
+        return result;
     },
     meta: {
         title: "Execution Tracker",
@@ -47,7 +41,7 @@ exports.tasksTrackerMiddleware = (0, define_1.defineTaskMiddleware)({
     tags: [globalTags_1.globalTags.system],
 });
 exports.resourcesTrackerMiddleware = (0, define_1.defineResourceMiddleware)({
-    id: "debug.middleware.tracker.resource",
+    id: "globals.debug.middleware.resource.executionTracker",
     dependencies: {
         logger: globalResources_1.globalResources.logger,
         debugConfig: debugConfig_resource_1.debugConfig,
@@ -66,19 +60,14 @@ exports.resourcesTrackerMiddleware = (0, define_1.defineResourceMiddleware)({
         await logger.info(resourceStartMessage, {
             data: shouldShowConfig ? { config: resource.config } : undefined,
         });
-        try {
-            const result = await next(resource.config);
-            const duration = Date.now() - start;
-            const resourceCompleteMessage = `Resource ${String(resource.definition.id)} initialized in ${duration}ms`;
-            const shouldShowResult = debugConfig.logResourceValue && result !== undefined;
-            await logger.info(resourceCompleteMessage, {
-                data: shouldShowResult ? { result } : undefined,
-            });
-            return result;
-        }
-        catch (error) {
-            throw error;
-        }
+        const result = await next(resource.config);
+        const duration = Date.now() - start;
+        const resourceCompleteMessage = `Resource ${String(resource.definition.id)} initialized in ${duration}ms`;
+        const shouldShowResult = debugConfig.logResourceValue && result !== undefined;
+        await logger.info(resourceCompleteMessage, {
+            data: shouldShowResult ? { result } : undefined,
+        });
+        return result;
     },
     meta: {
         title: "Execution Tracker",

package/dist/globals/resources/debug/executionTracker.middleware.js.map

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

package/dist/globals/resources/debug/globalEvent.hook.js

@@ -8,7 +8,7 @@ const utils_1 = require("./utils");
 const debugConfig_resource_1 = require("./debugConfig.resource");
 const types_1 = require("./types");
 exports.globalEventListener = (0, define_1.defineHook)({
-    id: "debug.catchAllHook",
+    id: "globals.debug.hooks.onAnyEvent",
     on: "*",
     dependencies: {
         logger: globalResources_1.globalResources.logger,
@@ -22,7 +22,7 @@ exports.globalEventListener = (0, define_1.defineHook)({
         if (debugConfig.logEventEmissionOnRun) {
             const message = `Event ${String(event.id)} emitted`;
             await logger.info(message, {
-                source: "debug.catchAllHook",
+                source: "globals.debug.hooks.onAnyEvent",
                 data: debugConfig.logEventEmissionInput
                     ? { data: event.data }
                     : undefined,

package/dist/globals/resources/debug/globalEvent.hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalEvent.hook.js","sourceRoot":"","sources":["../../../../src/globals/resources/debug/globalEvent.hook.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,2DAAwD;AACxD,iDAA8C;AAC9C,mCAAuC;AACvC,iEAAqD;AACrD,mCAAoC;AAGvB,QAAA,mBAAmB,GAAG,IAAA,mBAAU,EAAC;IAC5C,EAAE,EAAE,oBAAoB;IACxB,EAAE,EAAE,GAAG;IACP,YAAY,EAAE;QACZ,MAAM,EAAE,iCAAe,CAAC,MAAM;QAC9B,WAAW,EAAX,kCAAW;KACZ;IACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;QAC5C,IAAI,IAAA,oBAAY,EAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,WAAW,GAAG,IAAA,iBAAS,EAAC,WAAW,EAAE,KAAM,CAAC,CAAC;QAC7C,IAAI,WAAW,CAAC,qBAAqB,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,SAAS,MAAM,CAAC,KAAM,CAAC,EAAE,CAAC,UAAU,CAAC;YACrD,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;gBACzB,MAAM,EAAE,oBAAoB;gBAC5B,IAAI,EAAE,WAAW,CAAC,qBAAqB;oBACrC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAM,CAAC,IAAI,EAAE;oBACvB,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,6BAA6B;KAC3C;IACD,IAAI,EAAE,CAAC,uBAAU,CAAC,MAAM,CAAC;CAC1B,CAAC,CAAC"}
+{"version":3,"file":"globalEvent.hook.js","sourceRoot":"","sources":["../../../../src/globals/resources/debug/globalEvent.hook.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,2DAAwD;AACxD,iDAA8C;AAC9C,mCAAuC;AACvC,iEAAqD;AACrD,mCAAoC;AAGvB,QAAA,mBAAmB,GAAG,IAAA,mBAAU,EAAC;IAC5C,EAAE,EAAE,gCAAgC;IACpC,EAAE,EAAE,GAAG;IACP,YAAY,EAAE;QACZ,MAAM,EAAE,iCAAe,CAAC,MAAM;QAC9B,WAAW,EAAX,kCAAW;KACZ;IACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;QAC5C,IAAI,IAAA,oBAAY,EAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,WAAW,GAAG,IAAA,iBAAS,EAAC,WAAW,EAAE,KAAM,CAAC,CAAC;QAC7C,IAAI,WAAW,CAAC,qBAAqB,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,SAAS,MAAM,CAAC,KAAM,CAAC,EAAE,CAAC,UAAU,CAAC;YACrD,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;gBACzB,MAAM,EAAE,gCAAgC;gBACxC,IAAI,EAAE,WAAW,CAAC,qBAAqB;oBACrC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAM,CAAC,IAAI,EAAE;oBACvB,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,6BAA6B;KAC3C;IACD,IAAI,EAAE,CAAC,uBAAU,CAAC,MAAM,CAAC;CAC1B,CAAC,CAAC"}

package/dist/globals/resources/debug/hook.hook.js

@@ -8,7 +8,7 @@ const utils_1 = require("./utils");
 const debugConfig_resource_1 = require("./debugConfig.resource");
 const types_1 = require("./types");
 exports.hookInterceptorResource = (0, define_1.defineResource)({
-    id: "debug.hookInterceptorResource",
+    id: "globals.debug.resources.hookInterceptor",
     meta: {
         title: "Hook Interceptor",
         description: "Intercepts hooks for debug logging, skipping system-tagged hooks.",
@@ -31,7 +31,7 @@ exports.hookInterceptorResource = (0, define_1.defineResource)({
                 const hookId = hook.id;
                 let logString = `Hook triggered for ${String(hookId)}`;
                 await logger.info(logString, {
-                    source: "debug.hookInterceptorResource",
+                    source: "globals.debug.resources.hookInterceptor",
                 });
             }
             await next(hook, event);
@@ -39,7 +39,7 @@ exports.hookInterceptorResource = (0, define_1.defineResource)({
                 const hookId = hook.id;
                 let logString = `Hook completed for ${String(hookId)}`;
                 await logger.info(logString, {
-                    source: "debug.hookInterceptorResource",
+                    source: "globals.debug.resources.hookInterceptor",
                 });
             }
         });