@t4h.framework/core 0.0.0-experimental-c0d4325

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tech four humans
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,336 @@
+# @t4h.framework/core
+
+Core primitives for modeling automation workflows and activities.
+
+## Concepts
+
+- **Workflow** -- business logic abstraction. The workflow author focuses on orchestration and rules, not infrastructure. It composes Activities to get work done.
+- **Activity** -- pre-defined systemic unit of work. Activities define _what_ operations are available (HTTP request, save file, query DB) with a structured lifecycle. The activity author defines the contract; the runtime fulfills it.
+- **Claim** -- the bridge between an activity and the runtime. An activity declares what it needs (e.g. a file storage accessor, an HTTP client) as abstract dependencies. The runtime provides concrete implementations when executing.
+
+```mermaid
+flowchart LR
+  Workflow -->|"composes"| Activity
+  Activity -->|"declares"| Claim
+  Runtime -->|"provides"| Claim
+  Runtime -->|"executes with env, history, claims"| Workflow
+  Runtime -->|"executes with env, claims"| Activity
+```
+
+---
+
+## Creating a Workflow
+
+A workflow is a function that orchestrates activities and business logic.
+
+### Simple workflow (no validation)
+
+```javascript
+import { Workflow } from '@t4h.framework/core'
+
+const myWorkflow = new Workflow(async () => {
+  // orchestration here
+  return { ok: true }
+})
+```
+
+### Workflow with id and description
+
+```javascript
+const myWorkflow = new Workflow(
+  { id: 'cashback/v1', description: 'Process cashback' },
+  async input => {
+    return { value: input.amount * 0.05 }
+  },
+)
+```
+
+### Workflow with JSON Schema validation
+
+The `schema` field accepts any valid JSON Schema.
+
+```javascript
+const myWorkflow = new Workflow(
+  {
+    id: 'cashback/v1',
+    schema: {
+      type: 'object',
+      properties: {
+        userId: { type: 'string' },
+        amount: { type: 'number' },
+      },
+      required: ['userId', 'amount'],
+    },
+  },
+  async input => {
+    // input is validated: { userId: string, amount: number }
+    return { value: input.amount * 0.05 }
+  },
+)
+```
+
+You can also use libraries like [TypeBox](https://github.com/sinclairzx81/typebox) to generate the schema with type inference:
+
+```typescript
+import Type from 'typebox'
+
+const schema = Type.Object({
+  userId: Type.String(),
+  amount: Type.Number(),
+})
+
+const myWorkflow = new Workflow({ id: 'cashback/v1', schema }, async input => {
+  return { value: input.amount * 0.05 }
+})
+```
+
+### Using environment variables
+
+```javascript
+import { Workflow, env } from '@t4h.framework/core'
+
+const myWorkflow = new Workflow({ id: 'notify/v1' }, async () => {
+  console.log(env.API_URL)
+  console.log(env.API_SECRET)
+})
+```
+
+### Registering workflows in an App
+
+```javascript
+import { App, Workflow } from '@t4h.framework/core'
+
+const app = new App({
+  id: 'my-automation',
+  description: 'Cashback automation',
+  workflows: [myWorkflow],
+})
+
+// or add later
+app.addWorkflow(anotherWorkflow)
+```
+
+---
+
+## Creating Activities
+
+Activities are reusable units of work. There are two types: `SyncActivity` (synchronous) and `AsyncActivity` (long-running).
+
+Each activity method runs in a specific context:
+
+**SyncActivity lifecycle:**
+
+```mermaid
+flowchart LR
+  subgraph core [Core]
+    toInput["toInput"]
+    toOutput["toOutput"]
+  end
+  subgraph runtime [Runtime]
+    run["run"]
+  end
+  toInput --> run --> toOutput
+```
+
+- `toInput` -- core context, little or no claim dependency. Converts designer arguments into serializable input.
+- `run` -- runtime context, strong claim dependency. Performs the actual work.
+- `toOutput` -- core context, no claim dependency. Transforms the raw result back for the designer.
+
+**AsyncActivity lifecycle:**
+
+```mermaid
+flowchart LR
+  subgraph core [Core]
+    toInput["toInput"]
+    toOutput["toOutput"]
+  end
+  subgraph runtime [Runtime]
+    bootstrap["bootstrap"]
+    advance["advance"]
+  end
+  toInput --> bootstrap --> advance --> toOutput
+```
+
+- `toInput` -- same as sync.
+- `bootstrap` -- runtime context, starts the long-running operation and returns a `AsyncActivityAdvanceResultPending`.
+- `advance` -- runtime context, called when an external event resumes the activity. It returns one of:
+  - `AsyncActivityAdvanceResultPending` (still waiting),
+  - `AsyncActivityAdvanceResultFulfilled` (completed),
+  - `AsyncActivityAdvanceResultRejected` (failed).
+- `toOutput` -- same as sync.
+
+### SyncActivity
+
+```typescript
+import { SyncActivity } from '@t4h.framework/core'
+
+class CalculateCashbackActivity extends SyncActivity<
+  [transaction: { amount: number }], // designer arguments
+  { amount: number }, // serializable input
+  number // designer output
+> {
+  public async toInput(transaction: { amount: number }) {
+    return { amount: transaction.amount }
+  }
+
+  public run(input: { amount: number }) {
+    return Math.floor(input.amount * 0.05)
+  }
+
+  public toOutput(output: number) {
+    return output
+  }
+}
+```
+
+### AsyncActivity
+
+For long-running operations that need a bootstrap/advance cycle (e.g. waiting for human approval, external webhook).
+
+```typescript
+import Type from 'typebox'
+import {
+  AsyncActivity,
+  AsyncActivityAdvanceResultFulfilled,
+  AsyncActivityAdvanceResultPending,
+  AsyncActivityAdvanceResultRejected,
+} from '@t4h.framework/core'
+
+const ApprovalSchema = Type.Object({
+  approved: Type.Boolean(),
+})
+
+class WaitForApprovalActivity extends AsyncActivity<
+  [orderId: string],
+  { orderId: string },
+  { approved: boolean },
+  { requestId: string; orderId: string },
+  typeof ApprovalSchema
+> {
+  public async toInput(orderId: string) {
+    return { orderId }
+  }
+
+  public async bootstrap(input: { orderId: string }) {
+    // triggers the approval request and stores correlation data
+    return new AsyncActivityAdvanceResultPending({
+      output: {
+        requestId: 'req-123',
+        orderId: input.orderId,
+      },
+      schema: ApprovalSchema,
+    })
+  }
+
+  public async advance(
+    payload: Type.Static<typeof ApprovalSchema>,
+    bootstrap: AsyncActivityAdvanceResultPending<{
+      requestId: string
+      orderId: string
+    }>,
+  ) {
+    if (payload.approved) {
+      return new AsyncActivityAdvanceResultFulfilled({
+        approved: true,
+      })
+    }
+
+    return new AsyncActivityAdvanceResultRejected({
+      approved: false,
+      requestId: bootstrap.output?.requestId,
+    })
+  }
+
+  public toOutput(output: { approved: boolean }) {
+    return output
+  }
+}
+```
+
+### Activities with Claims (dependencies)
+
+A Claim is an abstract dependency that an Activity declares. For example, an activity that saves files declares it needs a "file storage" claim -- it doesn't know whether the implementation uses S3, local disk, or anything else. The runtime must provide a concrete implementation for each declared claim via `ClaimProvider`. This decouples the activity definition from the infrastructure.
+
+```typescript
+import { SyncActivity, Claim } from '@t4h.framework/core'
+
+abstract class UserRepositoryClaim {
+  abstract findById(id: string): Promise<any>
+}
+
+class FetchUserActivity extends SyncActivity<
+  [id: string],
+  { id: string },
+  any
+> {
+  private readonly claims = new Claim({
+    repo: UserRepositoryClaim,
+  })
+
+  public async toInput(id: string) {
+    return { id }
+  }
+
+  public async run(input: { id: string }) {
+    return await this.claims.repo.findById(input.id)
+  }
+
+  public toOutput(output: any) {
+    return output
+  }
+}
+```
+
+---
+
+## Runtime Execution
+
+The runtime is responsible for executing workflows and activities by providing the necessary context (env, claims, history).
+
+### Running a Workflow
+
+```typescript
+import { Internals } from '@t4h.framework/core'
+
+Internals.runWorkflow(myWorkflow, {
+  input: { userId: '123', amount: 100 },
+  env: { API_URL: 'https://api.example.com' },
+  claims: [
+    { provide: UserRepositoryClaim, value: new UserRepositoryClaimImpl() },
+  ],
+  history: [],
+})
+```
+
+### Running an Activity
+
+```typescript
+Internals.runActivity(
+  FetchUserActivity,
+  {
+    env: { API_URL: 'https://api.example.com' },
+    claims: [
+      { provide: UserRepositoryClaim, value: new UserRepositoryClaimImpl() },
+    ],
+  },
+  activity => {
+    return activity.run({ id: '123' })
+  },
+)
+```
+
+### How it works internally
+
+`runWorkflow` composes three context layers via `AsyncLocalStorage`:
+
+```
+Env.run → Claim.run → History.run → workflow.fn(input)
+```
+
+`runActivity` composes two:
+
+```
+Env.run → Claim.run → fn(activity)
+```
+
+**History** handles reconciliation: when an activity has been executed before, the previous result is returned directly (deterministic replay). When there is no history, the activity runs and the result is stored.

package/dist/activities/StartWorkflowActivity.d.ts

@@ -0,0 +1,21 @@
+import { Claim } from '../models/Claim.js';
+import { SyncActivity } from '../models/SyncActivity.js';
+import type { Workflow, WorkflowInput } from '../models/Workflow.js';
+import { WorkflowRef } from '../models/WorkflowRef.js';
+import type { Serializable } from '../typings/Serializable.js';
+export declare abstract class WorkflowClaim {
+    abstract start<TWorkflow extends Workflow<any, any>>(workflow: TWorkflow, input: WorkflowInput<TWorkflow>): Serializable | Promise<Serializable>;
+}
+export declare class StartWorkflowActivity extends SyncActivity<[
+    workflow: Workflow,
+    input: any
+], Serializable, Serializable, WorkflowRef> {
+    readonly claims: Claim<{
+        workflow: typeof WorkflowClaim;
+    }>;
+    toInput(workflow: Workflow<any, any>, input: any): Promise<Serializable>;
+    run(payload: Serializable): Serializable;
+    toOutput(payload: Serializable): WorkflowRef;
+}
+export declare function startWorkflow<TWorkflow extends Workflow<any, any>>(workflow: TWorkflow, input: WorkflowInput<TWorkflow>): Promise<WorkflowRef>;
+//# sourceMappingURL=StartWorkflowActivity.d.ts.map

package/dist/activities/StartWorkflowActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartWorkflowActivity.d.ts","sourceRoot":"","sources":["../../src/activities/StartWorkflowActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,8BAAsB,aAAa;aACjB,KAAK,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACxD,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CACxC;AAED,qBAAa,qBAAsB,SAAQ,YAAY,CACrD;IAAC,QAAQ,EAAE,QAAQ;IAAE,KAAK,EAAE,GAAG;CAAC,EAChC,YAAY,EACZ,YAAY,EACZ,WAAW,CACZ;IACC,SAAgB,MAAM;;OAEpB;IAEW,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG;IAItD,GAAG,CAAC,OAAO,EAAE,YAAY;IAIzB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;CAGpD;AAED,wBAAgB,aAAa,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAChE,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,wBAGhC"}

package/dist/activities/StartWorkflowActivity.js

@@ -0,0 +1,24 @@
+import { Claim } from '../models/Claim.js';
+import { History } from '../models/History.js';
+import { SyncActivity } from '../models/SyncActivity.js';
+import { WorkflowRef } from '../models/WorkflowRef.js';
+export class WorkflowClaim {
+}
+export class StartWorkflowActivity extends SyncActivity {
+    claims = new Claim({
+        workflow: WorkflowClaim,
+    });
+    async toInput(workflow, input) {
+        return await this.claims.workflow.start(workflow, input);
+    }
+    run(payload) {
+        return payload;
+    }
+    toOutput(payload) {
+        return new WorkflowRef(payload);
+    }
+}
+export function startWorkflow(workflow, input) {
+    return History.reconciler(StartWorkflowActivity, workflow, input);
+}
+//# sourceMappingURL=StartWorkflowActivity.js.map

package/dist/activities/StartWorkflowActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartWorkflowActivity.js","sourceRoot":"","sources":["../../src/activities/StartWorkflowActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAGtD,MAAM,OAAgB,aAAa;CAKlC;AAED,MAAM,OAAO,qBAAsB,SAAQ,YAK1C;IACiB,MAAM,GAAG,IAAI,KAAK,CAAC;QACjC,QAAQ,EAAE,aAAa;KACxB,CAAC,CAAA;IAEK,KAAK,CAAC,OAAO,CAAC,QAA4B,EAAE,KAAU;QAC3D,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC1D,CAAC;IAEM,GAAG,CAAC,OAAqB;QAC9B,OAAO,OAAO,CAAA;IAChB,CAAC;IAEM,QAAQ,CAAC,OAAqB;QACnC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAC3B,QAAmB,EACnB,KAA+B;IAE/B,OAAO,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;AACnE,CAAC"}

package/dist/core.d.ts

@@ -0,0 +1,23 @@
+export * from './activities/StartWorkflowActivity.js';
+export * from './exceptions/ActivityException.js';
+export * from './exceptions/ClaimException.js';
+export * from './models/Activity.js';
+export * from './models/App.js';
+export * from './models/AsyncActivity.js';
+export * from './models/AsyncActivityAdvanceResult.js';
+export * from './models/AsyncActivityAwaitable.js';
+export * from './models/Binary.js';
+export * from './models/Claim.js';
+export * from './models/Env.js';
+export * from './models/EnvDesign.js';
+export * from './models/History.js';
+export * from './models/PushActivity.js';
+export * from './models/PushWaitAsyncActivity.js';
+export * from './models/SerializableHelper.js';
+export * from './models/SyncActivity.js';
+export * from './models/Workflow.js';
+export * from './models/WorkflowRef.js';
+export * from './tools/Internals.js';
+export * from './typings/PromiseLikeType.js';
+export * from './typings/Serializable.js';
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}

