@happyvertical/smrt-languages 0.35.1 → 0.35.2

package/dist/chunks/{translation-job-DHg2E-eH.js → translation-job-BMzCflao.js}

@@ -49,9 +49,7 @@ let LanguageTranslationTask = class extends SmrtObject {
     if (await isAutoTranslateDisabled(args.tenantId ?? null, this.options)) {
       return { skipped: "feature_disabled" };
     }
-    const overrides = await LanguageOverrideCollection.create(
-      this.options
-    );
+    const overrides = await LanguageOverrideCollection.create(this.options);
     const existing = await overrides.getAppOverride(args.key, targetLocale);
     if (existing?.auto_generated && existing.source_hash === args.sourceHash) {
       return { skipped: "stale", template: existing.template };
@@ -283,4 +281,4 @@ export {
   TRANSLATION_PROMPT_KEY,
   enqueueTranslationJob
 };
-//# sourceMappingURL=translation-job-DHg2E-eH.js.map
+//# sourceMappingURL=translation-job-BMzCflao.js.map

package/dist/chunks/translation-job-BMzCflao.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-job-BMzCflao.js","sources":["../../src/translation-job.ts"],"sourcesContent":["import { type GetAIOptions, getAI } from '@happyvertical/ai';\nimport { createLogger } from '@happyvertical/logger';\nimport { getPackageConfig } from '@happyvertical/smrt-config';\nimport {\n  type SmrtClassOptions,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { FeatureResolver } from '@happyvertical/smrt-features';\nimport { SmrtJobCollection } from '@happyvertical/smrt-jobs';\nimport { definePrompt, resolvePrompt } from '@happyvertical/smrt-prompts';\nimport { invalidateLanguageCache } from './cache.js';\nimport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nimport { buildTenantGlossary } from './glossary.js';\nimport { LanguageRegistry } from './language-registry.js';\nimport type { LanguagesPackageConfig, TranslationJobPayload } from './types.js';\nimport {\n  buildTranslationJobId,\n  computeSourceHash,\n  normalizeLocale,\n} from './utils.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/** Feature flag key honored as the kill-switch for AI auto-translation. */\nexport const AUTO_TRANSLATE_FEATURE_KEY = 'smrt-languages.auto_translate';\n\n/**\n * Prompt key registered with `smrt-prompts` so ops can tune the AI translation\n * style without redeploying. The prompt itself is referenced by the job\n * handler when calling `@happyvertical/ai`.\n */\nexport const TRANSLATION_PROMPT_KEY = 'smrt-languages.translation';\n\n/**\n * Brace-containing example values that must reach the model verbatim. The\n * prompt renderer treats every `{...}` as a variable, so anything we want the\n * model to literally see (the placeholder syntax we're asking it to preserve,\n * the JSON shape we're asking it to return) is injected via a variable rather\n * than being baked into the static template.\n */\nconst PLACEHOLDER_EXAMPLE = '\"{name}\"';\nconst RESPONSE_SHAPE_EXAMPLE = '{\"translation\": \"Hola, {name}\"}';\n\ndefinePrompt({\n  key: TRANSLATION_PROMPT_KEY,\n  template:\n    'You translate user-facing application strings from {sourceLocale} to {targetLocale}.\\n' +\n    'Preserve any placeholders such as {placeholderExample} exactly as they appear, including the braces. Do not add markup or commentary.\\n' +\n    'Match the organization glossary where applicable:\\n{glossary}\\n' +\n    'String to translate: \"{template}\"\\n' +\n    'Reply with a JSON object shaped like {responseShapeExample} where the translation field is your translated string.',\n  editable: {\n    template: true,\n    profile: true,\n    model: true,\n    params: true,\n  },\n});\n\n/**\n * SmrtObject that owns the translation job's `execute` method. The TaskRunner\n * resolves jobs by `objectType` so the registered class name needs to match\n * what `enqueueTranslationJob` writes.\n */\n@smrt({\n  api: { include: [] },\n  cli: { include: [] },\n  mcp: { include: [] },\n})\nexport class LanguageTranslationTask extends SmrtObject {\n  /**\n   * Job-runner entrypoint. Reads the translation payload, calls\n   * `@happyvertical/ai`, and upserts a `LanguageOverride` row.\n   */\n  async execute(args: TranslationJobPayload): Promise<{\n    skipped?: 'feature_disabled' | 'not_supported' | 'budget' | 'stale';\n    template?: string;\n  }> {\n    if (!args || !args.key || !args.targetLocale || !args.sourceTemplate) {\n      throw new Error(\n        'LanguageTranslationTask.execute requires a translation payload',\n      );\n    }\n\n    const config = getLanguagesConfig();\n    const targetLocale = normalizeLocale(args.targetLocale);\n    const sourceLocale = normalizeLocale(args.sourceLocale);\n\n    // Locale allowlist (cheap pre-check before any AI / DB work).\n    if (\n      Array.isArray(config.supportedLocales) &&\n      config.supportedLocales.length > 0 &&\n      !config.supportedLocales.map(normalizeLocale).includes(targetLocale)\n    ) {\n      return { skipped: 'not_supported' };\n    }\n\n    // Feature flag kill switch (best-effort — never blocks if unavailable).\n    if (await isAutoTranslateDisabled(args.tenantId ?? null, this.options)) {\n      return { skipped: 'feature_disabled' };\n    }\n\n    const overrides = await LanguageOverrideCollection.create(this.options);\n\n    // Source-hash gate: if a translation already exists with the same source,\n    // do nothing. Only re-translate when the source changed.\n    const existing = await overrides.getAppOverride(args.key, targetLocale);\n    if (existing?.auto_generated && existing.source_hash === args.sourceHash) {\n      return { skipped: 'stale', template: existing.template };\n    }\n    if (existing && !existing.auto_generated) {\n      // Human-edited rows are never overwritten.\n      return { skipped: 'stale', template: existing.template };\n    }\n\n    // Per-tenant daily budget.\n    if (\n      args.tenantId &&\n      typeof config.translationBudgetPerTenantPerDay === 'number'\n    ) {\n      const used = await countTodayTenantTranslations(\n        this.options,\n        args.tenantId,\n      );\n      if (used >= config.translationBudgetPerTenantPerDay) {\n        return { skipped: 'budget' };\n      }\n    }\n\n    // Build glossary from tenant overrides (no-op when no tenant context).\n    let glossary = '';\n    if (args.tenantId) {\n      const tenantOverrides = await overrides.listTenantOverrides(\n        args.tenantId,\n      );\n      glossary = buildTenantGlossary(tenantOverrides, {\n        sourceLocale,\n        targetLocale,\n        max: 25,\n      });\n    }\n    if (!glossary) {\n      glossary = '(no organization glossary)';\n    }\n\n    // Pass the task's DB into resolvePrompt so any app/tenant-level prompt\n    // overrides stored in `_smrt_prompt_overrides` are honored — that's the\n    // whole reason we register the translation prompt with smrt-prompts in\n    // the first place.\n    const prompt = await resolvePrompt(TRANSLATION_PROMPT_KEY, {\n      db: this.options.db,\n      tenantId: args.tenantId ?? null,\n      variables: {\n        sourceLocale,\n        targetLocale,\n        template: args.sourceTemplate,\n        glossary,\n        placeholderExample: PLACEHOLDER_EXAMPLE,\n        responseShapeExample: RESPONSE_SHAPE_EXAMPLE,\n      },\n    });\n\n    // Single merged AI config: per-job model override (`args.model`) wins\n    // over the prompt's `ai.model`, and the same merge feeds both `getAI()`\n    // (client construction) and `ai.message()` (request options) so the\n    // override actually takes effect end-to-end.\n    const promptAi = (prompt.ai ?? {}) as Record<string, unknown>;\n    const mergedAiConfig: Record<string, unknown> = { ...promptAi };\n    if (args.model) mergedAiConfig.model = args.model;\n    const ai = await getAI(mergedAiConfig as GetAIOptions);\n\n    const message = await ai.message(prompt.text, {\n      ...mergedAiConfig,\n      responseFormat: { type: 'json_object' },\n    });\n\n    const translated = parseTranslationResponse(message);\n    if (!translated) {\n      throw new Error(\n        `LanguageTranslationTask: AI returned no usable translation for \"${args.key}\" → ${targetLocale}`,\n      );\n    }\n\n    if (containsObviousMarkupLeak(translated)) {\n      throw new Error(\n        `LanguageTranslationTask: refusing to persist suspicious translation for \"${args.key}\"`,\n      );\n    }\n\n    // Persist the model that actually produced the translation, not just the\n    // prompt's default — `args.model` overrides the prompt's `ai.model`.\n    const aiModel =\n      (args.model as string | undefined) ??\n      (promptAi.model as string | undefined) ??\n      null;\n    const sourceHash =\n      args.sourceHash || computeSourceHash(args.sourceTemplate);\n\n    if (existing) {\n      existing.template = translated;\n      existing.auto_generated = true;\n      existing.source_hash = sourceHash;\n      existing.ai_model = aiModel;\n      existing.reviewed_at = null;\n      existing.reviewed_by = null;\n      await existing.save();\n    } else {\n      // Use the collection's create() so the new row is initialized against\n      // the same DB the task is running on. Constructing `new LanguageOverride`\n      // directly leaves it un-initialized and `.save()` then trips on the\n      // \"Database accessed before initialization\" guard.\n      await overrides.create({\n        key: args.key,\n        locale: targetLocale,\n        tenantId: null,\n        template: translated,\n        auto_generated: true,\n        source_hash: sourceHash,\n        ai_model: aiModel,\n        reviewed_at: null,\n        reviewed_by: null,\n      });\n    }\n\n    invalidateLanguageCache(args.key, targetLocale, null, this.db);\n    return { template: translated };\n  }\n}\n\ninterface EnqueueTranslationOptions {\n  key: string;\n  targetLocale: string;\n  sourceLocale?: string;\n  tenantId?: string | null;\n  db: SmrtClassOptions['db'];\n  /** When true, skip the dedup check and force a fresh job. */\n  force?: boolean;\n}\n\n/**\n * Enqueue a translation job for `(key, targetLocale)`, deduplicated against\n * any already-pending job for the same target. Returns the (possibly existing)\n * job's deterministic ID.\n */\nexport async function enqueueTranslationJob(\n  options: EnqueueTranslationOptions,\n): Promise<{ id: string; status: 'enqueued' | 'duplicate' | 'skipped' }> {\n  const targetLocale = normalizeLocale(options.targetLocale);\n  const sourceLocale = normalizeLocale(options.sourceLocale ?? 'en');\n  const dedupId = buildTranslationJobId(options.key, targetLocale);\n\n  const definition = LanguageRegistry.get(options.key, sourceLocale);\n  if (!definition) {\n    return { id: dedupId, status: 'skipped' };\n  }\n\n  const config = getLanguagesConfig();\n  if (\n    Array.isArray(config.supportedLocales) &&\n    config.supportedLocales.length > 0 &&\n    !config.supportedLocales.map(normalizeLocale).includes(targetLocale)\n  ) {\n    return { id: dedupId, status: 'skipped' };\n  }\n\n  const jobs = await SmrtJobCollection.create({ db: options.db });\n\n  if (!options.force) {\n    const existing = await findPendingTranslationJob(\n      jobs,\n      options.key,\n      targetLocale,\n    );\n    if (existing) {\n      return { id: dedupId, status: 'duplicate' };\n    }\n  }\n\n  const payload: TranslationJobPayload = {\n    key: options.key,\n    sourceLocale,\n    sourceTemplate: definition.template,\n    sourceHash: definition.sourceHash,\n    targetLocale,\n    tenantId: options.tenantId ?? null,\n  };\n\n  // Stamp tenantId on the SmrtJob row so the per-tenant daily budget query\n  // (which filters by `tenantId`) actually counts this job. SmrtJob.save()\n  // will fall back to `getTenantId()` from AsyncLocalStorage when undefined,\n  // but we may be enqueueing from outside a tenant context (e.g. resolver\n  // miss with an explicit tenantId option), so set it explicitly here.\n  const job = await jobs.create({\n    queue: 'languages',\n    objectType: 'LanguageTranslationTask',\n    objectId: null,\n    method: 'execute',\n    tenantId: options.tenantId ?? null,\n    args: { ...payload, _dedupId: dedupId },\n    runAt: new Date(),\n    priority: 25,\n  });\n  await job.save();\n\n  return { id: dedupId, status: 'enqueued' };\n}\n\n/**\n * In-memory match cap for the dedup scan. We pull the most recently-queued\n * language jobs and check them in JS because querying inside a JSON column\n * portably across SQLite/Postgres is fiddly. If the working queue is deeper\n * than this, the scan truncates — when that happens we log a warning instead\n * of silently letting duplicate jobs slip through, and the handler's\n * source-hash gate (`execute()`) still prevents redundant AI calls. Tune via\n * `packages.languages.dedupScanLimit` if your steady-state pending queue\n * regularly exceeds the default.\n */\nconst DEFAULT_DEDUP_SCAN_LIMIT = 500;\n\nasync function findPendingTranslationJob(\n  jobs: SmrtJobCollection,\n  key: string,\n  targetLocale: string,\n): Promise<unknown | null> {\n  const dedupId = buildTranslationJobId(key, targetLocale);\n  const config = getLanguagesConfig();\n  const scanLimit =\n    typeof (config as { dedupScanLimit?: number }).dedupScanLimit === 'number'\n      ? (config as { dedupScanLimit: number }).dedupScanLimit\n      : DEFAULT_DEDUP_SCAN_LIMIT;\n\n  const rows = await jobs.list({\n    where: {\n      objectType: 'LanguageTranslationTask',\n      method: 'execute',\n      status: ['pending', 'running'],\n      queue: 'languages',\n    },\n    orderBy: 'createdAt DESC',\n    limit: scanLimit,\n  });\n\n  for (const row of rows) {\n    const args = (row as { args?: Record<string, unknown> }).args ?? {};\n    if (args._dedupId === dedupId) return row;\n    if (\n      args.key === key &&\n      typeof args.targetLocale === 'string' &&\n      normalizeLocale(args.targetLocale as string) === targetLocale\n    ) {\n      return row;\n    }\n  }\n\n  if (rows.length === scanLimit) {\n    // Don't crash; the handler's source-hash gate is the durable safeguard.\n    // But surface a warning so operators notice when the queue depth has\n    // outgrown the in-memory match window.\n    logger.warn(\n      `[smrt-languages] translation-job dedup scan hit its limit (${scanLimit}); raise packages.languages.dedupScanLimit if duplicate jobs appear`,\n    );\n  }\n  return null;\n}\n\nasync function countTodayTenantTranslations(\n  options: SmrtClassOptions,\n  tenantId: string,\n): Promise<number> {\n  // SmrtCollection.list() encodes operators into the where-clause key (e.g.\n  // `'createdAt >='`), not as `{ op, value }` objects — using the wrong shape\n  // either throws or matches nothing, and a swallowed failure here silently\n  // disables the budget. Let the call propagate so configuration mistakes\n  // surface immediately rather than as a missed throttle in production.\n  const jobs = await SmrtJobCollection.create({ db: options.db });\n  const since = new Date();\n  since.setUTCHours(0, 0, 0, 0);\n  const rows = await jobs.list({\n    where: {\n      objectType: 'LanguageTranslationTask',\n      method: 'execute',\n      tenantId,\n      'createdAt >=': since.toISOString(),\n    },\n  });\n  return rows.length;\n}\n\nfunction getLanguagesConfig(): LanguagesPackageConfig {\n  return getPackageConfig<LanguagesPackageConfig>('languages', {\n    defaultLocale: 'en',\n    overrides: {},\n  });\n}\n\nasync function isAutoTranslateDisabled(\n  tenantId: string | null,\n  options: SmrtClassOptions,\n): Promise<boolean> {\n  try {\n    const resolver = new FeatureResolver(options);\n    const enabled = await resolver.isEnabled(AUTO_TRANSLATE_FEATURE_KEY, {\n      tenantId: tenantId ?? undefined,\n    });\n    return enabled === false;\n  } catch {\n    // If features package can't resolve (no definition synced, etc.), default\n    // to enabled — operators opt out by registering the flag.\n    return false;\n  }\n}\n\nfunction parseTranslationResponse(\n  message: string | null | undefined,\n): string | null {\n  if (!message) return null;\n\n  // We requested `responseFormat: json_object` so the model is supposed to\n  // return a JSON object with a `translation` string. If parsing succeeds but\n  // the shape is wrong (e.g. `{\"text\":\"Hola\"}`), we MUST NOT fall through to\n  // the bare-string path — that would persist the whole JSON blob as the\n  // translation. Only the parse-failed branch may try to use the raw message\n  // as a literal string (some providers occasionally return prose despite\n  // the format hint).\n  let parseFailed = false;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(message);\n  } catch {\n    parseFailed = true;\n  }\n\n  if (!parseFailed) {\n    if (\n      parsed &&\n      typeof parsed === 'object' &&\n      !Array.isArray(parsed) &&\n      typeof (parsed as { translation?: unknown }).translation === 'string'\n    ) {\n      const cleaned = (parsed as { translation: string }).translation.trim();\n      return cleaned.length > 0 ? cleaned : null;\n    }\n    if (typeof parsed === 'string') {\n      const cleaned = parsed.trim();\n      return cleaned.length > 0 ? cleaned : null;\n    }\n    return null;\n  }\n\n  const trimmed = String(message).trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction containsObviousMarkupLeak(value: string): boolean {\n  // Cheap defense: refuse responses that look like raw HTML/system tags. We\n  // can tighten this in v1.1 once we have telemetry on real failure modes.\n  return /<\\/?(script|html|body|iframe|system)/i.test(value);\n}\n"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -1,11 +1,13 @@
 import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { SmrtObjectOptions } from '@happyvertical/smrt-core';
 
 /** `smrt languages approve <id> --reviewer=<user>` — mark reviewed. */
 export declare function approveAutoTranslation(options: {
     db: SmrtClassOptions['db'];
     id: string;
     reviewer: string;
-}): Promise<any>;
+}): Promise<LanguageOverride>;
 
 /** `smrt languages edit <id> --template=...` — human-edit suppresses auto-overwrites. */
 export declare function editLanguageOverride(options: {
@@ -13,14 +15,58 @@ export declare function editLanguageOverride(options: {
     id: string;
     template: string;
     reviewer?: string;
-}): Promise<any>;
+}): Promise<LanguageOverride>;
+
+declare class LanguageOverride extends SmrtObject {
+    key: string;
+    locale: string;
+    tenantId: string | null;
+    template: string;
+    /** True when this row was produced by the AI translation job. */
+    auto_generated: boolean;
+    /** sha256 of the source template at translation time, for re-translation gating. */
+    source_hash: string | null;
+    /** AI model identifier (null for human-edited rows). */
+    ai_model: string | null;
+    /** ISO timestamp marking admin review of an auto-generated row. */
+    reviewed_at: string | null;
+    /** User ID of the reviewer. */
+    reviewed_by: string | null;
+    constructor(options?: LanguageOverrideCtorOptions);
+    save(): Promise<this>;
+    private saveAfterIdentityChange;
+    private saveAfterIdentityChangeInTransaction;
+    private saveAfterIdentityChangeWithDeferredDelete;
+    delete(): Promise<void>;
+    /**
+     * Mark this auto-generated row as reviewed by an admin. Useful for the
+     * admin review queue surfaced via `smrt languages approve <id>`.
+     */
+    approve(reviewerId: string): Promise<this>;
+    private getPersistedIdentity;
+}
+
+declare interface LanguageOverrideCtorOptions extends SmrtObjectOptions, LanguageOverrideOptions {
+}
+
+declare interface LanguageOverrideOptions {
+    key?: string;
+    locale?: string;
+    tenantId?: string | null;
+    template?: string;
+    auto_generated?: boolean;
+    source_hash?: string | null;
+    ai_model?: string | null;
+    reviewed_at?: string | null;
+    reviewed_by?: string | null;
+}
 
 /** `smrt languages review --locale=es` — list unreviewed auto-translations. */
 export declare function listUnreviewedAutoTranslations(options: {
     db: SmrtClassOptions['db'];
     locale?: string;
     limit?: number;
-}): Promise<any>;
+}): Promise<LanguageOverride[]>;
 
 /**
  * Implementation of `smrt languages translate --locales=es,fr`.

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { L as LanguageOverrideCollection, n as normalizeLocale, a as LanguageRegistry } from "./chunks/language-registry-CgsuwQo6.js";
-import { enqueueTranslationJob } from "./chunks/translation-job-DHg2E-eH.js";
+import { enqueueTranslationJob } from "./chunks/translation-job-BMzCflao.js";
 async function translateMissing(options) {
   const sourceLocale = normalizeLocale(options.sourceLocale ?? "en");
   const targets = options.locales.map(normalizeLocale).filter(Boolean);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["import type { SmrtClassOptions } from '@happyvertical/smrt-core';\nimport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nimport { LanguageRegistry } from './language-registry.js';\nimport { enqueueTranslationJob } from './translation-job.js';\nimport { normalizeLocale } from './utils.js';\n\n/**\n * Implementation of `smrt languages translate --locales=es,fr`.\n *\n * Walks the registered code defaults and enqueues a translation job for every\n * `(key, locale)` pair that does not yet have an app-level override. The job\n * itself respects the same dedup / budget / allowlist rules as the resolver's\n * miss-path enqueue.\n */\nexport async function translateMissing(options: {\n  locales: string[];\n  sourceLocale?: string;\n  db: SmrtClassOptions['db'];\n  tenantId?: string | null;\n}): Promise<{\n  enqueued: string[];\n  skipped: string[];\n}> {\n  const sourceLocale = normalizeLocale(options.sourceLocale ?? 'en');\n  const targets = options.locales.map(normalizeLocale).filter(Boolean);\n  const overrides = await (LanguageOverrideCollection as any).create({\n    db: options.db,\n  });\n\n  const enqueued: string[] = [];\n  const skipped: string[] = [];\n\n  for (const definition of LanguageRegistry.getAll()) {\n    if (definition.locale !== sourceLocale) continue;\n\n    for (const target of targets) {\n      if (target === sourceLocale) continue;\n      const existing = await overrides.getAppOverride(definition.key, target);\n      // Human edits win permanently — never enqueue an AI translation job for\n      // a row that an admin has curated, even if the source has changed. The\n      // CLAUDE.md spec calls this out and the job handler enforces the same\n      // rule, but we prefer to skip at the enqueue layer so we don't burn\n      // queue budget on work the handler is going to discard.\n      if (existing && !existing.auto_generated) {\n        skipped.push(`${definition.key}:${target}`);\n        continue;\n      }\n      if (existing && existing.source_hash === definition.sourceHash) {\n        skipped.push(`${definition.key}:${target}`);\n        continue;\n      }\n\n      const result = await enqueueTranslationJob({\n        key: definition.key,\n        targetLocale: target,\n        sourceLocale,\n        tenantId: options.tenantId ?? null,\n        db: options.db,\n      });\n\n      if (result.status === 'enqueued') {\n        enqueued.push(`${definition.key}:${target}`);\n      } else {\n        skipped.push(`${definition.key}:${target}`);\n      }\n    }\n  }\n\n  return { enqueued, skipped };\n}\n\n/** `smrt languages review --locale=es` — list unreviewed auto-translations. */\nexport async function listUnreviewedAutoTranslations(options: {\n  db: SmrtClassOptions['db'];\n  locale?: string;\n  limit?: number;\n}) {\n  const overrides = await (LanguageOverrideCollection as any).create({\n    db: options.db,\n  });\n  return overrides.listUnreviewedAutoTranslations({\n    locale: options.locale,\n    limit: options.limit,\n  });\n}\n\n/** `smrt languages approve <id> --reviewer=<user>` — mark reviewed. */\nexport async function approveAutoTranslation(options: {\n  db: SmrtClassOptions['db'];\n  id: string;\n  reviewer: string;\n}) {\n  const overrides = await (LanguageOverrideCollection as any).create({\n    db: options.db,\n  });\n  const row = await overrides.get({ id: options.id });\n  if (!row) {\n    throw new Error(`LanguageOverride \"${options.id}\" not found`);\n  }\n  return row.approve(options.reviewer);\n}\n\n/** `smrt languages edit <id> --template=...` — human-edit suppresses auto-overwrites. */\nexport async function editLanguageOverride(options: {\n  db: SmrtClassOptions['db'];\n  id: string;\n  template: string;\n  reviewer?: string;\n}) {\n  const overrides = await (LanguageOverrideCollection as any).create({\n    db: options.db,\n  });\n  const row = await overrides.get({ id: options.id });\n  if (!row) {\n    throw new Error(`LanguageOverride \"${options.id}\" not found`);\n  }\n  row.template = options.template;\n  row.auto_generated = false;\n  row.ai_model = null;\n  if (options.reviewer) {\n    row.reviewed_at = new Date().toISOString();\n    row.reviewed_by = options.reviewer;\n  }\n  await row.save();\n  return row;\n}\n"],"names":[],"mappings":";;AAcA,eAAsB,iBAAiB,SAQpC;AACD,QAAM,eAAe,gBAAgB,QAAQ,gBAAgB,IAAI;AACjE,QAAM,UAAU,QAAQ,QAAQ,IAAI,eAAe,EAAE,OAAO,OAAO;AACnE,QAAM,YAAY,MAAO,2BAAmC,OAAO;AAAA,IACjE,IAAI,QAAQ;AAAA,EAAA,CACb;AAED,QAAM,WAAqB,CAAA;AAC3B,QAAM,UAAoB,CAAA;AAE1B,aAAW,cAAc,iBAAiB,UAAU;AAClD,QAAI,WAAW,WAAW,aAAc;AAExC,eAAW,UAAU,SAAS;AAC5B,UAAI,WAAW,aAAc;AAC7B,YAAM,WAAW,MAAM,UAAU,eAAe,WAAW,KAAK,MAAM;AAMtE,UAAI,YAAY,CAAC,SAAS,gBAAgB;AACxC,gBAAQ,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAC1C;AAAA,MACF;AACA,UAAI,YAAY,SAAS,gBAAgB,WAAW,YAAY;AAC9D,gBAAQ,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAC1C;AAAA,MACF;AAEA,YAAM,SAAS,MAAM,sBAAsB;AAAA,QACzC,KAAK,WAAW;AAAA,QAChB,cAAc;AAAA,QACd;AAAA,QACA,UAAU,QAAQ,YAAY;AAAA,QAC9B,IAAI,QAAQ;AAAA,MAAA,CACb;AAED,UAAI,OAAO,WAAW,YAAY;AAChC,iBAAS,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAAA,MAC7C,OAAO;AACL,gBAAQ,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,UAAU,QAAA;AACrB;AAGA,eAAsB,+BAA+B,SAIlD;AACD,QAAM,YAAY,MAAO,2BAAmC,OAAO;AAAA,IACjE,IAAI,QAAQ;AAAA,EAAA,CACb;AACD,SAAO,UAAU,+BAA+B;AAAA,IAC9C,QAAQ,QAAQ;AAAA,IAChB,OAAO,QAAQ;AAAA,EAAA,CAChB;AACH;AAGA,eAAsB,uBAAuB,SAI1C;AACD,QAAM,YAAY,MAAO,2BAAmC,OAAO;AAAA,IACjE,IAAI,QAAQ;AAAA,EAAA,CACb;AACD,QAAM,MAAM,MAAM,UAAU,IAAI,EAAE,IAAI,QAAQ,IAAI;AAClD,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qBAAqB,QAAQ,EAAE,aAAa;AAAA,EAC9D;AACA,SAAO,IAAI,QAAQ,QAAQ,QAAQ;AACrC;AAGA,eAAsB,qBAAqB,SAKxC;AACD,QAAM,YAAY,MAAO,2BAAmC,OAAO;AAAA,IACjE,IAAI,QAAQ;AAAA,EAAA,CACb;AACD,QAAM,MAAM,MAAM,UAAU,IAAI,EAAE,IAAI,QAAQ,IAAI;AAClD,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qBAAqB,QAAQ,EAAE,aAAa;AAAA,EAC9D;AACA,MAAI,WAAW,QAAQ;AACvB,MAAI,iBAAiB;AACrB,MAAI,WAAW;AACf,MAAI,QAAQ,UAAU;AACpB,QAAI,eAAc,oBAAI,KAAA,GAAO,YAAA;AAC7B,QAAI,cAAc,QAAQ;AAAA,EAC5B;AACA,QAAM,IAAI,KAAA;AACV,SAAO;AACT;"}
+{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["import type { SmrtClassOptions } from '@happyvertical/smrt-core';\nimport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nimport { LanguageRegistry } from './language-registry.js';\nimport { enqueueTranslationJob } from './translation-job.js';\nimport { normalizeLocale } from './utils.js';\n\n/**\n * Implementation of `smrt languages translate --locales=es,fr`.\n *\n * Walks the registered code defaults and enqueues a translation job for every\n * `(key, locale)` pair that does not yet have an app-level override. The job\n * itself respects the same dedup / budget / allowlist rules as the resolver's\n * miss-path enqueue.\n */\nexport async function translateMissing(options: {\n  locales: string[];\n  sourceLocale?: string;\n  db: SmrtClassOptions['db'];\n  tenantId?: string | null;\n}): Promise<{\n  enqueued: string[];\n  skipped: string[];\n}> {\n  const sourceLocale = normalizeLocale(options.sourceLocale ?? 'en');\n  const targets = options.locales.map(normalizeLocale).filter(Boolean);\n  const overrides = await LanguageOverrideCollection.create({\n    db: options.db,\n  });\n\n  const enqueued: string[] = [];\n  const skipped: string[] = [];\n\n  for (const definition of LanguageRegistry.getAll()) {\n    if (definition.locale !== sourceLocale) continue;\n\n    for (const target of targets) {\n      if (target === sourceLocale) continue;\n      const existing = await overrides.getAppOverride(definition.key, target);\n      // Human edits win permanently — never enqueue an AI translation job for\n      // a row that an admin has curated, even if the source has changed. The\n      // CLAUDE.md spec calls this out and the job handler enforces the same\n      // rule, but we prefer to skip at the enqueue layer so we don't burn\n      // queue budget on work the handler is going to discard.\n      if (existing && !existing.auto_generated) {\n        skipped.push(`${definition.key}:${target}`);\n        continue;\n      }\n      if (existing && existing.source_hash === definition.sourceHash) {\n        skipped.push(`${definition.key}:${target}`);\n        continue;\n      }\n\n      const result = await enqueueTranslationJob({\n        key: definition.key,\n        targetLocale: target,\n        sourceLocale,\n        tenantId: options.tenantId ?? null,\n        db: options.db,\n      });\n\n      if (result.status === 'enqueued') {\n        enqueued.push(`${definition.key}:${target}`);\n      } else {\n        skipped.push(`${definition.key}:${target}`);\n      }\n    }\n  }\n\n  return { enqueued, skipped };\n}\n\n/** `smrt languages review --locale=es` — list unreviewed auto-translations. */\nexport async function listUnreviewedAutoTranslations(options: {\n  db: SmrtClassOptions['db'];\n  locale?: string;\n  limit?: number;\n}) {\n  const overrides = await LanguageOverrideCollection.create({\n    db: options.db,\n  });\n  return overrides.listUnreviewedAutoTranslations({\n    locale: options.locale,\n    limit: options.limit,\n  });\n}\n\n/** `smrt languages approve <id> --reviewer=<user>` — mark reviewed. */\nexport async function approveAutoTranslation(options: {\n  db: SmrtClassOptions['db'];\n  id: string;\n  reviewer: string;\n}) {\n  const overrides = await LanguageOverrideCollection.create({\n    db: options.db,\n  });\n  const row = await overrides.get({ id: options.id });\n  if (!row) {\n    throw new Error(`LanguageOverride \"${options.id}\" not found`);\n  }\n  return row.approve(options.reviewer);\n}\n\n/** `smrt languages edit <id> --template=...` — human-edit suppresses auto-overwrites. */\nexport async function editLanguageOverride(options: {\n  db: SmrtClassOptions['db'];\n  id: string;\n  template: string;\n  reviewer?: string;\n}) {\n  const overrides = await LanguageOverrideCollection.create({\n    db: options.db,\n  });\n  const row = await overrides.get({ id: options.id });\n  if (!row) {\n    throw new Error(`LanguageOverride \"${options.id}\" not found`);\n  }\n  row.template = options.template;\n  row.auto_generated = false;\n  row.ai_model = null;\n  if (options.reviewer) {\n    row.reviewed_at = new Date().toISOString();\n    row.reviewed_by = options.reviewer;\n  }\n  await row.save();\n  return row;\n}\n"],"names":[],"mappings":";;AAcA,eAAsB,iBAAiB,SAQpC;AACD,QAAM,eAAe,gBAAgB,QAAQ,gBAAgB,IAAI;AACjE,QAAM,UAAU,QAAQ,QAAQ,IAAI,eAAe,EAAE,OAAO,OAAO;AACnE,QAAM,YAAY,MAAM,2BAA2B,OAAO;AAAA,IACxD,IAAI,QAAQ;AAAA,EAAA,CACb;AAED,QAAM,WAAqB,CAAA;AAC3B,QAAM,UAAoB,CAAA;AAE1B,aAAW,cAAc,iBAAiB,UAAU;AAClD,QAAI,WAAW,WAAW,aAAc;AAExC,eAAW,UAAU,SAAS;AAC5B,UAAI,WAAW,aAAc;AAC7B,YAAM,WAAW,MAAM,UAAU,eAAe,WAAW,KAAK,MAAM;AAMtE,UAAI,YAAY,CAAC,SAAS,gBAAgB;AACxC,gBAAQ,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAC1C;AAAA,MACF;AACA,UAAI,YAAY,SAAS,gBAAgB,WAAW,YAAY;AAC9D,gBAAQ,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAC1C;AAAA,MACF;AAEA,YAAM,SAAS,MAAM,sBAAsB;AAAA,QACzC,KAAK,WAAW;AAAA,QAChB,cAAc;AAAA,QACd;AAAA,QACA,UAAU,QAAQ,YAAY;AAAA,QAC9B,IAAI,QAAQ;AAAA,MAAA,CACb;AAED,UAAI,OAAO,WAAW,YAAY;AAChC,iBAAS,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAAA,MAC7C,OAAO;AACL,gBAAQ,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,UAAU,QAAA;AACrB;AAGA,eAAsB,+BAA+B,SAIlD;AACD,QAAM,YAAY,MAAM,2BAA2B,OAAO;AAAA,IACxD,IAAI,QAAQ;AAAA,EAAA,CACb;AACD,SAAO,UAAU,+BAA+B;AAAA,IAC9C,QAAQ,QAAQ;AAAA,IAChB,OAAO,QAAQ;AAAA,EAAA,CAChB;AACH;AAGA,eAAsB,uBAAuB,SAI1C;AACD,QAAM,YAAY,MAAM,2BAA2B,OAAO;AAAA,IACxD,IAAI,QAAQ;AAAA,EAAA,CACb;AACD,QAAM,MAAM,MAAM,UAAU,IAAI,EAAE,IAAI,QAAQ,IAAI;AAClD,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qBAAqB,QAAQ,EAAE,aAAa;AAAA,EAC9D;AACA,SAAO,IAAI,QAAQ,QAAQ,QAAQ;AACrC;AAGA,eAAsB,qBAAqB,SAKxC;AACD,QAAM,YAAY,MAAM,2BAA2B,OAAO;AAAA,IACxD,IAAI,QAAQ;AAAA,EAAA,CACb;AACD,QAAM,MAAM,MAAM,UAAU,IAAI,EAAE,IAAI,QAAQ,IAAI;AAClD,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qBAAqB,QAAQ,EAAE,aAAa;AAAA,EAC9D;AACA,MAAI,WAAW,QAAQ;AACvB,MAAI,iBAAiB;AACrB,MAAI,WAAW;AACf,MAAI,QAAQ,UAAU;AACpB,QAAI,eAAc,oBAAI,KAAA,GAAO,YAAA;AAC7B,QAAI,cAAc,QAAQ;AAAA,EAC5B;AACA,QAAM,IAAI,KAAA;AACV,SAAO;AACT;"}

package/dist/index.js

@@ -206,7 +206,7 @@ async function tryEnqueueTranslation(args) {
     return;
   }
   try {
-    const { enqueueTranslationJob } = await import("./chunks/translation-job-DHg2E-eH.js");
+    const { enqueueTranslationJob } = await import("./chunks/translation-job-BMzCflao.js");
     await enqueueTranslationJob({
       key: args.key,
       targetLocale: args.requestedLocale,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/__smrt-register__.ts","../src/language-resolver.ts","../src/index.ts"],"sourcesContent":["/**\n * Self-registers this package's build-time manifest before any @smrt()\n * decorator in the package fires. Same pattern as smrt-prompts — see\n * packages/prompts/src/__smrt-register__.ts and issue #1132 for context.\n */\nimport { ObjectRegistry } from '@happyvertical/smrt-core';\n\nObjectRegistry.registerPackageManifest(\n  new URL('./manifest.json', import.meta.url),\n);\n","import { getPackageConfig } from '@happyvertical/smrt-config';\nimport { getTenantId } from '@happyvertical/smrt-tenancy';\nimport {\n  getCachedLanguage,\n  invalidateLanguageCache,\n  setCachedLanguage,\n} from './cache.js';\nimport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nimport { LanguageRegistry } from './language-registry.js';\nimport type {\n  LanguageCacheValue,\n  LanguagesPackageConfig,\n  ResolvedLanguageString,\n  ResolveLanguageStringOptions,\n} from './types.js';\nimport {\n  buildLocaleFallbackChain,\n  normalizeLocale,\n  renderTemplate,\n} from './utils.js';\n\nconst DEFAULT_LOCALE = 'en';\n\nfunction getLanguagesConfig(): LanguagesPackageConfig {\n  return getPackageConfig<LanguagesPackageConfig>('languages', {\n    defaultLocale: DEFAULT_LOCALE,\n    overrides: {},\n  });\n}\n\ninterface ResolutionAttempt {\n  template: string | null;\n  source: ResolvedLanguageString['source'];\n  resolvedFromLocale: string;\n}\n\nasync function resolveBaseForLocale(\n  key: string,\n  locale: string,\n  options: ResolveLanguageStringOptions,\n  config: LanguagesPackageConfig,\n): Promise<ResolutionAttempt> {\n  const tenantId =\n    options.tenantId !== undefined ? options.tenantId : (getTenantId() ?? null);\n\n  let collection: LanguageOverrideCollection | null = null;\n  if (options.db) {\n    collection = await (LanguageOverrideCollection as any).create({\n      db: options.db,\n    });\n  }\n\n  const cacheDb = collection?.db ?? options.db;\n  const cached = getCachedLanguage(key, locale, tenantId, cacheDb);\n  if (cached) {\n    return {\n      template: cached.template,\n      source: cached.source,\n      resolvedFromLocale: cached.resolvedFromLocale,\n    };\n  }\n\n  // 1. Tenant override (highest precedence among stored layers).\n  if (collection && tenantId) {\n    const tenantOverride = await collection.getTenantOverride(\n      key,\n      locale,\n      tenantId,\n    );\n    if (tenantOverride) {\n      return finalize({\n        key,\n        locale,\n        tenantId,\n        db: cacheDb,\n        attempt: {\n          template: tenantOverride.template,\n          source: 'tenant',\n          resolvedFromLocale: locale,\n        },\n      });\n    }\n  }\n\n  // 2. App-level override (incl. AI auto-translations).\n  if (collection) {\n    const appOverride = await collection.getAppOverride(key, locale);\n    if (appOverride) {\n      return finalize({\n        key,\n        locale,\n        tenantId,\n        db: cacheDb,\n        attempt: {\n          template: appOverride.template,\n          source: 'app',\n          resolvedFromLocale: locale,\n        },\n      });\n    }\n  }\n\n  // 3. File-config override. Locale keys in user-authored config files\n  // commonly come in mixed case (`fr-ca`, `Fr-CA`, etc.); normalize lookup so\n  // config matches the same way the DB and code-default layers do.\n  const configForKey = config.overrides?.[key];\n  const configTemplate = lookupNormalizedLocale(configForKey, locale);\n  if (typeof configTemplate === 'string') {\n    return finalize({\n      key,\n      locale,\n      tenantId,\n      db: cacheDb,\n      attempt: {\n        template: configTemplate,\n        source: 'config',\n        resolvedFromLocale: locale,\n      },\n    });\n  }\n\n  // 4. Code default.\n  const definition = LanguageRegistry.get(key, locale);\n  if (definition) {\n    return finalize({\n      key,\n      locale,\n      tenantId,\n      db: cacheDb,\n      attempt: {\n        template: definition.template,\n        source: 'code',\n        resolvedFromLocale: locale,\n      },\n    });\n  }\n\n  return {\n    template: null,\n    source: 'missing',\n    resolvedFromLocale: locale,\n  };\n}\n\nfunction lookupNormalizedLocale(\n  bag: Record<string, string> | undefined,\n  locale: string,\n): string | undefined {\n  if (!bag) return undefined;\n  // Fast path: exact match (most file configs use the canonical form).\n  if (typeof bag[locale] === 'string') return bag[locale];\n  for (const [candidate, template] of Object.entries(bag)) {\n    if (normalizeLocale(candidate) === locale) {\n      return template;\n    }\n  }\n  return undefined;\n}\n\nfunction finalize(args: {\n  key: string;\n  locale: string;\n  tenantId: string | null;\n  db: unknown;\n  attempt: ResolutionAttempt;\n}): ResolutionAttempt {\n  if (args.attempt.template !== null) {\n    const value: LanguageCacheValue = {\n      key: args.key,\n      locale: args.locale,\n      template: args.attempt.template,\n      source: args.attempt.source,\n      resolvedFromLocale: args.attempt.resolvedFromLocale,\n    };\n    setCachedLanguage(args.key, args.locale, args.tenantId, args.db, value);\n  }\n  return args.attempt;\n}\n\nexport async function resolveLanguageString(\n  key: string,\n  options: ResolveLanguageStringOptions = {},\n): Promise<ResolvedLanguageString> {\n  if (!key || key.trim() === '') {\n    throw new Error('resolveLanguageString requires a non-empty key');\n  }\n\n  const config = getLanguagesConfig();\n  const defaultLocale = normalizeLocale(config.defaultLocale ?? DEFAULT_LOCALE);\n  const requested = normalizeLocale(options.locale ?? defaultLocale);\n\n  // Runtime override always wins, regardless of locale chain.\n  if (typeof options.overrides?.template === 'string') {\n    return {\n      key,\n      locale: requested,\n      template: options.overrides.template,\n      text: renderTemplate(options.overrides.template, options.vars),\n      resolvedFromLocale: requested,\n      source: 'runtime',\n    };\n  }\n\n  const chain = buildLocaleFallbackChain(requested, defaultLocale);\n\n  let firstHit: ResolutionAttempt | null = null;\n  let firstLocale = requested;\n  for (const locale of chain) {\n    const attempt = await resolveBaseForLocale(key, locale, options, config);\n    if (attempt.template !== null) {\n      firstHit = attempt;\n      firstLocale = locale;\n      break;\n    }\n  }\n\n  if (!firstHit) {\n    if (options.strict) {\n      throw new Error(\n        `Language string \"${key}\" has no resolution for locale \"${requested}\"`,\n      );\n    }\n    // Soft-miss: enqueue translation if the requested locale differs from the\n    // default and a default-locale source exists. Failure of the enqueue path\n    // must never break resolution — we still return the key as the rendered\n    // text so the UI degrades gracefully.\n    await tryEnqueueTranslation({\n      key,\n      requestedLocale: requested,\n      defaultLocale,\n      options,\n    });\n    return {\n      key,\n      locale: requested,\n      template: key,\n      text: key,\n      resolvedFromLocale: requested,\n      source: 'missing',\n    };\n  }\n\n  // Hit at a fallback locale that isn't the requested one — fire-and-forget a\n  // translation job for the requested target.\n  if (firstLocale !== requested) {\n    await tryEnqueueTranslation({\n      key,\n      requestedLocale: requested,\n      defaultLocale,\n      options,\n    });\n    return {\n      key,\n      locale: requested,\n      template: firstHit.template ?? key,\n      text: renderTemplate(firstHit.template ?? key, options.vars),\n      resolvedFromLocale: firstLocale,\n      source: 'fallback',\n    };\n  }\n\n  return {\n    key,\n    locale: requested,\n    template: firstHit.template ?? key,\n    text: renderTemplate(firstHit.template ?? key, options.vars),\n    resolvedFromLocale: firstLocale,\n    source: firstHit.source,\n  };\n}\n\n/**\n * Best-effort enqueue of an AI translation job. Wrapped so resolution never\n * fails because of an enqueue error, missing optional dependency, etc.\n *\n * The actual job machinery lives in `./translation-job.ts` and is loaded\n * lazily so the resolver does not pull `@happyvertical/ai` into the import\n * graph for synchronous resolves that never miss.\n */\nasync function tryEnqueueTranslation(args: {\n  key: string;\n  requestedLocale: string;\n  defaultLocale: string;\n  options: ResolveLanguageStringOptions;\n}): Promise<void> {\n  if (!args.options.db) {\n    // Without a DB we cannot persist a job; skip silently — resolver still\n    // returns a fallback to the caller.\n    return;\n  }\n  if (normalizeLocale(args.requestedLocale) === args.defaultLocale) {\n    return;\n  }\n\n  try {\n    const { enqueueTranslationJob } = await import('./translation-job.js');\n    await enqueueTranslationJob({\n      key: args.key,\n      targetLocale: args.requestedLocale,\n      sourceLocale: args.defaultLocale,\n      tenantId: args.options.tenantId ?? getTenantId() ?? null,\n      db: args.options.db,\n    });\n  } catch {\n    // Enqueueing must never break resolution.\n  }\n}\n\nexport function invalidateResolvedLanguageCache(\n  key: string,\n  locale: string,\n  tenantId: string | null | undefined,\n  db: unknown,\n): void {\n  invalidateLanguageCache(key, locale, tenantId, db);\n}\n","/**\n * @happyvertical/smrt-languages\n *\n * Code-first language strings with config + tenant overrides and AI-driven\n * auto-translation for SMRT applications. Mirrors the architecture of\n * `@happyvertical/smrt-prompts` plus a smrt-jobs handler that fills gaps in\n * non-default locales the first time a string is requested.\n *\n * The package root intentionally exposes only the read path\n * (`defineLanguageString`, `resolveLanguageString`, `LanguageOverride`, the\n * cache helpers, glossary helpers, and shared types/utilities). The\n * translation-worker stack — which depends on `@happyvertical/ai`,\n * smrt-jobs, smrt-features, and smrt-prompts — lives on the\n * `@happyvertical/smrt-languages/jobs` subpath, and the admin CLI helpers\n * live on `@happyvertical/smrt-languages/cli`. Resolver consumers (the vast\n * majority of call sites) never load the worker dependency tree.\n *\n * @packageDocumentation\n */\n\nimport './__smrt-register__.js';\n\nexport {\n  clearLanguageCache,\n  getLanguageCacheTtlMs,\n  invalidateLanguageCache,\n} from './cache.js';\nexport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nexport { buildTenantGlossary } from './glossary.js';\n\nexport {\n  defineLanguageString,\n  LanguageRegistry,\n} from './language-registry.js';\n\nexport {\n  invalidateResolvedLanguageCache,\n  resolveLanguageString,\n} from './language-resolver.js';\n\nexport {\n  LanguageOverride,\n  type LanguageOverrideCtorOptions,\n} from './models/LanguageOverride.js';\n\nexport type {\n  LanguageCacheValue,\n  LanguageOverrideOptions,\n  LanguageStringDefinition,\n  LanguageStringDefinitionInput,\n  LanguagesPackageConfig,\n  LanguageVariables,\n  ResolvedLanguageString,\n  ResolveLanguageStringOptions,\n} from './types.js';\n\nexport {\n  buildLocaleFallbackChain,\n  buildTranslationJobId,\n  computeSourceHash,\n  normalizeLocale,\n  renderTemplate,\n} from './utils.js';\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"names":[],"mappings":";;;;;AAOA,eAAe;AAAA,EACb,IAAA,IAAA,mBAAA,YAAA,GAAA;AACF;ACYA,MAAM,iBAAiB;AAEvB,SAAS,qBAA6C;AACpD,SAAO,iBAAyC,aAAa;AAAA,IAC3D,eAAe;AAAA,IACf,WAAW,CAAA;AAAA,EAAC,CACb;AACH;AAQA,eAAe,qBACb,KACA,QACA,SACA,QAC4B;AAC5B,QAAM,WACJ,QAAQ,aAAa,SAAY,QAAQ,WAAY,iBAAiB;AAExE,MAAI,aAAgD;AACpD,MAAI,QAAQ,IAAI;AACd,iBAAa,MAAO,2BAAmC,OAAO;AAAA,MAC5D,IAAI,QAAQ;AAAA,IAAA,CACb;AAAA,EACH;AAEA,QAAM,UAAU,YAAY,MAAM,QAAQ;AAC1C,QAAM,SAAS,kBAAkB,KAAK,QAAQ,UAAU,OAAO;AAC/D,MAAI,QAAQ;AACV,WAAO;AAAA,MACL,UAAU,OAAO;AAAA,MACjB,QAAQ,OAAO;AAAA,MACf,oBAAoB,OAAO;AAAA,IAAA;AAAA,EAE/B;AAGA,MAAI,cAAc,UAAU;AAC1B,UAAM,iBAAiB,MAAM,WAAW;AAAA,MACtC;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAEF,QAAI,gBAAgB;AAClB,aAAO,SAAS;AAAA,QACd;AAAA,QACA;AAAA,QACA;AAAA,QACA,IAAI;AAAA,QACJ,SAAS;AAAA,UACP,UAAU,eAAe;AAAA,UACzB,QAAQ;AAAA,UACR,oBAAoB;AAAA,QAAA;AAAA,MACtB,CACD;AAAA,IACH;AAAA,EACF;AAGA,MAAI,YAAY;AACd,UAAM,cAAc,MAAM,WAAW,eAAe,KAAK,MAAM;AAC/D,QAAI,aAAa;AACf,aAAO,SAAS;AAAA,QACd;AAAA,QACA;AAAA,QACA;AAAA,QACA,IAAI;AAAA,QACJ,SAAS;AAAA,UACP,UAAU,YAAY;AAAA,UACtB,QAAQ;AAAA,UACR,oBAAoB;AAAA,QAAA;AAAA,MACtB,CACD;AAAA,IACH;AAAA,EACF;AAKA,QAAM,eAAe,OAAO,YAAY,GAAG;AAC3C,QAAM,iBAAiB,uBAAuB,cAAc,MAAM;AAClE,MAAI,OAAO,mBAAmB,UAAU;AACtC,WAAO,SAAS;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI;AAAA,MACJ,SAAS;AAAA,QACP,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,oBAAoB;AAAA,MAAA;AAAA,IACtB,CACD;AAAA,EACH;AAGA,QAAM,aAAa,iBAAiB,IAAI,KAAK,MAAM;AACnD,MAAI,YAAY;AACd,WAAO,SAAS;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI;AAAA,MACJ,SAAS;AAAA,QACP,UAAU,WAAW;AAAA,QACrB,QAAQ;AAAA,QACR,oBAAoB;AAAA,MAAA;AAAA,IACtB,CACD;AAAA,EACH;AAEA,SAAO;AAAA,IACL,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,oBAAoB;AAAA,EAAA;AAExB;AAEA,SAAS,uBACP,KACA,QACoB;AACpB,MAAI,CAAC,IAAK,QAAO;AAEjB,MAAI,OAAO,IAAI,MAAM,MAAM,SAAU,QAAO,IAAI,MAAM;AACtD,aAAW,CAAC,WAAW,QAAQ,KAAK,OAAO,QAAQ,GAAG,GAAG;AACvD,QAAI,gBAAgB,SAAS,MAAM,QAAQ;AACzC,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,SAAS,MAMI;AACpB,MAAI,KAAK,QAAQ,aAAa,MAAM;AAClC,UAAM,QAA4B;AAAA,MAChC,KAAK,KAAK;AAAA,MACV,QAAQ,KAAK;AAAA,MACb,UAAU,KAAK,QAAQ;AAAA,MACvB,QAAQ,KAAK,QAAQ;AAAA,MACrB,oBAAoB,KAAK,QAAQ;AAAA,IAAA;AAEnC,sBAAkB,KAAK,KAAK,KAAK,QAAQ,KAAK,UAAU,KAAK,IAAI,KAAK;AAAA,EACxE;AACA,SAAO,KAAK;AACd;AAEA,eAAsB,sBACpB,KACA,UAAwC,IACP;AACjC,MAAI,CAAC,OAAO,IAAI,KAAA,MAAW,IAAI;AAC7B,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AAEA,QAAM,SAAS,mBAAA;AACf,QAAM,gBAAgB,gBAAgB,OAAO,iBAAiB,cAAc;AAC5E,QAAM,YAAY,gBAAgB,QAAQ,UAAU,aAAa;AAGjE,MAAI,OAAO,QAAQ,WAAW,aAAa,UAAU;AACnD,WAAO;AAAA,MACL;AAAA,MACA,QAAQ;AAAA,MACR,UAAU,QAAQ,UAAU;AAAA,MAC5B,MAAM,eAAe,QAAQ,UAAU,UAAU,QAAQ,IAAI;AAAA,MAC7D,oBAAoB;AAAA,MACpB,QAAQ;AAAA,IAAA;AAAA,EAEZ;AAEA,QAAM,QAAQ,yBAAyB,WAAW,aAAa;AAE/D,MAAI,WAAqC;AACzC,MAAI,cAAc;AAClB,aAAW,UAAU,OAAO;AAC1B,UAAM,UAAU,MAAM,qBAAqB,KAAK,QAAQ,SAAS,MAAM;AACvE,QAAI,QAAQ,aAAa,MAAM;AAC7B,iBAAW;AACX,oBAAc;AACd;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,UAAU;AACb,QAAI,QAAQ,QAAQ;AAClB,YAAM,IAAI;AAAA,QACR,oBAAoB,GAAG,mCAAmC,SAAS;AAAA,MAAA;AAAA,IAEvE;AAKA,UAAM,sBAAsB;AAAA,MAC1B;AAAA,MACA,iBAAiB;AAAA,MACjB;AAAA,MACA;AAAA,IAAA,CACD;AACD,WAAO;AAAA,MACL;AAAA,MACA,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,MAAM;AAAA,MACN,oBAAoB;AAAA,MACpB,QAAQ;AAAA,IAAA;AAAA,EAEZ;AAIA,MAAI,gBAAgB,WAAW;AAC7B,UAAM,sBAAsB;AAAA,MAC1B;AAAA,MACA,iBAAiB;AAAA,MACjB;AAAA,MACA;AAAA,IAAA,CACD;AACD,WAAO;AAAA,MACL;AAAA,MACA,QAAQ;AAAA,MACR,UAAU,SAAS,YAAY;AAAA,MAC/B,MAAM,eAAe,SAAS,YAAY,KAAK,QAAQ,IAAI;AAAA,MAC3D,oBAAoB;AAAA,MACpB,QAAQ;AAAA,IAAA;AAAA,EAEZ;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,IACR,UAAU,SAAS,YAAY;AAAA,IAC/B,MAAM,eAAe,SAAS,YAAY,KAAK,QAAQ,IAAI;AAAA,IAC3D,oBAAoB;AAAA,IACpB,QAAQ,SAAS;AAAA,EAAA;AAErB;AAUA,eAAe,sBAAsB,MAKnB;AAChB,MAAI,CAAC,KAAK,QAAQ,IAAI;AAGpB;AAAA,EACF;AACA,MAAI,gBAAgB,KAAK,eAAe,MAAM,KAAK,eAAe;AAChE;AAAA,EACF;AAEA,MAAI;AACF,UAAM,EAAE,sBAAA,IAA0B,MAAM,OAAO,sCAAsB;AACrE,UAAM,sBAAsB;AAAA,MAC1B,KAAK,KAAK;AAAA,MACV,cAAc,KAAK;AAAA,MACnB,cAAc,KAAK;AAAA,MACnB,UAAU,KAAK,QAAQ,YAAY,iBAAiB;AAAA,MACpD,IAAI,KAAK,QAAQ;AAAA,IAAA,CAClB;AAAA,EACH,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,gCACd,KACA,QACA,UACA,IACM;AACN,0BAAwB,KAAK,QAAQ,UAAU,EAAE;AACnD;AC1PO,MAAM,8BAA8B;"}
+{"version":3,"file":"index.js","sources":["../src/__smrt-register__.ts","../src/language-resolver.ts","../src/index.ts"],"sourcesContent":["/**\n * Self-registers this package's build-time manifest before any @smrt()\n * decorator in the package fires. Same pattern as smrt-prompts — see\n * packages/prompts/src/__smrt-register__.ts and issue #1132 for context.\n */\nimport { ObjectRegistry } from '@happyvertical/smrt-core';\n\nObjectRegistry.registerPackageManifest(\n  new URL('./manifest.json', import.meta.url),\n);\n","import { getPackageConfig } from '@happyvertical/smrt-config';\nimport { getTenantId } from '@happyvertical/smrt-tenancy';\nimport {\n  getCachedLanguage,\n  invalidateLanguageCache,\n  setCachedLanguage,\n} from './cache.js';\nimport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nimport { LanguageRegistry } from './language-registry.js';\nimport type {\n  LanguageCacheValue,\n  LanguagesPackageConfig,\n  ResolvedLanguageString,\n  ResolveLanguageStringOptions,\n} from './types.js';\nimport {\n  buildLocaleFallbackChain,\n  normalizeLocale,\n  renderTemplate,\n} from './utils.js';\n\nconst DEFAULT_LOCALE = 'en';\n\nfunction getLanguagesConfig(): LanguagesPackageConfig {\n  return getPackageConfig<LanguagesPackageConfig>('languages', {\n    defaultLocale: DEFAULT_LOCALE,\n    overrides: {},\n  });\n}\n\ninterface ResolutionAttempt {\n  template: string | null;\n  source: ResolvedLanguageString['source'];\n  resolvedFromLocale: string;\n}\n\nasync function resolveBaseForLocale(\n  key: string,\n  locale: string,\n  options: ResolveLanguageStringOptions,\n  config: LanguagesPackageConfig,\n): Promise<ResolutionAttempt> {\n  const tenantId =\n    options.tenantId !== undefined ? options.tenantId : (getTenantId() ?? null);\n\n  let collection: LanguageOverrideCollection | null = null;\n  if (options.db) {\n    collection = await LanguageOverrideCollection.create({\n      db: options.db,\n    });\n  }\n\n  const cacheDb = collection?.db ?? options.db;\n  const cached = getCachedLanguage(key, locale, tenantId, cacheDb);\n  if (cached) {\n    return {\n      template: cached.template,\n      source: cached.source,\n      resolvedFromLocale: cached.resolvedFromLocale,\n    };\n  }\n\n  // 1. Tenant override (highest precedence among stored layers).\n  if (collection && tenantId) {\n    const tenantOverride = await collection.getTenantOverride(\n      key,\n      locale,\n      tenantId,\n    );\n    if (tenantOverride) {\n      return finalize({\n        key,\n        locale,\n        tenantId,\n        db: cacheDb,\n        attempt: {\n          template: tenantOverride.template,\n          source: 'tenant',\n          resolvedFromLocale: locale,\n        },\n      });\n    }\n  }\n\n  // 2. App-level override (incl. AI auto-translations).\n  if (collection) {\n    const appOverride = await collection.getAppOverride(key, locale);\n    if (appOverride) {\n      return finalize({\n        key,\n        locale,\n        tenantId,\n        db: cacheDb,\n        attempt: {\n          template: appOverride.template,\n          source: 'app',\n          resolvedFromLocale: locale,\n        },\n      });\n    }\n  }\n\n  // 3. File-config override. Locale keys in user-authored config files\n  // commonly come in mixed case (`fr-ca`, `Fr-CA`, etc.); normalize lookup so\n  // config matches the same way the DB and code-default layers do.\n  const configForKey = config.overrides?.[key];\n  const configTemplate = lookupNormalizedLocale(configForKey, locale);\n  if (typeof configTemplate === 'string') {\n    return finalize({\n      key,\n      locale,\n      tenantId,\n      db: cacheDb,\n      attempt: {\n        template: configTemplate,\n        source: 'config',\n        resolvedFromLocale: locale,\n      },\n    });\n  }\n\n  // 4. Code default.\n  const definition = LanguageRegistry.get(key, locale);\n  if (definition) {\n    return finalize({\n      key,\n      locale,\n      tenantId,\n      db: cacheDb,\n      attempt: {\n        template: definition.template,\n        source: 'code',\n        resolvedFromLocale: locale,\n      },\n    });\n  }\n\n  return {\n    template: null,\n    source: 'missing',\n    resolvedFromLocale: locale,\n  };\n}\n\nfunction lookupNormalizedLocale(\n  bag: Record<string, string> | undefined,\n  locale: string,\n): string | undefined {\n  if (!bag) return undefined;\n  // Fast path: exact match (most file configs use the canonical form).\n  if (typeof bag[locale] === 'string') return bag[locale];\n  for (const [candidate, template] of Object.entries(bag)) {\n    if (normalizeLocale(candidate) === locale) {\n      return template;\n    }\n  }\n  return undefined;\n}\n\nfunction finalize(args: {\n  key: string;\n  locale: string;\n  tenantId: string | null;\n  db: unknown;\n  attempt: ResolutionAttempt;\n}): ResolutionAttempt {\n  if (args.attempt.template !== null) {\n    const value: LanguageCacheValue = {\n      key: args.key,\n      locale: args.locale,\n      template: args.attempt.template,\n      source: args.attempt.source,\n      resolvedFromLocale: args.attempt.resolvedFromLocale,\n    };\n    setCachedLanguage(args.key, args.locale, args.tenantId, args.db, value);\n  }\n  return args.attempt;\n}\n\nexport async function resolveLanguageString(\n  key: string,\n  options: ResolveLanguageStringOptions = {},\n): Promise<ResolvedLanguageString> {\n  if (!key || key.trim() === '') {\n    throw new Error('resolveLanguageString requires a non-empty key');\n  }\n\n  const config = getLanguagesConfig();\n  const defaultLocale = normalizeLocale(config.defaultLocale ?? DEFAULT_LOCALE);\n  const requested = normalizeLocale(options.locale ?? defaultLocale);\n\n  // Runtime override always wins, regardless of locale chain.\n  if (typeof options.overrides?.template === 'string') {\n    return {\n      key,\n      locale: requested,\n      template: options.overrides.template,\n      text: renderTemplate(options.overrides.template, options.vars),\n      resolvedFromLocale: requested,\n      source: 'runtime',\n    };\n  }\n\n  const chain = buildLocaleFallbackChain(requested, defaultLocale);\n\n  let firstHit: ResolutionAttempt | null = null;\n  let firstLocale = requested;\n  for (const locale of chain) {\n    const attempt = await resolveBaseForLocale(key, locale, options, config);\n    if (attempt.template !== null) {\n      firstHit = attempt;\n      firstLocale = locale;\n      break;\n    }\n  }\n\n  if (!firstHit) {\n    if (options.strict) {\n      throw new Error(\n        `Language string \"${key}\" has no resolution for locale \"${requested}\"`,\n      );\n    }\n    // Soft-miss: enqueue translation if the requested locale differs from the\n    // default and a default-locale source exists. Failure of the enqueue path\n    // must never break resolution — we still return the key as the rendered\n    // text so the UI degrades gracefully.\n    await tryEnqueueTranslation({\n      key,\n      requestedLocale: requested,\n      defaultLocale,\n      options,\n    });\n    return {\n      key,\n      locale: requested,\n      template: key,\n      text: key,\n      resolvedFromLocale: requested,\n      source: 'missing',\n    };\n  }\n\n  // Hit at a fallback locale that isn't the requested one — fire-and-forget a\n  // translation job for the requested target.\n  if (firstLocale !== requested) {\n    await tryEnqueueTranslation({\n      key,\n      requestedLocale: requested,\n      defaultLocale,\n      options,\n    });\n    return {\n      key,\n      locale: requested,\n      template: firstHit.template ?? key,\n      text: renderTemplate(firstHit.template ?? key, options.vars),\n      resolvedFromLocale: firstLocale,\n      source: 'fallback',\n    };\n  }\n\n  return {\n    key,\n    locale: requested,\n    template: firstHit.template ?? key,\n    text: renderTemplate(firstHit.template ?? key, options.vars),\n    resolvedFromLocale: firstLocale,\n    source: firstHit.source,\n  };\n}\n\n/**\n * Best-effort enqueue of an AI translation job. Wrapped so resolution never\n * fails because of an enqueue error, missing optional dependency, etc.\n *\n * The actual job machinery lives in `./translation-job.ts` and is loaded\n * lazily so the resolver does not pull `@happyvertical/ai` into the import\n * graph for synchronous resolves that never miss.\n */\nasync function tryEnqueueTranslation(args: {\n  key: string;\n  requestedLocale: string;\n  defaultLocale: string;\n  options: ResolveLanguageStringOptions;\n}): Promise<void> {\n  if (!args.options.db) {\n    // Without a DB we cannot persist a job; skip silently — resolver still\n    // returns a fallback to the caller.\n    return;\n  }\n  if (normalizeLocale(args.requestedLocale) === args.defaultLocale) {\n    return;\n  }\n\n  try {\n    const { enqueueTranslationJob } = await import('./translation-job.js');\n    await enqueueTranslationJob({\n      key: args.key,\n      targetLocale: args.requestedLocale,\n      sourceLocale: args.defaultLocale,\n      tenantId: args.options.tenantId ?? getTenantId() ?? null,\n      db: args.options.db,\n    });\n  } catch {\n    // Enqueueing must never break resolution.\n  }\n}\n\nexport function invalidateResolvedLanguageCache(\n  key: string,\n  locale: string,\n  tenantId: string | null | undefined,\n  db: unknown,\n): void {\n  invalidateLanguageCache(key, locale, tenantId, db);\n}\n","/**\n * @happyvertical/smrt-languages\n *\n * Code-first language strings with config + tenant overrides and AI-driven\n * auto-translation for SMRT applications. Mirrors the architecture of\n * `@happyvertical/smrt-prompts` plus a smrt-jobs handler that fills gaps in\n * non-default locales the first time a string is requested.\n *\n * The package root intentionally exposes only the read path\n * (`defineLanguageString`, `resolveLanguageString`, `LanguageOverride`, the\n * cache helpers, glossary helpers, and shared types/utilities). The\n * translation-worker stack — which depends on `@happyvertical/ai`,\n * smrt-jobs, smrt-features, and smrt-prompts — lives on the\n * `@happyvertical/smrt-languages/jobs` subpath, and the admin CLI helpers\n * live on `@happyvertical/smrt-languages/cli`. Resolver consumers (the vast\n * majority of call sites) never load the worker dependency tree.\n *\n * @packageDocumentation\n */\n\nimport './__smrt-register__.js';\n\nexport {\n  clearLanguageCache,\n  getLanguageCacheTtlMs,\n  invalidateLanguageCache,\n} from './cache.js';\nexport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nexport { buildTenantGlossary } from './glossary.js';\n\nexport {\n  defineLanguageString,\n  LanguageRegistry,\n} from './language-registry.js';\n\nexport {\n  invalidateResolvedLanguageCache,\n  resolveLanguageString,\n} from './language-resolver.js';\n\nexport {\n  LanguageOverride,\n  type LanguageOverrideCtorOptions,\n} from './models/LanguageOverride.js';\n\nexport type {\n  LanguageCacheValue,\n  LanguageOverrideOptions,\n  LanguageStringDefinition,\n  LanguageStringDefinitionInput,\n  LanguagesPackageConfig,\n  LanguageVariables,\n  ResolvedLanguageString,\n  ResolveLanguageStringOptions,\n} from './types.js';\n\nexport {\n  buildLocaleFallbackChain,\n  buildTranslationJobId,\n  computeSourceHash,\n  normalizeLocale,\n  renderTemplate,\n} from './utils.js';\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"names":[],"mappings":"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"}

package/dist/jobs.d.ts

@@ -1,3 +1,4 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
 import { SmrtObject } from '@happyvertical/smrt-core';
 
 /** Feature flag key honored as the kill-switch for AI auto-translation. */
@@ -18,7 +19,7 @@ declare interface EnqueueTranslationOptions {
     targetLocale: string;
     sourceLocale?: string;
     tenantId?: string | null;
-    db: unknown;
+    db: SmrtClassOptions['db'];
     /** When true, skip the dedup check and force a fresh job. */
     force?: boolean;
 }

package/dist/jobs.js

@@ -1,4 +1,4 @@
-import { AUTO_TRANSLATE_FEATURE_KEY, LanguageTranslationTask, TRANSLATION_PROMPT_KEY, enqueueTranslationJob } from "./chunks/translation-job-DHg2E-eH.js";
+import { AUTO_TRANSLATE_FEATURE_KEY, LanguageTranslationTask, TRANSLATION_PROMPT_KEY, enqueueTranslationJob } from "./chunks/translation-job-BMzCflao.js";
 export {
   AUTO_TRANSLATE_FEATURE_KEY,
   LanguageTranslationTask,

package/dist/manifest.json

@@ -1,8 +1,8 @@
 {
   "version": "1.0.0",
-  "timestamp": 1782335301761,
+  "timestamp": 1782340080331,
   "packageName": "@happyvertical/smrt-languages",
-  "packageVersion": "0.35.1",
+  "packageVersion": "0.35.2",
   "objects": {
     "@happyvertical/smrt-languages:LanguageTranslationTask": {
       "name": "languagetranslationtask",

package/dist/smrt-knowledge.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-06-24T21:08:30.550Z",
+  "generatedAt": "2026-06-24T22:28:07.778Z",
   "packageName": "@happyvertical/smrt-languages",
-  "packageVersion": "0.35.1",
+  "packageVersion": "0.35.2",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "822864927076cca2cc1794311020fb2f6ef86e8bee6cfa4b66b40c8a27d832da",
-    "packageJson": "e66458fbe9985f17ab9e0ad1252e58e4fd5c9984a422604137a14f4657dc1cf9",
+    "manifest": "2106ac794120da509e5cb27df6a79b2fb1bb8f09d42b5390bce7e7a08bd52602",
+    "packageJson": "847daadf0b7288dab5a9cb9f4b2bed7be157aff07f43527d7a69e761f4c3fcd0",
     "agents": "6dc270bd9bb9c51d48f526396544ab2a54a071c42f60869f4806520818f7e864"
   },
   "exports": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-languages",
-  "version": "0.35.1",
+  "version": "0.35.2",
   "description": "Code-first language strings with config + tenant overrides and AI auto-translation for SMRT",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,20 +30,20 @@
     "@happyvertical/ai": "^0.74.7",
     "@happyvertical/logger": "^0.74.7",
     "@happyvertical/sql": "^0.74.7",
-    "@happyvertical/smrt-config": "0.35.1",
-    "@happyvertical/smrt-core": "0.35.1",
-    "@happyvertical/smrt-features": "0.35.1",
-    "@happyvertical/smrt-jobs": "0.35.1",
-    "@happyvertical/smrt-prompts": "0.35.1",
-    "@happyvertical/smrt-tenancy": "0.35.1"
+    "@happyvertical/smrt-config": "0.35.2",
+    "@happyvertical/smrt-core": "0.35.2",
+    "@happyvertical/smrt-jobs": "0.35.2",
+    "@happyvertical/smrt-features": "0.35.2",
+    "@happyvertical/smrt-prompts": "0.35.2",
+    "@happyvertical/smrt-tenancy": "0.35.2"
   },
   "devDependencies": {
     "@types/node": "24.10.9",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vitest": "^4.0.17",
-    "@happyvertical/smrt-cli": "0.35.1",
-    "@happyvertical/smrt-vitest": "0.35.1"
+    "@happyvertical/smrt-cli": "0.35.2",
+    "@happyvertical/smrt-vitest": "0.35.2"
   },
   "keywords": [
     "smrt",

package/dist/chunks/translation-job-DHg2E-eH.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"translation-job-DHg2E-eH.js","sources":["../../src/translation-job.ts"],"sourcesContent":["import { getAI } from '@happyvertical/ai';\nimport { createLogger } from '@happyvertical/logger';\nimport { getPackageConfig } from '@happyvertical/smrt-config';\nimport { SmrtObject, smrt } from '@happyvertical/smrt-core';\nimport { FeatureResolver } from '@happyvertical/smrt-features';\nimport { SmrtJobCollection } from '@happyvertical/smrt-jobs';\nimport { definePrompt, resolvePrompt } from '@happyvertical/smrt-prompts';\nimport { invalidateLanguageCache } from './cache.js';\nimport { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';\nimport { buildTenantGlossary } from './glossary.js';\nimport { LanguageRegistry } from './language-registry.js';\nimport type { LanguagesPackageConfig, TranslationJobPayload } from './types.js';\nimport {\n  buildTranslationJobId,\n  computeSourceHash,\n  normalizeLocale,\n} from './utils.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/** Feature flag key honored as the kill-switch for AI auto-translation. */\nexport const AUTO_TRANSLATE_FEATURE_KEY = 'smrt-languages.auto_translate';\n\n/**\n * Prompt key registered with `smrt-prompts` so ops can tune the AI translation\n * style without redeploying. The prompt itself is referenced by the job\n * handler when calling `@happyvertical/ai`.\n */\nexport const TRANSLATION_PROMPT_KEY = 'smrt-languages.translation';\n\n/**\n * Brace-containing example values that must reach the model verbatim. The\n * prompt renderer treats every `{...}` as a variable, so anything we want the\n * model to literally see (the placeholder syntax we're asking it to preserve,\n * the JSON shape we're asking it to return) is injected via a variable rather\n * than being baked into the static template.\n */\nconst PLACEHOLDER_EXAMPLE = '\"{name}\"';\nconst RESPONSE_SHAPE_EXAMPLE = '{\"translation\": \"Hola, {name}\"}';\n\ndefinePrompt({\n  key: TRANSLATION_PROMPT_KEY,\n  template:\n    'You translate user-facing application strings from {sourceLocale} to {targetLocale}.\\n' +\n    'Preserve any placeholders such as {placeholderExample} exactly as they appear, including the braces. Do not add markup or commentary.\\n' +\n    'Match the organization glossary where applicable:\\n{glossary}\\n' +\n    'String to translate: \"{template}\"\\n' +\n    'Reply with a JSON object shaped like {responseShapeExample} where the translation field is your translated string.',\n  editable: {\n    template: true,\n    profile: true,\n    model: true,\n    params: true,\n  },\n});\n\n/**\n * SmrtObject that owns the translation job's `execute` method. The TaskRunner\n * resolves jobs by `objectType` so the registered class name needs to match\n * what `enqueueTranslationJob` writes.\n */\n@smrt({\n  api: { include: [] },\n  cli: { include: [] },\n  mcp: { include: [] },\n})\nexport class LanguageTranslationTask extends SmrtObject {\n  /**\n   * Job-runner entrypoint. Reads the translation payload, calls\n   * `@happyvertical/ai`, and upserts a `LanguageOverride` row.\n   */\n  async execute(args: TranslationJobPayload): Promise<{\n    skipped?: 'feature_disabled' | 'not_supported' | 'budget' | 'stale';\n    template?: string;\n  }> {\n    if (!args || !args.key || !args.targetLocale || !args.sourceTemplate) {\n      throw new Error(\n        'LanguageTranslationTask.execute requires a translation payload',\n      );\n    }\n\n    const config = getLanguagesConfig();\n    const targetLocale = normalizeLocale(args.targetLocale);\n    const sourceLocale = normalizeLocale(args.sourceLocale);\n\n    // Locale allowlist (cheap pre-check before any AI / DB work).\n    if (\n      Array.isArray(config.supportedLocales) &&\n      config.supportedLocales.length > 0 &&\n      !config.supportedLocales.map(normalizeLocale).includes(targetLocale)\n    ) {\n      return { skipped: 'not_supported' };\n    }\n\n    // Feature flag kill switch (best-effort — never blocks if unavailable).\n    if (await isAutoTranslateDisabled(args.tenantId ?? null, this.options)) {\n      return { skipped: 'feature_disabled' };\n    }\n\n    const overrides = await (LanguageOverrideCollection as any).create(\n      this.options,\n    );\n\n    // Source-hash gate: if a translation already exists with the same source,\n    // do nothing. Only re-translate when the source changed.\n    const existing = await overrides.getAppOverride(args.key, targetLocale);\n    if (existing?.auto_generated && existing.source_hash === args.sourceHash) {\n      return { skipped: 'stale', template: existing.template };\n    }\n    if (existing && !existing.auto_generated) {\n      // Human-edited rows are never overwritten.\n      return { skipped: 'stale', template: existing.template };\n    }\n\n    // Per-tenant daily budget.\n    if (\n      args.tenantId &&\n      typeof config.translationBudgetPerTenantPerDay === 'number'\n    ) {\n      const used = await countTodayTenantTranslations(\n        this.options,\n        args.tenantId,\n      );\n      if (used >= config.translationBudgetPerTenantPerDay) {\n        return { skipped: 'budget' };\n      }\n    }\n\n    // Build glossary from tenant overrides (no-op when no tenant context).\n    let glossary = '';\n    if (args.tenantId) {\n      const tenantOverrides = await overrides.listTenantOverrides(\n        args.tenantId,\n      );\n      glossary = buildTenantGlossary(tenantOverrides, {\n        sourceLocale,\n        targetLocale,\n        max: 25,\n      });\n    }\n    if (!glossary) {\n      glossary = '(no organization glossary)';\n    }\n\n    // Pass the task's DB into resolvePrompt so any app/tenant-level prompt\n    // overrides stored in `_smrt_prompt_overrides` are honored — that's the\n    // whole reason we register the translation prompt with smrt-prompts in\n    // the first place.\n    const prompt = await resolvePrompt(TRANSLATION_PROMPT_KEY, {\n      db: this.options.db,\n      tenantId: args.tenantId ?? null,\n      variables: {\n        sourceLocale,\n        targetLocale,\n        template: args.sourceTemplate,\n        glossary,\n        placeholderExample: PLACEHOLDER_EXAMPLE,\n        responseShapeExample: RESPONSE_SHAPE_EXAMPLE,\n      },\n    });\n\n    // Single merged AI config: per-job model override (`args.model`) wins\n    // over the prompt's `ai.model`, and the same merge feeds both `getAI()`\n    // (client construction) and `ai.message()` (request options) so the\n    // override actually takes effect end-to-end.\n    const promptAi = (prompt.ai ?? {}) as Record<string, unknown>;\n    const mergedAiConfig: Record<string, unknown> = { ...promptAi };\n    if (args.model) mergedAiConfig.model = args.model;\n    const ai = await getAI(mergedAiConfig as any);\n\n    const message = await ai.message(prompt.text, {\n      ...mergedAiConfig,\n      responseFormat: { type: 'json_object' },\n    });\n\n    const translated = parseTranslationResponse(message);\n    if (!translated) {\n      throw new Error(\n        `LanguageTranslationTask: AI returned no usable translation for \"${args.key}\" → ${targetLocale}`,\n      );\n    }\n\n    if (containsObviousMarkupLeak(translated)) {\n      throw new Error(\n        `LanguageTranslationTask: refusing to persist suspicious translation for \"${args.key}\"`,\n      );\n    }\n\n    // Persist the model that actually produced the translation, not just the\n    // prompt's default — `args.model` overrides the prompt's `ai.model`.\n    const aiModel =\n      (args.model as string | undefined) ??\n      (promptAi.model as string | undefined) ??\n      null;\n    const sourceHash =\n      args.sourceHash || computeSourceHash(args.sourceTemplate);\n\n    if (existing) {\n      existing.template = translated;\n      existing.auto_generated = true;\n      existing.source_hash = sourceHash;\n      existing.ai_model = aiModel;\n      existing.reviewed_at = null;\n      existing.reviewed_by = null;\n      await existing.save();\n    } else {\n      // Use the collection's create() so the new row is initialized against\n      // the same DB the task is running on. Constructing `new LanguageOverride`\n      // directly leaves it un-initialized and `.save()` then trips on the\n      // \"Database accessed before initialization\" guard.\n      await overrides.create({\n        key: args.key,\n        locale: targetLocale,\n        tenantId: null,\n        template: translated,\n        auto_generated: true,\n        source_hash: sourceHash,\n        ai_model: aiModel,\n        reviewed_at: null,\n        reviewed_by: null,\n      });\n    }\n\n    invalidateLanguageCache(args.key, targetLocale, null, this.db);\n    return { template: translated };\n  }\n}\n\ninterface EnqueueTranslationOptions {\n  key: string;\n  targetLocale: string;\n  sourceLocale?: string;\n  tenantId?: string | null;\n  db: unknown;\n  /** When true, skip the dedup check and force a fresh job. */\n  force?: boolean;\n}\n\n/**\n * Enqueue a translation job for `(key, targetLocale)`, deduplicated against\n * any already-pending job for the same target. Returns the (possibly existing)\n * job's deterministic ID.\n */\nexport async function enqueueTranslationJob(\n  options: EnqueueTranslationOptions,\n): Promise<{ id: string; status: 'enqueued' | 'duplicate' | 'skipped' }> {\n  const targetLocale = normalizeLocale(options.targetLocale);\n  const sourceLocale = normalizeLocale(options.sourceLocale ?? 'en');\n  const dedupId = buildTranslationJobId(options.key, targetLocale);\n\n  const definition = LanguageRegistry.get(options.key, sourceLocale);\n  if (!definition) {\n    return { id: dedupId, status: 'skipped' };\n  }\n\n  const config = getLanguagesConfig();\n  if (\n    Array.isArray(config.supportedLocales) &&\n    config.supportedLocales.length > 0 &&\n    !config.supportedLocales.map(normalizeLocale).includes(targetLocale)\n  ) {\n    return { id: dedupId, status: 'skipped' };\n  }\n\n  const jobs = await (SmrtJobCollection as any).create({ db: options.db });\n\n  if (!options.force) {\n    const existing = await findPendingTranslationJob(\n      jobs,\n      options.key,\n      targetLocale,\n    );\n    if (existing) {\n      return { id: dedupId, status: 'duplicate' };\n    }\n  }\n\n  const payload: TranslationJobPayload = {\n    key: options.key,\n    sourceLocale,\n    sourceTemplate: definition.template,\n    sourceHash: definition.sourceHash,\n    targetLocale,\n    tenantId: options.tenantId ?? null,\n  };\n\n  // Stamp tenantId on the SmrtJob row so the per-tenant daily budget query\n  // (which filters by `tenantId`) actually counts this job. SmrtJob.save()\n  // will fall back to `getTenantId()` from AsyncLocalStorage when undefined,\n  // but we may be enqueueing from outside a tenant context (e.g. resolver\n  // miss with an explicit tenantId option), so set it explicitly here.\n  const job = await jobs.create({\n    queue: 'languages',\n    objectType: 'LanguageTranslationTask',\n    objectId: null,\n    method: 'execute',\n    tenantId: options.tenantId ?? null,\n    args: { ...payload, _dedupId: dedupId },\n    runAt: new Date(),\n    priority: 25,\n  });\n  await job.save();\n\n  return { id: dedupId, status: 'enqueued' };\n}\n\n/**\n * In-memory match cap for the dedup scan. We pull the most recently-queued\n * language jobs and check them in JS because querying inside a JSON column\n * portably across SQLite/Postgres is fiddly. If the working queue is deeper\n * than this, the scan truncates — when that happens we log a warning instead\n * of silently letting duplicate jobs slip through, and the handler's\n * source-hash gate (`execute()`) still prevents redundant AI calls. Tune via\n * `packages.languages.dedupScanLimit` if your steady-state pending queue\n * regularly exceeds the default.\n */\nconst DEFAULT_DEDUP_SCAN_LIMIT = 500;\n\nasync function findPendingTranslationJob(\n  jobs: SmrtJobCollection,\n  key: string,\n  targetLocale: string,\n): Promise<unknown | null> {\n  const dedupId = buildTranslationJobId(key, targetLocale);\n  const config = getLanguagesConfig();\n  const scanLimit =\n    typeof (config as { dedupScanLimit?: number }).dedupScanLimit === 'number'\n      ? (config as { dedupScanLimit: number }).dedupScanLimit\n      : DEFAULT_DEDUP_SCAN_LIMIT;\n\n  const rows = await jobs.list({\n    where: {\n      objectType: 'LanguageTranslationTask',\n      method: 'execute',\n      status: ['pending', 'running'],\n      queue: 'languages',\n    },\n    orderBy: 'createdAt DESC',\n    limit: scanLimit,\n  });\n\n  for (const row of rows) {\n    const args = (row as { args?: Record<string, unknown> }).args ?? {};\n    if (args._dedupId === dedupId) return row;\n    if (\n      args.key === key &&\n      typeof args.targetLocale === 'string' &&\n      normalizeLocale(args.targetLocale as string) === targetLocale\n    ) {\n      return row;\n    }\n  }\n\n  if (rows.length === scanLimit) {\n    // Don't crash; the handler's source-hash gate is the durable safeguard.\n    // But surface a warning so operators notice when the queue depth has\n    // outgrown the in-memory match window.\n    logger.warn(\n      `[smrt-languages] translation-job dedup scan hit its limit (${scanLimit}); raise packages.languages.dedupScanLimit if duplicate jobs appear`,\n    );\n  }\n  return null;\n}\n\nasync function countTodayTenantTranslations(\n  options: { db?: unknown },\n  tenantId: string,\n): Promise<number> {\n  // SmrtCollection.list() encodes operators into the where-clause key (e.g.\n  // `'createdAt >='`), not as `{ op, value }` objects — using the wrong shape\n  // either throws or matches nothing, and a swallowed failure here silently\n  // disables the budget. Let the call propagate so configuration mistakes\n  // surface immediately rather than as a missed throttle in production.\n  const jobs = await (SmrtJobCollection as any).create({ db: options.db });\n  const since = new Date();\n  since.setUTCHours(0, 0, 0, 0);\n  const rows = await jobs.list({\n    where: {\n      objectType: 'LanguageTranslationTask',\n      method: 'execute',\n      tenantId,\n      'createdAt >=': since.toISOString(),\n    },\n  });\n  return rows.length;\n}\n\nfunction getLanguagesConfig(): LanguagesPackageConfig {\n  return getPackageConfig<LanguagesPackageConfig>('languages', {\n    defaultLocale: 'en',\n    overrides: {},\n  });\n}\n\nasync function isAutoTranslateDisabled(\n  tenantId: string | null,\n  options: { db?: unknown },\n): Promise<boolean> {\n  try {\n    const resolver = new FeatureResolver(options as any);\n    const enabled = await resolver.isEnabled(AUTO_TRANSLATE_FEATURE_KEY, {\n      tenantId: tenantId ?? undefined,\n    });\n    return enabled === false;\n  } catch {\n    // If features package can't resolve (no definition synced, etc.), default\n    // to enabled — operators opt out by registering the flag.\n    return false;\n  }\n}\n\nfunction parseTranslationResponse(\n  message: string | null | undefined,\n): string | null {\n  if (!message) return null;\n\n  // We requested `responseFormat: json_object` so the model is supposed to\n  // return a JSON object with a `translation` string. If parsing succeeds but\n  // the shape is wrong (e.g. `{\"text\":\"Hola\"}`), we MUST NOT fall through to\n  // the bare-string path — that would persist the whole JSON blob as the\n  // translation. Only the parse-failed branch may try to use the raw message\n  // as a literal string (some providers occasionally return prose despite\n  // the format hint).\n  let parseFailed = false;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(message);\n  } catch {\n    parseFailed = true;\n  }\n\n  if (!parseFailed) {\n    if (\n      parsed &&\n      typeof parsed === 'object' &&\n      !Array.isArray(parsed) &&\n      typeof (parsed as { translation?: unknown }).translation === 'string'\n    ) {\n      const cleaned = (parsed as { translation: string }).translation.trim();\n      return cleaned.length > 0 ? cleaned : null;\n    }\n    if (typeof parsed === 'string') {\n      const cleaned = parsed.trim();\n      return cleaned.length > 0 ? cleaned : null;\n    }\n    return null;\n  }\n\n  const trimmed = String(message).trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction containsObviousMarkupLeak(value: string): boolean {\n  // Cheap defense: refuse responses that look like raw HTML/system tags. We\n  // can tighten this in v1.1 once we have telemetry on real failure modes.\n  return /<\\/?(script|html|body|iframe|system)/i.test(value);\n}\n"],"names":[],"mappings":"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"}