@veloxts/cli 0.4.2 → 0.4.3

package/dist/seeding/errors.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Seeding Errors
+ *
+ * Structured error classes for the VeloxTS database seeding system.
+ */
+/**
+ * Error codes for seeding errors (for AI/tooling integration)
+ */
+export declare enum SeederErrorCode {
+    /** Seeder not found in registry */
+    SEEDER_NOT_FOUND = "E3001",
+    /** Circular dependency detected between seeders */
+    CIRCULAR_DEPENDENCY = "E3002",
+    /** Seeder execution failed */
+    EXECUTION_FAILED = "E3003",
+    /** Truncation failed */
+    TRUNCATION_FAILED = "E3004",
+    /** Invalid seeder configuration */
+    INVALID_CONFIG = "E3005",
+    /** Seeder dependency not found */
+    DEPENDENCY_NOT_FOUND = "E3006",
+    /** No seeders found in project */
+    NO_SEEDERS_FOUND = "E3007",
+    /** Database connection failed */
+    DATABASE_ERROR = "E3008",
+    /** Factory not found in registry */
+    FACTORY_NOT_FOUND = "E3010",
+    /** Factory state not found */
+    STATE_NOT_FOUND = "E3011",
+    /** Factory creation failed */
+    FACTORY_CREATE_FAILED = "E3012",
+    /** Invalid factory configuration */
+    INVALID_FACTORY = "E3013",
+    /** File system error during seeder loading */
+    FILESYSTEM_ERROR = "E3020",
+    /** Invalid seeder export */
+    INVALID_EXPORT = "E3021"
+}
+/**
+ * Structured error for seeding operations
+ */
+export declare class SeederError extends Error {
+    readonly code: SeederErrorCode;
+    readonly fix?: string | undefined;
+    constructor(code: SeederErrorCode, message: string, fix?: string | undefined);
+    /**
+     * Format error for display
+     */
+    format(): string;
+    /**
+     * Convert to JSON for --json output
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Structured error for factory operations
+ */
+export declare class FactoryError extends Error {
+    readonly code: SeederErrorCode;
+    readonly fix?: string | undefined;
+    constructor(code: SeederErrorCode, message: string, fix?: string | undefined);
+    /**
+     * Format error for display
+     */
+    format(): string;
+    /**
+     * Convert to JSON for --json output
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Create error for seeder not found
+ */
+export declare function seederNotFound(name: string): SeederError;
+/**
+ * Create error for circular dependency
+ */
+export declare function circularDependency(cycle: string[]): SeederError;
+/**
+ * Create error for seeder execution failure
+ */
+export declare function executionFailed(name: string, cause: Error): SeederError;
+/**
+ * Create error for truncation failure
+ */
+export declare function truncationFailed(name: string, cause: Error): SeederError;
+/**
+ * Create error for dependency not found
+ */
+export declare function dependencyNotFound(seederName: string, dependencyName: string): SeederError;
+/**
+ * Create error for no seeders found
+ */
+export declare function noSeedersFound(path: string): SeederError;
+/**
+ * Create error for database connection issue
+ */
+export declare function seederDatabaseError(operation: string, cause: Error): SeederError;
+/**
+ * Create error for factory not found
+ */
+export declare function factoryNotFound(name: string): FactoryError;
+/**
+ * Create error for state not found
+ */
+export declare function stateNotFound(factoryName: string, stateName: string, available: string[]): FactoryError;
+/**
+ * Create error for factory creation failure
+ */
+export declare function factoryCreateFailed(modelName: string, cause: Error): FactoryError;
+/**
+ * Create error for invalid seeder export
+ */
+export declare function invalidExport(filePath: string, reason: string): SeederError;
+/**
+ * Create error for filesystem issue
+ */
+export declare function filesystemError(operation: string, path: string, cause: Error): SeederError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/seeding/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/seeding/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,oBAAY,eAAe;IACzB,mCAAmC;IACnC,gBAAgB,UAAU;IAE1B,mDAAmD;IACnD,mBAAmB,UAAU;IAE7B,8BAA8B;IAC9B,gBAAgB,UAAU;IAE1B,wBAAwB;IACxB,iBAAiB,UAAU;IAE3B,mCAAmC;IACnC,cAAc,UAAU;IAExB,kCAAkC;IAClC,oBAAoB,UAAU;IAE9B,kCAAkC;IAClC,gBAAgB,UAAU;IAE1B,iCAAiC;IACjC,cAAc,UAAU;IAExB,oCAAoC;IACpC,iBAAiB,UAAU;IAE3B,8BAA8B;IAC9B,eAAe,UAAU;IAEzB,8BAA8B;IAC9B,qBAAqB,UAAU;IAE/B,oCAAoC;IACpC,eAAe,UAAU;IAEzB,8CAA8C;IAC9C,gBAAgB,UAAU;IAE1B,4BAA4B;IAC5B,cAAc,UAAU;CACzB;AAMD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,eAAe;aAErB,GAAG,CAAC,EAAE,MAAM;gBAFZ,IAAI,EAAE,eAAe,EACrC,OAAO,EAAE,MAAM,EACC,GAAG,CAAC,EAAE,MAAM,YAAA;IAM9B;;OAEG;IACH,MAAM,IAAI,MAAM;IAQhB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAMD;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAEnB,IAAI,EAAE,eAAe;aAErB,GAAG,CAAC,EAAE,MAAM;gBAFZ,IAAI,EAAE,eAAe,EACrC,OAAO,EAAE,MAAM,EACC,GAAG,CAAC,EAAE,MAAM,YAAA;IAM9B;;OAEG;IACH,MAAM,IAAI,MAAM;IAQhB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,CAM/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAMvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAMxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,WAAW,CAM1F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAMhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,GAClB,YAAY,CAOd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,CAMjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAM3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAM1F"}

package/dist/seeding/errors.js

@@ -0,0 +1,191 @@
+/**
+ * Seeding Errors
+ *
+ * Structured error classes for the VeloxTS database seeding system.
+ */
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * Error codes for seeding errors (for AI/tooling integration)
+ */
+export var SeederErrorCode;
+(function (SeederErrorCode) {
+    /** Seeder not found in registry */
+    SeederErrorCode["SEEDER_NOT_FOUND"] = "E3001";
+    /** Circular dependency detected between seeders */
+    SeederErrorCode["CIRCULAR_DEPENDENCY"] = "E3002";
+    /** Seeder execution failed */
+    SeederErrorCode["EXECUTION_FAILED"] = "E3003";
+    /** Truncation failed */
+    SeederErrorCode["TRUNCATION_FAILED"] = "E3004";
+    /** Invalid seeder configuration */
+    SeederErrorCode["INVALID_CONFIG"] = "E3005";
+    /** Seeder dependency not found */
+    SeederErrorCode["DEPENDENCY_NOT_FOUND"] = "E3006";
+    /** No seeders found in project */
+    SeederErrorCode["NO_SEEDERS_FOUND"] = "E3007";
+    /** Database connection failed */
+    SeederErrorCode["DATABASE_ERROR"] = "E3008";
+    /** Factory not found in registry */
+    SeederErrorCode["FACTORY_NOT_FOUND"] = "E3010";
+    /** Factory state not found */
+    SeederErrorCode["STATE_NOT_FOUND"] = "E3011";
+    /** Factory creation failed */
+    SeederErrorCode["FACTORY_CREATE_FAILED"] = "E3012";
+    /** Invalid factory configuration */
+    SeederErrorCode["INVALID_FACTORY"] = "E3013";
+    /** File system error during seeder loading */
+    SeederErrorCode["FILESYSTEM_ERROR"] = "E3020";
+    /** Invalid seeder export */
+    SeederErrorCode["INVALID_EXPORT"] = "E3021";
+})(SeederErrorCode || (SeederErrorCode = {}));
+// ============================================================================
+// Seeder Error
+// ============================================================================
+/**
+ * Structured error for seeding operations
+ */
+export class SeederError extends Error {
+    code;
+    fix;
+    constructor(code, message, fix) {
+        super(message);
+        this.code = code;
+        this.fix = fix;
+        this.name = 'SeederError';
+    }
+    /**
+     * Format error for display
+     */
+    format() {
+        let output = `SeederError[${this.code}]: ${this.message}`;
+        if (this.fix) {
+            output += `\n\n  Fix: ${this.fix}`;
+        }
+        return output;
+    }
+    /**
+     * Convert to JSON for --json output
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            fix: this.fix,
+        };
+    }
+}
+// ============================================================================
+// Factory Error
+// ============================================================================
+/**
+ * Structured error for factory operations
+ */
+export class FactoryError extends Error {
+    code;
+    fix;
+    constructor(code, message, fix) {
+        super(message);
+        this.code = code;
+        this.fix = fix;
+        this.name = 'FactoryError';
+    }
+    /**
+     * Format error for display
+     */
+    format() {
+        let output = `FactoryError[${this.code}]: ${this.message}`;
+        if (this.fix) {
+            output += `\n\n  Fix: ${this.fix}`;
+        }
+        return output;
+    }
+    /**
+     * Convert to JSON for --json output
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            fix: this.fix,
+        };
+    }
+}
+// ============================================================================
+// Error Factory Functions
+// ============================================================================
+/**
+ * Create error for seeder not found
+ */
+export function seederNotFound(name) {
+    return new SeederError(SeederErrorCode.SEEDER_NOT_FOUND, `Seeder '${name}' not found.`, `Check that the seeder exists in src/database/seeders/ and is properly exported.`);
+}
+/**
+ * Create error for circular dependency
+ */
+export function circularDependency(cycle) {
+    return new SeederError(SeederErrorCode.CIRCULAR_DEPENDENCY, `Circular dependency detected: ${cycle.join(' -> ')}`, `Review seeder dependencies and remove the circular reference.`);
+}
+/**
+ * Create error for seeder execution failure
+ */
+export function executionFailed(name, cause) {
+    return new SeederError(SeederErrorCode.EXECUTION_FAILED, `Seeder '${name}' failed: ${cause.message}`, `Check the seeder implementation and database state.`);
+}
+/**
+ * Create error for truncation failure
+ */
+export function truncationFailed(name, cause) {
+    return new SeederError(SeederErrorCode.TRUNCATION_FAILED, `Truncation failed for seeder '${name}': ${cause.message}`, `Check for foreign key constraints that may prevent truncation.`);
+}
+/**
+ * Create error for dependency not found
+ */
+export function dependencyNotFound(seederName, dependencyName) {
+    return new SeederError(SeederErrorCode.DEPENDENCY_NOT_FOUND, `Seeder '${seederName}' depends on '${dependencyName}' which was not found.`, `Ensure '${dependencyName}' exists in src/database/seeders/ and is registered.`);
+}
+/**
+ * Create error for no seeders found
+ */
+export function noSeedersFound(path) {
+    return new SeederError(SeederErrorCode.NO_SEEDERS_FOUND, `No seeders found in ${path}`, `Create a seeder with: velox generate seeder <name>`);
+}
+/**
+ * Create error for database connection issue
+ */
+export function seederDatabaseError(operation, cause) {
+    return new SeederError(SeederErrorCode.DATABASE_ERROR, `Database error during ${operation}: ${cause.message}`, `Check your database connection and ensure it's running.`);
+}
+/**
+ * Create error for factory not found
+ */
+export function factoryNotFound(name) {
+    return new FactoryError(SeederErrorCode.FACTORY_NOT_FOUND, `Factory '${name}' not found in registry.`, `Ensure the factory is properly instantiated before use.`);
+}
+/**
+ * Create error for state not found
+ */
+export function stateNotFound(factoryName, stateName, available) {
+    const availableStr = available.length > 0 ? available.join(', ') : 'none';
+    return new FactoryError(SeederErrorCode.STATE_NOT_FOUND, `State '${stateName}' not found on factory '${factoryName}'.`, `Available states: ${availableStr}. Register states using registerState().`);
+}
+/**
+ * Create error for factory creation failure
+ */
+export function factoryCreateFailed(modelName, cause) {
+    return new FactoryError(SeederErrorCode.FACTORY_CREATE_FAILED, `Failed to create '${modelName}': ${cause.message}`, `Check the factory definition and ensure all required fields are provided.`);
+}
+/**
+ * Create error for invalid seeder export
+ */
+export function invalidExport(filePath, reason) {
+    return new SeederError(SeederErrorCode.INVALID_EXPORT, `Invalid seeder export in '${filePath}': ${reason}`, `Ensure the file exports a valid Seeder object with 'name' and 'run' properties.`);
+}
+/**
+ * Create error for filesystem issue
+ */
+export function filesystemError(operation, path, cause) {
+    return new SeederError(SeederErrorCode.FILESYSTEM_ERROR, `Filesystem error during ${operation} at '${path}': ${cause.message}`, `Check file permissions and path validity.`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/seeding/errors.js.map

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

package/dist/seeding/factory.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Factory System
+ *
+ * Base factory class and registry for generating fake data.
+ */
+import type { Factory, FactoryRegistry, PrismaClientLike, StateModifier } from './types.js';
+/**
+ * Abstract base class for model factories.
+ *
+ * Provides a fluent API for creating model instances with fake data
+ * and named state variations.
+ *
+ * @template TInput - The input type for creating records
+ * @template TOutput - The output type returned from database (defaults to TInput)
+ *
+ * @example
+ * ```typescript
+ * import { BaseFactory } from '@veloxts/cli';
+ * import { faker } from '@faker-js/faker';
+ *
+ * interface UserInput {
+ *   email: string;
+ *   name: string;
+ *   role: 'admin' | 'user';
+ * }
+ *
+ * export class UserFactory extends BaseFactory<UserInput> {
+ *   modelName = 'user';
+ *
+ *   definition(): UserInput {
+ *     return {
+ *       email: faker.internet.email(),
+ *       name: faker.person.fullName(),
+ *       role: 'user',
+ *     };
+ *   }
+ *
+ *   admin(): this {
+ *     return this.state('admin');
+ *   }
+ *
+ *   constructor(prisma: PrismaClientLike) {
+ *     super(prisma);
+ *     this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseFactory<TInput extends Record<string, unknown>, TOutput = TInput> implements Factory<TInput, TOutput> {
+    /** Map of registered state modifiers */
+    protected states: Map<string, StateModifier<TInput>>;
+    /** Currently active state names */
+    protected activeStates: string[];
+    /** Prisma client for database operations */
+    protected readonly prisma: PrismaClientLike;
+    /**
+     * Model name for Prisma operations (e.g., 'user', 'post').
+     * Must match the lowercase model name in your Prisma schema.
+     */
+    abstract readonly modelName: string;
+    /**
+     * Define default attributes for new instances.
+     * Override this method to provide fake data generation.
+     */
+    abstract definition(): TInput;
+    constructor(prisma: PrismaClientLike);
+    /**
+     * Register a named state modifier.
+     *
+     * @param name - State name (e.g., 'admin', 'verified')
+     * @param modifier - Function that modifies attributes
+     * @returns this for chaining during construction
+     *
+     * @example
+     * ```typescript
+     * constructor(prisma: PrismaClientLike) {
+     *   super(prisma);
+     *   this.registerState('admin', (attrs) => ({ ...attrs, role: 'admin' }));
+     *   this.registerState('unverified', (attrs) => ({ ...attrs, emailVerified: null }));
+     * }
+     * ```
+     */
+    protected registerState(name: string, modifier: StateModifier<TInput>): this;
+    /**
+     * Apply a named state modifier.
+     * Returns a new factory instance with the state applied.
+     *
+     * @param name - State name to apply
+     * @returns New factory instance with state active (preserves subclass type)
+     *
+     * @example
+     * ```typescript
+     * // Create an admin user
+     * await factory.get(UserFactory).state('admin').create();
+     *
+     * // Chain multiple states
+     * await factory.get(UserFactory).state('admin').state('verified').create();
+     *
+     * // Subclass methods preserved after state()
+     * const factory = new UserFactory(prisma);
+     * await factory.state('verified').admin().create(); // admin() still accessible
+     * ```
+     */
+    state(name: string): this;
+    /**
+     * Get list of available state names.
+     */
+    getAvailableStates(): ReadonlyArray<string>;
+    /**
+     * Make a single instance without persisting to database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Generated attributes
+     */
+    make(overrides?: Partial<TInput>): TInput;
+    /**
+     * Make multiple instances without persisting to database.
+     *
+     * @param count - Number of instances to make
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of generated attributes
+     */
+    makeMany(count: number, overrides?: Partial<TInput>): TInput[];
+    /**
+     * Create a single instance in the database.
+     *
+     * @param overrides - Attributes to override defaults
+     * @returns Created database record
+     */
+    create(overrides?: Partial<TInput>): Promise<TOutput>;
+    /**
+     * Create multiple instances in the database.
+     *
+     * @param count - Number of instances to create
+     * @param overrides - Attributes to override defaults for all instances
+     * @returns Array of created database records
+     */
+    createMany(count: number, overrides?: Partial<TInput>): Promise<TOutput[]>;
+    /**
+     * Build attributes by applying definition, states, and overrides.
+     */
+    private buildAttributes;
+}
+/**
+ * Create a factory registry for managing factory instances.
+ *
+ * The registry caches factory instances and provides type-safe access.
+ *
+ * @param prisma - Prisma client to inject into factories
+ * @returns Factory registry instance
+ *
+ * @example
+ * ```typescript
+ * const registry = createFactoryRegistry(prisma);
+ *
+ * // Get or create factory instance
+ * const userFactory = registry.get(UserFactory);
+ * await userFactory.create();
+ * ```
+ */
+export declare function createFactoryRegistry(prisma: PrismaClientLike): FactoryRegistry;
+//# sourceMappingURL=factory.d.ts.map

package/dist/seeding/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/seeding/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,OAAO,EAEP,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AA2BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,8BAAsB,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CACxF,YAAW,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAa;IAEjE,mCAAmC;IACnC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,CAAM;IAEtC,4CAA4C;IAC5C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,UAAU,IAAI,MAAM;gBAEjB,MAAM,EAAE,gBAAgB;IAQpC;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAK5E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAazB;;OAEG;IACH,kBAAkB,IAAI,aAAa,CAAC,MAAM,CAAC;IAQ3C;;;;;OAKG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAIzC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAQ9D;;;;;OAKG;IACG,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB3D;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiBhF;;OAEG;IACH,OAAO,CAAC,eAAe;CAmBxB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAyB/E"}