@intuned/runtime 1.3.17 → 1.3.18-interface.6

package/dist/runtime/downloadDirectory.d.ts

@@ -1 +0,0 @@
-export declare function getDownloadDirectoryPath(): string;

package/dist/runtime/downloadDirectory.js

@@ -1,19 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getDownloadDirectoryPath = getDownloadDirectoryPath;
-var _ = require("..");
-var _fsExtra = require("fs-extra");
-function getDownloadDirectoryPath() {
-  const context = (0, _.getExecutionContext)();
-  if (!context) {
-    throw new Error("ExecutionContext not found");
-  }
-  const path = `/tmp/downloads/${context.runId}`;
-  (0, _fsExtra.ensureDirSync)(path, {
-    mode: 0o2775
-  });
-  return path;
-}

package/dist/runtime/enums.d.js

@@ -1,5 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});

package/dist/runtime/enums.d.ts

@@ -1,11 +0,0 @@
-export declare enum RunEnvironment {
-  IDE = "IDE",
-  DEPLOYED = "DEPLOYED",
-}
-
-export declare enum RunType {
-  SYNC = "SYNC",
-  ASYNC = "ASYNC",
-  JOB = "JOB",
-  QUEUE = "QUEUE",
-}

package/dist/runtime/enums.js

@@ -1,18 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.RunType = exports.RunEnvironment = void 0;
-let RunEnvironment = exports.RunEnvironment = function (RunEnvironment) {
-  RunEnvironment["IDE"] = "IDE";
-  RunEnvironment["DEPLOYED"] = "DEPLOYED";
-  return RunEnvironment;
-}({});
-let RunType = exports.RunType = function (RunType) {
-  RunType["SYNC"] = "SYNC";
-  RunType["ASYNC"] = "ASYNC";
-  RunType["JOB"] = "JOB";
-  RunType["QUEUE"] = "QUEUE";
-  return RunType;
-}({});

package/dist/runtime/executionHelpers.test.js

@@ -1,52 +0,0 @@
-"use strict";
-
-var _vitest = require("vitest");
-var _asyncLocalStorage = require("../common/asyncLocalStorage");
-var _ = require(".");
-var _enums = require("./enums");
-(0, _vitest.describe)("Execution Helpers", () => {
-  (0, _vitest.it)("should be able to get execution info", () => {
-    (0, _asyncLocalStorage.runWithContext)({
-      runEnvironment: _enums.RunEnvironment.IDE,
-      runId: "test-run-id",
-      extendedPayloads: []
-    }, () => {
-      (0, _vitest.expect)((0, _.runInfo)().runId).toEqual("test-run-id");
-    });
-  });
-  (0, _vitest.it)("should be able to mutate extendedPayloads and get the accmulated value at the end ", () => {
-    const context = {
-      extendedPayloads: [],
-      runId: "test-run-id"
-    };
-    (0, _asyncLocalStorage.runWithContext)({
-      runEnvironment: _enums.RunEnvironment.IDE,
-      runId: "test-run-id",
-      extendedPayloads: []
-    }, () => {
-      (0, _vitest.expect)((0, _asyncLocalStorage.getExecutionContext)()?.extendedPayloads).toEqual([]);
-      (0, _.extendPayload)({
-        api: "test-api",
-        parameters: {}
-      });
-      (0, _vitest.expect)((0, _asyncLocalStorage.getExecutionContext)()?.extendedPayloads).toEqual([{
-        api: "test-api",
-        parameters: {}
-      }]);
-      (0, _.extendPayload)({
-        api: "test-api",
-        parameters: {}
-      });
-      (0, _.extendPayload)({
-        api: "test-api",
-        parameters: {}
-      });
-      (0, _.extendPayload)({
-        api: "test-api",
-        parameters: {}
-      });
-      const context = (0, _asyncLocalStorage.getExecutionContext)();
-      (0, _vitest.expect)(context?.extendedPayloads).toHaveLength(4);
-    });
-  });
-});

package/dist/runtime/export.d.js

