@versini/sassysaint-common 4.3.0 → 4.4.0

package/dist/index.d.ts

@@ -54,22 +54,6 @@ declare const PROVIDER_ROLE_MAP: {
     Google: string[];
     Perplexity: string[];
 };
-/**
- * List of all plans available.
- */
-declare const PLAN_FREE = "sassy:free";
-declare const PLAN_PLUS = "sassy:plus";
-declare const PLAN_PREMIUM = "sassy:advanced";
-/**
- * List of grants available.
- */
-declare const POLICY_GRANTS: {
-    PLAN_FREE: string;
-    PLAN_PLUS: string;
-    PLAN_PREMIUM: string;
-    REASONING: string;
-    WEBSEARCH: string;
-};
 /**
  * Header string for Callisto Chat Id. Used to identify the chat in the server
  * when there is a client abort.
@@ -332,4 +316,65 @@ declare namespace index {
   export { type index_ClientCryptoKeyPair as ClientCryptoKeyPair, type index_CryptoConfig as CryptoConfig, index_CryptoError as CryptoError, type index_CryptoSession as CryptoSession, index_DEFAULT_CRYPTO_CONFIG as DEFAULT_CRYPTO_CONFIG, type index_EncryptedMessage as EncryptedMessage, type index_KeyExchangeResponse as KeyExchangeResponse, type index_RSAKeyGenParams as RSAKeyGenParams, type index_SerializablePublicKey as SerializablePublicKey, index_arrayBufferToBase64 as arrayBufferToBase64, index_base64ToArrayBuffer as base64ToArrayBuffer, index_canUseEncryption as canUseEncryption, index_debugLog as debugLog, index_decryptFromServer as decryptFromServer, index_encryptForServer as encryptForServer, index_establishCryptoSession as establishCryptoSession, index_exportPublicKey as exportPublicKey, index_generateClientKeyPair as generateClientKeyPair, index_generateDeviceId as generateDeviceId, index_importServerPublicKey as importServerPublicKey, index_isCryptoSessionValid as isCryptoSessionValid, index_isSecureContext as isSecureContext, index_isWebCryptoSupported as isWebCryptoSupported, index_safeParse as safeParse, index_safeStringify as safeStringify };
 }
 
-export { ALL_MODELS, ALL_PROVIDERS, ALL_REASONING_MODELS, APPLICATION_NAME, CALLISTO_CHAT_ID_HEADER, DEFAULT_PROVIDER, MODELS_PER_PROVIDER, MODEL_CLAUDE_HAIKU, MODEL_CLAUDE_SONNET, MODEL_GEMINI_FLASH, MODEL_GEMINI_PRO, MODEL_GPT, MODEL_GPT4_MINI, MODEL_O4_MINI, MODEL_SONAR, MODEL_SONAR_PRO, PLAN_FREE, PLAN_PLUS, PLAN_PREMIUM, POLICY_GRANTS, PROVIDER_ANTHROPIC, PROVIDER_GOOGLE, PROVIDER_MEMORY, 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, index as crypto, findProvider };
+/**
+ * List of all plans available.
+ */
+declare const PLAN_FREE = "sassy:free";
+declare const PLAN_PLUS = "sassy:plus";
+declare const PLAN_PREMIUM = "sassy:advanced";
+/**
+ * List of grants available (coarse grain). This is to be used by client with
+ * the isGranted() helper to check for feature availability via JWT
+ * capabilities.
+ */
+declare const POLICY_GRANTS: {
+    PLAN_FREE: string;
+    PLAN_PLUS: string;
+    PLAN_PREMIUM: string;
+    REASONING: string;
+};
+/**
+ * Capability constants (single source of truth for string ids).
+ * NOTE: these map 1:1 to tool names in ALL_TOOLS from @sassysaint/tools
+ * therefore each tools needs to import this file to name its tool correctly.
+ */
+declare const CAPABILITIES: {
+    readonly TOOL: {
+        readonly DATETIME: "getDateTime";
+        readonly IMAGES: "getImages";
+        readonly POLLUTION: "getAirPollution";
+        readonly WEATHER: "getWeather";
+        readonly URLCONTENTPARSER: "getUrlContent";
+        readonly MEMORIES: "getUserMemories";
+        readonly HUMANIZE: "humanize";
+        readonly WEBSEARCH: "getWebSearch";
+        readonly GITREPOSITORY: "getGitRepoDetails";
+        readonly HOTELS: "getHotelDetails";
+        readonly ATTACHMENTS: "tool:attachments";
+    };
+};
+/**
+ * Capability entitlement helper (client/server shared).
+ */
+type CapabilityInput = string | readonly string[];
+interface IsEntitledOptions {
+    /**
+     * Allow entitlement if ANY capability matches (OR). Default false = require
+     * ALL.
+     */
+    any?: boolean;
+    /**
+     * Pre-supplied Set; if absent we'll build one from `capabilities`.
+     */
+    set?: Set<string>;
+}
+interface EntitlementStateLike {
+    capabilities?: string[];
+    version?: number;
+    status?: string;
+}
+declare function isEntitlementLoaded(state: EntitlementStateLike | null | undefined): boolean;
+declare function toCapabilitySet(capabilities: string[] | undefined | null): Set<string> | null;
+declare function isEntitled(capabilitiesOrSet: string[] | Set<string> | null | undefined, required: CapabilityInput, options?: IsEntitledOptions): boolean;
+
+export { ALL_MODELS, ALL_PROVIDERS, ALL_REASONING_MODELS, APPLICATION_NAME, CALLISTO_CHAT_ID_HEADER, CAPABILITIES, type CapabilityInput, DEFAULT_PROVIDER, type EntitlementStateLike, type IsEntitledOptions, MODELS_PER_PROVIDER, MODEL_CLAUDE_HAIKU, MODEL_CLAUDE_SONNET, MODEL_GEMINI_FLASH, MODEL_GEMINI_PRO, MODEL_GPT, MODEL_GPT4_MINI, MODEL_O4_MINI, MODEL_SONAR, MODEL_SONAR_PRO, PLAN_FREE, PLAN_PLUS, PLAN_PREMIUM, POLICY_GRANTS, PROVIDER_ANTHROPIC, PROVIDER_GOOGLE, PROVIDER_MEMORY, 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, index as crypto, findProvider, isEntitled, isEntitlementLoaded, toCapabilitySet };

