fix(sdk): release lifecycle validation modules

cocoscreator_projects/framework-tests/sdk/game-contract-harness.test.ts

@@ -14,6 +14,7 @@ import {
 test('assertGameContract runs the reusable isolated session conformance suite', () => {
   let invalidations = 0;
   let nextModuleId = 0;
+  const restoredDeskinfo: unknown[] = [];
   const entry: GameEntry = {
     key: 'fixture',
     gameId: 41,
@@ -23,15 +24,19 @@ test('assertGameContract runs the reusable isolated session conformance suite',
       if (seats === 2 || seats === 4 || seats === 10) return seats;
       return 4;
     },
-    createModule: () => makeModule(++nextModuleId),
+    createModule: () => makeModule(++nextModuleId, (deskinfo) => { restoredDeskinfo.push(deskinfo); }),
   };
 
-  assert.doesNotThrow(() => assertGameContract(entry, makeConformanceHost(() => { invalidations++; })));
+  assert.doesNotThrow(() => assertGameContract(
+    entry,
+    makeConformanceHost(() => { invalidations++; }, restoredDeskinfo),
+  ));
   assert.equal(invalidations, 2);
+  assert.equal(restoredDeskinfo.length, 0);
   assert.ok(nextModuleId >= 2);
 });
 
-function makeModule(id: number): GameModule {
+function makeModule(id: number, onRestore: (deskinfo: unknown) => void): GameModule {
   let host: GameHost | undefined;
   let restored: unknown;
   let eventCount = 0;
@@ -50,8 +55,16 @@ function makeModule(id: number): GameModule {
       assert.equal(typeof data.cycle, 'number');
       messageCycle = data.cycle;
     },
-    restore(deskinfo) { restored = deskinfo; },
+    restore(deskinfo) {
+      restored = deskinfo;
+      onRestore(deskinfo);
+    },
     dispose() {
+      if (!host) {
+        assert.equal(eventCount, 0);
+        assert.equal(restored, undefined);
+        return;
+      }
       assert.ok(host);
       assert.equal(eventCount, 1);
       assert.deepEqual(restored, deskinfoFor(messageCycle!));
@@ -63,7 +76,10 @@ function deskinfoFor(cycle: number): { readonly cycle: number } {
   return { cycle };
 }
 
-function makeConformanceHost(onInvalidate: () => void): () => GameContractHost {
+function makeConformanceHost(
+  onInvalidate: () => void,
+  restoredDeskinfo: unknown[],
+): () => GameContractHost {
   return () => {
     const snapshot: PlatformGameSnapshot = {
       connection: { phase: 'connected' },
@@ -80,6 +96,9 @@ function makeConformanceHost(onInvalidate: () => void): () => GameContractHost {
         execute: () => {},
       },
       invalidate: onInvalidate,
+      assertRestored(deskinfo) {
+        assert.equal(restoredDeskinfo.shift(), deskinfo);
+      },
     };
   };
 }

cocoscreator_projects/framework-tests/sdk/game-session-host.test.ts

@@ -40,15 +40,21 @@ function makeEntry(createModule: () => GameModule): GameEntry {
 }
 
 function makeModule(log: string[], onRestore?: (deskinfo: unknown) => void): GameModule {
+  let attached = false;
   return {
-    attach: () => log.push('attach'),
+    attach: () => {
+      attached = true;
+      log.push('attach');
+    },
     handlePlatformEvent: (event) => log.push(`event:${event.type}`),
     handleGameMessage: (message) => log.push(`message:${message.rpc}`),
     restore: (deskinfo) => {
       log.push('restore');
       onRestore?.(deskinfo);
     },
-    dispose: () => log.push('dispose'),
+    dispose: () => {
+      if (attached) log.push('dispose');
+    },
   };
 }
 
@@ -65,6 +71,18 @@ test('assertGameEntry rejects invalid identity, routes, seat counts, and module
   assert.throws(() => assertGameEntry({ ...entry, createModule: () => undefined as never }), /module/);
 });
 
+test('assertGameEntry disposes its validation module exactly once', () => {
+  let disposals = 0;
+  const entry = makeEntry(() => ({
+    ...makeModule([]),
+    dispose: () => { disposals++; },
+  }));
+
+  assert.doesNotThrow(() => assertGameEntry(entry));
+
+  assert.equal(disposals, 1);
+});
+
 test('GameSessionHost delivers room events and deskinfo to one active module in order', () => {
   const log: string[] = [];
   const deskinfo = { turn: 7 };
@@ -120,6 +138,21 @@ test('GameSessionHost rejects illegal state transitions and mismatched game rout
   assert.deepEqual(log, ['attach', 'message:draw']);
 });
 
+test('GameSessionHost disposes a module when attachment throws and returns to idle', () => {
+  let disposals = 0;
+  const sessions = new GameSessionHost(makeEntry(() => ({
+    ...makeModule([]),
+    attach: () => { throw new Error('attach failed'); },
+    dispose: () => { disposals++; },
+  })));
+  disposals = 0;
+
+  assert.throws(() => sessions.open(makeHost()), /attach failed/);
+
+  assert.equal(disposals, 1);
+  assert.equal(sessions.state, 'idle');
+});
+
 test('GameSessionHost disposes a module exactly once and becomes terminal after dispose', () => {
   const log: string[] = [];
   const sessions = new GameSessionHost(makeEntry(() => makeModule(log)));