@sdt-tools/cli 0.2.0 → 0.2.6

package/dist/template-ZERIXVXF.js

@@ -0,0 +1,403 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/template.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+function templateCommand() {
+  const cmd = new Command("template");
+  cmd.description(
+    "Scaffold a common schema pattern (scd1|scd2|scd3|scd4|scd6|star|fact|scd2-merge|current-view|time-series|audit). Writes .sql files into <out>/."
+  ).argument(
+    "<kind>",
+    "Pattern to scaffold: scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit"
+  ).argument("<name>", "Base object name (e.g. CUSTOMER, ORDERS).").option("--db <database>", "Database name. Default DEMO_DB.", "DEMO_DB").option("--schema <schema>", "Schema name. Default PUBLIC.", "PUBLIC").option("-o, --out <path>", "Output directory. Default <kind>-<name>/.").option(
+    "--dims <dims>",
+    "[star|fact] Comma-separated dimension names. Default: customer,product,date.",
+    "customer,product,date"
+  ).option(
+    "--track <cols>",
+    "[scd3|scd6] Comma-separated columns to track previous-values for. Default: attribute_1.",
+    "attribute_1"
+  ).option(
+    "--source <fqn>",
+    "[scd2-merge] Source/staging table fully-qualified name. Default DEMO_DB.PUBLIC.<name>_STAGE."
+  ).option("--retention-days <n>", "[time-series] Retention window in days. Default 90.", "90").option(
+    "--hybrid",
+    "Emit CREATE HYBRID TABLE (Unistore row-store) instead of CREATE OR ALTER TABLE. Constraints become enforced; CLUSTER BY is suppressed (not supported on Hybrid Tables)."
+  ).action(async (kindArg, nameArg, opts) => {
+    const kind = String(kindArg).toLowerCase();
+    const name = String(nameArg);
+    const db = String(opts.db);
+    const schema = String(opts.schema);
+    const hybrid = Boolean(opts.hybrid);
+    const out = opts.out ? path.resolve(String(opts.out)) : path.resolve(`${kind}-${name.toLowerCase()}`);
+    await fs.mkdir(out, { recursive: true });
+    if (hybrid && (kind === "scd2-merge" || kind === "current-view")) {
+      console.error(`Warning: --hybrid has no effect on ${kind} (no table DDL emitted).`);
+    }
+    const ctx = { db, schema, name, hybrid };
+    let files;
+    const trackCols = String(opts.track).split(",").map((s) => s.trim()).filter(Boolean);
+    const dims = String(opts.dims).split(",").map((s) => s.trim()).filter(Boolean);
+    if (kind === "scd1") files = renderScd1(ctx);
+    else if (kind === "scd2") files = renderScd2(ctx);
+    else if (kind === "scd3") files = renderScd3(ctx, trackCols);
+    else if (kind === "scd4") files = renderScd4(ctx);
+    else if (kind === "scd6") files = renderScd6(ctx, trackCols);
+    else if (kind === "star") files = renderStar(ctx, dims);
+    else if (kind === "fact") files = renderFact(ctx, dims);
+    else if (kind === "scd2-merge")
+      files = renderScd2Merge(
+        ctx,
+        opts.source ? String(opts.source) : `${db}.${schema}.${name.toUpperCase()}_STAGE`
+      );
+    else if (kind === "current-view") files = renderCurrentView(ctx);
+    else if (kind === "time-series") files = renderTimeSeries(ctx, Number(opts.retentionDays));
+    else if (kind === "audit") files = renderAudit(ctx);
+    else
+      throw new Error(
+        `Unknown template kind: ${kind}. Use scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit.`
+      );
+    for (const [rel, contents] of Object.entries(files)) {
+      const filePath = path.join(out, rel);
+      await fs.mkdir(path.dirname(filePath), { recursive: true });
+      await fs.writeFile(filePath, contents, "utf8");
+      console.error(
+        `  wrote ${path.relative(process.cwd(), filePath)} (${contents.length} bytes)`
+      );
+    }
+    console.error(
+      `Done. ${Object.keys(files).length} file(s) written to ${path.relative(process.cwd(), out)}.`
+    );
+  });
+  return cmd;
+}
+function header(why) {
+  return `-- Generated by \`sdt template\`. Why this pattern is the right shape:
+--   ${why}
+--
+-- Edit freely; this is just a starting point.
+
+`;
+}
+function tableKw(c, tableName) {
+  return c.hybrid ? `CREATE HYBRID TABLE ${c.db}.${c.schema}.${tableName}` : `CREATE OR ALTER TABLE ${c.db}.${c.schema}.${tableName}`;
+}
+function pkConstraint(name, cols, c) {
+  return c.hybrid ? `CONSTRAINT ${name} PRIMARY KEY (${cols})` : `CONSTRAINT ${name} PRIMARY KEY (${cols}) NOT ENFORCED`;
+}
+function ukConstraint(name, cols, c) {
+  return c.hybrid ? `CONSTRAINT ${name} UNIQUE (${cols})` : `CONSTRAINT ${name} UNIQUE (${cols}) NOT ENFORCED`;
+}
+function clusterBy(expr, c) {
+  return c.hybrid ? "" : `
+CLUSTER BY (${expr})`;
+}
+function renderScd1(c) {
+  const upper = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Tables/${upper}.sql`]: header(
+      `SCD1 overwrites the row in place when an attribute changes. No history is
+--   preserved. Use this when downstream consumers only care about the *current*
+--   state and the dimension is small enough that losing history is fine.
+--   LOAD_TS/UPDATED_TS give you minimal auditability without history-table cost.`
+    ) + `${tableKw(c, upper)} (
+  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key \u2014 stable across overwrites',
+  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',
+  ATTRIBUTE_1       VARCHAR                                  COMMENT 'Replace with real columns',
+  ATTRIBUTE_2       VARCHAR                                  COMMENT 'Replace with real columns',
+  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the row was first inserted',
+  UPDATED_TS        TIMESTAMP_NTZ                            COMMENT 'When the row was last overwritten',
+  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)},
+  ${ukConstraint(`UK_${upper}_BK`, `${upper}_BK`, c)}
+)
+COMMENT = 'SCD1 dimension \u2014 overwrite-on-change. No history kept; join on ${upper}_BK.';
+`
+  };
+}
+function renderScd2(c) {
+  const upper = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Tables/${upper}.sql`]: header(
+      `SCD2 preserves every historical version of a row by closing the previous row's
+--   VALID_TO when the natural key reappears with new attribute values. Use this
+--   when downstream analytics needs "what did this row look like on date X".`
+    ) + `${tableKw(c, upper)} (
+  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key \u2014 unique per version',
+  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key \u2014 stable across versions',
+  ATTRIBUTE_1       VARCHAR                                  COMMENT 'Replace with real columns',
+  ATTRIBUTE_2       VARCHAR                                  COMMENT 'Replace with real columns',
+  VALID_FROM        TIMESTAMP_NTZ NOT NULL                  COMMENT 'When this version became current',
+  VALID_TO          TIMESTAMP_NTZ                            COMMENT 'When this version was superseded; NULL while current',
+  IS_CURRENT        BOOLEAN       NOT NULL                  COMMENT 'TRUE only on the latest row per BK',
+  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',
+  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)}
+)
+COMMENT = 'SCD2 dimension \u2014 preserves history. Treat business key + IS_CURRENT as the natural join target.';
+`,
+    [`${c.db}/${c.schema}/Streams/${upper}_STREAM.sql`]: header(
+      `Stream over the SCD2 table lets downstream tasks consume only the rows that
+--   changed since they last read. Drop this if you don't have a downstream
+--   consumer that needs incremental updates.`
+    ) + `CREATE OR ALTER STREAM ${c.db}.${c.schema}.${upper}_STREAM ON TABLE ${c.db}.${c.schema}.${upper}
+COMMENT = 'CDC stream over ${upper}. Read by downstream tasks for incremental processing.';
+`
+  };
+}
+function renderScd3(c, tracked) {
+  const upper = c.name.toUpperCase();
+  const cols = (tracked.length ? tracked : ["attribute_1"]).map((t) => t.toUpperCase());
+  const prevCols = cols.map(
+    (t) => `  PREV_${t}       VARCHAR                                  COMMENT 'Prior value of ${t}, captured on overwrite'`
+  ).join(",\n");
+  return {
+    [`${c.db}/${c.schema}/Tables/${upper}.sql`]: header(
+      `SCD3 keeps the current value plus one prior value per tracked column. Use
+--   this when downstream needs "current vs immediately prior" but doesn't need
+--   the full history. Cheaper than SCD2 but lossy beyond one change.`
+    ) + `${tableKw(c, upper)} (
+  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',
+  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',
+${cols.map((t) => `  ${t}             VARCHAR                                  COMMENT 'Current value'`).join(",\n")},
+${prevCols},
+  PREV_CHANGED_TS   TIMESTAMP_NTZ                            COMMENT 'When prior values were captured',
+  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',
+  UPDATED_TS        TIMESTAMP_NTZ                            COMMENT 'When this row was last overwritten',
+  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)},
+  ${ukConstraint(`UK_${upper}_BK`, `${upper}_BK`, c)}
+)
+COMMENT = 'SCD3 dimension \u2014 current + one prior value for ${cols.join(", ")}.';
+`
+  };
+}
+function renderScd4(c) {
+  const upper = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Tables/${upper}.sql`]: header(
+      `SCD4 keeps a small, fast "current" table for joins and a separate history
+--   table for slow analytics. Use this when the current-state lookups are hot
+--   (every fact query joins to it) and you want to keep that join skinny.`
+    ) + `${tableKw(c, upper)} (
+  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',
+  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',
+  ATTRIBUTE_1       VARCHAR                                  COMMENT 'Replace with real columns',
+  ATTRIBUTE_2       VARCHAR                                  COMMENT 'Replace with real columns',
+  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the row was inserted',
+  UPDATED_TS        TIMESTAMP_NTZ                            COMMENT 'When the row was last overwritten',
+  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)},
+  ${ukConstraint(`UK_${upper}_BK`, `${upper}_BK`, c)}
+)
+COMMENT = 'SCD4 current-state table. Pair with ${upper}_HISTORY for change tracking.';
+`,
+    [`${c.db}/${c.schema}/Tables/${upper}_HISTORY.sql`]: header(
+      `Companion history table for SCD4. Rows are appended (never updated) when
+--   the current table is overwritten \u2014 same columns plus a CHANGED_TS so you
+--   can replay "what did this BK look like at time T".`
+    ) + `${tableKw(c, `${upper}_HISTORY`)} (
+  ${upper}_HISTORY_SK NUMBER(38,0) NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate id for each historical snapshot',
+  ${upper}_BK         VARCHAR      NOT NULL                  COMMENT 'Business key',
+  ATTRIBUTE_1         VARCHAR                                 COMMENT 'Snapshot of column at CHANGED_TS',
+  ATTRIBUTE_2         VARCHAR                                 COMMENT 'Snapshot of column at CHANGED_TS',
+  CHANGED_TS          TIMESTAMP_NTZ NOT NULL                 COMMENT 'When this snapshot was taken',
+  LOAD_TS             TIMESTAMP_NTZ NOT NULL DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the row was appended',
+  ${pkConstraint(`PK_${upper}_HISTORY`, `${upper}_HISTORY_SK`, c)}
+)${clusterBy(`${upper}_BK, CHANGED_TS`, c)}
+COMMENT = 'SCD4 history-side. Append-only snapshots of ${upper}; reconstruct as-of state via window functions.';
+`
+  };
+}
+function renderScd6(c, tracked) {
+  const upper = c.name.toUpperCase();
+  const cols = (tracked.length ? tracked : ["attribute_1"]).map((t) => t.toUpperCase());
+  const prevCols = cols.map(
+    (t) => `  PREV_${t}       VARCHAR                                  COMMENT 'Prior value of ${t}'`
+  ).join(",\n");
+  return {
+    [`${c.db}/${c.schema}/Tables/${upper}.sql`]: header(
+      `SCD6 = 1 + 2 + 3 hybrid. You get full SCD2 history (rows per version),
+--   SCD3 "current vs prior" lookback on hot columns, and SCD1 "current value"
+--   denormalized onto every historical row. Heavyweight; use when downstream
+--   consumers ask both "what was it at time T?" and "what's the current value
+--   for the BK on this old row?" in the same query.`
+    ) + `${tableKw(c, upper)} (
+  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key \u2014 unique per version',
+  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key \u2014 stable across versions',
+${cols.map((t) => `  ${t}             VARCHAR                                  COMMENT 'Value on THIS version'`).join(",\n")},
+${cols.map((t) => `  CURRENT_${t}     VARCHAR                                  COMMENT 'Current value for the BK (SCD1 denorm)'`).join(",\n")},
+${prevCols},
+  VALID_FROM        TIMESTAMP_NTZ NOT NULL                  COMMENT 'When this version became current',
+  VALID_TO          TIMESTAMP_NTZ                            COMMENT 'When this version was superseded; NULL while current',
+  IS_CURRENT        BOOLEAN       NOT NULL                  COMMENT 'TRUE only on the latest row per BK',
+  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',
+  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)}
+)
+COMMENT = 'SCD6 dimension \u2014 hybrid 1+2+3. Heavy but answers every common BI question without re-joining.';
+`
+  };
+}
+function renderStar(c, dims) {
+  const fact = c.name.toUpperCase();
+  const out = {};
+  for (const d of dims) {
+    const upper = d.toUpperCase();
+    out[`${c.db}/${c.schema}/Tables/DIM_${upper}.sql`] = header(`Dimension table \u2014 describes the WHAT. Joined by the fact via DIM_${upper}_SK.`) + `${tableKw(c, `DIM_${upper}`)} (
+  DIM_${upper}_SK   NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',
+  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',
+  ${upper}_NAME     VARCHAR                                  COMMENT 'Replace with real attributes',
+  COUNTRY           VARCHAR                                  COMMENT 'Example attribute',
+  ${pkConstraint(`PK_DIM_${upper}`, `DIM_${upper}_SK`, c)}
+)
+COMMENT = 'Dimension table for the ${fact} star schema.';
+`;
+  }
+  out[`${c.db}/${c.schema}/Tables/FACT_${fact}.sql`] = header(
+    `Fact table \u2014 the WHO/WHAT/WHEN/HOW-MUCH. One row per business event.
+--   Surrogate-key FKs to every dimension; measure columns hold the numbers.`
+  ) + `${tableKw(c, `FACT_${fact}`)} (
+  FACT_${fact}_SK   NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',
+${dims.map((d) => `  DIM_${d.toUpperCase()}_SK NUMBER(38,0)              COMMENT 'FK to DIM_${d.toUpperCase()}'`).join(",\n")},
+  EVENT_TS          TIMESTAMP_NTZ NOT NULL                  COMMENT 'When the event occurred',
+  MEASURE_AMOUNT    NUMBER(38,4)                             COMMENT 'Primary measure \u2014 replace with real columns',
+  MEASURE_QUANTITY  NUMBER(38,0)                             COMMENT 'Secondary measure',
+  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',
+  ${pkConstraint(`PK_FACT_${fact}`, `FACT_${fact}_SK`, c)}
+)${clusterBy("EVENT_TS", c)}
+COMMENT = 'Fact table for the ${fact} star. CLUSTER BY date keeps recent-event scans cheap.';
+`;
+  return out;
+}
+function renderFact(c, dims) {
+  const fact = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Tables/FACT_${fact}.sql`]: header(
+      `Fact-only template \u2014 assumes the named dimensions already exist. Use this
+--   when adding a new fact to an existing star, rather than scaffolding the
+--   dims a second time. Surrogate-key FKs follow the DIM_<NAME>_SK convention.`
+    ) + `${tableKw(c, `FACT_${fact}`)} (
+  FACT_${fact}_SK   NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',
+${dims.map((d) => `  DIM_${d.toUpperCase()}_SK NUMBER(38,0)              COMMENT 'FK to DIM_${d.toUpperCase()}'`).join(",\n")},
+  EVENT_TS          TIMESTAMP_NTZ NOT NULL                  COMMENT 'When the event occurred',
+  MEASURE_AMOUNT    NUMBER(38,4)                             COMMENT 'Primary measure \u2014 replace with real columns',
+  MEASURE_QUANTITY  NUMBER(38,0)                             COMMENT 'Secondary measure',
+  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',
+  ${pkConstraint(`PK_FACT_${fact}`, `FACT_${fact}_SK`, c)}
+)${clusterBy("EVENT_TS", c)}
+COMMENT = 'Fact table FACT_${fact}. Add this to an existing star \u2014 dimensions assumed to exist.';
+`
+  };
+}
+function renderScd2Merge(c, source) {
+  const upper = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Scripts/MERGE_${upper}.sql`]: header(
+      `Canonical SCD2 load. Step 1 closes the prior row when the BK reappears with
+--   different attributes (sets VALID_TO + IS_CURRENT=FALSE). Step 2 inserts the
+--   new version. Wrap both in a transaction so you don't end up with two current
+--   rows. Source: ${source}.`
+    ) + `-- Step 1 \u2014 close the previous version when attributes change for an existing BK.
+BEGIN TRANSACTION;
+
+MERGE INTO ${c.db}.${c.schema}.${upper} AS tgt
+USING (
+  SELECT
+    src.${upper}_BK,
+    src.ATTRIBUTE_1,
+    src.ATTRIBUTE_2
+  FROM ${source} AS src
+) AS src
+ON tgt.${upper}_BK = src.${upper}_BK
+   AND tgt.IS_CURRENT = TRUE
+WHEN MATCHED
+     AND (tgt.ATTRIBUTE_1 IS DISTINCT FROM src.ATTRIBUTE_1
+       OR tgt.ATTRIBUTE_2 IS DISTINCT FROM src.ATTRIBUTE_2)
+  THEN UPDATE SET
+    VALID_TO   = CURRENT_TIMESTAMP(),
+    IS_CURRENT = FALSE;
+
+-- Step 2 \u2014 insert the new version for changed BKs + brand-new BKs.
+INSERT INTO ${c.db}.${c.schema}.${upper} (
+  ${upper}_BK, ATTRIBUTE_1, ATTRIBUTE_2,
+  VALID_FROM, VALID_TO, IS_CURRENT
+)
+SELECT
+  src.${upper}_BK,
+  src.ATTRIBUTE_1,
+  src.ATTRIBUTE_2,
+  CURRENT_TIMESTAMP(),
+  NULL,
+  TRUE
+FROM ${source} AS src
+LEFT JOIN ${c.db}.${c.schema}.${upper} AS tgt
+  ON tgt.${upper}_BK = src.${upper}_BK
+     AND tgt.IS_CURRENT = TRUE
+WHERE tgt.${upper}_BK IS NULL
+   OR (tgt.ATTRIBUTE_1 IS DISTINCT FROM src.ATTRIBUTE_1
+    OR tgt.ATTRIBUTE_2 IS DISTINCT FROM src.ATTRIBUTE_2);
+
+COMMIT;
+`
+  };
+}
+function renderCurrentView(c) {
+  const upper = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Views/V_${upper}_CURRENT.sql`]: header(
+      `Current-state view over an SCD2 table. Lets downstream consumers join on
+--   one canonical "current row per BK" target without remembering the
+--   IS_CURRENT predicate. Cheap \u2014 Snowflake filter-pushdown handles it.`
+    ) + `CREATE OR REPLACE VIEW ${c.db}.${c.schema}.V_${upper}_CURRENT
+COMMENT = 'Current rows from ${upper} (SCD2). Join here instead of filtering IS_CURRENT manually.'
+AS
+SELECT *
+FROM ${c.db}.${c.schema}.${upper}
+WHERE IS_CURRENT = TRUE;
+`
+  };
+}
+function renderTimeSeries(c, retentionDays) {
+  const upper = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Tables/${upper}.sql`]: header(
+      `Time-series table \u2014 append-only, clustered by event timestamp so recent-event
+--   scans prune to a small number of micropartitions. DATA_RETENTION_TIME_IN_DAYS
+--   bounds Time Travel cost; aged-out rows must be archived elsewhere.`
+    ) + `${tableKw(c, upper)} (
+  EVENT_ID          NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate id',
+  EVENT_TS          TIMESTAMP_NTZ NOT NULL                  COMMENT 'When the event occurred',
+  EVENT_TYPE        VARCHAR                                  COMMENT 'Discriminator \u2014 index of partition by event_type if useful',
+  ENTITY_ID         VARCHAR                                  COMMENT 'Foreign key to the entity the event is about',
+  PAYLOAD           VARIANT                                  COMMENT 'Event-specific payload (semistructured)',
+  INGESTED_TS       TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When SDT loaded the row',
+  ${pkConstraint(`PK_${upper}`, "EVENT_ID", c)}
+)${clusterBy("EVENT_TS", c)}
+DATA_RETENTION_TIME_IN_DAYS = ${Math.max(1, Math.min(retentionDays, 90))}
+COMMENT = 'Time-series ${upper}. Aged out beyond DATA_RETENTION_TIME_IN_DAYS; archive separately if you need longer history.';
+`
+  };
+}
+function renderAudit(c) {
+  const upper = c.name.toUpperCase();
+  return {
+    [`${c.db}/${c.schema}/Tables/${upper}_AUDIT.sql`]: header(
+      `Audit log \u2014 append-only by convention. INSERT-only INSERT-only permissions on
+--   downstream roles enforce the "append-only" property; this table itself doesn't
+--   block updates, but the role grants do. Pair with a row-access policy if
+--   stronger guarantees are needed.`
+    ) + `${tableKw(c, `${upper}_AUDIT`)} (
+  AUDIT_ID          NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate id',
+  AUDIT_TS          TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the event was logged',
+  ACTOR             VARCHAR       NOT NULL                  COMMENT 'Who performed the action (user / service-account)',
+  ACTION            VARCHAR       NOT NULL                  COMMENT 'What happened (e.g. CREATE_USER, ROLE_GRANT)',
+  TARGET            VARCHAR                                  COMMENT 'What it was performed on',
+  DETAILS           VARIANT                                  COMMENT 'Free-form payload \u2014 keep it small',
+  ${pkConstraint(`PK_${upper}_AUDIT`, "AUDIT_ID", c)}
+)
+COMMENT = 'Audit log for ${upper}. Append-only by convention \u2014 grant INSERT only to writer roles.';
+`
+  };
+}
+export {
+  templateCommand
+};
+//# sourceMappingURL=template-ZERIXVXF.js.map

