@rovela-ai/sdk 0.1.25 → 0.1.27

package/dist/media/server/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/media/server/delete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AASlD;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoEpD;AAMD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAMlB"}

package/dist/media/server/delete.js

@@ -0,0 +1,176 @@
+/**
+ * @rovela-ai/sdk/media/server/delete
+ *
+ * File deletion from R2 storage.
+ * Server-side only - do not import in client components.
+ */
+import { DeleteObjectCommand, DeleteObjectsCommand } from '@aws-sdk/client-s3';
+import { extractKeyFromUrl, requireMediaConfig } from '../config';
+import { getR2Client, getBucketName, getPublicUrlBase } from './r2-client';
+import { validateStoreUrl } from './presign';
+// =============================================================================
+// Single File Deletion
+// =============================================================================
+/**
+ * Delete a file from R2 storage.
+ *
+ * @param url - Public URL of the file to delete
+ * @param config - Optional storage configuration override
+ * @returns True if deletion was successful
+ * @throws Error if URL is invalid or doesn't belong to this store
+ *
+ * @example
+ * ```typescript
+ * await deleteFile('https://pub-xxx.r2.dev/stores/abc123/products/img.jpg');
+ * ```
+ */
+export async function deleteFile(url, config) {
+    const resolvedConfig = config || requireMediaConfig();
+    // Validate URL belongs to this store
+    if (!validateStoreUrl(url, resolvedConfig)) {
+        throw new Error('Invalid URL: does not belong to this store');
+    }
+    // Extract key from URL
+    const publicUrlBase = getPublicUrlBase(resolvedConfig);
+    const key = extractKeyFromUrl(publicUrlBase, url);
+    if (!key) {
+        throw new Error('Invalid URL: could not extract storage key');
+    }
+    const client = getR2Client(resolvedConfig);
+    const bucketName = getBucketName(resolvedConfig);
+    try {
+        await client.send(new DeleteObjectCommand({
+            Bucket: bucketName,
+            Key: key,
+        }));
+        return true;
+    }
+    catch (error) {
+        console.error('[Media] Delete failed:', error);
+        throw new Error('Failed to delete file');
+    }
+}
+/**
+ * Delete a file by its storage key.
+ * Use this when you have the key directly instead of the URL.
+ *
+ * @param key - Storage key of the file
+ * @param config - Optional storage configuration override
+ * @returns True if deletion was successful
+ */
+export async function deleteFileByKey(key, config) {
+    const resolvedConfig = config || requireMediaConfig();
+    const client = getR2Client(resolvedConfig);
+    const bucketName = getBucketName(resolvedConfig);
+    // Validate key belongs to this store
+    const expectedPrefix = `stores/${resolvedConfig.storeId}/`;
+    if (!key.startsWith(expectedPrefix)) {
+        throw new Error('Invalid key: does not belong to this store');
+    }
+    try {
+        await client.send(new DeleteObjectCommand({
+            Bucket: bucketName,
+            Key: key,
+        }));
+        return true;
+    }
+    catch (error) {
+        console.error('[Media] Delete by key failed:', error);
+        throw new Error('Failed to delete file');
+    }
+}
+// =============================================================================
+// Batch Deletion
+// =============================================================================
+/**
+ * Delete multiple files from R2 storage.
+ *
+ * @param urls - Array of public URLs to delete
+ * @param config - Optional storage configuration override
+ * @returns Object with results for each URL
+ *
+ * @example
+ * ```typescript
+ * const results = await deleteFiles([
+ *   'https://pub-xxx.r2.dev/stores/abc123/products/img1.jpg',
+ *   'https://pub-xxx.r2.dev/stores/abc123/products/img2.jpg',
+ * ]);
+ * // { succeeded: ['url1', 'url2'], failed: [] }
+ * ```
+ */
+export async function deleteFiles(urls, config) {
+    const resolvedConfig = config || requireMediaConfig();
+    const publicUrlBase = getPublicUrlBase(resolvedConfig);
+    // Filter and extract keys
+    const validEntries = [];
+    const invalidUrls = [];
+    for (const url of urls) {
+        if (!validateStoreUrl(url, resolvedConfig)) {
+            invalidUrls.push(url);
+            continue;
+        }
+        const key = extractKeyFromUrl(publicUrlBase, url);
+        if (!key) {
+            invalidUrls.push(url);
+            continue;
+        }
+        validEntries.push({ url, key });
+    }
+    if (validEntries.length === 0) {
+        return { succeeded: [], failed: urls };
+    }
+    const client = getR2Client(resolvedConfig);
+    const bucketName = getBucketName(resolvedConfig);
+    try {
+        // Use batch delete for efficiency
+        await client.send(new DeleteObjectsCommand({
+            Bucket: bucketName,
+            Delete: {
+                Objects: validEntries.map(({ key }) => ({ Key: key })),
+                Quiet: true,
+            },
+        }));
+        return {
+            succeeded: validEntries.map(({ url }) => url),
+            failed: invalidUrls,
+        };
+    }
+    catch (error) {
+        console.error('[Media] Batch delete failed:', error);
+        // On error, try to delete individually
+        const succeeded = [];
+        const failed = [...invalidUrls];
+        for (const { url, key } of validEntries) {
+            try {
+                await client.send(new DeleteObjectCommand({
+                    Bucket: bucketName,
+                    Key: key,
+                }));
+                succeeded.push(url);
+            }
+            catch {
+                failed.push(url);
+            }
+        }
+        return { succeeded, failed };
+    }
+}
+// =============================================================================
+// Safe Deletion (with existence check)
+// =============================================================================
+/**
+ * Safely delete a file - returns false instead of throwing if file doesn't exist.
+ *
+ * @param url - Public URL of the file to delete
+ * @param config - Optional storage configuration override
+ * @returns True if deleted, false if not found or invalid
+ */
+export async function safeDeleteFile(url, config) {
+    try {
+        return await deleteFile(url, config);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=delete.js.map

package/dist/media/server/delete.js.map

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

package/dist/media/server/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @rovela-ai/sdk/media/server
+ *
+ * Server-side media utilities.
+ * Only import this in server components and API routes.
+ */
+export { getR2Client, clearR2ClientCache, getBucketName, getPublicUrlBase, getStoreId } from './r2-client';
+export { generatePresignedUrl, generatePresignedUrls, isR2Url, validateStoreUrl, type GeneratePresignedUrlOptions, } from './presign';
+export { deleteFile, deleteFileByKey, deleteFiles, safeDeleteFile } from './delete';
+//# sourceMappingURL=index.d.ts.map

package/dist/media/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG1G,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,OAAO,EACP,gBAAgB,EAChB,KAAK,2BAA2B,GACjC,MAAM,WAAW,CAAA;AAGlB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}

package/dist/media/server/index.js

@@ -0,0 +1,13 @@
+/**
+ * @rovela-ai/sdk/media/server
+ *
+ * Server-side media utilities.
+ * Only import this in server components and API routes.
+ */
+// R2 Client
+export { getR2Client, clearR2ClientCache, getBucketName, getPublicUrlBase, getStoreId } from './r2-client';
+// Presigned URLs
+export { generatePresignedUrl, generatePresignedUrls, isR2Url, validateStoreUrl, } from './presign';
+// File Deletion
+export { deleteFile, deleteFileByKey, deleteFiles, safeDeleteFile } from './delete';
+//# sourceMappingURL=index.js.map

package/dist/media/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE1G,iBAAiB;AACjB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,OAAO,EACP,gBAAgB,GAEjB,MAAM,WAAW,CAAA;AAElB,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}

