@edge-base/web 0.1.1

package/README.md

@@ -0,0 +1,352 @@
+<h1 align="center">@edge-base/web</h1>
+
+<p align="center">
+  <b>Browser SDK for EdgeBase</b><br>
+  Auth, database, realtime, storage, functions, analytics, and rooms for modern web apps
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@edge-base/web"><img src="https://img.shields.io/npm/v/%40edge-base%2Fweb?color=brightgreen" alt="npm"></a>&nbsp;
+  <a href="https://edgebase.fun/docs/database/client-sdk"><img src="https://img.shields.io/badge/docs-client_sdk-blue" alt="Docs"></a>&nbsp;
+  <a href="https://github.com/edge-base/edgebase/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+</p>
+
+<p align="center">
+  React · Next.js · Vite · Vanilla TS · PWAs
+</p>
+
+<p align="center">
+  <a href="https://edgebase.fun/docs/getting-started/quickstart"><b>Quickstart</b></a> ·
+  <a href="https://edgebase.fun/docs/database/client-sdk"><b>Client SDK Docs</b></a> ·
+  <a href="https://edgebase.fun/docs/database/subscriptions"><b>Database Live</b></a> ·
+  <a href="https://edgebase.fun/docs/room/client-sdk"><b>Room Docs</b></a>
+</p>
+
+---
+
+`@edge-base/web` is the main client SDK for browser environments.
+
+It is designed for apps that need:
+
+- user authentication with session persistence
+- direct database access from the client through access rules
+- live updates with `onSnapshot()`
+- multiplayer and presence flows with rooms
+- storage uploads and file URLs
+- client-side function calls, analytics, and web push
+
+If you need privileged or server-only access, use [`@edge-base/admin`](https://www.npmjs.com/package/@edge-base/admin) instead.
+
+> Beta: the package is already usable, but some APIs may still evolve before general availability.
+
+## Documentation Map
+
+Use this README for the fast overview, then jump into the docs when you need depth:
+
+- [Quickstart](https://edgebase.fun/docs/getting-started/quickstart)
+  Create a project and run EdgeBase locally
+- [Client SDK](https://edgebase.fun/docs/database/client-sdk)
+  Full browser SDK reference and query patterns
+- [Database Subscriptions](https://edgebase.fun/docs/database/subscriptions)
+  Live queries and `onSnapshot()` patterns
+- [Authentication](https://edgebase.fun/docs/authentication)
+  Email/password, OAuth, MFA, sessions, passkeys
+- [Room Client SDK](https://edgebase.fun/docs/room/client-sdk)
+  Presence, state, members, signals, and media
+- [Functions Client SDK](https://edgebase.fun/docs/functions/client-sdk)
+  Calling EdgeBase functions from the browser
+- [Analytics Client SDK](https://edgebase.fun/docs/analytics/client-sdk)
+  Event tracking from web clients
+- [Push Client SDK](https://edgebase.fun/docs/push/client-sdk)
+  Web push registration and client-side handling
+
+## For AI Coding Assistants
+
+This package ships with an `llms.txt` file for AI-assisted development.
+
+Use it when you want an agent or code assistant to:
+
+- avoid common API mistakes
+- use the correct method signatures
+- choose the right database and auth patterns
+- prefer the documented EdgeBase flow instead of guessing
+
+You can find it:
+
+- in this package after install: `node_modules/@edge-base/web/llms.txt`
+- in the repository: [llms.txt](https://github.com/edge-base/edgebase/blob/main/packages/sdk/js/packages/web/llms.txt)
+
+For deeper behavioral details, pair `llms.txt` with the docs linked above.
+
+## Why This Package
+
+Most browser SDKs stop at auth + CRUD.
+
+`@edge-base/web` is meant to be the single browser entry point for the whole EdgeBase app surface:
+
+| Capability | Included |
+|---|---|
+| Auth | Email/password, OAuth, sessions, auth state |
+| Database | Query, insert, update, delete |
+| Database Live | `onSnapshot()` subscriptions |
+| Rooms | Presence, room state, signals, media-ready client surface |
+| Storage | Uploads, bucket access, file URLs |
+| Functions | Call EdgeBase functions from the browser |
+| Analytics | Client-side analytics helpers |
+| Push | Web push registration and message handling |
+
+## Installation
+
+```bash
+npm install @edge-base/web
+```
+
+Starting a brand new project?
+
+```bash
+npm create edge-base@latest my-app
+```
+
+That scaffold creates a full EdgeBase app and wires in the local CLI for development and deployment.
+
+Read more: [Quickstart](https://edgebase.fun/docs/getting-started/quickstart)
+
+## Recommended Project Layout
+
+If you already have a frontend app, a good default is to create EdgeBase inside that project as a dedicated subdirectory:
+
+```bash
+cd your-frontend-project
+npm create edge-base@latest edgebase
+```
+
+That gives you a layout like:
+
+```text
+your-frontend-project/
+  src/
+  app/
+  package.json
+  edgebase/
+    edgebase.config.ts
+    functions/
+    package.json
+```
+
+This is only a recommendation, not a requirement.
+
+You can also:
+
+- create EdgeBase as a completely separate project
+- keep frontend and backend in different repos
+- use a different subdirectory name if that fits your monorepo better
+
+The main thing we recommend is avoiding scaffolding directly into an existing app root unless that is intentionally how you want to organize the repo.
+
+## Quick Start
+
+```ts
+import { createClient } from '@edge-base/web';
+
+const client = createClient('https://your-project.edgebase.fun');
+
+await client.auth.signIn({
+  email: 'june@example.com',
+  password: 'pass1234',
+});
+
+const posts = await client
+  .db('app')
+  .table('posts')
+  .where('published', '==', true)
+  .orderBy('createdAt', 'desc')
+  .limit(10)
+  .getList();
+
+const health = await client.functions.get('health');
+
+console.log(posts.items, health);
+```
+
+`app` in the example above is your database block name from `edgebase.config.ts`.
+
+For instance databases, pass both a namespace and an id:
+
+```ts
+client.db('workspace', 'ws-123');
+client.db('user', 'user-123');
+```
+
+Read more: [Client SDK](https://edgebase.fun/docs/database/client-sdk)
+
+## Core API
+
+Once you create a client, these are the main surfaces you will use:
+
+- `client.auth`
+  Sign up, sign in, sign out, OAuth, MFA flows, and auth state listeners
+- `client.db(namespace, id?)`
+  Query tables, mutate records, and subscribe to live changes
+- `client.storage`
+  Upload files and resolve bucket URLs
+- `client.functions`
+  Call app functions from the browser
+- `client.room(namespace, roomId)`
+  Join realtime rooms for presence, state sync, and signals
+- `client.analytics`
+  Send analytics data from the client
+- `client.push`
+  Register and manage web push flows
+
+## Auth
+
+### Email and password
+
+```ts
+await client.auth.signUp({
+  email: 'june@example.com',
+  password: 'pass1234',
+  data: {
+    displayName: 'June',
+  },
+});
+
+await client.auth.signIn({
+  email: 'june@example.com',
+  password: 'pass1234',
+});
+
+client.auth.onAuthStateChange((user) => {
+  console.log('auth changed:', user);
+});
+```
+
+### OAuth
+
+```ts
+await client.auth.signInWithOAuth('google');
+
+const result = await client.auth.handleOAuthCallback();
+if (result) {
+  console.log('signed in with OAuth:', result.user);
+}
+```
+
+By default, the browser SDK uses `/auth/callback` on the current origin as the redirect target.
+
+Read more: [Authentication Docs](https://edgebase.fun/docs/authentication)
+
+## Database Queries
+
+```ts
+type Post = {
+  id: string;
+  title: string;
+  published: boolean;
+  createdAt: string;
+};
+
+const posts = client.db('app').table<Post>('posts');
+
+const latest = await posts
+  .where('published', '==', true)
+  .orderBy('createdAt', 'desc')
+  .limit(20)
+  .getList();
+
+await posts.insert({
+  title: 'Hello EdgeBase',
+  published: true,
+});
+```
+
+Read more: [Database Client SDK](https://edgebase.fun/docs/database/client-sdk)
+
+## Database Live
+
+```ts
+const unsubscribe = client
+  .db('app')
+  .table('posts')
+  .onSnapshot((change) => {
+    console.log(change.changeType, change.data);
+  });
+
+// later
+unsubscribe();
+```
+
+Use this for feeds, counters, collaborative UIs, moderation dashboards, or any UI that should react instantly to server-side changes.
+
+Read more: [Database Subscriptions](https://edgebase.fun/docs/database/subscriptions)
+
+## Storage
+
+```ts
+const bucket = client.storage.bucket('avatars');
+
+await bucket.upload('me.jpg', file);
+
+const publicUrl = bucket.getUrl('me.jpg');
+console.log(publicUrl);
+```
+
+Read more: [Storage Docs](https://edgebase.fun/docs/storage)
+
+## Functions
+
+```ts
+const result = await client.functions.post('contact/send', {
+  email: 'june@example.com',
+  message: 'Hello from the web SDK',
+});
+
+console.log(result);
+```
+
+Read more: [Functions Client SDK](https://edgebase.fun/docs/functions/client-sdk)
+
+## Rooms
+
+```ts
+const room = client.room('game', 'lobby-1');
+
+await room.join();
+
+room.leave();
+```
+
+Use rooms when you need:
+
+- presence
+- room state
+- peer signals
+- multiplayer coordination
+- media/session-style realtime flows
+
+Read more: [Room Client SDK](https://edgebase.fun/docs/room/client-sdk)
+
+## Which EdgeBase Package Should You Use?
+
+| Package | Use it when |
+|---|---|
+| `@edge-base/web` | You are in the browser or another untrusted client runtime |
+| `@edge-base/admin` | You need trusted server/admin access |
+| `@edge-base/ssr` | You want cookie-based SSR helpers for frameworks like Next.js |
+| `@edge-base/auth-ui-react` | You want headless React auth UI built on top of the web SDK |
+| `@edge-base/react-native` | You are building a React Native app |
+
+## Docs
+
+- [Quickstart](https://edgebase.fun/docs/getting-started/quickstart)
+- [Client SDK](https://edgebase.fun/docs/database/client-sdk)
+- [Database Live](https://edgebase.fun/docs/database/subscriptions)
+- [Room Client SDK](https://edgebase.fun/docs/room/client-sdk)
+- [Authentication Docs](https://edgebase.fun/docs/authentication)
+- [Functions Client SDK](https://edgebase.fun/docs/functions/client-sdk)
+- [Analytics Client SDK](https://edgebase.fun/docs/analytics/client-sdk)
+- [Push Client SDK](https://edgebase.fun/docs/push/client-sdk)
+
+## License
+
+MIT

package/dist/analytics.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ClientAnalytics — Browser-side custom event tracking for Client SDK
+ *
+ * Optimized for browser:
+ * - Batches events in memory (max 20 or 5s timer, whichever comes first)
+ * - Uses sendBeacon on page unload to avoid losing events
+ * - Auto-retries failed flushes once by re-queuing
+ *
+ * Usage:
+ *   const client = createClient('https://my-app.edgebase.fun');
+ *   client.analytics.track('page_view', { path: '/pricing' });
+ *   client.analytics.track('button_click', { id: 'signup-cta', variant: 'A' });
+ *
+ *   // Manual flush if needed
+ *   await client.analytics.flush();
+ */
+import { type HttpClient, type GeneratedDbApi } from '@edge-base/core';
+export declare class ClientAnalytics {
+    private httpClient;
+    private baseUrl;
+    private core?;
+    private queue;
+    private timer;
+    private readonly FLUSH_INTERVAL;
+    private readonly MAX_BATCH;
+    private boundVisibilityHandler;
+    private boundPageHideHandler;
+    constructor(httpClient: HttpClient, baseUrl: string, core?: GeneratedDbApi | undefined);
+    /**
+     * Track a custom event. Events are batched and sent automatically.
+     *
+     * @param name       Event name (e.g. 'page_view', 'button_click', 'purchase')
+     * @param properties Optional key-value data (max 50 keys, max 4KB total)
+     *
+     * @example
+     * client.analytics.track('page_view', { path: '/pricing' });
+     * client.analytics.track('purchase', { plan: 'pro', amount: 29.99 });
+     */
+    track(name: string, properties?: Record<string, string | number | boolean>): void;
+    /**
+     * Manually flush all queued events to the server.
+     * Automatically called on timer expiry, batch size reached, or page unload.
+     */
+    flush(): Promise<void>;
+    /**
+     * Send remaining events via navigator.sendBeacon (used on page unload).
+     * sendBeacon cannot send Authorization headers, so these events arrive
+     * without JWT auth — protected by rate limiting only.
+     *
+     * NOTE: Direct HTTP — sendBeacon requires a raw URL + Blob. Cannot use
+     * generated core because sendBeacon bypasses normal fetch/XHR entirely.
+     */
+    private sendBeacon;
+    /**
+     * Destroy the analytics client. Flushes remaining events and removes
+     * event listeners. Call this when unmounting the SDK.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAY,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQjF,qBAAa,eAAe;IAUxB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI,CAAC;IAXf,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAM;IAEhC,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,oBAAoB,CAA6B;gBAG/C,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,cAAc,YAAA;IAc/B;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAUjF;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAoBlB;;;OAGG;IACH,OAAO,IAAI,IAAI;CAiBhB"}

package/dist/analytics.js

@@ -0,0 +1,146 @@
+/**
+ * ClientAnalytics — Browser-side custom event tracking for Client SDK
+ *
+ * Optimized for browser:
+ * - Batches events in memory (max 20 or 5s timer, whichever comes first)
+ * - Uses sendBeacon on page unload to avoid losing events
+ * - Auto-retries failed flushes once by re-queuing
+ *
+ * Usage:
+ *   const client = createClient('https://my-app.edgebase.fun');
+ *   client.analytics.track('page_view', { path: '/pricing' });
+ *   client.analytics.track('button_click', { id: 'signup-cta', variant: 'A' });
+ *
+ *   // Manual flush if needed
+ *   await client.analytics.flush();
+ */
+import { ApiPaths } from '@edge-base/core';
+export class ClientAnalytics {
+    httpClient;
+    baseUrl;
+    core;
+    queue = [];
+    timer = null;
+    FLUSH_INTERVAL = 5_000; // 5 seconds
+    MAX_BATCH = 20; // 20 events per batch
+    boundVisibilityHandler = null;
+    boundPageHideHandler = null;
+    constructor(httpClient, baseUrl, core) {
+        this.httpClient = httpClient;
+        this.baseUrl = baseUrl;
+        this.core = core;
+        // Send remaining events on page unload
+        if (typeof window !== 'undefined') {
+            this.boundVisibilityHandler = () => {
+                if (document.visibilityState === 'hidden')
+                    this.sendBeacon();
+            };
+            this.boundPageHideHandler = () => this.sendBeacon();
+            window.addEventListener('visibilitychange', this.boundVisibilityHandler);
+            window.addEventListener('pagehide', this.boundPageHideHandler);
+        }
+    }
+    /**
+     * Track a custom event. Events are batched and sent automatically.
+     *
+     * @param name       Event name (e.g. 'page_view', 'button_click', 'purchase')
+     * @param properties Optional key-value data (max 50 keys, max 4KB total)
+     *
+     * @example
+     * client.analytics.track('page_view', { path: '/pricing' });
+     * client.analytics.track('purchase', { plan: 'pro', amount: 29.99 });
+     */
+    track(name, properties) {
+        this.queue.push({ name, properties, timestamp: Date.now() });
+        if (this.queue.length >= this.MAX_BATCH) {
+            void this.flush();
+        }
+        else if (!this.timer) {
+            this.timer = setTimeout(() => void this.flush(), this.FLUSH_INTERVAL);
+        }
+    }
+    /**
+     * Manually flush all queued events to the server.
+     * Automatically called on timer expiry, batch size reached, or page unload.
+     */
+    async flush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (!this.queue.length)
+            return;
+        const batch = this.queue.splice(0, this.MAX_BATCH);
+        try {
+            const payload = {
+                events: batch.map(e => ({
+                    name: e.name,
+                    properties: e.properties,
+                    timestamp: e.timestamp,
+                })),
+            };
+            if (this.core) {
+                await this.core.trackEvents(payload);
+            }
+            else {
+                await this.httpClient.post(ApiPaths.TRACK_EVENTS, payload);
+            }
+        }
+        catch {
+            // Failed — re-queue for one retry (don't retry infinitely)
+            this.queue.unshift(...batch);
+        }
+        // If there are still events in the queue, schedule another flush
+        if (this.queue.length > 0 && !this.timer) {
+            this.timer = setTimeout(() => void this.flush(), this.FLUSH_INTERVAL);
+        }
+    }
+    /**
+     * Send remaining events via navigator.sendBeacon (used on page unload).
+     * sendBeacon cannot send Authorization headers, so these events arrive
+     * without JWT auth — protected by rate limiting only.
+     *
+     * NOTE: Direct HTTP — sendBeacon requires a raw URL + Blob. Cannot use
+     * generated core because sendBeacon bypasses normal fetch/XHR entirely.
+     */
+    sendBeacon() {
+        if (!this.queue.length)
+            return;
+        const batch = this.queue.splice(0);
+        const url = `${this.baseUrl}${ApiPaths.TRACK_EVENTS}`;
+        const body = JSON.stringify({
+            events: batch.map(e => ({
+                name: e.name,
+                properties: e.properties,
+                timestamp: e.timestamp,
+            })),
+        });
+        try {
+            navigator.sendBeacon(url, new Blob([body], { type: 'application/json' }));
+        }
+        catch {
+            // sendBeacon failed — page is unloading, nothing we can do
+        }
+    }
+    /**
+     * Destroy the analytics client. Flushes remaining events and removes
+     * event listeners. Call this when unmounting the SDK.
+     */
+    destroy() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.sendBeacon();
+        // Remove event listeners
+        if (typeof window !== 'undefined') {
+            if (this.boundVisibilityHandler) {
+                window.removeEventListener('visibilitychange', this.boundVisibilityHandler);
+            }
+            if (this.boundPageHideHandler) {
+                window.removeEventListener('pagehide', this.boundPageHideHandler);
+            }
+        }
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

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

package/dist/auth-refresh.d.ts

@@ -0,0 +1,5 @@
+export declare function refreshAccessToken(baseUrl: string, refreshToken: string): Promise<{
+    accessToken: string;
+    refreshToken: string;
+}>;
+//# sourceMappingURL=auth-refresh.d.ts.map

package/dist/auth-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-refresh.d.ts","sourceRoot":"","sources":["../src/auth-refresh.ts"],"names":[],"mappings":"AAQA,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IACvF,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAgCD"}

package/dist/auth-refresh.js

@@ -0,0 +1,26 @@
+import { EdgeBaseError } from '@edge-base/core';
+export async function refreshAccessToken(baseUrl, refreshToken) {
+    let response;
+    try {
+        response = await fetch(`${baseUrl.replace(/\/$/, '')}/api/auth/refresh`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ refreshToken }),
+        });
+    }
+    catch (error) {
+        throw new EdgeBaseError(0, `Network error: ${error instanceof Error ? error.message : 'Failed to refresh access token.'}`);
+    }
+    const body = await response.json().catch(() => null);
+    if (!response.ok) {
+        throw new EdgeBaseError(response.status, typeof body?.message === 'string' ? body.message : 'Failed to refresh access token.');
+    }
+    if (!body?.accessToken || !body?.refreshToken) {
+        throw new EdgeBaseError(500, 'Invalid auth refresh response.');
+    }
+    return {
+        accessToken: body.accessToken,
+        refreshToken: body.refreshToken,
+    };
+}
+//# sourceMappingURL=auth-refresh.js.map

package/dist/auth-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-refresh.js","sourceRoot":"","sources":["../src/auth-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQhD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAe,EAAE,YAAoB;IAI5E,IAAI,QAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,EAAE;YACvE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CACrB,CAAC,EACD,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,EAAE,CAC/F,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAA2B,CAAC;IAC/E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,aAAa,CACrB,QAAQ,CAAC,MAAM,EACf,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CACrF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;QAC9C,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC"}