@purposeinplay/payload-ai-translate 0.1.0

package/dist/endpoints/translation-hub/usage-summary.js

@@ -0,0 +1,481 @@
+import { DEFAULT_USAGE_COLLECTION_SLUG } from '../../defaults.js';
+import { errorResponse, isAdminUser, unauthorizedResponse } from './_helpers.js';
+/**
+ * `GET /api/translation-hub/usage-summary`
+ *
+ * Server-side aggregation of the `translation-usage` collection for
+ * Hub Overview + Audit & Cost KPIs. Replaces the prior client-side
+ * pattern where both panels fetched `?limit=1000` and reduced in JS;
+ * past 1000 rows the totals silently truncated and the network panel
+ * showed two parallel megabyte responses per Hub mount. See NEW-15.
+ *
+ * Query params:
+ *   - `range` — one of `7d` | `30d` | `90d` | `all` | `custom`.
+ *               Defaults to `7d`.
+ *   - `from`  — ISO timestamp; required when `range=custom`.
+ *   - `to`    — ISO timestamp; optional ceiling when `range=custom`.
+ *
+ * Response shape (`UsageSummaryResponse`):
+ *   {
+ *     range: { kind, from?, to?, since?, until? },
+ *     totals: {
+ *       runs, succeeded, failed, inputTokens, outputTokens, costUsd,
+ *       totalMatching, truncated
+ *     },
+ *     byCollection: [{ slug, kind, runs, tokens, costUsd }],
+ *     byModel: [{ model, runs, tokens, costUsd }],
+ *     byLocale: [{ locale, runs, failed }],
+ *     samples: [UsageRow]  // 20 most recent rows for the "Recent
+ *                          // translations" / "Recent failures" tables
+ *   }
+ *
+ * Implementation note: when `payload.db.drizzle` is available (Postgres
+ * adapter), aggregates run as `SELECT … SUM(...) GROUP BY ...` against
+ * the underlying tables. When it isn't (mock / SQLite / other adapter
+ * stacks in tests), we fall back to a paginated `payload.find()` walk
+ * that still avoids loading the entire result set into memory at once.
+ * Both paths return the same shape — consumers cannot tell the
+ * difference. The drizzle path is what makes >1000-row windows
+ * correct, which is the NEW-15 contract.
+ *
+ * Auth: admin-only, identical posture to every other translation-hub
+ * endpoint (see `active.ts`, `list.ts`). Editors aren't allowed to
+ * read cost data.
+ */ const PRESET_MS = {
+    '7d': 7 * 24 * 60 * 60 * 1000,
+    '30d': 30 * 24 * 60 * 60 * 1000,
+    '90d': 90 * 24 * 60 * 60 * 1000
+};
+const SAMPLES_LIMIT = 20;
+/**
+ * Parse the `range`/`from`/`to` query params. Exported for testing —
+ * mirrors the StatusStrip/AuditPanel resolution rules so the UI and
+ * the endpoint agree on what "Last 7 days" means.
+ */ export function parseRangeParams(params) {
+    const rangeRaw = (params.get('range') ?? '7d').toLowerCase();
+    if (rangeRaw === 'all') {
+        return {
+            range: {
+                kind: 'all'
+            },
+            since: null,
+            until: null
+        };
+    }
+    if (rangeRaw === 'custom') {
+        const fromRaw = params.get('from');
+        const toRaw = params.get('to');
+        let since = null;
+        let until = null;
+        if (fromRaw) {
+            const d = new Date(fromRaw);
+            if (!Number.isNaN(d.getTime())) {
+                since = d.toISOString();
+            }
+        }
+        if (toRaw) {
+            const d = new Date(toRaw);
+            if (!Number.isNaN(d.getTime())) {
+                // Include end-of-day so a "to 2026-01-15" filter matches rows
+                // logged that day, not just rows before midnight UTC. Mirrors
+                // the StatusStrip + AuditPanel client behaviour.
+                d.setUTCHours(23, 59, 59, 999);
+                until = d.toISOString();
+            }
+        }
+        return {
+            range: {
+                kind: 'custom',
+                ...since ? {
+                    from: since
+                } : {},
+                ...until ? {
+                    to: until
+                } : {}
+            },
+            since,
+            until
+        };
+    }
+    if (rangeRaw === '7d' || rangeRaw === '30d' || rangeRaw === '90d') {
+        const since = new Date(Date.now() - PRESET_MS[rangeRaw]).toISOString();
+        return {
+            range: {
+                kind: rangeRaw,
+                since
+            },
+            since,
+            until: null
+        };
+    }
+    // Unknown preset — fall back to 7d so a client typo doesn't surface a
+    // 400. Same shape every other consumer expects.
+    const since = new Date(Date.now() - PRESET_MS['7d']).toISOString();
+    return {
+        range: {
+            kind: '7d',
+            since
+        },
+        since,
+        until: null
+    };
+}
+export const getTranslationHubUsageSummaryHandler = (options = {})=>async (req)=>{
+        if (!req.user) {
+            return unauthorizedResponse(req);
+        }
+        if (!isAdminUser(req.user)) {
+            return errorResponse('forbidden', 'Admin role required to read translation usage.', 403);
+        }
+        const usageSlug = options.usageCollectionSlug ?? DEFAULT_USAGE_COLLECTION_SLUG;
+        const url = new URL(req.url ?? 'http://localhost');
+        const { range, since, until } = parseRangeParams(url.searchParams);
+        try {
+            const drizzle = getDrizzleHandle(req.payload);
+            const aggregates = drizzle ? await aggregateWithDrizzle(drizzle, usageSlug, since, until) : await aggregateWithPayload(req.payload, usageSlug, since, until);
+            const samples = await fetchRecentSamples(req.payload, usageSlug, since, until);
+            const body = {
+                range,
+                totals: aggregates.totals,
+                byCollection: aggregates.byCollection,
+                byModel: aggregates.byModel,
+                byLocale: aggregates.byLocale,
+                samples
+            };
+            return Response.json(body);
+        } catch (err) {
+            req.payload.logger?.error?.(`[ai-translate] usage-summary: aggregation failed — ${err instanceof Error ? err.message : String(err)}`);
+            return errorResponse('aggregation_failed', 'Could not compute usage summary. Try again or narrow the time range.', 500);
+        }
+    };
+function getDrizzleHandle(payload) {
+    const db = payload.db.drizzle;
+    if (!db || typeof db.execute !== 'function') return null;
+    return db;
+}
+/**
+ * Slug → snake_case table identifier. Identical rule to the one in
+ * `lib/bulk-translate-migrations.ts`; duplicated locally to keep this
+ * endpoint independent of bulk-translate internals.
+ */ function slugToTable(slug) {
+    if (!/^[a-z][a-z0-9_-]{0,62}$/.test(slug)) {
+        throw new Error(`[ai-translate] usage-summary: invalid usage collection slug "${slug}" (must match /^[a-z][a-z0-9_-]{0,62}$/)`);
+    }
+    return slug.replace(/-/g, '_');
+}
+async function loadSqlTag() {
+    try {
+        // String-indirected so the bundler/tsc don't try to resolve
+        // `drizzle-orm` at build time — consumers without the dep still
+        // ship the plugin, the fallback aggregation path catches them.
+        const modulePath = 'drizzle-orm';
+        const mod = await import(modulePath);
+        return mod.sql ?? null;
+    } catch  {
+        return null;
+    }
+}
+async function aggregateWithDrizzle(drizzle, usageSlug, since, until) {
+    const sql = await loadSqlTag();
+    if (!sql) {
+        throw new Error('drizzle-orm sql tag unavailable');
+    }
+    const usageTable = slugToTable(usageSlug);
+    const targetLocalesTable = `${usageTable}_target_locales`;
+    // We splice the table identifiers via sql.raw — they come from the
+    // slug allowlist above (`/^[a-z][a-z0-9_-]{0,62}$/`), not from user
+    // input, so there's no injection surface.
+    const usageRef = sql.raw(`"${usageTable}"`);
+    const targetLocalesRef = sql.raw(`"${targetLocalesTable}"`);
+    // Build the WHERE filter as a single fragment so each query reuses it.
+    // Bound params are interpolated by drizzle.
+    const sinceParam = since ? sql`AND "created_at" >= ${since}` : sql``;
+    const untilParam = until ? sql`AND "created_at" <= ${until}` : sql``;
+    const whereClause = sql`WHERE 1 = 1 ${sinceParam} ${untilParam}`;
+    // ----- totals + truncation count (single row) -----
+    // ROUND2-2 canonical definitions:
+    //   - succeeded = status = 'succeeded' AND fields_translated > 0
+    //   - preserved = status = 'succeeded' AND COALESCE(fields_translated, 0) <= 0
+    //   - failed    = status = 'failed'
+    // Invariant: runs = succeeded + preserved + failed. The Hub Overview
+    // and Audit tabs both consume this endpoint and must report the same
+    // numbers for the same time window.
+    const totalsResult = await drizzle.execute(sql`
+      SELECT
+        COUNT(*)::bigint AS runs,
+        COALESCE(SUM(CASE WHEN "status" = 'succeeded' AND COALESCE("fields_translated", 0) > 0 THEN 1 ELSE 0 END), 0)::bigint AS succeeded,
+        COALESCE(SUM(CASE WHEN "status" = 'succeeded' AND COALESCE("fields_translated", 0) <= 0 THEN 1 ELSE 0 END), 0)::bigint AS preserved,
+        COALESCE(SUM(CASE WHEN "status" = 'failed' THEN 1 ELSE 0 END), 0)::bigint AS failed,
+        COALESCE(SUM("input_tokens"), 0)::numeric AS input_tokens,
+        COALESCE(SUM("output_tokens"), 0)::numeric AS output_tokens,
+        COALESCE(SUM("estimated_cost_usd"), 0)::numeric AS cost_usd
+      FROM ${usageRef}
+      ${whereClause}
+    `);
+    const totalsRow = totalsResult.rows?.[0] ?? {};
+    const runs = toFiniteNumber(totalsRow.runs);
+    const totals = {
+        runs,
+        succeeded: toFiniteNumber(totalsRow.succeeded),
+        preserved: toFiniteNumber(totalsRow.preserved),
+        failed: toFiniteNumber(totalsRow.failed),
+        inputTokens: toFiniteNumber(totalsRow.input_tokens),
+        outputTokens: toFiniteNumber(totalsRow.output_tokens),
+        costUsd: toFiniteNumber(totalsRow.cost_usd),
+        totalMatching: runs,
+        truncated: false
+    };
+    // ----- per-collection -----
+    const byCollectionResult = await drizzle.execute(sql`
+      SELECT
+        "slug",
+        "kind",
+        COUNT(*)::bigint AS runs,
+        COALESCE(SUM("input_tokens" + "output_tokens"), 0)::numeric AS tokens,
+        COALESCE(SUM("estimated_cost_usd"), 0)::numeric AS cost_usd
+      FROM ${usageRef}
+      ${whereClause}
+      GROUP BY "slug", "kind"
+      ORDER BY cost_usd DESC, runs DESC
+    `);
+    const byCollection = (byCollectionResult.rows ?? []).map((row)=>({
+            slug: typeof row.slug === 'string' ? row.slug : '—',
+            kind: row.kind === 'global' ? 'global' : 'collection',
+            runs: toFiniteNumber(row.runs),
+            tokens: toFiniteNumber(row.tokens),
+            costUsd: toFiniteNumber(row.cost_usd)
+        }));
+    // ----- per-model. Rows whose model is null/empty/provider-only
+    // (no slash) collapse into a single "__unresolved__" bucket so the
+    // UI's "Failed before model selection" pseudo-row stays accurate
+    // even when the dataset crosses the 1000-row boundary. Mirrors
+    // `isRealModelId` in AuditPanel.helpers.
+    const byModelResult = await drizzle.execute(sql`
+      SELECT
+        CASE
+          WHEN "model" IS NULL OR "model" = '' OR POSITION('/' IN "model") = 0
+            THEN '__unresolved__'
+          ELSE "model"
+        END AS model,
+        COUNT(*)::bigint AS runs,
+        COALESCE(SUM("input_tokens" + "output_tokens"), 0)::numeric AS tokens,
+        COALESCE(SUM("estimated_cost_usd"), 0)::numeric AS cost_usd
+      FROM ${usageRef}
+      ${whereClause}
+      GROUP BY model
+      ORDER BY cost_usd DESC, runs DESC
+    `);
+    const byModel = (byModelResult.rows ?? []).map((row)=>({
+            model: typeof row.model === 'string' ? row.model : '__unresolved__',
+            runs: toFiniteNumber(row.runs),
+            tokens: toFiniteNumber(row.tokens),
+            costUsd: toFiniteNumber(row.cost_usd)
+        }));
+    // ----- per-locale (join on target_locales) -----
+    // Locale rows are joined to the parent usage row so the same time
+    // filter applies. Counts both total target-locale entries and the
+    // ones marked `status = 'failed'`.
+    const byLocaleResult = await drizzle.execute(sql`
+      SELECT
+        tl."locale" AS locale,
+        COUNT(*)::bigint AS runs,
+        COALESCE(SUM(CASE WHEN tl."status" = 'failed' THEN 1 ELSE 0 END), 0)::bigint AS failed
+      FROM ${targetLocalesRef} AS tl
+      JOIN ${usageRef} AS u ON u."id" = tl."_parent_id"
+      WHERE 1 = 1
+        ${since ? sql`AND u."created_at" >= ${since}` : sql``}
+        ${until ? sql`AND u."created_at" <= ${until}` : sql``}
+      GROUP BY tl."locale"
+      ORDER BY runs DESC
+    `);
+    const byLocale = (byLocaleResult.rows ?? []).map((row)=>({
+            locale: typeof row.locale === 'string' ? row.locale : '—',
+            runs: toFiniteNumber(row.runs),
+            failed: toFiniteNumber(row.failed)
+        }));
+    return {
+        totals,
+        byCollection,
+        byModel,
+        byLocale
+    };
+}
+// ---------------------------------------------------------------------------
+// Fallback aggregation path (page-by-page payload.find)
+// ---------------------------------------------------------------------------
+// `targetLocales` join-table arrives as a nested array on each doc when
+// read via `payload.find`. The Postgres adapter only inflates it when
+// `depth > 0`, but reading `depth=0` returns the raw IDs. We use
+// `depth=1` for the fallback so per-locale counts are correct.
+const PAGINATION_LIMIT = 500;
+async function aggregateWithPayload(payload, usageSlug, since, until) {
+    const whereClauses = [];
+    if (since) whereClauses.push({
+        createdAt: {
+            greater_than_equal: since
+        }
+    });
+    if (until) whereClauses.push({
+        createdAt: {
+            less_than_equal: until
+        }
+    });
+    const where = whereClauses.length > 0 ? {
+        and: whereClauses
+    } : undefined;
+    let runs = 0;
+    let succeeded = 0;
+    let preserved = 0;
+    let failed = 0;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let costUsd = 0;
+    const perCollection = new Map();
+    const perModel = new Map();
+    const perLocale = new Map();
+    let page = 1;
+    // eslint-disable-next-line no-constant-condition
+    while(true){
+        const result = await payload.find({
+            collection: usageSlug,
+            where,
+            page,
+            limit: PAGINATION_LIMIT,
+            depth: 0,
+            overrideAccess: true
+        });
+        const docs = result.docs;
+        for (const r of docs){
+            runs++;
+            // ROUND2-2 canonical definitions — mirrors the drizzle path's
+            // CASE expressions. `fieldsTranslated > 0` separates LLM-write
+            // successes from preserve-only no-ops.
+            const fieldsTranslated = toFiniteNumber(r.fieldsTranslated);
+            if (r.status === 'succeeded' && fieldsTranslated > 0) succeeded++;
+            else if (r.status === 'succeeded') preserved++;
+            if (r.status === 'failed') failed++;
+            const inT = toFiniteNumber(r.inputTokens);
+            const outT = toFiniteNumber(r.outputTokens);
+            inputTokens += inT;
+            outputTokens += outT;
+            const cost = toFiniteNumber(r.estimatedCostUsd);
+            costUsd += cost;
+            const slug = typeof r.slug === 'string' ? r.slug : '—';
+            const kind = r.kind === 'global' ? 'global' : 'collection';
+            const collectionKey = `${kind}:${slug}`;
+            const cBucket = perCollection.get(collectionKey) ?? {
+                slug,
+                kind,
+                runs: 0,
+                tokens: 0,
+                costUsd: 0
+            };
+            cBucket.runs++;
+            cBucket.tokens += inT + outT;
+            cBucket.costUsd += cost;
+            perCollection.set(collectionKey, cBucket);
+            const modelRaw = typeof r.model === 'string' ? r.model : '';
+            const modelKey = modelRaw.length === 0 || !modelRaw.includes('/') ? '__unresolved__' : modelRaw;
+            const mBucket = perModel.get(modelKey) ?? {
+                model: modelKey,
+                runs: 0,
+                tokens: 0,
+                costUsd: 0
+            };
+            mBucket.runs++;
+            mBucket.tokens += inT + outT;
+            mBucket.costUsd += cost;
+            perModel.set(modelKey, mBucket);
+            for (const tl of r.targetLocales ?? []){
+                const locale = typeof tl?.locale === 'string' ? tl.locale : '—';
+                const lBucket = perLocale.get(locale) ?? {
+                    locale,
+                    runs: 0,
+                    failed: 0
+                };
+                lBucket.runs++;
+                if (tl?.status === 'failed') lBucket.failed++;
+                perLocale.set(locale, lBucket);
+            }
+        }
+        if (!result.hasNextPage) break;
+        page++;
+        // Safety cap — don't walk forever if pagination misreports.
+        if (page > 200) break;
+    }
+    return {
+        totals: {
+            runs,
+            succeeded,
+            preserved,
+            failed,
+            inputTokens,
+            outputTokens,
+            costUsd,
+            totalMatching: runs,
+            truncated: false
+        },
+        byCollection: Array.from(perCollection.values()).sort((a, b)=>b.costUsd - a.costUsd || b.runs - a.runs),
+        byModel: Array.from(perModel.values()).sort((a, b)=>b.costUsd - a.costUsd || b.runs - a.runs),
+        byLocale: Array.from(perLocale.values()).sort((a, b)=>b.runs - a.runs)
+    };
+}
+async function fetchRecentSamples(payload, usageSlug, since, until) {
+    const whereClauses = [];
+    if (since) whereClauses.push({
+        createdAt: {
+            greater_than_equal: since
+        }
+    });
+    if (until) whereClauses.push({
+        createdAt: {
+            less_than_equal: until
+        }
+    });
+    const where = whereClauses.length > 0 ? {
+        and: whereClauses
+    } : undefined;
+    const result = await payload.find({
+        collection: usageSlug,
+        where,
+        sort: '-createdAt',
+        limit: SAMPLES_LIMIT,
+        depth: 0,
+        overrideAccess: true
+    });
+    const docs = result.docs;
+    return docs.map((r)=>({
+            id: r.id ?? 0,
+            createdAt: typeof r.createdAt === 'string' ? r.createdAt : new Date(0).toISOString(),
+            slug: typeof r.slug === 'string' ? r.slug : '—',
+            kind: r.kind === 'global' ? 'global' : 'collection',
+            documentId: typeof r.documentId === 'string' ? r.documentId : null,
+            status: r.status === 'failed' ? 'failed' : 'succeeded',
+            model: typeof r.model === 'string' ? r.model : null,
+            inputTokens: toFiniteNumber(r.inputTokens),
+            outputTokens: toFiniteNumber(r.outputTokens),
+            estimatedCostUsd: r.estimatedCostUsd == null ? null : toFiniteNumber(r.estimatedCostUsd),
+            durationMs: r.durationMs == null ? null : toFiniteNumber(r.durationMs),
+            error: typeof r.error === 'string' ? r.error : null,
+            failedCount: toFiniteNumber(r.failedCount),
+            succeededCount: toFiniteNumber(r.succeededCount),
+            targetLocales: Array.isArray(r.targetLocales) ? r.targetLocales.map((tl)=>({
+                    locale: typeof tl?.locale === 'string' ? tl.locale : '',
+                    status: tl?.status ?? null
+                })) : null
+        }));
+}
+function toFiniteNumber(v) {
+    if (typeof v === 'number') {
+        return Number.isFinite(v) ? v : 0;
+    }
+    if (typeof v === 'string') {
+        // Postgres returns `numeric`/`bigint` as strings — coerce.
+        const n = Number.parseFloat(v);
+        return Number.isFinite(n) ? n : 0;
+    }
+    if (typeof v === 'bigint') {
+        return Number(v);
+    }
+    return 0;
+}

