@bates-solutions/squareup 0.2.0 → 1.1.0

package/README.md

@@ -1,7 +1,7 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/React-18+-61DAFB?logo=react&logoColor=white&style=for-the-badge" alt="React" height="28">
+  <img src="https://img.shields.io/badge/Node.js-18+-339933?logo=node.js&logoColor=white&style=for-the-badge" alt="Node.js" height="28">
   &nbsp;&nbsp;&nbsp;&nbsp;
-  <img src="https://img.shields.io/badge/Angular-17+-DD0031?logo=angular&logoColor=white&style=for-the-badge" alt="Angular" height="28">
+  <img src="https://img.shields.io/badge/TypeScript-5.0+-3178C6?logo=typescript&logoColor=white&style=for-the-badge" alt="TypeScript" height="28">
   &nbsp;&nbsp;&nbsp;&nbsp;
   <img src="https://img.shields.io/badge/Square-Payments-0066CC?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiByeD0iNCIgZmlsbD0iIzAwNjZDQyIvPgo8cGF0aCBkPSJNOC41IDEySDE1LjVWMTMuNUgxMC41VjE1SDE1LjVWMTYuNUgxMC41VjE4SDE1LjVWMTlIMFYxMkg4LjVWMTJIMFYxMkg4LjVWMTJaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K&style=for-the-badge" alt="Square" height="28">
 </p>
@@ -10,64 +10,33 @@
 
 <p align="center">
   <strong>The modern TypeScript SDK for Square payments</strong><br>
-  Build payment experiences in React and Angular with type-safe APIs, fluent builders, and framework-native integrations.
+  Build payment backends with type-safe APIs, fluent builders, and webhook support.
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.1.0-blue.svg" alt="version 0.1.0">
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
   <a href="https://typescriptlang.org"><img src="https://img.shields.io/badge/TypeScript-5.0+-blue.svg" alt="TypeScript"></a>
-  <br>
-  <img src="https://img.shields.io/badge/tests-329%20passed-brightgreen.svg" alt="Tests">
-  <img src="https://img.shields.io/badge/coverage-99.84%25-brightgreen.svg" alt="Coverage">
-  <img src="https://img.shields.io/badge/React-110%20tests-blue.svg" alt="React Tests">
-  <img src="https://img.shields.io/badge/Angular-133%20tests-red.svg" alt="Angular Tests">
 </p>
 
 ---
 
-Stop wrestling with Square's low-level APIs. **squareup** gives you React hooks, Angular services, and a fluent builder API that makes payment integration feel native to your framework. Tokenize cards, process payments, manage orders, and handle webhooks—all with full TypeScript support and zero boilerplate.
+Stop wrestling with Square's low-level APIs. **squareup** gives you a simplified client API and fluent builders that make payment integration straightforward. Process payments, manage orders, handle webhooks—all with full TypeScript support and zero boilerplate.
 
 ## Features
 
 - **Simplified APIs** - Less boilerplate, more productivity
-- **React Integration** - Hooks and components for payments
-- **Angular Integration** - Services with RxJS Observables
-- **Server Utilities** - Webhook verification and middleware
 - **Type-Safe** - Full TypeScript support with strict types
 - **Fluent Builders** - Chainable order and payment construction
-
-## 🧪 Testing & Quality
-
-**329 comprehensive tests** with **99.84% code coverage** ensure reliability and maintainability:
-
-- **React Tests (110)**: Complete coverage of hooks, components, and integrations
-- **Angular Tests (133)**: Full service testing with RxJS observables
-- **Core Tests (86)**: API clients, builders, and utilities
-- **Coverage Breakdown**:
-  - Statements: **99.84%**
-  - Branches: **95.99%**
-  - Functions: **100%**
-  - Lines: **99.84%**
-
-Run tests with:
-
-```bash
-npm test              # All tests
-npm run test:react    # React tests only
-npm run test:angular  # Angular tests only
-npm run test:coverage # With coverage report
-```
+- **Webhook Support** - Signature verification and middleware for Express/Next.js
+- **Service Classes** - Payments, Orders, Customers, Catalog, Inventory, Subscriptions, Invoices, Loyalty
 
 ## Requirements
 
 | Dependency | Version |
 | ---------- | ------- |
 | Square SDK | ^43.0.0 |
-| Node.js    | 20+     |
+| Node.js    | 22+     |
 | TypeScript | 5.0+    |
