@yottagraph-app/aether-instructions 1.0.1

package/skills/aether_test-api-queries/query-api.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/**
+ * Simple CLI tool to query the Elemental API.
+ *
+ * Auth: set AUTH0_M2M_DEV_TOKEN as an env var or in your .env file.
+ * Server: set NUXT_PUBLIC_QUERY_SERVER_ADDRESS in your .env file.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const FORM_ENCODED_ENDPOINTS = ['/elemental/find', '/elemental/entities/properties'];
+
+function loadEnvFile() {
+    // Try current working directory first (project .env), then script directory
+    const envPaths = [
+        path.join(process.cwd(), '.env'),
+        path.join(__dirname, '.env'),
+    ];
+
+    for (const envPath of envPaths) {
+        try {
+            const contents = fs.readFileSync(envPath, 'utf8');
+            for (const line of contents.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#')) continue;
+                const eqIndex = trimmed.indexOf('=');
+                if (eqIndex === -1) continue;
+                const key = trimmed.slice(0, eqIndex).trim();
+                const value = trimmed.slice(eqIndex + 1).trim();
+                if (!process.env[key]) {
+                    process.env[key] = value;
+                }
+            }
+            return; // Stop after first successful load
+        } catch {
+            // Try next path
+        }
+    }
+}
+
+function requiresFormEncoding(endpoint) {
+    return FORM_ENCODED_ENDPOINTS.some((e) => endpoint.startsWith(e));
+}
+
+function buildFormBody(endpoint, params) {
+    const formParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (typeof value === 'object') {
+            formParams.append(key, JSON.stringify(value));
+        } else {
+            formParams.append(key, String(value));
+        }
+    }
+    return formParams.toString();
+}
+
+async function main() {
+    loadEnvFile();
+
+    const args = process.argv.slice(2);
+
+    if (args.length < 2 || args[0] === '--help' || args[0] === '-h') {
+        console.log(`
+Elemental API Query Tool
+
+Usage:
+  node query-api.js <METHOD> <ENDPOINT> [JSON_PARAMS]
+
+Examples:
+  # Search for entities (JSON body)
+  node query-api.js POST /entities/search '{"queries":[{"queryId":1,"query":"Apple"}],"maxResults":3}'
+
+  # Get entity details
+  node query-api.js GET /entities/00416400910670863867
+
+  # Find entities by expression (auto form-encoded)
+  node query-api.js POST /elemental/find '{"expression":{"type":"is_type","is_type":{"fid":10}},"limit":5}'
+
+  # Find entities with a property value
+  node query-api.js POST /elemental/find '{"expression":{"type":"comparison","comparison":{"operator":"has_value","pid":313}},"limit":10}'
+
+  # Get entity properties (auto form-encoded)
+  node query-api.js POST /elemental/entities/properties '{"eids":["00416400910670863867"],"pids":[8,313]}'
+
+Environment variables (required):
+  AUTH0_M2M_DEV_TOKEN                Bearer token for API auth
+  NUXT_PUBLIC_QUERY_SERVER_ADDRESS     Query server URL (e.g. https://query.news.prod.g.lovelace.ai)
+
+Setup:
+  1. Get a dev token from your team
+  2. Add AUTH0_M2M_DEV_TOKEN to your .env file or export in your shell
+     (NUXT_PUBLIC_QUERY_SERVER_ADDRESS should already be in your .env from project init)
+
+Note: /elemental/find and /elemental/entities/properties require form-encoded bodies.
+      This tool automatically handles the encoding for these endpoints.
+`);
+        process.exit(0);
+    }
+
+    const [method, endpoint, jsonParams] = args;
+
+    const token = process.env.AUTH0_M2M_DEV_TOKEN;
+    if (!token) {
+        console.error('Error: AUTH0_M2M_DEV_TOKEN is not set.');
+        console.error('Add it to your .env file or export it in your shell.');
+        console.error('Run: node query-api.js --help');
+        process.exit(1);
+    }
+
+    let params = {};
+    if (jsonParams) {
+        try {
+            params = JSON.parse(jsonParams);
+        } catch (err) {
+            console.error('Error: Invalid JSON parameters');
+            console.error(err.message);
+            process.exit(1);
+        }
+    }
+
+    const server = process.env.NUXT_PUBLIC_QUERY_SERVER_ADDRESS;
+    if (!server) {
+        console.error('Error: NUXT_PUBLIC_QUERY_SERVER_ADDRESS is not set.');
+        console.error('Add it to your .env file or export it in your shell.');
+        console.error('Run: node query-api.js --help');
+        process.exit(1);
+    }
+
+    const normalizedEndpoint = endpoint.startsWith('/') ? endpoint : '/' + endpoint;
+    let url = `${server}${normalizedEndpoint}`;
+
+    const useFormEncoding = requiresFormEncoding(normalizedEndpoint);
+    const fetchOptions = {
+        method: method.toUpperCase(),
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': useFormEncoding
+                ? 'application/x-www-form-urlencoded'
+                : 'application/json',
+            Accept: 'application/json',
+        },
+    };
+
+    if (method.toUpperCase() === 'GET' && Object.keys(params).length > 0) {
+        const queryString = new URLSearchParams(params).toString();
+        url = `${url}?${queryString}`;
+    } else if (method.toUpperCase() !== 'GET' && Object.keys(params).length > 0) {
+        if (useFormEncoding) {
+            fetchOptions.body = buildFormBody(normalizedEndpoint, params);
+        } else {
+            fetchOptions.body = JSON.stringify(params);
+        }
+    }
+
+    console.error(`\n📡 ${method.toUpperCase()} ${url}\n`);
+
+    try {
+        const response = await fetch(url, fetchOptions);
+        const data = await response.json();
+
+        if (!response.ok) {
+            console.error(`❌ Error ${response.status}: ${response.statusText}`);
+        } else {
+            console.error(`✅ Success (${response.status})\n`);
+        }
+
+        console.log(JSON.stringify(data, null, 2));
+    } catch (err) {
+        console.error('❌ Request failed:', err.message);
+        process.exit(1);
+    }
+}
+
+main();