@wave-av/sdk 2.0.4 → 2.0.6

package/dist/mesh.d.ts

@@ -0,0 +1,238 @@
+/**
+ * WAVE SDK - Mesh API
+ *
+ * Multi-region infrastructure failover. Manage regions, peers, failover
+ * policies, and replication across your global streaming infrastructure.
+ *
+ * NOTE: This is a client SDK. All authorization checks are performed server-side.
+ * The API will return 403 Forbidden if the user lacks required permissions.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps } from "./client";
+/**
+ * Region operational status
+ */
+export type RegionStatus = "active" | "standby" | "draining" | "offline";
+/**
+ * Failover strategy
+ */
+export type FailoverStrategy = "automatic" | "manual" | "weighted";
+/**
+ * Mesh region
+ */
+export interface MeshRegion extends Timestamps {
+    id: string;
+    name: string;
+    provider: "aws" | "gcp" | "cloudflare" | "custom";
+    location: string;
+    status: RegionStatus;
+    latency_ms: number;
+    capacity_percent: number;
+    stream_count: number;
+    viewer_count: number;
+    is_primary: boolean;
+}
+/**
+ * Mesh peer connection between regions
+ */
+export interface MeshPeer {
+    id: string;
+    region_id: string;
+    endpoint: string;
+    status: "connected" | "disconnected" | "syncing";
+    last_sync_at: string;
+    replication_lag_ms: number;
+}
+/**
+ * Failover policy
+ */
+export interface FailoverPolicy extends Timestamps {
+    id: string;
+    organization_id: string;
+    name: string;
+    strategy: FailoverStrategy;
+    primary_region: string;
+    fallback_regions: string[];
+    health_check_interval_ms: number;
+    failover_threshold: number;
+    auto_failback: boolean;
+}
+/**
+ * Failover event record
+ */
+export interface FailoverEvent {
+    id: string;
+    policy_id: string;
+    type: "failover" | "failback" | "manual_switch";
+    from_region: string;
+    to_region: string;
+    reason: string;
+    duration_ms: number;
+    timestamp: string;
+}
+/**
+ * Replication status between two regions
+ */
+export interface ReplicationStatus {
+    source_region: string;
+    target_region: string;
+    status: "synced" | "lagging" | "stale";
+    lag_ms: number;
+    last_sync_at: string;
+}
+/**
+ * Full mesh topology snapshot
+ */
+export interface MeshTopology {
+    regions: MeshRegion[];
+    peers: MeshPeer[];
+    policies: FailoverPolicy[];
+}
+/**
+ * Create a failover policy
+ */
+export interface CreatePolicyRequest {
+    name: string;
+    strategy: FailoverStrategy;
+    primary_region: string;
+    fallback_regions: string[];
+    health_check_interval_ms?: number;
+    failover_threshold?: number;
+    auto_failback?: boolean;
+}
+/**
+ * List regions filters
+ */
+export interface ListRegionsParams extends PaginationParams {
+    status?: RegionStatus;
+    provider?: "aws" | "gcp" | "cloudflare" | "custom";
+}
+/**
+ * Mesh API client
+ *
+ * All operations require appropriate permissions. Authorization is enforced
+ * server-side - the API returns 403 if the authenticated user lacks access.
+ *
+ * @example
+ * ```typescript
+ * import { WaveClient } from '@wave/sdk';
+ * import { MeshAPI } from '@wave/sdk/mesh';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const mesh = new MeshAPI(client);
+ *
+ * // Get the full mesh topology
+ * const topology = await mesh.getTopology();
+ * console.log('Regions:', topology.regions.length);
+ *
+ * // Create a failover policy
+ * const policy = await mesh.createPolicy({
+ *   name: 'US West Failover',
+ *   strategy: 'automatic',
+ *   primary_region: 'us-west-2',
+ *   fallback_regions: ['us-east-1', 'eu-west-1'],
+ *   failover_threshold: 3,
+ *   auto_failback: true,
+ * });
+ *
+ * // Trigger manual failover
+ * await mesh.triggerFailover(policy.id, 'us-east-1');
+ * ```
+ */
+export declare class MeshAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * List mesh regions with optional filters
+     *
+     * Requires: mesh:read permission
+     */
+    listRegions(params?: ListRegionsParams): Promise<PaginatedResponse<MeshRegion>>;
+    /**
+     * Get a region by ID
+     *
+     * Requires: mesh:read permission
+     */
+    getRegion(regionId: string): Promise<MeshRegion>;
+    /**
+     * Get health details for a region
+     *
+     * Requires: mesh:read permission
+     */
+    getRegionHealth(regionId: string): Promise<{
+        status: RegionStatus;
+        latency_ms: number;
+        details: Record<string, unknown>;
+    }>;
+    /**
+     * List mesh peers, optionally filtered by region
+     *
+     * Requires: mesh:read permission
+     */
+    listPeers(regionId?: string): Promise<MeshPeer[]>;
+    /**
+     * Add a peer to a region
+     *
+     * Requires: mesh:create permission
+     */
+    addPeer(regionId: string, endpoint: string): Promise<MeshPeer>;
+    /**
+     * Remove a peer
+     *
+     * Requires: mesh:remove permission (server-side RBAC enforced)
+     */
+    removePeer(peerId: string): Promise<void>;
+    /**
+     * Create a failover policy
+     *
+     * Requires: mesh:create permission
+     */
+    createPolicy(request: CreatePolicyRequest): Promise<FailoverPolicy>;
+    /**
+     * Update a failover policy
+     *
+     * Requires: mesh:update permission
+     */
+    updatePolicy(policyId: string, updates: Partial<CreatePolicyRequest>): Promise<FailoverPolicy>;
+    /**
+     * Remove a failover policy
+     *
+     * Requires: mesh:remove permission (server-side RBAC enforced)
+     */
+    removePolicy(policyId: string): Promise<void>;
+    /**
+     * List failover policies
+     *
+     * Requires: mesh:read permission
+     */
+    listPolicies(params?: PaginationParams): Promise<PaginatedResponse<FailoverPolicy>>;
+    /**
+     * Trigger a manual failover to a target region
+     *
+     * Requires: mesh:failover permission
+     */
+    triggerFailover(policyId: string, targetRegion: string): Promise<FailoverEvent>;
+    /**
+     * Get failover event history for a policy
+     *
+     * Requires: mesh:read permission
+     */
+    getFailoverHistory(policyId: string, params?: PaginationParams): Promise<PaginatedResponse<FailoverEvent>>;
+    /**
+     * Get replication status between regions
+     *
+     * Requires: mesh:read permission
+     */
+    getReplicationStatus(sourceRegion?: string, targetRegion?: string): Promise<ReplicationStatus[]>;
+    /**
+     * Get the full mesh topology (regions, peers, and policies)
+     *
+     * Requires: mesh:read permission
+     */
+    getTopology(): Promise<MeshTopology>;
+}
+/**
+ * Create a Mesh API instance
+ */
+export declare function createMeshAPI(client: WaveClient): MeshAPI;
+//# sourceMappingURL=mesh.d.ts.map

