@noeva/etl-core 1.0.0-next.4 → 1.0.0-next.5
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/README.md +2 -1
- package/dist/chunk-BVUOUBLW.js +1 -0
- package/dist/chunk-CRR3Q2C7.js +2 -0
- package/dist/chunk-J3PBMWSP.js +2 -0
- package/dist/{chunk-KMUNED7K.js → chunk-LJ7DVP5F.js} +1 -1
- package/dist/{chunk-ZBKP2UOF.js → chunk-P6B2KLNJ.js} +2 -2
- package/dist/chunk-PKBSETMV.js +2 -0
- package/dist/chunk-QPJC4GWR.js +1 -0
- package/dist/chunk-RCRMQPFH.js +5 -0
- package/dist/chunk-RS5SGDUU.js +1 -0
- package/dist/chunk-RWPHH4E2.js +1 -0
- package/dist/chunk-SRFFKE5W.js +6 -0
- package/dist/chunk-WVODQB6Z.js +1 -0
- package/dist/chunk-XZMCC6VQ.js +1 -0
- package/dist/chunk-ZCYGHS7P.js +2 -0
- package/dist/cli.js +2 -2
- package/dist/connector-kit.d.ts +4 -2
- package/dist/connector-kit.js +1 -1
- package/dist/connectors/file.js +1 -1
- package/dist/connectors/http.js +1 -1
- package/dist/connectors/imap.js +1 -1
- package/dist/connectors/jira.js +2 -2
- package/dist/connectors/mail.js +1 -1
- package/dist/connectors/noeva.js +1 -1
- package/dist/connectors/oauth.js +1 -1
- package/dist/connectors/postgres.js +1 -1
- package/dist/connectors/sendgrid.js +1 -1
- package/dist/connectors/smtp.js +1 -1
- package/dist/connectors/sqlserver.js +1 -1
- package/dist/connectors/zoho.d.ts +304 -0
- package/dist/connectors/zoho.js +2 -0
- package/dist/etl.config.js +2 -2
- package/dist/guida/404.html +2 -2
- package/dist/guida/GUIDA_SVILUPPO.html +6 -6
- package/dist/guida/TECHNICAL_OVERVIEW.html +5 -5
- package/dist/guida/assets/{GUIDA_SVILUPPO.md.D13C7Zwu.js → GUIDA_SVILUPPO.md.CrN52ZDN.js} +1 -1
- package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DQP0pWc8.js → TECHNICAL_OVERVIEW.md.iD1gDlJY.js} +1 -1
- package/dist/guida/assets/{app.CzIZwOrR.js → app.BrI3mcoI.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.DjrQYH6x.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.Cv9o56BQ.js → VPLocalSearchBox.BlKLVNlB.js} +1 -1
- package/dist/guida/assets/chunks/{theme.CsUxYN72.js → theme.Cuah39Zj.js} +2 -2
- package/dist/guida/assets/connectors_README.md.BqI2RLCu.js +1 -0
- package/dist/guida/assets/connectors_README.md.BqI2RLCu.lean.js +1 -0
- package/dist/guida/assets/connectors_oauth.md.BeotXAWb.js +7 -0
- package/dist/guida/assets/connectors_oauth.md.BeotXAWb.lean.js +1 -0
- package/dist/guida/assets/connectors_zoho.md.BfEzRNZk.js +17 -0
- package/dist/guida/assets/connectors_zoho.md.BfEzRNZk.lean.js +1 -0
- package/dist/guida/assets/{conventions_node-descriptor.md.D8Si7E2S.js → conventions_node-descriptor.md.MQaGlm8a.js} +1 -1
- package/dist/guida/assets/{nodes_source.md.V_vlNfOz.js → nodes_source.md.DP2i3GFv.js} +3 -3
- package/dist/guida/assets/{nodes_source.md.V_vlNfOz.lean.js → nodes_source.md.DP2i3GFv.lean.js} +1 -1
- package/dist/guida/connectors/README.html +5 -5
- package/dist/guida/connectors/file.html +4 -4
- package/dist/guida/connectors/http.html +4 -4
- package/dist/guida/connectors/imap.html +4 -4
- package/dist/guida/connectors/jira.html +4 -4
- package/dist/guida/connectors/noeva.html +5 -5
- package/dist/guida/connectors/oauth.html +6 -6
- 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 +5 -5
- package/dist/guida/connectors/zoho.html +43 -0
- package/dist/guida/conventions/node-columns.html +4 -4
- package/dist/guida/conventions/node-descriptor.html +6 -6
- package/dist/guida/conventions/run-report.html +4 -4
- package/dist/guida/conventions/run-trace.html +4 -4
- package/dist/guida/conventions/variabili-del-core.html +4 -4
- package/dist/guida/conventions/versioni-di-pipeline.html +4 -4
- package/dist/guida/guide/claude-code/index.html +4 -4
- package/dist/guida/guide/claude-code/prompt.html +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 +4 -4
- package/dist/guida/nodes/action.html +4 -4
- package/dist/guida/nodes/ai.html +4 -4
- package/dist/guida/nodes/join.html +4 -4
- package/dist/guida/nodes/lookup.html +4 -4
- package/dist/guida/nodes/pipeline.html +4 -4
- package/dist/guida/nodes/route.html +4 -4
- package/dist/guida/nodes/sink.html +4 -4
- package/dist/guida/nodes/source.html +6 -6
- package/dist/guida/nodes/task.html +4 -4
- package/dist/guida/nodes/transform.html +4 -4
- package/dist/guida/nodes/try-catch.html +4 -4
- package/dist/guida/nodes/union.html +4 -4
- package/dist/guida/pagine.json +1 -0
- package/dist/guida/pipelines/README.html +5 -5
- 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 +4 -4
- package/dist/guida/runbooks/etl-worker.html +4 -4
- package/dist/guida/runbooks/graph-server.html +4 -4
- package/dist/guida/runbooks/mask-key.html +4 -4
- package/dist/guida/runbooks/oauth-google-posta.html +4 -4
- package/dist/guida/runbooks/rollback-di-pipeline.html +4 -4
- package/dist/guida/runbooks/scd2-rehash.html +4 -4
- package/dist/guida/runbooks/sql-task-truncate-swap.html +4 -4
- package/dist/guida/runbooks/stato-incrementale.html +4 -4
- package/dist/guida/sub-pipelines/README.html +4 -4
- package/dist/guida/sub-pipelines/riepilogo-ordini.html +4 -4
- package/dist/index.js +1 -1
- package/dist/pipelines.js +1 -1
- package/dist/testing.js +1 -1
- package/kit/skills/etl-graph/references/wiring.md +4 -3
- package/kit/skills/new-connector/SKILL.md +1 -1
- package/package.json +8 -3
- package/dist/chunk-BFW7HTF6.js +0 -2
- package/dist/chunk-BPRH262Y.js +0 -2
- package/dist/chunk-DPWGI266.js +0 -1
- package/dist/chunk-H75NY6Z4.js +0 -1
- package/dist/chunk-HMED2UDJ.js +0 -2
- package/dist/chunk-MOHJWOCB.js +0 -1
- package/dist/chunk-MXSKD3Z4.js +0 -2
- package/dist/chunk-PGJWGJEB.js +0 -5
- package/dist/chunk-R53642SH.js +0 -1
- package/dist/chunk-RU6CZIDB.js +0 -1
- package/dist/chunk-UN3BPCPA.js +0 -1
- package/dist/chunk-XFHTODDW.js +0 -6
- package/dist/guida/assets/chunks/@localSearchIndexroot.08YFQ5n8.js +0 -1
- package/dist/guida/assets/connectors_README.md.ChyXSf73.js +0 -1
- package/dist/guida/assets/connectors_README.md.ChyXSf73.lean.js +0 -1
- package/dist/guida/assets/connectors_oauth.md.DUHajB0u.js +0 -7
- package/dist/guida/assets/connectors_oauth.md.DUHajB0u.lean.js +0 -1
- /package/dist/guida/assets/{GUIDA_SVILUPPO.md.D13C7Zwu.lean.js → GUIDA_SVILUPPO.md.CrN52ZDN.lean.js} +0 -0
- /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DQP0pWc8.lean.js → TECHNICAL_OVERVIEW.md.iD1gDlJY.lean.js} +0 -0
- /package/dist/guida/assets/{conventions_node-descriptor.md.D8Si7E2S.lean.js → conventions_node-descriptor.md.MQaGlm8a.lean.js} +0 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
import {b as b$1,c,a as a$2}from'../chunk-
|
|
1
|
+
import {b as b$1,c,a as a$2}from'../chunk-BVUOUBLW.js';import {V,u,Z,W,l,m as m$1,r,s,Y,g as g$1,f,i,$,k,j as j$1,a as a$1,ja,ea,fa,ha,ia,ga,ca}from'../chunk-PKBSETMV.js';export{e as KEYS_PLACEHOLDER,f as assertReadOnlyQuery}from'../chunk-PKBSETMV.js';import {a,g,j,e,W as W$1,f as f$1}from'../chunk-PE2QKU34.js';import b from'mssql';var E=[...V,{suffisso:"ENCRYPT",default:"true"},{suffisso:"TRUSTCERT",default:"true"}];function pe(e){return {connettore:"sqlserver",prefisso:u,manifest:E,id:e}}a(pe,"istanzaMssqlDichiarata");function se(e,n){return W(E,e,n)}a(se,"risolviMssql");function L(e=u,n=process.env){let r=se(e,n),{host:o,port:s,database:c}=r.connessione;return {server:o,port:s,user:r.user,password:r.password,database:c,options:{encrypt:r.valore("ENCRYPT")!=="false",trustServerCertificate:r.valore("TRUSTCERT")!=="false"},pool:{max:10,min:0,idleTimeoutMillis:3e4}}}a(L,"loadMssqlConfig");function ae(e,n){return se(e,n).connessione}a(ae,"loadMssqlConnessioneDaPrefisso");function me(e,n={}){return new b.ConnectionPool({...e,...n.requestTimeout===void 0?{}:{requestTimeout:n.requestTimeout}})}a(me,"createMssqlPool");function ie(e,n){return {kind:"sqlserver",listEnvVar:"MSSQL_INSTANCES",instancesRaw:e.MSSQL_INSTANCES,defaultId:l,loadOne:a(r=>n(m$1(u,r),e),"loadOne")}}a(ie,"opzioni");function ye(e=process.env){return r(ie(e,L))}a(ye,"loadMssqlRegistry");function N(e,n=process.env){return s(ie(n,ae),e)}a(N,"loadMssqlConnessione");function Se(e,n){return Y({manifest:E,prefisso:m$1(u,e),env:n,esempio:{host:"sqlserver.esempio",port:1433,database:"esempio"},risolta:a(()=>N(e,n),"risolta")})}a(Se,"istanzaMssqlPerIlPiano");var qe=/^[A-Za-z_][A-Za-z0-9_]*$/;function m(e){if(!qe.test(e))throw new g(`Identificatore SQL non valido: "${e}"`);return `[${e}]`}a(m,"quoteIdentifier");function C(e){return e.split(".").map(m).join(".")}a(C,"qualifiedTable");function O(e,n,r,o){if(n.length===0)throw new g("`columns` non pu\xF2 essere vuoto");if(o<=0)throw new g("`rowCount` deve essere > 0");let s=C(e),c=n.map(m).join(", "),d=0,u=[];for(let p=0;p<o;p+=1){let l=n.map(()=>`@p${d++}`).join(", ");u.push(`(${l})`);}let a=u.join(", ");if(r.length===0)return `INSERT INTO ${s} (${c}) VALUES ${a};`;let i=n.map(m).join(", "),y=r.map(p=>`TGT.${m(p)} = SRC.${m(p)}`).join(" AND "),f=n.filter(p=>!r.includes(p)),S=f.length===0?"":` WHEN MATCHED THEN UPDATE SET ${f.map(p=>`TGT.${m(p)} = SRC.${m(p)}`).join(", ")}`,g$1=n.map(p=>`SRC.${m(p)}`).join(", ");return `MERGE INTO ${s} AS TGT USING (VALUES ${a}) AS SRC (${i}) ON ${y}${S} WHEN NOT MATCHED THEN INSERT (${c}) VALUES (${g$1});`}a(O,"buildMergeText");function ge(e){let n=e.config;if(typeof n!="object"||n===null)return {};let{server:r,port:o,database:s}=n;return {...typeof r=="string"?{server:r}:{},...typeof o=="number"?{port:o}:{},...typeof s=="string"?{database:s}:{}}}a(ge,"readConfig");function q(e){let{server:n,port:r,database:o}=ge(e),s=[];return n!==void 0&&n!==""&&s.push({label:"host",value:n}),r!==void 0&&s.push({label:"porta",value:String(r)}),o!==void 0&&o!==""&&s.push({label:"database",value:o}),s}a(q,"poolDetails");function v(e){let n=e.replace(/\s+/g," ").trim();return {label:"query",value:n.length>120?`${n.slice(0,120)}\u2026`:n}}a(v,"queryDetail");var A="sqlserver:lookup",Te="(SELECT CAST(NULL AS nvarchar(4000)) AS chiave WHERE 1 = 0)";function ke(e,n,r="list"){let o={};return n.forEach((s,c)=>{o[`k${c}`]=s;}),{text:g$1(e,n.length,s=>`@k${s}`,{shape:r,emptyRowset:Te}),inputs:o}}a(ke,"expandKeysPlaceholder");function he(e){let n=e.name??"sqlserver-lookup";return f(e.query,{requireKeysPlaceholder:true,stage:A}),{name:n,descriptor:{kind:"sqlserver-lookup",...a$1(e.instanceId),details:[...q(e.pool),v(e.query)]},async resolve(r,o){o.signal.throwIfAborted();let{text:s,inputs:c}=ke(e.query,i(r),e.keysAs??"list"),d=e.pool.request();for(let[i,y]of Object.entries(c))d.input(i,y);let u;try{u=await d.query(s);}catch(i){throw new j("Query del lookup fallita su SQL Server",{stage:A,...$(i)},{cause:i})}let a=k(u.recordset??[],e.keyColumn,A);return j$1(r,a)}}}a(he,"mssqlLookup");var x="watermark";function Ee(e,n){if(!(e instanceof Date)||n!=="timestamp")return ja(e,n);if(Number.isNaN(e.getTime()))return;let r=e.nanosecondsDelta,o=typeof r=="number"&&Number.isFinite(r)&&r>0?Math.round(r*1e7):0,s=Math.min(999,Math.floor(o/10));return `${e.toISOString().slice(0,-1)}${String(s).padStart(3,"0")}`}a(Ee,"mssqlWatermarkText");function we(e$1){let n=e$1.name??"sqlserver",r=e$1.highWaterMark??1e3,{watermark:o}=e$1;if(ea(n,e$1.query,o),o!==void 0&&Object.keys(e$1.inputs??{}).includes(x))throw new g(`La source "${n}" \xE8 incrementale: il parametro @${x} lo lega la source, non pu\xF2 stare fra gli \`inputs\`.`);let s=o===void 0?e$1.query:fa(e$1.query,`@${x}`);return {name:n,descriptor:{kind:"sqlserver",...a$1(e$1.instanceId),details:[...q(e$1.pool),v(e$1.query),...o!==void 0?[ga(o)]:[]]},...o!==void 0?{watermark:{...o,...e$1.instanceId!==void 0?{instanceId:e$1.instanceId}:{}}}:{},async*extract(c,d){let u=o===void 0?void 0:{watermark:o,incremental:ha(n,d)},a$1=e$1.pool.request();a$1.stream=true;for(let[l,ue]of Object.entries(e$1.inputs??{}))a$1.input(l,ue);u!==void 0&&a$1.input(x,u.incremental.from);let i=[],y=false,f=null,S=null,g=a(()=>{if(S){let l=S;S=null,l();}},"signal");a$1.on("row",l=>{i.push(l),i.length>=r&&a$1.pause(),g();}),a$1.on("error",l=>{f=l,g();}),a$1.on("done",()=>{y=true,g();}),a$1.query(s).catch(l=>{f??=l instanceof Error?l:new Error(String(l)),g();});try{for(;;){if(c.signal.throwIfAborted(),i.length===0){if(f!==null||y)break;await new Promise(l=>{S=l;});continue}for(;i.length>0;){let l=i.shift();u!==void 0&&ia(n,u.watermark,l,u.incremental,Ee),yield l;}a$1.resume();}}catch(l){throw a$1.cancel(),l instanceof e?l:new e("Errore durante l'estrazione da SQL Server",{stage:n},{cause:l})}let p=f;if(p)throw a$1.cancel(),new e("Errore durante l'estrazione da SQL Server",{stage:n},{cause:p})}}}a(we,"mssqlSource");var le={quote:m,table:C,param:a(e=>`@p${e}`,"param"),dateText:a(e=>`CONVERT(char(10), ${e}, 23)`,"dateText"),trueLiteral:"1",falseLiteral:"0",tryLock:a(e=>({text:"DECLARE @scd2_lock int; EXEC @scd2_lock = sp_getapplock @Resource = @p0, @LockMode = 'Exclusive', @LockOwner = 'Transaction', @LockTimeout = 0; SELECT @scd2_lock AS locked;",params:[`noeva-etl:scd2:${e}`]}),"tryLock"),lockGranted:a(e=>{let n=e?.locked;return typeof n=="number"&&n>=0},"lockGranted"),isUniqueViolation:a(e=>Z(e,{numbers:new Set([2601,2627])}),"isUniqueViolation")};function Re(e){return async n=>{let r=new b.Request(e);n.params.forEach((c,d)=>{r.input(`p${d}`,c);});let o=await r.query(n.text);return {rows:o.recordset??[],rowCount:o.rowsAffected.reduce((c,d)=>c+d,0)}}}a(Re,"scd2Exec");var ce=2100,Me=1e3;function Ce(e,n,r){let o=Math.max(n.columns.length+1,n.naturalKey.length+1),s=Math.min(Me,Math.floor((ce-2)/o));if(r===void 0)return Math.min(200,s);if(!Number.isInteger(r)||r<1||r>s)throw new g(`sink SCD2 "${e}": \`batchSize\` deve essere un intero fra 1 e ${s}: SQL Server ammette ${ce} parametri per richiesta, e questa tabella ne usa ${o} per riga.`);return r}a(Ce,"scd2BatchSize");function ve(e,n,r){let o=Ce(r,n,e.batchSize),s=W$1();return {name:r,retrySafe:true,held:s.read,descriptor:{kind:"sqlserver",...a$1(e.instanceId),details:[...q(e.pool),{label:"table",value:e.table},{label:"mode",value:"scd2"}]},async load(c$1,d){let u=b$1(d.params,r),a$1=new b.Transaction(e.pool);return c({config:n,dialect:le,exec:Re(a$1),records:c$1,ctx:d,batchSize:o,run:u,stage:r,onHeld:a(i=>s.set(d,i),"onHeld")},{engine:"SQL Server",begin:a(async()=>{await a$1.begin();},"begin"),commit:a(()=>a$1.commit(),"commit"),rollback:a(()=>a$1.rollback(),"rollback")})}}}a(ve,"mssqlScd2Sink");function xe(e){let n=e.name??`sqlserver:${e.table}`;if(e.mode==="scd2")return ve(e,a$2(n,e.table,e.columns,e),n);let r=e.batchSize??200,o=e.conflictTarget??[],s=W$1();return {name:n,retrySafe:true,held:s.read,descriptor:{kind:"sqlserver",...a$1(e.instanceId),details:[...q(e.pool),{label:"table",value:e.table}]},async load(c,d){let u=new b.Transaction(e.pool),a$1=0,i=[],y=a(async()=>{if(i.length===0)return;let f=O(e.table,e.columns,o,i.length),S=new b.Request(u),g=0;for(let p of i)for(let l of e.columns)S.input(`p${g++}`,p[l]);await S.query(f),a$1+=i.length,i=[],s.set(d,0);},"flush");await u.begin();try{for await(let f of c)d.signal.throwIfAborted(),i.push(f),s.set(d,i.length),i.length>=r&&await y();await y(),await u.commit();}catch(f){try{await u.rollback();}catch{}throw new f$1("Errore durante il caricamento su SQL Server",{stage:n,...$(f)},{cause:f})}finally{s.set(d,0);}return {written:a$1}}}}a(xe,"mssqlSink");function be(e){return {kind:"sqlserver-task",connectionDetails:q(e),async transaction(n){let r=e.transaction();try{await r.begin(),await n({async execute(o,s){let c=r.request();for(let a of o.params)c.input(a,s[a]);let u=(await c.query(o.text)).rowsAffected;return u.length===0?null:u.reduce((a,i)=>a+i,0)}}),await r.commit();}catch(o){try{await r.rollback();}catch{}throw o}}}}a(be,"mssqlDriver");function Pe(e){let{pool:n,...r}=e;return ca(r,be(n))}a(Pe,"mssqlSqlTask");export{E as MANIFEST_MSSQL,O as buildMergeText,me as createMssqlPool,pe as istanzaMssqlDichiarata,Se as istanzaMssqlPerIlPiano,L as loadMssqlConfig,N as loadMssqlConnessione,ye as loadMssqlRegistry,he as mssqlLookup,xe as mssqlSink,we as mssqlSource,Pe as mssqlSqlTask,C as qualifiedTable,m as quoteIdentifier};
|
|
@@ -0,0 +1,304 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { C as ConfigError, e as ConnectorDetail, d as RetryPolicy, a as Source } from '../errors-bgSO6lGO.js';
|
|
3
|
+
import { M as ManifestVariabili, V as VariabileRisolta, R as RisoluzioneVariabili } from '../manifest-variabili-U1UfPDfF.js';
|
|
4
|
+
import { H as HttpConfig } from '../config-BSUwK4p_.js';
|
|
5
|
+
import { I as IstanzaPerIlPiano } from '../istanza-per-il-piano-CucqUF7b.js';
|
|
6
|
+
import { C as ConnectorRegistry } from '../registry-tB3G64MU.js';
|
|
7
|
+
import '../ambiente-della-pipeline-BoymQ6uN.js';
|
|
8
|
+
import '../variabili-dichiarate-DmfcxsT9.js';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Un campo di un modulo Zoho CRM come lo dichiara la pipeline (ADR-0106,
|
|
12
|
+
* punto 4): il nome API e il tipo di Zoho (`data_type` di
|
|
13
|
+
* `/settings/fields`). La lista dei campi dichiarati **è** la regola di
|
|
14
|
+
* privacy: un campo che non c'è non si chiede e non esce.
|
|
15
|
+
*/
|
|
16
|
+
interface CampoZoho {
|
|
17
|
+
/** Il nome API: `Stage`, `Account_Name`, `Data_Inizio_Terapia`. */
|
|
18
|
+
readonly nome: string;
|
|
19
|
+
/** Il `data_type` di Zoho: `text`, `picklist`, `lookup`, `datetime`… */
|
|
20
|
+
readonly tipo: string;
|
|
21
|
+
}
|
|
22
|
+
/** Il campo che ogni lettura chiede: la chiave del record. */
|
|
23
|
+
declare const CAMPO_ID = "id";
|
|
24
|
+
/** Il campo che la Records API chiede sempre oltre a `id`; con COQL è un campo come gli altri. */
|
|
25
|
+
declare const CAMPO_MODIFICA = "Modified_Time";
|
|
26
|
+
/** I campi per chiamata della Records API. */
|
|
27
|
+
declare const MAX_CAMPI_PER_CHIAMATA = 50;
|
|
28
|
+
/**
|
|
29
|
+
* I campi dichiarabili per passata con la Records API: i 50 meno `id` e
|
|
30
|
+
* `Modified_Time`. Con COQL vale {@link MAX_CAMPI_COQL}.
|
|
31
|
+
*/
|
|
32
|
+
declare const MAX_CAMPI_DICHIARATI: number;
|
|
33
|
+
/**
|
|
34
|
+
* I campi di una `SELECT` COQL: 500, `id` compreso. Nome e cognome di ogni
|
|
35
|
+
* collegamento a un utente contano anche loro (vedi `coql.ts`).
|
|
36
|
+
*/
|
|
37
|
+
declare const MAX_CAMPI_COQL: number;
|
|
38
|
+
/**
|
|
39
|
+
* Come il source legge un modulo (ADR-0106, emendamento del 2026-10-23):
|
|
40
|
+
*
|
|
41
|
+
* - `records`: la Records API, a pagine di 200 ordinate per `id`, fino a
|
|
42
|
+
* 100.000 record e 48 campi oltre a `Modified_Time` per chiamata;
|
|
43
|
+
* - `coql`: la Query API, a blocchi di 2.000 con `id` crescente, senza tetto
|
|
44
|
+
* di record e fino a 499 campi. Vuole lo scope `ZohoCRM.coql.READ`.
|
|
45
|
+
*/
|
|
46
|
+
type LetturaZoho = "records" | "coql";
|
|
47
|
+
/** I campi dichiarabili in una lettura, `Modified_Time` escluso per `records`. */
|
|
48
|
+
declare const maxCampiDi: (lettura: LetturaZoho) => number;
|
|
49
|
+
/** Il suffisso della colonna con il nome dell'utente di un `userlookup`. */
|
|
50
|
+
declare const SUFFISSO_NOME = "_nome";
|
|
51
|
+
/**
|
|
52
|
+
* Il nome della colonna di un campo: i caratteri non di parola diventano `_`,
|
|
53
|
+
* gli `_` ripetuti uno, senza `_` ai bordi, in minuscolo. È `colonna()` dello
|
|
54
|
+
* script Python che ha letto il CRM fino a oggi, così le colonne restano
|
|
55
|
+
* quelle dei parquet.
|
|
56
|
+
*/
|
|
57
|
+
declare function colonnaZoho(api: string): string;
|
|
58
|
+
/** `true` se il campo è un collegamento a un utente, con la colonna del nome. */
|
|
59
|
+
declare const eCampoUtente: (campo: CampoZoho) => boolean;
|
|
60
|
+
/** Il tipo della colonna in uscita, per il DAG e per lo schema del record. */
|
|
61
|
+
type TipoColonnaZoho = "string" | "integer" | "number" | "boolean" | "date" | "datetime";
|
|
62
|
+
/** Il tipo della colonna di un campo, come lo converte {@link valoreZoho}. */
|
|
63
|
+
declare function tipoColonnaZoho(tipo: string): TipoColonnaZoho;
|
|
64
|
+
/** Una colonna del record: da quale campo viene e di che tipo è. */
|
|
65
|
+
interface ColonnaZoho {
|
|
66
|
+
readonly colonna: string;
|
|
67
|
+
readonly campo: CampoZoho;
|
|
68
|
+
readonly tipo: TipoColonnaZoho;
|
|
69
|
+
/** `true` per la colonna `<colonna>_nome` di un collegamento a un utente. */
|
|
70
|
+
readonly nomeUtente: boolean;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Le colonne di un record letto con questi campi, nell'ordine: `id`, poi una
|
|
74
|
+
* per campo e, per un collegamento a un utente, subito dopo `<colonna>_nome`.
|
|
75
|
+
*/
|
|
76
|
+
declare function colonneZoho(campi: readonly CampoZoho[]): ColonnaZoho[];
|
|
77
|
+
/** I nomi delle colonne del record, `id` compreso: quelle che scrive un sink. */
|
|
78
|
+
declare function nomiColonneZoho(campi: readonly CampoZoho[]): string[];
|
|
79
|
+
/** Il valore di una colonna del record. */
|
|
80
|
+
type ValoreZoho = string | number | boolean | null;
|
|
81
|
+
/**
|
|
82
|
+
* Il valore di un campo come lo scrive la colonna. È `valore()` dello script
|
|
83
|
+
* Python che ha letto il CRM fino a oggi:
|
|
84
|
+
*
|
|
85
|
+
* - vuoto (`null`, `""`) → `null`;
|
|
86
|
+
* - un collegamento → il solo `id`: il nome accanto (il paziente, il medico)
|
|
87
|
+
* non esce mai;
|
|
88
|
+
* - una multiselezione → le voci unite da `"; "`;
|
|
89
|
+
* - una data e ora → l'ora locale come la dà Zoho, senza fuso
|
|
90
|
+
* (`AAAA-MM-GGTHH:MM:SS`); una data → `AAAA-MM-GG`;
|
|
91
|
+
* - booleani, interi e decimali → il loro tipo;
|
|
92
|
+
* - il resto (testo, picklist, formule) → testo.
|
|
93
|
+
*
|
|
94
|
+
* Un valore che non si converte lancia {@link ValoreNonConvertibile}, senza il
|
|
95
|
+
* valore: chi legge lo trasforma in un errore che nomina campo e record.
|
|
96
|
+
*/
|
|
97
|
+
declare function valoreZoho(valore: unknown, tipo: string): ValoreZoho;
|
|
98
|
+
/** Un record di Zoho dopo la conversione: `id` e una colonna per campo. */
|
|
99
|
+
type RecordZoho = Readonly<Record<string, ValoreZoho>> & {
|
|
100
|
+
readonly id: string;
|
|
101
|
+
};
|
|
102
|
+
/**
|
|
103
|
+
* Il contratto di un record letto con questi campi: `id` non vuoto, ogni
|
|
104
|
+
* colonna del suo tipo, e **nient'altro** (`strict`). È il controllo di
|
|
105
|
+
* privacy al confine: una colonna non dichiarata ferma la run.
|
|
106
|
+
*/
|
|
107
|
+
declare function schemaRecordZoho(campi: readonly CampoZoho[]): z.ZodType<RecordZoho>;
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Un'organizzazione Zoho CRM, come la vede il connettore (ADR-0106). Solo la
|
|
111
|
+
* Records API v8.
|
|
112
|
+
*
|
|
113
|
+
* Non porta credenziali: il token lo rinnova l'identità OAuth2 nominata da
|
|
114
|
+
* `oauthInstance` (`OAUTH_<ID>_*`, ADR-0065), con il refresh token di Zoho.
|
|
115
|
+
* Così il segreto vive in un posto solo, e questo connettore non ha un
|
|
116
|
+
* fornitore di token suo.
|
|
117
|
+
*/
|
|
118
|
+
interface ZohoConfig {
|
|
119
|
+
/**
|
|
120
|
+
* La base delle API, `https://www.zohoapis.<dc>/crm/v8`, senza barra
|
|
121
|
+
* finale. Decide anche il data center: un token emesso da
|
|
122
|
+
* `accounts.zoho.eu` vale solo su `zohoapis.eu`.
|
|
123
|
+
*/
|
|
124
|
+
readonly baseUrl: string;
|
|
125
|
+
/** L'identità OAuth2 del registry che rinnova il token. */
|
|
126
|
+
readonly oauthInstance: string;
|
|
127
|
+
/** Tempo massimo di una singola richiesta, in millisecondi. */
|
|
128
|
+
readonly timeoutMs: number;
|
|
129
|
+
/** Dimensione massima di una risposta, in byte. */
|
|
130
|
+
readonly maxResponseBytes: number;
|
|
131
|
+
/**
|
|
132
|
+
* Le variabili da cui arriva la config, con la loro origine (ADR-0089): il
|
|
133
|
+
* descriptor le mostra accanto ai valori. Le mette {@link loadZohoConfig};
|
|
134
|
+
* assenti in una config scritta a mano.
|
|
135
|
+
*/
|
|
136
|
+
readonly variabili?: readonly VariabileRisolta[];
|
|
137
|
+
/**
|
|
138
|
+
* Solo in un'istanza d'esempio del piano: il `ConfigError` per cui la
|
|
139
|
+
* configurazione risolta non si costruisce (ADR-0089).
|
|
140
|
+
*/
|
|
141
|
+
readonly ricaduta?: ConfigError;
|
|
142
|
+
/**
|
|
143
|
+
* Solo nel piano: le variabili dell'identità OAuth2 `oauthInstance`, per dire
|
|
144
|
+
* nella riga `credenziale` se è completa (`conIdentitaOauth`).
|
|
145
|
+
*/
|
|
146
|
+
readonly identitaOauth?: RisoluzioneVariabili;
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Più largo di quello di `http`: una pagina di 200 record con 50 campi può
|
|
150
|
+
* metterci secondi, e un timeout la farebbe ripetere da capo.
|
|
151
|
+
*/
|
|
152
|
+
declare const DEFAULT_ZOHO_TIMEOUT_MS = 60000;
|
|
153
|
+
declare const DEFAULT_ZOHO_MAX_RESPONSE_BYTES: number;
|
|
154
|
+
/**
|
|
155
|
+
* Le variabili di un'organizzazione Zoho, per suffisso del prefisso d'istanza
|
|
156
|
+
* (ADR-0089). Le leggono sia {@link loadZohoConfig} sia il piano.
|
|
157
|
+
*/
|
|
158
|
+
declare const MANIFEST_ZOHO: ManifestVariabili;
|
|
159
|
+
/**
|
|
160
|
+
* Config di un'organizzazione Zoho CRM da variabili d'ambiente con prefisso
|
|
161
|
+
* (default `ZOHO_`), dichiarate in {@link MANIFEST_ZOHO}:
|
|
162
|
+
*
|
|
163
|
+
* - `ZOHO_BASE_URL` (obbligatoria): la base delle API v8 del data center,
|
|
164
|
+
* `https://www.zohoapis.eu/crm/v8` per l'Europa;
|
|
165
|
+
* - `ZOHO_OAUTH_INSTANCE` (default `default`): l'identità OAuth2 del registry
|
|
166
|
+
* (`OAUTH_INSTANCES`) che rinnova il token, con il token endpoint di Zoho
|
|
167
|
+
* (`https://accounts.zoho.eu/oauth/v2/token`);
|
|
168
|
+
* - `ZOHO_TIMEOUT_MS` (default {@link DEFAULT_ZOHO_TIMEOUT_MS}).
|
|
169
|
+
*
|
|
170
|
+
* Con variabili mancanti lancia un `ConfigError` che le elenca **tutte**. Gli
|
|
171
|
+
* errori nominano le variabili, mai i valori.
|
|
172
|
+
*/
|
|
173
|
+
declare function loadZohoConfig(prefix?: string, env?: NodeJS.ProcessEnv): ZohoConfig;
|
|
174
|
+
/**
|
|
175
|
+
* La config del trasporto condiviso di `http` per **una** richiesta, con il
|
|
176
|
+
* token valido in quel momento. Zoho vuole `Zoho-oauthtoken`, non `Bearer`, e
|
|
177
|
+
* il token si rinnova durante una lettura lunga: per questo il connettore la
|
|
178
|
+
* costruisce a ogni richiesta invece di tenerne una per run (ADR-0106).
|
|
179
|
+
*/
|
|
180
|
+
declare function trasportoZoho(config: ZohoConfig, token: string): HttpConfig;
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* La riga `credenziale` di un nodo Zoho: l'identità OAuth2 e, nel piano, se le
|
|
184
|
+
* sue variabili ci sono tutte o quali mancano (il badge punta alla prima).
|
|
185
|
+
* Senza risoluzione, una config costruita a mano, nomina solo l'identità.
|
|
186
|
+
*/
|
|
187
|
+
declare function dettaglioCredenzialeZoho(config: ZohoConfig): ConnectorDetail;
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* Retry di una lettura: `Retry-After` come attesa minima (il trasporto lo
|
|
191
|
+
* legge su 429 e 5xx transitori), backoff da 2 secondi con jitter, al più 5
|
|
192
|
+
* tentativi. `maxMs` è il tetto di **ogni** attesa (ADR-0059): Zoho conta le
|
|
193
|
+
* chiamate per minuto, e una pausa di un minuto basta a rientrare.
|
|
194
|
+
*/
|
|
195
|
+
declare const DEFAULT_ZOHO_RETRY: RetryPolicy;
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* L'organizzazione `id` per il piano (ADR-0089): quella risolta dall'ambiente,
|
|
199
|
+
* o l'esempio con le variabili e le origini dell'istanza vera, sempre con lo
|
|
200
|
+
* stato dell'identità OAuth2 che le rinnova il token. Senza caricare le altre
|
|
201
|
+
* istanze, così una rotta non trascina le sane.
|
|
202
|
+
*/
|
|
203
|
+
declare function istanzaZohoPerIlPiano(id: string, env: NodeJS.ProcessEnv): IstanzaPerIlPiano<ZohoConfig>;
|
|
204
|
+
|
|
205
|
+
/** Registry validato delle organizzazioni Zoho CRM configurate (ADR-0030). */
|
|
206
|
+
type ZohoRegistry = ConnectorRegistry<ZohoConfig>;
|
|
207
|
+
/**
|
|
208
|
+
* Risolve lo {@link ZohoRegistry} da env. Con `ZOHO_INSTANCES` (es. `vendite`)
|
|
209
|
+
* carica un'organizzazione per id dalle variabili `ZOHO_<ID>_*`; senza,
|
|
210
|
+
* l'istanza `default` dalle variabili base `ZOHO_*`. Più clienti con Zoho CRM
|
|
211
|
+
* convivono nello stesso worker, ognuno con la sua identità OAuth2.
|
|
212
|
+
*/
|
|
213
|
+
declare function loadZohoRegistry(env?: NodeJS.ProcessEnv): ZohoRegistry;
|
|
214
|
+
/**
|
|
215
|
+
* La config della sola organizzazione `id`, senza caricare le altre: è ciò che
|
|
216
|
+
* usa il piano, dove un'istanza rotta non deve trascinare le altre (ADR-0089).
|
|
217
|
+
*/
|
|
218
|
+
declare function loadZohoInstance(id: string, env?: NodeJS.ProcessEnv): ZohoConfig;
|
|
219
|
+
|
|
220
|
+
/** Record per pagina: il massimo che la Records API restituisce. */
|
|
221
|
+
declare const MAX_ZOHO_PER_PAGINA = 200;
|
|
222
|
+
/**
|
|
223
|
+
* I record che una sola interrogazione della Records API può scorrere: oltre,
|
|
224
|
+
* Zoho risponde `PAGINATION_LIMIT_EXCEEDED`.
|
|
225
|
+
*/
|
|
226
|
+
declare const MAX_ZOHO_PER_INTERROGAZIONE = 100000;
|
|
227
|
+
|
|
228
|
+
/** Record per query: il massimo che la Query API restituisce. */
|
|
229
|
+
declare const MAX_ZOHO_PER_QUERY = 2000;
|
|
230
|
+
|
|
231
|
+
interface ZohoCrmRecordsOptions {
|
|
232
|
+
/** L'organizzazione, da `loadZohoRegistry().get(id)` (ADR-0030). */
|
|
233
|
+
readonly config: ZohoConfig;
|
|
234
|
+
/**
|
|
235
|
+
* Il token valido in questo momento, da `fornitoreToken` sull'identità
|
|
236
|
+
* OAuth2 `config.oauthInstance`. Un fornitore per run, condiviso fra i nodi
|
|
237
|
+
* della stessa organizzazione: tiene la cache del token.
|
|
238
|
+
*/
|
|
239
|
+
readonly token: () => Promise<string>;
|
|
240
|
+
/** Id dell'istanza, mostrato nel DAG. */
|
|
241
|
+
readonly instanceId?: string;
|
|
242
|
+
readonly name?: string;
|
|
243
|
+
/** Il nome API del modulo: `Deals`, `Sales_Orders`. */
|
|
244
|
+
readonly modulo: string;
|
|
245
|
+
/**
|
|
246
|
+
* I campi da leggere, con il loro tipo (ADR-0106, punto 4). Ognuno diventa
|
|
247
|
+
* una colonna; un collegamento a un utente anche `<colonna>_nome`. Nessun
|
|
248
|
+
* altro campo esce dal source. Quanti ne stanno in una lettura lo dice
|
|
249
|
+
* {@link lettura}: 48 oltre a `Modified_Time` con `records`, 499 con `coql`.
|
|
250
|
+
*/
|
|
251
|
+
readonly campi: readonly CampoZoho[];
|
|
252
|
+
/**
|
|
253
|
+
* Come leggere il modulo (vedi `LetturaZoho`). Default `records`, che basta
|
|
254
|
+
* fino a 100.000 record; oltre serve `coql`, con lo scope
|
|
255
|
+
* `ZohoCRM.coql.READ`.
|
|
256
|
+
*/
|
|
257
|
+
readonly lettura?: LetturaZoho;
|
|
258
|
+
/** `records`: record per pagina, fra 1 e {@link MAX_ZOHO_PER_PAGINA} (default 200). */
|
|
259
|
+
readonly perPagina?: number;
|
|
260
|
+
/**
|
|
261
|
+
* `records`: record per interrogazione prima di fermarsi. Default
|
|
262
|
+
* {@link MAX_ZOHO_PER_INTERROGAZIONE}, il tetto di Zoho: più basso solo nei
|
|
263
|
+
* test, dove centomila record finti non servono.
|
|
264
|
+
*/
|
|
265
|
+
readonly maxPerInterrogazione?: number;
|
|
266
|
+
/** `coql`: record per query, fra 1 e {@link MAX_ZOHO_PER_QUERY} (default 2000). */
|
|
267
|
+
readonly perQuery?: number;
|
|
268
|
+
/** Retry del catalogo e di ogni richiesta. */
|
|
269
|
+
readonly retry?: RetryPolicy;
|
|
270
|
+
/** Iniettabile nei test; default il `fetch` di Node. */
|
|
271
|
+
readonly fetchImpl?: typeof fetch;
|
|
272
|
+
}
|
|
273
|
+
/**
|
|
274
|
+
* I record di un modulo Zoho CRM con i soli campi dichiarati (ADR-0106). Ogni
|
|
275
|
+
* run rilegge tutto il modulo, senza stato: è il carico completo della v1.
|
|
276
|
+
*
|
|
277
|
+
* A ogni run legge prima il catalogo dei campi del modulo
|
|
278
|
+
* (`GET /settings/fields`), una volta: un campo dichiarato che Zoho non
|
|
279
|
+
* conosce più è un `ConfigError` che lo nomina, prima del primo record.
|
|
280
|
+
*
|
|
281
|
+
* Poi legge il modulo **in ordine di `id`**, che un record modificato durante
|
|
282
|
+
* la lettura non cambia, con una delle due letture (`lettura`):
|
|
283
|
+
*
|
|
284
|
+
* - `records`: la Records API, `GET /{modulo}` a pagine di 200 con
|
|
285
|
+
* `page_token`, fino a 100.000 record;
|
|
286
|
+
* - `coql`: la Query API, `POST /coql` a blocchi di 2.000 con `id > ultimo`,
|
|
287
|
+
* senza tetto di record.
|
|
288
|
+
*
|
|
289
|
+
* In entrambe una richiesta parte solo quando chi legge ha consumato il
|
|
290
|
+
* blocco precedente, e in memoria restano gli `id` visti, non i record.
|
|
291
|
+
*
|
|
292
|
+
* Ogni record esce con `id` e una colonna per campo dichiarato, convertita
|
|
293
|
+
* come dice `valoreZoho`: di un collegamento solo l'`id`, di un utente Zoho
|
|
294
|
+
* anche il nome. Un valore che non si converte nel tipo del suo campo è un
|
|
295
|
+
* `ExtractError` che nomina modulo, campo e `id` del record, mai il valore.
|
|
296
|
+
*
|
|
297
|
+
* Usa il trasporto condiviso di `http`: timeout, tetto sui byte, abort,
|
|
298
|
+
* validazione Zod, 429 e 5xx transitori con `Retry-After`. Il token si chiede
|
|
299
|
+
* al fornitore a ogni richiesta, quindi una lettura lunga sopravvive alla sua
|
|
300
|
+
* scadenza.
|
|
301
|
+
*/
|
|
302
|
+
declare function zohoCrmRecords(options: ZohoCrmRecordsOptions): Source<RecordZoho>;
|
|
303
|
+
|
|
304
|
+
export { CAMPO_ID, CAMPO_MODIFICA, type CampoZoho, type ColonnaZoho, DEFAULT_ZOHO_MAX_RESPONSE_BYTES, DEFAULT_ZOHO_RETRY, DEFAULT_ZOHO_TIMEOUT_MS, type LetturaZoho, MANIFEST_ZOHO, MAX_CAMPI_COQL, MAX_CAMPI_DICHIARATI, MAX_CAMPI_PER_CHIAMATA, MAX_ZOHO_PER_INTERROGAZIONE, MAX_ZOHO_PER_PAGINA, MAX_ZOHO_PER_QUERY, type RecordZoho, SUFFISSO_NOME, type TipoColonnaZoho, type ValoreZoho, type ZohoConfig, type ZohoCrmRecordsOptions, type ZohoRegistry, colonnaZoho, colonneZoho, dettaglioCredenzialeZoho, eCampoUtente, istanzaZohoPerIlPiano, loadZohoConfig, loadZohoInstance, loadZohoRegistry, maxCampiDi, nomiColonneZoho, schemaRecordZoho, tipoColonnaZoho, trasportoZoho, valoreZoho, zohoCrmRecords };
|
|
@@ -0,0 +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");
|
|
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/etl.config.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {a as a$2}from'./chunk-P6B2KLNJ.js';import'./chunk-NZR6TZ42.js';import {e as e$1,d as d$1,l,m,b as b$2,g}from'./chunk-RWPHH4E2.js';import'./chunk-BVUOUBLW.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-XZMCC6VQ.js';import {d}from'./chunk-RCRMQPFH.js';import'./chunk-RS5SGDUU.js';import'./chunk-WVODQB6Z.js';import'./chunk-4NPSBPBY.js';import {f,t,x,u}from'./chunk-SRFFKE5W.js';import {d as d$2,e as e$2}from'./chunk-J3PBMWSP.js';import'./chunk-QPJC4GWR.js';import'./chunk-LJ7DVP5F.js';import {X,O,Q,R as R$1}from'./chunk-PKBSETMV.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$1,U as U$1}from'./chunk-PE2QKU34.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 {e as e$1,d as d$1,l,m,b as b$2,g}from'./chunk-DPWGI266.js';import'./chun
|
|
|
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:W$1(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:W$1(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 Q({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=N(U,z,e);return {fileName:P(i,"FILE_NAME"),workspaceB:P(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 Q({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: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(`
|
|
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
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$1("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$1("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.BNn_AkzN.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.BrI3mcoI.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\":\"
|
|
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\":\"CxVSru8e\",\"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\":\"f3LAxif4\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CsIYRa_5\",\"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\":\"iD1gDlJY\"}");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>
|
|
22
22
|
|
|
23
23
|
</body>
|
|
24
24
|
</html>
|