@versori/run 0.3.0-beta.6 → 0.3.0-beta.7

package/esm/mod.d.ts

@@ -1,3 +1,68 @@
+/**
+ * The Versori Run SDK is the backbone of the Versori AI integration platform. It provides a set of tools and
+ * abstractions for building integrations which can run in the cloud on Versori's infrastructure.
+ *
+ * # Getting Started
+ *
+ * First off, it's worth being familiar with the Versori AI platform, and understanding how Connectors, Connections
+ * and Projects fit together to make up an integration. This information is available on our primary documentation site,
+ * [Versori User Documentation](https://docs.versori.com).
+ *
+ * Our in-platform AI helps you build and test your integrations, and then deploy them to the cloud, however sometimes
+ * AI falls short and you may need to understand the underlying code to debug or extend your integrations; this is where
+ * this documentation comes in.
+ *
+ * # Structure of an integration
+ *
+ * An integration is made up of a {@linkcode Trigger} and one or more {@linkcode Task},
+ * to form a {@linkcode Workflow}. There are two main types of triggers, {@link schedule} and
+ * {@link webhook}, and two main types of tasks, {@link fn} and {@link http}.
+ *
+ * A simple integration might look like this:
+ *
+ * @example Make an authenticated request to httpbin.org every minute
+ *
+ * ```typescript
+ * import { fn, http, schedule, MemoryInterpreter } from '@versori/run';
+ *
+ * const workflow = schedule('every-minute', '* * * * *')
+ *     .then(
+ *         fn('log', (ctx) => {
+ *             ctx.log.debug('Hello, world!');
+ *
+ *             return 42;
+ *         })
+ *     )
+ *     .then(
+ *         http('httpbin', { connection: 'httpbin' }, async ({ fetch, log }) => {
+ *             // The `fetch` implementation passed on the context object is already authenticated and configured to
+ *             // prepend the base URL to the final request based on how the connection is configured from the Versori
+ *             // platform.
+ *             const resp = await fetch('/headers');
+ *
+ *             log.debug('response', { resp });
+ *
+ *             return resp.json();
+ *         })
+ *     );
+ *
+ * async function main(): Promise<void> {
+ *     const interpreter = new MemoryInterpreter();
+ *
+ *     interpreter.register(workflow);
+ *
+ *     await interpreter.start();
+ * }
+ *
+ * main().catch((err) => {
+ *     console.error('Failed to run workflow', err);
+ * });
+ * ```
+ *
+ * @module
+ */
 import "./_dnt.polyfills.js";
-export * from './src/mod.js';
+export * from './src/dsl/mod.js';
+export { durable, ExecutionError, MemoryInterpreter, type MemoryInterpreterOptions, } from './src/interpreter/mod.js';
+export * from './src/context/mod.js';
 //# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,OAAO,qBAAqB,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACH,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,KAAK,wBAAwB,GAChC,MAAM,0BAA0B,CAAC;AAClC,cAAc,sBAAsB,CAAC"}

package/esm/mod.js

@@ -1,2 +1,79 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
+/**
+ * The Versori Run SDK is the backbone of the Versori AI integration platform. It provides a set of tools and
+ * abstractions for building integrations which can run in the cloud on Versori's infrastructure.
+ *
+ * # Getting Started
+ *
+ * First off, it's worth being familiar with the Versori AI platform, and understanding how Connectors, Connections
+ * and Projects fit together to make up an integration. This information is available on our primary documentation site,
+ * [Versori User Documentation](https://docs.versori.com).
+ *
+ * Our in-platform AI helps you build and test your integrations, and then deploy them to the cloud, however sometimes
+ * AI falls short and you may need to understand the underlying code to debug or extend your integrations; this is where
+ * this documentation comes in.
+ *
+ * # Structure of an integration
+ *
+ * An integration is made up of a {@linkcode Trigger} and one or more {@linkcode Task},
+ * to form a {@linkcode Workflow}. There are two main types of triggers, {@link schedule} and
+ * {@link webhook}, and two main types of tasks, {@link fn} and {@link http}.
+ *
+ * A simple integration might look like this:
+ *
+ * @example Make an authenticated request to httpbin.org every minute
+ *
+ * ```typescript
+ * import { fn, http, schedule, MemoryInterpreter } from '@versori/run';
+ *
+ * const workflow = schedule('every-minute', '* * * * *')
+ *     .then(
+ *         fn('log', (ctx) => {
+ *             ctx.log.debug('Hello, world!');
+ *
+ *             return 42;
+ *         })
+ *     )
+ *     .then(
+ *         http('httpbin', { connection: 'httpbin' }, async ({ fetch, log }) => {
+ *             // The `fetch` implementation passed on the context object is already authenticated and configured to
+ *             // prepend the base URL to the final request based on how the connection is configured from the Versori
+ *             // platform.
+ *             const resp = await fetch('/headers');
+ *
+ *             log.debug('response', { resp });
+ *
+ *             return resp.json();
+ *         })
+ *     );
+ *
+ * async function main(): Promise<void> {
+ *     const interpreter = new MemoryInterpreter();
+ *
+ *     interpreter.register(workflow);
+ *
+ *     await interpreter.start();
+ * }
+ *
+ * main().catch((err) => {
+ *     console.error('Failed to run workflow', err);
+ * });
+ * ```
+ *
+ * @module
+ */
 import "./_dnt.polyfills.js";
