@jsonfirst/sdk 1.0.0 → 1.1.0

package/README.md

@@ -39,14 +39,14 @@ console.log(valid, errors);
 ```javascript
 const client = new JsonFirst({
   apiKey: 'YOUR_API_KEY',
-  baseUrl: 'https://jsonfirst.io' // optional override
+  baseUrl: 'https://jsonfirst.com' // optional override
 });
 ```
 
 ## Links
 
-- [Documentation](https://jsonfirst.io/developers)
-- [Templates](https://jsonfirst.io/templates)
+- [Documentation](https://jsonfirst.com/developers)
+- [Templates](https://jsonfirst.com/templates)
 - [GitHub](https://github.com/jsonfirst/sdk)
 
 ## License

package/index.js

@@ -19,7 +19,7 @@
   }
 }(typeof globalThis !== 'undefined' ? globalThis : this, function() {
 
-  const DEFAULT_BASE_URL = 'https://jsonfirst.io';
+  const DEFAULT_BASE_URL = 'https://jsonfirst.com';
 
   class JsonFirstError extends Error {
     constructor(message, status, body) {
@@ -34,7 +34,7 @@
     /**
      * @param {Object} options
      * @param {string} options.apiKey - Your JSONFIRST API key
-     * @param {string} [options.baseUrl] - Override base URL (default: https://jsonfirst.io)
+     * @param {string} [options.baseUrl] - Override base URL (default: https://jsonfirst.com)
      */
     constructor(options = {}) {
       if (!options.apiKey) throw new Error('JsonFirst: apiKey is required');
@@ -85,20 +85,73 @@
     }
 
     /**
-     * Validate a JSON object against the JSONFIRST spec.
-     * @param {Object} json - The JSON to validate
-     * @returns {{ valid: boolean, errors: string[] }}
+     * Validate a JSONFIRST output JSON against the JSONFIRST v2 spec.
+     * @param {Object} json - The JSONFIRST JSON to validate
+     * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
      */
     validate(json) {
       const errors = [];
+      const warnings = [];
       if (!json || typeof json !== 'object') {
-        return { valid: false, errors: ['Input must be a JSON object'] };
+        return { valid: false, errors: ['Input must be a JSON object'], warnings: [] };
       }
       if (json.spec !== 'JSONFIRST') errors.push('Missing or incorrect "spec" field (expected "JSONFIRST")');
       if (!json.version) errors.push('Missing "version" field');
-      if (!json.jdons || !Array.isArray(json.jdons)) errors.push('Missing "jdons" array');
+      if (!json.jdons || !Array.isArray(json.jdons)) {
+        errors.push('Missing "jdons" array');
+      } else if (json.jdons.length === 0) {
+        warnings.push('"jdons" array is empty — no intents parsed');
+      }
       if (!json.execution || typeof json.execution !== 'object') errors.push('Missing "execution" object');
-      return { valid: errors.length === 0, errors };
+      return { valid: errors.length === 0, errors, warnings };
+    }
+
+    /**
+     * Validate a single JDON intent for completeness and executability.
+     * Checks required params, confidence threshold, and executable flag.
+     * @param {Object} intent - A single JDON object from jdons[]
+     * @param {Object} [options]
+     * @param {number} [options.minConfidence=0.5] - Minimum confidence threshold (0-1)
+     * @param {string[]} [options.requiredParams=[]] - List of required param keys in intent.object
+     * @returns {{ valid: boolean, executable: boolean, missing_params: string[], errors: string[], confidence: number }}
+     */
+    validateIntent(intent, options = {}) {
+      const { minConfidence = 0.5, requiredParams = [] } = options;
+      const errors = [];
+      const missing_params = [];
+
+      if (!intent || typeof intent !== 'object') {
+        return { valid: false, executable: false, missing_params: [], errors: ['Intent must be a JSON object'], confidence: 0 };
+      }
+
+      // Action check
+      if (!intent.action || !intent.action.normalized) errors.push('Missing action.normalized');
+
+      // Confidence check
+      const confidence = intent.confidence || 0;
+      if (confidence < minConfidence) {
+        errors.push(`Confidence ${(confidence * 100).toFixed(0)}% is below minimum ${(minConfidence * 100).toFixed(0)}%`);
+      }
+
+      // Required params check
+      const obj = intent.object || {};
+      for (const param of requiredParams) {
+        if (obj[param] === undefined || obj[param] === null) {
+          missing_params.push(param);
+          errors.push(`Missing required param: ${param}`);
+        }
+      }
+
+      // Missing params from JSONFIRST spec
+      if (intent.missing_params && intent.missing_params.length > 0) {
+        for (const p of intent.missing_params) {
+          if (!missing_params.includes(p)) missing_params.push(p);
+        }
+      }
+
+      const executable = intent.executable === true && missing_params.length === 0 && errors.length === 0;
+
+      return { valid: errors.length === 0, executable, missing_params, errors, confidence };
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonfirst/sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Official JavaScript/Node.js SDK for the JSONFIRST Protocol — Universal Intent Protocol for AI governance",
   "main": "index.js",
   "files": [
@@ -23,13 +23,13 @@
     "claude",
     "gemini"
   ],
-  "author": "JSONFIRST <contact@jsonfirst.io>",
+  "author": "JSONFIRST <contact@jsonfirst.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/jsonfirst/sdk"
   },
-  "homepage": "https://jsonfirst.io",
+  "homepage": "https://jsonfirst.com",
   "engines": {
     "node": ">=14"
   }