@ticketpm/core 0.0.4

package/dist/compact.js

@@ -0,0 +1,164 @@
+import { sortRecordByKey } from "./utils.js";
+function compactInteractionMetadata(metadata) {
+    if (!metadata) {
+        return undefined;
+    }
+    return {
+        id: metadata.id,
+        type: metadata.type,
+        user_id: metadata.user.id,
+        name: metadata.name,
+        original_response_message_id: metadata.original_response_message_id,
+        triggering_interaction_metadata: compactInteractionMetadata(metadata.triggering_interaction_metadata)
+    };
+}
+function compactInteraction(interaction) {
+    if (!interaction) {
+        return undefined;
+    }
+    return {
+        id: interaction.id,
+        type: interaction.type,
+        name: interaction.name,
+        user_id: interaction.user.id
+    };
+}
+function compactPoll(poll) {
+    if (!poll) {
+        return undefined;
+    }
+    const { answer_voters, ...compactPollData } = poll;
+    if (!answer_voters || Object.keys(answer_voters).length === 0) {
+        return compactPollData;
+    }
+    return {
+        ...compactPollData,
+        answer_voter_ids: Object.fromEntries(Object.entries(answer_voters).map(([answerId, voters]) => [Number(answerId), voters.map((voter) => voter.id)]))
+    };
+}
+function compactReferencedMessage(message) {
+    return {
+        id: message.id,
+        type: message.type,
+        author_id: message.author?.id,
+        content: message.content,
+        mention_everyone: message.mention_everyone || undefined,
+        interaction: message.interaction ? { type: message.interaction.type } : undefined,
+        interaction_metadata: message.interaction_metadata ? { type: message.interaction_metadata.type } : undefined,
+        embeds: message.embeds,
+        attachments: message.attachments,
+        sticker_items: message.sticker_items
+    };
+}
+function compactMessageSnapshot(snapshot) {
+    return {
+        message: {
+            ...snapshot.message,
+            mention_everyone: snapshot.message.mention_everyone || undefined
+        }
+    };
+}
+function compactMessage(message) {
+    return {
+        id: message.id,
+        type: message.type,
+        timestamp: message.timestamp,
+        author_id: message.author?.id,
+        content: message.content,
+        mention_everyone: message.mention_everyone || undefined,
+        edited_timestamp: message.edited_timestamp,
+        attachments: message.attachments,
+        embeds: message.embeds,
+        reactions: message.reactions,
+        components: message.components,
+        sticker_items: message.sticker_items,
+        poll: compactPoll(message.poll),
+        interaction_metadata: compactInteractionMetadata(message.interaction_metadata),
+        interaction: compactInteraction(message.interaction),
+        message_reference: message.message_reference,
+        message_snapshots: message.message_snapshots?.map(compactMessageSnapshot),
+        referenced_message: message.referenced_message
+            ? compactReferencedMessage(message.referenced_message)
+            : message.referenced_message,
+        mention_ids: message.mentions?.map((user) => user.id),
+        mention_roles: message.mention_roles
+    };
+}
+/**
+ * Prune `null`, `undefined`, and structurally empty values while preserving the
+ * two context containers that are intentionally meaningful when non-empty.
+ */
+export function pruneForExport(value) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        const prunedArray = value
+            .map((item) => pruneForExport(item))
+            .filter((item) => item !== undefined);
+        return prunedArray.length > 0 ? prunedArray : undefined;
+    }
+    if (typeof value === "object") {
+        const objectValue = value;
+        const prunedObject = {};
+        for (const key of Object.keys(objectValue).sort()) {
+            if (key === "members" || key === "roles") {
+                const nestedRecord = objectValue[key];
+                if (nestedRecord && Object.keys(nestedRecord).length > 0) {
+                    prunedObject[key] = nestedRecord;
+                }
+                continue;
+            }
+            const prunedValue = pruneForExport(objectValue[key]);
+            if (prunedValue !== undefined) {
+                prunedObject[key] = prunedValue;
+            }
+        }
+        return Object.keys(prunedObject).length > 0 ? prunedObject : undefined;
+    }
+    return value;
+}
+/**
+ * Context ordering participates in canonical byte generation, so each map is
+ * normalized explicitly before serialization.
+ */
+export function sortTranscriptContext(context) {
+    const transcriptChannelId = context.channel_id;
+    const channels = { ...(context.channels ?? {}) };
+    if (transcriptChannelId && !channels[transcriptChannelId]) {
+        channels[transcriptChannelId] = { name: transcriptChannelId };
+    }
+    return {
+        channel_id: transcriptChannelId,
+        users: sortRecordByKey(context.users),
+        channels: sortRecordByKey(channels),
+        roles: sortRecordByKey(context.roles),
+        members: sortRecordByKey(context.members),
+        guild: context.guild
+    };
+}
+/**
+ * Produce the compact stored transcript format that the upload API hashes and
+ * the viewer hydrates.
+ */
+export function buildStoredTranscript(input) {
+    const compactTranscript = {
+        messages: input.messages.map(compactMessage),
+        context: sortTranscriptContext(input.context)
+    };
+    return (pruneForExport(compactTranscript) ?? {
+        messages: []
+    });
+}
+/**
+ * Preserve the first-party chronological ordering convention for adapters that
+ * receive newest-first collections from Discord APIs.
+ */
+export function sortMessagesChronologically(messages) {
+    return [...messages].sort((left, right) => {
+        const leftTimestamp = new Date(left.timestamp ?? 0).getTime();
+        const rightTimestamp = new Date(right.timestamp ?? 0).getTime();
+        return leftTimestamp - rightTimestamp;
+    });
+}
+//# sourceMappingURL=compact.js.map

