@h-rig/validator-kit 0.0.6-alpha.0

package/README.md

@@ -0,0 +1 @@
+# @h-rig/validator-kit

package/dist/src/checks.js

@@ -0,0 +1,66 @@
+// @bun
+// packages/validator-kit/src/checks.ts
+import { existsSync as existsSync2, statSync as statSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+
+// packages/validator-kit/src/fs.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { resolve } from "path";
+function walkDir(dir, fn) {
+  if (!existsSync(dir))
+    return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = resolve(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git")
+        continue;
+      walkDir(full, fn);
+    } else if (entry.isFile()) {
+      fn(full);
+    }
+  }
+}
+function countTestFiles(dir) {
+  let count = 0;
+  walkDir(dir, (filePath) => {
+    if (filePath.endsWith(".test.ts") || filePath.endsWith(".spec.ts")) {
+      count++;
+    }
+  });
+  return count;
+}
+
+// packages/validator-kit/src/checks.ts
+function requireFileCheck(checker, path, checkName) {
+  if (existsSync2(path)) {
+    checker.pass(checkName);
+  } else {
+    checker.fail(checkName, `file not found: ${path}`);
+  }
+}
+function requireDirCheck(checker, path, checkName) {
+  if (existsSync2(path) && statSync2(path).isDirectory()) {
+    checker.pass(checkName);
+  } else {
+    checker.fail(checkName, `directory not found: ${path}`);
+  }
+}
+function requirePackageStructure(checker, serviceDir, prefix) {
+  requireFileCheck(checker, resolve2(serviceDir, "package.json"), `${prefix}-package-json`);
+  requireFileCheck(checker, resolve2(serviceDir, "tsconfig.json"), `${prefix}-tsconfig`);
+  requireDirCheck(checker, resolve2(serviceDir, "src"), `${prefix}-src-dir`);
+}
+function checkTestsExist(checker, projectDir, checkName) {
+  const count = countTestFiles(projectDir);
+  if (count > 0) {
+    checker.pass(checkName);
+  } else {
+    checker.fail(checkName, "no test files found");
+  }
+}
+export {
+  requirePackageStructure,
+  requireFileCheck,
+  requireDirCheck,
+  checkTestsExist
+};

package/dist/src/content.js