package/dist/core.js

@@ -0,0 +1,23 @@
+export * from './activities/StartWorkflowActivity.js';
+export * from './exceptions/ActivityException.js';
+export * from './exceptions/ClaimException.js';
+export * from './models/Activity.js';
+export * from './models/App.js';
+export * from './models/AsyncActivity.js';
+export * from './models/AsyncActivityAdvanceResult.js';
+export * from './models/AsyncActivityAwaitable.js';
+export * from './models/Binary.js';
+export * from './models/Claim.js';
+export * from './models/Env.js';
+export * from './models/EnvDesign.js';
+export * from './models/History.js';
+export * from './models/PushActivity.js';
+export * from './models/PushWaitAsyncActivity.js';
+export * from './models/SerializableHelper.js';
+export * from './models/SyncActivity.js';
+export * from './models/Workflow.js';
+export * from './models/WorkflowRef.js';
+export * from './tools/Internals.js';
+export * from './typings/PromiseLikeType.js';
+export * from './typings/Serializable.js';
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}

package/dist/exceptions/ActivityException.d.ts

@@ -0,0 +1,7 @@
+export interface ActivityExceptionOptions extends ErrorOptions {
+    isRetriable?: boolean;
+}
+export declare class ActivityException extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=ActivityException.d.ts.map

