@icib.dev/api-client 1.0.1 → 1.0.3

package/dist/scripts/hash.js

@@ -0,0 +1,49 @@
+import { createHash } from "crypto";
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join } from "path";
+/** Recursively sort object keys for deterministic JSON hashing */
+export function sortKeysRecursive(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(sortKeysRecursive);
+    return Object.keys(obj)
+        .sort()
+        .reduce((acc, k) => {
+        acc[k] = sortKeysRecursive(obj[k]);
+        return acc;
+    }, {});
+}
+/** SHA256 hash of normalized JSON (deterministic regardless of key order) */
+export function normalizedJsonHash(obj) {
+    const str = JSON.stringify(sortKeysRecursive(obj));
+    return createHash("sha256").update(str).digest("hex");
+}
+/** Deterministic file list for client hash: types/index.ts, client.ts, apiClient.ts, index.ts, contexts/*.ts (sorted) */
+const CLIENT_FILE_ORDER = [
+    "types/index.ts",
+    "client.ts",
+    "apiClient.ts",
+    "index.ts",
+];
+/** Compute SHA256 hash of all generated client files in deterministic order */
+export function computeClientHash(baseDir, outSubdir) {
+    const outDir = join(baseDir, outSubdir);
+    const hash = createHash("sha256");
+    for (const relPath of CLIENT_FILE_ORDER) {
+        const fullPath = join(outDir, relPath);
+        if (existsSync(fullPath)) {
+            hash.update(readFileSync(fullPath, "utf-8"));
+        }
+    }
+    const contextsDir = join(outDir, "contexts");
+    if (existsSync(contextsDir)) {
+        const contextFiles = readdirSync(contextsDir)
+            .filter((f) => f.endsWith(".ts"))
+            .sort();
+        for (const f of contextFiles) {
+            hash.update(readFileSync(join(contextsDir, f), "utf-8"));
+        }
+    }
+    return hash.digest("hex");
+}

package/dist/scripts/verify.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { fileURLToPath } from "url";
+import { normalizedJsonHash, computeClientHash, } from "./hash.js";
+async function loadRawSpec(urlOrPath) {
+    if (urlOrPath.startsWith("http://") || urlOrPath.startsWith("https://")) {
+        const res = await fetch(urlOrPath);
+        if (!res.ok) {
+            throw new Error(`Failed to fetch spec: ${res.status} ${res.statusText}`);
+        }
+        return res.json();
+    }
+    return JSON.parse(readFileSync(urlOrPath, "utf-8"));
+}
+export async function verify(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const manifestPath = options.manifestPath ?? join(cwd, "api-client.manifest.json");
+    if (!existsSync(manifestPath)) {
+        throw new Error("No manifest found. Run `npm run generate` first.");
+    }
+    const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+    if (!manifest.docsSource ||
+        !manifest.docsHash ||
+        !manifest.clientHash ||
+        !manifest.out) {
+        throw new Error("Invalid manifest: missing docsSource, docsHash, clientHash, or out.");
+    }
+    const rawSpec = await loadRawSpec(manifest.docsSource);
+    const currentDocsHash = normalizedJsonHash(rawSpec);
+    if (currentDocsHash !== manifest.docsHash) {
+        throw new Error("API docs have changed. Run `npm run generate` to regenerate the client, then update your application.");
+    }
+    const currentClientHash = computeClientHash(cwd, manifest.out);
+    if (currentClientHash !== manifest.clientHash) {
+        throw new Error("Generated client files were modified. Run `npm run generate` to regenerate.");
+    }
+}
+async function main() {
+    try {
+        await verify();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(message);
+        process.exit(1);
+    }
+}
+const __filename = fileURLToPath(import.meta.url);
+if (process.argv[1] === __filename) {
+    main();
+}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@icib.dev/api-client",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Strictly-typed TypeScript API client for ICIB API",
   "type": "module",
   "main": "./dist/api/index.js",
   "types": "./dist/api/index.d.ts",
+  "bin": {
+    "api-client-generate": "./dist/scripts/generate.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/api/index.d.ts",
@@ -17,17 +20,20 @@
   ],
   "scripts": {
     "generate": "tsx scripts/generate.ts",
-    "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run generate && npm run build"
+    "build": "tsx scripts/verify.ts && tsc -p tsconfig.build.json && tsc -p tsconfig.scripts.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "axios": "^1.7.0"
+    "@apidevtools/swagger-parser": "^12.1.0",
+    "axios": "^1.13.6"
   },
   "devDependencies": {
-    "@apidevtools/swagger-parser": "^10.0.3",
-    "@types/node": "^22.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.6.0"
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
   },
   "keywords": [
     "api-client",