@happyvertical/smrt-languages 0.37.4 → 0.37.5

package/dist/index.js

@@ -3,7 +3,7 @@ import { ObjectRegistry } from "@happyvertical/smrt-core";
 import { getPackageConfig } from "@happyvertical/smrt-config";
 import { getTenantId } from "@happyvertical/smrt-tenancy";
 //#region src/__smrt-register__.ts
-ObjectRegistry.registerPackageManifest(new URL("./manifest.json", "" + import.meta.url));
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":1782953446280,\"packageName\":\"@happyvertical/smrt-languages\",\"packageVersion\":\"0.37.5\",\"objects\":{\"@happyvertical/smrt-languages:LanguageTranslationTask\":{\"name\":\"languagetranslationtask\",\"className\":\"LanguageTranslationTask\",\"qualifiedName\":\"@happyvertical/smrt-languages:LanguageTranslationTask\",\"collection\":\"languagetranslationtasks\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/languages/src/translation-job.ts\",\"packageName\":\"@happyvertical/smrt-languages\",\"fields\":{},\"methods\":{\"execute\":{\"name\":\"execute\",\"async\":true,\"parameters\":[{\"name\":\"args\",\"type\":\"TranslationJobPayload\",\"optional\":false}],\"returnType\":\"Promise<object>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"api\":{\"include\":[]},\"cli\":{\"include\":[]},\"mcp\":{\"include\":[]}},\"extends\":\"SmrtObject\",\"exportName\":\"LanguageTranslationTask\",\"collectionExportName\":\"LanguageTranslationTaskCollection\",\"schema\":{\"tableName\":\"language_translation_tasks\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"language_translation_tasks\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"language_translation_tasks_id_idx\",\"columns\":[\"id\"]},{\"name\":\"language_translation_tasks_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"2cfc8812\"}},\"@happyvertical/smrt-languages:LanguageOverrideCollection\":{\"name\":\"languageoverridecollection\",\"className\":\"LanguageOverrideCollection\",\"qualifiedName\":\"@happyvertical/smrt-languages:LanguageOverrideCollection\",\"collection\":\"languageoverrides\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/languages/src/collections/LanguageOverrideCollection.ts\",\"packageName\":\"@happyvertical/smrt-languages\",\"fields\":{},\"methods\":{\"getAppOverride\":{\"name\":\"getAppOverride\",\"async\":true,\"parameters\":[{\"name\":\"key\",\"type\":\"string\",\"optional\":false},{\"name\":\"locale\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<LanguageOverride | null>\",\"isStatic\":false,\"isPublic\":true},\"getTenantOverride\":{\"name\":\"getTenantOverride\",\"async\":true,\"parameters\":[{\"name\":\"key\",\"type\":\"string\",\"optional\":false},{\"name\":\"locale\",\"type\":\"string\",\"optional\":false},{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<LanguageOverride | null>\",\"isStatic\":false,\"isPublic\":true},\"getResolutionLayers\":{\"name\":\"getResolutionLayers\",\"async\":true,\"parameters\":[{\"name\":\"key\",\"type\":\"string\",\"optional\":false},{\"name\":\"locale\",\"type\":\"string\",\"optional\":false},{\"name\":\"tenantId\",\"type\":\"string | null\",\"optional\":true}],\"returnType\":\"Promise<object>\",\"isStatic\":false,\"isPublic\":true},\"listTenantOverrides\":{\"name\":\"listTenantOverrides\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<LanguageOverride[]>\",\"isStatic\":false,\"isPublic\":true},\"listUnreviewedAutoTranslations\":{\"name\":\"listUnreviewedAutoTranslations\",\"async\":true,\"parameters\":[{\"name\":\"options\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<LanguageOverride[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"_smrt_language_overrides\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"LanguageOverride\",\"exportName\":\"LanguageOverrideCollection\",\"collectionExportName\":\"LanguageOverrideCollectionCollection\",\"schema\":{\"tableName\":\"_smrt_language_overrides\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"_smrt_language_overrides\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"_smrt_language_overrides_id_idx\",\"columns\":[\"id\"]},{\"name\":\"_smrt_language_overrides_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"743ae4eb\"}},\"@happyvertical/smrt-languages:LanguageOverride\":{\"name\":\"languageoverride\",\"className\":\"LanguageOverride\",\"qualifiedName\":\"@happyvertical/smrt-languages:LanguageOverride\",\"collection\":\"languageoverrides\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/languages/src/models/LanguageOverride.ts\",\"packageName\":\"@happyvertical/smrt-languages\",\"fields\":{\"key\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"locale\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"template\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"required\":true}},\"auto_generated\":{\"type\":\"boolean\",\"required\":true,\"default\":false,\"_meta\":{\"required\":true,\"default\":false}},\"source_hash\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"ai_model\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"reviewed_at\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"reviewed_by\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true},\"approve\":{\"name\":\"approve\",\"async\":true,\"parameters\":[{\"name\":\"reviewerId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"_smrt_language_overrides\",\"conflictColumns\":[\"key\",\"locale\",\"context\"],\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"cli\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\",\"approve\"],\"skipApiCheck\":true},\"mcp\":{\"include\":[]}},\"extends\":\"SmrtObject\",\"exportName\":\"LanguageOverride\",\"collectionExportName\":\"LanguageOverrideCollection\",\"validationRules\":[{\"field\":\"key\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"locale\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"template\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"auto_generated\",\"rule\":\"required\",\"fieldType\":\"boolean\"}],\"schema\":{\"tableName\":\"_smrt_language_overrides\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"_smrt_language_overrides\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"key\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"locale\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"tenant_id\\\" TEXT,\\n  \\\"template\\\" TEXT NOT NULL,\\n  \\\"auto_generated\\\" BOOLEAN NOT NULL DEFAULT FALSE,\\n  \\\"source_hash\\\" TEXT,\\n  \\\"ai_model\\\" TEXT,\\n  \\\"reviewed_at\\\" TEXT,\\n  \\\"reviewed_by\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"key\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"locale\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"tenant_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"template\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false},\"auto_generated\":{\"type\":\"BOOLEAN\",\"notNull\":true,\"unique\":false,\"default\":false},\"source_hash\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"ai_model\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_at\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_by\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"_smrt_language_overrides_id_idx\",\"columns\":[\"id\"]},{\"name\":\"_smrt_language_overrides_key_locale_idx\",\"columns\":[\"key\",\"locale\",\"context\"],\"unique\":true}],\"version\":\"4bef8abc\"}}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-core\",\"@happyvertical/smrt-features\",\"@happyvertical/smrt-jobs\",\"@happyvertical/smrt-prompts\",\"@happyvertical/smrt-tenancy\"]}"));
 //#endregion
 //#region src/language-resolver.ts
 var DEFAULT_LOCALE = "en";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"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"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"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"],"mappings":"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"}

