altalandi 0.4.0 → 0.5.0

package/client.d.ts

@@ -1,113 +1,117 @@
-export type SourceLang = "auto" | "en" | "is";
-export type Domain = "general" | "marketing" | "data-analysis" | "childrens-fiction";
-export type Register = "formal" | "neutral" | "warm";
-export type WriterTier = "standard" | "max";
-export type ScoringTier = "none" | "fast" | "rigorous";
-
-export interface GlossaryTerm {
-  en: string;
-  is: string;
-  note?: string;
-}
-
-export interface FetchResponseLike {
-  ok: boolean;
-  status: number;
-  statusText?: string;
-  text(): Promise<string>;
-}
-
-export type FetchLike = (
-  url: string,
-  init: {
-    method: string;
-    headers: Record<string, string>;
-    body: string;
-    signal: any;
-  },
-) => Promise<FetchResponseLike>;
-
-export interface RefineOptions {
-  sourceLang?: SourceLang;
-  domain?: Domain;
-  register?: Register;
-  preserveMeaning?: boolean;
-  scoreNativeness?: boolean;
-  /** IS-refine: keep the original unless improvement is verified. */
-  onlyImprove?: boolean;
-  /** Optional EN→IS monolingual polish pass; false by default. */
-  polishPass?: boolean;
-  writer?: WriterTier;
-  scoring?: ScoringTier;
-  glossary?: GlossaryTerm[];
-  returnDiffs?: boolean;
-  /** Defaults to ALTALANDI_API_KEY. Never put a key in source control. */
-  apiKey?: string;
-  /** Defaults to https://altalandi.is/api. */
-  baseUrl?: string;
-  /** Per-request timeout in milliseconds; defaults to 300000. */
-  timeoutMs?: number;
-  /** Optional fetch-compatible implementation, useful for controlled runtimes and tests. */
-  fetch?: FetchLike;
-}
-
-export interface RefineDiff {
-  before: string;
-  after: string;
-  layer: "L1" | "L2" | "L3";
-  reason: string;
-}
-
-export interface RefineQuality {
-  nativenessScore: number | null;
-  translationeseTells: string[];
-  iceBertScore: number | null;
-  morphologyOk: boolean | null;
-  calqueFlags: string[];
-  englishRemnants: string[];
-  encodingArtifacts: string[];
-}
-
-export interface RefineResult {
-  id: string;
-  output: string;
-  sourceLang: "en" | "is";
-  diffs: RefineDiff[];
-  quality: RefineQuality;
-  /** Only strict true is a completed verification; null means skipped/unavailable. */
-  meaningPreserved: boolean | null;
-  meaningNotes: string;
-  modelUsed: string;
-  tier?: { writer: WriterTier; scoring: ScoringTier };
-  billedTier?: { writer: WriterTier; scoring: ScoringTier };
-  warnings: string[];
-}
-
-export type VerifiedRefineResult = RefineResult & { meaningPreserved: true };
-
-export interface AltalandiErrorOptions {
-  code?: string;
-  status?: number;
-}
-
-export class AltalandiError extends Error {
-  readonly code: string;
-  readonly status?: number;
-  constructor(message: string, options?: AltalandiErrorOptions);
-}
-
-export class MeaningVerificationError extends AltalandiError {
-  readonly verdict: false | null;
-  constructor(verdict: boolean | null | undefined);
-}
-
-/** Refine text and return the full hosted API response. */
-export function refine(text: string, options?: RefineOptions): Promise<RefineResult>;
-
-/** Refine text and throw unless meaningPreserved is strict true. */
-export function refineVerified(text: string, options?: RefineOptions): Promise<VerifiedRefineResult>;
-
-/** Narrow an existing result to one with a verified meaning verdict. */
-export function assertMeaningVerified(
-  result: RefineResult,
-): asserts result is VerifiedRefineResult;
+export type SourceLang = "auto" | "en" | "is";
+export type Domain = "general" | "marketing" | "data-analysis" | "childrens-fiction";
+export type Register = "formal" | "neutral" | "warm";
+export type WriterTier = "standard" | "max";
+export type ScoringTier = "none" | "fast" | "rigorous";
+
+export interface GlossaryTerm {
+  en: string;
+  is: string;
+  note?: string;
+}
+
+export interface FetchResponseLike {
+  ok: boolean;
+  status: number;
+  statusText?: string;
+  text(): Promise<string>;
+}
+
+export type FetchLike = (
+  url: string,
+  init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+    signal: any;
+  },
+) => Promise<FetchResponseLike>;
+
+export interface RefineOptions {
+  sourceLang?: SourceLang;
+  domain?: Domain;
+  register?: Register;
+  preserveMeaning?: boolean;
+  scoreNativeness?: boolean;
+  /** IS-refine: keep the original unless improvement is verified. */
+  onlyImprove?: boolean;
+  /** Optional EN→IS monolingual polish pass; false by default. */
+  polishPass?: boolean;
+  writer?: WriterTier;
+  scoring?: ScoringTier;
+  glossary?: GlossaryTerm[];
+  returnDiffs?: boolean;
+  /** Let Altalandi keep this text and its output to improve the service. Only with the person's consent; default false. */
+  contribute?: boolean;
+  /** Defaults to ALTALANDI_API_KEY. Never put a key in source control. */
+  apiKey?: string;
+  /** Defaults to https://altalandi.is/api. */
+  baseUrl?: string;
+  /** Per-request timeout in milliseconds; defaults to 300000. */
+  timeoutMs?: number;
+  /** Optional fetch-compatible implementation, useful for controlled runtimes and tests. */
+  fetch?: FetchLike;
+}
+
+export interface RefineDiff {
+  before: string;
+  after: string;
+  layer: "L1" | "L2" | "L3";
+  reason: string;
+}
+
+export interface RefineQuality {
+  nativenessScore: number | null;
+  translationeseTells: string[];
+  iceBertScore: number | null;
+  morphologyOk: boolean | null;
+  calqueFlags: string[];
+  englishRemnants: string[];
+  encodingArtifacts: string[];
+}
+
+export interface RefineResult {
+  id: string;
+  output: string;
+  sourceLang: "en" | "is";
+  diffs: RefineDiff[];
+  quality: RefineQuality;
+  /** Only strict true is a completed verification; null means skipped/unavailable. */
+  meaningPreserved: boolean | null;
+  meaningNotes: string;
+  modelUsed: string;
+  tier?: { writer: WriterTier; scoring: ScoringTier };
+  billedTier?: { writer: WriterTier; scoring: ScoringTier };
+  warnings: string[];
+  /** true when a test key made the call: no model ran, nothing was charged, output = input. */
+  test?: boolean | null;
+}
+
+export type VerifiedRefineResult = RefineResult & { meaningPreserved: true };
+
+export interface AltalandiErrorOptions {
+  code?: string;
+  status?: number;
+}
+
+export class AltalandiError extends Error {
+  readonly code: string;
+  readonly status?: number;
+  constructor(message: string, options?: AltalandiErrorOptions);
+}
+
+export class MeaningVerificationError extends AltalandiError {
+  readonly verdict: false | null;
+  constructor(verdict: boolean | null | undefined);
+}
+
+/** Refine text and return the full hosted API response. */
+export function refine(text: string, options?: RefineOptions): Promise<RefineResult>;
+
+/** Refine text and throw unless meaningPreserved is strict true. */
+export function refineVerified(text: string, options?: RefineOptions): Promise<VerifiedRefineResult>;
+
+/** Narrow an existing result to one with a verified meaning verdict. */
+export function assertMeaningVerified(
+  result: RefineResult,
+): asserts result is VerifiedRefineResult;