@alsania-io/utils 0.1.0

package/README.md

@@ -0,0 +1,157 @@
+# @alsania-io/utils
+
+> Shared utilities for Alsania ecosystem
+
+## Features
+
+- 📝 **Response Parsing** — Extract text from various AI response formats (OpenAI, Anthropic, etc.)
+- 🔐 **Hash Utilities** — BLAKE3, SHA3-256, SHA256, HMAC-SHA256
+- 🆔 **UUID Generation** — Random UUIDs and short IDs
+- ⏱️ **Async Utilities** — Sleep, retry with exponential backoff, timeout
+- 📦 **Object Utilities** — Deep merge, deep clone, pick, omit
+- 📝 **String Utilities** — Truncate, capitalize, camelCase, snake_case
+- 🔍 **Type Guards** — isNotNull, isString, isObject, isArray
+- 🌐 **Environment Utilities** — Type-safe env variable access
+
+## Installation
+
+```bash
+npm install @alsania-io/utils
+```
+
+## Usage
+
+### Response Parsing
+
+```typescript
+import { extractText } from '@alsania-io/utils';
+
+// OpenAI format
+const openaiResponse = {
+  choices: [{ message: { content: 'Hello!' } }]
+};
+console.log(extractText(openaiResponse)); // 'Hello!'
+
+// Anthropic format
+const anthropicResponse = {
+  content: [{ text: 'Hello!' }]
+};
+console.log(extractText(anthropicResponse)); // 'Hello!'
+
+// Direct text
+console.log(extractText('Hello!')); // 'Hello!'
+```
+
+### Hashing
+
+```typescript
+import { blake3Hash, sha3Hash, sha256Hash } from '@alsania-io/utils';
+
+const data = 'hello world';
+console.log(sha3Hash(data)); // 0x...
+console.log(sha256Hash(data)); // ...
+```
+
+### Async Utilities
+
+```typescript
+import { sleep, retry, timeout } from '@alsania-io/utils';
+
+// Sleep
+await sleep(1000); // Wait 1 second
+
+// Retry with exponential backoff
+const result = await retry(
+  async () => {
+    // Your async operation
+    return await fetchData();
+  },
+  { maxAttempts: 5, initialDelay: 100 }
+);
+
+// Timeout
+const result = await timeout(fetchData(), 5000);
+```
+
+### Object Utilities
+
+```typescript
+import { deepMerge, pick, omit } from '@alsania-io/utils';
+
+const obj1 = { a: 1, b: { c: 2 } };
+const obj2 = { b: { d: 3 }, e: 4 };
+console.log(deepMerge(obj1, obj2)); // { a: 1, b: { c: 2, d: 3 }, e: 4 }
+
+const picked = pick(obj1, ['a']); // { a: 1 }
+const omitted = omit(obj1, ['a']); // { b: { c: 2 } }
+```
+
+### String Utilities
+
+```typescript
+import { capitalize, toCamelCase, toSnakeCase, truncate } from '@alsania-io/utils';
+
+console.log(capitalize('hello')); // 'Hello'
+console.log(toCamelCase('hello-world')); // 'helloWorld'
+console.log(toSnakeCase('helloWorld')); // 'hello_world'
+console.log(truncate('hello world', 5)); // 'hello...'
+```
+
+### Environment Utilities
+
+```typescript
+import { getEnv, getEnvNumber, getEnvBoolean } from '@alsania-io/utils';
+
+const apiKey = getEnv('API_KEY', 'default-key');
+const port = getEnvNumber('PORT', 3000);
+const debug = getEnvBoolean('DEBUG', false);
+```
+
+## API Reference
+
+### Response Parsing
+- `extractText(data: any): string` — Extract text from various AI response formats
+- `safeJsonParse<T>(json: string, fallback: T): T` — Safe JSON parsing
+- `safeStringify(obj: any, indent?: number): string` — Safe JSON stringify with circular ref handling
+
+### Hash Utilities
+- `blake3Hash(data: string | Buffer): string` — BLAKE3 hash (SHA3-256 fallback)
+- `sha3Hash(data: string | Buffer): string` — SHA3-256 hash
+- `sha256Hash(data: string | Buffer): string` — SHA256 hash
+- `hmacSha256(key: string | Buffer, data: string | Buffer): string` — HMAC-SHA256
+
+### UUID
+- `uuid(): string` — Generate UUID v4
+- `shortId(length?: number): string` — Generate short ID
+
+### Async
+- `sleep(ms: number): Promise<void>` — Sleep
+- `retry<T>(fn: () => Promise<T>, options?): Promise<T>` — Retry with exponential backoff
+- `timeout<T>(promise: Promise<T>, ms: number): Promise<T>` — Timeout a promise
+
+### Object
+- `deepMerge<T>(target: T, source: Partial<T>): T` — Deep merge objects
+- `deepClone<T>(obj: T): T` — Deep clone
+- `pick<T, K>(obj: T, keys: K[]): Pick<T, K>` — Pick specific keys
+- `omit<T, K>(obj: T, keys: K[]): Omit<T, K>` — Omit specific keys
+
+### String
+- `truncate(str: string, maxLength: number, suffix?: string): string` — Truncate string
+- `capitalize(str: string): string` — Capitalize first letter
+- `toCamelCase(str: string): string` — Convert to camelCase
+- `toSnakeCase(str: string): string` — Convert to snake_case
+
+### Type Guards
+- `isNotNull<T>(value: T | null | undefined): value is T`
+- `isString(value: unknown): value is string`
+- `isObject(value: unknown): value is Record<string, any>`
+- `isArray(value: unknown): value is any[]`
+
+### Environment
+- `getEnv(key: string, defaultValue?: string): string`
+- `getEnvNumber(key: string, defaultValue?: number): number`
+- `getEnvBoolean(key: string, defaultValue?: boolean): boolean`
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @alsania-io/utils
+ * Shared utilities for Alsania ecosystem
+ *
+ * Features:
+ * - Response parsing (text/choices/output formats)
+ * - Hash utilities (BLAKE3, SHA3-256)
+ * - Configuration helpers
+ * - Type definitions
+ * - Async utilities
+ */
+/**
+ * Extract text from various AI response formats
+ * Handles: {text}, {choices[].message.content}, {output}, and raw strings
+ */
+export declare function extractText(data: any): string;
+/**
+ * Safe JSON parsing with fallback
+ */
+export declare function safeJsonParse<T>(json: string, fallback: T): T;
+/**
+ * Safe JSON stringify with circular reference handling
+ */
+export declare function safeStringify(obj: any, indent?: number): string;
+/**
+ * Compute BLAKE3 hash (using Node.js crypto with SHA3-256 as fallback)
+ * Note: Native BLAKE3 requires @noble/hashes or similar
+ */
+export declare function blake3Hash(data: string | Buffer): string;
+/**
+ * Compute SHA3-256 hash
+ */
+export declare function sha3Hash(data: string | Buffer): string;
+/**
+ * Compute SHA256 hash
+ */
+export declare function sha256Hash(data: string | Buffer): string;
+/**
+ * HMAC-SHA256
+ */
+export declare function hmacSha256(key: string | Buffer, data: string | Buffer): string;
+/**
+ * Generate a random UUID v4
+ */
+export declare function uuid(): string;
+/**
+ * Generate a short ID (8 characters)
+ */
+export declare function shortId(length?: number): string;
+/**
+ * Sleep for a given number of milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry an async function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoff?: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+/**
+ * Timeout a promise
+ */
+export declare function timeout<T>(promise: Promise<T>, ms: number): Promise<T>;
+/**
+ * Deep merge objects
+ */
+export declare function deepMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T;
+/**
+ * Deep clone an object
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Pick specific keys from an object
+ */
+export declare function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Omit specific keys from an object
+ */
+export declare function omit<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * Truncate a string to a maximum length with ellipsis
+ */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * Capitalize the first letter of a string
+ */
+export declare function capitalize(str: string): string;
+/**
+ * Convert a string to camelCase
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * Convert a string to snake_case
+ */
+export declare function toSnakeCase(str: string): string;
+/**
+ * Type guard for non-null values
+ */
+export declare function isNotNull<T>(value: T | null | undefined): value is T;
+/**
+ * Type guard for strings
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Type guard for objects
+ */
+export declare function isObject(value: unknown): value is Record<string, any>;
+/**
+ * Type guard for arrays
+ */
+export declare function isArray(value: unknown): value is any[];
+/**
+ * Get an environment variable with a default value
+ */
+export declare function getEnv(key: string, defaultValue?: string): string;
+/**
+ * Get an environment variable as a number
+ */
+export declare function getEnvNumber(key: string, defaultValue?: number): number;
+/**
+ * Get an environment variable as a boolean
+ */
+export declare function getEnvBoolean(key: string, defaultValue?: boolean): boolean;
+declare const _default: {
+    extractText: typeof extractText;
+    safeJsonParse: typeof safeJsonParse;
+    safeStringify: typeof safeStringify;
+    blake3Hash: typeof blake3Hash;
+    sha3Hash: typeof sha3Hash;
+    sha256Hash: typeof sha256Hash;
+    hmacSha256: typeof hmacSha256;
+    uuid: typeof uuid;
+    shortId: typeof shortId;
+    sleep: typeof sleep;
+    retry: typeof retry;
+    timeout: typeof timeout;
+    deepMerge: typeof deepMerge;
+    deepClone: typeof deepClone;
+    pick: typeof pick;
+    omit: typeof omit;
+    truncate: typeof truncate;
+    capitalize: typeof capitalize;
+    toCamelCase: typeof toCamelCase;
+    toSnakeCase: typeof toSnakeCase;
+    isNotNull: typeof isNotNull;
+    isString: typeof isString;
+    isObject: typeof isObject;
+    isArray: typeof isArray;
+    getEnv: typeof getEnv;
+    getEnvNumber: typeof getEnvNumber;
+    getEnvBoolean: typeof getEnvBoolean;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,433 @@
+"use strict";
+/**
+ * @alsania-io/utils
+ * Shared utilities for Alsania ecosystem
+ *
+ * Features:
+ * - Response parsing (text/choices/output formats)
+ * - Hash utilities (BLAKE3, SHA3-256)
+ * - Configuration helpers
+ * - Type definitions
+ * - Async utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractText = extractText;
+exports.safeJsonParse = safeJsonParse;
+exports.safeStringify = safeStringify;
+exports.blake3Hash = blake3Hash;
+exports.sha3Hash = sha3Hash;
+exports.sha256Hash = sha256Hash;
+exports.hmacSha256 = hmacSha256;
+exports.uuid = uuid;
+exports.shortId = shortId;
+exports.sleep = sleep;
+exports.retry = retry;
+exports.timeout = timeout;
+exports.deepMerge = deepMerge;
+exports.deepClone = deepClone;
+exports.pick = pick;
+exports.omit = omit;
+exports.truncate = truncate;
+exports.capitalize = capitalize;
+exports.toCamelCase = toCamelCase;
+exports.toSnakeCase = toSnakeCase;
+exports.isNotNull = isNotNull;
+exports.isString = isString;
+exports.isObject = isObject;
+exports.isArray = isArray;
+exports.getEnv = getEnv;
+exports.getEnvNumber = getEnvNumber;
+exports.getEnvBoolean = getEnvBoolean;
+// ============================================
+// Response Parsing
+// ============================================
+/**
+ * Extract text from various AI response formats
+ * Handles: {text}, {choices[].message.content}, {output}, and raw strings
+ */
+function extractText(data) {
+    try {
+        if (typeof data === 'string')
+            return data;
+        if (typeof data !== 'object' || data === null)
+            return String(data);
+        // Direct text field
+        if (typeof data.text === 'string')
+            return data.text;
+        // OpenAI/Anthropic style: choices[].message.content
+        if (Array.isArray(data.choices) && data.choices.length > 0) {
+            const choice = data.choices[0];
+            if (choice && typeof choice === 'object') {
+                const message = choice.message;
+                if (message && typeof message === 'object') {
+                    if (typeof message.content === 'string')
+                        return message.content;
+                    if (typeof message.text === 'string')
+                        return message.text;
+                }
+                if (typeof choice.text === 'string')
+                    return choice.text;
+                if (typeof choice.content === 'string')
+                    return choice.content;
+            }
+        }
+        // Output field
+        if (typeof data.output === 'string')
+            return data.output;
+        // Fallback: JSON stringify
+        return JSON.stringify(data, null, 2);
+    }
+    catch (e) {
+        return String(data);
+    }
+}
+/**
+ * Safe JSON parsing with fallback
+ */
+function safeJsonParse(json, fallback) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Safe JSON stringify with circular reference handling
+ */
+function safeStringify(obj, indent) {
+    try {
+        return JSON.stringify(obj, null, indent);
+    }
+    catch {
+        // Handle circular references
+        const seen = new WeakSet();
+        const replacer = (key, value) => {
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value))
+                    return '[Circular]';
+                seen.add(value);
+            }
+            return value;
+        };
+        return JSON.stringify(obj, replacer, indent);
+    }
+}
+// ============================================
+// Hash Utilities
+// ============================================
+const crypto_1 = require("crypto");
+/**
+ * Compute BLAKE3 hash (using Node.js crypto with SHA3-256 as fallback)
+ * Note: Native BLAKE3 requires @noble/hashes or similar
+ */
+function blake3Hash(data) {
+    // Use SHA3-256 as a close alternative to BLAKE3
+    const hash = (0, crypto_1.createHash)('sha3-256');
+    if (typeof data === 'string') {
+        hash.update(data, 'utf-8');
+    }
+    else {
+        hash.update(data);
+    }
+    return '0x' + hash.digest('hex');
+}
+/**
+ * Compute SHA3-256 hash
+ */
+function sha3Hash(data) {
+    const hash = (0, crypto_1.createHash)('sha3-256');
+    if (typeof data === 'string') {
+        hash.update(data, 'utf-8');
+    }
+    else {
+        hash.update(data);
+    }
+    return '0x' + hash.digest('hex');
+}
+/**
+ * Compute SHA256 hash
+ */
+function sha256Hash(data) {
+    const hash = (0, crypto_1.createHash)('sha256');
+    if (typeof data === 'string') {
+        hash.update(data, 'utf-8');
+    }
+    else {
+        hash.update(data);
+    }
+    return hash.digest('hex');
+}
+/**
+ * HMAC-SHA256
+ */
+function hmacSha256(key, data) {
+    const hmac = (0, crypto_1.createHmac)('sha256', key);
+    if (typeof data === 'string') {
+        hmac.update(data, 'utf-8');
+    }
+    else {
+        hmac.update(data);
+    }
+    return hmac.digest('hex');
+}
+// ============================================
+// UUID Utilities
+// ============================================
+/**
+ * Generate a random UUID v4
+ */
+function uuid() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = Math.random() * 16 | 0;
+        const v = c === 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+/**
+ * Generate a short ID (8 characters)
+ */
+function shortId(length = 8) {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+// ============================================
+// Async Utilities
+// ============================================
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry an async function with exponential backoff
+ */
+async function retry(fn, options = {}) {
+    const { maxAttempts = 5, initialDelay = 100, maxDelay = 10000, backoff = 2, onRetry = () => { }, } = options;
+    let lastError;
+    let delay = initialDelay;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < maxAttempts - 1) {
+                onRetry(attempt + 1, lastError);
+                await sleep(delay);
+                delay = Math.min(delay * backoff, maxDelay);
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Timeout a promise
+ */
+function timeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`Timeout after ${ms}ms`));
+        }, ms);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+// ============================================
+// Object Utilities
+// ============================================
+/**
+ * Deep merge objects
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        const val = source[key];
+        if (val && typeof val === 'object' && !Array.isArray(val) && result[key]) {
+            result[key] = deepMerge(result[key], val);
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}
+/**
+ * Deep clone an object
+ */
+function deepClone(obj) {
+    if (obj === null || typeof obj !== 'object')
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(deepClone);
+    const result = {};
+    for (const key in obj) {
+        result[key] = deepClone(obj[key]);
+    }
+    return result;
+}
+/**
+ * Pick specific keys from an object
+ */
+function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (key in obj) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+/**
+ * Omit specific keys from an object
+ */
+function omit(obj, keys) {
+    const result = { ...obj };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+}
+// ============================================
+// String Utilities
+// ============================================
+/**
+ * Truncate a string to a maximum length with ellipsis
+ */
+function truncate(str, maxLength, suffix = '...') {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - suffix.length) + suffix;
+}
+/**
+ * Capitalize the first letter of a string
+ */
+function capitalize(str) {
+    if (!str)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Convert a string to camelCase
+ */
+function toCamelCase(str) {
+    return str.replace(/[-_]([a-z])/g, (_, char) => char.toUpperCase());
+}
+/**
+ * Convert a string to snake_case
+ */
+function toSnakeCase(str) {
+    return str.replace(/[A-Z]/g, (char) => '_' + char.toLowerCase()).replace(/^_/, '');
+}
+// ============================================
+// Type Utilities
+// ============================================
+/**
+ * Type guard for non-null values
+ */
+function isNotNull(value) {
+    return value !== null && value !== undefined;
+}
+/**
+ * Type guard for strings
+ */
+function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Type guard for objects
+ */
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Type guard for arrays
+ */
+function isArray(value) {
+    return Array.isArray(value);
+}
+// ============================================
+// Environment Utilities
+// ============================================
+/**
+ * Get an environment variable with a default value
+ */
+function getEnv(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined) {
+        if (defaultValue === undefined) {
+            throw new Error(`Environment variable ${key} is not set`);
+        }
+        return defaultValue;
+    }
+    return value;
+}
+/**
+ * Get an environment variable as a number
+ */
+function getEnvNumber(key, defaultValue) {
+    const value = getEnv(key, defaultValue?.toString());
+    const num = Number(value);
+    if (isNaN(num)) {
+        throw new Error(`Environment variable ${key} is not a number: ${value}`);
+    }
+    return num;
+}
+/**
+ * Get an environment variable as a boolean
+ */
+function getEnvBoolean(key, defaultValue) {
+    const value = getEnv(key, defaultValue?.toString());
+    return value.toLowerCase() === 'true' || value === '1';
+}
+// ============================================
+// Export all
+// ============================================
+exports.default = {
+    // Response parsing
+    extractText,
+    safeJsonParse,
+    safeStringify,
+    // Hash
+    blake3Hash,
+    sha3Hash,
+    sha256Hash,
+    hmacSha256,
+    // UUID
+    uuid,
+    shortId,
+    // Async
+    sleep,
+    retry,
+    timeout,
+    // Object
+    deepMerge,
+    deepClone,
+    pick,
+    omit,
+    // String
+    truncate,
+    capitalize,
+    toCamelCase,
+    toSnakeCase,
+    // Type
+    isNotNull,
+    isString,
+    isObject,
+    isArray,
+    // Env
+    getEnv,
+    getEnvNumber,
+    getEnvBoolean,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@alsania-io/utils",
+  "version": "0.1.0",
+  "description": "Shared utilities for Alsania ecosystem",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "utils",
+    "alsania",
+    "shared",
+    "utilities",
+    "hash",
+    "parse"
+  ],
+  "author": "Alsania I/O <admin@alsania-io.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alsania-dev/alsania-io-utils.git"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}