@sdt-tools/core — core engine powering SDT

The TypeScript engine behind SDT — Snowflake Data Tools: the Snowflake object model, extractors, compare engine, safety classifier, and deploy/migration emitters.

🚧 Public Beta. This is the library layer. Most people want the @sdt-tools/cli command or the "Snowflake Data Tools" VS Code extension — both are thin layers over this package. Use @sdt-tools/core directly only if you are embedding the engine in your own tooling.

Main API surface areas

| Subpath | Purpose | | ----------------------------- | ------------------------------------------------------------------------------------------------------- | | @sdt-tools/core/model | TypeScript types for every Snowflake object (discriminated by objectType). | | @sdt-tools/core/connection | Snowflake connection wrapper, profile store, connection pool. | | @sdt-tools/core/extract | BaseExtractor, AccountExtractor, per-type extractors (GET_DDL → SHOW fallback). | | @sdt-tools/core/compare | CompareEngine, CompareSource (Project / Pac / Live), per-type differs. | | @sdt-tools/core/safety | Safety classifier — returns SAFE / DESTRUCTIVE / EXPENSIVE / UNRECOVERABLE findings with gates. | | @sdt-tools/core/deploy | ScriptGenerator + per-type migration emitters + dependency-tier ordering. | | @sdt-tools/core/project | .sdtproj reader/writer + zod-validated schema. | | @sdt-tools/core/pac | .sdtpac ZIP artifact reader/writer. | | @sdt-tools/core/refactoring | Refactor-log model for rename / move operations. | | @sdt-tools/core/variables | $(VAR) substitution for SQL and deploy scripts. | | @sdt-tools/core/drift | Drift detection helpers. | | @sdt-tools/core/importers | Importers from schemachange, dbt, dacpac, Liquibase/Flyway, Atlas, raw .sql, and more. |

Install

npm i @sdt-tools/core

Documentation

• Public repo (issues, docs, pricing): https://github.com/GVOrganization/sdt-tools
• Architecture: docs/ARCHITECTURE.md

SDT is an independent tool and is not affiliated with or endorsed by Snowflake Inc.

License: Apache-2.0.