interaqt 1.1.3 → 1.2.0

package/agent/agentspace/knowledge/generator/api-reference.md

@@ -553,7 +553,7 @@ EventSource.create<TArgs, TResult>(
   ```typescript
   async function(this: Controller, args: TArgs): Promise<TResult>
   ```
-- `config.afterDispatch` (function, optional): Hook called after dispatch completes. Can return additional context.
+- `config.afterDispatch` (function, optional): Hook called inside the retryable transaction attempt. Can return additional context, but must be retry-safe and must not perform irreversible external IO.
   ```typescript
   async function(this: Controller, args: TArgs, result: { data?: TResult }): Promise<Record<string, unknown> | void>
   ```
@@ -664,7 +664,7 @@ const result = await controller.dispatch(webhookSource, {
 2. `guard` runs before event processing; throw to reject the event
 3. `mapEventData` converts dispatch args into the format stored in the entity
 4. `resolve` returns data to the caller (useful for query-type events)
-5. `afterDispatch` runs after successful processing and can return additional context
+5. `afterDispatch` runs inside the retryable transaction attempt and can return additional context
 6. The Controller automatically registers the event source's entity if not already in the entities list
 7. Interaction is a built-in EventSource type that provides pre-built `guard`, `mapEventData`, and `resolve` implementations
 
@@ -1631,6 +1631,13 @@ Custom.create(config: CustomConfig): CustomInstance
   - For accessing dictionaries: use `type: 'global'` with `source: DictionaryInstance`
 - `config.useLastValue` (boolean, optional): Whether to use last computed value in incremental computation
 - `config.attributeQuery` (AttributeQueryData, optional): Attribute query configuration
+- `config.concurrency` (`'serializable' | 'atomic-safe'`, optional): Defaults to `'serializable'`. Serializable custom computations are retried in PostgreSQL `SERIALIZABLE` transactions. Use `'atomic-safe'` only when the callback is explicitly written with atomic state, idempotent patches, or other safe primitives.
+
+**Retry safety**
+
+Custom `compute`, `incrementalCompute`, `incrementalPatchCompute`, and `asyncReturn` callbacks may be replayed after transaction retry. Keep them deterministic and avoid irreversible external IO. Put post-commit external work in `recordMutationSideEffects`.
+
+For async custom computations, `ComputationResult.async({ freshnessKey })` can override the default freshness stream. Property async freshness is scoped to the host record, global async freshness is scoped to the global result, and entity/relation async freshness defaults to the result target.
 
 **Examples**
 
@@ -3376,7 +3383,7 @@ type DispatchResponse = {
 2. Execute `guard` (if provided and `ignoreGuard` is false)
 3. Map event data via `mapEventData` and create event record
 4. Execute `resolve` (if provided) - returns data
-5. Execute `afterDispatch` (if provided) - returns context
+5. Execute `afterDispatch` (if provided) inside the retryable transaction attempt - returns context
 6. Commit transaction
 7. Run RecordMutationSideEffects
 
@@ -3465,9 +3472,10 @@ interface Storage {
     map: any
     
     // Transaction operations
-    beginTransaction: (transactionName?: string) => Promise<any>
-    commitTransaction: (transactionName?: string) => Promise<any>
-    rollbackTransaction: (transactionName?: string) => Promise<any>
+    runInTransaction: <T>(
+        options: { name?: string; isolation?: 'READ COMMITTED' | 'SERIALIZABLE' },
+        fn: () => Promise<T>
+    ) => Promise<T>
     
     // Dictionary-specific API
     dict: {
@@ -3506,22 +3514,12 @@ interface Storage {
 
 #### Transaction Operations
 
-**beginTransaction(transactionName?: string)**
-Begin a database transaction.
-```typescript
-await storage.beginTransaction('updateOrder')
-```
-
-**commitTransaction(transactionName?: string)**
-Commit a database transaction.
+**runInTransaction(options, fn)**
+Run a callback inside a database transaction. The callback form is the only supported transaction boundary because it keeps the transaction connection bound to the full async chain.
 ```typescript
-await storage.commitTransaction('updateOrder')
-```
-
-**rollbackTransaction(transactionName?: string)**
-Rollback a database transaction.
-```typescript
-await storage.rollbackTransaction('updateOrder')
+await storage.runInTransaction({ name: 'updateOrder' }, async () => {
+  await storage.update('Order', match, data)
+})
 ```
 
 #### Entity/Relation Operations

package/agent/agentspace/knowledge/generator/computation-implementation.md

@@ -5,6 +5,12 @@ Computations are the reactive core of interaqt, connecting interactions to entit
 
 ## Types of Computations
 
+## Retry Safety
+
+Computation callbacks may be replayed under PostgreSQL transaction retry. Keep callbacks deterministic and database-focused. Do not perform irreversible external IO in `compute`, `incrementalCompute`, `incrementalPatchCompute`, Transform callbacks, StateMachine compute functions, or `asyncReturn`.
+
+For custom computations, the default concurrency mode is `serializable`; use `concurrency: 'atomic-safe'` only when the callback is explicitly safe under concurrent `READ COMMITTED` execution.
+
 ### 1. Transform - Creates Entities/Relations
 
 **ONLY use in Entity/Relation computation, NEVER in Property!**

package/agent/agentspace/knowledge/generator/integration-implementation-handler.md

@@ -206,6 +206,8 @@ async setup(controller: Controller) {
 
 **Purpose**: Define side effects that synchronize reactive data changes to external systems.
 
+`RecordMutationSideEffect` is the recommended place for irreversible external IO. Interaction callbacks, custom computation callbacks, `afterDispatch`, and `asyncReturn` may be replayed by PostgreSQL transaction retry; side effects run after the final successful commit.
+
 **Use Cases**:
 - Push data mutations to external APIs
 - Publish messages to message queues

package/agent/agentspace/knowledge/usage/04-reactive-computations.md

@@ -81,6 +81,14 @@ Reactive computation is a **declarative way of defining data**:
 - **Incremental computation**: Framework uses efficient incremental algorithms to avoid unnecessary recomputation
 - **Persistent**: Computation results are stored in the database for fast queries
 
+### PostgreSQL Concurrency Guarantees
+
+Built-in computations such as Count, Summation, Average, Every, Any, WeightedSummation, StateMachine, and data-based Transform use atomic state updates, row locks, or unique indexes on PostgreSQL. They are safe when multiple Node.js processes share one PostgreSQL database.
+
+Custom computations are different because interaqt cannot inspect user callback logic. `Custom.create()` defaults to `concurrency: 'serializable'`, so the framework promotes the transaction to PostgreSQL `SERIALIZABLE` and retries on `40001` / `40P01`. Use `concurrency: 'atomic-safe'` only when the custom computation is explicitly written with atomic state, idempotent patches, or other safe primitives.
+
+Because retry replays the transaction attempt, `guard`, `mapEventData`, `resolve`, computation callbacks, `afterDispatch`, and `asyncReturn` must be deterministic and retry-safe. Put irreversible external IO in `recordMutationSideEffects`, which runs after the final commit.
+
 ### Core Principle: Data Existence
 
 In interaqt, all data has its "reason for existence":

package/agent/agentspace/knowledge/usage/05-interactions.md

@@ -21,6 +21,19 @@ const result = await controller.callInteraction('CreatePost', {
 });
 ```
 
+## Retry-Safe Interaction Callbacks
+
+`Controller.dispatch()` runs interaction processing inside a retryable transaction. PostgreSQL SERIALIZABLE promotion or retryable SQLSTATE errors (`40001`, `40P01`) may replay the transaction attempt.
+
+These interaction callbacks must be deterministic and retry-safe:
+
+- `guard`
+- `mapEventData`
+- `resolve`
+- `afterDispatch`
+
+`afterDispatch` runs before commit inside the retryable transaction attempt. It can return response context or perform retry-safe database work, but it must not perform irreversible external IO. Put emails, webhooks, message publishing, payment calls, and other post-commit external effects in `recordMutationSideEffects`.
+
 ## Basic Concepts of Interactions
 
 ### What is an Interaction

package/agent/agentspace/knowledge/usage/10-async-computations.md

@@ -205,6 +205,19 @@ const currentWeather = await system.storage.get('state', 'currentWeather');
 console.log('Current weather:', currentWeather);
 ```
 
+### Retry and Freshness Semantics
+
+`handleAsyncReturn()` runs inside the same retryable transaction model as `Controller.dispatch()`. If PostgreSQL reports a retryable transaction error, or if the async result applies a custom/full-replace path that requires `SERIALIZABLE`, interaqt may replay the async return attempt.
+
+Keep `asyncReturn` deterministic and database-focused. Do not send emails, call payment APIs, publish messages, or perform other irreversible external IO from `asyncReturn`; those effects can be duplicated by a retry. Put irreversible post-commit work in `recordMutationSideEffects`.
+
+Async tasks also use a freshness key so stale results do not overwrite newer work:
+
+- Property async computations default to a key scoped by computation and host record.
+- Global async computations default to a key scoped by computation and global result.
+- Entity and relation async computations default to the result target, which means each target has one global freshness stream.
+- Pass an explicit `freshnessKey` to `ComputationResult.async({ freshnessKey })` when multiple independent async streams should be allowed for the same entity or relation target.
+
 ## Implementing Entity Async Computations
 
 ### Use Cases

package/agent/agentspace/knowledge/usage/13-testing.md

@@ -13,10 +13,10 @@ Many LLMs generate incorrect API usage. Here's the correct way to use interaqt t
 controller.run()                           // ❌ No such method
 storage.findByProperty('Entity', 'prop')   // ❌ No such method
 controller.execute()                       // ❌ No such method
-controller.dispatch()                      // ❌ No such method
 
 // ✅ CORRECT: Use these APIs instead
-controller.callInteraction('InteractionName', args)  // ✅ Call interactions
+controller.callInteraction('InteractionName', args)  // ✅ Call interaction by name
+controller.dispatch(InteractionObject, args)         // ✅ Dispatch an event source object
 storage.findOne('Entity', MatchExp)                  // ✅ Find single record
 storage.find('Entity', MatchExp)                     // ✅ Find multiple records
 storage.create('Entity', data)                       // ✅ Create record
@@ -139,6 +139,16 @@ describe('Feature Tests', () => {
 })
 ```
 
+### PostgreSQL Concurrency Tests
+
+For changes that affect runtime transactions, custom computations, async computations, PostgreSQL id generation, or reactive computation state, run the real PostgreSQL suite:
+
+```bash
+INTERAQT_POSTGRES_DATABASE=interaqt_test npm run test:postgres-concurrency
+```
+
+This script fails when the database environment variable is missing. Plain `npm test` may skip PostgreSQL-specific tests in local lightweight environments.
+
 ### Key API Methods
 
 #### 1. Controller APIs

package/agent/agentspace/knowledge/usage/14-api-reference.md

@@ -514,6 +514,16 @@ Transform.create(config: TransformConfig): KlassInstance<typeof Transform>
 - `config.callback` (function, required): Transformation function that converts source data to target data
 - `config.attributeQuery` (AttributeQueryData, required): Attribute query configuration
 
+### Custom.create()
+
+Create a custom computation when built-in computations are not expressive enough.
+
+**Concurrency parameter**
+- `config.concurrency` (optional): `'serializable' | 'atomic-safe'`, defaults to `'serializable'`.
+- `'serializable'`: interaqt runs the custom computation in a retryable PostgreSQL `SERIALIZABLE` transaction.
+- `'atomic-safe'`: you explicitly promise the custom computation only uses atomic state, idempotent patches, or other concurrency-safe primitives. Full recompute and entity/relation full replace paths still require SERIALIZABLE even for `atomic-safe` custom computations.
+
+Custom callbacks may be replayed after retryable transaction failures. Do not perform irreversible external IO inside custom `compute`, `incrementalCompute`, `incrementalPatchCompute`, or `asyncReturn`; use `recordMutationSideEffects` for post-commit external work.
 
 ### StateMachine.create()
 

package/agent/agentspace/knowledge/usage/18-api-exports-reference.md

@@ -53,6 +53,9 @@ import {
   // Storage and Query
   Controller,
   MonoSystem,
+  runWithTransactionRetry,
+  isRetryableTransactionError,
+  isRequireSerializableRetry,
   
   // Dictionary (Global State)
   Dictionary,
@@ -173,4 +176,6 @@ const controller = new Controller({
 
 4. **Filtered Entities**: Created using `Entity.create()` with `baseEntity` and `filterCondition`, not a separate import.
 
-5. **Database Drivers**: Choose one based on your needs - PGLiteDB for in-memory testing, PostgreSQLDB for production, etc. 
+5. **Database Drivers**: Choose one based on your needs - PGLiteDB for in-memory testing, PostgreSQLDB for production, etc. 
+
+6. **Transaction helpers**: `runWithTransactionRetry`, `isRetryableTransactionError`, and `isRequireSerializableRetry` are exported for advanced runtime integrations and tests. Most application code should use `Controller.dispatch()` or `system.storage.runInTransaction()` instead of calling retry helpers directly.

package/agent/agentspace/knowledge/usage/20-postgresql-concurrency-migration.md

@@ -0,0 +1,105 @@
+# PostgreSQL Concurrency Migration
+
+This note summarizes user-visible changes from the PostgreSQL reactive computation concurrency fix.
+
+## What Changed
+
+interaqt now uses PostgreSQL as the concurrency coordinator for multi-process deployments:
+
+- Built-in computations use atomic state updates, row locks, unique indexes, or SERIALIZABLE retry where needed.
+- PostgreSQL id generation uses native sequences instead of writing `_IDS_`.
+- Custom computations default to retryable `SERIALIZABLE` execution.
+- Async return handling runs in a retryable transaction and applies freshness checks.
+
+## Callback Replay Rules
+
+The following callbacks may be replayed after SERIALIZABLE promotion, `40001`, or `40P01`:
+
+- `guard`
+- `mapEventData`
+- `resolve`
+- computation callbacks
+- `afterDispatch`
+- `asyncReturn`
+
+Keep these callbacks deterministic. Do not send emails, charge payments, call irreversible external APIs, publish messages, or write non-transactional resources from these callbacks.
+
+Use `recordMutationSideEffects` for irreversible external IO. Side effects run after the final successful commit and are not replayed for failed attempts.
+
+## Custom Computation Concurrency
+
+`Custom.create()` now defaults to:
+
+```typescript
+Custom.create({
+  name: 'MyComputation',
+  concurrency: 'serializable',
+  // ...
+})
+```
+
+Use `concurrency: 'atomic-safe'` only when the custom computation is explicitly safe under concurrent PostgreSQL `READ COMMITTED` execution, for example because it only uses atomic state or idempotent patches.
+
+Even with `atomic-safe`, full recompute and entity/relation full replace paths still require SERIALIZABLE.
+
+## Async Return Freshness
+
+`handleAsyncReturn()` locks the task row and checks whether the task is still current.
+
+Default freshness streams:
+
+- Property async computation: scoped to the host record.
+- Global async computation: scoped to the global result.
+- Entity/relation async computation: scoped to the result target.
+
+Pass an explicit `freshnessKey` when one entity or relation target needs multiple independent async streams:
+
+```typescript
+return ComputationResult.async({
+  freshnessKey: `tenant:${tenantId}:job:${jobId}`,
+  // task args...
+})
+```
+
+Stale tasks are marked `skipped` and do not call `asyncReturn`.
+
+## PostgreSQL ID Sequences
+
+PostgreSQL ids are allocated with native sequences.
+
+Migration behavior:
+
+- New databases start at id `1`.
+- Existing table max id is used to initialize the sequence.
+- Existing `_IDS_` rows are read as legacy migration input when the table exists.
+- Databases without `_IDS_` are supported.
+- Shared physical tables use one sequence per physical table/id field.
+
+Do not write `_IDS_` to control ids. `_IDS_` is legacy input only.
+
+PostgreSQL sequence gaps are normal after rollback or failed transactions. Do not depend on contiguous ids.
+
+## Transaction API
+
+Use callback transactions:
+
+```typescript
+await system.storage.runInTransaction(
+  { name: 'my-operation', isolation: 'SERIALIZABLE' },
+  async () => {
+    // transactional work
+  }
+)
+```
+
+Do not use old manual transaction APIs such as `beginTransaction`, `commitTransaction`, or `rollbackTransaction`.
+
+## Testing PostgreSQL Concurrency
+
+Run the real PostgreSQL concurrency suite with:
+
+```bash
+INTERAQT_POSTGRES_DATABASE=interaqt_test npm run test:postgres-concurrency
+```
+
+This script intentionally fails when `INTERAQT_POSTGRES_DATABASE` is missing, so PostgreSQL concurrency coverage cannot silently skip in CI.

package/agent/agentspace/knowledge/usage/README.md

@@ -142,6 +142,7 @@ Remember: **Stop thinking "how to do", start thinking "what is"**!
 18. [Performance Optimization](./17-performance-optimization.md) - Performance tips
 19. [API Exports Reference](./18-api-exports-reference.md) - Complete list of available imports
 20. [Common Anti-Patterns](./19-common-anti-patterns.md) - Mistakes to avoid
+21. [PostgreSQL Concurrency Migration](./20-postgresql-concurrency-migration.md) - Retry, async, and sequence migration notes
 
 ## 📞 Need Help?
 

package/dist/core/Custom.d.ts

@@ -1,5 +1,6 @@
 import { IInstance } from './interfaces.js';
 import { DataDep } from './Computation.js';
+export type CustomConcurrency = 'serializable' | 'atomic-safe';
 export interface CustomInstance extends IInstance {
     name: string;
     dataDeps?: {
@@ -10,8 +11,18 @@ export interface CustomInstance extends IInstance {
     incrementalPatchCompute?: Function;
     createState?: Function;
     getInitialValue?: Function;
+    /**
+     * Runs inside the retryable transaction attempt when async task results are
+     * applied. Keep it deterministic and free of irreversible external IO.
+     */
     asyncReturn?: Function;
     useLastValue?: boolean;
+    /**
+     * Defaults to 'serializable'. Use 'atomic-safe' only when the custom
+     * computation's incremental path is built from framework atomic primitives or
+     * otherwise remains correct under READ COMMITTED retry boundaries.
+     */
+    concurrency?: CustomConcurrency;
 }
 export interface CustomCreateArgs {
     name: string;
@@ -25,6 +36,7 @@ export interface CustomCreateArgs {
     getInitialValue?: Function;
     asyncReturn?: Function;
     useLastValue?: boolean;
+    concurrency?: CustomConcurrency;
 }
 export declare class Custom implements CustomInstance {
     uuid: string;
@@ -43,6 +55,7 @@ export declare class Custom implements CustomInstance {
     getInitialValue?: Function;
     asyncReturn?: Function;
     useLastValue?: boolean;
+    concurrency?: CustomConcurrency;
     constructor(args: CustomCreateArgs, options?: {
         uuid?: string;
     });
@@ -95,6 +108,11 @@ export declare class Custom implements CustomInstance {
             collection: false;
             required: false;
         };
+        concurrency: {
+            type: "string";
+            collection: false;
+            required: false;
+        };
     };
     static create(args: CustomCreateArgs, options?: {
         uuid?: string;

package/dist/core/Custom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Custom.d.ts","sourceRoot":"","sources":["../../src/core/Custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgC,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACtC,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAC9B,uBAAuB,CAAC,EAAE,QAAQ,CAAC;IACnC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACtC,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAC9B,uBAAuB,CAAC,EAAE,QAAQ,CAAC;IACnC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,MAAO,YAAW,cAAc;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,SAAY;IACjB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACtC,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAC9B,uBAAuB,CAAC,EAAE,QAAQ,CAAC;IACnC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;gBAElB,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAe/D,MAAM,CAAC,OAAO,EAAG,IAAI,CAAU;IAC/B,MAAM,CAAC,WAAW,SAAY;IAC9B,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAM;IAExC,MAAM,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA8CX;IAEF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc;IAalF,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAsBlD,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc;IAcrE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc;IAI9C,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAIpC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;CAc3C"}
+{"version":3,"file":"Custom.d.ts","sourceRoot":"","sources":["../../src/core/Custom.ts"],"names":[],"mappings":"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"}

package/dist/core/EventSource.d.ts

@@ -4,9 +4,26 @@ type CallbackThis = any;
 export interface EventSourceInstance<TArgs = unknown, TResult = void> extends IInstance {
     name: string;
     entity: EntityInstance;
+    /**
+     * Runs inside the dispatch transaction attempt. It may be replayed when the
+     * transaction is promoted or retried, so it must be deterministic and must
+     * not perform irreversible external IO.
+     */
     guard?: (this: CallbackThis, args: TArgs) => Promise<void>;
+    /**
+     * Runs inside the dispatch transaction attempt and may be replayed on retry.
+     */
     mapEventData?: (args: TArgs) => Record<string, unknown>;
+    /**
+     * Runs inside the dispatch transaction attempt and may be replayed on retry.
+     * External side effects should be modeled with record mutation side effects,
+     * which run after the final successful commit.
+     */
     resolve?: (this: CallbackThis, args: TArgs) => Promise<TResult>;
+    /**
+     * Runs before commit inside the retryable transaction attempt. It may produce
+     * response context, but it must not perform irreversible external IO.
+     */
     afterDispatch?: (this: CallbackThis, args: TArgs, result: {
         data?: TResult;
     }) => Promise<Record<string, unknown> | void>;

package/dist/core/EventSource.d.ts.map

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

package/dist/drivers/PGLite.d.ts

@@ -15,8 +15,10 @@ export declare class PGLiteDB implements Database {
     idSystem: IDSystem;
     logger: DatabaseLogger;
     db: InstanceType<typeof PGlite>;
+    supportsSelectForUpdate: boolean;
     constructor(database?: string | undefined, options?: PGLiteDBConfig);
     open(forceDrop?: boolean): Promise<void>;
+    setupInternalComputationState(): Promise<void>;
     query<T>(sql: string, params?: unknown[], name?: string): Promise<T[]>;
     update<T>(sql: string, values: unknown[], idField?: string, name?: string): Promise<T[]>;
     insert(sql: string, values: unknown[], name?: string): Promise<EntityIdRef>;

package/dist/drivers/PGLite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PGLite.d.ts","sourceRoot":"","sources":["../../src/drivers/PGLite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAA4E,MAAM,UAAU,CAAC;AAC1I,OAAO,EAAE,MAAM,EAAC,MAAM,sBAAsB,CAAA;AAG5C,cAAM,QAAQ;IACS,EAAE,EAAE,QAAQ;gBAAZ,EAAE,EAAE,QAAQ;IAC/B,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;CAGrC;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAExD,qBAAa,QAAS,YAAW,QAAQ;IAIlB,QAAQ,CAAC,EAAC,MAAM;IAAS,OAAO,EAAE,cAAc;IAHnE,QAAQ,EAAG,QAAQ,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;IACtB,EAAE,EAAE,YAAY,CAAC,OAAO,MAAM,CAAC,CAAA;gBACZ,QAAQ,CAAC,EAAC,MAAM,YAAA,EAAS,OAAO,GAAE,cAAmB;IAKlE,IAAI,CAAC,SAAS,UAAQ;IAqBtB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,MAAM,GAAE,OAAO,EAAM,EAAE,IAAI,SAAI;IAuBpD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,SAAG;IAgBhE,MAAM,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,OAAO,EAAE,EAAE,IAAI,SAAG;IA2B5C,MAAM,CAAC,CAAC,EAAG,GAAG,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,SAAG;IAYjD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAG;IAoBjC,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;IAGlC,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,MAAM;;;;IAYzL,cAAc;IAOd,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAmBtD"}
+{"version":3,"file":"PGLite.d.ts","sourceRoot":"","sources":["../../src/drivers/PGLite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAA4E,MAAM,UAAU,CAAC;AAC1I,OAAO,EAAE,MAAM,EAAC,MAAM,sBAAsB,CAAA;AAG5C,cAAM,QAAQ;IACS,EAAE,EAAE,QAAQ;gBAAZ,EAAE,EAAE,QAAQ;IAC/B,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;CAGrC;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAExD,qBAAa,QAAS,YAAW,QAAQ;IAKlB,QAAQ,CAAC,EAAC,MAAM;IAAS,OAAO,EAAE,cAAc;IAJnE,QAAQ,EAAG,QAAQ,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;IACtB,EAAE,EAAE,YAAY,CAAC,OAAO,MAAM,CAAC,CAAA;IAC/B,uBAAuB,UAAO;gBACX,QAAQ,CAAC,EAAC,MAAM,YAAA,EAAS,OAAO,GAAE,cAAmB;IAKlE,IAAI,CAAC,SAAS,UAAQ;IAqBtB,6BAA6B;IAU7B,KAAK,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,MAAM,GAAE,OAAO,EAAM,EAAE,IAAI,SAAI;IAuBpD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,SAAG;IAgBhE,MAAM,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,OAAO,EAAE,EAAE,IAAI,SAAG;IA2B5C,MAAM,CAAC,CAAC,EAAG,GAAG,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,SAAG;IAYjD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAG;IAoBjC,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;IAGlC,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,MAAM;;;;IAYzL,cAAc;IAOd,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAmBtD"}

package/dist/drivers/PostgreSQL.d.ts

@@ -1,10 +1,21 @@
-import { Database, DatabaseLogger, EntityIdRef } from '..';
+import { Database, DatabaseLogger, EntityIdRef, TransactionOptions } from '..';
 import { default as pg, ClientConfig } from 'pg';
-declare const Client: typeof pg.Client;
+declare const Client: typeof pg.Client, Pool: typeof pg.Pool;
 declare class IDSystem {
-    db: Database;
-    constructor(db: Database);
-    setup(): Promise<unknown>;
+    db: PostgreSQLDB;
+    private initialized;
+    private recordToSequenceName;
+    constructor(db: PostgreSQLDB);
+    setup(): Promise<pg.QueryResult<any>>;
+    private sanitizeIdentifierPart;
+    sequenceName(recordName: string): string;
+    private sequenceNameForKey;
+    private quoteIdentifier;
+    setupSequences(records: Array<{
+        recordName: string;
+        tableName: string;
+        idField: string;
+    }>): Promise<void>;
     getAutoId(recordName: string): Promise<string>;
 }
 export type PostgreSQLDBConfig = Omit<ClientConfig, 'database'> & {
@@ -16,8 +27,14 @@ export declare class PostgreSQLDB implements Database {
     idSystem: IDSystem;
     logger: DatabaseLogger;
     db: InstanceType<typeof Client>;
+    pool?: InstanceType<typeof Pool>;
+    private transactionContext;
+    supportsSelectForUpdate: boolean;
     constructor(database: string, options?: PostgreSQLDBConfig);
     open(forceDrop?: boolean): Promise<void>;
+    private getQueryable;
+    runInTransaction<T>(options: TransactionOptions, fn: () => Promise<T>): Promise<T>;
+    setupInternalComputationState(): Promise<void>;
     query<T>(sql: string, where?: unknown[], name?: string): Promise<T[]>;
     update<T>(sql: string, values: unknown[], idField?: string, name?: string): Promise<T[]>;
     insert(sql: string, values: unknown[], name?: string): Promise<EntityIdRef>;
@@ -25,6 +42,11 @@ export declare class PostgreSQLDB implements Database {
     scheme(sql: string, name?: string): Promise<pg.QueryResult<any>>;
     close(): Promise<void>;
     getAutoId(recordName: string): Promise<string>;
+    setupRecordSequences(records: Array<{
+        recordName: string;
+        tableName: string;
+        idField: string;
+    }>): Promise<void>;
     parseMatchExpression(key: string, value: [string, string], fieldName: string, fieldType: string, isReferenceValue: boolean, getReferenceFieldValue: (v: string) => string, p: () => string): {
         fieldValue: string;
         fieldParams: string[];

package/dist/drivers/PostgreSQL.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PostgreSQL.d.ts","sourceRoot":"","sources":["../../src/drivers/PostgreSQL.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAA4E,MAAM,UAAU,CAAC;AAC1I,OAAO,EAAE,EAAE,EAAE,KAAK,YAAY,EAAC,MAAM,IAAI,CAAA;AAEzC,QAAA,MAAQ,MAAM,kBAAM,CAAA;AAEpB,cAAM,QAAQ;IACS,EAAE,EAAE,QAAQ;gBAAZ,EAAE,EAAE,QAAQ;IAC/B,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;CAWrC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAE7F,qBAAa,YAAa,YAAW,QAAQ;IAItB,QAAQ,EAAC,MAAM;IAAS,OAAO,EAAE,kBAAkB;IAHtE,QAAQ,EAAG,QAAQ,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;IACtB,EAAE,EAAE,YAAY,CAAC,OAAO,MAAM,CAAC,CAAA;gBACZ,QAAQ,EAAC,MAAM,EAAS,OAAO,GAAE,kBAAuB;IAOrE,IAAI,CAAC,SAAS,UAAQ;IAsBtB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,KAAK,GAAE,OAAO,EAAM,EAAE,IAAI,SAAI;IAanD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,SAAG;IAehE,MAAM,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,OAAO,EAAE,EAAE,IAAI,SAAG;IAgB5C,MAAM,CAAC,CAAC,EAAG,GAAG,EAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,SAAG;IAYhD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAG;IAUjC,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;IAGlC,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,MAAM;;;;IAYzL,cAAc;IAOd,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAmBtD"}
+{"version":3,"file":"PostgreSQL.d.ts","sourceRoot":"","sources":["../../src/drivers/PostgreSQL.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAuG,kBAAkB,EAAC,MAAM,UAAU,CAAC;AAGxL,OAAO,EAAE,EAAE,EAAE,KAAK,YAAY,EAAkB,MAAM,IAAI,CAAA;AAE1D,QAAA,MAAQ,MAAM,oBAAE,IAAI,gBAAO,CAAA;AAQ3B,cAAM,QAAQ;IAGS,EAAE,EAAE,YAAY;IAFnC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,oBAAoB,CAA4B;gBACrC,EAAE,EAAE,YAAY;IACnC,KAAK;IAGL,OAAO,CAAC,sBAAsB;IAI9B,YAAY,CAAC,UAAU,EAAE,MAAM;IAG/B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,eAAe;IAGjB,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAsCzF,SAAS,CAAC,UAAU,EAAE,MAAM;CAYrC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAE7F,qBAAa,YAAa,YAAW,QAAQ;IAOtB,QAAQ,EAAC,MAAM;IAAS,OAAO,EAAE,kBAAkB;IANtE,QAAQ,EAAG,QAAQ,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;IACtB,EAAE,EAAE,YAAY,CAAC,OAAO,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,IAAI,CAAC,CAAA;IAChC,OAAO,CAAC,kBAAkB,CAA8C;IACxE,uBAAuB,UAAO;gBACX,QAAQ,EAAC,MAAM,EAAS,OAAO,GAAE,kBAAuB;IAKrE,IAAI,CAAC,SAAS,UAAQ;IA4B5B,OAAO,CAAC,YAAY;IAQd,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuClF,6BAA6B;IAU7B,KAAK,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,KAAK,GAAE,OAAO,EAAM,EAAE,IAAI,SAAI;IAanD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,SAAG;IAehE,MAAM,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,OAAO,EAAE,EAAE,IAAI,SAAG;IAgB5C,MAAM,CAAC,CAAC,EAAG,GAAG,EAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,SAAG;IAYhD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAG;IAUjC,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;IAGlC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAG/F,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,MAAM;;;;IAYzL,cAAc;IAOd,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAmBtD"}

package/dist/drivers/SQLite.d.ts

@@ -15,8 +15,10 @@ export declare class SQLiteDB implements Database {
     db: InstanceType<typeof SQLite>;
     idSystem: IDSystem;
     logger: DatabaseLogger;
+    supportsSelectForUpdate: boolean;
     constructor(file?: string, options?: SQLiteDBOptions | undefined);
     open(): Promise<void>;
+    setupInternalComputationState(): Promise<void>;
     query<T>(sql: string, where?: unknown[], name?: string): Promise<T[]>;
     update(sql: string, values: unknown[], idField?: string, name?: string): Promise<EntityIdRef[]>;
     insert(sql: string, values: unknown[], name?: string): Promise<EntityIdRef>;

package/dist/drivers/SQLite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SQLite.d.ts","sourceRoot":"","sources":["../../src/drivers/SQLite.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAA4E,MAAM,UAAU,CAAC;AAE1I,cAAM,QAAQ;IACS,EAAE,EAAE,QAAQ;gBAAZ,EAAE,EAAE,QAAQ;IAC/B,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;CAWrC;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAA;AAEvF,qBAAa,QAAS,YAAW,QAAQ;IAIlB,IAAI,EAAC,MAAM;IAAsB,OAAO,CAAC,EAAE,eAAe;IAH7E,EAAE,EAAG,YAAY,CAAC,OAAO,MAAM,CAAC,CAAA;IAChC,QAAQ,EAAG,QAAQ,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;gBACH,IAAI,GAAC,MAAmB,EAAS,OAAO,CAAC,EAAE,eAAe,YAAA;IAIvE,IAAI;IAIJ,KAAK,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,KAAK,GAAE,OAAO,EAAM,EAAE,IAAI,SAAI;IAanD,MAAM,CAAC,GAAG,EAAC,MAAM,EAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,SAAG;IAe7D,MAAM,CAAE,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,OAAO,EAAE,EAAE,IAAI,SAAG;IAc7C,MAAM,CAAC,CAAC,EAAG,GAAG,EAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,SAAG;IAYhD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAG;IAU3B,KAAK;IAGL,SAAS,CAAC,UAAU,EAAE,MAAM;IAGlC,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,MAAM;;;;IAczL,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAmBtD"}
+{"version":3,"file":"SQLite.d.ts","sourceRoot":"","sources":["../../src/drivers/SQLite.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAA4E,MAAM,UAAU,CAAC;AAE1I,cAAM,QAAQ;IACS,EAAE,EAAE,QAAQ;gBAAZ,EAAE,EAAE,QAAQ;IAC/B,KAAK;IAGC,SAAS,CAAC,UAAU,EAAE,MAAM;CAWrC;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAA;AAEvF,qBAAa,QAAS,YAAW,QAAQ;IAKlB,IAAI,EAAC,MAAM;IAAsB,OAAO,CAAC,EAAE,eAAe;IAJ7E,EAAE,EAAG,YAAY,CAAC,OAAO,MAAM,CAAC,CAAA;IAChC,QAAQ,EAAG,QAAQ,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;IACtB,uBAAuB,UAAQ;gBACZ,IAAI,GAAC,MAAmB,EAAS,OAAO,CAAC,EAAE,eAAe,YAAA;IAIvE,IAAI;IAIJ,6BAA6B;IAU7B,KAAK,CAAC,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,KAAK,GAAE,OAAO,EAAM,EAAE,IAAI,SAAI;IAanD,MAAM,CAAC,GAAG,EAAC,MAAM,EAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,SAAG;IAe7D,MAAM,CAAE,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,OAAO,EAAE,EAAE,IAAI,SAAG;IAc7C,MAAM,CAAC,CAAC,EAAG,GAAG,EAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,SAAG;IAYhD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAG;IAU3B,KAAK;IAGL,SAAS,CAAC,UAAU,EAAE,MAAM;IAGlC,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,MAAM;;;;IAczL,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;CAmBtD"}