package/dist/mesh.d.ts.map

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

package/dist/notifications.d.ts

@@ -0,0 +1,83 @@
+/**
+ * WAVE SDK - Notifications API
+ *
+ * User notification preferences, delivery channels, and notification management.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps } from "./client";
+export type NotificationChannel = "in_app" | "email" | "push" | "sms" | "slack" | "webhook";
+export type NotificationStatus = "unread" | "read" | "archived";
+export type NotificationPriority = "low" | "normal" | "high" | "urgent";
+export interface Notification extends Timestamps {
+    id: string;
+    user_id: string;
+    type: string;
+    title: string;
+    body: string;
+    status: NotificationStatus;
+    priority: NotificationPriority;
+    channel: NotificationChannel;
+    action_url?: string;
+    metadata?: Record<string, unknown>;
+    read_at?: string;
+}
+export interface NotificationPreferences {
+    user_id: string;
+    channels: Record<NotificationChannel, boolean>;
+    categories: Record<string, {
+        enabled: boolean;
+        channels: NotificationChannel[];
+    }>;
+    quiet_hours?: {
+        start: string;
+        end: string;
+        timezone: string;
+    };
+    digest_frequency?: "realtime" | "hourly" | "daily" | "weekly";
+}
+export interface ListNotificationsParams extends PaginationParams {
+    status?: NotificationStatus;
+    type?: string;
+    priority?: NotificationPriority;
+    channel?: NotificationChannel;
+    since?: string;
+}
+/**
+ * User notification management: preferences, channels, read state, and delivery.
+ *
+ * @example
+ * ```typescript
+ * const notifications = await wave.notifications.list({ status: 'unread' });
+ * await wave.notifications.markAsRead(notifications.data[0].id);
+ * await wave.notifications.markAllRead();
+ * const prefs = await wave.notifications.getPreferences();
+ * ```
+ */
+export declare class NotificationsAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /** List notifications with optional filters. */
+    list(params?: ListNotificationsParams): Promise<PaginatedResponse<Notification>>;
+    /** Get a single notification by ID. */
+    get(notificationId: string): Promise<Notification>;
+    /** Mark a notification as read. */
+    markAsRead(notificationId: string): Promise<Notification>;
+    /** Mark all notifications as read. */
+    markAllRead(): Promise<{
+        updated: number;
+    }>;
+    /** Archive a notification. */
+    archive(notificationId: string): Promise<Notification>;
+    /** Delete a notification. */
+    remove(notificationId: string): Promise<void>;
+    /** Get unread count. */
+    getUnreadCount(): Promise<{
+        count: number;
+    }>;
+    /** Get notification preferences. */
+    getPreferences(): Promise<NotificationPreferences>;
+    /** Update notification preferences. */
+    updatePreferences(preferences: Partial<NotificationPreferences>): Promise<NotificationPreferences>;
+}
+export declare function createNotificationsAPI(client: WaveClient): NotificationsAPI;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

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

