postgresdk 0.16.14 → 0.17.0

package/dist/cache.d.ts

@@ -0,0 +1,34 @@
+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
+ */
+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>;

package/dist/cli.js

@@ -471,7 +471,7 @@ var require_config = __commonJS(() => {
 });
 
 // src/utils.ts
-import { mkdir, writeFile } from "fs/promises";
+import { mkdir, writeFile, readFile } from "fs/promises";
 import { dirname } from "path";
 async function writeFiles(files) {
   for (const f of files) {
@@ -701,7 +701,6 @@ function generateUnifiedContract(model, config, graph) {
   }
   const contract = {
     version: "2.0.0",
-    generatedAt: new Date().toISOString(),
     description: "Unified API and SDK contract - your one-stop reference for all operations",
     sdk: {
       initialization: generateSDKInitExamples(),
@@ -1237,7 +1236,6 @@ function generateUnifiedContractMarkdown(contract) {
   lines.push(contract.description);
   lines.push("");
   lines.push(`**Version:** ${contract.version}`);
-  lines.push(`**Generated:** ${new Date(contract.generatedAt).toLocaleString()}`);
   lines.push("");
   lines.push("## SDK Setup");
   lines.push("");
@@ -1688,6 +1686,102 @@ 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 } from "fs";
+import { join } from "path";
+function computeSchemaHash(model, config) {
+  const payload = {
+    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 init_cache = () => {};
+
 // src/cli-config-utils.ts
 function extractConfigFields(configContent) {
   const fields = [];
@@ -2107,7 +2201,7 @@ var exports_cli_init = {};
 __export(exports_cli_init, {
   initCommand: () => initCommand
 });
-import { existsSync as existsSync2, writeFileSync, readFileSync, copyFileSync } from "fs";
+import { existsSync as existsSync3, writeFileSync, readFileSync, copyFileSync } from "fs";
 import { resolve } from "path";
 import prompts from "prompts";
 async function initCommand(args) {
@@ -2117,7 +2211,7 @@ async function initCommand(args) {
   const isApiSide = args.includes("--api");
   const isSdkSide = args.includes("--sdk") || args[0] === "pull";
   const configPath = resolve(process.cwd(), "postgresdk.config.ts");
-  if (existsSync2(configPath)) {
+  if (existsSync3(configPath)) {
     if (forceError) {
       console.error("❌ Error: postgresdk.config.ts already exists");
       console.log("   To reinitialize, please remove or rename the existing file first.");
@@ -2272,7 +2366,7 @@ async function initCommand(args) {
   }
   const template = projectType === "api" ? CONFIG_TEMPLATE_API : CONFIG_TEMPLATE_SDK;
   const envPath = resolve(process.cwd(), ".env");
-  const hasEnv = existsSync2(envPath);
+  const hasEnv = existsSync3(envPath);
   try {
     writeFileSync(configPath, template, "utf-8");
     console.log("✅ Created postgresdk.config.ts");
@@ -2516,9 +2610,9 @@ var exports_cli_pull = {};
 __export(exports_cli_pull, {
   pullCommand: () => pullCommand
 });
-import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
-import { join as join2, dirname as dirname2, resolve as resolve2 } from "path";
-import { existsSync as existsSync3 } from "fs";
+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 { existsSync as existsSync4 } from "fs";
 import { pathToFileURL as pathToFileURL2 } from "url";
 async function pullCommand(args) {
   let configPath = "postgresdk.config.ts";
@@ -2528,7 +2622,7 @@ async function pullCommand(args) {
   }
   let fileConfig = {};
   const fullConfigPath = resolve2(process.cwd(), configPath);
-  if (existsSync3(fullConfigPath)) {
+  if (existsSync4(fullConfigPath)) {
     console.log(`\uD83D\uDCCB Loading ${configPath}`);
     try {
       const configUrl = pathToFileURL2(fullConfigPath).href;
@@ -2586,7 +2680,6 @@ Options:`);
     }
     const manifest = await manifestRes.json();
     console.log(`\uD83D\uDCE6 SDK version: ${manifest.version}`);
-    console.log(`\uD83D\uDCC5 Generated: ${manifest.generated}`);
     console.log(`\uD83D\uDCC4 Files: ${manifest.files.length}`);
     const sdkRes = await fetch(`${config.from}/_psdk/sdk/download`, { headers });
     if (!sdkRes.ok) {
@@ -2600,31 +2693,78 @@ Options:`);
       throw new Error(`Failed to download SDK: ${errorMsg}`);
     }
     const sdk = await sdkRes.json();
+    let filesWritten = 0;
+    let filesUnchanged = 0;
+    const changedFiles = [];
     for (const [path, content] of Object.entries(sdk.files)) {
-      const fullPath = join2(config.output, path);
-      await mkdir2(dirname2(fullPath), { recursive: true });
-      await writeFile2(fullPath, content, "utf-8");
-      console.log(`  ✓ ${path}`);
+      const fullPath = join3(config.output, path);
+      await mkdir3(dirname3(fullPath), { recursive: true });
+      let shouldWrite = true;
+      if (existsSync4(fullPath)) {
+        const existing = await readFile3(fullPath, "utf-8");
+        if (existing === content) {
+          shouldWrite = false;
+          filesUnchanged++;
+        }
+      }
+      if (shouldWrite) {
+        await writeFile3(fullPath, content, "utf-8");
+        filesWritten++;
+        changedFiles.push(path);
+        console.log(`  ✓ ${path}`);
+      }
     }
-    await writeFile2(join2(config.output, ".postgresdk.json"), JSON.stringify({
+    const metadataPath = join3(config.output, ".postgresdk.json");
+    const metadata = {
       version: sdk.version,
-      generated: sdk.generated,
-      pulledFrom: config.from,
-      pulledAt: new Date().toISOString()
-    }, null, 2));
-    console.log(`✅ SDK pulled successfully to ${config.output}`);
+      pulledFrom: config.from
+    };
+    let metadataChanged = true;
+    if (existsSync4(metadataPath)) {
+      const existing = await readFile3(metadataPath, "utf-8");
+      if (existing === JSON.stringify(metadata, null, 2)) {
+        metadataChanged = false;
+      }
+    }
+    if (metadataChanged) {
+      await writeFile3(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 = () => {};
+var init_cli_pull = __esm(() => {
+  init_cache();
+});
 
 // src/index.ts
 var import_config = __toESM(require_config(), 1);
-import { join, relative } from "node:path";
+import { join as join2, relative } from "node:path";
 import { pathToFileURL } from "node:url";
-import { existsSync } from "node:fs";
+import { existsSync as existsSync2 } from "node:fs";
 
 // src/introspect.ts
 import { Client } from "pg";
@@ -4987,7 +5127,6 @@ ${pullToken ? `
   router.get("/_psdk/sdk/manifest", (c) => {
     return c.json({
       version: SDK_MANIFEST.version,
-      generated: SDK_MANIFEST.generated,
       files: Object.keys(SDK_MANIFEST.files)
     });
   });
@@ -5089,7 +5228,6 @@ function emitSdkBundle(clientFiles, clientDir) {
     }
   }
   const version = `1.0.0`;
-  const generated = new Date().toISOString();
   return `/**
  * AUTO-GENERATED FILE - DO NOT EDIT
  *
@@ -5101,7 +5239,6 @@ function emitSdkBundle(clientFiles, clientDir) {
 
 export const SDK_MANIFEST = {
   version: "${version}",
-  generated: "${generated}",
   files: ${JSON.stringify(files, null, 2)}
 };
 `;
@@ -6513,8 +6650,9 @@ function generateTestCases(table, sampleData, updateData, hasForeignKeys = false
 // src/index.ts
 init_emit_sdk_contract();
 init_utils();
+init_cache();
 async function generate(configPath) {
-  if (!existsSync(configPath)) {
+  if (!existsSync2(configPath)) {
     throw new Error(`Config file not found: ${configPath}
 
 ` + `Run 'postgresdk init' to create a config file, or specify a custom path with:
@@ -6527,43 +6665,58 @@ 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 = join(originalClientDir, "sdk");
+    clientDir = join2(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 = join(originalTestDir, "tests");
+    testDir = join2(originalTestDir, "tests");
   }
   const testFramework = cfg.tests?.framework || "vitest";
   console.log("\uD83D\uDCC1 Creating directories...");
   const dirs = [
     serverDir,
-    join(serverDir, "types"),
-    join(serverDir, "zod"),
-    join(serverDir, "routes"),
+    join2(serverDir, "types"),
+    join2(serverDir, "zod"),
+    join2(serverDir, "routes"),
     clientDir,
-    join(clientDir, "types"),
-    join(clientDir, "zod"),
-    join(clientDir, "params")
+    join2(clientDir, "types"),
+    join2(clientDir, "zod"),
+    join2(clientDir, "params")
   ];
   if (generateTests) {
     dirs.push(testDir);
@@ -6571,26 +6724,26 @@ async function generate(configPath) {
   await ensureDirs(dirs);
   const files = [];
   const includeSpec = emitIncludeSpec(graph);
-  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-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-builder.ts"),
+    path: join2(serverDir, "include-builder.ts"),
     content: emitIncludeBuilder(graph, cfg.includeMethodsDepth || 2)
   });
   files.push({
-    path: join(serverDir, "include-loader.ts"),
+    path: join2(serverDir, "include-loader.ts"),
     content: emitIncludeLoader(graph, model, cfg.includeMethodsDepth || 2, cfg.useJsExtensions)
   });
-  files.push({ path: join(serverDir, "logger.ts"), content: emitLogger() });
+  files.push({ path: join2(serverDir, "logger.ts"), content: emitLogger() });
   if (getAuthStrategy(normalizedAuth) !== "none") {
-    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
+    files.push({ path: join2(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
   }
   files.push({
-    path: join(serverDir, "core", "operations.ts"),
+    path: join2(serverDir, "core", "operations.ts"),
     content: emitCoreOperations()
   });
   if (process.env.SDK_DEBUG) {
@@ -6599,13 +6752,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: join(serverDir, "types", `${table.name}.ts`), content: typesSrc });
-    files.push({ path: join(clientDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join2(serverDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join2(clientDir, "types", `${table.name}.ts`), content: typesSrc });
     const zodSrc = emitZod(table, { numericMode }, model.enums);
-    files.push({ path: join(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
-    files.push({ path: join(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join2(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join2(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
     const paramsZodSrc = emitParamsZod(table, graph);
-    files.push({ path: join(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
+    files.push({ path: join2(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
     let routeContent;
     if (serverFramework === "hono") {
       routeContent = emitHonoRoutes(table, graph, {
@@ -6619,11 +6772,11 @@ async function generate(configPath) {
       throw new Error(`Framework "${serverFramework}" is not yet supported. Currently only "hono" is available.`);
     }
     files.push({
-      path: join(serverDir, "routes", `${table.name}.ts`),
+      path: join2(serverDir, "routes", `${table.name}.ts`),
       content: routeContent
     });
     files.push({
-      path: join(clientDir, `${table.name}.ts`),
+      path: join2(clientDir, `${table.name}.ts`),
       content: emitClient(table, graph, {
         useJsExtensions: cfg.useJsExtensionsClient,
         includeMethodsDepth: cfg.includeMethodsDepth ?? 2,
@@ -6632,12 +6785,12 @@ async function generate(configPath) {
     });
   }
   files.push({
-    path: join(clientDir, "index.ts"),
+    path: join2(clientDir, "index.ts"),
     content: emitClientIndex(Object.values(model.tables), cfg.useJsExtensionsClient)
   });
   if (serverFramework === "hono") {
     files.push({
-      path: join(serverDir, "router.ts"),
+      path: join2(serverDir, "router.ts"),
       content: emitHonoRouter(Object.values(model.tables), getAuthStrategy(normalizedAuth) !== "none", cfg.useJsExtensions, cfg.pullToken)
     });
   }
@@ -6647,59 +6800,72 @@ async function generate(configPath) {
   }
   const contract = generateUnifiedContract2(model, cfg, graph);
   files.push({
-    path: join(serverDir, "CONTRACT.md"),
+    path: join2(serverDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   files.push({
-    path: join(clientDir, "CONTRACT.md"),
+    path: join2(clientDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   const contractCode = emitUnifiedContract(model, cfg, graph);
   files.push({
-    path: join(serverDir, "contract.ts"),
+    path: join2(serverDir, "contract.ts"),
     content: contractCode
   });
   const clientFiles = files.filter((f) => {
     return f.path.includes(clientDir);
   });
   files.push({
-    path: join(serverDir, "sdk-bundle.ts"),
+    path: join2(serverDir, "sdk-bundle.ts"),
     content: emitSdkBundle(clientFiles, clientDir)
   });
   if (generateTests) {
     console.log("\uD83E\uDDEA Generating tests...");
     const relativeClientPath = relative(testDir, clientDir);
     files.push({
-      path: join(testDir, "setup.ts"),
+      path: join2(testDir, "setup.ts"),
       content: emitTestSetup(relativeClientPath, testFramework)
     });
     files.push({
-      path: join(testDir, "docker-compose.yml"),
+      path: join2(testDir, "docker-compose.yml"),
       content: emitDockerCompose()
     });
     files.push({
-      path: join(testDir, "run-tests.sh"),
+      path: join2(testDir, "run-tests.sh"),
       content: emitTestScript(testFramework, testDir)
     });
     files.push({
-      path: join(testDir, ".gitignore"),
+      path: join2(testDir, ".gitignore"),
       content: emitTestGitignore()
     });
     if (testFramework === "vitest") {
       files.push({
-        path: join(testDir, "vitest.config.ts"),
+        path: join2(testDir, "vitest.config.ts"),
         content: emitVitestConfig()
       });
     }
     for (const table of Object.values(model.tables)) {
       files.push({
-        path: join(testDir, `${table.name}.test.ts`),
+        path: join2(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`);
   console.log(`  Server: ${serverDir}`);
   console.log(`  Client: ${sameDirectory ? clientDir + " (in sdk subdir due to same output dir)" : clientDir}`);
@@ -6738,10 +6904,10 @@ var import_config2 = __toESM(require_config(), 1);
 import { resolve as resolve3 } from "node:path";
 import { readFileSync as readFileSync2 } from "node:fs";
 import { fileURLToPath } from "node:url";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { dirname as dirname4, join as join4 } from "node:path";
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = dirname3(__filename2);
-var packageJson = JSON.parse(readFileSync2(join3(__dirname2, "../package.json"), "utf-8"));
+var __dirname2 = dirname4(__filename2);
+var packageJson = JSON.parse(readFileSync2(join4(__dirname2, "../package.json"), "utf-8"));
 var VERSION = packageJson.version;
 var args = process.argv.slice(2);
 var command = args[0];

package/dist/emit-sdk-contract.d.ts

@@ -3,7 +3,6 @@ import type { Config, AuthConfig } from "./types";
 import type { Graph } from "./rel-classify";
 export interface UnifiedContract {
     version: string;
-    generatedAt: string;
     description: string;
     sdk: {
         initialization: SDKInitExample[];

package/dist/index.js

@@ -470,7 +470,7 @@ var require_config = __commonJS(() => {
 });
 
 // src/utils.ts
-import { mkdir, writeFile } from "fs/promises";
+import { mkdir, writeFile, readFile } from "fs/promises";
 import { dirname } from "path";
 async function writeFiles(files) {
   for (const f of files) {
@@ -700,7 +700,6 @@ function generateUnifiedContract(model, config, graph) {
   }
   const contract = {
     version: "2.0.0",
-    generatedAt: new Date().toISOString(),
     description: "Unified API and SDK contract - your one-stop reference for all operations",
     sdk: {
       initialization: generateSDKInitExamples(),
@@ -1236,7 +1235,6 @@ function generateUnifiedContractMarkdown(contract) {
   lines.push(contract.description);
   lines.push("");
   lines.push(`**Version:** ${contract.version}`);
-  lines.push(`**Generated:** ${new Date(contract.generatedAt).toLocaleString()}`);
   lines.push("");
   lines.push("## SDK Setup");
   lines.push("");
@@ -1687,11 +1685,107 @@ 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 } from "fs";
+import { join } from "path";
+function computeSchemaHash(model, config) {
+  const payload = {
+    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 init_cache = () => {};
+
 // src/index.ts
 var import_config = __toESM(require_config(), 1);
-import { join, relative } from "node:path";
+import { join as join2, relative } from "node:path";
 import { pathToFileURL } from "node:url";
-import { existsSync } from "node:fs";
+import { existsSync as existsSync2 } from "node:fs";
 
 // src/introspect.ts
 import { Client } from "pg";
@@ -4054,7 +4148,6 @@ ${pullToken ? `
   router.get("/_psdk/sdk/manifest", (c) => {
     return c.json({
       version: SDK_MANIFEST.version,
-      generated: SDK_MANIFEST.generated,
       files: Object.keys(SDK_MANIFEST.files)
     });
   });
@@ -4156,7 +4249,6 @@ function emitSdkBundle(clientFiles, clientDir) {
     }
   }
   const version = `1.0.0`;
-  const generated = new Date().toISOString();
   return `/**
  * AUTO-GENERATED FILE - DO NOT EDIT
  *
@@ -4168,7 +4260,6 @@ function emitSdkBundle(clientFiles, clientDir) {
 
 export const SDK_MANIFEST = {
   version: "${version}",
-  generated: "${generated}",
   files: ${JSON.stringify(files, null, 2)}
 };
 `;
@@ -5580,8 +5671,9 @@ function generateTestCases(table, sampleData, updateData, hasForeignKeys = false
 // src/index.ts
 init_emit_sdk_contract();
 init_utils();
+init_cache();
 async function generate(configPath) {
-  if (!existsSync(configPath)) {
+  if (!existsSync2(configPath)) {
     throw new Error(`Config file not found: ${configPath}
 
 ` + `Run 'postgresdk init' to create a config file, or specify a custom path with:
@@ -5594,43 +5686,58 @@ 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 = join(originalClientDir, "sdk");
+    clientDir = join2(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 = join(originalTestDir, "tests");
+    testDir = join2(originalTestDir, "tests");
   }
   const testFramework = cfg.tests?.framework || "vitest";
   console.log("\uD83D\uDCC1 Creating directories...");
   const dirs = [
     serverDir,
-    join(serverDir, "types"),
-    join(serverDir, "zod"),
-    join(serverDir, "routes"),
+    join2(serverDir, "types"),
+    join2(serverDir, "zod"),
+    join2(serverDir, "routes"),
     clientDir,
-    join(clientDir, "types"),
-    join(clientDir, "zod"),
-    join(clientDir, "params")
+    join2(clientDir, "types"),
+    join2(clientDir, "zod"),
+    join2(clientDir, "params")
   ];
   if (generateTests) {
     dirs.push(testDir);
@@ -5638,26 +5745,26 @@ async function generate(configPath) {
   await ensureDirs(dirs);
   const files = [];
   const includeSpec = emitIncludeSpec(graph);
-  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-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-builder.ts"),
+    path: join2(serverDir, "include-builder.ts"),
     content: emitIncludeBuilder(graph, cfg.includeMethodsDepth || 2)
   });
   files.push({
-    path: join(serverDir, "include-loader.ts"),
+    path: join2(serverDir, "include-loader.ts"),
     content: emitIncludeLoader(graph, model, cfg.includeMethodsDepth || 2, cfg.useJsExtensions)
   });
-  files.push({ path: join(serverDir, "logger.ts"), content: emitLogger() });
+  files.push({ path: join2(serverDir, "logger.ts"), content: emitLogger() });
   if (getAuthStrategy(normalizedAuth) !== "none") {
-    files.push({ path: join(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
+    files.push({ path: join2(serverDir, "auth.ts"), content: emitAuth(normalizedAuth) });
   }
   files.push({
-    path: join(serverDir, "core", "operations.ts"),
+    path: join2(serverDir, "core", "operations.ts"),
     content: emitCoreOperations()
   });
   if (process.env.SDK_DEBUG) {
@@ -5666,13 +5773,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: join(serverDir, "types", `${table.name}.ts`), content: typesSrc });
-    files.push({ path: join(clientDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join2(serverDir, "types", `${table.name}.ts`), content: typesSrc });
+    files.push({ path: join2(clientDir, "types", `${table.name}.ts`), content: typesSrc });
     const zodSrc = emitZod(table, { numericMode }, model.enums);
-    files.push({ path: join(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
-    files.push({ path: join(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join2(serverDir, "zod", `${table.name}.ts`), content: zodSrc });
+    files.push({ path: join2(clientDir, "zod", `${table.name}.ts`), content: zodSrc });
     const paramsZodSrc = emitParamsZod(table, graph);
-    files.push({ path: join(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
+    files.push({ path: join2(clientDir, "params", `${table.name}.ts`), content: paramsZodSrc });
     let routeContent;
     if (serverFramework === "hono") {
       routeContent = emitHonoRoutes(table, graph, {
@@ -5686,11 +5793,11 @@ async function generate(configPath) {
       throw new Error(`Framework "${serverFramework}" is not yet supported. Currently only "hono" is available.`);
     }
     files.push({
-      path: join(serverDir, "routes", `${table.name}.ts`),
+      path: join2(serverDir, "routes", `${table.name}.ts`),
       content: routeContent
     });
     files.push({
-      path: join(clientDir, `${table.name}.ts`),
+      path: join2(clientDir, `${table.name}.ts`),
       content: emitClient(table, graph, {
         useJsExtensions: cfg.useJsExtensionsClient,
         includeMethodsDepth: cfg.includeMethodsDepth ?? 2,
@@ -5699,12 +5806,12 @@ async function generate(configPath) {
     });
   }
   files.push({
-    path: join(clientDir, "index.ts"),
+    path: join2(clientDir, "index.ts"),
     content: emitClientIndex(Object.values(model.tables), cfg.useJsExtensionsClient)
   });
   if (serverFramework === "hono") {
     files.push({
-      path: join(serverDir, "router.ts"),
+      path: join2(serverDir, "router.ts"),
       content: emitHonoRouter(Object.values(model.tables), getAuthStrategy(normalizedAuth) !== "none", cfg.useJsExtensions, cfg.pullToken)
     });
   }
@@ -5714,59 +5821,72 @@ async function generate(configPath) {
   }
   const contract = generateUnifiedContract2(model, cfg, graph);
   files.push({
-    path: join(serverDir, "CONTRACT.md"),
+    path: join2(serverDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   files.push({
-    path: join(clientDir, "CONTRACT.md"),
+    path: join2(clientDir, "CONTRACT.md"),
     content: generateUnifiedContractMarkdown2(contract)
   });
   const contractCode = emitUnifiedContract(model, cfg, graph);
   files.push({
-    path: join(serverDir, "contract.ts"),
+    path: join2(serverDir, "contract.ts"),
     content: contractCode
   });
   const clientFiles = files.filter((f) => {
     return f.path.includes(clientDir);
   });
   files.push({
-    path: join(serverDir, "sdk-bundle.ts"),
+    path: join2(serverDir, "sdk-bundle.ts"),
     content: emitSdkBundle(clientFiles, clientDir)
   });
   if (generateTests) {
     console.log("\uD83E\uDDEA Generating tests...");
     const relativeClientPath = relative(testDir, clientDir);
     files.push({
-      path: join(testDir, "setup.ts"),
+      path: join2(testDir, "setup.ts"),
       content: emitTestSetup(relativeClientPath, testFramework)
     });
     files.push({
-      path: join(testDir, "docker-compose.yml"),
+      path: join2(testDir, "docker-compose.yml"),
       content: emitDockerCompose()
     });
     files.push({
-      path: join(testDir, "run-tests.sh"),
+      path: join2(testDir, "run-tests.sh"),
       content: emitTestScript(testFramework, testDir)
     });
     files.push({
-      path: join(testDir, ".gitignore"),
+      path: join2(testDir, ".gitignore"),
       content: emitTestGitignore()
     });
     if (testFramework === "vitest") {
       files.push({
-        path: join(testDir, "vitest.config.ts"),
+        path: join2(testDir, "vitest.config.ts"),
         content: emitVitestConfig()
       });
     }
     for (const table of Object.values(model.tables)) {
       files.push({
-        path: join(testDir, `${table.name}.test.ts`),
+        path: join2(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`);
   console.log(`  Server: ${serverDir}`);
   console.log(`  Client: ${sameDirectory ? clientDir + " (in sdk subdir due to same output dir)" : clientDir}`);

package/dist/utils.d.ts

@@ -3,4 +3,20 @@ export declare function writeFiles(files: Array<{
     path: string;
     content: string;
 }>): Promise<void>;
+/**
+ * Write files only if content has changed (idempotent)
+ * Returns the count of files actually written
+ */
+export declare function writeFilesIfChanged(files: Array<{
+    path: string;
+    content: string;
+}>): Promise<{
+    written: number;
+    unchanged: number;
+    filesWritten: string[];
+}>;
+/**
+ * Compute hash of a string
+ */
+export declare function hashContent(content: string): string;
 export declare function ensureDirs(dirs: string[]): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresdk",
-  "version": "0.16.14",
+  "version": "0.17.0",
   "description": "Generate a typed server/client SDK from a Postgres schema (includes, Zod, Hono).",
   "type": "module",
   "bin": {