postgresdk 0.18.5 → 0.18.7

package/dist/cli.js

@@ -473,11 +473,25 @@ var require_config = __commonJS(() => {
 // src/utils.ts
 import { mkdir, writeFile, readFile } from "fs/promises";
 import { dirname } from "path";
-async function writeFiles(files) {
+import { existsSync } from "fs";
+async function writeFilesIfChanged(files) {
+  let written = 0;
+  let unchanged = 0;
+  const filesWritten = [];
   for (const f of files) {
     await mkdir(dirname(f.path), { recursive: true });
+    if (existsSync(f.path)) {
+      const existing = await readFile(f.path, "utf-8");
+      if (existing === f.content) {
+        unchanged++;
+        continue;
+      }
+    }
     await writeFile(f.path, f.content, "utf-8");
+    written++;
+    filesWritten.push(f.path);
   }
+  return { written, unchanged, filesWritten };
 }
 async function ensureDirs(dirs) {
   for (const d of dirs)
@@ -1686,107 +1700,6 @@ var init_emit_sdk_contract = __esm(() => {
   init_emit_include_methods();
 });
 
-// src/cache.ts
-import { createHash } from "crypto";
-import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2, appendFile } from "fs/promises";
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-function computeSchemaHash(model, config) {
-  const payload = {
-    version: POSTGRESDK_VERSION,
-    schema: model.schema,
-    tables: model.tables,
-    enums: model.enums,
-    config: {
-      outDir: config.outDir,
-      schema: config.schema,
-      softDeleteColumn: config.softDeleteColumn,
-      includeMethodsDepth: config.includeMethodsDepth,
-      serverFramework: config.serverFramework,
-      useJsExtensions: config.useJsExtensions,
-      useJsExtensionsClient: config.useJsExtensionsClient,
-      numericMode: config.numericMode,
-      skipJunctionTables: config.skipJunctionTables,
-      apiPathPrefix: config.apiPathPrefix,
-      auth: config.auth,
-      tests: config.tests
-    }
-  };
-  const json = JSON.stringify(payload, Object.keys(payload).sort());
-  return createHash("sha256").update(json).digest("hex");
-}
-function getCacheDir(baseDir = process.cwd()) {
-  return join(baseDir, ".postgresdk");
-}
-async function ensureGitignore(baseDir = process.cwd()) {
-  const gitignorePath = join(baseDir, ".gitignore");
-  if (!existsSync(gitignorePath)) {
-    return;
-  }
-  try {
-    const content = await readFile2(gitignorePath, "utf-8");
-    if (content.includes(".postgresdk")) {
-      return;
-    }
-    const entry = `
-# PostgreSDK cache and history
-.postgresdk/
-`;
-    await appendFile(gitignorePath, entry);
-    console.log("✓ Added .postgresdk/ to .gitignore");
-  } catch {}
-}
-async function readCache(baseDir) {
-  const cachePath = join(getCacheDir(baseDir), "cache.json");
-  if (!existsSync(cachePath)) {
-    return null;
-  }
-  try {
-    const content = await readFile2(cachePath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
-async function writeCache(data, baseDir) {
-  const cacheDir = getCacheDir(baseDir);
-  const isNewCache = !existsSync(cacheDir);
-  await mkdir2(cacheDir, { recursive: true });
-  if (isNewCache) {
-    await ensureGitignore(baseDir);
-  }
-  const cachePath = join(cacheDir, "cache.json");
-  await writeFile2(cachePath, JSON.stringify(data, null, 2), "utf-8");
-}
-async function appendToHistory(entry, baseDir) {
-  const cacheDir = getCacheDir(baseDir);
-  const isNewCache = !existsSync(cacheDir);
-  await mkdir2(cacheDir, { recursive: true });
-  if (isNewCache) {
-    await ensureGitignore(baseDir);
-  }
-  const historyPath = join(cacheDir, "history.md");
-  const timestamp = new Date().toISOString().replace("T", " ").substring(0, 19);
-  const formattedEntry = `## ${timestamp} - ${entry}
-
-`;
-  try {
-    const existing = existsSync(historyPath) ? await readFile2(historyPath, "utf-8") : `# PostgreSDK Generation History
-
-`;
-    await writeFile2(historyPath, existing + formattedEntry, "utf-8");
-  } catch {
-    await writeFile2(historyPath, `# PostgreSDK Generation History
-
-${formattedEntry}`, "utf-8");
-  }
-}
-var __dirname = "/workspace/src", packageJson, POSTGRESDK_VERSION;
-var init_cache = __esm(() => {
-  packageJson = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
-  POSTGRESDK_VERSION = packageJson.version;
-});
-
 // src/cli-config-utils.ts
 function extractConfigFields(configContent) {
   const fields = [];
@@ -2206,7 +2119,7 @@ var exports_cli_init = {};
 __export(exports_cli_init, {
   initCommand: () => initCommand
 });
-import { existsSync as existsSync3, writeFileSync, readFileSync as readFileSync2, copyFileSync } from "fs";
+import { existsSync as existsSync3, writeFileSync, readFileSync, copyFileSync } from "fs";
 import { resolve } from "path";
 import prompts from "prompts";
 async function initCommand(args) {
@@ -2224,7 +2137,7 @@ async function initCommand(args) {
     }
     console.log(`⚠️  Found existing postgresdk.config.ts
 `);
-    const existingContent = readFileSync2(configPath, "utf-8");
+    const existingContent = readFileSync(configPath, "utf-8");
     const existingFields = extractConfigFields(existingContent);
     console.log("\uD83D\uDCCB Existing configuration detected:");
     existingFields.forEach((field) => {
@@ -2615,8 +2528,8 @@ var exports_cli_pull = {};
 __export(exports_cli_pull, {
   pullCommand: () => pullCommand
 });
-import { writeFile as writeFile3, mkdir as mkdir3, readFile as readFile3 } from "fs/promises";
-import { join as join3, dirname as dirname3, resolve as resolve2 } from "path";
+import { writeFile as writeFile2, mkdir as mkdir2, readFile as readFile2 } from "fs/promises";
+import { join as join2, dirname as dirname2, resolve as resolve2 } from "path";
 import { existsSync as existsSync4 } from "fs";
 import { pathToFileURL as pathToFileURL2 } from "url";
 async function pullCommand(args) {
@@ -2702,72 +2615,54 @@ Options:`);
     let filesUnchanged = 0;
     const changedFiles = [];
     for (const [path, content] of Object.entries(sdk.files)) {
-      const fullPath = join3(config.output, path);
-      await mkdir3(dirname3(fullPath), { recursive: true });
+      const fullPath = join2(config.output, path);
+      await mkdir2(dirname2(fullPath), { recursive: true });
       let shouldWrite = true;
       if (existsSync4(fullPath)) {
-        const existing = await readFile3(fullPath, "utf-8");
+        const existing = await readFile2(fullPath, "utf-8");
         if (existing === content) {
           shouldWrite = false;
           filesUnchanged++;
         }
       }
       if (shouldWrite) {
-        await writeFile3(fullPath, content, "utf-8");
+        await writeFile2(fullPath, content, "utf-8");
         filesWritten++;
         changedFiles.push(path);
         console.log(`  ✓ ${path}`);
       }
     }
-    const metadataPath = join3(config.output, ".postgresdk.json");
+    const metadataPath = join2(config.output, ".postgresdk.json");
     const metadata = {
       version: sdk.version,
       pulledFrom: config.from
     };
     let metadataChanged = true;
     if (existsSync4(metadataPath)) {
-      const existing = await readFile3(metadataPath, "utf-8");
+      const existing = await readFile2(metadataPath, "utf-8");
       if (existing === JSON.stringify(metadata, null, 2)) {
         metadataChanged = false;
       }
     }
     if (metadataChanged) {
-      await writeFile3(metadataPath, JSON.stringify(metadata, null, 2));
+      await writeFile2(metadataPath, JSON.stringify(metadata, null, 2));
     }
     if (filesWritten === 0 && !metadataChanged) {
       console.log(`✅ SDK up-to-date (${filesUnchanged} files unchanged)`);
-      await appendToHistory(`Pull
-✅ SDK up-to-date
-- Pulled from: ${config.from}
-- Files checked: ${filesUnchanged}`);
     } else {
       console.log(`✅ SDK pulled successfully to ${config.output}`);
       console.log(`   Updated: ${filesWritten} files, Unchanged: ${filesUnchanged} files`);
-      let logEntry = `Pull
-✅ Updated ${filesWritten} files from ${config.from}
-- SDK version: ${sdk.version}
-- Files unchanged: ${filesUnchanged}`;
-      if (changedFiles.length > 0 && changedFiles.length <= 10) {
-        logEntry += `
-- Modified: ${changedFiles.join(", ")}`;
-      } else if (changedFiles.length > 10) {
-        logEntry += `
-- Modified: ${changedFiles.slice(0, 10).join(", ")} and ${changedFiles.length - 10} more...`;
-      }
-      await appendToHistory(logEntry);
     }
   } catch (err) {
     console.error(`❌ Pull failed:`, err);
     process.exit(1);
   }
 }
-var init_cli_pull = __esm(() => {
-  init_cache();
-});
+var init_cli_pull = () => {};
 
 // src/index.ts
 var import_config = __toESM(require_config(), 1);
-import { join as join2, relative } from "node:path";
+import { join, relative } from "node:path";
 import { pathToFileURL } from "node:url";
 import { existsSync as existsSync2 } from "node:fs";
 
@@ -3565,6 +3460,7 @@ function emitClient(table, graph, opts, model) {
     }
   }
   const typeImports = `import type { Insert${Type}, Update${Type}, Select${Type} } from "./types/${table.name}${ext}";`;
+  const includeSpecImport = `import type { ${Type}IncludeSpec } from "./include-spec${ext}";`;
   const otherTableImports = [];
   for (const target of Array.from(importedTypes)) {
     if (target !== table.name) {
@@ -3647,7 +3543,7 @@ function emitClient(table, graph, opts, model) {
       order?: "asc" | "desc";
       limit?: number;
       offset?: number;
-      include?: any;
+      include?: ${Type}IncludeSpec;
     };
   }`;
     }
@@ -3755,6 +3651,7 @@ import { BaseClient } from "./base-client${ext}";
 import type { Where } from "./where-types${ext}";
 import type { PaginatedResponse } from "./types/shared${ext}";
 ${typeImports}
+${includeSpecImport}
 ${otherTableImports.join(`
 `)}
 
@@ -3904,7 +3801,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list<TJsonb extends Partial<Select${Type}> = {}>(params: {
     select: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}<TJsonb>>;${hasVectorColumns ? `
@@ -3924,7 +3821,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list<TJsonb extends Partial<Select${Type}> = {}>(params: {
     exclude: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}<TJsonb>>;${hasVectorColumns ? `
@@ -3952,7 +3849,7 @@ ${hasJsonbColumns ? `  /**
    * const users = await client.list<{ metadata: Metadata }>({ where: { status: 'active' } });
    */
   async list<TJsonb extends Partial<Select${Type}> = {}>(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}<TJsonb>>;${hasVectorColumns ? `
@@ -3966,7 +3863,7 @@ ${hasJsonbColumns ? `  /**
     order?: "asc" | "desc" | ("asc" | "desc")[];
   }): Promise<PaginatedResponse<Select${Type}<TJsonb>${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list<TJsonb extends Partial<Select${Type}> = {}>(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     select?: string[];
     exclude?: string[];
     limit?: number;
@@ -3989,7 +3886,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list(params: {
     select: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}>;${hasVectorColumns ? `
@@ -4009,7 +3906,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list(params: {
     exclude: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}>;${hasVectorColumns ? `
@@ -4034,7 +3931,7 @@ ${hasJsonbColumns ? `  /**
    * @returns Paginated results with all fields
    */
   async list(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}>;${hasVectorColumns ? `
@@ -4048,7 +3945,7 @@ ${hasJsonbColumns ? `  /**
     order?: "asc" | "desc" | ("asc" | "desc")[];
   }): Promise<PaginatedResponse<Select${Type}${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     select?: string[];
     exclude?: string[];
     limit?: number;
@@ -7159,7 +7056,6 @@ function generateTestCases(table, sampleData, updateData, hasForeignKeys = false
 // src/index.ts
 init_emit_sdk_contract();
 init_utils();
-init_cache();
 async function generate(configPath) {
   if (!existsSync2(configPath)) {
     throw new Error(`Config file not found: ${configPath}
@@ -7174,58 +7070,43 @@ async function generate(configPath) {
   const cfg = { ...rawCfg, auth: normalizedAuth };
   console.log("\uD83D\uDD0D Introspecting database...");
   const model = await introspect(cfg.connectionString, cfg.schema || "public");
-  const schemaHash = computeSchemaHash(model, cfg);
-  const cache = await readCache();
-  let serverDir;
-  if (typeof cfg.outDir === "string") {
-    serverDir = cfg.outDir;
-  } else if (cfg.outDir && typeof cfg.outDir === "object") {
-    serverDir = cfg.outDir.server;
-  } else {
-    serverDir = "./api/server";
-  }
-  const currentOutDir = typeof cfg.outDir === "string" ? cfg.outDir : `${serverDir}`;
-  const cachedOutDir = typeof cache?.config.outDir === "string" ? cache.config.outDir : cache?.config.outDir?.server;
-  if (cache && cache.schemaHash === schemaHash && existsSync2(serverDir) && currentOutDir === cachedOutDir) {
-    console.log("✅ Schema unchanged, skipping generation");
-    await appendToHistory(`Generate
-✅ Schema unchanged, skipped generation
-- Schema hash: ${schemaHash.substring(0, 12)}...`);
-    return;
-  }
   console.log("\uD83D\uDD17 Building relationship graph...");
   const graph = buildGraph(model);
+  let serverDir;
   let originalClientDir;
   if (typeof cfg.outDir === "string") {
+    serverDir = cfg.outDir;
     originalClientDir = cfg.outDir;
   } else if (cfg.outDir && typeof cfg.outDir === "object") {
+    serverDir = cfg.outDir.server;
     originalClientDir = cfg.outDir.client;
   } else {
+    serverDir = "./api/server";
     originalClientDir = "./api/client";
   }
   const sameDirectory = serverDir === originalClientDir;
   let clientDir = originalClientDir;
   if (sameDirectory) {
-    clientDir = join2(originalClientDir, "sdk");
+    clientDir = join(originalClientDir, "sdk");
   }
   const serverFramework = cfg.serverFramework || "hono";
   const generateTests = cfg.tests?.generate ?? false;
   const originalTestDir = cfg.tests?.output || "./api/tests";
   let testDir = originalTestDir;
   if (generateTests && (originalTestDir === serverDir || originalTestDir === originalClientDir)) {
-    testDir = join2(originalTestDir, "tests");
+    testDir = join(originalTestDir, "tests");
   }
   const testFramework = cfg.tests?.framework || "vitest";
   console.log("\uD83D\uDCC1 Creating directories...");
   const dirs = [
     serverDir,
-    join2(serverDir, "types"),
-    join2(serverDir, "zod"),
-    join2(serverDir, "routes"),
+    join(serverDir, "types"),
+    join(serverDir, "zod"),
+    join(serverDir, "routes"),
     clientDir,
-    join2(clientDir, "types"),
-    join2(clientDir, "zod"),
-    join2(clientDir, "params")
+    join(clientDir, "types"),
+    join(clientDir, "zod"),
+    join(clientDir, "params")
   ];
   if (generateTests) {
     dirs.push(testDir);
@@ -7233,26 +7114,26 @@ async function generate(configPath) {
   await ensureDirs(dirs);
   const files = [];
   const includeSpec = emitIncludeSpec(graph);
-  files.push({ path: join2(serverDir, "include-spec.ts"), content: includeSpec });
-  files.push({ path: join2(clientDir, "include-spec.ts"), content: includeSpec });
-  files.push({ path: join2(clientDir, "params", "shared.ts"), content: emitSharedParamsZod() });
-  files.push({ path: join2(clientDir, "types", "shared.ts"), content: emitSharedTypes() });
-  files.push({ path: join2(clientDir, "base-client.ts"), content: emitBaseClient() });
-  files.push({ path: join2(clientDir, "where-types.ts"), content: emitWhereTypes() });
+  files.push({ path: join(serverDir, "include-spec.ts"), content: includeSpec });
+  files.push({ path: join(clientDir, "include-spec.ts"), content: includeSpec });
+  files.push({ path: join(clientDir, "params", "shared.ts"), content: emitSharedParamsZod() });
+  files.push({ path: join(clientDir, "types", "shared.ts"), content: emitSharedTypes() });
+  files.push({ path: join(clientDir, "base-client.ts"), content: emitBaseClient() });
+  files.push({ path: join(clientDir, "where-types.ts"), content: emitWhereTypes() });
   files.push({
-    path: join2(serverDir, "include-builder.ts"),
+    path: join(serverDir, "include-builder.ts"),
     content: emitIncludeBuilder(graph, cfg.includeMethodsDepth || 2)
   });
   files.push({
-    path: join2(serverDir, "include-loader.ts"),
+    path: join(serverDir, "include-loader.ts"),
     content: emitIncludeLoader(graph, model, cfg.includeMethodsDepth || 2, cfg.useJsExtensions)
   });
-  files.push({ path: join2(serverDir, "logger.ts"), content: emitLogger() });
+  files.push({ path: join(serverDir, "logger.ts"), content: emitLogger() });
   if (getAuthStrategy(normalizedAuth) !== "none") {
-    files.push({ path: join2(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
+    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
   }
   files.push({
-    path: join2(serverDir, "core", "operations.ts"),
+    path: join(serverDir, "core", "operations.ts"),
     content: emitCoreOperations()
   });
   if (process.env.SDK_DEBUG) {
@@ -7261,13 +7142,13 @@ async function generate(configPath) {
   for (const table of Object.values(model.tables)) {
     const numericMode = cfg.numericMode ?? "auto";
     const typesSrc = emitTypes(table, { numericMode }, model.enums);
-    files.push({ path: join2(serverDir, "types", `${table.name}.ts`), content: typesSrc });
-    files.push({ path: join2(clientDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join(serverDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join(clientDir, "types", `${table.name}.ts`), content: typesSrc });
     const zodSrc = emitZod(table, { numericMode }, model.enums);
-    files.push({ path: join2(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
-    files.push({ path: join2(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
     const paramsZodSrc = emitParamsZod(table, graph);
-    files.push({ path: join2(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
+    files.push({ path: join(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
     let routeContent;
     if (serverFramework === "hono") {
       routeContent = emitHonoRoutes(table, graph, {
@@ -7281,11 +7162,11 @@ async function generate(configPath) {
       throw new Error(`Framework "${serverFramework}" is not yet supported. Currently only "hono" is available.`);
     }
     files.push({
-      path: join2(serverDir, "routes", `${table.name}.ts`),
+      path: join(serverDir, "routes", `${table.name}.ts`),
       content: routeContent
     });
     files.push({
-      path: join2(clientDir, `${table.name}.ts`),
+      path: join(clientDir, `${table.name}.ts`),
       content: emitClient(table, graph, {
         useJsExtensions: cfg.useJsExtensionsClient,
         includeMethodsDepth: cfg.includeMethodsDepth ?? 2,
@@ -7294,12 +7175,12 @@ async function generate(configPath) {
     });
   }
   files.push({
-    path: join2(clientDir, "index.ts"),
+    path: join(clientDir, "index.ts"),
     content: emitClientIndex(Object.values(model.tables), cfg.useJsExtensionsClient)
   });
   if (serverFramework === "hono") {
     files.push({
-      path: join2(serverDir, "router.ts"),
+      path: join(serverDir, "router.ts"),
       content: emitHonoRouter(Object.values(model.tables), getAuthStrategy(normalizedAuth) !== "none", cfg.useJsExtensions, cfg.pullToken)
     });
   }
@@ -7309,73 +7190,64 @@ async function generate(configPath) {
   }
   const contract = generateUnifiedContract2(model, cfg, graph);
   files.push({
-    path: join2(serverDir, "CONTRACT.md"),
+    path: join(serverDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   files.push({
-    path: join2(clientDir, "CONTRACT.md"),
+    path: join(clientDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   const contractCode = emitUnifiedContract(model, cfg, graph);
   files.push({
-    path: join2(serverDir, "contract.ts"),
+    path: join(serverDir, "contract.ts"),
     content: contractCode
   });
   const clientFiles = files.filter((f) => {
     return f.path.includes(clientDir);
   });
   files.push({
-    path: join2(serverDir, "sdk-bundle.ts"),
+    path: join(serverDir, "sdk-bundle.ts"),
     content: emitSdkBundle(clientFiles, clientDir)
   });
   if (generateTests) {
     console.log("\uD83E\uDDEA Generating tests...");
     const relativeClientPath = relative(testDir, clientDir);
     files.push({
-      path: join2(testDir, "setup.ts"),
+      path: join(testDir, "setup.ts"),
       content: emitTestSetup(relativeClientPath, testFramework)
     });
     files.push({
-      path: join2(testDir, "docker-compose.yml"),
+      path: join(testDir, "docker-compose.yml"),
       content: emitDockerCompose()
     });
     files.push({
-      path: join2(testDir, "run-tests.sh"),
+      path: join(testDir, "run-tests.sh"),
       content: emitTestScript(testFramework, testDir)
     });
     files.push({
-      path: join2(testDir, ".gitignore"),
+      path: join(testDir, ".gitignore"),
       content: emitTestGitignore()
     });
     if (testFramework === "vitest") {
       files.push({
-        path: join2(testDir, "vitest.config.ts"),
+        path: join(testDir, "vitest.config.ts"),
         content: emitVitestConfig()
       });
     }
     for (const table of Object.values(model.tables)) {
       files.push({
-        path: join2(testDir, `${table.name}.test.ts`),
+        path: join(testDir, `${table.name}.test.ts`),
         content: emitTableTest(table, model, relativeClientPath, testFramework)
       });
     }
   }
   console.log("✍️  Writing files...");
-  await writeFiles(files);
-  const outDirStr = typeof cfg.outDir === "string" ? cfg.outDir : `${cfg.outDir?.server || "./api/server"}`;
-  await writeCache({
-    schemaHash,
-    lastRun: new Date().toISOString(),
-    filesGenerated: files.length,
-    config: {
-      outDir: cfg.outDir || "./api",
-      schema: cfg.schema || "public"
-    }
-  });
-  await appendToHistory(`Generate
-✅ Generated ${files.length} files
-- Schema hash: ${schemaHash.substring(0, 12)}...`);
-  console.log(`✅ Generated ${files.length} files`);
+  const writeResult = await writeFilesIfChanged(files);
+  if (writeResult.written === 0) {
+    console.log(`✅ All ${writeResult.unchanged} files up-to-date (no changes)`);
+  } else {
+    console.log(`✅ Updated ${writeResult.written} files, ${writeResult.unchanged} unchanged`);
+  }
   console.log(`  Server: ${serverDir}`);
   console.log(`  Client: ${sameDirectory ? clientDir + " (in sdk subdir due to same output dir)" : clientDir}`);
   if (generateTests) {
@@ -7411,13 +7283,13 @@ async function generate(configPath) {
 // src/cli.ts
 var import_config2 = __toESM(require_config(), 1);
 import { resolve as resolve3 } from "node:path";
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync2 } from "node:fs";
 import { fileURLToPath } from "node:url";
-import { dirname as dirname4, join as join4 } from "node:path";
+import { dirname as dirname3, join as join3 } from "node:path";
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = dirname4(__filename2);
-var packageJson2 = JSON.parse(readFileSync3(join4(__dirname2, "../package.json"), "utf-8"));
-var VERSION = packageJson2.version;
+var __dirname2 = dirname3(__filename2);
+var packageJson = JSON.parse(readFileSync2(join3(__dirname2, "../package.json"), "utf-8"));
+var VERSION = packageJson.version;
 var args = process.argv.slice(2);
 var command = args[0];
 if (args.includes("--version") || args.includes("-v") || command === "version") {

package/dist/index.js

@@ -472,11 +472,25 @@ var require_config = __commonJS(() => {
 // src/utils.ts
 import { mkdir, writeFile, readFile } from "fs/promises";
 import { dirname } from "path";
-async function writeFiles(files) {
+import { existsSync } from "fs";
+async function writeFilesIfChanged(files) {
+  let written = 0;
+  let unchanged = 0;
+  const filesWritten = [];
   for (const f of files) {
     await mkdir(dirname(f.path), { recursive: true });
+    if (existsSync(f.path)) {
+      const existing = await readFile(f.path, "utf-8");
+      if (existing === f.content) {
+        unchanged++;
+        continue;
+      }
+    }
     await writeFile(f.path, f.content, "utf-8");
+    written++;
+    filesWritten.push(f.path);
   }
+  return { written, unchanged, filesWritten };
 }
 async function ensureDirs(dirs) {
   for (const d of dirs)
@@ -1685,110 +1699,9 @@ var init_emit_sdk_contract = __esm(() => {
   init_emit_include_methods();
 });
 
-// src/cache.ts
-import { createHash } from "crypto";
-import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2, appendFile } from "fs/promises";
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-function computeSchemaHash(model, config) {
-  const payload = {
-    version: POSTGRESDK_VERSION,
-    schema: model.schema,
-    tables: model.tables,
-    enums: model.enums,
-    config: {
-      outDir: config.outDir,
-      schema: config.schema,
-      softDeleteColumn: config.softDeleteColumn,
-      includeMethodsDepth: config.includeMethodsDepth,
-      serverFramework: config.serverFramework,
-      useJsExtensions: config.useJsExtensions,
-      useJsExtensionsClient: config.useJsExtensionsClient,
-      numericMode: config.numericMode,
-      skipJunctionTables: config.skipJunctionTables,
-      apiPathPrefix: config.apiPathPrefix,
-      auth: config.auth,
-      tests: config.tests
-    }
-  };
-  const json = JSON.stringify(payload, Object.keys(payload).sort());
-  return createHash("sha256").update(json).digest("hex");
-}
-function getCacheDir(baseDir = process.cwd()) {
-  return join(baseDir, ".postgresdk");
-}
-async function ensureGitignore(baseDir = process.cwd()) {
-  const gitignorePath = join(baseDir, ".gitignore");
-  if (!existsSync(gitignorePath)) {
-    return;
-  }
-  try {
-    const content = await readFile2(gitignorePath, "utf-8");
-    if (content.includes(".postgresdk")) {
-      return;
-    }
-    const entry = `
-# PostgreSDK cache and history
-.postgresdk/
-`;
-    await appendFile(gitignorePath, entry);
-    console.log("✓ Added .postgresdk/ to .gitignore");
-  } catch {}
-}
-async function readCache(baseDir) {
-  const cachePath = join(getCacheDir(baseDir), "cache.json");
-  if (!existsSync(cachePath)) {
-    return null;
-  }
-  try {
-    const content = await readFile2(cachePath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
-async function writeCache(data, baseDir) {
-  const cacheDir = getCacheDir(baseDir);
-  const isNewCache = !existsSync(cacheDir);
-  await mkdir2(cacheDir, { recursive: true });
-  if (isNewCache) {
-    await ensureGitignore(baseDir);
-  }
-  const cachePath = join(cacheDir, "cache.json");
-  await writeFile2(cachePath, JSON.stringify(data, null, 2), "utf-8");
-}
-async function appendToHistory(entry, baseDir) {
-  const cacheDir = getCacheDir(baseDir);
-  const isNewCache = !existsSync(cacheDir);
-  await mkdir2(cacheDir, { recursive: true });
-  if (isNewCache) {
-    await ensureGitignore(baseDir);
-  }
-  const historyPath = join(cacheDir, "history.md");
-  const timestamp = new Date().toISOString().replace("T", " ").substring(0, 19);
-  const formattedEntry = `## ${timestamp} - ${entry}
-
-`;
-  try {
-    const existing = existsSync(historyPath) ? await readFile2(historyPath, "utf-8") : `# PostgreSDK Generation History
-
-`;
-    await writeFile2(historyPath, existing + formattedEntry, "utf-8");
-  } catch {
-    await writeFile2(historyPath, `# PostgreSDK Generation History
-
-${formattedEntry}`, "utf-8");
-  }
-}
-var __dirname = "/workspace/src", packageJson, POSTGRESDK_VERSION;
-var init_cache = __esm(() => {
-  packageJson = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
-  POSTGRESDK_VERSION = packageJson.version;
-});
-
 // src/index.ts
 var import_config = __toESM(require_config(), 1);
-import { join as join2, relative } from "node:path";
+import { join, relative } from "node:path";
 import { pathToFileURL } from "node:url";
 import { existsSync as existsSync2 } from "node:fs";
 
@@ -2586,6 +2499,7 @@ function emitClient(table, graph, opts, model) {
     }
   }
   const typeImports = `import type { Insert${Type}, Update${Type}, Select${Type} } from "./types/${table.name}${ext}";`;
+  const includeSpecImport = `import type { ${Type}IncludeSpec } from "./include-spec${ext}";`;
   const otherTableImports = [];
   for (const target of Array.from(importedTypes)) {
     if (target !== table.name) {
@@ -2668,7 +2582,7 @@ function emitClient(table, graph, opts, model) {
       order?: "asc" | "desc";
       limit?: number;
       offset?: number;
-      include?: any;
+      include?: ${Type}IncludeSpec;
     };
   }`;
     }
@@ -2776,6 +2690,7 @@ import { BaseClient } from "./base-client${ext}";
 import type { Where } from "./where-types${ext}";
 import type { PaginatedResponse } from "./types/shared${ext}";
 ${typeImports}
+${includeSpecImport}
 ${otherTableImports.join(`
 `)}
 
@@ -2925,7 +2840,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list<TJsonb extends Partial<Select${Type}> = {}>(params: {
     select: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}<TJsonb>>;${hasVectorColumns ? `
@@ -2945,7 +2860,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list<TJsonb extends Partial<Select${Type}> = {}>(params: {
     exclude: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}<TJsonb>>;${hasVectorColumns ? `
@@ -2973,7 +2888,7 @@ ${hasJsonbColumns ? `  /**
    * const users = await client.list<{ metadata: Metadata }>({ where: { status: 'active' } });
    */
   async list<TJsonb extends Partial<Select${Type}> = {}>(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}<TJsonb>>;${hasVectorColumns ? `
@@ -2987,7 +2902,7 @@ ${hasJsonbColumns ? `  /**
     order?: "asc" | "desc" | ("asc" | "desc")[];
   }): Promise<PaginatedResponse<Select${Type}<TJsonb>${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list<TJsonb extends Partial<Select${Type}> = {}>(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     select?: string[];
     exclude?: string[];
     limit?: number;
@@ -3010,7 +2925,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list(params: {
     select: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}>;${hasVectorColumns ? `
@@ -3030,7 +2945,7 @@ ${hasJsonbColumns ? `  /**
    */
   async list(params: {
     exclude: string[];
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}>;${hasVectorColumns ? `
@@ -3055,7 +2970,7 @@ ${hasJsonbColumns ? `  /**
    * @returns Paginated results with all fields
    */
   async list(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     limit?: number;
     offset?: number;
     where?: Where<Select${Type}>;${hasVectorColumns ? `
@@ -3069,7 +2984,7 @@ ${hasJsonbColumns ? `  /**
     order?: "asc" | "desc" | ("asc" | "desc")[];
   }): Promise<PaginatedResponse<Select${Type}${hasVectorColumns ? " & { _distance?: number }" : ""}>>;
   async list(params?: {
-    include?: any;
+    include?: ${Type}IncludeSpec;
     select?: string[];
     exclude?: string[];
     limit?: number;
@@ -6180,7 +6095,6 @@ function generateTestCases(table, sampleData, updateData, hasForeignKeys = false
 // src/index.ts
 init_emit_sdk_contract();
 init_utils();
-init_cache();
 async function generate(configPath) {
   if (!existsSync2(configPath)) {
     throw new Error(`Config file not found: ${configPath}
@@ -6195,58 +6109,43 @@ async function generate(configPath) {
   const cfg = { ...rawCfg, auth: normalizedAuth };
   console.log("\uD83D\uDD0D Introspecting database...");
   const model = await introspect(cfg.connectionString, cfg.schema || "public");
-  const schemaHash = computeSchemaHash(model, cfg);
-  const cache = await readCache();
-  let serverDir;
-  if (typeof cfg.outDir === "string") {
-    serverDir = cfg.outDir;
-  } else if (cfg.outDir && typeof cfg.outDir === "object") {
-    serverDir = cfg.outDir.server;
-  } else {
-    serverDir = "./api/server";
-  }
-  const currentOutDir = typeof cfg.outDir === "string" ? cfg.outDir : `${serverDir}`;
-  const cachedOutDir = typeof cache?.config.outDir === "string" ? cache.config.outDir : cache?.config.outDir?.server;
-  if (cache && cache.schemaHash === schemaHash && existsSync2(serverDir) && currentOutDir === cachedOutDir) {
-    console.log("✅ Schema unchanged, skipping generation");
-    await appendToHistory(`Generate
-✅ Schema unchanged, skipped generation
-- Schema hash: ${schemaHash.substring(0, 12)}...`);
-    return;
-  }
   console.log("\uD83D\uDD17 Building relationship graph...");
   const graph = buildGraph(model);
+  let serverDir;
   let originalClientDir;
   if (typeof cfg.outDir === "string") {
+    serverDir = cfg.outDir;
     originalClientDir = cfg.outDir;
   } else if (cfg.outDir && typeof cfg.outDir === "object") {
+    serverDir = cfg.outDir.server;
     originalClientDir = cfg.outDir.client;
   } else {
+    serverDir = "./api/server";
     originalClientDir = "./api/client";
   }
   const sameDirectory = serverDir === originalClientDir;
   let clientDir = originalClientDir;
   if (sameDirectory) {
-    clientDir = join2(originalClientDir, "sdk");
+    clientDir = join(originalClientDir, "sdk");
   }
   const serverFramework = cfg.serverFramework || "hono";
   const generateTests = cfg.tests?.generate ?? false;
   const originalTestDir = cfg.tests?.output || "./api/tests";
   let testDir = originalTestDir;
   if (generateTests && (originalTestDir === serverDir || originalTestDir === originalClientDir)) {
-    testDir = join2(originalTestDir, "tests");
+    testDir = join(originalTestDir, "tests");
   }
   const testFramework = cfg.tests?.framework || "vitest";
   console.log("\uD83D\uDCC1 Creating directories...");
   const dirs = [
     serverDir,
-    join2(serverDir, "types"),
-    join2(serverDir, "zod"),
-    join2(serverDir, "routes"),
+    join(serverDir, "types"),
+    join(serverDir, "zod"),
+    join(serverDir, "routes"),
     clientDir,
-    join2(clientDir, "types"),
-    join2(clientDir, "zod"),
-    join2(clientDir, "params")
+    join(clientDir, "types"),
+    join(clientDir, "zod"),
+    join(clientDir, "params")
   ];
   if (generateTests) {
     dirs.push(testDir);
@@ -6254,26 +6153,26 @@ async function generate(configPath) {
   await ensureDirs(dirs);
   const files = [];
   const includeSpec = emitIncludeSpec(graph);
-  files.push({ path: join2(serverDir, "include-spec.ts"), content: includeSpec });
-  files.push({ path: join2(clientDir, "include-spec.ts"), content: includeSpec });
-  files.push({ path: join2(clientDir, "params", "shared.ts"), content: emitSharedParamsZod() });
-  files.push({ path: join2(clientDir, "types", "shared.ts"), content: emitSharedTypes() });
-  files.push({ path: join2(clientDir, "base-client.ts"), content: emitBaseClient() });
-  files.push({ path: join2(clientDir, "where-types.ts"), content: emitWhereTypes() });
+  files.push({ path: join(serverDir, "include-spec.ts"), content: includeSpec });
+  files.push({ path: join(clientDir, "include-spec.ts"), content: includeSpec });
+  files.push({ path: join(clientDir, "params", "shared.ts"), content: emitSharedParamsZod() });
+  files.push({ path: join(clientDir, "types", "shared.ts"), content: emitSharedTypes() });
+  files.push({ path: join(clientDir, "base-client.ts"), content: emitBaseClient() });
+  files.push({ path: join(clientDir, "where-types.ts"), content: emitWhereTypes() });
   files.push({
-    path: join2(serverDir, "include-builder.ts"),
+    path: join(serverDir, "include-builder.ts"),
     content: emitIncludeBuilder(graph, cfg.includeMethodsDepth || 2)
   });
   files.push({
-    path: join2(serverDir, "include-loader.ts"),
+    path: join(serverDir, "include-loader.ts"),
     content: emitIncludeLoader(graph, model, cfg.includeMethodsDepth || 2, cfg.useJsExtensions)
   });
-  files.push({ path: join2(serverDir, "logger.ts"), content: emitLogger() });
+  files.push({ path: join(serverDir, "logger.ts"), content: emitLogger() });
   if (getAuthStrategy(normalizedAuth) !== "none") {
-    files.push({ path: join2(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
+    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
   }
   files.push({
-    path: join2(serverDir, "core", "operations.ts"),
+    path: join(serverDir, "core", "operations.ts"),
     content: emitCoreOperations()
   });
   if (process.env.SDK_DEBUG) {
@@ -6282,13 +6181,13 @@ async function generate(configPath) {
   for (const table of Object.values(model.tables)) {
     const numericMode = cfg.numericMode ?? "auto";
     const typesSrc = emitTypes(table, { numericMode }, model.enums);
-    files.push({ path: join2(serverDir, "types", `${table.name}.ts`), content: typesSrc });
-    files.push({ path: join2(clientDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join(serverDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join(clientDir, "types", `${table.name}.ts`), content: typesSrc });
     const zodSrc = emitZod(table, { numericMode }, model.enums);
-    files.push({ path: join2(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
-    files.push({ path: join2(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
     const paramsZodSrc = emitParamsZod(table, graph);
-    files.push({ path: join2(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
+    files.push({ path: join(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
     let routeContent;
     if (serverFramework === "hono") {
       routeContent = emitHonoRoutes(table, graph, {
@@ -6302,11 +6201,11 @@ async function generate(configPath) {
       throw new Error(`Framework "${serverFramework}" is not yet supported. Currently only "hono" is available.`);
     }
     files.push({
-      path: join2(serverDir, "routes", `${table.name}.ts`),
+      path: join(serverDir, "routes", `${table.name}.ts`),
       content: routeContent
     });
     files.push({
-      path: join2(clientDir, `${table.name}.ts`),
+      path: join(clientDir, `${table.name}.ts`),
       content: emitClient(table, graph, {
         useJsExtensions: cfg.useJsExtensionsClient,
         includeMethodsDepth: cfg.includeMethodsDepth ?? 2,
@@ -6315,12 +6214,12 @@ async function generate(configPath) {
     });
   }
   files.push({
-    path: join2(clientDir, "index.ts"),
+    path: join(clientDir, "index.ts"),
     content: emitClientIndex(Object.values(model.tables), cfg.useJsExtensionsClient)
   });
   if (serverFramework === "hono") {
     files.push({
-      path: join2(serverDir, "router.ts"),
+      path: join(serverDir, "router.ts"),
       content: emitHonoRouter(Object.values(model.tables), getAuthStrategy(normalizedAuth) !== "none", cfg.useJsExtensions, cfg.pullToken)
     });
   }
@@ -6330,73 +6229,64 @@ async function generate(configPath) {
   }
   const contract = generateUnifiedContract2(model, cfg, graph);
   files.push({
-    path: join2(serverDir, "CONTRACT.md"),
+    path: join(serverDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   files.push({
-    path: join2(clientDir, "CONTRACT.md"),
+    path: join(clientDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   const contractCode = emitUnifiedContract(model, cfg, graph);
   files.push({
-    path: join2(serverDir, "contract.ts"),
+    path: join(serverDir, "contract.ts"),
     content: contractCode
   });
   const clientFiles = files.filter((f) => {
     return f.path.includes(clientDir);
   });
   files.push({
-    path: join2(serverDir, "sdk-bundle.ts"),
+    path: join(serverDir, "sdk-bundle.ts"),
     content: emitSdkBundle(clientFiles, clientDir)
   });
   if (generateTests) {
     console.log("\uD83E\uDDEA Generating tests...");
     const relativeClientPath = relative(testDir, clientDir);
     files.push({
-      path: join2(testDir, "setup.ts"),
+      path: join(testDir, "setup.ts"),
       content: emitTestSetup(relativeClientPath, testFramework)
     });
     files.push({
-      path: join2(testDir, "docker-compose.yml"),
+      path: join(testDir, "docker-compose.yml"),
       content: emitDockerCompose()
     });
     files.push({
-      path: join2(testDir, "run-tests.sh"),
+      path: join(testDir, "run-tests.sh"),
       content: emitTestScript(testFramework, testDir)
     });
     files.push({
-      path: join2(testDir, ".gitignore"),
+      path: join(testDir, ".gitignore"),
       content: emitTestGitignore()
     });
     if (testFramework === "vitest") {
       files.push({
-        path: join2(testDir, "vitest.config.ts"),
+        path: join(testDir, "vitest.config.ts"),
         content: emitVitestConfig()
       });
     }
     for (const table of Object.values(model.tables)) {
       files.push({
-        path: join2(testDir, `${table.name}.test.ts`),
+        path: join(testDir, `${table.name}.test.ts`),
         content: emitTableTest(table, model, relativeClientPath, testFramework)
       });
     }
   }
   console.log("✍️  Writing files...");
-  await writeFiles(files);
-  const outDirStr = typeof cfg.outDir === "string" ? cfg.outDir : `${cfg.outDir?.server || "./api/server"}`;
-  await writeCache({
-    schemaHash,
-    lastRun: new Date().toISOString(),
-    filesGenerated: files.length,
-    config: {
-      outDir: cfg.outDir || "./api",
-      schema: cfg.schema || "public"
-    }
-  });
-  await appendToHistory(`Generate
-✅ Generated ${files.length} files
-- Schema hash: ${schemaHash.substring(0, 12)}...`);
-  console.log(`✅ Generated ${files.length} files`);
+  const writeResult = await writeFilesIfChanged(files);
+  if (writeResult.written === 0) {
+    console.log(`✅ All ${writeResult.unchanged} files up-to-date (no changes)`);
+  } else {
+    console.log(`✅ Updated ${writeResult.written} files, ${writeResult.unchanged} unchanged`);
+  }
   console.log(`  Server: ${serverDir}`);
   console.log(`  Client: ${sameDirectory ? clientDir + " (in sdk subdir due to same output dir)" : clientDir}`);
   if (generateTests) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresdk",
-  "version": "0.18.5",
+  "version": "0.18.7",
   "description": "Generate a typed server/client SDK from a Postgres schema (includes, Zod, Hono).",
   "type": "module",
   "bin": {
@@ -22,7 +22,8 @@
   },
   "scripts": {
     "build": "bun build src/cli.ts src/index.ts --outdir dist --target node --format esm --external=pg --external=zod --external=hono --external=prompts --external=node:* && tsc -p tsconfig.build.json --emitDeclarationOnly",
-    "test": "bun test:init && bun test:gen && bun test test/test-where-clause.test.ts && bun test test/test-where-or-and.test.ts && bun test test/test-nested-include-options.test.ts && bun test test/test-include-methods-with-options.test.ts && bun test:gen-with-tests && bun test:pull && bun test:enums && bun test:typecheck && bun test:drizzle-e2e && bun test test/test-numeric-mode-integration.test.ts",
+    "test": "bun test:write-files && bun test:init && bun test:gen && bun test test/test-where-clause.test.ts && bun test test/test-where-or-and.test.ts && bun test test/test-nested-include-options.test.ts && bun test test/test-include-methods-with-options.test.ts && bun test:gen-with-tests && bun test:pull && bun test:enums && bun test:typecheck && bun test:drizzle-e2e && bun test test/test-numeric-mode-integration.test.ts",
+    "test:write-files": "bun test/test-write-files-if-changed.ts",
     "test:init": "bun test/test-init.ts",
     "test:gen": "bun test/test-gen.ts",
     "test:gen-with-tests": "bun test/test-gen-with-tests.ts",

package/dist/cache.d.ts

@@ -1,35 +0,0 @@
-import type { Model } from "./introspect";
-import type { Config } from "./types";
-export interface CacheData {
-    schemaHash: string;
-    lastRun: string;
-    filesGenerated: number;
-    config: {
-        outDir: string | {
-            server: string;
-            client: string;
-        };
-        schema: string;
-    };
-}
-/**
- * Compute a deterministic hash of the schema and config
- * Includes postgresdk version to trigger regeneration on upgrades
- */
-export declare function computeSchemaHash(model: Model, config: Config): string;
-/**
- * Get the cache directory path
- */
-export declare function getCacheDir(baseDir?: string): string;
-/**
- * Read cache data if it exists
- */
-export declare function readCache(baseDir?: string): Promise<CacheData | null>;
-/**
- * Write cache data
- */
-export declare function writeCache(data: CacheData, baseDir?: string): Promise<void>;
-/**
- * Append an entry to the history log
- */
-export declare function appendToHistory(entry: string, baseDir?: string): Promise<void>;