package/dist/index.js

@@ -1,72 +1,66 @@
-const w = "system", s = "user", c = "assistant", re = "hidden", ne = "data", a = "OpenAI", i = "Anthropic", E = "Google", M = "Summary", g = "Memory", d = "Perplexity", oe = a, se = [
-  a,
+const D = "system", a = "user", c = "assistant", ne = "hidden", re = "data", i = "OpenAI", E = "Anthropic", y = "Google", T = "Summary", M = "Memory", u = "Perplexity", oe = i, se = [
   i,
-  E
-], A = "gpt-5", _ = "gpt-4.1-nano", m = "o4-mini", l = "claude-3-5-haiku-20241022", u = "claude-sonnet-4-20250514", R = "gemini-2.5-flash", p = "gemini-2.5-pro", f = "sonar", P = "sonar-pro", ce = [
-  A,
+  E,
+  y
+], O = "gpt-5", p = "gpt-4.1-nano", w = "o4-mini", f = "claude-3-5-haiku-20241022", d = "claude-sonnet-4-20250514", _ = "gemini-2.5-flash", l = "gemini-2.5-pro", R = "sonar", P = "sonar-pro", ae = [
+  O,
+  p,
+  w,
+  f,
+  d,
   _,
-  m,
   l,
-  u,
   R,
-  p,
-  f,
   P
-], ae = [
-  A,
-  u,
-  p
-], b = "claude-sonnet-4", h = "claude-3", T = "gpt-", N = "o3", v = "o4", C = "gemini", K = "sonar", U = {
-  [i]: [
-    b,
+], ce = [
+  O,
+  d,
+  l
+], m = "claude-sonnet-4", h = "claude-3", b = "gpt-", N = "o3", C = "o4", v = "gemini", U = "sonar", K = {
+  [E]: [
+    m,
     h
   ],
-  [a]: [
-    T,
+  [i]: [
+    b,
     N,
-    v
+    C
   ],
-  [E]: [C],
-  [d]: [K]
+  [y]: [v],
+  [u]: [U]
 }, ie = {
-  [a]: [_, A],
-  [i]: [l, u],
-  [E]: [R, p],
-  [d]: [f, P]
+  [i]: [p, O],
+  [E]: [f, d],
+  [y]: [_, l],
+  [u]: [R, P]
 }, Ee = {
-  [a]: [w, s, c],
-  [i]: [s, c],
-  [M]: [s, c],
-  [g]: [s, c],
-  [E]: [s, c],
-  [d]: [s, c]
-}, k = "sassy:free", F = "sassy:plus", G = "sassy:advanced", V = "sassy:advanced:reasoning", Y = "sassy:advanced:websearch", ye = {
-  PLAN_FREE: k,
-  PLAN_PLUS: F,
-  PLAN_PREMIUM: G,
-  REASONING: V,
-  WEBSEARCH: Y
-}, de = "x-callisto-chat-id", Ae = (r) => {
-  for (const [e, n] of Object.entries(
-    U
+  [i]: [D, a, c],
+  [E]: [a, c],
+  [T]: [a, c],
+  [M]: [a, c],
+  [y]: [a, c],
+  [u]: [a, c]
+}, ye = "x-callisto-chat-id", Ae = (n) => {
+  for (const [e, r] of Object.entries(
+    K
   ))
-    if (n.some((t) => r.startsWith(t)))
+    if (r.some((t) => n.startsWith(t)))
       return e;
   return null;
-}, ue = "timestamp", pe = "tokenUsage", Oe = "Callisto";
-class o extends Error {
-  constructor(e, n, t) {
-    super(e), this.code = n, this.originalError = t, this.name = "CryptoError";
+}, ue = "timestamp", Oe = "tokenUsage", de = "Callisto";
+class s extends Error {
+  constructor(e, r, t) {
+    super(e), this.code = r, this.originalError = t, this.name = "CryptoError";
   }
 }
-const S = {
+const I = {
   keySize: 4096,
   debug: !1
 };
-async function x(r = {}) {
-  const e = { ...S, ...r };
+async function k(n = {}) {
+  const e = { ...I, ...n };
   try {
-    const n = {
+    const r = {
       modulusLength: e.keySize,
       publicExponent: new Uint8Array([1, 0, 1]),
       // 65537
@@ -74,7 +68,7 @@ async function x(r = {}) {
     }, t = await crypto.subtle.generateKey(
       {
         name: "RSA-OAEP",
-        ...n
+        ...r
       },
       !0,
       // extractable for public key export
@@ -92,32 +86,32 @@ async function x(r = {}) {
       publicKey: t.publicKey,
       privateKey: t.privateKey
     };
-  } catch (n) {
-    throw new o(
-      `Failed to generate RSA key pair: ${n instanceof Error ? n.message : "Unknown error"}`,
+  } catch (r) {
+    throw new s(
+      `Failed to generate RSA key pair: ${r instanceof Error ? r.message : "Unknown error"}`,
       "KEY_GENERATION_FAILED",
-      n instanceof Error ? n : void 0
+      r instanceof Error ? r : void 0
     );
   }
 }
-async function H(r) {
+async function G(n) {
   try {
     return {
-      jwk: await crypto.subtle.exportKey("jwk", r),
+      jwk: await crypto.subtle.exportKey("jwk", n),
       kty: "RSA",
       alg: "RSA-OAEP-256"
     };
   } catch (e) {
-    throw new o(
+    throw new s(
       `Failed to export public key: ${e instanceof Error ? e.message : "Unknown error"}`,
       "KEY_IMPORT_FAILED",
       e instanceof Error ? e : void 0
     );
   }
 }
-async function I(r) {
+async function S(n) {
   try {
-    const e = JSON.parse(r);
+    const e = JSON.parse(n);
     return await crypto.subtle.importKey(
       "jwk",
       e,
@@ -130,166 +124,201 @@ async function I(r) {
       ["encrypt"]
     );
   } catch (e) {
-    throw new o(
+    throw new s(
       `Failed to import server public key: ${e instanceof Error ? e.message : "Unknown error"}`,
       "KEY_IMPORT_FAILED",
       e instanceof Error ? e : void 0
     );
   }
 }
-async function X(r, e, n) {
+async function F(n, e, r) {
   try {
-    const O = new TextEncoder().encode(r), y = await crypto.subtle.encrypt(
+    const A = new TextEncoder().encode(n), o = await crypto.subtle.encrypt(
       {
         name: "RSA-OAEP"
       },
       e,
-      O
+      A
     );
     return {
       data: btoa(
-        String.fromCharCode(...new Uint8Array(y))
+        String.fromCharCode(...new Uint8Array(o))
       ),
       algorithm: "RSA-OAEP",
-      keyId: n
+      keyId: r
     };
   } catch (t) {
-    throw new o(
+    throw new s(
       `Failed to encrypt message for server: ${t instanceof Error ? t.message : "Unknown error"}`,
       "ENCRYPTION_FAILED",
       t instanceof Error ? t : void 0
     );
   }
 }
-async function $(r, e) {
+async function H(n, e) {
   try {
-    const n = Uint8Array.from(
-      atob(r.data),
-      (y) => y.charCodeAt(0)
+    const r = Uint8Array.from(
+      atob(n.data),
+      (o) => o.charCodeAt(0)
     ), t = await crypto.subtle.decrypt(
       {
         name: "RSA-OAEP"
       },
       e,
-      n
+      r
     );
     return new TextDecoder().decode(t);
-  } catch (n) {
-    throw new o(
-      `Failed to decrypt message from server: ${n instanceof Error ? n.message : "Unknown error"}`,
+  } catch (r) {
+    throw new s(
+      `Failed to decrypt message from server: ${r instanceof Error ? r.message : "Unknown error"}`,
       "DECRYPTION_FAILED",
-      n instanceof Error ? n : void 0
+      r instanceof Error ? r : void 0
     );
   }
 }
-async function j(r, e, n) {
+async function V(n, e, r) {
   try {
-    const t = await I(
-      r.serverPublicKey
+    const t = await S(
+      n.serverPublicKey
     );
     return {
       clientKeyPair: e,
       serverPublicKey: t,
-      deviceId: n,
-      serverKeyId: r.keyId,
+      deviceId: r,
+      serverKeyId: n.keyId,
       establishedAt: /* @__PURE__ */ new Date()
     };
   } catch (t) {
-    throw new o(
+    throw new s(
       `Failed to establish crypto session: ${t instanceof Error ? t.message : "Unknown error"}`,
       "KEY_IMPORT_FAILED",
       t instanceof Error ? t : void 0
     );
   }
 }
-function B(r) {
-  return !(!r || !r.clientKeyPair || !r.serverPublicKey);
+function Y(n) {
+  return !(!n || !n.clientKeyPair || !n.serverPublicKey);
 }
-function z() {
-  const r = Date.now().toString(36), e = new Uint8Array(8);
+function x() {
+  const n = Date.now().toString(36), e = new Uint8Array(8);
   if (typeof window < "u" && window.crypto?.getRandomValues)
     window.crypto.getRandomValues(e);
   else
     for (let t = 0; t < e.length; t++)
       e[t] = Math.floor(Math.random() * 256);
-  const n = Array.from(e).map((t) => t.toString(36)).join("");
-  return `device_${r}_${n}`;
+  const r = Array.from(e).map((t) => t.toString(36)).join("");
+  return `device_${n}_${r}`;
 }
 function L() {
   return typeof window < "u" && typeof window.crypto < "u" && typeof window.crypto.subtle < "u";
 }
-function D() {
+function g() {
   return typeof window < "u" && (window.isSecureContext || window.location.protocol === "https:");
 }
-function W() {
-  return L() && D();
+function X() {
+  return L() && g();
 }
-function J(r) {
-  const e = new Uint8Array(r);
-  let n = "";
+function $(n) {
+  const e = new Uint8Array(n);
+  let r = "";
   for (let t = 0; t < e.byteLength; t++)
-    n += String.fromCharCode(e[t]);
-  return btoa(n);
+    r += String.fromCharCode(e[t]);
+  return btoa(r);
 }
-function q(r) {
-  const e = atob(r), n = new Uint8Array(e.length);
+function j(n) {
+  const e = atob(n), r = new Uint8Array(e.length);
   for (let t = 0; t < e.length; t++)
-    n[t] = e.charCodeAt(t);
-  return n.buffer;
+    r[t] = e.charCodeAt(t);
+  return r.buffer;
 }
-function Q(r) {
+function B(n) {
   try {
-    return JSON.stringify(r);
+    return JSON.stringify(n);
   } catch {
-    return String(r);
+    return String(n);
   }
 }
-function Z(r) {
+function z(n) {
   try {
-    return JSON.parse(r);
+    return JSON.parse(n);
   } catch {
     return null;
   }
 }
-function ee(r, ...e) {
-  typeof process < "u" && process.env && process.env.NODE_ENV === "development" && console.info(`🔐 [Crypto] ${r}`, ...e);
+function W(n, ...e) {
+  typeof process < "u" && process.env && process.env.NODE_ENV === "development" && console.info(`🔐 [Crypto] ${n}`, ...e);
+}
+const le = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({ __proto__: null, CryptoError: s, DEFAULT_CRYPTO_CONFIG: I, arrayBufferToBase64: $, base64ToArrayBuffer: j, canUseEncryption: X, debugLog: W, decryptFromServer: H, encryptForServer: F, establishCryptoSession: V, exportPublicKey: G, generateClientKeyPair: k, generateDeviceId: x, importServerPublicKey: S, isCryptoSessionValid: Y, isSecureContext: g, isWebCryptoSupported: L, safeParse: z, safeStringify: B }, Symbol.toStringTag, { value: "Module" })), J = "sassy:free", Z = "sassy:plus", Q = "sassy:advanced", q = "sassy:advanced:reasoning", pe = {
+  PLAN_FREE: J,
+  PLAN_PLUS: Z,
+  PLAN_PREMIUM: Q,
+  REASONING: q
+}, fe = {
+  TOOL: {
+    DATETIME: "getDateTime",
+    IMAGES: "getImages",
+    POLLUTION: "getAirPollution",
+    WEATHER: "getWeather",
+    URLCONTENTPARSER: "getUrlContent",
+    MEMORIES: "getUserMemories",
+    HUMANIZE: "humanize",
+    WEBSEARCH: "getWebSearch",
+    GITREPOSITORY: "getGitRepoDetails",
+    HOTELS: "getHotelDetails",
+    ATTACHMENTS: "tool:attachments"
+  }
+};
+function _e(n) {
+  return !!n && Array.isArray(n.capabilities) && n.capabilities.length >= 0;
+}
+function ee(n) {
+  return n ? new Set(n) : null;
+}
+function Re(n, e, r) {
+  if (!e || Array.isArray(e) && e.length === 0)
+    return !0;
+  const t = n instanceof Set ? n : ee(n);
+  return !t || t.size === 0 ? !1 : typeof e == "string" ? t.has(e) : r?.any === !0 ? e.some((o) => t.has(o)) : e.every((o) => t.has(o));
 }
-const _e = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({ __proto__: null, CryptoError: o, DEFAULT_CRYPTO_CONFIG: S, arrayBufferToBase64: J, base64ToArrayBuffer: q, canUseEncryption: W, debugLog: ee, decryptFromServer: $, encryptForServer: X, establishCryptoSession: j, exportPublicKey: H, generateClientKeyPair: x, generateDeviceId: z, importServerPublicKey: I, isCryptoSessionValid: B, isSecureContext: D, isWebCryptoSupported: L, safeParse: Z, safeStringify: Q }, Symbol.toStringTag, { value: "Module" }));
 export {
-  ce as ALL_MODELS,
+  ae as ALL_MODELS,
   se as ALL_PROVIDERS,
-  ae as ALL_REASONING_MODELS,
-  Oe as APPLICATION_NAME,
-  de as CALLISTO_CHAT_ID_HEADER,
+  ce as ALL_REASONING_MODELS,
+  de as APPLICATION_NAME,
+  ye as CALLISTO_CHAT_ID_HEADER,
+  fe as CAPABILITIES,
   oe as DEFAULT_PROVIDER,
   ie as MODELS_PER_PROVIDER,
-  l as MODEL_CLAUDE_HAIKU,
-  u as MODEL_CLAUDE_SONNET,
-  R as MODEL_GEMINI_FLASH,
-  p as MODEL_GEMINI_PRO,
-  A as MODEL_GPT,
-  _ as MODEL_GPT4_MINI,
-  m as MODEL_O4_MINI,
-  f as MODEL_SONAR,
+  f as MODEL_CLAUDE_HAIKU,
+  d as MODEL_CLAUDE_SONNET,
+  _ as MODEL_GEMINI_FLASH,
+  l as MODEL_GEMINI_PRO,
+  O as MODEL_GPT,
+  p as MODEL_GPT4_MINI,
+  w as MODEL_O4_MINI,
+  R as MODEL_SONAR,
   P as MODEL_SONAR_PRO,
-  k as PLAN_FREE,
-  F as PLAN_PLUS,
-  G as PLAN_PREMIUM,
-  ye as POLICY_GRANTS,
-  i as PROVIDER_ANTHROPIC,
-  E as PROVIDER_GOOGLE,
-  g as PROVIDER_MEMORY,
-  a as PROVIDER_OPENAI,
-  d as PROVIDER_PERPLEXITY,
+  J as PLAN_FREE,
+  Z as PLAN_PLUS,
+  Q as PLAN_PREMIUM,
+  pe as POLICY_GRANTS,
+  E as PROVIDER_ANTHROPIC,
+  y as PROVIDER_GOOGLE,
+  M as PROVIDER_MEMORY,
+  i as PROVIDER_OPENAI,
+  u as PROVIDER_PERPLEXITY,
   Ee as PROVIDER_ROLE_MAP,
-  M as PROVIDER_SUMMARY,
+  T as PROVIDER_SUMMARY,
   c as ROLE_ASSISTANT,
-  re as ROLE_HIDDEN,
-  ne as ROLE_INTERNAL,
-  w as ROLE_SYSTEM,
-  s as ROLE_USER,
+  ne as ROLE_HIDDEN,
+  re as ROLE_INTERNAL,
+  D as ROLE_SYSTEM,
+  a as ROLE_USER,
   ue as SORT_BY_TIMESTAMP,
-  pe as SORT_BY_TOKEN_USAGE,
-  _e as crypto,
-  Ae as findProvider
+  Oe as SORT_BY_TOKEN_USAGE,
+  le as crypto,
+  Ae as findProvider,
+  Re as isEntitled,
+  _e as isEntitlementLoaded,
+  ee as toCapabilitySet
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/sassysaint-common",
-	"version": "4.3.0",
+	"version": "4.4.0",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -19,7 +19,7 @@
 		"build:types": "tsup",
 		"build": "npm-run-all --serial clean build:check build:js build:types",
 		"clean": "rimraf dist tmp",
-		"comments:fix": "comments src/**/*.ts* --merge-line-comments",
+		"comments:fix": "comments \"src/**/*.ts*\" --merge-line-comments",
 		"dev:js": "vite build --watch --mode development",
 		"dev:types": "tsup --watch src",
 		"dev": "npm-run-all --parallel dev:js dev:types",
@@ -32,5 +32,5 @@
 		"test:watch": "vitest",
 		"watch": "npm-run-all dev"
 	},
-	"gitHead": "639ee1b0e2f051da5a348b43c6ebeec211399986"
+	"gitHead": "8e04dcba87baf260337a99820c5f7a32e5caf006"
 }