package/dist/exports/client.d.ts

@@ -0,0 +1,6 @@
+export { EstimatedCostCell } from '../client/estimated-cost-cell.js';
+export { ExcludedFieldsField } from '../client/excluded-fields-field.js';
+export { FieldTranslateButton } from '../client/field-translate-button.js';
+export { TranslateButton } from '../client/translate-button.js';
+export { TranslateModal } from '../client/translate-modal.js';
+export { TranslationProgress } from '../client/translation-progress.js';

package/dist/exports/client.js

@@ -0,0 +1,6 @@
+export { EstimatedCostCell } from '../client/estimated-cost-cell.js';
+export { ExcludedFieldsField } from '../client/excluded-fields-field.js';
+export { FieldTranslateButton } from '../client/field-translate-button.js';
+export { TranslateButton } from '../client/translate-button.js';
+export { TranslateModal } from '../client/translate-modal.js';
+export { TranslationProgress } from '../client/translation-progress.js';

package/dist/exports/components.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exports for admin-sidebar components shipped by the ai-translate
+ * plugin. Consumers wire these via `admin.components.beforeNavLinks`
+ * or `afterNavLinks` in their payload.config.ts.
+ */
+export { default, TranslationNavGroup } from '../components/TranslationNavGroup.js';

package/dist/exports/components.js

