@noeva/etl-core 1.0.0 → 1.1.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 +137 -0
- package/README.md +6 -11
- package/deploy/Dockerfile +2 -1
- package/dist/{ai-BoTwcmUg.d.ts → ai-DyDIf-hQ.d.ts} +1 -1
- package/dist/{ambiente-della-pipeline-BoymQ6uN.d.ts → ambiente-della-pipeline-BhWsyLUR.d.ts} +2 -2
- package/dist/chunk-47NVGHUY.js +2 -0
- package/dist/chunk-5OE6F2MK.js +2 -0
- package/dist/{chunk-NZR6TZ42.js → chunk-5XVANFXO.js} +1 -1
- package/dist/chunk-672L5BGQ.js +1 -0
- package/dist/{chunk-4NPSBPBY.js → chunk-6QVYBDIS.js} +1 -1
- package/dist/{chunk-PE2QKU34.js → chunk-CEAMQIRO.js} +1 -1
- package/dist/chunk-DHQ3YOPX.js +5 -0
- package/dist/chunk-FBSNZG34.js +1 -0
- package/dist/{chunk-J3PBMWSP.js → chunk-GZWYRO3V.js} +1 -1
- package/dist/chunk-IODXIHU2.js +1 -0
- package/dist/{chunk-P6B2KLNJ.js → chunk-KEFIGSRS.js} +2 -2
- package/dist/chunk-KGWA46Y6.js +2 -0
- package/dist/chunk-L25W2QNS.js +1 -0
- package/dist/{chunk-JLPK6MMQ.js → chunk-OK3XRTGA.js} +1 -1
- package/dist/chunk-UHGHK6NP.js +1 -0
- package/dist/chunk-VL7DZWWO.js +2 -0
- package/dist/chunk-VVXT66DC.js +1 -0
- package/dist/chunk-ZKDCUSM2.js +6 -0
- package/dist/cli.js +2 -2
- package/dist/{client-DYA3wIyb.d.ts → client-BC_mLuT2.d.ts} +2 -2
- package/dist/config-BSdGSRPG.d.ts +37 -0
- package/dist/{config-BSUwK4p_.d.ts → config-DMafsY4H.d.ts} +3 -3
- package/dist/connector-kit.d.ts +14 -9
- package/dist/connector-kit.js +1 -1
- package/dist/connectors/excel.d.ts +391 -0
- package/dist/connectors/excel.js +10 -0
- package/dist/connectors/file.d.ts +12 -5
- package/dist/connectors/file.js +1 -1
- package/dist/connectors/http.d.ts +7 -7
- package/dist/connectors/http.js +1 -1
- package/dist/connectors/imap.d.ts +6 -6
- package/dist/connectors/imap.js +1 -1
- package/dist/connectors/jira.d.ts +6 -6
- package/dist/connectors/jira.js +2 -2
- package/dist/connectors/mail.d.ts +7 -7
- package/dist/connectors/mail.js +1 -1
- package/dist/connectors/mysql.d.ts +238 -0
- package/dist/connectors/mysql.js +2 -0
- package/dist/connectors/noeva.d.ts +6 -6
- package/dist/connectors/noeva.js +1 -1
- package/dist/connectors/oauth.d.ts +5 -5
- package/dist/connectors/oauth.js +1 -1
- package/dist/connectors/odoo.d.ts +309 -0
- package/dist/connectors/odoo.js +3 -0
- package/dist/connectors/postgres.d.ts +7 -6
- package/dist/connectors/postgres.js +1 -1
- package/dist/connectors/process.d.ts +1 -1
- package/dist/connectors/process.js +1 -1
- package/dist/connectors/sendgrid.d.ts +7 -7
- package/dist/connectors/sendgrid.js +1 -1
- package/dist/connectors/smtp.d.ts +8 -8
- package/dist/connectors/smtp.js +1 -1
- package/dist/connectors/sqlserver.d.ts +7 -6
- package/dist/connectors/sqlserver.js +1 -1
- package/dist/connectors/zoho.d.ts +6 -6
- package/dist/connectors/zoho.js +1 -1
- package/dist/contract.d.ts +2 -2
- package/dist/{credenziali-posta-f7HB2cYW.d.ts → credenziali-posta-C0az04uV.d.ts} +2 -2
- package/dist/{errors-bgSO6lGO.d.ts → errors-CRq1uNYZ.d.ts} +8 -1
- package/dist/etl.config.js +3 -3
- package/dist/guida/404.html +2 -2
- package/dist/guida/GUIDA_SVILUPPO.html +7 -7
- package/dist/guida/TECHNICAL_OVERVIEW.html +7 -7
- package/dist/guida/assets/{GUIDA_SVILUPPO.md.CrN52ZDN.js → GUIDA_SVILUPPO.md.Bvr7RKHN.js} +2 -2
- package/dist/guida/assets/TECHNICAL_OVERVIEW.md.C6HYc5_h.js +10 -0
- package/dist/guida/assets/{app.DlsuGVZn.js → app.zL1wgTBx.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.B5GjWddx.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.v4vBLemj.js → VPLocalSearchBox.BSMd0tSF.js} +1 -1
- package/dist/guida/assets/chunks/{theme.D9XEK7o0.js → theme.CRpFq7vp.js} +2 -2
- package/dist/guida/assets/connectors_README.md.B5QWzWUK.js +1 -0
- package/dist/guida/assets/connectors_README.md.B5QWzWUK.lean.js +1 -0
- package/dist/guida/assets/connectors_excel.md.CqGtwEB4.js +92 -0
- package/dist/guida/assets/connectors_excel.md.CqGtwEB4.lean.js +1 -0
- package/dist/guida/assets/{connectors_file.md.B1NJe0VJ.js → connectors_file.md.Dbofo9W5.js} +3 -3
- package/dist/guida/assets/{connectors_file.md.B1NJe0VJ.lean.js → connectors_file.md.Dbofo9W5.lean.js} +1 -1
- package/dist/guida/assets/connectors_mysql.md.fVCxQWUW.js +34 -0
- package/dist/guida/assets/connectors_mysql.md.fVCxQWUW.lean.js +1 -0
- package/dist/guida/assets/connectors_odoo.md.DprabV5e.js +19 -0
- package/dist/guida/assets/connectors_odoo.md.DprabV5e.lean.js +1 -0
- package/dist/guida/assets/{conventions_node-descriptor.md.MQaGlm8a.js → conventions_node-descriptor.md.C19dB-Tb.js} +4 -4
- package/dist/guida/assets/conventions_node-descriptor.md.C19dB-Tb.lean.js +1 -0
- package/dist/guida/assets/{conventions_run-report.md.D_pG07VG.js → conventions_run-report.md.iVSN9fNV.js} +1 -1
- package/dist/guida/assets/{conventions_versioni-di-pipeline.md.cy5nsizS.js → conventions_versioni-di-pipeline.md.DJPSthZ8.js} +1 -1
- package/dist/guida/assets/{conventions_versioni-di-pipeline.md.cy5nsizS.lean.js → conventions_versioni-di-pipeline.md.DJPSthZ8.lean.js} +1 -1
- package/dist/guida/assets/{nodes_README.md.CHGy_go6.js → nodes_README.md.BNAiSoJJ.js} +2 -2
- package/dist/guida/assets/{nodes_README.md.CHGy_go6.lean.js → nodes_README.md.BNAiSoJJ.lean.js} +1 -1
- package/dist/guida/assets/{nodes_lookup.md.BI8tgBIq.js → nodes_lookup.md.DrJFsfOJ.js} +1 -1
- package/dist/guida/assets/{nodes_sink.md.yAf_z4wO.js → nodes_sink.md.C1S-lAh2.js} +2 -2
- package/dist/guida/assets/{nodes_source.md.DP2i3GFv.js → nodes_source.md.BitUNtug.js} +2 -2
- package/dist/guida/assets/{nodes_task.md.Dk6VB7as.js → nodes_task.md.CejEQZcD.js} +2 -2
- package/dist/guida/assets/{nodes_task.md.Dk6VB7as.lean.js → nodes_task.md.CejEQZcD.lean.js} +1 -1
- package/dist/guida/assets/{nodes_transform.md.Bv5fg2Xx.js → nodes_transform.md.Ciycywnb.js} +1 -1
- package/dist/guida/assets/{runbooks_deployment.md.CwG77qGO.js → runbooks_deployment.md.BV8Izw4I.js} +1 -1
- package/dist/guida/assets/runbooks_excel-operazioni-distruttive.md.CEygSROg.js +16 -0
- package/dist/guida/assets/runbooks_excel-operazioni-distruttive.md.CEygSROg.lean.js +1 -0
- package/dist/guida/assets/{runbooks_sql-task-truncate-swap.md.C8viT-fp.js → runbooks_sql-task-truncate-swap.md.DAz41942.js} +5 -3
- package/dist/guida/assets/{runbooks_sql-task-truncate-swap.md.C8viT-fp.lean.js → runbooks_sql-task-truncate-swap.md.DAz41942.lean.js} +1 -1
- package/dist/guida/connectors/README.html +5 -5
- package/dist/guida/connectors/excel.html +118 -0
- package/dist/guida/connectors/file.html +7 -7
- package/dist/guida/connectors/http.html +4 -4
- package/dist/guida/connectors/imap.html +4 -4
- package/dist/guida/connectors/jira.html +5 -5
- package/dist/guida/connectors/mysql.html +60 -0
- package/dist/guida/connectors/noeva.html +5 -5
- package/dist/guida/connectors/oauth.html +5 -5
- package/dist/guida/connectors/odoo.html +45 -0
- package/dist/guida/connectors/postgres.html +5 -5
- 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 +8 -8
- package/dist/guida/conventions/run-report.html +6 -6
- 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 +6 -6
- package/dist/guida/guide/claude-code/index.html +4 -4
- package/dist/guida/guide/claude-code/prompt.html +5 -5
- 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 +4 -4
- package/dist/guida/nodes/README.html +5 -5
- 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 +6 -6
- package/dist/guida/nodes/pipeline.html +4 -4
- package/dist/guida/nodes/route.html +4 -4
- package/dist/guida/nodes/sink.html +7 -7
- package/dist/guida/nodes/source.html +7 -7
- package/dist/guida/nodes/task.html +6 -6
- package/dist/guida/nodes/transform.html +6 -6
- package/dist/guida/nodes/try-catch.html +4 -4
- package/dist/guida/nodes/union.html +4 -4
- package/dist/guida/pagine.json +4 -0
- package/dist/guida/pipelines/README.html +4 -4
- 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 +4 -4
- package/dist/guida/runbooks/aggiornamento-pm2.html +4 -4
- package/dist/guida/runbooks/deploy-ecr.html +4 -4
- package/dist/guida/runbooks/deployment.html +6 -6
- package/dist/guida/runbooks/etl-worker.html +5 -5
- package/dist/guida/runbooks/excel-operazioni-distruttive.html +42 -0
- package/dist/guida/runbooks/graph-server.html +5 -5
- 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 +8 -6
- 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/index.d.ts +9 -9
- package/dist/index.js +1 -1
- package/dist/{invio-Dwz3J7sP.d.ts → invio-9Ubb_cdR.d.ts} +3 -3
- package/dist/{istanza-per-il-piano-CucqUF7b.d.ts → istanza-per-il-piano-74NYhIHc.d.ts} +1 -1
- package/dist/{manifest-variabili-U1UfPDfF.d.ts → manifest-variabili-DRWUzmxU.d.ts} +1 -1
- package/dist/pipelines.d.ts +3 -3
- package/dist/pipelines.js +1 -1
- package/dist/{runnable-pipeline-CArkLzfv.d.ts → runnable-pipeline-CWgPwi6w.d.ts} +2 -2
- package/dist/{config-DIthC7n7.d.ts → sql-watermark-CQVvxhPZ.d.ts} +9 -40
- package/dist/testing.d.ts +3 -3
- package/dist/testing.js +1 -1
- package/dist/{trasporto-DpPLCEQ1.d.ts → trasporto-BaRdP6Wl.d.ts} +4 -4
- package/dist/{types-BVA7BIou.d.ts → types-_3rgLhje.d.ts} +21 -2
- package/dist/{variabili-dichiarate-DmfcxsT9.d.ts → variabili-dichiarate-CS-eC53K.d.ts} +1 -1
- package/kit/skills/etl-graph/SKILL.md +6 -3
- package/kit/skills/etl-graph/references/data-patterns.md +1 -1
- package/kit/skills/etl-graph/references/error-handling.md +3 -3
- package/kit/skills/etl-graph/references/wiring.md +10 -10
- package/kit/skills/new-connector/SKILL.md +2 -2
- package/package.json +16 -1
- package/dist/chunk-BVUOUBLW.js +0 -1
- package/dist/chunk-CRR3Q2C7.js +0 -2
- package/dist/chunk-LJ7DVP5F.js +0 -2
- package/dist/chunk-PKBSETMV.js +0 -2
- package/dist/chunk-QPJC4GWR.js +0 -1
- package/dist/chunk-RCRMQPFH.js +0 -5
- package/dist/chunk-RS5SGDUU.js +0 -1
- package/dist/chunk-RWPHH4E2.js +0 -1
- package/dist/chunk-SRFFKE5W.js +0 -6
- package/dist/chunk-WVODQB6Z.js +0 -1
- package/dist/chunk-XZMCC6VQ.js +0 -1
- package/dist/chunk-ZCYGHS7P.js +0 -2
- package/dist/guida/assets/TECHNICAL_OVERVIEW.md.DTIhkkg9.js +0 -10
- package/dist/guida/assets/chunks/@localSearchIndexroot.LnC621Vy.js +0 -1
- package/dist/guida/assets/connectors_README.md.BqI2RLCu.js +0 -1
- package/dist/guida/assets/connectors_README.md.BqI2RLCu.lean.js +0 -1
- package/dist/guida/assets/conventions_node-descriptor.md.MQaGlm8a.lean.js +0 -1
- /package/dist/guida/assets/{GUIDA_SVILUPPO.md.CrN52ZDN.lean.js → GUIDA_SVILUPPO.md.Bvr7RKHN.lean.js} +0 -0
- /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DTIhkkg9.lean.js → TECHNICAL_OVERVIEW.md.C6HYc5_h.lean.js} +0 -0
- /package/dist/guida/assets/{conventions_run-report.md.D_pG07VG.lean.js → conventions_run-report.md.iVSN9fNV.lean.js} +0 -0
- /package/dist/guida/assets/{nodes_lookup.md.BI8tgBIq.lean.js → nodes_lookup.md.DrJFsfOJ.lean.js} +0 -0
- /package/dist/guida/assets/{nodes_sink.md.yAf_z4wO.lean.js → nodes_sink.md.C1S-lAh2.lean.js} +0 -0
- /package/dist/guida/assets/{nodes_source.md.DP2i3GFv.lean.js → nodes_source.md.BitUNtug.lean.js} +0 -0
- /package/dist/guida/assets/{nodes_transform.md.Bv5fg2Xx.lean.js → nodes_transform.md.Ciycywnb.lean.js} +0 -0
- /package/dist/guida/assets/{runbooks_deployment.md.CwG77qGO.lean.js → runbooks_deployment.md.BV8Izw4I.lean.js} +0 -0
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { C as ConfigError,
|
|
3
|
-
import { M as ManifestVariabili, V as VariabileRisolta, R as RisoluzioneVariabili } from '../manifest-variabili-
|
|
4
|
-
import { H as HttpConfig } from '../config-
|
|
5
|
-
import { I as IstanzaPerIlPiano } from '../istanza-per-il-piano-
|
|
2
|
+
import { C as ConfigError, f as ConnectorDetail, e as RetryPolicy, S as Source } from '../errors-CRq1uNYZ.js';
|
|
3
|
+
import { M as ManifestVariabili, V as VariabileRisolta, R as RisoluzioneVariabili } from '../manifest-variabili-DRWUzmxU.js';
|
|
4
|
+
import { H as HttpConfig } from '../config-DMafsY4H.js';
|
|
5
|
+
import { I as IstanzaPerIlPiano } from '../istanza-per-il-piano-74NYhIHc.js';
|
|
6
6
|
import { C as ConnectorRegistry } from '../registry-tB3G64MU.js';
|
|
7
|
-
import '../ambiente-della-pipeline-
|
|
8
|
-
import '../variabili-dichiarate-
|
|
7
|
+
import '../ambiente-della-pipeline-BhWsyLUR.js';
|
|
8
|
+
import '../variabili-dichiarate-CS-eC53K.js';
|
|
9
9
|
|
|
10
10
|
/**
|
|
11
11
|
* Un campo di un modulo Zoho CRM come lo dichiara la pipeline (ADR-0106,
|
package/dist/connectors/zoho.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import'../chunk-ZCYGHS7P.js';import {e as e$1}from'../chunk-JLPK6MMQ.js';import {c as c$2}from'../chunk-LJ7DVP5F.js';import {A as A$1,O as O$1,l,P,Q as Q$1,G as G$1,H as H$1,J,m,r,s,a as a$1}from'../chunk-PKBSETMV.js';import {a,g,c as c$1,e,aa,Z as Z$1}from'../chunk-PE2QKU34.js';import {z}from'zod';var c="id",y="Modified_Time",N=50,T=N-[c,y].length,L=499,ao=15,So=a(o=>o==="coql"?L:T,"maxCampiDi"),co=new Set(["userlookup","ownerlookup"]),xo=new Set(["lookup",...co]),wo=new Set(["double","currency","decimal","percent"]),uo="_nome",Po=/^[A-Za-z_][A-Za-z0-9_]*$/;function mo(o){return o.replace(/[^\p{L}\p{N}_]/gu,"_").replace(/_+/g,"_").replace(/^_+|_+$/g,"").toLowerCase()}a(mo,"colonnaZoho");var Z=a(o=>co.has(o.tipo),"eCampoUtente");function H(o){return o==="integer"?"integer":wo.has(o)?"number":o==="boolean"?"boolean":o==="date"?"date":o==="datetime"?"datetime":"string"}a(H,"tipoColonnaZoho");function R(o){return o.flatMap(e=>{let n=mo(e.nome),t={colonna:n,campo:e,tipo:H(e.tipo),nomeUtente:false};return Z(e)?[t,{colonna:`${n}${uo}`,campo:e,tipo:"string",nomeUtente:true}]:[t]})}a(R,"colonneZoho");function To(o){return [c,...R(o).map(e=>e.colonna)]}a(To,"nomiColonneZoho");function po(o,e,n="records"){let t=a(s=>{throw new g(`${o}: ${s}`)},"fail");e.length===0&&t("serve almeno un campo");let i=new Set;for(let s of e)Po.test(s.nome)||t(`"${s.nome}" non \xE8 un nome API di Zoho valido`),s.nome===c&&t(`"${c}" non si dichiara: ogni record lo porta gi\xE0`),i.has(s.nome)&&t(`il campo "${s.nome}" \xE8 dichiarato due volte`),i.add(s.nome);let a$1=n==="coql"?e.length:e.filter(s=>s.nome!==y).length;if(n==="coql"){let s=e.filter(Z).length;a$1+2*s>L&&t(`${a$1} campi, pi\xF9 nome e cognome di ${s} utenti, ma una SELECT COQL ne ammette ${L} oltre a ${c}: dividi il modulo in pi\xF9 passate`),s>ao&&t(`${s} collegamenti a utenti, ma una SELECT COQL ammette ${ao} join: dividi il modulo in pi\xF9 passate`);}n==="records"&&a$1>T&&t(`${a$1} campi oltre a ${y}, ma la Records API ne restituisce ${N} per chiamata (${T} pi\xF9 ${c} e ${y}): dividi il modulo in pi\xF9 passate, o leggilo con COQL`);let l=new Map([[c,c]]);for(let{colonna:s,campo:d}of R(e)){let g=l.get(s);g!==void 0&&t(`i campi "${g}" e "${d.nome}" finirebbero entrambi nella colonna "${s}"`),l.set(s,d.nome);}return e}a(po,"campiDichiaratiZoho");function ho(o){return [{id:c,name:c,dataType:"string",isKey:true},...R(o).map(({colonna:e,tipo:n})=>({id:e,name:e,dataType:n,isKey:false}))]}a(ho,"colonneDelPianoZoho");var Lo=/^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2})(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})?$/,fo=/^\d{4}-\d{2}-\d{2}$/,$o=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/,A=class extends Error{static{a(this,"ValoreNonConvertibile");}},O=a(()=>{throw new A},"nonConvertibile");function so(o){let e=typeof o=="number"?o:typeof o=="string"&&o.trim()!==""?Number(o):Number.NaN;return Number.isFinite(e)?e:O()}a(so,"numero");var q=a(o=>typeof o=="object"&&o!==null&&!Array.isArray(o),"eOggetto");function lo(o){let e=o.id;return typeof e=="string"||typeof e=="number"?String(e):null}a(lo,"idDi");function Mo(o){if(q(o)){let e=o.name;return typeof e=="string"?e:JSON.stringify(o)}return String(o)}a(Mo,"voce");function F(o,e){if(o==null||o==="")return null;if(q(o))return xo.has(e)?lo(o):lo(o)??JSON.stringify(o);if(Array.isArray(o))return o.map(Mo).join("; ");switch(H(e)){case "datetime":{let n=typeof o=="string"?Lo.exec(o):null;return n===null?O():`${n[1]??""}T${n[2]??""}`}case "date":return typeof o=="string"&&fo.test(o)?o:O();case "boolean":return typeof o=="boolean"?o:o==="true"?true:o==="false"?false:O();case "integer":{let n=so(o);return Number.isInteger(n)?n:O()}case "number":return so(o);case "string":return typeof o=="string"?o:JSON.stringify(o)}}a(F,"valoreZoho");function go(o){if(!q(o))return null;let e=o.name;return typeof e=="string"&&e!==""?e:null}a(go,"nomeUtenteZoho");function Do(o){switch(o){case "integer":return z.number().int().nullable();case "number":return z.number().nullable();case "boolean":return z.boolean().nullable();case "date":return z.string().regex(fo).nullable();case "datetime":return z.string().regex($o).nullable();case "string":return z.string().nullable()}}a(Do,"schemaColonna");function vo(o){let e={};for(let{colonna:n,tipo:t}of R(o))e[n]=Do(t);return z.object({[c]:z.string().min(1),...e}).strict()}a(vo,"schemaRecordZoho");var $=6e4,M=20*1024*1024,Uo=new Set(["localhost","127.0.0.1","[::1]"]),D=[{suffisso:"BASE_URL",obbligatoria:true},{suffisso:"OAUTH_INSTANCE",default:l},{suffisso:"TIMEOUT_MS",default:String($)}];function zo(o,e){let n;try{n=new URL(e);}catch{throw new g(`${o}BASE_URL non \xE8 un URL valido`)}if(n.username!==""||n.password!=="")throw new g(`${o}BASE_URL contiene credenziali nell'URL: il token lo rinnova l'identit\xE0 OAuth2 (${o}OAUTH_INSTANCE)`);if(!(n.protocol==="https:"||n.protocol==="http:"&&Uo.has(n.hostname)))throw new g(`${o}BASE_URL deve usare https: il token viaggia in ogni richiesta`);if(n.search!==""||n.hash!=="")throw new g(`${o}BASE_URL deve essere la base delle API, senza query (https://www.zohoapis.eu/crm/v8)`);if(!/\/crm\/v8\/?$/.test(n.pathname))throw new g(`${o}BASE_URL deve finire con /crm/v8: il connettore parla la Records API v8 (https://www.zohoapis.eu/crm/v8)`);return `${n.origin}${n.pathname.replace(/\/+$/,"")}`}a(zo,"parseBaseUrl");function ko(o,e){let n=Number(e);if(!Number.isInteger(n)||n<=0)throw new g(`${o}TIMEOUT_MS non valido (atteso un intero positivo di millisecondi)`);return n}a(ko,"parseTimeout");function Q(o=A$1,e=process.env){let n=O$1(D,o,e);P(n);let t=a(i=>Q$1(n,i),"valore");return {baseUrl:zo(o,t("BASE_URL")),oauthInstance:t("OAUTH_INSTANCE"),timeoutMs:ko(o,t("TIMEOUT_MS")),maxResponseBytes:M,variabili:n.variabili}}a(Q,"loadZohoConfig");function B(o,e){return {baseUrl:o.baseUrl,auth:{kind:"header",name:"authorization",value:`Zoho-oauthtoken ${e}`},timeoutMs:o.timeoutMs,maxResponseBytes:o.maxResponseBytes}}a(B,"trasportoZoho");function yo(o){try{let e=new URL(o);return `${e.origin}${e.pathname.replace(/\/+$/,"")}`}catch{return "non valido"}}a(yo,"apiMostrabile");function Zo(o,e){let n=G$1(o.variabili,"BASE_URL");return [H$1("api",yo(o.baseUrl),n?.valore===void 0?n:{...n,valore:yo(n.valore)}),...e,...J(o.ricaduta),Ro(o)]}a(Zo,"dettagliZoho");var j="credenziale";function Ro(o){let e=G$1(o.variabili,"OAUTH_INSTANCE"),n=`OAuth \xB7 identit\xE0 ${e?.valore??o.oauthInstance}`,t=o.identitaOauth;if(t===void 0)return {label:j,value:n,...e!==void 0?{env:e.variabile,origine:e.origine}:{}};let[i]=t.mancanti;if(i===void 0)return {label:j,value:`${n} \xB7 impostata`,...e!==void 0?{env:e.variabile,origine:e.origine}:{}};let a=t.mancanti.length===1?"manca":"mancano";return {label:j,value:`${n} \xB7 ${a} ${t.mancanti.join(", ")}`,env:i,origine:"mancante"}}a(Ro,"dettaglioCredenzialeZoho");var X={attempts:5,baseMs:2e3,maxMs:6e4,jitter:.3},No={400:"richiesta rifiutata: un campo dichiarato non si legge pi\xF9, o la query COQL usa un campo che COQL non ammette",401:"token rifiutato: controlla l'identit\xE0 OAuth2 dell'istanza, il suo data center (BASE_URL) e gli scope ZohoCRM.modules.READ, ZohoCRM.settings.fields.READ e, per la lettura COQL, ZohoCRM.coql.READ",403:"permesso negato: l'utente del refresh token non vede questo modulo",404:"non trovato: controlla il nome API del modulo e BASE_URL"};function Ho(o,e$1,n){if(!(o instanceof c$1)||o instanceof g)return o;let t=o.context.details?.status,i=typeof t=="number"?No[t]:void 0;return new e(`Zoho, ${e$1.descrizione}: ${o.message}${i!==void 0?` (${i})`:""}`,{stage:n.stage,...o.context.details!==void 0?{details:o.context.details}:{},...o.context.transient!==void 0?{transient:o.context.transient}:{}},{cause:o})}a(Ho,"erroreDelSource");async function _(o,e$2,n){try{return await aa(async()=>{let t=await o.token(),i=await e$1(B(o.config,t),{method:e$2.method??"GET",path:e$2.path,endpoint:e$2.path,...e$2.body!==void 0?{body:e$2.body}:{},...e$2.query!==void 0?{query:e$2.query}:{},...e$2.headers!==void 0?{headers:e$2.headers}:{}},e$2.schema,n,o.fetchImpl!==void 0?{fetchImpl:o.fetchImpl}:{});if(i.kind!=="ok")throw new e(`${e$2.method??"GET"} ${e$2.path}: risposta inattesa`,{stage:o.stage});return i.value},o.retry,n,{onRetry:a(({retry:t,delayMs:i,error:a})=>n.logger.warn("zoho-source.retry",{stage:o.stage,endpoint:e$2.path,retry:t,delayMs:i,status:a instanceof c$1?a.context.details?.status:void 0}),"onRetry")})}catch(t){throw Ho(t,e$2,o)}}a(_,"leggiDaZoho");function Co(o){return {kind:"zoho",listEnvVar:"ZOHO_INSTANCES",instancesRaw:o.ZOHO_INSTANCES,defaultId:l,loadOne:a(e=>Q(m(A$1,e),o),"loadOne")}}a(Co,"opzioni");function qo(o=process.env){return r(Co(o))}a(qo,"loadZohoRegistry");function V(o,e=process.env){return s(Co(e),o)}a(V,"loadZohoInstance");var Fo={baseUrl:"https://zoho.esempio/crm/v8",oauthInstance:"default",timeoutMs:$,maxResponseBytes:M};function Qo(o,e){return {risolta:a(()=>c$2(V(o,e),e),"risolta"),esempio:a(n=>c$2({...Fo,ricaduta:n,variabili:O$1(D,m(A$1,o),e).variabili},e),"esempio")}}a(Qo,"istanzaZohoPerIlPiano");var _o=a(()=>({visti:new Set,chiamate:0,duplicati:0}),"nuovoStato");function Bo(o,e$1,n){let t=o[c];if(typeof t=="string"&&t!=="")return t;if(typeof t=="number")return String(t);throw new e(`Zoho, modulo ${e$1.modulo}: un record senza id`,{stage:n,details:{modulo:e$1.modulo}})}a(Bo,"idDelRecord");function jo(o,e$1,n,t){let i={[c]:e$1};for(let{colonna:a,campo:l,nomeUtente:s}of n.colonne){let d=o[l.nome];try{i[a]=s?go(d):F(d,l.tipo);}catch(g){throw g instanceof A?new e(`Zoho, modulo ${n.modulo}: il campo ${l.nome} del record ${e$1} non si legge come ${l.tipo}`,{stage:t,details:{modulo:n.modulo,campo:l.nome,id:e$1}}):g}}return i}a(jo,"versoRecord");function*v(o,e,n,t){for(let i of o){let a=Bo(i,e,t);if(n.visti.has(a)){n.duplicati++;continue}n.visti.add(a),yield jo(i,a,e,t);}}a(v,"nuoviDelBlocco");var E=2e3,Xo=/^\d+$/,Oo=["first_name","last_name"],Vo=z.union([z.null(),z.object({data:z.array(z.record(z.unknown())),info:z.object({more_records:z.boolean().optional()}).passthrough().optional()})]);function Go(o,e){let n=o.campi.filter(Z).flatMap(a=>Oo.map(l=>`${a.nome}.${l}`)),t=[c,...o.campi.map(a=>a.nome),...n].map(a=>`'${a}'`).join(", "),i=e===void 0?"id is not null":`id > '${e}'`;return `select ${t} from ${o.modulo} where ${i} order by id asc limit ${o.perQuery}`}a(Go,"queryCoql");async function*Ao(o,e,n,t){let i=new Set,a;for(;;){let l=await _(o,{descrizione:`query COQL del modulo ${e.modulo}`,method:"POST",path:"/coql",body:{select_query:Go(e,a)},schema:Vo},n);t.chiamate++;let s=(l?.data??[]).map(g=>Jo(g,e));if(s.length===0)return;Ko(s,e,i,o.stage,n);let d=Yo(s,a,e,o.stage);if(yield*v(s,e,t,o.stage),l?.info?.more_records!==true)return;a=d;}}a(Ao,"leggiConCoql");function Yo(o,e$1,n,t){let i=o[o.length-1]?.[c],a=typeof i=="number"?String(i):i;if(typeof a!="string"||!Xo.test(a))throw new e(`Zoho, modulo ${n.modulo}: la query COQL ha restituito un id che non \xE8 un numero`,{stage:t,details:{modulo:n.modulo}});if(e$1!==void 0&&BigInt(a)<=BigInt(e$1))throw new e(`Zoho, modulo ${n.modulo}: gli id della query COQL non crescono dopo ${e$1}, la lettura girerebbe in tondo`,{stage:t,details:{modulo:n.modulo,dopo:e$1}});return a}a(Yo,"ultimoId");var Eo=a(o=>typeof o=="string"&&o.trim()!=="","eNome");function Jo(o,e){let n=o;for(let t of e.campi.filter(Z)){let i=o[t.nome];if(typeof i!="object"||i===null)continue;let a=i,l=Oo.map(s=>o[`${t.nome}.${s}`]).filter(Eo);l.length!==0&&(n={...n,[t.nome]:{...a,name:l.join(" ")}});}return n}a(Jo,"conNomiUtente");function Ko(o,e,n,t,i){for(let a of e.campi.filter(Z)){if(n.has(a.nome))continue;o.some(s=>{let d=s[a.nome];return typeof d=="object"&&d!==null&&!Eo(d.name)})&&(n.add(a.nome),i.logger.warn("zoho-source.nome-utente-assente",{stage:t,modulo:e.modulo,campo:a.nome}));}}a(Ko,"segnalaNomiAssenti");var b=200,I=1e5,Wo=z.union([z.null(),z.object({data:z.array(z.record(z.unknown())),info:z.object({more_records:z.boolean().optional(),next_page_token:z.string().nullish()}).passthrough().optional()})]);async function*bo(o,e$1,n,t){let i=new Set,a,l=0;for(;;){let s=await _(o,{descrizione:`record del modulo ${e$1.modulo}`,path:`/${e$1.modulo}`,query:{fields:e$1.fields,per_page:String(e$1.perPagina),sort_by:c,sort_order:"asc",...a!==void 0?{page_token:a}:{}},schema:Wo},n);t.chiamate++;let d=s?.data??[];if(l+=d.length,yield*v(d,e$1,t,o.stage),s?.info?.more_records!==true)return;if(l>=e$1.maxPerInterrogazione-e$1.perPagina)throw new e(`Zoho, modulo ${e$1.modulo}: oltre ${e$1.maxPerInterrogazione} record la Records API non legge; leggi il modulo con lettura "coql"`,{stage:o.stage,details:{modulo:e$1.modulo}});a=oe(s.info,i,e$1,o.stage),i.add(a);}}a(bo,"leggiConRecords");var Io=a(o=>[...new Set([c,y,...o.map(e=>e.nome)])].join(","),"fieldsRecords");function oe(o,e$1,n,t){let i=o.next_page_token;if(i==null||i==="")throw new e(`Zoho, modulo ${n.modulo}: more_records senza next_page_token`,{stage:t,details:{modulo:n.modulo}});if(e$1.has(i))throw new e(`Zoho, modulo ${n.modulo}: next_page_token ripetuto, la lettura girerebbe in tondo`,{stage:t,details:{modulo:n.modulo}});return i}a(oe,"prossimoToken");var ee=/^[A-Za-z][A-Za-z0-9_]*$/,ne=z.object({fields:z.array(z.object({api_name:z.string(),data_type:z.string().optional()}).passthrough())});function G(o,e,n,t){if(!Number.isInteger(n)||n<1||n>t)throw new g(`zohoCrmRecords "${o}": ${e} deve essere un intero fra 1 e ${t}`);return n}a(G,"interoFra");function te(o,e,n){return e.lettura==="coql"?{lettura:"coql",perQuery:G(o,"perQuery",e.perQuery??E,E)}:{lettura:"records",fields:Io(n),perPagina:G(o,"perPagina",e.perPagina??b,b),maxPerInterrogazione:G(o,"maxPerInterrogazione",e.maxPerInterrogazione??I,I)}}a(te,"letturaScelta");function re(o){let e=o.name??`zoho:${o.modulo}`;if(!ee.test(o.modulo))throw new g(`zohoCrmRecords "${e}": "${o.modulo}" non \xE8 un nome API di modulo valido`);let n=o.lettura??"records",t=po(`zohoCrmRecords "${e}"`,o.campi,n),i={modulo:o.modulo,campi:t,colonne:R(t)},a$2=te(e,o,t),l={config:o.config,token:o.token,retry:Z$1({...X,...o.retry},e),stage:e,...o.fetchImpl!==void 0?{fetchImpl:o.fetchImpl}:{}};return {name:e,columns:ho(t),descriptor:{kind:"zoho-source",...a$1(o.instanceId),details:Zo(o.config,[{label:"modulo",value:o.modulo},{label:"lettura",value:n==="coql"?"COQL, per id crescente":"Records API, per id"},{label:"campi",value:t.map(s=>s.nome).join(", ")}])},extract:a(s=>ae(l,i,a$2,s),"extract")}}a(re,"zohoCrmRecords");async function ie(o,e,n){let{fields:t}=await _(o,{descrizione:`catalogo dei campi del modulo ${e.modulo}`,path:"/settings/fields",query:{module:e.modulo},schema:ne},n),i=new Map(t.map(l=>[l.api_name,l.data_type])),a=e.campi.map(l=>l.nome).filter(l=>!i.has(l));if(a.length>0)throw new g(`zohoCrmRecords "${o.stage}": il modulo ${e.modulo} non ha pi\xF9 ${a.length===1?"il campo":"i campi"} ${a.join(", ")}. Togli${a.length===1?"lo":"li"} dalla pipeline con una versione nuova`);for(let l of e.campi){let s=i.get(l.nome);s!==void 0&&s!==l.tipo&&n.logger.warn("zoho-source.tipo-cambiato",{stage:o.stage,modulo:e.modulo,campo:l.nome,dichiarato:l.tipo,zoho:s});}}a(ie,"controllaCatalogo");async function*ae(o,e,n,t){await ie(o,e,t);let i=_o();n.lettura==="coql"?yield*Ao(o,{...e,...n},t,i):yield*bo(o,{...e,...n},t,i),t.logger.info("zoho-source.lettura",{stage:o.stage,modulo:e.modulo,lettura:n.lettura,chiamate:i.chiamate,record:i.visti.size,duplicati:i.duplicati});}a(ae,"leggiTutti");
|
|
1
|
+
import'../chunk-5OE6F2MK.js';import {c as c$2}from'../chunk-VL7DZWWO.js';import {e as e$1}from'../chunk-OK3XRTGA.js';import {B as B$1,Q as Q$1,l,R as R$1,S,I as I$1,J,L as L$1,m,r,s,a as a$1}from'../chunk-47NVGHUY.js';import {a,g,c as c$1,e,aa,Z as Z$1}from'../chunk-CEAMQIRO.js';import {z}from'zod';var c="id",y="Modified_Time",N=50,T=N-[c,y].length,L=499,ao=15,So=a(o=>o==="coql"?L:T,"maxCampiDi"),co=new Set(["userlookup","ownerlookup"]),xo=new Set(["lookup",...co]),wo=new Set(["double","currency","decimal","percent"]),uo="_nome",Po=/^[A-Za-z_][A-Za-z0-9_]*$/;function mo(o){return o.replace(/[^\p{L}\p{N}_]/gu,"_").replace(/_+/g,"_").replace(/^_+|_+$/g,"").toLowerCase()}a(mo,"colonnaZoho");var Z=a(o=>co.has(o.tipo),"eCampoUtente");function H(o){return o==="integer"?"integer":wo.has(o)?"number":o==="boolean"?"boolean":o==="date"?"date":o==="datetime"?"datetime":"string"}a(H,"tipoColonnaZoho");function R(o){return o.flatMap(e=>{let n=mo(e.nome),t={colonna:n,campo:e,tipo:H(e.tipo),nomeUtente:false};return Z(e)?[t,{colonna:`${n}${uo}`,campo:e,tipo:"string",nomeUtente:true}]:[t]})}a(R,"colonneZoho");function To(o){return [c,...R(o).map(e=>e.colonna)]}a(To,"nomiColonneZoho");function po(o,e,n="records"){let t=a(s=>{throw new g(`${o}: ${s}`)},"fail");e.length===0&&t("serve almeno un campo");let i=new Set;for(let s of e)Po.test(s.nome)||t(`"${s.nome}" non \xE8 un nome API di Zoho valido`),s.nome===c&&t(`"${c}" non si dichiara: ogni record lo porta gi\xE0`),i.has(s.nome)&&t(`il campo "${s.nome}" \xE8 dichiarato due volte`),i.add(s.nome);let a$1=n==="coql"?e.length:e.filter(s=>s.nome!==y).length;if(n==="coql"){let s=e.filter(Z).length;a$1+2*s>L&&t(`${a$1} campi, pi\xF9 nome e cognome di ${s} utenti, ma una SELECT COQL ne ammette ${L} oltre a ${c}: dividi il modulo in pi\xF9 passate`),s>ao&&t(`${s} collegamenti a utenti, ma una SELECT COQL ammette ${ao} join: dividi il modulo in pi\xF9 passate`);}n==="records"&&a$1>T&&t(`${a$1} campi oltre a ${y}, ma la Records API ne restituisce ${N} per chiamata (${T} pi\xF9 ${c} e ${y}): dividi il modulo in pi\xF9 passate, o leggilo con COQL`);let l=new Map([[c,c]]);for(let{colonna:s,campo:d}of R(e)){let g=l.get(s);g!==void 0&&t(`i campi "${g}" e "${d.nome}" finirebbero entrambi nella colonna "${s}"`),l.set(s,d.nome);}return e}a(po,"campiDichiaratiZoho");function ho(o){return [{id:c,name:c,dataType:"string",isKey:true},...R(o).map(({colonna:e,tipo:n})=>({id:e,name:e,dataType:n,isKey:false}))]}a(ho,"colonneDelPianoZoho");var Lo=/^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2})(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})?$/,fo=/^\d{4}-\d{2}-\d{2}$/,$o=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/,A=class extends Error{static{a(this,"ValoreNonConvertibile");}},O=a(()=>{throw new A},"nonConvertibile");function so(o){let e=typeof o=="number"?o:typeof o=="string"&&o.trim()!==""?Number(o):Number.NaN;return Number.isFinite(e)?e:O()}a(so,"numero");var q=a(o=>typeof o=="object"&&o!==null&&!Array.isArray(o),"eOggetto");function lo(o){let e=o.id;return typeof e=="string"||typeof e=="number"?String(e):null}a(lo,"idDi");function Mo(o){if(q(o)){let e=o.name;return typeof e=="string"?e:JSON.stringify(o)}return String(o)}a(Mo,"voce");function F(o,e){if(o==null||o==="")return null;if(q(o))return xo.has(e)?lo(o):lo(o)??JSON.stringify(o);if(Array.isArray(o))return o.map(Mo).join("; ");switch(H(e)){case "datetime":{let n=typeof o=="string"?Lo.exec(o):null;return n===null?O():`${n[1]??""}T${n[2]??""}`}case "date":return typeof o=="string"&&fo.test(o)?o:O();case "boolean":return typeof o=="boolean"?o:o==="true"?true:o==="false"?false:O();case "integer":{let n=so(o);return Number.isInteger(n)?n:O()}case "number":return so(o);case "string":return typeof o=="string"?o:JSON.stringify(o)}}a(F,"valoreZoho");function go(o){if(!q(o))return null;let e=o.name;return typeof e=="string"&&e!==""?e:null}a(go,"nomeUtenteZoho");function Do(o){switch(o){case "integer":return z.number().int().nullable();case "number":return z.number().nullable();case "boolean":return z.boolean().nullable();case "date":return z.string().regex(fo).nullable();case "datetime":return z.string().regex($o).nullable();case "string":return z.string().nullable()}}a(Do,"schemaColonna");function vo(o){let e={};for(let{colonna:n,tipo:t}of R(o))e[n]=Do(t);return z.object({[c]:z.string().min(1),...e}).strict()}a(vo,"schemaRecordZoho");var $=6e4,M=20*1024*1024,Uo=new Set(["localhost","127.0.0.1","[::1]"]),D=[{suffisso:"BASE_URL",obbligatoria:true},{suffisso:"OAUTH_INSTANCE",default:l},{suffisso:"TIMEOUT_MS",default:String($)}];function zo(o,e){let n;try{n=new URL(e);}catch{throw new g(`${o}BASE_URL non \xE8 un URL valido`)}if(n.username!==""||n.password!=="")throw new g(`${o}BASE_URL contiene credenziali nell'URL: il token lo rinnova l'identit\xE0 OAuth2 (${o}OAUTH_INSTANCE)`);if(!(n.protocol==="https:"||n.protocol==="http:"&&Uo.has(n.hostname)))throw new g(`${o}BASE_URL deve usare https: il token viaggia in ogni richiesta`);if(n.search!==""||n.hash!=="")throw new g(`${o}BASE_URL deve essere la base delle API, senza query (https://www.zohoapis.eu/crm/v8)`);if(!/\/crm\/v8\/?$/.test(n.pathname))throw new g(`${o}BASE_URL deve finire con /crm/v8: il connettore parla la Records API v8 (https://www.zohoapis.eu/crm/v8)`);return `${n.origin}${n.pathname.replace(/\/+$/,"")}`}a(zo,"parseBaseUrl");function ko(o,e){let n=Number(e);if(!Number.isInteger(n)||n<=0)throw new g(`${o}TIMEOUT_MS non valido (atteso un intero positivo di millisecondi)`);return n}a(ko,"parseTimeout");function Q(o=B$1,e=process.env){let n=Q$1(D,o,e);R$1(n);let t=a(i=>S(n,i),"valore");return {baseUrl:zo(o,t("BASE_URL")),oauthInstance:t("OAUTH_INSTANCE"),timeoutMs:ko(o,t("TIMEOUT_MS")),maxResponseBytes:M,variabili:n.variabili}}a(Q,"loadZohoConfig");function B(o,e){return {baseUrl:o.baseUrl,auth:{kind:"header",name:"authorization",value:`Zoho-oauthtoken ${e}`},timeoutMs:o.timeoutMs,maxResponseBytes:o.maxResponseBytes}}a(B,"trasportoZoho");function yo(o){try{let e=new URL(o);return `${e.origin}${e.pathname.replace(/\/+$/,"")}`}catch{return "non valido"}}a(yo,"apiMostrabile");function Zo(o,e){let n=I$1(o.variabili,"BASE_URL");return [J("api",yo(o.baseUrl),n?.valore===void 0?n:{...n,valore:yo(n.valore)}),...e,...L$1(o.ricaduta),Ro(o)]}a(Zo,"dettagliZoho");var j="credenziale";function Ro(o){let e=I$1(o.variabili,"OAUTH_INSTANCE"),n=`OAuth \xB7 identit\xE0 ${e?.valore??o.oauthInstance}`,t=o.identitaOauth;if(t===void 0)return {label:j,value:n,...e!==void 0?{env:e.variabile,origine:e.origine}:{}};let[i]=t.mancanti;if(i===void 0)return {label:j,value:`${n} \xB7 impostata`,...e!==void 0?{env:e.variabile,origine:e.origine}:{}};let a=t.mancanti.length===1?"manca":"mancano";return {label:j,value:`${n} \xB7 ${a} ${t.mancanti.join(", ")}`,env:i,origine:"mancante"}}a(Ro,"dettaglioCredenzialeZoho");var X={attempts:5,baseMs:2e3,maxMs:6e4,jitter:.3},No={400:"richiesta rifiutata: un campo dichiarato non si legge pi\xF9, o la query COQL usa un campo che COQL non ammette",401:"token rifiutato: controlla l'identit\xE0 OAuth2 dell'istanza, il suo data center (BASE_URL) e gli scope ZohoCRM.modules.READ, ZohoCRM.settings.fields.READ e, per la lettura COQL, ZohoCRM.coql.READ",403:"permesso negato: l'utente del refresh token non vede questo modulo",404:"non trovato: controlla il nome API del modulo e BASE_URL"};function Ho(o,e$1,n){if(!(o instanceof c$1)||o instanceof g)return o;let t=o.context.details?.status,i=typeof t=="number"?No[t]:void 0;return new e(`Zoho, ${e$1.descrizione}: ${o.message}${i!==void 0?` (${i})`:""}`,{stage:n.stage,...o.context.details!==void 0?{details:o.context.details}:{},...o.context.transient!==void 0?{transient:o.context.transient}:{}},{cause:o})}a(Ho,"erroreDelSource");async function _(o,e$2,n){try{return await aa(async()=>{let t=await o.token(),i=await e$1(B(o.config,t),{method:e$2.method??"GET",path:e$2.path,endpoint:e$2.path,...e$2.body!==void 0?{body:e$2.body}:{},...e$2.query!==void 0?{query:e$2.query}:{},...e$2.headers!==void 0?{headers:e$2.headers}:{}},e$2.schema,n,o.fetchImpl!==void 0?{fetchImpl:o.fetchImpl}:{});if(i.kind!=="ok")throw new e(`${e$2.method??"GET"} ${e$2.path}: risposta inattesa`,{stage:o.stage});return i.value},o.retry,n,{onRetry:a(({retry:t,delayMs:i,error:a})=>n.logger.warn("zoho-source.retry",{stage:o.stage,endpoint:e$2.path,retry:t,delayMs:i,status:a instanceof c$1?a.context.details?.status:void 0}),"onRetry")})}catch(t){throw Ho(t,e$2,o)}}a(_,"leggiDaZoho");function Co(o){return {kind:"zoho",listEnvVar:"ZOHO_INSTANCES",instancesRaw:o.ZOHO_INSTANCES,defaultId:l,loadOne:a(e=>Q(m(B$1,e),o),"loadOne")}}a(Co,"opzioni");function qo(o=process.env){return r(Co(o))}a(qo,"loadZohoRegistry");function V(o,e=process.env){return s(Co(e),o)}a(V,"loadZohoInstance");var Fo={baseUrl:"https://zoho.esempio/crm/v8",oauthInstance:"default",timeoutMs:$,maxResponseBytes:M};function Qo(o,e){return {risolta:a(()=>c$2(V(o,e),e),"risolta"),esempio:a(n=>c$2({...Fo,ricaduta:n,variabili:Q$1(D,m(B$1,o),e).variabili},e),"esempio")}}a(Qo,"istanzaZohoPerIlPiano");var _o=a(()=>({visti:new Set,chiamate:0,duplicati:0}),"nuovoStato");function Bo(o,e$1,n){let t=o[c];if(typeof t=="string"&&t!=="")return t;if(typeof t=="number")return String(t);throw new e(`Zoho, modulo ${e$1.modulo}: un record senza id`,{stage:n,details:{modulo:e$1.modulo}})}a(Bo,"idDelRecord");function jo(o,e$1,n,t){let i={[c]:e$1};for(let{colonna:a,campo:l,nomeUtente:s}of n.colonne){let d=o[l.nome];try{i[a]=s?go(d):F(d,l.tipo);}catch(g){throw g instanceof A?new e(`Zoho, modulo ${n.modulo}: il campo ${l.nome} del record ${e$1} non si legge come ${l.tipo}`,{stage:t,details:{modulo:n.modulo,campo:l.nome,id:e$1}}):g}}return i}a(jo,"versoRecord");function*v(o,e,n,t){for(let i of o){let a=Bo(i,e,t);if(n.visti.has(a)){n.duplicati++;continue}n.visti.add(a),yield jo(i,a,e,t);}}a(v,"nuoviDelBlocco");var E=2e3,Xo=/^\d+$/,Oo=["first_name","last_name"],Vo=z.union([z.null(),z.object({data:z.array(z.record(z.unknown())),info:z.object({more_records:z.boolean().optional()}).passthrough().optional()})]);function Go(o,e){let n=o.campi.filter(Z).flatMap(a=>Oo.map(l=>`${a.nome}.${l}`)),t=[c,...o.campi.map(a=>a.nome),...n].map(a=>`'${a}'`).join(", "),i=e===void 0?"id is not null":`id > '${e}'`;return `select ${t} from ${o.modulo} where ${i} order by id asc limit ${o.perQuery}`}a(Go,"queryCoql");async function*Ao(o,e,n,t){let i=new Set,a;for(;;){let l=await _(o,{descrizione:`query COQL del modulo ${e.modulo}`,method:"POST",path:"/coql",body:{select_query:Go(e,a)},schema:Vo},n);t.chiamate++;let s=(l?.data??[]).map(g=>Jo(g,e));if(s.length===0)return;Ko(s,e,i,o.stage,n);let d=Yo(s,a,e,o.stage);if(yield*v(s,e,t,o.stage),l?.info?.more_records!==true)return;a=d;}}a(Ao,"leggiConCoql");function Yo(o,e$1,n,t){let i=o[o.length-1]?.[c],a=typeof i=="number"?String(i):i;if(typeof a!="string"||!Xo.test(a))throw new e(`Zoho, modulo ${n.modulo}: la query COQL ha restituito un id che non \xE8 un numero`,{stage:t,details:{modulo:n.modulo}});if(e$1!==void 0&&BigInt(a)<=BigInt(e$1))throw new e(`Zoho, modulo ${n.modulo}: gli id della query COQL non crescono dopo ${e$1}, la lettura girerebbe in tondo`,{stage:t,details:{modulo:n.modulo,dopo:e$1}});return a}a(Yo,"ultimoId");var Eo=a(o=>typeof o=="string"&&o.trim()!=="","eNome");function Jo(o,e){let n=o;for(let t of e.campi.filter(Z)){let i=o[t.nome];if(typeof i!="object"||i===null)continue;let a=i,l=Oo.map(s=>o[`${t.nome}.${s}`]).filter(Eo);l.length!==0&&(n={...n,[t.nome]:{...a,name:l.join(" ")}});}return n}a(Jo,"conNomiUtente");function Ko(o,e,n,t,i){for(let a of e.campi.filter(Z)){if(n.has(a.nome))continue;o.some(s=>{let d=s[a.nome];return typeof d=="object"&&d!==null&&!Eo(d.name)})&&(n.add(a.nome),i.logger.warn("zoho-source.nome-utente-assente",{stage:t,modulo:e.modulo,campo:a.nome}));}}a(Ko,"segnalaNomiAssenti");var b=200,I=1e5,Wo=z.union([z.null(),z.object({data:z.array(z.record(z.unknown())),info:z.object({more_records:z.boolean().optional(),next_page_token:z.string().nullish()}).passthrough().optional()})]);async function*bo(o,e$1,n,t){let i=new Set,a,l=0;for(;;){let s=await _(o,{descrizione:`record del modulo ${e$1.modulo}`,path:`/${e$1.modulo}`,query:{fields:e$1.fields,per_page:String(e$1.perPagina),sort_by:c,sort_order:"asc",...a!==void 0?{page_token:a}:{}},schema:Wo},n);t.chiamate++;let d=s?.data??[];if(l+=d.length,yield*v(d,e$1,t,o.stage),s?.info?.more_records!==true)return;if(l>=e$1.maxPerInterrogazione-e$1.perPagina)throw new e(`Zoho, modulo ${e$1.modulo}: oltre ${e$1.maxPerInterrogazione} record la Records API non legge; leggi il modulo con lettura "coql"`,{stage:o.stage,details:{modulo:e$1.modulo}});a=oe(s.info,i,e$1,o.stage),i.add(a);}}a(bo,"leggiConRecords");var Io=a(o=>[...new Set([c,y,...o.map(e=>e.nome)])].join(","),"fieldsRecords");function oe(o,e$1,n,t){let i=o.next_page_token;if(i==null||i==="")throw new e(`Zoho, modulo ${n.modulo}: more_records senza next_page_token`,{stage:t,details:{modulo:n.modulo}});if(e$1.has(i))throw new e(`Zoho, modulo ${n.modulo}: next_page_token ripetuto, la lettura girerebbe in tondo`,{stage:t,details:{modulo:n.modulo}});return i}a(oe,"prossimoToken");var ee=/^[A-Za-z][A-Za-z0-9_]*$/,ne=z.object({fields:z.array(z.object({api_name:z.string(),data_type:z.string().optional()}).passthrough())});function G(o,e,n,t){if(!Number.isInteger(n)||n<1||n>t)throw new g(`zohoCrmRecords "${o}": ${e} deve essere un intero fra 1 e ${t}`);return n}a(G,"interoFra");function te(o,e,n){return e.lettura==="coql"?{lettura:"coql",perQuery:G(o,"perQuery",e.perQuery??E,E)}:{lettura:"records",fields:Io(n),perPagina:G(o,"perPagina",e.perPagina??b,b),maxPerInterrogazione:G(o,"maxPerInterrogazione",e.maxPerInterrogazione??I,I)}}a(te,"letturaScelta");function re(o){let e=o.name??`zoho:${o.modulo}`;if(!ee.test(o.modulo))throw new g(`zohoCrmRecords "${e}": "${o.modulo}" non \xE8 un nome API di modulo valido`);let n=o.lettura??"records",t=po(`zohoCrmRecords "${e}"`,o.campi,n),i={modulo:o.modulo,campi:t,colonne:R(t)},a$2=te(e,o,t),l={config:o.config,token:o.token,retry:Z$1({...X,...o.retry},e),stage:e,...o.fetchImpl!==void 0?{fetchImpl:o.fetchImpl}:{}};return {name:e,columns:ho(t),descriptor:{kind:"zoho-source",...a$1(o.instanceId),details:Zo(o.config,[{label:"modulo",value:o.modulo},{label:"lettura",value:n==="coql"?"COQL, per id crescente":"Records API, per id"},{label:"campi",value:t.map(s=>s.nome).join(", ")}])},extract:a(s=>ae(l,i,a$2,s),"extract")}}a(re,"zohoCrmRecords");async function ie(o,e,n){let{fields:t}=await _(o,{descrizione:`catalogo dei campi del modulo ${e.modulo}`,path:"/settings/fields",query:{module:e.modulo},schema:ne},n),i=new Map(t.map(l=>[l.api_name,l.data_type])),a=e.campi.map(l=>l.nome).filter(l=>!i.has(l));if(a.length>0)throw new g(`zohoCrmRecords "${o.stage}": il modulo ${e.modulo} non ha pi\xF9 ${a.length===1?"il campo":"i campi"} ${a.join(", ")}. Togli${a.length===1?"lo":"li"} dalla pipeline con una versione nuova`);for(let l of e.campi){let s=i.get(l.nome);s!==void 0&&s!==l.tipo&&n.logger.warn("zoho-source.tipo-cambiato",{stage:o.stage,modulo:e.modulo,campo:l.nome,dichiarato:l.tipo,zoho:s});}}a(ie,"controllaCatalogo");async function*ae(o,e,n,t){await ie(o,e,t);let i=_o();n.lettura==="coql"?yield*Ao(o,{...e,...n},t,i):yield*bo(o,{...e,...n},t,i),t.logger.info("zoho-source.lettura",{stage:o.stage,modulo:e.modulo,lettura:n.lettura,chiamate:i.chiamate,record:i.visti.size,duplicati:i.duplicati});}a(ae,"leggiTutti");
|
|
2
2
|
export{c as CAMPO_ID,y as CAMPO_MODIFICA,M as DEFAULT_ZOHO_MAX_RESPONSE_BYTES,X as DEFAULT_ZOHO_RETRY,$ as DEFAULT_ZOHO_TIMEOUT_MS,D as MANIFEST_ZOHO,L as MAX_CAMPI_COQL,T as MAX_CAMPI_DICHIARATI,N as MAX_CAMPI_PER_CHIAMATA,I as MAX_ZOHO_PER_INTERROGAZIONE,b as MAX_ZOHO_PER_PAGINA,E as MAX_ZOHO_PER_QUERY,uo as SUFFISSO_NOME,mo as colonnaZoho,R as colonneZoho,Ro as dettaglioCredenzialeZoho,Z as eCampoUtente,Qo as istanzaZohoPerIlPiano,Q as loadZohoConfig,V as loadZohoInstance,qo as loadZohoRegistry,So as maxCampiDi,To as nomiColonneZoho,vo as schemaRecordZoho,H as tipoColonnaZoho,B as trasportoZoho,F as valoreZoho,re as zohoCrmRecords};
|
package/dist/contract.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { G as GraphNodeKind,
|
|
2
|
-
export {
|
|
1
|
+
import { G as GraphNodeKind, k as SkippedBy, N as NodeCounts, l as GraphRunReport, m as GraphRunStatus } from './errors-CRq1uNYZ.js';
|
|
2
|
+
export { n as CaughtErrorSummary, h as ConnectorConnectionRef, g as ConnectorDescriptor, f as ConnectorDetail, D as DepKind, E as EdgeReport, o as GraphRunError, p as InstanceDep, q as InstanceOutput, r as InstanceSummary, s as LoadVersions, t as NodeReport, O as OrigineValore, u as PlanInstance, v as RunInstance, w as SourceStateReport, x as StateCommitRejection, y as StateOrigin, z as StateSkipReason } from './errors-CRq1uNYZ.js';
|
|
3
3
|
import 'zod';
|
|
4
4
|
|
|
5
5
|
/**
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { V as VariabileRisolta, R as RisoluzioneVariabili, O as Obbligatorieta, c as VariantiManifest } from './manifest-variabili-
|
|
1
|
+
import { f as ConnectorDetail } from './errors-CRq1uNYZ.js';
|
|
2
|
+
import { V as VariabileRisolta, R as RisoluzioneVariabili, O as Obbligatorieta, c as VariantiManifest } from './manifest-variabili-DRWUzmxU.js';
|
|
3
3
|
|
|
4
4
|
/** Legge una variabile `<prefix><key>`; stringa vuota vale assente. */
|
|
5
5
|
type LetturaEnv = (key: string) => string | undefined;
|
|
@@ -436,6 +436,13 @@ interface Sink<T> {
|
|
|
436
436
|
readonly held?: (ctx: RunContext) => number;
|
|
437
437
|
/** Descrizione non sensibile per la UI del DAG. Opzionale per retrocompatibilità. */
|
|
438
438
|
readonly descriptor?: ConnectorDescriptor;
|
|
439
|
+
/**
|
|
440
|
+
* Chiave opaca della risorsa che il sink scrive **da solo** (un workbook, un
|
|
441
|
+
* file riscritto per intero). Due sink dello stesso grafo con la stessa chiave
|
|
442
|
+
* fanno fallire `build()`: scriverebbero sulla stessa risorsa uno dopo l'altro,
|
|
443
|
+
* e il secondo perderebbe o sovrascriverebbe il lavoro del primo.
|
|
444
|
+
*/
|
|
445
|
+
readonly exclusiveTarget?: string;
|
|
439
446
|
/**
|
|
440
447
|
* Colonne note caricate da questo sink, per la UI del DAG. Dichiarate
|
|
441
448
|
* esplicitamente quando il sink non ha uno schema Zod introspezionabile a
|
|
@@ -3319,4 +3326,4 @@ declare function withDerivedFrom<E extends EtlError>(error: E, derivedFrom: read
|
|
|
3319
3326
|
*/
|
|
3320
3327
|
declare function withDetails<E extends EtlError>(error: E, details: Readonly<Record<string, unknown>>): E;
|
|
3321
3328
|
|
|
3322
|
-
export { type UnionBuilderConfig as $, type Action as A, type
|
|
3329
|
+
export { type UnionBuilderConfig as $, type Action as A, type GraphEdge as B, ConfigError as C, type DepKind as D, type EdgeReport as E, type RouteGraphNode as F, type GraphNodeKind as G, type ParamsSchema as H, type IncrementalExtract as I, type NoParams as J, type DepSlots as K, type LookupResolver as L, type NoDeps as M, type NodeCounts as N, type OrigineValore as O, type PlanVariable as P, type NodeReportOptions as Q, type RateLimiter as R, type Source as S, type Task as T, type EdgeFromPortOptions as U, type NodePurposeOptions as V, type WriteReportFn as W, type NodeLineageOptions as X, type LookupConfig as Y, type ActionTransformOptions as Z, type JoinBuilderConfig as _, type Sink as a, LoadError as a$, type InstanceArgsRest as a0, type InstanceBuildArgs as a1, type GivenInstanceArgs as a2, type DeadLetter as a3, type GraphNode as a4, type GraphOptions as a5, type ControlEdge as a6, type GraphParts as a7, type NodeDeadLetterOptions as a8, type ControlAfterOptions as a9, DEFAULT_LOOKUP_BATCH_SIZE as aA, DEFAULT_LOOKUP_CACHE_LIMIT as aB, DEFAULT_RETRY_POLICY as aC, DEFAULT_SNAPSHOT_LIMIT as aD, DEFAULT_SNAPSHOT_OVERFLOW as aE, DEFAULT_STATEFUL_LINEAGE as aF, DEFAULT_TRACE_MAX_ERRORS as aG, DEFAULT_TRACE_MAX_RECORDS as aH, DEFAULT_TRACE_PER_SOURCE as aI, DEFAULT_TRY_CATCH_MODE as aJ, DEFAULT_UNION_ORDER as aK, type DepSlot as aL, type DepsOf as aM, type ErrorRecord as aN, type EtlErrorContext as aO, type Expansion as aP, ExtractError as aQ, type FlatMapTransformOptions as aR, GRAPH_REPORT_SCHEMA_VERSION as aS, GraphRunFailure as aT, GraphValidationError as aU, INPUT as aV, INSTANCE_SEPARATOR as aW, type InstanceArgs as aX, type InstanceMember as aY, JoinError as aZ, type JoinGraphNode as a_, type TaskPolicyOptions as aa, type SinkPolicyOptions as ab, type TryCatchOptions as ac, type GraphSpec as ad, type PlanSpec as ae, type ProgressClock as af, type PlanColumn as ag, type GraphInstance as ah, type InstanceParamsAndDeps as ai, EtlError as aj, type EmitMode as ak, ActionError as al, type ActionGraphNode as am, type AiGraphNode as an, AssertionError as ao, CAUGHT_ERROR_MESSAGE_MAX_LEN as ap, CAUGHT_ERROR_RAW_MAX_LEN as aq, type CallPolicy as ar, type CollectingSink as as, type CommitOn as at, type ConfigErrorOptions as au, ConsoleLogger as av, type ConsoleLoggerOptions as aw, type CreateRunContextOptions as ax, DEAD_LETTER_PURPOSE as ay, DEFAULT_CAUGHT_ERRORS_LIMIT as az, type Transform as b, arraySink as b$, type LoadResult as b0, type LogLevel as b1, type Logger as b2, LookupError as b3, type LookupGraphNode as b4, type LookupNotFound as b5, type LookupReport as b6, type LookupStats as b7, type LookupTransform as b8, type MapTransformOptions as b9, type SnapshotOverflow as bA, type SourceGraphNode as bB, type StateCommitEntry as bC, type StateCommitResult as bD, type StatefulLineage as bE, TRACE_VALUE_MAX_LEN as bF, type TaggedRecord as bG, TaskError as bH, type TaskGraphNode as bI, type TaskPolicy as bJ, type TraceSample as bK, type TraceStep as bL, type TracedRecord as bM, type Trail as bN, type TrailStep as bO, type TransformGraphNode as bP, type TransformLikeGraphNode as bQ, type TryCatchGraphNode as bR, type TryCatchMode as bS, type UnionFrom as bT, type UnionGraphNode as bU, type UnionInput as bV, type UnionOrder as bW, ValidationError as bX, type WithRetryOptions as bY, actionDep as bZ, actionTransform as b_, Metrics as ba, type NodeExit as bb, type NodeProgressUpdate as bc, type NodeReportStats as bd, type NodeStartUpdate as be, PROGRESS_INTERVAL_MS as bf, PURPOSE_MAX_LENGTH as bg, PipelineStateError as bh, type PipelineStateKey as bi, type PipelineStateStore as bj, type PlanEdge as bk, type PlanNode as bl, type PlanStepType as bm, type PolicyCaller as bn, type ProgressReporter as bo, RUN_PARAM_TYPES as bp, RUN_TRACE_SCHEMA_VERSION as bq, type ResolvedRetryPolicy as br, type RetryInfo as bs, type RunParam as bt, type RunParamType as bu, type RunProgressUpdate as bv, type RunTrace as bw, RunTracer as bx, type RunTracerOptions as by, type SinkGraphNode as bz, type RunContext as c, arraySource as c0, assertRateLimit as c1, assertRunParams as c2, assertSourceWatermark as c3, attachGraphRunReport as c4, backoffDelay as c5, buildFailedGraphReport as c6, childInstances as c7, collectAncestors as c8, compareWatermarks as c9, tagDerived as cA, tagSource as cB, toCaughtErrorSummary as cC, topologicalSort as cD, unionInputKey as cE, unionStreams as cF, validate as cG, validateGraph as cH, validateRunParamDeclarations as cI, watermarkOrdinal as cJ, withBranch as cK, withDerivedFrom as cL, withDetails as cM, withNodeId as cN, withRecordId as cO, withRetry as cP, concatStreams as ca, createRateLimiter as cb, createRunContext as cc, createRunTracer as cd, filterTransform as ce, flatMapTransform as cf, graphRunReportOf as cg, interleaveStreams as ch, isIsolableSink as ci, isTransformLike as cj, isTransient as ck, lookupDep as cl, lookupTransform as cm, makeRecordId as cn, mapTransform as co, maxWatermark as cp, orderedUnionEdges as cq, policyCaller as cr, resolveRetryPolicy as cs, resolveTaskPolicy as ct, rootInstanceOf as cu, runGraph as cv, runParamProblems as cw, serializeRawForReport as cx, sleep as cy, subtractLookback as cz, type RateLimit as d, type RetryPolicy as e, type ConnectorDetail as f, type ConnectorDescriptor as g, type ConnectorConnectionRef as h, type SourceWatermark as i, type WatermarkType as j, type SkippedBy as k, type GraphRunReport as l, type GraphRunStatus as m, type CaughtErrorSummary as n, type GraphRunError as o, type InstanceDep as p, type InstanceOutput as q, type InstanceSummary as r, type LoadVersions as s, type NodeReport as t, type PlanInstance as u, type RunInstance as v, type SourceStateReport as w, type StateCommitRejection as x, type StateOrigin as y, type StateSkipReason as z };
|
package/dist/etl.config.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {a as a$2}from'./chunk-
|
|
1
|
+
import {a as a$2}from'./chunk-KEFIGSRS.js';import'./chunk-5XVANFXO.js';import {f,t,x,u}from'./chunk-ZKDCUSM2.js';import {d as d$2,e as e$2}from'./chunk-GZWYRO3V.js';import'./chunk-FBSNZG34.js';import {e as e$1,d as d$1,l,m,b as b$2,g}from'./chunk-L25W2QNS.js';import'./chunk-UHGHK6NP.js';import {L,b as b$1,a as a$1,h,f as f$1,i,H,I as I$2,J,K as K$1}from'./chunk-672L5BGQ.js';import {d}from'./chunk-DHQ3YOPX.js';import'./chunk-IODXIHU2.js';import'./chunk-VVXT66DC.js';import'./chunk-6QVYBDIS.js';import'./chunk-VL7DZWWO.js';import {Z,Q,S as S$1,T as T$1}from'./chunk-47NVGHUY.js';import {a,M as M$1,L as L$1,Hb,I as I$1,Fb,V as V$1,e,S as S$2,U as U$1}from'./chunk-CEAMQIRO.js';function T(e){return {name:e,descriptor:{kind:"report",details:[{label:"report",value:"record andati in errore (conteggio)"}]},async load(i,r){let n=0;for await(let a of i)n+=1;return r.logger.info("crm-leads-sync.error-report",{erroredRecords:n}),{written:n}}}}a(T,"errorCountReportSink");var me=L.object({id:L.string().uuid(),workspace_id:L.string().uuid(),name:L.string(),email:L.string().nullable(),phone:L.string().nullable(),company:L.string().nullable(),status:L.string(),source:L.string().nullable(),notes:L.string().nullable(),assigned_to:L.string().uuid().nullable(),estimated_value:L.string().nullable(),created_by:L.string().uuid(),created_at:L.date(),updated_at:L.date(),company_id:L.string().uuid().nullable(),social_profiles:L.string()}),ue=["id","workspace_id","name","email","phone","company","status","source","notes","assigned_to","estimated_value","created_by","created_at","updated_at","company_id","social_profiles"],ge=[{id:"id",name:"id",dataType:"uuid",isKey:true},{id:"workspace_id",name:"workspace_id",dataType:"uuid",isKey:false},{id:"name",name:"name",dataType:"text",isKey:false},{id:"email",name:"email",dataType:"text",isKey:false},{id:"phone",name:"phone",dataType:"text",isKey:false},{id:"company",name:"company",dataType:"text",isKey:false},{id:"status",name:"status",dataType:"text",isKey:false},{id:"source",name:"source",dataType:"text",isKey:false},{id:"notes",name:"notes",dataType:"text",isKey:false},{id:"assigned_to",name:"assigned_to",dataType:"uuid",isKey:false},{id:"estimated_value",name:"estimated_value",dataType:"numeric",isKey:false},{id:"created_by",name:"created_by",dataType:"uuid",isKey:false},{id:"created_at",name:"created_at",dataType:"timestamptz",isKey:false},{id:"updated_at",name:"updated_at",dataType:"timestamptz",isKey:false},{id:"company_id",name:"company_id",dataType:"uuid",isKey:false},{id:"social_profiles",name:"social_profiles",dataType:"jsonb",isKey:false}];var _="crm-leads-sync";function I(e,i,r){return Fb(_).source("crm_leads",e,{purpose:"Legge dal database di origine un primo gruppo di lead del CRM, sempre gli stessi a ogni run. La copia \xE8 una prova del passaggio di dati fra due database, non un trasferimento completo."}).tryCatch("crm_leads","guard",{purpose:"Protegge la copia lead per lead: un lead che non si riesce a controllare o a salvare finisce fra gli errori, e la run prosegue con gli altri."}).transform("guard","validate",V$1("crm-lead-contract",me),{purpose:"Controlla che ogni lead sia completo e coerente prima di copiarlo. Un lead che non passa il controllo finisce fra gli errori invece di arrivare a destinazione, dove entrano solo lead utilizzabili."}).sink("validate",i,{purpose:"Salva i lead nell'area d'appoggio del database di destinazione, aggiornando quelli gi\xE0 copiati invece di duplicarli. L'area d'appoggio non \xE8 collegata agli altri dati dell'applicazione, cos\xEC la copia non li altera."}).sink("guard",r,{fromPort:"catch",purpose:"Conta i lead che non \xE8 stato possibile copiare e ne riporta il numero nel report, senza salvarli. Dice a colpo d'occhio se la copia \xE8 stata completa."}).build()}a(I,"buildCrmLeadsSyncPipeline");var fe=[{version:1,date:"2026-10-05",tickets:["ETL-120"],added:["Versione iniziale sotto versionamento (ADR-0086)"],changed:[],removed:[]},{version:2,date:"2026-10-06",tickets:["ETL-153"],added:["Host, porta e database delle istanze `source` e `sink`, ognuno con variabile e origine (ADR-0089)","Riga `credenziale` con lo stato della password, mai il valore","L'istanza del registry sta in `connection`, come negli altri connettori"],changed:["Il piano ricade sulla configurazione d'esempio per istanza: un sink incompleto non nasconde il source"],removed:["Il dettaglio `instance`, sostituito da `connection`"]},{version:3,date:"2026-10-09",tickets:["ETL-193","ETL-195"],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)"],removed:[]}];var C="source",S="sink",M="public.crm_leads_import",ye=100,Qe=`
|
|
2
2
|
SELECT
|
|
3
3
|
id::text AS id,
|
|
4
4
|
workspace_id::text AS workspace_id,
|
|
@@ -38,6 +38,6 @@ import {a as a$2}from'./chunk-P6B2KLNJ.js';import'./chunk-NZR6TZ42.js';import {e
|
|
|
38
38
|
company_id uuid,
|
|
39
39
|
social_profiles jsonb NOT NULL
|
|
40
40
|
)
|
|
41
|
-
`;function rr(e){return {name:"crm_leads",columns:ge,descriptor:{kind:"postgres",connection:{id:C},details:X(e,[{label:"table",value:"public.crm_leads"},{label:"limit",value:String(ye)}])},async*extract(){throw new Error("stub di sola topologia: non eseguibile")}}}a(rr,"specSource");function or(e){return {name:"crm_leads_import",descriptor:{kind:"postgres",connection:{id:S},details:X(e,[{label:"table",value:M},{label:"mode",value:"upsert(id)"}])},load(){throw new Error("stub di sola topologia: non eseguibile")}}}a(or,"specSink");var ve={name:_,description:"Copia le prime 100 righe di public.crm_leads (istanza 'source') nella tabella di landing crm_leads_import (istanza 'sink'), upsert idempotente su id",changelog:fe,getSpec(){let e=H({source:g(C,process.env),sink:g(S,process.env)});return I(rr(e.source),or(e.sink),T("error-report")).getSpec()},environment(e){return R$1({pipeline:_,istanze:[b$2(C),b$2(S)]},e)},async run(e){let i=e$1(),r=d$1(i.get(C)),n=d$1(i.get(S));try{await n.query(er);let a=l({pool:r,name:"crm_leads",instanceId:C,query:Qe}),s=m({pool:n,name:"crm_leads_import",instanceId:S,table:M,columns:ue,conflictTarget:["id"]});return await I(a,s,T("error-report")).run(e)}finally{await r.end(),await n.end();}}};var z="NOEVA_MERGE_",ir="test-etl.csv",tr="8793575e-7546-489e-91c9-3004918361fb",U=[{suffisso:"FILE_NAME",default:ir},{suffisso:"SECONDARY_WORKSPACE_ID",default:tr}];function w(e=process.env){let i=O(U,z,e);return {fileName:Q(i,"FILE_NAME"),workspaceB:Q(i,"SECONDARY_WORKSPACE_ID"),variabili:i.variabili}}a(w,"parseConfig");function Ce(e){return {risolta:a(()=>w(e),"risolta"),esempio:a(()=>w(e),"esempio")}}a(Ce,"configCrossWorkspacePerIlPiano");function nr(e){return [...new Set(e.flatMap(i=>Object.keys(i)))]}a(nr,"unionColumns");async function*ar(e){yield*e;}a(ar,"recordsOf");function Se(e){return {name:e,stateful:true,async*apply(i){let r=[];for await(let a of i)r.push(a);if(r.length===0)return;yield*d({columns:nr(r)}).encode(ar(r));}}}a(Se,"encodeCsvWithColumnUnion");function he(e){let i=Object.keys(e).filter(r=>e[r]!=="").sort().map(r=>[r,e[r]]);return JSON.stringify(i)}a(he,"rowKey");var ke="union-workspaces",G="dedup-rows",sr=1e5,R="encode-csv";function W(e,i){let r={writeReport:I$1};return Fb("cross-workspace-csv-merge").source(e.workspaceA.name,e.workspaceA,{...r,purpose:"Legge il file condiviso dal primo workspace. Se l\xEC il file non esiste ancora, il workspace non porta righe e l'unione parte lo stesso."}).source(e.workspaceB.name,e.workspaceB,{...r,purpose:"Legge lo stesso file dal secondo workspace. Se l\xEC il file non esiste ancora, il workspace non porta righe e l'unione parte lo stesso."}).union(ke,{from:[e.workspaceA.name,e.workspaceB.name],order:"concat"},{...r,purpose:"Mette in fila le righe dei due workspace, prima tutte quelle del primo e poi quelle del secondo. L'ordine fisso fa s\xEC che, a dati fermi, ogni run produca lo stesso identico file."}).transform(ke,G,a$1(G,{key:he,maxKeys:sr}),{...r,purpose:"Toglie le righe ripetute, tenendo la prima copia di ognuna. Il risultato torna in tutti e due i workspace: senza questo passo il file raddoppierebbe a ogni run."}).transform(G,R,Se(R),{...r,purpose:"Ricompone le righe in un unico file, con tutte le colonne presenti in almeno uno dei due workspace. Una colonna che un workspace non ha resta vuota nelle sue righe, cos\xEC nessun dato va perso."}).sink(R,i.workspaceA,{...r,purpose:"Salva il file unito come nuova versione nel primo workspace. Se il contenuto \xE8 uguale all'ultima versione, non ne crea un'altra."}).sink(R,i.workspaceB,{...r,purpose:"Salva il file unito come nuova versione nel secondo workspace. Se il contenuto \xE8 uguale all'ultima versione, non ne crea un'altra."}).build()}a(W,"buildCrossWorkspaceCsvMergePipeline");var _e=L.record(L.string(),L.string());var cr=d({unmappedFields:"error",missingFields:"empty"});function K(e,i){return {kind:"noeva-file",details:[...f(e),{label:"fileName",value:i}]}}a(K,"workspaceCsvDescriptor");function B(e$1,i,r){return {name:r.name,descriptor:K({baseUrl:e$1.client.baseUrl,workspaceId:e$1.workspaceId,variabili:e$1.client.variabili,ricaduta:e$1.client.ricaduta},i),async*extract(n){n.signal.throwIfAborted();try{let s=(await e$1.client.searchFilesByName(i)).find(l=>l.name===i);if(s===void 0){n.logger.warn("cross-workspace-merge: file assente nel workspace",{workspaceId:e$1.workspaceId,fileName:i});return}for await(let l of cr.decode(e$1.client.downloadBytes(s.id)))yield _e.parse(l),n.signal.throwIfAborted();}catch(a){throw n.signal.aborted?a:new e(`Lettura di "${i}" dal workspace "${e$1.workspaceId}" fallita`,{stage:r.name,details:{fileName:i}},{cause:a})}}}}a(B,"workspaceCsvSource");var we=[{version:1,date:"2026-10-05",tickets:["ETL-120"],added:["Versione iniziale sotto versionamento (ADR-0086)"],changed:[],removed:[]},{version:2,date:"2026-10-06",tickets:["ETL-152"],added:["Variabile e origine su ogni riga dei nodi Noeva: base URL, workspace A, file e workspace B, che col default compare con origine `default` (ADR-0089)","Riga `credenziale` sui nodi Noeva, con lo stato della chiave API e mai il valore","Configurazione della pipeline nel piano: le variabili `NOEVA_MERGE_*` con valore e origine"],changed:["Senza `.env` i nodi mostrano un client Noeva d'esempio con le variabili mancanti marcate, invece di omettere base URL e workspace A","Il workspace A \xE8 il primo che l'istanza serve: con `NOEVA_WORKSPACE_IDS` impostata, `NOEVA_WORKSPACE_ID` non conta pi\xF9"],removed:[]},{version:3,date:"2026-10-09",tickets:["ETL-193","ETL-195"],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)"],removed:[]}];var Re="cross-workspace-csv-merge",be="read-workspace-a",Ee="read-workspace-b",Ae="workspace-a",Pe="workspace-b",F="new-version",Le={fileName:"FILE_NAME"},Oe={fileName:"FILE_NAME",workspace:"SECONDARY_WORKSPACE_ID"},lr=[{id:"id",name:"id",dataType:"string",isKey:true},{id:"val",name:"val",dataType:"string",isKey:false}];function xe(e,i,r){return {name:e,columns:lr,descriptor:K(i,r),async*extract(){throw new Error("stub di sola topologia: non eseguibile")}}}a(xe,"specSource");function De(e,i,r){return {name:e,descriptor:t(i,{fileName:r,mode:F}),async load(){throw new Error("stub di sola topologia: non eseguibile")}}}a(De,"specSink");var Ne={name:Re,description:"Demo cross-workspace: unisce test-etl.csv da due workspace e lo riscrive (new-version) su entrambi",changelog:we,environment(e){return R$1({pipeline:Re,configurazione:{prefisso:z,manifest:U}},e)},getSpec(){let e=process.env,i=H({config:Ce(e),noeva:e$2(e)}),{config:r}=i,n={baseUrl:i.noeva.baseUrl,workspaceId:i.noeva.workspaceId,...i.noeva.variabili!==void 0?{variabili:i.noeva.variabili}:{},...i.noeva.ricaduta!==void 0?{ricaduta:i.noeva.ricaduta}:{}},a={...n,workspaceId:r.workspaceB},s={workspaceA:J(xe(be,n,r.fileName),r,Le),workspaceB:J(xe(Ee,a,r.fileName),r,Oe)},l={workspaceA:J(De(Ae,n,r.fileName),r,Le),workspaceB:J(De(Pe,a,r.fileName),r,Oe)};return K$1(W(s,l).getSpec(),r)},async run(e){let i=process.env,r=I$2({config:a(()=>w(i),"config"),workspaces:a(()=>d$2(i),"workspaces")}),n=r.config,a$1=x(r.workspaces),[s]=a$1.workspaceIds;if(s===void 0)throw new Error("nessun workspace Noeva risolto");let l=n.workspaceB,f=a$1.client(s),j=a$1.client(l),Je={workspaceA:B({workspaceId:s,client:f},n.fileName,{name:be}),workspaceB:B({workspaceId:l,client:j},n.fileName,{name:Ee})},Xe={workspaceA:u(f,{fileName:n.fileName,mode:F,name:Ae}),workspaceB:u(j,{fileName:n.fileName,mode:F,name:Pe})};return W(Je,Xe).run(e)}};var Te=[{version:1,date:"2026-10-18",tickets:["ETL-206"],added:["Versione iniziale: esempio di riferimento per `parse`, `sort` e `serialize`, su estratti conto di prova in memoria"],changed:[],removed:[]}];var Ie=L.object({file:L.string().min(1),riga:L.number().int().positive(),conto:L.string().min(1),data:L.string().regex(/^\d{4}-\d{2}-\d{2}$/,"data in formato AAAA-MM-GG"),descrizione:L.string(),importo:L.coerce.number().finite()}),Me=L.object({nome:L.string().min(1),conto:L.string().min(1),movimenti:L.number().int().positive(),bytes:L.custom(e=>e instanceof Uint8Array)});var ze=1e5,Ue={delimiter:";"},pr=new TextEncoder,dr=a(e=>({conto:e.conto,data:e.data,descrizione:e.descrizione,importo:e.importo.toFixed(2)}),"rigaDiUscita");function Ge(e,i$1,r={}){let n=I$1,a$1=r.scarti?{deadLetter:r.scarti}:{};return Fb("movimenti-per-conto").source("estratti",e,{writeReport:n,purpose:"Legge gli estratti conto di prova della dimostrazione, ognuno un file CSV con i movimenti di pi\xF9 conti."}).transform("estratti","righe",h("righe",d(Ue),{bytes:a(s=>pr.encode(s.contenuto),"bytes"),fileName:a(s=>s.nome,"fileName"),merge:a((s,l,f)=>({...s,file:l.nome,riga:f}),"merge")}),{writeReport:n,...a$1,purpose:"Apre ogni estratto e ne ricava i movimenti, uno per riga, ricordando da quale file e da quale riga viene ciascuno. Un file che non si legge finisce per intero fra gli scarti."}).transform("righe","movimenti",V$1("movimenti",Ie),{writeReport:n,...a$1,purpose:"Controlla che ogni movimento abbia conto, data e importo validi. Un movimento fuori regola finisce fra gli scarti, e gli altri proseguono."}).transform("movimenti","ordina",f$1("ordina",{by:[{key:a(s=>s.conto,"key")},{key:a(s=>s.data,"key")}],maxRecords:ze}),{writeReport:n,purpose:"Mette i movimenti in ordine di conto e, per ogni conto, di data, cos\xEC ogni file per conto li elenca dal pi\xF9 vecchio."}).transform("ordina","componi-file",i("componi-file",d(Ue),{groupBy:a(s=>s.conto,"groupBy"),row:dr,toOutput:a((s,l,f)=>({nome:`movimenti-${s}.csv`,conto:s,movimenti:f.length,bytes:l}),"toOutput"),maxRecords:ze,outputSchema:Me}),{writeReport:n,purpose:"Scrive un file CSV per conto, con i suoi movimenti in ordine e gli importi con due decimali."}).sink("componi-file",i$1.file,{writeReport:n,purpose:"Consegna i file per conto, uno per ciascun conto che compare negli estratti."}).build()}a(Ge,"buildMovimentiPerContoPipeline");var We="conto;data;descrizione;importo",mr=[{nome:"estratto-luglio-a.csv",contenuto:[We,"IT02;2026-07-03;Bonifico in uscita;-40.00","IT01;2026-07-02;Stipendio;1500","IT01;2026-07-05;Spesa;-82.40"].join(`
|
|
41
|
+
`;function rr(e){return {name:"crm_leads",columns:ge,descriptor:{kind:"postgres",connection:{id:C},details:Z(e,[{label:"table",value:"public.crm_leads"},{label:"limit",value:String(ye)}])},async*extract(){throw new Error("stub di sola topologia: non eseguibile")}}}a(rr,"specSource");function or(e){return {name:"crm_leads_import",descriptor:{kind:"postgres",connection:{id:S},details:Z(e,[{label:"table",value:M},{label:"mode",value:"upsert(id)"}])},load(){throw new Error("stub di sola topologia: non eseguibile")}}}a(or,"specSink");var ve={name:_,description:"Copia le prime 100 righe di public.crm_leads (istanza 'source') nella tabella di landing crm_leads_import (istanza 'sink'), upsert idempotente su id",changelog:fe,getSpec(){let e=H({source:g(C,process.env),sink:g(S,process.env)});return I(rr(e.source),or(e.sink),T("error-report")).getSpec()},environment(e){return T$1({pipeline:_,istanze:[b$2(C),b$2(S)]},e)},async run(e){let i=e$1(),r=d$1(i.get(C)),n=d$1(i.get(S));try{await n.query(er);let a=l({pool:r,name:"crm_leads",instanceId:C,query:Qe}),s=m({pool:n,name:"crm_leads_import",instanceId:S,table:M,columns:ue,conflictTarget:["id"]});return await I(a,s,T("error-report")).run(e)}finally{await r.end(),await n.end();}}};var z="NOEVA_MERGE_",ir="test-etl.csv",tr="8793575e-7546-489e-91c9-3004918361fb",U=[{suffisso:"FILE_NAME",default:ir},{suffisso:"SECONDARY_WORKSPACE_ID",default:tr}];function w(e=process.env){let i=Q(U,z,e);return {fileName:S$1(i,"FILE_NAME"),workspaceB:S$1(i,"SECONDARY_WORKSPACE_ID"),variabili:i.variabili}}a(w,"parseConfig");function Ce(e){return {risolta:a(()=>w(e),"risolta"),esempio:a(()=>w(e),"esempio")}}a(Ce,"configCrossWorkspacePerIlPiano");function nr(e){return [...new Set(e.flatMap(i=>Object.keys(i)))]}a(nr,"unionColumns");async function*ar(e){yield*e;}a(ar,"recordsOf");function Se(e){return {name:e,stateful:true,async*apply(i){let r=[];for await(let a of i)r.push(a);if(r.length===0)return;yield*d({columns:nr(r)}).encode(ar(r));}}}a(Se,"encodeCsvWithColumnUnion");function he(e){let i=Object.keys(e).filter(r=>e[r]!=="").sort().map(r=>[r,e[r]]);return JSON.stringify(i)}a(he,"rowKey");var ke="union-workspaces",G="dedup-rows",sr=1e5,R="encode-csv";function W(e,i){let r={writeReport:I$1};return Fb("cross-workspace-csv-merge").source(e.workspaceA.name,e.workspaceA,{...r,purpose:"Legge il file condiviso dal primo workspace. Se l\xEC il file non esiste ancora, il workspace non porta righe e l'unione parte lo stesso."}).source(e.workspaceB.name,e.workspaceB,{...r,purpose:"Legge lo stesso file dal secondo workspace. Se l\xEC il file non esiste ancora, il workspace non porta righe e l'unione parte lo stesso."}).union(ke,{from:[e.workspaceA.name,e.workspaceB.name],order:"concat"},{...r,purpose:"Mette in fila le righe dei due workspace, prima tutte quelle del primo e poi quelle del secondo. L'ordine fisso fa s\xEC che, a dati fermi, ogni run produca lo stesso identico file."}).transform(ke,G,a$1(G,{key:he,maxKeys:sr}),{...r,purpose:"Toglie le righe ripetute, tenendo la prima copia di ognuna. Il risultato torna in tutti e due i workspace: senza questo passo il file raddoppierebbe a ogni run."}).transform(G,R,Se(R),{...r,purpose:"Ricompone le righe in un unico file, con tutte le colonne presenti in almeno uno dei due workspace. Una colonna che un workspace non ha resta vuota nelle sue righe, cos\xEC nessun dato va perso."}).sink(R,i.workspaceA,{...r,purpose:"Salva il file unito come nuova versione nel primo workspace. Se il contenuto \xE8 uguale all'ultima versione, non ne crea un'altra."}).sink(R,i.workspaceB,{...r,purpose:"Salva il file unito come nuova versione nel secondo workspace. Se il contenuto \xE8 uguale all'ultima versione, non ne crea un'altra."}).build()}a(W,"buildCrossWorkspaceCsvMergePipeline");var _e=L.record(L.string(),L.string());var cr=d({unmappedFields:"error",missingFields:"empty"});function K(e,i){return {kind:"noeva-file",details:[...f(e),{label:"fileName",value:i}]}}a(K,"workspaceCsvDescriptor");function B(e$1,i,r){return {name:r.name,descriptor:K({baseUrl:e$1.client.baseUrl,workspaceId:e$1.workspaceId,variabili:e$1.client.variabili,ricaduta:e$1.client.ricaduta},i),async*extract(n){n.signal.throwIfAborted();try{let s=(await e$1.client.searchFilesByName(i)).find(l=>l.name===i);if(s===void 0){n.logger.warn("cross-workspace-merge: file assente nel workspace",{workspaceId:e$1.workspaceId,fileName:i});return}for await(let l of cr.decode(e$1.client.downloadBytes(s.id)))yield _e.parse(l),n.signal.throwIfAborted();}catch(a){throw n.signal.aborted?a:new e(`Lettura di "${i}" dal workspace "${e$1.workspaceId}" fallita`,{stage:r.name,details:{fileName:i}},{cause:a})}}}}a(B,"workspaceCsvSource");var we=[{version:1,date:"2026-10-05",tickets:["ETL-120"],added:["Versione iniziale sotto versionamento (ADR-0086)"],changed:[],removed:[]},{version:2,date:"2026-10-06",tickets:["ETL-152"],added:["Variabile e origine su ogni riga dei nodi Noeva: base URL, workspace A, file e workspace B, che col default compare con origine `default` (ADR-0089)","Riga `credenziale` sui nodi Noeva, con lo stato della chiave API e mai il valore","Configurazione della pipeline nel piano: le variabili `NOEVA_MERGE_*` con valore e origine"],changed:["Senza `.env` i nodi mostrano un client Noeva d'esempio con le variabili mancanti marcate, invece di omettere base URL e workspace A","Il workspace A \xE8 il primo che l'istanza serve: con `NOEVA_WORKSPACE_IDS` impostata, `NOEVA_WORKSPACE_ID` non conta pi\xF9"],removed:[]},{version:3,date:"2026-10-09",tickets:["ETL-193","ETL-195"],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)"],removed:[]}];var Re="cross-workspace-csv-merge",be="read-workspace-a",Ee="read-workspace-b",Ae="workspace-a",Pe="workspace-b",F="new-version",Le={fileName:"FILE_NAME"},Oe={fileName:"FILE_NAME",workspace:"SECONDARY_WORKSPACE_ID"},lr=[{id:"id",name:"id",dataType:"string",isKey:true},{id:"val",name:"val",dataType:"string",isKey:false}];function xe(e,i,r){return {name:e,columns:lr,descriptor:K(i,r),async*extract(){throw new Error("stub di sola topologia: non eseguibile")}}}a(xe,"specSource");function De(e,i,r){return {name:e,descriptor:t(i,{fileName:r,mode:F}),async load(){throw new Error("stub di sola topologia: non eseguibile")}}}a(De,"specSink");var Ne={name:Re,description:"Demo cross-workspace: unisce test-etl.csv da due workspace e lo riscrive (new-version) su entrambi",changelog:we,environment(e){return T$1({pipeline:Re,configurazione:{prefisso:z,manifest:U}},e)},getSpec(){let e=process.env,i=H({config:Ce(e),noeva:e$2(e)}),{config:r}=i,n={baseUrl:i.noeva.baseUrl,workspaceId:i.noeva.workspaceId,...i.noeva.variabili!==void 0?{variabili:i.noeva.variabili}:{},...i.noeva.ricaduta!==void 0?{ricaduta:i.noeva.ricaduta}:{}},a={...n,workspaceId:r.workspaceB},s={workspaceA:J(xe(be,n,r.fileName),r,Le),workspaceB:J(xe(Ee,a,r.fileName),r,Oe)},l={workspaceA:J(De(Ae,n,r.fileName),r,Le),workspaceB:J(De(Pe,a,r.fileName),r,Oe)};return K$1(W(s,l).getSpec(),r)},async run(e){let i=process.env,r=I$2({config:a(()=>w(i),"config"),workspaces:a(()=>d$2(i),"workspaces")}),n=r.config,a$1=x(r.workspaces),[s]=a$1.workspaceIds;if(s===void 0)throw new Error("nessun workspace Noeva risolto");let l=n.workspaceB,f=a$1.client(s),j=a$1.client(l),Je={workspaceA:B({workspaceId:s,client:f},n.fileName,{name:be}),workspaceB:B({workspaceId:l,client:j},n.fileName,{name:Ee})},Xe={workspaceA:u(f,{fileName:n.fileName,mode:F,name:Ae}),workspaceB:u(j,{fileName:n.fileName,mode:F,name:Pe})};return W(Je,Xe).run(e)}};var Te=[{version:1,date:"2026-10-18",tickets:["ETL-206"],added:["Versione iniziale: esempio di riferimento per `parse`, `sort` e `serialize`, su estratti conto di prova in memoria"],changed:[],removed:[]}];var Ie=L.object({file:L.string().min(1),riga:L.number().int().positive(),conto:L.string().min(1),data:L.string().regex(/^\d{4}-\d{2}-\d{2}$/,"data in formato AAAA-MM-GG"),descrizione:L.string(),importo:L.coerce.number().finite()}),Me=L.object({nome:L.string().min(1),conto:L.string().min(1),movimenti:L.number().int().positive(),bytes:L.custom(e=>e instanceof Uint8Array)});var ze=1e5,Ue={delimiter:";"},pr=new TextEncoder,dr=a(e=>({conto:e.conto,data:e.data,descrizione:e.descrizione,importo:e.importo.toFixed(2)}),"rigaDiUscita");function Ge(e,i$1,r={}){let n=I$1,a$1=r.scarti?{deadLetter:r.scarti}:{};return Fb("movimenti-per-conto").source("estratti",e,{writeReport:n,purpose:"Legge gli estratti conto di prova della dimostrazione, ognuno un file CSV con i movimenti di pi\xF9 conti."}).transform("estratti","righe",h("righe",d(Ue),{bytes:a(s=>pr.encode(s.contenuto),"bytes"),fileName:a(s=>s.nome,"fileName"),merge:a((s,l,f)=>({...s,file:l.nome,riga:f}),"merge")}),{writeReport:n,...a$1,purpose:"Apre ogni estratto e ne ricava i movimenti, uno per riga, ricordando da quale file e da quale riga viene ciascuno. Un file che non si legge finisce per intero fra gli scarti."}).transform("righe","movimenti",V$1("movimenti",Ie),{writeReport:n,...a$1,purpose:"Controlla che ogni movimento abbia conto, data e importo validi. Un movimento fuori regola finisce fra gli scarti, e gli altri proseguono."}).transform("movimenti","ordina",f$1("ordina",{by:[{key:a(s=>s.conto,"key")},{key:a(s=>s.data,"key")}],maxRecords:ze}),{writeReport:n,purpose:"Mette i movimenti in ordine di conto e, per ogni conto, di data, cos\xEC ogni file per conto li elenca dal pi\xF9 vecchio."}).transform("ordina","componi-file",i("componi-file",d(Ue),{groupBy:a(s=>s.conto,"groupBy"),row:dr,toOutput:a((s,l,f)=>({nome:`movimenti-${s}.csv`,conto:s,movimenti:f.length,bytes:l}),"toOutput"),maxRecords:ze,outputSchema:Me}),{writeReport:n,purpose:"Scrive un file CSV per conto, con i suoi movimenti in ordine e gli importi con due decimali."}).sink("componi-file",i$1.file,{writeReport:n,purpose:"Consegna i file per conto, uno per ciascun conto che compare negli estratti."}).build()}a(Ge,"buildMovimentiPerContoPipeline");var We="conto;data;descrizione;importo",mr=[{nome:"estratto-luglio-a.csv",contenuto:[We,"IT02;2026-07-03;Bonifico in uscita;-40.00","IT01;2026-07-02;Stipendio;1500","IT01;2026-07-05;Spesa;-82.40"].join(`
|
|
42
42
|
`)},{nome:"estratto-luglio-b.csv",contenuto:[We,"IT01;2026-07-01;Affitto;-700","IT02;2026-07-01;Ricarica;20.5","IT02;2026-07-04;Commissione;tre"].join(`
|
|
43
|
-
`)}],Ke=a(()=>Ge(L$1("estratti",mr),{file:M$1("file-per-conto")},{scarti:M$1("scarti")}),"build"),Be={name:"movimenti-per-conto",description:"Esempio di parse, sort e serialize: estratti conto CSV \u2192 un CSV per conto, movimenti in ordine di data (demo in memoria)",changelog:Te,environment(){return []},getSpec(){return Ke().getSpec()},run(e){return Ke().run(e)}};var y=L.object({order_id:L.string(),customer_id:L.string(),customer_name:L.string().nullable(),tier:L.enum(["gold","silver","bronze"]).nullable(),amount:L.number().positive(),created_at:L.date()}),b=L.object({tier:L.string(),order_count:L.number().int().positive(),total_amount:L.number().finite()}),Fe=L.object({tierMancante:L.string().min(1).default("unknown")});var Ve=L.object({order_id:L.string().min(1),customer_id:L.string().min(1),amount:L.number(),created_at:L.coerce.date()}),je=L.object({customer_id:L.string().min(1),name:L.string().min(1),tier:L.enum(["gold","silver","bronze"])});var qe=Hb({name:"riepilogo-ordini",description:"Riepilogo degli ordini arricchiti per tier cliente, con numero di ordini e importo totale, e gli ordini validati come fatti",input:y,outputs:{"per-tier":b,fatti:y},params:Fe,build:a((e,{params:i})=>e.transform("in","tier-summary",b$1("tier-summary",{key:a(r=>r.tier??i.tierMancante,"key"),init:a(r=>({tier:r.tier??i.tierMancante,order_count:1,total_amount:r.amount}),"init"),reduce:a((r,n)=>({...r,order_count:r.order_count+1,total_amount:r.total_amount+n.amount}),"reduce"),outputSchema:b}),{writeReport:I$1,purpose:"Conta gli ordini e somma i loro importi per fascia cliente. Gli ordini senza un cliente noto finiscono in una fascia a parte, cos\xEC nessun ordine resta fuori dai totali."}).output("tier-summary","per-tier").output("in","fatti"),"build")});function V(e,i,r={}){let n=I$1;return Fb("orders-enriched-daily").source("orders",e.orders,{writeReport:n,purpose:"Legge gli ordini di prova della dimostrazione, ognuno con il cliente che l'ha fatto, l'importo e la data."}).source("customers",e.customers,{writeReport:n,purpose:"Legge l'anagrafica di prova dei clienti, con il nome e la fascia di ciascuno, che servono a completare gli ordini."}).transform("orders","validate-orders",V$1("raw-order-contract",Ve),{writeReport:n,purpose:"Controlla che ogni ordine abbia cliente, importo e data validi. Un ordine fuori regola viene messo da parte fra gli scarti, e gli altri proseguono.",...r.ordersDeadLetter?{deadLetter:r.ordersDeadLetter}:{}}).transform("customers","validate-customers",V$1("raw-customer-contract",je),{writeReport:n,purpose:"Controlla che ogni cliente abbia un nome e una fascia ammessa. Un cliente fuori regola ferma la run: gli ordini completati con un'anagrafica sbagliata sarebbero sbagliati anche loro."}).join("enrich",{build:"validate-customers",probe:"validate-orders",how:"left",buildKey:a(a=>a.customer_id,"buildKey"),probeKey:a(a=>a.customer_id,"probeKey"),merge:a((a,s)=>({order_id:s.order_id,customer_id:s.customer_id,customer_name:a?.name??null,tier:a?.tier??null,amount:s.amount,created_at:s.created_at}),"merge")},{writeReport:n,purpose:"Completa ogni ordine con il nome e la fascia del suo cliente. Un ordine il cui cliente non \xE8 in anagrafica prosegue lo stesso, senza nome n\xE9 fascia."}).tryCatch("enrich","guard",{includeRawInReport:true,purpose:"Protegge, ordine per ordine, il riepilogo e il salvataggio: un ordine rifiutato pi\xF9 avanti, come quello con un importo non positivo, finisce fra gli errori e la run prosegue con gli altri."}).pipeline("guard","riepilogo-ordini",qe,{purpose:"Prepara i due risultati della giornata a partire dagli ordini completati: gli ordini controllati, pronti da salvare, e il riepilogo per fascia cliente."}).sink("riepilogo-ordini",i.enrichedOrders,{fromPort:"fatti",writeReport:n,purpose:"Salva gli ordini della giornata completati con i dati del cliente, uno per ordine: \xE8 il dettaglio su cui si appoggia ogni analisi."}).sink("riepilogo-ordini",i.tierSummary,{fromPort:"per-tier",writeReport:n,purpose:"Salva il riepilogo della giornata per fascia cliente, con quanti ordini e quale importo totale per ciascuna."}).transform("guard","log-errors",S$
|
|
43
|
+
`)}],Ke=a(()=>Ge(L$1("estratti",mr),{file:M$1("file-per-conto")},{scarti:M$1("scarti")}),"build"),Be={name:"movimenti-per-conto",description:"Esempio di parse, sort e serialize: estratti conto CSV \u2192 un CSV per conto, movimenti in ordine di data (demo in memoria)",changelog:Te,environment(){return []},getSpec(){return Ke().getSpec()},run(e){return Ke().run(e)}};var y=L.object({order_id:L.string(),customer_id:L.string(),customer_name:L.string().nullable(),tier:L.enum(["gold","silver","bronze"]).nullable(),amount:L.number().positive(),created_at:L.date()}),b=L.object({tier:L.string(),order_count:L.number().int().positive(),total_amount:L.number().finite()}),Fe=L.object({tierMancante:L.string().min(1).default("unknown")});var Ve=L.object({order_id:L.string().min(1),customer_id:L.string().min(1),amount:L.number(),created_at:L.coerce.date()}),je=L.object({customer_id:L.string().min(1),name:L.string().min(1),tier:L.enum(["gold","silver","bronze"])});var qe=Hb({name:"riepilogo-ordini",description:"Riepilogo degli ordini arricchiti per tier cliente, con numero di ordini e importo totale, e gli ordini validati come fatti",input:y,outputs:{"per-tier":b,fatti:y},params:Fe,build:a((e,{params:i})=>e.transform("in","tier-summary",b$1("tier-summary",{key:a(r=>r.tier??i.tierMancante,"key"),init:a(r=>({tier:r.tier??i.tierMancante,order_count:1,total_amount:r.amount}),"init"),reduce:a((r,n)=>({...r,order_count:r.order_count+1,total_amount:r.total_amount+n.amount}),"reduce"),outputSchema:b}),{writeReport:I$1,purpose:"Conta gli ordini e somma i loro importi per fascia cliente. Gli ordini senza un cliente noto finiscono in una fascia a parte, cos\xEC nessun ordine resta fuori dai totali."}).output("tier-summary","per-tier").output("in","fatti"),"build")});function V(e,i,r={}){let n=I$1;return Fb("orders-enriched-daily").source("orders",e.orders,{writeReport:n,purpose:"Legge gli ordini di prova della dimostrazione, ognuno con il cliente che l'ha fatto, l'importo e la data."}).source("customers",e.customers,{writeReport:n,purpose:"Legge l'anagrafica di prova dei clienti, con il nome e la fascia di ciascuno, che servono a completare gli ordini."}).transform("orders","validate-orders",V$1("raw-order-contract",Ve),{writeReport:n,purpose:"Controlla che ogni ordine abbia cliente, importo e data validi. Un ordine fuori regola viene messo da parte fra gli scarti, e gli altri proseguono.",...r.ordersDeadLetter?{deadLetter:r.ordersDeadLetter}:{}}).transform("customers","validate-customers",V$1("raw-customer-contract",je),{writeReport:n,purpose:"Controlla che ogni cliente abbia un nome e una fascia ammessa. Un cliente fuori regola ferma la run: gli ordini completati con un'anagrafica sbagliata sarebbero sbagliati anche loro."}).join("enrich",{build:"validate-customers",probe:"validate-orders",how:"left",buildKey:a(a=>a.customer_id,"buildKey"),probeKey:a(a=>a.customer_id,"probeKey"),merge:a((a,s)=>({order_id:s.order_id,customer_id:s.customer_id,customer_name:a?.name??null,tier:a?.tier??null,amount:s.amount,created_at:s.created_at}),"merge")},{writeReport:n,purpose:"Completa ogni ordine con il nome e la fascia del suo cliente. Un ordine il cui cliente non \xE8 in anagrafica prosegue lo stesso, senza nome n\xE9 fascia."}).tryCatch("enrich","guard",{includeRawInReport:true,purpose:"Protegge, ordine per ordine, il riepilogo e il salvataggio: un ordine rifiutato pi\xF9 avanti, come quello con un importo non positivo, finisce fra gli errori e la run prosegue con gli altri."}).pipeline("guard","riepilogo-ordini",qe,{purpose:"Prepara i due risultati della giornata a partire dagli ordini completati: gli ordini controllati, pronti da salvare, e il riepilogo per fascia cliente."}).sink("riepilogo-ordini",i.enrichedOrders,{fromPort:"fatti",writeReport:n,purpose:"Salva gli ordini della giornata completati con i dati del cliente, uno per ordine: \xE8 il dettaglio su cui si appoggia ogni analisi."}).sink("riepilogo-ordini",i.tierSummary,{fromPort:"per-tier",writeReport:n,purpose:"Salva il riepilogo della giornata per fascia cliente, con quanti ordini e quale importo totale per ciascuna."}).transform("guard","log-errors",S$2("log-errors",(a,s)=>(s.logger.warn("orders-enriched-daily.error-caught",{nodeId:a.error.context.nodeId??null,stage:a.error.context.stage??null,message:a.error.message}),a)),{fromPort:"catch",writeReport:n,purpose:"Registra nel log ogni ordine finito fra gli errori, con il passo in cui l'errore \xE8 nato e il motivo, cos\xEC si capisce che cosa \xE8 andato storto."}).sink("log-errors",r.errorLog??M$1("caught-errors"),{writeReport:n,purpose:"Conserva gli errori registrati, ognuno con l'ordine che l'ha causato, per poterli esaminare dopo la run."}).transform("log-errors","recover-orders",U$1("recover-orders",a=>a.error.context.nodeId===i.enrichedOrders.name&&a.raw!==void 0),{writeReport:n,purpose:"Fra gli errori, tiene solo gli ordini che non si sono potuti salvare: sono gli unici da recuperare. Gli altri errori restano solo nel log."}).transform("recover-orders","restore-order",S$2("restore-order",a=>a.raw,{outputSchema:y}),{writeReport:n,purpose:"Riprende l'ordine com'era prima del salvataggio non riuscito, per poterlo salvare altrove."}).sink("restore-order",r.ordersFallback??M$1("orders-fallback"),{writeReport:n,purpose:"Salva in un archivio di riserva gli ordini che non si sono potuti salvare al loro posto, cos\xEC nessun ordine va perso."}).build()}a(V,"buildOrdersEnrichedDailyPipeline");var He=[{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-85","ETL-87","ETL-88"],added:[],changed:["Contratto del fatto e riepilogo per tier passano nella sub-pipeline `riepilogo-ordini`, istanziata da un nodo `pipeline` (ADR-0079): `fact-contract`, `tier-summary` e `tier-summary-contract` lasciano il posto ai nodi dell'istanza, e i due sink leggono dalle sue uscite `fatti` e `per-tier`","Un ordine con importo non positivo \xE8 rifiutato al confine d'ingresso dell'istanza invece che da `fact-contract`; il `guard` lo cattura e lo instrada sul ramo `catch` come prima"],removed:[]},{version:3,date:"2026-10-09",tickets:["ETL-193","ETL-195"],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)"],removed:[]}];var Ye=[{order_id:"O1",customer_id:"C1",amount:120.5,created_at:"2026-07-01T09:00:00Z"},{order_id:"O2",customer_id:"C2",amount:45,created_at:"2026-07-01T10:15:00Z"},{order_id:"O3",customer_id:"C1",amount:300,created_at:"2026-07-01T11:30:00Z"},{order_id:"O4",customer_id:"C9",amount:15,created_at:"2026-07-01T12:00:00Z"},{order_id:"O5",customer_id:"C2",amount:-10,created_at:"2026-07-01T13:45:00Z"},{order_id:"O6",customer_id:"C1",amount:0,created_at:"2026-07-01T14:10:00Z"},{order_id:"O7",customer_id:"C2",amount:-3.5,created_at:"2026-07-01T14:30:00Z"}],Ze=[{customer_id:"C1",name:"Acme S.p.A.",tier:"gold"},{customer_id:"C2",name:"Beta S.r.l.",tier:"silver"}],$e={name:"orders-enriched-daily",description:"Esempio DAG: ordini + anagrafica clienti \u2192 join a chiave \u2192 fan-out su fatto arricchito e riepilogo per tier",changelog:He,environment(){return []},getSpec(){return V({orders:L$1("orders",Ye),customers:L$1("customers",Ze)},{enrichedOrders:M$1("enriched_orders"),tierSummary:M$1("tier_summary")},{ordersDeadLetter:M$1("orders_dead_letter"),errorLog:M$1("caught_errors")}).getSpec()},async run(e){return V({orders:L$1("orders",Ye),customers:L$1("customers",Ze)},{enrichedOrders:M$1("enriched_orders"),tierSummary:M$1("tier_summary")},{ordersDeadLetter:M$1("orders_dead_letter"),errorLog:M$1("caught_errors")}).run(e)}};var Yo={client:"core",pipelines:[ve,Ne,Be,$e,a$2]};export{Yo as default};
|
package/dist/guida/404.html
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.DFlUbYCk.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.zL1wgTBx.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
14
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
15
15
|
<meta name="theme-color" content="#0a0e15">
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
</head>
|
|
19
19
|
<body>
|
|
20
20
|
<div id="app"></div>
|
|
21
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"DP2i3GFv\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CwG77qGO\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DTIhkkg9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
21
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_excel.md\":\"CqGtwEB4\",\"connectors_file.md\":\"Dbofo9W5\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_mysql.md\":\"fVCxQWUW\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_odoo.md\":\"DprabV5e\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"B5QWzWUK\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"C19dB-Tb\",\"conventions_run-report.md\":\"iVSN9fNV\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"DJPSthZ8\",\"guida_sviluppo.md\":\"Bvr7RKHN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"DrJFsfOJ\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"BNAiSoJJ\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"C1S-lAh2\",\"nodes_source.md\":\"BitUNtug\",\"nodes_task.md\":\"CejEQZcD\",\"nodes_transform.md\":\"Ciycywnb\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"BV8Izw4I\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_excel-operazioni-distruttive.md\":\"CEygSROg\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"DAz41942\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"C6HYc5_h\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"Excel\",\"link\":\"/connectors/excel\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"MySQL e MariaDB\",\"link\":\"/connectors/mysql\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"Odoo (record di un modello, con i campi dichiarati)\",\"link\":\"/connectors/odoo\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"operazioni distruttive di excelSink\",\"link\":\"/runbooks/excel-operazioni-distruttive\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
22
22
|
|
|
23
23
|
</body>
|
|
24
24
|
</html>
|