@happyvertical/smrt-languages 0.51.32 → 0.51.34

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/cache.d.ts

@@ -0,0 +1,50 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { LanguageCacheValue } from './types.js';
+export declare function getLanguageCacheTtlMs(): number;
+export declare function getCachedLanguage(key: string, locale: string, tenantId: string | null | undefined, db: DatabaseInterface | unknown): LanguageCacheValue | null;
+/**
+ * Reads the current invalidation generation for a `(key, locale)` pair.
+ *
+ * A resolution captures this *before* its asynchronous layer loads and hands
+ * it back to {@link setCachedLanguage}. Any write that lands while those loads
+ * are in flight bumps the generation, so the in-flight resolution — which read
+ * the pre-write layers — is refused the cache write instead of repopulating
+ * the entry the write just invalidated. Without this, a read that raced a
+ * write served the pre-write value for the full TTL, and a raced `delete()`
+ * resurrected the deleted override.
+ *
+ * Granularity is `(db, key, locale)`, not `(db, key)` as in smrt-playbooks and
+ * smrt-prompts, and not `(db, key, locale, tenantId)`:
+ *
+ * - `locale` is part of the key because every layer a cached entry is built
+ *   from is read at exactly the locale it is cached under. `resolveLanguageString`
+ *   walks a fallback chain (`fr-CA` → `fr` → `en`), but each attempt reads its
+ *   own locale's rows (`getTenantOverride`/`getAppOverride` are called with
+ *   that locale) and caches the result under that same locale; an attempt that
+ *   resolves nothing caches nothing, so a fallback hit is never stored under
+ *   the requested locale. Every writer — `LanguageOverride.save()`/`delete()`
+ *   (both identities, when one changes) and the translation job — invalidates
+ *   the same `(key, locale)` it wrote. A per-locale generation therefore still
+ *   covers every write that can change what a cached entry was built from.
+ * - `tenantId` is deliberately *not* part of the key, because an app-level row
+ *   (tenantId null) is inherited by every tenant, so a write to any scope of a
+ *   `(key, locale)` must be able to refuse an in-flight write for any other
+ *   scope of it. This matches the coarsest fan-out of
+ *   {@link invalidateLanguageCache}.
+ *
+ * A pair with no entry of its own reports the {@link clearLanguageCache} floor
+ * rather than a bare 0, so a clear refuses in-flight writes for pairs that have
+ * never been invalidated too.
+ */
+export declare function getLanguageCacheGeneration(key: string, locale: string, db: DatabaseInterface | unknown): number;
+export declare function setCachedLanguage(key: string, locale: string, tenantId: string | null | undefined, db: DatabaseInterface | unknown, value: LanguageCacheValue, loadedAtGeneration: number): void;
+/**
+ * Drop cached entries that match the given (key, locale).
+ *
+ * - When `tenantId` is provided, only that tenant's entries for this DB are dropped.
+ * - When `tenantId` is null/undefined, every (key, locale, *) entry across tenants
+ *   is dropped — used for app-level writes that affect all tenants.
+ */
+export declare function invalidateLanguageCache(key: string, locale: string, tenantId: string | null | undefined, db: DatabaseInterface | unknown): void;
+export declare function clearLanguageCache(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA8FrD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAC9B,kBAAkB,GAAG,IAAI,CAc3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAC9B,MAAM,CAIR;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,EAAE,EAAE,iBAAiB,GAAG,OAAO,EAC/B,KAAK,EAAE,kBAAkB,EACzB,kBAAkB,EAAE,MAAM,GACzB,IAAI,CAWN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAC9B,IAAI,CAgBN;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC"}

package/dist/cli.d.ts

@@ -1,94 +1,38 @@
-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< LanguageOverride>;
-
-/** `smrt languages edit <id> --template=...` — human-edit suppresses auto-overwrites. */
-export declare function editLanguageOverride(options: {
-    db: SmrtClassOptions['db'];
-    id: string;
-    template: string;
-    reviewer?: string;
-}): 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< LanguageOverride[]>;
-
-/**
- * Implementation of `smrt languages translate --locales=es,fr`.
- *
- * Walks the registered code defaults and enqueues a translation job for every
- * `(key, locale)` pair that does not yet have an app-level override. The job
- * itself respects the same dedup / budget / allowlist rules as the resolver's
- * miss-path enqueue.
- */
-export declare function translateMissing(options: {
-    locales: string[];
-    sourceLocale?: string;
-    db: SmrtClassOptions['db'];
-    tenantId?: string | null;
-}): Promise<{
-    enqueued: string[];
-    skipped: string[];
-}>;
-
-export { }
-
-
-declare global {
-    var __smrtLanguageRegistry: Map<string, Map<string, LanguageStringDefinition>> | undefined;
-}
+import type { SmrtClassOptions } from '@happyvertical/smrt-core';
+/**
+ * Implementation of `smrt languages translate --locales=es,fr`.
+ *
+ * Walks the registered code defaults and enqueues a translation job for every
+ * `(key, locale)` pair that does not yet have an app-level override. The job
+ * itself respects the same dedup / budget / allowlist rules as the resolver's
+ * miss-path enqueue.
+ */
+export declare function translateMissing(options: {
+    locales: string[];
+    sourceLocale?: string;
+    db: SmrtClassOptions['db'];
+    tenantId?: string | null;
+}): Promise<{
+    enqueued: string[];
+    skipped: string[];
+}>;
+/** `smrt languages review --locale=es` — list unreviewed auto-translations. */
+export declare function listUnreviewedAutoTranslations(options: {
+    db: SmrtClassOptions['db'];
+    locale?: string;
+    limit?: number;
+}): Promise<import("./index.js").LanguageOverride[]>;
+/** `smrt languages approve <id> --reviewer=<user>` — mark reviewed. */
+export declare function approveAutoTranslation(options: {
+    db: SmrtClassOptions['db'];
+    id: string;
+    reviewer: string;
+}): Promise<import("./index.js").LanguageOverride>;
+/** `smrt languages edit <id> --template=...` — human-edit suppresses auto-overwrites. */
+export declare function editLanguageOverride(options: {
+    db: SmrtClassOptions['db'];
+    id: string;
+    template: string;
+    reviewer?: string;
+}): Promise<import("./index.js").LanguageOverride>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAMjE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC;IACV,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CA+CD;AAED,+EAA+E;AAC/E,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,oDAQA;AAED,uEAAuE;AACvE,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,kDASA;AAED,yFAAyF;AACzF,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,kDAiBA"}

package/dist/collections/LanguageOverrideCollection.d.ts

@@ -0,0 +1,27 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { LanguageOverride } from '../models/LanguageOverride.js';
+export declare class LanguageOverrideCollection extends SmrtCollection<LanguageOverride> {
+    static readonly _itemClass: typeof LanguageOverride;
+    /**
+     * Look up the app-level (tenantId = null) override for a (key, locale) pair.
+     * App-level rows hold AI auto-translations and ops-curated app-wide strings.
+     */
+    getAppOverride(key: string, locale: string): Promise<LanguageOverride | null>;
+    getTenantOverride(key: string, locale: string, tenantId: string): Promise<LanguageOverride | null>;
+    /**
+     * Convenience helper for the resolver: returns the app and (optional) tenant
+     * override rows for a (key, locale).
+     */
+    getResolutionLayers(key: string, locale: string, tenantId?: string | null): Promise<{
+        app: LanguageOverride | null;
+        tenant: LanguageOverride | null;
+    }>;
+    /** All overrides for a tenant (used to build the AI translation glossary). */
+    listTenantOverrides(tenantId: string): Promise<LanguageOverride[]>;
+    /** Auto-generated overrides that no admin has approved yet. */
+    listUnreviewedAutoTranslations(options?: {
+        locale?: string;
+        limit?: number;
+    }): Promise<LanguageOverride[]>;
+}
+//# sourceMappingURL=LanguageOverrideCollection.d.ts.map

package/dist/collections/LanguageOverrideCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanguageOverrideCollection.d.ts","sourceRoot":"","sources":["../../src/collections/LanguageOverrideCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,qBAAa,0BAA2B,SAAQ,cAAc,CAAC,gBAAgB,CAAC;IAC9E,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAAoB;IAE9C;;;OAGG;IACG,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAO7B,iBAAiB,CACrB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAOnC;;;OAGG;IACG,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC;QACT,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC7B,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;KACjC,CAAC;IAUF,8EAA8E;IACxE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIxE,+DAA+D;IACzD,8BAA8B,CAClC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAc/B"}

package/dist/glossary.d.ts

@@ -0,0 +1,17 @@
+import type { LanguageOverride } from './models/LanguageOverride.js';
+/**
+ * Build a glossary string suitable for inclusion in an AI translation prompt.
+ *
+ * Pulls the tenant's existing language overrides for the source/target locales
+ * and renders them as a concise list of "source → target" pairs, restricted to
+ * keys that actually have both sides. The intent is "make AI auto-translations
+ * match tenant voice", not bulk dump every override.
+ *
+ * Returns an empty string when there is nothing useful to add.
+ */
+export declare function buildTenantGlossary(overrides: LanguageOverride[], options: {
+    sourceLocale: string;
+    targetLocale: string;
+    max?: number;
+}): string;
+//# sourceMappingURL=glossary.d.ts.map

package/dist/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../src/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGrE;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,MAAM,CA4BR"}

package/dist/index.d.ts

@@ -1,252 +1,31 @@
-import { DatabaseInterface } from '@happyvertical/sql';
-import { SmrtClassOptions } from '@happyvertical/smrt-core';
-import { SmrtCollection } from '@happyvertical/smrt-core';
-import { SmrtObject } from '@happyvertical/smrt-core';
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
-
-/**
- * Build the locale fallback chain for a requested locale.
- *
- * Example: `fr-CA` with default `en` → `['fr-CA', 'fr', 'en']`.
- * Duplicates and empty segments are removed.
- */
-export declare function buildLocaleFallbackChain(requested: string, defaultLocale: string): string[];
-
-/**
- * Build a glossary string suitable for inclusion in an AI translation prompt.
- *
- * Pulls the tenant's existing language overrides for the source/target locales
- * and renders them as a concise list of "source → target" pairs, restricted to
- * keys that actually have both sides. The intent is "make AI auto-translations
- * match tenant voice", not bulk dump every override.
- *
- * Returns an empty string when there is nothing useful to add.
- */
-export declare function buildTenantGlossary(overrides: LanguageOverride[], options: {
-    sourceLocale: string;
-    targetLocale: string;
-    max?: number;
-}): string;
-
-/** Deterministic translation-job ID — used for stampede protection. */
-export declare function buildTranslationJobId(key: string, targetLocale: string): string;
-
-export declare function clearLanguageCache(): void;
-
-/** Stable hash used to gate auto-translation re-runs against a specific source. */
-export declare function computeSourceHash(template: string): string;
-
-export declare function defineLanguageString(input: LanguageStringDefinitionInput): LanguageStringDefinition;
-
-export declare function getLanguageCacheTtlMs(): number;
-
-/**
- * Drop cached entries that match the given (key, locale).
- *
- * - When `tenantId` is provided, only that tenant's entries for this DB are dropped.
- * - When `tenantId` is null/undefined, every (key, locale, *) entry across tenants
- *   is dropped — used for app-level writes that affect all tenants.
- */
-export declare function invalidateLanguageCache(key: string, locale: string, tenantId: string | null | undefined, db: DatabaseInterface | unknown): void;
-
-export declare function invalidateResolvedLanguageCache(key: string, locale: string, tenantId: string | null | undefined, db: unknown): void;
-
-export declare interface LanguageCacheValue {
-    key: string;
-    locale: string;
-    template: string;
-    source: ResolvedLanguageString['source'];
-    resolvedFromLocale: string;
-}
-
-export 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;
-}
-
-export declare class LanguageOverrideCollection extends SmrtCollection<LanguageOverride> {
-    static readonly _itemClass: typeof LanguageOverride;
-    /**
-     * Look up the app-level (tenantId = null) override for a (key, locale) pair.
-     * App-level rows hold AI auto-translations and ops-curated app-wide strings.
-     */
-    getAppOverride(key: string, locale: string): Promise<LanguageOverride | null>;
-    getTenantOverride(key: string, locale: string, tenantId: string): Promise<LanguageOverride | null>;
-    /**
-     * Convenience helper for the resolver: returns the app and (optional) tenant
-     * override rows for a (key, locale).
-     */
-    getResolutionLayers(key: string, locale: string, tenantId?: string | null): Promise<{
-        app: LanguageOverride | null;
-        tenant: LanguageOverride | null;
-    }>;
-    /** All overrides for a tenant (used to build the AI translation glossary). */
-    listTenantOverrides(tenantId: string): Promise<LanguageOverride[]>;
-    /** Auto-generated overrides that no admin has approved yet. */
-    listUnreviewedAutoTranslations(options?: {
-        locale?: string;
-        limit?: number;
-    }): Promise<LanguageOverride[]>;
-}
-
-export declare interface LanguageOverrideCtorOptions extends SmrtObjectOptions, LanguageOverrideOptions {
-}
-
-export 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;
-}
-
-export declare const LanguageRegistry: {
-    register(input: LanguageStringDefinitionInput): LanguageStringDefinition;
-    get(key: string, locale: string): LanguageStringDefinition | undefined;
-    has(key: string, locale: string): boolean;
-    hasKey(key: string): boolean;
-    /** Return the locales that have a registered code default for the given key. */
-    getLocalesForKey(key: string): string[];
-    /** All registered (key, locale, template) triples. Used by the batch translator. */
-    getAll(): LanguageStringDefinition[];
-    /** Distinct keys currently registered. */
-    getKeys(): string[];
-    clear(): void;
-};
-
-/**
- * Per-package config bag, read via `getPackageConfig('languages', ...)`.
- *
- * `overrides[key][locale]` is a plain string template that takes precedence over
- * code defaults for that (key, locale) pair. It is the file-config layer in the
- * 5-layer resolution chain.
- */
-export declare interface LanguagesPackageConfig {
-    /** Default locale used when none is supplied at resolve-time. Defaults to 'en'. */
-    defaultLocale?: string;
-    /** When set, AI auto-translation jobs are only enqueued for these locales. */
-    supportedLocales?: string[];
-    /** Daily cap on AI translation jobs per tenant (null = no cap). */
-    translationBudgetPerTenantPerDay?: number | null;
-    /** File-config overrides, keyed by (key)(locale). */
-    overrides?: Record<string, Record<string, string>>;
-    [key: string]: unknown;
-}
-
-export declare interface LanguageStringDefinition {
-    key: string;
-    locale: string;
-    template: string;
-    /** sha256 of the template at registration time, used for re-translation gating */
-    sourceHash: string;
-}
-
-/** A registered code default for a single (key, locale) pair. */
-export declare interface LanguageStringDefinitionInput {
-    key: string;
-    locale: string;
-    template: string;
-}
-
-export declare type LanguageVariables = Record<string, unknown>;
-
-/**
- * Normalize a BCP-47-ish locale tag for consistent matching across the
- * registry, the cache, and DB lookups.
- *
- * Lowercases the language subtag and uppercases everything after it so
- * `fr-ca`, `fr-CA`, and `Fr-Ca` collapse to the same key. This is **not**
- * canonical BCP-47 casing (proper BCP-47 lower-cases variants and uses
- * Title-case for script subtags like `Hans`); it is an internal
- * normalization shared by every layer in this package and intentionally
- * stricter than what BCP-47 mandates.
- */
-export declare function normalizeLocale(locale: string): string;
-
-/* Excluded from this release type: PACKAGE_VERSION_INITIALIZED */
-
-/**
- * Render `{var}` placeholders against the supplied variables.
- *
- * When at least one variable is provided, every `{...}` placeholder in the
- * template is replaced; missing or `undefined`/`null` variables collapse to
- * empty strings (callers that pass `name` but not `title` get the `{title}`
- * placeholder removed).
- *
- * When `variables` is `undefined` or `{}` the template is returned unchanged
- * — that fast path avoids the regex pass for the common "no interpolation
- * needed" case. If you need every placeholder collapsed regardless, pass at
- * least one variable (e.g. `{ __forceRender: true }`).
- */
-export declare function renderTemplate(template: string, variables?: LanguageVariables): string;
-
-export declare interface ResolvedLanguageString {
-    key: string;
-    locale: string;
-    /** The fully-rendered string with variables substituted. */
-    text: string;
-    /** The raw template that produced `text`. */
-    template: string;
-    /** Locale that actually produced the template (may differ from `locale` after fallback). */
-    resolvedFromLocale: string;
-    /**
-     * `'code' | 'config' | 'app' | 'tenant' | 'runtime'`. `'fallback'` indicates
-     * no exact match was found and a fallback locale was used.
-     */
-    source: 'code' | 'config' | 'app' | 'tenant' | 'runtime' | 'fallback' | 'missing';
-}
-
-export declare function resolveLanguageString(key: string, options?: ResolveLanguageStringOptions): Promise<ResolvedLanguageString>;
-
-export declare interface ResolveLanguageStringOptions {
-    db?: SmrtClassOptions['db'];
-    tenantId?: string | null;
-    locale?: string;
-    /** Variables substituted into `{var}` placeholders. */
-    vars?: LanguageVariables;
-    /** Optional per-call override for the rendered template (highest precedence). */
-    overrides?: {
-        template?: string;
-    };
-    /**
-     * When `true`, throw if the resolution chain finishes without producing a
-     * template. When `false` (default), return the key as the rendered string and
-     * enqueue an AI translation job for the missing (key, locale).
-     */
-    strict?: boolean;
-}
-
-export { }
-
-
-declare global {
-    var __smrtLanguageRegistry: Map<string, Map<string, LanguageStringDefinition>> | undefined;
-}
+/**
+ * @happyvertical/smrt-languages
+ *
+ * Code-first language strings with config + tenant overrides and AI-driven
+ * auto-translation for SMRT applications. Mirrors the architecture of
+ * `@happyvertical/smrt-prompts` plus a smrt-jobs handler that fills gaps in
+ * non-default locales the first time a string is requested.
+ *
+ * The package root intentionally exposes only the read path
+ * (`defineLanguageString`, `resolveLanguageString`, `LanguageOverride`, the
+ * cache helpers, glossary helpers, and shared types/utilities). The
+ * translation-worker stack — which depends on `@happyvertical/ai`,
+ * smrt-jobs, smrt-features, and smrt-prompts — lives on the
+ * `@happyvertical/smrt-languages/jobs` subpath, and the admin CLI helpers
+ * live on `@happyvertical/smrt-languages/cli`. Resolver consumers (the vast
+ * majority of call sites) never load the worker dependency tree.
+ *
+ * @packageDocumentation
+ */
+import './__smrt-register__.js';
+export { clearLanguageCache, getLanguageCacheTtlMs, invalidateLanguageCache, } from './cache.js';
+export { LanguageOverrideCollection } from './collections/LanguageOverrideCollection.js';
+export { buildTenantGlossary } from './glossary.js';
+export { defineLanguageString, LanguageRegistry, } from './language-registry.js';
+export { invalidateResolvedLanguageCache, resolveLanguageString, } from './language-resolver.js';
+export { LanguageOverride, type LanguageOverrideCtorOptions, } from './models/LanguageOverride.js';
+export type { LanguageCacheValue, LanguageOverrideOptions, LanguageStringDefinition, LanguageStringDefinitionInput, LanguagesPackageConfig, LanguageVariables, ResolvedLanguageString, ResolveLanguageStringOptions, } from './types.js';
+export { buildLocaleFallbackChain, buildTranslationJobId, computeSourceHash, normalizeLocale, renderTemplate, } from './utils.js';
+/** @internal */
+export declare const PACKAGE_VERSION_INITIALIZED = true;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,KAAK,2BAA2B,GACjC,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,OAAO,CAAC"}

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(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-languages\",\"packageVersion\":\"0.51.32\",\"objects\":{\"@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,\"unionBranches\":[{\"type\":\"string\"},{\"type\":\"null\"}]}],\"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,\"memberTypes\":[\"string\",\"number\"]}],\"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  \\\"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_key_locale_idx\",\"columns\":[\"key\",\"locale\",\"context\"],\"unique\":true},{\"name\":\"_smrt_language_overrides_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"_smrt_language_overrides_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"4bef8abc\"},\"importPath\":\"@happyvertical/smrt-languages\"},\"@happyvertical/smrt-languages:LanguageTranslationTask\":{\"name\":\"languagetranslationtask\",\"className\":\"LanguageTranslationTask\",\"qualifiedName\":\"@happyvertical/smrt-languages:LanguageTranslationTask\",\"collection\":\"languagetranslationtasks\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/languages/src/jobs/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_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true},{\"name\":\"language_translation_tasks_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"2cfc8812\"},\"importPath\":\"@happyvertical/smrt-languages/jobs\"},\"@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<this>\",\"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<this>\",\"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_key_locale_idx\",\"columns\":[\"key\",\"locale\",\"context\"],\"unique\":true},{\"name\":\"_smrt_language_overrides_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"_smrt_language_overrides_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"4bef8abc\"},\"importPath\":\"@happyvertical/smrt-languages\"}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-core\",\"@happyvertical/smrt-features\",\"@happyvertical/smrt-jobs\",\"@happyvertical/smrt-prompts\",\"@happyvertical/smrt-tenancy\"]}"));
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-languages\",\"packageVersion\":\"0.51.34\",\"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/jobs/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_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true},{\"name\":\"language_translation_tasks_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"2cfc8812\"},\"importPath\":\"@happyvertical/smrt-languages/jobs\"},\"@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,\"unionBranches\":[{\"type\":\"string\"},{\"type\":\"null\"}]}],\"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,\"memberTypes\":[\"string\",\"number\"]}],\"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  \\\"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_key_locale_idx\",\"columns\":[\"key\",\"locale\",\"context\"],\"unique\":true},{\"name\":\"_smrt_language_overrides_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"_smrt_language_overrides_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"4bef8abc\"},\"importPath\":\"@happyvertical/smrt-languages\"},\"@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<this>\",\"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<this>\",\"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_key_locale_idx\",\"columns\":[\"key\",\"locale\",\"context\"],\"unique\":true},{\"name\":\"_smrt_language_overrides_slug_context_idx\",\"columns\":[\"slug\",\"context\"]},{\"name\":\"_smrt_language_overrides_created_at_idx\",\"columns\":[\"created_at\"]}],\"version\":\"4bef8abc\"},\"importPath\":\"@happyvertical/smrt-languages\"}},\"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";