@linxin666/dsh-pet 0.3.10 → 0.3.11

package/lib/types/host/run-guarded.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Async-boundary guard shared by the plugin family's Host halves: every
+ * fire-and-forget promise chain and callback the host runtime does not own
+ * (route handlers, timers, event listeners, spawned work) funnels through
+ * these helpers. The dsh host installs a process-level fail-loud guard that
+ * turns ANY unhandled promise rejection into a whole-process exit — one
+ * plugin's stray rejection would otherwise take every plugin down. These
+ * helpers exist so that failure mode is structurally impossible in family
+ * code: the rejection becomes a logged error at the plugin boundary instead.
+ *
+ * Complements the aggregate's shell isolation (packages/dsh-web-all): the
+ * shell contains import/activation failures at boot; runGuarded contains
+ * run-time failures after activation.
+ * @module dsh-web-shared/host/run-guarded
+ */
+/**
+ * Run one async operation, logging (never propagating) a rejection. Use for
+ * promises whose lifecycle the caller does not await: spawned work, retry
+ * loops, background flushes. Returns the original promise so callers can
+ * still chain when they want to.
+ * @param promise - the work to shield; any thenable.
+ * @param label - log prefix naming the work site.
+ * @param log - error sink; defaults to console.error.
+ * @returns the input promise (rejection already consumed).
+ */
+export declare function runGuarded<T>(promise: PromiseLike<T>, label: string, log?: (error: unknown) => void): PromiseLike<T>;
+/**
+ * Wrap one callback so every invocation is individually guarded: a rejection
+ * inside one call is logged and swallowed instead of escaping into whatever
+ * infrastructure invoked the callback (HTTP server, EventEmitter, interval).
+ * Sync throws are caught identically; a returned promise is replaced by
+ * `undefined` after guarding (callers that need the original rejection should
+ * await inside their own try/catch instead).
+ * @param label - log prefix naming the callback site.
+ * @param handler - the work to guard.
+ * @param log - error sink; defaults to console.error.
+ * @returns a wrapped callback with the same parameter list.
+ */
+export declare function guardedHandler<A extends unknown[]>(label: string, handler: (...args: A) => unknown, log?: (error: unknown) => void): (...args: A) => unknown;
+//# sourceMappingURL=run-guarded.d.ts.map

package/lib/types/host/run-guarded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-guarded.d.ts","sourceRoot":"","sources":["../../../src/host/run-guarded.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;GAcG;AAOH;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAoB,GAAG,WAAW,CAAC,CAAC,CAAC,CAKnI;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,EAChD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,EAChC,GAAG,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAoB,GAC5C,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAgBzB"}

package/lib/types/host/run-guarded.js

