@trokky/trokky 2.0.3

package/dist/core/types/user.js

@@ -0,0 +1,45 @@
+/**
+ * System user types for CMS authentication and authorization
+ * These are internal system entities, separate from user-defined content schemas
+ *
+ * Types are now centralized in @trokky/types and re-exported here for backwards compatibility.
+ */
+// Default permissions for each role (this is runtime data, not just types)
+export const ROLE_PERMISSIONS = {
+    admin: [
+        'content:read', 'content:write', 'content:delete', 'content:publish',
+        'media:read', 'media:upload', 'media:edit', 'media:delete',
+        'users:read', 'users:write', 'users:delete', 'users:invite',
+        'settings:read', 'settings:write',
+        'studio:access',
+        'tokens:read', 'tokens:write', 'tokens:delete',
+        'webhooks:read', 'webhooks:write', 'webhooks:delete', 'webhooks:test'
+    ],
+    editor: [
+        'content:read', 'content:write', 'content:delete', 'content:publish',
+        'media:read', 'media:upload', 'media:edit', 'media:delete',
+        'studio:access'
+    ],
+    author: [
+        'content:read', 'content:write', 'content:publish',
+        'media:read', 'media:upload',
+        'studio:access'
+    ],
+    writer: [
+        // Writer can create and edit content, but cannot publish or delete
+        // Content must be reviewed and published by an editor or admin
+        'content:read', 'content:write',
+        'media:read', 'media:upload',
+        'studio:access'
+    ],
+    viewer: [
+        'content:read',
+        'media:read',
+        'studio:access'
+    ],
+    api: [
+    // API tokens get their permissions from the token itself, not from role defaults
+    // This is just a placeholder - actual permissions come from AppToken.permissions
+    ]
+};
+//# sourceMappingURL=user.js.map

package/dist/core/types/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../../src/core/types/user.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+CH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,KAAK,EAAE;QACL,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB;QACpE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc;QAC1D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc;QAC3D,eAAe,EAAE,gBAAgB;QACjC,eAAe;QACf,aAAa,EAAE,cAAc,EAAE,eAAe;QAC9C,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe;KACtE;IACD,MAAM,EAAE;QACN,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB;QACpE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc;QAC1D,eAAe;KAChB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,eAAe,EAAE,iBAAiB;QAClD,YAAY,EAAE,cAAc;QAC5B,eAAe;KAChB;IACD,MAAM,EAAE;QACN,mEAAmE;QACnE,+DAA+D;QAC/D,cAAc,EAAE,eAAe;QAC/B,YAAY,EAAE,cAAc;QAC5B,eAAe;KAChB;IACD,MAAM,EAAE;QACN,cAAc;QACd,YAAY;QACZ,eAAe;KAChB;IACD,GAAG,EAAE;IACH,iFAAiF;IACjF,iFAAiF;KAClF;CACF,CAAA"}

package/dist/core/utils/id-generator.d.ts

@@ -0,0 +1,16 @@
+export interface IdGeneratorOptions {
+    prefix?: string;
+    length?: number;
+    includeTimestamp?: boolean;
+}
+export declare class IdGenerator {
+    private counter;
+    private readonly instanceId;
+    private readonly crypto;
+    constructor();
+    generate(options?: IdGeneratorOptions): string;
+    generateUUID(): string;
+    validateId(id: string): boolean;
+    reset(): void;
+}
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/core/utils/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../../src/core/utils/id-generator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;;IAQvC,QAAQ,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM;IAqClD,YAAY,IAAI,MAAM;IAkBtB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B,KAAK,IAAI,IAAI;CAGrB"}

package/dist/core/utils/id-generator.js

