@versini/sassysaint-common 4.13.0 → 4.14.0

package/dist/index.d.ts

@@ -178,6 +178,109 @@ declare const findProvider: (modelName: string) => null | typeof PROVIDER_ANTHRO
  *
  */
 declare const getProvidersFromModels: (models: string[]) => Array<typeof PROVIDER_OPENAI | typeof PROVIDER_ANTHROPIC | typeof PROVIDER_GOOGLE>;
+/**
+ * Groups allowed models by their respective providers. This function is used to
+ * create nested menu structures in the UI where users can select specific
+ * models within each provider category.
+ *
+ * The function analyzes the given array of model names and organizes them into
+ * a map where keys are provider names and values are arrays of models available
+ * for that provider. Only models that exist in the MODELS_PER_PROVIDER mapping
+ * are included.
+ *
+ * @param models - Array of model names available to the user (e.g., from
+ *   allowedModels in policy configuration).
+ * @returns Map where keys are provider names (PROVIDER_OPENAI,
+ *   PROVIDER_ANTHROPIC, PROVIDER_GOOGLE) and values are arrays of model names
+ *   available for that provider. Returns empty map if no models are provided.
+ *
+ * @example
+ * ```ts
+ * // User has multiple models per provider:
+ * getModelsGroupedByProvider([MODEL_GPT5, MODEL_GPT5_MINI, MODEL_CLAUDE_HAIKU]);
+ * // Returns: Map {
+ * //   "OpenAI" => ["gpt-5", "gpt-5-mini"],
+ * //   "Anthropic" => ["claude-haiku-4-5-20251001"]
+ * // }
+ *
+ * // Single model per provider:
+ * getModelsGroupedByProvider([MODEL_GPT5, MODEL_CLAUDE_HAIKU]);
+ * // Returns: Map {
+ * //   "OpenAI" => ["gpt-5"],
+ * //   "Anthropic" => ["claude-haiku-4-5-20251001"]
+ * // }
+ *
+ * // Empty models array:
+ * getModelsGroupedByProvider([]);
+ * // Returns: Map {}
+ * ```
+ *
+ */
+declare const getModelsGroupedByProvider: (models: string[]) => Map<string, string[]>;
+/**
+ * Checks if the user has multiple models available for at least one provider.
+ * This function is used to determine if the nested model selection feature
+ * should be available to the user.
+ *
+ * The function groups models by provider and checks if any provider has more
+ * than one model. This enables the UI to conditionally show the nested model
+ * selection toggle only to users who would benefit from it.
+ *
+ * @param models - Array of model names available to the user (e.g., from
+ *   allowedModels in policy configuration).
+ * @returns True if at least one provider has multiple models available, false
+ *   otherwise.
+ *
+ * @example
+ * ```ts
+ * // Premium plan with multiple models per provider:
+ * hasMultipleModelsPerProvider([MODEL_GPT5, MODEL_GPT5_MINI, MODEL_CLAUDE_HAIKU]);
+ * // Returns: true (OpenAI has 2 models)
+ *
+ * // Plus plan with one model per provider:
+ * hasMultipleModelsPerProvider([MODEL_GPT5_MINI, MODEL_CLAUDE_HAIKU, MODEL_GEMINI_FLASH]);
+ * // Returns: false (each provider has only 1 model)
+ *
+ * // Basic plan with single model:
+ * hasMultipleModelsPerProvider([MODEL_GPT5_NANO]);
+ * // Returns: false
+ * ```
+ *
+ */
+declare const hasMultipleModelsPerProvider: (models: string[]) => boolean;
+/**
+ * Validates if a selected model is allowed for the user based on their current
+ * plan's allowed models. This function is used to prevent users from using
+ * models they selected under a previous (higher) plan after downgrading.
+ *
+ * The function checks if the model exists in the user's allowedModels array.
+ * Returns false if the model is undefined, null, or not in the allowed list.
+ *
+ * @param selectedModel - The model the user has selected (may be null/undefined
+ *   if no selection was made).
+ * @param allowedModels - Array of model names the user is entitled to use based
+ *   on their current plan.
+ * @returns True if the selected model is in the allowed models list, false
+ *   otherwise.
+ *
+ * @example
+ * ```ts
+ * // User downgrades from Premium to Plus:
+ * const selectedModel = "gpt-4o"; // Was selected when user had Premium
+ * const allowedModels = ["gpt-4o-mini"]; // Plus plan only has mini model
+ * isModelAllowedForPlan(selectedModel, allowedModels); // Returns: false
+ *
+ * // Model is still allowed:
+ * isModelAllowedForPlan("gpt-4o-mini", ["gpt-4o-mini", "claude-haiku"]);
+ * // Returns: true
+ *
+ * // No model selected:
+ * isModelAllowedForPlan(undefined, ["gpt-4o-mini"]);
+ * // Returns: false
+ * ```
+ *
+ */
+declare const isModelAllowedForPlan: (selectedModel: string | undefined | null, allowedModels: string[]) => boolean;
 /**
  * Input type for capability checks. Can be a single capability string or an
  * array of capability strings for checking multiple capabilities at once.
@@ -322,4 +425,4 @@ declare function toCapabilitySet(capabilities: string[] | undefined | null): Set
  */
 declare function isEntitled(capabilitiesOrSet: string[] | Set<string> | null | undefined, required: CapabilityInput, options?: IsEntitledOptions): boolean;
 
