@hamak/ui-remote-resource 0.5.1

package/dist/api/types/resource-attributes.d.ts

@@ -0,0 +1,43 @@
+import type { ResourceOperation, EntityKey } from './resource-types';
+/**
+ * Remote resource attributes stored in extensionStates
+ *
+ * Note: Does not include loading/error/schema as these are already in FileSystemNode:
+ * - loading: FileSystemNodeState.contentLoading
+ * - error: FileSystemNodeState.contentLoadError
+ * - schema: FileNode.schema (top-level field)
+ */
+export interface RemoteResourceAttributes {
+    /** Last fetch timestamp */
+    lastFetched?: number;
+    /** Cache expiry timestamp */
+    expiresAt?: number;
+    /** Endpoint ID that populated this file */
+    endpointId?: string;
+    /** Resource-specific metadata */
+    metadata?: {
+        status?: number;
+        headers?: Record<string, string>;
+        [key: string]: any;
+    };
+    /** Last operation performed */
+    lastOperation?: ResourceOperation;
+    /** Optimistic update flag */
+    optimistic?: boolean;
+    /** Entity-specific attributes (if this resource represents an entity) */
+    entity?: EntityAttributes;
+}
+/**
+ * Entity-specific attributes (nested under resource attributes)
+ */
+export interface EntityAttributes {
+    /** Entity type identifier */
+    entityId: string;
+    /** Entity keys (for re-fetching, updating, deleting) */
+    keys: EntityKey;
+    /** Entity key schema fields */
+    keyFields: string[];
+    /** Entity version (for optimistic locking) */
+    version?: string | number;
+}
+//# sourceMappingURL=resource-attributes.d.ts.map

package/dist/api/types/resource-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-attributes.d.ts","sourceRoot":"","sources":["../../../src/api/types/resource-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF,+BAA+B;IAC/B,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,yEAAyE;IACzE,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAEhB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B"}

package/dist/api/types/resource-attributes.js

@@ -0,0 +1 @@
+export {};

package/dist/api/types/resource-types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resource operation types
+ */
+export type ResourceOperation = 'fetch' | 'create' | 'update' | 'delete';
+/**
+ * Entity key - can be simple or composite
+ * Examples:
+ * - Simple: { id: "123" }
+ * - Composite: { tenantId: "org1", userId: "user123" }
+ */
+export type EntityKey = Record<string, string | number>;
+/**
+ * Error object structure
+ */
+export interface ErrorObject {
+    message: string;
+    code?: string;
+    details?: any;
+}
+//# sourceMappingURL=resource-types.d.ts.map

package/dist/api/types/resource-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-types.d.ts","sourceRoot":"","sources":["../../../src/api/types/resource-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,GAAG,CAAC;CACf"}

package/dist/api/types/resource-types.js

@@ -0,0 +1 @@
+export {};

package/dist/api/utils/resource-attributes-util.d.ts