@@ -0,0 +1,61 @@
+import { getUniversalCrypto, bytesToHex } from './universal-crypto.js';
+export class IdGenerator {
+    counter = 0;
+    instanceId;
+    crypto = getUniversalCrypto();
+    constructor() {
+        // Generate a unique instance ID for this generator
+        const bytes = this.crypto.getRandomBytes(4);
+        this.instanceId = bytesToHex(bytes);
+    }
+    generate(options = {}) {
+        const { prefix = '', length = 12, includeTimestamp = true } = options;
+        let id = '';
+        if (prefix) {
+            id += `${prefix}-`;
+        }
+        if (includeTimestamp) {
+            // Use timestamp in base36 for shorter IDs
+            id += Date.now().toString(36);
+            id += '-';
+        }
+        // Add instance ID to prevent collisions across instances
+        id += this.instanceId;
+        // Add counter to prevent collisions within same millisecond
+        id += '-';
+        id += (++this.counter).toString(36).padStart(2, '0');
+        // Add random bytes for additional entropy
+        const remainingLength = Math.max(4, length - id.length);
+        const randomBytesNeeded = Math.ceil(remainingLength / 2);
+        const randomBytesArray = this.crypto.getRandomBytes(randomBytesNeeded);
+        const randomPart = bytesToHex(randomBytesArray).slice(0, remainingLength);
+        id += randomPart;
+        return id;
+    }
+    generateUUID() {
+        // Generate a proper UUID v4
+        const bytes = this.crypto.getRandomBytes(16);
+        // Set version (4) and variant bits
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        const hex = bytesToHex(bytes);
+        return [
+            hex.slice(0, 8),
+            hex.slice(8, 12),
+            hex.slice(12, 16),
+            hex.slice(16, 20),
+            hex.slice(20, 32)
+        ].join('-');
+    }
+    validateId(id) {
+        if (typeof id !== 'string' || id.length === 0) {
+            return false;
+        }
+        // Basic validation - only alphanumeric, hyphens, and underscores
+        return /^[a-zA-Z0-9-_]+$/.test(id) && id.length <= 100;
+    }
+    reset() {
+        this.counter = 0;
+    }
+}
+//# sourceMappingURL=id-generator.js.map

package/dist/core/utils/id-generator.js.map

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

