@nekutima/biome-sdk 0.1.18

package/README.md

@@ -0,0 +1,100 @@
+# Biome SDK
+
+Pure TypeScript SDK for Biome platform integration - authentication, task management, and blockchain interactions.
+
+## Purpose
+
+The Biome SDK is the **official contract** between frontend and backend teams, providing pure business logic, data models, and API communication without any UI concerns.
+
+## Features
+
+- 🔄 **Authentication** - Login, logout, session management
+- 📋 **Task Management** - CRUD operations, state transitions, search
+- 👤 **Profile Management** - User profiles, updates, validation
+- 📁 **File Upload** - Image validation, upload, management
+- 🔧 **Utilities** - Sorting, validation, date manipulation
+- 📊 **Type Safety** - Complete TypeScript definitions
+
+## Installation
+
+### As Git Submodule (Current Biome Project)
+```bash
+# The SDK is included as a git submodule in the main Biome project
+cd biome
+git submodule update --init --recursive
+npm install  # Creates symlink for @biome/sdk
+npm run build:sdk
+npm run dev:sdk  # Watch mode for development
+```
+
+### As NPM Package (Future External Use)
+```bash
+npm install @biome/sdk
+```
+
+## Quick Start
+
+```typescript
+import { BiomeSDK } from 'biome-sdk';
+
+const biome = new BiomeSDK({
+  apiBaseUrl: 'https://api.biome.dev',
+  timeout: 30000
+});
+
+// Authentication
+await biome.auth.login({ emailOrUsername: 'user@example.com', password: 'password' });
+
+// Task Management
+const tasks = await biome.tasks.getMyTasks();
+const newTask = await biome.tasks.create({
+  title: 'New Task',
+  description: 'Task description',
+  assigneeId: 1
+});
+
+// Profile Management
+const profile = await biome.profiles.getMyProfile();
+await biome.profiles.updateProfile({ bio: 'Updated bio' });
+```
+
+## Architecture
+
+```
+Frontend (Angular/React/Vue)
+    ↓ calls
+BiomeSDK (Pure TypeScript)
+    ↓ HTTP
+Backend API (Node.js/Express)
+```
+
+## Scope
+
+### ✅ INCLUDED
+- Data models & interfaces
+- Business logic & validation
+- API communication
+- Pure algorithms
+- Error handling
+
+### ❌ EXCLUDED
+- UI components
+- Framework dependencies
+- Visual state management
+- DOM manipulation
+
+## Documentation
+
+- [CONTRACT.md](./CONTRACT.md) - SDK contract and scope
+- [FRONTEND_INTEGRATION.md](./FRONTEND_INTEGRATION.md) - Frontend integration guide
+- [BACKEND_INTEGRATION.md](./BACKEND_INTEGRATION.md) - Backend integration guide
+
+## Version
+
+Current: **0.1.18**
+- Private package for internal use
+- Future npm publication planned
+
+## Support
+
+For SDK issues, integration help, or questions about scope and usage, see [CONTRACT.md](./CONTRACT.md) contact guidelines.

package/dist/auth/auth.service.d.ts

@@ -0,0 +1,90 @@
+import { BiomeHttpClient } from '../core/http-client';
+import { ApiResponse } from '../models/api-response.model';
+/**
+ * Authentication service - pure business logic without UI concerns
+ */
+export declare class BiomeAuth {
+    private http;
+    private readonly operatorId;
+    private readonly sessionExpiresAt;
+    constructor(http: BiomeHttpClient);
+    /**
+     * Get current operator ID
+     */
+    get currentOperatorId(): number | null;
+    /**
+     * Subscribe to operator ID changes
+     */
+    onOperatorIdChange(callback: (operatorId: number | null) => void): () => void;
+    /**
+     * Register a new user
+     */
+    signup(data: SignupData): Promise<ApiResponse<void>>;
+    /**
+     * Log in a user
+     */
+    login(data: LoginData): Promise<LoginResponse>;
+    /**
+     * Log out current user
+     */
+    logout(): Promise<ApiResponse<void>>;
+    /**
+     * Check if current session is valid
+     */
+    isSessionValid(): boolean;
+    /**
+     * Validate session with server
+     */
+    validateSessionWithServer(): Promise<boolean>;
+    /**
+     * Get current session data
+     */
+    getSessionData(): SessionData;
+    /**
+     * Validate and restore a stored session
+     */
+    validateStoredSession(sessionData: SessionData): boolean;
+    /**
+     * Confirm email with token
+     */
+    confirmEmail(token: string): Promise<void>;
+    /**
+     * Resend confirmation email
+     */
+    resendConfirmation(email: string): Promise<void>;
+    /**
+     * Clear current session
+     */
+    clearSession(): void;
+}
+/**
+ * Session data structure
+ */
+export interface SessionData {
+    operatorId: number;
+    expiresAt: string;
+}
+/**
+ * Data required for user signup
+ */
+export interface SignupData {
+    timezoneId: number;
+    email: string;
+    password: string;
+}
+/**
+ * Data required for user login (Story 2: Flexible Login)
+ */
+export interface LoginData {
+    emailOrUsername: string;
+    password: string;
+    rememberMe?: boolean;
+}
+/**
+ * Response from successful login
+ */
+export interface LoginResponse {
+    ttl: number;
+    operatorId: number;
+}
+//# sourceMappingURL=auth.service.d.ts.map