@@ -1,5 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});

package/dist/runtime/export.d.ts

@@ -1,284 +0,0 @@
-import { RunEnvironment } from "./enums";
-
-/**
- * ## Description
- * In the context of a job, extendTimeout will increase the timeout of the currently executing payload.
- * This is useful when the payload is expected to take a long time. For example, when running pagination code.
- *
- * @example
- * ```typescript Example
- * import { extendTimeout } from "@intuned/sdk/runtime"
- *
- * extendTimeout();
- * ```
- *
- */
-export declare function extendTimeout(): void;
-
-/**
- * ## Description
- * In the context of a job or queue execution, extendPayload appends new payloads to the end of the queue of job.
- * Calling extendPayload will also call extendTimeout.
- *
- * @param {Payload | Payload[]} payload - The payload or array of payloads to extend. you can specify the api name and what parameters you want to pass it, the new added apis will use the same proxy and auth-session settings as the api that extended them
- *
- * @example
- * ```typescript Single payload
- * import { extendPayload } from "@intuned/sdk/runtime"
- *
- * // this function will append the exampleApi to the end of the queue or job it's executing in.
- * extendPayload({ api: 'exampleApi', parameters: { key: 'value' } });
- * ```
- *
- * @example
- * ```typescript Array of payloads
- * import { extendPayload } from "@intuned/sdk/runtime"
- *
- * const payloadArray: Payload[] = [
- *   { api: 'exampleApi1', parameters: { key1: 'value1' } },
- *   { api: 'exampleApi2', parameters: { key2: 'value2' } }
- * ];
- *
- * // this function will append 2 apis to the end of the queue or job it's executing in.
- * extendPayload(payloadArray);
- * ```
- */
-export declare function extendPayload(payload: Payload | Payload[]): void;
-
-/**
- * @interface Payload
- * @property {string} api - The API path you want to extend.
- * @property {Record<string, any>} parameters - A record of key-value pairs representing the parameters to be sent to the API
- *
- * @example
- *
- * ```typescript payload
- * import { Payload } from "@intuned/sdk/runtime"
- *
- * const payload: Payload = {
- *   api: 'exampleApi',
- *   parameters: {
- *     key1: 'value1',
- *     key2: 'value2'
- *   }
- * };
- * ```
- */
-export interface Payload {
-  api: string;
-  parameters: Record<string, any>;
-}
-
-/**
- * Retrieves information about the current run environment.
- *
- * @returns {RunInfo} An object containing details about the run environment and the run ID.
- *
- * @example
- * ```typescript runInfo
- * import { runInfo } from "@intuned/sdk/runtime"
- *
- * const info = runInfo();
- * console.log(info.runEnvironment); // Outputs the run environment, IDE or DEPLOYED
- * console.log(info.runId); // Outputs the run ID, if available, in IDE run id will be undefined
- * ```
- */
-export declare function runInfo(): RunInfo;
-
-/**
- * Represents information about the current run.
- *
- * @interface RunInfo
- * @property {RunEnvironment} runEnvironment - the run environment `IDE` or `DEPLOYED`
- * @property {string} [runId] - Optional. The ID of the current run, in IDE environment, run id will be undefined
- */
-export interface RunInfo {
-  runEnvironment: RunEnvironment;
-  runId?: string;
-  jobId?: string;
-  jobRunId?: string;
-  queueId?: string;
-  proxy?: string;
-  authSessionId?: string;
-}
-
-/**
- * @interface RunErrorOptions
- * @property {boolean} [retryable] - Optional. Indicates whether the error is retryable.
- * @property {number} [status_code] - Optional. The HTTP status code associated with the error.
- * @property {string} [error_code] - Optional. A specific error code to identify the type of error.
- *
- * @example
- * ```typescript RunErrorOptions
- * import { RunErrorOptions } from "@intuned/sdk/runtime"
- *
- * const options: RunErrorOptions = {
- *   retryable: true,
- *   status_code: 500,
- *   error_code: 'SERVER_ERROR'
- * };
- * ```
- */
-export interface RunErrorOptions {
-  retryable?: boolean;
-  status_code?: number;
-  error_code?: string;
-}
-
-/**
- * @deprecated This error is deprecated. it will be treated like any normal error
- *
- * Represents an error that occurs during a run.
- *
- * @class
- * @extends Error
- *
- * @param {string} message - The error message.
- * @param {RunErrorOptions} [options] - Optional. Additional options for the error.
- *
- * @property {RunErrorOptions} options - The options associated with the error.
- *
- * @example
- * ```typescript RunError
- * import { RunError } from "@intuned/sdk/runtime"
- *
- * throw new RunError('An error occurred', {
- *   retryable: true,
- *   status_code: 500,
- *   error_code: 'SERVER_ERROR'
- * });
- *
- * ```
- */
-export declare class RunError extends Error {
-  constructor(message: string, options?: RunErrorOptions);
-  options: RunErrorOptions;
-}
-
-/**
- * Retrieves the parameters for the authentication session currently being used.
- *
- * @returns {AuthSessionParameters} An object containing the parameters for the current authentication session.
- *
- * @example
- * ```typescript getAuthSessionParameters
- * import { getAuthSessionParameters } from "@intuned/sdk/runtime"
- *
- * const authSessionParams = getAuthSessionParameters();
- * console.log(authSessionParams);
- * ```
- */
-export declare function getAuthSessionParameters(): Promise<any>;
-
-/**
- * @interface AttemptStore
- * @property {function} get - Retrieves a value from the store by key
- * @property {function} set - Sets a value in the store by key
- *
- * @example
- * ```typescript AttemptStore usage
- * import { attemptStore } from "@intuned/sdk/runtime"
- *
- * // Set a value in the store
- * attemptStore.set('openAiClient', openaiClient);
- *
- * // Get a value from the store
- * const openAiClient = attemptStore.get('openAiClient');
- * ```
- */
-export interface AttemptStore {
-  /**
-   * Retrieves a value from the store by key.
-   *
-   * @param {string} key - The key to retrieve the value for
-   * @returns {any} The value associated with the key, or undefined if not found
-   */
-  get(key: string): any;
-
-  /**
-   * Sets a value in the store by key.
-   *
-   * @param {string} key - The key to set the value for
-   * @param {any} value - The value to store
-   * @throws {Error} Throws an error if the store operation fails
-   */
-  set(key: string, value: any): void;
-}
-
-/**
- * ## Description
- * A persistent key-value store that maintains data within the execution context.
- * This store allows you to share data between different parts of your API execution.
- *
- * @example
- * ```typescript AttemptStore usage
- * import { attemptStore } from "@intuned/sdk/runtime"
- *
- * // Set a value in the store
- * store.set('openAiClient', openaiClient);
- *
- * // Get a value from the store
- * const openAiClient = attemptStore.get('openAiClient');
- * openAiClient.doSomething();
- *
- * // Handle missing values
- * const missingData = attemptStore.get('nonexistent'); // undefined
- * ```
- */
-export declare const attemptStore: AttemptStore;
-
-/**
- * @interface PersistentStore
- * @property {function} get - Retrieves a value from the store by key
- * @property {function} set - Sets a value in the store by key
- *
- * @example
- * ```typescript PersistentStore usage
- * import { persistentStore } from "@intuned/sdk/runtime"
- *
- * // Set a value in the store
- * persistentStore.set('data', { foo: 'bar' });
- *
- * // Get a value from the store
- * await persistentStore.get('data');
- * ```
- */
-export interface PersistentStore {
-  /**
-   * Retrieves a value from the store by key.
-   *
-   * @param {string} key - The key to retrieve the value for
-   * @returns {any} The value associated with the key, or undefined if not found
-   */
-  get(key: string): Promise<any>;
-
-  /**
-   * Sets a value in the store by key.
-   *
-   * @param {string} key - The key to set the value for
-   * @param {any} value - The value to store
-   * @throws {Error} Throws an error if the store operation fails
-   */
-  set(key: string, value: any): Promise<void>;
-}
-
-/**
- * ## Description
- * A persistent key-value store that maintains data within the execution context.
- * This store allows you to share data between different API executions.
- *
- * @example
- * ```typescript PersistentStore usage
- * import { persistentStore } from "@intuned/sdk/runtime"
- *
- * // Set a value in the store
- * persistentStore.set('data', { foo: 'bar' });
- *
- * // Get a value from the store
- * await persistentStore.get('data');
- *
- * // Handle missing values
- * const missingData = await persistentStore.get('nonexistent'); // undefined
- * ```
- */
-export declare const persistentStore: PersistentStore;

