@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/member-search-workflow.js

@@ -0,0 +1,143 @@
+/**
+ * Member search workflows: Bounded traversal over member search pages.
+ * Invariant: Traversal combines existing page operations with bounded work and retains no roster.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import * as Effect from "effect/Effect";
+import { GuildOperationError, Permissions } from "#sdk/guilds";
+import { PaginationError } from "#sdk/pagination";
+import { guildFetch, memberSelf, roleList } from "./guilds.js";
+import { calculatePermissions } from "./permissions.js";
+import { encodeMemberSearchQuery, memberSearch } from "./member-search.js";
+import { Pagination } from "./pagination.js";
+import { suspendInput } from "./defects.js";
+import { identifier, record } from "./decode/primitives.js";
+import { InputValidationFailure, inputValidationFailure, unsupportedKeyFailure } from "#sdk/input-validation";
+const positive = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+/** Search may enqueue indexing, so the shared REST owner's POST retry policy remains unchanged */
+export function searchMembers(owner, guildId, query, options) {
+    const invalid = (failure) => Effect.fail(new GuildOperationError({
+        operation: "members.search",
+        reason: "input",
+        outcome: "notDispatched",
+        inputValidation: failure.detail,
+    }));
+    // Reading and validating the caller query and options is marked as application input
+    return suspendInput(() => {
+        const request = memberSearch(guildId, query);
+        if (request instanceof InputValidationFailure)
+            return invalid(request);
+        if (options !== undefined && !record(options))
+            return invalid(inputValidationFailure("options", "type", "Member search options must be an object"));
+        const unsupported = record(options)
+            ? unsupportedKeyFailure(options, ["timeoutMs", "signal"], "options", "the member search options")
+            : undefined;
+        if (unsupported)
+            return invalid(unsupported);
+        const timeoutInput = options?.timeoutMs;
+        const timeout = timeoutInput === undefined ? (owner.defaultTimeoutMs ?? 30_000) : timeoutInput;
+        if (!positive(timeout) || timeout > 2_147_483_647)
+            return invalid(inputValidationFailure("options.timeoutMs", "range", "Member search timeout must be an integer from 1 through 2,147,483,647 ms"));
+        return Effect.succeed([request, timeout]);
+    }).pipe(Effect.flatMap(([request, timeout]) => searchValidated(owner, guildId, request, timeout)));
+}
+/** Run one validated member search, checking Manage Guild first when the filters select sensitive join sources */
+function searchValidated(owner, guildId, request, timeout) {
+    return Effect.gen(function* () {
+        const body = JSON.parse(request.json);
+        const sensitive = (body.join_source_type?.length ?? 0) > 0 || (body.source_invite_code?.length ?? 0) > 0;
+        const now = () => owner.logical.now();
+        const deadline = now() + timeout;
+        const remaining = () => Effect.suspend(() => {
+            const left = Math.ceil(deadline - now());
+            return left > 0
+                ? Effect.succeed({ timeoutMs: left })
+                : Effect.fail(new GuildOperationError({
+                    operation: "members.search",
+                    reason: "timeout",
+                    outcome: "notDispatched",
+                }));
+        });
+        if (sensitive) {
+            const [member, guild, roles] = yield* Effect.all([
+                remaining().pipe(Effect.flatMap((options) => owner.guild("members.fetchSelf", () => memberSelf(guildId), options))),
+                remaining().pipe(Effect.flatMap((options) => owner.guild("guilds.fetch", () => guildFetch(guildId), options))),
+                remaining().pipe(Effect.flatMap((options) => owner.guild("roles.fetchAll", () => roleList(guildId), options))),
+            ], { concurrency: 3 });
+            const bits = yield* calculatePermissions({ guild, member, roles });
+            if ((bits & Permissions.ManageGuild) !== Permissions.ManageGuild)
+                return yield* Effect.fail(new GuildOperationError({
+                    operation: "members.search",
+                    reason: "rejected",
+                    outcome: "notDispatched",
+                }));
+        }
+        return yield* owner.guild("members.search", () => request, yield* remaining());
+    });
+}
+export function searchMemberPagination(owner, guildId, filters, limits, options) {
+    // Reading and validating the caller filters, limits and options is marked as application input
+    return suspendInput(() => {
+        const invalid = (failure) => Effect.fail(new PaginationError({
+            operation: "members.iterateSearch",
+            reason: "input",
+            inputValidation: failure.detail,
+        }));
+        if (!record(filters))
+            return invalid(inputValidationFailure("filters", "type", "Member search filters must be an object"));
+        if ("limit" in filters)
+            return invalid(inputValidationFailure("filters", "allowedFields", "Member search iteration filters cannot contain limit"));
+        if (!record(limits))
+            return invalid(inputValidationFailure("limits", "type", "Member search limits must be an object"));
+        const unsupportedLimit = unsupportedKeyFailure(limits, ["maxItems", "maxPages", "pageSize"], "limits", "the member search limits");
+        if (unsupportedLimit)
+            return invalid(unsupportedLimit);
+        const maxItems = limits.maxItems;
+        if (!positive(maxItems))
+            return invalid(inputValidationFailure("limits.maxItems", "range", "The limit maxItems is required and must be a positive safe integer"));
+        if (options !== undefined && !record(options))
+            return invalid(inputValidationFailure("options", "type", "Member search options must be an object"));
+        // The native Effect API cancels by interruption, so its options have no signal
+        const unsupportedOption = record(options)
+            ? unsupportedKeyFailure(options, ["timeoutMs"], "options", "the member search options")
+            : undefined;
+        if (unsupportedOption)
+            return invalid(unsupportedOption);
+        const pageSize = limits.pageSize === undefined ? 100 : limits.pageSize, maxPages = limits.maxPages === undefined ? 100 : limits.maxPages;
+        if (!positive(pageSize) || pageSize > 100)
+            return invalid(inputValidationFailure("limits.pageSize", "range", "The limit pageSize must be an integer from 1 through 100"));
+        if (!positive(maxPages))
+            return invalid(inputValidationFailure("limits.maxPages", "range", "The limit maxPages must be a positive safe integer"));
+        const timeoutMs = options?.timeoutMs;
+        if (timeoutMs !== undefined && (!positive(timeoutMs) || timeoutMs > 2_147_483_647))
+            return invalid(inputValidationFailure("options.timeoutMs", "range", "Member search timeout must be an integer from 1 through 2,147,483,647 ms"));
+        if (!identifier(guildId))
+            return invalid(inputValidationFailure("guildId", "format", "Guild IDs must be decimal strings"));
+        const validated = encodeMemberSearchQuery(filters);
+        if (validated instanceof InputValidationFailure)
+            return invalid(validated);
+        const copied = validated.query;
+        const requestOptions = timeoutMs === undefined ? {} : { timeoutMs };
+        const source = {
+            identity: (hit) => hit.userId,
+            load: (cursor, limit) => Effect.gen(function* () {
+                const offset = cursor === undefined ? 0 : Number(cursor);
+                const page = yield* searchMembers(owner, guildId, { ...copied, offset, limit }, requestOptions);
+                if (page.indexing)
+                    return yield* Effect.fail(new PaginationError({ operation: "members.iterateSearch", reason: "indexing" }));
+                const next = offset + page.members.length;
+                if (!Number.isSafeInteger(next) || (page.members.length === 0 && offset < page.totalResultCount))
+                    return yield* Effect.fail(new PaginationError({ operation: "members.iterateSearch", reason: "cursorStalled" }));
+                return { items: page.members, next: next >= page.totalResultCount ? null : String(next) };
+            }),
+        };
+        return Effect.succeed(() => new Pagination(owner, "members.iterateSearch", {
+            maxItems,
+            maxPages,
+            pageSize,
+            cursor: String(copied.offset ?? 0),
+            options: requestOptions,
+        }, source));
+    }).pipe(Effect.map((create) => create()));
+}
+//# sourceMappingURL=member-search-workflow.js.map