@@ -0,0 +1,183 @@
+type FileSystemNode = any;
+import type { RemoteResourceAttributes, EntityAttributes } from '../types/resource-attributes';
+import type { EntityKey, ResourceOperation } from '../types/resource-types';
+/**
+ * Utility class for accessing and manipulating remote resource attributes
+ * stored in file node extension states.
+ *
+ * Note: This utility accesses loading/error/schema from FileSystemNode directly:
+ * - loading: node.state.contentLoading
+ * - error: node.state.contentLoadError
+ * - schema: node.schema (for FileNode)
+ */
+export declare class ResourceAttributesUtil {
+    /**
+     * Extension state key for remote resource attributes
+     */
+    readonly extensionKey = "ui-remote-resource";
+    /**
+     * Get remote resource attributes from file node extension state
+     */
+    getResourceAttributes(node: FileSystemNode | undefined): RemoteResourceAttributes | undefined;
+    /**
+     * Check if file has resource attributes
+     */
+    hasResourceAttributes(node: FileSystemNode | undefined): boolean;
+    /**
+     * Get loading state from FileSystemNodeState (not extension state)
+     */
+    isLoading(node: FileSystemNode | undefined): boolean;
+    /**
+     * Get error information from FileSystemNodeState (not extension state)
+     */
+    getError(node: FileSystemNode | undefined): {
+        message?: string;
+        code?: string;
+    } | undefined;
+    /**
+     * Check if resource has error
+     */
+    hasError(node: FileSystemNode | undefined): boolean;
+    /**
+     * Get resource metadata from extension state
+     */
+    getMetadata(node: FileSystemNode | undefined): Record<string, any> | undefined;
+    /**
+     * Get last fetch timestamp from extension state
+     */
+    getLastFetchTime(node: FileSystemNode | undefined): number | undefined;
+    /**
+     * Get cache expiry timestamp from extension state
+     */
+    getExpiryTime(node: FileSystemNode | undefined): number | undefined;
+    /**
+     * Check if resource is cached and not expired
+     */
+    isCached(node: FileSystemNode | undefined): boolean;
+    /**
+     * Get endpoint ID from extension state
+     */
+    getEndpointId(node: FileSystemNode | undefined): string | undefined;
+    /**
+     * Get schema reference from FileNode (not extension state)
+     */
+    getSchema(node: FileSystemNode | undefined): string | undefined;
+    /**
+     * Get last operation performed from extension state
+     */
+    getLastOperation(node: FileSystemNode | undefined): ResourceOperation | undefined;
+    /**
+     * Check if resource is optimistic update
+     */
+    isOptimistic(node: FileSystemNode | undefined): boolean;
+    /**
+     * Get entity attributes from extension state
+     */
+    getEntityAttributes(node: FileSystemNode | undefined): EntityAttributes | undefined;
+    /**
+     * Check if file represents an entity
+     */
+    isEntity(node: FileSystemNode | undefined): boolean;
+    /**
+     * Get entity ID
+     */
+    getEntityId(node: FileSystemNode | undefined): string | undefined;
+    /**
+     * Get entity keys
+     */
+    getEntityKeys(node: FileSystemNode | undefined): EntityKey | undefined;
+    /**
+     * Get entity key fields
+     */
+    getEntityKeyFields(node: FileSystemNode | undefined): string[] | undefined;
+    /**
+     * Get entity version
+     */
+    getEntityVersion(node: FileSystemNode | undefined): string | number | undefined;
+    /**
+     * Get specific entity key value
+     */
+    getEntityKeyValue(node: FileSystemNode | undefined, keyField: string): string | number | undefined;
+    /**
+     * Create resource attributes object (for extension state only)
+     * Does NOT include loading/error/schema - those go in FileSystemNodeState/FileNode
+     */
+    createResourceAttributes(partial: Partial<RemoteResourceAttributes>): RemoteResourceAttributes;
+    /**
+     * Create entity attributes object
+     */
+    createEntityAttributes(entityId: string, keys: EntityKey, keyFields: string[], version?: string | number): EntityAttributes;
+    /**
+     * Merge resource attributes (for partial updates in extension state)
+     */
+    mergeResourceAttributes(existing: RemoteResourceAttributes | undefined, updates: Partial<RemoteResourceAttributes>): RemoteResourceAttributes;
+    /**
+     * Create attributes for successful resource call
+     * Note: loading/error are managed separately in FileSystemNodeState
+     */
+    createSuccessAttributes(endpointId: string, metadata?: any, operation?: ResourceOperation): RemoteResourceAttributes;
+    /**
+     * Check if resource needs refresh based on cache duration
+     */
+    needsRefresh(node: FileSystemNode | undefined, cacheDurationMs?: number): boolean;
+    /**
+     * Calculate cache expiry time
+     */
+    calculateExpiryTime(cacheDurationMs: number): number;
+    /**
+     * Get complete resource state for component use
+     */
+    getResourceState(node: FileSystemNode | undefined): {
+        data: any;
+        loading: boolean;
+        error: {
+            message?: string | undefined;
+            code?: string | undefined;
+        } | undefined;
+        metadata: {
+            [key: string]: any;
+            status?: number | undefined;
+            headers?: Record<string, string> | undefined;
+        } | undefined;
+        lastFetched: number | undefined;
+        cached: boolean;
+        endpointId: string | undefined;
+        schema: string | undefined;
+        lastOperation: ResourceOperation | undefined;
+    };
+    /**
+     * Get complete entity state for component use
+     */
+    getEntityState(node: FileSystemNode | undefined): {
+        isEntity: boolean;
+        entityId: string | undefined;
+        entityKeys: EntityKey | undefined;
+        entityKeyFields: string[] | undefined;
+        entityVersion: string | number | undefined;
+        data: any;
+        loading: boolean;
+        error: {
+            message?: string | undefined;
+            code?: string | undefined;
+        } | undefined;
+        metadata: {
+            [key: string]: any;
+            status?: number | undefined;
+            headers?: Record<string, string> | undefined;
+        } | undefined;
+        lastFetched: number | undefined;
+        cached: boolean;
+        endpointId: string | undefined;
+        schema: string | undefined;
+        lastOperation: ResourceOperation | undefined;
+    };
+}
+/**
+ * Singleton instance
+ */
+export declare const resourceAttributesUtil: ResourceAttributesUtil;
+/**
+ * Default export for convenience
+ */
+export default resourceAttributesUtil;
+//# sourceMappingURL=resource-attributes-util.d.ts.map