@@ -0,0 +1,5 @@
+/**
+ * Re-exports for admin-sidebar components shipped by the ai-translate
+ * plugin. Consumers wire these via `admin.components.beforeNavLinks`
+ * or `afterNavLinks` in their payload.config.ts.
+ */ export { default, TranslationNavGroup } from '../components/TranslationNavGroup.js';

package/dist/exports/index.d.ts

@@ -0,0 +1,8 @@
+export { translateDocument, translateGlobal } from '../api.js';
+export { ensureBulkTranslateSchema, migrateBatchStatusVocabulary, migrateHashesToV1Prefix, } from '../lib/bulk-translate-migrations.js';
+export { diffFields } from '../lib/field-diff.js';
+export { isFieldEmpty } from '../lib/field-empty.js';
+export { createScopedLogger, type LogContext, type LogEventFields, type LogLevel, type ScopedLogger, type SerializedError, serializeErr, } from '../lib/logger.js';
+export { type AcquireTokenResult, acquireToken, getBucketStatus, type TokenBucketOptions, } from '../lib/translation-token-bucket.js';
+export { aiTranslatePlugin } from '../plugin.js';
+export type { AITranslatePluginConfig, AutomationConfig, ConcurrencyLimits, CostGuardError, CostLimits, FieldLocaleResult, LexicalNodeRegistration, QualityConfig, RetryConfig, SamplingConfig, TargetPolicy, TranslateDocumentOptions, TranslateDocumentResult, TranslatedItem, TranslateGlobalOptions, TranslateRequest, TranslateResponse, TranslationAlert, TranslationAlertType, TranslationContext, TranslationEstimate, TranslationEvent, TranslationEventType, TranslationItem, TranslationItemKind, TranslationProvider, TranslationSample, TranslationUsage, ValidationConfig, } from '../types.js';

