@raspberryvarg/bot-kit 1.0.4 → 1.0.6

package/dist/modules/module.d.ts

@@ -0,0 +1,43 @@
+import type { Container } from '../di/container.js';
+export type LifecycleMethod = keyof Pick<FeatureModule, 'register' | 'boot' | 'shutdown'>;
+export interface FeatureModule {
+    /**
+     * The name of the module.
+     *
+     * Mainly for debugging, no real use case right now.
+     */
+    name: string;
+    /**
+     * Modules that must be resolved before this module's lifecycle runs.
+     */
+    dependsOn?: readonly FeatureModule[];
+    /**
+     * If defined, the module will only be registered and booted if the function returns true.
+     */
+    enabled?: () => boolean;
+    /**
+     * Set up any DI implementations.
+     */
+    register?: (container: Container) => void | Promise<void>;
+    /**
+     * Start any workers, listeners, etc.
+     *
+     * Runs after all modules have called their {@link register} function.
+     */
+    boot?: (container: Container) => void | Promise<void>;
+    /**
+     * Tear down anything before the application shuts down.
+     */
+    shutdown?: (container: Container) => void | Promise<void>;
+    /**
+     * Configuration specific to HMR.
+     */
+    hmr?: {
+        surviveSoftReload?: boolean;
+    };
+}
+/**
+ * Define a module with a managed lifecycle.
+ */
+export declare function defineModule(module: FeatureModule): Readonly<FeatureModule>;
+//# sourceMappingURL=module.d.ts.map

package/dist/modules/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/modules/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAErC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,GAAG,CAAC,EAAE;QACJ,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAE3E"}

package/dist/modules/module.js

@@ -0,0 +1,7 @@
+/**
+ * Define a module with a managed lifecycle.
+ */
+export function defineModule(module) {
+    return module;
+}
+//# sourceMappingURL=module.js.map

package/dist/modules/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/modules/module.ts"],"names":[],"mappings":"AA+CA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/util/serializableOr.d.ts

@@ -1,11 +1,11 @@
 /**
  * Data that can be serialized to JSON (or already the target serialized value).
  */
