ata-validator 1.0.2 → 1.2.0

package/include/ata.h

@@ -1,111 +0,0 @@
-#pragma once
-
-#include <cstdint>
-#include <memory>
-#include <optional>
-#include <string>
-#include <string_view>
-#include <variant>
-#include <vector>
-
-#define ATA_VERSION "1.0.2"
-
-namespace ata {
-
-inline constexpr uint32_t VERSION_MAJOR = 1;
-inline constexpr uint32_t VERSION_MINOR = 0;
-inline constexpr uint32_t VERSION_REVISION = 2;
-
-inline constexpr std::string_view version() noexcept {
-  return ATA_VERSION;
-}
-
-enum class error_code : uint8_t {
-  ok = 0,
-  invalid_json,
-  invalid_schema,
-  type_mismatch,
-  required_property_missing,
-  additional_property_not_allowed,
-  enum_mismatch,
-  const_mismatch,
-  minimum_violation,
-  maximum_violation,
-  exclusive_minimum_violation,
-  exclusive_maximum_violation,
-  min_length_violation,
-  max_length_violation,
-  pattern_mismatch,
-  format_mismatch,
-  min_items_violation,
-  max_items_violation,
-  unique_items_violation,
-  min_properties_violation,
-  max_properties_violation,
-  multiple_of_violation,
-  all_of_failed,
-  any_of_failed,
-  one_of_failed,
-  not_failed,
-  ref_not_found,
-  if_then_else_failed,
-};
-
-struct validation_error {
-  error_code code;
-  std::string path;
-  std::string message;
-  std::string expected;
-  std::string actual;
-};
-
-struct validation_result {
-  bool valid;
-  std::vector<validation_error> errors;
-
-  explicit operator bool() const noexcept { return valid; }
-};
-
-struct compiled_schema;
-
-struct schema_warning {
-  std::string path;
-  std::string message;
-};
-
-struct schema_ref {
-  std::shared_ptr<compiled_schema> impl;
-  std::vector<schema_warning> warnings;
-
-  explicit operator bool() const noexcept { return impl != nullptr; }
-};
-
-struct validate_options {
-  bool all_errors = true;  // false = stop at first error (faster)
-};
-
-// Compile a JSON Schema string into an internal representation.
-schema_ref compile(std::string_view schema_json);
-
-// Validate a JSON document against a compiled schema.
-validation_result validate(const schema_ref& schema, std::string_view json,
-                           const validate_options& opts = {});
-
-// Validate a JSON document against a schema (compiles schema each time).
-validation_result validate(std::string_view schema_json,
-                           std::string_view json,
-                           const validate_options& opts = {});
-
-// Ultra-fast boolean validation — no error collection, no allocation.
-// Input MUST have at least 64 bytes of padding after data (simdjson requirement).
-// Use this when you only need true/false and can provide pre-padded input.
-bool is_valid_prepadded(const schema_ref& schema, const char* data, size_t length);
-
-// Validate raw buffer — handles padding internally via thread-local copy.
-// Use this when input doesn't have simdjson padding (e.g., from V8 TypedArray).
-bool is_valid_buf(const schema_ref& schema, const uint8_t* data, size_t length);
-
-// Required padding size for is_valid_prepadded
-inline constexpr size_t REQUIRED_PADDING = 64;
-
-}  // namespace ata

package/include/ata_c.h

@@ -1,57 +0,0 @@
-#ifndef ATA_C_H
-#define ATA_C_H
-
-#include <stdbool.h>
-#include <stddef.h>
-#include <stdint.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-typedef struct ata_schema_s* ata_schema;
-
-typedef struct {
-  const char* data;
-  size_t length;
-} ata_string;
-
-typedef struct {
-  bool valid;
-  size_t error_count;
-} ata_result;
-
-typedef struct {
-  uint32_t major;
-  uint32_t minor;
-  uint32_t revision;
-} ata_version_components;
-
-// Compile a JSON Schema. Returns NULL on failure.
-ata_schema ata_compile(const char* schema_json, size_t length);
-
-// Free a compiled schema. NULL-safe.
-void ata_schema_free(ata_schema schema);
-
-// Validate JSON against a compiled schema.
-ata_result ata_validate(ata_schema schema, const char* json, size_t length);
-
-// Validate JSON against a schema string (compiles each time).
-ata_result ata_validate_oneshot(const char* schema_json, size_t schema_length,
-                                const char* json, size_t json_length);
-
-// Get error message at index from last validation.
-ata_string ata_get_error_message(size_t index);
-
-// Get error path at index from last validation.
-ata_string ata_get_error_path(size_t index);
-
-// Version info
-const char* ata_get_version(void);
-ata_version_components ata_get_version_components(void);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif  // ATA_C_H

