@versini/sassysaint-common 4.2.0 → 4.3.0

package/dist/index.d.ts

@@ -68,18 +68,20 @@ declare const POLICY_GRANTS: {
     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.
+ * Header string for Callisto Chat Id. Used to identify the chat in the server
+ * when there is a client abort.
  */
 declare const CALLISTO_CHAT_ID_HEADER = "x-callisto-chat-id";
 /**
- * This function finds the provider associated with a given model name.
- * It checks the model name against a list of approximate models for each provider.
+ * This function finds the provider associated with a given model name. It
+ * checks the model name against a list of approximate models for each provider.
  *
  * @param modelName - The model name to check.
  * @returns The provider associated with the model name or null if not found.
+ *
  */
 declare const findProvider: (modelName: string) => null | typeof PROVIDER_ANTHROPIC | typeof PROVIDER_OPENAI | typeof PROVIDER_GOOGLE;
 /**
@@ -93,76 +95,110 @@ declare const SORT_BY_TOKEN_USAGE = "tokenUsage";
 declare const APPLICATION_NAME = "Callisto";
 
 /**
- * TypeScript interfaces for Server-Mediated Encryption
+ * TypeScript interfaces for Server-Mediated Encryption.
  */
 /**
- * RSA key pair stored in memory for the current session
+ * RSA key pair stored in memory for the current session.
  */
 interface ClientCryptoKeyPair {
     publicKey: CryptoKey;
     privateKey: CryptoKey;
 }
 /**
- * Serializable format for public key exchange with server
+ * Serializable format for public key exchange with server.
  */
 interface SerializablePublicKey {
-    /** Public key in JSON Web Key format */
+    /**
+     * Public key in JSON Web Key format.
+     */
     jwk: JsonWebKey;
-    /** Key type identifier */
+    /**
+     * Key type identifier.
+     */
     kty: "RSA";
-    /** Algorithm identifier */
+    /**
+     * Algorithm identifier.
+     */
     alg: "RSA-OAEP-256";
 }
 /**
- * Response from server's key exchange mutation
+ * Response from server's key exchange mutation.
  */
 interface KeyExchangeResponse {
-    /** Server's public key in JWK format */
+    /**
+     * Server's public key in JWK format.
+     */
     serverPublicKey: string;
-    /** Server's key identifier for rotation tracking */
+    /**
+     * Server's key identifier for rotation tracking.
+     */
     keyId: string;
-    /** List of supported encryption algorithms */
+    /**
+     * List of supported encryption algorithms.
+     */
     supportedAlgorithms: string[];
 }
 /**
- * Client crypto session state stored in memory
+ * Client crypto session state stored in memory.
  */
 interface CryptoSession {
-    /** Client's RSA key pair */
+    /**
+     * Client's RSA key pair.
+     */
     clientKeyPair: ClientCryptoKeyPair;
-    /** Server's public key for encryption */
+    /**
+     * Server's public key for encryption.
+     */
     serverPublicKey: CryptoKey;
-    /** Unique device/session identifier */
+    /**
+     * Unique device/session identifier.
+     */
     deviceId: string;
-    /** Server's key identifier */
+    /**
+     * Server's key identifier.
+     */
     serverKeyId: string;
-    /** When this session was established */
+    /**
+     * When this session was established.
+     */
     establishedAt: Date;
 }
 /**
- * Encrypted message format for transport
+ * Encrypted message format for transport.
  */
 interface EncryptedMessage {
-    /** Base64-encoded encrypted data */
+    /**
+     * Base64-encoded encrypted data.
+     */
     data: string;
-    /** Algorithm used for encryption */
+    /**
+     * Algorithm used for encryption.
+     */
     algorithm: "RSA-OAEP";
-    /** Key ID used for encryption */
+    /**
+     * Key ID used for encryption.
+     */
     keyId: string;
 }
 /**
- * Parameters for RSA key generation
+ * Parameters for RSA key generation.
  */
 interface RSAKeyGenParams {
-    /** RSA modulus length in bits */
+    /**
+     * RSA modulus length in bits.
+     */
     modulusLength: 2048 | 4096;
-    /** Public exponent */
+    /**
+     * Public exponent.
+     */
     publicExponent: Uint8Array;
-    /** Hash algorithm for OAEP */
+    /**
+     * Hash algorithm for OAEP.
+     */
     hash: "SHA-256";
 }
 /**
- * Error types for crypto operations
+ * Error types for crypto operations.
  */
 declare class CryptoError extends Error {
     readonly code: "KEY_GENERATION_FAILED" | "ENCRYPTION_FAILED" | "DECRYPTION_FAILED" | "KEY_IMPORT_FAILED" | "INVALID_KEY_FORMAT";
@@ -170,85 +206,89 @@ declare class CryptoError extends Error {
     constructor(message: string, code: "KEY_GENERATION_FAILED" | "ENCRYPTION_FAILED" | "DECRYPTION_FAILED" | "KEY_IMPORT_FAILED" | "INVALID_KEY_FORMAT", originalError?: Error | undefined);
 }
 /**
- * Configuration options for crypto operations
+ * Configuration options for crypto operations.
  */
 interface CryptoConfig {
-    /** RSA key size in bits */
+    /**
+     * RSA key size in bits.
+     */
     keySize: 2048 | 4096;
-    /** Enable debug logging */
+    /**
+     * Enable debug logging.
+     */
     debug: boolean;
 }
 /**
- * Default crypto configuration
+ * Default crypto configuration.
  */
 declare const DEFAULT_CRYPTO_CONFIG: CryptoConfig;
 
 /**
- * Generate a new RSA key pair for the current session
+ * Generate a new RSA key pair for the current session.
  */
 declare function generateClientKeyPair(config?: Partial<CryptoConfig>): Promise<ClientCryptoKeyPair>;
 /**
- * Export public key to serializable format for server exchange
+ * Export public key to serializable format for server exchange.
  */
 declare function exportPublicKey(publicKey: CryptoKey): Promise<SerializablePublicKey>;
 /**
- * Import server's public key from JWK format
+ * Import server's public key from JWK format.
  */
 declare function importServerPublicKey(serverPublicKeyJWK: string): Promise<CryptoKey>;
 /**
- * Encrypt message for transmission to server
+ * Encrypt message for transmission to server.
  */
 declare function encryptForServer(message: string, serverPublicKey: CryptoKey, serverKeyId: string): Promise<EncryptedMessage>;
 /**
- * Decrypt message received from server
+ * Decrypt message received from server.
  */
 declare function decryptFromServer(encryptedMessage: EncryptedMessage, clientPrivateKey: CryptoKey): Promise<string>;
 /**
- * Create a complete crypto session with key exchange
+ * Create a complete crypto session with key exchange.
  */
 declare function establishCryptoSession(keyExchangeResponse: KeyExchangeResponse, clientKeyPair: ClientCryptoKeyPair, deviceId: string): Promise<CryptoSession>;
 /**
- * Validate that a crypto session is still valid
+ * Validate that a crypto session is still valid.
  */
 declare function isCryptoSessionValid(session: CryptoSession): boolean;
 
 /**
- * Utility functions for crypto operations
+ * Utility functions for crypto operations.
  */
 /**
- * Generate a unique device ID for this session
+ * Generate a unique device ID for this session.
  */
 declare function generateDeviceId(): string;
 /**
- * Check if the current environment supports Web Crypto API
+ * Check if the current environment supports Web Crypto API.
  */
 declare function isWebCryptoSupported(): boolean;
 /**
- * Validate that we're in a secure context (required for Web Crypto API)
+ * Validate that we're in a secure context (required for Web Crypto API).
  */
 declare function isSecureContext(): boolean;
 /**
- * Check if encryption is available in the current environment
+ * Check if encryption is available in the current environment.
  */
 declare function canUseEncryption(): boolean;
 /**
- * Convert ArrayBuffer to base64 string
+ * Convert ArrayBuffer to base64 string.
  */
 declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
 /**
- * Convert base64 string to ArrayBuffer
+ * Convert base64 string to ArrayBuffer.
  */
 declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
 /**
- * Safely stringify JSON with error handling
+ * Safely stringify JSON with error handling.
  */
 declare function safeStringify(obj: unknown): string;
 /**
- * Safely parse JSON with error handling
+ * Safely parse JSON with error handling.
  */
 declare function safeParse<T = unknown>(json: string): T | null;
 /**
- * Debug logger for crypto operations (only in development)
+ * Debug logger for crypto operations (only in development).
  *
  * ⚠️ SECURITY WARNING: Never log sensitive data such as:
  * - Private or public key objects
@@ -256,7 +296,9 @@ declare function safeParse<T = unknown>(json: string): T | null;
  * - Raw cryptographic material
  * - Device IDs or session identifiers
  *
- * Only log non-sensitive metadata like algorithms, key sizes, operation status, etc.
+ * Only log non-sensitive metadata like algorithms, key sizes, operation status,
+ * etc.
+ *
  */
 declare function debugLog(message: string, ...args: unknown[]): void;
 

package/dist/index.js

@@ -1,22 +1,22 @@
-const w = "system", s = "user", c = "assistant", te = "hidden", re = "data", a = "OpenAI", i = "Anthropic", E = "Google", M = "Summary", g = "Memory", d = "Perplexity", ne = a, oe = [
+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,
   i,
   E
-], u = "gpt-5", _ = "gpt-4.1-nano", m = "o4-mini", l = "claude-3-5-haiku-20241022", A = "claude-sonnet-4-20250514", f = "gemini-2.5-flash", p = "gemini-2.5-pro", R = "sonar", P = "sonar-pro", se = [
-  u,
+], 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,
   _,
   m,
   l,
-  A,
-  f,
-  p,
+  u,
   R,
+  p,
+  f,
   P
-], ce = [
-  u,
+], ae = [
   A,
+  u,
   p
-], b = "claude-sonnet-4", h = "claude-3", T = "gpt-", N = "o3", v = "o4", K = "gemini", C = "sonar", U = {
+], b = "claude-sonnet-4", h = "claude-3", T = "gpt-", N = "o3", v = "o4", C = "gemini", K = "sonar", U = {
   [i]: [
     b,
     h
@@ -26,33 +26,34 @@ const w = "system", s = "user", c = "assistant", te = "hidden", re = "data", a =
     N,
     v
   ],
-  [E]: [K],
-  [d]: [C]
-}, ae = {
-  [a]: [_, u],
-  [i]: [l, A],
-  [E]: [f, p],
-  [d]: [R, P]
+  [E]: [C],
+  [d]: [K]
 }, ie = {
+  [a]: [_, A],
+  [i]: [l, u],
+  [E]: [R, p],
+  [d]: [f, 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", Ee = {
+}, 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
-}, ye = "x-callisto-chat-id", de = (r) => {
+  REASONING: V,
+  WEBSEARCH: Y
+}, de = "x-callisto-chat-id", Ae = (r) => {
   for (const [e, n] of Object.entries(
     U
   ))
     if (n.some((t) => r.startsWith(t)))
       return e;
   return null;
-}, ue = "timestamp", Ae = "tokenUsage", pe = "Callisto";
+}, 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";
@@ -62,7 +63,7 @@ const S = {
   keySize: 4096,
   debug: !1
 };
