@nurama/sdk 0.0.0-stage → 1.4.0

package/dist/routes/public.js

@@ -0,0 +1,412 @@
+/**
+ * Defines public route methods for unauthenticated access to public file systems.
+ */
+export default function createPublicMethods(client) {
+    return {
+        /**
+         * Gets public file system details by token.
+         * This endpoint does not require authentication - access is controlled by the token.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @returns {Promise<PublicFileSystemDetailsResponse>} The public file system details.
+         *
+         * @example
+         * ```typescript
+         * const publicFileSystem = await nuramaClient.public.getPublicFileSystem('abc123def4');
+         * ```
+         */
+        async getPublicFileSystem(token) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            return client._request({
+                endpoint: `/v1/public/${token}`,
+                method: 'GET',
+                sendJWT: false, // This is a public endpoint
+            });
+        },
+        /**
+         * Gets public items at the root level of a public file system.
+         * This endpoint does not require authentication - access is controlled by the token.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {PublicPaginationParams} params - Optional pagination and filtering parameters.
+         * @returns {Promise<PublicFileSystemResponse>} Paginated list of public file system items.
+         *
+         * @example
+         * ```typescript
+         * const publicItems = await nuramaClient.public.getPublicItems('abc123def4');
+         * ```
+         */
+        async getPublicItems(token, params) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            // Convert arrays to proper format for query params
+            const queryParams = params ? {
+                ...params,
+                resourceIds: Array.isArray(params.resourceIds) ? params.resourceIds : (params.resourceIds ? [params.resourceIds] : []),
+                resourceSlugs: Array.isArray(params.resourceSlugs) ? params.resourceSlugs : (params.resourceSlugs ? [params.resourceSlugs] : []),
+                resourceTags: Array.isArray(params.resourceTags) ? params.resourceTags : (params.resourceTags ? [params.resourceTags] : []),
+                mediaTypes: Array.isArray(params.mediaTypes) ? params.mediaTypes : (params.mediaTypes ? [params.mediaTypes] : []),
+            } : {};
+            return client._request({
+                endpoint: `/v1/public/${token}/files`,
+                method: 'GET',
+                params: queryParams,
+                sendJWT: false, // This is a public endpoint
+            });
+        },
+        /**
+         * Gets public items at a specific path within a public file system.
+         * This endpoint does not require authentication - access is controlled by the token.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {string} path - The path within the public file system to retrieve items from.
+         * @param {PublicPaginationParams} params - Optional pagination and filtering parameters.
+         * @returns {Promise<PublicFileSystemResponse>} Paginated list of public file system items.
+         *
+         * @example
+         * ```typescript
+         * const items = await nuramaClient.public.getPublicItemsAtPath('abc123def4', 'folder1/subfolder');
+         * ```
+         */
+        async getPublicItemsAtPath(token, path, params) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            if (path === null || path === undefined)
+                throw new Error('path is required.');
+            // Remove leading slash if present
+            const cleanPath = path.startsWith('/') ? path.substring(1) : path;
+            // Convert arrays to proper format for query params
+            const queryParams = params ? {
+                ...params,
+                resourceIds: Array.isArray(params.resourceIds) ? params.resourceIds : (params.resourceIds ? [params.resourceIds] : []),
+                resourceSlugs: Array.isArray(params.resourceSlugs) ? params.resourceSlugs : (params.resourceSlugs ? [params.resourceSlugs] : []),
+                resourceTags: Array.isArray(params.resourceTags) ? params.resourceTags : (params.resourceTags ? [params.resourceTags] : []),
+                mediaTypes: Array.isArray(params.mediaTypes) ? params.mediaTypes : (params.mediaTypes ? [params.mediaTypes] : []),
+            } : {};
+            return client._request({
+                endpoint: `/v1/public/${token}/files/${cleanPath}`,
+                method: 'GET',
+                params: queryParams,
+                sendJWT: false, // This is a public endpoint
+            });
+        },
+        /**
+         * Downloads public assets by generating signed URLs for the original files.
+         * This endpoint does not require authentication - access is controlled by the token.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {DownloadPublicAssetsData} downloadData - The asset IDs to download.
+         * @returns {Promise<DownloadSignedUrlData[]>} Array of signed download URLs for the requested assets.
+         *
+         * @example
+         * ```typescript
+         * const downloadUrls = await nuramaClient.public.downloadAssets('abc123def4', {
+         *   assetIds: ['507f1f77bcf86cd799439011', '507f191e810c19729de860ea']
+         * });
+         * ```
+         */
+        async downloadAssets(token, downloadData) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            if (!downloadData)
+                throw new Error('downloadData is required.');
+            if (!downloadData.assetIds || !Array.isArray(downloadData.assetIds) || downloadData.assetIds.length === 0) {
+                throw new Error('downloadData.assetIds must be a non-empty array.');
+            }
+            return client._request({
+                endpoint: `/v1/public/${token}/download`,
+                method: 'POST',
+                body: downloadData,
+                sendJWT: false, // This is a public endpoint
+            });
+        },
+        // ============================================================================
+        // Public Chat Methods
+        // ============================================================================
+        /**
+         * Gets the main public file system chat or a specific chat by ID.
+         * This endpoint does not require authentication for read access.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {string} [chatId] - Optional specific chat ID to retrieve.
+         * @returns {Promise<Chat | null>} The chat object, or null if no main chat exists yet.
+         *
+         * @example
+         * ```typescript
+         * // Get main public file system chat
+         * const mainChat = await nuramaClient.public.getPublicChat('abc123def4');
+         *
+         * // Get specific chat by ID
+         * const chat = await nuramaClient.public.getPublicChat('abc123def4', 'chat-id-here');
+         * ```
+         */
+        async getPublicChat(token, chatId) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            const endpoint = chatId ? `/v1/public/${token}/chat/${chatId}` : `/v1/public/${token}/chat`;
+            return client._request({
+                endpoint,
+                method: 'GET',
+                sendJWT: false, // Read access is public
+            });
+        },
+        /**
+         * Gets paginated messages for a public chat.
+         * This endpoint does not require authentication for read access.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {string} chatId - The ID of the chat to get messages from.
+         * @param {GetPublicChatMessagesParams} [params] - Optional pagination parameters.
+         * @returns {Promise<PublicChatMessagesResponse>} Paginated list of chat messages.
+         *
+         * @example
+         * ```typescript
+         * const messages = await nuramaClient.public.getPublicChatMessages('abc123def4', 'chat-id', {
+         *   limit: 20,
+         *   paginateReverse: false,
+         * });
+         * ```
+         */
+        async getPublicChatMessages(token, chatId, params) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            if (!chatId)
+                throw new Error('chatId is required.');
+            return client._request({
+                endpoint: `/v1/public/${token}/chat/${chatId}/messages`,
+                method: 'GET',
+                params: params || {},
+                sendJWT: false, // Read access is public
+            });
+        },
+        /**
+         * Creates a message in an existing public chat.
+         * Requires authentication.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {string} chatId - The ID of the chat to post to.
+         * @param {CreatePublicChatMessageRequest} data - The message data.
+         * @returns {Promise<ChatMessage>} The created message.
+         *
+         * @example
+         * ```typescript
+         * const message = await nuramaClient.public.createPublicChatMessage('abc123def4', 'chat-id', {
+         *   content: 'Hello world!',
+         * });
+         * ```
+         */
+        async createPublicChatMessage(token, chatId, data) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            if (!chatId)
+                throw new Error('chatId is required.');
+            if (!data)
+                throw new Error('data is required.');
+            return client._request({
+                endpoint: `/v1/public/${token}/chat/${chatId}/messages`,
+                method: 'POST',
+                body: data,
+                sendJWT: 'optional', // Authenticated caller keeps identity; anonymous allowed when the release opts in
+            });
+        },
+        /**
+         * Creates a message on the main public topic chat.
+         * If no main chat exists for this public file system, one is created (lazy creation).
+         * Requires authentication.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {CreatePublicChatMessageRequest} data - The message data.
+         * @returns {Promise<CreatePublicAssetChatMessageResponse>} The chat and created message.
+         *
+         * @example
+         * ```typescript
+         * // This creates the main chat if it doesn't exist and posts the first message
+         * const { chat, message } = await nuramaClient.public.createPublicTopicChatMessage('abc123def4', {
+         *   content: 'First comment on this public file system!',
+         * });
+         * ```
+         */
+        async createPublicTopicChatMessage(token, data) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            if (!data)
+                throw new Error('data is required.');
+            return client._request({
+                endpoint: `/v1/public/${token}/chat/messages`,
+                method: 'POST',
+                body: data,
+                sendJWT: 'optional', // Authenticated caller keeps identity; anonymous allowed when the release opts in
+            });
+        },
+        /**
+         * Gets an asset with its public chat in the context of a public file system.
+         * This endpoint does not require authentication for read access.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {string} assetId - The ID of the asset to retrieve.
+         * @returns {Promise<PublicAssetResponse>} The asset with its public chat (or null if no chat exists).
+         *
+         * @example
+         * ```typescript
+         * const asset = await nuramaClient.public.getPublicAsset('abc123def4', 'asset-id');
+         * if (asset.chats.public) {
+         *   console.log('Asset has public chat:', asset.chats.public.id);
+         * }
+         * ```
+         */
+        async getPublicAsset(token, assetId) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            if (!assetId)
+                throw new Error('assetId is required.');
+            return client._request({
+                endpoint: `/v1/public/${token}/assets/${assetId}`,
+                method: 'GET',
+                sendJWT: false, // Read access is public
+            });
+        },
+        /**
+         * Creates a message on an asset's public chat.
+         * If no public chat exists for this asset in this public file system, one is created (lazy creation).
+         * Requires authentication.
+         *
+         * @param {string} token - The 10-character alphanumeric public access token.
+         * @param {string} assetId - The ID of the asset to post to.
+         * @param {CreatePublicChatMessageRequest} data - The message data.
+         * @returns {Promise<CreatePublicAssetChatMessageResponse>} The chat and created message.
+         *
+         * @example
+         * ```typescript
+         * // This creates the chat if it doesn't exist and posts the first message
+         * const { chat, message } = await nuramaClient.public.createPublicAssetChatMessage('abc123def4', 'asset-id', {
+         *   content: 'First comment on this asset!',
+         * });
+         * ```
+         */
+        async createPublicAssetChatMessage(token, assetId, data) {
+            if (!token)
+                throw new Error('token is required.');
+            if (token.length !== 10)
+                throw new Error('token must be exactly 10 characters long.');
+            if (!/^[a-zA-Z0-9]{10}$/.test(token))
+                throw new Error('token must contain only alphanumeric characters.');
+            if (!assetId)
+                throw new Error('assetId is required.');
+            if (!data)
+                throw new Error('data is required.');
+            return client._request({
+                endpoint: `/v1/public/${token}/assets/${assetId}/messages`,
+                method: 'POST',
+                body: data,
+                sendJWT: 'optional', // Authenticated caller keeps identity; anonymous allowed when the release opts in
+            });
+        },
+        // ========================================================================
+        // Public asset links (/public-download)
+        // ========================================================================
+        /**
+         * Resolve a public asset-link token to the minimal file info the download page shows.
+         * Public endpoint; no authentication.
+         * @param {string} token - The public asset-link token.
+         * @returns {Promise<ResolvePublicDownloadResponse>} File name, media type and link status.
+         * @throws {Error} 'token is required.' when `token` is falsy.
+         */
+        async resolvePublicDownload(token) {
+            if (!token)
+                throw new Error('token is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/public-download/${token}`,
+                sendJWT: false,
+            });
+        },
+        /**
+         * Get a short-lived signed download URL for a public asset-link token.
+         * Public endpoint; fails with 403 for embed-only links.
+         * @param {string} token - The public asset-link token.
+         * @returns {Promise<PublicDownloadUrlResponse>} The signed URL and its expiry.
+         * @throws {Error} 'token is required.' when `token` is falsy.
+         */
+        async getPublicDownloadUrl(token) {
+            if (!token)
+                throw new Error('token is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/public-download/${token}/download`,
+                sendJWT: false,
+            });
+        },
+        /**
+         * Get the HLS stream and fallback media key paths for the embeddable player.
+         * Public endpoint; fails with 403 for download-only links.
+         * @param {string} token - The public asset-link token.
+         * @returns {Promise<PublicEmbedFilesResponse>} Stream and fallback key paths.
+         * @throws {Error} 'token is required.' when `token` is falsy.
+         */
+        async getPublicEmbedFiles(token) {
+            if (!token)
+                throw new Error('token is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/public-download/${token}/embed-files`,
+                sendJWT: false,
+            });
+        },
+        /**
+         * Record a play event from the embed player for a public asset link.
+         * Public endpoint; no authentication. The API responds 204.
+         * @param {string} token - The public asset-link token.
+         * @param {object} body - `{ eventType: 'play_started' | 'play_completed' }`.
+         * @returns {Promise<void>} Resolves once recorded.
+         * @throws {Error} 'token is required.' when `token` is falsy.
+         */
+        async recordAccessActivity(token, body) {
+            if (!token)
+                throw new Error('token is required.');
+            await client._request({
+                method: 'POST',
+                endpoint: `/v1/public-download/${token}/access-activity`,
+                body,
+                sendJWT: false,
+            });
+        },
+    };
+}
+//# sourceMappingURL=public.js.map