package/dist/exports/index.js

@@ -0,0 +1,7 @@
+export { translateDocument, translateGlobal } from '../api.js';
+export { ensureBulkTranslateSchema, migrateBatchStatusVocabulary, migrateHashesToV1Prefix } from '../lib/bulk-translate-migrations.js';
+export { diffFields } from '../lib/field-diff.js';
+export { isFieldEmpty } from '../lib/field-empty.js';
+export { createScopedLogger, serializeErr } from '../lib/logger.js';
+export { acquireToken, getBucketStatus } from '../lib/translation-token-bucket.js';
+export { aiTranslatePlugin } from '../plugin.js';

package/dist/exports/providers.d.ts

@@ -0,0 +1,9 @@
+export type { AnthropicProviderOptions } from '../providers/anthropic.js';
+export { createAnthropicProvider } from '../providers/anthropic.js';
+export type { CustomProviderOptions, CustomProviderPricing } from '../providers/custom.js';
+export { createCustomProvider } from '../providers/custom.js';
+export type { GeminiProviderOptions } from '../providers/gemini.js';
+export { createGeminiProvider } from '../providers/gemini.js';
+export { createMockProvider } from '../providers/mock.js';
+export type { OpenAIProviderOptions } from '../providers/openai.js';
+export { createOpenAIProvider } from '../providers/openai.js';