package/dist/phone-types.d.ts

@@ -0,0 +1,111 @@
+export type CallStatus = 'initiating' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+export type CallDirection = 'inbound' | 'outbound';
+export type PhoneNumberType = 'local' | 'toll_free' | 'mobile' | 'voip';
+export interface PhoneNumberCapabilities {
+    voice: boolean;
+    sms: boolean;
+    mms: boolean;
+    fax: boolean;
+}
+export interface PhoneNumber extends Timestamps {
+    id: string;
+    organization_id: string;
+    number: string;
+    formatted_number: string;
+    country_code: string;
+    type: PhoneNumberType;
+    capabilities: PhoneNumberCapabilities;
+    friendly_name?: string;
+    status: 'active' | 'inactive' | 'pending';
+    monthly_cost: number;
+    metadata?: Metadata;
+}
+export interface Call extends Timestamps {
+    id: string;
+    organization_id: string;
+    from_number: string;
+    to_number: string;
+    direction: CallDirection;
+    status: CallStatus;
+    duration?: number;
+    start_time?: string;
+    end_time?: string;
+    recording_url?: string;
+    transcription_id?: string;
+    cost?: number;
+    metadata?: Metadata;
+}
+export interface MakeCallRequest {
+    /** Phone number to call from (must be owned) */
+    from: string;
+    /** Phone number to call */
+    to: string;
+    /** URL for call status webhooks */
+    status_callback_url?: string;
+    /** URL for call instructions (TwiML or similar) */
+    url?: string;
+    /** Timeout in seconds before no-answer */
+    timeout?: number;
+    /** Record the call */
+    record?: boolean;
+    /** Enable transcription */
+    transcribe?: boolean;
+    /** Custom data to include with call events */
+    metadata?: Metadata;
+}
+export interface UpdateCallRequest {
+    /** URL for new call instructions */
+    url?: string;
+    /** End the call */
+    status?: 'completed' | 'canceled';
+    /** Mute/unmute the call */
+    muted?: boolean;
+}
+export interface Conference extends Timestamps {
+    id: string;
+    organization_id: string;
+    friendly_name: string;
+    status: 'init' | 'in_progress' | 'completed';
+    region?: string;
+    participants: ConferenceParticipant[];
+    max_participants?: number;
+    recording_enabled: boolean;
+    recording_url?: string;
+    metadata?: Metadata;
+}
+export interface ConferenceParticipant {
+    call_id: string;
+    phone_number: string;
+    status: 'connecting' | 'connected' | 'disconnected';
+    muted: boolean;
+    hold: boolean;
+    start_time?: string;
+    duration?: number;
+}
+export interface SearchNumbersRequest {
+    country_code: string;
+    type?: PhoneNumberType;
+    area_code?: string;
+    contains?: string;
+    capabilities?: Partial<PhoneNumberCapabilities>;
+    limit?: number;
+}
+export interface AvailablePhoneNumber {
+    number: string;
+    formatted_number: string;
+    country_code: string;
+    type: PhoneNumberType;
+    capabilities: PhoneNumberCapabilities;
+    region?: string;
+    city?: string;
+    monthly_cost: number;
+}
+export interface ListCallsParams extends PaginationParams {
+    status?: CallStatus;
+    direction?: CallDirection;
+    from_number?: string;
+    to_number?: string;
+    start_after?: string;
+    start_before?: string;
+}
+//# sourceMappingURL=phone-types.d.ts.map

