@voltade/wess-sdk 1.0.0

package/README.md

@@ -0,0 +1,352 @@
+# @voltade/wess-sdk
+
+A comprehensive, type-safe TypeScript SDK for the WESS Open API with built-in error handling and resource-based architecture.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub Package](https://img.shields.io/badge/GitHub-Package-blue.svg)](https://github.com/voltade/wess-sdk/packages)
+
+## Features
+
+- 🔒 **Type-safe**: Full TypeScript support with exported types
+- 🏗️ **Resource-based architecture**: Organized by API domain (user, branches, customers)
+- ⚠️ **Error handling**: Specific error classes for different failure scenarios
+- 🔌 **Zero dependencies**: Uses native `fetch` API (Node.js 18+)
+- 🛠️ **Configurable**: Environment variables or programmatic configuration
+
+## Installation
+
+> **Note:** This package is published to GitHub Packages (not npm) as a private package.
+
+### Prerequisites
+
+1. **Create a GitHub Personal Access Token:**
+
+   - Go to https://github.com/settings/tokens/new
+   - Give it a name (e.g., "npm-packages")
+   - Select scopes: `read:packages` and `repo`
+   - Generate and copy the token
+
+2. **Configure npm to use GitHub Packages:**
+
+Create or update `.npmrc` in your project root:
+
+```bash
+@voltade:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+```
+
+> **Important:** Add `.npmrc` to your `.gitignore` to avoid committing your token!
+
+3. **Install the package:**
+
+```bash
+npm install @voltade/wess-sdk
+```
+
+```bash
+yarn add @voltade/wess-sdk
+```
+
+```bash
+pnpm add @voltade/wess-sdk
+```
+
+## Quick Start
+
+```typescript
+import { WessClient } from "@voltade/wess-sdk";
+
+// Initialize the client
+const client = new WessClient({
+  baseUrl: "https://your-wess-api.com/api",
+  bearerToken: "your-bearer-token",
+});
+
+// Get current user
+const user = await client.user.get();
+console.log(user.data.name);
+
+// List all branches
+const branches = await client.branches.list();
+
+// Get a specific branch
+const branch = await client.branches.get(4630);
+
+// Get online appointment services for a branch
+const services = await client.branches.getOnlineAppointmentServices(4630);
+
+// Get available employees for specific products
+const employees = await client.branches.getOnlineAppointmentEmployees(4630, {
+  product_ids: [1718, 5523],
+});
+
+// Get available time slots
+const timeSlots = await client.branches.getOnlineAppointmentTimeSlots(4630, {
+  product_ids: [1718],
+  date: "2024-12-15",
+});
+
+// Search customers by phone number
+const customers = await client.customers.searchByPhoneNumber("+60123456789");
+```
+
+## Configuration
+
+### Environment Variables
+
+The SDK can be configured using environment variables:
+
+```bash
+WESS_BASE_URL=https://your-wess-api.com/api
+WESS_BEARER_TOKEN=your-bearer-token
+```
+
+### Client Options
+
+```typescript
+interface WessClientConfig {
+  /** Base URL for the WESS API (default: from WESS_BASE_URL env var) */
+  baseUrl?: string;
+  /** Bearer token for authentication (default: from WESS_BEARER_TOKEN env var) */
+  bearerToken?: string;
+  /** Request timeout in milliseconds (default: 30000) */
+  timeout?: number;
+  /** Custom headers to include in all requests */
+  headers?: Record<string, string>;
+}
+```
+
+## API Reference
+
+### User Resource
+
+```typescript
+// Get current authenticated user
+const response = await client.user.get();
+// Returns: { code: number, data: User }
+```
+
+### Branches Resource
+
+```typescript
+// List all branches
+const branches = await client.branches.list();
+// Returns: Branch[]
+
+// Get a single branch
+const branch = await client.branches.get(branchId);
+// Returns: Branch
+
+// Get a customer from a branch
+const customer = await client.branches.getCustomer(branchId, customerId);
+// Returns: Customer
+
+// Get online appointment services
+const services = await client.branches.getOnlineAppointmentServices(branchId);
+// Returns: OnlineAppointmentService[]
+
+// Get employees for online appointments (filtered by product IDs)
+const employees = await client.branches.getOnlineAppointmentEmployees(
+  branchId,
+  {
+    product_ids: [1718, 5523],
+  }
+);
+// Returns: OnlineAppointmentEmployee[]
+
+// Get available time slots
+const slots = await client.branches.getOnlineAppointmentTimeSlots(branchId, {
+  product_ids: [1718],
+  date: "2024-12-15", // YYYY-MM-DD format
+});
+// Returns: OnlineAppointmentTimeSlot[]
+```
+
+### Customers Resource
+
+```typescript
+// Search customers by phone number
+const customers = await client.customers.searchByPhoneNumber("+60123456789");
+// Returns: Customer[]
+```
+
+## Error Handling
+
+The SDK provides specific error classes for different failure scenarios:
+
+```typescript
+import {
+  WessError,
+  WessAuthenticationError,
+  WessNotFoundError,
+  WessValidationError,
+  WessNetworkError,
+  WessTimeoutError,
+} from "@voltade/wess-sdk";
+
+try {
+  const branch = await client.branches.get(99999);
+} catch (error) {
+  if (error instanceof WessAuthenticationError) {
+    // 401 - Invalid or expired token
+    console.error("Please check your bearer token");
+  } else if (error instanceof WessNotFoundError) {
+    // 404 - Resource not found
+    console.error("Branch not found");
+  } else if (error instanceof WessValidationError) {
+    // 422 - Validation failed
+    console.error("Validation errors:", error.errors);
+  } else if (error instanceof WessNetworkError) {
+    // Network connectivity issues
+    console.error("Network error:", error.message);
+  } else if (error instanceof WessTimeoutError) {
+    // Request timeout
+    console.error("Request timed out");
+  } else if (error instanceof WessError) {
+    // Generic API error
+    console.error(`API error (${error.statusCode}):`, error.message);
+  }
+}
+```
+
+### Available Error Classes
+
+| Error Class               | Status Code | Description                    |
+| ------------------------- | ----------- | ------------------------------ |
+| `WessError`               | Any         | Base error class               |
+| `WessAuthenticationError` | 401         | Invalid or missing credentials |
+| `WessNotFoundError`       | 404         | Resource not found             |
+| `WessValidationError`     | 422         | Request validation failed      |
+| `WessNetworkError`        | -           | Network connectivity issues    |
+| `WessTimeoutError`        | -           | Request timeout                |
+
+## TypeScript Support
+
+All types are exported and fully documented:
+
+```typescript
+import type {
+  // Config
+  WessClientConfig,
+  RequestOptions,
+
+  // User
+  User,
+  UserResponse,
+
+  // Branch
+  Branch,
+
+  // Customer
+  Customer,
+
+  // Online Appointments
+  OnlineAppointmentService,
+  OnlineAppointmentEmployee,
+  OnlineAppointmentTimeSlot,
+  ServiceDetails,
+  EmployeeProduct,
+  GetEmployeesParams,
+  GetTimeSlotsParams,
+
+  // Errors
+  ApiErrorResponse,
+  ValidationErrorResponse,
+} from "@voltade/wess-sdk";
+```
+
+## Advanced Usage
+
+### Direct Resource Access
+
+```typescript
+import { WessClient, BranchesResource } from "@voltade/wess-sdk";
+
+const client = new WessClient({ baseUrl: "...", bearerToken: "..." });
+
+// Access resources directly
+const branches: BranchesResource = client.branches;
+const allBranches = await branches.list();
+```
+
+### Custom HTTP Client
+
+```typescript
+const httpClient = client.getHttpClient();
+
+// Make custom requests
+const response = await httpClient.get("/custom-endpoint", {
+  params: { key: "value" },
+});
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- TypeScript >= 5.0.0
+
+## Architecture
+
+```
+@voltade/wess-sdk/
+├── index.ts              # Main entry point & WessClient class
+├── client.ts             # HTTP client wrapper
+├── types.ts              # TypeScript type definitions
+├── errors.ts             # Error classes
+├── resources/
+│   ├── index.ts          # Resource exports
+│   ├── user.ts           # User resource
+│   ├── branches.ts       # Branches resource
+│   └── customers.ts      # Customers resource
+└── utils/
+    └── pagination.ts     # Pagination utilities (if needed)
+```
+
+## Publishing (Maintainers Only)
+
+This package is published exclusively to GitHub Packages. To publish a new version:
+
+### 1. Create a GitHub Personal Access Token
+
+- Go to https://github.com/settings/tokens/new
+- Name: `npm-publish-token`
+- Select scopes: `write:packages`, `read:packages`, and `repo`
+- Generate and copy the token
+
+### 2. Authenticate with GitHub Packages
+
+```bash
+npm login --registry=https://npm.pkg.github.com
+```
+
+- **Username:** `voltade`
+- **Password:** Your personal access token
+- **Email:** Your GitHub email
+
+### 3. Publish
+
+```bash
+# Bump version in package.json first
+npm version patch  # or minor, or major
+
+# Publish to GitHub Packages
+npm publish
+```
+
+> **Note:** This package is NOT published to npm, only to GitHub Packages.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © Voltade
+
+## Support
+
+For issues and questions, please file an issue on [GitHub](https://github.com/voltade/wess-sdk/issues).
+
+---
+
+Made with ❤️ by Voltade

package/dist/client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WESS HTTP Client
+ * Core HTTP wrapper with built-in error handling
+ */
+import type { RequestOptions, WessClientConfig } from "./types.js";
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly bearerToken;
+    private readonly timeout;
+    private readonly defaultHeaders;
+    constructor(config: WessClientConfig);
+    private buildUrl;
+    private getHeaders;
+    private handleResponse;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAWnE,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,MAAM,EAAE,gBAAgB;IAuBpC,OAAO,CAAC,QAAQ;IA2BhB,OAAO,CAAC,UAAU;YAUJ,cAAc;IA+BtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAkC9D,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IAmCP,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IAmCP,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;CAiCxE"}

package/dist/client.js

@@ -0,0 +1,195 @@
+/**
+ * WESS HTTP Client
+ * Core HTTP wrapper with built-in error handling
+ */
+import { WessError, WessAuthenticationError, WessNotFoundError, WessValidationError, WessNetworkError, WessTimeoutError, WessRateLimitError, } from "./errors.js";
+export class HttpClient {
+    baseUrl;
+    bearerToken;
+    timeout;
+    defaultHeaders;
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.bearerToken = config.bearerToken;
+        this.timeout = config.timeout ?? 30000;
+        this.defaultHeaders = {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            ...config.headers,
+        };
+        if (!this.baseUrl) {
+            throw new WessError("Base URL is required. Set WESS_BASE_URL env var or pass baseUrl in config.");
+        }
+        if (!this.bearerToken) {
+            throw new WessError("Bearer token is required. Set WESS_BEARER_TOKEN env var or pass bearerToken in config.");
+        }
+    }
+    buildUrl(path, params) {
+        // Ensure baseUrl ends with / and path doesn't start with /
+        const base = this.baseUrl.endsWith("/") ? this.baseUrl : this.baseUrl + "/";
+        const cleanPath = path.startsWith("/") ? path.slice(1) : path;
+        const url = new URL(cleanPath, base);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value === undefined || value === null)
+                    continue;
+                if (Array.isArray(value)) {
+                    // Handle array params like product_ids[]
+                    for (const item of value) {
+                        url.searchParams.append(`${key}[]`, String(item));
+                    }
+                }
+                else {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    getHeaders(customHeaders) {
+        return {
+            ...this.defaultHeaders,
+            Authorization: `Bearer ${this.bearerToken}`,
+            ...customHeaders,
+        };
+    }
+    async handleResponse(response) {
+        if (response.ok) {
+            const text = await response.text();
+            if (!text)
+                return {};
+            return JSON.parse(text);
+        }
+        let errorData = {};
+        try {
+            errorData = await response.json();
+        }
+        catch {
+            // Response body might not be JSON
+        }
+        const message = errorData.message || `HTTP ${response.status}: ${response.statusText}`;
+        switch (response.status) {
+            case 401:
+                throw new WessAuthenticationError(message);
+            case 404:
+                throw new WessNotFoundError(message);
+            case 422:
+                throw new WessValidationError(message, errorData.errors);
+            case 429:
+                throw new WessRateLimitError(message);
+            default:
+                throw new WessError(message, response.status, errorData);
+        }
+    }
+    async get(path, options = {}) {
+        const url = this.buildUrl(path, options.params);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "GET",
+                headers: this.getHeaders(options.headers),
+                signal: controller.signal,
+            });
+            return this.handleResponse(response);
+        }
+        catch (error) {
+            if (error instanceof WessError)
+                throw error;
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new WessTimeoutError(`Request timeout after ${options.timeout ?? this.timeout}ms`);
+                }
+                throw new WessNetworkError(error.message);
+            }
+            throw new WessNetworkError("Unknown network error");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async post(path, body, options = {}) {
+        const url = this.buildUrl(path, options.params);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: this.getHeaders(options.headers),
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            return this.handleResponse(response);
+        }
+        catch (error) {
+            if (error instanceof WessError)
+                throw error;
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new WessTimeoutError(`Request timeout after ${options.timeout ?? this.timeout}ms`);
+                }
+                throw new WessNetworkError(error.message);
+            }
+            throw new WessNetworkError("Unknown network error");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async put(path, body, options = {}) {
+        const url = this.buildUrl(path, options.params);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "PUT",
+                headers: this.getHeaders(options.headers),
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            return this.handleResponse(response);
+        }
+        catch (error) {
+            if (error instanceof WessError)
+                throw error;
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new WessTimeoutError(`Request timeout after ${options.timeout ?? this.timeout}ms`);
+                }
+                throw new WessNetworkError(error.message);
+            }
+            throw new WessNetworkError("Unknown network error");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async delete(path, options = {}) {
+        const url = this.buildUrl(path, options.params);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "DELETE",
+                headers: this.getHeaders(options.headers),
+                signal: controller.signal,
+            });
+            return this.handleResponse(response);
+        }
+        catch (error) {
+            if (error instanceof WessError)
+                throw error;
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new WessTimeoutError(`Request timeout after ${options.timeout ?? this.timeout}ms`);
+                }
+                throw new WessNetworkError(error.message);
+            }
+            throw new WessNetworkError("Unknown network error");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * WESS SDK Error Classes
+ */
+export declare class WessError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly response?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined);
+}
+export declare class WessAuthenticationError extends WessError {
+    constructor(message?: string);
+}
+export declare class WessNotFoundError extends WessError {
+    constructor(message?: string);
+}
+export declare class WessValidationError extends WessError {
+    readonly errors: Record<string, string[]>;
+    constructor(message: string, errors?: Record<string, string[]>);
+}
+export declare class WessNetworkError extends WessError {
+    constructor(message?: string);
+}
+export declare class WessTimeoutError extends WessError {
+    constructor(message?: string);
+}
+export declare class WessRateLimitError extends WessError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,SAAU,SAAQ,KAAK;aAGhB,UAAU,CAAC,EAAE,MAAM;aACnB,QAAQ,CAAC,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,OAAO,YAAA;CAMrC;AAED,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,OAAO,SAAoB;CAKxC;AAED,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,OAAO,SAAuB;CAK3C;AAED,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAErC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;CAMnE;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,SAA2B;CAK/C;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,SAAoB;CAKxC;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,SAAsB;CAK1C"}

package/dist/errors.js

@@ -0,0 +1,59 @@
+/**
+ * WESS SDK Error Classes
+ */
+export class WessError extends Error {
+    statusCode;
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = "WessError";
+        Object.setPrototypeOf(this, WessError.prototype);
+    }
+}
+export class WessAuthenticationError extends WessError {
+    constructor(message = "Unauthenticated") {
+        super(message, 401);
+        this.name = "WessAuthenticationError";
+        Object.setPrototypeOf(this, WessAuthenticationError.prototype);
+    }
+}
+export class WessNotFoundError extends WessError {
+    constructor(message = "Resource not found") {
+        super(message, 404);
+        this.name = "WessNotFoundError";
+        Object.setPrototypeOf(this, WessNotFoundError.prototype);
+    }
+}
+export class WessValidationError extends WessError {
+    errors;
+    constructor(message, errors = {}) {
+        super(message, 422);
+        this.name = "WessValidationError";
+        this.errors = errors;
+        Object.setPrototypeOf(this, WessValidationError.prototype);
+    }
+}
+export class WessNetworkError extends WessError {
+    constructor(message = "Network error occurred") {
+        super(message);
+        this.name = "WessNetworkError";
+        Object.setPrototypeOf(this, WessNetworkError.prototype);
+    }
+}
+export class WessTimeoutError extends WessError {
+    constructor(message = "Request timeout") {
+        super(message);
+        this.name = "WessTimeoutError";
+        Object.setPrototypeOf(this, WessTimeoutError.prototype);
+    }
+}
+export class WessRateLimitError extends WessError {
+    constructor(message = "Too many requests") {
+        super(message, 429);
+        this.name = "WessRateLimitError";
+        Object.setPrototypeOf(this, WessRateLimitError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,UAAmB,EACnB,QAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAU;QAGlC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,SAAS;IACpD,YAAY,OAAO,GAAG,iBAAiB;QACrC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,OAAO,GAAG,oBAAoB;QACxC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChC,MAAM,CAA2B;IAEjD,YAAY,OAAe,EAAE,SAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,OAAO,GAAG,wBAAwB;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,OAAO,GAAG,iBAAiB;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,OAAO,GAAG,mBAAmB;QACvC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF"}