package/dist/exports/providers.js

@@ -0,0 +1,5 @@
+export { createAnthropicProvider } from '../providers/anthropic.js';
+export { createCustomProvider } from '../providers/custom.js';
+export { createGeminiProvider } from '../providers/gemini.js';
+export { createMockProvider } from '../providers/mock.js';
+export { createOpenAIProvider } from '../providers/openai.js';

package/dist/exports/views-client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Client-side surface for the Translation Hub view.
+ *
+ * Separated from `./views.ts` (the server entry) because tsup's single-
+ * bundle output strips `"use client"` directives from any sub-files
+ * (Hub.client.tsx, ActiveJobs.tsx, etc) — so the entire bundle would
+ * compile as a server component and React useState/useEffect would
+ * throw "useState only works in Client Components" at runtime.
+ *
+ * Two-entry split:
+ *   - `ai-translate-views` (server, no banner): exports `TranslationHubView`
+ *     which uses `DefaultTemplate` from `@payloadcms/next/templates` (server).
+ *   - `ai-translate-views-client` (this file, banner: '"use client";'): all
+ *     client sub-components.
+ *
+ * The server `index.tsx` imports `TranslationHubClient` via the package's
+ * own subpath `@purposeinplay/payload-ai-translate/views-client`, which
+ * is marked `external` in the server tsup config so it stays as an external
+ * import (resolved at runtime via package.json `exports`) instead of being
+ * inlined into the server bundle.
+ */
+export { BulkRunsHubClient } from '../views/BulkRunsHub/BulkRunsHub.client.js';
+export { TranslationHubClient } from '../views/TranslationHub/Hub.client.js';

