@pgpmjs/core 7.1.0 → 7.2.0

package/files/sql/header.js

@@ -1,266 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parsePgpmHeader = parsePgpmHeader;
-exports.writePgpmScript = writePgpmScript;
-exports.renameInHeader = renameInHeader;
-exports.scanDeployScript = scanDeployScript;
-exports.verifyPlanMatchesHeaders = verifyPlanMatchesHeaders;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const parser_1 = require("../plan/parser");
-const validators_1 = require("../plan/validators");
-const HEADER_LINE = /^--\s*(Deploy|Revert|Verify)\b(:)?\s*(.*?)\s*$/;
-const REQUIRES_LINE = /^--\s*requires:\s*(.*?)\s*$/;
-const COMMENT_LINE = /^\s*--/;
-const TO_PG_SUFFIX = /\s+to\s+pg\s*$/;
-/**
- * Parse the header block of a pgpm SQL script into a structured model.
- *
- * Recognizes both header formats:
- *   `-- Deploy <project>:<change> to pg` (legacy sqitch-compatible)
- *   `-- Deploy <change>` / `-- Deploy: <change>` (new)
- * along with `-- requires: <ref>` lines where `<ref>` may be a plain change
- * name, `{package}:{change}`, `@tag`, or `{package}:@tag`.
- *
- * The parse is lossless: `header.lines` plus `body` reassemble the original
- * content byte-exactly (see {@link writePgpmScript}).
- */
-function parsePgpmHeader(content) {
-    const header = {
-        verb: null,
-        project: null,
-        change: null,
-        toPg: false,
-        requires: [],
-        lines: []
-    };
-    const lines = content.split('\n');
-    let lastHeaderIdx = -1;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.trim() === '') {
-            continue;
-        }
-        if (!COMMENT_LINE.test(line)) {
-            break;
-        }
-        const headerMatch = line.match(HEADER_LINE);
-        if (headerMatch && header.verb === null) {
-            header.verb = headerMatch[1];
-            let target = headerMatch[3];
-            if (TO_PG_SUFFIX.test(target)) {
-                header.toPg = true;
-                target = target.replace(TO_PG_SUFFIX, '');
-            }
-            const colonIndex = target.indexOf(':');
-            if (colonIndex > 0 && /^[a-zA-Z0-9_-]+$/.test(target.substring(0, colonIndex))) {
-                header.project = target.substring(0, colonIndex);
-                header.change = target.substring(colonIndex + 1).trim();
-            }
-            else {
-                header.change = target.trim() || null;
-            }
-            lastHeaderIdx = i;
-            continue;
-        }
-        const requiresMatch = line.match(REQUIRES_LINE);
-        if (requiresMatch) {
-            const raw = requiresMatch[1];
-            header.requires.push({ raw, ref: (0, validators_1.parseReference)(raw) });
-            lastHeaderIdx = i;
-            continue;
-        }
-        // Other comment lines (e.g. attribution) before/between header lines are
-        // tolerated but only absorbed into the header when a later header line
-        // follows; trailing comments belong to the body.
-    }
-    header.lines = lines.slice(0, lastHeaderIdx + 1);
-    return {
-        header,
-        body: lines.slice(lastHeaderIdx + 1).join('\n')
-    };
-}
-/**
- * Serialize a header back to its raw lines. When the structured fields have
- * been modified via {@link renameInHeader}, the raw lines already reflect the
- * change; this simply joins header and body losslessly.
- */
-function writePgpmScript(script) {
-    if (script.header.lines.length === 0)
-        return script.body;
-    return script.header.lines.join('\n') + '\n' + script.body;
-}
-/**
- * Rewrite change names in a script header according to a rename map
- * (old change name -> new change name). Rewrites both the `-- Deploy` line's
- * change identity and any `-- requires:` lines referencing renamed changes,
- * preserving format (project qualifier, ` to pg` suffix, tag refs untouched).
- *
- * Returns the number of substitutions applied; mutates `script` in place.
- */
-function renameInHeader(script, renames) {
-    const { header } = script;
-    let count = 0;
-    const renameRef = (raw) => {
-        const ref = (0, validators_1.parseReference)(raw);
-        if (!ref) {
-            const to = renames.get(raw);
-            return to ?? null;
-        }
-        if (ref.tag || ref.symbolic || ref.relative)
-            return null;
-        const change = ref.change;
-        if (!change)
-            return null;
-        const to = renames.get(change);
-        if (!to)
-            return null;
-        return ref.package ? `${ref.package}:${to}` : to;
-    };
-    header.lines = header.lines.map(line => {
-        const headerMatch = line.match(HEADER_LINE);
-        if (headerMatch && header.change && renames.has(header.change)) {
-            const to = renames.get(header.change);
-            const oldTarget = header.project ? `${header.project}:${header.change}` : header.change;
-            const newTarget = header.project ? `${header.project}:${to}` : to;
-            const rewritten = line.replace(oldTarget, newTarget);
-            if (rewritten !== line) {
-                header.change = to;
-                count++;
-                return rewritten;
-            }
-            return line;
-        }
-        const requiresMatch = line.match(REQUIRES_LINE);
-        if (requiresMatch) {
-            const raw = requiresMatch[1];
-            const renamed = renameRef(raw);
-            if (renamed !== null) {
-                count++;
-                return line.replace(raw, renamed);
-            }
-        }
-        return line;
-    });
-    header.requires = header.requires.map(req => {
-        const renamed = renameRef(req.raw);
-        if (renamed === null)
-            return req;
-        return { raw: renamed, ref: (0, validators_1.parseReference)(renamed) };
-    });
-    return count;
-}
-/**
- * Scan a deploy script the way dependency resolution historically has:
- * line-by-line over the whole file, collecting `-- requires: <ref>` lines
- * verbatim and validating any `-- Deploy <project>:<change>[ to pg]` line
- * against the script's path identity and project name.
- *
- * Kept strictly line-regex-compatible with the original resolver behavior
- * (requires lines are honored anywhere in the file, and the legacy
- * `-- Deploy: <change>` colon form is not identity-validated).
- *
- * @throws when the Deploy line's project or change identity mismatches.
- */
-function scanDeployScript(content, options) {
-    const { key, extname, makeKey } = options;
-    const requires = [];
-    for (const line of content.split('\n')) {
-        const requiresMatch = line.match(/^-- requires: (.*)/);
-        if (requiresMatch) {
-            requires.push(requiresMatch[1].trim());
-            continue;
-        }
-        if (/:/.test(line)) {
-            const m2 = line.match(/^-- Deploy ([^:]*):([\w\/]+)(?:\s+to\s+pg)?/);
-            if (m2) {
-                const actualProject = m2[1];
-                const keyToTest = m2[2];
-                if (extname !== actualProject) {
-                    throw new Error(`Mismatched project name in deploy file:
-          Expected project: ${extname}
-          Found in line   : ${actualProject}
-          Line            : ${line}`);
-                }
-                const expectedKey = makeKey(keyToTest);
-                if (key !== expectedKey) {
-                    throw new Error(`Deployment script path or internal name mismatch:
-          Expected key    : ${key}
-          Found in line   : ${expectedKey}
-          Line            : ${line}`);
-                }
-            }
-        }
-        else {
-            const m2 = line.match(/^-- Deploy (.*?)(?:\s+to\s+pg)?\s*$/);
-            if (m2) {
-                const keyToTest = m2[1].trim();
-                if (key !== makeKey(keyToTest)) {
-                    throw new Error('deployment script in wrong place or is named wrong internally\n' + line);
-                }
-            }
-        }
-    }
-    return { requires };
-}
-/**
- * Verify that every change in a module's pgpm.plan has a deploy script whose
- * header identity matches its path, and report dependency drift between the
- * plan's dep lists and the scripts' `-- requires:` lines.
- *
- * Read-only diagnostic; returns issues rather than throwing.
- */
-function verifyPlanMatchesHeaders(moduleDir) {
-    const issues = [];
-    const planPath = (0, path_1.join)(moduleDir, 'pgpm.plan');
-    const parsed = (0, parser_1.parsePlanFile)(planPath);
-    if (!parsed.data) {
-        throw new Error(`Failed to parse plan file: ${planPath}`);
-    }
-    for (const planChange of parsed.data.changes) {
-        const change = planChange.name;
-        const file = (0, path_1.join)(moduleDir, 'deploy', `${change}.sql`);
-        let content;
-        try {
-            content = (0, fs_1.readFileSync)(file, 'utf-8');
-        }
-        catch {
-            issues.push({
-                change,
-                file,
-                kind: 'missing-file',
-                message: `deploy script not found for plan change "${change}"`
-            });
-            continue;
-        }
-        const { header } = parsePgpmHeader(content);
-        if (header.change && header.change !== change) {
-            issues.push({
-                change,
-                file,
-                kind: 'identity-mismatch',
-                message: `header declares "${header.change}" but path identity is "${change}"`
-            });
-        }
-        const planDeps = new Set(planChange.dependencies || []);
-        const headerDeps = new Set(header.requires.map(r => r.raw));
-        const missingInHeader = [...planDeps].filter(d => !headerDeps.has(d));
-        const missingInPlan = [...headerDeps].filter(d => !planDeps.has(d));
-        if (missingInHeader.length > 0 || missingInPlan.length > 0) {
-            const parts = [];
-            if (missingInHeader.length > 0) {
-                parts.push(`in plan but not in header requires: ${missingInHeader.join(', ')}`);
-            }
-            if (missingInPlan.length > 0) {
-                parts.push(`in header requires but not in plan: ${missingInPlan.join(', ')}`);
-            }
-            issues.push({
-                change,
-                file,
-                kind: 'requires-drift',
-                message: parts.join('; ')
-            });
-        }
-    }
-    return issues;
-}