package/dist/manifest.json

@@ -1,8 +1,8 @@
 {
   "version": "1.0.0",
-  "timestamp": 1782943649265,
+  "timestamp": 1782953446280,
   "packageName": "@happyvertical/smrt-languages",
-  "packageVersion": "0.37.4",
+  "packageVersion": "0.37.5",
   "objects": {
     "@happyvertical/smrt-languages:LanguageTranslationTask": {
       "name": "languagetranslationtask",
@@ -91,6 +91,167 @@
         "version": "2cfc8812"
       }
     },
+    "@happyvertical/smrt-languages:LanguageOverrideCollection": {
+      "name": "languageoverridecollection",
+      "className": "LanguageOverrideCollection",
+      "qualifiedName": "@happyvertical/smrt-languages:LanguageOverrideCollection",
+      "collection": "languageoverrides",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/languages/src/collections/LanguageOverrideCollection.ts",
+      "packageName": "@happyvertical/smrt-languages",
+      "fields": {},
+      "methods": {
+        "getAppOverride": {
+          "name": "getAppOverride",
+          "async": true,
+          "parameters": [
+            {
+              "name": "key",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "locale",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<LanguageOverride | null>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getTenantOverride": {
+          "name": "getTenantOverride",
+          "async": true,
+          "parameters": [
+            {
+              "name": "key",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "locale",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "tenantId",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<LanguageOverride | null>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getResolutionLayers": {
+          "name": "getResolutionLayers",
+          "async": true,
+          "parameters": [
+            {
+              "name": "key",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "locale",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "tenantId",
+              "type": "string | null",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<object>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "listTenantOverrides": {
+          "name": "listTenantOverrides",
+          "async": true,
+          "parameters": [
+            {
+              "name": "tenantId",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<LanguageOverride[]>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "listUnreviewedAutoTranslations": {
+          "name": "listUnreviewedAutoTranslations",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<LanguageOverride[]>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "_smrt_language_overrides"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "LanguageOverride",
+      "exportName": "LanguageOverrideCollection",
+      "collectionExportName": "LanguageOverrideCollectionCollection",
+      "schema": {
+        "tableName": "_smrt_language_overrides",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_language_overrides\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_language_overrides_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "_smrt_language_overrides_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "743ae4eb"
+      }
+    },
     "@happyvertical/smrt-languages:LanguageOverride": {
       "name": "languageoverride",
       "className": "LanguageOverride",
@@ -352,167 +513,6 @@
         ],
         "version": "4bef8abc"
       }
-    },
-    "@happyvertical/smrt-languages:LanguageOverrideCollection": {
-      "name": "languageoverridecollection",
-      "className": "LanguageOverrideCollection",
-      "qualifiedName": "@happyvertical/smrt-languages:LanguageOverrideCollection",
-      "collection": "languageoverrides",
-      "filePath": "/home/runner/_work/smrt/smrt/packages/languages/src/collections/LanguageOverrideCollection.ts",
-      "packageName": "@happyvertical/smrt-languages",
-      "fields": {},
-      "methods": {
-        "getAppOverride": {
-          "name": "getAppOverride",
-          "async": true,
-          "parameters": [
-            {
-              "name": "key",
-              "type": "string",
-              "optional": false
-            },
-            {
-              "name": "locale",
-              "type": "string",
-              "optional": false
-            }
-          ],
-          "returnType": "Promise<LanguageOverride | null>",
-          "isStatic": false,
-          "isPublic": true
-        },
-        "getTenantOverride": {
-          "name": "getTenantOverride",
-          "async": true,
-          "parameters": [
-            {
-              "name": "key",
-              "type": "string",
-              "optional": false
-            },
-            {
-              "name": "locale",
-              "type": "string",
-              "optional": false
-            },
-            {
-              "name": "tenantId",
-              "type": "string",
-              "optional": false
-            }
-          ],
-          "returnType": "Promise<LanguageOverride | null>",
-          "isStatic": false,
-          "isPublic": true
-        },
-        "getResolutionLayers": {
-          "name": "getResolutionLayers",
-          "async": true,
-          "parameters": [
-            {
-              "name": "key",
-              "type": "string",
-              "optional": false
-            },
-            {
-              "name": "locale",
-              "type": "string",
-              "optional": false
-            },
-            {
-              "name": "tenantId",
-              "type": "string | null",
-              "optional": true
-            }
-          ],
-          "returnType": "Promise<object>",
-          "isStatic": false,
-          "isPublic": true
-        },
-        "listTenantOverrides": {
-          "name": "listTenantOverrides",
-          "async": true,
-          "parameters": [
-            {
-              "name": "tenantId",
-              "type": "string",
-              "optional": false
-            }
-          ],
-          "returnType": "Promise<LanguageOverride[]>",
-          "isStatic": false,
-          "isPublic": true
-        },
-        "listUnreviewedAutoTranslations": {
-          "name": "listUnreviewedAutoTranslations",
-          "async": true,
-          "parameters": [
-            {
-              "name": "options",
-              "type": "object",
-              "optional": true
-            }
-          ],
-          "returnType": "Promise<LanguageOverride[]>",
-          "isStatic": false,
-          "isPublic": true
-        }
-      },
-      "decoratorConfig": {
-        "tableName": "_smrt_language_overrides"
-      },
-      "extends": "SmrtCollection",
-      "extendsTypeArg": "LanguageOverride",
-      "exportName": "LanguageOverrideCollection",
-      "collectionExportName": "LanguageOverrideCollectionCollection",
-      "schema": {
-        "tableName": "_smrt_language_overrides",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_language_overrides\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp\n);",
-        "columns": {
-          "id": {
-            "type": "UUID",
-            "primaryKey": true,
-            "referenceKind": "id",
-            "notNull": true
-          },
-          "slug": {
-            "type": "TEXT",
-            "notNull": true
-          },
-          "context": {
-            "type": "TEXT",
-            "notNull": true,
-            "default": ""
-          },
-          "created_at": {
-            "type": "TIMESTAMP",
-            "notNull": true,
-            "default": "current_timestamp"
-          },
-          "updated_at": {
-            "type": "TIMESTAMP",
-            "notNull": true,
-            "default": "current_timestamp"
-          }
-        },
-        "indexes": [
-          {
-            "name": "_smrt_language_overrides_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
-          {
-            "name": "_smrt_language_overrides_slug_context_idx",
-            "columns": [
-              "slug",
-              "context"
-            ],
-            "unique": true
-          }
-        ],
-        "version": "743ae4eb"
-      }
     }
   },
   "moduleType": "smrt",

package/dist/smrt-knowledge.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-07-01T22:07:36.914Z",
+  "generatedAt": "2026-07-02T00:50:55.843Z",
   "packageName": "@happyvertical/smrt-languages",
-  "packageVersion": "0.37.4",
+  "packageVersion": "0.37.5",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "aa81c3db0fccedb591ed37016de5ad5ac79a90ba4e8fd30846f0882a93d64231",
-    "packageJson": "a2039db1f3ecef4d5b7c84983c6b621980c91446ef6b3e4cb1f8bab5fcf1f0c0",
+    "manifest": "136084faa4aaa7440167f5c37ea54aff4c2d0b15b863b0840cbe4a5be250ad13",
+    "packageJson": "507f6b87246adba6b6bb5c5d11afcb6d54b55165a743055a2374359050072305",
     "agents": "6dc270bd9bb9c51d48f526396544ab2a54a071c42f60869f4806520818f7e864"
   },
   "exports": [
@@ -71,6 +71,29 @@
       "tags": [],
       "risks": []
     },
+    {
+      "name": "LanguageOverrideCollection",
+      "qualifiedName": "@happyvertical/smrt-languages:LanguageOverrideCollection",
+      "collection": "languageoverrides",
+      "tableName": "_smrt_language_overrides",
+      "packageName": "@happyvertical/smrt-languages",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getAppOverride",
+        "getResolutionLayers",
+        "getTenantOverride",
+        "listTenantOverrides",
+        "listUnreviewedAutoTranslations"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
     {
       "name": "LanguageOverride",
       "qualifiedName": "@happyvertical/smrt-languages:LanguageOverride",
@@ -223,29 +246,6 @@
       ],
       "tags": [],
       "risks": []
-    },
-    {
-      "name": "LanguageOverrideCollection",
-      "qualifiedName": "@happyvertical/smrt-languages:LanguageOverrideCollection",
-      "collection": "languageoverrides",
-      "tableName": "_smrt_language_overrides",
-      "packageName": "@happyvertical/smrt-languages",
-      "extends": "SmrtCollection",
-      "fields": [],
-      "relationships": [],
-      "methods": [
-        "getAppOverride",
-        "getResolutionLayers",
-        "getTenantOverride",
-        "listTenantOverrides",
-        "listUnreviewedAutoTranslations"
-      ],
-      "surfaces": [],
-      "relationshipFeatures": [
-        "uuidColumns"
-      ],
-      "tags": [],
-      "risks": []
     }
   ],
   "surfaces": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-languages",
-  "version": "0.37.4",
+  "version": "0.37.5",
   "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.11",
     "@happyvertical/logger": "^0.74.11",
     "@happyvertical/sql": "^0.74.11",
-    "@happyvertical/smrt-config": "0.37.4",
-    "@happyvertical/smrt-core": "0.37.4",
-    "@happyvertical/smrt-features": "0.37.4",
-    "@happyvertical/smrt-jobs": "0.37.4",
-    "@happyvertical/smrt-prompts": "0.37.4",
-    "@happyvertical/smrt-tenancy": "0.37.4"
+    "@happyvertical/smrt-config": "0.37.5",
+    "@happyvertical/smrt-jobs": "0.37.5",
+    "@happyvertical/smrt-core": "0.37.5",
+    "@happyvertical/smrt-features": "0.37.5",
+    "@happyvertical/smrt-prompts": "0.37.5",
+    "@happyvertical/smrt-tenancy": "0.37.5"
   },
   "devDependencies": {
     "@types/node": "24.13.2",
     "typescript": "^5.9.3",
     "vite": "^8.1.2",
     "vitest": "^4.1.9",
-    "@happyvertical/smrt-cli": "0.37.4",
-    "@happyvertical/smrt-vitest": "0.37.4"
+    "@happyvertical/smrt-vitest": "0.37.5",
+    "@happyvertical/smrt-cli": "0.37.5"
   },
   "keywords": [
     "smrt",