Skip to content

Commit 3213cb8

Browse files
committed
docs(spec): 重生成 connector 参考页,并更新一处指向已删文件的注释
- content/docs/references/integration/connector.mdx 随 connector.zod.ts 的 TSDoc 修正重生成(三条死链消失) - alias-integrity.test.ts 的十点测量里 etl.zod.ts 已不在:保留原计数并注明 退役,论点是 AST 盲区,不因少一个文件而变弱
1 parent b93ee57 commit 3213cb8

2 files changed

Lines changed: 22 additions & 13 deletions

File tree

content/docs/references/integration/connector.mdx

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,12 @@ Defines the standard connector specification for external system integration.
1111
Connectors enable ObjectStack to sync data with SaaS apps, databases, file storage,
1212
and message queues through a unified protocol.
1313

14-
**Positioning in the sync/integration layering** (L1 "Simple Sync" was
15-
retired in #4738 — narrative-only, zero consumers; see
16-
`packages/spec/docs/SYNC_ARCHITECTURE.md`):
17-
- **ETL Pipeline** ([automation/etl.zod.ts](/docs/references/automation/etl)) - Data engineers - Aggregate 10 sources to warehouse
14+
**Positioning in the sync/integration layering** — this file is now the ONLY
15+
layer. Both layers above it were retired under ADR-0049 for the same measured
16+
reason, that no engine ever executed them: L1 "Simple Sync"
17+
(`automation/sync.zod.ts`) in #4738, and L2 "ETL Pipeline"
18+
(`automation/etl.zod.ts`) in #6414. See
19+
`packages/spec/docs/SYNC_ARCHITECTURE.md`:
1820
- **Enterprise Connector** (THIS FILE) - System integrators - Full SAP integration; connector-attached sync via `syncConfig`
1921

2022
**SCOPE: Most comprehensive integration layer.**
@@ -95,9 +97,11 @@ Authentication is now imported from the canonical `auth/config.zod.ts`.
9597
- Microsoft Dynamics 365 connector
9698

9799
**When to downgrade:**
98-
- Data transformation only → Use [ETL Pipeline](/docs/references/automation/etl)
99-
100-
See also: [../automation/etl.zod.ts](/docs/references/automation/etl) for the ETL Pipeline layer (data engineering)
100+
- Per-field value conversion on import only → the import mapping's own
101+
`transform` (`data/mapping.zod.ts`), which the REST import path executes
102+
row by row. (This used to point at `automation/etl.zod.ts`; L2 was retired
103+
at #6414 for having no executor, so the pointer would have been a signpost
104+
landing nowhere — the same defect class this header names below.)
101105

102106
## There is no "Trigger Registry" alternative
103107

@@ -110,9 +114,11 @@ platform's authority, at a dead end (#4499; removed alongside the #4480
110114
per-provider template cluster). The same defect class as the
111115
`capabilities.readOnly` prescription #4487 corrected: a signpost must land
112116
somewhere enforced. Lightweight cases are served HERE — a connector instance
113-
with simple `auth` — or by `automation/etl.zod.ts` for transformation
114-
pipelines. (The automation-side L1 "Simple Sync" file was itself retired as
115-
a dead end of the same class in #4738.)
117+
with simple `auth`. (Both automation-side layers were themselves retired as
118+
dead ends of the same class: L1 "Simple Sync" in #4738, L2 `etl.zod.ts` in
119+
#6414. This paragraph named L2 as the transformation destination until the
120+
second retirement; a signpost that must land somewhere enforced cannot make
121+
an exception for itself.)
116122

117123
<Callout type="info">
118124
**Source:** `packages/spec/src/integration/connector.zod.ts`

packages/spec/src/shared/alias-integrity.test.ts

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,12 @@
3131
* no source-literal reader can see, so the target check has to be suppressed
3232
* for most of the interesting schemas. `.shape` sees them.
3333
* 2. **Assembled tables.** Ten call sites build `aliases` (or `surface`) from
34-
* something other than a literal — `data/field.zod.ts`, `ui/theme.zod.ts`,
35-
* `automation/etl.zod.ts` and others. The AST reads those as empty and
36-
* reports them clean.
34+
* something other than a literal — `data/field.zod.ts`, `ui/theme.zod.ts`
35+
* and others. The AST reads those as empty and reports them clean.
36+
* (`automation/etl.zod.ts` was one of the ten when this was measured; the
37+
* whole L2 layer was retired at #6414, which is why the count above is kept
38+
* as the measurement it was rather than silently decremented — the argument
39+
* is about the AST's blind spot, and it does not get weaker by one file.)
3740
* 3. **Colliding surfaces.** `'this field group'` names two different schemas
3841
* (`data/object.zod.ts`, `studio/object-designer.zod.ts`), so the surface
3942
* string is not a key and the hand-map silently judges one against the

0 commit comments

Comments
 (0)