@upstash/workflow 0.2.3 → 0.2.4

package/express.js

@@ -23696,6 +23696,23 @@ __export(express_exports, {
 });
 module.exports = __toCommonJS(express_exports);
 
+// src/constants.ts
+var WORKFLOW_ID_HEADER = "Upstash-Workflow-RunId";
+var WORKFLOW_INIT_HEADER = "Upstash-Workflow-Init";
+var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
+var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
+var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
+var WORKFLOW_PROTOCOL_VERSION = "1";
+var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
+var DEFAULT_CONTENT_TYPE = "application/json";
+var NO_CONCURRENCY = 1;
+var DEFAULT_RETRIES = 3;
+var VERSION = "v0.2.3";
+var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
+var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
+var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
+var TELEMETRY_HEADER_RUNTIME = "Upstash-Telemetry-Runtime";
+
 // src/client/utils.ts
 var import_qstash = require("@upstash/qstash");
 var makeNotifyRequest = async (requester, eventId, eventData) => {
@@ -24386,18 +24403,6 @@ var Err = class {
 };
 var fromThrowable = Result.fromThrowable;
 
-// src/constants.ts
-var WORKFLOW_ID_HEADER = "Upstash-Workflow-RunId";
-var WORKFLOW_INIT_HEADER = "Upstash-Workflow-Init";
-var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
-var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
-var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
-var WORKFLOW_PROTOCOL_VERSION = "1";
-var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
-var DEFAULT_CONTENT_TYPE = "application/json";
-var NO_CONCURRENCY = 1;
-var DEFAULT_RETRIES = 3;
-
 // src/types.ts
 var StepTypes = [
   "Initial",
@@ -24411,16 +24416,21 @@ var StepTypes = [
 
 // src/workflow-requests.ts
 var import_qstash3 = require("@upstash/qstash");
-var triggerFirstInvocation = async (workflowContext, retries, useJSONContent, debug) => {
-  const { headers } = getHeaders(
-    "true",
-    workflowContext.workflowRunId,
-    workflowContext.url,
-    workflowContext.headers,
-    void 0,
-    workflowContext.failureUrl,
-    retries
-  );
+var triggerFirstInvocation = async ({
+  workflowContext,
+  useJSONContent,
+  telemetry,
+  debug
+}) => {
+  const { headers } = getHeaders({
+    initHeaderValue: "true",
+    workflowRunId: workflowContext.workflowRunId,
+    workflowUrl: workflowContext.url,
+    userHeaders: workflowContext.headers,
+    failureUrl: workflowContext.failureUrl,
+    retries: workflowContext.retries,
+    telemetry
+  });
   if (useJSONContent) {
     headers["content-type"] = "application/json";
   }
@@ -24526,7 +24536,16 @@ var recreateUserHeaders = (headers) => {
   }
   return filteredHeaders;
 };
-var handleThirdPartyCallResult = async (request, requestPayload, client, workflowUrl, failureUrl, retries, debug) => {
+var handleThirdPartyCallResult = async ({
+  request,
+  requestPayload,
+  client,
+  workflowUrl,
+  failureUrl,
+  retries,
+  telemetry,
+  debug
+}) => {
   try {
     if (request.headers.get("Upstash-Workflow-Callback")) {
       let callbackPayload;
@@ -24585,15 +24604,15 @@ ${atob(callbackMessage.body ?? "")}`
         );
       }
       const userHeaders = recreateUserHeaders(request.headers);
-      const { headers: requestHeaders } = getHeaders(
-        "false",
+      const { headers: requestHeaders } = getHeaders({
+        initHeaderValue: "false",
         workflowRunId,
         workflowUrl,
         userHeaders,
-        void 0,
         failureUrl,
-        retries
-      );
+        retries,
+        telemetry
+      });
       const callResponse = {
         status: callbackMessage.status,
         body: atob(callbackMessage.body ?? ""),
@@ -24631,12 +24650,31 @@ ${atob(callbackMessage.body ?? "")}`
     );
   }
 };
-var getHeaders = (initHeaderValue, workflowRunId, workflowUrl, userHeaders, step, failureUrl, retries, callRetries, callTimeout) => {
+var getTelemetryHeaders = (telemetry) => {
+  return {
+    [TELEMETRY_HEADER_SDK]: telemetry.sdk,
+    [TELEMETRY_HEADER_FRAMEWORK]: telemetry.framework,
+    [TELEMETRY_HEADER_RUNTIME]: telemetry.runtime ?? "unknown"
+  };
+};
+var getHeaders = ({
+  initHeaderValue,
+  workflowRunId,
+  workflowUrl,
+  userHeaders,
+  failureUrl,
+  retries,
+  step,
+  callRetries,
+  callTimeout,
+  telemetry
+}) => {
   const baseHeaders = {
     [WORKFLOW_INIT_HEADER]: initHeaderValue,
     [WORKFLOW_ID_HEADER]: workflowRunId,
     [WORKFLOW_URL_HEADER]: workflowUrl,
-    [WORKFLOW_FEATURE_HEADER]: "LazyFetch,InitialBody"
+    [WORKFLOW_FEATURE_HEADER]: "LazyFetch,InitialBody",
+    ...telemetry ? getTelemetryHeaders(telemetry) : {}
   };
   if (!step?.callUrl) {
     baseHeaders[`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`] = WORKFLOW_PROTOCOL_VERSION;
@@ -24710,6 +24748,13 @@ var getHeaders = (initHeaderValue, workflowRunId, workflowUrl, userHeaders, step
         ...Object.fromEntries(
           Object.entries(baseHeaders).map(([header, value]) => [header, [value]])
         ),
+        // to include telemetry headers:
+        ...telemetry ? Object.fromEntries(
+          Object.entries(getTelemetryHeaders(telemetry)).map(([header, value]) => [
+            header,
+            [value]
+          ])
+        ) : {},
         // note: using WORKFLOW_ID_HEADER doesn't work, because Runid -> RunId:
         "Upstash-Workflow-Runid": [workflowRunId],
         [WORKFLOW_INIT_HEADER]: ["false"],
@@ -24748,6 +24793,7 @@ If you want to disable QStash Verification, you should clear env variables QSTAS
 };
 
 // src/context/auto-executor.ts
+var import_qstash4 = require("@upstash/qstash");
 var AutoExecutor = class _AutoExecutor {
   context;
   promises = /* @__PURE__ */ new WeakMap();
@@ -24756,13 +24802,15 @@ var AutoExecutor = class _AutoExecutor {
   nonPlanStepCount;
   steps;
   indexInCurrentList = 0;
+  telemetry;
   stepCount = 0;
   planStepCount = 0;
   executingStep = false;
-  constructor(context, steps, debug) {
+  constructor(context, steps, telemetry, debug) {
     this.context = context;
-    this.debug = debug;
     this.steps = steps;
+    this.telemetry = telemetry;
+    this.debug = debug;
     this.nonPlanStepCount = this.steps.filter((step) => !step.targetStep).length;
   }
   /**
@@ -24905,7 +24953,7 @@ var AutoExecutor = class _AutoExecutor {
           );
           await this.submitStepsToQStash([resultStep], [parallelStep]);
         } catch (error) {
-          if (error instanceof WorkflowAbort) {
+          if (error instanceof WorkflowAbort || error instanceof import_qstash4.QstashError && error.status === 400) {
             throw error;
           }
           throw new WorkflowError(
@@ -24976,15 +25024,16 @@ var AutoExecutor = class _AutoExecutor {
     });
     if (steps[0].waitEventId && steps.length === 1) {
       const waitStep = steps[0];
-      const { headers, timeoutHeaders } = getHeaders(
-        "false",
-        this.context.workflowRunId,
-        this.context.url,
-        this.context.headers,
-        waitStep,
-        this.context.failureUrl,
-        this.context.retries
-      );
+      const { headers, timeoutHeaders } = getHeaders({
+        initHeaderValue: "false",
+        workflowRunId: this.context.workflowRunId,
+        workflowUrl: this.context.url,
+        userHeaders: this.context.headers,
+        step: waitStep,
+        failureUrl: this.context.failureUrl,
+        retries: this.context.retries,
+        telemetry: this.telemetry
+      });
       const waitBody = {
         url: this.context.url,
         timeout: waitStep.timeout,
@@ -25011,17 +25060,18 @@ var AutoExecutor = class _AutoExecutor {
     const result = await this.context.qstashClient.batchJSON(
       steps.map((singleStep, index) => {
         const lazyStep = lazySteps[index];
-        const { headers } = getHeaders(
-          "false",
-          this.context.workflowRunId,
-          this.context.url,
-          this.context.headers,
-          singleStep,
-          this.context.failureUrl,
-          this.context.retries,
-          lazyStep instanceof LazyCallStep ? lazyStep.retries : void 0,
-          lazyStep instanceof LazyCallStep ? lazyStep.timeout : void 0
-        );
+        const { headers } = getHeaders({
+          initHeaderValue: "false",
+          workflowRunId: this.context.workflowRunId,
+          workflowUrl: this.context.url,
+          userHeaders: this.context.headers,
+          step: singleStep,
+          failureUrl: this.context.failureUrl,
+          retries: this.context.retries,
+          callRetries: lazyStep instanceof LazyCallStep ? lazyStep.retries : void 0,
+          callTimeout: lazyStep instanceof LazyCallStep ? lazyStep.timeout : void 0,
+          telemetry: this.telemetry
+        });
         const willWait = singleStep.concurrent === NO_CONCURRENCY || singleStep.stepId === 0;
         singleStep.out = JSON.stringify(singleStep.out);
         return singleStep.callUrl ? (
@@ -25134,7 +25184,7 @@ var sortSteps = (steps) => {
 };
 
 // src/context/api/anthropic.ts
-var import_qstash4 = require("@upstash/qstash");
+var import_qstash5 = require("@upstash/qstash");
 
 // src/context/provider.ts
 var getProviderInfo = (api) => {
@@ -25198,7 +25248,7 @@ var AnthropicAPI = class extends BaseWorkflowApi {
     return await this.callApi(stepName, {
       api: {
         name: "llm",
-        provider: (0, import_qstash4.anthropic)({ token })
+        provider: (0, import_qstash5.anthropic)({ token })
       },
       ...parameters
     });
@@ -25206,14 +25256,14 @@ var AnthropicAPI = class extends BaseWorkflowApi {
 };
 
 // src/context/api/openai.ts
-var import_qstash5 = require("@upstash/qstash");
+var import_qstash6 = require("@upstash/qstash");
 var OpenAIAPI = class extends BaseWorkflowApi {
   async call(stepName, settings) {
     const { token, organization, operation, ...parameters } = settings;
     return await this.callApi(stepName, {
       api: {
         name: "llm",
-        provider: (0, import_qstash5.openai)({ token, organization })
+        provider: (0, import_qstash6.openai)({ token, organization })
       },
       ...parameters
     });
@@ -25221,14 +25271,14 @@ var OpenAIAPI = class extends BaseWorkflowApi {
 };
 
 // src/context/api/resend.ts
-var import_qstash6 = require("@upstash/qstash");
+var import_qstash7 = require("@upstash/qstash");
 var ResendAPI = class extends BaseWorkflowApi {
   async call(stepName, settings) {
     const { token, batch = false, ...parameters } = settings;
     return await this.callApi(stepName, {
       api: {
         name: "email",
-        provider: (0, import_qstash6.resend)({ token, batch })
+        provider: (0, import_qstash7.resend)({ token, batch })
       },
       ...parameters
     });
@@ -25386,7 +25436,8 @@ var WorkflowContext = class {
     debug,
     initialPayload,
     env,
-    retries
+    retries,
+    telemetry
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -25397,7 +25448,7 @@ var WorkflowContext = class {
     this.requestPayload = initialPayload;
     this.env = env ?? {};
     this.retries = retries ?? DEFAULT_RETRIES;
-    this.executor = new AutoExecutor(this, this.steps, debug);
+    this.executor = new AutoExecutor(this, this.steps, telemetry, debug);
   }
   /**
    * Executes a workflow step
@@ -25715,7 +25766,7 @@ function decodeBase64(base64) {
 }
 
 // src/serve/authorization.ts
-var import_qstash7 = require("@upstash/qstash");
+var import_qstash8 = require("@upstash/qstash");
 var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowContext {
   static disabledMessage = "disabled-qstash-worklfow-run";
   /**
@@ -25746,7 +25797,7 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
    */
   static async tryAuthentication(routeFunction, context) {
     const disabledContext = new _DisabledWorkflowContext({
-      qstashClient: new import_qstash7.Client({
+      qstashClient: new import_qstash8.Client({
         baseUrl: "disabled-client",
         token: "disabled-client"
       }),
@@ -25910,7 +25961,7 @@ var parseRequest = async (requestPayload, isFirstInvocation, workflowRunId, requ
     };
   }
 };
-var handleFailure = async (request, requestPayload, qstashClient, initialPayloadParser, routeFunction, failureFunction, debug) => {
+var handleFailure = async (request, requestPayload, qstashClient, initialPayloadParser, routeFunction, failureFunction, env, retries, debug) => {
   if (request.headers.get(WORKFLOW_FAILURE_HEADER) !== "true") {
     return ok("not-failure-callback");
   }
@@ -25935,7 +25986,11 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       steps: [],
       url,
       failureUrl: url,
-      debug
+      debug,
+      env,
+      retries,
+      telemetry: void 0
+      // not going to make requests in authentication check
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -25960,15 +26015,15 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
 };
 
 // src/serve/options.ts
-var import_qstash8 = require("@upstash/qstash");
 var import_qstash9 = require("@upstash/qstash");
+var import_qstash10 = require("@upstash/qstash");
 var processOptions = (options) => {
   const environment = options?.env ?? (typeof process === "undefined" ? {} : process.env);
   const receiverEnvironmentVariablesSet = Boolean(
     environment.QSTASH_CURRENT_SIGNING_KEY && environment.QSTASH_NEXT_SIGNING_KEY
   );
   return {
-    qstashClient: new import_qstash9.Client({
+    qstashClient: new import_qstash10.Client({
       baseUrl: environment.QSTASH_URL,
       token: environment.QSTASH_TOKEN
     }),
@@ -26002,7 +26057,7 @@ var processOptions = (options) => {
         throw error;
       }
     },
-    receiver: receiverEnvironmentVariablesSet ? new import_qstash8.Receiver({
+    receiver: receiverEnvironmentVariablesSet ? new import_qstash9.Receiver({
       currentSigningKey: environment.QSTASH_CURRENT_SIGNING_KEY,
       nextSigningKey: environment.QSTASH_NEXT_SIGNING_KEY
     }) : void 0,
@@ -26010,6 +26065,7 @@ var processOptions = (options) => {
     env: environment,
     retries: DEFAULT_RETRIES,
     useJSONContent: false,
+    disableTelemetry: false,
     ...options
   };
 };
@@ -26044,7 +26100,7 @@ var determineUrls = async (request, url, baseUrl, failureFunction, failureUrl, d
 var AUTH_FAIL_MESSAGE = `Failed to authenticate Workflow request. If this is unexpected, see the caveat https://upstash.com/docs/workflow/basics/caveats#avoid-non-deterministic-code-outside-context-run`;
 
 // src/serve/index.ts
-var serveBase = (routeFunction, options) => {
+var serveBase = (routeFunction, telemetry, options) => {
   const {
     qstashClient,
     onStepFinish,
@@ -26057,8 +26113,10 @@ var serveBase = (routeFunction, options) => {
     baseUrl,
     env,
     retries,
-    useJSONContent
+    useJSONContent,
+    disableTelemetry
   } = processOptions(options);
+  telemetry = disableTelemetry ? void 0 : telemetry;
   const debug = WorkflowLogger.getLogger(verbose);
   const handler = async (request) => {
     await debug?.log("INFO", "ENDPOINT_START");
@@ -26094,7 +26152,10 @@ var serveBase = (routeFunction, options) => {
       qstashClient,
       initialPayloadParser,
       routeFunction,
-      failureFunction
+      failureFunction,
+      env,
+      retries,
+      debug
     );
     if (failureCheck.isErr()) {
       throw failureCheck.error;
@@ -26112,7 +26173,8 @@ var serveBase = (routeFunction, options) => {
       failureUrl: workflowFailureUrl,
       debug,
       env,
-      retries
+      retries,
+      telemetry
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -26128,22 +26190,23 @@ var serveBase = (routeFunction, options) => {
         "auth-fail"
       );
     }
-    const callReturnCheck = await handleThirdPartyCallResult(
+    const callReturnCheck = await handleThirdPartyCallResult({
       request,
-      rawInitialPayload,
-      qstashClient,
+      requestPayload: rawInitialPayload,
+      client: qstashClient,
       workflowUrl,
-      workflowFailureUrl,
+      failureUrl: workflowFailureUrl,
       retries,
+      telemetry,
       debug
-    );
+    });
     if (callReturnCheck.isErr()) {
       await debug?.log("ERROR", "SUBMIT_THIRD_PARTY_RESULT", {
         error: callReturnCheck.error.message
       });
       throw callReturnCheck.error;
     } else if (callReturnCheck.value === "continue-workflow") {
-      const result = isFirstInvocation ? await triggerFirstInvocation(workflowContext, retries, useJSONContent, debug) : await triggerRouteFunction({
+      const result = isFirstInvocation ? await triggerFirstInvocation({ workflowContext, useJSONContent, telemetry, debug }) : await triggerRouteFunction({
         onStep: async () => routeFunction(workflowContext),
         onCleanup: async () => {
           await triggerWorkflowDelete(workflowContext, debug);
@@ -26204,7 +26267,12 @@ function serve(routeFunction, options) {
       body: requestBody
     });
     const { handler: serveHandler } = serveBase(
-      (workflowContext) => routeFunction(workflowContext),
+      routeFunction,
+      {
+        sdk: SDK_TELEMETRY,
+        framework: "express",
+        runtime: process.versions.bun ? `bun@${process.versions.bun}/node@${process.version}` : `node@${process.version}`
+      },
       {
         ...options,
         useJSONContent: true

package/express.mjs

@@ -1,9 +1,10 @@
 import {
+  SDK_TELEMETRY,
   __commonJS,
   __require,
   __toESM,
   serveBase
-} from "./chunk-QBJ3LQIO.mjs";
+} from "./chunk-ETDFMXER.mjs";
 
 // node_modules/depd/index.js
 var require_depd = __commonJS({
@@ -23690,7 +23691,12 @@ function serve(routeFunction, options) {
       body: requestBody
     });
     const { handler: serveHandler } = serveBase(
-      (workflowContext) => routeFunction(workflowContext),
+      routeFunction,
+      {
+        sdk: SDK_TELEMETRY,
+        framework: "express",
+        runtime: process.versions.bun ? `bun@${process.versions.bun}/node@${process.version}` : `node@${process.version}`
+      },
       {
         ...options,
         useJSONContent: true

package/h3.d.mts

@@ -1,5 +1,5 @@
 import * as h3 from 'h3';
-import { R as RouteFunction, j as PublicServeOptions } from './types-R9q4MUwl.mjs';
+import { R as RouteFunction, j as PublicServeOptions } from './types-Bt4-paRy.mjs';
 import '@upstash/qstash';
 
 declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: PublicServeOptions<TInitialPayload>) => {

package/h3.d.ts

@@ -1,5 +1,5 @@
 import * as h3 from 'h3';
-import { R as RouteFunction, j as PublicServeOptions } from './types-R9q4MUwl.js';
+import { R as RouteFunction, j as PublicServeOptions } from './types-Bt4-paRy.js';
 import '@upstash/qstash';
 
 declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: PublicServeOptions<TInitialPayload>) => {