-| React      | 18+ (optional) |
-| Angular    | 17+ (optional) |
 
 ## Installation
 
@@ -75,26 +44,9 @@ npm run test:coverage # With coverage report
 npm install @bates-solutions/squareup square
 ```
 
-### Peer Dependencies
-
-```bash
-# For React integration
-npm install react
-
-# For Angular integration
-npm install @angular/core @angular/common rxjs
-```
-
-## 📚 Documentation
-
-- **[Getting Started](./docs/getting-started/)** - Installation and setup guides
-- **[Guides](./docs/guides/)** - Framework-specific tutorials and examples
-- **[API Reference](./docs/api-reference.md)** - Complete API documentation
-- **[Configuration](./docs/getting-started/configuration.md)** - Environment setup
-
 ## Quick Start
 
-### Backend
+### Basic Usage
 
 ```typescript
 import { createSquareClient } from '@bates-solutions/squareup';
@@ -104,55 +56,106 @@ const client = createSquareClient({
   environment: 'sandbox',
 });
 
+// Process a payment
 const payment = await client.payments.create({
   sourceId: 'cnon:card-nonce',
   amount: 1000, // $10.00
   currency: 'USD',
 });
+
+// Create an order with the fluent builder
+const order = await client.orders.create(
+  client.orders
+    .builder()
+    .addItem({ name: 'Coffee', quantity: 2, amount: 450 })
+    .addItem({ name: 'Muffin', quantity: 1, amount: 350 })
+    .build()
+);
+
+// Manage customers
+const customer = await client.customers.create({
+  givenName: 'John',
+  familyName: 'Doe',
+  emailAddress: 'john@example.com',
+});
 ```
 
-### React
+### Webhook Handling (Express)
 
-```tsx
-import { SquareProvider, usePayments } from '@bates-solutions/squareup/react';
+```typescript
+import express from 'express';
+import { createWebhookHandler, rawBodyMiddleware } from '@bates-solutions/squareup/server';
 
-function App() {
-  return (
-    <SquareProvider applicationId="sq0idp-xxx" locationId="LXXX" environment="sandbox">
-      <PaymentForm />
-    </SquareProvider>
-  );
-}
+const app = express();
 
-function PaymentForm() {
-  const { processPayment } = usePayments();
+// Use raw body middleware before JSON parsing for webhook routes
+app.use('/webhooks/square', rawBodyMiddleware);
+app.use(express.json());
 
-  const handlePayment = async () => {
-    const result = await processPayment({
-      sourceId: 'cnon:card-nonce',
-      amount: 1000, // $10.00
-      currency: 'USD',
-    });
-  };
+const webhookHandler = createWebhookHandler({
+  signatureKey: process.env.SQUARE_WEBHOOK_SIGNATURE_KEY!,
+});
+
+app.post('/webhooks/square', (req, res) => {
+  const event = webhookHandler.verifyAndParse(req);
+
+  switch (event.type) {
+    case 'payment.completed':
+      console.log('Payment completed:', event.data);
+      break;
+    case 'order.created':
+      console.log('Order created:', event.data);
+      break;
+  }
+
+  res.sendStatus(200);
+});
+```
+
+### Webhook Handling (Next.js)
+
+```typescript
+// app/api/webhooks/square/route.ts
+import { createWebhookHandler } from '@bates-solutions/squareup/server';
 
-  return <button onClick={handlePayment}>Pay $10.00</button>;
+const webhookHandler = createWebhookHandler({
+  signatureKey: process.env.SQUARE_WEBHOOK_SIGNATURE_KEY!,
+});
+
+export async function POST(request: Request) {
+  const body = await request.text();
+  const signature = request.headers.get('x-square-hmacsha256-signature')!;
+
+  const event = webhookHandler.verifyAndParse(body, signature);
+
+  // Handle the event
+  console.log('Received event:', event.type);
+
+  return new Response('OK', { status: 200 });
 }
 ```
 