package/dist/exports/views-client.js

@@ -0,0 +1,22 @@
+/**
+ * Client-side surface for the Translation Hub view.
+ *
+ * Separated from `./views.ts` (the server entry) because tsup's single-
+ * bundle output strips `"use client"` directives from any sub-files
+ * (Hub.client.tsx, ActiveJobs.tsx, etc) — so the entire bundle would
+ * compile as a server component and React useState/useEffect would
+ * throw "useState only works in Client Components" at runtime.
+ *
+ * Two-entry split:
+ *   - `ai-translate-views` (server, no banner): exports `TranslationHubView`
+ *     which uses `DefaultTemplate` from `@payloadcms/next/templates` (server).
+ *   - `ai-translate-views-client` (this file, banner: '"use client";'): all
+ *     client sub-components.
+ *
+ * The server `index.tsx` imports `TranslationHubClient` via the package's
+ * own subpath `@purposeinplay/payload-ai-translate/views-client`, which
+ * is marked `external` in the server tsup config so it stays as an external
+ * import (resolved at runtime via package.json `exports`) instead of being
+ * inlined into the server bundle.
+ */ export { BulkRunsHubClient } from '../views/BulkRunsHub/BulkRunsHub.client.js';
+export { TranslationHubClient } from '../views/TranslationHub/Hub.client.js';

