@monque/tsed 0.1.0

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config/types.ts","../src/config/config.ts","../src/constants/constants.ts","../src/constants/types.ts","../src/decorators/types.ts","../src/decorators/cron.ts","../src/decorators/worker.ts","../src/decorators/worker-controller.ts","../src/services/monque-service.ts","../src/monque-module.ts","../src/utils/build-job-name.ts","../src/utils/collect-worker-metadata.ts","../src/utils/get-worker-token.ts","../src/utils/resolve-database.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,582 @@
+import { Configuration, InjectorService, LOGGER, OnDestroy, OnInit, TokenProvider } from "@tsed/di";
+import { BulkOperationResult, CursorOptions, CursorPage, EnqueueOptions, GetJobsFilter, JobSelector, Monque, MonqueOptions, PersistedJob, QueueStats, ScheduleOptions, WorkerOptions } from "@monque/core";
+import { Db, ObjectId } from "mongodb";
+
+//#region src/config/types.d.ts
+/**
+ * Configuration options for @monque/tsed.
+ *
+ * Extends MonqueOptions with Ts.ED-specific settings for database resolution
+ * and module behavior.
+ *
+ * @example
+ * ```typescript
+ * @Configuration({
+ *   monque: {
+ *     db: mongoClient.db("myapp"),
+ *     collectionName: "jobs",
+ *     defaultConcurrency: 5
+ *   }
+ * })
+ * export class Server {}
+ * ```
+ */
+interface MonqueTsedConfig extends Omit<MonqueOptions, 'db'> {
+  /**
+   * Enable or disable the Monque module.
+   *
+   * When disabled:
+   * - Workers are not registered
+   * - Lifecycle hooks are no-ops
+   * - MonqueService throws on access
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Direct MongoDB database instance.
+   *
+   * Use when you have a pre-connected Db object available synchronously.
+   *
+   * @example
+   * ```typescript
+   * @Configuration({
+   *   monque: {
+   *     db: mongoClient.db("myapp"),
+   *     collectionName: "jobs"
+   *   }
+   * })
+   * ```
+   */
+  db?: Db;
+  /**
+   * Factory function to create the database connection.
+   *
+   * Called once during module initialization. Supports async factories
+   * for connection pooling or lazy initialization.
+   *
+   * @example
+   * ```typescript
+   * @Configuration({
+   *   monque: {
+   *     dbFactory: async () => {
+   *       const client = await MongoClient.connect(process.env.MONGO_URI!);
+   *       return client.db("myapp");
+   *     }
+   *   }
+   * })
+   * ```
+   */
+  dbFactory?: () => Promise<Db> | Db;
+  /**
+   * DI token to inject the Db instance from the container.
+   *
+   * Use when your application already has a MongoDB provider registered
+   * in the DI container.
+   *
+   * Can also be used to inject a MongooseService or Connection.
+   *
+   * @example
+   * ```typescript
+   * // First, register a MongoDB provider
+   * registerProvider({
+   *   provide: "MONGODB_DATABASE",
+   *   useFactory: async () => {
+   *     const client = await MongoClient.connect(uri);
+   *     return client.db("myapp");
+   *   }
+   * });
+   *
+   * // Then reference it in config
+   * @Configuration({
+   *   monque: {
+   *     dbToken: "MONGODB_DATABASE"
+   *   }
+   * })
+   * ```
+   */
+  dbToken?: TokenProvider<Db> | string;
+  /**
+   * Connection ID of the Mongoose connection to use.
+   *
+   * Requires the use of `dbToken` pointing to `MongooseService`.
+   *
+   * @default "default"
+   */
+  mongooseConnectionId?: string;
+}
+//#endregion
+//#region src/config/config.d.ts
+/**
+ * Augment TsED's Configuration interface to include monque settings.
+ *
+ * This allows type-safe configuration via @Configuration decorator.
+ */
+declare global {
+  namespace TsED {
+    interface Configuration {
+      /**
+       * Monque job queue configuration.
+       */
+      monque?: MonqueTsedConfig;
+    }
+  }
+}
+/**
+ * Validate that exactly one database resolution strategy is provided.
+ *
+ * @param config - The configuration to validate.
+ * @throws Error if zero or multiple strategies are provided.
+ *
+ * @example
+ * ```typescript
+ * validateDatabaseConfig({ db: mongoDb }); // OK
+ * validateDatabaseConfig({}); // throws
+ * validateDatabaseConfig({ db: mongoDb, dbFactory: fn }); // throws
+ * ```
+ */
+declare function validateDatabaseConfig(config: MonqueTsedConfig): void;
+//#endregion
+//#region src/constants/constants.d.ts
+/**
+ * Symbol used to store decorator metadata on class constructors.
+ *
+ * Used by @WorkerController, @Worker, and @Cron decorators to attach
+ * metadata that is later collected by MonqueModule during initialization.
+ *
+ * @example
+ * ```typescript
+ * Store.from(Class).set(MONQUE, metadata);
+ * ```
+ */
+declare const MONQUE: unique symbol;
+//#endregion
+//#region src/constants/types.d.ts
+/**
+ * Provider type constants for DI scanning.
+ *
+ * These constants are used to categorize providers registered with Ts.ED's
+ * dependency injection container, enabling MonqueModule to discover and
+ * register workers automatically.
+ *
+ * Note: Using string constants with `as const` instead of enums per
+ * Constitution guidelines.
+ */
+declare const ProviderTypes: {
+  /** Provider type for @WorkerController decorated classes */readonly WORKER_CONTROLLER: "monque:worker-controller"; /** Provider type for cron job handlers */
+  readonly CRON: "monque:cron";
+};
+/**
+ * Union type of all provider type values.
+ */
+type ProviderType = (typeof ProviderTypes)[keyof typeof ProviderTypes];
+//#endregion
+//#region src/decorators/types.d.ts
+/**
+ * Options for the @Worker method decorator.
+ *
+ * Maps to @monque/core WorkerOptions. All standard Monque worker options
+ * are exposed here for decorator-based configuration.
+ */
+interface WorkerDecoratorOptions extends WorkerOptions {}
+/**
+ * Metadata for a single @Worker decorated method.
+ *
+ * Stored in the WorkerStore and used by MonqueModule to register workers.
+ */
+interface WorkerMetadata {
+  /**
+   * Job name (without namespace prefix).
+   * Combined with controller namespace to form full job name.
+   */
+  name: string;
+  /**
+   * Method name on the controller class.
+   */
+  method: string;
+  /**
+   * Worker options forwarded to Monque.register().
+   */
+  opts: WorkerDecoratorOptions;
+}
+/**
+ * Options for the @Cron method decorator.
+ *
+ * Maps to @monque/core ScheduleOptions with additional metadata overrides.
+ */
+interface CronDecoratorOptions extends ScheduleOptions {
+  /**
+   * Override job name (defaults to method name).
+   */
+  name?: string;
+}
+/**
+ * Metadata for a single @Cron decorated method.
+ *
+ * Stored in the WorkerStore and used by MonqueModule to schedule cron jobs.
+ */
+interface CronMetadata {
+  /**
+   * Cron expression (5-field standard or predefined like @daily).
+   */
+  pattern: string;
+  /**
+   * Job name (defaults to method name if not specified in options).
+   */
+  name: string;
+  /**
+   * Method name on the controller class.
+   */
+  method: string;
+  /**
+   * Schedule options forwarded to Monque.schedule().
+   */
+  opts: CronDecoratorOptions;
+}
+/**
+ * Complete metadata structure stored on @WorkerController classes.
+ *
+ * Accessed via `Store.from(Class).get(MONQUE)`.
+ *
+ * @example
+ * ```typescript
+ * const store = Store.from(EmailWorkers).get<WorkerStore>(MONQUE);
+ * console.log(store.namespace); // "email"
+ * console.log(store.workers); // [{ name: "send", method: "sendEmail", opts: {} }]
+ * ```
+ */
+interface WorkerStore {
+  /**
+   * Type identifier for the store.
+   * Always "controller" for WorkerController.
+   */
+  type: 'controller';
+  /**
+   * Optional namespace prefix for all jobs in this controller.
+   * When set, job names become "{namespace}.{name}".
+   */
+  namespace?: string;
+  /**
+   * Worker method registrations from @Worker decorators.
+   */
+  workers: WorkerMetadata[];
+  /**
+   * Cron job registrations from @Cron decorators.
+   */
+  cronJobs: CronMetadata[];
+}
+//#endregion
+//#region src/decorators/cron.d.ts
+/**
+ * Method decorator that registers a method as a scheduled cron job.
+ *
+ * @param pattern - Cron expression (e.g., "* * * * *", "@daily")
+ * @param options - Optional cron configuration (name, timezone, etc.)
+ *
+ * @example
+ * ```typescript
+ * @WorkerController()
+ * class ReportWorkers {
+ *   @Cron("@daily", { timezone: "UTC" })
+ *   async generateDailyReport() {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+declare function Cron(pattern: string, options?: CronDecoratorOptions): MethodDecorator;
+//#endregion
+//#region src/decorators/worker.d.ts
+/**
+ * Method decorator that registers a method as a job handler.
+ *
+ * @param name - The job name (will be prefixed with controller namespace if present)
+ * @param options - Optional worker configuration (concurrency, replace, etc.)
+ */
+declare function Worker(name: string, options?: WorkerDecoratorOptions): MethodDecorator;
+//#endregion
+//#region src/decorators/worker-controller.d.ts
+/**
+ * Class decorator that registers a class as a worker controller.
+ *
+ * @param namespace - Optional namespace prefix for job names
+ */
+declare function WorkerController(namespace?: string): ClassDecorator;
+//#endregion
+//#region src/services/monque-service.d.ts
+/**
+ * Injectable service that wraps the Monque instance.
+ *
+ * Exposes the full Monque public API through dependency injection.
+ */
+declare class MonqueService {
+  /**
+   * Internal Monque instance (set by MonqueModule)
+   * @internal
+   */
+  private _monque;
+  /**
+   * Set the internal Monque instance.
+   * Called by MonqueModule during initialization.
+   * @internal
+   */
+  _setMonque(monque: Monque): void;
+  /**
+   * Access the underlying Monque instance.
+   * @throws Error if MonqueModule is not initialized
+   */
+  get monque(): Monque;
+  /**
+   * Enqueue a job for processing.
+   *
+   * @param name - Job type identifier (use full namespaced name, e.g., "email.send")
+   * @param data - Job payload
+   * @param options - Scheduling and deduplication options
+   * @returns The created or existing job document
+   */
+  enqueue<T>(name: string, data: T, options?: EnqueueOptions): Promise<PersistedJob<T>>;
+  /**
+   * Enqueue a job for immediate processing.
+   *
+   * @param name - Job type identifier
+   * @param data - Job payload
+   * @returns The created job document
+   */
+  now<T>(name: string, data: T): Promise<PersistedJob<T>>;
+  /**
+   * Schedule a recurring job with a cron expression.
+   *
+   * @param cron - Cron expression (5-field standard or predefined like @daily)
+   * @param name - Job type identifier
+   * @param data - Job payload
+   * @param options - Scheduling options
+   * @returns The created job document
+   */
+  schedule<T>(cron: string, name: string, data: T, options?: ScheduleOptions): Promise<PersistedJob<T>>;
+  /**
+   * Cancel a pending or scheduled job.
+   *
+   * @param jobId - The ID of the job to cancel
+   * @returns The cancelled job, or null if not found
+   */
+  cancelJob(jobId: string): Promise<PersistedJob<unknown> | null>;
+  /**
+   * Retry a failed or cancelled job.
+   *
+   * @param jobId - The ID of the job to retry
+   * @returns The updated job, or null if not found
+   */
+  retryJob(jobId: string): Promise<PersistedJob<unknown> | null>;
+  /**
+   * Reschedule a pending job to run at a different time.
+   *
+   * @param jobId - The ID of the job to reschedule
+   * @param runAt - The new Date when the job should run
+   * @returns The updated job, or null if not found
+   */
+  rescheduleJob(jobId: string, runAt: Date): Promise<PersistedJob<unknown> | null>;
+  /**
+   * Permanently delete a job.
+   *
+   * @param jobId - The ID of the job to delete
+   * @returns true if deleted, false if job not found
+   */
+  deleteJob(jobId: string): Promise<boolean>;
+  /**
+   * Cancel multiple jobs matching the given filter.
+   *
+   * @param filter - Selector for which jobs to cancel
+   * @returns Result with count of cancelled jobs
+   */
+  cancelJobs(filter: JobSelector): Promise<BulkOperationResult>;
+  /**
+   * Retry multiple jobs matching the given filter.
+   *
+   * @param filter - Selector for which jobs to retry
+   * @returns Result with count of retried jobs
+   */
+  retryJobs(filter: JobSelector): Promise<BulkOperationResult>;
+  /**
+   * Delete multiple jobs matching the given filter.
+   *
+   * @param filter - Selector for which jobs to delete
+   * @returns Result with count of deleted jobs
+   */
+  deleteJobs(filter: JobSelector): Promise<BulkOperationResult>;
+  /**
+   * Get a job by its ID.
+   *
+   * @param jobId - The job's ObjectId (as string or ObjectId)
+   * @returns The job document, or null if not found
+   * @throws MonqueError if jobId is an invalid hex string
+   */
+  getJob<T>(jobId: string | ObjectId): Promise<PersistedJob<T> | null>;
+  /**
+   * Query jobs from the queue with optional filters.
+   *
+   * @param filter - Optional filter criteria (name, status, limit, skip)
+   * @returns Array of matching jobs
+   */
+  getJobs<T>(filter?: GetJobsFilter): Promise<PersistedJob<T>[]>;
+  /**
+   * Get a paginated list of jobs using opaque cursors.
+   *
+   * @param options - Pagination options (cursor, limit, direction, filter)
+   * @returns Page of jobs with next/prev cursors
+   */
+  getJobsWithCursor<T>(options?: CursorOptions): Promise<CursorPage<T>>;
+  /**
+   * Get aggregate statistics for the job queue.
+   *
+   * @param filter - Optional filter to scope statistics by job name
+   * @returns Queue statistics
+   */
+  getQueueStats(filter?: Pick<JobSelector, 'name'>): Promise<QueueStats>;
+  /**
+   * Check if the scheduler is healthy and running.
+   *
+   * @returns true if running and connected
+   */
+  isHealthy(): boolean;
+}
+//#endregion
+//#region src/monque-module.d.ts
+declare class MonqueModule implements OnInit, OnDestroy {
+  protected injector: InjectorService;
+  protected monqueService: MonqueService;
+  protected logger: LOGGER;
+  protected monqueConfig: MonqueTsedConfig;
+  protected monque: Monque | null;
+  constructor(injector: InjectorService, monqueService: MonqueService, logger: LOGGER, configuration: Configuration);
+  $onInit(): Promise<void>;
+  $onDestroy(): Promise<void>;
+  /**
+   * Discover and register all workers from @WorkerController providers
+   */
+  protected registerWorkers(): Promise<void>;
+}
+//#endregion
+//#region src/utils/build-job-name.d.ts
+/**
+ * Build the full job name by combining namespace and name.
+ *
+ * @param namespace - Optional namespace from @WorkerController
+ * @param name - Job name from @Worker or @Cron
+ * @returns Full job name (e.g., "email.send" or just "send")
+ *
+ * @example
+ * ```typescript
+ * buildJobName("email", "send"); // "email.send"
+ * buildJobName(undefined, "send"); // "send"
+ * buildJobName("", "send"); // "send"
+ * ```
+ */
+declare function buildJobName(namespace: string | undefined, name: string): string;
+//#endregion
+//#region src/utils/collect-worker-metadata.d.ts
+/**
+ * Collected worker registration info ready for Monque.register()
+ */
+interface CollectedWorkerMetadata {
+  /**
+   * Full job name (with namespace prefix if applicable)
+   */
+  fullName: string;
+  /**
+   * Method name on the controller class
+   */
+  method: string;
+  /**
+   * Worker options to pass to Monque.register()
+   */
+  opts: WorkerDecoratorOptions | CronDecoratorOptions;
+  /**
+   * Whether this is a cron job
+   */
+  isCron: boolean;
+  /**
+   * Cron pattern (only for cron jobs)
+   */
+  cronPattern?: string;
+}
+/**
+ * Collect all worker metadata from a class.
+ *
+ * @param target - The class constructor (decorated with @WorkerController)
+ * @returns Array of collected worker metadata ready for registration
+ *
+ * @example
+ * ```typescript
+ * const metadata = collectWorkerMetadata(EmailWorkers);
+ * // Returns:
+ * // [
+ * //   { fullName: "email.send", method: "sendEmail", opts: {}, isCron: false },
+ * //   { fullName: "email.daily-digest", method: "sendDailyDigest", opts: {}, isCron: true, cronPattern: "0 9 * * *" }
+ * // ]
+ * ```
+ */
+declare function collectWorkerMetadata(target: new (...args: unknown[]) => unknown): CollectedWorkerMetadata[];
+//#endregion
+//#region src/utils/get-worker-token.d.ts
+/**
+ * Generate a unique token for a worker controller.
+ *
+ * Used internally by Ts.ED DI to identify worker controller providers.
+ * The token is based on the class name for debugging purposes.
+ *
+ * @param target - The class constructor
+ * @returns A Symbol token unique to this worker controller
+ *
+ * @example
+ * ```typescript
+ * @WorkerController("email")
+ * class EmailWorkers {}
+ *
+ * const token = getWorkerToken(EmailWorkers);
+ * // Symbol("monque:worker:EmailWorkers")
+ * ```
+ */
+declare function getWorkerToken(target: new (...args: unknown[]) => unknown): symbol;
+//#endregion
+//#region src/utils/resolve-database.d.ts
+/**
+ * Type for the injector function used to resolve DI tokens.
+ */
+type InjectorFn = <T>(token: TokenProvider<T>) => T | undefined;
+/**
+ * Resolve the MongoDB database instance from the configuration.
+ *
+ * Supports three resolution strategies:
+ * 1. **Direct `db`**: Returns the provided Db instance directly
+ * 2. **Factory `dbFactory`**: Calls the factory function (supports async)
+ * 3. **DI Token `dbToken`**: Resolves the Db from the DI container
+ *
+ * @param config - The Monque configuration containing database settings
+ * @param injectorFn - Optional function to resolve DI tokens (required for dbToken strategy)
+ * @returns The resolved MongoDB Db instance
+ * @throws Error if no database strategy is provided or if DI resolution fails
+ *
+ * @example
+ * ```typescript
+ * // Direct Db instance
+ * const db = await resolveDatabase({ db: mongoDb });
+ *
+ * // Factory function
+ * const db = await resolveDatabase({
+ *   dbFactory: async () => {
+ *     const client = await MongoClient.connect(uri);
+ *     return client.db("myapp");
+ *   }
+ * });
+ *
+ * // DI token
+ * const db = await resolveDatabase(
+ *   { dbToken: "MONGODB_DATABASE" },
+ *   (token) => injector.get(token)
+ * );
+ * ```
+ */
+declare function resolveDatabase(config: MonqueTsedConfig, injectorFn?: InjectorFn): Promise<Db>;
+//#endregion
+export { type CollectedWorkerMetadata, Cron, type CronDecoratorOptions, type CronMetadata, type InjectorFn, MONQUE, MonqueModule, MonqueService, type MonqueTsedConfig, type ProviderType, ProviderTypes, Worker, WorkerController, type WorkerDecoratorOptions, type WorkerMetadata, type WorkerStore, buildJobName, collectWorkerMetadata, getWorkerToken, resolveDatabase, validateDatabaseConfig };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/config/types.ts","../src/config/config.ts","../src/constants/constants.ts","../src/constants/types.ts","../src/decorators/types.ts","../src/decorators/cron.ts","../src/decorators/worker.ts","../src/decorators/worker-controller.ts","../src/services/monque-service.ts","../src/monque-module.ts","../src/utils/build-job-name.ts","../src/utils/collect-worker-metadata.ts","../src/utils/get-worker-token.ts","../src/utils/resolve-database.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;UA0BiB,gBAAA,SAAyB,IAAA,CAAK,aAAA;EAgDpB;;;;;;;;;;EArC1B,OAAA;EC/BkD;;;;;;;;;;;;AAuCnD;;;EDSC,EAAA,GAAK,EAAA;ECTyD;;;;AClC/D;;;;;;;;ACDA;;;;;AAUA;EHsDC,SAAA,SAAkB,OAAA,CAAQ,EAAA,IAAM,EAAA;;;;;;;AI1DjC;;;;;AAWA;;;;;;;;;;AA2BA;;;;;AAgBA;EJiCC,OAAA,GAAU,aAAA,CAAc,EAAA;;;;;;;;EASxB,oBAAA;AAAA;;;;;;;;QC/FO,MAAA;EAAA,UACG,IAAA;IAAA,UACC,aAAA;MDoFD;;;MChFR,MAAA,GAAS,gBAAA;IAAA;EAAA;AAAA;;;;;;;;;;;;;;iBAsBI,sBAAA,CAAuB,MAAA,EAAQ,gBAAA;;;;;;;;ADnB/C;;;;;;cEfa,MAAA;;;;;;;;AFeb;;;;;cGhBa,aAAA;EHgEM,qEG3DT,iBAAA,8BHwFe;EAAA,SGxFf,IAAA;AAAA;;;;KAKE,YAAA,WAAuB,aAAA,eAA4B,aAAA;;;;AHM/D;;;;;UIViB,sBAAA,SAA+B,aAAA;;;;;;UAW/B,cAAA;EJDyB;;;;EIMzC,IAAA;EJ0CA;;;EIrCA,MAAA;EJkEA;;;EI7DA,IAAA,EAAM,sBAAA;AAAA;;;;;AHpC4C;UGgDlC,oBAAA,SAA6B,eAAA;;;;EAI7C,IAAA;AAAA;;;;;;UAYgB,YAAA;EHzBqB;;;EG6BrC,OAAA;;;;EAKA,IAAA;EFpEyC;;;EEyEzC,MAAA;;;;EAKA,IAAA,EAAM,oBAAA;AAAA;;;;ADrEP;;;;;;;;ACJA;UA4FiB,WAAA;;;;AAjFjB;EAsFC,IAAA;;;;;EAMA,SAAA;EA7EM;;;EAkFN,OAAA,EAAS,cAAA;EAtE4B;;;EA2ErC,QAAA,EAAU,YAAA;AAAA;;;;;;;AJvGX;;;;;;;;;;;;;iBKJgB,IAAA,CAAK,OAAA,UAAiB,OAAA,GAAU,oBAAA,GAAuB,eAAA;;;;;;;ALIvE;;iBMMgB,MAAA,CAAO,IAAA,UAAc,OAAA,GAAU,sBAAA,GAAyB,eAAA;;;;;;;;iBCFxD,gBAAA,CAAiB,SAAA,YAAqB,cAAA;;;;;;;;cCczC,aAAA;ER2DY;;;;EAAA,QQtDhB,OAAA;;;AP3C0C;;;EOkDlD,UAAA,CAAW,MAAA,EAAQ,MAAA;EPvCZ;;;;EAAA,IO+CH,MAAA,CAAA,GAAU,MAAA;EPzCa;;;AAsB5B;;;;;EOyCO,OAAA,GAAA,CAAW,IAAA,UAAc,IAAA,EAAM,CAAA,EAAG,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,YAAA,CAAa,CAAA;;;AN3EzF;;;;;EMsFO,GAAA,GAAA,CAAO,IAAA,UAAc,IAAA,EAAM,CAAA,GAAI,OAAA,CAAQ,YAAA,CAAa,CAAA;;;ALvF3D;;;;;AAUA;;EK0FO,QAAA,GAAA,CACL,IAAA,UACA,IAAA,UACA,IAAA,EAAM,CAAA,EACN,OAAA,GAAU,eAAA,GACR,OAAA,CAAQ,YAAA,CAAa,CAAA;EL/FU;;;;;ACJnC;EIiHO,SAAA,CAAU,KAAA,WAAgB,OAAA,CAAQ,YAAA;;;;AJtGzC;;;EIgHO,QAAA,CAAS,KAAA,WAAgB,OAAA,CAAQ,YAAA;EJ3GvC;;;;;;AAsBD;EIgGO,aAAA,CAAc,KAAA,UAAe,KAAA,EAAO,IAAA,GAAO,OAAA,CAAQ,YAAA;;;;AJhF1D;;;EI0FO,SAAA,CAAU,KAAA,WAAgB,OAAA;EJtFhC;;;;;;EIoGM,UAAA,CAAW,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,mBAAA;EJlE/B;;;;;;EI4EV,SAAA,CAAU,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,mBAAA;EJ5DrC;;;;;;EIsEH,UAAA,CAAW,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,mBAAA;;AH5KhD;;;;;;EG2LO,MAAA,GAAA,CAAU,KAAA,WAAgB,QAAA,GAAW,OAAA,CAAQ,YAAA,CAAa,CAAA;EH3LM;;;;;;EGgNhE,OAAA,GAAA,CAAW,MAAA,GAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA,CAAa,CAAA;EFtM1C;;;;;;EEgNf,iBAAA,GAAA,CAAqB,OAAA,GAAU,aAAA,GAAgB,OAAA,CAAQ,UAAA,CAAW,CAAA;EFhNc;;;;;ACFvF;EC4NO,aAAA,CAAc,MAAA,GAAS,IAAA,CAAK,WAAA,YAAuB,OAAA,CAAQ,UAAA;;;;;;EAajE,SAAA,CAAA;AAAA;;;cCnOY,YAAA,YAAwB,MAAA,EAAQ,SAAA;EAAA,UAClC,QAAA,EAAU,eAAA;EAAA,UACV,aAAA,EAAe,aAAA;EAAA,UACf,MAAA,EAAQ,MAAA;EAAA,UACR,YAAA,EAAc,gBAAA;EAAA,UAEd,MAAA,EAAQ,MAAA;cAGQ,QAAA,EAAU,eAAA,EACZ,aAAA,EAAe,aAAA,EACtB,MAAA,EAAQ,MAAA,EACD,aAAA,EAAe,aAAA;EAQjC,OAAA,CAAA,GAAW,OAAA;EA0CX,UAAA,CAAA,GAAc,OAAA;ETxE0B;;;EAAA,USqF9B,eAAA,CAAA,GAAmB,OAAA;AAAA;;;;;;;;ATrFpC;;;;;;;;;iBUZgB,YAAA,CAAa,SAAA,sBAA+B,IAAA;;;;;;UCE3C,uBAAA;EXUA;;;EWNhB,QAAA;EXkCK;;;EW7BL,MAAA;EX8EwB;;;EWzExB,IAAA,EAAM,sBAAA,GAAyB,oBAAA;EXJc;;;EWS7C,MAAA;EXmBA;;;EWdA,WAAA;AAAA;;;;;;;;;;;AVlCkD;;;;;;iBUqDnC,qBAAA,CACf,MAAA,UAAgB,IAAA,0BACd,uBAAA;;;;;;;;AXnCH;;;;;;;;;;;;;iBYRgB,cAAA,CAAe,MAAA,UAAgB,IAAA;;;;;;KCFnC,UAAA,OAAiB,KAAA,EAAO,aAAA,CAAc,CAAA,MAAO,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;AZVN;;;;;;;;;iBY6C7B,eAAA,CACrB,MAAA,EAAQ,gBAAA,EACR,UAAA,GAAa,UAAA,GACX,OAAA,CAAQ,EAAA"}