@memberjunction/cli 5.37.0 → 5.38.0

package/dist/baseline/types.d.ts

@@ -0,0 +1,286 @@
+/**
+ * Shared types for the baseline migration builder + comparator.
+ *
+ * A SchemaSnapshot is the result of introspecting a live database. It is
+ * dialect-agnostic in shape (the same shape comes back from MSSQL or PG),
+ * but every field is stored verbatim from the source system. Equality is
+ * decided structurally by the comparator.
+ */
+export type Dialect = 'mssql' | 'postgres';
+/** Top-level snapshot of an introspected database. */
+export interface SchemaSnapshot {
+    dialect: Dialect;
+    schemas: SchemaDef[];
+    tables: TableDef[];
+    views: ViewDef[];
+    procedures: RoutineDef[];
+    functions: RoutineDef[];
+    triggers: TriggerDef[];
+    sequences: SequenceDef[];
+    /** User-defined types (table types primarily; scalar/CLR are future work). */
+    userDefinedTypes: UserDefinedTypeDef[];
+    /** sp_addextendedproperty entries (descriptions etc.) on schemas/tables/columns/views/routines. */
+    extendedProperties: ExtendedPropertyDef[];
+    /** Non-system database principals (users + custom roles). */
+    principals: DatabasePrincipalDef[];
+    /** Non-system role memberships (ALTER ROLE ... ADD MEMBER). */
+    roleMemberships: RoleMembershipDef[];
+    /** Object/schema/database/type permission grants (no DENY/REVOKE captured by default). */
+    permissions: PermissionDef[];
+}
+export interface SchemaDef {
+    name: string;
+}
+export interface TableDef {
+    schema: string;
+    name: string;
+    columns: ColumnDef[];
+    primaryKey?: PrimaryKeyDef;
+    uniqueConstraints: UniqueConstraintDef[];
+    indexes: IndexDef[];
+    foreignKeys: ForeignKeyDef[];
+    checks: CheckConstraintDef[];
+    hasIdentity: boolean;
+}
+export interface ColumnDef {
+    name: string;
+    ordinal: number;
+    dataType: string;
+    isNullable: boolean;
+    isIdentity: boolean;
+    isComputed: boolean;
+    /** When `isComputed`, the body of the AS (...) expression. */
+    computedExpression?: string;
+    /** When `isComputed`, whether the value is PERSISTED. */
+    isComputedPersisted?: boolean;
+    /** DEFAULT expression text (already wrapped in parens by sys.default_constraints.definition). */
+    defaultExpression?: string;
+    /** Original `sys.default_constraints.name`. Needed so the new DB's DF_* constraints match the source byte-for-byte. */
+    defaultConstraintName?: string;
+    collation?: string;
+}
+export interface PrimaryKeyDef {
+    name: string;
+    columns: string[];
+    clustered: boolean;
+}
+export interface UniqueConstraintDef {
+    name: string;
+    columns: string[];
+    clustered: boolean;
+}
+export interface IndexDef {
+    name: string;
+    columns: string[];
+    includes: string[];
+    isUnique: boolean;
+    isClustered: boolean;
+    filter?: string;
+}
+export interface ForeignKeyDef {
+    name: string;
+    columns: string[];
+    referencedSchema: string;
+    referencedTable: string;
+    referencedColumns: string[];
+    onDelete: 'NO_ACTION' | 'CASCADE' | 'SET_NULL' | 'SET_DEFAULT';
+    onUpdate: 'NO_ACTION' | 'CASCADE' | 'SET_NULL' | 'SET_DEFAULT';
+}
+export interface CheckConstraintDef {
+    name: string;
+    expression: string;
+}
+export interface ViewDef {
+    schema: string;
+    name: string;
+    definition: string;
+}
+export interface RoutineDef {
+    schema: string;
+    name: string;
+    definition: string;
+    kind: 'procedure' | 'function';
+}
+export interface TriggerDef {
+    schema: string;
+    name: string;
+    table: string;
+    definition: string;
+}
+export interface SequenceDef {
+    schema: string;
+    name: string;
+    startValue: string;
+    increment: string;
+    minValue?: string;
+    maxValue?: string;
+    cycle: boolean;
+    currentValue?: string;
+}
+/** A user-defined TYPE (currently only table types; scalar/CLR are future work). */
+export interface UserDefinedTypeDef {
+    schema: string;
+    name: string;
+    kind: 'table';
+    isMemoryOptimized: boolean;
+    columns: UserDefinedTypeColumnDef[];
+    /** Inline primary key, if any. CREATE TYPE AS TABLE supports a PK clause. */
+    primaryKey?: PrimaryKeyDef;
+}
+/** Columns inside a CREATE TYPE AS TABLE definition. Subset of ColumnDef (no identity/computed/FK). */
+export interface UserDefinedTypeColumnDef {
+    name: string;
+    ordinal: number;
+    dataType: string;
+    isNullable: boolean;
+    collation?: string;
+}
+/**
+ * A non-system database principal — a SQL user (mapped or contained) or a
+ * custom database role. Fixed roles (db_owner, db_datareader, etc.) and
+ * built-in users (dbo, guest, public, sys) are filtered out at introspection
+ * time; the baseline never re-creates those.
+ */
+export interface DatabasePrincipalDef {
+    name: string;
+    kind: 'sql_user' | 'database_role' | 'windows_user' | 'application_role' | 'aad_user' | 'aad_group';
+    /** Owner principal name (e.g. `db_securityadmin` for MJ's cdp_* roles). Undefined falls back to the current user (typically `dbo`). */
+    owner?: string;
+    /** Default schema for users. Roles don't have one. */
+    defaultSchema?: string;
+}
+/** A row in `sys.database_role_members`. Both names refer to principals (user or role). */
+export interface RoleMembershipDef {
+    role: string;
+    member: string;
+}
+/** State of a permission row in `sys.database_permissions`. */
+export type PermissionState = 'GRANT' | 'GRANT_WITH_GRANT_OPTION' | 'DENY' | 'REVOKE';
+/**
+ * A `GRANT`/`DENY` entry. MJ's CodeGen emits per-object grants for every view
+ * and stored procedure (e.g. `GRANT EXECUTE ON [__mj].[spCreateAIAgent] TO [cdp_Developer]`).
+ * Without these in the baseline, downstream V-files that GRANT to roles fail because
+ * the grantee is missing AND/OR the migration sequence drifts.
+ */
+export interface PermissionDef {
+    grantee: string;
+    state: PermissionState;
+    permission: string;
+    targetClass: 'database' | 'schema' | 'object' | 'type';
+    targetSchema?: string;
+    targetObject?: string;
+    targetType?: string;
+    targetColumn?: string;
+}
+/**
+ * An `sp_addextendedproperty` entry. MJ uses these heavily for MS_Description
+ * on tables, columns, views, procs, and functions. Skipping them produces a
+ * silent DB difference that CodeGen and tools depend on.
+ */
+export interface ExtendedPropertyDef {
+    /** Property name, e.g. 'MS_Description'. Case is preserved as stored. */
+    name: string;
+    /** Property value, always serialized as NVARCHAR. */
+    value: string;
+    /** level0 is always SCHEMA in MJ. Stored separately so we can emit the canonical 3-tier call. */
+    schemaName: string;
+    /** TABLE | VIEW | PROCEDURE | FUNCTION | TYPE | SEQUENCE | TRIGGER | null (for schema-level properties). */
+    level1Type?: string;
+    level1Name?: string;
+    /** COLUMN | PARAMETER | TRIGGER | INDEX | null. */
+    level2Type?: string;
+    level2Name?: string;
+}
+/** Per-table data dump (every row, ordered deterministically). */
+export interface TableDataDump {
+    schema: string;
+    table: string;
+    /** Column order matches the INSERT column list. */
+    columns: string[];
+    /** Each row is an array of values matching `columns`. Null = JS null. */
+    rows: unknown[][];
+    /** Set when the dump was truncated due to a hard limit. */
+    truncated?: boolean;
+    rowCount: number;
+}
+/** Output of a full diff between two snapshots (and optional row data). */
+export interface DiffReport {
+    generatedAt: string;
+    leftLabel: string;
+    rightLabel: string;
+    rowCompareMode: RowCompareMode;
+    isClean: boolean;
+    objectDiffs: ObjectDiff[];
+    tableRowDiffs: TableRowDiff[];
+    summary: DiffSummary;
+}
+export interface DiffSummary {
+    schemasChecked: number;
+    tablesChecked: number;
+    viewsChecked: number;
+    proceduresChecked: number;
+    functionsChecked: number;
+    triggersChecked: number;
+    sequencesChecked: number;
+    userDefinedTypesChecked: number;
+    extendedPropertiesChecked: number;
+    principalsChecked: number;
+    roleMembershipsChecked: number;
+    permissionsChecked: number;
+    objectsWithDiffs: number;
+    tablesWithRowDiffs: number;
+    totalRowDiffs: number;
+}
+export type RowCompareMode = 'full' | 'hash' | 'counts' | 'none';
+export type RowHashAlgo = 'sha256' | 'md5' | 'checksum_agg';
+export type ObjectKind = 'schema' | 'table' | 'column' | 'primaryKey' | 'uniqueConstraint' | 'index' | 'foreignKey' | 'check' | 'view' | 'procedure' | 'function' | 'trigger' | 'sequence' | 'userDefinedType' | 'extendedProperty' | 'principal' | 'roleMembership' | 'permission';
+export type DiffKind = 'missing-on-left' | 'missing-on-right' | 'changed';
+export interface ObjectDiff {
+    kind: ObjectKind;
+    diffKind: DiffKind;
+    qualifiedName: string;
+    /** Free-form details: which fields differ, with left/right values. */
+    details?: string;
+    leftValue?: unknown;
+    rightValue?: unknown;
+}
+export interface TableRowDiff {
+    schema: string;
+    table: string;
+    leftRowCount: number;
+    rightRowCount: number;
+    /** First N (default 100) row mismatches captured during full mode. */
+    sampleDiffs: RowDiff[];
+    /** True if there are more diffs than `sampleDiffs` shows. */
+    truncated: boolean;
+    /** Total mismatches counted (may exceed sampleDiffs.length). */
+    diffCount: number;
+}
+export interface RowDiff {
+    diffKind: DiffKind;
+    /** Stringified key (PK or whole-row hash) used for matching. */
+    key: string;
+    /** Per-column diffs in 'changed' rows only. */
+    columnDiffs?: ColumnValueDiff[];
+}
+export interface ColumnValueDiff {
+    column: string;
+    leftValue: unknown;
+    rightValue: unknown;
+}
+/** Build options passed to the emitter. */
+export interface BaselineEmitOptions {
+    baselineVersion: string;
+    description: string;
+    generatedAtUtc: Date;
+    includeData: boolean;
+    excludedDataTables: Set<string>;
+    batchSize: number;
+}
+export interface BaselineCompareOptions {
+    rowCompareMode: RowCompareMode;
+    rowHashAlgo: RowHashAlgo;
+    ignorePattern?: RegExp;
+    rowDiffSampleLimit: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/baseline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/baseline/types.ts"],"names":[],"mappings":"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"}

package/dist/baseline/types.js

@@ -0,0 +1,10 @@
+/**
+ * Shared types for the baseline migration builder + comparator.
+ *
+ * A SchemaSnapshot is the result of introspecting a live database. It is
+ * dialect-agnostic in shape (the same shape comes back from MSSQL or PG),
+ * but every field is stored verbatim from the source system. Equality is
+ * decided structurally by the comparator.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/baseline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/baseline/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/baseline/util.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Canonical formatting helpers used by the emitter and comparator.
+ *
+ * Determinism is the contract: identical input must produce byte-identical
+ * output, regardless of host OS, locale, or run order.
+ */
+/** Lower-case schema-qualified name used for sort keys and sets. */
+export declare function qname(schema: string, name: string): string;
+/** Quote a T-SQL identifier with brackets, escaping any embedded `]`. */
+export declare function quoteIdent(name: string): string;
+/** Quote a T-SQL string literal, escaping single quotes. */
+export declare function quoteString(value: string): string;
+/** Stable sort by a key extractor; preserves input order for ties. */
+export declare function stableSortBy<T>(items: readonly T[], key: (item: T) => string): T[];
+/** Cross-platform line endings: emit LF only. Caller normalizes if needed. */
+export declare const NL = "\n";
+/**
+ * Tables that must never appear in the emitted baseline — they belong to the
+ * migration tool itself and get created automatically before the baseline runs.
+ * Match by table name only (schema-independent) because Skyway can be configured
+ * to put `flyway_schema_history` in any schema (MJ uses `__mj`, default is `dbo`).
+ */
+export declare const EXCLUDED_TABLE_NAMES: ReadonlySet<string>;
+/** Returns true if a table (by bare name) is one we never emit in a baseline. */
+export declare function isExcludedTable(name: string): boolean;
+/** Canonical ISO-8601 UTC stamp without milliseconds: 2026-05-02T19:47:00Z. */
+export declare function isoUtcSeconds(date: Date): string;
+/** Filename timestamp: YYYYMMDDHHMM in UTC. */
+export declare function fileStamp(date: Date): string;
+/** Build the canonical filename for a baseline migration. */
+export declare function baselineFilename(opts: {
+    generatedAtUtc: Date;
+    baselineVersion: string;
+}): string;
+/** Inverse of {@link fileStamp}: parses a YYYYMMDDHHMM string into a UTC Date. */
+export declare function parseFileStamp(stamp: string): Date;
+/** Return a new Date offset by N minutes (negative for past). */
+export declare function addMinutes(date: Date, minutes: number): Date;
+/**
+ * Parse a Skyway/Flyway migration filename into its parts. Returns null if the
+ * filename doesn't match the expected `[VB]<timestamp>__v<Major>.<Minor>...` shape.
+ *
+ * Handles both styles found in the `migrations/v{N}/` directories:
+ *   - `V202602131500__v5.0.x__Entity_Name_Normalization.sql`  (with `.x` patch)
+ *   - `V202602170015__v5.1__Regenerate_Delete_Stored_Procs.sql` (no patch)
+ *   - `B202602151200__v5.0__Baseline.sql`                       (baseline marker)
+ */
+export interface ParsedMigrationFilename {
+    kind: 'V' | 'B';
+    timestamp: string;
+    major: number;
+    minor: number;
+    majorMinor: string;
+    filename: string;
+}
+export declare function parseMigrationFilename(filename: string): ParsedMigrationFilename | null;
+/**
+ * Scan a migrations source directory and return the latest V-file by timestamp.
+ * Files that don't match the expected shape are silently ignored.
+ *
+ * Used by within-major rebaseline to derive the new baseline's version + timestamp
+ * from the head of the existing V-stack.
+ */
+export declare function findLatestVersionedMigration(sourceDir: string): ParsedMigrationFilename | null;
+/** Same as {@link findLatestVersionedMigration} but for `B`-prefixed baseline files. */
+export declare function findLatestBaselineMigration(sourceDir: string): ParsedMigrationFilename | null;
+/**
+ * Walk up from `cwd` looking for a `migrations/` directory, then return the path
+ * to the highest-numbered `vN/` subdirectory inside it. Returns null if nothing
+ * suitable is found.
+ *
+ * Stops walking at the filesystem root. Used so the CLI can auto-locate the
+ * source dir for within-major rebaseline without forcing the caller to pass `--source-dir`.
+ */
+export declare function discoverMigrationsSourceDir(cwd: string): string | null;
+/**
+ * Compute the canonical generated-at timestamp for a within-major rebaseline.
+ * The new baseline's filename timestamp is exactly 1 minute after the latest
+ * V-file's timestamp — guaranteeing the new B-file sorts after the V-stack it
+ * succeeds, while remaining deterministic across re-runs against the same input.
+ */
+export declare function computeAutoBaselineStamp(latestVTimestamp: string): {
+    generatedAtUtc: Date;
+    fileStamp: string;
+};
+/**
+ * Format a JS value as a T-SQL literal. Used by the data dumper.
+ * Returns `NULL` for null/undefined, otherwise a typed literal.
+ */
+export declare function formatTsqlValue(value: unknown): string;
+/** Strict equality used by the comparator for column values. */
+export declare function deepValueEqual(a: unknown, b: unknown): boolean;
+/** Truncate a string with an ellipsis for diff output. */
+export declare function ellipsize(value: string, max?: number): string;
+/**
+ * Topologically sort a list of SQL routines (views/functions/procs/triggers)
+ * by inferred dependencies. A routine A depends on B if A's `definition` text
+ * mentions B's name (case-insensitive, schema-qualified or bare with word
+ * boundaries). Stable for equal items; sorts cycles by qname so the result is
+ * still deterministic.
+ *
+ * Reference extraction is heuristic — comments and string literals are not
+ * stripped — but false positives only add edges that don't hurt correctness.
+ * MSSQL `CREATE VIEW`/`CREATE FUNCTION` reject forward references at create
+ * time, so without this sort we hit `Invalid object name` errors on apply.
+ */
+export declare function topoSortRoutinesByDefinition<T extends {
+    name: string;
+    schema: string;
+    definition: string;
+}>(items: readonly T[]): T[];
+//# sourceMappingURL=util.d.ts.map

package/dist/baseline/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/baseline/util.ts"],"names":[],"mappings":"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"}