@trillboards/edge-sdk 0.2.258 → 0.2.263

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/deploy/windows/ci/test-published-install.ps1 +29 -1
  2. package/deploy/windows/e2e/test-recorder-family.ps1 +16 -2
  3. package/dist/CloudSensingManager.d.ts +36 -0
  4. package/dist/CloudSensingManager.d.ts.map +1 -1
  5. package/dist/CloudSensingManager.js +147 -20
  6. package/dist/CloudSensingManager.js.map +1 -1
  7. package/dist/DetectorFields.d.ts +2 -1
  8. package/dist/DetectorFields.d.ts.map +1 -1
  9. package/dist/DetectorFields.js +6 -3
  10. package/dist/DetectorFields.js.map +1 -1
  11. package/dist/EdgeAgent.js +1 -1
  12. package/dist/FloorObjects.d.ts +342 -0
  13. package/dist/FloorObjects.d.ts.map +1 -0
  14. package/dist/FloorObjects.js +961 -0
  15. package/dist/FloorObjects.js.map +1 -0
  16. package/dist/SceneMarks.d.ts +1 -1
  17. package/dist/SceneMarks.d.ts.map +1 -1
  18. package/dist/SceneMarks.js +1 -1
  19. package/dist/SceneMarks.js.map +1 -1
  20. package/dist/ScopedVlmReview.d.ts +5 -1
  21. package/dist/ScopedVlmReview.d.ts.map +1 -1
  22. package/dist/ScopedVlmReview.js +40 -4
  23. package/dist/ScopedVlmReview.js.map +1 -1
  24. package/dist/UniformSceneStore.d.ts +7 -0
  25. package/dist/UniformSceneStore.d.ts.map +1 -1
  26. package/dist/UniformSceneStore.js +26 -1
  27. package/dist/UniformSceneStore.js.map +1 -1
  28. package/dist/VideoSegmentUploader.d.ts +4 -0
  29. package/dist/VideoSegmentUploader.d.ts.map +1 -1
  30. package/dist/VideoSegmentUploader.js +21 -1
  31. package/dist/VideoSegmentUploader.js.map +1 -1
  32. package/dist/autoSense.d.ts +5 -4
  33. package/dist/autoSense.d.ts.map +1 -1
  34. package/dist/autoSense.js +24 -9
  35. package/dist/autoSense.js.map +1 -1
  36. package/dist/config.d.ts +9 -0
  37. package/dist/config.d.ts.map +1 -1
  38. package/dist/config.js +15 -0
  39. package/dist/config.js.map +1 -1
  40. package/dist/diagnose.d.ts +1 -1
  41. package/dist/diagnose.js +1 -1
  42. package/dist/localSensing.d.ts.map +1 -1
  43. package/dist/localSensing.js +2 -0
  44. package/dist/localSensing.js.map +1 -1
  45. package/dist/sensingRunMode.d.ts +8 -0
  46. package/dist/sensingRunMode.d.ts.map +1 -1
  47. package/dist/sensingRunMode.js +59 -11
  48. package/dist/sensingRunMode.js.map +1 -1
  49. package/package.json +6 -5
  50. package/retained/CapturedTheftProfile.cjs +83 -0
  51. package/retained/ExperimentalTheftConnector.cjs +392 -0
  52. package/retained/FrameTheftRuntime.cjs +111 -0
  53. package/retained/FrameTheftWorker.py +136 -0
  54. package/retained/InstalledTheftLifecycle.cjs +165 -0
  55. package/retained/InstalledTheftPackage.cjs +91 -0
  56. package/retained/LiveTheftBinding.cjs +55 -0
  57. package/retained/ObservedReviewCaseEvidence.py +188 -0
  58. package/retained/ObservedSameWristPolicy.py +205 -0
  59. package/retained/OrderedPerceptionDelivery.cjs +72 -0
  60. package/retained/PairedTheftRoute.cjs +402 -0
  61. package/retained/ReplayRpc.cjs +157 -0
  62. package/retained/RetainedCaptureClient.cjs +63 -16
  63. package/retained/SavedTheftSession.cjs +110 -0
  64. package/retained/TheftCaseContract.cjs +36 -0
  65. package/retained/TheftCaseDelivery.cjs +81 -0
  66. package/retained/TheftDeliveryPump.cjs +41 -0
  67. package/retained/TheftMovementOwner.py +234 -0
  68. package/retained/TheftReviewPolicy.cjs +8 -0
  69. package/retained/__tests__/paired-theft-manager.test.cjs +509 -0
  70. package/retained/__tests__/support/live-shelf-api.cjs +139 -0
  71. package/retained/__tests__/support/load-sdk-sources.cjs +41 -0
  72. package/retained/__tests__/support/loopback-proxy.cjs +33 -0
  73. package/retained/__tests__/support/pinned-api-loader.cjs +11 -0
  74. package/retained/__tests__/support/theft-builder.cjs +61 -0
  75. package/retained/__tests__/support/theft-packet-fixture.cjs +58 -0
  76. package/retained/__tests__/support/theft-readiness.cjs +51 -0
  77. package/retained/__tests__/test_live_theft_input.py +103 -0
  78. package/retained/__tests__/theft-case-api.test.cjs +135 -0
  79. package/retained/__tests__/theft-ci-regression.test.cjs +92 -0
  80. package/retained/__tests__/theft-config.test.cjs +84 -0
  81. package/retained/__tests__/theft-entry.test.cjs +76 -0
  82. package/retained/__tests__/theft-native-recovery.test.cjs +90 -0
  83. package/retained/__tests__/theft-readiness.test.cjs +164 -0
  84. package/retained/manager.cjs +61 -7
  85. package/retained/pilot-profile-client.cjs +4 -0
