@antprofuse/saddle-islands-tools 0.1.8 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antprofuse/saddle-islands-tools",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Independent Saddle–Islands engineering tools",
   "files": [
     "tools"

package/tools/modules/minifish/checks/package.test.mjs

@@ -17,7 +17,7 @@ async function fixture(){
  await writeFile(path.join(project,'harness/regions/alternate.mjs'),"import {semanticLocator} from '@antprofuse/saddle-islands-tools/tools/modules/minifish/harness/semantic-anchor.mjs';export function locate(root,name){return semanticLocator(root,name)};export function assertTarget(){}");
  return {root,project,configFile,config,loaded:await loadProject(project,configFile)};
 }
-test('alternate project static closure records tool/adapter separately and copies no unrelated region',async()=>{const f=await fixture();try{const output=path.join(f.root,'artifact'),records=await packageRunner(f.loaded,output,'regions/alternate.mjs');assert(records.some(r=>r.kind==='tool'&&r.path==='harness/semantic-anchor.mjs'));for(const name of ['visual-expectation.mjs','visual-carrier.mjs']){assert(records.some(r=>r.kind==='tool'&&r.path==='harness/'+name));assert((await readFile(path.join(output,'tools/harness',name),'utf8')).length>0);}assert(records.some(r=>r.kind==='adapter'&&r.path==='harness/regions/alternate.mjs'));assert(records.every(r=>/^[a-f0-9]{64}$/.test(r.sha256)));assert(!records.some(r=>r.path.includes('T1')));assert((await readFile(path.join(output,'adapters/harness/regions/alternate.mjs'),'utf8')).includes('../../../tools/harness/semantic-anchor.mjs'));}finally{await rm(f.root,{recursive:true,force:true});}});
+test('alternate project static closure records tool/adapter separately and copies no unrelated region',async()=>{const f=await fixture();try{const output=path.join(f.root,'artifact'),records=await packageRunner(f.loaded,output,'regions/alternate.mjs');assert(records.some(r=>r.kind==='tool'&&r.path==='harness/semantic-anchor.mjs'));for(const name of ['visual-expectation.mjs','visual-carrier.mjs','jsapi.mjs','browser.mjs']){assert(records.some(r=>r.kind==='tool'&&r.path==='harness/'+name));assert((await readFile(path.join(output,'tools/harness',name),'utf8')).length>0);}assert(records.some(r=>r.kind==='adapter'&&r.path==='harness/regions/alternate.mjs'));assert(records.every(r=>/^[a-f0-9]{64}$/.test(r.sha256)));assert(!records.some(r=>r.path.includes('T1')));assert((await readFile(path.join(output,'adapters/harness/regions/alternate.mjs'),'utf8')).includes('../../../tools/harness/semantic-anchor.mjs'));}finally{await rm(f.root,{recursive:true,force:true});}});
 for(const [name,code] of [['unknown package',"import 'fs';"],['dependency traversal',"import '../../outside.mjs';"],['direct DOM',"export const read=root=>root.evaluate(()=>1);"],['dynamic import',"export const read=()=>import('./other.mjs');"]])test(name+' is rejected from the closed observation dependency graph',async()=>{const f=await fixture();try{await writeFile(path.join(f.project,'harness/regions/alternate.mjs'),code);await writeFile(path.join(f.project,'outside.mjs'),'export const leaked=true;');await assert.rejects(packageRunner(f.loaded,path.join(f.root,'artifact'),'regions/alternate.mjs'));}finally{await rm(f.root,{recursive:true,force:true});}});
 test('symlink aliases, undeclared module, missing config, and package output are rejected',async()=>{const f=await fixture();try{const module=path.join(f.project,'harness/regions/alternate.mjs');await rm(module);await writeFile(path.join(f.project,'harness/other.mjs'),'export const safe=true;');await symlink('../other.mjs',module);await assert.rejects(packageRunner(f.loaded,path.join(f.root,'alias'),'regions/alternate.mjs'),/Symlink/);await assert.rejects(packageRunner(f.loaded,path.join(f.root,'unknown'),'regions/unknown.mjs'),/declared module/);await assert.rejects(loadProject(f.project,path.join(f.project,'missing.json')));await assert.rejects(packageRunner(f.loaded,path.join(f.project,'artifact'),'regions/alternate.mjs'),/outside/);}finally{await rm(f.root,{recursive:true,force:true});}});
 test('generic composition preserves exact preparation and original ID mappings without project names',()=>{const noop=()=>{},policy={validateSemanticTargets:noop,supplementalDefinition:()=>null,officialTitle:()=>false,validatePreparationOverrides:noop,validateFixtureTypes:noop,validateSpecialBoundaries:noop,validateIndependentFixture:noop,validatePacketPlan:noop,validatePluginEvents:noop,validatePluginAssertionIdentity:noop,validateObservationModuleName:noop};const catalog={cases:[{id:'alternate / page / value / content',title:'value'}]},definition={caseId:catalog.cases[0].id,ancestors:['open'],basis:[{path:'alternate/source.yaml'}],preparation:{},assertions:[{id:'value',kind:'text',target:'alternate / page / value',expected:'42',count:1}]},fragment={id:'open',inputs:{query:{key:'42'}},boundaries:[],actions:[{kind:'open-page'}]};const plan=compileCase(catalog,definition,[fragment],policy);assert.deepEqual(plan.inputs,fragment.inputs);assert.deepEqual(plan.assertions,definition.assertions);assert.equal(plan.case.id,definition.caseId);assert.throws(()=>compileCase(catalog,{...definition,ancestors:['unknown']},[fragment],policy),/missing preparation/);});

package/tools/modules/minifish/harness/browser.mjs

@@ -9,7 +9,7 @@ import {pluginPackagePlan} from './plugin-package.mjs';
 import {installHostLanguage} from './host-language.mjs';
 import {installResponseConsumption} from './response-consumption.mjs';
 import { fulfillRpc } from './rpc-wire.mjs';
-import { bridgePath, jsapiPath, bridgeScript, fulfillJsapi, businessJsapiOption } from './jsapi.mjs';
+import { bridgePath, jsapiPath, jsapiDeliveryPath, acknowledgeJsapiDelivery, bridgeScript, fulfillJsapi, businessJsapiOption } from './jsapi.mjs';
 
 // Official Lyra keeps earlier pages painted in the same simulator stack.
 // The last non-exiting sibling is the active shell; route name alone is ambiguous.
@@ -54,6 +54,7 @@ export async function openMinifish({ page, plan, query, simulatorUrl, pageRoute,
     const request = route.request(), target = new URL(request.url());
     try {
       if (target.origin === url.origin && target.pathname === bridgePath) return await route.fulfill({contentType:'application/javascript',body:bridgeScript(url.origin,nativeApis,Boolean(process.env.MINIFISH_LOADING_DIAGNOSTICS_DIR),officialUi,process.env.MINIFISH_CALLBACK_CORRELATION==='1')});
+      if(target.origin===url.origin&&target.pathname===jsapiDeliveryPath)return await acknowledgeJsapiDelivery(route,plan);
       if (target.origin === url.origin && target.pathname === jsapiPath) {const wire=request.postDataJSON();callbackCorrelation?.transport(wire,request.frame());observeLocalNavigationCandidate(page,wire);if(officialUi.includes(wire.api)){plan.recordNativeUiRequest('jsapi:'+wire.api,businessJsapiOption(wire.option),wire);return await route.fulfill({status:204});}if(delegateLocalNavigation(page,wire))return await route.fulfill({status:204});return await fulfillJsapi(route, plan);}
       if(target.origin===url.origin&&target.pathname===nativeUiResultPath){assert.equal(request.method(),'POST');const receipt=request.postDataJSON();plan.recordNativeUiResult('jsapi:'+receipt.api,businessJsapiOption(receipt.option),receipt);return await route.fulfill({status:204});}
       if (target.origin === url.origin && target.pathname.startsWith('/lyraParams/')) {

package/tools/modules/minifish/harness/jsapi.mjs

@@ -1,3 +1,4 @@
+import {randomUUID} from 'node:crypto';
 import {hostDeviceFixture,configureHostDeviceMount,hostDeviceMountEvidence} from './host-device-fixture.mjs';
 import assert from 'node:assert/strict';
 import {nativeUiResultPath,nativeUiApis} from './native-ui-contract.mjs';
@@ -5,6 +6,9 @@ import {nativeUiResultPath,nativeUiApis} from './native-ui-contract.mjs';
 // Captures native calls without reading or altering product business state.
 export const bridgePath = '/__bill_tests__/bridge.js';
 export const jsapiPath = '/__bill_tests__/jsapi';
+export const jsapiDeliveryPath = '/__bill_tests__/jsapi-delivery';
+const deliveryPlans = new WeakMap();
+const deliveryHeader = 'x-minifish-response-id';
 export function bridgeScript(origin, additionalApis = [], observeLoading = false, officialUi = [], observeCorrelation = false) {
   assert(!additionalApis.includes('pageScrollTo'),'Official scroll cannot enter renderer Mock list');
   assert(officialUi.every(api=>nativeUiApis.includes(api)),'Finite official UI delegation list');
@@ -50,7 +54,12 @@ export function bridgeScript(origin, additionalApis = [], observeLoading = false
         return undefined;
       }
       if (!response.ok) return {error:99999,errorMessage:'test boundary rejected native call'};
-      return await response.json();
+      const result = await response.json();
+      const token = response.headers.get(${JSON.stringify(deliveryHeader)});
+      if(!token)throw Error('Mock response missing delivery identity');
+      const receipt = await fetch(${JSON.stringify(origin+jsapiDeliveryPath)},{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({token})});
+      if(!receipt.ok)throw Error('Mock response delivery rejected');
+      return result;
     }
   });});`;
 }
@@ -70,8 +79,27 @@ export async function fulfillJsapi(route, plan) {
   const call=decodeNativeStorage(wire.api,businessJsapiOption(wire.option));
   let result = await plan.receive(`jsapi:${call.api}`, call.params, wire);
   if(wire.api==='getTinyLocalStorage'&&Object.hasOwn(result??{},'data'))result={...result,data:JSON.stringify({APDataStorage:result.data})};
-  await route.fulfill({json:result});
-  plan.markDelivered(`jsapi:${call.api}`,call.params);
+  let deliveries=deliveryPlans.get(plan);
+  if(!deliveries){deliveries=new Map();deliveryPlans.set(plan,deliveries);}
+  const token=randomUUID();
+  deliveries.set(token,{operation:`jsapi:${call.api}`,request:call.params,frame:request.frame()});
+  try{await route.fulfill({json:result,headers:{[deliveryHeader]:token}});}
+  catch(error){deliveries.delete(token);throw error;}
+}
+
+// Browser acknowledges a fully parsed response before returning it to AppX.
+// This records delivery, not product callback consumption; consumption stays independent.
+export async function acknowledgeJsapiDelivery(route,plan){
+  const request=route.request();
+  assert.equal(request.method(),'POST','Delivery receipt must POST');
+  const receipt=request.postDataJSON();
+  assert.deepEqual(Object.keys(receipt).sort(),['token'],'Exact delivery receipt required');
+  const deliveries=deliveryPlans.get(plan),entry=deliveries?.get(receipt.token);
+  assert(entry,'Unknown, duplicate or failed response delivery identity');
+  assert.equal(request.frame(),entry.frame,'Response receipt must belong to original frame');
+  deliveries.delete(receipt.token);
+  plan.markDelivered(entry.operation,entry.request);
+  await route.fulfill({status:204});
 }
 
 // Official @ali/antcube-appx-bridge-my root/storage/boost/impl.js maps