altalandi 0.4.0 → 0.5.0

package/client.mjs

@@ -1,208 +1,209 @@
-const DEFAULT_BASE_URL = "https://altalandi.is/api";
-const DEFAULT_TIMEOUT_MS = 300_000;
-const REQUEST_FIELDS = [
-  "sourceLang",
-  "domain",
-  "register",
-  "preserveMeaning",
-  "scoreNativeness",
-  "onlyImprove",
-  "polishPass",
-  "writer",
-  "scoring",
-  "glossary",
-  "returnDiffs",
-];
-
-export class AltalandiError extends Error {
-  constructor(message, { code = "ALTALANDI_ERROR", status } = {}) {
-    super(message);
-    this.name = "AltalandiError";
-    this.code = code;
-    if (Number.isInteger(status)) this.status = status;
-  }
-}
-
-export class MeaningVerificationError extends AltalandiError {
-  constructor(verdict) {
-    const changed = verdict === false;
-    super(
-      changed
-        ? "Altalandi could not preserve the input meaning."
-        : "Altalandi did not return a verified meaning verdict.",
-      { code: changed ? "MEANING_NOT_PRESERVED" : "MEANING_UNVERIFIED" },
-    );
-    this.name = "MeaningVerificationError";
-    this.verdict = verdict === false ? false : null;
-  }
-}
-
-function env(name) {
-  if (typeof process === "undefined" || !process.env) return undefined;
-  return process.env[name];
-}
-
-function cleanText(value, secret = "") {
-  if (typeof value !== "string") return "";
-  let cleaned = value.replace(/[\u0000-\u001f\u007f]+/g, " ").replace(/\s+/g, " ").trim();
-  if (secret) cleaned = cleaned.split(secret).join("[redacted]");
-  return cleaned.slice(0, 300);
-}
-
-function errorDetail(payload) {
-  const detail = payload?.detail;
-  if (typeof detail === "string") return detail;
-  if (Array.isArray(detail)) {
-    return detail
-      .map((entry) => (typeof entry?.msg === "string" ? entry.msg : ""))
-      .filter(Boolean)
-      .join("; ");
-  }
-  return "";
-}
-
-function requestBody(text, options) {
-  const body = { text };
-  for (const field of REQUEST_FIELDS) {
-    if (options[field] !== undefined) body[field] = options[field];
-  }
-  return body;
-}
-
-/**
- * Refine English or Icelandic text through the hosted Altalandi API.
- * Client settings (`apiKey`, `baseUrl`, `timeoutMs`, `fetch`) are never sent in
- * the JSON body. The full API result is returned without weakening its verdict.
- */
-export async function refine(text, options = {}) {
-  if (typeof text !== "string" || !text.trim()) {
-    throw new AltalandiError("Altalandi requires non-empty text.", { code: "INVALID_INPUT" });
-  }
-
-  const explicitKey = options.apiKey;
-  const selectedKey = explicitKey === undefined ? env("ALTALANDI_API_KEY") : explicitKey;
-  if (selectedKey !== undefined && typeof selectedKey !== "string") {
-    throw new AltalandiError("Altalandi apiKey must be a string.", { code: "INVALID_CONFIG" });
-  }
-  const apiKey = selectedKey?.trim();
-  if (!apiKey) {
-    throw new AltalandiError(
-      "No Altalandi API key. Set ALTALANDI_API_KEY or pass apiKey explicitly.",
-      { code: "MISSING_API_KEY" },
-    );
-  }
-
-  const selectedBaseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
-  if (typeof selectedBaseUrl !== "string") {
-    throw new AltalandiError("Altalandi baseUrl must be a string.", { code: "INVALID_CONFIG" });
-  }
-  const baseUrl = selectedBaseUrl.trim().replace(/\/+$/, "");
-  if (!baseUrl) {
-    throw new AltalandiError("Altalandi baseUrl must not be empty.", { code: "INVALID_CONFIG" });
-  }
-
-  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
-    throw new AltalandiError("Altalandi timeoutMs must be a positive number.", {
-      code: "INVALID_CONFIG",
-    });
-  }
-
-  const fetchImpl = options.fetch ?? globalThis.fetch;
-  if (typeof fetchImpl !== "function") {
-    throw new AltalandiError("This runtime does not provide fetch.", { code: "INVALID_CONFIG" });
-  }
-
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    let response;
-    try {
-      response = await fetchImpl(`${baseUrl}/v1/refine`, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-          authorization: `Bearer ${apiKey}`,
-        },
-        body: JSON.stringify(requestBody(text, options)),
-        signal: controller.signal,
-      });
-    } catch {
-      if (controller.signal.aborted) {
-        throw new AltalandiError(`Altalandi timed out after ${timeoutMs} ms.`, {
-          code: "TIMEOUT",
-        });
-      }
-      throw new AltalandiError("Altalandi could not reach the API.", { code: "NETWORK_ERROR" });
-    }
-
-    let raw = "";
-    try {
-      raw = await response.text();
-    } catch {
-      if (controller.signal.aborted) {
-        throw new AltalandiError(`Altalandi timed out after ${timeoutMs} ms.`, {
-          code: "TIMEOUT",
-        });
-      }
-      if (response.ok) {
-        throw new AltalandiError("Altalandi could not read the API response.", {
-          code: "INVALID_RESPONSE",
-          status: response.status,
-        });
-      }
-      // The HTTP status remains useful when an error response has no readable body.
-    }
-
-    let payload;
-    if (raw) {
-      try {
-        payload = JSON.parse(raw);
-      } catch {
-        if (response.ok) {
-          throw new AltalandiError("Altalandi returned an invalid JSON response.", {
-            code: "INVALID_RESPONSE",
-            status: response.status,
-          });
-        }
-      }
-    }
-
-    if (!response.ok) {
-      const status = Number.isInteger(response.status) ? response.status : 0;
-      const statusText = cleanText(response.statusText);
-      const detail = cleanText(errorDetail(payload), apiKey);
-      const suffix = detail || statusText;
-      throw new AltalandiError(
-        `Altalandi API request failed (${status || "unknown status"})${suffix ? `: ${suffix}` : "."}`,
-        { code: "API_ERROR", status },
-      );
-    }
-
-    if (!payload || typeof payload !== "object" || Array.isArray(payload) || typeof payload.output !== "string") {
-      throw new AltalandiError("Altalandi returned an invalid response shape.", {
-        code: "INVALID_RESPONSE",
-        status: response.status,
-      });
-    }
-
-    return payload;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-
-/** Assert that an existing result carries a completed, positive meaning check. */
-export function assertMeaningVerified(result) {
-  if (result?.meaningPreserved !== true) {
-    throw new MeaningVerificationError(result?.meaningPreserved);
-  }
-  return result;
-}
-
-/** Request meaning verification and reject unless the API returns strict true. */
-export async function refineVerified(text, options = {}) {
-  const result = await refine(text, { ...options, preserveMeaning: true });
-  assertMeaningVerified(result);
-  return result;
-}
+const DEFAULT_BASE_URL = "https://altalandi.is/api";
+const DEFAULT_TIMEOUT_MS = 300_000;
+const REQUEST_FIELDS = [
+  "sourceLang",
+  "domain",
+  "register",
+  "preserveMeaning",
+  "scoreNativeness",
+  "onlyImprove",
+  "polishPass",
+  "writer",
+  "scoring",
+  "glossary",
+  "returnDiffs",
+  "contribute",
+];
+
+export class AltalandiError extends Error {
+  constructor(message, { code = "ALTALANDI_ERROR", status } = {}) {
+    super(message);
+    this.name = "AltalandiError";
+    this.code = code;
+    if (Number.isInteger(status)) this.status = status;
+  }
+}
+
+export class MeaningVerificationError extends AltalandiError {
+  constructor(verdict) {
+    const changed = verdict === false;
+    super(
+      changed
+        ? "Altalandi could not preserve the input meaning."
+        : "Altalandi did not return a verified meaning verdict.",
+      { code: changed ? "MEANING_NOT_PRESERVED" : "MEANING_UNVERIFIED" },
+    );
+    this.name = "MeaningVerificationError";
+    this.verdict = verdict === false ? false : null;
+  }
+}
+
+function env(name) {
+  if (typeof process === "undefined" || !process.env) return undefined;
+  return process.env[name];
+}
+
+function cleanText(value, secret = "") {
+  if (typeof value !== "string") return "";
+  let cleaned = value.replace(/[\u0000-\u001f\u007f]+/g, " ").replace(/\s+/g, " ").trim();
+  if (secret) cleaned = cleaned.split(secret).join("[redacted]");
+  return cleaned.slice(0, 300);
+}
+
+function errorDetail(payload) {
+  const detail = payload?.detail;
+  if (typeof detail === "string") return detail;
+  if (Array.isArray(detail)) {
+    return detail
+      .map((entry) => (typeof entry?.msg === "string" ? entry.msg : ""))
+      .filter(Boolean)
+      .join("; ");
+  }
+  return "";
+}
+
+function requestBody(text, options) {
+  const body = { text };
+  for (const field of REQUEST_FIELDS) {
+    if (options[field] !== undefined) body[field] = options[field];
+  }
+  return body;
+}
+
+/**
+ * Refine English or Icelandic text through the hosted Altalandi API.
+ * Client settings (`apiKey`, `baseUrl`, `timeoutMs`, `fetch`) are never sent in
+ * the JSON body. The full API result is returned without weakening its verdict.
+ */
+export async function refine(text, options = {}) {
+  if (typeof text !== "string" || !text.trim()) {
+    throw new AltalandiError("Altalandi requires non-empty text.", { code: "INVALID_INPUT" });
+  }
+
+  const explicitKey = options.apiKey;
+  const selectedKey = explicitKey === undefined ? env("ALTALANDI_API_KEY") : explicitKey;
+  if (selectedKey !== undefined && typeof selectedKey !== "string") {
+    throw new AltalandiError("Altalandi apiKey must be a string.", { code: "INVALID_CONFIG" });
+  }
+  const apiKey = selectedKey?.trim();
+  if (!apiKey) {
+    throw new AltalandiError(
+      "No Altalandi API key. Set ALTALANDI_API_KEY or pass apiKey explicitly.",
+      { code: "MISSING_API_KEY" },
+    );
+  }
+
+  const selectedBaseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+  if (typeof selectedBaseUrl !== "string") {
+    throw new AltalandiError("Altalandi baseUrl must be a string.", { code: "INVALID_CONFIG" });
+  }
+  const baseUrl = selectedBaseUrl.trim().replace(/\/+$/, "");
+  if (!baseUrl) {
+    throw new AltalandiError("Altalandi baseUrl must not be empty.", { code: "INVALID_CONFIG" });
+  }
+
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new AltalandiError("Altalandi timeoutMs must be a positive number.", {
+      code: "INVALID_CONFIG",
+    });
+  }
+
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  if (typeof fetchImpl !== "function") {
+    throw new AltalandiError("This runtime does not provide fetch.", { code: "INVALID_CONFIG" });
+  }
+
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    let response;
+    try {
+      response = await fetchImpl(`${baseUrl}/v1/refine`, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(requestBody(text, options)),
+        signal: controller.signal,
+      });
+    } catch {
+      if (controller.signal.aborted) {
+        throw new AltalandiError(`Altalandi timed out after ${timeoutMs} ms.`, {
+          code: "TIMEOUT",
+        });
+      }
+      throw new AltalandiError("Altalandi could not reach the API.", { code: "NETWORK_ERROR" });
+    }
+
+    let raw = "";
+    try {
+      raw = await response.text();
+    } catch {
+      if (controller.signal.aborted) {
+        throw new AltalandiError(`Altalandi timed out after ${timeoutMs} ms.`, {
+          code: "TIMEOUT",
+        });
+      }
+      if (response.ok) {
+        throw new AltalandiError("Altalandi could not read the API response.", {
+          code: "INVALID_RESPONSE",
+          status: response.status,
+        });
+      }
+      // The HTTP status remains useful when an error response has no readable body.
+    }
+
+    let payload;
+    if (raw) {
+      try {
+        payload = JSON.parse(raw);
+      } catch {
+        if (response.ok) {
+          throw new AltalandiError("Altalandi returned an invalid JSON response.", {
+            code: "INVALID_RESPONSE",
+            status: response.status,
+          });
+        }
+      }
+    }
+
+    if (!response.ok) {
+      const status = Number.isInteger(response.status) ? response.status : 0;
+      const statusText = cleanText(response.statusText);
+      const detail = cleanText(errorDetail(payload), apiKey);
+      const suffix = detail || statusText;
+      throw new AltalandiError(
+        `Altalandi API request failed (${status || "unknown status"})${suffix ? `: ${suffix}` : "."}`,
+        { code: "API_ERROR", status },
+      );
+    }
+
+    if (!payload || typeof payload !== "object" || Array.isArray(payload) || typeof payload.output !== "string") {
+      throw new AltalandiError("Altalandi returned an invalid response shape.", {
+        code: "INVALID_RESPONSE",
+        status: response.status,
+      });
+    }
+
+    return payload;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+/** Assert that an existing result carries a completed, positive meaning check. */
+export function assertMeaningVerified(result) {
+  if (result?.meaningPreserved !== true) {
+    throw new MeaningVerificationError(result?.meaningPreserved);
+  }
+  return result;
+}
+
+/** Request meaning verification and reject unless the API returns strict true. */
+export async function refineVerified(text, options = {}) {
+  const result = await refine(text, { ...options, preserveMeaning: true });
+  assertMeaningVerified(result);
+  return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "altalandi",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Native-sounding Icelandic from your terminal or AI agent: one-time login, a Claude Code skill, and meaning verification.",
   "type": "module",
   "main": "./client.mjs",
@@ -27,7 +27,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test test/cli.test.mjs test/client.test.mjs test/update.test.mjs test/auth.test.mjs"
+    "test": "node --test test/cli.test.mjs test/client.test.mjs test/update.test.mjs test/auth.test.mjs test/report.test.mjs"
   },
   "keywords": [
     "icelandic",