@noeva/etl-core 1.0.0-next.5 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +183 -0
- package/LICENSE +19 -0
- package/README.md +1 -1
- package/deploy/Dockerfile +1 -1
- package/dist/guida/404.html +3 -3
- package/dist/guida/GUIDA_SVILUPPO.html +6 -6
- package/dist/guida/TECHNICAL_OVERVIEW.html +8 -8
- package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.iD1gDlJY.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.js} +1 -1
- package/dist/guida/assets/{app.BrI3mcoI.js → app.DlsuGVZn.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.LnC621Vy.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.BlKLVNlB.js → VPLocalSearchBox.v4vBLemj.js} +2 -2
- package/dist/guida/assets/chunks/{theme.Cuah39Zj.js → theme.D9XEK7o0.js} +2 -2
- package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.js → guide_claude-code_index.md.DEnzf9b_.js} +1 -1
- package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.js → runbooks_aggiornamento-pm2.md.DrFr4blI.js} +1 -1
- package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.js → runbooks_deployment.md.CwG77qGO.js} +1 -1
- package/dist/guida/assets/{style.BNn_AkzN.css → style.DFlUbYCk.css} +1 -1
- package/dist/guida/connectors/README.html +5 -5
- package/dist/guida/connectors/file.html +6 -6
- package/dist/guida/connectors/http.html +6 -6
- package/dist/guida/connectors/imap.html +6 -6
- package/dist/guida/connectors/jira.html +6 -6
- package/dist/guida/connectors/noeva.html +6 -6
- package/dist/guida/connectors/oauth.html +6 -6
- package/dist/guida/connectors/postgres.html +6 -6
- package/dist/guida/connectors/process.html +6 -6
- package/dist/guida/connectors/sendgrid.html +6 -6
- package/dist/guida/connectors/smtp.html +6 -6
- package/dist/guida/connectors/sqlserver.html +6 -6
- package/dist/guida/connectors/zoho.html +6 -6
- package/dist/guida/conventions/node-columns.html +6 -6
- package/dist/guida/conventions/node-descriptor.html +6 -6
- package/dist/guida/conventions/run-report.html +6 -6
- package/dist/guida/conventions/run-trace.html +6 -6
- package/dist/guida/conventions/variabili-del-core.html +5 -5
- package/dist/guida/conventions/versioni-di-pipeline.html +6 -6
- package/dist/guida/guide/claude-code/index.html +7 -7
- package/dist/guida/guide/claude-code/prompt.html +6 -6
- package/dist/guida/guide/claude-code/strumenti.html +5 -5
- package/dist/guida/guide/grafo.html +6 -6
- package/dist/guida/guide/usare/app-desktop.html +5 -5
- package/dist/guida/guide/usare/esito-di-una-run.html +6 -6
- package/dist/guida/guide/usare/index.html +5 -5
- package/dist/guida/hashmap.json +1 -1
- package/dist/guida/index.html +6 -6
- package/dist/guida/nodes/README.html +6 -6
- package/dist/guida/nodes/action.html +6 -6
- package/dist/guida/nodes/ai.html +6 -6
- package/dist/guida/nodes/join.html +6 -6
- package/dist/guida/nodes/lookup.html +6 -6
- package/dist/guida/nodes/pipeline.html +6 -6
- package/dist/guida/nodes/route.html +6 -6
- package/dist/guida/nodes/sink.html +6 -6
- package/dist/guida/nodes/source.html +6 -6
- package/dist/guida/nodes/task.html +6 -6
- package/dist/guida/nodes/transform.html +6 -6
- package/dist/guida/nodes/try-catch.html +6 -6
- package/dist/guida/nodes/union.html +6 -6
- package/dist/guida/pipelines/README.html +6 -6
- package/dist/guida/pipelines/crm-leads-sync.html +6 -6
- package/dist/guida/pipelines/cross-workspace-csv-merge.html +6 -6
- package/dist/guida/pipelines/movimenti-per-conto.html +6 -6
- package/dist/guida/pipelines/orders-enriched-daily.html +6 -6
- package/dist/guida/pipelines/test-posta.html +6 -6
- package/dist/guida/runbooks/aggiornamento-pm2.html +7 -7
- package/dist/guida/runbooks/deploy-ecr.html +6 -6
- package/dist/guida/runbooks/deployment.html +8 -8
- package/dist/guida/runbooks/etl-worker.html +6 -6
- package/dist/guida/runbooks/graph-server.html +6 -6
- package/dist/guida/runbooks/mask-key.html +6 -6
- package/dist/guida/runbooks/oauth-google-posta.html +6 -6
- package/dist/guida/runbooks/rollback-di-pipeline.html +6 -6
- package/dist/guida/runbooks/scd2-rehash.html +6 -6
- package/dist/guida/runbooks/sql-task-truncate-swap.html +6 -6
- package/dist/guida/runbooks/stato-incrementale.html +6 -6
- package/dist/guida/sub-pipelines/README.html +6 -6
- package/dist/guida/sub-pipelines/riepilogo-ordini.html +6 -6
- package/kit/boilerplate/.github/workflows/ci.yml +1 -1
- package/kit/boilerplate/.github/workflows/image.yml +1 -1
- package/kit/boilerplate/package.json +1 -1
- package/package.json +5 -4
- package/dist/guida/assets/chunks/@localSearchIndexroot.DjrQYH6x.js +0 -1
- /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.iD1gDlJY.lean.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.lean.js} +0 -0
- /package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.lean.js → guide_claude-code_index.md.DEnzf9b_.lean.js} +0 -0
- /package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.lean.js → runbooks_aggiornamento-pm2.md.DrFr4blI.lean.js} +0 -0
- /package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.lean.js → runbooks_deployment.md.CwG77qGO.lean.js} +0 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
# @noeva/etl-core
|
|
2
|
+
|
|
3
|
+
## 1.0.0
|
|
4
|
+
|
|
5
|
+
### Major Changes
|
|
6
|
+
|
|
7
|
+
- 417e6dc: Il core chiede Node 26 o successivo (`engines`, ADR-0107). L'immagine dell'artefatto
|
|
8
|
+
(`deploy/Dockerfile`) parte da `node:26-slim`, e il boilerplate di `etl init` nasce con `engines`
|
|
9
|
+
`>=26` e Node 26 nei workflow `ci.yml` e `image.yml`. In un repo cliente già nato `etl upgrade`
|
|
10
|
+
porta i due workflow gestiti a Node 26, mentre `engines` del suo `package.json` si alza a mano. Un
|
|
11
|
+
server PM2 va aggiornato a Node 26 prima del bump del core.
|
|
12
|
+
- 032d9e1: Prima versione pubblicata come `@noeva/etl-core` (ADR-0093): il core è un pacchetto, e ogni
|
|
13
|
+
cliente scrive le sue pipeline in un repo cliente, con il catalogo in `etl.config.ts` e la CLI
|
|
14
|
+
`etl` del pacchetto. L'API pubblica è la radice più un subpath per area, con la mappa `exports`
|
|
15
|
+
come unico confine.
|
|
16
|
+
|
|
17
|
+
Il pacchetto è pubblico su npmjs.com, sull'org `noeva` (ADR-0105): si installa senza token e
|
|
18
|
+
senza righe di registry, quindi il `.npmrc` del repo cliente non dichiara un registry, `ci.yml` e
|
|
19
|
+
`image.yml` installano senza segreti e il Dockerfile non monta un BuildKit secret. Porta
|
|
20
|
+
`"license": "UNLICENSED"` e il file `LICENSE`, lo stesso dei pacchetti MCP di Noeva (ETL-191): tutti i
|
|
21
|
+
diritti riservati, uso consentito per interagire con i servizi Noeva secondo i termini
|
|
22
|
+
contrattuali con 4D S.R.L.
|
|
23
|
+
|
|
24
|
+
### Minor Changes
|
|
25
|
+
|
|
26
|
+
- 688ff49: Le due confezioni del deploy arrivano col pacchetto. `./deploy/Dockerfile`, con il suo
|
|
27
|
+
`Dockerfile.dockerignore`, costruisce l'immagine di un repo cliente: `node:26-slim`,
|
|
28
|
+
`pnpm install --prod --frozen-lockfile` senza credenziali,
|
|
29
|
+
`ETL_RELEASE` come build arg, la documentazione del cliente costruita nell'immagine, `ENTRYPOINT etl`
|
|
30
|
+
e `CMD serve`. `./pm2` esporta `ecosystem(radice)`, che avvia solo `etl serve` con l'arresto via
|
|
31
|
+
messaggio IPC, `kill_timeout` e `node` diretto anche su Windows: la UI con Vite su :9011 non c'è
|
|
32
|
+
più. `etl init` scrive i file gestiti `image.yml` (build e push su
|
|
33
|
+
`ghcr.io/<owner>/noeva-etl-<slug>` con tag = SHA, a mano o su tag, mai `latest`) ed
|
|
34
|
+
`ecosystem.config.cjs` di una riga. La CLI carica da sola il `.env` alla radice dell'`etl.config.ts`
|
|
35
|
+
prima di ogni comando, e le variabili già nel processo vincono. Il preset `./eslint` riconosce i
|
|
36
|
+
file `.cjs` come CommonJS di Node. I piani delle pipeline d'esempio e
|
|
37
|
+
pronte non cambiano.
|
|
38
|
+
- 772beb9: `etl catalog check` verifica la conformità del catalogo di `etl.config.ts`: scopo dei nodi,
|
|
39
|
+
changelog valido, piano senza credenziali e senza segreti (ambiente di prova da `.env.example`,
|
|
40
|
+
poi con le credenziali alternative commentate) e cartelle orfane in `src/pipelines/`. Una riga per
|
|
41
|
+
violazione su stdout, exit 1 se ce n'è una. Il `.env.example` del repo deve portare le variabili
|
|
42
|
+
obbligatorie di ogni pipeline del catalogo. Il pacchetto esporta tre preset, `./tsconfig`
|
|
43
|
+
(`moduleResolution: bundler`), `./eslint` (`no-explicit-any` e `no-console` a `error`) e
|
|
44
|
+
`./vitest` (senza soglia di coverage), e porta `eslint`, `typescript-eslint` e `vitest` fra le
|
|
45
|
+
dipendenze. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
46
|
+
- 287e06d: Tre connettori entrano nell'API pubblica: `./connectors/sendgrid` (mail via API REST di SendGrid),
|
|
47
|
+
`./connectors/mail` (`mailAction` e `mailSink`, che scelgono fra SMTP e SendGrid dalla
|
|
48
|
+
configurazione) e `./connectors/process` (un programma esterno lanciato da un nodo `action`).
|
|
49
|
+
`./testing` aggiunge `WorkspaceNoevaFinto`, un workspace Noeva in memoria, e `fetchSendgridFinto`,
|
|
50
|
+
un `fetch` finto per l'API di SendGrid. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
51
|
+
- 2d1e181: `etl deploy-ecr <cliente>` porta su ECR + ECS l'immagine di un cliente che ha scelto ECR invece di
|
|
52
|
+
GHCR (ADR-0104). Lo script arriva col pacchetto, in `deploy/deploy-ecr.sh`, e lavora sulla radice del
|
|
53
|
+
repo da cui si lancia: legge la `deploy-ecr.conf` del repo cliente, usa `etl ci` come gate (o
|
|
54
|
+
`pnpm run check` dove lo script `check` c'è) e costruisce l'immagine col Dockerfile del pacchetto, o
|
|
55
|
+
con quello alla radice se il repo l'ha preso in `unmanaged`. Le opzioni sono quelle di prima
|
|
56
|
+
(`--dry-run`, `--env`, `--solo-env`, `--solo-ecr`, `--attendi`, `etl deploy-ecr --help`). Il comando
|
|
57
|
+
non carica il `.env` del repo. Con `CLIENTE_SLUG` la `deploy-ecr.conf` dichiara di
|
|
58
|
+
quale cliente è, e il deploy si ferma su uno slug diverso. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
59
|
+
- aa59de3: `etl docs build` e `etl docs dev` costruiscono il sito di documentazione del repo con
|
|
60
|
+
configurazione, tema e componenti dei grafi dal pacchetto: in un repo cliente resta solo il
|
|
61
|
+
markdown di `docs/`, e il sito, col nome del cliente nel titolo («Noeva ETL · ACME») e gli ADR
|
|
62
|
+
compresi, va in `docs/.vitepress/dist`. Il build genera la pagina indice del catalogo,
|
|
63
|
+
`docs/catalogo.md`, da non versionare, con le pipeline pronte come righe che portano alla guida del
|
|
64
|
+
core. Prima di costruire si ferma, una riga per problema ed exit 1, se una pipeline del catalogo o
|
|
65
|
+
una sub-pipeline istanziata non ha la scheda, se un nodo non ha scopo, se un link è rotto o se un
|
|
66
|
+
link `core:` non è una pagina della guida del core installata; le pipeline pronte sono esenti. I
|
|
67
|
+
link `core:nodes/lookup.md` diventano `/guida/core/nodes/lookup`. `vitepress`, `vue`, `mermaid` e
|
|
68
|
+
`gray-matter` entrano fra le dipendenze, e il pacchetto porta la guida del core costruita in
|
|
69
|
+
`dist/guida/`. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
70
|
+
- f4bb538: `etl init <slug>` crea un repo cliente in una cartella vuota: il boilerplate del pacchetto
|
|
71
|
+
(`package.json` con gli alias `pipeline:*`, `etl.config.ts` col catalogo vuoto, `.env.example` con
|
|
72
|
+
le variabili obbligatorie del core, `tsconfig`, `eslint` e `vitest` di una riga sui preset,
|
|
73
|
+
`AGENTS.md` col blocco gestito, `CLAUDE.md` e `ci.yml`), poi `git init` e i branch `dev`, `staging`
|
|
74
|
+
e `main`. Su una cartella non vuota si ferma senza scrivere. `etl ci` è il gate del repo cliente:
|
|
75
|
+
`tsc --noEmit`, lint, format, test, `etl versions check`, `etl catalog check` ed `etl docs build`,
|
|
76
|
+
in quest'ordine, fermandosi alla prima fase che fallisce e nominandola. `ci.yml` lo lancia dopo il
|
|
77
|
+
setup, senza workflow riusabili dell'org. Le `devDependencies` del boilerplate portano la
|
|
78
|
+
toolchain (`vitest`, `eslint`, `typescript`, `prettier`, `@types/node`) con i range del core.
|
|
79
|
+
|
|
80
|
+
`etl versions check` senza la base della mappa dei branch (`origin/dev`, oppure `origin/main` per
|
|
81
|
+
`main` e per un `hotfix/*` verso `main`) non fallisce più per la base mancante: con l'avviso
|
|
82
|
+
«nessuna base (<ref>): niente da confrontare» salta bump e numero di versione e controlla solo gli
|
|
83
|
+
snapshot, così passano un repo appena creato e il bootstrap di un repo migrato con pipeline già
|
|
84
|
+
oltre la v1. Una base data con
|
|
85
|
+
`--base` che non c'è resta un errore.
|
|
86
|
+
|
|
87
|
+
- 36f9aaa: `etl upgrade [--check] [--force]`: con `--check`, in sola lettura, la versione del core installata e
|
|
88
|
+
l'ultima sul registry, il changelog fra le due con le major e «Cambia il piano» in evidenza, e la
|
|
89
|
+
deriva dei file gestiti. Senza, il bump del core (con la toolchain allineata ai suoi range) e il
|
|
90
|
+
sync dei file gestiti col template del core nuovo; si ferma su un file gestito modificato a mano,
|
|
91
|
+
salvo `--force`, e rispetta `unmanaged`; `--sync` fa solo il sync, senza registry. `etl ci` avvisa, senza fallire, di un core non aggiornato.
|
|
92
|
+
- cb938fa: `etl serve` serve la documentazione: su `/guida/` il sito del cliente, che `etl docs build`
|
|
93
|
+
costruisce in `docs/.vitepress/dist`, e su `/guida/core/` la guida del core del pacchetto
|
|
94
|
+
installato (`dist/guida/`), con gli URL puliti e il `404.html` di ciascun sito. `etl serve` non
|
|
95
|
+
costruisce niente: se il sito del cliente manca, `/guida/` dice «Documentazione del cliente non
|
|
96
|
+
costruita» e porta alla guida del core, e il log lo segnala con un avviso senza fermare l'avvio.
|
|
97
|
+
La guida del core del pacchetto si costruisce col prefisso `/guida/core/`, e la favicon dei due
|
|
98
|
+
siti segue il loro prefisso. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
99
|
+
- 593fdfa: La guida del core è una sola, la stessa nel pacchetto (`dist/guida/`) e su Cloudflare: escono le
|
|
100
|
+
varianti `app` e `public`, `NOEVA_DOCS_TARGET` e i blocchi `::: solo-app`. Non contiene ADR, piani,
|
|
101
|
+
processo del team né clienti, e ha le sezioni «Pipeline pronte» ed «Esempi», generate dal catalogo
|
|
102
|
+
del core. Il manifesto `pagine.json` ora porta le schede delle pipeline pronte, quindi un link
|
|
103
|
+
`core:pipelines/test-posta.md` da un repo cliente si valida. In `etl docs build` un link a un file
|
|
104
|
+
che esiste ma non si pubblica, o fuori da `docs/`, ferma il build anche nella guida del core. Le
|
|
105
|
+
pagine di sviluppo descrivono il repo cliente, e una pagina nuova elenca le variabili d'ambiente del
|
|
106
|
+
core con i default. Nuova pipeline d'esempio `movimenti-per-conto`, di riferimento per `parse`, `sort`
|
|
107
|
+
e `serialize`. I piani delle pipeline d'esempio e pronte esistenti non cambiano.
|
|
108
|
+
- 5b34808: `./connectors/jira` esporta `istanzaJiraDichiarata(id)`, il sito Jira da passare ad
|
|
109
|
+
`ambienteDellaPipeline` nel membro `environment(env)`: `etl env check` vede così anche
|
|
110
|
+
`JIRA_<ID>_EMAIL` e `JIRA_<ID>_API_TOKEN`, che il piano non mostra, e non dà le variabili del sito
|
|
111
|
+
per sconosciute. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
112
|
+
- 2faf13d: `etl agent sync` copia nel repo il kit dell'agente del core installato: le skill `etl-graph`,
|
|
113
|
+
`new-pipeline`, `new-connector`, `new-transform`, `etl-review` e `doc-sync` in
|
|
114
|
+
`.claude/skills/noeva-etl-*`, i subagent di scaffolding e di review in `.claude/agents/noeva-etl-*`
|
|
115
|
+
e la guardia sui branch in `.claude/hooks/noeva-etl-branch-guard.sh`, con la sua voce in
|
|
116
|
+
`.claude/settings.json`. Scrive anche il blocco gestito di `AGENTS.md`, con le regole del core su
|
|
117
|
+
upgrade, doc nello stesso commit, `--realign` e i tre rollback, e lascia al repo il resto del file
|
|
118
|
+
e di `.claude/`. Toglie le voci `noeva-etl-*` che il kit non ha più e salta quelle dichiarate in
|
|
119
|
+
`unmanaged`. `etl init` lancia il sync, quindi un repo nuovo nasce col kit. Il pacchetto pubblica
|
|
120
|
+
la cartella `kit/` intera. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
121
|
+
- a5f661c: `./connectors/sendgrid` esporta `istanzaSendgridDichiarata(id)`, l'account SendGrid da passare ad
|
|
122
|
+
`ambienteDellaPipeline` nel membro `environment(env)`: `etl env check` vede così anche
|
|
123
|
+
`SENDGRID_API_KEY`, che il piano non mostra, e non dà le variabili dell'account per sconosciute.
|
|
124
|
+
|
|
125
|
+
`etl versions check` senza la base della mappa dei branch (un repo mai pubblicato, il bootstrap di
|
|
126
|
+
uno migrato) non salta più tutto: con l'avviso «nessuna base» salta solo il bump richiesto e la
|
|
127
|
+
versione uguale a base + 1, e controlla comunque che lo snapshot della versione corrente ci sia e
|
|
128
|
+
coincida col piano. Un repo che prima era verde senza base con uno snapshot sbagliato ora esce
|
|
129
|
+
con 1. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
130
|
+
|
|
131
|
+
- 781e8d0: Lo storage S3, SFTP e FTP di `./connectors/file` prende la config di un'istanza al posto di un
|
|
132
|
+
client già connesso (ADR-0103): `s3Storage(config, { bucket })`, `sftpStorage(config)` e
|
|
133
|
+
`ftpStorage(config)`, con `config` da `loadS3Registry`, `loadSftpRegistry` o `loadFtpRegistry`. Il
|
|
134
|
+
connettore costruisce il client, apre la sessione alla prima operazione e la chiude quando non ne
|
|
135
|
+
resta nessuna in corso, anche su errore e abort; una sessione su cui un'operazione fallisce non si
|
|
136
|
+
riusa. Un repo cliente non importa più
|
|
137
|
+
`@aws-sdk/client-s3`, `ssh2-sftp-client` né `basic-ftp`. L'opzione `client` sparisce; restano
|
|
138
|
+
`name`, si aggiungono `timeoutMs` (default 30 secondi) e `creaClient`, la porta dei test verso
|
|
139
|
+
`ClientS3`, `ClientSftp` e `ClientFtp`. Per `environment(env)` arrivano `istanzaS3Dichiarata`,
|
|
140
|
+
`istanzaSftpDichiarata` e `istanzaFtpDichiarata`, con i manifest `MANIFEST_S3`, `MANIFEST_SFTP` e
|
|
141
|
+
`MANIFEST_FTP`. I loader elencano tutte le variabili mancanti insieme, e un `SFTP_PORT` non valido
|
|
142
|
+
non finisce più nel messaggio. `ftpStorage` scrive a partire dalla home del login e non da `/`,
|
|
143
|
+
che su un server senza chroot non è scrivibile. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
144
|
+
- a9a864e: Il connettore Jira Cloud entra nell'API pubblica: `./connectors/jira` esporta `jiraIssues` (pieno o
|
|
145
|
+
incrementale), i lookup `jiraIssueLookup`, `jiraChangelogLookup`, `jiraCommentsLookup` e
|
|
146
|
+
`jiraWorklogsLookup`, le azioni di scrittura (`jiraCreateIssue`, `jiraUpdateIssue`,
|
|
147
|
+
`jiraTransition`, `jiraUpsertIssue`, `jiraAddComment`, `jiraAddWorklog`, `jiraLinkIssues`),
|
|
148
|
+
`istanzaJiraPerIlPiano` e i convertitori fra Markdown, ADF e testo. Le istanze si dichiarano con
|
|
149
|
+
le variabili `JIRA_*`. I piani delle pipeline d'esempio e pronte non cambiano.
|
|
150
|
+
- f3dbed1: Il connettore Zoho CRM entra nell'API pubblica: `./connectors/zoho` esporta `zohoCrmRecords`, il
|
|
151
|
+
source dei record di un modulo con i soli campi dichiarati, in ordine di `id` (Records API v8 fino a
|
|
152
|
+
100.000 record, Query API COQL oltre), il registry delle organizzazioni (`loadZohoRegistry`,
|
|
153
|
+
`loadZohoInstance`), `istanzaZohoPerIlPiano` e le funzioni sulle colonne (`colonneZoho`,
|
|
154
|
+
`schemaRecordZoho`). Le organizzazioni si dichiarano con le variabili `ZOHO_*`; il token lo rinnova
|
|
155
|
+
un'identità `OAUTH_*`. `PREFISSO_ZOHO` entra in `./connector-kit`. In `./connectors/oauth`,
|
|
156
|
+
`fornitoreToken` tratta una risposta 200 con `{ error }` nel corpo (come la dà Zoho quando il
|
|
157
|
+
rinnovo fallisce) come un rifiuto: il `ConfigError` porta il codice del provider invece del
|
|
158
|
+
messaggio generico. I piani delle pipeline d'esempio
|
|
159
|
+
e pronte non cambiano.
|
|
160
|
+
|
|
161
|
+
### Patch Changes
|
|
162
|
+
|
|
163
|
+
- c1bad71: Il pacchetto non porta più codice né nomi di un cliente: il catalogo del repo del core non registra
|
|
164
|
+
più la pipeline di un cliente, che vive nel suo repo cliente (ETL-276). `etl deploy-ecr` legge solo la
|
|
165
|
+
`deploy-ecr.conf` alla radice del repo cliente: la ricerca in `clienti/<cliente>/`, che serviva ai
|
|
166
|
+
clienti ospitati nel core, è tolta. Né l'API né i piani delle pipeline d'esempio e pronte cambiano.
|
|
167
|
+
- ff4930d: `etl versions check` con una base, e il rollback che legge i changelog allo stesso modo, tornano
|
|
168
|
+
a funzionare su Node 20 e 22. Il changelog della base, scritto in una cartella temporanea per
|
|
169
|
+
importarlo, ha accanto un `package.json` con `"type": "module"`: senza, `tsx` lo caricava come
|
|
170
|
+
CommonJS e Node si fermava nel ciclo `require(esm)` («non si importa da solo»). Su Node 24 il gate
|
|
171
|
+
passava già. Lo smoke test del pacchetto prova ora il gate anche con una base (ETL-287).
|
|
172
|
+
- 2d17b19: `etl init` funziona dal pacchetto pubblicato. Si fermava con uno `ZodError` su `packageManager`:
|
|
173
|
+
il pnpm del repo cliente veniva letto dal `package.json` del core, e `pnpm pack` toglie quel campo
|
|
174
|
+
dal manifest pubblicato. Ora il valore sta nel codice del core, allineato al suo `packageManager`
|
|
175
|
+
da un test. `etl init --help` (e `-h`) stampa l'uso invece di prendere l'opzione per uno slug. Lo
|
|
176
|
+
smoke test del pacchetto lancia `etl init` dal tarball installato, non più dal `dist/` del repo
|
|
177
|
+
(ETL-286).
|
|
178
|
+
- 24c50e9: Il pacchetto non porta più il materiale di sviluppo del tema delle docs: i test e le fixture di
|
|
179
|
+
`docs/.vitepress/`, `wrangler.jsonc`, la cache di VitePress e i siti costruiti. `pnpm pack`, e
|
|
180
|
+
quindi `changeset publish`, ignorava le negazioni di `files`; ora li esclude
|
|
181
|
+
`docs/.vitepress/.npmignore`. Uno smoke test, nel check e in CI, installa il tarball in un repo
|
|
182
|
+
nato da `etl init` e verifica `etl ci`, `etl run` ed `etl serve` con la guida del core del
|
|
183
|
+
pacchetto. I piani delle pipeline d'esempio e pronte non cambiano.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
Copyright © 2026 4D S.R.L. Tutti i diritti riservati.
|
|
2
|
+
|
|
3
|
+
"Noeva" è un marchio registrato di 4D S.R.L. (P.IVA IT03000790356),
|
|
4
|
+
Via Brigata Reggio 32, 42124 Reggio Emilia (RE), Italia.
|
|
5
|
+
|
|
6
|
+
Questo software è concesso in licenza, non venduto. È consentito installare ed
|
|
7
|
+
eseguire questo pacchetto esclusivamente per interagire con i servizi Noeva,
|
|
8
|
+
in conformità ai termini contrattuali applicabili tra l'utente e 4D S.R.L.
|
|
9
|
+
|
|
10
|
+
Non sono concessi diritti di modifica, ridistribuzione, sublicenza, decompilazione
|
|
11
|
+
o reverse engineering, salvo diversa autorizzazione scritta di 4D S.R.L. o per
|
|
12
|
+
quanto inderogabilmente consentito dalla legge applicabile.
|
|
13
|
+
|
|
14
|
+
IL SOFTWARE È FORNITO "COSÌ COM'È", SENZA GARANZIE DI ALCUN TIPO, ESPRESSE O
|
|
15
|
+
IMPLICITE, INCLUSE, A TITOLO ESEMPLIFICATIVO, LE GARANZIE DI COMMERCIABILITÀ E
|
|
16
|
+
IDONEITÀ A UNO SCOPO PARTICOLARE. IN NESSUN CASO 4D S.R.L. SARÀ RESPONSABILE PER
|
|
17
|
+
QUALSIASI RECLAMO, DANNO O ALTRA RESPONSABILITÀ DERIVANTE DALL'USO DEL SOFTWARE.
|
|
18
|
+
|
|
19
|
+
Contatti: hello@noeva.ai
|
package/README.md
CHANGED
package/deploy/Dockerfile
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
# Il contesto lo filtra `Dockerfile.dockerignore`, accanto a questo file. Un
|
|
17
17
|
# cliente che ha bisogno di altro (un CA aziendale, un proxy) copia il
|
|
18
18
|
# Dockerfile nel suo repo e se ne assume l'aggiornamento.
|
|
19
|
-
FROM node:
|
|
19
|
+
FROM node:26-slim
|
|
20
20
|
ENV NODE_ENV=production \
|
|
21
21
|
COREPACK_ENABLE_DOWNLOAD_PROMPT=0 \
|
|
22
22
|
PATH=/app/node_modules/.bin:$PATH
|
package/dist/guida/404.html
CHANGED
|
@@ -6,10 +6,10 @@
|
|
|
6
6
|
<title>404 · Noeva ETL</title>
|
|
7
7
|
<meta name="description" content="Not Found">
|
|
8
8
|
<meta name="generator" content="VitePress v1.6.4">
|
|
9
|
-
<link rel="preload stylesheet" href="/guida/core/assets/style.
|
|
9
|
+
<link rel="preload stylesheet" href="/guida/core/assets/style.DFlUbYCk.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.DlsuGVZn.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
14
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
15
15
|
<meta name="theme-color" content="#0a0e15">
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
</head>
|
|
19
19
|
<body>
|
|
20
20
|
<div id="app"></div>
|
|
21
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"guide_claude-code_index.md\":\"
|
|
21
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"DP2i3GFv\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CwG77qGO\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DTIhkkg9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
22
22
|
|
|
23
23
|
</body>
|
|
24
24
|
</html>
|