package/dist/runtime/extendPayload.d.ts

@@ -1,2 +0,0 @@
-import { Payload } from "./export";
-export declare function extendPayload(payload: Payload | Payload[]): void;

package/dist/runtime/extendPayload.js

@@ -1,21 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.extendPayload = extendPayload;
-var _asyncLocalStorage = require("../common/asyncLocalStorage");
-var _extendTimeout = require("./extendTimeout");
-function extendPayload(payload) {
-  const context = (0, _asyncLocalStorage.getExecutionContext)();
-  if (!context) {
-    throw new Error("extendPayload failed due to an internal error.");
-  }
-  const items = Array.isArray(payload) ? payload : [payload];
-  if (!context.extendedPayloads) {
-    context.extendedPayloads = [...items];
-    return;
-  }
-  context?.extendedPayloads.push(...items);
-  (0, _extendTimeout.extendTimeout)();
-}

package/dist/runtime/extendTimeout.d.ts

@@ -1 +0,0 @@
-export declare function extendTimeout(): void;

package/dist/runtime/extendTimeout.js

@@ -1,23 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.extendTimeout = extendTimeout;
-var _asyncLocalStorage = require("../common/asyncLocalStorage");
-const _DEBOUNCE_TIME = 60_000;
-function extendTimeout() {
-  const context = (0, _asyncLocalStorage.getExecutionContext)();
-  if (!context) {
-    throw new Error("extendTimeout failed due to an internal error.");
-  }
-  const {
-    timeoutInfo
-  } = context;
-  if (!timeoutInfo) {
-    return;
-  }
-  if (timeoutInfo.extendTimeoutCallback !== undefined) {
-    void timeoutInfo.extendTimeoutCallback().catch(() => undefined);
-  }
-}