package/dist/core/utils/logger.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Trokky Logging System
+ *
+ * Platform-agnostic logger that works on:
+ * - Node.js servers
+ * - Edge functions (Cloudflare Workers, Vercel Edge)
+ * - Serverless functions (AWS Lambda, Netlify)
+ * - Browser environments
+ *
+ * Features:
+ * - Zero filesystem dependencies
+ * - Structured logging (JSON when appropriate)
+ * - Standard log levels
+ * - Environment-based configuration
+ * - Color support where available
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogContext {
+    package: string;
+    component?: string;
+    operation?: string;
+}
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context: LogContext;
+    data?: any;
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}
+export interface LoggerConfig {
+    level: LogLevel;
+    format: 'human' | 'json';
+    timestamp: boolean;
+    colors: boolean;
+}
+/**
+ * Platform-agnostic logger
+ */
+export declare class TrokkyLogger {
+    private config;
+    private context;
+    constructor(context: LogContext, config?: Partial<LoggerConfig>);
+    private shouldLog;
+    private createLogEntry;
+    private formatHuman;
+    private formatJson;
+    private output;
+    debug(message: string, data?: any): void;
+    info(message: string, data?: any): void;
+    warn(message: string, data?: any): void;
+    error(message: string, error?: Error | any): void;
+    child(context: Partial<LogContext>): TrokkyLogger;
+    configure(config: Partial<LoggerConfig>): void;
+}
+/**
+ * Global logger factory
+ */
+export declare class LoggerFactory {
+    private static globalConfig;
+    static configure(config: Partial<LoggerConfig>): void;
+    static create(context: LogContext): TrokkyLogger;
+    static setLevel(level: LogLevel): void;
+    static setFormat(format: 'human' | 'json'): void;
+    static disable(): void;
+}
+/**
+ * Convenience function to create package loggers
+ */
+export declare function createLogger(package_name: string, component?: string): TrokkyLogger;
+/**
+ * Environment-specific configuration helpers
+ */
+export declare const LoggerPresets: {
+    readonly development: {
+        readonly level: LogLevel;
+        readonly format: "human";
+        readonly colors: true;
+    };
+    readonly production: {
+        readonly level: LogLevel;
+        readonly format: "json";
+        readonly colors: false;
+    };
+    readonly testing: {
+        readonly level: LogLevel;
+        readonly format: "human";
+        readonly colors: false;
+    };
+    readonly edge: {
+        readonly level: LogLevel;
+        readonly format: "json";
+        readonly colors: false;
+    };
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,QAAQ,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,UAAU,CAAA;IACnB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE,OAAO,GAAG,MAAM,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;CAChB;AA2CD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAY;gBAEf,OAAO,EAAE,UAAU,EAAE,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAKnE,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,MAAM;IAiCd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG,GAAG,IAAI;IAQjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,YAAY;IAOjD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;CAG/C;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,YAAY,CAA4B;IAEvD,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAIrD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,YAAY;IAIhD,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAItC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAIhD,MAAM,CAAC,OAAO,IAAI,IAAI;CAGvB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAEnF;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;wBACS,QAAQ;;;;;wBACV,QAAQ;;;;;wBACX,QAAQ;;;;;wBACX,QAAQ;;;;CACzB,CAAA"}

package/dist/core/utils/logger.js

@@ -0,0 +1,212 @@
+/**
+ * Trokky Logging System
+ *
+ * Platform-agnostic logger that works on:
+ * - Node.js servers
+ * - Edge functions (Cloudflare Workers, Vercel Edge)
+ * - Serverless functions (AWS Lambda, Netlify)
+ * - Browser environments
+ *
+ * Features:
+ * - Zero filesystem dependencies
+ * - Structured logging (JSON when appropriate)
+ * - Standard log levels
+ * - Environment-based configuration
+ * - Color support where available
+ */
+/**
+ * Environment detection
+ */
+const isNode = typeof process !== 'undefined' && process.versions?.node;
+const isBrowser = typeof globalThis !== 'undefined' && typeof globalThis.window !== 'undefined';
+const isEdge = typeof globalThis !== 'undefined' && typeof globalThis.EdgeRuntime !== 'undefined';
+const isDevelopment = typeof process !== 'undefined' && process.env.NODE_ENV === 'development';
+/**
+ * Default configuration based on environment
+ */
+const DEFAULT_CONFIG = {
+    level: isDevelopment ? 'debug' : 'info',
+    format: isDevelopment ? 'human' : 'json',
+    timestamp: true,
+    colors: Boolean(isNode && !isEdge && process.stdout?.isTTY)
+};
+/**
+ * Log level hierarchy
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+};
+/**
+ * ANSI colors (only used in appropriate environments)
+ */
+const COLORS = {
+    debug: '\x1b[36m', // Cyan
+    info: '\x1b[32m', // Green  
+    warn: '\x1b[33m', // Yellow
+    error: '\x1b[31m', // Red
+    reset: '\x1b[0m', // Reset
+    gray: '\x1b[90m', // Gray
+    bold: '\x1b[1m' // Bold
+};
+/**
+ * Platform-agnostic logger
+ */
+export class TrokkyLogger {
+    config;
+    context;
+    constructor(context, config = {}) {
+        this.context = context;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];
+    }
+    createLogEntry(level, message, data, error) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            context: this.context
+        };
+        if (data !== undefined) {
+            entry.data = data;
+        }
+        if (error) {
+            entry.error = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack
+            };
+        }
+        return entry;
+    }
+    formatHuman(entry) {
+        const parts = [];
+        // Timestamp
+        if (this.config.timestamp) {
+            const time = entry.timestamp.slice(11, 23); // HH:mm:ss.SSS
+            const timeStr = this.config.colors ? `${COLORS.gray}${time}${COLORS.reset}` : time;
+            parts.push(timeStr);
+        }
+        // Level with color
+        const levelUpper = entry.level.toUpperCase().padEnd(5);
+        const levelStr = this.config.colors
+            ? `${COLORS[entry.level]}${levelUpper}${COLORS.reset}`
+            : levelUpper;
+        parts.push(levelStr);
+        // Context
+        const contextParts = [entry.context.package];
+        if (entry.context.component)
+            contextParts.push(entry.context.component);
+        if (entry.context.operation)
+            contextParts.push(entry.context.operation);
+        const contextStr = this.config.colors
+            ? `${COLORS.gray}[${contextParts.join(':')}]${COLORS.reset}`
+            : `[${contextParts.join(':')}]`;
+        parts.push(contextStr);
+        // Message
+        parts.push(entry.message);
+        return parts.join(' ');
+    }
+    formatJson(entry) {
+        return JSON.stringify(entry);
+    }
+    output(entry) {
+        const formatted = this.config.format === 'json'
+            ? this.formatJson(entry)
+            : this.formatHuman(entry);
+        // Use appropriate console method
+        switch (entry.level) {
+            case 'debug':
+                console.debug(formatted);
+                break;
+            case 'info':
+                console.info(formatted);
+                break;
+            case 'warn':
+                console.warn(formatted);
+                break;
+            case 'error':
+                console.error(formatted);
+                if (entry.error?.stack && this.config.format === 'human') {
+                    console.error(entry.error.stack);
+                }
+                break;
+        }
+        // Output data separately in human format
+        if (entry.data && this.config.format === 'human') {
+            const dataStr = typeof entry.data === 'string'
+                ? entry.data
+                : JSON.stringify(entry.data, null, 2);
+            console.log(dataStr);
+        }
+    }
+    debug(message, data) {
+        if (this.shouldLog('debug')) {
+            this.output(this.createLogEntry('debug', message, data));
+        }
+    }
+    info(message, data) {
+        if (this.shouldLog('info')) {
+            this.output(this.createLogEntry('info', message, data));
+        }
+    }
+    warn(message, data) {
+        if (this.shouldLog('warn')) {
+            this.output(this.createLogEntry('warn', message, data));
+        }
+    }
+    error(message, error) {
+        if (this.shouldLog('error')) {
+            const actualError = error instanceof Error ? error : undefined;
+            const data = error instanceof Error ? undefined : error;
+            this.output(this.createLogEntry('error', message, data, actualError));
+        }
+    }
+    child(context) {
+        return new TrokkyLogger({ ...this.context, ...context }, this.config);
+    }
+    configure(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Global logger factory
+ */
+export class LoggerFactory {
+    static globalConfig = {};
+    static configure(config) {
+        LoggerFactory.globalConfig = { ...LoggerFactory.globalConfig, ...config };
+    }
+    static create(context) {
+        return new TrokkyLogger(context, LoggerFactory.globalConfig);
+    }
+    static setLevel(level) {
+        LoggerFactory.configure({ level });
+    }
+    static setFormat(format) {
+        LoggerFactory.configure({ format });
+    }
+    static disable() {
+        LoggerFactory.configure({ level: 'error' });
+    }
+}
+/**
+ * Convenience function to create package loggers
+ */
+export function createLogger(package_name, component) {
+    return LoggerFactory.create({ package: package_name, component });
+}
+/**
+ * Environment-specific configuration helpers
+ */
+export const LoggerPresets = {
+    development: { level: 'debug', format: 'human', colors: true },
+    production: { level: 'info', format: 'json', colors: false },
+    testing: { level: 'warn', format: 'human', colors: false },
+    edge: { level: 'info', format: 'json', colors: false }
+};
+//# sourceMappingURL=logger.js.map

package/dist/core/utils/logger.js.map

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

package/dist/core/utils/reference-expander.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Reference Expander Utility
+ * Expands reference fields in documents by fetching the referenced documents
+ */
+import type { ContentSchema } from '../types/index.js';
+/**
+ * Reference value structure
+ */
+export interface ReferenceValue {
+    _ref: string;
+    _type: string;
+    _cached?: Record<string, unknown>;
+}
+/**
+ * Options for reference expansion
+ */
+export interface ExpandOptions {
+    /** Fields to expand (dot notation supported for nested fields) */
+    fields: string[];
+    /** Maximum depth for nested expansions (default: 1) */
+    maxDepth?: number;
+    /** Current depth (internal use) */
+    currentDepth?: number;
+}
+/**
+ * Document fetcher function type
+ */
+export type DocumentFetcher = (collection: string, id: string) => Promise<Record<string, unknown> | null>;
+/**
+ * Schema getter function type
+ */
+export type SchemaGetter = (collection: string) => ContentSchema | null;
+/**
+ * Check if a value is a reference
+ */
+export declare function isReference(value: unknown): value is ReferenceValue;
+/**
+ * Find all reference fields in a schema
+ */
+export declare function findReferenceFields(schema: ContentSchema, prefix?: string): string[];
+/**
+ * Expand references in a single document
+ */
+export declare function expandDocumentReferences(document: Record<string, unknown>, options: ExpandOptions, fetchDocument: DocumentFetcher, getSchema?: SchemaGetter): Promise<Record<string, unknown>>;
+/**
+ * Expand references in multiple documents
+ */
+export declare function expandDocumentsReferences(documents: Record<string, unknown>[], options: ExpandOptions, fetchDocument: DocumentFetcher, getSchema?: SchemaGetter): Promise<Record<string, unknown>[]>;
+/**
+ * Parse expand parameter from query string
+ * Supports formats:
+ * - "field1,field2" - comma-separated field names
+ * - "field1,field2[]" - array fields with [] suffix
+ * - "*" - expand all reference fields (requires schema)
+ */
+export declare function parseExpandParam(expandParam: string | string[] | undefined, schema?: ContentSchema): string[];
+//# sourceMappingURL=reference-expander.d.ts.map

package/dist/core/utils/reference-expander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-expander.d.ts","sourceRoot":"","sources":["../../../src/core/utils/reference-expander.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;AAEzG;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAA;AAEvE;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CASnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,MAAW,GAClB,MAAM,EAAE,CA8BV;AAwCD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,eAAe,EAC9B,SAAS,CAAC,EAAE,YAAY,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwFlC;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACpC,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,eAAe,EAC9B,SAAS,CAAC,EAAE,YAAY,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAKpC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EAC1C,MAAM,CAAC,EAAE,aAAa,GACrB,MAAM,EAAE,CAgBV"}