package/dist/routes/public.js.map

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

package/dist/routes/scratch.d.ts

@@ -0,0 +1,70 @@
+import NuramaClient from '../NuramaClient.js';
+export interface CompleteUploadBody {
+    uploadId: string;
+    parts: Array<{
+        ETag: string;
+        PartNumber: number;
+    }>;
+}
+export interface CompleteUploadResponse {
+    id: string;
+    url: string | null;
+}
+export interface PromoteBody {
+    /** Optional rename — lands on `Asset.name`. Defaults to a row-id-derived name. */
+    fileName?: string;
+}
+export interface PromoteResponse {
+    asset: unknown;
+    /**
+     * `true` when the scratch row was already promoted on a prior call
+     * (e.g. the same revision was Attached-to-chat earlier and the
+     * chat-send pipeline ran the promote synchronously). The returned
+     * `asset` is the existing one. The FE should treat this as a no-op
+     * for "newly added" UX (toast copy, list-refresh side effects) while
+     * still surfacing the asset.
+     */
+    alreadyPromoted: boolean;
+}
+/**
+ * Scratch — platform-wide temporary object-storage with explicit lifecycle.
+ *
+ * There is NO public surface for creating scratch rows or minting
+ * upload URLs. Parent processes (e.g. AI Revision) initiate the
+ * multipart upload server-side and return the
+ * `{ scratchId, uploadId, key, urls[] }` bundle in their own response
+ * payload. The FE uploads each part directly against its signed URL
+ * (same pattern as asset uploads), then calls `completeUpload` here to
+ * finalise.
+ *
+ * `completeUpload` mirrors `nuramaClient.asset.completeUpload`:
+ * the body is the same `{ uploadId, parts }` shape, the server runs the
+ * S3-compatible `CompleteMultipartUploadCommand`, and (for scratch
+ * specifically) HEADs the resulting object, increments workspace
+ * storage usage, and writes the audit row.
+ */
+export default function createScratchMethods(client: NuramaClient): {
+    /**
+     * Finish a multipart upload for a scratch row. Same `{ uploadId,
+     * parts }` body the asset complete-upload route accepts. Server
+     * runs `CompleteMultipartUploadCommand` against the media bucket,
+     * HEADs the object for size, increments workspace storage usage,
+     * writes the audit row, and flips status pendingUpload → active.
+     * Creator-only.
+     */
+    completeUpload(scratchId: string, data: CompleteUploadBody): Promise<CompleteUploadResponse>;
+    /**
+     * Promote a scratch row to a real Asset. Creator-only — only the
+     * user who created the scratch row can call this. Destination is
+     * derived server-side from the row itself:
+     *   - row has `projectId`     → asset created in that project
+     *   - row has only workspace  → asset created at the workspace
+     *
+     * No body fields for destination on purpose: the FE doesn't get to
+     * claim a scratch belongs to a different workspace / project. The
+     * only optional input is `fileName` to override the asset's
+     * user-facing name.
+     */
+    promote(scratchId: string, data?: PromoteBody): Promise<PromoteResponse>;
+};
+//# sourceMappingURL=scratch.d.ts.map