package/dist/internal/member-search-workflow.js.map

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

package/dist/internal/member-search.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Member search requests and page projection.
+ * Invariant: Queries are validated locally, and pages are decoded completely before any result is returned.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import { type MemberSearchPage, type MemberSearchQuery } from "#sdk/member-search";
+import type { GuildRequest } from "./guilds.js";
+import { InputValidationFailure } from "#sdk/input-validation";
+interface EncodedMemberSearchQuery {
+    readonly limit: number;
+    readonly offset: number;
+    readonly json: string;
+    readonly query: MemberSearchQuery;
+}
+/** Validates and encodes one provider page request, preserving provider defaults without retaining caller input */
+export declare function encodeMemberSearchQuery(query?: unknown): EncodedMemberSearchQuery | InputValidationFailure;
+/** Builds a remote-only POST page request. It omits cache admission and therefore cannot populate partial indexed hits */
+export declare function memberSearch(guildId: string, query?: MemberSearchQuery): GuildRequest<MemberSearchPage> | InputValidationFailure;
+export {};
+//# sourceMappingURL=member-search.d.ts.map

package/dist/internal/member-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-search.d.ts","sourceRoot":"","sources":["../../src/internal/member-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAIH,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EAAE,sBAAsB,EAAiD,MAAM,uBAAuB,CAAA;AAmB7G,UAAU,wBAAwB;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CACpC;AA4BD,mHAAmH;AACnH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,wBAAwB,GAAG,sBAAsB,CA8G1G;AA6ED,0HAA0H;AAC1H,wBAAgB,YAAY,CACxB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,iBAAiB,GAC1B,YAAY,CAAC,gBAAgB,CAAC,GAAG,sBAAsB,CAazD"}