package/dist/runtime/getAiGatewayConfig.d.ts

@@ -1,10 +0,0 @@
-/**
- * Retrieves the base URL and API key for the Intuned AI Gateway.
-
- * Returns:
- *   { baseUrl: string, apiKey: string }: An object containing the base URL and API key
- */
-export declare function getAiGatewayConfig(): {
-    baseUrl: string;
-    apiKey: string;
-};

package/dist/runtime/getAiGatewayConfig.js

@@ -1,16 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getAiGatewayConfig = getAiGatewayConfig;
-var _constants = require("../common/constants");
-var _jwtTokenManager = require("../common/jwtTokenManager");
-function getAiGatewayConfig() {
-  const baseUrl = `${_jwtTokenManager.backendFunctionsTokenManager.backendFunctionsBaseUrl}/intuned-ai-gateway`;
-  const apiKey = _jwtTokenManager.backendFunctionsTokenManager.token ?? process.env[_constants.API_KEY_ENV_VAR_KEY] ?? "";
-  return {
-    baseUrl,
-    apiKey
-  };
-}

package/dist/runtime/getAuthSessionParameters.d.ts

@@ -1 +0,0 @@
-export declare function getAuthSessionParameters(): Promise<any>;

package/dist/runtime/getAuthSessionParameters.js

