@rawsql-ts/ztd-cli 0.16.0 → 0.19.0

package/templates/tests/support/testkit-client.webapi.ts

@@ -0,0 +1,14 @@
+import type { SqlClient } from '../../src/infrastructure/db/sql-client';
+
+/**
+ * Placeholder for wiring an SQL client that tests can reuse.
+ *
+ * Replace this implementation with your chosen adapter (pg, mysql2, etc.) or a
+ * fixture-based helper that fulfills the `SqlClient` contract. Avoid committing
+ * production credentials inside this file.
+ */
+export async function createTestkitClient(): Promise<SqlClient> {
+  throw new Error(
+    'Provide a SqlClient implementation here (for example by adapting pg via src/infrastructure/db/sql-client-adapters.ts, or by importing @rawsql-ts/adapter-node-pg for ZTD-backed tests).',
+  );
+}

package/templates/tests/ztd-layout.generated.ts

@@ -1,6 +1,6 @@
-// GENERATED FILE. DO NOT EDIT.
-
-export default {
-  ztdRootDir: 'ztd',
-  ddlDir: 'ztd/ddl',
-};
+// GENERATED FILE. DO NOT EDIT.
+
+export default {
+  ztdRootDir: 'ztd',
+  ddlDir: 'ztd/ddl',
+};

package/templates/tsconfig.json

@@ -1,8 +1,15 @@
-{
-  "extends": "../../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "tsBuildInfoFile": "dist/.tsbuildinfo"
-  },
-  "include": ["src/**/*.ts", "tests/**/*.ts"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "tsBuildInfoFile": "dist/.tsbuildinfo"
+  },
+  "include": ["src/**/*.ts", "tests/**/*.ts"]
+}

package/templates/vitest.config.ts

@@ -1,13 +1,13 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    include: ['tests/**/*.test.ts'],
-    environment: 'node',
-    globals: true,
-    globalSetup: ['tests/support/global-setup.ts'],
-    // Starting a Postgres testcontainer can exceed the default 5s timeout on some machines.
-    testTimeout: 60_000,
-    hookTimeout: 60_000,
-  },
-});
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    include: ['tests/**/*.test.ts'],
+    environment: 'node',
+    globals: true,
+    globalSetup: ['tests/support/global-setup.ts'],
+    // Starting a Postgres testcontainer can exceed the default 5s timeout on some machines.
+    testTimeout: 60_000,
+    hookTimeout: 60_000,
+  },
+});

package/templates/ztd/AGENTS.md