package/dist/api/utils/resource-attributes-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-attributes-util.d.ts","sourceRoot":"","sources":["../../../src/api/utils/resource-attributes-util.ts"],"names":[],"mappings":"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"}

package/dist/api/utils/resource-attributes-util.js

@@ -0,0 +1,280 @@
+import { REMOTE_RESOURCE_EXTENSION_KEY } from '../constants';
+/**
+ * Utility class for accessing and manipulating remote resource attributes
+ * stored in file node extension states.
+ *
+ * Note: This utility accesses loading/error/schema from FileSystemNode directly:
+ * - loading: node.state.contentLoading
+ * - error: node.state.contentLoadError
+ * - schema: node.schema (for FileNode)
+ */
+export class ResourceAttributesUtil {
+    constructor() {
+        /**
+         * Extension state key for remote resource attributes
+         */
+        Object.defineProperty(this, "extensionKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: REMOTE_RESOURCE_EXTENSION_KEY
+        });
+    }
+    // ========== Resource Attributes Accessors ==========
+    /**
+     * Get remote resource attributes from file node extension state
+     */
+    getResourceAttributes(node) {
+        if (!node || node.type !== 'file') {
+            return undefined;
+        }
+        const fileNode = node;
+        return fileNode.state?.extensionStates?.[this.extensionKey];
+    }
+    /**
+     * Check if file has resource attributes
+     */
+    hasResourceAttributes(node) {
+        return this.getResourceAttributes(node) !== undefined;
+    }
+    /**
+     * Get loading state from FileSystemNodeState (not extension state)
+     */
+    isLoading(node) {
+        if (!node)
+            return false;
+        return node.state?.contentLoading === true;
+    }
+    /**
+     * Get error information from FileSystemNodeState (not extension state)
+     */
+    getError(node) {
+        if (!node)
+            return undefined;
+        return node.state?.contentLoadError;
+    }
+    /**
+     * Check if resource has error
+     */
+    hasError(node) {
+        return this.getError(node) !== undefined;
+    }
+    /**
+     * Get resource metadata from extension state
+     */
+    getMetadata(node) {
+        return this.getResourceAttributes(node)?.metadata;
+    }
+    /**
+     * Get last fetch timestamp from extension state
+     */
+    getLastFetchTime(node) {
+        return this.getResourceAttributes(node)?.lastFetched;
+    }
+    /**
+     * Get cache expiry timestamp from extension state
+     */
+    getExpiryTime(node) {
+        return this.getResourceAttributes(node)?.expiresAt;
+    }
+    /**
+     * Check if resource is cached and not expired
+     */
+    isCached(node) {
+        const attrs = this.getResourceAttributes(node);
+        if (!attrs || !attrs.lastFetched) {
+            return false;
+        }
+        if (attrs.expiresAt) {
+            return Date.now() < attrs.expiresAt;
+        }
+        return true;
+    }
+    /**
+     * Get endpoint ID from extension state
+     */
+    getEndpointId(node) {
+        return this.getResourceAttributes(node)?.endpointId;
+    }
+    /**
+     * Get schema reference from FileNode (not extension state)
+     */
+    getSchema(node) {
+        if (!node || node.type !== 'file') {
+            return undefined;
+        }
+        const fileNode = node;
+        return typeof fileNode.schema === 'string'
+            ? fileNode.schema
+            : fileNode.schema?.schemaObject;
+    }
+    /**
+     * Get last operation performed from extension state
+     */
+    getLastOperation(node) {
+        return this.getResourceAttributes(node)?.lastOperation;
+    }
+    /**
+     * Check if resource is optimistic update
+     */
+    isOptimistic(node) {
+        return this.getResourceAttributes(node)?.optimistic === true;
+    }
+    // ========== Entity Attributes Accessors ==========
+    /**
+     * Get entity attributes from extension state
+     */
+    getEntityAttributes(node) {
+        const resourceAttrs = this.getResourceAttributes(node);
+        return resourceAttrs?.entity;
+    }
+    /**
+     * Check if file represents an entity
+     */
+    isEntity(node) {
+        return this.getEntityAttributes(node) !== undefined;
+    }
+    /**
+     * Get entity ID
+     */
+    getEntityId(node) {
+        return this.getEntityAttributes(node)?.entityId;
+    }
+    /**
+     * Get entity keys
+     */
+    getEntityKeys(node) {
+        return this.getEntityAttributes(node)?.keys;
+    }
+    /**
+     * Get entity key fields
+     */
+    getEntityKeyFields(node) {
+        return this.getEntityAttributes(node)?.keyFields;
+    }
+    /**
+     * Get entity version
+     */
+    getEntityVersion(node) {
+        return this.getEntityAttributes(node)?.version;
+    }
+    /**
+     * Get specific entity key value
+     */
+    getEntityKeyValue(node, keyField) {
+        const keys = this.getEntityKeys(node);
+        return keys?.[keyField];
+    }
+    // ========== Attribute Builders ==========
+    /**
+     * Create resource attributes object (for extension state only)
+     * Does NOT include loading/error/schema - those go in FileSystemNodeState/FileNode
+     */
+    createResourceAttributes(partial) {
+        return {
+            ...partial
+        };
+    }
+    /**
+     * Create entity attributes object
+     */
+    createEntityAttributes(entityId, keys, keyFields, version) {
+        return {
+            entityId,
+            keys,
+            keyFields,
+            version
+        };
+    }
+    /**
+     * Merge resource attributes (for partial updates in extension state)
+     */
+    mergeResourceAttributes(existing, updates) {
+        return {
+            ...existing,
+            ...updates,
+            // Deep merge metadata
+            metadata: {
+                ...existing?.metadata,
+                ...updates.metadata
+            },
+            // Deep merge entity (if present in both)
+            entity: updates.entity !== undefined
+                ? { ...existing?.entity, ...updates.entity }
+                : existing?.entity
+        };
+    }
+    /**
+     * Create attributes for successful resource call
+     * Note: loading/error are managed separately in FileSystemNodeState
+     */
+    createSuccessAttributes(endpointId, metadata, operation) {
+        return {
+            endpointId,
+            metadata,
+            lastFetched: Date.now(),
+            lastOperation: operation
+        };
+    }
+    // ========== Cache Utilities ==========
+    /**
+     * Check if resource needs refresh based on cache duration
+     */
+    needsRefresh(node, cacheDurationMs) {
+        if (!cacheDurationMs) {
+            return !this.isCached(node);
+        }
+        const lastFetched = this.getLastFetchTime(node);
+        if (!lastFetched) {
+            return true;
+        }
+        return Date.now() - lastFetched > cacheDurationMs;
+    }
+    /**
+     * Calculate cache expiry time
+     */
+    calculateExpiryTime(cacheDurationMs) {
+        return Date.now() + cacheDurationMs;
+    }
+    // ========== Utility Methods ==========
+    /**
+     * Get complete resource state for component use
+     */
+    getResourceState(node) {
+        const attrs = this.getResourceAttributes(node);
+        return {
+            data: node?.type === 'file' ? node.content : undefined,
+            loading: this.isLoading(node),
+            error: this.getError(node),
+            metadata: attrs?.metadata,
+            lastFetched: attrs?.lastFetched,
+            cached: this.isCached(node),
+            endpointId: attrs?.endpointId,
+            schema: this.getSchema(node),
+            lastOperation: attrs?.lastOperation
+        };
+    }
+    /**
+     * Get complete entity state for component use
+     */
+    getEntityState(node) {
+        const resourceState = this.getResourceState(node);
+        const entityAttrs = this.getEntityAttributes(node);
+        return {
+            ...resourceState,
+            isEntity: !!entityAttrs,
+            entityId: entityAttrs?.entityId,
+            entityKeys: entityAttrs?.keys,
+            entityKeyFields: entityAttrs?.keyFields,
+            entityVersion: entityAttrs?.version
+        };
+    }
+}
+/**
+ * Singleton instance
+ */
+export const resourceAttributesUtil = new ResourceAttributesUtil();
+/**
+ * Default export for convenience
+ */
+export default resourceAttributesUtil;

