@econ-v1/app-sdk 7.5.9 → 7.5.11

package/dist/app-log.d.ts

@@ -0,0 +1,11 @@
+export declare const ERROR_REPORT_INTERVAL_MS = 60000;
+export interface AppLogWriter {
+    write(level: string, message: string): void;
+}
+export interface AppLogWriterOptions {
+    /** Where a failed write is reported. Defaults to `console.error`. */
+    reportError?: (line: string) => void;
+    /** Clock for the report rate limit. Defaults to `Date.now`. */
+    now?: () => number;
+}
+export declare function createAppLogWriter(logDir: string | undefined, options?: AppLogWriterOptions): AppLogWriter;

package/dist/burger/index.js

@@ -1,2 +1,2 @@
-var ee=Object.defineProperty;var te=(e)=>e;function ne(e,t){this[e]=te.bind(null,t)}var oe=(e,t)=>{for(var o in t)ee(e,o,{get:t[o],enumerable:!0,configurable:!0,set:ne.bind(t,o)})};import{appendFileSync as le,mkdirSync as me,existsSync as fe}from"burger:fs";import{join as ye}from"burger:path";import{Database as ge}from"burger:sqlite";var w={};oe(w,{incrementCounter:()=>S,initAppTelemetry:()=>R,injectTraceContext:()=>re,telemetryActive:()=>A,traceIncomingCapability:()=>ie});async function R(e){}function A(){return!1}function S(e,t=1,o){}function re(e){return e}async function ie(e,t,o){return o()}import{connect as se,dataDir as ae,exit as L,logDir as pe,memoryUsage as ce}from"burger:host";var E=!0,F=256;function k(){return{socket:void 0,logDir:pe,dataDir:ae}}var M=k();function D(){return M.socket}function j(e,t,o=L){o(e)}function m(e){L(e)}function z(){}var ue=/the app channel is (not open|closed)/;function U(e){let t=se(),o=!0,n=!1;function i(r){if(n)return;try{t.send(r)}catch(s){if(s instanceof Error&&ue.test(s.message)){n=!0;return}throw s}}return t.onFrame((r)=>{if(!o)return;e.onFrame(r).catch((s)=>e.onFrameError(s))}),t.onClose((r)=>{if(n=!0,r)e.onError(r);else e.onClose()}),queueMicrotask(()=>e.onConnected("burger:host")),{send(r){i(r)},sendAndFlush(r){return i(r),Promise.resolve()},stopAccepting(){o=!1},end(){n=!0,t.close()}}}function B(){let e;return{run(t,o){let n=e;e=t;try{return o()}finally{e=n}},getStore(){return e}}}function K(){let e=ce();return{heap_used_kb:Math.round(e.heap_used_kb),heap_total_kb:Math.round(e.heap_total_kb),external_kb:Math.round(e.external_kb),heap_capacity_kb:Math.round(e.heap_capacity_kb)}}function H(){throw Error("heap snapshots are not available in the Burger runtime")}async function O(e,t=H,o=H){let n=t();return{size_bytes:await o(e,n)}}var{injectTraceContext:be,traceIncomingCapability:_e}=w,he=R,De=A,$e=S,ve=F;function je(e,t={}){let o=t.cacheSizeKb??ve;if(!Number.isInteger(o)||o<=0)throw RangeError("cacheSizeKb must be a positive integer");let n=new ge(e);try{return n.exec(`PRAGMA cache_size = -${o}`),n}catch(i){throw n.close(),i}}var ze=k,Ue=D,Be=j,y=M.logDir,W=y?ye(y,"app.log"):null,P=!1;function xe(){if(P||!y)return;try{if(!fe(y))me(y,{recursive:!0});P=!0}catch{}}function Ce(e,t){if(!W)return;if(xe(),!P)return;let n=`${new Date().toISOString()} [${e.toUpperCase().padEnd(5)}] ${t}
-`;try{le(W,n)}catch{}}var p=null,Z=B(),g=new Map,c={trace:(e)=>f("trace",e),debug:(e)=>f("debug",e),info:(e)=>f("info",e),warn:(e)=>f("warn",e),error:(e)=>f("error",e),holdLease:()=>{let e=!1;return h(),()=>{if(e)return;e=!0,v()}}};function f(e,t){if(Ce(e,t),p)p({type:"log",level:e,message:t});else console[e==="trace"?"debug":e](t)}function Ke(e,t){if(!p)return Promise.reject(Error("Not connected to host"));let o=t??30000,n=e.timeout_ms===void 0?{...e,timeout_ms:o}:e,i={...n,trace_context:be({...n.trace_context??{}})},r=Z.getStore();if(r?.active&&r.id!==void 0)i.invocation_context_id=r.id;return new Promise((s,a)=>{g.set(e.id,{resolve:s,reject:a}),p({type:"invoke_capability",id:e.id,request:i}),setTimeout(()=>{if(g.has(e.id))g.delete(e.id),a(Error(`Capability invocation timed out after ${o}ms: ${e.capability}`))},o)})}function Oe(e,t){if(!p)throw Error("Not connected to host");p({type:"publish_event",event_name:e,data:t})}var u=0,b,d=null,_=!1,C,V=()=>m(0),T=V,q,Y=(e)=>(p?.(e),Promise.resolve()),N=Y;function G(e){if(b=e,e===void 0)I()}function I(){if(d)clearTimeout(d),d=null}function Ie(){if(_)return;if(b===void 0)return;if(u!==0)return;I();let e=Math.max(0,b*1000),t=setTimeout(()=>{d=null,Re()},e);t.unref?.(),d=t}function h(){u++,I()}function v(){if(u=Math.max(0,u-1),u===0)Ie()}async function Re(){if(_)return;if(_=!0,q?.(),C)await C.shutdown();await N({type:"lease_exit"}),T()}function We(){I(),u=0,b=void 0,_=!1,C=void 0,T=V,q=void 0,N=Y}function Ge(e){T=e}function Qe(){return{inFlight:u,rememberedSecs:b,timerArmed:d!==null,draining:_}}var Ae=30000;function Se(){let e=process.env.NODE_APP_MEMORY_SAMPLE_INTERVAL_MS,t=e?Number.parseInt(e,10):NaN;return Number.isFinite(t)&&t>=1000?t:Ae}var l=null,we=K;function Q(e){e({type:"app_memory",...we()})}function Ee(e){if(l)return;Q(e),l=setInterval(()=>Q(e),Se()),l.unref?.()}function x(){if(l)clearInterval(l),l=null}var ke=O;async function Me(e,t,o=ke){try{let n=await o(e.path);t({type:"heap_snapshot_response",id:e.id,success:!0,size_bytes:n.size_bytes})}catch{t({type:"heap_snapshot_response",id:e.id,success:!1,error:"heap_snapshot_failed"})}}function Pe(e,t){let o=t.indexOf("?"),n=o>=0?t.slice(0,o):t,i=e.split("/"),r=n.split("/"),s=0,a=0;while(s<i.length){if(i[s]==="**")return!0;if(a>=r.length)return!1;if(i[s]!=="*"&&i[s]!==r[a])return!1;s++,a++}return a===r.length}class Te{_routes=[];route(e,t,o,n){this._routes.push({method:e,path:t,policy:o,handler:n})}async init(e){}async shutdown(){}async handleRequest(e){if(this._routes.length>0)return this._dispatchRoute(e);return{status:501,headers:{},body:{error:"Not implemented"}}}async _dispatchRoute(e){let t=e.method.toUpperCase(),o=e.path;for(let n of this._routes){if(!(n.method==="*"||n.method.toUpperCase()===t))continue;if(!Pe(n.path,o))continue;let r=n.policy.requiredPermissions??[],s=e.caller?.granted_permissions??[],a=r.filter((X)=>!s.includes(X));if(a.length>0)return c.warn(`SDK scope denied: [${a.join(", ")}] missing for ${t} ${o}`),{status:403,headers:{},body:{error:`Missing permissions: ${a.join(", ")}`}};return n.handler(e)}return this.notFound()}async handleEvent(e){}providedCapabilities(){return[]}async handleCapability(e){return{id:e.id,success:!1,payload:{error:"Capability handling not implemented"}}}json(e,t=200){return{status:t,headers:{"Content-Type":"application/json"},body:e}}error(e,t=500){return{status:t,headers:{"Content-Type":"application/json"},body:{error:e}}}notFound(){return this.error("Not found",404)}}function Ze(e){z(),he(e.metadata?.name??"node-app");let t=U({onConnected:(n)=>{c.debug(`Connected to host via ${n}`)},onFrame:(n)=>J(e,n,o),onFrameError:(n)=>{c.error(`Failed to parse IPC message: ${n}`)},onError:(n)=>{console.error(`[node-app-sdk] Socket error: ${n.message}`),m(1)},onClose:()=>{x(),m(0),c.debug("Socket closed, shutting down")}});function o(n){t.send(n)}p=o,q=()=>{t.stopAccepting()},N=(n)=>t.sendAndFlush(n),process.on("SIGTERM",async()=>{if(!E)return;x(),await e.shutdown(),t.end(),process.exit(0)}),process.on("SIGINT",async()=>{if(!E)return;x(),await e.shutdown(),t.end(),process.exit(0)})}async function J(e,t,o){switch(C=e,t.type){case"init":{let n=t.config;await e.init(n),o({type:"ready",metadata:e.metadata}),Ee(o);break}case"request":{let{id:n,request:i}=t;h();try{let r=await e.handleRequest(i);o({type:"response",id:n,response:r})}catch(r){o({type:"response",id:n,response:{status:500,headers:{},body:{error:`Internal app error: ${r}`}}})}finally{v()}break}case"event":{let{event:n,lease_secs:i}=t;G(i),h();try{await e.handleEvent(n)}catch(r){c.error(`Event handler error: ${r}`)}finally{v()}break}case"capability_request":{let{id:n,request:i}=t;G(i.lease_secs),h();let r={id:i.invocation_context_id,active:!0};try{let s=await Z.run(r,async()=>{try{return await _e(i.capability,i.trace_context,()=>e.handleCapability(i))}finally{r.active=!1}});o({type:"capability_response",id:n,response:s})}catch(s){o({type:"capability_response",id:n,response:{id:i.id,success:!1,payload:{error:`Capability handler error: ${s}`}}})}finally{v()}break}case"invoke_capability_result":{let{id:n,response:i}=t,r=g.get(n);if(r)g.delete(n),r.resolve(i);break}case"shutdown":{c.info("Received shutdown signal from host"),x(),await e.shutdown(),m(0);break}case"heap_snapshot_request":{await Me(t,o);break}default:c.warn(`Unknown IPC message type: ${t.type}`)}}async function Ve(e,t,o){p=o,await J(e,t,p)}export{Te as NodeApp,ke as _captureHeapSnapshotTo,Me as _handleHeapSnapshotRequest,ze as _resolveCtx,we as _sampleMemory,Be as _testExitWorker,Ve as _testHandleMessage,Qe as _testLeaseState,We as _testResetLeaseState,Ue as _testRunNodeAppPath,Ge as _testSetLeaseExitFn,c as host,$e as incrementCounter,he as initAppTelemetry,Ke as invokeCapability,je as openDatabase,Oe as publishEvent,Ze as runNodeApp,De as telemetryActive};
+var se=Object.defineProperty;var ae=(e)=>e;function pe(e,t){this[e]=ae.bind(null,t)}var ce=(e,t)=>{for(var r in t)se(e,r,{get:t[r],enumerable:!0,configurable:!0,set:pe.bind(t,r)})};import{Database as ve}from"burger:sqlite";var q={};ce(q,{incrementCounter:()=>T,initAppTelemetry:()=>M,injectTraceContext:()=>ue,telemetryActive:()=>P,traceIncomingCapability:()=>le});async function M(e){}function P(){return!1}function T(e,t=1,r){}function ue(e){return e}async function le(e,t,r){return r()}import{connect as de,dataDir as me,exit as O,logDir as fe,memoryUsage as ye}from"burger:host";var N=!0,U=256;function L(){return{socket:void 0,logDir:fe,dataDir:me}}var H=L();function B(){return H.socket}function K(e,t,r=O){r(e)}function g(e){O(e)}function G(){}var ge=/the app channel is (not open|closed)/;function Q(e){let t=de(),r=!0,n=!1;function i(o){if(n)return;try{t.send(o)}catch(s){if(s instanceof Error&&ge.test(s.message)){n=!0;return}throw s}}return t.onFrame((o)=>{if(!r)return;e.onFrame(o).catch((s)=>e.onFrameError(s))}),t.onClose((o)=>{if(n=!0,o)e.onError(o);else e.onClose()}),queueMicrotask(()=>e.onConnected("burger:host")),{send(o){i(o)},sendAndFlush(o){return i(o),Promise.resolve()},stopAccepting(){r=!1},end(){n=!0,t.close()}}}function V(){let e;return{run(t,r){let n=e;e=t;try{return r()}finally{e=n}},getStore(){return e}}}function Z(){let e=ye();return{heap_used_kb:Math.round(e.heap_used_kb),heap_total_kb:Math.round(e.heap_total_kb),external_kb:Math.round(e.external_kb),heap_capacity_kb:Math.round(e.heap_capacity_kb)}}function W(){throw Error("heap snapshots are not available in the Burger runtime")}async function Y(e,t=W,r=W){let n=t();return{size_bytes:await r(e,n)}}import*as p from"burger:fs";import{join as _e}from"burger:path";var he=60000;function J(e,t={}){if(!e)return{write:()=>{}};let r=_e(e,"app.log"),n=t.reportError??((u)=>console.error(u)),i=t.now??Date.now,o=typeof p.openSync==="function"&&typeof p.writeSync==="function"&&typeof p.closeSync==="function",s=null,a=!1,y=null,x=0;function z(){if(a)return;p.mkdirSync(e,{recursive:!0}),a=!0}function ie(u){let R=i();if(y!==null&&R-y<he){x+=1;return}let C=u instanceof Error?u.message:String(u),k=x>0?`; ${x} earlier failure(s) not reported`:"";n(`[node-app-sdk] app.log write failed (${r}): ${C}${k}`),y=R,x=0}return{write(u,R){let C=`${new Date().toISOString()} [${u.toUpperCase().padEnd(5)}] ${R}
+`;try{if(!o){z(),p.appendFileSync(r,C);return}if(s===null)z(),s=p.openSync(r,"a");p.writeSync(s,C)}catch(k){if(s!==null){try{p.closeSync(s)}catch{}s=null}ie(k)}}}}var{injectTraceContext:xe,traceIncomingCapability:Re}=q,Ce=M,We=P,Oe=T,Ie=U;function Ue(e,t={}){let r=t.cacheSizeKb??Ie;if(!Number.isInteger(r)||r<=0)throw RangeError("cacheSizeKb must be a positive integer");let n=new ve(e);try{return n.exec(`PRAGMA cache_size = -${r}`),n}catch(i){throw n.close(),i}}var Be=L,Ke=B,Ge=K,Ae=J(H.logDir),c=null,te=V(),_=new Map,l={trace:(e)=>b("trace",e),debug:(e)=>b("debug",e),info:(e)=>b("info",e),warn:(e)=>b("warn",e),error:(e)=>b("error",e),holdLease:()=>{let e=!1;return I(),()=>{if(e)return;e=!0,A()}}};function b(e,t){if(Ae.write(e,t),c)c({type:"log",level:e,message:t});else console[e==="trace"?"debug":e](t)}function Qe(e,t){if(!c)return Promise.reject(Error("Not connected to host"));let r=t??30000,n=e.timeout_ms===void 0?{...e,timeout_ms:r}:e,i={...n,trace_context:xe({...n.trace_context??{}})},o=te.getStore();if(o?.active&&o.id!==void 0)i.invocation_context_id=o.id;return new Promise((s,a)=>{_.set(e.id,{resolve:s,reject:a}),c({type:"invoke_capability",id:e.id,request:i}),setTimeout(()=>{if(_.has(e.id))_.delete(e.id),a(Error(`Capability invocation timed out after ${r}ms: ${e.capability}`))},r)})}function Ve(e,t){if(!c)throw Error("Not connected to host");c({type:"publish_event",event_name:e,data:t})}var d=0,h,m=null,v=!1,S,ne=()=>g(0),F=ne,D,re=(e)=>(c?.(e),Promise.resolve()),j=re;function X(e){if(h=e,e===void 0)E()}function E(){if(m)clearTimeout(m),m=null}function we(){if(v)return;if(h===void 0)return;if(d!==0)return;E();let e=Math.max(0,h*1000),t=setTimeout(()=>{m=null,Se()},e);t.unref?.(),m=t}function I(){d++,E()}function A(){if(d=Math.max(0,d-1),d===0)we()}async function Se(){if(v)return;if(v=!0,D?.(),S)await S.shutdown();await j({type:"lease_exit"}),F()}function Ze(){E(),d=0,h=void 0,v=!1,S=void 0,F=ne,D=void 0,j=re}function Ye(e){F=e}function Je(){return{inFlight:d,rememberedSecs:h,timerArmed:m!==null,draining:v}}var Ee=30000;function ke(){let e=process.env.NODE_APP_MEMORY_SAMPLE_INTERVAL_MS,t=e?Number.parseInt(e,10):NaN;return Number.isFinite(t)&&t>=1000?t:Ee}var f=null,Me=Z;function ee(e){e({type:"app_memory",...Me()})}function Pe(e){if(f)return;ee(e),f=setInterval(()=>ee(e),ke()),f.unref?.()}function w(){if(f)clearInterval(f),f=null}var Te=Y;async function qe(e,t,r=Te){try{let n=await r(e.path);t({type:"heap_snapshot_response",id:e.id,success:!0,size_bytes:n.size_bytes})}catch{t({type:"heap_snapshot_response",id:e.id,success:!1,error:"heap_snapshot_failed"})}}function Ne(e,t){let r=t.indexOf("?"),n=r>=0?t.slice(0,r):t,i=e.split("/"),o=n.split("/"),s=0,a=0;while(s<i.length){if(i[s]==="**")return!0;if(a>=o.length)return!1;if(i[s]!=="*"&&i[s]!==o[a])return!1;s++,a++}return a===o.length}class Le{_routes=[];route(e,t,r,n){this._routes.push({method:e,path:t,policy:r,handler:n})}async init(e){}async shutdown(){}async handleRequest(e){if(this._routes.length>0)return this._dispatchRoute(e);return{status:501,headers:{},body:{error:"Not implemented"}}}async _dispatchRoute(e){let t=e.method.toUpperCase(),r=e.path;for(let n of this._routes){if(!(n.method==="*"||n.method.toUpperCase()===t))continue;if(!Ne(n.path,r))continue;let o=n.policy.requiredPermissions??[],s=e.caller?.granted_permissions??[],a=o.filter((y)=>!s.includes(y));if(a.length>0)return l.warn(`SDK scope denied: [${a.join(", ")}] missing for ${t} ${r}`),{status:403,headers:{},body:{error:`Missing permissions: ${a.join(", ")}`}};return n.handler(e)}return this.notFound()}async handleEvent(e){}providedCapabilities(){return[]}async handleCapability(e){return{id:e.id,success:!1,payload:{error:"Capability handling not implemented"}}}json(e,t=200){return{status:t,headers:{"Content-Type":"application/json"},body:e}}error(e,t=500){return{status:t,headers:{"Content-Type":"application/json"},body:{error:e}}}notFound(){return this.error("Not found",404)}}function Xe(e){G(),Ce(e.metadata?.name??"node-app");let t=Q({onConnected:(n)=>{l.debug(`Connected to host via ${n}`)},onFrame:(n)=>oe(e,n,r),onFrameError:(n)=>{l.error(`Failed to parse IPC message: ${n}`)},onError:(n)=>{console.error(`[node-app-sdk] Socket error: ${n.message}`),g(1)},onClose:()=>{w(),g(0),l.debug("Socket closed, shutting down")}});function r(n){t.send(n)}c=r,D=()=>{t.stopAccepting()},j=(n)=>t.sendAndFlush(n),process.on("SIGTERM",async()=>{if(!N)return;w(),await e.shutdown(),t.end(),process.exit(0)}),process.on("SIGINT",async()=>{if(!N)return;w(),await e.shutdown(),t.end(),process.exit(0)})}async function oe(e,t,r){switch(S=e,t.type){case"init":{let n=t.config;await e.init(n),r({type:"ready",metadata:e.metadata}),Pe(r);break}case"request":{let{id:n,request:i}=t;I();try{let o=await e.handleRequest(i);r({type:"response",id:n,response:o})}catch(o){r({type:"response",id:n,response:{status:500,headers:{},body:{error:`Internal app error: ${o}`}}})}finally{A()}break}case"event":{let{event:n,lease_secs:i}=t;X(i),I();try{await e.handleEvent(n)}catch(o){l.error(`Event handler error: ${o}`)}finally{A()}break}case"capability_request":{let{id:n,request:i}=t;X(i.lease_secs),I();let o={id:i.invocation_context_id,active:!0};try{let s=await te.run(o,async()=>{try{return await Re(i.capability,i.trace_context,()=>e.handleCapability(i))}finally{o.active=!1}});r({type:"capability_response",id:n,response:s})}catch(s){r({type:"capability_response",id:n,response:{id:i.id,success:!1,payload:{error:`Capability handler error: ${s}`}}})}finally{A()}break}case"invoke_capability_result":{let{id:n,response:i}=t,o=_.get(n);if(o)_.delete(n),o.resolve(i);break}case"shutdown":{l.info("Received shutdown signal from host"),w(),await e.shutdown(),g(0);break}case"heap_snapshot_request":{await qe(t,r);break}default:l.warn(`Unknown IPC message type: ${t.type}`)}}async function et(e,t,r){c=r,await oe(e,t,c)}export{Le as NodeApp,Te as _captureHeapSnapshotTo,qe as _handleHeapSnapshotRequest,Be as _resolveCtx,Me as _sampleMemory,Ge as _testExitWorker,et as _testHandleMessage,Je as _testLeaseState,Ze as _testResetLeaseState,Ke as _testRunNodeAppPath,Ye as _testSetLeaseExitFn,l as host,Oe as incrementCounter,Ce as initAppTelemetry,Qe as invokeCapability,Ue as openDatabase,Ve as publishEvent,Xe as runNodeApp,We as telemetryActive};