package/dist/exports/views.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server-rendered admin views provided by the ai-translate plugin.
+ *
+ * Consumers wire these into Payload's `admin.components.views` config so the
+ * plugin owns the canonical UI surface — there's no copy-paste between
+ * consumer repos.
+ *
+ * Example (payload.config.ts):
+ *
+ *   import { TranslationHubView } from '@purposeinplay/payload-ai-translate/views'
+ *
+ *   admin: {
+ *     components: {
+ *       views: {
+ *         TranslationHub: {
+ *           Component: TranslationHubView,
+ *           path: '/translation',
+ *           // ...
+ *         },
+ *       },
+ *     },
+ *   }
+ *
+ * NOTE: This entry must NOT carry a "use client" banner — `TranslationHubView`
+ * is a Server Component that wraps the client `<TranslationHubClient />` in
+ * Payload's `<DefaultTemplate>`. The client subtree lives behind a
+ * `"use client"` directive in `Hub.client.tsx` and its children.
+ */
+export { BulkRunsHubView, default as BulkRunsHub } from '../views/BulkRunsHub/index.js';
+export { default as TranslationHub, TranslationHubView } from '../views/TranslationHub/index.js';

package/dist/exports/views.js

@@ -0,0 +1,29 @@
+/**
+ * Server-rendered admin views provided by the ai-translate plugin.
+ *
+ * Consumers wire these into Payload's `admin.components.views` config so the
+ * plugin owns the canonical UI surface — there's no copy-paste between
+ * consumer repos.
+ *
+ * Example (payload.config.ts):
+ *
+ *   import { TranslationHubView } from '@purposeinplay/payload-ai-translate/views'
+ *
+ *   admin: {
+ *     components: {
+ *       views: {
+ *         TranslationHub: {
+ *           Component: TranslationHubView,
+ *           path: '/translation',
+ *           // ...
+ *         },
+ *       },
+ *     },
+ *   }
+ *
+ * NOTE: This entry must NOT carry a "use client" banner — `TranslationHubView`
+ * is a Server Component that wraps the client `<TranslationHubClient />` in
+ * Payload's `<DefaultTemplate>`. The client subtree lives behind a
+ * `"use client"` directive in `Hub.client.tsx` and its children.
+ */ export { BulkRunsHubView, default as BulkRunsHub } from '../views/BulkRunsHub/index.js';
+export { default as TranslationHub, TranslationHubView } from '../views/TranslationHub/index.js';

package/dist/hooks/after-change-global.d.ts

@@ -0,0 +1,4 @@
+import type { GlobalAfterChangeHook } from 'payload';
+import type { CoalescingQueue } from '../lib/coalescing-queue.js';
+import type { AITranslatePluginConfig } from '../types.js';
+export declare function createTranslateGlobalAfterChangeHook(globalSlug: string, pluginOptions: AITranslatePluginConfig, queue?: CoalescingQueue | null): GlobalAfterChangeHook;