@noeva/etl-core 1.1.1 → 1.2.0
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.
- package/CHANGELOG.md +6 -0
- package/dist/chunk-IDQXX435.js +1 -0
- package/dist/{chunk-KEFIGSRS.js → chunk-SRO66WUJ.js} +1 -1
- package/dist/chunk-XRRC27NI.js +1 -0
- package/dist/cli.js +120 -120
- package/dist/connectors/process.js +1 -1
- package/dist/etl.config.js +6 -6
- package/dist/guida/404.html +2 -2
- package/dist/guida/GUIDA_SVILUPPO.html +4 -4
- package/dist/guida/TECHNICAL_OVERVIEW.html +4 -4
- package/dist/guida/assets/{app.uK-5scpr.js → app.Dsl1ZLFh.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.DZbSWLHu.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.CB5vaMvW.js → VPLocalSearchBox.CMLsenZG.js} +1 -1
- package/dist/guida/assets/chunks/{theme.z6u0J2Ii.js → theme.DspmxPAW.js} +7 -7
- package/dist/guida/assets/pipelines_analytics-snapshot.md.B8KfsjUs.js +1 -0
- package/dist/guida/assets/pipelines_analytics-snapshot.md.B8KfsjUs.lean.js +1 -0
- package/dist/guida/connectors/README.html +4 -4
- package/dist/guida/connectors/excel.html +4 -4
- package/dist/guida/connectors/file.html +4 -4
- package/dist/guida/connectors/http.html +4 -4
- package/dist/guida/connectors/imap.html +4 -4
- package/dist/guida/connectors/jira.html +4 -4
- package/dist/guida/connectors/mysql.html +4 -4
- package/dist/guida/connectors/noeva.html +4 -4
- package/dist/guida/connectors/oauth.html +4 -4
- package/dist/guida/connectors/odoo.html +4 -4
- package/dist/guida/connectors/postgres.html +4 -4
- package/dist/guida/connectors/process.html +4 -4
- package/dist/guida/connectors/sendgrid.html +4 -4
- package/dist/guida/connectors/smtp.html +4 -4
- package/dist/guida/connectors/sqlserver.html +4 -4
- package/dist/guida/connectors/zoho.html +4 -4
- package/dist/guida/conventions/node-columns.html +4 -4
- package/dist/guida/conventions/node-descriptor.html +4 -4
- package/dist/guida/conventions/run-report.html +4 -4
- package/dist/guida/conventions/run-trace.html +4 -4
- package/dist/guida/conventions/variabili-del-core.html +4 -4
- package/dist/guida/conventions/versioni-di-pipeline.html +4 -4
- package/dist/guida/guide/claude-code/index.html +4 -4
- package/dist/guida/guide/claude-code/prompt.html +4 -4
- package/dist/guida/guide/claude-code/strumenti.html +4 -4
- package/dist/guida/guide/grafo.html +4 -4
- package/dist/guida/guide/usare/app-desktop.html +4 -4
- package/dist/guida/guide/usare/esito-di-una-run.html +4 -4
- package/dist/guida/guide/usare/index.html +4 -4
- package/dist/guida/hashmap.json +1 -1
- package/dist/guida/index.html +3 -3
- package/dist/guida/nodes/README.html +4 -4
- package/dist/guida/nodes/action.html +4 -4
- package/dist/guida/nodes/ai.html +4 -4
- package/dist/guida/nodes/join.html +4 -4
- package/dist/guida/nodes/lookup.html +4 -4
- package/dist/guida/nodes/pipeline.html +4 -4
- package/dist/guida/nodes/route.html +4 -4
- package/dist/guida/nodes/sink.html +4 -4
- package/dist/guida/nodes/source.html +4 -4
- package/dist/guida/nodes/task.html +4 -4
- package/dist/guida/nodes/transform.html +4 -4
- package/dist/guida/nodes/try-catch.html +4 -4
- package/dist/guida/nodes/union.html +4 -4
- package/dist/guida/pagine.json +2 -0
- package/dist/guida/pipelines/README.html +5 -5
- package/dist/guida/pipelines/analytics-snapshot.html +40 -0
- package/dist/guida/pipelines/crm-leads-sync.html +4 -4
- package/dist/guida/pipelines/cross-workspace-csv-merge.html +4 -4
- package/dist/guida/pipelines/movimenti-per-conto.html +4 -4
- package/dist/guida/pipelines/orders-enriched-daily.html +4 -4
- package/dist/guida/pipelines/test-posta.html +5 -5
- package/dist/guida/runbooks/aggiornamento-pm2.html +4 -4
- package/dist/guida/runbooks/deploy-ecr.html +4 -4
- package/dist/guida/runbooks/deployment.html +4 -4
- package/dist/guida/runbooks/etl-worker.html +4 -4
- package/dist/guida/runbooks/excel-operazioni-distruttive.html +4 -4
- package/dist/guida/runbooks/graph-server.html +4 -4
- package/dist/guida/runbooks/mask-key.html +4 -4
- package/dist/guida/runbooks/oauth-google-posta.html +4 -4
- package/dist/guida/runbooks/rollback-di-pipeline.html +4 -4
- package/dist/guida/runbooks/scd2-rehash.html +4 -4
- package/dist/guida/runbooks/sql-task-truncate-swap.html +4 -4
- package/dist/guida/runbooks/stato-incrementale.html +4 -4
- package/dist/guida/sub-pipelines/README.html +4 -4
- package/dist/guida/sub-pipelines/riepilogo-ordini.html +4 -4
- package/dist/pipelines.d.ts +24 -1
- package/dist/pipelines.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-5XVANFXO.js +0 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.AxYI9rrX.js +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# @noeva/etl-core
|
|
2
2
|
|
|
3
|
+
## 1.2.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 899c792: Nuova pipeline standard `analytics-snapshot`: lo snapshot delle dashboard NOEVA Analytics, lanciato dal worker con `noeva-snapshot giro`. Non si dichiara in `etl.config.ts`: la accende il `.env` con `CORE_ANALYTICS_SNAPSHOT=<nome della pipeline>` (il nome è anche la chiave `--pipeline` del `worker.json` e la schedulazione del workspace). Senza la variabile la pipeline non è nel catalogo. `CORE_ANALYTICS_SNAPSHOT_ENV` elenca i nomi delle variabili d'ambiente in più che il giro riceve. `loadCatalog` accoda al catalogo le pipeline standard accese dall'ambiente. Un repo cliente che ne ha una copia propria la toglie dal catalogo e imposta la variabile. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
8
|
+
|
|
3
9
|
## 1.1.1
|
|
4
10
|
|
|
5
11
|
### Patch Changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import {e}from'./chunk-XRRC27NI.js';import {L as L$1}from'./chunk-672L5BGQ.js';import {a,L as L$2,g,Fb,M}from'./chunk-CEAMQIRO.js';var A=Symbol.for("@noeva/etl-core/ready-pipeline");function m(e){return Object.freeze(Object.defineProperty({...e},A,{value:true}))}a(m,"readyPipeline");function L(e){return Object.getOwnPropertyDescriptor(e,A)?.value===true}a(L,"isReadyPipeline");var v=[{version:1,date:"2026-11-16",tickets:["ETL-352"],added:["Lo snapshot delle dashboard NOEVA Analytics come pipeline standard del core: un giro di `noeva-snapshot giro` lanciato dal worker, che esporta dal DataSmart attraverso il modello semantico, controlla le cifre e pubblica. Si attiva con `CORE_ANALYTICS_SNAPSHOT=<nome>` nel `.env` del cliente"],changed:[],removed:[]}];var E="CORE_ANALYTICS_SNAPSHOT",P="CORE_ANALYTICS_SNAPSHOT_ENV",l="analytics-snapshot",_=/^[a-z0-9]+(?:-[a-z0-9]+)*$/,h=/^[A-Za-z_][A-Za-z0-9_]*$/;function z(e=process.env){let o=e[E]?.trim();if(!(o===void 0||o==="")){if(!_.test(o))throw new g(`${E} non valida: il nome della pipeline dev'essere in minuscole, cifre e trattini, come "${l}"`);return o}}a(z,"nomeAttivo");function S(e=process.env){let o=(e[P]??"").split(",").map(r=>r.trim()).filter(r=>r!==""),t=o.find(r=>!h.test(r));if(t!==void 0)throw new g(`${P} non valida: "${t}" non \xE8 il nome di una variabile d'ambiente`);return [...new Set(o)]}a(S,"ambienteExtra");var p="avvio",s="giro-snapshot",y="esito",R="C:\\NOEVA\\snapshot",I=`${R}\\noeva-snapshot\\noeva-snapshot.exe`,T=["NOEVA_API_KEY","NOEVA_MSSQL_DRIVER","SYSTEMROOT","WINDIR","PATH","TEMP","TMP","USERPROFILE","LOCALAPPDATA","APPDATA","PROGRAMDATA","COMPUTERNAME","HTTPS_PROXY","HTTP_PROXY","NO_PROXY"],x=45*6e4,N=L$1.object({progetto:L$1.string(),versione:L$1.string(),data_del_dato:L$1.string().nullable().optional(),file:L$1.number().int(),byte:L$1.number().nullable().optional(),secondi:L$1.number(),controlli:L$1.record(L$1.string(),L$1.number()).optional(),avvisi:L$1.array(L$1.string()).optional(),estrazioni:L$1.number().int().optional(),cartella:L$1.string().optional()});function b(e,o=[]){return {eseguibile:I,argomenti:["giro","--config",`${R}\\worker.json`,"--pipeline",e],ambiente:[...new Set([...T,...o])],timeoutMs:x}}a(b,"comandoGiro");function f(e$1){return e({name:s,eseguibile:e$1.eseguibile,argomenti:e$1.argomenti,timeoutMs:e$1.timeoutMs,ambiente:e$1.ambiente,ingresso:a(()=>({file:[]}),"ingresso"),riepilogo:N,merge:a((o,t)=>t.riepilogo,"merge")})}a(f,"giroSnapshot");var G=a(()=>L$2(p,[{progetto:"analytics"}]),"avvioDelGiro");function O(e,o){return Fb(e).source(p,o.avvio??G(),{purpose:"Un record per run: fa partire un giro dello snapshot."}).action(p,s,o.giro,{purpose:"Lancia noeva-snapshot giro sul server: esporta dal DataSmart attraverso il modello semantico, controlla le cifre e pubblica lo snapshot delle dashboard.",recordReport:{key:"giri",row:a(t=>({versione:t.versione,data_del_dato:t.data_del_dato??null,file:t.file,secondi:t.secondi,avvisi:(t.avvisi??[]).join(", ")}),"row")}}).sink(s,o.esito,{purpose:"Tiene l'esito del giro per il report della run."}).build()}a(O,"buildAnalyticsSnapshotPipeline");function C(e=l){let o=a(()=>O(e,{giro:f(b(e,S(process.env))),esito:M(y)}),"pipeline");return m({name:e,description:"Lo snapshot delle dashboard NOEVA Analytics, generato e pubblicato da noeva-snapshot sul server del cliente",changelog:v,getSpec(){return o().getSpec()},async run(t){return o().run(t)}})}a(C,"analyticsSnapshot");var K=C();export{m as a,L as b,z as c,C as d,K as e};
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import {a as a$1}from'./chunk-
|
|
1
|
+
import {a as a$1}from'./chunk-IDQXX435.js';import {a as a$2,d as d$1,b as b$3}from'./chunk-FBSNZG34.js';import {L,H as H$1,K as K$1,b as b$2,J as J$1,I}from'./chunk-672L5BGQ.js';import {B as B$1}from'./chunk-DHQ3YOPX.js';import {b,f as f$2,h,d as d$3}from'./chunk-IODXIHU2.js';import {b as b$1,f as f$1,j as j$1,d as d$2}from'./chunk-VVXT66DC.js';import {T,l as l$1,Q as Q$1,R,S as S$1}from'./chunk-47NVGHUY.js';import {a,g as g$1,Fb,e}from'./chunk-CEAMQIRO.js';import {join}from'path';var r="TEST_POSTA_",Z="5",g=[{suffisso:"IMAP_INSTANCE",default:l$1},{suffisso:"SMTP_INSTANCE",default:l$1},{suffisso:"CARTELLA",default:"INBOX"},{suffisso:"CARTELLA_LOCALE",obbligatoria:true},{suffisso:"DESTINATARIO",obbligatoria:true},{suffisso:"MAX_MESSAGES",default:Z}];function d(e){return Q$1(g,r,e)}a(d,"risolvi");function K(e,a){let t=Number(a);if(!Number.isInteger(t)||t<=0)throw new g$1(`${r}${e} non valido (atteso un intero positivo)`);return t}a(K,"intero");function c(e=process.env){let a$1=d(e);R(a$1);let t=a(n=>S$1(a$1,n),"valore");return {imapInstance:t("IMAP_INSTANCE"),smtpInstance:t("SMTP_INSTANCE"),cartella:t("CARTELLA"),cartellaLocale:t("CARTELLA_LOCALE"),destinatario:t("DESTINATARIO"),maxMessages:K("MAX_MESSAGES",t("MAX_MESSAGES")),variabili:a$1.variabili}}a(c,"parseConfig");function l(e){let a=d(e);return {imap:S$1(a,"IMAP_INSTANCE"),smtp:S$1(a,"SMTP_INSTANCE")}}a(l,"istanzeTestPosta");var Q={[`${r}CARTELLA_LOCALE`]:"/percorso/di/esempio",[`${r}DESTINATARIO`]:"prova@esempio"};function j(e){return {risolta:a(()=>c(e),"risolta"),esempio:a(a=>{let t=l(e);return {...c(Q),ricaduta:a,imapInstance:t.imap,smtpInstance:t.smtp,variabili:d(e).variabili}},"esempio")}}a(j,"configTestPostaPerIlPiano");function X(e){return `${(e/1024).toFixed(1)} kB`}a(X,"kb");function W(e){let a=e.oggetto===""?"(senza oggetto)":e.oggetto,t=e.data===""?"(senza data)":e.data,n=e.allegati===0?"nessun allegato":`${e.allegati} allegati`;return [`uid ${e.uid} \u2014 ${a}`,` da: ${e.mittente}`,` data: ${t}`,` allegati: ${n}`,` file: ${e.percorso} (${X(e.byte)})`,...e.errore===""?[]:[` ATTENZIONE: non interpretabile \u2014 ${e.errore}`]].join(`
|
|
2
2
|
`)}a(W,"riga");function Y(e){let a=e.salvati.slice(0,50),t=e.salvati.length-a.length;return [`Cartella IMAP letta: ${e.cartellaImap}`,`Cartella locale: ${e.cartellaLocale}`,`Messaggi salvati: ${e.messaggi}`,`Totale scritto: ${X(e.byteTotali)}`,"",...a.map(W),...t>0?["",`\u2026 e altri ${t} messaggi.`]:[],"","Se stai leggendo questa mail, IMAP in lettura e SMTP in invio funzionano entrambi."].join(`
|
|
3
3
|
`)}a(Y,"corpo");function w(e,a){return {a:[e],oggetto:`[Noeva ETL] Prova posta: ${a.messaggi} messaggi da ${a.cartellaImap}`,testo:Y(a)}}a(w,"notificaRiepilogo");var f=L.object({uid:L.number().int(),uidValidity:L.string(),mittente:L.string(),oggetto:L.string(),data:L.string(),allegati:L.number().int().nonnegative(),errore:L.string(),byte:L.number().int().nonnegative(),percorso:L.string()}),H=L.object({cartellaLocale:L.string(),cartellaImap:L.string(),messaggi:L.number().int().nonnegative(),byteTotali:L.number().int().nonnegative(),salvati:L.array(f)});var p="test-posta",ee="run";function ae(e){return b$2("riepilogo",{key:a(()=>ee,"key"),init:a(a=>[a],"init"),reduce:a((a,t)=>[...a,t],"reduce"),finalize:a(a=>({cartellaLocale:e.cartellaLocale,cartellaImap:e.cartella,messaggi:a.length,byteTotali:a.reduce((t,n)=>t+n.byte,0),salvati:[...a]}),"finalize"),outputSchema:H})}a(ae,"riepilogo");function S(e,a){return Fb(p).source("posta",a.posta,{purpose:"Legge alcune mail dalla cartella di posta configurata, senza segnarle come lette n\xE9 spostarle. Se questo passo riesce, l'accesso alla casella funziona."}).action("posta","salva-eml",a.salva,{outputSchema:f,purpose:"Salva una copia di ogni mail letta nella cartella locale dell'installazione, per controllare che cosa \xE8 arrivato. Rilanciando la prova, le stesse mail riscrivono gli stessi file."}).transform("salva-eml","riepilogo",ae(e),{purpose:"Riunisce le mail salvate in un unico riepilogo, con quante sono e quanto pesano. Serve perch\xE9 la prova mandi una mail sola invece di una per messaggio."}).sink("riepilogo",a.notifica,{purpose:"Manda l'unica mail di riepilogo della prova. Se arriva, l'invio della posta da questa installazione funziona."}).build()}a(S,"buildTestPostaPipeline");var ie=60,oe=8,ne="senza-oggetto",re="(mittente assente)",le=/[^A-Za-z0-9_]+/g,J=/^-+|-+$/g;function se(e){let a=(e??"").replace(le,"-").replace(J,"").slice(0,ie).replace(J,"");return a===""?ne:a}a(se,"slug");function ce(e,a){return `${String(e).padStart(oe,"0")}-${se(a)}.eml`}a(ce,"nomeFile");function pe(e){return e===null?re:e.name===null||e.name===""?e.address:`${e.name} <${e.address}>`}a(pe,"descriviMittente");function q(e$1){let a=e$1.scrivi??B$1;return {name:"salva-eml",descriptor:{kind:"local-folder",details:[{label:"cartella",value:e$1.cartella}]},async run(t,n){if(t.eml===null)throw new e(`Messaggio uid ${t.uid} senza sorgente grezza: IMAP non ha restituito l'EML`,{stage:"salva-eml",details:{uid:t.uid}});let T=join(e$1.cartella,ce(t.uid,t.subject));return await a(T,t.eml),n.logger.info("test-posta.salvato",{stage:"salva-eml",uid:t.uid,byte:t.eml.byteLength}),{uid:t.uid,uidValidity:t.uidValidity,mittente:pe(t.from),oggetto:t.subject??"",data:t.date??"",allegati:t.attachments.length,errore:t.error??"",byte:t.eml.byteLength,percorso:T}}}}a(q,"salvaEmlAction");var B=[{version:1,date:"2026-10-05",tickets:["ETL-120"],added:["Versione iniziale sotto versionamento (ADR-0086)"],changed:[],removed:[]},{version:2,date:"2026-10-05",tickets:["ETL-150","ETL-152","ETL-154"],added:["Variabile e origine (env, default, mancante, non impostata) su ogni riga dei connettori IMAP, SMTP e della cartella locale (ADR-0089)","Riga `credenziale` con la variante in uso e il suo stato, mai il valore","Configurazione della pipeline nel piano: tutte le variabili `TEST_POSTA_*` con valore e origine, compreso il destinatario che nessun nodo mostra"],changed:["Il piano ricade sulla configurazione d'esempio per istanza di connettore, non per l'intero piano: una cartella locale mancante non nasconde IMAP e SMTP","Host e porta sono righe separate","Con un utente IMAP mancante, la riga `credenziale` lo dice; con OAuth2, dice se l'identit\xE0 che rinnova il token \xE8 completa"],removed:[]},{version:3,date:"2026-10-09",tickets:["ETL-193","ETL-194","ETL-195","ETL-202"],added:[],changed:["Nessun cambio di comportamento: il piano \xE8 identico alla v2. Gli import seguono l'infrastruttura (changelog, configurazione delle istanze, report di volume) uscita da `src/pipelines/` (ADR-0093 \xA71), e la pipeline si dichiara nel catalogo di `etl.config.ts` invece che in un registro (ADR-0093 \xA72)","Porta il marchio di pipeline pronta del core, che il caricamento del catalogo riconosce (ADR-0094 \xA72): il piano non cambia","Dichiara le variabili d'ambiente che legge (`environment`) per `etl env check`, dagli stessi manifest della run: casella IMAP, server SMTP, identit\xE0 OAuth2 se la casella la usa, e `TEST_POSTA_*` (ADR-0094 \xA71). Il piano non cambia"],removed:[]}];var me="Prova dei connettori IMAP e SMTP: legge una cartella, salva gli EML in una cartella locale e manda una sola mail di riepilogo. Non tocca la casella.";function U(e,a$1={}){let{config:t}=e;return {posta:J$1(h(e.imap,{name:"casella-prova",instanceId:t.imapInstance,cartella:t.cartella,maxMessages:t.maxMessages,...a$1.imap!==void 0?{client:{accessToken:a$1.imap}}:{}}),t,{cartella:"CARTELLA",maxMessages:"MAX_MESSAGES"}),salva:J$1(q({cartella:t.cartellaLocale}),t,{cartella:"CARTELLA_LOCALE"}),notifica:j$1(e.smtp,{name:"notifica",instanceId:t.smtpInstance,mail:a(n=>w(t.destinatario,n),"mail"),...a$1.smtp!==void 0?{trasporto:{accessToken:a$1.smtp}}:{}})}}a(U,"dipendenze");function ue(e){let a$1=l(e);return I({config:a(()=>c(e),"config"),imap:a(()=>d$3(e).get(a$1.imap),"imap"),smtp:a(()=>d$2(e).get(a$1.smtp),"smtp"),oauth:a(()=>b$3(e),"oauth")})}a(ue,"configurazioniDellaRun");var ge=a$1({name:p,description:me,changelog:B,async run(e){let a=ue(process.env),t=d$1(a.oauth),n={imap:t(a.imap.auth,a.imap.oauthInstance),smtp:a.smtp.auth===null?void 0:t(a.smtp.auth.credenziali,a.smtp.oauthInstance)};return S(a.config,U(a,n)).run(e)},getSpec(){let e=process.env,a=l(e),t=H$1({config:j(e),imap:f$2(a.imap,e),smtp:f$1(a.smtp,e)});return K$1(S(t.config,U(t)).getSpec(),t.config)},environment(e){let a=l(e),t=[b(a.imap),b$1(a.smtp)];return T({pipeline:p,configurazione:{prefisso:r,manifest:g},istanze:[...t,...a$2(t,e)]},e)}});export{ge as a};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import {a,k,g as g$1}from'./chunk-CEAMQIRO.js';import {mkdtemp,mkdir,writeFile,readdir,readFile,rm}from'fs/promises';import {tmpdir}from'os';import {join,dirname}from'path';import {spawn}from'child_process';var g="uscita";async function E(e){return mkdtemp(join(e,"noeva-processo-"))}a(E,"creaCartellaRecord");async function R(e,r,t){await mkdir(join(e,g));for(let o of r){let i=join(e,...$(o.nome,t));await mkdir(dirname(i),{recursive:true}),await writeFile(i,o.bytes);}}a(R,"preparaCartella");async function v(e){return w(join(e,g),[])}a(v,"raccogliUscita");async function w(e,r){let o=[...await readdir(e,{withFileTypes:true})].sort((s,a)=>s.name.localeCompare(a.name)),i=[];for(let s of o){let a=join(e,s.name),c=[...r,s.name];s.isDirectory()?i.push(...await w(a,c)):s.isFile()&&i.push({nome:c.join("/"),bytes:new Uint8Array(await readFile(a))});}return i}a(w,"leggiAlbero");function $(e,r){let t=e.split("/");if(!(!e.includes("\0")&&!e.includes("\\")&&t.every(i=>i!==""&&i!=="."&&i!=="..")))throw new k(`nome di file d'ingresso non ammesso: ${JSON.stringify(e)}`,{stage:r});return t}a($,"segmenti");function P(e){let r=e.ambiente??[];return {kind:"processo-esterno",details:[{label:"eseguibile",value:e.eseguibile},{label:"argomenti",value:JSON.stringify(e.argomenti??[])},...e.versione!==void 0?[{label:"versione",value:e.versione}]:[],{label:"timeout",value:`${e.timeoutMs} ms`},{label:"ambiente",value:r.length>0?r.join(", "):"nessuna variabile"}]}}a(P,"descrittoreProcesso");var I=2e3,f=1e6,A=process.platform!=="win32";function O(e){return new Promise((r,t)=>{let o=spawn(e.eseguibile,[...e.argomenti],{cwd:e.cwd,env:{...e.env},shell:false,stdio:["ignore","pipe","pipe"],detached:A,windowsHide:true}),i=N(o),s=F(o,e),a$1=false,c=a(()=>a$1?false:(a$1=true,s.annulla(),true),"chiudi");o.once("error",l=>{c()&&t(l);}),o.once("close",(l,h)=>{if(!c())return;let p=s.interruzione();r({exitCode:l,segnale:h,...i.lette(),...p!==void 0?{interruzione:p}:{}});});})}a(O,"esegui");function N(e){let r="",t=false,o="";return e.stdout?.setEncoding("utf8"),e.stdout?.on("data",i=>{t||(r+=i,r.length>f&&(r="",t=true));}),e.stderr?.setEncoding("utf8"),e.stderr?.on("data",i=>{o=(o+i).slice(-I);}),{lette:a(()=>({stdout:r,stdoutTroncato:t,stderr:o}),"lette")}}a(N,"raccogliUscite");function F(e,r){let t,o,i=a(c=>{t===void 0&&(t=c,b(e,"SIGTERM"),o=setTimeout(()=>b(e,"SIGKILL"),r.terminazioneMs));},"termina"),s=setTimeout(()=>i("timeout"),r.timeoutMs),a$1=a(()=>i("annullata"),"suAnnullamento");return r.signal.addEventListener("abort",a$1,{once:true}),r.signal.aborted&&i("annullata"),{interruzione:a(()=>t,"interruzione"),annulla:a(()=>{clearTimeout(s),clearTimeout(o),r.signal.removeEventListener("abort",a$1);},"annulla")}}a(F,"arrestoProgrammato");function b(e,r){if(!A||e.pid===void 0){e.kill(r);return}try{process.kill(-e.pid,r);}catch(t){t.code!=="ESRCH"&&e.kill(r);}}a(b,"segnala");var T=5e3,L=/^[A-Za-z_][A-Za-z0-9_]*$/;function j(e){let r=e.name??"processo-esterno";return Z(e,r),{name:r,descriptor:P(e),run:a((t,o)=>J(e,r,t,o),"run")}}a(j,"processoEsternoAction");async function J(e,r,t,o){if(o.signal.aborted)throw new k(`Run annullata: il processo "${r}" non \xE8 partito`,{stage:r});let i=e.ingresso(t),s=await E(e.cartellaBase??tmpdir());try{await R(s,i.file,r);let a=await B(r,G(e,i,s,o.signal)),c=K(r,a,e),l=await v(s);return e.merge(t,{riepilogo:c,file:l})}finally{await rm(s,{recursive:true,force:true}).catch(a=>{o.logger.warn("processo-esterno.cartella-non-cancellata",{processo:r,cartella:s,errore:C(a)});});}}a(J,"lancia");function Z(e,r){let t=a(i=>Number.isSafeInteger(i)&&i>0,"intero");if(e.eseguibile.trim()==="")throw new g$1(`processo "${r}": eseguibile vuoto`);if(!t(e.timeoutMs))throw new g$1(`processo "${r}": timeoutMs dev'essere un intero positivo, non ${e.timeoutMs}`);if(e.terminazioneMs!==void 0&&!t(e.terminazioneMs))throw new g$1(`processo "${r}": terminazioneMs dev'essere un intero positivo, non ${e.terminazioneMs}`);let o=(e.ambiente??[]).filter(i=>!L.test(i));if(o.length>0)throw new g$1(`processo "${r}": nomi di variabile non validi: ${o.join(", ")}`)}a(Z,"verificaConfigurazione");function G(e,r,t,o){return {eseguibile:e.eseguibile,argomenti:[...e.argomenti??[],...r.argomenti??[]],cwd:t,env:X(e.ambiente??[]),timeoutMs:e.timeoutMs,terminazioneMs:e.terminazioneMs??T,signal:o}}a(G,"parametri");function X(e){return Object.fromEntries(e.flatMap(r=>{let t=process.env[r];return t===void 0?[]:[[r,t]]}))}a(X,"ambienteDa");async function B(e,r){try{return await O(r)}catch(t){throw new k(`Impossibile avviare il processo "${e}": ${C(t)}`,{stage:e,details:{eseguibile:r.eseguibile}},{cause:t})}}a(B,"avvia");function H(e,r){if(e.interruzione==="timeout")return `ha superato il timeout di ${r} ms ed \xE8 stato terminato`;if(e.interruzione==="annullata")return "\xE8 stato terminato: run annullata";if(e.exitCode===null)return `\xE8 stato terminato dal segnale ${e.segnale??"?"}`;if(e.exitCode!==0)return `\xE8 terminato con exit code ${e.exitCode}`;if(e.stdoutTroncato)return `ha scritto su stdout pi\xF9 di ${f} caratteri`}a(H,"motivoDelFallimento");function K(e,r,t){let o=a((c,l={})=>new k(`Il processo "${e}" ${c}`,{stage:e,details:{exitCode:r.exitCode,segnale:r.segnale,stderr:r.stderr,...l}}),"fallisci"),i=H(r,t.timeoutMs);if(i!==void 0)throw o(i);let s;try{s=JSON.parse(r.stdout);}catch{throw o("non ha scritto su stdout un documento JSON")}let a$1=t.riepilogo.safeParse(s);if(!a$1.success)throw o("ha scritto un riepilogo non conforme allo schema",{campi:a$1.error.issues.map(c=>c.path.join(".")||"(radice)")});return a$1.data}a(K,"leggiRiepilogo");function C(e){return e instanceof Error?e.message:String(e)}a(C,"messaggio");export{g as a,I as b,f as c,T as d,j as e};
|