@dugjason/front-node 0.1.0-alpha.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 J.Dugdale
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,323 @@
+# Front Node.js SDK
+
+A modern TypeScript SDK for the [Front.com API](https://dev.frontapp.com/reference/introduction). This SDK provides a clean, intuitive interface for interacting with Front's customer operations platform.
+
+## Installation
+
+```bash
+npm install front-node
+# or
+pnpm install front-node
+# or
+yarn add front-node
+```
+
+## Quick Start
+
+```typescript
+import { Front } from 'front-node';
+
+// Initialize with API key (required)
+const front = new Front({ 
+  apiKey: process.env.FRONT_API_KEY || 'your-api-key' 
+});
+
+// Fetch a conversation
+const conversation = await front.conversations.fetch('cnv_55c8c149');
+
+// List teammates
+const teammates = await front.teammates.list();
+
+// Update a teammate
+await front.teammates.update(teammates._results[0].id, {
+  is_available: true
+});
+```
+
+## Authentication
+
+The SDK supports two authentication methods:
+
+### 1. OAuth (Recommended for Production)
+
+OAuth provides automatic token refresh and is required for public integrations:
+
+```typescript
+const front = new Front({
+  oauth: {
+    clientId: 'your-oauth-client-id',
+    clientSecret: 'your-oauth-client-secret',
+    accessToken: 'your-current-access-token',
+    refreshToken: 'your-refresh-token',
+    
+    // Optional: Called when tokens are refreshed
+    onTokenRefresh: async (tokens) => {
+      // Save new tokens to your database
+      await saveTokensToDatabase(tokens);
+    }
+  }
+});
+```
+
+The SDK automatically refreshes tokens when they expire (every hour) and calls your `onTokenRefresh` callback with the new tokens.
+
+### 2. API Key (Simple Setup)
+
+For testing or single-instance usage:
+
+```typescript
+// Using environment variable (recommended)
+const front = new Front({ 
+  apiKey: process.env.FRONT_API_KEY || 'your-api-key' 
+});
+
+// Or provide directly
+const front = new Front({ apiKey: 'your-api-key' });
+```
+
+## API Reference
+
+### Conversations
+
+```typescript
+// List conversations
+const conversations = await front.conversations.list({
+  limit: 50,
+  q: 'status:unassigned'
+});
+
+// Fetch a specific conversation
+const conversation = await front.conversations.fetch('cnv_123');
+
+// Update a conversation
+await front.conversations.update('cnv_123', {
+  status: 'archived'
+});
+
+// Get conversation messages
+const messages = await front.conversations.getMessages('cnv_123');
+
+// Get conversation events
+const events = await front.conversations.getEvents('cnv_123');
+```
+
+### Teammates
+
+```typescript
+// List all teammates
+const teammates = await front.teammates.list();
+
+// Fetch a specific teammate
+const teammate = await front.teammates.fetch('tea_123');
+
+// Update a teammate
+await front.teammates.update('tea_123', {
+  first_name: 'John',
+  last_name: 'Doe',
+  is_available: true
+});
+
+// Get teammate's inboxes
+const inboxes = await front.teammates.getInboxes('tea_123');
+
+// Get teammate's conversations
+const conversations = await front.teammates.getConversations('tea_123', {
+  limit: 10
+});
+```
+
+## OAuth Token Management
+
+When using OAuth, the SDK provides several utilities for token management:
+
+```typescript
+// Check if using OAuth
+const isOAuth = front.isUsingOAuth();
+
+// Get OAuth manager for advanced operations
+const oauthManager = front.getOAuthManager();
+if (oauthManager) {
+  // Force token refresh
+  const newToken = oauthManager.getAccessToken();
+}
+
+// Update OAuth configuration (e.g., after manual token refresh)
+front.updateOAuthConfig({
+  accessToken: 'new-access-token',
+  refreshToken: 'new-refresh-token',
+});
+```
+
+### Token Refresh Callback
+
+The `onTokenRefresh` callback is crucial for OAuth implementations - it allows the SDK to notify your application when tokens are automatically refreshed, so you can save the updated tokens to your database or storage system.
+
+**Example with database storage:**
+```typescript
+// Function to save tokens to your database
+async function saveTokensToDatabase(userId: string, tokens: OAuthTokens) {
+  await db.users.update(userId, {
+    frontAccessToken: tokens.access_token,
+    frontRefreshToken: tokens.refresh_token,
+    updatedAt: new Date()
+  });
+}
+
+const front = new Front({
+  oauth: {
+    clientId: 'your-client-id',
+    clientSecret: 'your-client-secret',
+    accessToken: 'current-access-token',
+    refreshToken: 'current-refresh-token',
+    
+    // SDK calls this whenever tokens are refreshed
+    onTokenRefresh: async (tokens) => {
+      console.log('Front SDK refreshed tokens, saving to database...');
+      await saveTokensToDatabase(currentUserId, tokens);
+      console.log('Tokens saved successfully');
+    }
+  }
+});
+
+// When any API call triggers a token refresh, your callback will be called
+const conversations = await front.conversations.list(); // May trigger refresh + callback
+```
+
+### Concurrent Token Refresh Protection
+
+The SDK uses an internal `refreshPromise` mechanism to prevent multiple simultaneous token refresh attempts. This ensures that if multiple API calls happen simultaneously when a token is expired, only one refresh request is made to the OAuth server, and your `onTokenRefresh` callback is only called once.
+
+**How it works:**
+- When the first API call detects an expired token, it starts the refresh process
+- Any subsequent API calls that also detect the expired token will wait for the same refresh promise to complete
+- Once the refresh is complete, `onTokenRefresh` is called once with the new tokens
+- All waiting calls then proceed with the refreshed token
+
+**Practical Example:**
+```typescript
+let refreshCount = 0;
+
+const front = new Front({
+  oauth: {
+    clientId: 'your-client-id',
+    clientSecret: 'your-client-secret',
+    accessToken: 'expired-token',
+    refreshToken: 'your-refresh-token',
+    onTokenRefresh: async (tokens) => {
+      refreshCount++;
+      console.log(`Token refresh #${refreshCount}:`, tokens);
+      await saveTokensToDatabase(currentUserId, tokens);
+    }
+  }
+});
+
+// These calls happen simultaneously when token is expired
+// Only ONE refresh request will be made, callback called once
+const [conversations, teammates, accounts] = await Promise.all([
+  front.conversations.list(),  // Triggers token refresh
+  front.teammates.list(),      // Waits for existing refresh
+  front.accounts.list()        // Waits for existing refresh
+]);
+
+console.log(`Refresh count: ${refreshCount}`); // Will be 1, not 3
+```
+
+This prevents rate limiting issues with the OAuth provider and ensures your database isn't hit with duplicate token updates.
+
+## Configuration
+
+```typescript
+const front = new Front({
+  apiKey: 'your-api-key', // For API key auth
+  baseUrl: 'https://api2.frontapp.com', // optional, defaults to Front's API
+  oauth: { // For OAuth auth
+    clientId: 'your-client-id',
+    clientSecret: 'your-client-secret',
+    accessToken: 'current-access-token',
+    refreshToken: 'current-refresh-token',
+    onTokenRefresh: async (tokens) => { /* save tokens */ }
+  }
+});
+```
+
+## Error Handling
+
+The SDK throws structured errors with helpful information:
+
+```typescript
+try {
+  const conversation = await front.conversations.fetch('invalid-id');
+} catch (error) {
+  console.error('Status:', error.status);
+  console.error('Message:', error.message);
+  console.error('Code:', error.code);
+}
+```
+
+## TypeScript Support
+
+The SDK is built with TypeScript and provides full type definitions:
+
+```typescript
+import { Front, Conversation, Teammate } from 'front-node';
+
+const front = new Front({ apiKey: 'your-api-key' });
+
+// Full type safety
+const conversation: Conversation = await front.conversations.fetch('cnv_123');
+const teammates: Teammate[] = (await front.teammates.list())._results;
+```
+
+## Releases
+
+This package uses automated publishing with manual version management. When changes are merged to the main branch, the current version in `package.json` is automatically published to npm.
+
+### Release Process
+
+1. **Version Management**: Version bumps are handled manually using semantic versioning:
+   - **Patch** (`1.0.0` → `1.0.1`): Bug fixes, documentation updates, refactoring
+   - **Minor** (`1.0.0` → `1.1.0`): New features, enhancements
+   - **Major** (`1.0.0` → `2.0.0`): Breaking changes
+
+2. **How to Release**:
+   ```bash
+   # Bump version using pnpm (recommended)
+   pnpm version patch   # for bug fixes
+   pnpm version minor   # for new features
+   pnpm version major   # for breaking changes
+   
+   # Or manually edit package.json and create a git tag
+   git tag v1.2.3
+   
+   # Push changes and tags
+   git push origin main --tags
+   ```
+
+3. **What Happens on Push to Main**:
+   - Tests run on Node.js 20 and 22
+   - Code is linted with Biome
+   - TypeScript compilation is verified
+   - Package is published to npm using the current `package.json` version
+   - GitHub release is created with the current version tag
+
+### Development Workflow
+
+1. Create feature branch from `main`
+2. Make changes and commit
+3. Open Pull Request
+4. After review and merge to `main`:
+   - If you want to publish: bump version first, then merge
+   - If not ready to publish: merge without version bump
+
+## Requirements
+
+- Node.js 18.0.0 or higher (for native fetch support)
+- TypeScript 5.0+ (if using TypeScript)
+
+## License
+
+ISC
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/client.d.ts

@@ -0,0 +1,48 @@
+import { OAuthTokenManager } from "./oauth";
+import type { FrontConfig, RequestOptions } from "./types";
+export declare class FrontClient {
+    private apiKey?;
+    private baseUrl;
+    private oauthManager?;
+    constructor(config: FrontConfig);
+    request<T>(options: RequestOptions): Promise<T>;
+    private requestWithRetry;
+    /**
+     * Calculate retry delay based on retry-after header and exponential backoff
+     */
+    private getRetryDelay;
+    /**
+     * Calculate exponential backoff delay with jitter
+     */
+    private calculateExponentialBackoff;
+    /**
+     * Sleep for the specified number of milliseconds
+     */
+    private sleep;
+    /**
+     * Get the appropriate auth token (OAuth access token or API key)
+     */
+    private getAuthToken;
+    /**
+     * Handle the response from the API
+     */
+    private handleResponse;
+    get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+    /**
+     * Get the OAuth token manager (if using OAuth)
+     */
+    getOAuthManager(): OAuthTokenManager | undefined;
+    /**
+     * Check if the client is using OAuth authentication
+     */
+    isUsingOAuth(): boolean;
+    /**
+     * Update OAuth configuration (useful for updating tokens)
+     */
+    updateOAuthConfig(updates: Partial<import("./types").OAuthConfig>): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAc,cAAc,EAAE,MAAM,SAAS,CAAA;AAUtE,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAC,CAAmB;gBAE5B,MAAM,EAAE,WAAW;IAiBzB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAIvC,gBAAgB;IAwF9B;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;YACW,cAAc;IAyBtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzC;;OAEG;IACH,eAAe,IAAI,iBAAiB,GAAG,SAAS;IAIhD;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI;CAMzE"}

package/dist/client.js

@@ -0,0 +1,218 @@
+import { OAuthTokenManager } from "./oauth";
+// Rate limiting configuration
+const RATE_LIMIT_CONFIG = {
+    maxRetries: 3,
+    baseDelay: 1_000, // 1 second
+    maxDelay: 30_000, // 30 seconds
+    jitterFactor: 0.2, // 20% jitter to avoid thundering herd problem
+};
+export class FrontClient {
+    apiKey;
+    baseUrl;
+    oauthManager;
+    constructor(config) {
+        this.baseUrl = config.baseUrl || "https://api2.frontapp.com";
+        if ("oauth" in config && config.oauth) {
+            // OAuth configuration provided
+            this.oauthManager = new OAuthTokenManager(config.oauth);
+        }
+        else {
+            // API key configuration
+            this.apiKey = config.apiKey || process.env.FRONT_API_KEY;
+            if (!this.apiKey) {
+                throw new Error("API key is required when not using OAuth. Provide apiKey via config or FRONT_API_KEY environment variable.");
+            }
+        }
+    }
+    async request(options) {
+        return this.requestWithRetry(options, 0);
+    }
+    async requestWithRetry(options, retryCount) {
+        const { method, path, body, params } = options;
+        // Build URL with query parameters
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.append(key, String(value));
+                }
+            });
+        }
+        // Get the authorization token (OAuth or API key)
+        const authToken = this.getAuthToken();
+        // Prepare headers
+        const headers = {
+            Authorization: `Bearer ${authToken}`,
+            Accept: "application/json",
+        };
+        // Add content-type for requests with body
+        if (body) {
+            headers["Content-Type"] = "application/json";
+        }
+        // Prepare fetch options
+        const fetchOptions = {
+            method,
+            headers,
+        };
+        // Add body for non-GET requests
+        if (body) {
+            fetchOptions.body = JSON.stringify(body);
+        }
+        try {
+            const response = await fetch(url.toString(), fetchOptions);
+            // Handle token expiration for OAuth
+            if (response.status === 401 && this.oauthManager) {
+                // Token might be expired, try to refresh and retry once
+                const refreshedToken = await this.oauthManager.refreshToken();
+                // Token was refreshed, retry the request
+                headers.Authorization = `Bearer ${refreshedToken}`;
+                const retryResponse = await fetch(url.toString(), {
+                    ...fetchOptions,
+                    headers,
+                });
+                return this.handleResponse(retryResponse);
+            }
+            // Handle rate limiting (429 status)
+            if (response.status === 429) {
+                if (retryCount < RATE_LIMIT_CONFIG.maxRetries) {
+                    const retryAfterMs = this.getRetryDelay(response, retryCount);
+                    await this.sleep(retryAfterMs);
+                    return this.requestWithRetry(options, retryCount + 1);
+                }
+                // Max retries exceeded, handle as normal error response
+            }
+            return this.handleResponse(response);
+        }
+        catch (error) {
+            if (error instanceof Error && "status" in error) {
+                // Re-throw Front API errors
+                throw error;
+            }
+            // Handle network or other errors - retry if we haven't exceeded max retries
+            if (retryCount < RATE_LIMIT_CONFIG.maxRetries) {
+                const retryAfterMs = this.calculateExponentialBackoff(retryCount);
+                await this.sleep(retryAfterMs);
+                return this.requestWithRetry(options, retryCount + 1);
+            }
+            // Max retries exceeded for network errors
+            throw new Error(`Request failed after ${RATE_LIMIT_CONFIG.maxRetries} retries: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Calculate retry delay based on retry-after header and exponential backoff
+     */
+    getRetryDelay(response, retryCount) {
+        const retryAfterHeader = response.headers.get("retry-after");
+        let retryAfterMs = 0;
+        if (retryAfterHeader) {
+            // retry-after can be in seconds (integer) or HTTP date
+            const retryAfterSeconds = Number.parseInt(retryAfterHeader, 10);
+            if (!Number.isNaN(retryAfterSeconds)) {
+                retryAfterMs = retryAfterSeconds * 1000;
+            }
+            else {
+                // Try parsing as HTTP date
+                const retryAfterDate = new Date(retryAfterHeader);
+                if (!Number.isNaN(retryAfterDate.getTime())) {
+                    retryAfterMs = Math.max(0, retryAfterDate.getTime() - Date.now());
+                }
+            }
+        }
+        // Calculate exponential backoff delay
+        const exponentialBackoffMs = this.calculateExponentialBackoff(retryCount);
+        // Use the maximum of retry-after and exponential backoff to ensure we wait AT LEAST retry-after time
+        return Math.max(retryAfterMs, exponentialBackoffMs);
+    }
+    /**
+     * Calculate exponential backoff delay with jitter
+     */
+    calculateExponentialBackoff(retryCount) {
+        const { baseDelay, maxDelay, jitterFactor } = RATE_LIMIT_CONFIG;
+        // Calculate exponential delay: baseDelay * (2 ^ retryCount)
+        const exponentialDelay = baseDelay * 2 ** retryCount;
+        // Apply maximum delay cap
+        const cappedDelay = Math.min(exponentialDelay, maxDelay);
+        // Add jitter to avoid thundering herd problem
+        // Jitter is a random value between +-jitterFactor of the delay
+        const jitter = cappedDelay * jitterFactor * (Math.random() * 2 - 1);
+        return Math.max(0, cappedDelay + jitter);
+    }
+    /**
+     * Sleep for the specified number of milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get the appropriate auth token (OAuth access token or API key)
+     */
+    getAuthToken() {
+        if (this.oauthManager) {
+            return this.oauthManager.getAccessToken();
+        }
+        if (!this.apiKey) {
+            throw new Error("No authentication method available. This should not happen with proper configuration.");
+        }
+        return this.apiKey;
+    }
+    /**
+     * Handle the response from the API
+     */
+    async handleResponse(response) {
+        // Handle non-JSON responses (like 204 No Content)
+        if (response.status === 204) {
+            return {};
+        }
+        const responseData = await response.json();
+        if (!response.ok) {
+            // Type guard for error response structure
+            const errorData = responseData;
+            const error = {
+                message: (typeof errorData.message === "string"
+                    ? errorData.message
+                    : undefined) || `HTTP ${response.status}: ${response.statusText}`,
+                status: response.status,
+                code: typeof errorData.code === "string" ? errorData.code : undefined,
+            };
+            throw error;
+        }
+        return responseData;
+    }
+    async get(path, params) {
+        return this.request({ method: "GET", path, params });
+    }
+    async post(path, body) {
+        return this.request({ method: "POST", path, body });
+    }
+    async put(path, body) {
+        return this.request({ method: "PUT", path, body });
+    }
+    async patch(path, body) {
+        return this.request({ method: "PATCH", path, body });
+    }
+    async delete(path) {
+        return this.request({ method: "DELETE", path });
+    }
+    /**
+     * Get the OAuth token manager (if using OAuth)
+     */
+    getOAuthManager() {
+        return this.oauthManager;
+    }
+    /**
+     * Check if the client is using OAuth authentication
+     */
+    isUsingOAuth() {
+        return !!this.oauthManager;
+    }
+    /**
+     * Update OAuth configuration (useful for updating tokens)
+     */
+    updateOAuthConfig(updates) {
+        if (!this.oauthManager) {
+            throw new Error("OAuth is not configured for this client");
+        }
+        this.oauthManager.updateConfig(updates);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/front.d.ts

@@ -0,0 +1,29 @@
+import { FrontClient } from "./client";
+import { Accounts } from "./resources/accounts";
+import { Conversations } from "./resources/conversations";
+import { Teammates } from "./resources/teammates";
+import type { FrontConfig } from "./types";
+export declare class Front {
+    private client;
+    readonly teammates: Teammates;
+    readonly conversations: Conversations;
+    readonly accounts: Accounts;
+    constructor(config: FrontConfig);
+    /**
+     * Get the underlying HTTP client for advanced usage
+     */
+    getClient(): FrontClient;
+    /**
+     * Check if the SDK is using OAuth authentication
+     */
+    isUsingOAuth(): boolean;
+    /**
+     * Get the OAuth token manager (if using OAuth)
+     */
+    getOAuthManager(): import("./oauth").OAuthTokenManager | undefined;
+    /**
+     * Update OAuth configuration (useful for updating tokens)
+     */
+    updateOAuthConfig(updates: Partial<FrontConfig["oauth"]>): void;
+}
+//# sourceMappingURL=front.d.ts.map

package/dist/front.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"front.d.ts","sourceRoot":"","sources":["../src/front.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAa;IAE3B,SAAgB,SAAS,EAAE,SAAS,CAAA;IACpC,SAAgB,aAAa,EAAE,aAAa,CAAA;IAC5C,SAAgB,QAAQ,EAAE,QAAQ,CAAA;gBAEtB,MAAM,EAAE,WAAW;IAS/B;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,eAAe;IAIf;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;CAIzD"}