package/dist/phone-types.d.ts.map

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

package/dist/phone.d.ts

@@ -0,0 +1,235 @@
+/**
+ * WAVE SDK - Phone API
+ *
+ * Voice calling and telephony integration capabilities.
+ *
+ * NOTE: This is a client SDK. All authorization checks are performed server-side.
+ * The API will return 403 Forbidden if the user lacks required permissions.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Metadata } from './client';
+import type { PhoneNumberType, PhoneNumber, Call, MakeCallRequest, UpdateCallRequest, Conference, ConferenceParticipant, SearchNumbersRequest, AvailablePhoneNumber, ListCallsParams } from './phone-types';
+/**
+ * Call status
+ */
+/**
+ * Call direction
+ */
+/**
+ * Phone number type
+ */
+/**
+ * Phone number capabilities
+ */
+/**
+ * Phone number
+ */
+/**
+ * Call record
+ */
+/**
+ * Make call request
+ */
+/**
+ * Call update request
+ */
+/**
+ * Conference room
+ */
+/**
+ * Conference participant
+ */
+/**
+ * Search available numbers request
+ */
+/**
+ * Available phone number
+ */
+/**
+ * List calls params
+ */
+/**
+ * Phone API client
+ */
+export declare class PhoneAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * List owned phone numbers
+     *
+     * Requires: phone:read permission
+     */
+    listNumbers(params?: PaginationParams & {
+        status?: 'active' | 'inactive';
+        type?: PhoneNumberType;
+    }): Promise<PaginatedResponse<PhoneNumber>>;
+    /**
+     * Get a phone number by ID
+     *
+     * Requires: phone:read permission
+     */
+    getNumber(numberId: string): Promise<PhoneNumber>;
+    /**
+     * Search for available phone numbers to purchase
+     *
+     * Requires: phone:read permission
+     */
+    searchAvailableNumbers(request: SearchNumbersRequest): Promise<AvailablePhoneNumber[]>;
+    /**
+     * Purchase a phone number
+     *
+     * Requires: phone:purchase permission
+     */
+    purchaseNumber(number: string, options?: {
+        friendly_name?: string;
+        metadata?: Metadata;
+    }): Promise<PhoneNumber>;
+    /**
+     * Update a phone number
+     *
+     * Requires: phone:update permission
+     */
+    updateNumber(numberId: string, updates: {
+        friendly_name?: string;
+        metadata?: Metadata;
+    }): Promise<PhoneNumber>;
+    /**
+     * Release a phone number
+     *
+     * Requires: phone:release permission (server-side RBAC enforced)
+     */
+    releaseNumber(numberId: string): Promise<void>;
+    /**
+     * Make an outbound call
+     *
+     * Requires: phone:call permission
+     */
+    makeCall(request: MakeCallRequest): Promise<Call>;
+    /**
+     * Get a call by ID
+     *
+     * Requires: phone:read permission
+     */
+    getCall(callId: string): Promise<Call>;
+    /**
+     * List calls
+     *
+     * Requires: phone:read permission
+     */
+    listCalls(params?: ListCallsParams): Promise<PaginatedResponse<Call>>;
+    /**
+     * Update an active call
+     *
+     * Requires: phone:call permission
+     */
+    updateCall(callId: string, updates: UpdateCallRequest): Promise<Call>;
+    /**
+     * End an active call
+     *
+     * Requires: phone:call permission
+     */
+    endCall(callId: string): Promise<Call>;
+    /**
+     * Get call recording
+     *
+     * Requires: phone:read permission
+     */
+    getRecording(callId: string): Promise<{
+        url: string;
+        duration: number;
+        file_size: number;
+    }>;
+    /**
+     * Wait for call to end
+     */
+    waitForCallEnd(callId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onUpdate?: (call: Call) => void;
+    }): Promise<Call>;
+    /**
+     * Create a conference room
+     *
+     * Requires: phone:conference permission
+     */
+    createConference(options: {
+        friendly_name: string;
+        max_participants?: number;
+        recording_enabled?: boolean;
+        region?: string;
+        metadata?: Metadata;
+    }): Promise<Conference>;
+    /**
+     * Get a conference by ID
+     *
+     * Requires: phone:read permission
+     */
+    getConference(conferenceId: string): Promise<Conference>;
+    /**
+     * List conferences
+     *
+     * Requires: phone:read permission
+     */
+    listConferences(params?: PaginationParams & {
+        status?: 'init' | 'in_progress' | 'completed';
+    }): Promise<PaginatedResponse<Conference>>;
+    /**
+     * Add a participant to a conference
+     *
+     * Requires: phone:conference permission
+     */
+    addConferenceParticipant(conferenceId: string, options: {
+        from: string;
+        to: string;
+        muted?: boolean;
+    }): Promise<ConferenceParticipant>;
+    /**
+     * Update a conference participant
+     *
+     * Requires: phone:conference permission
+     */
+    updateConferenceParticipant(conferenceId: string, callId: string, updates: {
+        muted?: boolean;
+        hold?: boolean;
+    }): Promise<ConferenceParticipant>;
+    /**
+     * Remove a participant from a conference
+     *
+     * Requires: phone:conference permission (server-side RBAC enforced)
+     */
+    removeConferenceParticipant(conferenceId: string, callId: string): Promise<void>;
+    /**
+     * End a conference
+     *
+     * Requires: phone:conference permission
+     */
+    endConference(conferenceId: string): Promise<Conference>;
+    /**
+     * Validate a phone number
+     *
+     * Requires: phone:read permission
+     */
+    validateNumber(number: string): Promise<{
+        valid: boolean;
+        formatted_number?: string;
+        country_code?: string;
+        type?: PhoneNumberType;
+        carrier?: string;
+    }>;
+    /**
+     * Get supported countries
+     *
+     * Requires: phone:read permission
+     */
+    getSupportedCountries(): Promise<Array<{
+        code: string;
+        name: string;
+        calling_code: string;
+        supported_types: PhoneNumberType[];
+    }>>;
+}
+/**
+ * Create a Phone API instance
+ */
+export declare function createPhoneAPI(client: WaveClient): PhoneAPI;
+//# sourceMappingURL=phone.d.ts.map

