@versini/sassysaint-common 4.1.0 → 4.2.1

package/dist/index.d.ts

@@ -20,7 +20,7 @@ declare const ALL_PROVIDERS: readonly ["OpenAI", "Anthropic", "Google"];
 /**
  * List of available models TODAY.
  */
-declare const MODEL_GPT4 = "gpt-4.1";
+declare const MODEL_GPT = "gpt-5";
 declare const MODEL_GPT4_MINI = "gpt-4.1-nano";
 declare const MODEL_O4_MINI = "o4-mini";
 declare const MODEL_CLAUDE_HAIKU = "claude-3-5-haiku-20241022";
@@ -32,13 +32,13 @@ declare const MODEL_SONAR_PRO = "sonar-pro";
 /**
  * List of all models available TODAY.
  */
-declare const ALL_MODELS: readonly ["gpt-4.1", "gpt-4.1-nano", "o4-mini", "claude-3-5-haiku-20241022", "claude-sonnet-4-20250514", "gemini-2.5-flash", "gemini-2.5-pro", "sonar", "sonar-pro"];
+declare const ALL_MODELS: readonly ["gpt-5", "gpt-4.1-nano", "o4-mini", "claude-3-5-haiku-20241022", "claude-sonnet-4-20250514", "gemini-2.5-flash", "gemini-2.5-pro", "sonar", "sonar-pro"];
 declare const ALL_REASONING_MODELS: string[];
 /**
  * List of models available according to the providers.
  */
 declare const MODELS_PER_PROVIDER: {
-    readonly OpenAI: readonly ["gpt-4.1-nano", "gpt-4.1", "o4-mini"];
+    readonly OpenAI: readonly ["gpt-4.1-nano", "gpt-5"];
     readonly Anthropic: readonly ["claude-3-5-haiku-20241022", "claude-sonnet-4-20250514"];
     readonly Google: readonly ["gemini-2.5-flash", "gemini-2.5-pro"];
     readonly Perplexity: readonly ["sonar", "sonar-pro"];
@@ -70,16 +70,17 @@ declare const POLICY_GRANTS: {
     REASONING: 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 +94,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 +205,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 +295,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;
 
@@ -290,4 +331,4 @@ 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_GPT4, 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 };
+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 };

package/dist/index.js

