@startanaicompany/dns 1.3.0

package/lib/client.js

@@ -0,0 +1,134 @@
+'use strict';
+
+/**
+ * SAAC DNS API Client
+ * Communicates with the SAAC backend (production: https://start-an-ai-company-3l1xzm.adam.startanaicompany.com)
+ * which proxies to NameSilo for domain operations.
+ *
+ * Auth: set SAAC_USER_API_KEY and SAAC_USER_EMAIL environment variables.
+ *   SAAC_USER_API_KEY  — your personal API key (used as Bearer token and as api_key on registration)
+ *   SAAC_USER_EMAIL    — your account email
+ *
+ * Override the backend URL with SAAC_API_URL (useful for local development).
+ */
+
+const BASE_URL = process.env.SAAC_API_URL || 'https://start-an-ai-company-3l1xzm.adam.startanaicompany.com';
+
+class AuthenticationError extends Error {
+  constructor(msg) { super(msg); this.name = 'AuthenticationError'; this.code = 110; }
+}
+class DomainNotFoundError extends Error {
+  constructor(msg) { super(msg); this.name = 'DomainNotFoundError'; this.code = 200; }
+}
+class DomainUnavailableError extends Error {
+  constructor(msg) { super(msg); this.name = 'DomainUnavailableError'; this.code = 261; }
+}
+class ValidationError extends Error {
+  constructor(msg) { super(msg); this.name = 'ValidationError'; this.code = 108; }
+}
+class InsufficientFundsError extends Error {
+  constructor(msg) { super(msg); this.name = 'InsufficientFundsError'; this.code = 280; }
+}
+class SaacDnsError extends Error {
+  constructor(msg, code) { super(msg); this.name = 'SaacDnsError'; this.code = code; }
+}
+
+function getCredentials() {
+  const apiKey = process.env.SAAC_USER_API_KEY;
+  const email = process.env.SAAC_USER_EMAIL;
+  if (!apiKey) throw new AuthenticationError('SAAC_USER_API_KEY environment variable is required. Get your key at https://start-an-ai-company-3l1xzm.adam.startanaicompany.com');
+  if (!email) throw new AuthenticationError('SAAC_USER_EMAIL environment variable is required.');
+  return { apiKey, email };
+}
+
+async function request(method, path, body) {
+  const { apiKey, email } = getCredentials();
+
+  const headers = {
+    'Content-Type': 'application/json',
+    'Authorization': `Bearer ${apiKey}`,
+    'X-SAAC-Email': email
+  };
+
+  const opts = { method, headers };
+  if (body) opts.body = JSON.stringify(body);
+
+  const res = await fetch(`${BASE_URL}${path}`, opts);
+  const contentType = res.headers.get('content-type') || '';
+  let data;
+  if (contentType.includes('application/json')) {
+    data = await res.json();
+  } else {
+    const text = await res.text();
+    if (!res.ok) {
+      throw new SaacDnsError(
+        `Server error (HTTP ${res.status}): ${text.slice(0, 200)}`,
+        res.status
+      );
+    }
+    // Try to parse as JSON anyway
+    try {
+      data = JSON.parse(text);
+    } catch (_) {
+      throw new SaacDnsError(`Unexpected non-JSON response: ${text.slice(0, 200)}`, res.status);
+    }
+  }
+
+  if (!res.ok) {
+    const msg = data.error || `Request failed (${res.status})`;
+    const code = data.code;
+    switch (code || res.status) {
+      case 110: case 401: throw new AuthenticationError(msg);
+      case 200: case 404: throw new DomainNotFoundError(msg);
+      case 261: throw new DomainUnavailableError(msg);
+      case 108: case 400: throw new ValidationError(msg);
+      case 280: throw new InsufficientFundsError(msg);
+      default: throw new SaacDnsError(msg, code);
+    }
+  }
+
+  return data;
+}
+
+/**
+ * Auto-provision user on first call.
+ *
+ * Checks if the user already exists via GET /v1/users/me.
+ * If authentication fails (user not yet synced), calls POST /v1/auth/login
+ * which validates the us_ key against the SAAC platform and upserts the user.
+ *
+ * This means no manual registration is needed — the agent just sets
+ * SAAC_USER_API_KEY and SAAC_USER_EMAIL and everything is provisioned automatically.
+ */
+async function ensureRegistered() {
+  const { apiKey, email } = getCredentials();
+  try {
+    await request('GET', '/v1/users/me');
+  } catch (err) {
+    if (err.name === 'AuthenticationError') {
+      // User not synced yet — authenticate with SAAC platform to provision account
+      try {
+        await fetch(`${BASE_URL}/v1/auth/login`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ email, api_key: apiKey })
+        });
+      } catch (_) {
+        // Suppress errors; the caller's request() will surface the real issue
+      }
+    }
+  }
+}
+
+module.exports = {
+  request,
+  getCredentials,
+  ensureRegistered,
+  BASE_URL,
+  AuthenticationError,
+  DomainNotFoundError,
+  DomainUnavailableError,
+  ValidationError,
+  InsufficientFundsError,
+  SaacDnsError
+};