@@ -1,74 +1,23 @@
-# AGENTS: Zero Table Dependency Definitions
-
-This file defines **protected, human-led domains** under the `ztd/` directory.
-AI must treat these directories as authoritative sources of truth and must not modify them without explicit instruction.
-These rules govern the `ztd/` contents after project initialization and apply regardless of mapper, writer, or runtime architecture decisions.
-
----
-
-## Generated files (important)
-
-- `tests/generated/` is auto-generated and must never be committed.
-- After cloning the repository (or in a clean environment), run `npx ztd ztd-config`.
-- If TypeScript reports missing modules or type errors because `tests/generated/` is missing, run `npx ztd ztd-config`.
-- Generated artifacts exist solely to support validation and testing and MUST NEVER influence definitions under `ztd/`.
-
----
-
-## DDL Specifications (`ztd/ddl/`)
-
-You are an AI assistant responsible for **reading and respecting** the contents of this directory.
-
-### Purpose
-
-This directory contains all canonical definitions of database structure, including:
-
-- CREATE TABLE
-- ALTER TABLE
-- Constraints
-- Indexes
-
-It is the **single source of truth** for the physical database schema as interpreted by ztd-cli.
-
-### Behavior Rules (strict)
-
-- **Never modify files in this directory unless explicitly instructed by a human.**
-- Do not apply “helpful” refactors, cleanups, or formatting changes on your own.
-- You may propose edits or review changes when asked, but you must not apply them without approval.
-- All DDL statements must be:
-  - Valid PostgreSQL syntax
-  - Explicitly semicolon-terminated
-- Do not reorder statements; dependency and execution order matters.
-- Preserve all human-authored:
-  - Naming
-  - Formatting
-  - Comments
-  - Structural intent
-- When asked to extend existing definitions:
-  - Do not remove or rewrite existing columns or comments unless explicitly told.
-  - Maintain column order and constraint style.
-  - Do not introduce schema changes that conflict with existing constraints or indexes.
-- The `public.user_account` and `public.user_profile` tables exist to support the mapper/writer sample; any modification to those tables is a maintenance obligation that requires concurrent updates to `src/repositories/user-accounts.ts` and `tests/writer-constraints.test.ts` so the workflow keeps functioning.
-- DDL defines physical truth only and MUST NEVER be reshaped to accommodate mapper, writer, or test tooling.
-- Runtime convenience is never a valid reason to alter DDL.
-
-If there is uncertainty, stop and request clarification instead of guessing.
-
----
-
-- Only `ztd/ddl` is part of the canonical `ztd` contract; do not create or assume additional subdirectories without explicit human direction.
-
----
-
-## Absolute Restrictions (important)
-
-- AI must not modify anything under `ztd/` by default.
-- DDL is the only **human-led artifact** in this directory.
-- AI may assist by:
-  - Reading
-  - Explaining
-  - Proposing diffs
-- AI may apply changes **only** with explicit instruction.
-- No tooling limitation, test strategy, or runtime design justifies modifying `ztd/` artifacts.
-
-Violation of these rules leads to silent corruption of domain meaning and is unacceptable.
+# Package Scope
+- Applies to `packages/ztd-cli/templates/ztd`.
+- Governs ZTD inputs and related metadata used for generation.
+
+# Policy
+## REQUIRED
+- `ztd/ddl` MUST remain the human-owned source of truth inside `ztd`.
+
+## ALLOWED
+- Tests MAY reference ZTD DDL and generated outputs through ZTD tooling.
+
+## PROHIBITED
+- Creating new `ztd` subdirectories without explicit instruction.
+- Modifying `ztd/README.md` without explicit instruction.
+
+# Mandatory Workflow
+- DDL-related rule updates MUST be made in `ztd/ddl/AGENTS.md`.
+
+# Hygiene
+- Keep runtime code independent from `ztd` subtree dependencies.
+
+# References
+- DDL policy: [./ddl/AGENTS.md](./ddl/AGENTS.md)

package/templates/ztd/README.md

@@ -1,15 +1,6 @@
-# ZTD Definitions
-
-This directory hosts the schema definitions under `ztd/ddl/`. Every DDL file in that folder is the single source of truth for database objects; parser tools and tests read these files to learn table structures, columns, indexes, and constraints.
-
-## DDL Guidelines
-
-- Place every schema definition under `ztd/ddl/` with valid PostgreSQL and semicolon-terminated statements.
-- Keep the files deterministic: avoid generated output, enforce column ordering, and document any non-obvious constraints with comments.
-- When you rename or drop a column, update the corresponding DDL file rather than trying to patch test artifacts manually.
-- Treat `ztd/ddl/` as a human-maintained catalog; AI may assist but must not invent or diverge from the files stored there.
-
-## Workflow expectations
-
-- Regenerate `tests/generated/ztd-row-map.generated.ts` via `npx ztd ztd-config` whenever the DDL changes.
-- Do not assume any other subdirectories under `/ztd` exist unless a human has explicitly created them for a specific purpose.
+# ztd/
+
+This directory stores ZTD schema artifacts.
+
+- `ztd/ddl/<schema>.sql` is the source of truth for schema.
+- Run `npx ztd ztd-config` to regenerate `tests/generated` outputs.

package/templates/ztd/ddl/AGENTS.md