-export type SerializableOr<T extends NonNullable<unknown>> = {
+export type SerializableOr<T> = {
     toJSON: () => T;
 } | T;
 /**
  * Resolves a serializable to its target value, returning itself if already resolved.
  */
-export declare function resolveSerializableOr<T extends NonNullable<unknown>>(serializableOr: SerializableOr<T>): T;
+export declare function resolveSerializableOr<T extends object>(serializableOr: SerializableOr<T>): T;
 //# sourceMappingURL=serializableOr.d.ts.map

package/dist/util/serializableOr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializableOr.d.ts","sourceRoot":"","sources":["../../src/util/serializableOr.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,CAAC,OAAO,CAAC,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC;AAErF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,WAAW,CAAC,OAAO,CAAC,EAClE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,GAChC,CAAC,CAEH"}
+{"version":3,"file":"serializableOr.d.ts","sourceRoot":"","sources":["../../src/util/serializableOr.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC;AAExD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAE5F"}

package/dist/util/serializableOr.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializableOr.js","sourceRoot":"","sources":["../../src/util/serializableOr.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,cAAiC;IAEjC,OAAO,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"serializableOr.js","sourceRoot":"","sources":["../../src/util/serializableOr.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAmB,cAAiC;IACvF,OAAO,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;AAC/E,CAAC"}

package/dist/util/topologicalSort.d.ts

@@ -0,0 +1,2 @@
+export declare function topologicalSort<T>(items: Iterable<T>, getKey: (item: T) => string, getDependencies: (item: T) => readonly string[]): T[];
+//# sourceMappingURL=topologicalSort.d.ts.map

package/dist/util/topologicalSort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topologicalSort.d.ts","sourceRoot":"","sources":["../../src/util/topologicalSort.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3B,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,GAC9C,CAAC,EAAE,CA+CL"}

package/dist/util/topologicalSort.js

@@ -0,0 +1,40 @@
+export function topologicalSort(items, getKey, getDependencies) {
+    const sorted = [];
+    const visited = new Set();
+    const visiting = new Set();
+    const keyToItem = new Map();
+    for (const item of items) {
+        const key = getKey(item);
+        if (keyToItem.has(key)) {
+            throw new Error(`Item with key '${key}' already exists.`);
+        }
+        keyToItem.set(key, item);
+    }
+    const visit = (key, path) => {
+        if (visited.has(key))
+            return;
+        if (visiting.has(key)) {
+            const cycle = [...path, key].join(' ➔ ');
+            throw new Error(`Circular dependency detected: ${cycle}`);
+        }
+        const item = keyToItem.get(key);
+        if (!item) {
+            const parent = path[path.length - 1];
+            throw new Error(`Missing dependency: '${key}' (required by '${parent}')`);
+        }
+        visiting.add(key);
+        path.push(key);
+        for (const depKey of getDependencies(item)) {
+            visit(depKey, path);
+        }
+        path.pop();
+        visiting.delete(key);
+        visited.add(key);
+        sorted.push(item);
+    };
+    for (const item of items) {
+        visit(getKey(item), []);
+    }
+    return sorted;
+}
+//# sourceMappingURL=topologicalSort.js.map

package/dist/util/topologicalSort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topologicalSort.js","sourceRoot":"","sources":["../../src/util/topologicalSort.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAC7B,KAAkB,EAClB,MAA2B,EAC3B,eAA+C;IAE/C,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAa,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,mBAAmB,CAAC,CAAC;QAC5D,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE;QAC5C,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAE7B,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,mBAAmB,MAAM,IAAI,CAAC,CAAC;QAC5E,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raspberryvarg/bot-kit",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "private": false,
   "description": "",
   "keywords": [],

package/dist/core/container.d.ts

@@ -1,17 +0,0 @@
-import type { Token } from './token.js';
-type ImplFactory<T> = (container: Container) => T;
-declare class Container {
-    private registry;
-    private instances;
-    register<T>(token: Token<T>, factory: ImplFactory<T>): void;
-    resolve<T>(token: Token<T>): T;
-}
-export declare const container: Container;
-/**
- * Inject a registered dependency.
- *
- * @throws {Error} If the dependency is not registered.
- */
-export declare function inject<T>(token: Token<T>): T;
-export {};
-//# sourceMappingURL=container.d.ts.map

package/dist/core/container.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/core/container.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;AAElD,cAAM,SAAS;IACb,OAAO,CAAC,QAAQ,CAAmD;IACnE,OAAO,CAAC,SAAS,CAAsC;IAEvD,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,QAyBnD;IAED,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAoB7B;CACF;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAE5C"}

package/dist/core/container.js

@@ -1,55 +0,0 @@
-import { coreLog } from '../internal/coreLog.js';
-const isDev = process.env.NODE_ENV === 'development';
-class Container {
-    registry = new Map();
-    instances = new Map();
-    register(token, factory) {
-        if (typeof token === 'function') {
-            token = token.token;
-        }
-        if (isDev) {
-            // HMR
-            if (this.registry.delete(token)) {
-                coreLog.verbose(`HMR: Overriding inject for ${String(token)}`);
-            }
-            if (this.instances.delete(token)) {
-                coreLog.verbose(`HMR: Invalidating constructed instance for ${String(token)}`);
-            }
-        }
-        if (this.registry.has(token)) {
-            throw new Error(`Injectable factory has already been registered with the token: ${String(token)}`);
-        }
-        if (this.instances.has(token)) {
-            throw new Error(`Injectable has already been resolved with the token: ${String(token)}`);
-        }
-        this.registry.set(token, factory);
-    }
-    resolve(token) {
-        if (typeof token === 'function') {
-            token = token.token;
-        }
-        if (this.instances.has(token)) {
-            // oxlint-disable-next-line no-unsafe-type-assertion
-            return this.instances.get(token);
-        }
-        const factory = this.registry.get(token);
-        if (!factory) {
-            throw new Error(`Missing dependency: ${String(token)}`);
-        }
-        coreLog.verbose(`Resolving ${String(token)} dependency: ${String(factory)}`);
-        const instance = factory(this);
-        this.instances.set(token, instance);
-        // oxlint-disable-next-line no-unsafe-type-assertion
-        return instance;
-    }
-}
-export const container = new Container();
-/**
- * Inject a registered dependency.
- *
- * @throws {Error} If the dependency is not registered.
- */
-export function inject(token) {
-    return container.resolve(token);
-}
-//# sourceMappingURL=container.js.map

package/dist/core/container.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/core/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAIjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;AAIrD,MAAM,SAAS;IACL,QAAQ,GAAG,IAAI,GAAG,EAAwC,CAAC;IAC3D,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEvD,QAAQ,CAAI,KAAe,EAAE,OAAuB;QAClD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,MAAM;YACN,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,OAAO,CAAC,8BAA8B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,OAAO,CAAC,8CAA8C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,kEAAkE,MAAM,CAAC,KAAK,CAAC,EAAE,CAClF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wDAAwD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAI,KAAe;QACxB,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,oDAAoD;YACpD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QACxC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACpC,oDAAoD;QACpD,OAAO,QAAa,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAI,KAAe;IACvC,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/token.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/core/token.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,UAAU;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,yBAAyB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1F;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAExE"}

package/dist/core/token.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/core/token.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,KAAsB;IACnD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}