-async function Y(r = {}) {
+async function x(r = {}) {
   const e = { ...S, ...r };
   try {
     const n = {
@@ -99,7 +100,7 @@ async function Y(r = {}) {
     );
   }
 }
-async function x(r) {
+async function H(r) {
   try {
     return {
       jwk: await crypto.subtle.exportKey("jwk", r),
@@ -160,7 +161,7 @@ async function X(r, e, n) {
     );
   }
 }
-async function H(r, e) {
+async function $(r, e) {
   try {
     const n = Uint8Array.from(
       atob(r.data),
@@ -181,7 +182,7 @@ async function H(r, e) {
     );
   }
 }
-async function $(r, e, n) {
+async function j(r, e, n) {
   try {
     const t = await I(
       r.serverPublicKey
@@ -201,10 +202,10 @@ async function $(r, e, n) {
     );
   }
 }
-function j(r) {
+function B(r) {
   return !(!r || !r.clientKeyPair || !r.serverPublicKey);
 }
-function B() {
+function z() {
   const r = Date.now().toString(36), e = new Uint8Array(8);
   if (typeof window < "u" && window.crypto?.getRandomValues)
     window.crypto.getRandomValues(e);
@@ -220,7 +221,7 @@ function L() {
 function D() {
   return typeof window < "u" && (window.isSecureContext || window.location.protocol === "https:");
 }
-function z() {
+function W() {
   return L() && D();
 }
 function J(r) {
@@ -230,65 +231,65 @@ function J(r) {
     n += String.fromCharCode(e[t]);
   return btoa(n);
 }
-function W(r) {
+function q(r) {
   const e = atob(r), n = new Uint8Array(e.length);
   for (let t = 0; t < e.length; t++)
     n[t] = e.charCodeAt(t);
   return n.buffer;
 }
-function q(r) {
+function Q(r) {
   try {
     return JSON.stringify(r);
   } catch {
     return String(r);
   }
 }
-function Q(r) {
+function Z(r) {
   try {
     return JSON.parse(r);
   } catch {
     return null;
   }
 }
-function Z(r, ...e) {
+function ee(r, ...e) {
   typeof process < "u" && process.env && process.env.NODE_ENV === "development" && console.info(`🔐 [Crypto] ${r}`, ...e);
 }
-const Oe = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({ __proto__: null, CryptoError: o, DEFAULT_CRYPTO_CONFIG: S, arrayBufferToBase64: J, base64ToArrayBuffer: W, canUseEncryption: z, debugLog: Z, decryptFromServer: H, encryptForServer: X, establishCryptoSession: $, exportPublicKey: x, generateClientKeyPair: Y, generateDeviceId: B, importServerPublicKey: I, isCryptoSessionValid: j, isSecureContext: D, isWebCryptoSupported: L, safeParse: Q, safeStringify: q }, Symbol.toStringTag, { value: "Module" }));
+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 {
-  se as ALL_MODELS,
-  oe as ALL_PROVIDERS,
-  ce as ALL_REASONING_MODELS,
-  pe as APPLICATION_NAME,
-  ye as CALLISTO_CHAT_ID_HEADER,
-  ne as DEFAULT_PROVIDER,
-  ae as MODELS_PER_PROVIDER,
+  ce as ALL_MODELS,
+  se as ALL_PROVIDERS,
+  ae as ALL_REASONING_MODELS,
+  Oe as APPLICATION_NAME,
+  de as CALLISTO_CHAT_ID_HEADER,
+  oe as DEFAULT_PROVIDER,
+  ie as MODELS_PER_PROVIDER,
   l as MODEL_CLAUDE_HAIKU,
-  A as MODEL_CLAUDE_SONNET,
-  f as MODEL_GEMINI_FLASH,
+  u as MODEL_CLAUDE_SONNET,
+  R as MODEL_GEMINI_FLASH,
   p as MODEL_GEMINI_PRO,
-  u as MODEL_GPT,
+  A as MODEL_GPT,
   _ as MODEL_GPT4_MINI,
   m as MODEL_O4_MINI,
-  R as MODEL_SONAR,
+  f as MODEL_SONAR,
   P as MODEL_SONAR_PRO,
   k as PLAN_FREE,
   F as PLAN_PLUS,
   G as PLAN_PREMIUM,
-  Ee as POLICY_GRANTS,
+  ye as POLICY_GRANTS,
   i as PROVIDER_ANTHROPIC,
   E as PROVIDER_GOOGLE,
   g as PROVIDER_MEMORY,
   a as PROVIDER_OPENAI,
   d as PROVIDER_PERPLEXITY,
-  ie as PROVIDER_ROLE_MAP,
+  Ee as PROVIDER_ROLE_MAP,
   M as PROVIDER_SUMMARY,
   c as ROLE_ASSISTANT,
-  te as ROLE_HIDDEN,
-  re as ROLE_INTERNAL,
+  re as ROLE_HIDDEN,
+  ne as ROLE_INTERNAL,
   w as ROLE_SYSTEM,
   s as ROLE_USER,
   ue as SORT_BY_TIMESTAMP,
-  Ae as SORT_BY_TOKEN_USAGE,
-  Oe as crypto,
-  de as findProvider
+  pe as SORT_BY_TOKEN_USAGE,
+  _e as crypto,
+  Ae as findProvider
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/sassysaint-common",
-	"version": "4.2.0",
+	"version": "4.3.0",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -19,9 +19,11 @@
 		"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",
 		"dev:js": "vite build --watch --mode development",
 		"dev:types": "tsup --watch src",
 		"dev": "npm-run-all --parallel dev:js dev:types",
+		"fix": "npm-run-all lint:fix comments:fix",
 		"lint": "biome lint src",
 		"lint:fix": "biome check src --write --no-errors-on-unmatched",
 		"test": "vitest run",
@@ -30,5 +32,5 @@
 		"test:watch": "vitest",
 		"watch": "npm-run-all dev"
 	},
-	"gitHead": "e846a9619cd9510aa7a7d8bf0395b2f8a4b29d4c"
+	"gitHead": "639ee1b0e2f051da5a348b43c6ebeec211399986"
 }