@@ -0,0 +1,26 @@
+# Package Scope
+- Applies to `packages/ztd-cli/templates/ztd/ddl`.
+- Defines contract rules for human-owned physical schema definitions.
+
+# Policy
+## REQUIRED
+- DDL semantics MUST remain human-owned.
+- Table and column comments MUST be included for important schema elements.
+- DDL naming and file organization MUST stay consistent within the selected strategy.
+
+## ALLOWED
+- AI MAY assist with mechanical DDL edits when explicitly requested.
+- Foreign keys MAY be used when intentional and documented.
+
+## PROHIBITED
+- Inventing domain rules without explicit instruction.
+- Inconsistent schema splitting strategy within this subtree.
+
+# Mandatory Workflow
+- DDL changes MUST preserve comment statements and naming conventions.
+
+# Hygiene
+- Maintain explicit NOT NULL and unique constraints where contract semantics require them.
+
+# References
+- Parent ZTD policy: [../AGENTS.md](../AGENTS.md)

package/templates/ztd/ddl/demo.sql

@@ -0,0 +1,74 @@
+create table "user" (
+  user_id     serial8 primary key,
+  user_name   text not null,
+  email       text not null,
+  created_at  timestamptz not null default current_timestamp
+);
+
+comment on table "user" is
+  'User master. Referenced by task_assignment.';
+
+comment on column "user".user_id is
+  'Primary key of user.';
+comment on column "user".user_name is
+  'Display name of the user.';
+comment on column "user".email is
+  'Email address of the user.';
+comment on column "user".created_at is
+  'Timestamp when the user was created.';
+
+create table task (
+  task_id     serial8 primary key,
+  title       text not null,
+  status      text not null,
+  priority    integer not null,
+  due_date    date,
+  created_at  timestamptz not null default current_timestamp
+);
+
+comment on table task is
+  'Task entity. Current assignee is derived from task_assignment history.';
+
+comment on column task.task_id is
+  'Primary key of task.';
+comment on column task.title is
+  'Short description of the task.';
+comment on column task.status is
+  'Task status. Example: open, in_progress, done.';
+comment on column task.priority is
+  'Priority of the task. Higher value means higher priority.';
+comment on column task.due_date is
+  'Optional due date of the task.';
+comment on column task.created_at is
+  'Timestamp when the task was created.';
+
+create table task_assignment (
+  task_assignment_id serial8 primary key,
+  task_id            bigint not null,
+  user_id            bigint not null,
+  assigned_at        timestamptz not null default current_timestamp
+);
+
+comment on table task_assignment is
+  'Assignment history of tasks. Latest assigned_at defines current assignee.';
+
+comment on column task_assignment.task_assignment_id is
+  'Primary key of task_assignment.';
+comment on column task_assignment.task_id is
+  'Referenced task identifier.';
+comment on column task_assignment.user_id is
+  'Referenced user identifier.';
+comment on column task_assignment.assigned_at is
+  'Timestamp when the task was assigned to the user.';
+
+create index idx_task_assignment_task
+  on task_assignment(task_id);
+
+create index idx_task_assignment_task_time
+  on task_assignment(task_id, assigned_at desc);
+
+comment on index idx_task_assignment_task is
+  'Index for joining task_assignment by task_id.';
+
+comment on index idx_task_assignment_task_time is
+  'Index for resolving latest assignment per task.';

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 MSugiura
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/commands/ddl.d.ts

@@ -1,7 +0,0 @@
-import { Command } from 'commander';
-/**
- * Registers all DDL-related commands (`pull`, `gen-entities`, `diff`) on the top-level CLI program.
- * @param program - The Commander program instance to extend.
- */
-export declare function registerDdlCommands(program: Command): void;
-export { collectDirectories, parseExtensions, DEFAULT_EXTENSIONS, DEFAULT_DDL_DIRECTORY } from './options';

package/dist/commands/ddl.js

