@convex-localfirst/cli 0.1.0 → 0.1.1

package/dist/freshness.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Which source files were modified after the manifest. `manifestMtimeMs` is null when the
+ * manifest doesn't exist (→ everything counts as stale, i.e. "run codegen"). Pure so it's
+ * unit-testable without fs.
+ */
+export declare function staleManifestSources(manifestMtimeMs: number | null, sources: ReadonlyArray<{
+    readonly file: string;
+    readonly mtimeMs: number;
+}>): string[];
+/**
+ * Read the convex source dir + the generated manifest and warn (once) if the manifest looks
+ * stale — so editing a `lf.table` and forgetting `codegen` can't silently ship a mismatched
+ * client. Best-effort: silent when there's no convex dir. `warn` is injected for tests.
+ */
+export declare function checkManifestFreshness(root: string, convexDir: string, generatedManifestPath: string, warn: (message: string) => void): void;

package/dist/freshness.js

@@ -0,0 +1,36 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+/**
+ * Which source files were modified after the manifest. `manifestMtimeMs` is null when the
+ * manifest doesn't exist (→ everything counts as stale, i.e. "run codegen"). Pure so it's
+ * unit-testable without fs.
+ */
+export function staleManifestSources(manifestMtimeMs, sources) {
+    if (manifestMtimeMs == null) {
+        return sources.map((s) => s.file);
+    }
+    return sources.filter((s) => s.mtimeMs > manifestMtimeMs).map((s) => s.file);
+}
+/**
+ * Read the convex source dir + the generated manifest and warn (once) if the manifest looks
+ * stale — so editing a `lf.table` and forgetting `codegen` can't silently ship a mismatched
+ * client. Best-effort: silent when there's no convex dir. `warn` is injected for tests.
+ */
+export function checkManifestFreshness(root, convexDir, generatedManifestPath, warn) {
+    const convexAbs = resolve(root, convexDir);
+    if (!existsSync(convexAbs)) {
+        return;
+    }
+    const manifestAbs = resolve(root, generatedManifestPath.replace(/^\//, ""));
+    const manifestMtimeMs = existsSync(manifestAbs) ? statSync(manifestAbs).mtimeMs : null;
+    const sources = readdirSync(convexAbs)
+        .filter((f) => /\.(ts|js)$/.test(f) && !f.startsWith("_") && !f.endsWith(".d.ts"))
+        .map((f) => ({ file: join(convexDir, f), mtimeMs: statSync(join(convexAbs, f)).mtimeMs }));
+    const stale = staleManifestSources(manifestMtimeMs, sources);
+    if (stale.length === 0) {
+        return;
+    }
+    const shown = stale.slice(0, 3).join(", ") + (stale.length > 3 ? `, +${stale.length - 3} more` : "");
+    warn(`[convex-localfirst] generated manifest looks stale: ${stale.length} convex source(s) changed after ` +
+        `"${generatedManifestPath}" (${shown}). Run \`npx convex-localfirst codegen\` to regenerate it.`);
+}

package/dist/index.js

@@ -4,6 +4,7 @@ import { join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { runCheck } from "./check.js";
 import { emitManifestSource, introspectExports } from "./codegen.js";
+import { checkManifestFreshness } from "./freshness.js";
 const command = process.argv[2] ?? "help";
 if (command === "init") {
     init();
@@ -209,6 +210,9 @@ async function codegen() {
 const CHECK_SCOPE_NOTE = "note: catches ctx.db.insert + id-based patch/delete/replace whose id is traceable to a local-first table within one function; ids passed across functions or via ctx.db.get() are not traced — review those manually.";
 function check() {
     const dir = existsSync("convex") ? "convex" : ".";
+    // Warn (don't fail) if the generated manifest is older than a DSL source — the safety net
+    // that used to live in the Vite plugin, now folded in so CI `check` catches a stale manifest.
+    checkManifestFreshness(process.cwd(), dir, "src/convex-localfirst/generated.ts", console.warn);
     const violations = runCheck(dir);
     if (violations.length === 0) {
         console.log("convex-localfirst check: no direct writes to local-first tables found");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convex-localfirst/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI for convex-localfirst: codegen (client manifest from lf.table), check (catch direct LF-table writes), dev.",
   "license": "MIT",
   "keywords": [
@@ -9,6 +9,19 @@
     "cli",
     "codegen"
   ],
+  "author": "Fanzzzd",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Fanzzzd/convex-localfirst.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/Fanzzzd/convex-localfirst#readme",
+  "bugs": {
+    "url": "https://github.com/Fanzzzd/convex-localfirst/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "type": "module",
   "bin": {
     "convex-localfirst": "./dist/index.js"
@@ -27,8 +40,8 @@
     "convex": ">=1.0.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0",
-    "@convex-localfirst/server": "^0.1.0",
-    "@convex-localfirst/core": "^0.1.0"
+    "@convex-localfirst/core": "^0.1.1",
+    "@convex-localfirst/server": "^0.1.1"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json --noEmit false --emitDeclarationOnly false",