@ticketlayer/live 0.2.0

package/dist/core/liveClient.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Runtime-neutral core of the Live client.
+ *
+ * Nothing in this module reads `window`, `document` or `location`: it is the
+ * shared state layer (session, cart, auth, orders, the event bus) that both
+ * adapters build on - `createLiveClient` (browser: cookie or token transport,
+ * page defaults, window publishing, modals) and `createNativeLiveClient`
+ * (React Native: injected token storage, X-Live-Session header, no page).
+ * `theme.apply()` delegates to applyTheme, which is a no-op without a document.
+ */
+import { LiveClient } from '../client.js';
+import { type LiveEvent } from '../state/emitter.js';
+/**
+ * Stateful ergonomic layer over the generated LiveClient.
+ *
+ * The generated client is stateless REST; Elements and HBO need a stateful,
+ * reactive surface (a session-owned cart, cart:updated events, theme
+ * application, auth state). This class provides that, COORDINATING with the
+ * live-api session - which owns the cartId server-side - rather than holding a
+ * second source of truth: on start it loads the session's existing cart, and
+ * cart mutations both update local state AND ride the same session upstream.
+ */
+export interface SessionState {
+    channelId: string | null;
+    customer: unknown | null;
+    authenticated: boolean;
+}
+/** Result of redeeming a presale/promo code (POST /sales/presale-codes/redeem). */
+export interface PresaleRedemption {
+    benefit: string;
+    alreadyHeld: boolean;
+}
+export interface CartItemInput {
+    eventOccurrenceId: string;
+    categoryId: string;
+    ticketTypeId: string;
+    quantity?: number;
+    eventLayoutAreaId?: string;
+    eventLayoutSeatIds?: string[];
+}
+export declare class TicketlayerLive {
+    /** The underlying generated client (escape hatch for un-wrapped calls). */
+    readonly client: LiveClient;
+    private emitter;
+    private sessionMode;
+    private publishableKey;
+    private domain;
+    private baseUrl;
+    private _sessionStarted;
+    private _sessionStarting;
+    private _session;
+    private _cart;
+    private _cartId;
+    readonly events: {
+        list: () => Promise<unknown>;
+        get: (eventId: string) => Promise<unknown>;
+    };
+    readonly theme: {
+        get: () => Promise<unknown>;
+        apply: () => Promise<unknown>;
+    };
+    readonly cart: {
+        readonly current: unknown | null;
+        readonly id: string | null;
+        ensure: () => Promise<string>;
+        add: (item: CartItemInput) => Promise<unknown>;
+        remove: (itemId: string) => Promise<unknown>;
+        refresh: () => Promise<unknown>;
+        checkout: (opts?: {
+            customerNotes?: string;
+        }) => Promise<unknown>;
+    };
+    readonly auth: {
+        readonly customer: unknown | null;
+        readonly authenticated: boolean;
+        requestMagicLink: (contact: {
+            email?: string;
+            phone?: string;
+        }) => Promise<unknown>;
+        exchange: (proof: string | {
+            type: string;
+            code?: string;
+            assertion?: string;
+        }) => Promise<unknown>;
+        logout: () => Promise<void>;
+    };
+    readonly orders: {
+        mine: () => Promise<unknown>;
+        get: (orderId: string) => Promise<unknown>;
+        ticketPdf: (orderId: string, passId: string) => Promise<Blob>;
+    };
+    readonly payments: {
+        begin: (orderId: string, opts?: {
+            paymentType?: string;
+            returnUrl?: string;
+        }) => Promise<unknown>;
+    };
+    readonly presale: {
+        redeem: (code: string) => Promise<PresaleRedemption>;
+    };
+    readonly queue: {
+        status: () => Promise<unknown>;
+        join: () => Promise<unknown>;
+    };
+    constructor(client: LiveClient, opts: {
+        sessionMode: 'cookie' | 'token';
+        publishableKey?: string;
+        domain?: string;
+        baseUrl: string;
+    });
+    /** Subscribe to a state event or UI intent; returns an unsubscribe fn. */
+    on(event: LiveEvent, handler: (payload?: unknown) => void): () => void;
+    off(event: LiveEvent, handler: (payload?: unknown) => void): void;
+    /**
+     * Push an event onto the shared bus. Used by Elements/host to raise UI
+     * intents (e.g. ui:checkout-requested) that the host app acts on - the SDK
+     * relays but does not render UI itself.
+     */
+    emit(event: LiveEvent, payload?: unknown): void;
+    get session(): Readonly<SessionState>;
+    /** True once a session has been created/resumed (i.e. a mutation has happened). */
+    get hasSession(): boolean;
+    /**
+     * Create the Live session on demand and hydrate state - idempotent and
+     * single-flight. Called lazily before the first mutation (cart/login); NOT on
+     * page load, so browsing never creates a session. Channel is identified by the
+     * publishable key (embed) or the storefront domain (hosted).
+     */
+    ensureSession(): Promise<void>;
+    /** @deprecated Use ensureSession(); kept for back-compat. */
+    start(opts?: {
+        domain?: string;
+    }): Promise<void>;
+    /**
+     * Rehydrate an ALREADY-EXISTING session (hosted/cookie transport) without
+     * creating one. On a page load/refresh the client is lazily session-less, but
+     * a returning visitor may still hold the `live_session` cookie with a cart
+     * server-side. This probes `GET /session` (a cheap read - it 401s when no
+     * session exists, and never writes one): on success it binds this client to
+     * that session and pulls the cart back in; on 401 it stays session-less so
+     * browsing still creates no session. Marking `_sessionStarted` on success is
+     * load-bearing - otherwise the next mutation's ensureSession() would POST a
+     * fresh session and orphan the existing cart.
+     *
+     * @returns true if an existing session was resumed.
+     */
+    resumeIfExists(): Promise<boolean>;
+    /**
+     * Resume an EXISTING session by token instead of bootstrapping a new one.
+     * Used by the embedded checkout iframe: the third-party page hands off its
+     * session token so the iframe sees the same cart/channel (token transport).
+     */
+    resume(token: string): Promise<void>;
+    /** The current session token (token mode), for handing off to an embed iframe. */
+    getSessionToken(): Promise<string | null>;
+    /** Re-read session state (customer, auth, cart) from the live-api session. */
+    refreshSession(): Promise<void>;
+    /**
+     * Forget that a session was started, so the next mutation or sign-in mints a
+     * fresh one. For adapters whose process outlives the session (a native app
+     * signing out, a stored token the API rejected); a browser page reloads instead.
+     */
+    protected _resetSessionStarted(): void;
+    private _setCart;
+    /**
+     * True when an API error means the server-side cart is no longer usable -
+     * it expired (reservation TTL lapsed), was already checked out, or can't be
+     * found. The SDK holds the cartId in memory and rehydrates it from the
+     * server session on load, so a lapsed cart would otherwise wedge every
+     * subsequent add/remove/checkout with a 409.
+     */
+    private _isCartGone;
+    /** Forget all local cart state and notify subscribers the cart is now empty. */
+    private _resetCart;
+}
+//# sourceMappingURL=liveClient.d.ts.map

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

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