package/dist/compact.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared constants copied from the current ticket.pm API contract so that
+ * package consumers can validate payloads before hitting the network.
+ */
+export declare const MAX_TRANSCRIPT_COMPRESSED_BYTES: number;
+export declare const MAX_TRANSCRIPT_DECOMPRESSED_BYTES: number;
+export declare const MAX_TRANSCRIPT_CHANNEL_NAME_CHARACTERS = 100;
+export declare const MAX_TRANSCRIPT_NESTING_DEPTH = 20;
+export declare const DEFAULT_TRANSCRIPT_COMPRESSION_LEVEL = 15;
+export declare const DEFAULT_TICKETPM_MEDIA_PROXY_BASE_URL = "https://m.ticket.pm/v2";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,+BAA+B,QAAmB,CAAC;AAChE,eAAO,MAAM,iCAAiC,QAAoB,CAAC;AACnE,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,oCAAoC,KAAK,CAAC;AACvD,eAAO,MAAM,qCAAqC,2BAA2B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,11 @@
+/**
+ * Shared constants copied from the current ticket.pm API contract so that
+ * package consumers can validate payloads before hitting the network.
+ */
+export const MAX_TRANSCRIPT_COMPRESSED_BYTES = 32 * 1024 * 1024;
+export const MAX_TRANSCRIPT_DECOMPRESSED_BYTES = 128 * 1024 * 1024;
+export const MAX_TRANSCRIPT_CHANNEL_NAME_CHARACTERS = 100;
+export const MAX_TRANSCRIPT_NESTING_DEPTH = 20;
+export const DEFAULT_TRANSCRIPT_COMPRESSION_LEVEL = 15;
+export const DEFAULT_TICKETPM_MEDIA_PROXY_BASE_URL = "https://m.ticket.pm/v2";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAChE,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AACnE,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAAG,CAAC;AAC1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,CAAC;AACvD,MAAM,CAAC,MAAM,qCAAqC,GAAG,wBAAwB,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,24 @@
+import type { UserInfo } from "./types.js";
+export type IdentityUser = Pick<UserInfo, "bot" | "public_flags" | "username"> & {
+    discriminator?: string | null;
+};
+/**
+ * Discord marks verified bots with the public flag bit `1 << 16`.
+ */
+export declare function isVerifiedBot(user: Pick<UserInfo, "bot" | "public_flags">): boolean;
+/**
+ * The first-party exporter distinguishes ordinary bot users from webhook
+ * authors because webhooks do not have a stable application identity.
+ */
+export declare function isWebhookAuthor(user: Pick<UserInfo, "bot" | "public_flags">, options?: {
+    isWebhook?: boolean;
+    applicationId?: string | null;
+}): boolean;
+/**
+ * The viewer wants canonical usernames for real users, but bot-like identities
+ * keep a `name#discriminator` shape so they stay visually distinguishable.
+ */
+export declare function formatExportUsername(user: IdentityUser, options?: {
+    webhook?: boolean;
+}): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,cAAc,GAAG,UAAU,CAAC,GAAG;IAChF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,cAAc,CAAC,GAAG,OAAO,CAOnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,cAAc,CAAC,EAC5C,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9D,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAWhG"}

