@rotorsoft/act 0.5.1 → 0.5.2

package/dist/@types/types/errors.d.ts

@@ -1,21 +1,42 @@
 import type { Message, Schema, Schemas, Target } from "./action.js";
 /**
- * Application error types
- * - `ERR_VALIDATION` schema validation error
- * - `ERR_INVARIANT` invariant validation error
- * - `ERR_CONCURRENCY` optimistic concurrency validation error on commits
+ * @packageDocumentation
+ * @module act/types
+ * @category Types
+ * Application error type constants and error classes for the Act Framework.
+ *
+ * - `ERR_VALIDATION`: Schema validation error
+ * - `ERR_INVARIANT`: Invariant validation error
+ * - `ERR_CONCURRENCY`: Optimistic concurrency validation error on commits
  */
 export declare const Errors: {
     readonly ValidationError: "ERR_VALIDATION";
     readonly InvariantError: "ERR_INVARIANT";
     readonly ConcurrencyError: "ERR_CONCURRENCY";
 };
+/**
+ * Thrown when a payload fails schema validation.
+ * @param target - The name of the target being validated (e.g., event, action).
+ * @param payload - The invalid payload.
+ * @param details - Additional validation error details.
+ * @example
+ *   throw new ValidationError('event', payload, zodError);
+ */
 export declare class ValidationError extends Error {
     readonly target: string;
     readonly payload: any;
     readonly details: any;
     constructor(target: string, payload: any, details: any);
 }