package/dist/auth/auth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../src/auth/auth.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D;;GAEG;AACH,qBAAa,SAAS;IAIN,OAAO,CAAC,IAAI;IAHxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwC;gBAErD,IAAI,EAAE,eAAe;IAEzC;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAErC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAI7E;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAQ1D;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBpD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAY1C;;OAEG;IACH,cAAc,IAAI,OAAO;IASzB;;OAEG;IACG,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBnD;;OAEG;IACH,cAAc,IAAI,WAAW;IAc7B;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAgBxD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;IACH,YAAY,IAAI,IAAI;CAIvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/auth/auth.service.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiomeAuth = void 0;
+const luxon_1 = require("luxon");
+const state_manager_1 = require("../core/state-manager");
+const error_handler_1 = require("../core/error-handler");
+/**
+ * Authentication service - pure business logic without UI concerns
+ */
+class BiomeAuth {
+    constructor(http) {
+        this.http = http;
+        this.operatorId = new state_manager_1.StatefulValue(null);
+        this.sessionExpiresAt = new state_manager_1.StatefulValue(null);
+    }
+    /**
+     * Get current operator ID
+     */
+    get currentOperatorId() {
+        return this.operatorId.value;
+    }
+    /**
+     * Subscribe to operator ID changes
+     */
+    onOperatorIdChange(callback) {
+        return this.operatorId.subscribe(callback);
+    }
+    /**
+     * Register a new user
+     */
+    async signup(data) {
+        try {
+            return await this.http.post('/signup', data);
+        }
+        catch (error) {
+            throw (0, error_handler_1.createSdkError)(error, 'User registration failed');
+        }
+    }
+    /**
+     * Log in a user
+     */
+    async login(data) {
+        try {
+            const response = await this.http.post('/login', data);
+            const payload = response.payload;
+            // Update session state
+            this.operatorId.value = payload.operatorId;
+            this.sessionExpiresAt.value = luxon_1.DateTime.now().plus({ seconds: payload.ttl }).toJSDate();
+            return payload;
+        }
+        catch (error) {
+            this.clearSession();
+            throw (0, error_handler_1.createSdkError)(error, 'Login failed');
+        }
+    }
+    /**
+     * Log out current user
+     */
+    async logout() {
+        try {
+            const response = await this.http.post('/logout', {});
+            this.clearSession();
+            return response;
+        }
+        catch (error) {
+            // Still clear session even if logout API fails
+            this.clearSession();
+            throw (0, error_handler_1.createSdkError)(error, 'Logout failed');
+        }
+    }
+    /**
+     * Check if current session is valid
+     */
+    isSessionValid() {
+        const operatorId = this.operatorId.value;
+        const expiresAt = this.sessionExpiresAt.value;
+        if (!Number.isInteger(operatorId))
+            return false;
+        if (!expiresAt)
+            return false;
+        return luxon_1.DateTime.now() < luxon_1.DateTime.fromJSDate(expiresAt);
+    }
+    /**
+     * Validate session with server
+     */
+    async validateSessionWithServer() {
+        try {
+            const response = await this.http.get('/validate');
+            if (response.isSuccess) {
+                if (response.payload !== undefined) {
+                    const payload = response.payload;
+                    this.operatorId.value = payload.operatorId;
+                }
+                // Set reasonable expiration time
+                this.sessionExpiresAt.value = luxon_1.DateTime.now().plus({ hours: 1 }).toJSDate();
+                return true;
+            }
+            return false;
+        }
+        catch (error) {
+            this.clearSession();
+            return false;
+        }
+    }
+    /**
+     * Get current session data
+     */
+    getSessionData() {
+        const operatorId = this.operatorId.value;
+        const expiresAt = this.sessionExpiresAt.value;
+        if (!operatorId || !expiresAt) {
+            throw new Error('No active session');
+        }
+        return {
+            operatorId,
+            expiresAt: expiresAt.toISOString(),
+        };
+    }
+    /**
+     * Validate and restore a stored session
+     */
+    validateStoredSession(sessionData) {
+        if (!sessionData.operatorId || !sessionData.expiresAt) {
+            return false;
+        }
+        const expiresAt = luxon_1.DateTime.fromISO(sessionData.expiresAt);
+        if (!expiresAt.isValid || expiresAt < luxon_1.DateTime.now()) {
+            return false;
+        }
+        // Restore session
+        this.operatorId.value = sessionData.operatorId;
+        this.sessionExpiresAt.value = expiresAt.toJSDate();
+        return true;
+    }
+    /**
+     * Confirm email with token
+     */
+    async confirmEmail(token) {
+        try {
+            await this.http.post('/confirm-email', {}, { params: { token } });
+        }
+        catch (error) {
+            throw (0, error_handler_1.createSdkError)(error, 'Email confirmation failed');
+        }
+    }
+    /**
+     * Resend confirmation email
+     */
+    async resendConfirmation(email) {
+        try {
+            await this.http.post('/resend-confirmation', { email });
+        }
+        catch (error) {
+            throw (0, error_handler_1.createSdkError)(error, 'Failed to resend confirmation email');
+        }
+    }
+    /**
+     * Clear current session
+     */
+    clearSession() {
+        this.operatorId.value = null;
+        this.sessionExpiresAt.value = null;
+    }
+}
+exports.BiomeAuth = BiomeAuth;
+//# sourceMappingURL=auth.service.js.map