@@ -0,0 +1,81 @@
+// @bun
+// packages/validator-kit/src/content.ts
+import { basename } from "path";
+
+// packages/validator-kit/src/fs.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+function readFileSafe(path) {
+  try {
+    return readFileSync(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+
+// packages/validator-kit/src/content.ts
+function requireMarkdownSections(checker, filePath, sections) {
+  const content = readFileSafe(filePath);
+  if (content === null) {
+    checker.fail("markdown-exists", `file not found: ${filePath}`);
+    return;
+  }
+  for (const section of sections) {
+    const regex = new RegExp(`^##+ .*${section}`, "im");
+    if (regex.test(content)) {
+      checker.pass(`section:${section}`);
+    } else {
+      checker.fail(`section:${section}`, `missing section '${section}' in ${basename(filePath)}`);
+    }
+  }
+}
+function requireTerms(checker, filePath, terms) {
+  const content = readFileSafe(filePath);
+  if (content === null)
+    return;
+  for (const [checkName, pattern] of Object.entries(terms)) {
+    const regex = new RegExp(pattern, "i");
+    if (regex.test(content)) {
+      checker.pass(checkName);
+    } else {
+      checker.fail(checkName, `'${checkName}' not found in ${basename(filePath)}`);
+    }
+  }
+}
+function requireJsonKeys(checker, filePath, keys) {
+  const content = readFileSafe(filePath);
+  if (content === null) {
+    checker.fail("json-exists", `file not found: ${filePath}`);
+    return;
+  }
+  let data;
+  try {
+    data = JSON.parse(content);
+    checker.pass("json-valid");
+  } catch {
+    checker.fail("json-valid", `invalid JSON: ${filePath}`);
+    return;
+  }
+  for (const key of keys) {
+    const parts = key.replace(/^\./, "").split(".");
+    let current = data;
+    let found = true;
+    for (const part of parts) {
+      if (current && typeof current === "object" && part in current) {
+        current = current[part];
+      } else {
+        found = false;
+        break;
+      }
+    }
+    if (found && current !== undefined) {
+      checker.pass(`key:${key}`);
+    } else {
+      checker.fail(`key:${key}`, `missing key '${key}' in ${basename(filePath)}`);
+    }
+  }
+}
+export {
+  requireTerms,
+  requireMarkdownSections,
+  requireJsonKeys
+};

package/dist/src/fs.js

@@ -0,0 +1,103 @@
+// @bun
+// packages/validator-kit/src/fs.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { resolve } from "path";
+
+// packages/validator-kit/src/result.ts
+function fail(id, summary, details) {
+  const output = details !== undefined ? { id, passed: false, summary, details } : { id, passed: false, summary };
+  console.log(JSON.stringify(output));
+  process.exit(1);
+}
+
+// packages/validator-kit/src/fs.ts
+function findFirstFile(candidates) {
+  for (const c of candidates) {
+    if (existsSync(c))
+      return c;
+  }
+  return null;
+}
+function readFileSafe(path) {
+  try {
+    return readFileSync(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function requireFile(path, id, description) {
+  if (!existsSync(path)) {
+    fail(id, `Required file missing: ${description}`, path);
+  }
+  return readFileSync(path, "utf-8");
+}
+function fileContains(path, pattern) {
+  const content = readFileSafe(path);
+  return content !== null && pattern.test(content);
+}
+function walkDir(dir, fn) {
+  if (!existsSync(dir))
+    return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = resolve(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git")
+        continue;
+      walkDir(full, fn);
+    } else if (entry.isFile()) {
+      fn(full);
+    }
+  }
+}
+function listSubdirs(dir) {
+  if (!existsSync(dir))
+    return [];
+  return readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => resolve(dir, e.name));
+}
+function countTsFiles(dir) {
+  let count = 0;
+  walkDir(dir, (filePath) => {
+    if (filePath.endsWith(".ts") && !filePath.endsWith(".test.ts") && !filePath.endsWith(".spec.ts") && !filePath.includes("/__tests__/")) {
+      count++;
+    }
+  });
+  return count;
+}
+function countTestFiles(dir) {
+  let count = 0;
+  walkDir(dir, (filePath) => {
+    if (filePath.endsWith(".test.ts") || filePath.endsWith(".spec.ts")) {
+      count++;
+    }
+  });
+  return count;
+}
+function findFirstDir(candidates) {
+  for (const c of candidates) {
+    if (existsSync(c) && statSync(c).isDirectory())
+      return c;
+  }
+  return null;
+}
+function findFilesByName(dir, namePattern) {
+  const results = [];
+  walkDir(dir, (filePath) => {
+    const base = filePath.split("/").at(-1) ?? "";
+    if (namePattern.test(base)) {
+      results.push(filePath);
+    }
+  });
+  return results;
+}
+export {
+  walkDir,
+  requireFile,
+  readFileSafe,
+  listSubdirs,
+  findFirstFile,
+  findFirstDir,
+  findFilesByName,
+  fileContains,
+  countTsFiles,
+  countTestFiles
+};

package/dist/src/grep.js

@@ -0,0 +1,64 @@
+// @bun
+// packages/validator-kit/src/grep.ts
+import { readFileSync as readFileSync2 } from "fs";
+
+// packages/validator-kit/src/fs.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { resolve } from "path";
+function walkDir(dir, fn) {
+  if (!existsSync(dir))
+    return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = resolve(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git")
+        continue;
+      walkDir(full, fn);
+    } else if (entry.isFile()) {
+      fn(full);
+    }
+  }
+}
+
+// packages/validator-kit/src/grep.ts
+function grepFiles(dir, pattern, extensions) {
+  const results = [];
+  walkDir(dir, (filePath) => {
+    if (extensions && !extensions.some((ext) => filePath.endsWith(ext)))
+      return;
+    try {
+      if (pattern.test(readFileSync2(filePath, "utf-8"))) {
+        results.push(filePath);
+      }
+    } catch {}
+  });
+  return results;
+}
+function grepCount(dir, pattern, extensions) {
+  return grepFiles(dir, pattern, extensions).length;
+}
+function grepLines(dir, pattern, extensions, maxLines = 20) {
+  const results = [];
+  walkDir(dir, (filePath) => {
+    if (results.length >= maxLines)
+      return;
+    if (extensions && !extensions.some((ext) => filePath.endsWith(ext)))
+      return;
+    try {
+      const lines = readFileSync2(filePath, "utf-8").split(/\r?\n/);
+      for (const line of lines) {
+        if (results.length >= maxLines)
+          break;
+        if (pattern.test(line)) {
+          results.push(`${filePath}:${line}`);
+        }
+      }
+    } catch {}
+  });
+  return results;
+}
+export {
+  grepLines,
+  grepFiles,
+  grepCount
+};

package/dist/src/index.js

@@ -0,0 +1,288 @@
+// @bun
+// packages/validator-kit/src/result.ts
+function pass(id, summary) {
+  const output = { id, passed: true, summary };
+  console.log(JSON.stringify(output));
+  process.exit(0);
+}
+function fail(id, summary, details) {
+  const output = details !== undefined ? { id, passed: false, summary, details } : { id, passed: false, summary };
+  console.log(JSON.stringify(output));
+  process.exit(1);
+}
+function error(id, message) {
+  const output = {
+    id,
+    passed: false,
+    summary: `ERROR: ${message}`
+  };
+  console.log(JSON.stringify(output));
+  process.exit(2);
+}
+
+class Checker {
+  results = [];
+  pass(name) {
+    this.results.push({ name, passed: true });
+  }
+  fail(name, reason) {
+    this.results.push({ name, passed: false, reason });
+  }
+  fatal(id, reason) {
+    this.fail("fatal", reason);
+    this.emit(id);
+  }
+  emit(id) {
+    const passed = this.results.filter((r) => r.passed).length;
+    const failed = this.results.filter((r) => !r.passed).length;
+    const total = this.results.length;
+    const failures = this.results.filter((r) => !r.passed).map((r) => `${r.name}: ${r.reason}`).join(`
+`);
+    const output = {
+      id,
+      passed: failed === 0,
+      summary: `${passed} of ${total} checks passed`,
+      ...failures ? { details: failures } : {}
+    };
+    console.log(JSON.stringify(output));
+    process.exit(failed === 0 ? 0 : 1);
+  }
+}
+// packages/validator-kit/src/fs.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { resolve } from "path";
+function findFirstFile(candidates) {
+  for (const c of candidates) {
+    if (existsSync(c))
+      return c;
+  }
+  return null;
+}
+function readFileSafe(path) {
+  try {
+    return readFileSync(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function requireFile(path, id, description) {
+  if (!existsSync(path)) {
+    fail(id, `Required file missing: ${description}`, path);
+  }
+  return readFileSync(path, "utf-8");
+}
+function fileContains(path, pattern) {
+  const content = readFileSafe(path);
+  return content !== null && pattern.test(content);
+}
+function walkDir(dir, fn) {
+  if (!existsSync(dir))
+    return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = resolve(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git")
+        continue;
+      walkDir(full, fn);
+    } else if (entry.isFile()) {
+      fn(full);
+    }
+  }
+}
+function listSubdirs(dir) {
+  if (!existsSync(dir))
+    return [];
+  return readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => resolve(dir, e.name));
+}
+function countTsFiles(dir) {
+  let count = 0;
+  walkDir(dir, (filePath) => {
+    if (filePath.endsWith(".ts") && !filePath.endsWith(".test.ts") && !filePath.endsWith(".spec.ts") && !filePath.includes("/__tests__/")) {
+      count++;
+    }
+  });
+  return count;
+}
+function countTestFiles(dir) {
+  let count = 0;
+  walkDir(dir, (filePath) => {
+    if (filePath.endsWith(".test.ts") || filePath.endsWith(".spec.ts")) {
+      count++;
+    }
+  });
+  return count;
+}
+function findFirstDir(candidates) {
+  for (const c of candidates) {
+    if (existsSync(c) && statSync(c).isDirectory())
+      return c;
+  }
+  return null;
+}
+function findFilesByName(dir, namePattern) {
+  const results = [];
+  walkDir(dir, (filePath) => {
+    const base = filePath.split("/").at(-1) ?? "";
+    if (namePattern.test(base)) {
+      results.push(filePath);
+    }
+  });
+  return results;
+}
+// packages/validator-kit/src/grep.ts
+import { readFileSync as readFileSync2 } from "fs";
+function grepFiles(dir, pattern, extensions) {
+  const results = [];
+  walkDir(dir, (filePath) => {
+    if (extensions && !extensions.some((ext) => filePath.endsWith(ext)))
+      return;
+    try {
+      if (pattern.test(readFileSync2(filePath, "utf-8"))) {
+        results.push(filePath);
+      }
+    } catch {}
+  });
+  return results;
+}
+function grepCount(dir, pattern, extensions) {
+  return grepFiles(dir, pattern, extensions).length;
+}
+function grepLines(dir, pattern, extensions, maxLines = 20) {
+  const results = [];
+  walkDir(dir, (filePath) => {
+    if (results.length >= maxLines)
+      return;
+    if (extensions && !extensions.some((ext) => filePath.endsWith(ext)))
+      return;
+    try {
+      const lines = readFileSync2(filePath, "utf-8").split(/\r?\n/);
+      for (const line of lines) {
+        if (results.length >= maxLines)
+          break;
+        if (pattern.test(line)) {
+          results.push(`${filePath}:${line}`);
+        }
+      }
+    } catch {}
+  });
+  return results;
+}
+// packages/validator-kit/src/content.ts
+import { basename } from "path";
+function requireMarkdownSections(checker, filePath, sections) {
+  const content = readFileSafe(filePath);
+  if (content === null) {
+    checker.fail("markdown-exists", `file not found: ${filePath}`);
+    return;
+  }
+  for (const section of sections) {
+    const regex = new RegExp(`^##+ .*${section}`, "im");
+    if (regex.test(content)) {
+      checker.pass(`section:${section}`);
+    } else {
+      checker.fail(`section:${section}`, `missing section '${section}' in ${basename(filePath)}`);
+    }
+  }
+}
+function requireTerms(checker, filePath, terms) {
+  const content = readFileSafe(filePath);
+  if (content === null)
+    return;
+  for (const [checkName, pattern] of Object.entries(terms)) {
+    const regex = new RegExp(pattern, "i");
+    if (regex.test(content)) {
+      checker.pass(checkName);
+    } else {
+      checker.fail(checkName, `'${checkName}' not found in ${basename(filePath)}`);
+    }
+  }
+}
+function requireJsonKeys(checker, filePath, keys) {
+  const content = readFileSafe(filePath);
+  if (content === null) {
+    checker.fail("json-exists", `file not found: ${filePath}`);
+    return;
+  }
+  let data;
+  try {
+    data = JSON.parse(content);
+    checker.pass("json-valid");
+  } catch {
+    checker.fail("json-valid", `invalid JSON: ${filePath}`);
+    return;
+  }
+  for (const key of keys) {
+    const parts = key.replace(/^\./, "").split(".");
+    let current = data;
+    let found = true;
+    for (const part of parts) {
+      if (current && typeof current === "object" && part in current) {
+        current = current[part];
+      } else {
+        found = false;
+        break;
+      }
+    }
+    if (found && current !== undefined) {
+      checker.pass(`key:${key}`);
+    } else {
+      checker.fail(`key:${key}`, `missing key '${key}' in ${basename(filePath)}`);
+    }
+  }
+}
+// packages/validator-kit/src/checks.ts
+import { existsSync as existsSync2, statSync as statSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+function requireFileCheck(checker, path, checkName) {
+  if (existsSync2(path)) {
+    checker.pass(checkName);
+  } else {
+    checker.fail(checkName, `file not found: ${path}`);
+  }
+}
+function requireDirCheck(checker, path, checkName) {
+  if (existsSync2(path) && statSync2(path).isDirectory()) {
+    checker.pass(checkName);
+  } else {
+    checker.fail(checkName, `directory not found: ${path}`);
+  }
+}
+function requirePackageStructure(checker, serviceDir, prefix) {
+  requireFileCheck(checker, resolve2(serviceDir, "package.json"), `${prefix}-package-json`);
+  requireFileCheck(checker, resolve2(serviceDir, "tsconfig.json"), `${prefix}-tsconfig`);
+  requireDirCheck(checker, resolve2(serviceDir, "src"), `${prefix}-src-dir`);
+}
+function checkTestsExist(checker, projectDir, checkName) {
+  const count = countTestFiles(projectDir);
+  if (count > 0) {
+    checker.pass(checkName);
+  } else {
+    checker.fail(checkName, "no test files found");
+  }
+}
+export {
+  walkDir,
+  requireTerms,
+  requirePackageStructure,
+  requireMarkdownSections,
+  requireJsonKeys,
+  requireFileCheck,
+  requireFile,
+  requireDirCheck,
+  readFileSafe,
+  pass,
+  listSubdirs,
+  grepLines,
+  grepFiles,
+  grepCount,
+  findFirstFile,
+  findFirstDir,
+  findFilesByName,
+  fileContains,
+  fail,
+  error,
+  countTsFiles,
+  countTestFiles,
+  checkTestsExist,
+  Checker
+};

package/dist/src/result.js

@@ -0,0 +1,56 @@
+// @bun
+// packages/validator-kit/src/result.ts
+function pass(id, summary) {
+  const output = { id, passed: true, summary };
+  console.log(JSON.stringify(output));
+  process.exit(0);
+}
+function fail(id, summary, details) {
+  const output = details !== undefined ? { id, passed: false, summary, details } : { id, passed: false, summary };
+  console.log(JSON.stringify(output));
+  process.exit(1);
+}
+function error(id, message) {
+  const output = {
+    id,
+    passed: false,
+    summary: `ERROR: ${message}`
+  };
+  console.log(JSON.stringify(output));
+  process.exit(2);
+}
+
+class Checker {
+  results = [];
+  pass(name) {
+    this.results.push({ name, passed: true });
+  }
+  fail(name, reason) {
+    this.results.push({ name, passed: false, reason });
+  }
+  fatal(id, reason) {
+    this.fail("fatal", reason);
+    this.emit(id);
+  }
+  emit(id) {
+    const passed = this.results.filter((r) => r.passed).length;
+    const failed = this.results.filter((r) => !r.passed).length;
+    const total = this.results.length;
+    const failures = this.results.filter((r) => !r.passed).map((r) => `${r.name}: ${r.reason}`).join(`
+`);
+    const output = {
+      id,
+      passed: failed === 0,
+      summary: `${passed} of ${total} checks passed`,
+      ...failures ? { details: failures } : {}
+    };
+    console.log(JSON.stringify(output));
+    process.exit(failed === 0 ? 0 : 1);
+  }
+}
+export {
+  pass,
+  fail,
+  error,
+  Checker
+};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@h-rig/validator-kit",
+  "version": "0.0.6-alpha.0",
+  "type": "module",
+  "description": "Rig package",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js"
+    }
+  },
+  "engines": {
+    "bun": ">=1.3.11"
+  },
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.js",
+  "dependencies": {
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.0",
+    "effect": "4.0.0-beta.78"
+  }
+}