package/dist/template-ZERIXVXF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/template.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\n\n/**\n * `sdt template <kind> <name>` — schema cookbook generator. Produces\n * a complete set of `.sql` files implementing a common pattern, ready\n * to drop into a `.sdtproj`'s object tree. Saves a junior engineer\n * from re-inventing the SCD2 pattern from scratch.\n *\n * Supported kinds:\n *   - `scd1`         — Slowly-changing-dimension type-1 (overwrite, no history).\n *   - `scd2`         — Slowly-changing-dimension type-2 (history-preserving).\n *   - `scd3`         — Slowly-changing-dimension type-3 (one previous value).\n *   - `scd4`         — Slowly-changing-dimension type-4 (current + history table).\n *   - `scd6`         — Hybrid 1+2+3 (current + valid_from/to + previous value).\n *   - `star`         — Star schema fact + N dimensions.\n *   - `fact`         — Fact table only, with surrogate-key FKs to named dims.\n *   - `scd2-merge`   — Canonical MERGE statement to load an SCD2 dimension.\n *   - `current-view` — `CREATE VIEW` over an SCD2 table where IS_CURRENT = TRUE.\n *   - `time-series`  — Hash-partitioned time-series with retention.\n *   - `audit`        — Generic audit-log table with append-only constraints.\n *\n * Mirrors `ddt template`. Patterns are conservative: every template\n * sets a PK, populates COMMENT fields, and prefers `CREATE OR ALTER`\n * over `CREATE OR REPLACE` to play well with the safety classifier.\n */\nexport function templateCommand(): Command {\n  const cmd = new Command('template');\n  cmd\n    .description(\n      'Scaffold a common schema pattern (scd1|scd2|scd3|scd4|scd6|star|fact|scd2-merge|current-view|time-series|audit). Writes .sql files into <out>/.',\n    )\n    .argument(\n      '<kind>',\n      'Pattern to scaffold: scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit',\n    )\n    .argument('<name>', 'Base object name (e.g. CUSTOMER, ORDERS).')\n    .option('--db <database>', 'Database name. Default DEMO_DB.', 'DEMO_DB')\n    .option('--schema <schema>', 'Schema name. Default PUBLIC.', 'PUBLIC')\n    .option('-o, --out <path>', 'Output directory. Default <kind>-<name>/.')\n    .option(\n      '--dims <dims>',\n      '[star|fact] Comma-separated dimension names. Default: customer,product,date.',\n      'customer,product,date',\n    )\n    .option(\n      '--track <cols>',\n      '[scd3|scd6] Comma-separated columns to track previous-values for. Default: attribute_1.',\n      'attribute_1',\n    )\n    .option(\n      '--source <fqn>',\n      '[scd2-merge] Source/staging table fully-qualified name. Default DEMO_DB.PUBLIC.<name>_STAGE.',\n    )\n    .option('--retention-days <n>', '[time-series] Retention window in days. Default 90.', '90')\n    .option(\n      '--hybrid',\n      'Emit CREATE HYBRID TABLE (Unistore row-store) instead of CREATE OR ALTER TABLE. Constraints become enforced; CLUSTER BY is suppressed (not supported on Hybrid Tables).',\n    )\n    .action(async (kindArg, nameArg, opts) => {\n      const kind = String(kindArg).toLowerCase();\n      const name = String(nameArg);\n      const db = String(opts.db);\n      const schema = String(opts.schema);\n      const hybrid = Boolean(opts.hybrid);\n      const out = opts.out\n        ? path.resolve(String(opts.out))\n        : path.resolve(`${kind}-${name.toLowerCase()}`);\n      await fs.mkdir(out, { recursive: true });\n\n      if (hybrid && (kind === 'scd2-merge' || kind === 'current-view')) {\n        console.error(`Warning: --hybrid has no effect on ${kind} (no table DDL emitted).`);\n      }\n\n      const ctx = { db, schema, name, hybrid };\n      let files: Record<string, string>;\n      const trackCols = String(opts.track)\n        .split(',')\n        .map((s) => s.trim())\n        .filter(Boolean);\n      const dims = String(opts.dims)\n        .split(',')\n        .map((s) => s.trim())\n        .filter(Boolean);\n      if (kind === 'scd1') files = renderScd1(ctx);\n      else if (kind === 'scd2') files = renderScd2(ctx);\n      else if (kind === 'scd3') files = renderScd3(ctx, trackCols);\n      else if (kind === 'scd4') files = renderScd4(ctx);\n      else if (kind === 'scd6') files = renderScd6(ctx, trackCols);\n      else if (kind === 'star') files = renderStar(ctx, dims);\n      else if (kind === 'fact') files = renderFact(ctx, dims);\n      else if (kind === 'scd2-merge')\n        files = renderScd2Merge(\n          ctx,\n          opts.source ? String(opts.source) : `${db}.${schema}.${name.toUpperCase()}_STAGE`,\n        );\n      else if (kind === 'current-view') files = renderCurrentView(ctx);\n      else if (kind === 'time-series') files = renderTimeSeries(ctx, Number(opts.retentionDays));\n      else if (kind === 'audit') files = renderAudit(ctx);\n      else\n        throw new Error(\n          `Unknown template kind: ${kind}. Use scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit.`,\n        );\n\n      for (const [rel, contents] of Object.entries(files)) {\n        const filePath = path.join(out, rel);\n        await fs.mkdir(path.dirname(filePath), { recursive: true });\n        await fs.writeFile(filePath, contents, 'utf8');\n        console.error(\n          `  wrote ${path.relative(process.cwd(), filePath)} (${contents.length} bytes)`,\n        );\n      }\n      console.error(\n        `Done. ${Object.keys(files).length} file(s) written to ${path.relative(process.cwd(), out)}.`,\n      );\n    });\n  return cmd;\n}\n\ninterface Ctx {\n  db: string;\n  schema: string;\n  name: string;\n  /** When true, emit CREATE HYBRID TABLE with enforced constraints and no CLUSTER BY. */\n  hybrid?: boolean;\n}\n\nfunction header(why: string): string {\n  return `-- Generated by \\`sdt template\\`. Why this pattern is the right shape:\\n--   ${why}\\n--\\n-- Edit freely; this is just a starting point.\\n\\n`;\n}\n\n/** DDL verb for table creation — Hybrid Tables can't use CREATE OR ALTER. */\nfunction tableKw(c: Ctx, tableName: string): string {\n  return c.hybrid\n    ? `CREATE HYBRID TABLE ${c.db}.${c.schema}.${tableName}`\n    : `CREATE OR ALTER TABLE ${c.db}.${c.schema}.${tableName}`;\n}\n\n/** Primary-key constraint. Hybrid Tables enforce PKs, regular tables don't. */\nfunction pkConstraint(name: string, cols: string, c: Ctx): string {\n  return c.hybrid\n    ? `CONSTRAINT ${name} PRIMARY KEY (${cols})`\n    : `CONSTRAINT ${name} PRIMARY KEY (${cols}) NOT ENFORCED`;\n}\n\n/** Unique constraint. Hybrid Tables enforce UKs, regular tables don't. */\nfunction ukConstraint(name: string, cols: string, c: Ctx): string {\n  return c.hybrid\n    ? `CONSTRAINT ${name} UNIQUE (${cols})`\n    : `CONSTRAINT ${name} UNIQUE (${cols}) NOT ENFORCED`;\n}\n\n/** CLUSTER BY clause — suppressed on Hybrid Tables (not supported). */\nfunction clusterBy(expr: string, c: Ctx): string {\n  return c.hybrid ? '' : `\\nCLUSTER BY (${expr})`;\n}\n\nfunction renderScd1(c: Ctx): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Tables/${upper}.sql`]:\n      header(\n        `SCD1 overwrites the row in place when an attribute changes. No history is\n--   preserved. Use this when downstream consumers only care about the *current*\n--   state and the dimension is small enough that losing history is fine.\n--   LOAD_TS/UPDATED_TS give you minimal auditability without history-table cost.`,\n      ) +\n      `${tableKw(c, upper)} (\n  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key — stable across overwrites',\n  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',\n  ATTRIBUTE_1       VARCHAR                                  COMMENT 'Replace with real columns',\n  ATTRIBUTE_2       VARCHAR                                  COMMENT 'Replace with real columns',\n  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the row was first inserted',\n  UPDATED_TS        TIMESTAMP_NTZ                            COMMENT 'When the row was last overwritten',\n  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)},\n  ${ukConstraint(`UK_${upper}_BK`, `${upper}_BK`, c)}\n)\nCOMMENT = 'SCD1 dimension — overwrite-on-change. No history kept; join on ${upper}_BK.';\n`,\n  };\n}\n\nfunction renderScd2(c: Ctx): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Tables/${upper}.sql`]:\n      header(\n        `SCD2 preserves every historical version of a row by closing the previous row's\n--   VALID_TO when the natural key reappears with new attribute values. Use this\n--   when downstream analytics needs \"what did this row look like on date X\".`,\n      ) +\n      `${tableKw(c, upper)} (\n  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key — unique per version',\n  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key — stable across versions',\n  ATTRIBUTE_1       VARCHAR                                  COMMENT 'Replace with real columns',\n  ATTRIBUTE_2       VARCHAR                                  COMMENT 'Replace with real columns',\n  VALID_FROM        TIMESTAMP_NTZ NOT NULL                  COMMENT 'When this version became current',\n  VALID_TO          TIMESTAMP_NTZ                            COMMENT 'When this version was superseded; NULL while current',\n  IS_CURRENT        BOOLEAN       NOT NULL                  COMMENT 'TRUE only on the latest row per BK',\n  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',\n  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)}\n)\nCOMMENT = 'SCD2 dimension — preserves history. Treat business key + IS_CURRENT as the natural join target.';\n`,\n    [`${c.db}/${c.schema}/Streams/${upper}_STREAM.sql`]:\n      header(\n        `Stream over the SCD2 table lets downstream tasks consume only the rows that\n--   changed since they last read. Drop this if you don't have a downstream\n--   consumer that needs incremental updates.`,\n      ) +\n      `CREATE OR ALTER STREAM ${c.db}.${c.schema}.${upper}_STREAM ON TABLE ${c.db}.${c.schema}.${upper}\nCOMMENT = 'CDC stream over ${upper}. Read by downstream tasks for incremental processing.';\n`,\n  };\n}\n\nfunction renderScd3(c: Ctx, tracked: string[]): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  const cols = (tracked.length ? tracked : ['attribute_1']).map((t) => t.toUpperCase());\n  const prevCols = cols\n    .map(\n      (t) =>\n        `  PREV_${t}       VARCHAR                                  COMMENT 'Prior value of ${t}, captured on overwrite'`,\n    )\n    .join(',\\n');\n  return {\n    [`${c.db}/${c.schema}/Tables/${upper}.sql`]:\n      header(\n        `SCD3 keeps the current value plus one prior value per tracked column. Use\n--   this when downstream needs \"current vs immediately prior\" but doesn't need\n--   the full history. Cheaper than SCD2 but lossy beyond one change.`,\n      ) +\n      `${tableKw(c, upper)} (\n  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',\n  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',\n${cols.map((t) => `  ${t}             VARCHAR                                  COMMENT 'Current value'`).join(',\\n')},\n${prevCols},\n  PREV_CHANGED_TS   TIMESTAMP_NTZ                            COMMENT 'When prior values were captured',\n  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',\n  UPDATED_TS        TIMESTAMP_NTZ                            COMMENT 'When this row was last overwritten',\n  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)},\n  ${ukConstraint(`UK_${upper}_BK`, `${upper}_BK`, c)}\n)\nCOMMENT = 'SCD3 dimension — current + one prior value for ${cols.join(', ')}.';\n`,\n  };\n}\n\nfunction renderScd4(c: Ctx): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Tables/${upper}.sql`]:\n      header(\n        `SCD4 keeps a small, fast \"current\" table for joins and a separate history\n--   table for slow analytics. Use this when the current-state lookups are hot\n--   (every fact query joins to it) and you want to keep that join skinny.`,\n      ) +\n      `${tableKw(c, upper)} (\n  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',\n  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',\n  ATTRIBUTE_1       VARCHAR                                  COMMENT 'Replace with real columns',\n  ATTRIBUTE_2       VARCHAR                                  COMMENT 'Replace with real columns',\n  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the row was inserted',\n  UPDATED_TS        TIMESTAMP_NTZ                            COMMENT 'When the row was last overwritten',\n  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)},\n  ${ukConstraint(`UK_${upper}_BK`, `${upper}_BK`, c)}\n)\nCOMMENT = 'SCD4 current-state table. Pair with ${upper}_HISTORY for change tracking.';\n`,\n    [`${c.db}/${c.schema}/Tables/${upper}_HISTORY.sql`]:\n      header(\n        `Companion history table for SCD4. Rows are appended (never updated) when\n--   the current table is overwritten — same columns plus a CHANGED_TS so you\n--   can replay \"what did this BK look like at time T\".`,\n      ) +\n      `${tableKw(c, `${upper}_HISTORY`)} (\n  ${upper}_HISTORY_SK NUMBER(38,0) NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate id for each historical snapshot',\n  ${upper}_BK         VARCHAR      NOT NULL                  COMMENT 'Business key',\n  ATTRIBUTE_1         VARCHAR                                 COMMENT 'Snapshot of column at CHANGED_TS',\n  ATTRIBUTE_2         VARCHAR                                 COMMENT 'Snapshot of column at CHANGED_TS',\n  CHANGED_TS          TIMESTAMP_NTZ NOT NULL                 COMMENT 'When this snapshot was taken',\n  LOAD_TS             TIMESTAMP_NTZ NOT NULL DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the row was appended',\n  ${pkConstraint(`PK_${upper}_HISTORY`, `${upper}_HISTORY_SK`, c)}\n)${clusterBy(`${upper}_BK, CHANGED_TS`, c)}\nCOMMENT = 'SCD4 history-side. Append-only snapshots of ${upper}; reconstruct as-of state via window functions.';\n`,\n  };\n}\n\nfunction renderScd6(c: Ctx, tracked: string[]): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  const cols = (tracked.length ? tracked : ['attribute_1']).map((t) => t.toUpperCase());\n  const prevCols = cols\n    .map(\n      (t) =>\n        `  PREV_${t}       VARCHAR                                  COMMENT 'Prior value of ${t}'`,\n    )\n    .join(',\\n');\n  return {\n    [`${c.db}/${c.schema}/Tables/${upper}.sql`]:\n      header(\n        `SCD6 = 1 + 2 + 3 hybrid. You get full SCD2 history (rows per version),\n--   SCD3 \"current vs prior\" lookback on hot columns, and SCD1 \"current value\"\n--   denormalized onto every historical row. Heavyweight; use when downstream\n--   consumers ask both \"what was it at time T?\" and \"what's the current value\n--   for the BK on this old row?\" in the same query.`,\n      ) +\n      `${tableKw(c, upper)} (\n  ${upper}_SK       NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key — unique per version',\n  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key — stable across versions',\n${cols.map((t) => `  ${t}             VARCHAR                                  COMMENT 'Value on THIS version'`).join(',\\n')},\n${cols.map((t) => `  CURRENT_${t}     VARCHAR                                  COMMENT 'Current value for the BK (SCD1 denorm)'`).join(',\\n')},\n${prevCols},\n  VALID_FROM        TIMESTAMP_NTZ NOT NULL                  COMMENT 'When this version became current',\n  VALID_TO          TIMESTAMP_NTZ                            COMMENT 'When this version was superseded; NULL while current',\n  IS_CURRENT        BOOLEAN       NOT NULL                  COMMENT 'TRUE only on the latest row per BK',\n  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',\n  ${pkConstraint(`PK_${upper}`, `${upper}_SK`, c)}\n)\nCOMMENT = 'SCD6 dimension — hybrid 1+2+3. Heavy but answers every common BI question without re-joining.';\n`,\n  };\n}\n\nfunction renderStar(c: Ctx, dims: string[]): Record<string, string> {\n  const fact = c.name.toUpperCase();\n  const out: Record<string, string> = {};\n  for (const d of dims) {\n    const upper = d.toUpperCase();\n    out[`${c.db}/${c.schema}/Tables/DIM_${upper}.sql`] =\n      header(`Dimension table — describes the WHAT. Joined by the fact via DIM_${upper}_SK.`) +\n      `${tableKw(c, `DIM_${upper}`)} (\n  DIM_${upper}_SK   NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',\n  ${upper}_BK       VARCHAR       NOT NULL                  COMMENT 'Business key',\n  ${upper}_NAME     VARCHAR                                  COMMENT 'Replace with real attributes',\n  COUNTRY           VARCHAR                                  COMMENT 'Example attribute',\n  ${pkConstraint(`PK_DIM_${upper}`, `DIM_${upper}_SK`, c)}\n)\nCOMMENT = 'Dimension table for the ${fact} star schema.';\n`;\n  }\n  out[`${c.db}/${c.schema}/Tables/FACT_${fact}.sql`] =\n    header(\n      `Fact table — the WHO/WHAT/WHEN/HOW-MUCH. One row per business event.\n--   Surrogate-key FKs to every dimension; measure columns hold the numbers.`,\n    ) +\n    `${tableKw(c, `FACT_${fact}`)} (\n  FACT_${fact}_SK   NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',\n${dims.map((d) => `  DIM_${d.toUpperCase()}_SK NUMBER(38,0)              COMMENT 'FK to DIM_${d.toUpperCase()}'`).join(',\\n')},\n  EVENT_TS          TIMESTAMP_NTZ NOT NULL                  COMMENT 'When the event occurred',\n  MEASURE_AMOUNT    NUMBER(38,4)                             COMMENT 'Primary measure — replace with real columns',\n  MEASURE_QUANTITY  NUMBER(38,0)                             COMMENT 'Secondary measure',\n  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',\n  ${pkConstraint(`PK_FACT_${fact}`, `FACT_${fact}_SK`, c)}\n)${clusterBy('EVENT_TS', c)}\nCOMMENT = 'Fact table for the ${fact} star. CLUSTER BY date keeps recent-event scans cheap.';\n`;\n  return out;\n}\n\nfunction renderFact(c: Ctx, dims: string[]): Record<string, string> {\n  const fact = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Tables/FACT_${fact}.sql`]:\n      header(\n        `Fact-only template — assumes the named dimensions already exist. Use this\n--   when adding a new fact to an existing star, rather than scaffolding the\n--   dims a second time. Surrogate-key FKs follow the DIM_<NAME>_SK convention.`,\n      ) +\n      `${tableKw(c, `FACT_${fact}`)} (\n  FACT_${fact}_SK   NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate key',\n${dims.map((d) => `  DIM_${d.toUpperCase()}_SK NUMBER(38,0)              COMMENT 'FK to DIM_${d.toUpperCase()}'`).join(',\\n')},\n  EVENT_TS          TIMESTAMP_NTZ NOT NULL                  COMMENT 'When the event occurred',\n  MEASURE_AMOUNT    NUMBER(38,4)                             COMMENT 'Primary measure — replace with real columns',\n  MEASURE_QUANTITY  NUMBER(38,0)                             COMMENT 'Secondary measure',\n  LOAD_TS           TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'Insertion timestamp',\n  ${pkConstraint(`PK_FACT_${fact}`, `FACT_${fact}_SK`, c)}\n)${clusterBy('EVENT_TS', c)}\nCOMMENT = 'Fact table FACT_${fact}. Add this to an existing star — dimensions assumed to exist.';\n`,\n  };\n}\n\nfunction renderScd2Merge(c: Ctx, source: string): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Scripts/MERGE_${upper}.sql`]:\n      header(\n        `Canonical SCD2 load. Step 1 closes the prior row when the BK reappears with\n--   different attributes (sets VALID_TO + IS_CURRENT=FALSE). Step 2 inserts the\n--   new version. Wrap both in a transaction so you don't end up with two current\n--   rows. Source: ${source}.`,\n      ) +\n      `-- Step 1 — close the previous version when attributes change for an existing BK.\nBEGIN TRANSACTION;\n\nMERGE INTO ${c.db}.${c.schema}.${upper} AS tgt\nUSING (\n  SELECT\n    src.${upper}_BK,\n    src.ATTRIBUTE_1,\n    src.ATTRIBUTE_2\n  FROM ${source} AS src\n) AS src\nON tgt.${upper}_BK = src.${upper}_BK\n   AND tgt.IS_CURRENT = TRUE\nWHEN MATCHED\n     AND (tgt.ATTRIBUTE_1 IS DISTINCT FROM src.ATTRIBUTE_1\n       OR tgt.ATTRIBUTE_2 IS DISTINCT FROM src.ATTRIBUTE_2)\n  THEN UPDATE SET\n    VALID_TO   = CURRENT_TIMESTAMP(),\n    IS_CURRENT = FALSE;\n\n-- Step 2 — insert the new version for changed BKs + brand-new BKs.\nINSERT INTO ${c.db}.${c.schema}.${upper} (\n  ${upper}_BK, ATTRIBUTE_1, ATTRIBUTE_2,\n  VALID_FROM, VALID_TO, IS_CURRENT\n)\nSELECT\n  src.${upper}_BK,\n  src.ATTRIBUTE_1,\n  src.ATTRIBUTE_2,\n  CURRENT_TIMESTAMP(),\n  NULL,\n  TRUE\nFROM ${source} AS src\nLEFT JOIN ${c.db}.${c.schema}.${upper} AS tgt\n  ON tgt.${upper}_BK = src.${upper}_BK\n     AND tgt.IS_CURRENT = TRUE\nWHERE tgt.${upper}_BK IS NULL\n   OR (tgt.ATTRIBUTE_1 IS DISTINCT FROM src.ATTRIBUTE_1\n    OR tgt.ATTRIBUTE_2 IS DISTINCT FROM src.ATTRIBUTE_2);\n\nCOMMIT;\n`,\n  };\n}\n\nfunction renderCurrentView(c: Ctx): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Views/V_${upper}_CURRENT.sql`]:\n      header(\n        `Current-state view over an SCD2 table. Lets downstream consumers join on\n--   one canonical \"current row per BK\" target without remembering the\n--   IS_CURRENT predicate. Cheap — Snowflake filter-pushdown handles it.`,\n      ) +\n      `CREATE OR REPLACE VIEW ${c.db}.${c.schema}.V_${upper}_CURRENT\nCOMMENT = 'Current rows from ${upper} (SCD2). Join here instead of filtering IS_CURRENT manually.'\nAS\nSELECT *\nFROM ${c.db}.${c.schema}.${upper}\nWHERE IS_CURRENT = TRUE;\n`,\n  };\n}\n\nfunction renderTimeSeries(c: Ctx, retentionDays: number): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Tables/${upper}.sql`]:\n      header(\n        `Time-series table — append-only, clustered by event timestamp so recent-event\n--   scans prune to a small number of micropartitions. DATA_RETENTION_TIME_IN_DAYS\n--   bounds Time Travel cost; aged-out rows must be archived elsewhere.`,\n      ) +\n      `${tableKw(c, upper)} (\n  EVENT_ID          NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate id',\n  EVENT_TS          TIMESTAMP_NTZ NOT NULL                  COMMENT 'When the event occurred',\n  EVENT_TYPE        VARCHAR                                  COMMENT 'Discriminator — index of partition by event_type if useful',\n  ENTITY_ID         VARCHAR                                  COMMENT 'Foreign key to the entity the event is about',\n  PAYLOAD           VARIANT                                  COMMENT 'Event-specific payload (semistructured)',\n  INGESTED_TS       TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When SDT loaded the row',\n  ${pkConstraint(`PK_${upper}`, 'EVENT_ID', c)}\n)${clusterBy('EVENT_TS', c)}\nDATA_RETENTION_TIME_IN_DAYS = ${Math.max(1, Math.min(retentionDays, 90))}\nCOMMENT = 'Time-series ${upper}. Aged out beyond DATA_RETENTION_TIME_IN_DAYS; archive separately if you need longer history.';\n`,\n  };\n}\n\nfunction renderAudit(c: Ctx): Record<string, string> {\n  const upper = c.name.toUpperCase();\n  return {\n    [`${c.db}/${c.schema}/Tables/${upper}_AUDIT.sql`]:\n      header(\n        `Audit log — append-only by convention. INSERT-only INSERT-only permissions on\n--   downstream roles enforce the \"append-only\" property; this table itself doesn't\n--   block updates, but the role grants do. Pair with a row-access policy if\n--   stronger guarantees are needed.`,\n      ) +\n      `${tableKw(c, `${upper}_AUDIT`)} (\n  AUDIT_ID          NUMBER(38,0)  NOT NULL  AUTOINCREMENT  COMMENT 'Surrogate id',\n  AUDIT_TS          TIMESTAMP_NTZ NOT NULL  DEFAULT CURRENT_TIMESTAMP() COMMENT 'When the event was logged',\n  ACTOR             VARCHAR       NOT NULL                  COMMENT 'Who performed the action (user / service-account)',\n  ACTION            VARCHAR       NOT NULL                  COMMENT 'What happened (e.g. CREATE_USER, ROLE_GRANT)',\n  TARGET            VARCHAR                                  COMMENT 'What it was performed on',\n  DETAILS           VARIANT                                  COMMENT 'Free-form payload — keep it small',\n  ${pkConstraint(`PK_${upper}_AUDIT`, 'AUDIT_ID', c)}\n)\nCOMMENT = 'Audit log for ${upper}. Append-only by convention — grant INSERT only to writer roles.';\n`,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/test-5M2ED3WT.js

@@ -0,0 +1,169 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/test.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import { project, testFramework } from "@sdt-tools/core";
+import { getProfile, SnowflakeConnection } from "@sdt-tools/core/connection";
+function testCommand() {
+  const cmd = new Command("test").description(
+    "Declarative tests (unique / not_null / accepted_values / relationships / expression) compiled from YAML to SQL."
+  );
+  cmd.command("list").description("Enumerate test files and their test counts.").requiredOption("-p, --project <path>", "Path to the .sdtproj file.").action(async (opts) => {
+    const loaded = await project.loadProject(String(opts.project));
+    const files = await testFramework.discoverTests(loaded.rootDir);
+    if (files.length === 0) {
+      console.log(
+        "No tests found. Add files under <project>/tests/<db>/<schema>/<table>.test.yaml."
+      );
+      return;
+    }
+    for (const f of files) {
+      console.log(`  ${f.fqn.padEnd(40)} ${String(f.tests.length).padStart(3)} test(s)`);
+      for (const t of f.tests) {
+        const cols = "columns" in t ? `(${(t.columns ?? []).join(", ")})` : "column" in t ? `(${t.column})` : "";
+        console.log(`    - ${t.kind}${cols}${t.name ? ` ${t.name}` : ""}`);
+      }
+    }
+    console.log("");
+    console.log(
+      `${files.length} file(s), ${files.reduce((acc, f) => acc + f.tests.length, 0)} test(s) total.`
+    );
+  });
+  cmd.command("render").description("Compile every test YAML into SQL assertions. Offline; no account contact.").requiredOption("-p, --project <path>", "Path to the .sdtproj file.").option("-o, --out <path>", "Write to file. Defaults to stdout.").action(async (opts) => {
+    const loaded = await project.loadProject(String(opts.project));
+    const files = await testFramework.discoverTests(loaded.rootDir);
+    const sql = testFramework.renderAllTests(files);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, sql, "utf8");
+      console.error(
+        `Wrote ${out} (${sql.length} bytes, ${files.reduce((a, f) => a + f.tests.length, 0)} test(s)).`
+      );
+    } else {
+      process.stdout.write(sql);
+    }
+  });
+  cmd.command("run").description(
+    "Execute every test assertion against a live Snowflake account and report pass/fail. Exits 2 when any error-severity test fails. Pro tier \u2014 composes DCM item 5 (data-quality expectations) with the existing dbt-test parity framework."
+  ).requiredOption("-p, --project <path>", "Path to the .sdtproj file.").requiredOption("-c, --connection <profile>", "Connection profile name.").option(
+    "--select <pattern>",
+    'Filter tests to files whose FQN matches a glob pattern. E.g. "mydb.public.*".'
+  ).option("--fail-fast", "Stop on the first error-severity failure.", false).option(
+    "--sample <n>",
+    "Cap failing-row samples captured per test. Default 10. 0 to skip.",
+    "10"
+  ).option(
+    "--update-snapshots",
+    "TEST.3: overwrite every saved snapshot under .sdt/tests/__snapshots__/ with the live rows. Use when intentional schema change makes drift expected.",
+    false
+  ).option("--format <fmt>", "Output format: text | json. Default text.", "text").option("-o, --out <path>", "Write report to a file instead of stdout.").action(async (opts) => {
+    const loaded = await project.loadProject(String(opts.project));
+    let files = await testFramework.discoverTests(loaded.rootDir);
+    if (opts.select) {
+      const re = globToRegex(String(opts.select));
+      files = files.filter((f) => re.test(f.fqn));
+    }
+    if (files.length === 0) {
+      console.log(
+        "No tests found. Add files under <project>/tests/<db>/<schema>/<table>.test.yaml."
+      );
+      return;
+    }
+    const profile = await getProfile(String(opts.connection));
+    const conn = new SnowflakeConnection(profile);
+    logger.step(`test run: connecting to ${profile.account} as ${profile.auth.username}\u2026`);
+    await conn.connect();
+    const snapshotsDir = path.join(loaded.rootDir, ".sdt", "tests", "__snapshots__");
+    const snapshotStorage = {
+      async read(name) {
+        try {
+          return await fs.readFile(path.join(snapshotsDir, `${name}.json`), "utf8");
+        } catch (e) {
+          if (e.code === "ENOENT") return null;
+          throw e;
+        }
+      },
+      async write(name, body) {
+        await fs.mkdir(snapshotsDir, { recursive: true });
+        await fs.writeFile(path.join(snapshotsDir, `${name}.json`), body, "utf8");
+      }
+    };
+    let report;
+    try {
+      report = await testFramework.runTestFiles(files, conn, {
+        failFast: opts.failFast === true,
+        failingRowSampleCap: Number(opts.sample ?? "10"),
+        snapshotStorage,
+        updateSnapshots: opts.updateSnapshots === true
+      });
+    } finally {
+      await conn.disconnect().catch(() => void 0);
+    }
+    const output = String(opts.format).toLowerCase() === "json" ? testFramework.renderJsonReport(report) : testFramework.renderTextReport(report);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, output, "utf8");
+      logger.info(
+        `Wrote ${out} \u2014 ${report.summary.pass} pass / ${report.summary.fail} fail / ${report.summary.error} error.`
+      );
+    } else {
+      process.stdout.write(output);
+    }
+    if (report.summary.blocking) {
+      process.exitCode = 2;
+    }
+  });
+  cmd.command("coverage").description(
+    "Report which project objects have at least one declarative test (TEST.4). Offline; no account contact. Emits a Markdown table (default) or JSON."
+  ).requiredOption("-p, --project <path>", "Path to the .sdtproj file.").option("--format <fmt>", "Output format: text | json. Default text.", "text").option("-o, --out <path>", "Write report to a file instead of stdout.").action(async (opts) => {
+    const loaded = await project.loadProject(String(opts.project));
+    const files = await testFramework.discoverTests(loaded.rootDir);
+    const model = await project.parseProjectModel(loaded);
+    const testable = /* @__PURE__ */ new Set([
+      "TABLE",
+      "EXTERNAL_TABLE",
+      "ICEBERG_TABLE",
+      "HYBRID_TABLE",
+      "DYNAMIC_TABLE",
+      "EVENT_TABLE",
+      "VIEW",
+      "MATERIALIZED_VIEW"
+    ]);
+    const fqns = [];
+    for (const obj of model) {
+      if (!testable.has(obj.objectType)) continue;
+      const db = obj.fqn.database;
+      const sc = obj.fqn.schema;
+      if (!db || !sc) continue;
+      fqns.push(`${db}.${sc}.${obj.fqn.name}`);
+    }
+    const report = testFramework.computeTestCoverage(files, fqns);
+    const output = String(opts.format).toLowerCase() === "json" ? testFramework.renderTestCoverageJson(report) : testFramework.renderTestCoverageMarkdown(report);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, output, "utf8");
+      logger.info(
+        `Wrote ${out} \u2014 ${report.withTests}/${report.total} object(s) covered (${report.coveragePct}%).`
+      );
+    } else {
+      process.stdout.write(output + "\n");
+    }
+  });
+  return cmd;
+}
+function globToRegex(pattern) {
+  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+  return new RegExp(`^${escaped}$`, "i");
+}
+export {
+  testCommand
+};
+//# sourceMappingURL=test-5M2ED3WT.js.map