package/files/sql/index.d.ts

@@ -1,2 +0,0 @@
-export * from './header';
-export * from './writer';

package/files/sql/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./header"), exports);
-__exportStar(require("./writer"), exports);

package/files/sql/writer.d.ts

@@ -1,12 +0,0 @@
-import { PgpmRow } from '../types';
-export interface SqlWriteOptions {
-    outdir: string;
-    name: string;
-    replacer: (str: string) => string;
-    author?: string;
-    useTx?: boolean;
-}
-/**
- * Write SQL files for PGPM migrations (deploy, revert, verify)
- */
-export declare const writePgpmFiles: (rows: PgpmRow[], opts: SqlWriteOptions) => void;

package/files/sql/writer.js

@@ -1,114 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writePgpmFiles = void 0;
-const env_1 = require("@pgpmjs/env");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * Write SQL files for PGPM migrations (deploy, revert, verify)
- */
-const writePgpmFiles = (rows, opts) => {
-    rows.forEach((row) => writeVerify(row, opts));
-    rows.forEach((row) => writeRevert(row, opts));
-    rows.forEach((row) => writeDeploy(row, opts));
-};
-exports.writePgpmFiles = writePgpmFiles;
-/**
- * Sort dependencies in a consistent order
- */
-const ordered = (arr) => {
-    if (!arr)
-        return [];
-    return arr.sort((a, b) => a.length - b.length || a.localeCompare(b));
-};
-/**
- * Write a deploy SQL file for a PGPM change
- */
-const writeDeploy = (row, opts) => {
-    const globalOpts = (0, env_1.getEnvOptions)({
-        migrations: {
-            codegen: {
-                useTx: opts.useTx
-            }
-        }
-    });
-    const useTx = globalOpts.migrations.codegen.useTx;
-    const deploy = opts.replacer(row.deploy);
-    const dir = path_1.default.dirname(deploy);
-    const prefix = path_1.default.join(opts.outdir, opts.name, 'deploy');
-    const actualDir = path_1.default.resolve(prefix, dir);
-    const actualFile = path_1.default.resolve(prefix, `${deploy}.sql`);
-    fs_1.default.mkdirSync(actualDir, { recursive: true });
-    const sqlContent = opts.replacer(row.content);
-    const content = `-- Deploy: ${deploy}
--- made with <3 @ constructive.io
-
-${opts.replacer(ordered(row?.deps)
-        .map((dep) => `-- requires: ${dep}`)
-        .join('\n') || '')}
-
-${useTx ? 'BEGIN;' : ''}
-${sqlContent}
-${useTx ? 'COMMIT;' : ''}
-`;
-    fs_1.default.writeFileSync(actualFile, content);
-};
-/**
- * Write a verify SQL file for a PGPM change
- */
-const writeVerify = (row, opts) => {
-    const globalOpts = (0, env_1.getEnvOptions)({
-        migrations: {
-            codegen: {
-                useTx: opts.useTx
-            }
-        }
-    });
-    const useTx = globalOpts.migrations.codegen.useTx;
-    const deploy = opts.replacer(row.deploy);
-    const dir = path_1.default.dirname(deploy);
-    const prefix = path_1.default.join(opts.outdir, opts.name, 'verify');
-    const actualDir = path_1.default.resolve(prefix, dir);
-    const actualFile = path_1.default.resolve(prefix, `${deploy}.sql`);
-    fs_1.default.mkdirSync(actualDir, { recursive: true });
-    const sqlContent = opts.replacer(row.verify);
-    const content = opts.replacer(`-- Verify: ${deploy}
-
-${useTx ? 'BEGIN;' : ''}
-${sqlContent}
-${useTx ? 'COMMIT;' : ''}
-
-`);
-    fs_1.default.writeFileSync(actualFile, content);
-};
-/**
- * Write a revert SQL file for a PGPM change
- */
-const writeRevert = (row, opts) => {
-    const globalOpts = (0, env_1.getEnvOptions)({
-        migrations: {
-            codegen: {
-                useTx: opts.useTx
-            }
-        }
-    });
-    const useTx = globalOpts.migrations.codegen.useTx;
-    const deploy = opts.replacer(row.deploy);
-    const dir = path_1.default.dirname(deploy);
-    const prefix = path_1.default.join(opts.outdir, opts.name, 'revert');
-    const actualDir = path_1.default.resolve(prefix, dir);
-    const actualFile = path_1.default.resolve(prefix, `${deploy}.sql`);
-    fs_1.default.mkdirSync(actualDir, { recursive: true });
-    const sqlContent = opts.replacer(row.revert);
-    const content = `-- Revert: ${deploy}
-
-${useTx ? 'BEGIN;' : ''}
-${sqlContent}
-${useTx ? 'COMMIT;' : ''}
-
-`;
-    fs_1.default.writeFileSync(actualFile, content);
-};