package/dist/media/server/presign.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @rovela-ai/sdk/media/server/presign
+ *
+ * Presigned URL generation for direct browser uploads to R2.
+ * Server-side only - do not import in client components.
+ */
+import type { PresignedUrlRequest, PresignedUrlResponse, MediaStorageConfig } from '../types';
+/**
+ * Options for generating a presigned URL
+ */
+export interface GeneratePresignedUrlOptions {
+    /** URL expiration time in seconds (default: 300 = 5 minutes) */
+    expiresIn?: number;
+    /** Optional storage config override */
+    config?: MediaStorageConfig;
+}
+/**
+ * Generate a presigned URL for uploading a file to R2.
+ *
+ * The presigned URL allows the browser to upload directly to R2
+ * without the file passing through your server.
+ *
+ * @param request - Upload request details
+ * @param options - Optional configuration
+ * @returns Presigned URL response with upload URL and final public URL
+ *
+ * @example
+ * ```typescript
+ * const result = await generatePresignedUrl({
+ *   filename: 'product-image.jpg',
+ *   contentType: 'image/jpeg',
+ *   folder: 'products',
+ *   entityId: 'prod_abc123',
+ * });
+ *
+ * // Client uploads directly to result.uploadUrl
+ * // After upload, image is accessible at result.publicUrl
+ * ```
+ */
+export declare function generatePresignedUrl(request: PresignedUrlRequest, options?: GeneratePresignedUrlOptions): Promise<PresignedUrlResponse>;
+/**
+ * Generate presigned URLs for multiple files at once.
+ *
+ * @param requests - Array of upload request details
+ * @param options - Optional configuration
+ * @returns Array of presigned URL responses
+ */
+export declare function generatePresignedUrls(requests: PresignedUrlRequest[], options?: GeneratePresignedUrlOptions): Promise<PresignedUrlResponse[]>;
+/**
+ * Check if a URL is from this store's R2 storage
+ */
+export declare function isR2Url(url: string, config?: MediaStorageConfig): boolean;
+/**
+ * Validate that a URL belongs to this store's storage prefix
+ */
+export declare function validateStoreUrl(url: string, config?: MediaStorageConfig): boolean;
+//# sourceMappingURL=presign.d.ts.map