package/dist/internal/member-search.js

@@ -0,0 +1,201 @@
+/**
+ * Member search requests and page projection.
+ * Invariant: Queries are validated locally, and pages are decoded completely before any result is returned.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import { GuildMemberJoinSourceTypes, } from "#sdk/member-search";
+import { identifier, nonNegativeInteger, record, snapshotArray } from "./decode/primitives.js";
+import { InputValidationFailure, inputValidationFailure, unsupportedKeyFailure } from "#sdk/input-validation";
+const joinSourceTypeValues = new Set(Object.values(GuildMemberJoinSourceTypes));
+const queryKeys = new Set([
+    "query",
+    "limit",
+    "offset",
+    "roleIds",
+    "joinedAtAfterSeconds",
+    "joinedAtBeforeSeconds",
+    "userCreatedAtAfterSeconds",
+    "userCreatedAtBeforeSeconds",
+    "joinSourceTypes",
+    "sourceInviteCodes",
+    "isBot",
+    "sortBy",
+    "sortOrder",
+]);
+const joinSourceType = (value) => typeof value === "number" && joinSourceTypeValues.has(value);
+const nullableText = (value) => value === null || typeof value === "string";
+const nullableIdentifier = (value) => value === null || identifier(value);
+function identifiers(value, maximum) {
+    const items = snapshotArray(value, maximum);
+    if (!items)
+        return undefined;
+    return items.every(identifier) && new Set(items).size === items.length ? Object.freeze(items) : undefined;
+}
+function texts(value, maximum) {
+    const items = snapshotArray(value, maximum);
+    if (!items)
+        return undefined;
+    return items.every((item) => typeof item === "string") && new Set(items).size === items.length
+        ? Object.freeze(items)
+        : undefined;
+}
+function joinSourceTypes(value) {
+    const items = snapshotArray(value, 10);
+    if (!items)
+        return undefined;
+    return items.every(joinSourceType) && new Set(items).size === items.length ? Object.freeze(items) : undefined;
+}
+/** Validates and encodes one provider page request, preserving provider defaults without retaining caller input */
+export function encodeMemberSearchQuery(query) {
+    const supplied = query === undefined ? {} : query;
+    if (!record(supplied))
+        return inputValidationFailure("query", "type", "Member search query must be an object");
+    const unsupported = unsupportedKeyFailure(supplied, [...queryKeys], "query", "the member search query");
+    if (unsupported)
+        return unsupported;
+    // Read recognized properties once, regardless of ownership or enumerability
+    const input = Object.fromEntries(Array.from(queryKeys, (key) => [key, supplied[key]]));
+    const limit = input.limit === undefined ? 25 : input.limit;
+    const offset = input.offset === undefined ? 0 : input.offset;
+    if (input.query !== undefined && (typeof input.query !== "string" || input.query.length > 100))
+        return inputValidationFailure("query.query", "length", "Member search text must contain at most 100 UTF-16 code units");
+    if (!nonNegativeInteger(offset))
+        return inputValidationFailure("query.offset", "range", "Member search offset must be a nonnegative safe integer");
+    if (typeof limit !== "number" || !Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+        return inputValidationFailure("query.limit", "range", "Member search limit must be an integer from 1 through 100");
+    const roleIds = input.roleIds === undefined ? undefined : identifiers(input.roleIds, 10);
+    if (input.roleIds !== undefined && !roleIds)
+        return inputValidationFailure("query.roleIds[]", "format", "Member search role IDs must be an array of at most 10 unique decimal strings");
+    input.roleIds = roleIds;
+    if (input.joinedAtAfterSeconds !== undefined && !nonNegativeInteger(input.joinedAtAfterSeconds))
+        return inputValidationFailure("query.joinedAtAfterSeconds", "range", "Joined-after time must be a nonnegative safe integer in Unix seconds");
+    if (input.joinedAtBeforeSeconds !== undefined && !nonNegativeInteger(input.joinedAtBeforeSeconds))
+        return inputValidationFailure("query.joinedAtBeforeSeconds", "range", "Joined-before time must be a nonnegative safe integer in Unix seconds");
+    if (input.userCreatedAtAfterSeconds !== undefined && !nonNegativeInteger(input.userCreatedAtAfterSeconds))
+        return inputValidationFailure("query.userCreatedAtAfterSeconds", "range", "User-created-after time must be a nonnegative safe integer in Unix seconds");
+    if (input.userCreatedAtBeforeSeconds !== undefined && !nonNegativeInteger(input.userCreatedAtBeforeSeconds))
+        return inputValidationFailure("query.userCreatedAtBeforeSeconds", "range", "User-created-before time must be a nonnegative safe integer in Unix seconds");
+    const sourceTypes = input.joinSourceTypes === undefined ? undefined : joinSourceTypes(input.joinSourceTypes);
+    if (input.joinSourceTypes !== undefined && !sourceTypes)
+        return inputValidationFailure("query.joinSourceTypes[]", "allowedValue", "Join source types must be an array of at most 10 unique supported values");
+    input.joinSourceTypes = sourceTypes;
+    const inviteCodes = input.sourceInviteCodes === undefined ? undefined : texts(input.sourceInviteCodes, 10);
+    if (input.sourceInviteCodes !== undefined && !inviteCodes)
+        return inputValidationFailure("query.sourceInviteCodes[]", "unique", "Source invite codes must be an array of at most 10 unique strings");
+    input.sourceInviteCodes = inviteCodes;
+    if (input.isBot !== undefined && typeof input.isBot !== "boolean")
+        return inputValidationFailure("query.isBot", "type", "Member search filter isBot must be a boolean");
+    if (input.sortBy !== undefined && input.sortBy !== "joinedAt" && input.sortBy !== "relevance")
+        return inputValidationFailure("query.sortBy", "allowedValue", "Member search sortBy must be joinedAt or relevance");
+    if (input.sortOrder !== undefined && input.sortOrder !== "asc" && input.sortOrder !== "desc")
+        return inputValidationFailure("query.sortOrder", "allowedValue", "Member search sortOrder must be asc or desc");
+    const body = {
+        ...(input.query === undefined ? {} : { query: input.query }),
+        limit,
+        offset,
+        ...(roleIds === undefined ? {} : { role_ids: roleIds }),
+        ...(input.joinedAtAfterSeconds === undefined ? {} : { joined_at_gte: input.joinedAtAfterSeconds }),
+        ...(input.joinedAtBeforeSeconds === undefined ? {} : { joined_at_lte: input.joinedAtBeforeSeconds }),
+        ...(sourceTypes === undefined ? {} : { join_source_type: sourceTypes }),
+        ...(inviteCodes === undefined ? {} : { source_invite_code: inviteCodes }),
+        ...(input.isBot === undefined ? {} : { is_bot: input.isBot }),
+        ...(input.userCreatedAtAfterSeconds === undefined
+            ? {}
+            : { user_created_at_gte: input.userCreatedAtAfterSeconds }),
+        ...(input.userCreatedAtBeforeSeconds === undefined
+            ? {}
+            : { user_created_at_lte: input.userCreatedAtBeforeSeconds }),
+        ...(input.sortBy === undefined ? {} : { sort_by: input.sortBy }),
+        ...(input.sortOrder === undefined ? {} : { sort_order: input.sortOrder }),
+    };
+    return Object.freeze({
+        limit,
+        offset,
+        json: JSON.stringify(body),
+        query: Object.freeze(input),
+    });
+}
+function hit(value, guildId) {
+    const roleIds = record(value) ? identifiers(value.role_ids, Number.MAX_SAFE_INTEGER) : undefined;
+    if (!record(value) ||
+        !identifier(value.guild_id) ||
+        value.guild_id !== guildId ||
+        !identifier(value.user_id) ||
+        typeof value.username !== "string" ||
+        typeof value.discriminator !== "string" ||
+        !/^\d{4}$/.test(value.discriminator) ||
+        !nullableText(value.global_name) ||
+        !nullableText(value.nickname) ||
+        !roleIds ||
+        !nonNegativeInteger(value.joined_at) ||
+        typeof value.is_bot !== "boolean" ||
+        !record(value.supplemental) ||
+        (value.supplemental.join_source_type !== undefined &&
+            value.supplemental.join_source_type !== null &&
+            !joinSourceType(value.supplemental.join_source_type)) ||
+        !nullableText(value.supplemental.source_invite_code) ||
+        !nullableIdentifier(value.supplemental.inviter_id))
+        return undefined;
+    return Object.freeze({
+        guildId: value.guild_id,
+        userId: value.user_id,
+        username: value.username,
+        discriminator: value.discriminator,
+        displayName: value.global_name,
+        nickname: value.nickname,
+        roleIds,
+        joinedAtSeconds: value.joined_at,
+        isBot: value.is_bot,
+        joinSourceType: value.supplemental.join_source_type ?? null,
+        sourceInviteCode: value.supplemental.source_invite_code,
+        inviterId: value.supplemental.inviter_id,
+    });
+}
+/** Decodes a complete provider page without admitting its partial indexed hits to the guild-member cache */
+function decodeMemberSearchPage(value, guildId, query) {
+    if (!record(value) ||
+        !identifier(value.guild_id) ||
+        value.guild_id !== guildId ||
+        !Array.isArray(value.members) ||
+        value.members.length > query.limit ||
+        !nonNegativeInteger(value.page_result_count) ||
+        value.page_result_count !== value.members.length ||
+        !nonNegativeInteger(value.total_result_count) ||
+        value.total_result_count < value.page_result_count ||
+        typeof value.indexing !== "boolean")
+        return undefined;
+    const members = [];
+    const userIds = new Set();
+    for (const source of value.members) {
+        const member = hit(source, guildId);
+        if (!member || userIds.has(member.userId))
+            return undefined;
+        userIds.add(member.userId);
+        members.push(member);
+    }
+    return Object.freeze({
+        guildId,
+        members: Object.freeze(members),
+        pageResultCount: value.page_result_count,
+        totalResultCount: value.total_result_count,
+        indexing: value.indexing,
+    });
+}
+/** Builds a remote-only POST page request. It omits cache admission and therefore cannot populate partial indexed hits */
+export function memberSearch(guildId, query) {
+    const encoded = encodeMemberSearchQuery(query);
+    if (!identifier(guildId))
+        return inputValidationFailure("guildId", "format", "Guild IDs must be decimal strings");
+    if (encoded instanceof InputValidationFailure)
+        return encoded;
+    return {
+        guildId,
+        bucket: "guild:members",
+        path: `/guilds/${guildId}/members-search`,
+        method: "POST",
+        status: 200,
+        json: encoded.json,
+        decode: (value) => decodeMemberSearchPage(value, guildId, encoded),
+    };
+}
+//# sourceMappingURL=member-search.js.map

package/dist/internal/member-search.js.map

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

package/dist/internal/message-cleanup.d.ts

@@ -0,0 +1,9 @@
+import * as Effect from "effect/Effect";
+import { MessageCleanupError, type MessageCleanupOptions, type MessageCleanupPlan, type MessageCleanupReport, type MessageCleanupSelection } from "#sdk/message-cleanup";
+import type { Message, MessageCore, MessageOperationOptions } from "#sdk/messages";
+import type { ClientOwner } from "./client.js";
+/** Builds an owned, immutable, exact message selection without submitting a deletion */
+export declare function previewCleanup<M extends MessageCore = Message>(owner: ClientOwner<M>, channelId: string, suppliedSelection: MessageCleanupSelection<M>, suppliedOptions?: MessageOperationOptions): Effect.Effect<MessageCleanupPlan<M>, MessageCleanupError>;
+/** Submit an owned preview's exact IDs sequentially through deleteMany, without rescanning or replaying an unknown batch */
+export declare function cleanup<M extends MessageCore = Message>(owner: ClientOwner<M>, plan: MessageCleanupPlan<M>, suppliedOptions?: MessageCleanupOptions): Effect.Effect<MessageCleanupReport, MessageCleanupError>;
+//# sourceMappingURL=message-cleanup.d.ts.map

package/dist/internal/message-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-cleanup.d.ts","sourceRoot":"","sources":["../../src/internal/message-cleanup.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AASvC,OAAO,EACH,mBAAmB,EAInB,KAAK,qBAAqB,EAE1B,KAAK,kBAAkB,EAEvB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAE/B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAwR9C,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,EAC1D,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAC7C,eAAe,CAAC,EAAE,uBAAuB,GAC1C,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAiG3D;AAED,4HAA4H;AAC5H,wBAAgB,OAAO,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,EACnD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC3B,eAAe,CAAC,EAAE,qBAAqB,GACxC,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CA8F1D"}