@rawsql-ts/ddl-docs-cli 0.2.2

package/dist/src/utils/ddlInputDedupe.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dedupeDdlInputsByInstanceAndPath = dedupeDdlInputsByInstanceAndPath;
+/**
+ * Dedupe DDL inputs by the tuple key of (instance, path).
+ *
+ * Inputs sharing only the path are preserved when their instance differs.
+ * The key format intentionally uses a NUL separator to avoid collisions with
+ * common path characters on Windows and POSIX.
+ */
+function dedupeDdlInputsByInstanceAndPath(inputs) {
+    const seen = new Set();
+    return inputs.filter((input) => {
+        var _a;
+        const normalizedInstance = (_a = input.instance) !== null && _a !== void 0 ? _a : '';
+        const normalizedPath = input.path;
+        const key = `${normalizedInstance}\0${normalizedPath}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=ddlInputDedupe.js.map

package/dist/src/utils/ddlInputDedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddlInputDedupe.js","sourceRoot":"","sources":["../../../src/utils/ddlInputDedupe.ts"],"names":[],"mappings":";;AASA,4EAYC;AAnBD;;;;;;GAMG;AACH,SAAgB,gCAAgC,CAAC,MAAkB;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;;QAC7B,MAAM,kBAAkB,GAAG,MAAA,KAAK,CAAC,QAAQ,mCAAI,EAAE,CAAC;QAChD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC;QAClC,MAAM,GAAG,GAAG,GAAG,kBAAkB,KAAK,cAAc,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/utils/fs.d.ts

@@ -0,0 +1,13 @@
+import type { DdlInput, SqlSource } from '../types';
+export declare function ensureDirectory(directoryPath: string): void;
+export declare function toWorkspaceRelative(filePath: string): string;
+/**
+ * Collects SQL sources from directory and file inputs with instance metadata.
+ *
+ * @param directories Directory inputs as `DdlInput` entries. Each entry carries a path and optional instance.
+ * @param files File inputs as `DdlInput` entries. Each entry carries a path and optional instance.
+ * @param extensions Allowed SQL file extensions. Values are normalized before matching.
+ * @returns Sorted `SqlSource[]` entries containing workspace-relative path, SQL text, and instance.
+ */
+export declare function collectSqlFiles(directories: DdlInput[], files: DdlInput[], extensions: string[]): SqlSource[];
+export declare function expandGlobPatterns(patterns: string[]): string[];

package/dist/src/utils/fs.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirectory = ensureDirectory;
+exports.toWorkspaceRelative = toWorkspaceRelative;
+exports.collectSqlFiles = collectSqlFiles;
+exports.expandGlobPatterns = expandGlobPatterns;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+function ensureDirectory(directoryPath) {
+    if (!(0, node_fs_1.existsSync)(directoryPath)) {
+        (0, node_fs_1.mkdirSync)(directoryPath, { recursive: true });
+    }
+}
+function toWorkspaceRelative(filePath) {
+    return node_path_1.default.relative(process.cwd(), filePath).replace(/\\/g, '/');
+}
+/**
+ * Collects SQL sources from directory and file inputs with instance metadata.
+ *
+ * @param directories Directory inputs as `DdlInput` entries. Each entry carries a path and optional instance.
+ * @param files File inputs as `DdlInput` entries. Each entry carries a path and optional instance.
+ * @param extensions Allowed SQL file extensions. Values are normalized before matching.
+ * @returns Sorted `SqlSource[]` entries containing workspace-relative path, SQL text, and instance.
+ */
+function collectSqlFiles(directories, files, extensions) {
+    const extensionSet = new Set(extensions.map((entry) => normalizeExtension(entry)));
+    const sources = [];
+    const seen = new Set();
+    for (const entry of directories) {
+        const { path: directory, instance } = normalizeDdlInput(entry);
+        const resolvedDirectory = node_path_1.default.resolve(directory);
+        if (!(0, node_fs_1.existsSync)(resolvedDirectory)) {
+            throw new Error(`DDL directory not found: ${resolvedDirectory}`);
+        }
+        // Recommended layout: ddl/{instance}/{schema}.sql
+        // If no explicit instance is given, auto-detect from first-level subfolder names.
+        // Files placed directly under the root dir get instance = "" (no instance).
+        if (instance) {
+            scanDirectoryRecursive(resolvedDirectory, extensionSet, sources, seen, instance);
+        }
+        else {
+            scanRootDirectory(resolvedDirectory, extensionSet, sources, seen);
+        }
+    }
+    for (const entry of files) {
+        const { path: filePath, instance } = normalizeDdlInput(entry);
+        const resolvedPath = node_path_1.default.resolve(filePath);
+        if (!(0, node_fs_1.existsSync)(resolvedPath)) {
+            throw new Error(`DDL file not found: ${resolvedPath}`);
+        }
+        appendSqlFile(resolvedPath, extensionSet, sources, seen, instance);
+    }
+    return sources.sort((a, b) => a.path.localeCompare(b.path));
+}
+function normalizeDdlInput(entry) {
+    var _a;
+    if (typeof entry === 'string') {
+        return { path: entry, instance: '' };
+    }
+    return {
+        path: entry.path,
+        instance: (_a = entry.instance) !== null && _a !== void 0 ? _a : '',
+    };
+}
+function expandGlobPatterns(patterns) {
+    const matches = new Set();
+    for (const pattern of patterns) {
+        const normalizedPattern = pattern.replace(/\\/g, '/');
+        const rootDir = resolveGlobRoot(normalizedPattern);
+        if (!(0, node_fs_1.existsSync)(rootDir)) {
+            continue;
+        }
+        const allFiles = [];
+        collectAllFiles(rootDir, allFiles);
+        const matcher = globToRegExp(node_path_1.default.resolve(normalizedPattern).replace(/\\/g, '/'));
+        for (const filePath of allFiles) {
+            const normalizedFile = filePath.replace(/\\/g, '/');
+            if (matcher.test(normalizedFile)) {
+                matches.add(filePath);
+            }
+        }
+    }
+    return Array.from(matches).sort((a, b) => a.localeCompare(b));
+}
+/**
+ * Scans the root DDL directory.
+ * First-level subdirectories become instance names (recommended: ddl/{instance}/{schema}.sql).
+ * Files placed directly in the root get instance = "" (no instance).
+ */
+function scanRootDirectory(rootDirectory, extensionSet, sources, seen) {
+    const entries = (0, node_fs_1.readdirSync)(rootDirectory, { withFileTypes: true });
+    for (const entry of entries) {
+        const resolved = node_path_1.default.join(rootDirectory, entry.name);
+        if (entry.isDirectory()) {
+            scanDirectoryRecursive(resolved, extensionSet, sources, seen, entry.name);
+            continue;
+        }
+        if (entry.isFile()) {
+            appendSqlFile(resolved, extensionSet, sources, seen, '');
+        }
+    }
+}
+/**
+ * Recursively scans a directory with a fixed instance name.
+ */
+function scanDirectoryRecursive(directory, extensionSet, sources, seen, instance) {
+    const entries = (0, node_fs_1.readdirSync)(directory, { withFileTypes: true });
+    for (const entry of entries) {
+        const resolved = node_path_1.default.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            scanDirectoryRecursive(resolved, extensionSet, sources, seen, instance);
+            continue;
+        }
+        if (entry.isFile()) {
+            appendSqlFile(resolved, extensionSet, sources, seen, instance);
+        }
+    }
+}
+function appendSqlFile(filePath, extensionSet, sources, seen, instance) {
+    const extension = normalizeExtension(node_path_1.default.extname(filePath));
+    if (!extensionSet.has(extension)) {
+        return;
+    }
+    const normalizedPath = node_path_1.default.normalize(filePath);
+    const dedupeKey = `${instance}\u0000${normalizedPath}`;
+    if (seen.has(dedupeKey)) {
+        return;
+    }
+    const sql = (0, node_fs_1.readFileSync)(filePath, 'utf8');
+    if (!sql.trim()) {
+        return;
+    }
+    seen.add(dedupeKey);
+    sources.push({
+        path: toWorkspaceRelative(filePath),
+        sql,
+        instance,
+    });
+}
+function normalizeExtension(extension) {
+    const trimmed = extension.trim().toLowerCase();
+    if (!trimmed) {
+        return '';
+    }
+    return trimmed.startsWith('.') ? trimmed : `.${trimmed}`;
+}
+function collectAllFiles(directory, acc) {
+    const entries = (0, node_fs_1.readdirSync)(directory, { withFileTypes: true });
+    for (const entry of entries) {
+        const resolved = node_path_1.default.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            collectAllFiles(resolved, acc);
+            continue;
+        }
+        if (entry.isFile()) {
+            acc.push(node_path_1.default.resolve(resolved));
+        }
+    }
+}
+function resolveGlobRoot(pattern) {
+    const absolute = node_path_1.default.resolve(pattern);
+    const tokens = absolute.split('/');
+    const rootTokens = [];
+    for (const token of tokens) {
+        if (token.includes('*') || token.includes('?')) {
+            break;
+        }
+        rootTokens.push(token);
+    }
+    if (rootTokens.length === 0) {
+        return process.cwd();
+    }
+    return rootTokens.join('/');
+}
+function globToRegExp(pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    const withGlob = escaped
+        .replace(/\\\*\\\*/g, '___DOUBLE_STAR___')
+        .replace(/\\\*/g, '[^/]*')
+        .replace(/\\\?/g, '[^/]')
+        .replace(/___DOUBLE_STAR___/g, '.*');
+    return new RegExp(`^${withGlob}$`);
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/utils/fs.js.map

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

package/dist/src/utils/io.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeLf(text: string): string;
+export declare function writeTextFileNormalized(filePath: string, text: string): void;

package/dist/src/utils/io.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeLf = normalizeLf;
+exports.writeTextFileNormalized = writeTextFileNormalized;
+const node_fs_1 = require("node:fs");
+function normalizeLf(text) {
+    const normalized = text.replace(/\r\n/g, '\n');
+    return normalized.endsWith('\n') ? normalized : `${normalized}\n`;
+}
+function writeTextFileNormalized(filePath, text) {
+    (0, node_fs_1.writeFileSync)(filePath, normalizeLf(text), 'utf8');
+}
+//# sourceMappingURL=io.js.map

package/dist/src/utils/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../src/utils/io.ts"],"names":[],"mappings":";;AAEA,kCAGC;AAED,0DAEC;AATD,qCAAwC;AAExC,SAAgB,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC;AACpE,CAAC;AAED,SAAgB,uBAAuB,CAAC,QAAgB,EAAE,IAAY;IACpE,IAAA,uBAAa,EAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/src/utils/markdown.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Escapes markdown-sensitive characters for table cells and normalizes line breaks.
+ */
+export declare function escapeMarkdownText(input: string): string;
+/**
+ * Formats nullable plain-text values for markdown table cells.
+ */
+export declare function formatTableCell(value: string | null | undefined): string;
+/**
+ * Formats nullable values as inline code for markdown table cells.
+ */
+export declare function formatCodeCell(value: string | null | undefined): string;

package/dist/src/utils/markdown.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeMarkdownText = escapeMarkdownText;
+exports.formatTableCell = formatTableCell;
+exports.formatCodeCell = formatCodeCell;
+/**
+ * Escapes markdown-sensitive characters for table cells and normalizes line breaks.
+ */
+function escapeMarkdownText(input) {
+    return input
+        .replace(/\|/g, '\\|')
+        .replace(/\r?\n/g, '<br>')
+        .trim();
+}
+/**
+ * Formats nullable plain-text values for markdown table cells.
+ */
+function formatTableCell(value) {
+    if (value === null || value === undefined || value.trim().length === 0) {
+        return '-';
+    }
+    return escapeMarkdownText(value);
+}
+/**
+ * Formats nullable values as inline code for markdown table cells.
+ */
+function formatCodeCell(value) {
+    if (value === null || value === undefined || value.trim().length === 0) {
+        return '-';
+    }
+    const escaped = value.replace(/`/g, '\\`');
+    return `\`${escaped}\``;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/src/utils/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/utils/markdown.ts"],"names":[],"mappings":";;AAGA,gDAKC;AAKD,0CAKC;AAKD,wCAMC;AA7BD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK;SACT,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;SACzB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAgC;IAC9D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAgC;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,OAAO,IAAI,CAAC;AAC1B,CAAC"}

package/dist/src/utils/pgDumpFilter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Removes pg_dump-specific administrative SQL statements from DDL output.
+ *
+ * Filters out GRANT, REVOKE, ALTER ... OWNER TO, SET, \connect, and
+ * SELECT pg_catalog.set_config statements that appear in pg_dump output
+ * but are not relevant for schema documentation.
+ */
+export declare function filterPgDump(sql: string): string;

package/dist/src/utils/pgDumpFilter.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterPgDump = filterPgDump;
+// pg_dump administrative statements are line-start keyword driven, so a small
+// regex list is a guarded fallback here instead of a full SQL AST parse.
+const SKIP_PATTERNS = [
+    /^GRANT\b/i,
+    /^REVOKE\b/i,
+    /^ALTER\b.*\bOWNER\s+TO\b/i,
+    /^SET\b/i,
+    /^SELECT\s+pg_catalog\.set_config\b/i,
+];
+/**
+ * Removes pg_dump-specific administrative SQL statements from DDL output.
+ *
+ * Filters out GRANT, REVOKE, ALTER ... OWNER TO, SET, \connect, and
+ * SELECT pg_catalog.set_config statements that appear in pg_dump output
+ * but are not relevant for schema documentation.
+ */
+function filterPgDump(sql) {
+    const lines = sql.split('\n');
+    const output = [];
+    let skipping = false;
+    for (const line of lines) {
+        const trimmed = line.trimStart();
+        if (!skipping) {
+            if (/^\\connect\b/i.test(trimmed)) {
+                continue;
+            }
+            if (SKIP_PATTERNS.some((pattern) => pattern.test(trimmed))) {
+                skipping = true;
+            }
+            else {
+                output.push(line);
+            }
+        }
+        if (skipping && hasStatementTerminator(line)) {
+            skipping = false;
+        }
+    }
+    return output.join('\n');
+}
+function hasStatementTerminator(line) {
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    for (let index = 0; index < line.length; index += 1) {
+        const char = line[index];
+        const next = line[index + 1];
+        if (inLineComment) {
+            break;
+        }
+        if (inBlockComment) {
+            if (char === '*' && next === '/') {
+                inBlockComment = false;
+                index += 1;
+            }
+            continue;
+        }
+        if (inSingleQuote) {
+            if (char === "'" && next === "'") {
+                index += 1;
+                continue;
+            }
+            if (char === "'") {
+                inSingleQuote = false;
+            }
+            continue;
+        }
+        if (inDoubleQuote) {
+            if (char === '"' && next === '"') {
+                index += 1;
+                continue;
+            }
+            if (char === '"') {
+                inDoubleQuote = false;
+            }
+            continue;
+        }
+        if (char === '-' && next === '-') {
+            inLineComment = true;
+            continue;
+        }
+        if (char === '/' && next === '*') {
+            inBlockComment = true;
+            index += 1;
+            continue;
+        }
+        if (char === "'") {
+            inSingleQuote = true;
+            continue;
+        }
+        if (char === '"') {
+            inDoubleQuote = true;
+            continue;
+        }
+        if (char === ';') {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=pgDumpFilter.js.map

package/dist/src/utils/pgDumpFilter.js.map

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

package/dist/src/utils/slug.d.ts

@@ -0,0 +1 @@
+export declare function slugifyIdentifier(value: string): string;

package/dist/src/utils/slug.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugifyIdentifier = slugifyIdentifier;
+function slugifyIdentifier(value) {
+    const normalized = value
+        .trim()
+        .replace(/^"|"$/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return normalized || 'unnamed';
+}
+//# sourceMappingURL=slug.js.map

package/dist/src/utils/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../../src/utils/slug.ts"],"names":[],"mappings":";;AAAA,8CAQC;AARD,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,MAAM,UAAU,GAAG,KAAK;SACrB,IAAI,EAAE;SACN,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rawsql-ts/ddl-docs-cli",
+  "version": "0.2.2",
+  "description": "CLI tool that generates Markdown table definition docs from DDL files using rawsql-ts",
+  "main": "dist/src/index.js",
+  "bin": {
+    "ddl-docs": "dist/src/index.js"
+  },
+  "scripts": {
+    "prepack": "node -e \"const fs=require('fs');const cp=require('child_process');const npm=process.platform==='win32'?'npm.cmd':'npm';if(!fs.existsSync('dist/src/index.js')){process.exit(cp.spawnSync(npm,['run','build'],{stdio:'inherit'}).status??1)}\"",
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "rawsql-ts",
+    "ddl",
+    "markdown",
+    "docs",
+    "cli"
+  ],
+  "author": "msugiura",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "rawsql-ts": "workspace:^"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.7"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "AGENTS.md"
+  ]
+}