@@ -1,118 +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.DEFAULT_DDL_DIRECTORY = exports.DEFAULT_EXTENSIONS = exports.parseExtensions = exports.collectDirectories = void 0;
-exports.registerDdlCommands = registerDdlCommands;
-const node_path_1 = __importDefault(require("node:path"));
-const diff_1 = require("./diff");
-const genEntities_1 = require("./genEntities");
-const pull_1 = require("./pull");
-const ztdProjectConfig_1 = require("../utils/ztdProjectConfig");
-const dbConnection_1 = require("../utils/dbConnection");
-const options_1 = require("./options");
-/**
- * Registers all DDL-related commands (`pull`, `gen-entities`, `diff`) on the top-level CLI program.
- * @param program - The Commander program instance to extend.
- */
-function registerDdlCommands(program) {
-    const ddl = program.command('ddl').description('DDL-focused workflows');
-    ddl
-        .command('pull')
-        .description('Retrieve the current schema DDL from a PostgreSQL database')
-        .option('--url <databaseUrl>', 'Connection string to use for pg_dump (optional; fallback to env/config)')
-        .option('--out <directory>', 'Destination directory for the pulled DDL', options_1.DEFAULT_DDL_DIRECTORY)
-        .option('--db-host <host>', 'Database host to use instead of DATABASE_URL')
-        .option('--db-port <port>', 'Database port (defaults to 5432)')
-        .option('--db-user <user>', 'Database user to connect as')
-        .option('--db-password <password>', 'Database password')
-        .option('--db-name <name>', 'Database name to connect to')
-        .option('--pg-dump-path <path>', 'Custom pg_dump executable path')
-        .option('--schema <schema>', 'Schema name to include (repeatable)', options_1.collectValues, [])
-        .option('--table <table>', 'Table spec (schema.table) to include (repeatable)', options_1.collectValues, [])
-        .action(async (options) => {
-        var _a, _b, _c;
-        const connection = resolveCliConnection(options);
-        await (0, pull_1.runPullSchema)({
-            url: connection.url,
-            out: (_a = options.out) !== null && _a !== void 0 ? _a : options_1.DEFAULT_DDL_DIRECTORY,
-            pgDumpPath: options.pgDumpPath,
-            schemas: (_b = options.schema) !== null && _b !== void 0 ? _b : [],
-            tables: (_c = options.table) !== null && _c !== void 0 ? _c : [],
-            connectionContext: connection.context
-        });
-    });
-    ddl
-        .command('gen-entities')
-        .description('Generate optional entities.ts helpers from the DDL snapshot')
-        .option('--ddl-dir <directory>', 'DDL directory to scan (repeatable)', options_1.collectDirectories, [])
-        .option('--extensions <list>', 'Comma-separated extensions to include', options_1.parseExtensions, options_1.DEFAULT_EXTENSIONS)
-        .option('--out <file>', 'Destination TypeScript file', node_path_1.default.join('src', 'entities.ts'))
-        .action(async (options) => {
-        var _a;
-        const directories = (0, options_1.normalizeDirectoryList)(options.ddlDir, options_1.DEFAULT_DDL_DIRECTORY);
-        const extensions = (0, options_1.resolveExtensions)(options.extensions, options_1.DEFAULT_EXTENSIONS);
-        await (0, genEntities_1.runGenerateEntities)({
-            directories,
-            extensions,
-            out: (_a = options.out) !== null && _a !== void 0 ? _a : node_path_1.default.join('src', 'entities.ts')
-        });
-    });
-    ddl
-        .command('diff')
-        .description('Compare local DDL against a live PostgreSQL database and emit a plan')
-        .option('--ddl-dir <directory>', 'DDL directory to scan (repeatable)', options_1.collectDirectories, [])
-        .option('--extensions <list>', 'Comma-separated extensions to include', options_1.parseExtensions, options_1.DEFAULT_EXTENSIONS)
-        .option('--url <databaseUrl>', 'Connection string to use for pg_dump (optional; fallback to env/config)')
-        .requiredOption('--out <file>', 'Output path for the generated plan file')
-        .option('--db-host <host>', 'Database host to use instead of DATABASE_URL')
-        .option('--db-port <port>', 'Database port (defaults to 5432)')
-        .option('--db-user <user>', 'Database user to connect as')
-        .option('--db-password <password>', 'Database password')
-        .option('--db-name <name>', 'Database name to connect to')
-        .option('--pg-dump-path <path>', 'Custom pg_dump executable path')
-        .action(async (options) => {
-        var _a;
-        const directories = (0, options_1.normalizeDirectoryList)((_a = options.ddlDir) !== null && _a !== void 0 ? _a : [], options_1.DEFAULT_DDL_DIRECTORY);
-        const extensions = (0, options_1.resolveExtensions)(options.extensions, options_1.DEFAULT_EXTENSIONS);
-        const connection = resolveCliConnection(options);
-        await (0, diff_1.runDiffSchema)({
-            directories,
-            extensions,
-            url: connection.url,
-            out: options.out,
-            pgDumpPath: options.pgDumpPath,
-            connectionContext: connection.context
-        });
-    });
-}
-/**
- * Resolves connection metadata for CLI commands using flags, environment, and project config.
- * @param options - CLI options containing optional overrides.
- * @returns The resolved connection and context.
- */
-function resolveCliConnection(options) {
-    // Gather configuration once per command so overrides and defaults stay synchronized.
-    return (0, dbConnection_1.resolveDatabaseConnection)(buildFlagSet(options), (0, ztdProjectConfig_1.loadZtdProjectConfig)(), options.url);
-}
-/**
- * Normalizes the incoming CLI flag values into the shared DbConnectionFlags shape.
- * @param options - CLI options exposing partial connection pieces.
- * @returns Flag object consumed by the `resolveDatabaseConnection` helper.
- */
-function buildFlagSet(options) {
-    return {
-        host: options.dbHost,
-        port: options.dbPort,
-        user: options.dbUser,
-        password: options.dbPassword,
-        database: options.dbName
-    };
-}
-var options_2 = require("./options");
-Object.defineProperty(exports, "collectDirectories", { enumerable: true, get: function () { return options_2.collectDirectories; } });
-Object.defineProperty(exports, "parseExtensions", { enumerable: true, get: function () { return options_2.parseExtensions; } });
-Object.defineProperty(exports, "DEFAULT_EXTENSIONS", { enumerable: true, get: function () { return options_2.DEFAULT_EXTENSIONS; } });
-Object.defineProperty(exports, "DEFAULT_DDL_DIRECTORY", { enumerable: true, get: function () { return options_2.DEFAULT_DDL_DIRECTORY; } });
-//# sourceMappingURL=ddl.js.map

