@versini/sassysaint-common 4.2.0 → 4.2.1

package/dist/index.d.ts

@@ -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;
 

package/package.json

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