gengo-ts 1.0.0

package/dist/webhook/hono.js

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

package/dist/webhook/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/webhook/hono.ts"],"names":[],"mappings":";AAsCO,SAAS,YAAY,OAAA,EAAsC;AAChE,EAAA,OAAO,OAAO,CAAA,KAAM;AAClB,IAAA,IAAI,CAAA,CAAE,GAAA,CAAI,MAAA,KAAW,MAAA,EAAQ;AAC3B,MAAA,OAAO,CAAA,CAAE,IAAA,CAAK,oBAAA,EAAsB,GAAG,CAAA;AAAA,IACzC;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,GAAA,CAAI,SAAA,EAAU;AACnC,MAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,cAAA,CAAe,IAA8B,CAAA;AAE1E,MAAA,IAAI,OAAO,OAAA,EAAS;AAClB,QAAA,OAAO,CAAA,CAAE,IAAA,CAAK,IAAA,EAAM,GAAG,CAAA;AAAA,MACzB,CAAA,MAAO;AACL,QAAA,OAAO,EAAE,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,OAAA,IAAW,qBAAqB,GAAG,CAAA;AAAA,MACjE;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,OAAA,GAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,eAAA;AACzD,MAAA,OAAO,CAAA,CAAE,IAAA,CAAK,OAAA,EAAS,GAAG,CAAA;AAAA,IAC5B;AAAA,EACF,CAAA;AACF","file":"hono.js","sourcesContent":["import type { WebhookHandler } from './index.js';\n\n/**\n * Hono-compatible context interface\n */\ninterface HonoContext {\n  req: {\n    method: string;\n    parseBody(): Promise<Record<string, string>>;\n  };\n  text(body: string, status?: number): Response;\n}\n\n/**\n * Hono handler type\n */\ntype HonoHandler = (c: HonoContext) => Promise<Response>;\n\n/**\n * Creates a Hono handler adapter for the webhook handler\n *\n * @example\n * ```typescript\n * import { Hono } from 'hono';\n * import { createWebhookHandler } from 'gengo-ts/webhook';\n * import { honoAdapter } from 'gengo-ts/webhook/hono';\n *\n * const app = new Hono();\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', honoAdapter(handler));\n * ```\n */\nexport function honoAdapter(handler: WebhookHandler): HonoHandler {\n  return async (c) => {\n    if (c.req.method !== 'POST') {\n      return c.text('Method not allowed', 405);\n    }\n\n    try {\n      const body = await c.req.parseBody();\n      const result = await handler.handleFormData(body as Record<string, string>);\n\n      if (result.success) {\n        return c.text('OK', 200);\n      } else {\n        return c.text(result.error?.message ?? 'Processing failed', 500);\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      return c.text(message, 500);\n    }\n  };\n}\n"]}

package/dist/webhook/index.d.ts

@@ -0,0 +1,95 @@
+import { T as Tier, a as JobStatus, C as Currency } from '../common-Bk4hl8fX.js';
+
+/**
+ * Job callback payload sent by Gengo
+ */
+interface JobCallback {
+    job_id: number;
+    order_id: number;
+    body_src: string;
+    body_tgt: string;
+    lc_src: string;
+    lc_tgt: string;
+    unit_count: number;
+    tier: Tier;
+    credits: number;
+    status: JobStatus;
+    eta: number;
+    ctime: number;
+    callback_url: string;
+    auto_approve: boolean;
+    custom_data: string;
+    slug: string;
+    currency: Currency;
+    file_url_src?: string;
+    file_url_tgt?: string;
+}
+/**
+ * Comment callback payload sent by Gengo
+ */
+interface CommentCallback {
+    job_id: string;
+    body: string;
+    ctime: string;
+    custom_data?: string;
+    file_url_tgt?: string;
+}
+/**
+ * Webhook handler callbacks
+ */
+interface WebhookHandlerCallbacks {
+    /** Called when a job status update is received */
+    onJobUpdate?: (job: JobCallback) => void | Promise<void>;
+    /** Called when a translator comment is received */
+    onComment?: (comment: CommentCallback) => void | Promise<void>;
+    /** Called when an error occurs during processing */
+    onError?: (error: Error) => void | Promise<void>;
+}
+/**
+ * Parsed webhook payload
+ */
+type WebhookPayload = {
+    type: 'job';
+    data: JobCallback;
+} | {
+    type: 'comment';
+    data: CommentCallback;
+};
+/**
+ * Result of webhook processing
+ */
+interface WebhookResult {
+    success: boolean;
+    type?: 'job' | 'comment';
+    error?: Error;
+}
+
+/**
+ * Webhook handler for processing Gengo callbacks
+ */
+declare class WebhookHandler {
+    private readonly callbacks;
+    constructor(callbacks: WebhookHandlerCallbacks);
+    /**
+     * Parses form data and returns the webhook payload
+     */
+    parsePayload(formData: URLSearchParams | FormData | Record<string, string>): WebhookPayload | null;
+    /**
+     * Processes a webhook payload and calls the appropriate callback
+     */
+    process(payload: WebhookPayload): Promise<WebhookResult>;
+    /**
+     * Parses and processes a webhook request body
+     */
+    handleFormData(formData: URLSearchParams | FormData | Record<string, string>): Promise<WebhookResult>;
+}
+/**
+ * Creates a webhook handler with the specified callbacks
+ */
+declare function createWebhookHandler(callbacks: WebhookHandlerCallbacks): WebhookHandler;
+/**
+ * Handles a raw Web Request (for Deno, Bun, Cloudflare Workers)
+ */
+declare function handleRequest(request: Request, handler: WebhookHandler): Promise<Response>;
+
+export { type CommentCallback, type JobCallback, WebhookHandler, type WebhookHandlerCallbacks, type WebhookPayload, type WebhookResult, createWebhookHandler, handleRequest };

package/dist/webhook/index.js

@@ -0,0 +1,100 @@
+// src/webhook/index.ts
+var WebhookHandler = class {
+  constructor(callbacks) {
+    this.callbacks = callbacks;
+  }
+  /**
+   * Parses form data and returns the webhook payload
+   */
+  parsePayload(formData) {
+    let jobData = null;
+    let commentData = null;
+    if (formData instanceof URLSearchParams) {
+      jobData = formData.get("job");
+      commentData = formData.get("comment");
+    } else if (formData instanceof FormData) {
+      const jobValue = formData.get("job");
+      const commentValue = formData.get("comment");
+      jobData = typeof jobValue === "string" ? jobValue : null;
+      commentData = typeof commentValue === "string" ? commentValue : null;
+    } else {
+      jobData = formData["job"] ?? null;
+      commentData = formData["comment"] ?? null;
+    }
+    if (jobData) {
+      return { type: "job", data: JSON.parse(jobData) };
+    }
+    if (commentData) {
+      return { type: "comment", data: JSON.parse(commentData) };
+    }
+    return null;
+  }
+  /**
+   * Processes a webhook payload and calls the appropriate callback
+   */
+  async process(payload) {
+    try {
+      if (payload.type === "job" && this.callbacks.onJobUpdate) {
+        await this.callbacks.onJobUpdate(payload.data);
+        return { success: true, type: "job" };
+      }
+      if (payload.type === "comment" && this.callbacks.onComment) {
+        await this.callbacks.onComment(payload.data);
+        return { success: true, type: "comment" };
+      }
+      return { success: true, type: payload.type };
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      if (this.callbacks.onError) {
+        await this.callbacks.onError(err);
+      }
+      return { success: false, error: err };
+    }
+  }
+  /**
+   * Parses and processes a webhook request body
+   */
+  async handleFormData(formData) {
+    const payload = this.parsePayload(formData);
+    if (!payload) {
+      return {
+        success: false,
+        error: new Error("Invalid webhook payload: no job or comment data found")
+      };
+    }
+    return this.process(payload);
+  }
+};
+function createWebhookHandler(callbacks) {
+  return new WebhookHandler(callbacks);
+}
+async function handleRequest(request, handler) {
+  if (request.method !== "POST") {
+    return new Response("Method not allowed", { status: 405 });
+  }
+  const contentType = request.headers.get("content-type") ?? "";
+  try {
+    let formData;
+    if (contentType.includes("application/x-www-form-urlencoded")) {
+      const text = await request.text();
+      formData = new URLSearchParams(text);
+    } else if (contentType.includes("multipart/form-data")) {
+      formData = await request.formData();
+    } else {
+      return new Response("Unsupported content type", { status: 415 });
+    }
+    const result = await handler.handleFormData(formData);
+    if (result.success) {
+      return new Response("OK", { status: 200 });
+    } else {
+      return new Response(result.error?.message ?? "Processing failed", { status: 500 });
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return new Response(message, { status: 500 });
+  }
+}
+
+export { WebhookHandler, createWebhookHandler, handleRequest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/webhook/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/webhook/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  JobCallback,\n  CommentCallback,\n  WebhookHandlerCallbacks,\n  WebhookPayload,\n  WebhookResult,\n} from './types.js';\n\nexport type {\n  JobCallback,\n  CommentCallback,\n  WebhookHandlerCallbacks,\n  WebhookPayload,\n  WebhookResult,\n};\n\n/**\n * Webhook handler for processing Gengo callbacks\n */\nexport class WebhookHandler {\n  constructor(private readonly callbacks: WebhookHandlerCallbacks) {}\n\n  /**\n   * Parses form data and returns the webhook payload\n   */\n  parsePayload(formData: URLSearchParams | FormData | Record<string, string>): WebhookPayload | null {\n    let jobData: string | null = null;\n    let commentData: string | null = null;\n\n    if (formData instanceof URLSearchParams) {\n      jobData = formData.get('job');\n      commentData = formData.get('comment');\n    } else if (formData instanceof FormData) {\n      const jobValue = formData.get('job');\n      const commentValue = formData.get('comment');\n      jobData = typeof jobValue === 'string' ? jobValue : null;\n      commentData = typeof commentValue === 'string' ? commentValue : null;\n    } else {\n      jobData = formData['job'] ?? null;\n      commentData = formData['comment'] ?? null;\n    }\n\n    if (jobData) {\n      return { type: 'job', data: JSON.parse(jobData) as JobCallback };\n    }\n\n    if (commentData) {\n      return { type: 'comment', data: JSON.parse(commentData) as CommentCallback };\n    }\n\n    return null;\n  }\n\n  /**\n   * Processes a webhook payload and calls the appropriate callback\n   */\n  async process(payload: WebhookPayload): Promise<WebhookResult> {\n    try {\n      if (payload.type === 'job' && this.callbacks.onJobUpdate) {\n        await this.callbacks.onJobUpdate(payload.data);\n        return { success: true, type: 'job' };\n      }\n\n      if (payload.type === 'comment' && this.callbacks.onComment) {\n        await this.callbacks.onComment(payload.data);\n        return { success: true, type: 'comment' };\n      }\n\n      return { success: true, type: payload.type };\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n      if (this.callbacks.onError) {\n        await this.callbacks.onError(err);\n      }\n      return { success: false, error: err };\n    }\n  }\n\n  /**\n   * Parses and processes a webhook request body\n   */\n  async handleFormData(\n    formData: URLSearchParams | FormData | Record<string, string>\n  ): Promise<WebhookResult> {\n    const payload = this.parsePayload(formData);\n\n    if (!payload) {\n      return {\n        success: false,\n        error: new Error('Invalid webhook payload: no job or comment data found'),\n      };\n    }\n\n    return this.process(payload);\n  }\n}\n\n/**\n * Creates a webhook handler with the specified callbacks\n */\nexport function createWebhookHandler(\n  callbacks: WebhookHandlerCallbacks\n): WebhookHandler {\n  return new WebhookHandler(callbacks);\n}\n\n/**\n * Handles a raw Web Request (for Deno, Bun, Cloudflare Workers)\n */\nexport async function handleRequest(\n  request: Request,\n  handler: WebhookHandler\n): Promise<Response> {\n  if (request.method !== 'POST') {\n    return new Response('Method not allowed', { status: 405 });\n  }\n\n  const contentType = request.headers.get('content-type') ?? '';\n\n  try {\n    let formData: URLSearchParams | FormData;\n\n    if (contentType.includes('application/x-www-form-urlencoded')) {\n      const text = await request.text();\n      formData = new URLSearchParams(text);\n    } else if (contentType.includes('multipart/form-data')) {\n      formData = await request.formData();\n    } else {\n      return new Response('Unsupported content type', { status: 415 });\n    }\n\n    const result = await handler.handleFormData(formData);\n\n    if (result.success) {\n      return new Response('OK', { status: 200 });\n    } else {\n      return new Response(result.error?.message ?? 'Processing failed', { status: 500 });\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    return new Response(message, { status: 500 });\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "gengo-ts",
+  "version": "1.0.0",
+  "description": "Modern TypeScript client for the Gengo Translation API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./webhook": {
+      "types": "./dist/webhook/index.d.ts",
+      "import": "./dist/webhook/index.js"
+    },
+    "./webhook/express": {
+      "types": "./dist/webhook/express.d.ts",
+      "import": "./dist/webhook/express.js"
+    },
+    "./webhook/hono": {
+      "types": "./dist/webhook/hono.d.ts",
+      "import": "./dist/webhook/hono.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "gengo",
+    "translation",
+    "api",
+    "typescript",
+    "i18n",
+    "localization"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0",
+    "hono": "^3.0.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    }
+  }
+}