-### Angular
+## Available Services
+
+| Service         | Description                          |
+| --------------- | ------------------------------------ |
+| `payments`      | Process and manage payments          |
+| `orders`        | Create and manage orders             |
+| `customers`     | Customer management                  |
+| `catalog`       | Product catalog operations           |
+| `inventory`     | Inventory tracking                   |
+| `subscriptions` | Subscription management              |
+| `invoices`      | Invoice operations                   |
+| `loyalty`       | Loyalty program management           |
+
+## Utilities
 
 ```typescript
-import { SquareModule } from '@bates-solutions/squareup/angular';
-
-@NgModule({
-  imports: [
-    SquareModule.forRoot({
-      accessToken: 'YOUR_ACCESS_TOKEN',
-      environment: 'sandbox',
-    }),
-  ],
-})
-export class AppModule {}
+import { toCents, fromCents, formatMoney } from '@bates-solutions/squareup';
+
+toCents(10.99);           // 1099
+fromCents(1099);          // 10.99
+formatMoney(1099, 'USD'); // "$10.99"
 ```
 
 ## Contributing

package/dist/core/services/catalog.service.d.ts

@@ -3,7 +3,32 @@ import type { CurrencyCode } from '../types/index.js';
 /**
  * Catalog item type
  */
-export type CatalogObjectType = 'ITEM' | 'ITEM_VARIATION' | 'CATEGORY' | 'DISCOUNT' | 'TAX' | 'MODIFIER' | 'MODIFIER_LIST' | 'IMAGE';
+export type CatalogObjectType = 'ITEM' | 'ITEM_VARIATION' | 'CATEGORY' | 'DISCOUNT' | 'TAX' | 'MODIFIER' | 'MODIFIER_LIST' | 'IMAGE' | 'CUSTOM_ATTRIBUTE_DEFINITION';
+/**
+ * Custom attribute value for catalog items
+ */
+export interface CatalogCustomAttributeValue {
+    name?: string;
+    stringValue?: string;
+    customAttributeDefinitionId?: string;
+    type?: 'STRING' | 'BOOLEAN' | 'NUMBER' | 'SELECTION';
+    numberValue?: string;
+    booleanValue?: boolean;
+    selectionUidValues?: string[];
+    key?: string;
+}
+/**
+ * Custom attribute definition data
+ */
+export interface CustomAttributeDefinitionData {
+    type?: 'STRING' | 'BOOLEAN' | 'NUMBER' | 'SELECTION';
+    name?: string;
+    description?: string;
+    allowedObjectTypes?: CatalogObjectType[];
+    sellerVisibility?: 'SELLER_VISIBILITY_HIDDEN' | 'SELLER_VISIBILITY_READ_WRITE_VALUES';
+    appVisibility?: 'APP_VISIBILITY_HIDDEN' | 'APP_VISIBILITY_READ_ONLY' | 'APP_VISIBILITY_READ_WRITE_VALUES';
+    key?: string;
+}
 /**
  * Catalog object from Square API
  */