@@ -1,20 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getAuthSessionParameters = getAuthSessionParameters;
-var _asyncLocalStorage = require("../common/asyncLocalStorage");
-async function getAuthSessionParameters() {
-  const context = (0, _asyncLocalStorage.getExecutionContext)();
-  if (!context) {
-    throw new Error("getAuthSessionParameters failed due to an internal error (context was not found).");
-  }
-  const {
-    getAuthSessionParameters
-  } = context;
-  if (!getAuthSessionParameters) {
-    throw new Error("getAuthSessionParameters failed due to an internal error (helper was not found on context).");
-  }
-  return await getAuthSessionParameters();
-}

package/dist/runtime/persistentStore.d.ts

@@ -1,2 +0,0 @@
-import type { PersistentStore } from "./export";
-export declare const persistentStore: PersistentStore;

package/dist/runtime/persistentStore.js

@@ -1,37 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.persistentStore = void 0;
-var _zod = require("zod");
-var _jwtTokenManager = require("../common/jwtTokenManager");
-const forbiddenCharacters = /[:#]/g;
-const keySchema = _zod.z.string().min(1, "Key must be at least 1 character long").refine(key => (key.match(forbiddenCharacters)?.length ?? 0) === 0, 'Key cannot contain the following characters: ":" or "#"');
-const persistentStore = exports.persistentStore = Object.freeze({
-  get: async key => {
-    const parsedKey = keySchema.parse(key);
-    const response = await (0, _jwtTokenManager.callBackendFunctionWithToken)(`kv-store/${parsedKey}`, {
-      method: "GET"
-    });
-    const json = await response.json();
-    if (!response.ok) {
-      throw new Error(json.message);
-    }
-    return json.value;
-  },
-  set: async (key, value) => {
-    const keyResult = keySchema.parse(key);
-    const response = await (0, _jwtTokenManager.callBackendFunctionWithToken)(`kv-store/${keyResult}`, {
-      method: "PUT",
-      body: JSON.stringify(value),
-      headers: {
-        "Content-Type": "application/json"
-      }
-    });
-    const json = await response.json();
-    if (!response.ok) {
-      throw new Error(json.message);
-    }
-  }
-});

package/dist/runtime/persistentStore.test.js

@@ -1,101 +0,0 @@
-"use strict";
-
-var _vitest = require("vitest");
-var _zod = require("zod");
-var _persistentStore = require("./persistentStore");
-var _jwtTokenManager = require("../common/jwtTokenManager");
-_vitest.vi.mock("../common/jwtTokenManager", () => ({
-  callBackendFunctionWithToken: _vitest.vi.fn()
-}));
-(0, _vitest.describe)("Cache", () => {
-  (0, _vitest.beforeEach)(() => {
-    _vitest.vi.clearAllMocks();
-  });
-  (0, _vitest.describe)("get", () => {
-    (0, _vitest.it)("should return value when successful", async () => {
-      const mockResponse = {
-        ok: true,
-        json: _vitest.vi.fn().mockResolvedValue({
-          value: "cached_data"
-        })
-      };
-      _vitest.vi.mocked(_jwtTokenManager.callBackendFunctionWithToken).mockResolvedValue(mockResponse);
-      const result = await _persistentStore.persistentStore.get("test_key");
-      (0, _vitest.expect)(result).toBe("cached_data");
-      (0, _vitest.expect)(_jwtTokenManager.callBackendFunctionWithToken).toHaveBeenCalledWith("kv-store/test_key", {
-        method: "GET"
-      });
-      (0, _vitest.expect)(mockResponse.json).toHaveBeenCalled();
-    });
-    (0, _vitest.it)("should throw error when response is not ok", async () => {
-      const mockResponse = {
-        ok: false,
-        json: _vitest.vi.fn().mockResolvedValue({
-          message: "Cache miss"
-        })
-      };
-      _vitest.vi.mocked(_jwtTokenManager.callBackendFunctionWithToken).mockResolvedValue(mockResponse);
-      await (0, _vitest.expect)(_persistentStore.persistentStore.get("test_key")).rejects.toThrow("Cache miss");
-    });
-    (0, _vitest.it)("should throw error for empty key", async () => {
-      await (0, _vitest.expect)(_persistentStore.persistentStore.get("")).rejects.toThrow(_zod.ZodError);
-    });
-    (0, _vitest.it)("should throw error for key with colon", async () => {
-      await (0, _vitest.expect)(_persistentStore.persistentStore.get("invalid:key")).rejects.toThrow(_zod.ZodError);
-    });
-    (0, _vitest.it)("should throw error for key with hash", async () => {
-      await (0, _vitest.expect)(_persistentStore.persistentStore.get("invalid#key")).rejects.toThrow(_zod.ZodError);
-    });
-  });
-  (0, _vitest.describe)("set", () => {
-    (0, _vitest.it)("should call backend correctly when successful", async () => {
-      const mockResponse = {
-        ok: true,
-        json: _vitest.vi.fn().mockResolvedValue({})
-      };
-      _vitest.vi.mocked(_jwtTokenManager.callBackendFunctionWithToken).mockResolvedValue(mockResponse);
-      const testValue = {
-        data: "test"
-      };
-      await _persistentStore.persistentStore.set("test_key", testValue);
-      (0, _vitest.expect)(_jwtTokenManager.callBackendFunctionWithToken).toHaveBeenCalledWith("kv-store/test_key", {
-        method: "PUT",
-        body: JSON.stringify(testValue),
-        headers: {
-          "Content-Type": "application/json"
-        }
-      });
-      (0, _vitest.expect)(mockResponse.json).toHaveBeenCalled();
-    });
-    (0, _vitest.it)("should throw error when response is not ok", async () => {
-      const mockResponse = {
-        ok: false,
-        json: _vitest.vi.fn().mockResolvedValue({
-          message: "Set failed"
-        })
-      };
-      _vitest.vi.mocked(_jwtTokenManager.callBackendFunctionWithToken).mockResolvedValue(mockResponse);
-      await (0, _vitest.expect)(_persistentStore.persistentStore.set("test_key", "value")).rejects.toThrow("Set failed");
-    });
-    (0, _vitest.it)("should throw error for empty key", async () => {
-      await (0, _vitest.expect)(_persistentStore.persistentStore.set("", "value")).rejects.toThrow(_zod.ZodError);
-    });
-    (0, _vitest.it)("should throw error for key with forbidden characters", async () => {
-      await (0, _vitest.expect)(_persistentStore.persistentStore.set("invalid:key", "value")).rejects.toThrow(_zod.ZodError);
-      await (0, _vitest.expect)(_persistentStore.persistentStore.set("invalid#key", "value")).rejects.toThrow(_zod.ZodError);
-    });
-    (0, _vitest.it)("should handle different value types", async () => {
-      const mockResponse = {
-        ok: true,
-        json: _vitest.vi.fn().mockResolvedValue({})
-      };
-      _vitest.vi.mocked(_jwtTokenManager.callBackendFunctionWithToken).mockResolvedValue(mockResponse);
-      await _persistentStore.persistentStore.set("key1", "string_value");
-      await _persistentStore.persistentStore.set("key2", {
-        object: "value"
-      });
-      await _persistentStore.persistentStore.set("key3", 123);
-      (0, _vitest.expect)(_jwtTokenManager.callBackendFunctionWithToken).toHaveBeenCalledTimes(3);
-    });
-  });
-});

package/dist/runtime/runInfo.d.ts

@@ -1,2 +0,0 @@
-import { RunInfo } from "./export";
-export declare function runInfo(): RunInfo;

package/dist/runtime/runInfo.js

@@ -1,21 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.runInfo = runInfo;
-var _asyncLocalStorage = require("../common/asyncLocalStorage");
-var _enums = require("./enums");
-function runInfo() {
-  const context = (0, _asyncLocalStorage.getExecutionContext)();
-  if (!context) {
-    return {
-      runEnvironment: _enums.RunEnvironment.IDE
-    };
-  }
-  const {
-    extendedPayloads: _extendedPayloads,
-    ...rest
-  } = context;
-  return rest;
-}