package/dist/commands/ddl.js.map

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

package/dist/commands/diff.d.ts

@@ -1,10 +0,0 @@
-import type { DbConnectionContext } from '../utils/dbConnection';
-export interface DiffSchemaOptions {
-    directories: string[];
-    extensions: string[];
-    url: string;
-    out: string;
-    pgDumpPath?: string;
-    connectionContext?: DbConnectionContext;
-}
-export declare function runDiffSchema(options: DiffSchemaOptions): void;

package/dist/commands/diff.js

@@ -1,38 +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.runDiffSchema = runDiffSchema;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const diff_1 = require("diff");
-const collectSqlFiles_1 = require("../utils/collectSqlFiles");
-const fs_1 = require("../utils/fs");
-const pgDump_1 = require("../utils/pgDump");
-const connectionSummary_1 = require("../utils/connectionSummary");
-function runDiffSchema(options) {
-    const localSources = (0, collectSqlFiles_1.collectSqlFiles)(options.directories, options.extensions);
-    if (localSources.length === 0) {
-        throw new Error(`No SQL files were discovered under ${options.directories.join(', ')}`);
-    }
-    // Concatenate the local DDL files in a stable order for deterministic diff outputs.
-    const localSql = localSources.map((source) => source.sql).join('\n\n');
-    const remoteSql = (0, pgDump_1.runPgDump)({
-        url: options.url,
-        pgDumpPath: options.pgDumpPath,
-        connectionContext: options.connectionContext
-    });
-    const hasChanges = localSql !== remoteSql;
-    // Create a unified diff patch only when there are material differences to report.
-    const patch = hasChanges
-        ? (0, diff_1.createTwoFilesPatch)('local', 'database', localSql, remoteSql, '', '', { context: 3 })
-        : '-- No schema differences detected.';
-    const databaseTarget = (0, connectionSummary_1.formatConnectionTarget)(options.connectionContext) || 'target: unknown';
-    const header = `-- ztd ddl diff plan\n-- Local DDL: ${options.directories.join(', ')}\n-- Database: ${databaseTarget}\n-- Generated: ${new Date().toISOString()}\n\n`;
-    // Guarantee the target path exists before emitting the plan file.
-    (0, fs_1.ensureDirectory)(node_path_1.default.dirname(options.out));
-    (0, node_fs_1.writeFileSync)(options.out, `${header}${patch}\n`, 'utf8');
-    console.log(`DDL diff plan written to ${options.out}`);
-}
-//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":";;;;;AAkBA,sCA2BC;AA7CD,qCAAwC;AACxC,0DAA6B;AAC7B,+BAA2C;AAC3C,8DAA2D;AAC3D,oCAA8C;AAC9C,4CAA4C;AAC5C,kEAAoE;AAYpE,SAAgB,aAAa,CAAC,OAA0B;IACtD,MAAM,YAAY,GAAG,IAAA,iCAAe,EAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,oFAAoF;IACpF,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAA,kBAAS,EAAC;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,QAAQ,KAAK,SAAS,CAAC;IAC1C,kFAAkF;IAClF,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,IAAA,0BAAmB,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC,CAAC,oCAAoC,CAAC;IAEzC,MAAM,cAAc,GAAG,IAAA,0CAAsB,EAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC;IAC9F,MAAM,MAAM,GAAG,uCAAuC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,cAAc,mBAAmB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtK,kEAAkE;IAClE,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAA,uBAAa,EAAC,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/commands/genEntities.d.ts