@@ -0,0 +1,69 @@
+// Generated by scripts/sync-shared.mjs from shared/host/run-guarded.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
+/**
+ * Async-boundary guard shared by the plugin family's Host halves: every
+ * fire-and-forget promise chain and callback the host runtime does not own
+ * (route handlers, timers, event listeners, spawned work) funnels through
+ * these helpers. The dsh host installs a process-level fail-loud guard that
+ * turns ANY unhandled promise rejection into a whole-process exit — one
+ * plugin's stray rejection would otherwise take every plugin down. These
+ * helpers exist so that failure mode is structurally impossible in family
+ * code: the rejection becomes a logged error at the plugin boundary instead.
+ *
+ * Complements the aggregate's shell isolation (packages/dsh-web-all): the
+ * shell contains import/activation failures at boot; runGuarded contains
+ * run-time failures after activation.
+ * @module dsh-web-shared/host/run-guarded
+ */
+/** Format one failure line for logging. */
+function formatFailure(label, error) {
+    return new Error(`[${label}] unhandled async failure: ${error instanceof Error ? error.stack ?? error.message : String(error)}`);
+}
+/**
+ * Run one async operation, logging (never propagating) a rejection. Use for
+ * promises whose lifecycle the caller does not await: spawned work, retry
+ * loops, background flushes. Returns the original promise so callers can
+ * still chain when they want to.
+ * @param promise - the work to shield; any thenable.
+ * @param label - log prefix naming the work site.
+ * @param log - error sink; defaults to console.error.
+ * @returns the input promise (rejection already consumed).
+ */
+export function runGuarded(promise, label, log = console.error) {
+    void Promise.resolve(promise).catch(error => {
+        log(formatFailure(label, error));
+    });
+    return promise;
+}
+/**
+ * Wrap one callback so every invocation is individually guarded: a rejection
+ * inside one call is logged and swallowed instead of escaping into whatever
+ * infrastructure invoked the callback (HTTP server, EventEmitter, interval).
+ * Sync throws are caught identically; a returned promise is replaced by
+ * `undefined` after guarding (callers that need the original rejection should
+ * await inside their own try/catch instead).
+ * @param label - log prefix naming the callback site.
+ * @param handler - the work to guard.
+ * @param log - error sink; defaults to console.error.
+ * @returns a wrapped callback with the same parameter list.
+ */
+export function guardedHandler(label, handler, log = console.error) {
+    return (...args) => {
+        try {
+            const result = handler(...args);
+            if (isPromiseLike(result)) {
+                void Promise.resolve(result).catch(error => {
+                    log(formatFailure(label, error));
+                });
+                return undefined;
+            }
+            return result;
+        }
+        catch (error) {
+            log(formatFailure(label, error));
+            return undefined;
+        }
+    };
+}
+function isPromiseLike(value) {
+    return typeof value === 'object' && value !== null && typeof value.then === 'function';
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-pet",
   "description": "Multi-pet companion plugin for the dsh web GUI: a registry-driven floating pet that reacts to model activity, with per-pet naming, petting/feeding interactions and an affinity score",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -40,7 +40,7 @@
   "license": "Apache-2.0",
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.2-alpha.1"
+      "dsh": ">=0.1.2-alpha.3"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -65,18 +65,18 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.3",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^22.20.0",

package/src/client/index.ts

@@ -296,8 +296,8 @@ export function apply(ctx: ClientContext): void {
 
       const openSession = (sessionId: string): void => {
         const list = sessions.list.getSnapshot()
-        if (list.byId[sessionId as SessionId] === undefined) return
-        sessions.open(sessionId as SessionId)
+        if ((list.byId as any)[sessionId] === undefined) return
+        sessions.open(sessionId as never)
       }
 
       const injected = (): PetInjected => ({

package/src/host/run-guarded.ts

@@ -0,0 +1,76 @@
+// Generated by scripts/sync-shared.mjs from shared/host/run-guarded.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
+/**
+ * Async-boundary guard shared by the plugin family's Host halves: every
+ * fire-and-forget promise chain and callback the host runtime does not own
+ * (route handlers, timers, event listeners, spawned work) funnels through
+ * these helpers. The dsh host installs a process-level fail-loud guard that
+ * turns ANY unhandled promise rejection into a whole-process exit — one
+ * plugin's stray rejection would otherwise take every plugin down. These
+ * helpers exist so that failure mode is structurally impossible in family
+ * code: the rejection becomes a logged error at the plugin boundary instead.
+ *
+ * Complements the aggregate's shell isolation (packages/dsh-web-all): the
+ * shell contains import/activation failures at boot; runGuarded contains
+ * run-time failures after activation.
+ * @module dsh-web-shared/host/run-guarded
+ */
+
+/** Format one failure line for logging. */
+function formatFailure(label: string, error: unknown): Error {
+  return new Error(`[${label}] unhandled async failure: ${error instanceof Error ? error.stack ?? error.message : String(error)}`)
+}
+
+/**
+ * Run one async operation, logging (never propagating) a rejection. Use for
+ * promises whose lifecycle the caller does not await: spawned work, retry
+ * loops, background flushes. Returns the original promise so callers can
+ * still chain when they want to.
+ * @param promise - the work to shield; any thenable.
+ * @param label - log prefix naming the work site.
+ * @param log - error sink; defaults to console.error.
+ * @returns the input promise (rejection already consumed).
+ */
+export function runGuarded<T>(promise: PromiseLike<T>, label: string, log: (error: unknown) => void = console.error): PromiseLike<T> {
+  void Promise.resolve(promise).catch(error => {
+    log(formatFailure(label, error))
+  })
+  return promise
+}
+
+/**
+ * Wrap one callback so every invocation is individually guarded: a rejection
+ * inside one call is logged and swallowed instead of escaping into whatever
+ * infrastructure invoked the callback (HTTP server, EventEmitter, interval).
+ * Sync throws are caught identically; a returned promise is replaced by
+ * `undefined` after guarding (callers that need the original rejection should
+ * await inside their own try/catch instead).
+ * @param label - log prefix naming the callback site.
+ * @param handler - the work to guard.
+ * @param log - error sink; defaults to console.error.
+ * @returns a wrapped callback with the same parameter list.
+ */
+export function guardedHandler<A extends unknown[]>(
+  label: string,
+  handler: (...args: A) => unknown,
+  log: (error: unknown) => void = console.error,
+): (...args: A) => unknown {
+  return (...args: A) => {
+    try {
+      const result = handler(...args)
+      if (isPromiseLike(result)) {
+        void Promise.resolve(result).catch(error => {
+          log(formatFailure(label, error))
+        })
+        return undefined
+      }
+      return result
+    } catch (error) {
+      log(formatFailure(label, error))
+      return undefined
+    }
+  }
+}
+
+function isPromiseLike(value: unknown): value is PromiseLike<unknown> {
+  return typeof value === 'object' && value !== null && typeof (value as PromiseLike<unknown>).then === 'function'
+}

package/src/registry.test.ts

@@ -314,13 +314,15 @@ describe('loadPetRegistry', () => {
       dshPetsDir: '',
     })
 
-    // The repo checkout also resolves miku (frames2d gameplay pet) from
-    // assets/; the npm files whitelist excludes it (Workshop delivery), so
-    // npm installs see the three atlas pets until a Workshop install lands
-    // miku under $DSH_HOME/pets.
+    // The repo checkout also resolves miku (frames2d gameplay pet) and
+    // starry-doll (community sprite2d pet) from assets/; the npm files
+    // whitelist excludes them (Workshop delivery), so npm installs see the
+    // three atlas pets until a Workshop install lands them under
+    // $DSH_HOME/pets.
     expect(registry.entries.map(entry => entry.id)).toEqual([
       'miku',
       'ouo-neko',
+      'starry-doll',
       'whale-girl',
       'whale-girl-refined',
     ])
@@ -331,6 +333,13 @@ describe('loadPetRegistry', () => {
       rows: [6, 8, 8, 4, 5, 8, 6, 6, 6],
     })
     expect(existsSync(petAtlasFile(registry.byId('ouo-neko')!))).toBe(true)
+    expect(registry.byId('starry-doll')).toMatchObject({
+      displayName: '星夜人偶',
+      atlasRows: 9,
+      columns: 8,
+      rows: [6, 8, 8, 4, 5, 8, 6, 6, 6],
+    })
+    expect(existsSync(petAtlasFile(registry.byId('starry-doll')!))).toBe(true)
     expect(registry.byId('whale-girl')?.displayName).toBe('鲸鱼娘（原版）')
     expect(registry.byId('whale-girl-refined')?.displayName).toBe('鲸鱼娘（精致版）')
     expect(existsSync(petAtlasFile(registry.byId('whale-girl-refined')!))).toBe(true)