@memberjunction/server 6.2.0-edge.5 → 6.2.0-edge.7

package/dist/broadcast/BaseCacheInvalidationBroadcastProvider.js

@@ -0,0 +1,442 @@
+import { randomUUID } from 'node:crypto';
+import { BaseSingleton, MJGlobal } from '@memberjunction/global';
+import { Metadata } from '@memberjunction/core';
+/**
+ * High-churn system telemetry/logging entities that can optionally be excluded from browser
+ * invalidation fan-out because browsers do not maintain live dataset caches for them.
+ */
+export const DEFAULT_HIGH_CHURN_SYSTEM_ENTITIES = [
+    'MJ: Audit Logs',
+    'MJ: Error Logs',
+    'MJ: AI Prompt Runs',
+    'MJ: AI Agent Runs',
+    'MJ: AI Agent Run Steps',
+    'MJ: Query Execution Histories',
+];
+/**
+ * Abstract base class for MemberJunction's pluggable Cache Invalidation Broadcast Hierarchy.
+ *
+ * Provides the shared primitives used by all broadcast topologies:
+ * 1. **Monotonic Sequence Ring Buffer (Topology 1)**: Every invalidation event is stamped with a
+ *    monotonically increasing `Sequence` integer and stored in a bounded circular buffer (`MaxRingBufferSize`),
+ *    enabling HTTP `X-MJ-Cache-Seq` piggybacking and `GetCacheInvalidationsSince` delta catch-up.
+ * 2. **Role-Fingerprint $O(\text{Roles})$ Evaluation & Shaping Memoizer (Topology 2)**: Computes a canonical
+ *    fingerprint of a user's sorted `RoleID`s (cached per `UserInfo` in a `WeakMap`) and memoizes
+ *    entity read-permission checks (`CanRead`) and row-level security key-withholding (`ReadIsRowFiltered`)
+ *    once per `(payload, entity, roleFingerprint)` tuple instead of once per connected WebSocket client.
+ * 3. **Cloud Multiplexer Extension Hooks (Topology 3)**: Subclasses (`AzureWebPubSubBroadcastProvider`,
+ *    `AWSIoTCoreBroadcastProvider`, `GCPPubSubBroadcastProvider`) override `PublishInvalidation` and
+ *    `NegotiateClientConnection` to offload WebSocket fan-out to managed cloud pub/sub infrastructure.
+ */
+export class BaseCacheInvalidationBroadcastProvider {
+    constructor() {
+        this._currentSequence = 0;
+        this._maxRingBufferSize = 5000;
+        this._ringBuffer = [];
+        this._ringHead = 0;
+        this._ringCount = 0;
+        this._excludedEntities = new Set();
+        this._config = {};
+        /**
+         * Memoizes canonical role fingerprints per `RoleHolder` / `UserInfo` object reference.
+         */
+        this._roleFingerprintCache = new WeakMap();
+        /**
+         * Memoizes `Metadata.EntityByName` lookup per `CacheInvalidationPayload` object reference
+         * so `CacheInvalidationFilter` and `CacheInvalidationResolver` only look up the entity once per event.
+         */
+        this._payloadEntityCache = new WeakMap();
+        /**
+         * Memoizes entity-level read permission (`CanRead`) per `(payload, roleFingerprint)`.
+         */
+        this._payloadFilterMemo = new WeakMap();
+        /**
+         * Memoizes row-level security key-withholding and shaped `CacheInvalidationNotification`
+         * per `(payload, entity, roleFingerprint)`.
+         */
+        this._payloadShapeMemo = new WeakMap();
+    }
+    static { this._serverProcessId = randomUUID(); }
+    /**
+     * Unique identifier of the running MJServer process, emitted in `X-MJ-Server-ID`.
+     */
+    get ServerProcessID() {
+        return BaseCacheInvalidationBroadcastProvider._serverProcessId;
+    }
+    /**
+     * Latest monotonic sequence number assigned to a cache invalidation event in this process.
+     */
+    get CurrentSequence() {
+        return this._currentSequence;
+    }
+    /**
+     * Maximum number of invalidation events held in the circular ring buffer.
+     */
+    get MaxRingBufferSize() {
+        return this._maxRingBufferSize;
+    }
+    /**
+     * Number of invalidation events currently retained in the circular ring buffer.
+     */
+    get BufferedEventCount() {
+        return this._ringCount;
+    }
+    /**
+     * Configures the provider instance with buffer sizing, entity exclusions, and cloud settings.
+     */
+    Configure(config) {
+        this._config = config ?? {};
+        const desiredSize = config?.ringBufferSize && config.ringBufferSize > 0 ? Math.floor(config.ringBufferSize) : 5000;
+        if (desiredSize !== this._maxRingBufferSize || this._ringBuffer.length === 0) {
+            this._maxRingBufferSize = desiredSize;
+            this._ringBuffer = new Array(this._maxRingBufferSize);
+            this._ringHead = 0;
+            this._ringCount = 0;
+        }
+        this._excludedEntities = new Set((config?.excludedEntities ?? [])
+            .map((name) => name.trim().toLowerCase())
+            .filter((name) => name.length > 0));
+    }
+    /**
+     * Returns whether invalidation events for `entityName` should be broadcast to clients.
+     * Returns `false` for blank names or entities explicitly listed in `excludedEntities`.
+     */
+    ShouldBroadcastEntity(entityName) {
+        if (!entityName) {
+            return false;
+        }
+        const normalized = entityName.trim().toLowerCase();
+        if (normalized.length === 0) {
+            return false;
+        }
+        return !this._excludedEntities.has(normalized);
+    }
+    /**
+     * Computes a canonical, order-independent role fingerprint for a user (`RoleHolder`).
+     * Memoized per user object in a `WeakMap` so repeated evaluations across thousands of events are $O(1)$.
+     */
+    GetRoleFingerprint(user) {
+        if (!user || typeof user !== 'object') {
+            return 'anonymous';
+        }
+        const roles = user.UserRoles;
+        if (!Array.isArray(roles)) {
+            return 'no-roles';
+        }
+        const cached = this._roleFingerprintCache.get(user);
+        if (cached && cached.roleCount === roles.length) {
+            return cached.fingerprint;
+        }
+        let fingerprint;
+        if (roles.length === 0) {
+            fingerprint = 'roles:empty';
+        }
+        else if (roles.length === 1) {
+            fingerprint = `roles:${(roles[0]?.RoleID ?? '').trim().toLowerCase()}`;
+        }
+        else {
+            const normalizedIds = new Array(roles.length);
+            for (let i = 0; i < roles.length; i++) {
+                normalizedIds[i] = (roles[i]?.RoleID ?? '').trim().toLowerCase();
+            }
+            normalizedIds.sort();
+            fingerprint = `roles:${normalizedIds.join('|')}`;
+        }
+        this._roleFingerprintCache.set(user, { roleCount: roles.length, fingerprint });
+        return fingerprint;
+    }
+    /**
+     * Resolves and caches the `EntityInfo` for a `CacheInvalidationPayload` so that
+     * `CacheInvalidationFilter` and `CacheInvalidationResolver` do not repeat metadata lookups.
+     */
+    ResolveEntityForPayload(payload, entityLookup) {
+        if (this._payloadEntityCache.has(payload)) {
+            return this._payloadEntityCache.get(payload) ?? null;
+        }
+        const entityName = payload?.entityName;
+        if (!entityName) {
+            this._payloadEntityCache.set(payload, null);
+            return null;
+        }
+        const entity = entityLookup
+            ? (entityLookup(entityName) ?? null)
+            : (new Metadata().EntityByName(entityName) ?? null); // global-provider-ok: subscription broadcast provider resolves server-wide entity metadata once per event
+        this._payloadEntityCache.set(payload, entity);
+        return entity;
+    }
+    /**
+     * Evaluates whether `user` has entity-level read permission for `payload`, memoized by
+     * `(payload, entityName, roleFingerprint)` so $N$ subscribers sharing $R$ role combinations
+     * only run `GetUserPermisions` $R$ times per event.
+     */
+    EvaluateEntityReadAccess(payload, user, entityLookup) {
+        if (!user) {
+            return false;
+        }
+        const entityName = payload?.entityName;
+        if (!this.ShouldBroadcastEntity(entityName)) {
+            return false;
+        }
+        const entity = this.ResolveEntityForPayload(payload, entityLookup);
+        if (!entity) {
+            // Unknown entity: deliver rather than leaving client cache silently stale
+            return true;
+        }
+        // Only coalesce across users when UserRoles is an array; mock users without UserRoles
+        // in isolated unit tests are evaluated directly.
+        if (!Array.isArray(user.UserRoles)) {
+            return entity.GetUserPermisions(user).CanRead;
+        }
+        let bucketMap = this._payloadFilterMemo.get(payload);
+        if (!bucketMap) {
+            bucketMap = new Map();
+            this._payloadFilterMemo.set(payload, bucketMap);
+        }
+        const bucketKey = `${entity.Name.toLowerCase()}::${this.GetRoleFingerprint(user)}`;
+        const cached = bucketMap.get(bucketKey);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const canRead = entity.GetUserPermisions(user).CanRead;
+        bucketMap.set(bucketKey, canRead);
+        return canRead;
+    }
+    /**
+     * Evaluates whether every read permission the user holds on `entity` is gated by a
+     * Row-Level Security filter (`ReadRLSFilterID`).
+     */
+    ReadIsRowFiltered(entity, user) {
+        const roles = new Set((user.UserRoles ?? []).map((role) => (role.RoleID ?? '').trim().toLowerCase()));
+        let filteredReads = 0;
+        for (const row of entity.Permissions) {
+            if (!row.CanRead)
+                continue;
+            const isDeny = row.IsDeny ?? (row.Type ?? 'Allow').trim().toLowerCase() === 'deny';
+            if (isDeny)
+                continue;
+            if (!roles.has((row.RoleID ?? '').trim().toLowerCase()))
+                continue;
+            if (!row.ReadRLSFilterID)
+                return false;
+            filteredReads += 1;
+        }
+        return filteredReads > 0;
+    }
+    /**
+     * Shapes a `CacheInvalidationPayload` into a `CacheInvalidationNotification` for `user` and `entity`.
+     * When `user` and `entity` are present and `user.UserRoles` is populated, the shaped object is
+     * memoized per `(payload, entity, roleFingerprint)` so $N$ subscribers sharing $R$ role buckets
+     * only allocate and evaluate `ReadIsRowFiltered` $R$ times per event.
+     */
+    ShapeEventForSubscriber(payload, user, entity) {
+        if (!user || !entity || !Array.isArray(user.UserRoles)) {
+            const withholdKey = !!user && !!entity && this.ReadIsRowFiltered(entity, user);
+            return this.buildNotification(payload, withholdKey);
+        }
+        let entityMap = this._payloadShapeMemo.get(payload);
+        if (!entityMap) {
+            entityMap = new WeakMap();
+            this._payloadShapeMemo.set(payload, entityMap);
+        }
+        let roleMap = entityMap.get(entity);
+        if (!roleMap) {
+            roleMap = new Map();
+            entityMap.set(entity, roleMap);
+        }
+        const fingerprint = this.GetRoleFingerprint(user);
+        const existing = roleMap.get(fingerprint);
+        if (existing) {
+            return existing;
+        }
+        const withholdKey = this.ReadIsRowFiltered(entity, user);
+        const shaped = this.buildNotification(payload, withholdKey);
+        roleMap.set(fingerprint, shaped);
+        return shaped;
+    }
+    /**
+     * Assigns the next monotonic sequence number to `payload` (if not already stamped on this server),
+     * appends it to the bounded circular ring buffer, and invokes `OnInvalidationRecorded` for
+     * provider-specific fan-out.
+     */
+    RecordInvalidation(payload) {
+        if (!this.ShouldBroadcastEntity(payload.entityName)) {
+            return payload;
+        }
+        if (this._ringBuffer.length === 0) {
+            this.Configure(this._config);
+        }
+        const seq = ++this._currentSequence;
+        payload.sequence = seq;
+        const writeIndex = (this._ringHead + this._ringCount) % this._maxRingBufferSize;
+        if (this._ringCount < this._maxRingBufferSize) {
+            this._ringBuffer[writeIndex] = { Sequence: seq, Payload: payload };
+            this._ringCount++;
+        }
+        else {
+            // Buffer full: overwrite oldest at _ringHead and advance head
+            this._ringBuffer[this._ringHead] = { Sequence: seq, Payload: payload };
+            this._ringHead = (this._ringHead + 1) % this._maxRingBufferSize;
+        }
+        void this.OnInvalidationRecorded(payload);
+        return payload;
+    }
+    /**
+     * Returns all permission-allowed, RLS-shaped invalidation events strictly after `sinceSequence`
+     * for `user`. If `sinceSequence` has already been evicted from the ring buffer (or lies in the
+     * future due to a server restart), sets `RequiresFullRefresh: true` and returns an empty `Events` list.
+     */
+    GetChangesSince(sinceSequence, user) {
+        if (!user) {
+            return {
+                RequiresFullRefresh: true,
+                CurrentSequence: this._currentSequence,
+                ServerProcessID: this.ServerProcessID,
+                Events: [],
+            };
+        }
+        if (sinceSequence < 0 || sinceSequence > this._currentSequence) {
+            return {
+                RequiresFullRefresh: true,
+                CurrentSequence: this._currentSequence,
+                ServerProcessID: this.ServerProcessID,
+                Events: [],
+            };
+        }
+        if (sinceSequence === this._currentSequence) {
+            return {
+                RequiresFullRefresh: false,
+                CurrentSequence: this._currentSequence,
+                ServerProcessID: this.ServerProcessID,
+                Events: [],
+            };
+        }
+        if (this._ringCount === 0) {
+            return {
+                RequiresFullRefresh: true,
+                CurrentSequence: this._currentSequence,
+                ServerProcessID: this.ServerProcessID,
+                Events: [],
+            };
+        }
+        const oldestEntry = this._ringBuffer[this._ringHead];
+        if (!oldestEntry || sinceSequence < oldestEntry.Sequence - 1) {
+            return {
+                RequiresFullRefresh: true,
+                CurrentSequence: this._currentSequence,
+                ServerProcessID: this.ServerProcessID,
+                Events: [],
+            };
+        }
+        // Coalesce duplicate entity+PK events within the catch-up window (latest event wins)
+        const coalescedPayloads = new Map();
+        for (let i = 0; i < this._ringCount; i++) {
+            const idx = (this._ringHead + i) % this._maxRingBufferSize;
+            const entry = this._ringBuffer[idx];
+            if (!entry || entry.Sequence <= sinceSequence) {
+                continue;
+            }
+            const payload = entry.Payload;
+            if (!this.EvaluateEntityReadAccess(payload, user)) {
+                continue;
+            }
+            const entity = this.ResolveEntityForPayload(payload);
+            const shaped = this.ShapeEventForSubscriber(payload, user, entity);
+            // If key is withheld (RLS-filtered), coalesce at whole-entity granularity; otherwise entity + PK
+            const dedupKey = shaped.PrimaryKeyValues
+                ? `${shaped.EntityName.toLowerCase()}::pk::${shaped.PrimaryKeyValues}`
+                : `${shaped.EntityName.toLowerCase()}::all`;
+            coalescedPayloads.set(dedupKey, payload);
+        }
+        const events = [];
+        for (const payload of coalescedPayloads.values()) {
+            const entity = this.ResolveEntityForPayload(payload);
+            events.push(this.ShapeEventForSubscriber(payload, user, entity));
+        }
+        return {
+            RequiresFullRefresh: false,
+            CurrentSequence: this._currentSequence,
+            ServerProcessID: this.ServerProcessID,
+            Events: events,
+        };
+    }
+    /**
+     * Resets the sequence counter and ring buffer. Intended for unit tests.
+     */
+    ResetStateForTesting() {
+        this._currentSequence = 0;
+        this._ringHead = 0;
+        this._ringCount = 0;
+        this._ringBuffer = new Array(this._maxRingBufferSize);
+    }
+    buildNotification(payload, withholdKey) {
+        const notification = {
+            EntityName: payload.entityName,
+            PrimaryKeyValues: withholdKey ? undefined : (payload.primaryKeyValues ?? undefined),
+            Action: payload.action,
+            SourceServerID: payload.sourceServerId,
+            Timestamp: payload.timestamp,
+            OriginSessionID: payload.originSessionId ?? undefined,
+            RecordData: withholdKey ? undefined : (payload.recordData ?? undefined),
+        };
+        if (payload.sequence !== undefined) {
+            notification.Sequence = payload.sequence;
+        }
+        return notification;
+    }
+}
+/**
+ * Process-wide singleton managing the active {@link BaseCacheInvalidationBroadcastProvider}.
+ *
+ * Uses `MJGlobal.Instance.ClassFactory` to instantiate the configured provider class
+ * (defaulting to `'SequencedRoleBucket'`).
+ */
+export class CacheInvalidationBroadcastManager extends BaseSingleton {
+    constructor() {
+        super();
+        this._provider = null;
+        this._fallbackFactory = null;
+    }
+    static get Instance() {
+        return super.getInstance();
+    }
+    /**
+     * Registers the default fallback provider factory so `Provider` is always available even
+     * before `Configure()` is explicitly called.
+     */
+    RegisterDefaultProviderFactory(factory) {
+        this._fallbackFactory = factory;
+    }
+    /**
+     * Returns the active broadcast provider, lazily instantiating the default
+     * `SequencedRoleBucketBroadcastProvider` if not yet configured.
+     */
+    get Provider() {
+        if (!this._provider) {
+            this.Configure();
+        }
+        return this._provider;
+    }
+    /**
+     * Configures and activates a broadcast provider via `MJGlobal.Instance.ClassFactory`.
+     */
+    Configure(config) {
+        const driverKey = config?.provider?.trim() || 'SequencedRoleBucket';
+        let instance = MJGlobal.Instance.ClassFactory.CreateInstance(BaseCacheInvalidationBroadcastProvider, driverKey);
+        if (!instance && this._fallbackFactory) {
+            instance = this._fallbackFactory();
+        }
+        if (!instance) {
+            throw new Error(`Failed to instantiate BaseCacheInvalidationBroadcastProvider for driver '${driverKey}'.`);
+        }
+        instance.Configure(config);
+        this._provider = instance;
+        return instance;
+    }
+    /**
+     * Explicitly sets the active provider instance (useful for testing or custom programmatic wiring).
+     */
+    SetProvider(provider) {
+        this._provider = provider;
+    }
+}
+//# sourceMappingURL=BaseCacheInvalidationBroadcastProvider.js.map