package/dist/impl/autosave/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Remote Resource Autosave
+ */
+export * from './resource-autosave-provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/impl/autosave/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/impl/autosave/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,8BAA8B,CAAC"}

package/dist/impl/autosave/index.js

@@ -0,0 +1,4 @@
+/**
+ * Remote Resource Autosave
+ */
+export * from './resource-autosave-provider';

package/dist/impl/autosave/resource-autosave-provider.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Resource Autosave Provider
+ *
+ * Implements autosave for files managed by the remote resource plugin.
+ * Uses UPDATE_ENTITY or RESOURCE_CALL_REQUEST actions to save files.
+ */
+import type { Dispatch, AnyAction } from 'redux';
+import type { FileSystemNode } from '@hamak/shared-utils';
+import type { IAutosaveProvider, AutosaveResult } from '@hamak/ui-store-spi';
+import { EntityActionFactory } from '../../api';
+import { ResourceActionFactory } from '../../api';
+/**
+ * Configuration for ResourceAutosaveProvider
+ */
+export interface ResourceAutosaveProviderConfig {
+    /** Entity action factory */
+    entityActionFactory?: EntityActionFactory;
+    /** Resource action factory */
+    resourceActionFactory?: ResourceActionFactory;
+}
+/**
+ * Autosave provider for remote resources
+ *
+ * This provider handles autosave for files that are managed via the
+ * remote resource plugin. It checks for the presence of resource/entity
+ * extension state and uses appropriate actions to save changes.
+ */
+export declare class ResourceAutosaveProvider implements IAutosaveProvider {
+    readonly id = "remote-resource";
+    readonly priority = 20;
+    private entityActionFactory;
+    private resourceActionFactory;
+    constructor(config?: ResourceAutosaveProviderConfig);
+    /**
+     * Check if this provider supports a given path.
+     * Returns true if the node has remote resource extension state.
+     */
+    supports(_path: string[], node: FileSystemNode): boolean;
+    /**
+     * Save file content to remote server.
+     * Dispatches UPDATE_ENTITY (if entity) or RESOURCE_CALL_REQUEST (if resource).
+     */
+    save(path: string[], content: unknown, node: FileSystemNode, dispatch: Dispatch<AnyAction>): Promise<AutosaveResult>;
+    /**
+     * Cancel is a no-op for resources since we don't track in-flight requests here.
+     */
+    cancel(_path: string[]): void;
+}
+//# sourceMappingURL=resource-autosave-provider.d.ts.map

package/dist/impl/autosave/resource-autosave-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-autosave-provider.d.ts","sourceRoot":"","sources":["../../../src/impl/autosave/resource-autosave-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,4BAA4B;IAC5B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,EAAE,qBAAqB;IAChC,QAAQ,CAAC,QAAQ,MAAM;IAEvB,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,qBAAqB,CAAwB;gBAEzC,MAAM,GAAE,8BAAmC;IAKvD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAKxD;;;OAGG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC;IAgE1B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;CAG9B"}