@dr-sentry/sdk 1.0.0

package/dist/cjs/streaming.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlagStreamClient = void 0;
+const SSE_INITIAL_RETRY_MS = 1_000;
+const SSE_MAX_RETRY_MS = 30_000;
+const SSE_BACKOFF_MULTIPLIER = 2;
+const SSE_JITTER_FRACTION = 0.2;
+/**
+ * Lightweight SSE streaming client that keeps the local flag cache
+ * synchronised with the DeploySentry service.
+ *
+ * Uses the built-in `fetch` readable stream API available in Node 18+
+ * to avoid external EventSource dependencies.
+ */
+class FlagStreamClient {
+    abortController = null;
+    reconnectTimer = null;
+    closed = false;
+    retryMs = SSE_INITIAL_RETRY_MS;
+    url;
+    headers;
+    onUpdate;
+    onError;
+    constructor(options) {
+        this.url = options.url;
+        this.headers = options.headers;
+        this.onUpdate = options.onUpdate;
+        this.onError = options.onError ?? (() => { });
+    }
+    /** Open the SSE connection and start processing events. */
+    async connect() {
+        if (this.closed)
+            return;
+        this.abortController = new AbortController();
+        try {
+            const response = await fetch(this.url, {
+                method: 'GET',
+                headers: {
+                    ...this.headers,
+                    Accept: 'text/event-stream',
+                    'Cache-Control': 'no-cache',
+                },
+                signal: this.abortController.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);
+            }
+            if (!response.body) {
+                throw new Error('SSE response has no body');
+            }
+            this.retryMs = SSE_INITIAL_RETRY_MS;
+            await this.consumeStream(response.body);
+        }
+        catch (err) {
+            if (this.closed)
+                return;
+            const error = err instanceof Error ? err : new Error(String(err));
+            if (error.name === 'AbortError')
+                return;
+            this.onError(error);
+            this.scheduleReconnect();
+        }
+    }
+    /** Close the connection and stop reconnection attempts. */
+    close() {
+        this.closed = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------------
+    async consumeStream(body) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (!this.closed) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // SSE events are delimited by double newlines.
+                const parts = buffer.split('\n\n');
+                buffer = parts.pop() ?? '';
+                for (const raw of parts) {
+                    this.processEvent(raw);
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        // If the stream ended naturally (server closed), attempt reconnect.
+        if (!this.closed) {
+            this.scheduleReconnect();
+        }
+    }
+    processEvent(raw) {
+        let eventType = 'message';
+        let data = '';
+        for (const line of raw.split('\n')) {
+            if (line.startsWith('event:')) {
+                eventType = line.slice(6).trim();
+            }
+            else if (line.startsWith('data:')) {
+                data += line.slice(5).trim();
+            }
+        }
+        if (eventType === 'flag_update' || eventType === 'message') {
+            try {
+                const parsed = JSON.parse(data);
+                const flags = Array.isArray(parsed) ? parsed : [parsed];
+                this.onUpdate(flags);
+            }
+            catch {
+                // Ignore malformed payloads (e.g. keep-alive comments).
+            }
+        }
+    }
+    scheduleReconnect() {
+        if (this.closed)
+            return;
+        const jitter = this.retryMs * SSE_JITTER_FRACTION * (2 * Math.random() - 1);
+        const delay = this.retryMs + jitter;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+        this.retryMs = Math.min(this.retryMs * SSE_BACKOFF_MULTIPLIER, SSE_MAX_RETRY_MS);
+    }
+}
+exports.FlagStreamClient = FlagStreamClient;
+//# sourceMappingURL=streaming.js.map

package/dist/cjs/streaming.js.map

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

package/dist/cjs/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * DeploySentry SDK type definitions.
+ */
+/** Categories that classify the intent and lifecycle of a feature flag. */
+export type FlagCategory = 'release' | 'feature' | 'experiment' | 'ops' | 'permission';
+/** Rich metadata attached to every feature flag. */
+export interface FlagMetadata {
+    /** Categorisation that drives lifecycle policies. */
+    category: FlagCategory;
+    /** Human-readable explanation of what this flag controls. */
+    purpose: string;
+    /** Team or individual owners responsible for this flag. */
+    owners: string[];
+    /** When true the flag is not expected to be removed. */
+    isPermanent: boolean;
+    /** ISO-8601 expiration timestamp. Undefined for permanent flags. */
+    expiresAt?: string;
+    /** Free-form tags for filtering and grouping. */
+    tags: string[];
+}
+/** A feature flag as returned by the DeploySentry API. */
+export interface Flag {
+    /** Unique key used to reference the flag in code. */
+    key: string;
+    /** Whether the flag is currently enabled. */
+    enabled: boolean;
+    /** The resolved value (boolean, string, number, or JSON object). */
+    value: unknown;
+    /** Rich metadata describing the flag. */
+    metadata: FlagMetadata;
+    /** ISO-8601 timestamp of the last update. */
+    updatedAt: string;
+}
+/** Contextual information sent with every evaluation request. */
+export interface EvaluationContext {
+    /** Identifier of the user being evaluated. */
+    userId?: string;
+    /** Identifier of the organisation the user belongs to. */
+    orgId?: string;
+    /** Arbitrary key-value attributes for targeting rules. */
+    attributes?: Record<string, string>;
+}
+/** Full evaluation result including the resolved value and metadata. */
+export interface EvaluationResult<T = unknown> {
+    /** The flag key that was evaluated. */
+    key: string;
+    /** The resolved value after evaluation. */
+    value: T;
+    /** Whether the flag is enabled for the given context. */
+    enabled: boolean;
+    /** Reason the value was resolved (e.g. "TARGETING_MATCH", "DEFAULT"). */
+    reason: string;
+    /** Rich metadata for the flag. */
+    metadata: FlagMetadata;
+    /** ISO-8601 evaluation timestamp. */
+    evaluatedAt: string;
+}
+/** Configuration options for the DeploySentry client. */
+export interface ClientOptions {
+    /** API key used for authenticating with the DeploySentry service. */
+    apiKey: string;
+    /** Base URL of the DeploySentry API. Defaults to https://api.dr-sentry.com. */
+    baseURL?: string;
+    /** Environment identifier (e.g. "production", "staging"). */
+    environment: string;
+    /** Project identifier. */
+    project: string;
+    /** Application identifier. */
+    application: string;
+    /** Cache TTL in milliseconds. Defaults to 60 000 (1 minute). */
+    cacheTimeout?: number;
+    /** When true, the client returns default values without contacting the API. */
+    offlineMode?: boolean;
+    /** Optional session identifier for consistent flag evaluation across requests. */
+    sessionId?: string;
+    /** SDK mode: server (default), file (YAML only), or server-with-fallback. */
+    mode?: 'server' | 'file' | 'server-with-fallback';
+    /** Path to a local YAML flag config file. Defaults to .deploysentry/flags.yaml. */
+    flagFilePath?: string;
+}
+export interface FlagConfig {
+    version: number;
+    project: string;
+    application: string;
+    exported_at: string;
+    environments: FlagConfigEnvironment[];
+    flags: FlagConfigFlag[];
+}
+export interface FlagConfigEnvironment {
+    id: string;
+    name: string;
+    is_production: boolean;
+}
+export interface FlagConfigFlag {
+    key: string;
+    name: string;
+    flag_type: string;
+    category: string;
+    default_value: string;
+    is_permanent: boolean;
+    expires_at?: string;
+    environments: Record<string, {
+        enabled: boolean;
+        value: string;
+    }>;
+    rules?: FlagConfigRule[];
+}
+export interface FlagConfigRule {
+    attribute: string;
+    operator: string;
+    target_values: string[];
+    value: string;
+    priority: number;
+    environments: Record<string, boolean>;
+}
+/** Internal representation of an API error response. */
+export interface ApiError {
+    status: number;
+    message: string;
+    code?: string;
+}
+export interface Registration<T extends (...args: any[]) => any = (...args: any[]) => any> {
+    handler: T;
+    flagKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

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

package/dist/cjs/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * DeploySentry SDK type definitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/esm/cache.d.ts

@@ -0,0 +1,33 @@
+import { Flag } from './types';
+/**
+ * In-memory flag cache with per-entry TTL support.
+ *
+ * Entries are lazily evicted on read. A periodic sweep can be triggered
+ * via {@link purgeExpired} if deterministic memory reclamation is required.
+ */
+export declare class FlagCache {
+    private readonly store;
+    private readonly ttlMs;
+    /**
+     * @param ttlMs - Time-to-live for every cache entry in milliseconds.
+     *                Defaults to 60 000 (1 minute).
+     */
+    constructor(ttlMs?: number);
+    /** Store or update a single flag in the cache. */
+    set(flag: Flag): void;
+    /** Bulk-insert flags, replacing any stale entries. */
+    setMany(flags: Flag[]): void;
+    /** Retrieve a flag by key. Returns `undefined` if missing or expired. */
+    get(key: string): Flag | undefined;
+    /** Return all non-expired flags currently in the cache. */
+    getAll(): Flag[];
+    /** Remove a single key from the cache. */
+    delete(key: string): void;
+    /** Remove all expired entries. Returns the number of entries purged. */
+    purgeExpired(): number;
+    /** Drop every entry from the cache. */
+    clear(): void;
+    /** Number of entries (including potentially expired ones). */
+    get size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/esm/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAO/B;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;OAGG;gBACS,KAAK,GAAE,MAAe;IAIlC,kDAAkD;IAClD,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAOrB,sDAAsD;IACtD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAM5B,yEAAyE;IACzE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAYlC,2DAA2D;IAC3D,MAAM,IAAI,IAAI,EAAE;IAehB,0CAA0C;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,wEAAwE;IACxE,YAAY,IAAI,MAAM;IActB,uCAAuC;IACvC,KAAK,IAAI,IAAI;IAIb,8DAA8D;IAC9D,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/esm/cache.js

@@ -0,0 +1,80 @@
+/**
+ * In-memory flag cache with per-entry TTL support.
+ *
+ * Entries are lazily evicted on read. A periodic sweep can be triggered
+ * via {@link purgeExpired} if deterministic memory reclamation is required.
+ */
+export class FlagCache {
+    store = new Map();
+    ttlMs;
+    /**
+     * @param ttlMs - Time-to-live for every cache entry in milliseconds.
+     *                Defaults to 60 000 (1 minute).
+     */
+    constructor(ttlMs = 60_000) {
+        this.ttlMs = ttlMs;
+    }
+    /** Store or update a single flag in the cache. */
+    set(flag) {
+        this.store.set(flag.key, {
+            flag,
+            expiresAt: Date.now() + this.ttlMs,
+        });
+    }
+    /** Bulk-insert flags, replacing any stale entries. */
+    setMany(flags) {
+        for (const flag of flags) {
+            this.set(flag);
+        }
+    }
+    /** Retrieve a flag by key. Returns `undefined` if missing or expired. */
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.flag;
+    }
+    /** Return all non-expired flags currently in the cache. */
+    getAll() {
+        const now = Date.now();
+        const result = [];
+        for (const [key, entry] of this.store) {
+            if (now > entry.expiresAt) {
+                this.store.delete(key);
+            }
+            else {
+                result.push(entry.flag);
+            }
+        }
+        return result;
+    }
+    /** Remove a single key from the cache. */
+    delete(key) {
+        this.store.delete(key);
+    }
+    /** Remove all expired entries. Returns the number of entries purged. */
+    purgeExpired() {
+        const now = Date.now();
+        let purged = 0;
+        for (const [key, entry] of this.store) {
+            if (now > entry.expiresAt) {
+                this.store.delete(key);
+                purged++;
+            }
+        }
+        return purged;
+    }
+    /** Drop every entry from the cache. */
+    clear() {
+        this.store.clear();
+    }
+    /** Number of entries (including potentially expired ones). */
+    get size() {
+        return this.store.size;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/esm/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IACH,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,KAAK,CAAS;IAE/B;;;OAGG;IACH,YAAY,QAAgB,MAAM;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,kDAAkD;IAClD,GAAG,CAAC,IAAU;QACZ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;YACvB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;SACnC,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,OAAO,CAAC,KAAa;QACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,2DAA2D;IAC3D,MAAM;QACJ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAW,EAAE,CAAC;QAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,wEAAwE;IACxE,YAAY;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uCAAuC;IACvC,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/esm/client.d.ts

@@ -0,0 +1,81 @@
+import { ClientOptions, EvaluationContext, EvaluationResult, Flag, FlagCategory } from './types';
+/**
+ * DeploySentry feature-flag client.
+ *
+ * ```ts
+ * const client = new DeploySentryClient({
+ *   apiKey: 'ds_live_xxx',
+ *   environment: 'production',
+ *   project: 'my-app',
+ * });
+ *
+ * await client.initialize();
+ *
+ * const darkMode = client.boolValue('dark-mode', false, { userId: 'u1' });
+ *
+ * client.close();
+ * ```
+ */
+export declare class DeploySentryClient {
+    private readonly apiKey;
+    private readonly baseURL;
+    private readonly environment;
+    private readonly project;
+    private readonly application;
+    private readonly offlineMode;
+    private readonly sessionId;
+    private readonly mode;
+    private readonly flagFilePath?;
+    private readonly cache;
+    private streamClient;
+    private _initialized;
+    private flagConfig;
+    private registry;
+    constructor(options: ClientOptions);
+    /**
+     * Fetch the initial flag set and open an SSE connection for real-time
+     * updates.  Must be called before evaluating flags.
+     */
+    initialize(): Promise<void>;
+    /** Tear down the SSE connection and release resources. */
+    close(): void;
+    /**
+     * Clear the local cache and re-fetch all flags from the server.
+     * Useful when session state may have changed and the client needs
+     * fresh evaluations.
+     */
+    refreshSession(): Promise<void>;
+    /** Whether {@link initialize} has been called successfully. */
+    get isInitialized(): boolean;
+    /** Evaluate a flag as a boolean. */
+    boolValue(key: string, defaultValue: boolean, context?: EvaluationContext): Promise<boolean>;
+    /** Evaluate a flag as a string. */
+    stringValue(key: string, defaultValue: string, context?: EvaluationContext): Promise<string>;
+    /** Evaluate a flag as an integer. */
+    intValue(key: string, defaultValue: number, context?: EvaluationContext): Promise<number>;
+    /** Evaluate a flag and return the value as a parsed JSON object. */
+    jsonValue<T = unknown>(key: string, defaultValue: T, context?: EvaluationContext): Promise<T>;
+    /**
+     * Return the full {@link EvaluationResult} for a flag including metadata,
+     * reason, and resolved value.
+     */
+    detail(key: string, context?: EvaluationContext): Promise<EvaluationResult>;
+    /** Return all cached flags belonging to a given category. */
+    flagsByCategory(category: FlagCategory): Flag[];
+    /** Return all cached flags whose `expiresAt` is in the past. */
+    expiredFlags(): Flag[];
+    /** Return the owners array for a given flag key. */
+    flagOwners(key: string): string[];
+    /** Return every flag currently held in the local cache. */
+    allFlags(): Flag[];
+    register<T extends (...args: any[]) => any>(operation: string, handler: T, flagKey?: string): void;
+    dispatch<T extends (...args: any[]) => any>(operation: string, _context?: EvaluationContext): T;
+    private evaluate;
+    private fetchAllFlags;
+    private post;
+    private request;
+    private authHeaders;
+    private offlineResult;
+    private cachedResult;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,IAAI,EACJ,YAAY,EAEb,MAAM,SAAS,CAAC;AAUjB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6C;IAClE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,QAAQ,CAA0C;gBAE9C,OAAO,EAAE,aAAa;IAuBlC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CjC,0DAA0D;IAC1D,KAAK,IAAI,IAAI;IAOb;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC,+DAA+D;IAC/D,IAAI,aAAa,IAAI,OAAO,CAE3B;IAMD,oCAAoC;IAC9B,SAAS,CACb,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC;IAcnB,mCAAmC;IAC7B,WAAW,CACf,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC;IAKlB,qCAAqC;IAC/B,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC;IAOlB,oEAAoE;IAC9D,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,CAAC,CAAC;IASb;;;OAGG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IA2B5B,6DAA6D;IAC7D,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE;IAI/C,gEAAgE;IAChE,YAAY,IAAI,IAAI,EAAE;IAOtB,oDAAoD;IACpD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAKjC,2DAA2D;IAC3D,QAAQ,IAAI,IAAI,EAAE;IAQlB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAeP,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,CAAC;YA0BU,QAAQ;YAkCR,aAAa;YAQb,IAAI;YAIJ,OAAO;IAgCrB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,YAAY;CAmBrB"}