-export { ALL_MODELS, ALL_PROVIDERS, ALL_REASONING_MODELS, APPLICATION_NAME, APPROXIMATE_MODELS_PER_PROVIDER, CAPABILITIES, type CapabilityInput, DEFAULT_PROVIDER, DIGGIDY_CHAT_ID_HEADER, type EntitlementStateLike, type IsEntitledOptions, MODELS_PER_PROVIDER, MODEL_CLAUDE_HAIKU, MODEL_CLAUDE_SONNET, MODEL_DEV, MODEL_DISPLAY_NAMES, MODEL_EMBEDDING_TEXT, MODEL_GEMINI_FLASH, MODEL_GEMINI_PRO, MODEL_GPT4_NANO, MODEL_GPT5, MODEL_GPT5_MINI, MODEL_GPT5_NANO, MODEL_MEMORY_INFERENCE, MODEL_SONAR, MODEL_SONAR_PRO, PLAN_BASIC, PLAN_PLUS, PLAN_PREMIUM, PROVIDER_ANTHROPIC, PROVIDER_GOOGLE, PROVIDER_MEMORY, PROVIDER_MISTRAL, PROVIDER_OPENAI, PROVIDER_PERPLEXITY, PROVIDER_ROLE_MAP, PROVIDER_SUMMARY, ROLE_ASSISTANT, ROLE_HIDDEN, ROLE_INTERNAL, ROLE_SYSTEM, ROLE_USER, SORT_BY_TIMESTAMP, SORT_BY_TOKEN_USAGE, findProvider, getProvidersFromModels, isEntitled, isEntitlementLoaded, toCapabilitySet };
+export { ALL_MODELS, ALL_PROVIDERS, ALL_REASONING_MODELS, APPLICATION_NAME, APPROXIMATE_MODELS_PER_PROVIDER, CAPABILITIES, type CapabilityInput, DEFAULT_PROVIDER, DIGGIDY_CHAT_ID_HEADER, type EntitlementStateLike, type IsEntitledOptions, MODELS_PER_PROVIDER, MODEL_CLAUDE_HAIKU, MODEL_CLAUDE_SONNET, MODEL_DEV, MODEL_DISPLAY_NAMES, MODEL_EMBEDDING_TEXT, MODEL_GEMINI_FLASH, MODEL_GEMINI_PRO, MODEL_GPT4_NANO, MODEL_GPT5, MODEL_GPT5_MINI, MODEL_GPT5_NANO, MODEL_MEMORY_INFERENCE, MODEL_SONAR, MODEL_SONAR_PRO, PLAN_BASIC, PLAN_PLUS, PLAN_PREMIUM, PROVIDER_ANTHROPIC, PROVIDER_GOOGLE, PROVIDER_MEMORY, PROVIDER_MISTRAL, PROVIDER_OPENAI, PROVIDER_PERPLEXITY, PROVIDER_ROLE_MAP, PROVIDER_SUMMARY, ROLE_ASSISTANT, ROLE_HIDDEN, ROLE_INTERNAL, ROLE_SYSTEM, ROLE_USER, SORT_BY_TIMESTAMP, SORT_BY_TOKEN_USAGE, findProvider, getModelsGroupedByProvider, getProvidersFromModels, hasMultipleModelsPerProvider, isEntitled, isEntitlementLoaded, isModelAllowedForPlan, toCapabilitySet };

