@brightchain/brightchain-lib 0.29.26 → 0.30.1

package/src/lib/services/communication/serverService.js

@@ -0,0 +1,495 @@
+"use strict";
+/**
+ * ServerService — manages server lifecycle, membership, and channel organization.
+ *
+ * Maintains in-memory stores for servers. When an IChatStorageProvider is
+ * injected, servers are also persisted to the provider's collections (write-through).
+ * Without a provider (e.g. in unit tests), services fall back to in-memory Maps.
+ *
+ * Requirements: 1.1, 1.3, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerService = exports.ServerInviteExpiredError = exports.ServerInviteNotFoundError = exports.MemberAlreadyInServerError = exports.ServerNameValidationError = exports.NotServerMemberError = exports.ServerPermissionError = exports.ServerNotFoundError = void 0;
+const uuid_1 = require("uuid");
+const communication_1 = require("../../enumerations/communication");
+const events_1 = require("../../interfaces/events");
+const pagination_1 = require("../../utils/pagination");
+// ─── Error classes ──────────────────────────────────────────────────────────
+class ServerNotFoundError extends Error {
+    constructor(serverId) {
+        super(`Server ${serverId} not found`);
+        this.name = 'ServerNotFoundError';
+    }
+}
+exports.ServerNotFoundError = ServerNotFoundError;
+class ServerPermissionError extends Error {
+    constructor(message = 'You do not have permission to perform this action') {
+        super(message);
+        this.name = 'ServerPermissionError';
+    }
+}
+exports.ServerPermissionError = ServerPermissionError;
+class NotServerMemberError extends Error {
+    constructor() {
+        super('You are not a member of this server');
+        this.name = 'NotServerMemberError';
+    }
+}
+exports.NotServerMemberError = NotServerMemberError;
+class ServerNameValidationError extends Error {
+    constructor(message = 'Server name must be between 1 and 100 characters') {
+        super(message);
+        this.name = 'ServerNameValidationError';
+    }
+}
+exports.ServerNameValidationError = ServerNameValidationError;
+class MemberAlreadyInServerError extends Error {
+    constructor(memberId) {
+        super(`Member ${memberId} is already in this server`);
+        this.name = 'MemberAlreadyInServerError';
+    }
+}
+exports.MemberAlreadyInServerError = MemberAlreadyInServerError;
+class ServerInviteNotFoundError extends Error {
+    constructor(token) {
+        super(`Server invite token ${token} not found`);
+        this.name = 'ServerInviteNotFoundError';
+    }
+}
+exports.ServerInviteNotFoundError = ServerInviteNotFoundError;
+class ServerInviteExpiredError extends Error {
+    constructor() {
+        super('Server invite token has expired or exceeded max uses');
+        this.name = 'ServerInviteExpiredError';
+    }
+}
+exports.ServerInviteExpiredError = ServerInviteExpiredError;
+// ─── Service ────────────────────────────────────────────────────────────────
+class ServerService {
+    /** serverId → IServer */
+    servers = new Map();
+    /** token → IServerInviteToken */
+    serverInviteTokens = new Map();
+    channelService;
+    eventEmitter;
+    /** Optional persistent collection for servers (write-through). */
+    serverCollection;
+    /** Optional persistent collection for server invite tokens (write-through). */
+    serverInviteCollection;
+    /** Whether init() has already been called. */
+    initialized = false;
+    constructor(options) {
+        this.channelService = options.channelService;
+        this.eventEmitter = options.eventEmitter ?? new events_1.NullEventEmitter();
+        if (options.storageProvider) {
+            this.serverCollection = options.storageProvider.servers;
+            this.serverInviteCollection = options.storageProvider.serverInvites;
+        }
+    }
+    // ─── Rehydration ──────────────────────────────────────────────────────
+    /**
+     * Load persisted servers and server invite tokens back into in-memory Maps.
+     *
+     * Idempotent: only the first call performs rehydration. No-op when no
+     * storage provider was supplied at construction time.
+     *
+     * Requirements: 1.4, 1.5, 1.6, 5.1, 5.2, 8.1, 8.2, 9.1
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        if (!this.serverCollection)
+            return;
+        this.initialized = true;
+        // ── Load servers ──────────────────────────────────────────────────
+        let loadedServers;
+        try {
+            loadedServers = await this.serverCollection.findMany();
+        }
+        catch (error) {
+            console.error('[ServerService] Failed to load from servers collection:', error);
+            throw error;
+        }
+        for (const server of loadedServers) {
+            this.servers.set(server.id, server);
+        }
+        // ── Load server invite tokens ───────────────────────────────────
+        let loadedInvites;
+        try {
+            loadedInvites = await this.serverInviteCollection.findMany();
+        }
+        catch (error) {
+            console.error('[ServerService] Failed to load from serverInvites collection:', error);
+            throw error;
+        }
+        for (const invite of loadedInvites) {
+            this.serverInviteTokens.set(invite.token, invite);
+        }
+    }
+    // ─── Helpers ──────────────────────────────────────────────────────────
+    validateServerName(name) {
+        if (!name || name.length === 0 || name.length > 100) {
+            throw new ServerNameValidationError();
+        }
+    }
+    assertServerExists(serverId) {
+        const server = this.servers.get(serverId);
+        if (!server)
+            throw new ServerNotFoundError(serverId);
+        return server;
+    }
+    /**
+     * Returns the role of a member within a server.
+     * The server owner always has OWNER role; all other members have MEMBER role.
+     * Returns null if the user is not a member.
+     */
+    getMemberRole(serverId, memberId) {
+        const server = this.servers.get(serverId);
+        if (!server)
+            return null;
+        if (!server.memberIds.includes(memberId))
+            return null;
+        if (server.ownerId === memberId)
+            return communication_1.DefaultRole.OWNER;
+        return communication_1.DefaultRole.MEMBER;
+    }
+    assertCanUpdate(server, userId) {
+        const role = this.getMemberRole(server.id, userId);
+        if (role !== communication_1.DefaultRole.OWNER && role !== communication_1.DefaultRole.ADMIN) {
+            throw new ServerPermissionError('Only the server owner or admin can update this server');
+        }
+    }
+    assertCanDelete(server, userId) {
+        if (server.ownerId !== userId) {
+            throw new ServerPermissionError('Only the server owner can delete this server');
+        }
+    }
+    // ─── CRUD ─────────────────────────────────────────────────────────────
+    /**
+     * Create a new server with a default "General" category and "general" channel.
+     * The owner is added as the first member.
+     *
+     * Requirements: 1.1, 1.3, 2.1
+     */
+    async createServer(ownerId, params) {
+        this.validateServerName(params.name);
+        const now = new Date();
+        const serverId = (0, uuid_1.v4)();
+        const categoryId = (0, uuid_1.v4)();
+        // Create the default "general" channel via ChannelService
+        const generalChannel = await this.channelService.createChannel('general', ownerId, communication_1.ChannelVisibility.PUBLIC, '', serverId);
+        // serverId is already set by createChannel above
+        // Build the default "General" category
+        const defaultCategory = {
+            id: categoryId,
+            name: 'General',
+            position: 0,
+            channelIds: [generalChannel.id],
+        };
+        const server = {
+            id: serverId,
+            name: params.name,
+            iconUrl: params.iconUrl,
+            ownerId,
+            memberIds: [ownerId],
+            channelIds: [generalChannel.id],
+            categories: [defaultCategory],
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.servers.set(serverId, server);
+        // Persist to storage provider if available
+        if (this.serverCollection) {
+            await this.serverCollection.create(server);
+        }
+        return server;
+    }
+    /**
+     * Get a server by ID.
+     * Throws ServerNotFoundError if the server does not exist.
+     *
+     * Requirement: 2.3
+     */
+    async getServer(serverId) {
+        return this.assertServerExists(serverId);
+    }
+    /**
+     * Update server settings (name, iconUrl, categories).
+     * Only the owner or admin can update.
+     *
+     * Requirements: 2.4, 2.5
+     */
+    async updateServer(serverId, userId, update) {
+        const server = this.assertServerExists(serverId);
+        this.assertCanUpdate(server, userId);
+        if (update.name !== undefined) {
+            this.validateServerName(update.name);
+            server.name = update.name;
+        }
+        if (update.iconUrl !== undefined) {
+            server.iconUrl = update.iconUrl;
+        }
+        if (update.categories !== undefined) {
+            server.categories = update.categories;
+        }
+        server.updatedAt = new Date();
+        // Persist to storage provider if available
+        if (this.serverCollection) {
+            await this.serverCollection.update(serverId, server);
+        }
+        return server;
+    }
+    /**
+     * Delete a server and cascade-delete all its channels.
+     * Only the owner can delete.
+     *
+     * Requirements: 2.5, 2.6
+     */
+    async deleteServer(serverId, userId) {
+        const server = this.assertServerExists(serverId);
+        this.assertCanDelete(server, userId);
+        // Cascade delete all channels belonging to this server
+        for (const channelId of server.channelIds) {
+            try {
+                await this.channelService.deleteChannel(channelId, server.ownerId);
+            }
+            catch {
+                // Channel may already be deleted; continue cleanup
+            }
+        }
+        this.servers.delete(serverId);
+        // Persist deletion to storage provider if available
+        if (this.serverCollection) {
+            await this.serverCollection.delete(serverId);
+        }
+    }
+    /**
+     * List all servers where the given member is a member.
+     * Supports cursor-based pagination.
+     *
+     * Requirement: 2.2
+     */
+    async listServersForMember(memberId, pagination) {
+        const memberServers = Array.from(this.servers.values()).filter((s) => s.memberIds.includes(memberId));
+        // Sort by creation date descending (newest first)
+        memberServers.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+        return (0, pagination_1.paginateItems)(memberServers, pagination?.cursor, pagination?.limit ?? 50);
+    }
+    // ─── Membership ────────────────────────────────────────────────────────
+    /**
+     * Add members to a server. Only owner or admin can add members.
+     * Skips members who are already in the server. Returns the list of
+     * actually added member IDs.
+     *
+     * After adding, distributes channel keys for all server channels
+     * to each new member via ChannelService.addMemberToChannel().
+     *
+     * Requirements: 2.7, 6.1, 6.2, 6.3
+     */
+    async addMembers(serverId, userId, memberIds) {
+        const server = this.assertServerExists(serverId);
+        this.assertCanUpdate(server, userId);
+        const added = [];
+        for (const memberId of memberIds) {
+            if (!server.memberIds.includes(memberId)) {
+                server.memberIds.push(memberId);
+                added.push(memberId);
+            }
+        }
+        if (added.length > 0) {
+            // Distribute channel keys for all server channels to each new member
+            for (const memberId of added) {
+                for (const channelId of server.channelIds) {
+                    await this.channelService.addMemberToChannel(channelId, memberId);
+                }
+            }
+            server.updatedAt = new Date();
+            // Persist to storage provider if available
+            if (this.serverCollection) {
+                await this.serverCollection.update(serverId, server);
+            }
+        }
+        return added;
+    }
+    /**
+     * Remove a member from a server and all of its channels.
+     * Only owner or admin can remove members. Emits SERVER_MEMBER_REMOVED event.
+     *
+     * Delegates to ChannelService.removeMemberFromChannel() for each channel,
+     * which performs epoch-aware key rotation and removes the member's wrapped
+     * key entries from all epochs.
+     *
+     * Requirements: 2.8, 7.1, 7.2, 7.3
+     */
+    async removeMember(serverId, userId, memberId) {
+        const server = this.assertServerExists(serverId);
+        this.assertCanUpdate(server, userId);
+        // Remove from server memberIds
+        server.memberIds = server.memberIds.filter((id) => id !== memberId);
+        // Remove from all server channels via ChannelService (triggers key rotation)
+        for (const channelId of server.channelIds) {
+            await this.channelService.removeMemberFromChannel(channelId, memberId);
+        }
+        server.updatedAt = new Date();
+        // Persist to storage provider if available
+        if (this.serverCollection) {
+            await this.serverCollection.update(serverId, server);
+        }
+        this.eventEmitter.emitServerMemberRemoved(serverId, memberId);
+    }
+    // ─── Invites ──────────────────────────────────────────────────────────
+    /**
+     * Create an invite token for a server.
+     * Only members of the server can create invites.
+     * Generates a unique token with optional expiration and max-use limits.
+     *
+     * Requirements: 3.1
+     */
+    async createInvite(serverId, userId, params) {
+        const server = this.assertServerExists(serverId);
+        // Caller must be a member of the server
+        if (!server.memberIds.includes(userId)) {
+            throw new NotServerMemberError();
+        }
+        const now = new Date();
+        const invite = {
+            token: (0, uuid_1.v4)(),
+            serverId,
+            createdBy: userId,
+            createdAt: now,
+            expiresAt: params.expiresInMs
+                ? new Date(now.getTime() + params.expiresInMs)
+                : undefined,
+            maxUses: params.maxUses,
+            currentUses: 0,
+        };
+        this.serverInviteTokens.set(invite.token, invite);
+        // Persist to storage provider if available
+        if (this.serverInviteCollection) {
+            await this.serverInviteCollection.create(invite);
+        }
+        return invite;
+    }
+    /**
+     * Redeem an invite token to join a server.
+     * Validates the token belongs to the specified server, checks expiration
+     * and max-use limits, increments currentUses, and adds the user to the server.
+     *
+     * After joining, distributes channel keys for all server channels
+     * to the new member via ChannelService.addMemberToChannel().
+     *
+     * Requirements: 3.2, 3.3, 3.4, 6.1, 6.2, 6.3
+     */
+    async redeemInvite(serverId, token, userId) {
+        const invite = this.serverInviteTokens.get(token);
+        if (!invite) {
+            throw new ServerInviteNotFoundError(token);
+        }
+        // Validate the token belongs to the specified server
+        if (invite.serverId !== serverId) {
+            throw new ServerInviteNotFoundError(token);
+        }
+        // Check expiration
+        if (invite.expiresAt && new Date() >= invite.expiresAt) {
+            throw new ServerInviteExpiredError();
+        }
+        // Check max uses
+        if (invite.maxUses !== undefined && invite.currentUses >= invite.maxUses) {
+            throw new ServerInviteExpiredError();
+        }
+        const server = this.assertServerExists(serverId);
+        // Skip if already a member
+        if (server.memberIds.includes(userId)) {
+            throw new MemberAlreadyInServerError(userId);
+        }
+        // Add user to server
+        server.memberIds.push(userId);
+        server.updatedAt = new Date();
+        // Distribute channel keys for all server channels to the new member
+        for (const channelId of server.channelIds) {
+            await this.channelService.addMemberToChannel(channelId, userId);
+        }
+        // Increment usage
+        invite.currentUses++;
+        // Persist changes to storage provider if available
+        if (this.serverCollection) {
+            await this.serverCollection.update(serverId, server);
+        }
+        if (this.serverInviteCollection) {
+            await this.serverInviteCollection.update(invite.token, invite);
+        }
+    }
+    // ─── Channel management within server ────────────────────────────────
+    /**
+     * Create a channel within a server.
+     * Validates caller has owner/admin role, creates the channel via ChannelService,
+     * sets serverId on the channel, adds channelId to server.channelIds,
+     * adds to specified category (or first category if not specified),
+     * and emits SERVER_CHANNEL_CREATED event.
+     *
+     * Requirements: 1.3, 1.4, 7.2
+     */
+    async createChannelInServer(serverId, userId, params, categoryId) {
+        const server = this.assertServerExists(serverId);
+        this.assertCanUpdate(server, userId);
+        // Create the channel via ChannelService
+        const channel = await this.channelService.createChannel(params.name, userId, params.visibility, params.topic ?? '', serverId);
+        // serverId is already set by createChannel above
+        // Add channelId to server's channelIds
+        server.channelIds.push(channel.id);
+        // Determine target category
+        let targetCategory;
+        if (categoryId) {
+            targetCategory = server.categories.find((c) => c.id === categoryId);
+        }
+        if (!targetCategory && server.categories.length > 0) {
+            targetCategory = server.categories[0];
+        }
+        const resolvedCategoryId = targetCategory?.id ?? '';
+        if (targetCategory) {
+            targetCategory.channelIds.push(channel.id);
+        }
+        server.updatedAt = new Date();
+        // Persist to storage provider if available
+        if (this.serverCollection) {
+            await this.serverCollection.update(serverId, server);
+        }
+        this.eventEmitter.emitServerChannelCreated(serverId, channel.id, channel.name, resolvedCategoryId);
+        return channel;
+    }
+    /**
+     * Remove a channel from a server.
+     * Validates caller has owner/admin role, deletes the channel via ChannelService,
+     * removes channelId from server.channelIds and from category.channelIds,
+     * and emits SERVER_CHANNEL_DELETED event.
+     *
+     * Requirements: 1.3, 1.4, 7.2
+     */
+    async removeChannelFromServer(serverId, channelId, userId) {
+        const server = this.assertServerExists(serverId);
+        this.assertCanUpdate(server, userId);
+        // Delete the channel via ChannelService
+        await this.channelService.deleteChannel(channelId, userId);
+        // Remove channelId from server's channelIds
+        server.channelIds = server.channelIds.filter((id) => id !== channelId);
+        // Remove from any category that contains it
+        for (const category of server.categories) {
+            category.channelIds = category.channelIds.filter((id) => id !== channelId);
+        }
+        server.updatedAt = new Date();
+        // Persist to storage provider if available
+        if (this.serverCollection) {
+            await this.serverCollection.update(serverId, server);
+        }
+        this.eventEmitter.emitServerChannelDeleted(serverId, channelId);
+    }
+    // ─── Accessors (for testing / internal use) ───────────────────────────
+    getServerById(serverId) {
+        return this.servers.get(serverId);
+    }
+    getInviteToken(token) {
+        return this.serverInviteTokens.get(token);
+    }
+}
+exports.ServerService = ServerService;
+//# sourceMappingURL=serverService.js.map

