@purposeinplay/payload-ai-translate 0.1.0

package/dist/views/shared/format.js

@@ -0,0 +1,131 @@
+/**
+ * Shared cost / duration formatters for Translation Hub + Bulk Translate
+ * Runs surfaces. v1.2.6 BugIndex NEW-17 + NEW-18 + NEW-10.
+ *
+ * Before extracting these, every surface (Hub Overview, Audit, Runs,
+ * batch rows, drill-down) rolled its own threshold logic. The result:
+ *   - Hub Overview "Estimated cost" showed `$0.54`
+ *   - Audit "Total spend" showed `53.6¢`
+ *   - Runs "Last 7 days cost" showed `$0.51`
+ *   - Batch row Cost column showed `12.4¢`
+ *   - Drill-down unit-detail showed `2.1¢`
+ *   - Bucket-row duration showed `964m 6s` with no hours carryover
+ *
+ * Same underlying value (cents, ms), five different formats.
+ *
+ * The contract here is the only contract going forward. Every cost /
+ * duration render site MUST import `formatCost` / `formatDuration`. Do
+ * NOT roll new threshold rules at the call site.
+ *
+ * `formatCost` rule (1.2.8):
+ *   - All values render as `$X.YY[YY]` (USD, dollar sign always present).
+ *   - Sub-cent values use up to 4 decimals so editors can tell a
+ *     0.46¢ run from a 0.88¢ run — but the unit is consistently $,
+ *     never the ¢ glyph (it was being mis-read as `$X.YY¢` on dense
+ *     tables and made per-doc costs look 100× higher than they were).
+ *   - Values ≥ $0.01 stay at the standard 2-decimal $X.YY form.
+ *
+ *   Wait — that was the OLD rule. The Group F brief locks this in:
+ *   `$X.XX` with 2 decimals; switch to `Y.Y¢` ONLY when value < $0.01
+ *   (or, equivalently, < 1¢).
+ *
+ *   So: < $0.01 → `Y.YY¢`, else `$X.XX`.
+ *
+ * `formatDuration` rule:
+ *   ms → s → m → h → d, carrying everywhere. Show two units of
+ *   precision when the next-down unit would otherwise be lost
+ *   (e.g. `16h 38m`, `5m 16s`, `42s`).
+ */ // ---------------------------------------------------------------------------
+// formatCost — single source of truth for any USD render in the UI.
+// ---------------------------------------------------------------------------
+/**
+ * Render a USD value with consistent rules.
+ *
+ * @param usd Dollars (e.g. 0.124 means 12.4 cents). `null` / `undefined`
+ *   / non-finite → `'—'`. Negative → coerced to `0`.
+ * @returns
+ *   - `'—'` when missing or non-finite
+ *   - `'$0.00'` when exactly zero
+ *   - `'$0.YYYY'` (USD, four decimals) when 0 < value < $0.01
+ *   - `'$X.XX'` (USD, two decimals) otherwise
+ *
+ * Tests pin the boundaries — see `__tests__/format.test.ts`.
+ */ export function formatCost(usd) {
+    if (usd == null || !Number.isFinite(usd)) return '—';
+    const v = Math.max(0, usd);
+    if (v === 0) return '$0.00';
+    if (v < 0.01) {
+        // Sub-cent: keep the $ unit consistent (the prior `0.46¢` form
+        // was mis-read on dense tables as `$0.46`, making per-doc costs
+        // look 100× higher). 4 decimals so editors can still tell 0.0046
+        // from 0.0088.
+        return `$${v.toFixed(4)}`;
+    }
+    return `$${v.toFixed(2)}`;
+}
+// ---------------------------------------------------------------------------
+// formatDuration — single source of truth for any ms render in the UI.
+// ---------------------------------------------------------------------------
+const MS_PER_SECOND = 1000;
+const MS_PER_MINUTE = 60 * MS_PER_SECOND;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+/**
+ * Render a duration in ms with full carry-over from ms → s → m → h → d.
+ *
+ * @param ms Duration in milliseconds. `null` / `undefined` / non-finite
+ *   → `'—'`. Zero → `'—'` by convention (matches the legacy `fmtUsd`
+ *   behaviour the call sites relied on). Negative → coerced to `0` →
+ *   `'—'`.
+ * @returns
+ *   - `'—'` when missing / non-finite / non-positive
+ *   - `'Nms'` when < 1s
+ *   - `'N.Ns'` when < 10s (one decimal, e.g. `3.4s`)
+ *   - `'Ns'` when < 60s
+ *   - `'Nm Ss'` when < 1h (e.g. `5m 16s`)
+ *   - `'Nh Mm'` when < 24h (e.g. `16h 38m`)
+ *   - `'Nd Hh'` when ≥ 24h (e.g. `2d 4h`)
+ *
+ * The rule is the same one BatchRow.tsx implemented for batch-level
+ * durations; lifting it here so BucketRow stops capping at minutes and
+ * rendering `964m 6s`. See NEW-18.
+ *
+ * Tests pin the boundaries — see `__tests__/format.test.ts`.
+ */ export function formatDuration(ms) {
+    if (ms == null || !Number.isFinite(ms)) return '—';
+    const v = Math.max(0, ms);
+    if (v === 0) return '—';
+    if (v < MS_PER_SECOND) return `${Math.round(v)}ms`;
+    if (v < 10 * MS_PER_SECOND) return `${(v / MS_PER_SECOND).toFixed(1)}s`;
+    if (v < MS_PER_MINUTE) return `${Math.round(v / MS_PER_SECOND)}s`;
+    if (v < MS_PER_HOUR) {
+        // Round to whole seconds FIRST, then decompose by integer division.
+        // The previous code rounded seconds independently of minutes:
+        // 1_799_500ms → minutes=29, seconds=Math.round(59.5)=60 → `29m 60s`.
+        // Decomposing from a single rounded total keeps the boundary clean.
+        // If the round-up tips us over the hour boundary (e.g. 3_599_500ms
+        // → 3600 totalSeconds → would render `60m 0s`), promote to the
+        // Nh Mm format so the carry cascades all the way.
+        const totalSeconds = Math.round(v / MS_PER_SECOND);
+        if (totalSeconds >= 3600) {
+            const hoursCarry = Math.floor(totalSeconds / 3600);
+            const minutesCarry = Math.floor(totalSeconds % 3600 / 60);
+            return `${hoursCarry}h ${minutesCarry}m`;
+        }
+        const minutes = Math.floor(totalSeconds / 60);
+        const seconds = totalSeconds % 60;
+        return `${minutes}m ${seconds}s`;
+    }
+    if (v < MS_PER_DAY) {
+        // Floor on minutes here (NOT round) — rounding would tip
+        // 23h 59m 59s up to 24h 0m, contradicting the formatter contract
+        // that the day branch handles ≥ 24h. The carry bug doesn't manifest
+        // here because there's no sub-minute display to round into.
+        const hours = Math.floor(v / MS_PER_HOUR);
+        const minutes = Math.floor(v % MS_PER_HOUR / MS_PER_MINUTE);
+        return `${hours}h ${minutes}m`;
+    }
+    const days = Math.floor(v / MS_PER_DAY);
+    const hours = Math.floor(v % MS_PER_DAY / MS_PER_HOUR);
+    return `${days}d ${hours}h`;
+}