@@ -0,0 +1,135 @@
1
+ 'use strict';
2
+ require('./support/load-sdk-sources.cjs');
3
+ const {test,afterEach}=require('node:test'),assert=require('node:assert/strict'),path=require('node:path');
4
+ const {fixture,cleanupFixtures}=require('./support/theft-packet-fixture.cjs');
5
+ const {root,api,contracts,load,logger}=require('./support/pinned-api-loader.cjs');
6
+ const contract=require('../TheftCaseContract.cjs');
7
+ const service=load(path.join(api,'services/retainedTheftCases.js'),{'./theftCaseContract':contract});
8
+ const repoModule=load(path.join(api,'services/pgRepo/retainedTheftCases.js'),{'../theftCaseContract':contract});
9
+ const clipContract=load(path.join(contracts,'services/pgRepo/retainedCctvAlertClips.js'));
10
+ afterEach(()=>{try{cleanupFixtures();}catch(e){console.error(require('node:util').inspect(e,{depth:8}));throw e;}});
11
+ const identity={screenId:'camera',ownerId:'owner',fingerprint:'fp'};
12
+ const route={routeId:'route',ownerId:'owner',ownerKind:'earner_user',screenMongoIds:['camera'],name:'Theft review',condition:{field:'theft_review'},actions:[]};
13
+ async function setup(){const f=fixture();await f.capture();await f.connector.reviewOne({cameraBusy:false});const e=contract.makeEnvelope(f.receiver.savedPackets()[0],{profileId:'theft',selectionId:'selected'});
14
+ const binding={...e,enabled:true,reviewMode:'human_only',cameraId:'camera',ownerId:'owner',sourceId:'source',regionConfigurationSha256:'b'.repeat(64),route};
15
+ return {f,e,binding};}
16
+ function response(){return {code:200,status(v){this.code=v;return this;},json(v){this.body=v;return this;}};}
17
+ function memorySql({clipError=false}={}){
18
+ let state={cases:new Map(),packets:new Map(),outbox:new Map(),clips:new Map()},queries=[];
19
+ async function query(sql,p=[]){queries.push({sql,p});
20
+ if(sql.includes('pg_advisory')||/^(SAVEPOINT|RELEASE|ROLLBACK TO)/.test(sql))return {rows:[]};
21
+ if(sql.startsWith('SELECT * FROM retained_cctv_theft_cases'))return {rows:state.cases.has(p[0])?[state.cases.get(p[0])]:[]};
22
+ if(sql.includes('INSERT INTO retained_cctv_theft_cases')){const row={alert_id:p[0],owner_id:p[1],screen_id:p[2],incident_id:p[3],scope_sha256:p[4],route_id:p[5],captured_at_ms:p[6]};state.cases.set(p[0],row);return {rows:[row]};}
23
+ if(sql.includes('INSERT INTO retained_cctv_theft_case_packets')){const key=p[0]+p[1],old=state.packets.get(key);if(old&&old.sha!==p[2])return {rows:[]};state.packets.set(key,{sha:p[2],packet:JSON.parse(p[4])});return {rows:[{packet_id:p[1]}]};}
24
+ if(sql.includes('INSERT INTO retained_cctv_alert_outbox')){if(!state.outbox.has(p[0]))state.outbox.set(p[0],{alert_id:p[0],payload:JSON.parse(p[5])});return {rows:[]};}
25
+ if(sql===clipContract.ALERT_CLIP_REQUEST_SQL){assert.deepEqual(p,clipContract.alertClipRequestParams(p[0]));if(clipError)throw Error('Fixture clip storage failure');if(!state.clips.has(p[0]))state.clips.set(p[0],{state:'requested'});return {rows:[]};}
26
+ if(sql.startsWith('SELECT state FROM retained_cctv_alert_clips'))return {rows:state.clips.has(p[0])?[state.clips.get(p[0])]:[]};
27
+ if(sql.startsWith('UPDATE retained_cctv_theft_cases SET clip_error'))return {rows:[]};
28
+ throw Error('Unexpected SQL: '+sql);
29
+ }
30
+ const repository=repoModule.createRepository({query,transaction:async work=>{const before=structuredClone(state);try{return await work({query});}catch(e){state=before;throw e;}},clipSql:clipContract.ALERT_CLIP_REQUEST_SQL,clipParams:clipContract.alertClipRequestParams});
31
+ return {repository,queries,get state(){return state;}};
32
+ }
33
+ function deps(binding,repository){return {authorize:async()=>({identity}),resolveTheftBinding:async()=>binding,caseRepository:repository,clipRepository:{pendingForScreen:async()=>[]}};}
34
+ test('authenticated complete case uses existing outbox once; extra evidence remains in same case',async()=>{
35
+ const {e,binding}=await setup(),db=memorySql(),d=deps(binding,db.repository),req={body:e};let r=response();await service.receive(req,r,d);assert.equal(r.code,202);
36
+ const first=r.body;await service.receive(req,response(),d);assert.equal(db.state.outbox.size,1);assert.equal(db.state.packets.size,1);
37
+ const p=structuredClone(e.packet);p.receipt.kind='add_case_evidence';p.receipt.snapshotAnchorMs+=500;
38
+ r=response();await service.receive({body:contract.makeEnvelope(p,e)},r,d);assert.equal(r.body.alertId,first.alertId);assert.equal(db.state.outbox.size,1);assert.equal(db.state.packets.size,2);
39
+ for(const row of db.state.packets.values())assert.equal(row.packet.pictures.length,13);
40
+ assert.equal(first.notificationState,'durably_queued_not_provider_delivery');assert.equal(first.clipState,'pending');
41
+ });
42
+ test('live case intake requires live provenance and cannot receive a replay packet',async()=>{
43
+ const {e,binding}=await setup(),db=memorySql();
44
+ const shelf=[[0,0],[1000000,0],[1000000,1000000]],frameSize=[e.packet.pictures[0].width,e.packet.pictures[0].height];
45
+ const d=deps({...binding,liveSource:true,modeSinceMs:e.packet.receipt.firstCaptureMs,shelf,frameSize},db.repository);
46
+ let r=response();await service.receive({body:e},r,d);
47
+ assert.equal(r.code,409);assert.equal(r.body.error,'theft_case_source_kind_changed');assert.equal(db.state.outbox.size,0);
48
+ const p=structuredClone(e.packet);
49
+ delete p.scope.sourceVideoSha256;p.scope.sourceKind='live_shelf_review_v1';
50
+ for(const observation of p.observations) observation.inputBinding.nativeScope=structuredClone(p.scope);
51
+ p.environment={kind:p.scope.sourceKind,cameraId:binding.cameraId,sourceId:binding.sourceId,
52
+ regionConfigurationSha256:binding.regionConfigurationSha256,frameSize,shelf};
53
+ for(const picture of p.pictures)picture.sourceTimeMs=null;
54
+ r=response();await service.receive({body:contract.makeEnvelope(p,e)},r,d);
55
+ assert.equal(r.code,202);assert.equal(db.state.outbox.size,1);
56
+ const payload=db.state.outbox.get(r.body.alertId).payload;
57
+ assert.equal(payload.theftReview.liveSource,true);
58
+ const prep={caseRepository:db.repository,routes:{getRouteById:async()=>route}};
59
+ for(const selection of [{mode:'off',sinceMs:1},{mode:'concealment',sinceMs:1},{mode:'shelf',sinceMs:p.receipt.firstCaptureMs+1}]){
60
+ assert.deepEqual(await service.prepareDelivery(payload,{...prep,readPilotReviewSelection:async()=>selection}),
61
+ {suppressed:'theft_pilot_mode_changed'});
62
+ }
63
+ r=response();await service.receive({body:contract.makeEnvelope(p,e)},r,
64
+ deps({...binding,liveSource:true,modeSinceMs:p.receipt.firstCaptureMs+1,shelf,frameSize},db.repository));
65
+ assert.equal(r.code,409);
66
+ r=response();await service.receive({body:contract.makeEnvelope(p,e)},r,deps(binding,db.repository));
67
+ assert.equal(r.code,409);assert.equal(r.body.error,'theft_case_source_kind_changed');
68
+ });
69
+ test('changed packet identity rolls back; attachment cannot create its own notification',async()=>{
70
+ const {e,binding}=await setup(),db=memorySql(),d=deps(binding,db.repository);await service.receive({body:e},response(),d);
71
+ const p=structuredClone(e.packet);p.message='changed';let r=response();await service.receive({body:contract.makeEnvelope(p,e)},r,d);assert.equal(r.code,409);assert.equal(db.state.packets.size,1);
72
+ const another=memorySql();p.receipt.kind='add_case_evidence';r=response();await service.receive({body:contract.makeEnvelope(p,e)},r,deps(binding,another.repository));assert.equal(r.code,409);assert.equal(another.state.outbox.size,0);
73
+ });
74
+ test('wrong camera, profile or current source binding is refused before storage',async()=>{
75
+ const {e,binding}=await setup(),db=memorySql();for(const change of [{cameraId:'other'},{profileId:'other'},{sourceId:'other'},{enabled:false}]){
76
+ const r=response();await service.receive({body:e},r,deps({...binding,...change},db.repository));assert([403,409].includes(r.code));
77
+ }assert.equal(db.state.outbox.size,0);
78
+ const r=response();await service.capabilities({},r,{authorize:async()=>({identity})});assert.equal(r.code,503);
79
+ });
80
+ test('clip already available, missing and request failure are reported without discarding pictures',async()=>{
81
+ const {e,binding}=await setup(),db=memorySql(),d=deps(binding,db.repository);let r=response();await service.receive({body:e},r,d);
82
+ db.state.clips.set(r.body.alertId,{state:'uploaded'});r=response();await service.receive({body:e},r,d);assert.equal(r.body.clipState,'available');
83
+ db.state.clips.set(r.body.alertId,{state:'deleted'});r=response();await service.receive({body:e},r,d);assert.equal(r.body.clipState,'unavailable');
84
+ assert.equal(db.state.packets.values().next().value.packet.pictures.length,13);
85
+ const failed=memorySql({clipError:true}),missing=response();await service.receive({body:e},missing,deps(binding,failed.repository));
86
+ assert.equal(missing.code,202);assert.equal(missing.body.clipState,'unavailable');assert.equal(failed.state.outbox.size,1);
87
+ assert(failed.queries.some(q=>q.sql==='ROLLBACK TO SAVEPOINT theft_clip'));
88
+ assert(failed.queries.some(q=>q.sql.startsWith('UPDATE retained_cctv_theft_cases SET clip_error')&&q.p[1]==='Fixture clip storage failure'));
89
+ });
90
+ test('database outage returns retryable failure, not a false acceptance or permanent malformed-packet verdict',async()=>{
91
+ const {e,binding}=await setup(),r=response();await service.receive({body:e},r,deps(binding,{accept:async()=>{throw Error('Fixture DB offline');}}));
92
+ assert.equal(r.code,503);assert.equal(r.body.accepted,undefined);
93
+ });
94
+ test('delivery preparation rechecks scope and entitlement; no cross-person grouping or automatic hold',async()=>{
95
+ const {e,binding}=await setup(),db=memorySql();let r=response();await service.receive({body:e},r,deps(binding,db.repository));const payload=db.state.outbox.get(r.body.alertId).payload;
96
+ const d={caseRepository:db.repository,reviews:{accountEnabled:async()=>true},routes:{getRouteById:async()=>route,getAlertPrefsForOwner:async()=>({maxPerDay:20})},
97
+ entitlement:async()=>({alertsAllowed:true}),deliveryPolicy:()=>({actions:[{channel:'email'}],target:'realtime',windowSeconds:100}),config:{getInt:(_k,v)=>v},now:()=>106500};
98
+ const prepared=await service.prepareDelivery(payload,d);assert.equal(prepared.windowSeconds,undefined);assert.equal(prepared.safetyHold,undefined);assert.equal(prepared.context.alert.title,contract.MESSAGE);
99
+ assert.equal((await service.prepareDelivery(payload,{...d,now:()=>900000})).suppressed,'stale_event');
100
+ await assert.rejects(service.prepareDelivery(payload,{...d,entitlement:async()=>({alertsAllowed:false})}),/entitlement/);
101
+ await assert.rejects(service.prepareDelivery(payload,{...d,routes:{...d.routes,getRouteById:async()=>({...route,ownerId:'other'})}}),/binding/);
102
+ });
103
+ test('existing retained delivery retries only the unacknowledged channel and retains one alert/clip identity',async()=>{
104
+ const deliver=load(path.join(api,'services/notifications/retainedCctvAlerts.js'),{
105
+ '../pgRepo/retainedCctvAlerts':{},'./retainedAlertEvidence':{},'./retainedAlertDeliveryPolicy':{},'./retainedAlertLiveness':{}}).deliver;
106
+ const actions=[{channel:'whatsapp',recipientE164:'+15550000000'},{channel:'email',recipientEmail:'fixture@example.invalid'}],sent=[];
107
+ let progress={},failEmail=true;const row={alert_id:'a'.repeat(64),payload:{},progress};
108
+ const repository={saveProgress:async(_r,p)=>{progress=structuredClone(p);},reservePeopleGroup:()=>{throw Error('Cases must not coalesce across people');}};
109
+ const d={prepare:async()=>({actions,target:'realtime',context:{},cap:20}),overBudget:async()=>false,clipLink:async()=>({watchUrl:'https://example.invalid/clip/case'}),
110
+ send:async(context,a)=>{sent.push(a.channel);assert.equal(context.retainedAlertId,row.alert_id);assert.match(context.clipWatchUrl,/case$/);if(a.channel==='email'&&failEmail)throw Error('Email down');return {sent:true,messageId:a.channel+'-id'};}};
111
+ await assert.rejects(deliver(row,repository,d),/Email down/);failEmail=false;await deliver({...row,progress},repository,d);
112
+ assert.deepEqual(sent,['whatsapp','email','email']);assert.equal(Object.keys(progress.accepted).length,2);
113
+ });
114
+ test('existing WhatsApp feedback binds recipient and case, deduplicates request id, and preserves uncertainty',async()=>{
115
+ const wa=load(path.join(contracts,'services/notifications/whatsappAlertFeedback.js'),{'../../utils/appLogger':logger});
116
+ const writes=new Map(),log={findOutboundByProviderMessageId:async()=>({retainedAlertId:'case',ownerId:'owner',recipient:'+15550000000'})};
117
+ const repository={recordOperatorAction:async row=>writes.set(row.requestId,row)};
118
+ let syncs=0;
119
+ const d={deliveryLog:log,repository,afterFeedbackLabel:async()=>{},watchlistSync:async scope=>{
120
+ assert.deepEqual(scope,{ownerId:'owner',alertId:'case'});syncs++;
121
+ }};
122
+ const message={id:'inbound1',reaction:{messageId:'outbound1',emoji:'👎'}};
123
+ await wa.recordFromMessage(message,{e164:'+15550000000'},d);await wa.recordFromMessage(message,{e164:'+15550000000'},d);assert.equal(writes.size,1);
124
+ assert.equal(contract.feedbackMeaning([...writes.values()][0].feedbackCategory),'negative_unspecified');
125
+ assert.equal(await wa.recordFromMessage({...message,id:'bad'},{e164:'+15559999999'},d),null);assert.equal(writes.size,1);
126
+ await wa.recordFromMessage({id:'unclear',contextId:'outbound1',body:'unclear'},{e164:'+15550000000'},d);
127
+ assert.equal([...writes.values()][1].action,'noted');assert.equal([...writes.values()][1].note,'unclear');
128
+ assert(syncs>0,'Existing watchlist synchronization remains connected');
129
+ });
130
+ test('theft negative feedback bypasses static hold; ordinary feedback still uses existing hold query',async()=>{
131
+ const safety=load(path.join(api,'services/notifications/boxMethodSafety.js'),{'../fein/alertFocusFields':{observedFieldForRoute:()=> 'person_present'}});
132
+ let calls=0;const input={ownerId:'owner',alertId:'case',feedbackCategory:'wrong_detection'};
133
+ const a=await safety.afterFeedbackLabel(input,{query:async()=>{calls++;return {rows:[{screen_id:'camera',field:'person_present',theft_version:'1'}]};}});assert.equal(a.held,false);assert.equal(calls,1);
134
+ calls=0;await safety.afterFeedbackLabel(input,{query:async()=>{calls++;return {rows:calls===1?[{screen_id:'camera',field:'person_present'}]:[]};}});assert.equal(calls,2);
135
+ });
@@ -0,0 +1,92 @@
1
+ 'use strict';
2
+ require('./support/load-sdk-sources.cjs');
3
+ const {test,afterEach}=require('node:test'),assert=require('node:assert/strict'),fs=require('node:fs'),path=require('node:path');
4
+ const yaml=require('js-yaml');
5
+ const {supervisorFixture}=require('./support/theft-readiness.cjs');
6
+ const {fixture,cleanupFixtures}=require('./support/theft-packet-fixture.cjs');
7
+ const {api,root,load}=require('./support/pinned-api-loader.cjs');
8
+ const contract=require('../TheftCaseContract.cjs');
9
+ afterEach(cleanupFixtures);
10
+
11
+ test('ordinary failed probe preserves the existing diagnostic and health-only startup',async()=>{
12
+ const calls=[],manager={async start(options){calls.push(options);},async stop(){}};
13
+ const s=supervisorFixture(manager,{ok:false,reason:'connect ECONNREFUSED'});
14
+ try{await s.supervisor.startInitial();
15
+ assert.deepEqual(Object.entries(calls[0]),[['healthOnly',true]]);
16
+ assert(s.logs.some(line=>/LOCAL AI is not ready yet/i.test(line)&&/ECONNREFUSED/.test(line)));
17
+ assert(s.logs.some(line=>/HEALTH-ONLY mode/i.test(line)));
18
+ assert(!s.logs.some(line=>/restart the connector/i.test(line)));
19
+ }finally{await s.supervisor.shutdown();assert.equal(s.timers.size,0);}
20
+ });
21
+
22
+ test('explicit native-theft admission stays distinct from ordinary model health',async()=>{
23
+ const calls=[],manager={async start(){throw Error('Must use explicit native entry');},async stop(){},
24
+ async startNativeTheftOnly(){calls.push('native');}};
25
+ const s=supervisorFixture(manager,{ok:false,reason:'connect ECONNREFUSED'});
26
+ try{await s.supervisor.startInitial();assert.deepEqual(calls,['native']);assert.equal(s.supervisor.currentMode,'waiting');
27
+ assert(s.logs.some(line=>/native.theft admission/i.test(line)));
28
+ assert(!s.logs.some(line=>/LOCAL on-device sensing selected/.test(line)));
29
+ }finally{await s.supervisor.shutdown();assert.equal(s.timers.size,0);}
30
+ });
31
+
32
+ test('real default case repository delegates transaction control and deadline to the existing PG owner',async()=>{
33
+ const f=fixture();await f.capture();await f.connector.reviewOne({cameraBusy:false});
34
+ const e=contract.makeEnvelope(f.receiver.savedPackets()[0],{profileId:'theft',selectionId:'selected'});
35
+ const identity={ownerId:'owner',screenId:'camera'},binding={route:{routeId:'route'}};
36
+ const failure=Error('exact advisory-lock failure'),events=[];let failLock=false,transactions=0;
37
+ const query=async(sql,p=[])=>{
38
+ assert(!/^(BEGIN|COMMIT|ROLLBACK)$/.test(sql),'Only withClientTimeout may control the transaction');
39
+ events.push(sql);
40
+ if(sql.includes('pg_advisory')&&failLock)throw failure;
41
+ if(sql.includes('INSERT INTO retained_cctv_theft_cases'))return {rows:[{alert_id:p[0],owner_id:p[1],screen_id:p[2],incident_id:p[3],scope_sha256:p[4],route_id:p[5],captured_at_ms:p[6]}]};
42
+ if(sql.includes('INSERT INTO retained_cctv_theft_case_packets'))return {rows:[{packet_id:p[1]}]};
43
+ if(sql.startsWith('SELECT state FROM retained_cctv_alert_clips'))return {rows:[{state:'requested'}]};
44
+ return {rows:[]};
45
+ };
46
+ const pg={withClientTimeout:async(work,timeout,options)=>{
47
+ transactions++;assert.equal(timeout,10000);assert(options.deadlineAtMs>Date.now());
48
+ assert(options.deadlineAtMs<=Date.now()+10000);
49
+ try{const result=await work({query});events.push('owner:commit');return result;}
50
+ catch(error){events.push('owner:rollback');throw error;}
51
+ }};
52
+ const mod=load(path.join(api,'services/pgRepo/retainedTheftCases.js'),{
53
+ '../theftCaseContract':contract,'../postgresClient':pg,'./_helpers':{runWriteQueryWithTimeout:query},
54
+ './retainedCctvAlertClips':{ALERT_CLIP_REQUEST_SQL:'FIXTURE_CLIP_REQUEST',alertClipRequestParams:id=>[id]}});
55
+ const repository=mod.getRepository(),input={identity,binding,envelope:e,alertId:'a'.repeat(64)};
56
+ assert.equal((await repository.accept(input)).clipState,'pending');assert.equal(transactions,1);
57
+ assert.equal(events.filter(x=>x==='owner:commit').length,1);assert(events.includes('SAVEPOINT theft_clip'));
58
+ assert(events.includes('RELEASE SAVEPOINT theft_clip'));
59
+ failLock=true;await assert.rejects(repository.accept(input),error=>error===failure);
60
+ assert.equal(transactions,2);assert.equal(events.filter(x=>x==='owner:rollback').length,1);
61
+ assert.equal(events.filter(x=>x==='owner:commit').length,1);
62
+ });
63
+
64
+ test('existing SDK CI checkout contains every registered cross-service theft fixture source',()=>{
65
+ const workflow=yaml.load(fs.readFileSync(path.join(root,'.github/workflows/ci.yml'),'utf8'));
66
+ const checkout=workflow.jobs['build-edge-sdk'].steps.find(step=>step.uses==='actions/checkout@v4');
67
+ const paths=checkout.with['sparse-checkout'].trim().split(/\r?\n/).map(value=>value.trim());
68
+ const required=['services/retainedTheftCases.js','services/retainedTheftBindings.js','services/theftCaseContract.js',
69
+ 'services/sensing/serverProducedFields.js',
70
+ 'services/pgRepo/retainedTheftCases.js','services/pgRepo/retainedCctvAlertClips.js',
71
+ 'services/notifications/retainedCctvAlerts.js','services/notifications/whatsappAlertFeedback.js',
72
+ 'services/notifications/boxMethodSafety.js','tests/unit/retainedTheftEntry.test.cjs','tests/unit/retainedTheftBindings.test.cjs'];
73
+ for(const file of required){const rel='trillboard-api/'+file;
74
+ assert(paths.some(entry=>entry===rel||rel.startsWith(entry+'/')),'Missing explicit checkout dependency: '+rel);
75
+ assert(fs.statSync(path.join(root,rel)).isFile());
76
+ }
77
+ const pkg=JSON.parse(fs.readFileSync(path.join(root,'trillboards-edge-sdk/packages/edge-sdk/package.json'),'utf8'));
78
+ assert(pkg.scripts['test:theft-review'].includes('theft-ci-regression.test.cjs'),'Regression must be registered in the existing lane');
79
+ });
80
+
81
+ test('separately distributed server and connector retain the same complete evidence wire contract',async()=>{
82
+ const server=require(path.join(api,'services/theftCaseContract.js'));
83
+ const f=fixture();await f.capture();await f.connector.reviewOne({cameraBusy:false});
84
+ const packet=f.receiver.savedPackets()[0],binding={profileId:'theft',selectionId:'selected'};
85
+ const sent=contract.makeEnvelope(packet,binding),received=server.makeEnvelope(packet,binding);
86
+ assert.deepEqual(received,sent);assert.equal(received.packet.pictures.length,13);
87
+ assert.equal(received.packet.receipt.deadlineMs,received.packet.receipt.firstCaptureMs+90000);
88
+ assert.deepEqual(server.validateEnvelope(sent),received);assert.deepEqual(contract.validateEnvelope(received),sent);
89
+ const changed=structuredClone(sent);changed.packet.pictures[0].jpegBase64+='AA==';
90
+ assert.throws(()=>server.validateEnvelope(changed));assert.throws(()=>contract.validateEnvelope(changed));
91
+ assert.equal(server.MESSAGE,contract.MESSAGE);assert.equal(server.MAX_BYTES,contract.MAX_BYTES);
92
+ });
@@ -0,0 +1,84 @@
1
+ 'use strict';
2
+ const test = require('node:test');
3
+ const assert = require('node:assert/strict');
4
+ const path = require('node:path');
5
+ const fs = require('node:fs');
6
+ const os = require('node:os');
7
+ const {createHash} = require('node:crypto');
8
+ require('./support/load-sdk-sources.cjs');
9
+ const {resolveConfig} = require('../../src/config.ts');
10
+ const base = () => ({deviceToken: 'fixture-token', localSensing: {enabled: true}});
11
+ const input = theftReview => ({...base(), localSensing: {enabled: true, theftReview}});
12
+ const good = () => ({enabled: true, packageFile: path.resolve('fixture-descriptor.json'), packageSha256: 'a'.repeat(64)});
13
+
14
+ test('ordinary configuration has no theft activation setting', () => {
15
+ const config = resolveConfig(base());
16
+ assert.equal(config.localSensing.theftReview, undefined);
17
+ assert.equal(config.localSensing.enabled, true);
18
+ });
19
+ test('explicit disabled theft leaves ordinary sensing settings intact', () => {
20
+ const config = resolveConfig(input({enabled: false}));
21
+ assert.deepEqual(config.localSensing.theftReview, {enabled: false});
22
+ assert.equal(config.localSensing.enabled, true);
23
+ });
24
+ test('enabled theft accepts only an explicitly pinned package location', () => {
25
+ const value = good();
26
+ assert.deepEqual(resolveConfig(input(value)).localSensing.theftReview, value);
27
+ });
28
+ test('enabled theft rejects a missing package filename', () => {
29
+ const value = good(); delete value.packageFile;
30
+ assert.throws(() => resolveConfig(input(value)), /theft.*package/i);
31
+ });
32
+ test('enabled theft rejects a relative package filename', () => {
33
+ assert.throws(() => resolveConfig(input({...good(), packageFile: 'relative.json'})), /theft.*package/i);
34
+ });
35
+ test('enabled theft rejects an invalid descriptor hash', () => {
36
+ assert.throws(() => resolveConfig(input({...good(), packageSha256: 'not-a-hash'})), /theft.*sha/i);
37
+ });
38
+ test('theft enabled must be a boolean when supplied', () => {
39
+ assert.throws(() => resolveConfig(input({...good(), enabled: 'yes'})), /theft.*enabled/i);
40
+ });
41
+
42
+ test('the installed live descriptor admits only the same camera and shelf as the pinned worker config', () => {
43
+ const {loadInstalledTheftPackage} = require('../InstalledTheftPackage.cjs');
44
+ const {OBSERVED_TIMING} = require('../FrameTheftRuntime.cjs');
45
+ const {KIND,TEMPLATE} = require('../LiveTheftBinding.cjs');
46
+ const sha = bytes => createHash('sha256').update(bytes).digest('hex');
47
+ const parent = fs.realpathSync(os.tmpdir());
48
+ const root = fs.mkdtempSync(path.join(parent, 'fixture-live-shelf-'));
49
+ const pin = (name, data = name) => {
50
+ const file = path.join(root, name);
51
+ fs.writeFileSync(file, data, {flag:'wx'});
52
+ return {path:file,sha256:sha(data)};
53
+ };
54
+ try {
55
+ const command = pin('runtime.exe'), worker = pin('FrameTheftWorker.py'), owner = pin('TheftMovementOwner.py');
56
+ const sources = {native:pin('native.py'),case:pin('case.py'),wrist:pin('wrist.py')};
57
+ const cameraId = 'paired-camera', sourceId = 'a'.repeat(64), frameSize = [640,480];
58
+ const shelf = [[100000,100000],[800000,100000],[800000,600000]];
59
+ const environment = {kind:KIND,cameraId,sourceId,frameSize,shelf,
60
+ regionConfigurationSha256:sha(JSON.stringify([KIND,cameraId,sourceId,frameSize,shelf]))};
61
+ const registration = {version:1,profiles:[{feedName:'fixture-camera',reviewMode:'human_only',templateId:TEMPLATE,
62
+ sceneId:0,environment}]};
63
+ const base = {version:3, captureTimingPolicy:OBSERVED_TIMING, sources,
64
+ nativeConfig:{frameRate:2,rfdetrThreads:4,poseThreads:2,maxCameras:1,cameraEnvironments:{[cameraId]:environment}}};
65
+ const prepare = (name, config) => {
66
+ const file = pin(name+'-worker.json',JSON.stringify(config));
67
+ const descriptor = pin(name+'.json',JSON.stringify({schema:'installed_human_only_theft/v1',registration,sharedGemma:null,
68
+ frameRuntime:{command:command.path,workerFile:worker.path,configFile:file.path,configSha256:file.sha256,
69
+ pinnedFiles:[command,worker,owner,...Object.values(sources)]}}));
70
+ return loadInstalledTheftPackage({file:descriptor.path,sha256:descriptor.sha256,stateDirectory:path.join(root,'state')});
71
+ };
72
+ const accepted = prepare('valid',base);
73
+ assert.equal(accepted.runtime.installedLifecycle.current,null);
74
+ assert.equal(accepted.runtime.reviewer,null);
75
+ const wrong = structuredClone(base);
76
+ wrong.nativeConfig.cameraEnvironments[cameraId].shelf[0][0] += 1;
77
+ assert.throws(() => prepare('wrong-shelf',wrong),/Live worker and connector shelf bindings differ/);
78
+ assert.throws(() => prepare('wrong-version',{...base,version:2}),/matching observed-clock configuration/);
79
+ } finally {
80
+ assert.equal(fs.realpathSync(root),root);
81
+ assert.equal(path.dirname(root),parent);
82
+ fs.rmSync(root,{recursive:true});
83
+ }
84
+ });
@@ -0,0 +1,76 @@
1
+ 'use strict';
2
+ const test=require('node:test'),assert=require('node:assert/strict'),path=require('node:path');
3
+ const {fixture}=require('./support/theft-builder.cjs');
4
+ const settings=()=>({enabled:true,packageFile:path.resolve('descriptor-fixture.json'),packageSha256:'c'.repeat(64)});
5
+ function installed(extra={}) {
6
+ const calls=[];let s;
7
+ s=fixture({...extra,installedLoad:input=>{calls.push(input);return {registration:s.registration,runtime:s.lifecycle.runtime};}});
8
+ s.config.localSensing.theftReview=settings();return {...s,loads:calls};
9
+ }
10
+ test('default-off startup preserves the original manager and starts no theft owner',async()=>{
11
+ const s=fixture({environment:{TRILLBOARDS_EXPERIMENTAL_THEFT_PACKAGE_FILE:path.resolve('ignored.json'),
12
+ TRILLBOARDS_EXPERIMENTAL_THEFT_PACKAGE_SHA256:'a'.repeat(64)}});
13
+ const before=JSON.stringify(s.config),manager=await s.api.buildConfiguredLocalSensingManager(s.config,s.io);
14
+ assert.equal(manager,s.manager);assert.equal(manager.start,s.originalStart);assert.equal(manager.stop,s.originalStop);
15
+ assert(!s.imports.some(name=>name.includes('InstalledTheft')));assert.equal(s.owners.length,0);
16
+ assert.equal(JSON.stringify(s.config),before);assert.equal(s.factoryCalls[0][2].theftRuntime,undefined);
17
+ });
18
+ test('disabled setting never opens its descriptor or changes the ordinary profile',async()=>{
19
+ const s=fixture();s.config.localSensing.theftReview={...settings(),enabled:false};
20
+ await s.api.buildConfiguredLocalSensingManager(s.config,s.io);
21
+ assert(!s.imports.some(name=>name.includes('InstalledTheft')));assert.equal(s.owners.length,0);
22
+ assert.equal(s.factoryCalls[0][0].localSensing.model,s.config.localSensing.model);
23
+ });
24
+ test('enabled setting loads once and binds the same original paired manager',async()=>{
25
+ const s=installed(),manager=await s.api.buildConfiguredLocalSensingManager(s.config,s.io);
26
+ assert.equal(s.loads.length,1);assert.equal(s.loads[0].file,s.config.localSensing.theftReview.packageFile);
27
+ assert.equal(s.loads[0].sha256,s.config.localSensing.theftReview.packageSha256);
28
+ assert.equal(s.factoryCalls[0][2].theftRuntime,s.lifecycle.runtime);
29
+ assert.deepEqual(s.factoryCalls[0][0].pilot.experimentalTheft,s.registration);
30
+ assert.equal(manager,s.manager);assert.equal(s.lifecycle.manager,manager);assert.equal(s.owners.length,0);
31
+ assert.equal(s.lifecycle.runtime.reviewer,null);await manager.start();await manager.stop();
32
+ });
33
+ test('embedding cannot enable theft while the typed setting is absent',async()=>{
34
+ const s=fixture();await assert.rejects(s.api.buildConfiguredLocalSensingManager(s.config,s.io,
35
+ {experimentalTheft:{registration:s.registration,runtime:s.lifecycle.runtime}}),/explicit theftReview.enabled/);
36
+ assert.equal(s.factoryCalls.length,0);assert.equal(s.owners.length,0);
37
+ });
38
+ test('builder validates descriptor pin before importing the package',async()=>{
39
+ const s=installed();delete s.config.localSensing.theftReview.packageSha256;
40
+ await assert.rejects(s.api.buildConfiguredLocalSensingManager(s.config,s.io),/file and SHA-256/);
41
+ assert.equal(s.loads.length,0);assert.equal(s.factoryCalls.length,0);
42
+ });
43
+ test('every enabled entry requires human-only profiles even with an injected runtime',async()=>{
44
+ const s=installed(),registration=structuredClone(s.registration);registration.profiles[0].reviewMode='optional_gemma';
45
+ await assert.rejects(s.api.buildConfiguredLocalSensingManager(s.config,s.io,
46
+ {experimentalTheft:{registration,runtime:{rpc:{call(){}},describeOriginal(){},reviewer:null}}}),/human_only/);
47
+ assert.equal(s.factoryCalls.length,0);assert.equal(s.owners.length,0);
48
+ });
49
+ test('package failure preserves the exact error and performs no factory fallback',async()=>{
50
+ const cause=Object.assign(Error('exact pin diagnostic'),{code:'PIN_CHANGED'}),error=Error('package rejected',{cause});
51
+ const s=fixture({installedLoad:()=>{throw error;}});s.config.localSensing.theftReview=settings();
52
+ await assert.rejects(s.api.buildConfiguredLocalSensingManager(s.config,s.io),e=>e===error&&e.cause===cause);
53
+ assert.equal(s.factoryCalls.length,0);assert.equal(s.owners.length,0);
54
+ });
55
+ test('factory failure retains complete diagnostics before native work starts',async()=>{
56
+ const cause=Object.assign(Error('profile setup detail'),{code:'PROFILE_SETUP'}),error=Error('manager failed',{cause});
57
+ const s=installed({factoryError:error});await assert.rejects(s.api.buildConfiguredLocalSensingManager(s.config,s.io),e=>e===error);
58
+ assert.equal(s.diagnostics[0].component,'manager_build');assert.equal(s.diagnostics[0].error.cause.code,'PROFILE_SETUP');
59
+ assert.equal(s.owners.length,0);assert.equal(s.lifecycle.manager,null);
60
+ });
61
+ test('native-only startup keeps13 pictures, queue-inclusive90s and no Gemma owner',async()=>{
62
+ const s=installed(),manager=await s.api.buildConfiguredLocalSensingManager(s.config,s.io);
63
+ await manager.startNativeTheftOnly();assert.deepEqual(s.events[0][1],{nativeTheftOnly:true});
64
+ assert.equal(s.lifecycle.contract.reviewPictures,13);assert.equal(s.lifecycle.contract.queueInclusiveReviewLimitMs,90000);
65
+ assert.equal(s.lifecycle.runtime.reviewer,null);assert.equal(s.owners.length,0);await manager.stop();
66
+ });
67
+ test('no feeds returns before package import or preparation',async()=>{
68
+ const s=installed();s.config.cameras=[];
69
+ assert.equal(await s.api.buildConfiguredLocalSensingManager(s.config,s.io),null);
70
+ assert.equal(s.loads.length,0);assert.equal(s.factoryCalls.length,0);assert.equal(s.owners.length,0);
71
+ });
72
+ test('non-website configuration does not silently route enabled theft elsewhere',async()=>{
73
+ const s=installed();s.config.cloudSensing.candidateBuffer.continuousReview={enabled:false};
74
+ await assert.rejects(s.api.buildConfiguredLocalSensingManager(s.config,s.io),/website manager/);
75
+ assert.equal(s.factoryCalls.length,0);assert.equal(s.owners.length,0);
76
+ });
@@ -0,0 +1,90 @@
1
+ 'use strict';
2
+ const test=require('node:test'),assert=require('node:assert/strict');
3
+ const {load}=require('./support/theft-readiness.cjs');
4
+ const Cloud=load('src/CloudSensingManager.ts').CloudSensingManager;
5
+ const tick=()=>new Promise(resolve=>setImmediate(resolve));
6
+ test('ordinary detector recovery clears its existing pause report and resumes capture',async()=>{
7
+ const events=[],m=Object.assign(Object.create(Cloud.prototype),{healthOnlyMode:false,nativeTheftOnlyMode:false,
8
+ isCurrentStart:()=>true,markFeedIdle:(_s,idle)=>events.push(['idle',idle]),scheduleNext:()=>events.push(['next'])});
9
+ const s={deps:{client:{prepareReview:async()=>{},isReviewActive:()=>true}},readinessRetryTimer:null,
10
+ nativePauseReported:true,tickInFlight:false,timer:null};
11
+ m.resumeWhenReviewReady(s,1);await tick();
12
+ assert.equal(s.nativePauseReported,false);assert.deepEqual(events,[['idle',false],['next']]);
13
+ });
14
+ test('native-only admission does not resume an ordinary camera after its readiness settles',async()=>{
15
+ let scheduled=0;const m=Object.assign(Object.create(Cloud.prototype),{healthOnlyMode:false,nativeTheftOnlyMode:true,
16
+ isCurrentStart:()=>true,markFeedIdle:()=>{},scheduleNext:()=>scheduled++});
17
+ const s={deps:{client:{prepareReview:async()=>{},isReviewActive:()=>true,isNativeTheftActive:()=>false}},
18
+ readinessRetryTimer:null,nativePauseReported:true,tickInFlight:false,timer:null};
19
+ m.resumeWhenReviewReady(s,1);await tick();assert.equal(scheduled,0);assert.equal(s.nativePauseReported,false);
20
+ });
21
+ test('ordinary detector downtime retains256 waiting state instead of being reported idle',async()=>{
22
+ const reports=[],m=Object.assign(Object.create(Cloud.prototype),{healthOnlyMode:false,nativeTheftOnlyMode:false,
23
+ captureCameraFrame:async()=>{},reportCameraOpen:(_s,row)=>reports.push(row),emit:()=>{}});
24
+ const s={deps:{client:{isReviewActive:()=>false,isNativeDetectorDown:()=>true}},captureCount:0};
25
+ await m.captureHealthFrame(s);assert.equal(reports[0].sensingState,'waiting_for_capacity');
26
+ assert.equal(s.captureCount,1);assert.equal(m.healthCaptureInFlight,false);
27
+ });
28
+
29
+
30
+ const {TheftDeliveryPump}=require('../TheftDeliveryPump.cjs');
31
+ function startDeliveryAttempt(perform){
32
+ let calls=0;
33
+ const delivery={pending:()=>[{}],async drainOne(){calls++;return perform();}};
34
+ return {delivery,get calls(){return calls;}};
35
+ }
36
+ function deliveryPump(deliveries,clock){
37
+ const pump=new TheftDeliveryPump(new Map([['camera',{deliveries:()=>deliveries}]]),{now:()=>clock.value});
38
+ pump.stopped=false;
39
+ return pump;
40
+ }
41
+
42
+ test('temporary outages retry with bounded backoff and resume the same delivery session',async()=>{
43
+ const clock={value:0};let online=false;let accepted=0;
44
+ const caseDelivery=startDeliveryAttempt(()=>{
45
+ if(!online)throw Object.assign(new Error('Temporary transport error'),{status:503});
46
+ accepted++;
47
+ });
48
+ const pump=deliveryPump([caseDelivery.delivery],clock);
49
+ for(const [index,delay] of [1000,2000,4000,8000,16000,32000,60000,60000].entries()){
50
+ await pump.tick();
51
+ assert.equal(caseDelivery.calls,index+1,'one first attempt per due retry');
52
+ clock.value+=delay-1;
53
+ await pump.tick();
54
+ assert.equal(caseDelivery.calls,index+1,'no retry before its deadline');
55
+ clock.value++;
56
+ }
57
+ online=true;
58
+ await pump.tick();
59
+ assert.equal(accepted,1,'existing session delivers once its network recovers');
60
+ clock.value+=1000;
61
+ await pump.tick();
62
+ assert.equal(accepted,2,'the recovered session can send later cases');
63
+ });
64
+
65
+ test('a rate-limited delivery backs off while another session keeps delivering',async()=>{
66
+ const clock={value:0};let rateLimited=true;let accepted=0;
67
+ const first=startDeliveryAttempt(()=>{
68
+ if(rateLimited)throw Object.assign(new Error('Temporary limit'),{status:429});
69
+ accepted++;
70
+ });
71
+ const other=startDeliveryAttempt(()=>{});
72
+ const pump=deliveryPump([first.delivery,other.delivery],clock);
73
+ await pump.tick();
74
+ await pump.tick();
75
+ assert.equal(other.calls,1);
76
+ clock.value=1000;
77
+ rateLimited=false;
78
+ await pump.tick();
79
+ assert.equal(accepted,1,'429 permits a later recovery attempt');
80
+ });
81
+
82
+ test('a permanent HTTP rejection remains held across scheduler ticks',async()=>{
83
+ const clock={value:0};
84
+ const rejected=startDeliveryAttempt(()=>{throw Object.assign(new Error('Bad packet'),{status:400});});
85
+ const pump=deliveryPump([rejected.delivery],clock);
86
+ await pump.tick();clock.value=61_000;
87
+ await pump.tick();clock.value=181_000;
88
+ await pump.tick();
89
+ assert.equal(rejected.calls,1);
90
+ });