package/dist/auth/auth.service.js.map

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

package/dist/auth/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Authentication validation types
+ */
+export interface AuthValidationRequest {
+    emailOrUsername: string;
+    password: string;
+    timezoneId: number;
+}
+export interface PasswordChangeRequest {
+    currentPassword: string;
+    newPassword: string;
+}
+export interface PasswordResetRequest {
+    email: string;
+}
+export interface EmailConfirmationRequest {
+    token: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,MAAM,CAAC;CACjB"}

package/dist/auth/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/auth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":""}

package/dist/core/configuration.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SDK Configuration Options
+ */
+export interface BiomeConfig {
+    /** Base URL for API requests */
+    apiBaseUrl: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Authentication token for API requests */
+    authToken?: string;
+    /** Additional HTTP headers */
+    headers?: Record<string, string>;
+    /** HTTP configuration */
+    http?: {
+        withCredentials?: boolean;
+        interceptors?: {
+            credentials?: boolean;
+            taskNotificationRefresh?: {
+                broadcastChannel?: string;
+                customEvent?: string;
+                ignoreUrls?: string[];
+            };
+        };
+    };
+}
+//# sourceMappingURL=configuration.d.ts.map

package/dist/core/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/core/configuration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,yBAAyB;IACzB,IAAI,CAAC,EAAE;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,YAAY,CAAC,EAAE;YACX,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,uBAAuB,CAAC,EAAE;gBACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;aACzB,CAAC;SACL,CAAC;KACL,CAAC;CACL"}

package/dist/core/configuration.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=configuration.js.map

package/dist/core/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/core/configuration.ts"],"names":[],"mappings":""}

package/dist/core/error-handler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Standardized SDK error structure
+ */
+export interface BiomeSdkError extends Error {
+    /** HTTP status code */
+    status?: number;
+    /** Error type from API */
+    type?: string;
+    /** User-friendly error message */
+    userMessage?: string;
+    /** Technical error details */
+    technicalDetails?: string;
+    /** Error code from API */
+    code?: string;
+    /** Timestamp when error occurred */
+    timestamp: string;
+    /** Original error */
+    originalError?: unknown;
+}
+/**
+ * Create standardized error object
+ */
+export declare function createSdkError(error: unknown, context?: string): BiomeSdkError;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/core/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/core/error-handler.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IACxC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GACjB,aAAa,CAgDf"}

package/dist/core/error-handler.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSdkError = createSdkError;
+const axios_1 = require("axios");
+/**
+ * Create standardized error object
+ */
+function createSdkError(error, context) {
+    const timestamp = new Date().toISOString();
+    // Defensive check for AxiosError availability
+    if (error && typeof axios_1.AxiosError !== 'undefined' && error instanceof axios_1.AxiosError) {
+        return {
+            name: 'BiomeSdkError',
+            message: error.message,
+            status: error.response?.status,
+            userMessage: getUserFriendlyErrorMessage(error.response?.status, error.response?.data),
+            technicalDetails: error.response?.data?.message || error.message,
+            code: error.code,
+            timestamp,
+            originalError: error,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            name: 'BiomeSdkError',
+            message: error.message,
+            userMessage: context ? `${context}: ${error.message}` : error.message,
+            technicalDetails: error.message,
+            timestamp,
+            originalError: error,
+        };
+    }
+    // Handle cases where error might be null, undefined, or not an object
+    if (!error || typeof error !== 'object') {
+        return {
+            name: 'BiomeSdkError',
+            message: 'Unknown error occurred',
+            userMessage: context ? `${context}: An unexpected error occurred` : 'An unexpected error occurred',
+            technicalDetails: 'Invalid error object received',
+            timestamp,
+            originalError: error,
+        };
+    }
+    return {
+        name: 'BiomeSdkError',
+        message: 'Unknown error occurred',
+        userMessage: context ? `${context}: An unexpected error occurred` : 'An unexpected error occurred',
+        technicalDetails: 'Unknown error',
+        timestamp,
+        originalError: error,
+    };
+}
+/**
+ * Get user-friendly error message based on HTTP status
+ */
+function getUserFriendlyErrorMessage(status, errorData) {
+    switch (status) {
+        case 400:
+            return errorData?.message || 'Invalid request format. Please check your input.';
+        case 401:
+            return errorData?.message || 'Authentication required. Please log in.';
+        case 403:
+            return errorData?.message || 'Access denied. You do not have permission for this action.';
+        case 404:
+            return 'The requested resource was not found.';
+        case 429:
+            return 'Too many requests. Please wait a moment and try again.';
+        case 500:
+        case 502:
+        case 503:
+            return 'Server error. Please try again in a few moments.';
+        default:
+            return errorData?.message || 'An error occurred. Please try again.';
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/core/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/core/error-handler.ts"],"names":[],"mappings":";;AAyBA,wCAmDC;AA5ED,iCAAmC;AAsBnC;;GAEG;AACH,SAAgB,cAAc,CAC1B,KAAc,EACd,OAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,8CAA8C;IAC9C,IAAI,KAAK,IAAI,OAAO,kBAAU,KAAK,WAAW,IAAI,KAAK,YAAY,kBAAU,EAAE,CAAC;QAC5E,OAAO;YACH,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM;YAC9B,WAAW,EAAE,2BAA2B,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;YACtF,gBAAgB,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO;YAChE,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS;YACT,aAAa,EAAE,KAAK;SACvB,CAAC;IACN,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO;YACH,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;YACrE,gBAAgB,EAAE,KAAK,CAAC,OAAO;YAC/B,SAAS;YACT,aAAa,EAAE,KAAK;SACvB,CAAC;IACN,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO;YACH,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,wBAAwB;YACjC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,gCAAgC,CAAC,CAAC,CAAC,8BAA8B;YAClG,gBAAgB,EAAE,+BAA+B;YACjD,SAAS;YACT,aAAa,EAAE,KAAK;SACvB,CAAC;IACN,CAAC;IAED,OAAO;QACH,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,gCAAgC,CAAC,CAAC,CAAC,8BAA8B;QAClG,gBAAgB,EAAE,eAAe;QACjC,SAAS;QACT,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAAC,MAAe,EAAE,SAAe;IACjE,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,GAAG;YACJ,OAAO,SAAS,EAAE,OAAO,IAAI,kDAAkD,CAAC;QACpF,KAAK,GAAG;YACJ,OAAO,SAAS,EAAE,OAAO,IAAI,yCAAyC,CAAC;QAC3E,KAAK,GAAG;YACJ,OAAO,SAAS,EAAE,OAAO,IAAI,4DAA4D,CAAC;QAC9F,KAAK,GAAG;YACJ,OAAO,uCAAuC,CAAC;QACnD,KAAK,GAAG;YACJ,OAAO,wDAAwD,CAAC;QACpE,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACJ,OAAO,kDAAkD,CAAC;QAC9D;YACI,OAAO,SAAS,EAAE,OAAO,IAAI,sCAAsC,CAAC;IAC5E,CAAC;AACL,CAAC"}

package/dist/core/http-client.d.ts

@@ -0,0 +1,43 @@
+import { AxiosRequestConfig } from 'axios';
+import { BiomeConfig } from './configuration';
+/**
+ * Framework-agnostic HTTP client using Axios
+ */
+export declare class BiomeHttpClient {
+    private config;
+    private readonly axiosInstance;
+    constructor(config: BiomeConfig);
+    /**
+     * Perform GET request
+     */
+    get<T>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform POST request
+     */
+    post<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform PUT request
+     */
+    put<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform PATCH request
+     */
+    patch<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Perform DELETE request
+     */
+    delete<T = void>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Set authentication token for subsequent requests
+     */
+    setAuthToken(token: string): void;
+    /**
+     * Clear authentication token
+     */
+    clearAuthToken(): void;
+    /**
+     * Setup request and response interceptors
+     */
+    private setupInterceptors;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/core/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiB,kBAAkB,EAAiB,MAAM,OAAO,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,qBAAa,eAAe;IAGZ,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAE1B,MAAM,EAAE,WAAW;IAcvC;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlE;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/E;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK9E;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKpF;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxE;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAyB5B"}