package/src/lib/services/communication/serverService.js.map

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

package/src/lib/services/copyOnWrite.service.d.ts

@@ -0,0 +1,110 @@
+import { Member, type PlatformID } from '@digitaldefiance/ecies-lib';
+import { ConstituentBlockListBlock } from '../blocks/cbl';
+import { ExtendedCBL } from '../blocks/extendedCbl';
+import { InMemoryBlockTuple } from '../blocks/memoryTuple';
+import { RandomBlock } from '../blocks/random';
+import { WhitenedBlock } from '../blocks/whitened';
+import { BlockSize } from '../enumerations/blockSize';
+import { Checksum } from '../types/checksum';
+import type { CBLService } from './cblService';
+import type { ChecksumService } from './checksum.service';
+/**
+ * Result of a CopyOnWrite operation.
+ * Contains the new CBL and metadata about what changed.
+ */
+export interface CopyOnWriteResult<TID extends PlatformID = Uint8Array> {
+    /** The new CBL referencing both reused and new blocks */
+    cbl: ConstituentBlockListBlock<TID> | ExtendedCBL<TID>;
+    /** Number of tuples reused from the original CBL */
+    reusedTupleCount: number;
+    /** Number of new tuples created for changed data */
+    newTupleCount: number;
+    /** Total number of tuples in the new CBL */
+    totalTupleCount: number;
+}
+/**
+ * Options for the CopyOnWrite operation.
+ */
+export interface CopyOnWriteOptions {
+    /** If true, create an ExtendedCBL with file metadata */
+    createExtendedCbl?: boolean;
+    /** File name for ExtendedCBL */
+    fileName?: string;
+    /** MIME type for ExtendedCBL */
+    mimeType?: string;
+}
+/**
+ * CopyOnWriteService provides efficient versioning for CBL-based data.
+ *
+ * When data changes, instead of re-creating all blocks from scratch, this service:
+ * 1. Reads the new data in block-sized chunks
+ * 2. Compares each chunk against the corresponding original block data
+ *    (recovered by XORing the tuple's constituent blocks)
+ * 3. Reuses the original tuple addresses for unchanged blocks
+ * 4. Creates new tuples only for blocks whose data has changed
+ * 5. Produces a new CBL that references both old (reused) and new block addresses
+ *
+ * This is analogous to copy-on-write in operating systems: we share unchanged
+ * pages and only allocate new storage for modified pages.
+ *
+ * The tuple size (typically 3) means each "logical block" in the CBL is
+ * represented by `tupleSize` addresses. When we say "reuse a tuple," we
+ * mean we copy all `tupleSize` addresses from the old CBL into the new one.
+ *
+ * @typeParam TID - The platform ID type (defaults to Uint8Array)
+ */
+export declare class CopyOnWriteService<TID extends PlatformID = Uint8Array> {
+    private readonly checksumService;
+    private readonly cblService;
+    constructor(checksumService?: ChecksumService, cblService?: CBLService<TID>);
+    /**
+     * Create a new version of a CBL by applying changes from new data,
+     * reusing unchanged blocks from the original CBL.
+     *
+     * @param originalCbl - The existing CBL to base the new version on
+     * @param newData - The complete new data as a Uint8Array
+     * @param creator - The member creating the new version
+     * @param blockSize - The block size to use (must match the original CBL's block size)
+     * @param getBlockData - Function to retrieve raw block data by checksum from the store
+     * @param whitenedBlockSource - Function to get whitened blocks for new tuples
+     * @param randomBlockSource - Function to get random blocks for new tuples
+     * @param persistTuple - Function to persist newly created tuples
+     * @param options - Optional settings for extended CBL creation
+     * @returns The new CBL and statistics about reuse
+     */
+    newVersion(originalCbl: ConstituentBlockListBlock<TID>, newData: Uint8Array, creator: Member<TID>, blockSize: BlockSize, getBlockData: (checksum: Checksum) => Promise<Uint8Array>, whitenedBlockSource: () => WhitenedBlock | undefined, randomBlockSource: () => RandomBlock, persistTuple: (tuple: InMemoryBlockTuple) => Promise<void>, options?: CopyOnWriteOptions): Promise<CopyOnWriteResult<TID>>;
+    /**
+     * Recover the original plaintext data from a tuple by XORing all
+     * constituent blocks together.
+     *
+     * In the OFF system, a tuple of `tupleSize` blocks is stored such that
+     * XORing all blocks together recovers the original data:
+     *   plaintext = block[0] XOR block[1] XOR ... XOR block[tupleSize-1]
+     *
+     * @param tupleAddresses - The checksums of the blocks in the tuple
+     * @param getBlockData - Function to retrieve raw block data by checksum
+     * @returns The recovered plaintext data
+     */
+    private recoverTupleData;
+    /**
+     * Compare two block-sized byte arrays for equality.
+     * Uses constant-length comparison (always checks all bytes).
+     */
+    private blocksEqual;
+    /**
+     * Create a new tuple for a data block by XORing it with whitener/random blocks,
+     * then persist the tuple.
+     *
+     * @returns The checksums of all blocks in the new tuple (in order)
+     */
+    private createNewTuple;
+    /**
+     * Convert an array of Checksums to a concatenated Uint8Array buffer.
+     */
+    private addressesToBuffer;
+    /**
+     * Helper to convert a Readable stream to Uint8Array.
+     */
+    private streamToUint8Array;
+}
+//# sourceMappingURL=copyOnWrite.service.d.ts.map

package/src/lib/services/copyOnWrite.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyOnWrite.service.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/services/copyOnWrite.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IACpE,yDAAyD;IACzD,GAAG,EAAE,yBAAyB,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACvD,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;gBAG3C,eAAe,CAAC,EAAE,eAAe,EACjC,UAAU,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC;IAQ9B;;;;;;;;;;;;;;OAcG;IACU,UAAU,CACrB,WAAW,EAAE,yBAAyB,CAAC,GAAG,CAAC,EAC3C,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EACpB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,EACzD,mBAAmB,EAAE,MAAM,aAAa,GAAG,SAAS,EACpD,iBAAiB,EAAE,MAAM,WAAW,EACpC,YAAY,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EAC1D,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IA0HlC;;;;;;;;;;;OAWG;YACW,gBAAgB;IA2B9B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;;;OAKG;YACW,cAAc;IAkD5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;YACW,kBAAkB;CAcjC"}