@@ -1,22 +1,22 @@
-const M = "system", s = "user", c = "assistant", te = "hidden", re = "data", a = "OpenAI", i = "Anthropic", E = "Google", g = "Summary", m = "Memory", d = "Perplexity", ne = a, oe = [
+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 = [
   a,
   i,
   E
-], _ = "gpt-4.1", l = "gpt-4.1-nano", u = "o4-mini", f = "claude-3-5-haiku-20241022", A = "claude-sonnet-4-20250514", R = "gemini-2.5-flash", p = "gemini-2.5-pro", P = "sonar", S = "sonar-pro", se = [
+], 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,
   _,
+  m,
   l,
-  u,
-  f,
   A,
-  R,
+  f,
   p,
-  P,
-  S
+  R,
+  P
 ], ce = [
   u,
   A,
   p
-], b = "claude-sonnet-4", h = "claude-3", T = "gpt-4", N = "o3", v = "o4", K = "gemini", C = "sonar", U = {
+], b = "claude-sonnet-4", h = "claude-3", T = "gpt-", N = "o3", v = "o4", K = "gemini", C = "sonar", U = {
   [i]: [
     b,
     h
@@ -29,15 +29,15 @@ const M = "system", s = "user", c = "assistant", te = "hidden", re = "data", a =
   [E]: [K],
   [d]: [C]
 }, ae = {
-  [a]: [l, _, u],
-  [i]: [f, A],
-  [E]: [R, p],
-  [d]: [P, S]
+  [a]: [_, u],
+  [i]: [l, A],
+  [E]: [f, p],
+  [d]: [R, P]
 }, ie = {
-  [a]: [M, s, c],
+  [a]: [w, s, c],
   [i]: [s, c],
+  [M]: [s, c],
   [g]: [s, c],
-  [m]: [s, c],
   [E]: [s, c],
   [d]: [s, c]
 }, k = "sassy:free", F = "sassy:plus", G = "sassy:advanced", V = "sassy:advanced:reasoning", Ee = {
@@ -58,12 +58,12 @@ class o extends Error {
     super(e), this.code = n, this.originalError = t, this.name = "CryptoError";
   }
 }
-const I = {
+const S = {
   keySize: 4096,
   debug: !1
 };
 async function Y(r = {}) {
-  const e = { ...I, ...r };
+  const e = { ...S, ...r };
   try {
     const n = {
       modulusLength: e.keySize,
@@ -114,7 +114,7 @@ async function x(r) {
     );
   }
 }
-async function L(r) {
+async function I(r) {
   try {
     const e = JSON.parse(r);
     return await crypto.subtle.importKey(
@@ -183,7 +183,7 @@ async function H(r, e) {
 }
 async function $(r, e, n) {
   try {
-    const t = await L(
+    const t = await I(
       r.serverPublicKey
     );
     return {
@@ -214,14 +214,14 @@ function B() {
   const n = Array.from(e).map((t) => t.toString(36)).join("");
   return `device_${r}_${n}`;
 }
-function D() {
+function L() {
   return typeof window < "u" && typeof window.crypto < "u" && typeof window.crypto.subtle < "u";
 }
-function w() {
+function D() {
   return typeof window < "u" && (window.isSecureContext || window.location.protocol === "https:");
 }
 function z() {
-  return D() && w();
+  return L() && D();
 }
 function J(r) {
   const e = new Uint8Array(r);
@@ -253,7 +253,7 @@ function Q(r) {
 function Z(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: I, arrayBufferToBase64: J, base64ToArrayBuffer: W, canUseEncryption: z, debugLog: Z, decryptFromServer: H, encryptForServer: X, establishCryptoSession: $, exportPublicKey: x, generateClientKeyPair: Y, generateDeviceId: B, importServerPublicKey: L, isCryptoSessionValid: j, isSecureContext: w, isWebCryptoSupported: D, safeParse: Q, safeStringify: q }, Symbol.toStringTag, { value: "Module" }));
+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" }));
 export {
   se as ALL_MODELS,
   oe as ALL_PROVIDERS,
@@ -262,30 +262,30 @@ export {
   ye as CALLISTO_CHAT_ID_HEADER,
   ne as DEFAULT_PROVIDER,
   ae as MODELS_PER_PROVIDER,
-  f as MODEL_CLAUDE_HAIKU,
+  l as MODEL_CLAUDE_HAIKU,
   A as MODEL_CLAUDE_SONNET,
-  R as MODEL_GEMINI_FLASH,
+  f as MODEL_GEMINI_FLASH,
   p as MODEL_GEMINI_PRO,
-  _ as MODEL_GPT4,
-  l as MODEL_GPT4_MINI,
-  u as MODEL_O4_MINI,
-  P as MODEL_SONAR,
-  S as MODEL_SONAR_PRO,
+  u as MODEL_GPT,
+  _ as MODEL_GPT4_MINI,
+  m 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,
   Ee as POLICY_GRANTS,
   i as PROVIDER_ANTHROPIC,
   E as PROVIDER_GOOGLE,
-  m as PROVIDER_MEMORY,
+  g as PROVIDER_MEMORY,
   a as PROVIDER_OPENAI,
   d as PROVIDER_PERPLEXITY,
   ie as PROVIDER_ROLE_MAP,
-  g as PROVIDER_SUMMARY,
+  M as PROVIDER_SUMMARY,
   c as ROLE_ASSISTANT,
   te as ROLE_HIDDEN,
   re as ROLE_INTERNAL,
-  M as ROLE_SYSTEM,
+  w as ROLE_SYSTEM,
   s as ROLE_USER,
   ue as SORT_BY_TIMESTAMP,
   Ae as SORT_BY_TOKEN_USAGE,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/sassysaint-common",
-	"version": "4.1.0",
+	"version": "4.2.1",
 	"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": "efc7567ecb058d8dd55180c28e1dc1a430d26965"
+	"gitHead": "e4097d73c3aac460481459f4b2c39d40b2f760f8"
 }