package/files/sql-scripts/index.d.ts

@@ -1 +0,0 @@
-export * from './reader';

package/files/sql-scripts/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// Re-export all sql-scripts functionality
-__exportStar(require("./reader"), exports);

package/files/sql-scripts/reader.d.ts

@@ -1,8 +0,0 @@
-/**
- * Read a SQL script file, return empty string if not found
- */
-export declare function readScript(basePath: string, scriptType: string, changeName: string): string;
-/**
- * Check if a script file exists
- */
-export declare function scriptExists(basePath: string, scriptType: string, changeName: string): boolean;

package/files/sql-scripts/reader.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readScript = readScript;
-exports.scriptExists = scriptExists;
-const fs_1 = require("fs");
-const path_1 = require("path");
-/**
- * Read a SQL script file, return empty string if not found
- */
-function readScript(basePath, scriptType, changeName) {
-    const scriptPath = (0, path_1.join)(basePath, scriptType, `${changeName}.sql`);
-    if (!(0, fs_1.existsSync)(scriptPath)) {
-        return '';
-    }
-    return (0, fs_1.readFileSync)(scriptPath, 'utf-8');
-}
-/**
- * Check if a script file exists
- */
-function scriptExists(basePath, scriptType, changeName) {
-    const scriptPath = (0, path_1.join)(basePath, scriptType, `${changeName}.sql`);
-    return (0, fs_1.existsSync)(scriptPath);
-}