@@ -15,6 +40,7 @@ export interface CatalogObject {
     isDeleted?: boolean;
     presentAtAllLocations?: boolean;
     presentAtLocationIds?: string[];
+    customAttributeValues?: Record<string, CatalogCustomAttributeValue>;
     itemData?: {
         name?: string;
         description?: string;
@@ -49,6 +75,7 @@ export interface CatalogObject {
         percentage?: string;
         inclusionType?: 'ADDITIVE' | 'INCLUSIVE';
     };
+    customAttributeDefinitionData?: CustomAttributeDefinitionData;
 }
 /**
  * Options for creating a catalog item
@@ -140,6 +167,39 @@ export declare class CatalogService {
      * ```
      */
     createCategory(options: CreateCategoryOptions): Promise<CatalogObject>;
+    /**
+     * Upsert (create or update) a catalog object
+     *
+     * @param catalogObject - The catalog object to upsert
+     * @param idempotencyKey - Optional idempotency key
+     * @returns The upserted catalog object
+     *
+     * @example
+     * ```typescript
+     * // Update an existing item's custom attributes
+     * const updatedItem = await square.catalog.upsert({
+     *   type: 'ITEM',
+     *   id: 'EXISTING_ITEM_ID',
+     *   version: existingItem.version,
+     *   customAttributeValues: {
+     *     'Square:some-key': { stringValue: 'new value' }
+     *   },
+     *   itemData: existingItem.itemData,
+     * });
+     *
+     * // Update a variation price
+     * const updatedVariation = await square.catalog.upsert({
+     *   type: 'ITEM_VARIATION',
+     *   id: 'EXISTING_VARIATION_ID',
+     *   version: existingVariation.version,
+     *   itemVariationData: {
+     *     ...existingVariation.itemVariationData,
+     *     priceMoney: { amount: BigInt(500), currency: 'USD' },
+     *   },
+     * });
+     * ```
+     */
+    upsert(catalogObject: CatalogObject, idempotencyKey?: string): Promise<CatalogObject>;
     /**
      * Get a catalog object by ID
      *

package/dist/core/services/catalog.service.d.ts.map

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

package/dist/core/services/catalog.service.js

@@ -126,6 +126,53 @@ export class CatalogService {
             throw parseSquareError(error);
         }
     }
+    /**
+     * Upsert (create or update) a catalog object
+     *
+     * @param catalogObject - The catalog object to upsert
+     * @param idempotencyKey - Optional idempotency key
+     * @returns The upserted catalog object
+     *
+     * @example
+     * ```typescript
+     * // Update an existing item's custom attributes
+     * const updatedItem = await square.catalog.upsert({
+     *   type: 'ITEM',
+     *   id: 'EXISTING_ITEM_ID',
+     *   version: existingItem.version,
+     *   customAttributeValues: {
+     *     'Square:some-key': { stringValue: 'new value' }
+     *   },
+     *   itemData: existingItem.itemData,
+     * });
+     *
+     * // Update a variation price
+     * const updatedVariation = await square.catalog.upsert({
+     *   type: 'ITEM_VARIATION',
+     *   id: 'EXISTING_VARIATION_ID',
+     *   version: existingVariation.version,
+     *   itemVariationData: {
+     *     ...existingVariation.itemVariationData,
+     *     priceMoney: { amount: BigInt(500), currency: 'USD' },
+     *   },
+     * });
+     * ```
+     */
+    async upsert(catalogObject, idempotencyKey) {
+        try {
+            const response = await this.client.catalog.object.upsert({
+                idempotencyKey: idempotencyKey ?? createIdempotencyKey(),
+                object: catalogObject,
+            });
+            if (!response.catalogObject) {
+                throw new Error('Catalog object was not upserted');
+            }
+            return response.catalogObject;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
     /**
      * Get a catalog object by ID
      *

package/dist/core/services/catalog.service.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bates-solutions/squareup",
-  "version": "0.2.0",
-  "description": "TypeScript wrapper for Square API with React & Angular integrations",
+  "version": "1.1.0",
+  "description": "TypeScript wrapper for Square API with webhook support for Node.js backends",
   "type": "module",
   "main": "./dist/core/index.js",
   "types": "./dist/core/index.d.ts",
@@ -10,14 +10,6 @@
       "types": "./dist/core/index.d.ts",
       "import": "./dist/core/index.js"
     },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js"
-    },
-    "./angular": {
-      "types": "./dist/angular/index.d.ts",
-      "import": "./dist/angular/index.js"
-    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.js"
@@ -37,8 +29,6 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "test:react": "vitest run --config vitest.react.config.ts",
-    "test:angular": "vitest run --config vitest.angular.config.ts",
     "docs": "typedoc",
     "prepublishOnly": "npm run build"
   },
@@ -47,11 +37,10 @@
     "square-api",
     "payments",
     "payment-processing",
-    "react",
-    "react-hooks",
-    "angular",
     "typescript",
-    "checkout",
+    "nodejs",
+    "backend",
+    "webhooks",
     "ecommerce",
     "point-of-sale",
     "pos",
@@ -69,53 +58,30 @@
   },
   "homepage": "https://github.com/mbates/squareup#readme",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "peerDependencies": {
-    "@angular/core": "^17.0.0 || ^18.0.0 || ^19.0.0",
-    "react": "^18.0.0 || ^19.0.0",
     "square": "^43.2.1"
   },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "@angular/core": {
-      "optional": true
-    }
-  },
   "devDependencies": {
-    "@angular/common": "^21.0.6",
-    "@angular/core": "^21.0.6",
-    "@angular/platform-browser": "^21.0.6",
-    "@angular/platform-browser-dynamic": "^21.0.6",
     "@eslint/js": "^9.39.2",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@testing-library/dom": "^10.4.1",
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.1",
     "@types/express": "^5.0.6",
     "@types/node": "^25.0.3",
-    "@types/react": "^19.2.7",
     "@typescript-eslint/eslint-plugin": "^8.51.0",
     "@typescript-eslint/parser": "^8.51.0",
     "@vitest/coverage-v8": "^4.0.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.1.0",
-    "jsdom": "^27.4.0",
     "prettier": "^3.2.0",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "rxjs": "^7.8.2",
     "semantic-release": "^25.0.2",
     "square": "^43.2.1",
     "typedoc": "^0.28.15",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.3.0",
     "typescript-eslint": "^8.51.0",
-    "vitest": "^4.0.16",
-    "zone.js": "^0.16.0"
+    "vitest": "^4.0.16"
   }
 }

package/dist/angular/__tests__/setup.d.ts

@@ -1 +0,0 @@
-//# sourceMappingURL=setup.d.ts.map

package/dist/angular/__tests__/setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/angular/__tests__/setup.ts"],"names":[],"mappings":""}

package/dist/angular/__tests__/setup.js

@@ -1,5 +0,0 @@
-"use strict";
-// Angular tests use direct instantiation and mocked NgZone,
-// so Zone.js is not required for our test setup.
-// Keeping Zone.js out avoids hanging processes in CI.
-//# sourceMappingURL=setup.js.map

package/dist/angular/__tests__/setup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/angular/__tests__/setup.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,iDAAiD;AACjD,sDAAsD"}

package/dist/angular/components/index.d.ts

@@ -1,2 +0,0 @@
-export { PaymentButtonComponent } from './payment-button.component.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/angular/components/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/angular/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/angular/components/index.js

@@ -1,2 +0,0 @@
-export { PaymentButtonComponent } from './payment-button.component.js';
-//# sourceMappingURL=index.js.map

package/dist/angular/components/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/angular/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/angular/components/payment-button.component.d.ts

@@ -1,49 +0,0 @@
-import { EventEmitter, OnInit, OnDestroy, ChangeDetectorRef } from '@angular/core';
-import { SquareSdkService } from '../services/square-sdk.service.js';
-import type { DigitalWalletOptions } from '../types.js';
-/**
- * Payment button component for Google Pay / Apple Pay
- *
- * @example
- * ```html
- * <square-payment-button
- *   type="googlePay"
- *   (payment)="onPayment($event)"
- *   (error)="onError($event)"
- * ></square-payment-button>
- *
- * <square-payment-button
- *   type="applePay"
- *   [buttonOptions]="{ buttonColor: 'black' }"
- *   (payment)="onPayment($event)"
- * ></square-payment-button>
- * ```
- */
-export declare class PaymentButtonComponent implements OnInit, OnDestroy {
-    private sdk;
-    private cdr;
-    /** Payment method type */
-    type: 'googlePay' | 'applePay';
-    /** Button styling options */
-    buttonOptions?: DigitalWalletOptions;
-    /** Emits when button is ready */
-    buttonReady: EventEmitter<void>;
-    /** Emits payment token on success */
-    payment: EventEmitter<string>;
-    /** Emits when an error occurs */
-    error: EventEmitter<Error>;
-    /** Emits when payment is cancelled */
-    cancel: EventEmitter<void>;
-    private containerRef;
-    private paymentMethod;
-    private subscription?;
-    ready: boolean;
-    loading: boolean;
-    constructor(sdk: SquareSdkService, cdr: ChangeDetectorRef);
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    handleClick(): void;
-    private initializePaymentMethod;
-    private tokenize;
-}
-//# sourceMappingURL=payment-button.component.d.ts.map

package/dist/angular/components/payment-button.component.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"payment-button.component.d.ts","sourceRoot":"","sources":["../../../src/angular/components/payment-button.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,YAAY,EAEZ,MAAM,EACN,SAAS,EAGT,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAuB,oBAAoB,EAAe,MAAM,aAAa,CAAC;AAE1F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAkBa,sBAAuB,YAAW,MAAM,EAAE,SAAS;IA6B5D,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,GAAG;IA7Bb,0BAA0B;IACjB,IAAI,EAAE,WAAW,GAAG,UAAU,CAAe;IAEtD,6BAA6B;IACpB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAE9C,iCAAiC;IACvB,WAAW,qBAA4B;IAEjD,qCAAqC;IAC3B,OAAO,uBAA8B;IAE/C,iCAAiC;IACvB,KAAK,sBAA6B;IAE5C,sCAAsC;IAC5B,MAAM,qBAA4B;IAG5C,OAAO,CAAC,YAAY,CAA2B;IAE/C,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,KAAK,UAAS;IACd,OAAO,UAAS;gBAGN,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,iBAAiB;IAGhC,QAAQ,IAAI,IAAI;IAWhB,WAAW,IAAI,IAAI;IAQnB,WAAW,IAAI,IAAI;YAQL,uBAAuB;YAyBvB,QAAQ;CA4BvB"}