@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/config/brand-assets.shared.schemas.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+/**
+ * RUNTIME brand-asset representation — the servable projection of the
+ * authored/generated brand identity, importable by every runtime consumer
+ * (app shell, org branding, email, auth, website, docs).
+ *
+ * WHY A RUNTIME SIBLING: the authoring/spec `BrandAssetConfig` lives in
+ * `@wildo-ai/saas-specifications`, which sits BELOW `saas-models` in the
+ * dependency graph — runtime consumers (this package and above) cannot import
+ * it. This is the runtime counterpart the companion PROJECTS the generated
+ * brand manifest into: a flat list of `(composition × theme × purpose) → url`
+ * entries a consumer resolves against by the axes it cares about (the app-shell
+ * header asks for `(LOCKUP, DEFAULT)`, the favicon for `(SYMBOL, DEFAULT,
+ * FAVICON)`). Enum VALUES are kept identical to the spec enums so the
+ * companion's projection is a value-preserving map — a value present in one
+ * enum and not the other makes `projectResolvedAssets` throw, by design.
+ */
+export declare enum BrandAssetComposition {
+    SYMBOL = "SYMBOL",
+    WORDMARK = "WORDMARK",
+    LOCKUP = "LOCKUP"
+}
+export declare enum BrandAssetTheme {
+    DEFAULT = "DEFAULT",
+    DARK = "DARK",
+    LIGHT = "LIGHT",
+    MONOCHROME = "MONOCHROME"
+}
+export declare enum BrandAssetPurpose {
+    /**
+     * Full-resolution generated source — print, high-DPI export, re-derivation.
+     * Reachable ONLY by an exact {@link resolveBrandAsset} query: it is
+     * deliberately absent from every fallback rung, so no consumer is ever handed
+     * an unbounded file it did not ask for. A UI surface wants {@link PRIMARY}.
+     */
+    MASTER = "MASTER",
+    /** The base DISPLAY form of a (composition, theme) — what a UI surface renders. */
+    PRIMARY = "PRIMARY",
+    FAVICON = "FAVICON",
+    APPLE_TOUCH_ICON = "APPLE_TOUCH_ICON",
+    MASKABLE_ICON = "MASKABLE_ICON",
+    OG_IMAGE = "OG_IMAGE",
+    EMAIL = "EMAIL"
+}
+export declare enum BrandAssetFormat {
+    PNG = "PNG",
+    SVG = "SVG",
+    ICO = "ICO",
+    WEBP = "WEBP"
+}
+declare const _RuntimeBrandAssetSchema: z.ZodObject<{
+    composition: z.ZodEnum<typeof BrandAssetComposition>;
+    theme: z.ZodEnum<typeof BrandAssetTheme>;
+    purpose: z.ZodEnum<typeof BrandAssetPurpose>;
+    url: z.ZodString;
+    format: z.ZodEnum<typeof BrandAssetFormat>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const RuntimeBrandAssetSchema: typeof _RuntimeBrandAssetSchema;
+export type RuntimeBrandAsset = z.infer<typeof _RuntimeBrandAssetSchema>;
+/** A resolution query — composition is required; theme/purpose default sensibly. */
+export interface BrandAssetQuery {
+    composition: BrandAssetComposition;
+    theme?: BrandAssetTheme;
+    purpose?: BrandAssetPurpose;
+}
+/**
+ * Resolves the best runtime brand asset for a query, with graceful fallbacks so
+ * a consumer always gets *something* when a specific variant was not generated:
+ *
+ * 1. exact `(composition, theme, purpose)` match, else
+ * 2. same `(composition, purpose)` at `theme: DEFAULT`, else
+ * 3. same `composition` at `(DEFAULT, PRIMARY)`, else
+ * 4. any `(DEFAULT, PRIMARY)` asset, else `undefined`.
+ *
+ * NOTE RUNGS 3 AND 4 BOTH TARGET `PRIMARY`: it is the universal last-resort, so
+ * whatever occupies it is what every unresolved query in the system degrades to.
+ * That is why {@link BrandAssetPurpose.MASTER} exists as a separate slot and
+ * appears on NO rung here — the full-resolution source must be asked for by an
+ * exact query (rung 1) and can never be handed to a consumer by a fallback.
+ * Keep it that way when editing the ladder.
+ *
+ * Returns `undefined` when the list is empty (no brand generated yet) — the
+ * caller keeps its existing fallback (e.g. a placeholder or the legacy URL).
+ */
+export declare function resolveBrandAsset(assets: RuntimeBrandAsset[], query: BrandAssetQuery): RuntimeBrandAsset | undefined;
+export {};
+//# sourceMappingURL=brand-assets.shared.schemas.d.ts.map

package/dist/esm/config/brand-assets.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-assets.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/config/brand-assets.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,qBAAqB;IAC/B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,UAAU,eAAe;CAC1B;AAED,oBAAY,iBAAiB;IAC3B;;;;;OAKG;IACH,MAAM,WAAW;IACjB,mFAAmF;IACnF,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,QAAQ,aAAa;IACrB,KAAK,UAAU;CAChB;AAED,oBAAY,gBAAgB;IAC1B,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,QAAA,MAAM,wBAAwB;;;;;;;;iBAS5B,CAAC;AACH,eAAO,MAAM,uBAAuB,EAAE,OAAO,wBAAmD,CAAC;AACjG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEzE,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,qBAAqB,CAAC;IACnC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,KAAK,EAAE,eAAe,GACrB,iBAAiB,GAAG,SAAS,CAsB/B"}

package/dist/esm/config/brand-assets.shared.schemas.js

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+/**
+ * RUNTIME brand-asset representation — the servable projection of the
+ * authored/generated brand identity, importable by every runtime consumer
+ * (app shell, org branding, email, auth, website, docs).
+ *
+ * WHY A RUNTIME SIBLING: the authoring/spec `BrandAssetConfig` lives in
+ * `@wildo-ai/saas-specifications`, which sits BELOW `saas-models` in the
+ * dependency graph — runtime consumers (this package and above) cannot import
+ * it. This is the runtime counterpart the companion PROJECTS the generated
+ * brand manifest into: a flat list of `(composition × theme × purpose) → url`
+ * entries a consumer resolves against by the axes it cares about (the app-shell
+ * header asks for `(LOCKUP, DEFAULT)`, the favicon for `(SYMBOL, DEFAULT,
+ * FAVICON)`). Enum VALUES are kept identical to the spec enums so the
+ * companion's projection is a value-preserving map — a value present in one
+ * enum and not the other makes `projectResolvedAssets` throw, by design.
+ */
+export var BrandAssetComposition;
+(function (BrandAssetComposition) {
+    BrandAssetComposition["SYMBOL"] = "SYMBOL";
+    BrandAssetComposition["WORDMARK"] = "WORDMARK";
+    BrandAssetComposition["LOCKUP"] = "LOCKUP";
+})(BrandAssetComposition || (BrandAssetComposition = {}));
+export var BrandAssetTheme;
+(function (BrandAssetTheme) {
+    BrandAssetTheme["DEFAULT"] = "DEFAULT";
+    BrandAssetTheme["DARK"] = "DARK";
+    BrandAssetTheme["LIGHT"] = "LIGHT";
+    BrandAssetTheme["MONOCHROME"] = "MONOCHROME";
+})(BrandAssetTheme || (BrandAssetTheme = {}));
+export var BrandAssetPurpose;
+(function (BrandAssetPurpose) {
+    /**
+     * Full-resolution generated source — print, high-DPI export, re-derivation.
+     * Reachable ONLY by an exact {@link resolveBrandAsset} query: it is
+     * deliberately absent from every fallback rung, so no consumer is ever handed
+     * an unbounded file it did not ask for. A UI surface wants {@link PRIMARY}.
+     */
+    BrandAssetPurpose["MASTER"] = "MASTER";
+    /** The base DISPLAY form of a (composition, theme) — what a UI surface renders. */
+    BrandAssetPurpose["PRIMARY"] = "PRIMARY";
+    BrandAssetPurpose["FAVICON"] = "FAVICON";
+    BrandAssetPurpose["APPLE_TOUCH_ICON"] = "APPLE_TOUCH_ICON";
+    BrandAssetPurpose["MASKABLE_ICON"] = "MASKABLE_ICON";
+    BrandAssetPurpose["OG_IMAGE"] = "OG_IMAGE";
+    BrandAssetPurpose["EMAIL"] = "EMAIL";
+})(BrandAssetPurpose || (BrandAssetPurpose = {}));
+export var BrandAssetFormat;
+(function (BrandAssetFormat) {
+    BrandAssetFormat["PNG"] = "PNG";
+    BrandAssetFormat["SVG"] = "SVG";
+    BrandAssetFormat["ICO"] = "ICO";
+    BrandAssetFormat["WEBP"] = "WEBP";
+})(BrandAssetFormat || (BrandAssetFormat = {}));
+const _RuntimeBrandAssetSchema = z.object({
+    composition: z.enum(BrandAssetComposition),
+    theme: z.enum(BrandAssetTheme),
+    purpose: z.enum(BrandAssetPurpose),
+    /** A servable URL or app-relative path for the asset file. */
+    url: z.string().min(1),
+    format: z.enum(BrandAssetFormat),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+});
+export const RuntimeBrandAssetSchema = _RuntimeBrandAssetSchema;
+/**
+ * Resolves the best runtime brand asset for a query, with graceful fallbacks so
+ * a consumer always gets *something* when a specific variant was not generated:
+ *
+ * 1. exact `(composition, theme, purpose)` match, else
+ * 2. same `(composition, purpose)` at `theme: DEFAULT`, else
+ * 3. same `composition` at `(DEFAULT, PRIMARY)`, else
+ * 4. any `(DEFAULT, PRIMARY)` asset, else `undefined`.
+ *
+ * NOTE RUNGS 3 AND 4 BOTH TARGET `PRIMARY`: it is the universal last-resort, so
+ * whatever occupies it is what every unresolved query in the system degrades to.
+ * That is why {@link BrandAssetPurpose.MASTER} exists as a separate slot and
+ * appears on NO rung here — the full-resolution source must be asked for by an
+ * exact query (rung 1) and can never be handed to a consumer by a fallback.
+ * Keep it that way when editing the ladder.
+ *
+ * Returns `undefined` when the list is empty (no brand generated yet) — the
+ * caller keeps its existing fallback (e.g. a placeholder or the legacy URL).
+ */
+export function resolveBrandAsset(assets, query) {
+    const theme = query.theme ?? BrandAssetTheme.DEFAULT;
+    const purpose = query.purpose ?? BrandAssetPurpose.PRIMARY;
+    const exact = assets.find((a) => a.composition === query.composition && a.theme === theme && a.purpose === purpose);
+    if (exact)
+        return exact;
+    const themeFallback = assets.find((a) => a.composition === query.composition && a.theme === BrandAssetTheme.DEFAULT && a.purpose === purpose);
+    if (themeFallback)
+        return themeFallback;
+    const compositionPrimary = assets.find((a) => a.composition === query.composition && a.theme === BrandAssetTheme.DEFAULT && a.purpose === BrandAssetPurpose.PRIMARY);
+    if (compositionPrimary)
+        return compositionPrimary;
+    return assets.find((a) => a.theme === BrandAssetTheme.DEFAULT && a.purpose === BrandAssetPurpose.PRIMARY);
+}
+//# sourceMappingURL=brand-assets.shared.schemas.js.map

package/dist/esm/config/brand-assets.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-assets.shared.schemas.js","sourceRoot":"","sources":["../../../../src/config/brand-assets.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\n/**\n * RUNTIME brand-asset representation — the servable projection of the\n * authored/generated brand identity, importable by every runtime consumer\n * (app shell, org branding, email, auth, website, docs).\n *\n * WHY A RUNTIME SIBLING: the authoring/spec `BrandAssetConfig` lives in\n * `@wildo-ai/saas-specifications`, which sits BELOW `saas-models` in the\n * dependency graph — runtime consumers (this package and above) cannot import\n * it. This is the runtime counterpart the companion PROJECTS the generated\n * brand manifest into: a flat list of `(composition × theme × purpose) → url`\n * entries a consumer resolves against by the axes it cares about (the app-shell\n * header asks for `(LOCKUP, DEFAULT)`, the favicon for `(SYMBOL, DEFAULT,\n * FAVICON)`). Enum VALUES are kept identical to the spec enums so the\n * companion's projection is a value-preserving map — a value present in one\n * enum and not the other makes `projectResolvedAssets` throw, by design.\n */\nexport enum BrandAssetComposition {\n  SYMBOL = 'SYMBOL',\n  WORDMARK = 'WORDMARK',\n  LOCKUP = 'LOCKUP',\n}\n\nexport enum BrandAssetTheme {\n  DEFAULT = 'DEFAULT',\n  DARK = 'DARK',\n  LIGHT = 'LIGHT',\n  MONOCHROME = 'MONOCHROME',\n}\n\nexport enum BrandAssetPurpose {\n  /**\n   * Full-resolution generated source — print, high-DPI export, re-derivation.\n   * Reachable ONLY by an exact {@link resolveBrandAsset} query: it is\n   * deliberately absent from every fallback rung, so no consumer is ever handed\n   * an unbounded file it did not ask for. A UI surface wants {@link PRIMARY}.\n   */\n  MASTER = 'MASTER',\n  /** The base DISPLAY form of a (composition, theme) — what a UI surface renders. */\n  PRIMARY = 'PRIMARY',\n  FAVICON = 'FAVICON',\n  APPLE_TOUCH_ICON = 'APPLE_TOUCH_ICON',\n  MASKABLE_ICON = 'MASKABLE_ICON',\n  OG_IMAGE = 'OG_IMAGE',\n  EMAIL = 'EMAIL',\n}\n\nexport enum BrandAssetFormat {\n  PNG = 'PNG',\n  SVG = 'SVG',\n  ICO = 'ICO',\n  WEBP = 'WEBP',\n}\n\nconst _RuntimeBrandAssetSchema = z.object({\n  composition: z.enum(BrandAssetComposition),\n  theme: z.enum(BrandAssetTheme),\n  purpose: z.enum(BrandAssetPurpose),\n  /** A servable URL or app-relative path for the asset file. */\n  url: z.string().min(1),\n  format: z.enum(BrandAssetFormat),\n  width: z.number().int().positive().optional(),\n  height: z.number().int().positive().optional(),\n});\nexport const RuntimeBrandAssetSchema: typeof _RuntimeBrandAssetSchema = _RuntimeBrandAssetSchema;\nexport type RuntimeBrandAsset = z.infer<typeof _RuntimeBrandAssetSchema>;\n\n/** A resolution query — composition is required; theme/purpose default sensibly. */\nexport interface BrandAssetQuery {\n  composition: BrandAssetComposition;\n  theme?: BrandAssetTheme;\n  purpose?: BrandAssetPurpose;\n}\n\n/**\n * Resolves the best runtime brand asset for a query, with graceful fallbacks so\n * a consumer always gets *something* when a specific variant was not generated:\n *\n * 1. exact `(composition, theme, purpose)` match, else\n * 2. same `(composition, purpose)` at `theme: DEFAULT`, else\n * 3. same `composition` at `(DEFAULT, PRIMARY)`, else\n * 4. any `(DEFAULT, PRIMARY)` asset, else `undefined`.\n *\n * NOTE RUNGS 3 AND 4 BOTH TARGET `PRIMARY`: it is the universal last-resort, so\n * whatever occupies it is what every unresolved query in the system degrades to.\n * That is why {@link BrandAssetPurpose.MASTER} exists as a separate slot and\n * appears on NO rung here — the full-resolution source must be asked for by an\n * exact query (rung 1) and can never be handed to a consumer by a fallback.\n * Keep it that way when editing the ladder.\n *\n * Returns `undefined` when the list is empty (no brand generated yet) — the\n * caller keeps its existing fallback (e.g. a placeholder or the legacy URL).\n */\nexport function resolveBrandAsset(\n  assets: RuntimeBrandAsset[],\n  query: BrandAssetQuery,\n): RuntimeBrandAsset | undefined {\n  const theme = query.theme ?? BrandAssetTheme.DEFAULT;\n  const purpose = query.purpose ?? BrandAssetPurpose.PRIMARY;\n\n  const exact = assets.find(\n    (a) => a.composition === query.composition && a.theme === theme && a.purpose === purpose,\n  );\n  if (exact) return exact;\n\n  const themeFallback = assets.find(\n    (a) => a.composition === query.composition && a.theme === BrandAssetTheme.DEFAULT && a.purpose === purpose,\n  );\n  if (themeFallback) return themeFallback;\n\n  const compositionPrimary = assets.find(\n    (a) => a.composition === query.composition && a.theme === BrandAssetTheme.DEFAULT && a.purpose === BrandAssetPurpose.PRIMARY,\n  );\n  if (compositionPrimary) return compositionPrimary;\n\n  return assets.find(\n    (a) => a.theme === BrandAssetTheme.DEFAULT && a.purpose === BrandAssetPurpose.PRIMARY,\n  );\n}\n"]}

package/dist/esm/config/configuration-validation.shared.schemas.d.ts

@@ -20,7 +20,18 @@ export declare enum ConfigurationValidationDomain {
     FEATURES = "FEATURES",
     BILLING = "BILLING",
     LIFECYCLE = "LIFECYCLE",
-    I18N = "I18N"
+    I18N = "I18N",
+    /**
+     * RAG derived-data-tier capability checks: `.ragSource()` field declarations cross-referenced
+     * against the owning datastore's vector capability — pgvector on PostgreSQL, `mongot` (MongoDB
+     * Search / Vector Search, a process beside `mongod`) on MongoDB. Both are proven by EXECUTING a
+     * command on the live connection rather than by reading a version, because a server can report a
+     * capable version while lacking the extension or the sidecar that implements it.
+     *
+     * Fail-closed at boot because chunks already written into an unreachable store are an ERASURE
+     * dead-end, not merely a degraded feature.
+     */
+    RAG = "RAG"
 }
 export interface ConfigurationValidationIssue {
     severity: ConfigurationValidationSeverity;

package/dist/esm/config/configuration-validation.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-validation.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/config/configuration-validation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,oBAAY,+BAA+B;IACzC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAMD,oBAAY,6BAA6B;IACvC,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,iBAAiB,sBAAsB;IACvC,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,IAAI,SAAS;CACd;AAMD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,MAAM,EAAE,6BAA6B,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,4BAA4B,EAAE,GAAG,6BAA6B,CAK3G;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,6BAA6B,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,4BAA4B,CAE9B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,6BAA6B,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,4BAA4B,CAE9B"}
+{"version":3,"file":"configuration-validation.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/config/configuration-validation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,oBAAY,+BAA+B;IACzC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAMD,oBAAY,6BAA6B;IACvC,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,iBAAiB,sBAAsB;IACvC,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,IAAI,SAAS;IACb;;;;;;;;;OASG;IACH,GAAG,QAAQ;CACZ;AAMD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,MAAM,EAAE,6BAA6B,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,4BAA4B,EAAE,GAAG,6BAA6B,CAK3G;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,6BAA6B,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,4BAA4B,CAE9B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,6BAA6B,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,4BAA4B,CAE9B"}

package/dist/esm/config/configuration-validation.shared.schemas.js

@@ -29,6 +29,17 @@ export var ConfigurationValidationDomain;
     ConfigurationValidationDomain["BILLING"] = "BILLING";
     ConfigurationValidationDomain["LIFECYCLE"] = "LIFECYCLE";
     ConfigurationValidationDomain["I18N"] = "I18N";
+    /**
+     * RAG derived-data-tier capability checks: `.ragSource()` field declarations cross-referenced
+     * against the owning datastore's vector capability — pgvector on PostgreSQL, `mongot` (MongoDB
+     * Search / Vector Search, a process beside `mongod`) on MongoDB. Both are proven by EXECUTING a
+     * command on the live connection rather than by reading a version, because a server can report a
+     * capable version while lacking the extension or the sidecar that implements it.
+     *
+     * Fail-closed at boot because chunks already written into an unreachable store are an ERASURE
+     * dead-end, not merely a degraded feature.
+     */
+    ConfigurationValidationDomain["RAG"] = "RAG";
 })(ConfigurationValidationDomain || (ConfigurationValidationDomain = {}));
 // ---------------------------------------------------------------------------
 // Helpers