package/package.json

@@ -0,0 +1,141 @@
+{
+  "name": "@purposeinplay/payload-ai-translate",
+  "version": "0.1.0",
+  "description": "AI translation plugin for Payload CMS 3 — multi-provider (OpenAI, Anthropic, Gemini, custom), bulk translation, Lexical-aware, with an admin Translation Hub.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/exports/index.js",
+  "types": "./dist/exports/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/exports/index.d.ts",
+      "import": "./dist/exports/index.js",
+      "default": "./dist/exports/index.js"
+    },
+    "./providers": {
+      "types": "./dist/exports/providers.d.ts",
+      "import": "./dist/exports/providers.js",
+      "default": "./dist/exports/providers.js"
+    },
+    "./views": {
+      "types": "./dist/exports/views.d.ts",
+      "import": "./dist/exports/views.js",
+      "default": "./dist/exports/views.js"
+    },
+    "./views-client": {
+      "types": "./dist/exports/views-client.d.ts",
+      "import": "./dist/exports/views-client.js",
+      "default": "./dist/exports/views-client.js"
+    },
+    "./client": {
+      "types": "./dist/exports/client.d.ts",
+      "import": "./dist/exports/client.js",
+      "default": "./dist/exports/client.js"
+    },
+    "./components": {
+      "types": "./dist/exports/components.d.ts",
+      "import": "./dist/exports/components.js",
+      "default": "./dist/exports/components.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^3.0.0",
+    "@ai-sdk/google": "^3.0.0",
+    "@ai-sdk/openai": "^3.0.0",
+    "@ai-sdk/openai-compatible": "^2.0.0",
+    "@payloadcms/db-postgres": "^3.0.0",
+    "@payloadcms/next": "^3.0.0",
+    "@payloadcms/ui": "^3.0.0",
+    "ai": "^6.0.0",
+    "next": "^15.0.0 || ^16.0.0",
+    "payload": "^3.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "zod": "^3.0.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/openai-compatible": {
+      "optional": true
+    },
+    "@payloadcms/db-postgres": {
+      "optional": true
+    },
+    "@payloadcms/next": {
+      "optional": true
+    },
+    "@payloadcms/ui": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.74",
+    "@ai-sdk/google": "^3.0.67",
+    "@ai-sdk/openai": "^3.0.58",
+    "@ai-sdk/openai-compatible": "^2.0.45",
+    "@biomejs/biome": "^2.2.0",
+    "@changesets/cli": "^2.27.9",
+    "@payloadcms/db-postgres": "^3.0.0",
+    "@payloadcms/next": "^3.85.0",
+    "@payloadcms/ui": "^3.0.0",
+    "@swc/cli": "^0.7.7",
+    "@swc/core": "^1.10.1",
+    "@types/node": "^22.0.0",
+    "drizzle-orm": "^0.45.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.2.3",
+    "ai": "^6.0.174",
+    "next": "^16.0.0",
+    "payload": "^3.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.2",
+    "zod": "^4.4.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/purposeinplay/payload-ai-translate.git"
+  },
+  "homepage": "https://github.com/purposeinplay/payload-ai-translate#readme",
+  "bugs": {
+    "url": "https://github.com/purposeinplay/payload-ai-translate/issues"
+  },
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "plugin",
+    "translation",
+    "i18n",
+    "ai",
+    "openai",
+    "anthropic",
+    "gemini"
+  ],
+  "scripts": {
+    "build": "pnpm run build:types && pnpm run build:swc && pnpm run build:fix-esm",
+    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
+    "build:swc": "swc ./src -d ./dist --config-file ./.swcrc --strip-leading-paths --ignore \"**/__tests__/**\"",
+    "build:fix-esm": "node ./scripts/fix-dist-extensions.mjs dist && node ./scripts/check-dist-esm.mjs dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "check": "biome check . && pnpm typecheck && pnpm build && pnpm test",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm build && changeset publish"
+  }
+}