@@ -1,6 +0,0 @@
-export interface GenerateEntitiesOptions {
-    directories: string[];
-    extensions: string[];
-    out: string;
-}
-export declare function runGenerateEntities(options: GenerateEntitiesOptions): void;

package/dist/commands/genEntities.js

@@ -1,50 +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.runGenerateEntities = runGenerateEntities;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const collectSqlFiles_1 = require("../utils/collectSqlFiles");
-const fs_1 = require("../utils/fs");
-const typeMapper_1 = require("../utils/typeMapper");
-const ztdConfig_1 = require("./ztdConfig");
-function runGenerateEntities(options) {
-    const sources = (0, collectSqlFiles_1.collectSqlFiles)(options.directories, options.extensions);
-    if (sources.length === 0) {
-        throw new Error(`No SQL files were discovered under ${options.directories.join(', ')}`);
-    }
-    const tables = (0, ztdConfig_1.snapshotTableMetadata)(sources);
-    if (tables.length === 0) {
-        throw new Error('The provided DDL sources did not contain any CREATE TABLE statements.');
-    }
-    const output = renderEntitiesFile(tables);
-    (0, fs_1.ensureDirectory)(node_path_1.default.dirname(options.out));
-    (0, node_fs_1.writeFileSync)(options.out, output, 'utf8');
-    console.log(`Generated ${tables.length} schema helpers at ${options.out}`);
-}
-function renderEntitiesFile(tables) {
-    // The header reminds maintainers that this file is a secondary reference next to tests/generated/ztd-row-map.generated.ts.
-    const header = [
-        '// ENTITY HELPERS - AUTO GENERATED',
-        '// Complementary reference for tooling. TestRowMap in tests/generated/ztd-row-map.generated.ts remains authoritative.',
-        ''
-    ].join('\n');
-    // Emit an interface per table to keep column metadata available for optional helpers.
-    const definitions = tables
-        .map((table) => {
-        const entityName = table.testRowInterfaceName.replace(/TestRow$/, 'Entity');
-        const fields = table.columns
-            .map((column) => {
-            const baseType = (0, typeMapper_1.mapSqlTypeToTs)(column.typeName, `${table.name}.${column.name}`);
-            const tsType = column.isNullable ? `${baseType} | null` : baseType;
-            return `  ${column.name}: ${tsType};`;
-        })
-            .join('\n');
-        return `export interface ${entityName} {\n${fields}\n}`;
-    })
-        .join('\n\n');
-    return `${header}${definitions}\n`;
-}
-//# sourceMappingURL=genEntities.js.map

