@ddt-tools/core
v0.2.5
Published
DDT core library — object model, extractors, comparers, builders, deployers for Databricks Unity Catalog.
Downloads
387
Readme
@ddt-tools/core — core engine powering DDT
The TypeScript engine behind DDT — Databricks Data Tools: the Unity Catalog object model, extractors, compare engine, safety classifier, and deploy/migration emitters. Sibling of @sdt-tools/core — same design, different platform.
🚧 Public Beta. This is the library layer. Most people want the
@ddt-tools/clicommand or the "Databricks Data Tools" VS Code extension — both are thin layers over this package. Use@ddt-tools/coredirectly only if you are embedding the engine in your own tooling.
Main API surface areas
| Subpath | Purpose |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| @ddt-tools/core/model | TypeScript types for every Unity Catalog object (discriminated by objectType). |
| @ddt-tools/core/connection | Databricks connection wrapper, profile store (PAT / OAuth-M2M). |
| @ddt-tools/core/extract | AccountExtractor + generic extractor (SHOW <type> → SHOW CREATE). |
| @ddt-tools/core/compare | CompareEngine, CompareSource (Project / Pac / Live), per-type differs. |
| @ddt-tools/core/safety | Safety classifier — returns SAFE / DESTRUCTIVE / EXPENSIVE / UNRECOVERABLE findings with gates; interface parity with the SDT side. |
| @ddt-tools/core/deploy | ScriptGenerator + per-type migration emitters + dependency-tier ordering. |
| @ddt-tools/core/project | .ddtproj reader/writer + zod-validated schema. |
| @ddt-tools/core/pac | .ddtpac ZIP artifact reader/writer (mirrors .sdtpac). |
| @ddt-tools/core/refactoring | Refactor-log model for rename / move operations. |
| @ddt-tools/core/variables | $(VAR) substitution for SQL and deploy scripts. |
| @ddt-tools/core/drift | Drift detection helpers. |
Install
npm i @ddt-tools/coreDocumentation
- Public repo (issues, docs, pricing): https://github.com/GVOrganization/ddt-tools
- Connection setup:
docs/CONNECTION_SETUP.md
DDT is an independent tool and is not affiliated with or endorsed by Databricks Inc.
License: Apache-2.0.