package/dist/routes/scratch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch.d.ts","sourceRoot":"","sources":["../../src/routes/scratch.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;OAOG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,MAAM,EAAE,YAAY;IAE7D;;;;;;;OAOG;8BAC6B,MAAM,QAAQ,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAclG;;;;;;;;;;;OAWG;uBACsB,MAAM,SAAQ,WAAW,GAAQ,OAAO,CAAC,eAAe,CAAC;EAUrF"}

package/dist/routes/scratch.js

@@ -0,0 +1,67 @@
+/**
+ * Scratch — platform-wide temporary object-storage with explicit lifecycle.
+ *
+ * There is NO public surface for creating scratch rows or minting
+ * upload URLs. Parent processes (e.g. AI Revision) initiate the
+ * multipart upload server-side and return the
+ * `{ scratchId, uploadId, key, urls[] }` bundle in their own response
+ * payload. The FE uploads each part directly against its signed URL
+ * (same pattern as asset uploads), then calls `completeUpload` here to
+ * finalise.
+ *
+ * `completeUpload` mirrors `nuramaClient.asset.completeUpload`:
+ * the body is the same `{ uploadId, parts }` shape, the server runs the
+ * S3-compatible `CompleteMultipartUploadCommand`, and (for scratch
+ * specifically) HEADs the resulting object, increments workspace
+ * storage usage, and writes the audit row.
+ */
+export default function createScratchMethods(client) {
+    return {
+        /**
+         * Finish a multipart upload for a scratch row. Same `{ uploadId,
+         * parts }` body the asset complete-upload route accepts. Server
+         * runs `CompleteMultipartUploadCommand` against the media bucket,
+         * HEADs the object for size, increments workspace storage usage,
+         * writes the audit row, and flips status pendingUpload → active.
+         * Creator-only.
+         */
+        async completeUpload(scratchId, data) {
+            if (!scratchId)
+                throw new Error('scratchId is required.');
+            if (!data?.uploadId)
+                throw new Error('uploadId is required.');
+            if (!Array.isArray(data?.parts) || data.parts.length === 0) {
+                throw new Error('parts is required.');
+            }
+            return client._request({
+                endpoint: `/v1/scratch/${encodeURIComponent(scratchId)}/complete-upload`,
+                method: 'POST',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Promote a scratch row to a real Asset. Creator-only — only the
+         * user who created the scratch row can call this. Destination is
+         * derived server-side from the row itself:
+         *   - row has `projectId`     → asset created in that project
+         *   - row has only workspace  → asset created at the workspace
+         *
+         * No body fields for destination on purpose: the FE doesn't get to
+         * claim a scratch belongs to a different workspace / project. The
+         * only optional input is `fileName` to override the asset's
+         * user-facing name.
+         */
+        async promote(scratchId, data = {}) {
+            if (!scratchId)
+                throw new Error('scratchId is required.');
+            return client._request({
+                endpoint: `/v1/scratch/${encodeURIComponent(scratchId)}/promote`,
+                method: 'POST',
+                body: data,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=scratch.js.map

package/dist/routes/scratch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch.js","sourceRoot":"","sources":["../../src/routes/scratch.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,MAAoB;IAC/D,OAAO;QACL;;;;;;;WAOG;QACH,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,IAAwB;YAC9D,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,EAAE,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,QAAQ,EAAE,eAAe,kBAAkB,CAAC,SAAS,CAAC,kBAAkB;gBACxE,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;;;;;;WAWG;QACH,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,OAAoB,EAAE;YACrD,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,QAAQ,EAAE,eAAe,kBAAkB,CAAC,SAAS,CAAC,UAAU;gBAChE,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}