package/scripts/check-doc-coverage.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { all } = require('../lib/error-codes');
-
-const doc = fs.readFileSync(path.join(__dirname, '..', 'docs', 'error-codes.md'), 'utf8');
-
-const missing = [];
-const placeholder = [];
-for (const code of all()) {
-  const headingRe = new RegExp(`^### ${code}\\b`, 'm');
-  if (!headingRe.test(doc)) {
-    missing.push(code);
-    continue;
-  }
-  // Find the section, ensure it doesn't still say "_TODO — fill before release._"
-  const start = doc.search(headingRe);
-  const next = doc.slice(start + 4).search(/^### /m);
-  const section = next === -1 ? doc.slice(start) : doc.slice(start, start + 4 + next);
-  if (section.includes('_TODO')) placeholder.push(code);
-}
-
-if (missing.length) {
-  console.error(`docs/error-codes.md is missing entries for: ${missing.join(', ')}`);
-  process.exit(1);
-}
-if (placeholder.length && process.env.ATA_ALLOW_DOC_PLACEHOLDERS !== '1') {
-  console.error(`docs/error-codes.md has placeholder _TODO sections for: ${placeholder.join(', ')}`);
-  console.error('Run: ATA_ALLOW_DOC_PLACEHOLDERS=1 node scripts/check-doc-coverage.js (development only)');
-  process.exit(1);
-}
-console.log(`ok: ${all().length} codes documented`);

package/scripts/check-prebuilds.js

@@ -1,54 +0,0 @@
-'use strict';
-
-// Refuse to publish a tarball that is missing platform prebuilds.
-// Local `npm publish` only carries whatever the publisher's machine built,
-// which silently drops every other platform's prebuild from the tarball.
-// Publishing must go through the release workflow so all platforms are present.
-
-const fs = require('fs');
-const path = require('path');
-const cp = require('child_process');
-
-const required = [
-  'ata-linux-x64',
-  'ata-linux-arm64',
-  'ata-linux-x64-musl',
-  'ata-linux-arm64-musl',
-  'ata-darwin-arm64',
-  'ata-win32-x64',
-];
-
-const root = path.resolve(__dirname, '..');
-const missing = required.filter(
-  (dir) => !fs.existsSync(path.join(root, 'prebuilds', dir, 'node-napi-v10.node')),
-);
-
-if (missing.length) {
-  console.error(
-    '\n[ata-validator] Refusing to publish, missing prebuilds:\n' +
-      missing.map((d) => '  - ' + d).join('\n') +
-      '\n\nPublish through the GitHub release workflow so every platform is built.\n',
-  );
-  process.exit(1);
-}
-
-// When publishing from a Mac, verify the darwin code signatures too. strip
-// invalidates the linker signature, and an unsigned arm64 addon is killed on
-// load. The release workflow re-signs and verifies, this is the local net.
-if (process.platform === 'darwin') {
-  for (const dir of required) {
-    if (!dir.startsWith('ata-darwin-')) continue;
-    const f = path.join(root, 'prebuilds', dir, 'node-napi-v10.node');
-    const r = cp.spawnSync('codesign', ['--verify', f], { encoding: 'utf8' });
-    if (r.status !== 0) {
-      console.error(
-        '\n[ata-validator] Refusing to publish, invalid code signature:\n' +
-          '  ' + f + '\n' + (r.stderr || '').trim() +
-          '\n\nRe-sign with: codesign --force --sign - "' + f + '"\n',
-      );
-      process.exit(1);
-    }
-  }
-}
-
-console.log('[ata-validator] prebuilds present for all ' + required.length + ' platforms');

package/scripts/install.js

@@ -1,23 +0,0 @@
-'use strict';
-
-const { execSync } = require('child_process');
-const path = require('path');
-
-const root = path.resolve(__dirname, '..');
-
-try {
-  execSync('pkg-prebuilds-verify ./binding-options.js', { cwd: root, stdio: 'ignore' });
-  process.exit(0);
-} catch {}
-
-// No prebuild for this platform — try cmake-js if available
-try {
-  execSync('cmake-js compile --target ata', { cwd: root, stdio: 'inherit' });
-  process.exit(0);
-} catch {}
-
-console.log(
-  '\n[ata-validator] No native prebuild found for ' + process.platform + '-' + process.arch + '.\n' +
-  'Falling back to JS engine (still works, ~2-3x slower for buffer APIs).\n' +
-  'To build from source: install cmake, RE2, abseil, then run `npx cmake-js compile --target ata`\n'
-);

package/scripts/regen-error-codes-doc.js

@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { CODES, all } = require('../lib/error-codes');
-
-const lines = [];
-lines.push('# ata Error Codes');
-lines.push('');
-lines.push('Stable registry of `ATA####` codes emitted by ata-validator. Each section is the target of `https://ata-validator.com/e/<code>`.');
-lines.push('');
-
-const byCategory = {};
-for (const c of all()) {
-  const cat = CODES[c].category;
-  (byCategory[cat] ||= []).push(c);
-}
-
-const order = ['type', 'shape', 'constraint', 'format', 'enum', 'composition', 'ref', 'system'];
-for (const cat of order) {
-  if (!byCategory[cat]) continue;
-  lines.push(`## ${cat}`);
-  lines.push('');
-  for (const code of byCategory[cat]) {
-    const meta = CODES[code];
-    lines.push(`### ${code} — ${meta.headline}`);
-    lines.push('');
-    lines.push(`Keyword: \`${meta.keyword}\`${meta.format ? ` (format: \`${meta.format}\`)` : ''}`);
-    lines.push('');
-    lines.push('**Cause.** _TODO — fill before release._');
-    lines.push('');
-    lines.push('**Fix.** _TODO — fill before release._');
-    lines.push('');
-  }
-}
-
-const docPath = path.join(__dirname, '..', 'docs', 'error-codes.md');
-fs.writeFileSync(docPath, lines.join('\n') + '\n');
-console.log(`wrote ${all().length} sections to docs/error-codes.md`);

package/scripts/regen-lock.js

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { CODES, all } = require('../lib/error-codes');
-
-const out = {};
-for (const c of all()) {
-  out[c] = {
-    keyword: CODES[c].keyword,
-    category: CODES[c].category,
-    format: CODES[c].format || null,
-  };
-}
-
-const lockPath = path.join(__dirname, '..', 'tests', 'error-codes.lock.json');
-fs.writeFileSync(lockPath, JSON.stringify(out, null, 2) + '\n');
-console.log(`wrote ${all().length} codes to ${path.relative(process.cwd(), lockPath)}`);

package/scripts/regen-safe-regex-source.js

@@ -1,33 +0,0 @@
-'use strict';
-
-// Bake `lib/safe-regex.js` into `lib/safe-regex-source.js` as a plain string
-// export so the AOT path (`lib/aot.js`) can embed the engine into generated
-// modules without reading from disk at runtime. The runtime read used to be
-// the reason browser bundles broke on first AOT call (and the reason the
-// default entry had to carry `__dirname`/`fs`/`path`).
-//
-// Run from `prepublishOnly` and from a sync test so the bundled string never
-// drifts from the engine source.
-
-const fs = require('fs');
-const path = require('path');
-
-const root = path.resolve(__dirname, '..');
-const src = fs.readFileSync(path.join(root, 'lib', 'safe-regex.js'), 'utf8').replace(/\r\n/g, '\n');
-
-const out =
-  "'use strict';\n\n" +
-  "// Auto-generated by scripts/regen-safe-regex-source.js — do not edit.\n" +
-  "// Mirrors `lib/safe-regex.js` verbatim so `lib/aot.js` can embed the engine\n" +
-  "// into standalone output without a runtime `fs` read. Kept in sync by\n" +
-  "// `tests/test_safe_regex_source_sync.js`.\n\n" +
-  'module.exports = ' + JSON.stringify(src) + ';\n';
-
-const outPath = path.join(root, 'lib', 'safe-regex-source.js');
-const prev = fs.existsSync(outPath) ? fs.readFileSync(outPath, 'utf8') : '';
-if (prev === out) {
-  console.log('lib/safe-regex-source.js: up to date');
-} else {
-  fs.writeFileSync(outPath, out);
-  console.log('lib/safe-regex-source.js: regenerated');
-}