@dr-sentry/sdk 1.0.0

package/dist/esm/client.js

@@ -0,0 +1,358 @@
+import { FlagCache } from './cache';
+import { FlagStreamClient } from './streaming';
+import { loadFlagConfig } from './file-loader';
+import { evaluateLocal } from './local-evaluator';
+const DEFAULT_BASE_URL = 'https://api.dr-sentry.com';
+const DEFAULT_CACHE_TIMEOUT_MS = 60_000;
+/**
+ * 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 class DeploySentryClient {
+    apiKey;
+    baseURL;
+    environment;
+    project;
+    application;
+    offlineMode;
+    sessionId;
+    mode;
+    flagFilePath;
+    cache;
+    streamClient = null;
+    _initialized = false;
+    flagConfig = null;
+    registry = new Map();
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error('apiKey is required');
+        if (!options.environment)
+            throw new Error('environment is required');
+        if (!options.project)
+            throw new Error('project is required');
+        if (!options.application)
+            throw new Error('application is required');
+        this.apiKey = options.apiKey;
+        this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.environment = options.environment;
+        this.project = options.project;
+        this.application = options.application;
+        this.offlineMode = options.offlineMode ?? false;
+        this.sessionId = options.sessionId;
+        this.mode = options.mode ?? 'server';
+        this.flagFilePath = options.flagFilePath;
+        this.cache = new FlagCache(options.cacheTimeout ?? DEFAULT_CACHE_TIMEOUT_MS);
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Fetch the initial flag set and open an SSE connection for real-time
+     * updates.  Must be called before evaluating flags.
+     */
+    async initialize() {
+        if (this.mode === 'file') {
+            this.flagConfig = loadFlagConfig(this.flagFilePath);
+            this._initialized = true;
+            return;
+        }
+        if (this.offlineMode) {
+            this._initialized = true;
+            return;
+        }
+        try {
+            // Fetch all flags for the project so the cache is warm.
+            const flags = await this.fetchAllFlags();
+            this.cache.setMany(flags);
+            // Start streaming updates.
+            this.streamClient = new FlagStreamClient({
+                url: `${this.baseURL}/api/v1/flags/stream?project_id=${enc(this.project)}&environment_id=${enc(this.environment)}&application=${enc(this.application)}`,
+                headers: this.authHeaders(),
+                onUpdate: (updated) => this.cache.setMany(updated),
+                onError: (err) => {
+                    // Surface errors but do not crash – the cache still serves stale data.
+                    console.error('[DeploySentry] stream error:', err.message);
+                },
+            });
+            // Fire-and-forget; the stream reconnects automatically.
+            this.streamClient.connect();
+            this._initialized = true;
+        }
+        catch (err) {
+            if (this.mode === 'server-with-fallback') {
+                console.warn('[DeploySentry] Server unavailable, falling back to flag config file');
+                this.flagConfig = loadFlagConfig(this.flagFilePath);
+                this._initialized = true;
+                return;
+            }
+            throw err;
+        }
+    }
+    /** Tear down the SSE connection and release resources. */
+    close() {
+        this.streamClient?.close();
+        this.streamClient = null;
+        this.cache.clear();
+        this._initialized = false;
+    }
+    /**
+     * 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.
+     */
+    async refreshSession() {
+        if (this.offlineMode)
+            return;
+        this.cache.clear();
+        const flags = await this.fetchAllFlags();
+        this.cache.setMany(flags);
+    }
+    /** Whether {@link initialize} has been called successfully. */
+    get isInitialized() {
+        return this._initialized;
+    }
+    // ---------------------------------------------------------------------------
+    // Typed value helpers
+    // ---------------------------------------------------------------------------
+    /** Evaluate a flag as a boolean. */
+    async boolValue(key, defaultValue, context) {
+        const result = await this.evaluate(key, defaultValue, context);
+        if (typeof result === 'boolean')
+            return result;
+        // The backend stores `default_value` as a string, so the evaluation
+        // endpoint commonly returns "true"/"false". Coerce so SDK callers see
+        // a real boolean instead of falling back to the literal default.
+        if (typeof result === 'string') {
+            const lowered = result.toLowerCase();
+            if (lowered === 'true')
+                return true;
+            if (lowered === 'false')
+                return false;
+        }
+        return defaultValue;
+    }
+    /** Evaluate a flag as a string. */
+    async stringValue(key, defaultValue, context) {
+        const result = await this.evaluate(key, defaultValue, context);
+        return typeof result === 'string' ? result : defaultValue;
+    }
+    /** Evaluate a flag as an integer. */
+    async intValue(key, defaultValue, context) {
+        const result = await this.evaluate(key, defaultValue, context);
+        return typeof result === 'number' && Number.isInteger(result)
+            ? result
+            : defaultValue;
+    }
+    /** Evaluate a flag and return the value as a parsed JSON object. */
+    async jsonValue(key, defaultValue, context) {
+        const result = await this.evaluate(key, defaultValue, context);
+        return result ?? defaultValue;
+    }
+    // ---------------------------------------------------------------------------
+    // Detail evaluation
+    // ---------------------------------------------------------------------------
+    /**
+     * Return the full {@link EvaluationResult} for a flag including metadata,
+     * reason, and resolved value.
+     */
+    async detail(key, context) {
+        if (this.offlineMode) {
+            return this.offlineResult(key);
+        }
+        try {
+            const body = await this.post('/api/v1/flags/evaluate', {
+                project_id: this.project,
+                environment_id: this.environment,
+                application: this.application,
+                flag_key: key,
+                context: context ?? {},
+                ...(this.sessionId ? { session_id: this.sessionId } : {}),
+            });
+            return body;
+        }
+        catch {
+            return this.cachedResult(key);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Metadata helpers
+    // ---------------------------------------------------------------------------
+    /** Return all cached flags belonging to a given category. */
+    flagsByCategory(category) {
+        return this.cache.getAll().filter((f) => f.metadata.category === category);
+    }
+    /** Return all cached flags whose `expiresAt` is in the past. */
+    expiredFlags() {
+        const now = new Date().toISOString();
+        return this.cache.getAll().filter((f) => {
+            return f.metadata.expiresAt && f.metadata.expiresAt < now;
+        });
+    }
+    /** Return the owners array for a given flag key. */
+    flagOwners(key) {
+        const flag = this.cache.get(key);
+        return flag?.metadata.owners ?? [];
+    }
+    /** Return every flag currently held in the local cache. */
+    allFlags() {
+        return this.cache.getAll();
+    }
+    // ---------------------------------------------------------------------------
+    // Register / Dispatch
+    // ---------------------------------------------------------------------------
+    register(operation, handler, flagKey) {
+        let list = this.registry.get(operation);
+        if (!list) {
+            list = [];
+            this.registry.set(operation, list);
+        }
+        if (flagKey === undefined) {
+            const idx = list.findIndex((r) => r.flagKey === undefined);
+            if (idx !== -1)
+                list[idx] = { handler };
+            else
+                list.push({ handler });
+        }
+        else {
+            list.push({ handler, flagKey });
+        }
+    }
+    dispatch(operation, _context) {
+        const list = this.registry.get(operation);
+        if (!list || list.length === 0) {
+            throw new Error(`No handlers registered for operation '${operation}'. Call register() before dispatch().`);
+        }
+        for (const reg of list) {
+            if (reg.flagKey !== undefined) {
+                const flag = this.cache.get(reg.flagKey);
+                if (flag && flag.enabled)
+                    return reg.handler;
+            }
+        }
+        const defaultReg = list.find((r) => r.flagKey === undefined);
+        if (!defaultReg) {
+            throw new Error(`No matching handler for operation '${operation}' and no default registered. Register a default handler (no flagKey) as the last registration.`);
+        }
+        return defaultReg.handler;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    async evaluate(key, defaultValue, context) {
+        if (this.flagConfig) {
+            const result = evaluateLocal(this.flagConfig, this.environment, key, context);
+            if (result.reason === 'flag_not_found')
+                return defaultValue;
+            return result.value;
+        }
+        if (this.offlineMode)
+            return defaultValue;
+        // Prefer server-side evaluation so targeting rules are applied.
+        try {
+            const result = await this.post('/api/v1/flags/evaluate', {
+                project_id: this.project,
+                environment_id: this.environment,
+                application: this.application,
+                flag_key: key,
+                context: context ?? {},
+                ...(this.sessionId ? { session_id: this.sessionId } : {}),
+            });
+            return result.value;
+        }
+        catch {
+            // Fall back to the cached flag value.
+            const cached = this.cache.get(key);
+            return cached?.value ?? defaultValue;
+        }
+    }
+    async fetchAllFlags() {
+        const response = await this.request('GET', `/api/v1/flags?project_id=${enc(this.project)}&application=${enc(this.application)}`);
+        return response.flags ?? [];
+    }
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    async request(method, path, body) {
+        const url = `${this.baseURL}${path}`;
+        const init = {
+            method,
+            headers: {
+                ...this.authHeaders(),
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+            },
+        };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, init);
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`DeploySentry API error: ${response.status} ${response.statusText} – ${text}`);
+        }
+        return response.json();
+    }
+    authHeaders() {
+        const headers = {
+            Authorization: `ApiKey ${this.apiKey}`,
+        };
+        if (this.sessionId) {
+            headers['X-DeploySentry-Session'] = this.sessionId;
+        }
+        return headers;
+    }
+    offlineResult(key) {
+        const flag = this.cache.get(key);
+        const metadata = flag?.metadata ?? {
+            category: 'feature',
+            purpose: '',
+            owners: [],
+            isPermanent: false,
+            tags: [],
+        };
+        return {
+            key,
+            value: flag?.value ?? null,
+            enabled: flag?.enabled ?? false,
+            reason: 'OFFLINE',
+            metadata,
+            evaluatedAt: new Date().toISOString(),
+        };
+    }
+    cachedResult(key) {
+        const flag = this.cache.get(key);
+        const metadata = flag?.metadata ?? {
+            category: 'feature',
+            purpose: '',
+            owners: [],
+            isPermanent: false,
+            tags: [],
+        };
+        return {
+            key,
+            value: flag?.value ?? null,
+            enabled: flag?.enabled ?? false,
+            reason: flag ? 'CACHE' : 'ERROR',
+            metadata,
+            evaluatedAt: new Date().toISOString(),
+        };
+    }
+}
+/** Percent-encode a value for use in a URL query parameter. */
+function enc(value) {
+    return encodeURIComponent(value);
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/file-loader.d.ts

@@ -0,0 +1,3 @@
+import type { FlagConfig } from './types';
+export declare function loadFlagConfig(filePath?: string): FlagConfig;
+//# sourceMappingURL=file-loader.d.ts.map

package/dist/esm/file-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../src/file-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAW5D"}

package/dist/esm/file-loader.js

@@ -0,0 +1,17 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+const DEFAULT_PATH = '.deploysentry/flags.yaml';
+export function loadFlagConfig(filePath) {
+    const resolved = path.resolve(filePath ?? DEFAULT_PATH);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`Flag config file not found: ${resolved}`);
+    }
+    const content = fs.readFileSync(resolved, 'utf-8');
+    const parsed = yaml.load(content);
+    if (!parsed || typeof parsed !== 'object' || !parsed.version || !parsed.flags) {
+        throw new Error(`Invalid flag config file: ${resolved}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=file-loader.js.map

package/dist/esm/file-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../src/file-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAGhC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAe,CAAC;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @deploysentry/sdk – Official Node.js/TypeScript SDK for DeploySentry.
+ *
+ * @example
+ * ```ts
+ * import { DeploySentryClient } from '@deploysentry/sdk';
+ *
+ * const client = new DeploySentryClient({
+ *   apiKey: 'ds_live_xxx',
+ *   environment: 'production',
+ *   project: 'my-app',
+ * });
+ *
+ * await client.initialize();
+ *
+ * const enabled = await client.boolValue('new-checkout', false, {
+ *   userId: 'user-42',
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { DeploySentryClient } from './client';
+export { FlagCache } from './cache';
+export { FlagStreamClient } from './streaming';
+export { loadFlagConfig } from './file-loader';
+export { evaluateLocal } from './local-evaluator';
+export type { ClientOptions, EvaluationContext, EvaluationResult, Flag, FlagCategory, FlagMetadata, FlagConfig, FlagConfigFlag, FlagConfigRule, FlagConfigEnvironment, ApiError, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,QAAQ,GACT,MAAM,SAAS,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,28 @@
+/**
+ * @deploysentry/sdk – Official Node.js/TypeScript SDK for DeploySentry.
+ *
+ * @example
+ * ```ts
+ * import { DeploySentryClient } from '@deploysentry/sdk';
+ *
+ * const client = new DeploySentryClient({
+ *   apiKey: 'ds_live_xxx',
+ *   environment: 'production',
+ *   project: 'my-app',
+ * });
+ *
+ * await client.initialize();
+ *
+ * const enabled = await client.boolValue('new-checkout', false, {
+ *   userId: 'user-42',
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { DeploySentryClient } from './client';
+export { FlagCache } from './cache';
+export { FlagStreamClient } from './streaming';
+export { loadFlagConfig } from './file-loader';
+export { evaluateLocal } from './local-evaluator';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/local-evaluator.d.ts

@@ -0,0 +1,6 @@
+import type { EvaluationContext, FlagConfig } from './types';
+export declare function evaluateLocal(config: FlagConfig, environment: string, key: string, context?: EvaluationContext): {
+    value: string;
+    reason: string;
+};
+//# sourceMappingURL=local-evaluator.d.ts.map

package/dist/esm/local-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-evaluator.d.ts","sourceRoot":"","sources":["../../src/local-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAkB,MAAM,SAAS,CAAC;AAE7E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAoBnC"}

package/dist/esm/local-evaluator.js

@@ -0,0 +1,37 @@
+export function evaluateLocal(config, environment, key, context) {
+    const flag = config.flags.find((f) => f.key === key);
+    if (!flag)
+        return { value: '', reason: 'flag_not_found' };
+    const envState = flag.environments[environment];
+    if (!envState || !envState.enabled) {
+        return { value: flag.default_value, reason: 'env_disabled' };
+    }
+    if (flag.rules && context) {
+        const sorted = [...flag.rules].sort((a, b) => a.priority - b.priority);
+        for (const rule of sorted) {
+            if (!rule.environments[environment])
+                continue;
+            if (matchRule(rule, context)) {
+                return { value: rule.value, reason: 'rule_match' };
+            }
+        }
+    }
+    return { value: envState.value || flag.default_value, reason: 'default' };
+}
+function matchRule(rule, context) {
+    const val = context.attributes?.[rule.attribute] ?? '';
+    const targets = rule.target_values ?? [];
+    switch (rule.operator) {
+        case 'equals': return targets.length > 0 && val === targets[0];
+        case 'not_equals': return targets.length > 0 && val !== targets[0];
+        case 'in': return targets.includes(val);
+        case 'not_in': return !targets.includes(val);
+        case 'contains': return targets.length > 0 && val.includes(targets[0]);
+        case 'starts_with': return targets.length > 0 && val.startsWith(targets[0]);
+        case 'ends_with': return targets.length > 0 && val.endsWith(targets[0]);
+        case 'greater_than': return targets.length > 0 && parseFloat(val) > parseFloat(targets[0]);
+        case 'less_than': return targets.length > 0 && parseFloat(val) < parseFloat(targets[0]);
+        default: return false;
+    }
+}
+//# sourceMappingURL=local-evaluator.js.map

package/dist/esm/local-evaluator.js.map

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

package/dist/esm/streaming.d.ts

@@ -0,0 +1,42 @@
+import { Flag } from './types';
+/** Callback invoked whenever a flag update arrives over SSE. */
+export type FlagUpdateHandler = (flags: Flag[]) => void;
+/** Callback invoked when the SSE connection encounters an error. */
+export type StreamErrorHandler = (error: Error) => void;
+interface StreamOptions {
+    /** Full URL of the SSE endpoint including query parameters. */
+    url: string;
+    /** Headers to attach to the request (e.g. Authorization). */
+    headers: Record<string, string>;
+    /** Called when one or more flag updates are received. */
+    onUpdate: FlagUpdateHandler;
+    /** Called when the stream encounters an error. */
+    onError?: StreamErrorHandler;
+}
+/**
+ * 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.
+ */
+export declare class FlagStreamClient {
+    private abortController;
+    private reconnectTimer;
+    private closed;
+    private retryMs;
+    private readonly url;
+    private readonly headers;
+    private readonly onUpdate;
+    private readonly onError;
+    constructor(options: StreamOptions);
+    /** Open the SSE connection and start processing events. */
+    connect(): Promise<void>;
+    /** Close the connection and stop reconnection attempts. */
+    close(): void;
+    private consumeStream;
+    private processEvent;
+    private scheduleReconnect;
+}
+export {};
+//# sourceMappingURL=streaming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;AAExD,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAOxD,UAAU,aAAa;IACrB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yDAAyD;IACzD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,kDAAkD;IAClD,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAwB;IAEvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,aAAa;IAOlC,2DAA2D;IACrD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC9B,2DAA2D;IAC3D,KAAK,IAAI,IAAI;YAkBC,aAAa;IA8B3B,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,iBAAiB;CAgB1B"}