package/dist/media/server/presign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presign.d.ts","sourceRoot":"","sources":["../../../src/media/server/presign.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,UAAU,CAAA;AAcjB;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAwC/B;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAEjC;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAGzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAiBlF"}

package/dist/media/server/presign.js

@@ -0,0 +1,112 @@
+/**
+ * @rovela-ai/sdk/media/server/presign
+ *
+ * Presigned URL generation for direct browser uploads to R2.
+ * Server-side only - do not import in client components.
+ */
+import { PutObjectCommand } from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+import { generateUniqueFilename } from '../types';
+import { buildStorageKey, buildPublicUrl, requireMediaConfig } from '../config';
+import { getR2Client, getBucketName, getPublicUrlBase, getStoreId } from './r2-client';
+// =============================================================================
+// Presigned URL Generation
+// =============================================================================
+/**
+ * Default presigned URL expiration time in seconds (5 minutes)
+ */
+const DEFAULT_EXPIRES_IN = 5 * 60;
+/**
+ * Generate a presigned URL for uploading a file to R2.
+ *
+ * The presigned URL allows the browser to upload directly to R2
+ * without the file passing through your server.
+ *
+ * @param request - Upload request details
+ * @param options - Optional configuration
+ * @returns Presigned URL response with upload URL and final public URL
+ *
+ * @example
+ * ```typescript
+ * const result = await generatePresignedUrl({
+ *   filename: 'product-image.jpg',
+ *   contentType: 'image/jpeg',
+ *   folder: 'products',
+ *   entityId: 'prod_abc123',
+ * });
+ *
+ * // Client uploads directly to result.uploadUrl
+ * // After upload, image is accessible at result.publicUrl
+ * ```
+ */
+export async function generatePresignedUrl(request, options = {}) {
+    const { expiresIn = DEFAULT_EXPIRES_IN, config } = options;
+    // Get configuration
+    const resolvedConfig = config || requireMediaConfig();
+    const client = getR2Client(resolvedConfig);
+    const bucketName = getBucketName(resolvedConfig);
+    const publicUrlBase = getPublicUrlBase(resolvedConfig);
+    const storeId = getStoreId(resolvedConfig);
+    // Generate unique filename to prevent overwrites
+    const uniqueFilename = generateUniqueFilename(request.filename);
+    // Build the storage key (path)
+    const key = buildStorageKey(storeId, request.folder, uniqueFilename, request.entityId);
+    // Create the PutObject command
+    const command = new PutObjectCommand({
+        Bucket: bucketName,
+        Key: key,
+        ContentType: request.contentType,
+    });
+    // Generate presigned URL
+    const uploadUrl = await getSignedUrl(client, command, {
+        expiresIn,
+    });
+    // Calculate expiration time
+    const expiresAt = new Date(Date.now() + expiresIn * 1000);
+    // Build public URL
+    const publicUrl = buildPublicUrl(publicUrlBase, key);
+    return {
+        uploadUrl,
+        publicUrl,
+        key,
+        expiresAt,
+    };
+}
+/**
+ * Generate presigned URLs for multiple files at once.
+ *
+ * @param requests - Array of upload request details
+ * @param options - Optional configuration
+ * @returns Array of presigned URL responses
+ */
+export async function generatePresignedUrls(requests, options = {}) {
+    return Promise.all(requests.map((request) => generatePresignedUrl(request, options)));
+}
+// =============================================================================
+// URL Validation
+// =============================================================================
+/**
+ * Check if a URL is from this store's R2 storage
+ */
+export function isR2Url(url, config) {
+    const resolvedConfig = config || requireMediaConfig();
+    return url.startsWith(resolvedConfig.publicUrl);
+}
+/**
+ * Validate that a URL belongs to this store's storage prefix
+ */
+export function validateStoreUrl(url, config) {
+    const resolvedConfig = config || requireMediaConfig();
+    if (!isR2Url(url, resolvedConfig)) {
+        return false;
+    }
+    // Extract key from URL and check prefix
+    const baseUrl = resolvedConfig.publicUrl.endsWith('/')
+        ? resolvedConfig.publicUrl.slice(0, -1)
+        : resolvedConfig.publicUrl;
+    const key = url.slice(baseUrl.length + 1);
+    // Key should start with stores/{storeId}/
+    const expectedPrefix = `stores/${resolvedConfig.storeId}/`;
+    return key.startsWith(expectedPrefix);
+}
+//# sourceMappingURL=presign.js.map

package/dist/media/server/presign.js.map

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