@@ -45,4 +56,4 @@ export function issueError(domain, message, context) {
 export function issueWarning(domain, message, context) {
     return { severity: ConfigurationValidationSeverity.WARNING, domain, message, context };
 }
-//# sourceMappingURL=configuration-validation.shared.schemas.js.map
+//# sourceMappingURL=configuration-validation.shared.schemas.js.map

package/dist/esm/config/configuration-validation.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-validation.shared.schemas.js","sourceRoot":"","sources":["../../../src/config/configuration-validation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,CAAN,IAAY,+BAGX;AAHD,WAAY,+BAA+B;IACzC,kDAAe,CAAA;IACf,sDAAmB,CAAA;AACrB,CAAC,EAHW,+BAA+B,KAA/B,+BAA+B,QAG1C;AAED,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,CAAN,IAAY,6BASX;AATD,WAAY,6BAA6B;IACvC,oDAAmB,CAAA;IACnB,8CAAa,CAAA;IACb,kDAAiB,CAAA;IACjB,wEAAuC,CAAA;IACvC,sDAAqB,CAAA;IACrB,oDAAmB,CAAA;IACnB,wDAAuB,CAAA;IACvB,8CAAa,CAAA;AACf,CAAC,EATW,6BAA6B,KAA7B,6BAA6B,QASxC;AAsBD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAU,qBAAqB,CAAC,MAAsC;IAC1E,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,+BAA+B,CAAC,KAAK,CAAC;KACjF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAqC,EACrC,OAAe,EACf,OAAiC;IAEjC,OAAO,EAAE,QAAQ,EAAE,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAqC,EACrC,OAAe,EACf,OAAiC;IAEjC,OAAO,EAAE,QAAQ,EAAE,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACzF,CAAC"}
+{"version":3,"file":"configuration-validation.shared.schemas.js","sourceRoot":"","sources":["../../../../src/config/configuration-validation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,CAAN,IAAY,+BAGX;AAHD,WAAY,+BAA+B;IACzC,kDAAe,CAAA;IACf,sDAAmB,CAAA;AACrB,CAAC,EAHW,+BAA+B,KAA/B,+BAA+B,QAG1C;AAED,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,CAAN,IAAY,6BAoBX;AApBD,WAAY,6BAA6B;IACvC,oDAAmB,CAAA;IACnB,8CAAa,CAAA;IACb,kDAAiB,CAAA;IACjB,wEAAuC,CAAA;IACvC,sDAAqB,CAAA;IACrB,oDAAmB,CAAA;IACnB,wDAAuB,CAAA;IACvB,8CAAa,CAAA;IACb;;;;;;;;;OASG;IACH,4CAAW,CAAA;AACb,CAAC,EApBW,6BAA6B,KAA7B,6BAA6B,QAoBxC;AAsBD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAU,qBAAqB,CAAC,MAAsC;IAC1E,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,+BAA+B,CAAC,KAAK,CAAC;KACjF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAqC,EACrC,OAAe,EACf,OAAiC;IAEjC,OAAO,EAAE,QAAQ,EAAE,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAqC,EACrC,OAAe,EACf,OAAiC;IAEjC,OAAO,EAAE,QAAQ,EAAE,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACzF,CAAC","sourcesContent":["/**\n * Configuration Validation — shared contract for startup cross-checks.\n *\n * Used by both backend (ApplicationStartupConfigValidatorService) and\n * frontend (future AppShellConfigValidatorService) to produce structured\n * validation reports after registry initialization.\n *\n * Each validator returns ConfigurationValidationIssue[] and the runner\n * collects, logs, and optionally throws on errors.\n */\n\n// ---------------------------------------------------------------------------\n// Issue severity\n// ---------------------------------------------------------------------------\n\nexport enum ConfigurationValidationSeverity {\n  ERROR = 'ERROR',\n  WARNING = 'WARNING',\n}\n\n// ---------------------------------------------------------------------------\n// Validation domain — groups related cross-checks\n// ---------------------------------------------------------------------------\n\nexport enum ConfigurationValidationDomain {\n  STORAGE = 'STORAGE',\n  AUTH = 'AUTH',\n  AGENTS = 'AGENTS',\n  FRONTEND_SERVICES = 'FRONTEND_SERVICES',\n  FEATURES = 'FEATURES',\n  BILLING = 'BILLING',\n  LIFECYCLE = 'LIFECYCLE',\n  I18N = 'I18N',\n  /**\n   * RAG derived-data-tier capability checks: `.ragSource()` field declarations cross-referenced\n   * against the owning datastore's vector capability — pgvector on PostgreSQL, `mongot` (MongoDB\n   * Search / Vector Search, a process beside `mongod`) on MongoDB. Both are proven by EXECUTING a\n   * command on the live connection rather than by reading a version, because a server can report a\n   * capable version while lacking the extension or the sidecar that implements it.\n   *\n   * Fail-closed at boot because chunks already written into an unreachable store are an ERASURE\n   * dead-end, not merely a degraded feature.\n   */\n  RAG = 'RAG',\n}\n\n// ---------------------------------------------------------------------------\n// Issue shape\n// ---------------------------------------------------------------------------\n\nexport interface ConfigurationValidationIssue {\n  severity: ConfigurationValidationSeverity;\n  domain: ConfigurationValidationDomain;\n  message: string;\n  context?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Aggregated result\n// ---------------------------------------------------------------------------\n\nexport interface ConfigurationValidationResult {\n  issues: ConfigurationValidationIssue[];\n  valid: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nexport function buildValidationResult(issues: ConfigurationValidationIssue[]): ConfigurationValidationResult {\n  return {\n    issues,\n    valid: issues.every((i) => i.severity !== ConfigurationValidationSeverity.ERROR),\n  };\n}\n\nexport function issueError(\n  domain: ConfigurationValidationDomain,\n  message: string,\n  context?: Record<string, unknown>,\n): ConfigurationValidationIssue {\n  return { severity: ConfigurationValidationSeverity.ERROR, domain, message, context };\n}\n\nexport function issueWarning(\n  domain: ConfigurationValidationDomain,\n  message: string,\n  context?: Record<string, unknown>,\n): ConfigurationValidationIssue {\n  return { severity: ConfigurationValidationSeverity.WARNING, domain, message, context };\n}\n"]}