package/dist/exceptions/ActivityException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityException.d.ts","sourceRoot":"","sources":["../../src/exceptions/ActivityException.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAG3D"}

package/dist/exceptions/ActivityException.js

@@ -0,0 +1,6 @@
+export class ActivityException extends Error {
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+//# sourceMappingURL=ActivityException.js.map

package/dist/exceptions/ActivityException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityException.js","sourceRoot":"","sources":["../../src/exceptions/ActivityException.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAmB,OAAe,EAAE,OAAsB;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF"}

package/dist/exceptions/ClaimException.d.ts

@@ -0,0 +1,20 @@
+export declare class ClaimException extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ClaimKeyNotFoundException extends ClaimException {
+    readonly key: string | symbol;
+    constructor(key: string | symbol);
+}
+export declare class ClaimConstructorNotFoundException extends ClaimException {
+    readonly key: string | symbol;
+    constructor(key: string | symbol);
+}
+export declare class ClaimStorageNotActiveException extends ClaimException {
+    constructor();
+}
+export declare class ClaimProviderNotFoundException extends ClaimException {
+    readonly key: string | symbol;
+    readonly constructorName: string;
+    constructor(constructorName: string, key: string | symbol);
+}
+//# sourceMappingURL=ClaimException.d.ts.map

package/dist/exceptions/ClaimException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimException.d.ts","sourceRoot":"","sources":["../../src/exceptions/ClaimException.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;gBACpB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAG3D;AAED,qBAAa,yBAA0B,SAAQ,cAAc;IAC3D,SAAgB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;gBAEjB,GAAG,EAAE,MAAM,GAAG,MAAM;CAIxC;AAED,qBAAa,iCAAkC,SAAQ,cAAc;IACnE,SAAgB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;gBAEjB,GAAG,EAAE,MAAM,GAAG,MAAM;CAIxC;AAED,qBAAa,8BAA+B,SAAQ,cAAc;;CAMjE;AAED,qBAAa,8BAA+B,SAAQ,cAAc;IAChE,SAAgB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IACpC,SAAgB,eAAe,EAAE,MAAM,CAAA;gBAEpB,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAOjE"}

package/dist/exceptions/ClaimException.js

@@ -0,0 +1,34 @@
+export class ClaimException extends Error {
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+export class ClaimKeyNotFoundException extends ClaimException {
+    key;
+    constructor(key) {
+        super(`Claim key "${key.toString()}" is not mapped`);
+        this.key = key;
+    }
+}
+export class ClaimConstructorNotFoundException extends ClaimException {
+    key;
+    constructor(key) {
+        super(`No constructor mapped for claim key "${key.toString()}"`);
+        this.key = key;
+    }
+}
+export class ClaimStorageNotActiveException extends ClaimException {
+    constructor() {
+        super('Claim storage is not active. Ensure you are inside an Claim.run() context');
+    }
+}
+export class ClaimProviderNotFoundException extends ClaimException {
+    key;
+    constructorName;
+    constructor(constructorName, key) {
+        super(`No provider for "${constructorName}" found for claim key "${key.toString()}"`);
+        this.constructorName = constructorName;
+        this.key = key;
+    }
+}
+//# sourceMappingURL=ClaimException.js.map

package/dist/exceptions/ClaimException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimException.js","sourceRoot":"","sources":["../../src/exceptions/ClaimException.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAmB,OAAe,EAAE,OAAsB;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,cAAc;IAC3C,GAAG,CAAiB;IAEpC,YAAmB,GAAoB;QACrC,KAAK,CAAC,cAAc,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAA;QACpD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,cAAc;IACnD,GAAG,CAAiB;IAEpC,YAAmB,GAAoB;QACrC,KAAK,CAAC,wCAAwC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;QAChE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,cAAc;IAChE;QACE,KAAK,CACH,2EAA2E,CAC5E,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,cAAc;IAChD,GAAG,CAAiB;IACpB,eAAe,CAAQ;IAEvC,YAAmB,eAAuB,EAAE,GAAoB;QAC9D,KAAK,CACH,oBAAoB,eAAe,0BAA0B,GAAG,CAAC,QAAQ,EAAE,GAAG,CAC/E,CAAA;QACD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAA;QACtC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;CACF"}

package/dist/models/Activity.d.ts

@@ -0,0 +1,13 @@
+import { AsyncActivity } from './AsyncActivity.js';
+import type { SyncActivity } from './SyncActivity.js';
+import type { Serializable } from '../typings/Serializable.js';
+export type AnyActivity = Activity<readonly any[], any, any, any>;
+export type Activity<TArgs extends readonly any[] = readonly any[], TInput extends Serializable = any, TSerializableOutput extends Serializable = any, TOutput = any> = AsyncActivity<TArgs, TInput, TSerializableOutput, TOutput, any, any> | SyncActivity<TArgs, TInput, TSerializableOutput, TOutput>;
+export type ActivityConstructor<T extends Activity> = new () => T;
+export declare namespace Activity {
+    type Constructor<T extends Activity> = new () => T;
+    type Args<T extends Activity> = T extends Activity<infer TArgs> ? Exclude<TArgs, []> : never;
+    type Input<T extends Activity> = T extends Activity<any, infer TInput> ? TInput : never;
+    type Output<T extends Activity> = T extends Activity<any, any, any, infer TOutput> ? TOutput : never;
+}
+//# sourceMappingURL=Activity.d.ts.map

package/dist/models/Activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../src/models/Activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAEjE,MAAM,MAAM,QAAQ,CAClB,KAAK,SAAS,SAAS,GAAG,EAAE,GAAG,SAAS,GAAG,EAAE,EAC7C,MAAM,SAAS,YAAY,GAAG,GAAG,EACjC,mBAAmB,SAAS,YAAY,GAAG,GAAG,EAC9C,OAAO,GAAG,GAAG,IAEX,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GACpE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAA;AAE7D,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,IAAI,UAAU,CAAC,CAAA;AAEjE,yBAAiB,QAAQ,CAAC;IACxB,KAAY,WAAW,CAAC,CAAC,SAAS,QAAQ,IAAI,UAAU,CAAC,CAAA;IAEzD,KAAY,IAAI,CAAC,CAAC,SAAS,QAAQ,IACjC,CAAC,SAAS,QAAQ,CAAC,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAA;IAE9D,KAAY,KAAK,CAAC,CAAC,SAAS,QAAQ,IAClC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;IAExD,KAAY,MAAM,CAAC,CAAC,SAAS,QAAQ,IACnC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,GAAG,OAAO,GAAG,KAAK,CAAA;CACrE"}

package/dist/models/Activity.js

@@ -0,0 +1,2 @@
+import { AsyncActivity } from './AsyncActivity.js';
+//# sourceMappingURL=Activity.js.map

package/dist/models/Activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Activity.js","sourceRoot":"","sources":["../../src/models/Activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/models/ActivityClaim.d.ts

@@ -0,0 +1,15 @@
+export type ActivityClaimMap = Record<keyof any, abstract new (...args: readonly any[]) => any>;
+export type ClaimProvider<T> = {
+    provide: abstract new (...args: readonly any[]) => any;
+    value: T;
+};
+export type ActivityClaim<TMap extends ActivityClaimMap> = {
+    [K in keyof TMap]: InstanceType<TMap[K]>;
+};
+export interface ActivityClaimConstructor {
+    new <TMap extends ActivityClaimMap>(map: TMap): ActivityClaim<TMap>;
+    run<T>(claims: readonly ClaimProvider<any>[], fn: () => T): T;
+    getClaims(): readonly ClaimProvider<any>[];
+}
+export declare const ActivityClaim: ActivityClaimConstructor;
+//# sourceMappingURL=ActivityClaim.d.ts.map

package/dist/models/ActivityClaim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityClaim.d.ts","sourceRoot":"","sources":["../../src/models/ActivityClaim.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG,MAAM,CACnC,MAAM,GAAG,EACT,QAAQ,MAAM,GAAG,IAAI,EAAE,SAAS,GAAG,EAAE,KAAK,GAAG,CAC9C,CAAA;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,OAAO,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,SAAS,GAAG,EAAE,KAAK,GAAG,CAAA;IACtD,KAAK,EAAE,CAAC,CAAA;CACT,CAAA;AAED,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,gBAAgB,IAAI;KACxD,CAAC,IAAI,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACzC,CAAA;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,IAAI,SAAS,gBAAgB,EAAE,GAAG,EAAE,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IACnE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IAC7D,SAAS,IAAI,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;CAC3C;AAED,eAAO,MAAM,aAAa,EAqCV,wBAAwB,CAAA"}

package/dist/models/ActivityClaim.js

@@ -0,0 +1,33 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { ClaimConstructorNotFoundException, ClaimKeyNotFoundException, ClaimProviderNotFoundException, ClaimStorageNotActiveException, } from '../exceptions/ClaimException.js';
+export const ActivityClaim = function (map) {
+    return new Proxy({}, {
+        get(target, propertyKey) {
+            if (!(propertyKey in map))
+                throw new ClaimKeyNotFoundException(propertyKey);
+            if (!map[propertyKey])
+                throw new ClaimConstructorNotFoundException(propertyKey);
+            const store = storage.getStore();
+            if (!store)
+                throw new ClaimStorageNotActiveException();
+            const { providers: claims, cache } = store;
+            if (cache.has(propertyKey))
+                return cache.get(propertyKey);
+            const constructor = map[propertyKey];
+            const claimProvider = claims.find(claim => claim.provide === constructor);
+            if (!claimProvider)
+                throw new ClaimProviderNotFoundException(constructor.name, propertyKey);
+            cache.set(propertyKey, claimProvider.value);
+            return claimProvider.value;
+        },
+    });
+};
+ActivityClaim.run = (claims, fn) => storage.run({ providers: claims, cache: new Map() }, fn);
+ActivityClaim.getClaims = () => {
+    const store = storage.getStore();
+    if (!store)
+        throw new ClaimStorageNotActiveException();
+    return store.providers;
+};
+const storage = new AsyncLocalStorage();
+//# sourceMappingURL=ActivityClaim.js.map

package/dist/models/ActivityClaim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityClaim.js","sourceRoot":"","sources":["../../src/models/ActivityClaim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,iCAAiC,CAAA;AAsBxC,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,GAAqB;IAC1D,OAAO,IAAI,KAAK,CACd,EAAE,EACF;QACE,GAAG,CAAC,MAAM,EAAE,WAAW;YACrB,IAAI,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC;gBACvB,MAAM,IAAI,yBAAyB,CAAC,WAAW,CAAC,CAAA;YAElD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;gBACnB,MAAM,IAAI,iCAAiC,CAAC,WAAW,CAAC,CAAA;YAE1D,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;YAEhC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,8BAA8B,EAAE,CAAA;YAEtD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;YAE1C,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAE,CAAA;YAE1D,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC,CAAA;YAEpC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAC/B,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,WAAW,CACvC,CAAA;YAED,IAAI,CAAC,aAAa;gBAChB,MAAM,IAAI,8BAA8B,CACtC,WAAW,CAAC,IAAI,EAChB,WAAW,CACZ,CAAA;YAEH,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;YAE3C,OAAO,aAAa,CAAC,KAAK,CAAA;QAC5B,CAAC;KACF,CAC+B,CAAA;AACpC,CAAwC,CAAA;AAExC,aAAa,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CACjC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;AAE1D,aAAa,CAAC,SAAS,GAAG,GAAG,EAAE;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;IAEhC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,8BAA8B,EAAE,CAAA;IAEtD,OAAO,KAAK,CAAC,SAAS,CAAA;AACxB,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAGjC,CAAA"}

package/dist/models/ActivityHistory.d.ts

@@ -0,0 +1,15 @@
+import type { Activity } from './Activity.js';
+export interface IActivityHistory {
+    output: any;
+}
+export declare class PushActivity<T extends Activity> {
+    readonly activity: T;
+    readonly input: Activity.Input<T>;
+    constructor(activity: T, input: Activity.Input<T>);
+}
+export declare namespace ActivityHistory {
+    function bind<T extends Activity>(Activity: new () => T): (...args: Activity.Args<T>) => Promise<Activity.Output<T>>;
+    function reconciler<T extends Activity>(Activity: new () => T, ...args: Activity.Args<T>): Promise<Activity.Output<T>>;
+    function run<T>(history: readonly IActivityHistory[], fn: () => T): T;
+}
+//# sourceMappingURL=ActivityHistory.d.ts.map