package/dist/commands/genEntities.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"genEntities.js","sourceRoot":"","sources":["../../src/commands/genEntities.ts"],"names":[],"mappings":";;;;;AAaA,kDAeC;AA5BD,qCAAwC;AACxC,0DAA6B;AAC7B,8DAA2D;AAC3D,oCAA8C;AAC9C,oDAAqD;AACrD,2CAAwE;AAQxE,SAAgB,mBAAmB,CAAC,OAAgC;IAClE,MAAM,OAAO,GAAG,IAAA,iCAAe,EAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,iCAAqB,EAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAA,uBAAa,EAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,sBAAsB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAuB;IACjD,2HAA2H;IAC3H,MAAM,MAAM,GAAG;QACb,oCAAoC;QACpC,uHAAuH;QACvH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,sFAAsF;IACtF,MAAM,WAAW,GAAG,MAAM;SACvB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,UAAU,GAAG,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO;aACzB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACd,MAAM,QAAQ,GAAG,IAAA,2BAAc,EAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YACnE,OAAO,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,GAAG,CAAC;QACxC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,oBAAoB,UAAU,OAAO,MAAM,KAAK,CAAC;IAC1D,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO,GAAG,MAAM,GAAG,WAAW,IAAI,CAAC;AACrC,CAAC"}

package/dist/commands/init.d.ts

@@ -1,66 +0,0 @@
-import { Command } from 'commander';
-import { type ZtdConfigGenerationOptions } from './ztdConfig';
-import { type PullSchemaOptions } from './pull';
-type PackageManager = 'pnpm' | 'npm' | 'yarn';
-type PackageInstallKind = 'devDependencies' | 'install';
-/**
- * Prompt interface for interactive input during `ztd init`.
- */
-export interface Prompter {
-    selectChoice(question: string, choices: string[]): Promise<number>;
-    promptInput(question: string, example?: string): Promise<string>;
-    confirm(question: string): Promise<boolean>;
-    close(): void;
-}
-/**
- * Create a readline-backed prompter that reads from stdin/stdout.
- */
-export declare function createConsolePrompter(): Prompter;
-/**
- * Summarizes how an individual file was created during initialization.
- */
-export interface FileSummary {
-    relativePath: string;
-    outcome: 'created' | 'overwritten' | 'unchanged';
-}
-/**
- * Result payload for `ztd init` describing outputs and next steps.
- */
-export interface InitResult {
-    summary: string;
-    files: FileSummary[];
-}
-/**
- * Dependency overrides used to orchestrate the init flow and IO side effects.
- */
-export interface ZtdConfigWriterDependencies {
-    ensureDirectory: (directory: string) => void;
-    writeFile: (filePath: string, contents: string) => void;
-    fileExists: (filePath: string) => boolean;
-    runPullSchema: (options: PullSchemaOptions) => Promise<void> | void;
-    runGenerateZtdConfig: (options: ZtdConfigGenerationOptions) => Promise<void> | void;
-    checkPgDump: () => boolean;
-    log: (message: string) => void;
-    copyAgentsTemplate: (rootDir: string) => string | null;
-    installPackages: (options: {
-        rootDir: string;
-        kind: PackageInstallKind;
-        packages: string[];
-        packageManager: PackageManager;
-    }) => Promise<void> | void;
-}
-/**
- * Options for configuring the `ztd init` command execution.
- */
-export interface InitCommandOptions {
-    rootDir?: string;
-    dependencies?: Partial<ZtdConfigWriterDependencies>;
-    withSqlClient?: boolean;
-    withAppInterface?: boolean;
-}
-/**
- * Run the interactive `ztd init` workflow and return the resulting summary.
- */
-export declare function runInitCommand(prompter: Prompter, options?: InitCommandOptions): Promise<InitResult>;
-export declare function registerInitCommand(program: Command): void;
-export {};