package/dist/broadcast/BaseCacheInvalidationBroadcastProvider.js.map

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

package/dist/broadcast/index.d.ts

@@ -0,0 +1,6 @@
+export * from './BaseCacheInvalidationBroadcastProvider.js';
+export * from './providers/SequencedRoleBucketBroadcastProvider.js';
+export * from './providers/AzureWebPubSubBroadcastProvider.js';
+export * from './providers/AWSIoTCoreBroadcastProvider.js';
+export * from './providers/GCPPubSubBroadcastProvider.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/broadcast/index.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qDAAqD,CAAC;AACpE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC"}

package/dist/broadcast/index.js

@@ -0,0 +1,6 @@
+export * from './BaseCacheInvalidationBroadcastProvider.js';
+export * from './providers/SequencedRoleBucketBroadcastProvider.js';
+export * from './providers/AzureWebPubSubBroadcastProvider.js';
+export * from './providers/AWSIoTCoreBroadcastProvider.js';
+export * from './providers/GCPPubSubBroadcastProvider.js';
+//# sourceMappingURL=index.js.map

package/dist/broadcast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/broadcast/index.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qDAAqD,CAAC;AACpE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC"}

package/dist/broadcast/providers/AWSIoTCoreBroadcastProvider.d.ts

@@ -0,0 +1,43 @@
+import { UserInfo } from '@memberjunction/core';
+import { BaseCacheInvalidationBroadcastProvider, CacheBroadcastNegotiationResult, CacheInvalidationBroadcastTopology } from '../BaseCacheInvalidationBroadcastProvider.js';
+import type { CacheInvalidationNotification, CacheInvalidationPayload } from '../../generic/CacheInvalidationResolver.js';
+/**
+ * Envelope published to an AWS IoT Core MQTT role topic.
+ */
+export interface AWSIoTCoreTopicMessage {
+    Topic: string;
+    QoS: 0 | 1;
+    Event: CacheInvalidationNotification;
+}
+/**
+ * Transport callback used by {@link AWSIoTCoreBroadcastProvider} to publish a shaped
+ * invalidation notification to an AWS IoT Core MQTT topic.
+ */
+export type AWSIoTCoreTopicPublisher = (message: AWSIoTCoreTopicMessage) => Promise<void>;
+/**
+ * Topology 3 Cloud Multiplexer Provider for **AWS IoT Core MQTT over WebSockets** (`'AWSIoTCore'`).
+ *
+ * Offloads per-client WebSocket connection management and message fan-out from MJServer
+ * to AWS IoT Core's managed MQTT message broker:
+ * - Each authenticated browser client calls `NegotiateCacheBroadcastConnection` to obtain
+ *   a SigV4-presigned `wss://<endpoint>/mqtt` URL and its authorized MQTT topic list
+ *   (`<topicPrefix>/roles/<RoleID>`).
+ * - When an entity mutation occurs, MJServer shapes the invalidation payload once per
+ *   authorized role on the entity and publishes to `<topicPrefix>/roles/<RoleID>`.
+ */
+export declare class AWSIoTCoreBroadcastProvider extends BaseCacheInvalidationBroadcastProvider {
+    private _topicPublisher;
+    get Topology(): CacheInvalidationBroadcastTopology;
+    /**
+     * Installs a custom MQTT topic publisher (e.g., AWS SDK `IoTDataPlaneClient` adapter or test spy).
+     */
+    SetTopicPublisher(publisher: AWSIoTCoreTopicPublisher | null): void;
+    /**
+     * Computes the MQTT topic filters (`<topicPrefix>/roles/<roleId>`) for a user's roles.
+     */
+    GetAuthorizedTopicsForUser(user: UserInfo): string[];
+    protected OnInvalidationRecorded(payload: CacheInvalidationPayload): Promise<void>;
+    NegotiateClientConnection(user: UserInfo, defaultGraphQLWsUrl?: string): Promise<CacheBroadcastNegotiationResult>;
+    private buildSigV4PresignedMqttUrl;
+}
+//# sourceMappingURL=AWSIoTCoreBroadcastProvider.d.ts.map

package/dist/broadcast/providers/AWSIoTCoreBroadcastProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AWSIoTCoreBroadcastProvider.d.ts","sourceRoot":"","sources":["../../../src/broadcast/providers/AWSIoTCoreBroadcastProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACH,sCAAsC,EACtC,+BAA+B,EAC/B,kCAAkC,EACrC,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EACR,6BAA6B,EAC7B,wBAAwB,EAC3B,MAAM,4CAA4C,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACX,KAAK,EAAE,6BAA6B,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,qBACa,2BAA4B,SAAQ,sCAAsC;IACnF,OAAO,CAAC,eAAe,CAAyC;IAEhE,IAAoB,QAAQ,IAAI,kCAAkC,CAEjE;IAED;;OAEG;IACI,iBAAiB,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI,GAAG,IAAI;IAI1E;;OAEG;IACI,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE;cAclC,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3E,yBAAyB,CAC3C,IAAI,EAAE,QAAQ,EACd,mBAAmB,SAAa,GACjC,OAAO,CAAC,+BAA+B,CAAC;IAmC3C,OAAO,CAAC,0BAA0B;CA4CrC"}