-export * from './src/mod.js';
+export * from './src/dsl/mod.js';
+export { durable, ExecutionError, MemoryInterpreter, } from './src/interpreter/mod.js';
+export * from './src/context/mod.js';

package/esm/src/connection/DirectConnectionFactory.d.ts

@@ -1,7 +1,7 @@
 import { Client } from '@connectrpc/connect';
 import { RequestHandler } from 'express';
 import { Logger } from '../observability/mod.js';
-import { credentialv1alpha1, tokensv1, oauth1v1 } from '../services/credentials/mod.js';
+import { credentialv1alpha1, oauth1v1, tokensv1 } from '../services/credentials/mod.js';
 import { Connection } from '../services/platform/mod.js';
 import { HttpClientFactory } from './internal/HttpClientFactory.js';
 import { ConnectionFactory, FetchLike } from './types.js';

package/esm/src/connection/DirectConnectionFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirectConnectionFactory.d.ts","sourceRoot":"","sources":["../../../src/src/connection/DirectConnectionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG1D;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAKzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAR3B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA4B;IACtE,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAA2B;gBAGtD,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,MAAM,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,EAChE,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,EAC5C,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,EACpD,MAAM,EAAE,MAAM;IAkBnC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAI5C,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjD,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB;CAiB1D"}
+{"version":3,"file":"DirectConnectionFactory.d.ts","sourceRoot":"","sources":["../../../src/src/connection/DirectConnectionFactory.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG1D;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAKzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAR3B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA4B;IACtE,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAA2B;gBAGtD,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,MAAM,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,EAChE,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,EAC5C,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,EACpD,MAAM,EAAE,MAAM;IAkBnC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAI5C,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjD,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB;CAuB1D"}

package/esm/src/connection/DirectConnectionFactory.js

@@ -1,5 +1,17 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 import { createGrpcTransport } from '@connectrpc/connect-node';
-import { credentialv1alpha1, tokensv1, oauth1v1 } from '../services/credentials/mod.js';
+import { credentialv1alpha1, oauth1v1, tokensv1 } from '../services/credentials/mod.js';
 import { createConnectRpcClient } from '../services/createConnectRpcClient.js';
 import { HttpClientFactory } from './internal/HttpClientFactory.js';
 import { ExpressInboundConnectionFactory as InboundConnectionFactory } from './internal/InboundConnectionFactory.js';
@@ -70,9 +82,15 @@ export class DirectConnectionFactory {
     }
     static fromEnv(logger) {
         const baseUrl = Deno.env.get(envVarCredsBaseURL) || 'http://localhost:9000';
-        const credentials = createConnectRpcClient(credentialv1alpha1.CredentialService, () => { return createGrpcTransport({ baseUrl }); });
-        const tokens = createConnectRpcClient(tokensv1.TokenService, () => { return createGrpcTransport({ baseUrl }); });
-        const oauth1 = createConnectRpcClient(oauth1v1.AuthorizationService, () => { return createGrpcTransport({ baseUrl }); });
+        const credentials = createConnectRpcClient(credentialv1alpha1.CredentialService, () => {
+            return createGrpcTransport({ baseUrl });
+        });
+        const tokens = createConnectRpcClient(tokensv1.TokenService, () => {
+            return createGrpcTransport({ baseUrl });
+        });
+        const oauth1 = createConnectRpcClient(oauth1v1.AuthorizationService, () => {
+            return createGrpcTransport({ baseUrl });
+        });
         const httpClientFactory = new HttpClientFactory();
         return new DirectConnectionFactory(httpClientFactory, credentials, tokens, oauth1, logger);
     }

package/esm/src/connection/DynamicFetchFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicFetchFactory.d.ts","sourceRoot":"","sources":["../../../src/src/connection/DynamicFetchFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAc,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,mBAAoB,YAAW,wBAAwB;IAQ5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAVhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAE7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;gBAGpD,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM;IAOxC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAkB5C,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAQrD,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAiBvD,UAAU;IAMV;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;YAgBP,cAAc;CAY/B"}
+{"version":3,"file":"DynamicFetchFactory.d.ts","sourceRoot":"","sources":["../../../src/src/connection/DynamicFetchFactory.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAc,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,mBAAoB,YAAW,wBAAwB;IAQ5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAVhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAE7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;gBAGpD,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM;IAOxC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAkB5C,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAQrD,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAiBvD,UAAU;IAMV;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;YAgBP,cAAc;CAY/B"}

package/esm/src/connection/DynamicFetchFactory.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 import { LRUCache } from 'lru-cache';
 export class DynamicFetchFactory {
     constructor(factory, platformApi, organisationId, envSystemId) {

package/esm/src/connection/StaticFetchFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StaticFetchFactory.d.ts","sourceRoot":"","sources":["../../../src/src/connection/StaticFetchFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAMjE,qBAAa,kBAAmB,YAAW,wBAAwB;;gBAKnD,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,MAAW,EAAE,OAAO,CAAC,EAAE,cAAc;IAM5E,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAInD,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CAG3D"}
+{"version":3,"file":"StaticFetchFactory.d.ts","sourceRoot":"","sources":["../../../src/src/connection/StaticFetchFactory.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAyB,cAAc,EAAY,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAMjE,qBAAa,kBAAmB,YAAW,wBAAwB;;gBAKnD,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,MAAW,EAAE,OAAO,CAAC,EAAE,cAAc;IAM5E,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAInD,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CAG3D"}

package/esm/src/connection/StaticFetchFactory.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");

package/esm/src/connection/internal/CredentialHolder.d.ts

@@ -4,8 +4,8 @@ export declare function alwaysValid(): boolean;
  */
 export declare class CredentialHolder<T> {
     #private;
-    constructor(initialValue: T, isValid: (t: T) => boolean, refresh: () => Promise<T | undefined>);
+    constructor(initialValue: T, isValid: (t: T) => boolean, refresh: (force?: boolean) => Promise<T | undefined>);
     get(refresh?: boolean): Promise<T>;
-    refresh(): void;
+    refresh(_force?: boolean): void;
 }
 //# sourceMappingURL=CredentialHolder.d.ts.map

package/esm/src/connection/internal/CredentialHolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CredentialHolder.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/CredentialHolder.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,CAAC;;gBAOf,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAMxF,GAAG,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IA0B/C,OAAO,IAAI,IAAI;CAgClB"}
+{"version":3,"file":"CredentialHolder.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/CredentialHolder.ts"],"names":[],"mappings":"AAeA,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,CAAC;;gBAQvB,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,EAC1B,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAOlD,GAAG,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IA0B/C,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;CAgClC"}

package/esm/src/connection/internal/CredentialHolder.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -31,7 +43,7 @@ export class CredentialHolder {
             this.refresh();
             return __classPrivateFieldGet(this, _CredentialHolder_value, "f");
         }
-        // if this.refresh returns a rejected promise we are stuck with it until a restart. 
+        // if this.refresh returns a rejected promise we are stuck with it until a restart.
         // the try/catch bellow just keeps on trying to refresh the token if this.#value is rejected.
         //
         // We might have to change this because if credentials has an issue we might just make that issue worse by pamming more requests
@@ -48,7 +60,7 @@ export class CredentialHolder {
         // the value with a new promise.
         return __classPrivateFieldGet(this, _CredentialHolder_value, "f");
     }
-    refresh() {
+    refresh(_force) {
         if (__classPrivateFieldGet(this, _CredentialHolder_isRefreshing, "f")) {
             return;
         }

package/esm/src/connection/internal/FetchBuilder.d.ts

@@ -1,4 +1,4 @@
-import { OutboundMiddleware, FetchLike } from '../types.js';
+import { FetchLike, OutboundMiddleware } from '../types.js';
 import { Connection } from '../../services/platform/mod.js';
 /**
  * FetchBuilder is used to build a fetch function which can be composed by multiple middlewares for

package/esm/src/connection/internal/FetchBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchBuilder.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/FetchBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAI5D;;;;GAIG;AACH,qBAAa,YAAY;;IACrB,WAAW,EAAE,kBAAkB,EAAE,CAAC;gBAKtB,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU;IAM7C,GAAG,CAAC,EAAE,EAAE,kBAAkB;IAI1B,KAAK,IAAI,SAAS;CAWrB"}
+{"version":3,"file":"FetchBuilder.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/FetchBuilder.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D;;;;GAIG;AACH,qBAAa,YAAY;;IACrB,WAAW,EAAE,kBAAkB,EAAE,CAAC;gBAKtB,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU;IAM7C,GAAG,CAAC,EAAE,EAAE,kBAAkB;IAI1B,KAAK,IAAI,SAAS;CAWrB"}

package/esm/src/connection/internal/FetchBuilder.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -81,7 +93,7 @@ function changeRequestInit(info, conn) {
 }
 function changeRequestbaseURLMiddleware(conn) {
     return (fetch) => {
-        return async (input, init = {}) => {
+        return (input, init = {}) => {
             const newInput = changeRequestInit(input, conn);
             return fetch(newInput, init);
         };

package/esm/src/connection/internal/HttpClientFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpClientFactory.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/HttpClientFactory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;;IAM1D,SAAS,CAAC,UAAU,EAAE,kBAAkB,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,GAAG,SAAS;IAcjF,OAAO,CAAC,aAAa;CAaxB"}
+{"version":3,"file":"HttpClientFactory.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/HttpClientFactory.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;;IAM1D,SAAS,CAAC,UAAU,EAAE,kBAAkB,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,GAAG,SAAS;IAcjF,OAAO,CAAC,aAAa;CAaxB"}

package/esm/src/connection/internal/HttpClientFactory.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 import { create } from '@bufbuild/protobuf';
 import { LRUCache } from 'lru-cache';
 import { credentialv1alpha1 } from '../../services/credentials/mod.js';

package/esm/src/connection/internal/InboundConnectionFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InboundConnectionFactory.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/InboundConnectionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AACxC,OAAO,EAIH,UAAU,EAGb,MAAM,gCAAgC,CAAC;AAQxC,qBAAa,+BAA+B;IAGpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoD;gBAErD,WAAW,EAAE,MAAM,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,EAChE,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,EAC5C,MAAM,EAAE,MAAM;IAKnC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;YAa3C,aAAa;IAc3B,OAAO,CAAC,YAAY;YAuDN,kBAAkB;YAiIlB,qBAAqB;YA2FrB,gBAAgB;CAsJjC"}
+{"version":3,"file":"InboundConnectionFactory.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/InboundConnectionFactory.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AACxC,OAAO,EAIH,UAAU,EAGb,MAAM,gCAAgC,CAAC;AAaxC,qBAAa,+BAA+B;IAGpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoD;gBAErD,WAAW,EAAE,MAAM,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,EAChE,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,EAC5C,MAAM,EAAE,MAAM;IAKnC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;YAa3C,aAAa;IAc3B,OAAO,CAAC,YAAY;YAuDN,kBAAkB;YAiIlB,qBAAqB;YA2FrB,gBAAgB;CAsJjC"}

package/esm/src/connection/internal/InboundConnectionFactory.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 import { credentialv1alpha1 } from '../../services/credentials/mod.js';
 import { create } from '@bufbuild/protobuf';
 import { Buffer } from 'node:buffer';

package/esm/src/connection/internal/OutboundConnectionFactory.d.ts

@@ -1,6 +1,6 @@
 import { Client } from '@connectrpc/connect';
 import { Logger } from '../../mod.js';
-import { credentialv1alpha1, tokensv1, oauth1v1 } from '../../services/credentials/mod.js';
+import { credentialv1alpha1, oauth1v1, tokensv1 } from '../../services/credentials/mod.js';
 import { Connection } from '../../services/platform/mod.js';
 import { FetchLike } from '../types.js';
 import { HttpClientFactory } from './HttpClientFactory.js';

package/esm/src/connection/internal/OutboundConnectionFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutboundConnectionFactory.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/OutboundConnectionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EAGH,UAAU,EAGb,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI3D,qBAAa,yBAAyB;IAI9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;gBAGxC,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,MAAM,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,EAChE,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,EAC5C,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,EACpD,MAAM,EAAE,MAAM;IAKnC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;YAkB9B,YAAY;IAmB1B,OAAO,CAAC,eAAe;YAiDT,0BAA0B;YAwB1B,qBAAqB;IA4DnC,OAAO,CAAC,2BAA2B;IAuBnC,OAAO,CAAC,0BAA0B;IAkDlC,OAAO,CAAC,2BAA2B;YA0BrB,wBAAwB;YAkCxB,qBAAqB;IAiCnC,OAAO,CAAC,8BAA8B;IAuBtC,OAAO,CAAC,2BAA2B;YA2ErB,wBAAwB;YAkCxB,qBAAqB;IA6CnC,OAAO,CAAC,kCAAkC;CAuB7C"}
+{"version":3,"file":"OutboundConnectionFactory.d.ts","sourceRoot":"","sources":["../../../../src/src/connection/internal/OutboundConnectionFactory.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EAGH,UAAU,EAGb,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI3D,qBAAa,yBAAyB;IAI9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;gBAGxC,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,MAAM,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,EAChE,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,EAC5C,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,EACpD,MAAM,EAAE,MAAM;IAKnC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;YAkB9B,YAAY;IAmB1B,OAAO,CAAC,eAAe;YAiDT,0BAA0B;YAwB1B,qBAAqB;IA4DnC,OAAO,CAAC,2BAA2B;IAuBnC,OAAO,CAAC,0BAA0B;IAkDlC,OAAO,CAAC,2BAA2B;YA0BrB,wBAAwB;YAoCxB,qBAAqB;IAmCnC,OAAO,CAAC,8BAA8B;IAsBtC,OAAO,CAAC,2BAA2B;YA2ErB,wBAAwB;YAmCxB,qBAAqB;IAiDnC,OAAO,CAAC,kCAAkC;CAsB7C"}

package/esm/src/connection/internal/OutboundConnectionFactory.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 import { LRUCache } from 'lru-cache';
 import { isTokenValid } from '../../services/credentials/isTokenValid.js';
 import { CredentialHolder } from './CredentialHolder.js';
@@ -373,7 +385,8 @@ export class OutboundConnectionFactory {
             });
             return refreshed.token;
         });
-        const authMiddleware = this.buildAuthorizationHeaderMiddleware(tokenHolder);
+        const authMiddleware = this
+            .buildAuthorizationHeaderMiddleware(tokenHolder);
         return Promise.resolve(refreshTokenMiddleware(authMiddleware, tokenHolder, this.logger));
     }
     async buildOAuth2Middleware(redactedCredential) {
@@ -383,10 +396,10 @@ export class OutboundConnectionFactory {
         if (!response || !response.token) {
             return Promise.resolve(undefined);
         }
-        const tokenHolder = new CredentialHolder(response.token, isTokenValid, async () => {
+        const tokenHolder = new CredentialHolder(response.token, isTokenValid, async (force) => {
             const refreshed = await this.tokens.getToken({
                 credentialId: redactedCredential.id,
-                forceRefresh: true,
+                forceRefresh: force || false,
             });
             return refreshed.token;
         });
@@ -405,7 +418,11 @@ export class OutboundConnectionFactory {
                 tokenType = 'Bearer';
                 break;
         }
-        return this.buildAuthorizationHeaderMiddleware(tokenHolder, tokenType);
+        const authMiddleware = this.buildAuthorizationHeaderMiddleware(tokenHolder, tokenType);
+        // wrap the middleware applying auth in a new middleware that handles refreshing tokens
+        // in the event of a 401 or 403 response. It's important that non of the middlewares above
+        // mutate the input or init parameters.
+        return refreshTokenMiddleware(authMiddleware, tokenHolder, this.logger);
     }
     buildAuthorizationHeaderMiddleware(tokenHolder, tokenType = 'Bearer') {
         return (fetch) => {
@@ -435,7 +452,7 @@ function refreshTokenMiddleware(authMiddleware, tokenHolder, logger) {
                 return response;
             }
             // the response is a 401 or 403, try refreshing the token and retrying the request
-            tokenHolder.refresh();
+            tokenHolder.refresh(true);
             if (init.body instanceof ReadableStream) {
                 logger.warn(`received ${response.status} but cannot refresh token requests using ReadableStream body`);
                 return response;

package/esm/src/connection/types.d.ts

@@ -24,9 +24,5 @@ export interface RuntimeConnectionFactory {
     baseUrl(ctx: Context<unknown>): Promise<string>;
     handler(ctx: Context<unknown>): Promise<express.RequestHandler>;
 }
-/**
- * ExpressHandlers is the interface for returning a dynamic express handler based on the provided context.
- */
-export interface ExpressHandlers {
-}
+export type ExpressHandlers = never;
 //# sourceMappingURL=types.d.ts.map

package/esm/src/connection/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/connection/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACrC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;CACnE;AAuBD;;GAEG;AACH,MAAM,WAAW,eAAe;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/connection/types.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACrC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;CACnE;AAwBD,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC"}

package/esm/src/connection/types.js

@@ -1 +1,13 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 export {};

package/esm/src/context/ActivationImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActivationImpl.d.ts","sourceRoot":"","sources":["../../../src/src/context/ActivationImpl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjI,qBAAa,cAAe,YAAW,UAAU;IAEzC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAJH,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM;IAGhC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAEhD;IAED,IAAI,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,CAE/C;IAED,IAAI,gBAAgB,IAAI,gBAAgB,GAAG,SAAS,CAEnD;IAED,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQ/C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BjE"}
+{"version":3,"file":"ActivationImpl.d.ts","sourceRoot":"","sources":["../../../src/src/context/ActivationImpl.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EACH,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,kBAAkB,EACrB,MAAM,6BAA6B,CAAC;AAErC,qBAAa,cAAe,YAAW,UAAU;IAEzC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAJH,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM;IAGhC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAEhD;IAED,IAAI,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,CAE/C;IAED,IAAI,gBAAgB,IAAI,gBAAgB,GAAG,SAAS,CAEnD;IAED,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQ/C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BjE"}

package/esm/src/context/ActivationImpl.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 export class ActivationImpl {
     constructor(activation, platformApi, organisationId, environmentId, log) {
         Object.defineProperty(this, "activation", {
@@ -67,7 +79,7 @@ export class ActivationImpl {
                 },
                 body: {
                     value,
-                }
+                },
             });
         }
         catch (err) {

package/esm/src/context/AsyncWorkflow.d.ts

@@ -1,4 +1,8 @@
 import { QueueAPI } from '../interpreter/durable/Queue.js';
+/**
+ * AsyncWorkflow represents a durable workflow that has been started asynchronously using `ctx.start()`.
+ * It provides methods to wait for completion and retrieve the workflow's output data.
+ */
 export declare class AsyncWorkflow {
     private workflowId;
     private queue;
@@ -7,9 +11,35 @@ export declare class AsyncWorkflow {
     private isWaiting;
     private isCompleted;
     constructor(queue: QueueAPI, workflowId: string);
+    /**
+     * The unique identifier for this workflow instance.
+     */
     get id(): string;
+    /**
+     * Wait for the workflow to complete by polling the queue.
+     *
+     * If the workflow is already completed, returns immediately. Throws an error if already waiting or if the wait
+     * times out.
+     *
+     * @param maxWait Optional maximum wait time in milliseconds. If exceeded, throws an error.
+     * @throws Error if already waiting for this workflow or if maxWait is exceeded.
+     */
     wait(maxWait?: number): Promise<void>;
+    /**
+     * Get the parsed output data from the completed workflow.
+     *
+     * If the workflow hasn't completed yet, this will wait for it to complete first.
+     *
+     * @returns The workflow's output data, JSON parsed.
+     */
     getData(): Promise<unknown | undefined>;
+    /**
+     * Get the raw output data from the completed workflow as a base64 encoded string.
+     *
+     * If the workflow hasn't completed yet, this will wait for it to complete first.
+     *
+     * @returns The workflow's output data, base64 encoded.
+     */
     getDataRaw(): Promise<string | undefined>;
 }
 //# sourceMappingURL=AsyncWorkflow.d.ts.map

package/esm/src/context/AsyncWorkflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncWorkflow.d.ts","sourceRoot":"","sources":["../../../src/src/context/AsyncWorkflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,qBAAa,aAAa;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM;IAK/C,IAAI,EAAE,IAAI,MAAM,CAEf;IAMK,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCrC,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAQvC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAMlD"}
+{"version":3,"file":"AsyncWorkflow.d.ts","sourceRoot":"","sources":["../../../src/src/context/AsyncWorkflow.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D;;;GAGG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM;IAK/C;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC3C;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAO7C;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAMlD"}