package/dist/core/liveClient.js

@@ -0,0 +1,372 @@
+/**
+ * Runtime-neutral core of the Live client.
+ *
+ * Nothing in this module reads `window`, `document` or `location`: it is the
+ * shared state layer (session, cart, auth, orders, the event bus) that both
+ * adapters build on - `createLiveClient` (browser: cookie or token transport,
+ * page defaults, window publishing, modals) and `createNativeLiveClient`
+ * (React Native: injected token storage, X-Live-Session header, no page).
+ * `theme.apply()` delegates to applyTheme, which is a no-op without a document.
+ */
+import { LiveAPIError } from '../client.js';
+import { Emitter } from '../state/emitter.js';
+import { applyTheme } from '../state/theme.js';
+/**
+ * Pull a named field from a response, tolerating the generator's
+ * single-property auto-unwrapping: some methods return `{ cart }`, others
+ * already return the cart itself. If `key` is present we use it; otherwise the
+ * value is assumed to be the already-unwrapped payload.
+ */
+const field = (obj, key) => {
+    if (obj && typeof obj === 'object' && !Array.isArray(obj) && key in obj) {
+        return obj[key];
+    }
+    return obj;
+};
+export class TicketlayerLive {
+    constructor(client, opts) {
+        this.emitter = new Emitter();
+        // A session is created LAZILY - only when something mutates state (cart/login).
+        // Browsing uses the publishable key as read auth, so most visitors never get
+        // a session (no per-visitor Redis write).
+        this._sessionStarted = false;
+        this._sessionStarting = null;
+        this._session = { channelId: null, customer: null, authenticated: false };
+        this._cart = null;
+        this._cartId = null;
+        this.client = client;
+        this.sessionMode = opts.sessionMode;
+        this.publishableKey = opts.publishableKey;
+        this.domain = opts.domain;
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        const self = this;
+        this.events = {
+            list: () => self.client.salesListings.list(),
+            get: (eventId) => self.client.sales.get(eventId).then((d) => field(d, 'event')),
+        };
+        this.theme = {
+            get: () => self.client.sales.getTheme().then((d) => field(d, 'theme')),
+            apply: async () => {
+                const theme = await self.theme.get();
+                applyTheme(theme);
+                return theme;
+            },
+        };
+        this.cart = {
+            get current() {
+                return self._cart;
+            },
+            get id() {
+                return self._cartId;
+            },
+            ensure: async () => {
+                if (!self._cartId) {
+                    // First mutation → create the session lazily, then the cart.
+                    await self.ensureSession();
+                    const res = await self.client.salesCarts.create({});
+                    const cart = field(res, 'cart');
+                    self._cartId = cart?.id ?? null;
+                    self._setCart(cart);
+                }
+                return self._cartId;
+            },
+            add: async (item) => {
+                const id = await self.cart.ensure();
+                try {
+                    const res = await self.client.salesCarts.addItem(id, item);
+                    self._setCart(field(res, 'cart'));
+                    return self._cart;
+                }
+                catch (err) {
+                    if (!self._isCartGone(err))
+                        throw err;
+                    // The server-side reservation lapsed under us. Drop the dead cart,
+                    // mint a fresh one and re-add - adding tickets should just work.
+                    self._resetCart();
+                    const freshId = await self.cart.ensure();
+                    const res = await self.client.salesCarts.addItem(freshId, item);
+                    self._setCart(field(res, 'cart'));
+                    return self._cart;
+                }
+            },
+            remove: async (itemId) => {
+                if (!self._cartId)
+                    return self._cart;
+                try {
+                    const res = await self.client.salesCarts.removeItem(self._cartId, itemId);
+                    self._setCart(field(res, 'cart'));
+                    return self._cart;
+                }
+                catch (err) {
+                    if (!self._isCartGone(err))
+                        throw err;
+                    // Nothing to remove from an expired cart - clear it locally and let
+                    // the UI fall through to an empty cart rather than surfacing an error.
+                    self._resetCart();
+                    return self._cart;
+                }
+            },
+            refresh: async () => {
+                if (!self._cartId)
+                    return self._cart;
+                try {
+                    const res = await self.client.salesCarts.get(self._cartId);
+                    self._setCart(field(res, 'cart'));
+                    return self._cart;
+                }
+                catch (err) {
+                    if (!self._isCartGone(err))
+                        throw err;
+                    // A stale cartId carried in from a prior session/page load. Forget it
+                    // so the next mutation starts a clean cart.
+                    self._resetCart();
+                    return self._cart;
+                }
+            },
+            checkout: async (opts = {}) => {
+                if (!self._cartId)
+                    throw new Error('No cart to check out');
+                try {
+                    const res = await self.client.salesCarts.checkout(self._cartId, opts);
+                    self._cartId = null;
+                    self._setCart(null);
+                    self.emitter.emit('checkout:completed', field(res, 'order'));
+                    return res; // { cart, order, orderAccessToken }
+                }
+                catch (err) {
+                    if (!self._isCartGone(err))
+                        throw err;
+                    // Can't check out an expired cart - clear it and surface a clear,
+                    // actionable error instead of the raw 409.
+                    self._resetCart();
+                    throw new LiveAPIError('Your cart has expired. Please add your tickets again.', 'CART_EXPIRED', 409);
+                }
+            },
+        };
+        this.auth = {
+            get customer() {
+                return self._session.customer;
+            },
+            get authenticated() {
+                return self._session.authenticated;
+            },
+            requestMagicLink: (contact) => self.client.salesCustomerAuth.magicLink(contact),
+            exchange: async (proof) => {
+                // Exchanging a proof binds a customer to THIS session → ensure one exists.
+                await self.ensureSession();
+                const body = typeof proof === 'string' ? { type: 'magic_link', code: proof } : proof;
+                const res = await self.client.salesCustomerTokens.create({ proof: body });
+                self._session = {
+                    ...self._session,
+                    customer: field(res, 'customer') ?? null,
+                    authenticated: true,
+                };
+                self.emitter.emit('auth:changed', self._session);
+                return res;
+            },
+            logout: async () => {
+                await self.client.session.end().catch(() => undefined);
+                self._session = { channelId: self._session.channelId, customer: null, authenticated: false };
+                self._cart = null;
+                self._cartId = null;
+                self.emitter.emit('auth:changed', self._session);
+            },
+        };
+        this.orders = {
+            mine: () => self.client.salesMyOrders.list().then((d) => field(d, 'orders')),
+            get: (orderId) => self.client.salesOrders.get(orderId).then((d) => field(d, 'order')),
+            // Binary download - bypasses the generated (JSON) client; fetches the PDF
+            // with the same session credentials.
+            ticketPdf: async (orderId, passId) => {
+                const headers = {};
+                if (self.publishableKey)
+                    headers['Authorization'] = `Bearer ${self.publishableKey}`;
+                if (self.sessionMode === 'token') {
+                    const token = await self.client.getSessionToken();
+                    if (token)
+                        headers['X-Live-Session'] = token;
+                }
+                const res = await fetch(`${self.baseUrl}/sales/orders/${orderId}/passes/${passId}/ticket.pdf`, { headers, credentials: self.sessionMode === 'cookie' ? 'include' : 'same-origin' });
+                if (!res.ok)
+                    throw new LiveAPIError(`Failed to download ticket (${res.status})`, 'TICKET_PDF_FAILED', res.status);
+                return res.blob();
+            },
+        };
+        this.payments = {
+            begin: (orderId, opts = {}) => self.client.salesOrderPayments.create(orderId, opts).then((d) => field(d, 'payment')),
+        };
+        this.presale = {
+            // POST /sales/presale-codes/redeem - needs a signed-in customer. Gated
+            // pricing unlocks immediately, so re-read the cart and let cart:updated
+            // carry the new totals to subscribers. A failed refresh must not undo a
+            // redemption that already succeeded.
+            redeem: async (code) => {
+                const res = (await self.client.salesPresaleCodes.redeem({ code: code.trim() }));
+                if (self._cartId)
+                    await self.cart.refresh().catch(() => undefined);
+                return res;
+            },
+        };
+        this.queue = {
+            status: () => self.client.queue.status(),
+            join: () => self.client.queue.join(),
+        };
+    }
+    /** Subscribe to a state event or UI intent; returns an unsubscribe fn. */
+    on(event, handler) {
+        return this.emitter.on(event, handler);
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+    /**
+     * Push an event onto the shared bus. Used by Elements/host to raise UI
+     * intents (e.g. ui:checkout-requested) that the host app acts on - the SDK
+     * relays but does not render UI itself.
+     */
+    emit(event, payload) {
+        this.emitter.emit(event, payload);
+    }
+    get session() {
+        return this._session;
+    }
+    /** True once a session has been created/resumed (i.e. a mutation has happened). */
+    get hasSession() {
+        return this._sessionStarted;
+    }
+    /**
+     * Create the Live session on demand and hydrate state - idempotent and
+     * single-flight. Called lazily before the first mutation (cart/login); NOT on
+     * page load, so browsing never creates a session. Channel is identified by the
+     * publishable key (embed) or the storefront domain (hosted).
+     */
+    async ensureSession() {
+        if (this._sessionStarted)
+            return;
+        if (this._sessionStarting)
+            return this._sessionStarting;
+        this._sessionStarting = (async () => {
+            // Embed (token transport) authenticates the session by publishable key;
+            // hosted (cookie transport) by storefront domain.
+            const startBody = {};
+            if (this.sessionMode === 'token' && this.publishableKey) {
+                startBody.channelKey = this.publishableKey;
+            }
+            else if (this.domain) {
+                startBody.domain = this.domain;
+            }
+            else if (this.publishableKey) {
+                startBody.channelKey = this.publishableKey;
+            }
+            const started = await this.client.session.start(startBody);
+            if (this.sessionMode === 'token') {
+                const token = field(started, 'sessionToken');
+                if (token)
+                    await this.client.setSessionToken(token);
+            }
+            this._sessionStarted = true;
+            await this.refreshSession();
+        })();
+        try {
+            await this._sessionStarting;
+        }
+        finally {
+            this._sessionStarting = null;
+        }
+    }
+    /** @deprecated Use ensureSession(); kept for back-compat. */
+    async start(opts = {}) {
+        if (opts.domain)
+            this.domain = opts.domain;
+        return this.ensureSession();
+    }
+    /**
+     * Rehydrate an ALREADY-EXISTING session (hosted/cookie transport) without
+     * creating one. On a page load/refresh the client is lazily session-less, but
+     * a returning visitor may still hold the `live_session` cookie with a cart
+     * server-side. This probes `GET /session` (a cheap read - it 401s when no
+     * session exists, and never writes one): on success it binds this client to
+     * that session and pulls the cart back in; on 401 it stays session-less so
+     * browsing still creates no session. Marking `_sessionStarted` on success is
+     * load-bearing - otherwise the next mutation's ensureSession() would POST a
+     * fresh session and orphan the existing cart.
+     *
+     * @returns true if an existing session was resumed.
+     */
+    async resumeIfExists() {
+        if (this._sessionStarted)
+            return true;
+        try {
+            await this.refreshSession();
+            this._sessionStarted = true;
+            return true;
+        }
+        catch {
+            // 401 NO_SESSION (or transient) → no session to resume; remain lazy.
+            return false;
+        }
+    }
+    /**
+     * Resume an EXISTING session by token instead of bootstrapping a new one.
+     * Used by the embedded checkout iframe: the third-party page hands off its
+     * session token so the iframe sees the same cart/channel (token transport).
+     */
+    async resume(token) {
+        await this.client.setSessionToken(token);
+        this._sessionStarted = true;
+        await this.refreshSession();
+    }
+    /** The current session token (token mode), for handing off to an embed iframe. */
+    getSessionToken() {
+        return this.client.getSessionToken();
+    }
+    /** Re-read session state (customer, auth, cart) from the live-api session. */
+    async refreshSession() {
+        const cur = await this.client.session.current();
+        this._session = {
+            channelId: field(cur, 'channel')?.id ?? null,
+            customer: field(cur, 'customer') ?? null,
+            authenticated: !!field(cur, 'authenticated'),
+        };
+        const cartId = field(cur, 'cartId') ?? null;
+        if (cartId) {
+            this._cartId = cartId;
+            await this.cart.refresh();
+        }
+        this.emitter.emit('session:changed', this._session);
+    }
+    /**
+     * Forget that a session was started, so the next mutation or sign-in mints a
+     * fresh one. For adapters whose process outlives the session (a native app
+     * signing out, a stored token the API rejected); a browser page reloads instead.
+     */
+    _resetSessionStarted() {
+        this._sessionStarted = false;
+        this._sessionStarting = null;
+    }
+    _setCart(cart) {
+        this._cart = cart ?? null;
+        this.emitter.emit('cart:updated', this._cart);
+    }
+    /**
+     * True when an API error means the server-side cart is no longer usable -
+     * it expired (reservation TTL lapsed), was already checked out, or can't be
+     * found. The SDK holds the cartId in memory and rehydrates it from the
+     * server session on load, so a lapsed cart would otherwise wedge every
+     * subsequent add/remove/checkout with a 409.
+     */
+    _isCartGone(err) {
+        if (!(err instanceof LiveAPIError))
+            return false;
+        return (err.code === 'CART_EXPIRED' ||
+            err.code === 'CART_NOT_ACTIVE' ||
+            err.code === 'CART_NOT_FOUND' ||
+            err.status === 404);
+    }
+    /** Forget all local cart state and notify subscribers the cart is now empty. */
+    _resetCart() {
+        this._cartId = null;
+        this._setCart(null);
+    }
+}
+//# sourceMappingURL=liveClient.js.map

package/dist/core/liveClient.js.map

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

package/dist/createLiveClient.d.ts

@@ -0,0 +1,49 @@
+import { type LiveClientConfig } from './client.js';
+import { type LoadElementsOptions } from './state/loadElements.js';
+import { type CheckoutModalOptions } from './state/checkoutModal.js';
+import { TicketlayerLive } from './core/liveClient.js';
+/**
+ * Browser adapter over the runtime-neutral core in ./core/liveClient.ts:
+ * resolves the channel from the page host, picks the session transport
+ * (cookie for a hosted storefront, token for embeds), publishes the client on
+ * `window.Ticketlayer`, applies the theme and mounts the modals. The class
+ * itself is re-exported here so existing imports keep working.
+ */
+export { TicketlayerLive };
+export type { PresaleRedemption, SessionState, CartItemInput } from './core/liveClient.js';
+export interface CreateLiveClientOptions extends LiveClientConfig, LoadElementsOptions {
+    /** Storefront host to resolve the channel from (hosted mode). Defaults to the page host. */
+    domain?: string;
+    /** Bootstrap the session immediately (default true). */
+    autoStart?: boolean;
+    /** Fetch + apply the channel theme on start (default true in the browser). */
+    applyTheme?: boolean;
+    /**
+     * Publish this client on `window.Ticketlayer` so Elements can find + bind to
+     * it (default true in the browser). Set false to keep the client private.
+     */
+    publish?: boolean;
+    /**
+     * Resume an existing session by token (token transport) instead of
+     * bootstrapping a new one. Used by the embedded checkout iframe to inherit
+     * the parent page's cart/session. Forces sessionMode 'token'.
+     */
+    sessionToken?: string;
+    /**
+     * Checkout rendering. 'modal' (third-party embeds) auto-opens the hosted
+     * checkout in an iframe overlay on `ui:checkout-requested`. Omit on HBO,
+     * which handles that intent by navigating to /checkout in-page.
+     */
+    checkout?: {
+        mode: 'modal';
+    } & CheckoutModalOptions;
+    /**
+     * Mount the in-page buy-tickets modal (occurrence → ticket selection) on
+     * `ui:event-modal-requested`. Native Elements overlay, no iframe - works on
+     * HBO and embeds alike. Defaults to true in the browser for the published
+     * client; set false to opt out.
+     */
+    buyModal?: boolean;
+}
+export declare function createLiveClient(options: CreateLiveClientOptions): Promise<TicketlayerLive>;
+//# sourceMappingURL=createLiveClient.d.ts.map

package/dist/createLiveClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLiveClient.d.ts","sourceRoot":"","sources":["../src/createLiveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAI3F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB,EAAE,mBAAmB;IACpF,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,oBAAoB,CAAC;IACpD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkBD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoEjG"}