package/dist/identity.js

@@ -0,0 +1,35 @@
+/**
+ * Discord marks verified bots with the public flag bit `1 << 16`.
+ */
+export function isVerifiedBot(user) {
+    if (!user.bot) {
+        return false;
+    }
+    const flags = user.public_flags ?? 0;
+    return (flags & (1 << 16)) === 1 << 16;
+}
+/**
+ * The first-party exporter distinguishes ordinary bot users from webhook
+ * authors because webhooks do not have a stable application identity.
+ */
+export function isWebhookAuthor(user, options) {
+    if (!user.bot || !options?.isWebhook) {
+        return false;
+    }
+    return !options.applicationId;
+}
+/**
+ * The viewer wants canonical usernames for real users, but bot-like identities
+ * keep a `name#discriminator` shape so they stay visually distinguishable.
+ */
+export function formatExportUsername(user, options) {
+    if (!user.bot && !options?.webhook) {
+        return user.username;
+    }
+    if (user.username.includes("#")) {
+        return user.username;
+    }
+    const discriminator = user.discriminator && user.discriminator.length > 0 ? user.discriminator : "0000";
+    return `${user.username}#${discriminator}`;
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAA4C;IACzE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC9B,IAA4C,EAC5C,OAAgE;IAEhE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAkB,EAAE,OAA+B;IACvF,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC;IACxG,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,aAAa,EAAE,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./canonical.js";
+export * from "./compact.js";
+export * from "./constants.js";
+export * from "./identity.js";
+export * from "./media-proxy.js";
+export * from "./runtime.js";
+export * from "./types.js";
+export * from "./upload-client.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from "./canonical.js";
+export * from "./compact.js";
+export * from "./constants.js";
+export * from "./identity.js";
+export * from "./media-proxy.js";
+export * from "./runtime.js";
+export * from "./types.js";
+export * from "./upload-client.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/media-proxy.d.ts

@@ -0,0 +1,100 @@
+import type { DiscordContext, DraftMessage, GuildInfo, UserInfo } from "./types.js";
+export interface TicketPmMediaProxyClientOptions {
+    /**
+     * Base media API URL, for example `https://m.ticket.pm/v2`.
+     *
+     * This value controls both where upload requests are sent and which proxy
+     * URLs are generated on successful uploads.
+     */
+    baseUrl: string;
+    /**
+     * Optional bearer token or raw token string. Raw values are normalized into
+     * the `Authorization: Bearer ...` header automatically.
+     */
+    token?: string;
+    /**
+     * Optional custom fetch implementation for environments that need their own
+     * HTTP transport, instrumentation, retries, or authentication pipeline.
+     */
+    fetch?: typeof fetch;
+}
+export type UploadProgressCallback = (completed: number, total: number) => void;
+/**
+ * Stateful client with in-memory dedupe so repeated avatar/icon/media uploads
+ * inside a single export run do not fan out into redundant requests.
+ */
+export declare class TicketPmMediaProxyClient {
+    private readonly options;
+    private readonly fetchImpl;
+    private readonly avatarUploadCache;
+    private readonly iconUploadCache;
+    private readonly attachmentUploadCache;
+    constructor(options: TicketPmMediaProxyClientOptions);
+    get baseUrl(): string;
+    /**
+     * Upload a Discord avatar hash to the configured media proxy.
+     *
+     * On success, the returned value is the proxy avatar URL. On failure, this
+     * returns `undefined` and the caller is expected to keep the original avatar
+     * hash untouched in transcript data.
+     */
+    uploadAvatarHash(hash: string, userId: string): Promise<string | undefined>;
+    uploadGuildIconHash(hash: string, guildId: string): Promise<string | undefined>;
+    /**
+     * Upload a media URL to the configured proxy.
+     *
+     * If the proxy is unavailable, returns a non-2xx response, or produces an
+     * invalid payload, this returns `undefined`. Callers should treat that as a
+     * no-rewrite outcome and keep the original media URL fields.
+     */
+    uploadAttachmentUrl(url: string): Promise<string | undefined>;
+}
+/**
+ * Walk a transcript recursively and collect the media URLs that would be sent
+ * to the proxy service.
+ */
+export declare function collectTranscriptMediaUrls(messages: readonly DraftMessage[]): Set<string>;
+/**
+ * Upload all avatar hashes already present in `context.users` so the media API
+ * can cache them, but keep `user.avatar` as the original Discord hash.
+ *
+ * The viewer still expects `user.avatar` to be a raw Discord avatar hash and
+ * derives the final CDN URL from `user.id + user.avatar`. Replacing the field
+ * with a proxy URL would make the serialized transcript incompatible with the
+ * existing viewer contract.
+ */
+export declare function proxyTranscriptAvatarsInPlace(users: Record<string, UserInfo>, client: TicketPmMediaProxyClient, options?: {
+    onProgress?: UploadProgressCallback;
+}): Promise<void>;
+/**
+ * Proxy the guild icon if one exists and mutate the guild object in place.
+ */
+export declare function proxyGuildIconInPlace(guild: GuildInfo, client: TicketPmMediaProxyClient): Promise<string | undefined>;
+/**
+ * Rewrite nested media-bearing fields to prefer the ticket.pm proxy service.
+ *
+ * Failure behavior:
+ *
+ * - successful proxy uploads write `proxy_url` or `proxy_icon_url`
+ * - failed proxy uploads leave existing fields unchanged
+ * - original Discord-hosted media URLs remain available as fallback
+ */
+export declare function rewriteTranscriptMediaUrlsInPlace(messages: DraftMessage[], client: TicketPmMediaProxyClient, options?: {
+    onProgress?: UploadProgressCallback;
+    expectedUrls?: Set<string>;
+}): Promise<void>;
+/**
+ * Convenience wrapper for callers that keep the whole transcript structure
+ * together while proxying assets.
+ *
+ * This helper is best-effort. Media proxy failures do not throw away the
+ * original transcript media fields; they simply leave them as they were.
+ */
+export declare function proxyTranscriptAssetsInPlace(transcript: {
+    messages: DraftMessage[];
+    context: DiscordContext;
+}, client: TicketPmMediaProxyClient, options?: {
+    avatarProgress?: UploadProgressCallback;
+    mediaProgress?: UploadProgressCallback;
+}): Promise<void>;
+//# sourceMappingURL=media-proxy.d.ts.map

package/dist/media-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-proxy.d.ts","sourceRoot":"","sources":["../src/media-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQpF,MAAM,WAAW,+BAA+B;IAC/C;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAsChF;;;GAGG;AACH,qBAAa,wBAAwB;IAMjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkD;IACpF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkD;IAClF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkD;gBAEpD,OAAO,EAAE,+BAA+B;IAI5E,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED;;;;;;OAMG;IACU,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAyC3E,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAyC5F;;;;;;OAMG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAiC1E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAmDzF;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC/B,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,sBAAsB,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW3H;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,iCAAiC,CACtD,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAAC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAC3E,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CACjD,UAAU,EAAE;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,EACjE,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE;IACT,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,aAAa,CAAC,EAAE,sBAAsB,CAAC;CACvC,GACC,OAAO,CAAC,IAAI,CAAC,CAcf"}