package/dist/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../src/phone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,QAAQ,EACT,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAA6B,eAAe,EAA2B,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhQ;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAIH;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,MAAM,EAAE,UAAU;IAI9B;;;;OAIG;IACG,WAAW,CACf,MAAM,CAAC,EAAE,gBAAgB,GAAG;QAC1B,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;QAC/B,IAAI,CAAC,EAAE,eAAe,CAAC;KACxB,GACA,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAO1C;;;;OAIG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvD;;;;OAIG;IACG,sBAAsB,CAC1B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOlC;;;;OAIG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,GACxD,OAAO,CAAC,WAAW,CAAC;IAOvB;;;;OAIG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,GACvD,OAAO,CAAC,WAAW,CAAC;IAOvB;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;OAIG;IACG,SAAS,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAO3E;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;OAIG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhE;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;KACjC,GACA,OAAO,CAAC,IAAI,CAAC;IA8BhB;;;;OAIG;IACG,gBAAgB,CAAC,OAAO,EAAE;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIvB;;;;OAIG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAM9D;;;;OAIG;IACG,eAAe,CACnB,MAAM,CAAC,EAAE,gBAAgB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,CAAA;KAAE,GAC5E,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAOzC;;;;OAIG;IACG,wBAAwB,CAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GACA,OAAO,CAAC,qBAAqB,CAAC;IAOjC;;;;OAIG;IACG,2BAA2B,CAC/B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3C,OAAO,CAAC,qBAAqB,CAAC;IAOjC;;;;OAIG;IACG,2BAA2B,CAC/B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAOhB;;;;OAIG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAM9D;;;;OAIG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QACT,KAAK,EAAE,OAAO,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,eAAe,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAIF;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CACpC,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,eAAe,EAAE,CAAC;KACpC,CAAC,CACH;CAGF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAE3D"}