gengo-ts 1.0.0

package/dist/index.js

@@ -0,0 +1,469 @@
+// src/core/auth.ts
+var encoder = new TextEncoder();
+async function generateSignature(privateKey, timestamp) {
+  const keyData = encoder.encode(privateKey);
+  const messageData = encoder.encode(timestamp);
+  const cryptoKey = await crypto.subtle.importKey(
+    "raw",
+    keyData,
+    { name: "HMAC", hash: "SHA-1" },
+    false,
+    ["sign"]
+  );
+  const signature = await crypto.subtle.sign("HMAC", cryptoKey, messageData);
+  return arrayBufferToHex(signature);
+}
+function arrayBufferToHex(buffer) {
+  const bytes = new Uint8Array(buffer);
+  let hex = "";
+  for (let i = 0; i < bytes.length; i++) {
+    hex += bytes[i].toString(16).padStart(2, "0");
+  }
+  return hex;
+}
+function getTimestamp() {
+  return Math.floor(Date.now() / 1e3).toString();
+}
+async function generateAuthParams(publicKey, privateKey) {
+  const ts = getTimestamp();
+  const api_sig = await generateSignature(privateKey, ts);
+  return {
+    api_key: publicKey,
+    ts,
+    api_sig
+  };
+}
+
+// src/core/errors.ts
+var GengoError = class extends Error {
+  code;
+  constructor(message, code = 0) {
+    super(message);
+    this.name = "GengoError";
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var GengoAuthError = class extends GengoError {
+  constructor(message, code = 1e3) {
+    super(message, code);
+    this.name = "GengoAuthError";
+  }
+};
+var GengoValidationError = class extends GengoError {
+  constructor(message, code = 0) {
+    super(message, code);
+    this.name = "GengoValidationError";
+  }
+};
+var GengoNotFoundError = class extends GengoError {
+  constructor(message, code = 0) {
+    super(message, code);
+    this.name = "GengoNotFoundError";
+  }
+};
+var GengoRateLimitError = class extends GengoError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429);
+    this.name = "GengoRateLimitError";
+  }
+};
+var GengoInsufficientCreditsError = class extends GengoError {
+  constructor(message = "Not enough credits - please top up") {
+    super(message, 2700);
+    this.name = "GengoInsufficientCreditsError";
+  }
+};
+var GengoNetworkError = class extends GengoError {
+  constructor(message, cause) {
+    super(message, 0);
+    this.name = "GengoNetworkError";
+    if (cause) {
+      this.cause = cause;
+    }
+  }
+};
+var GengoJobStateError = class extends GengoError {
+  constructor(message, code = 0) {
+    super(message, code);
+    this.name = "GengoJobStateError";
+  }
+};
+var AUTH_ERROR_CODES = [1e3, 1100, 1150];
+var NOT_FOUND_CODES = [2100, 2200, 2600, 2750];
+var JOB_STATE_CODES = [2250, 2251, 2252, 2650];
+var INSUFFICIENT_CREDITS_CODE = 2700;
+function createErrorFromCode(code, message) {
+  if (AUTH_ERROR_CODES.includes(code)) {
+    return new GengoAuthError(message, code);
+  }
+  if (NOT_FOUND_CODES.includes(code)) {
+    return new GengoNotFoundError(message, code);
+  }
+  if (JOB_STATE_CODES.includes(code)) {
+    return new GengoJobStateError(message, code);
+  }
+  if (code === INSUFFICIENT_CREDITS_CODE) {
+    return new GengoInsufficientCreditsError(message);
+  }
+  if (code >= 1200 && code <= 1951) {
+    return new GengoValidationError(message, code);
+  }
+  return new GengoError(message, code);
+}
+
+// src/core/http.ts
+var BASE_URLS = {
+  production: "https://api.gengo.com/v2",
+  sandbox: "https://api.sandbox.gengo.com/v2"
+};
+var HttpClient = class {
+  publicKey;
+  privateKey;
+  baseUrl;
+  timeout;
+  constructor(config) {
+    this.publicKey = config.publicKey;
+    this.privateKey = config.privateKey;
+    this.baseUrl = config.sandbox ? BASE_URLS.sandbox : BASE_URLS.production;
+    this.timeout = config.timeout ?? 3e4;
+  }
+  /**
+   * Makes an authenticated GET request
+   */
+  async get(path, params) {
+    return this.request({ method: "GET", path, params });
+  }
+  /**
+   * Makes an authenticated POST request
+   */
+  async post(path, data) {
+    return this.request({ method: "POST", path, data });
+  }
+  /**
+   * Makes an authenticated PUT request
+   */
+  async put(path, data) {
+    return this.request({ method: "PUT", path, data });
+  }
+  /**
+   * Makes an authenticated DELETE request
+   */
+  async delete(path) {
+    return this.request({ method: "DELETE", path });
+  }
+  /**
+   * Core request method that handles authentication, serialization, and error handling
+   */
+  async request(options) {
+    const { method, path, params, data } = options;
+    const authParams = await generateAuthParams(this.publicKey, this.privateKey);
+    let url = `${this.baseUrl}${path}`;
+    let body;
+    const headers = {
+      Accept: "application/json"
+    };
+    if (method === "GET" || method === "DELETE") {
+      const queryParams = new URLSearchParams();
+      queryParams.set("api_key", authParams.api_key);
+      queryParams.set("ts", authParams.ts);
+      queryParams.set("api_sig", authParams.api_sig);
+      if (params) {
+        for (const [key, value] of Object.entries(params)) {
+          if (value !== void 0) {
+            queryParams.set(key, String(value));
+          }
+        }
+      }
+      url = `${url}?${queryParams.toString()}`;
+    } else {
+      headers["Content-Type"] = "application/x-www-form-urlencoded";
+      const formData = new URLSearchParams();
+      formData.set("api_key", authParams.api_key);
+      formData.set("ts", authParams.ts);
+      formData.set("api_sig", authParams.api_sig);
+      if (data) {
+        formData.set("data", JSON.stringify(data));
+      }
+      body = formData.toString();
+    }
+    let response;
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+      response = await fetch(url, {
+        method,
+        headers,
+        body,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new GengoNetworkError("Request timeout", error);
+        }
+        throw new GengoNetworkError(`Network error: ${error.message}`, error);
+      }
+      throw new GengoNetworkError("Unknown network error");
+    }
+    if (response.status === 429) {
+      throw new GengoRateLimitError();
+    }
+    let json;
+    try {
+      json = await response.json();
+    } catch {
+      throw new GengoError(
+        `Invalid JSON response (HTTP ${response.status})`,
+        response.status
+      );
+    }
+    if (json.opstat === "error" && json.err) {
+      throw createErrorFromCode(json.err.code, json.err.msg);
+    }
+    if (json.opstat !== "ok") {
+      throw new GengoError("Unknown API error", 0);
+    }
+    return json.response;
+  }
+};
+
+// src/resources/account.ts
+var AccountResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Retrieves account statistics such as orders made and credits spent
+   */
+  async getStats() {
+    return this.http.get("/account/stats");
+  }
+  /**
+   * Retrieves account information such as email and display name
+   */
+  async getMe() {
+    return this.http.get("/account/me");
+  }
+  /**
+   * Retrieves account balance in credits
+   */
+  async getBalance() {
+    return this.http.get("/account/balance");
+  }
+  /**
+   * Retrieves list of preferred translators set by user
+   */
+  async getPreferredTranslators() {
+    return this.http.get("/account/preferred_translators");
+  }
+};
+
+// src/resources/jobs.ts
+var JobsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Submits a job or group of jobs for translation
+   * @param jobs - Record of job keys to job inputs, or a JobsPayload with optional order comment
+   */
+  async create(jobs) {
+    const payload = "jobs" in jobs && !("body_src" in jobs) ? jobs : { jobs };
+    return this.http.post("/translate/jobs", payload);
+  }
+  /**
+   * Retrieves a list of recent jobs filtered by parameters
+   */
+  async list(options) {
+    return this.http.get("/translate/jobs", options);
+  }
+  /**
+   * Retrieves a specific job by ID
+   */
+  async get(id) {
+    return this.http.get(`/translate/job/${id}`);
+  }
+  /**
+   * Retrieves multiple jobs by their IDs
+   * @param ids - Array of job IDs or comma-separated string
+   */
+  async getMany(ids) {
+    const idString = Array.isArray(ids) ? ids.join(",") : ids;
+    return this.http.get(`/translate/jobs/${idString}`);
+  }
+  /**
+   * Updates a job (approve, revise, reject, or archive)
+   */
+  async update(id, action) {
+    await this.http.put(`/translate/job/${id}`, action);
+  }
+  /**
+   * Updates multiple jobs with the same action
+   */
+  async updateMany(action) {
+    await this.http.put("/translate/jobs", action);
+  }
+  /**
+   * Cancels a job (only if not yet started by translator)
+   */
+  async cancel(id) {
+    await this.http.delete(`/translate/job/${id}`);
+  }
+  /**
+   * Gets list of revisions for a job
+   */
+  async getRevisions(id) {
+    return this.http.get(
+      `/translate/job/${id}/revisions`
+    );
+  }
+  /**
+   * Gets a specific revision for a job
+   */
+  async getRevision(id, revisionId) {
+    return this.http.get(
+      `/translate/job/${id}/revision/${revisionId}`
+    );
+  }
+  /**
+   * Retrieves feedback submitted for a job
+   */
+  async getFeedback(id) {
+    return this.http.get(`/translate/job/${id}/feedback`);
+  }
+  /**
+   * Retrieves the comment thread for a job
+   */
+  async getComments(id) {
+    return this.http.get(`/translate/job/${id}/comments`);
+  }
+  /**
+   * Submits a new comment to the job's comment thread
+   */
+  async addComment(id, body) {
+    await this.http.post(`/translate/job/${id}/comment`, { body });
+  }
+};
+
+// src/resources/orders.ts
+var OrdersResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Retrieves an order by ID with job status breakdown
+   */
+  async get(id) {
+    return this.http.get(`/translate/order/${id}`);
+  }
+  /**
+   * Cancels all available jobs in an order
+   * Note: This will not cancel jobs that are already in progress
+   */
+  async cancel(id) {
+    return this.http.delete(`/translate/order/${id}`);
+  }
+  /**
+   * Retrieves the comment thread for an order
+   */
+  async getComments(id) {
+    return this.http.get(`/translate/order/${id}/comments`);
+  }
+  /**
+   * Submits a new comment to the order's comment thread
+   */
+  async addComment(id, body) {
+    await this.http.post(`/translate/order/${id}/comment`, { body });
+  }
+};
+
+// src/resources/glossary.ts
+var GlossaryResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Retrieves all glossaries belonging to the authenticated user
+   */
+  async list() {
+    return this.http.get("/translate/glossary");
+  }
+  /**
+   * Retrieves a specific glossary by ID
+   */
+  async get(id) {
+    return this.http.get(`/translate/glossary/${id}`);
+  }
+};
+
+// src/resources/service.ts
+var ServiceResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Returns a list of supported languages and their language codes
+   */
+  async getLanguages() {
+    return this.http.get("/translate/service/languages");
+  }
+  /**
+   * Returns supported translation language pairs with pricing
+   * @param lcSrc - Optional source language code to filter pairs
+   */
+  async getLanguagePairs(lcSrc) {
+    return this.http.get("/translate/service/language_pairs", {
+      lc_src: lcSrc
+    });
+  }
+  /**
+   * Returns credit quote and unit count for text jobs
+   */
+  async getQuote(jobs) {
+    return this.http.post("/translate/service/quote", { jobs });
+  }
+  /**
+   * Uploads files and returns quotes with identifiers for ordering
+   * Note: File upload requires multipart/form-data which is not yet implemented.
+   * Use the Gengo dashboard for file jobs, or implement custom file upload logic.
+   */
+  async getFileQuote(_jobs) {
+    throw new Error(
+      "File quote upload is not yet implemented. Use text jobs or the Gengo dashboard."
+    );
+  }
+};
+
+// src/client.ts
+var GengoClient = class {
+  http;
+  /** Account information and statistics */
+  account;
+  /** Translation jobs management */
+  jobs;
+  /** Translation orders management */
+  orders;
+  /** Glossary management */
+  glossary;
+  /** Language and pricing services */
+  service;
+  constructor(config) {
+    this.http = new HttpClient({
+      publicKey: config.publicKey,
+      privateKey: config.privateKey,
+      sandbox: config.sandbox ?? false,
+      timeout: config.timeout
+    });
+    this.account = new AccountResource(this.http);
+    this.jobs = new JobsResource(this.http);
+    this.orders = new OrdersResource(this.http);
+    this.glossary = new GlossaryResource(this.http);
+    this.service = new ServiceResource(this.http);
+  }
+};
+
+export { GengoAuthError, GengoClient, GengoError, GengoInsufficientCreditsError, GengoJobStateError, GengoNetworkError, GengoNotFoundError, GengoRateLimitError, GengoValidationError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/auth.ts","../src/core/errors.ts","../src/core/http.ts","../src/resources/account.ts","../src/resources/jobs.ts","../src/resources/orders.ts","../src/resources/glossary.ts","../src/resources/service.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * HMAC-SHA1 signature generation for Gengo API authentication\n * Uses Web Crypto API for cross-runtime compatibility (Node.js 18+, Deno, Bun)\n */\n\nconst encoder = new TextEncoder();\n\n/**\n * Generates HMAC-SHA1 signature of the timestamp using the private key\n */\nexport async function generateSignature(\n  privateKey: string,\n  timestamp: string\n): Promise<string> {\n  const keyData = encoder.encode(privateKey);\n  const messageData = encoder.encode(timestamp);\n\n  const cryptoKey = await crypto.subtle.importKey(\n    'raw',\n    keyData,\n    { name: 'HMAC', hash: 'SHA-1' },\n    false,\n    ['sign']\n  );\n\n  const signature = await crypto.subtle.sign('HMAC', cryptoKey, messageData);\n\n  return arrayBufferToHex(signature);\n}\n\n/**\n * Converts an ArrayBuffer to a hexadecimal string\n */\nfunction arrayBufferToHex(buffer: ArrayBuffer): string {\n  const bytes = new Uint8Array(buffer);\n  let hex = '';\n  for (let i = 0; i < bytes.length; i++) {\n    hex += bytes[i]!.toString(16).padStart(2, '0');\n  }\n  return hex;\n}\n\n/**\n * Gets the current Unix timestamp as a string\n */\nexport function getTimestamp(): string {\n  return Math.floor(Date.now() / 1000).toString();\n}\n\n/**\n * Authentication parameters required for every API call\n */\nexport interface AuthParams {\n  api_key: string;\n  ts: string;\n  api_sig: string;\n}\n\n/**\n * Generates the authentication parameters for an API call\n */\nexport async function generateAuthParams(\n  publicKey: string,\n  privateKey: string\n): Promise<AuthParams> {\n  const ts = getTimestamp();\n  const api_sig = await generateSignature(privateKey, ts);\n\n  return {\n    api_key: publicKey,\n    ts,\n    api_sig,\n  };\n}\n","/**\n * Base error class for all Gengo API errors\n */\nexport class GengoError extends Error {\n  readonly code: number;\n\n  constructor(message: string, code: number = 0) {\n    super(message);\n    this.name = 'GengoError';\n    this.code = code;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Authentication failed (invalid API keys, missing signature, etc.)\n * Error codes: 1000, 1100, 1150\n */\nexport class GengoAuthError extends GengoError {\n  constructor(message: string, code: number = 1000) {\n    super(message, code);\n    this.name = 'GengoAuthError';\n  }\n}\n\n/**\n * Validation errors for request parameters\n * Error codes: 1200-1951\n */\nexport class GengoValidationError extends GengoError {\n  constructor(message: string, code: number = 0) {\n    super(message, code);\n    this.name = 'GengoValidationError';\n  }\n}\n\n/**\n * Resource not found or unauthorized access\n * Error codes: 2100, 2200, 2600, 2750\n */\nexport class GengoNotFoundError extends GengoError {\n  constructor(message: string, code: number = 0) {\n    super(message, code);\n    this.name = 'GengoNotFoundError';\n  }\n}\n\n/**\n * Rate limit exceeded\n * HTTP status: 429\n */\nexport class GengoRateLimitError extends GengoError {\n  constructor(message: string = 'Rate limit exceeded') {\n    super(message, 429);\n    this.name = 'GengoRateLimitError';\n  }\n}\n\n/**\n * Insufficient credits in account\n * Error code: 2700\n */\nexport class GengoInsufficientCreditsError extends GengoError {\n  constructor(message: string = 'Not enough credits - please top up') {\n    super(message, 2700);\n    this.name = 'GengoInsufficientCreditsError';\n  }\n}\n\n/**\n * Network or connection errors\n */\nexport class GengoNetworkError extends GengoError {\n  constructor(message: string, cause?: Error) {\n    super(message, 0);\n    this.name = 'GengoNetworkError';\n    if (cause) {\n      this.cause = cause;\n    }\n  }\n}\n\n/**\n * Job is not in the correct state for the requested action\n * Error codes: 2250, 2251, 2252, 2650\n */\nexport class GengoJobStateError extends GengoError {\n  constructor(message: string, code: number = 0) {\n    super(message, code);\n    this.name = 'GengoJobStateError';\n  }\n}\n\n// Error code ranges for classification\nconst AUTH_ERROR_CODES = [1000, 1100, 1150];\nconst NOT_FOUND_CODES = [2100, 2200, 2600, 2750];\nconst JOB_STATE_CODES = [2250, 2251, 2252, 2650];\nconst INSUFFICIENT_CREDITS_CODE = 2700;\n\n/**\n * Creates the appropriate error type based on the API error code\n */\nexport function createErrorFromCode(code: number, message: string): GengoError {\n  if (AUTH_ERROR_CODES.includes(code)) {\n    return new GengoAuthError(message, code);\n  }\n\n  if (NOT_FOUND_CODES.includes(code)) {\n    return new GengoNotFoundError(message, code);\n  }\n\n  if (JOB_STATE_CODES.includes(code)) {\n    return new GengoJobStateError(message, code);\n  }\n\n  if (code === INSUFFICIENT_CREDITS_CODE) {\n    return new GengoInsufficientCreditsError(message);\n  }\n\n  // Validation errors are in the 1200-1951 range\n  if (code >= 1200 && code <= 1951) {\n    return new GengoValidationError(message, code);\n  }\n\n  // Default to base GengoError\n  return new GengoError(message, code);\n}\n","import { generateAuthParams } from './auth.js';\nimport {\n  GengoError,\n  GengoNetworkError,\n  GengoRateLimitError,\n  createErrorFromCode,\n} from './errors.js';\n\n/**\n * Base URLs for Gengo API\n */\nconst BASE_URLS = {\n  production: 'https://api.gengo.com/v2',\n  sandbox: 'https://api.sandbox.gengo.com/v2',\n} as const;\n\n/**\n * API response wrapper\n */\ninterface ApiResponse<T> {\n  opstat: 'ok' | 'error';\n  response?: T;\n  err?: {\n    code: number;\n    msg: string;\n  };\n}\n\n/**\n * HTTP client configuration\n */\nexport interface HttpClientConfig {\n  publicKey: string;\n  privateKey: string;\n  sandbox?: boolean;\n  timeout?: number;\n}\n\n/**\n * Request options for API calls\n */\ninterface RequestOptions {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n  path: string;\n  params?: object;\n  data?: object;\n}\n\n/**\n * HTTP client for making authenticated requests to the Gengo API\n */\nexport class HttpClient {\n  private readonly publicKey: string;\n  private readonly privateKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(config: HttpClientConfig) {\n    this.publicKey = config.publicKey;\n    this.privateKey = config.privateKey;\n    this.baseUrl = config.sandbox ? BASE_URLS.sandbox : BASE_URLS.production;\n    this.timeout = config.timeout ?? 30000;\n  }\n\n  /**\n   * Makes an authenticated GET request\n   */\n  async get<T>(path: string, params?: object): Promise<T> {\n    return this.request<T>({ method: 'GET', path, params });\n  }\n\n  /**\n   * Makes an authenticated POST request\n   */\n  async post<T>(path: string, data?: object): Promise<T> {\n    return this.request<T>({ method: 'POST', path, data });\n  }\n\n  /**\n   * Makes an authenticated PUT request\n   */\n  async put<T>(path: string, data?: object): Promise<T> {\n    return this.request<T>({ method: 'PUT', path, data });\n  }\n\n  /**\n   * Makes an authenticated DELETE request\n   */\n  async delete<T>(path: string): Promise<T> {\n    return this.request<T>({ method: 'DELETE', path });\n  }\n\n  /**\n   * Core request method that handles authentication, serialization, and error handling\n   */\n  private async request<T>(options: RequestOptions): Promise<T> {\n    const { method, path, params, data } = options;\n    const authParams = await generateAuthParams(this.publicKey, this.privateKey);\n\n    let url = `${this.baseUrl}${path}`;\n    let body: string | undefined;\n    const headers: Record<string, string> = {\n      Accept: 'application/json',\n    };\n\n    if (method === 'GET' || method === 'DELETE') {\n      // For GET/DELETE, all params go in the query string\n      const queryParams = new URLSearchParams();\n      queryParams.set('api_key', authParams.api_key);\n      queryParams.set('ts', authParams.ts);\n      queryParams.set('api_sig', authParams.api_sig);\n\n      if (params) {\n        for (const [key, value] of Object.entries(params)) {\n          if (value !== undefined) {\n            queryParams.set(key, String(value));\n          }\n        }\n      }\n\n      url = `${url}?${queryParams.toString()}`;\n    } else {\n      // For POST/PUT, send as form data\n      headers['Content-Type'] = 'application/x-www-form-urlencoded';\n\n      const formData = new URLSearchParams();\n      formData.set('api_key', authParams.api_key);\n      formData.set('ts', authParams.ts);\n      formData.set('api_sig', authParams.api_sig);\n\n      if (data) {\n        // The Gengo API expects a 'data' field with JSON-stringified content\n        formData.set('data', JSON.stringify(data));\n      }\n\n      body = formData.toString();\n    }\n\n    let response: Response;\n\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n      response = await fetch(url, {\n        method,\n        headers,\n        body,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          throw new GengoNetworkError('Request timeout', error);\n        }\n        throw new GengoNetworkError(`Network error: ${error.message}`, error);\n      }\n      throw new GengoNetworkError('Unknown network error');\n    }\n\n    // Handle rate limiting\n    if (response.status === 429) {\n      throw new GengoRateLimitError();\n    }\n\n    // Parse JSON response\n    let json: ApiResponse<T>;\n\n    try {\n      json = (await response.json()) as ApiResponse<T>;\n    } catch {\n      throw new GengoError(\n        `Invalid JSON response (HTTP ${response.status})`,\n        response.status\n      );\n    }\n\n    // Check for API errors\n    if (json.opstat === 'error' && json.err) {\n      throw createErrorFromCode(json.err.code, json.err.msg);\n    }\n\n    if (json.opstat !== 'ok') {\n      throw new GengoError('Unknown API error', 0);\n    }\n\n    return json.response as T;\n  }\n}\n","import type { HttpClient } from '../core/http.js';\nimport type {\n  AccountStats,\n  AccountMe,\n  AccountBalance,\n  PreferredTranslatorGroup,\n} from '../types/index.js';\n\n/**\n * Account resource for managing account information\n */\nexport class AccountResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Retrieves account statistics such as orders made and credits spent\n   */\n  async getStats(): Promise<AccountStats> {\n    return this.http.get<AccountStats>('/account/stats');\n  }\n\n  /**\n   * Retrieves account information such as email and display name\n   */\n  async getMe(): Promise<AccountMe> {\n    return this.http.get<AccountMe>('/account/me');\n  }\n\n  /**\n   * Retrieves account balance in credits\n   */\n  async getBalance(): Promise<AccountBalance> {\n    return this.http.get<AccountBalance>('/account/balance');\n  }\n\n  /**\n   * Retrieves list of preferred translators set by user\n   */\n  async getPreferredTranslators(): Promise<PreferredTranslatorGroup[]> {\n    return this.http.get<PreferredTranslatorGroup[]>('/account/preferred_translators');\n  }\n}\n","import type { HttpClient } from '../core/http.js';\nimport type {\n  Job,\n  JobInput,\n  JobSummary,\n  JobAction,\n  BulkJobAction,\n  ListJobsOptions,\n  CreateJobsResponse,\n  Revision,\n  RevisionDetail,\n  Feedback,\n  Comment,\n} from '../types/index.js';\n\n/**\n * Jobs payload for submission\n */\ninterface JobsPayload {\n  jobs: Record<string, JobInput>;\n  comment?: string;\n}\n\n/**\n * Jobs resource for managing translation jobs\n */\nexport class JobsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Submits a job or group of jobs for translation\n   * @param jobs - Record of job keys to job inputs, or a JobsPayload with optional order comment\n   */\n  async create(jobs: Record<string, JobInput> | JobsPayload): Promise<CreateJobsResponse> {\n    const payload = 'jobs' in jobs && !('body_src' in jobs)\n      ? jobs as JobsPayload\n      : { jobs: jobs as Record<string, JobInput> };\n    return this.http.post<CreateJobsResponse>('/translate/jobs', payload);\n  }\n\n  /**\n   * Retrieves a list of recent jobs filtered by parameters\n   */\n  async list(options?: ListJobsOptions): Promise<JobSummary[]> {\n    return this.http.get<JobSummary[]>('/translate/jobs', options);\n  }\n\n  /**\n   * Retrieves a specific job by ID\n   */\n  async get(id: number | string): Promise<{ job: Job }> {\n    return this.http.get<{ job: Job }>(`/translate/job/${id}`);\n  }\n\n  /**\n   * Retrieves multiple jobs by their IDs\n   * @param ids - Array of job IDs or comma-separated string\n   */\n  async getMany(ids: (number | string)[] | string): Promise<{ jobs: Job[] }> {\n    const idString = Array.isArray(ids) ? ids.join(',') : ids;\n    return this.http.get<{ jobs: Job[] }>(`/translate/jobs/${idString}`);\n  }\n\n  /**\n   * Updates a job (approve, revise, reject, or archive)\n   */\n  async update(id: number | string, action: JobAction): Promise<void> {\n    await this.http.put<Record<string, never>>(`/translate/job/${id}`, action);\n  }\n\n  /**\n   * Updates multiple jobs with the same action\n   */\n  async updateMany(action: BulkJobAction): Promise<void> {\n    await this.http.put<Record<string, never>>('/translate/jobs', action);\n  }\n\n  /**\n   * Cancels a job (only if not yet started by translator)\n   */\n  async cancel(id: number | string): Promise<void> {\n    await this.http.delete<Record<string, never>>(`/translate/job/${id}`);\n  }\n\n  /**\n   * Gets list of revisions for a job\n   */\n  async getRevisions(id: number | string): Promise<{ job_id: number; revisions: Revision[] }> {\n    return this.http.get<{ job_id: number; revisions: Revision[] }>(\n      `/translate/job/${id}/revisions`\n    );\n  }\n\n  /**\n   * Gets a specific revision for a job\n   */\n  async getRevision(\n    id: number | string,\n    revisionId: number | string\n  ): Promise<{ revision: RevisionDetail }> {\n    return this.http.get<{ revision: RevisionDetail }>(\n      `/translate/job/${id}/revision/${revisionId}`\n    );\n  }\n\n  /**\n   * Retrieves feedback submitted for a job\n   */\n  async getFeedback(id: number | string): Promise<{ feedback: Feedback }> {\n    return this.http.get<{ feedback: Feedback }>(`/translate/job/${id}/feedback`);\n  }\n\n  /**\n   * Retrieves the comment thread for a job\n   */\n  async getComments(id: number | string): Promise<{ thread: Comment[] }> {\n    return this.http.get<{ thread: Comment[] }>(`/translate/job/${id}/comments`);\n  }\n\n  /**\n   * Submits a new comment to the job's comment thread\n   */\n  async addComment(id: number | string, body: string): Promise<void> {\n    await this.http.post<Record<string, never>>(`/translate/job/${id}/comment`, { body });\n  }\n}\n","import type { HttpClient } from '../core/http.js';\nimport type { Order, Comment } from '../types/index.js';\n\n/**\n * Orders resource for managing translation orders\n */\nexport class OrdersResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Retrieves an order by ID with job status breakdown\n   */\n  async get(id: number | string): Promise<{ order: Order }> {\n    return this.http.get<{ order: Order }>(`/translate/order/${id}`);\n  }\n\n  /**\n   * Cancels all available jobs in an order\n   * Note: This will not cancel jobs that are already in progress\n   */\n  async cancel(id: number | string): Promise<{ order: Order }> {\n    return this.http.delete<{ order: Order }>(`/translate/order/${id}`);\n  }\n\n  /**\n   * Retrieves the comment thread for an order\n   */\n  async getComments(id: number | string): Promise<{ thread: Comment[] }> {\n    return this.http.get<{ thread: Comment[] }>(`/translate/order/${id}/comments`);\n  }\n\n  /**\n   * Submits a new comment to the order's comment thread\n   */\n  async addComment(id: number | string, body: string): Promise<void> {\n    await this.http.post<Record<string, never>>(`/translate/order/${id}/comment`, { body });\n  }\n}\n","import type { HttpClient } from '../core/http.js';\nimport type { Glossary } from '../types/index.js';\n\n/**\n * Glossary resource for managing translation glossaries\n */\nexport class GlossaryResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Retrieves all glossaries belonging to the authenticated user\n   */\n  async list(): Promise<Glossary[]> {\n    return this.http.get<Glossary[]>('/translate/glossary');\n  }\n\n  /**\n   * Retrieves a specific glossary by ID\n   */\n  async get(id: number | string): Promise<Glossary> {\n    return this.http.get<Glossary>(`/translate/glossary/${id}`);\n  }\n}\n","import type { HttpClient } from '../core/http.js';\nimport type {\n  Language,\n  LanguagePair,\n  QuoteResponse,\n  QuoteJobInput,\n} from '../types/index.js';\n\n/**\n * Service resource for language and pricing information\n */\nexport class ServiceResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Returns a list of supported languages and their language codes\n   */\n  async getLanguages(): Promise<Language[]> {\n    return this.http.get<Language[]>('/translate/service/languages');\n  }\n\n  /**\n   * Returns supported translation language pairs with pricing\n   * @param lcSrc - Optional source language code to filter pairs\n   */\n  async getLanguagePairs(lcSrc?: string): Promise<LanguagePair[]> {\n    return this.http.get<LanguagePair[]>('/translate/service/language_pairs', {\n      lc_src: lcSrc,\n    });\n  }\n\n  /**\n   * Returns credit quote and unit count for text jobs\n   */\n  async getQuote(jobs: Record<string, QuoteJobInput>): Promise<QuoteResponse> {\n    return this.http.post<QuoteResponse>('/translate/service/quote', { jobs });\n  }\n\n  /**\n   * Uploads files and returns quotes with identifiers for ordering\n   * Note: File upload requires multipart/form-data which is not yet implemented.\n   * Use the Gengo dashboard for file jobs, or implement custom file upload logic.\n   */\n  async getFileQuote(\n    _jobs: Record<string, { type: 'file'; lc_src: string; lc_tgt: string; tier: string }>\n  ): Promise<QuoteResponse> {\n    throw new Error(\n      'File quote upload is not yet implemented. Use text jobs or the Gengo dashboard.'\n    );\n  }\n}\n","import { HttpClient } from './core/http.js';\nimport { AccountResource } from './resources/account.js';\nimport { JobsResource } from './resources/jobs.js';\nimport { OrdersResource } from './resources/orders.js';\nimport { GlossaryResource } from './resources/glossary.js';\nimport { ServiceResource } from './resources/service.js';\n\n/**\n * Configuration options for the Gengo client\n */\nexport interface GengoClientConfig {\n  /** Your Gengo API public key */\n  publicKey: string;\n  /** Your Gengo API private key */\n  privateKey: string;\n  /** Use sandbox environment (default: false) */\n  sandbox?: boolean;\n  /** Request timeout in milliseconds (default: 30000) */\n  timeout?: number;\n}\n\n/**\n * Gengo API client for human translation services\n *\n * @example\n * ```typescript\n * import { GengoClient } from 'gengo-ts';\n *\n * const client = new GengoClient({\n *   publicKey: 'your_public_key',\n *   privateKey: 'your_private_key',\n *   sandbox: true,\n * });\n *\n * // Get account balance\n * const balance = await client.account.getBalance();\n *\n * // Submit translation jobs\n * const order = await client.jobs.create({\n *   job_1: {\n *     body_src: 'Hello, world!',\n *     lc_src: 'en',\n *     lc_tgt: 'ja',\n *     tier: 'standard',\n *     slug: 'greeting',\n *   },\n * });\n * ```\n */\nexport class GengoClient {\n  private readonly http: HttpClient;\n\n  /** Account information and statistics */\n  readonly account: AccountResource;\n\n  /** Translation jobs management */\n  readonly jobs: JobsResource;\n\n  /** Translation orders management */\n  readonly orders: OrdersResource;\n\n  /** Glossary management */\n  readonly glossary: GlossaryResource;\n\n  /** Language and pricing services */\n  readonly service: ServiceResource;\n\n  constructor(config: GengoClientConfig) {\n    this.http = new HttpClient({\n      publicKey: config.publicKey,\n      privateKey: config.privateKey,\n      sandbox: config.sandbox ?? false,\n      timeout: config.timeout,\n    });\n\n    this.account = new AccountResource(this.http);\n    this.jobs = new JobsResource(this.http);\n    this.orders = new OrdersResource(this.http);\n    this.glossary = new GlossaryResource(this.http);\n    this.service = new ServiceResource(this.http);\n  }\n}\n"]}

package/dist/webhook/express.d.ts

@@ -0,0 +1,50 @@
+import { WebhookHandler } from './index.js';
+import '../common-Bk4hl8fX.js';
+
+/**
+ * Express-compatible request interface
+ */
+interface ExpressRequest {
+    method: string;
+    body?: Record<string, string>;
+    headers: Record<string, string | string[] | undefined>;
+}
+/**
+ * Express-compatible response interface
+ */
+interface ExpressResponse {
+    status(code: number): ExpressResponse;
+    send(body: string): void;
+}
+/**
+ * Express-compatible next function
+ */
+type NextFunction = (error?: Error) => void;
+/**
+ * Express middleware type
+ */
+type ExpressMiddleware = (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void | Promise<void>;
+/**
+ * Creates an Express middleware adapter for the webhook handler
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createWebhookHandler } from 'gengo-ts/webhook';
+ * import { expressAdapter } from 'gengo-ts/webhook/express';
+ *
+ * const app = express();
+ * app.use(express.urlencoded({ extended: true }));
+ *
+ * const handler = createWebhookHandler({
+ *   onJobUpdate: (job) => {
+ *     console.log('Job updated:', job.job_id, job.status);
+ *   },
+ * });
+ *
+ * app.post('/webhook', expressAdapter(handler));
+ * ```
+ */
+declare function expressAdapter(handler: WebhookHandler): ExpressMiddleware;
+
+export { expressAdapter };

package/dist/webhook/express.js

@@ -0,0 +1,24 @@
+// src/webhook/express.ts
+function expressAdapter(handler) {
+  return async (req, res, next) => {
+    if (req.method !== "POST") {
+      res.status(405).send("Method not allowed");
+      return;
+    }
+    try {
+      const body = req.body ?? {};
+      const result = await handler.handleFormData(body);
+      if (result.success) {
+        res.status(200).send("OK");
+      } else {
+        res.status(500).send(result.error?.message ?? "Processing failed");
+      }
+    } catch (error) {
+      next(error instanceof Error ? error : new Error(String(error)));
+    }
+  };
+}
+
+export { expressAdapter };
+//# sourceMappingURL=express.js.map
+//# sourceMappingURL=express.js.map

package/dist/webhook/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/webhook/express.ts"],"names":[],"mappings":";AAsDO,SAAS,eAAe,OAAA,EAA4C;AACzE,EAAA,OAAO,OAAO,GAAA,EAAK,GAAA,EAAK,IAAA,KAAS;AAC/B,IAAA,IAAI,GAAA,CAAI,WAAW,MAAA,EAAQ;AACzB,MAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,oBAAoB,CAAA;AACzC,MAAA;AAAA,IACF;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,GAAA,CAAI,IAAA,IAAQ,EAAC;AAC1B,MAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,cAAA,CAAe,IAAI,CAAA;AAEhD,MAAA,IAAI,OAAO,OAAA,EAAS;AAClB,QAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA;AAAA,MAC3B,CAAA,MAAO;AACL,QAAA,GAAA,CAAI,OAAO,GAAG,CAAA,CAAE,KAAK,MAAA,CAAO,KAAA,EAAO,WAAW,mBAAmB,CAAA;AAAA,MACnE;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,KAAA,YAAiB,QAAQ,KAAA,GAAQ,IAAI,MAAM,MAAA,CAAO,KAAK,CAAC,CAAC,CAAA;AAAA,IAChE;AAAA,EACF,CAAA;AACF","file":"express.js","sourcesContent":["import type { WebhookHandler } from './index.js';\n\n/**\n * Express-compatible request interface\n */\ninterface ExpressRequest {\n  method: string;\n  body?: Record<string, string>;\n  headers: Record<string, string | string[] | undefined>;\n}\n\n/**\n * Express-compatible response interface\n */\ninterface ExpressResponse {\n  status(code: number): ExpressResponse;\n  send(body: string): void;\n}\n\n/**\n * Express-compatible next function\n */\ntype NextFunction = (error?: Error) => void;\n\n/**\n * Express middleware type\n */\ntype ExpressMiddleware = (\n  req: ExpressRequest,\n  res: ExpressResponse,\n  next: NextFunction\n) => void | Promise<void>;\n\n/**\n * Creates an Express middleware adapter for the webhook handler\n *\n * @example\n * ```typescript\n * import express from 'express';\n * import { createWebhookHandler } from 'gengo-ts/webhook';\n * import { expressAdapter } from 'gengo-ts/webhook/express';\n *\n * const app = express();\n * app.use(express.urlencoded({ extended: true }));\n *\n * const handler = createWebhookHandler({\n *   onJobUpdate: (job) => {\n *     console.log('Job updated:', job.job_id, job.status);\n *   },\n * });\n *\n * app.post('/webhook', expressAdapter(handler));\n * ```\n */\nexport function expressAdapter(handler: WebhookHandler): ExpressMiddleware {\n  return async (req, res, next) => {\n    if (req.method !== 'POST') {\n      res.status(405).send('Method not allowed');\n      return;\n    }\n\n    try {\n      const body = req.body ?? {};\n      const result = await handler.handleFormData(body);\n\n      if (result.success) {\n        res.status(200).send('OK');\n      } else {\n        res.status(500).send(result.error?.message ?? 'Processing failed');\n      }\n    } catch (error) {\n      next(error instanceof Error ? error : new Error(String(error)));\n    }\n  };\n}\n"]}

package/dist/webhook/hono.d.ts

@@ -0,0 +1,40 @@
+import { WebhookHandler } from './index.js';
+import '../common-Bk4hl8fX.js';
+
+/**
+ * Hono-compatible context interface
+ */
+interface HonoContext {
+    req: {
+        method: string;
+        parseBody(): Promise<Record<string, string>>;
+    };
+    text(body: string, status?: number): Response;
+}
+/**
+ * Hono handler type
+ */
+type HonoHandler = (c: HonoContext) => Promise<Response>;
+/**
+ * Creates a Hono handler adapter for the webhook handler
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { createWebhookHandler } from 'gengo-ts/webhook';
+ * import { honoAdapter } from 'gengo-ts/webhook/hono';
+ *
+ * const app = new Hono();
+ *
+ * const handler = createWebhookHandler({
+ *   onJobUpdate: (job) => {
+ *     console.log('Job updated:', job.job_id, job.status);
+ *   },
+ * });
+ *
+ * app.post('/webhook', honoAdapter(handler));
+ * ```
+ */
+declare function honoAdapter(handler: WebhookHandler): HonoHandler;
+
+export { honoAdapter };