package/dist/index.js

@@ -1,62 +1,62 @@
-const l = "system", E = "user", e = "assistant", X = "hidden", Y = "data", O = "OpenAI", _ = "Anthropic", c = "Google", d = "Summary", g = "Memory", M = "Perplexity", v = "Mistral", b = O, m = [
+const u = "system", e = "user", E = "assistant", X = "hidden", Y = "data", r = "OpenAI", O = "Anthropic", c = "Google", N = "Summary", g = "Memory", I = "Perplexity", b = "Mistral", B = r, f = [
+  r,
   O,
-  _,
   c
-], A = "gpt-5", R = "gpt-5-mini", r = "gpt-5-nano", T = "gpt-4.1-nano", I = "claude-haiku-4-5-20251001", i = "claude-sonnet-4-5-20250929", D = "gemini-2.5-flash", a = "gemini-2.5-pro", S = "sonar", N = "sonar-pro", B = "mistralai/mistral-small-3.2-24b-instruct:free", F = "gpt-4o-mini", W = "text-embedding-3-small", x = {
-  [A]: "GPT-5",
-  [R]: "GPT-5 Mini",
-  [r]: "GPT-5 Nano",
+], _ = "gpt-5", A = "gpt-5-mini", a = "gpt-5-nano", T = "gpt-4.1-nano", D = "claude-haiku-4-5-20251001", R = "claude-sonnet-4-5-20250929", L = "gemini-2.5-flash", P = "gemini-2.5-pro", l = "sonar", S = "sonar-pro", F = "mistralai/mistral-small-3.2-24b-instruct:free", W = "gpt-4o-mini", k = "text-embedding-3-small", x = {
+  [_]: "GPT-5",
+  [A]: "GPT-5 Mini",
+  [a]: "GPT-5 Nano",
   [T]: "GPT-4.1 Nano",
-  [I]: "Claude Haiku 4.5",
-  [i]: "Claude Sonnet 4.5",
-  [D]: "Gemini 2.5 Flash",
-  [a]: "Gemini 2.5 Pro",
-  [S]: "Sonar",
-  [N]: "Sonar Pro"
-}, k = [
+  [D]: "Claude Haiku 4.5",
+  [R]: "Claude Sonnet 4.5",
+  [L]: "Gemini 2.5 Flash",
+  [P]: "Gemini 2.5 Pro",
+  [l]: "Sonar",
+  [S]: "Sonar Pro"
+}, j = [
+  _,
   A,
-  R,
-  r,
-  I,
-  i,
+  a,
   D,
-  a
-], j = [
+  R,
+  L,
+  P
+], w = [
+  _,
   A,
+  a,
   R,
-  r,
-  i,
-  a
-], u = {
-  [O]: [
+  P
+], d = {
+  [r]: [
     T,
+    _,
     A,
-    R,
-    r
-  ],
-  [_]: [I, i],
-  [c]: [D, a],
-  [M]: [S, N]
-}, w = {
-  [O]: [l, E, e],
-  [_]: [E, e],
-  [d]: [E, e],
-  [g]: [E, e],
-  [c]: [E, e],
-  [M]: [E, e]
-}, G = "claude-sonnet-4", f = "claude-3", p = "gpt-", y = "o3", h = "o4", C = "gemini", U = "sonar", H = {
-  [_]: [
-    G,
-    f
+    a
   ],
+  [O]: [D, R],
+  [c]: [L, P],
+  [I]: [l, S]
+}, z = {
+  [r]: [u, e, E],
+  [O]: [e, E],
+  [N]: [e, E],
+  [g]: [e, E],
+  [c]: [e, E],
+  [I]: [e, E]
+}, p = "claude-sonnet-4", G = "claude-3", m = "gpt-", h = "o3", y = "o4", C = "gemini", U = "sonar", v = {
   [O]: [
     p,
-    y,
-    h
+    G
+  ],
+  [r]: [
+    m,
+    h,
+    y
   ],
   [c]: [C],
-  [M]: [U]
-}, z = "x-diggidy-chat-id", K = "timestamp", Z = "tokenUsage", J = "Diggidy", Q = "sassy:basic", $ = "sassy:plus", q = "sassy:advanced", tt = {
+  [I]: [U]
+}, K = "x-diggidy-chat-id", Z = "timestamp", J = "tokenUsage", Q = "Diggidy", $ = "sassy:basic", q = "sassy:plus", tt = "sassy:advanced", nt = {
   TOOL: {
     DATETIME: "getDateTime",
     IMAGES: "getImages",
@@ -74,81 +74,103 @@ const l = "system", E = "user", e = "assistant", X = "hidden", Y = "data", O = "
     REASONING: "addon:reasoning",
     CODEINTERPRETER: "addon:codeinterpreter"
   }
-}, nt = (t) => {
+}, ot = (t) => {
   for (const [n, s] of Object.entries(
-    H
+    v
   ))
     if (s.some((o) => t.startsWith(o)))
       return n;
   return null;
-}, ot = (t) => {
+}, st = (t) => {
   if (!t || t.length === 0)
     return [];
   const n = /* @__PURE__ */ new Set();
   for (const s of t)
-    for (const [o, L] of Object.entries(
-      u
+    for (const [o, i] of Object.entries(
+      d
     ))
-      L.includes(s) && (o === O || o === _ || o === c) && n.add(o);
-  return m.filter((s) => n.has(s));
-};
-function st(t) {
+      i.includes(s) && (o === r || o === O || o === c) && n.add(o);
+  return f.filter((s) => n.has(s));
+}, H = (t) => {
+  const n = /* @__PURE__ */ new Map();
+  if (!t || t.length === 0)
+    return n;
+  for (const s of t)
+    for (const [o, i] of Object.entries(
+      d
+    ))
+      if (i.includes(s)) {
+        n.has(o) || n.set(o, []), n.get(o)?.push(s);
+        break;
+      }
+  return n;
+}, et = (t) => {
+  const n = H(t);
+  for (const s of n.values())
+    if (s.length > 1)
+      return !0;
+  return !1;
+}, Et = (t, n) => !t || !n || n.length === 0 ? !1 : n.includes(t);
+function rt(t) {
   return !!t && Array.isArray(t.capabilities) && t.capabilities.length >= 0;
 }
 function V(t) {
   return t ? new Set(t) : null;
 }
-function Et(t, n, s) {
+function Ot(t, n, s) {
   if (!n || Array.isArray(n) && n.length === 0)
     return !0;
   const o = t instanceof Set ? t : V(t);
-  return !o || o.size === 0 ? !1 : typeof n == "string" ? o.has(n) : s?.any === !0 ? n.some((P) => o.has(P)) : n.every((P) => o.has(P));
+  return !o || o.size === 0 ? !1 : typeof n == "string" ? o.has(n) : s?.any === !0 ? n.some((M) => o.has(M)) : n.every((M) => o.has(M));
 }
 export {
-  k as ALL_MODELS,
-  m as ALL_PROVIDERS,
-  j as ALL_REASONING_MODELS,
-  J as APPLICATION_NAME,
-  H as APPROXIMATE_MODELS_PER_PROVIDER,
-  tt as CAPABILITIES,
-  b as DEFAULT_PROVIDER,
-  z as DIGGIDY_CHAT_ID_HEADER,
-  u as MODELS_PER_PROVIDER,
-  I as MODEL_CLAUDE_HAIKU,
-  i as MODEL_CLAUDE_SONNET,
-  B as MODEL_DEV,
+  j as ALL_MODELS,
+  f as ALL_PROVIDERS,
+  w as ALL_REASONING_MODELS,
+  Q as APPLICATION_NAME,
+  v as APPROXIMATE_MODELS_PER_PROVIDER,
+  nt as CAPABILITIES,
+  B as DEFAULT_PROVIDER,
+  K as DIGGIDY_CHAT_ID_HEADER,
+  d as MODELS_PER_PROVIDER,
+  D as MODEL_CLAUDE_HAIKU,
+  R as MODEL_CLAUDE_SONNET,
+  F as MODEL_DEV,
   x as MODEL_DISPLAY_NAMES,
-  W as MODEL_EMBEDDING_TEXT,
-  D as MODEL_GEMINI_FLASH,
-  a as MODEL_GEMINI_PRO,
+  k as MODEL_EMBEDDING_TEXT,
+  L as MODEL_GEMINI_FLASH,
+  P as MODEL_GEMINI_PRO,
   T as MODEL_GPT4_NANO,
-  A as MODEL_GPT5,
-  R as MODEL_GPT5_MINI,
-  r as MODEL_GPT5_NANO,
-  F as MODEL_MEMORY_INFERENCE,
-  S as MODEL_SONAR,
-  N as MODEL_SONAR_PRO,
-  Q as PLAN_BASIC,
-  $ as PLAN_PLUS,
-  q as PLAN_PREMIUM,
-  _ as PROVIDER_ANTHROPIC,
+  _ as MODEL_GPT5,
+  A as MODEL_GPT5_MINI,
+  a as MODEL_GPT5_NANO,
+  W as MODEL_MEMORY_INFERENCE,
+  l as MODEL_SONAR,
+  S as MODEL_SONAR_PRO,
+  $ as PLAN_BASIC,
+  q as PLAN_PLUS,
+  tt as PLAN_PREMIUM,
+  O as PROVIDER_ANTHROPIC,
   c as PROVIDER_GOOGLE,
   g as PROVIDER_MEMORY,
-  v as PROVIDER_MISTRAL,
-  O as PROVIDER_OPENAI,
-  M as PROVIDER_PERPLEXITY,
-  w as PROVIDER_ROLE_MAP,
-  d as PROVIDER_SUMMARY,
-  e as ROLE_ASSISTANT,
+  b as PROVIDER_MISTRAL,
+  r as PROVIDER_OPENAI,
+  I as PROVIDER_PERPLEXITY,
+  z as PROVIDER_ROLE_MAP,
+  N as PROVIDER_SUMMARY,
+  E as ROLE_ASSISTANT,
   X as ROLE_HIDDEN,
   Y as ROLE_INTERNAL,
-  l as ROLE_SYSTEM,
-  E as ROLE_USER,
-  K as SORT_BY_TIMESTAMP,
-  Z as SORT_BY_TOKEN_USAGE,
-  nt as findProvider,
-  ot as getProvidersFromModels,
-  Et as isEntitled,
-  st as isEntitlementLoaded,
+  u as ROLE_SYSTEM,
+  e as ROLE_USER,
+  Z as SORT_BY_TIMESTAMP,
+  J as SORT_BY_TOKEN_USAGE,
+  ot as findProvider,
+  H as getModelsGroupedByProvider,
+  st as getProvidersFromModels,
+  et as hasMultipleModelsPerProvider,
+  Ot as isEntitled,
+  rt as isEntitlementLoaded,
+  Et as isModelAllowedForPlan,
   V as toCapabilitySet
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/sassysaint-common",
-	"version": "4.13.0",
+	"version": "4.14.0",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -32,5 +32,5 @@
 		"test:watch": "vitest",
 		"watch": "npm-run-all dev"
 	},
-	"gitHead": "89572beafadc51e691166d4334c4ce4d1002f682"
+	"gitHead": "0acf9b121471aaae4654d8909a6ac0168486ee91"
 }