@blastlauncher/engine 3.0.0-alpha.0 → 3.0.0-alpha.1

package/dist/engine.d.ts

@@ -6,6 +6,8 @@ export declare function createEngine(options?: {
     timeoutMs?: number;
     dataDir?: string;
     installer?: DependencyInstaller;
+    watcher?: OpenExtensionOptions["watcher"];
+    debounce?: OpenExtensionOptions["debounce"];
     dependencies?: "manual" | "auto";
     handlers?: Record<string, CapabilityHandler>;
 }): {

package/dist/engine.js

@@ -27,6 +27,8 @@ export function createEngine(options = {}) {
                 ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
                 ...(options.dataDir === undefined ? {} : { dataDir: options.dataDir }),
                 ...(options.installer === undefined ? {} : { installer: options.installer }),
+                ...(options.watcher === undefined ? {} : { watcher: options.watcher }),
+                ...(options.debounce === undefined ? {} : { debounce: options.debounce }),
                 ...extensionOptions,
             }, registeredHandlers, options.dependencies === "auto");
             const close = extension.close;

package/dist/extension.d.ts

@@ -32,6 +32,17 @@ export type OpenExtensionOptions = {
     dataDir?: string;
     installer?: DependencyInstaller;
     handlers?: Record<string, CapabilityHandler>;
+    watcher?: ExtensionWatcherFactory;
+    debounce?: DebounceScheduler;
+};
+export type ExtensionWatcher = {
+    on(event: "error", listener: (error: Error) => void): ExtensionWatcher;
+    close(): void;
+};
+export type ExtensionWatcherFactory = (path: string, listener: (event: string, filename: string | Buffer | null) => void) => ExtensionWatcher;
+export type DebounceScheduler = {
+    schedule(callback: () => void, delayMs: number): unknown;
+    cancel(handle: unknown): void;
 };
 /** Opens an extension without starting a command or installing dependencies. */
 export declare function openExtension(options: OpenExtensionOptions): {

package/dist/extension.js

@@ -42,6 +42,12 @@ export function createExtensionHandle(options, engineHandlers = () => ({}), defa
     const extensionDir = resolve(options.extensionDir);
     const dataDir = options.dataDir ?? defaultDataDir();
     const dependencyOptions = { extensionDir, dataDir };
+    const watcherFactory = options.watcher ?? ((path, listener) => watchDirectory(path, listener));
+    const debounce = options.debounce ??
+        {
+            schedule: (callback, delayMs) => setTimeout(callback, delayMs),
+            cancel: (handle) => clearTimeout(handle),
+        };
     let closed = false;
     let closing;
     let queue = Promise.resolve();
@@ -231,11 +237,12 @@ export function createExtensionHandle(options, engineHandlers = () => ({}), defa
                     listener(update);
             };
             // Directory watching also observes manifests replaced via atomic rename.
-            const watcher = watchDirectory(extensionDir, (_event, file) => {
+            const watcher = watcherFactory(extensionDir, (_event, file) => {
                 if (file && file !== "package.json" && file !== "package-lock.json")
                     return;
-                clearTimeout(timer);
-                timer = setTimeout(() => {
+                if (timer !== undefined)
+                    debounce.cancel(timer);
+                timer = debounce.schedule(() => {
                     void reload();
                 }, 100);
             });
@@ -245,7 +252,8 @@ export function createExtensionHandle(options, engineHandlers = () => ({}), defa
             });
             const unsubscribe = () => {
                 active = false;
-                clearTimeout(timer);
+                if (timer !== undefined)
+                    debounce.cancel(timer);
                 watcher.close();
                 subscriptions.delete(unsubscribe);
             };

package/dist/index.d.ts

@@ -8,6 +8,6 @@ export * from "./dependencies.js";
 export * from "./client.js";
 export * from "./install-dependencies.js";
 export * from "./preferences.js";
-export { openExtension, MissingLaunchValuesError, DependenciesRequiredError, type OpenExtensionOptions, type ExtensionHandle, type ExtensionLaunchOptions, } from "./extension.js";
+export { openExtension, MissingLaunchValuesError, DependenciesRequiredError, type OpenExtensionOptions, type ExtensionHandle, type ExtensionLaunchOptions, type DebounceScheduler, type ExtensionWatcher, type ExtensionWatcherFactory, } from "./extension.js";
 export * from "./extension-manifest.js";
 export * from "./engine.js";

package/package.json

@@ -9,13 +9,19 @@
     }
   },
   "dependencies": {
-    "@blastlauncher/protocol": "3.0.0-alpha.0",
-    "@blastlauncher/runtime": "3.0.0-alpha.0",
+    "@blastlauncher/protocol": "3.0.0-alpha.1",
+    "@blastlauncher/runtime": "3.0.0-alpha.1",
     "esbuild": "0.28.2",
     "semver": "7.8.5"
   },
-  "version": "3.0.0-alpha.0",
+  "version": "3.0.0-alpha.1",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BlastLauncher/blast.git",
+    "directory": "packages/host"
+  },
+  "homepage": "https://github.com/BlastLauncher/blast#readme",
   "engines": {
     "node": ">=24.20.0"
   },