package/dist/media/server/r2-client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @rovela-ai/sdk/media/server/r2-client
+ *
+ * S3-compatible client for Cloudflare R2 storage.
+ * Server-side only - do not import in client components.
+ */
+import { S3Client } from '@aws-sdk/client-s3';
+import type { MediaStorageConfig } from '../types';
+/**
+ * Get or create the S3 client for R2.
+ * Caches the client instance for reuse.
+ */
+export declare function getR2Client(config?: MediaStorageConfig): S3Client;
+/**
+ * Clear the cached client (useful for testing)
+ */
+export declare function clearR2ClientCache(): void;
+/**
+ * Get the configured bucket name
+ */
+export declare function getBucketName(config?: MediaStorageConfig): string;
+/**
+ * Get the public URL base for the bucket
+ */
+export declare function getPublicUrlBase(config?: MediaStorageConfig): string;
+/**
+ * Get the store ID for path prefixing
+ */
+export declare function getStoreId(config?: MediaStorageConfig): string;
+//# sourceMappingURL=r2-client.d.ts.map

package/dist/media/server/r2-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-client.d.ts","sourceRoot":"","sources":["../../../src/media/server/r2-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAoBlD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAsBjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAGpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAG9D"}

package/dist/media/server/r2-client.js

@@ -0,0 +1,76 @@
+/**
+ * @rovela-ai/sdk/media/server/r2-client
+ *
+ * S3-compatible client for Cloudflare R2 storage.
+ * Server-side only - do not import in client components.
+ */
+import { S3Client } from '@aws-sdk/client-s3';
+import { requireMediaConfig } from '../config';
+// =============================================================================
+// Client Instance Management
+// =============================================================================
+/** Cached S3 client instance */
+let cachedClient = null;
+/** Cached config used to create the client */
+let cachedConfigHash = null;
+/**
+ * Create a hash of the config for cache invalidation
+ */
+function hashConfig(config) {
+    return `${config.accountId}:${config.bucketName}:${config.accessKeyId.slice(0, 8)}`;
+}
+/**
+ * Get or create the S3 client for R2.
+ * Caches the client instance for reuse.
+ */
+export function getR2Client(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    const configHash = hashConfig(resolvedConfig);
+    // Return cached client if config hasn't changed
+    if (cachedClient && cachedConfigHash === configHash) {
+        return cachedClient;
+    }
+    // Create new client
+    cachedClient = new S3Client({
+        region: 'auto',
+        endpoint: `https://${resolvedConfig.accountId}.r2.cloudflarestorage.com`,
+        credentials: {
+            accessKeyId: resolvedConfig.accessKeyId,
+            secretAccessKey: resolvedConfig.secretAccessKey,
+        },
+    });
+    cachedConfigHash = configHash;
+    return cachedClient;
+}
+/**
+ * Clear the cached client (useful for testing)
+ */
+export function clearR2ClientCache() {
+    cachedClient = null;
+    cachedConfigHash = null;
+}
+// =============================================================================
+// Bucket Operations
+// =============================================================================
+/**
+ * Get the configured bucket name
+ */
+export function getBucketName(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    return resolvedConfig.bucketName;
+}
+/**
+ * Get the public URL base for the bucket
+ */
+export function getPublicUrlBase(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    return resolvedConfig.publicUrl;
+}
+/**
+ * Get the store ID for path prefixing
+ */
+export function getStoreId(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    return resolvedConfig.storeId;
+}
+//# sourceMappingURL=r2-client.js.map

package/dist/media/server/r2-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-client.js","sourceRoot":"","sources":["../../../src/media/server/r2-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE9C,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF,gCAAgC;AAChC,IAAI,YAAY,GAAoB,IAAI,CAAA;AAExC,8CAA8C;AAC9C,IAAI,gBAAgB,GAAkB,IAAI,CAAA;AAE1C;;GAEG;AACH,SAAS,UAAU,CAAC,MAA0B;IAC5C,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAA2B;IACrD,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAA;IAE7C,gDAAgD;IAChD,IAAI,YAAY,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpD,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,oBAAoB;IACpB,YAAY,GAAG,IAAI,QAAQ,CAAC;QAC1B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,WAAW,cAAc,CAAC,SAAS,2BAA2B;QACxE,WAAW,EAAE;YACX,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,eAAe,EAAE,cAAc,CAAC,eAAe;SAChD;KACF,CAAC,CAAA;IAEF,gBAAgB,GAAG,UAAU,CAAA;IAE7B,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,YAAY,GAAG,IAAI,CAAA;IACnB,gBAAgB,GAAG,IAAI,CAAA;AACzB,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,OAAO,cAAc,CAAC,UAAU,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IAC1D,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,OAAO,cAAc,CAAC,SAAS,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAA2B;IACpD,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,OAAO,cAAc,CAAC,OAAO,CAAA;AAC/B,CAAC"}