@xirconsss/zero-mock 0.2.3 → 1.1.0

package/README.md

@@ -122,11 +122,11 @@ The root must be a JSON **object**. Each property must be an **array** (your “
 
 ## Publishing to npm (maintainers)
 
-**Release flow (recommended):** bump **`version`** in `package.json` and `package-lock.json`, commit, and **push to `main`**. [`.github/workflows/publish-npm.yml`](.github/workflows/publish-npm.yml) runs automatically, builds, and runs **`npm publish`**. If that version is already on the registry, the job skips publish and succeeds with a notice (no E403). You can still trigger a run manually from the **Actions** tab (**workflow_dispatch**). Avoid **`npm publish` on your machine** for the same version CI will publish, or you will block CI with “already published”.
+**Release flow (recommended):** Automated via `semantic-release`. Commits following the conventional commit format (e.g., `feat:`, `fix:`) pushed to `main` will automatically trigger a version bump, changelog generation, and NPM publish via the [`.github/workflows/publish-npm.yml`](.github/workflows/publish-npm.yml) workflow. Avoid running `npm publish` on your machine.
 
 1. Use an [npmjs.com](https://www.npmjs.com/) account with **2FA** enabled and permission to publish the **`@xirconsss`** scope (user or org on npm).
 2. **GitHub:** repo → **Settings** → **Environments** → **`NPM_TOKEN`** → add secret **`NPM_TOKEN`** (see token steps below). The workflow uses that environment on each run.
-3. Bump **`version`**, push to **`main`**, wait for **Publish to npm** to finish. Check with `npm view @xirconsss/zero-mock version`.
+3. Push conventional commits to **`main`**, wait for **Publish to npm** to finish. Check with `npm view @xirconsss/zero-mock version`.
 
 **Token on npm (required for CI):**
 
@@ -143,4 +143,4 @@ MIT - see [LICENSE](LICENSE).
 ## Links
 
 - **Repository:** [github.com/xircons/zero-mock](https://github.com/xircons/zero-mock)
-- **Issues:** [github.com/xircons/zero-mock/issues](https://github.com/xircons/zero-mock/issues)
+- **Issues:** [github.com/xircons/zero-mock/issues](https://github.com/xircons/zero-mock/issues)

package/dist/__tests__/basic.test.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+(0, vitest_1.describe)('Environment Check', () => {
+    (0, vitest_1.it)('should pass a basic truthy test', () => {
+        (0, vitest_1.expect)(true).toBe(true);
+    });
+});

package/dist/index.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = require("fs");
+const chokidar_1 = __importDefault(require("chokidar"));
 const commander_1 = require("commander");
 const jsonStore_1 = require("./store/jsonStore");
 const bootstrap_1 = require("./server/bootstrap");
@@ -13,33 +16,29 @@ function parseDelayMs(raw) {
     return Number.parseInt(trimmed, 10);
 }
 function startFileWatcher(filePath) {
-    let reloadInFlight = false;
+    let reloadTimeout = null;
     const reload = async () => {
-        if (reloadInFlight) {
-            return;
-        }
-        reloadInFlight = true;
         try {
             await jsonStore_1.JsonStore.load(filePath);
+            console.log(`[watch] Reloaded "${filePath}".`);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
             console.error(`[watch] Could not reload "${filePath}": ${message}`);
         }
-        finally {
-            reloadInFlight = false;
-        }
     };
-    try {
-        (0, fs_1.watch)(filePath, { persistent: true }, () => {
-            void reload();
-        });
-        console.log(`[watch] Watching "${filePath}" for changes.`);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.error(`[watch] Failed to watch "${filePath}": ${message}`);
-    }
+    chokidar_1.default
+        .watch(filePath, { persistent: true, ignoreInitial: true })
+        .on("change", () => {
+        if (reloadTimeout)
+            clearTimeout(reloadTimeout);
+        reloadTimeout = setTimeout(() => void reload(), 100);
+    })
+        .on("error", (err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[watch] Watcher error: ${msg}`);
+    });
+    console.log(`[watch] Watching "${filePath}" for changes.`);
 }
 const program = new commander_1.Command();
 program
@@ -49,6 +48,9 @@ program
     .option("-p, --port <number>", "HTTP port", "3000")
     .option("-d, --delay <ms>", "delay each request by this many ms (0 = off)", "0")
     .option("-w, --watch", "reload JSON from disk when the file changes", false)
+    .option("--cors-origin <origins>", "comma-separated list of allowed origins (e.g., http://localhost:3000)", "*")
+    .option("--cors-methods <methods>", "comma-separated list of allowed HTTP methods", "GET,HEAD,PUT,PATCH,POST,DELETE")
+    .option("--cors-credentials", "enable CORS credentials (cookies, authorization headers)", false)
     .action(async (opts) => {
     const port = Number.parseInt(opts.port, 10);
     if (Number.isNaN(port) || port < 1 || port > 65535) {
@@ -73,7 +75,12 @@ program
         return;
     }
     try {
-        await (0, bootstrap_1.bootstrap)(port, { delayMs });
+        await (0, bootstrap_1.bootstrap)(port, {
+            delayMs,
+            corsOrigin: opts.corsOrigin,
+            corsMethods: opts.corsMethods,
+            corsCredentials: opts.corsCredentials,
+        });
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);

package/dist/server/app.js

@@ -12,7 +12,7 @@ const errorHandler = (err, _req, res, _next) => {
         return;
     }
     const message = err instanceof Error ? err.message : String(err);
-    res.status(500).json({ error: message });
+    res.status(500).json({ error: "INTERNAL_SERVER_ERROR", message, statusCode: 500 });
 };
 function requestLoggingMiddleware(req, res, next) {
     res.on("finish", () => {
@@ -31,7 +31,11 @@ function delayMiddleware(delayMs) {
 }
 function createApp(options) {
     const app = (0, express_1.default)();
-    app.use((0, cors_1.default)());
+    app.use((0, cors_1.default)({
+        origin: options.corsOrigin && options.corsOrigin !== "*" ? options.corsOrigin.split(",") : "*",
+        methods: options.corsMethods || "GET,HEAD,PUT,PATCH,POST,DELETE",
+        credentials: options.corsCredentials || false,
+    }));
     app.use(express_1.default.json());
     app.use(requestLoggingMiddleware);
     app.use(delayMiddleware(options.delayMs));

package/dist/server/routes/dynamicRouter.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildDynamicRouter = buildDynamicRouter;
 const crypto_1 = require("crypto");
 const express_1 = __importDefault(require("express"));
+const zod_1 = require("zod");
 const jsonStore_1 = require("../../store/jsonStore");
 function isPlainObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -44,27 +45,73 @@ function parsePagination(query) {
     return { page, limit };
 }
 function filterCollection(items, query) {
-    const filterEntries = Object.entries(query).filter(([k]) => k !== "_page" && k !== "_limit");
+    let result = items;
+    // Sorting
+    const sort = firstQueryValue(query["_sort"]);
+    const order = firstQueryValue(query["_order"])?.toLowerCase() === "desc" ? -1 : 1;
+    if (sort) {
+        result = [...result].sort((a, b) => {
+            if (!isPlainObject(a) || !isPlainObject(b))
+                return 0;
+            const valA = a[sort];
+            const valB = b[sort];
+            if (valA === valB)
+                return 0;
+            if (valA === undefined)
+                return order;
+            if (valB === undefined)
+                return -order;
+            if (typeof valA === "number" && typeof valB === "number")
+                return (valA - valB) * order;
+            return String(valA).localeCompare(String(valB)) * order;
+        });
+    }
+    const filterEntries = Object.entries(query).filter(([k]) => !["_page", "_limit", "_sort", "_order"].includes(k));
     if (filterEntries.length === 0) {
-        return items;
+        return result;
     }
-    return items.filter((item) => {
+    return result.filter((item) => {
         if (!isPlainObject(item)) {
             return false;
         }
         const rec = item;
         for (const [key, qVal] of filterEntries) {
             const want = firstQueryValue(qVal);
-            if (want === undefined) {
+            if (want === undefined)
                 continue;
+            let field = key;
+            let op = "eq";
+            if (key.endsWith("_gte")) {
+                field = key.slice(0, -4);
+                op = "gte";
             }
-            if (!Object.prototype.hasOwnProperty.call(rec, key)) {
-                return false;
+            else if (key.endsWith("_lte")) {
+                field = key.slice(0, -4);
+                op = "lte";
             }
-            if (rec[key] == want) {
-                continue;
+            else if (key.endsWith("_like")) {
+                field = key.slice(0, -5);
+                op = "like";
+            }
+            const actual = rec[field];
+            if (op === "eq") {
+                if (actual != want)
+                    return false;
+            }
+            else if (op === "gte") {
+                if (Number(actual) < Number(want))
+                    return false;
+            }
+            else if (op === "lte") {
+                if (Number(actual) > Number(want))
+                    return false;
+            }
+            else if (op === "like") {
+                if (actual === undefined || actual === null)
+                    return false;
+                if (!String(actual).toLowerCase().includes(String(want).toLowerCase()))
+                    return false;
             }
-            return false;
         }
         return true;
     });
@@ -98,6 +145,43 @@ function itemNotFound(res, resource, id) {
 function badBody(res) {
     res.status(400).json({ error: "Request body must be a JSON object." });
 }
+/**
+ * Infer a zod schema from the first item in a collection.
+ * Returns null if the collection is empty (skip validation).
+ * The schema is "partial" so that POST/PATCH with missing optional fields still pass —
+ * only fields that ARE present are type-checked.
+ */
+function inferSchema(collection) {
+    const first = collection.find(isPlainObject);
+    if (!first)
+        return null;
+    const shape = {};
+    for (const [key, value] of Object.entries(first)) {
+        if (key === "id")
+            continue;
+        if (typeof value === "string")
+            shape[key] = zod_1.z.string();
+        else if (typeof value === "number")
+            shape[key] = zod_1.z.number();
+        else if (typeof value === "boolean")
+            shape[key] = zod_1.z.boolean();
+        else
+            shape[key] = zod_1.z.unknown();
+    }
+    return zod_1.z.object(shape).partial();
+}
+function validateBody(res, collection, body) {
+    const schema = inferSchema(collection);
+    if (!schema)
+        return true; // empty collection → skip
+    const result = schema.safeParse(body);
+    if (!result.success) {
+        const messages = result.error.issues.map((e) => `${e.path.join(".")}: ${e.message}`);
+        res.status(400).json({ error: "Validation failed.", details: messages });
+        return false;
+    }
+    return true;
+}
 function numericIdValue(id) {
     if (typeof id === "number" && Number.isFinite(id) && Number.isInteger(id)) {
         return id;
@@ -164,6 +248,8 @@ function buildDynamicRouter() {
                 return;
             }
             const collection = jsonStore_1.JsonStore.getData()[resource];
+            if (!validateBody(res, collection, req.body))
+                return;
             const newId = nextIdForCollection(collection);
             const rawBody = req.body;
             const rest = { ...rawBody };
@@ -180,6 +266,8 @@ function buildDynamicRouter() {
             }
             const { id: idParam } = req.params;
             const collection = jsonStore_1.JsonStore.getData()[resource];
+            if (!validateBody(res, collection, req.body))
+                return;
             const index = findIndexById(collection, idParam);
             if (index === -1) {
                 itemNotFound(res, resource, idParam);
@@ -202,6 +290,8 @@ function buildDynamicRouter() {
             }
             const { id: idParam } = req.params;
             const collection = jsonStore_1.JsonStore.getData()[resource];
+            if (!validateBody(res, collection, req.body))
+                return;
             const index = findIndexById(collection, idParam);
             if (index === -1) {
                 itemNotFound(res, resource, idParam);

package/dist/store/jsonStore.js

@@ -31,9 +31,22 @@ function parseJsonStorePayload(raw, filePath) {
 class JsonStoreImpl {
     data = {};
     backingPath = null;
+    lockPath = null;
     /** Serializes concurrent save() calls so writes are not interleaved. */
     saveChain = Promise.resolve();
     async load(filePath) {
+        const lockPath = filePath + ".zero-mock.lock";
+        try {
+            await (0, promises_1.access)(lockPath);
+            console.warn(`[warn] Lock file found: "${lockPath}". ` +
+                `Another zero-mock process may be running on this file. ` +
+                `If not, delete the lock file and retry.`);
+        }
+        catch {
+            await (0, promises_1.writeFile)(lockPath, String(process.pid), "utf8");
+            this.lockPath = lockPath;
+            this._registerLockCleanup();
+        }
         let raw;
         try {
             raw = await (0, promises_1.readFile)(filePath, "utf8");
@@ -48,6 +61,19 @@ class JsonStoreImpl {
         this.data = parseJsonStorePayload(raw, filePath);
         this.backingPath = filePath;
     }
+    _registerLockCleanup() {
+        const cleanup = () => {
+            if (this.lockPath) {
+                try {
+                    require("fs").unlinkSync(this.lockPath);
+                }
+                catch (_) { }
+            }
+        };
+        process.once("exit", cleanup);
+        process.once("SIGINT", () => { cleanup(); process.exit(130); });
+        process.once("SIGTERM", () => { cleanup(); process.exit(143); });
+    }
     getData() {
         return this.data;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xirconsss/zero-mock",
-  "version": "0.2.3",
+  "version": "1.1.0",
   "description": "Zero-config CLI that generates REST APIs from JSON files",
   "license": "MIT",
   "keywords": [
@@ -29,10 +29,14 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "ts-node src/index.ts",
-    "prepublishOnly": "npm run build"
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "repository": {
     "type": "git",
@@ -43,15 +47,29 @@
   },
   "homepage": "https://github.com/xircons/zero-mock#readme",
   "dependencies": {
+    "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "cors": "^2.8.5",
-    "express": "^4.21.2"
+    "express": "^4.21.2",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@commitlint/cli": "^21.0.2",
+    "@commitlint/config-conventional": "^21.0.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/release-notes-generator": "^14.1.1",
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
     "@types/node": "^22.14.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "husky": "^9.1.7",
+    "semantic-release": "^25.0.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.2",
+    "vitest": "^2.1.9"
   }
 }