package/files/types/index.d.ts

@@ -1,46 +0,0 @@
-export * from './package';
-export interface Change {
-    name: string;
-    dependencies: string[];
-    timestamp?: string;
-    planner?: string;
-    email?: string;
-    comment?: string;
-}
-export interface PlanFile {
-    package: string;
-    uri?: string;
-    changes: Change[];
-}
-export interface Tag {
-    name: string;
-    change: string;
-    timestamp?: string;
-    planner?: string;
-    email?: string;
-    comment?: string;
-}
-export interface ExtendedPlanFile extends PlanFile {
-    tags: Tag[];
-}
-export interface ParseError {
-    line: number;
-    message: string;
-}
-export interface ParseResult<T> {
-    data?: T;
-    errors: ParseError[];
-}
-export interface ResolvedReference {
-    type: 'change' | 'tag' | 'sha1' | 'relative';
-    target: string;
-    resolved?: string;
-}
-export interface PgpmRow {
-    deploy: string;
-    revert?: string;
-    verify?: string;
-    content: string;
-    deps?: string[];
-    name?: string;
-}

package/files/types/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./package"), exports);

package/files/types/package.d.ts

@@ -1,20 +0,0 @@
-export interface PackageAnalysisIssue {
-    code: string;
-    message: string;
-    file?: string;
-    fixable?: boolean;
-}
-export interface PackageAnalysisResult {
-    ok: boolean;
-    name: string;
-    path: string;
-    issues: PackageAnalysisIssue[];
-}
-export interface RenameOptions {
-    dryRun?: boolean;
-    syncPackageJsonName?: boolean;
-}
-export interface RenameResult {
-    changed: string[];
-    warnings: string[];
-}

package/files/types/package.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/utils/author.d.ts

@@ -1,5 +0,0 @@
-export interface ParsedAuthor {
-    fullName: string;
-    email?: string;
-}
-export declare function parseAuthor(author: string): ParsedAuthor;

package/utils/author.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseAuthor = parseAuthor;
-function parseAuthor(author) {
-    const trimmed = (author || '').trim();
-    const match = trimmed.match(/^(.+?)\s*<([^>]+)>$/);
-    if (match) {
-        return {
-            fullName: match[1].trim(),
-            email: match[2].trim()
-        };
-    }
-    return { fullName: trimmed };
-}