+/**
+ * Thrown when a state invariant is violated after an action or event.
+ * @param name - The name of the invariant or action.
+ * @param payload - The state or payload that failed the invariant.
+ * @param target - The target context (e.g., stream, actor).
+ * @param description - Description of the invariant.
+ * @example
+ *   throw new InvariantError('balanceNonNegative', state, target, 'Balance must be >= 0');
+ */
 export declare class InvariantError extends Error {
     readonly details: {
         name: string;
@@ -32,6 +53,14 @@ export declare class InvariantError extends Error {
     };
     constructor(name: string, payload: Schema, target: Target, description: string);
 }
+/**
+ * Thrown when an optimistic concurrency check fails during event commit.
+ * @param lastVersion - The last known version in the stream.
+ * @param events - The events being committed.
+ * @param expectedVersion - The expected version for the commit.
+ * @example
+ *   throw new ConcurrencyError(2, events, 1);
+ */
 export declare class ConcurrencyError extends Error {
     readonly lastVersion: number;
     readonly events: Message<Schemas, keyof Schemas>[];

package/dist/@types/types/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,MAAM,EAAE,MAAM;aACd,OAAO,EAAE,GAAG;aACZ,OAAO,EAAE,GAAG;gBAFZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG;CAK/B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,OAAO;;;;;;;;;;;;MAAC;gBAEtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM;CAMtB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,WAAW,EAAE,MAAM;aACnB,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,EAAE;aACzC,eAAe,EAAE,MAAM;gBAFvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,EAAE,EACzC,eAAe,EAAE,MAAM;CAS1C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,MAAM,EAAE,MAAM;aACd,OAAO,EAAE,GAAG;aACZ,OAAO,EAAE,GAAG;gBAFZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG;CAK/B;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,OAAO;;;;;;;;;;;;MAAC;gBAEtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM;CAMtB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,WAAW,EAAE,MAAM;aACnB,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,EAAE;aACzC,eAAe,EAAE,MAAM;gBAFvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,EAAE,EACzC,eAAe,EAAE,MAAM;CAS1C"}

package/dist/@types/types/index.d.ts

@@ -1,11 +1,39 @@
+/**
+ * @packageDocumentation
+ * @module act/types
+ * Barrel file for Act Framework core types.
+ *
+ * Re-exports all major type definitions for actions, errors, ports, reactions, registries, and schemas.
+ * Also defines common environment and log level types/constants for configuration and logging.
+ *
+ * @remarks
+ * Import from this module to access all core framework types in one place.
+ */
 export type * from "./action.js";
 export * from "./errors.js";
 export type * from "./ports.js";
 export type * from "./reaction.js";
 export type * from "./registry.js";
 export * from "./schemas.js";
+/**
+ * Supported runtime environments for the framework.
+ * - `development`: Local development
+ * - `test`: Automated testing
+ * - `staging`: Pre-production
+ * - `production`: Live/production
+ */
 export declare const Environments: readonly ["development", "test", "staging", "production"];
+/**
+ * Type representing a valid environment string.
+ */
 export type Environment = (typeof Environments)[number];
+/**
+ * Supported log levels for framework logging.
+ * - `fatal`, `error`, `warn`, `info`, `debug`, `trace`
+ */
 export declare const LogLevels: readonly ["fatal", "error", "warn", "info", "debug", "trace"];
+/**
+ * Type representing a valid log level string.
+ */
 export type LogLevel = (typeof LogLevels)[number];
 //# sourceMappingURL=index.d.ts.map

package/dist/@types/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,aAAa,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,eAAe,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B,eAAO,MAAM,YAAY,2DAKf,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,SAAS,+DAOZ,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,mBAAmB,aAAa,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,eAAe,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,2DAKf,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,SAAS,+DAOZ,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/@types/types/ports.d.ts

@@ -1,16 +1,69 @@
+/**
+ * @packageDocumentation
+ * @module act/types
+ * @category Types
+ * Types and interfaces for event store ports and disposables in the Act Framework.
+ */
 import type { Committed, EventMeta, Message, Query, Schemas } from "./action.js";
 import type { Fetch, Lease } from "./reaction.js";
+/**
+ * A function that disposes of a resource asynchronously.
+ * @returns Promise that resolves when disposal is complete.
+ */
 export type Disposer = () => Promise<void>;
+/**
+ * An object that can be disposed of asynchronously.
+ */
 export type Disposable = {
     dispose: Disposer;
 };
+/**
+ * Interface for an event store implementation.
+ * Provides methods for seeding, dropping, committing, querying, and managing event streams.
+ */
 export interface Store extends Disposable {
+    /**
+     * Seed the store with initial data (optional, for testing/dev).
+     */
     seed: () => Promise<void>;
+    /**
+     * Drop all data from the store (optional, for testing/dev).
+     */
     drop: () => Promise<void>;
+    /**
+     * Commit one or more events to a stream.
+     * @param stream - The stream name.
+     * @param msgs - The events/messages to commit.
+     * @param meta - Event metadata.
+     * @param expectedVersion - Optional optimistic concurrency check.
+     * @returns The committed events with metadata.
+     * @throws ConcurrencyError if expectedVersion does not match.
+     */
     commit: <E extends Schemas>(stream: string, msgs: Message<E, keyof E>[], meta: EventMeta, expectedVersion?: number) => Promise<Committed<E, keyof E>[]>;
+    /**
+     * Query events in the store, optionally filtered by query options.
+     * @param callback - Function to call for each event.
+     * @param query - Optional query options.
+     * @param withSnaps - Whether to include snapshot events.
+     * @returns The number of events processed.
+     */
     query: <E extends Schemas>(callback: (event: Committed<E, keyof E>) => void, query?: Query, withSnaps?: boolean) => Promise<number>;
+    /**
+     * Fetch new events from stream watermarks for processing.
+     * @param limit - Maximum number of streams to fetch.
+     * @returns Fetched streams and events.
+     */
     fetch: <E extends Schemas>(limit: number) => Promise<Fetch<E>>;
+    /**
+     * Lease streams for processing (e.g., for distributed consumers).
+     * @param leases - Lease requests.
+     * @returns Granted leases.
+     */
     lease: (leases: Lease[]) => Promise<Lease[]>;
+    /**
+     * Acknowledge completion of processing for leased streams.
+     * @param leases - Leases to acknowledge.
+     */
     ack: (leases: Lease[]) => Promise<void>;
 }
 //# sourceMappingURL=ports.d.ts.map

package/dist/@types/types/ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/types/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,OAAO,EACP,KAAK,EACL,OAAO,EACR,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3C,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE/C,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAG1B,MAAM,EAAE,CAAC,CAAC,SAAS,OAAO,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAC3B,IAAI,EAAE,SAAS,EACf,eAAe,CAAC,EAAE,MAAM,KACrB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,SAAS,OAAO,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,EAChD,KAAK,CAAC,EAAE,KAAK,EACb,SAAS,CAAC,EAAE,OAAO,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;IAGrB,KAAK,EAAE,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/types/ports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,OAAO,EACP,KAAK,EACL,OAAO,EACR,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,CAAC,SAAS,OAAO,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAC3B,IAAI,EAAE,SAAS,EACf,eAAe,CAAC,EAAE,MAAM,KACrB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAEtC;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,CAAC,SAAS,OAAO,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,EAChD,KAAK,CAAC,EAAE,KAAK,EACb,SAAS,CAAC,EAAE,OAAO,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;IAErB;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D;;;;OAIG;IACH,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE7C;;;OAGG;IACH,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/@types/types/reaction.d.ts

@@ -1,23 +1,74 @@
+/**
+ * @packageDocumentation
+ * @module act/types
+ * @category Types
+ * Types for reactions, leases, and fetch results in the Act Framework.
+ */
 import type { Committed, Schema, Schemas, Snapshot } from "./action.js";
+/**
+ * Handles a committed event and optionally returns a new snapshot of state.
+ * @template E - Event schemas.
+ * @template K - Event name.
+ * @param event - The committed event.
+ * @param stream - The stream name.
+ * @returns A promise resolving to a snapshot or void.
+ */
 export type ReactionHandler<E extends Schemas, K extends keyof E> = (event: Committed<E, K>, stream: string) => Promise<Snapshot<E, Schema> | void>;
+/**
+ * Resolves the stream for a reaction, either by function or static string.
+ * @template E - Event schemas.
+ * @template K - Event name.
+ * @param event - The committed event.
+ * @returns The stream name or undefined.
+ */
 export type ReactionResolver<E extends Schemas, K extends keyof E> = ((event: Committed<E, K>) => string | undefined) | string;
+/**
+ * Options for reaction processing.
+ * @property blockOnError - Whether to block on error.
+ * @property maxRetries - Maximum number of retries.
+ * @property retryDelayMs - Delay between retries in ms.
+ */
 export type ReactionOptions = {
     readonly blockOnError: boolean;
     readonly maxRetries: number;
     readonly retryDelayMs: number;
 };
+/**
+ * Defines a reaction to an event, including handler, resolver, and options.
+ * @template E - Event schemas.
+ * @template K - Event name.
+ */
 export type Reaction<E extends Schemas, K extends keyof E = keyof E> = {
     readonly handler: ReactionHandler<E, K>;
     readonly resolver: ReactionResolver<E, K>;
     readonly options: ReactionOptions;
 };
+/**
+ * Payload for a reaction, including the event and reaction definition.
+ * @template E - Event schemas.
+ */
 export type ReactionPayload<E extends Schemas> = Reaction<E> & {
     readonly event: Committed<E, keyof E>;
 };
+/**
+ * Result of fetching events from the store for processing.
+ * @template E - Event schemas.
+ * @property streams - The list of stream names.
+ * @property events - The list of committed events.
+ */
 export type Fetch<E extends Schemas> = {
     streams: string[];
     events: Committed<E, keyof E>[];
 };
+/**
+ * Lease information for stream processing.
+ * @property stream - The stream name.
+ * @property by - The lease holder.
+ * @property at - The lease timestamp.
+ * @property retry - Retry count.
+ * @property block - Whether the stream is blocked.
+ * @property error - Optional error info.
+ */
 export type Lease = {
     stream: string;
     by: string;

package/dist/@types/types/reaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reaction.d.ts","sourceRoot":"","sources":["../../../src/types/reaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAClE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AAEzC,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,IAC7D,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC,GAChD,MAAM,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI;IACrE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,IAAI;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC"}
+{"version":3,"file":"reaction.d.ts","sourceRoot":"","sources":["../../../src/types/reaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAClE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,IAC7D,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC,GAChD,MAAM,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI;IACrE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,IAAI;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;CACjC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/@types/types/registry.d.ts

@@ -1,21 +1,48 @@
 import { z, ZodType } from "zod/v4";
 import type { CommittedMeta, Schema, Schemas, State } from "./action.js";
 import type { Reaction } from "./reaction.js";
+/**
+ * @packageDocumentation
+ * @module act/types
+ * @category Types
+ * Types for event and action registries in the Act Framework.
+ */
+/**
+ * Maps event names to their schema and registered reactions.
+ * @template E - Event schemas.
+ */
 export type EventRegister<E extends Schemas> = {
     [K in keyof E]: {
         schema: ZodType<E[K]>;
         reactions: Map<string, Reaction<E, K>>;
     };
 };
+/**
+ * Maps action names to their schema definitions.
+ * @template A - Action schemas.
+ */
 export type SchemaRegister<A> = {
     [K in keyof A]: Schema;
 };
+/**
+ * Registry of all actions and events for a domain.
+ * @template S - State schemas.
+ * @template E - Event schemas.
+ * @template A - Action schemas.
+ * @property actions - Map of action names to state definitions.
+ * @property events - Map of event names to event registration info.
+ */
 export type Registry<S extends SchemaRegister<A>, E extends Schemas, A extends Schemas> = {
     readonly actions: {
         [K in keyof A]: State<S[K], E, A>;
     };
     readonly events: EventRegister<E>;
 };
+/**
+ * Utility type to convert a registry entry to a committed event type.
+ * @template R - Registry map.
+ * @template K - Event name.
+ */
 export type AsCommitted<R, K extends keyof R> = R[K] extends {
     schema: infer S;
 } ? {

package/dist/@types/types/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,OAAO,IAAI;KAC5C,CAAC,IAAI,MAAM,CAAC,GAAG;QACd,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KACxC;CACF,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC;AAE3D,MAAM,MAAM,QAAQ,CAClB,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EAC3B,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,OAAO,IACf;IACF,QAAQ,CAAC,OAAO,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5E;IACE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAC3B,GAAG,aAAa,GACjB,KAAK,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,OAAO,IAAI;KAC5C,CAAC,IAAI,MAAM,CAAC,GAAG;QACd,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KACxC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,CAClB,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EAC3B,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,OAAO,IACf;IACF,QAAQ,CAAC,OAAO,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5E;IACE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAC3B,GAAG,aAAa,GACjB,KAAK,CAAC"}

package/dist/@types/types/schemas.d.ts

@@ -1,9 +1,24 @@
 import { z, ZodObject, ZodRawShape } from "zod/v4";
+/**
+ * @packageDocumentation
+ * @module act/types
+ * @category Types
+ * Zod schemas and helpers for the Act Framework.
+ */
+/**
+ * An empty Zod schema (no properties).
+ */
 export declare const ZodEmpty: z.ZodRecord<z.ZodString, z.ZodNever>;
+/**
+ * Zod schema for an actor (user, system, etc.).
+ */
 export declare const ActorSchema: z.ZodReadonly<z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
 }, z.core.$strip>>;
+/**
+ * Zod schema for a target (stream and actor info).
+ */
 export declare const TargetSchema: z.ZodReadonly<z.ZodObject<{
     stream: z.ZodString;
     actor: z.ZodReadonly<z.ZodObject<{
@@ -12,11 +27,17 @@ export declare const TargetSchema: z.ZodReadonly<z.ZodObject<{
     }, z.core.$strip>>;
     expectedVersion: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
+/**
+ * Zod schema for causation event metadata.
+ */
 export declare const CausationEventSchema: z.ZodObject<{
     id: z.ZodNumber;
     name: z.ZodString;
     stream: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Zod schema for event metadata (correlation and causation).
+ */
 export declare const EventMetaSchema: z.ZodReadonly<z.ZodObject<{
     correlation: z.ZodString;
     causation: z.ZodObject<{
@@ -37,6 +58,9 @@ export declare const EventMetaSchema: z.ZodReadonly<z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>>;
+/**
+ * Zod schema for committed event metadata (id, stream, version, created, meta).
+ */
 export declare const CommittedMetaSchema: z.ZodReadonly<z.ZodObject<{
     id: z.ZodNumber;
     stream: z.ZodString;
@@ -63,11 +87,22 @@ export declare const CommittedMetaSchema: z.ZodReadonly<z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>>;
 }, z.core.$strip>>;
+/**
+ * Type representing the full state schema for a domain.
+ * @property events - Map of event names to Zod schemas.
+ * @property actions - Map of action names to Zod schemas.
+ * @property state - Zod schema for the state object.
+ */
 export type StateSchema = Readonly<{
     events: Record<string, ZodObject<ZodRawShape> | typeof ZodEmpty>;
     actions: Record<string, ZodObject<ZodRawShape> | typeof ZodEmpty>;
     state: ZodObject<ZodRawShape>;
 }>;
+/**
+ * Builds a Zod schema for a snapshot of state and the most recent event.
+ * @param s - The state schema definition.
+ * @returns A Zod schema for the snapshot object.
+ */
 export declare function buildSnapshotSchema<S extends StateSchema>(s: S): z.ZodObject<{
     state: z.ZodReadonly<z.ZodObject<Readonly<{
         [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
@@ -164,18 +199,19 @@ export declare function buildSnapshotSchema<S extends StateSchema>(s: S): z.ZodO
     snaps: z.ZodNumber;
 }, z.core.$strip>;
 /**
- * Options to query the all stream
- * - `stream?` filter by stream
- * - `names?` filter by event names
- * - `before?` filter events before this id
- * - `after?` filter events after this id
- * - `limit?` limit the number of events to return
- * - `created_before?` filter events created before this date/time
- * - `created_after?` filter events created after this date/time
- * - `backward?` order descending when true
- * - `correlation?` filter by correlation
- * - `actor?` filter by actor id (mainly used to reduce process managers)
- * - `loading?` flag when loading to optimize queries
+ * Query options for event store queries.
+ *
+ * - `stream?`: Filter by stream name
+ * - `names?`: Filter by event names
+ * - `before?`: Filter events before this id
+ * - `after?`: Filter events after this id
+ * - `limit?`: Limit the number of events to return
+ * - `created_before?`: Filter events created before this date/time
+ * - `created_after?`: Filter events created after this date/time
+ * - `backward?`: Order descending when true
+ * - `correlation?`: Filter by correlation
+ * - `actor?`: Filter by actor id (mainly used to reduce process managers)
+ * - `loading?`: Flag when loading to optimize queries
  */
 export declare const QuerySchema: z.ZodObject<{
     stream: z.ZodOptional<z.ZodString>;

package/dist/@types/types/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/types/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEnD,eAAO,MAAM,QAAQ,sCAAkC,CAAC;AAExD,eAAO,MAAM,WAAW;;;kBAKX,CAAC;AAEd,eAAO,MAAM,YAAY;;;;;;;kBAMZ,CAAC;AAEd,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;kBAQf,CAAC;AAEd,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;kBAQnB,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IAClE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkB9D;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;iBAUtB,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/types/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEnD;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,sCAAkC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW;;;kBAKX,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;kBAMZ,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;kBAQf,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;kBAQnB,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC;IAClE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkB9D;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;iBAUtB,CAAC"}

package/dist/@types/utils.d.ts

@@ -1,20 +1,61 @@
 import { type ZodType } from "zod/v4";
 import type { Patch, Schema } from "./types/index.js";
 /**
+ * @module utils
+ * @category Utilities
  * Utility functions for patching state, validation, extending objects, and async helpers.
+ *
+ * - Use `patch()` to immutably update state with patches.
+ * - Use `validate()` to validate payloads against Zod schemas.
+ * - Use `extend()` to merge and validate configuration objects.
+ * - Use `sleep()` for async delays.
  */
 /**
- * Copies state with patches recursively.
+ * Immutably copies state with patches recursively.
+ *
  * Keys with `undefined` or `null` values in patch are deleted.
- * @param original original state
- * @param patches patches to merge
- * @returns a new patched state
+ *
+ * @param original The original state object
+ * @param patches The patches to merge
+ * @returns A new patched state
+ *
+ * @example
+ * const newState = patch(oldState, { count: 5 });
  */
 export declare const patch: <S extends Schema>(original: Readonly<S>, patches: Readonly<Patch<S>>) => Readonly<S>;
+/**
+ * Validates a payload against a Zod schema, throwing a ValidationError on failure.
+ *
+ * @param target The name of the target (for error reporting)
+ * @param payload The payload to validate
+ * @param schema (Optional) The Zod schema to validate against
+ * @returns The validated payload
+ * @throws ValidationError if validation fails
+ *
+ * @example
+ * const valid = validate("User", userPayload, userSchema);
+ */
 export declare const validate: <S>(target: string, payload: Readonly<S>, schema?: ZodType<S>) => Readonly<S>;
 /**
- * Extends target payload with source payload after validating source
+ * Extends the target payload with the source payload after validating the source.
+ *
+ * @param source The source object to validate and merge
+ * @param schema The Zod schema for the source
+ * @param target (Optional) The target object to extend
+ * @returns The merged and validated object
+ *
+ * @example
+ * const config = extend(envConfig, configSchema, defaultConfig);
  */
 export declare const extend: <S extends Record<string, unknown>, T extends Record<string, unknown>>(source: Readonly<S>, schema: ZodType<S>, target?: Readonly<T>) => Readonly<S & T>;
+/**
+ * Async helper to pause execution for a given number of milliseconds.
+ *
+ * @param ms (Optional) Milliseconds to sleep (defaults to config().sleepMs)
+ * @returns Promise that resolves after the delay
+ *
+ * @example
+ * await sleep(1000); // sleep for 1 second
+ */
 export declare function sleep(ms?: number): Promise<unknown>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/@types/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAiB,MAAM,QAAQ,CAAC;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA+BtD;;GAEG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,EACpC,UAAU,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAC1B,QAAQ,CAAC,CAAC,CAgBZ,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,QAAQ,MAAM,EACd,SAAS,QAAQ,CAAC,CAAC,CAAC,EACpB,SAAS,OAAO,CAAC,CAAC,CAAC,KAClB,QAAQ,CAAC,CAAC,CAaZ,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,GACjB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEjC,QAAQ,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,OAAO,CAAC,CAAC,CAAC,EAClB,SAAS,QAAQ,CAAC,CAAC,CAAC,KACnB,QAAQ,CAAC,CAAC,GAAG,CAAC,CAGhB,CAAC;AAEF,wBAAsB,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,oBAEtC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAiB,MAAM,QAAQ,CAAC;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA+BtD;;;;;;;;;GASG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,EACpC,UAAU,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAC1B,QAAQ,CAAC,CAAC,CAgBZ,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,QAAQ,MAAM,EACd,SAAS,QAAQ,CAAC,CAAC,CAAC,EACpB,SAAS,OAAO,CAAC,CAAC,CAAC,KAClB,QAAQ,CAAC,CAAC,CAaZ,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,GACjB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEjC,QAAQ,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,OAAO,CAAC,CAAC,CAAC,EAClB,SAAS,QAAQ,CAAC,CAAC,CAAC,KACnB,QAAQ,CAAC,CAAC,GAAG,CAAC,CAGhB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,oBAEtC"}