@upstash/workflow 0.1.1-canary-2 → 0.1.2-canary-astro

package/README.md

@@ -1,3 +1,120 @@
-# Upstash Workflow
+# Upstash Workflow SDK
 
-Durable, Reliable and Performant Serverless Functions
+![npm (scoped)](https://img.shields.io/npm/v/@upstash/workflow)
+
+> [!NOTE]  
+> **This project is in GA Stage.**
+> The Upstash Professional Support fully covers this project. It receives regular updates, and bug fixes.
+> The Upstash team is committed to maintaining and improving its functionality.
+
+**Upstash Workflow** lets you write durable, reliable and performant serverless functions. Get delivery guarantees, automatic retries on failure, scheduling and more without managing any infrastructure.
+
+See [the documentation](https://upstash.com/docs/workflow/getstarted) for more details
+
+## Quick Start
+
+Here, we will briefly showcase how you can get started with Upstash Workflow.
+
+Alternatively, you can check [our quickstarts for different frameworks](https://upstash.com/docs/workflow/quickstarts/platforms), including [Next.js](https://upstash.com/docs/qstash/workflow/quickstarts/vercel-nextjs) and [Cloudflare](https://upstash.com/docs/workflow/quickstarts/cloudflare-workers).
+
+### Install
+
+First, install the package with:
+
+```
+npm install @upstash/workflow
+```
+
+### Get QStash token
+
+Go to [Upstash Console](https://console.upstash.com/qstash) and copy the QSTASH_TOKEN.
+
+### Define a Workflow Endpoint
+
+To declare workflow endpoints, use the `serve` method:
+
+```ts
+import { serve } from "@upstash/workflow/nextjs";
+
+// mock function
+const someWork = (input: string) => {
+  return `processed '${JSON.stringify(input)}'`;
+};
+
+// serve endpoint which expects a string payload:
+export const { POST } = serve<string>(async (context) => {
+  // get request body:
+  const input = context.requestPayload;
+
+  // run the first step:
+  const result1 = await context.run("step1", async () => {
+    const output = someWork(input);
+    console.log("step 1 input", input, "output", output);
+    return output;
+  });
+
+  // run the second step:
+  await context.run("step2", async () => {
+    const output = someWork(result1);
+    console.log("step 2 input", result1, "output", output);
+  });
+});
+```
+
+In the example, you can see that steps are declared through the `context` object.
+
+The kinds of steps which are available are:
+
+- `context.run`: execute a function
+- `context.sleep`: sleep for some time
+- `context.sleepUntil`: sleep until some timestamp
+- `context.call`: make a third party call without consuming any runtime
+- `context.waitForEvent`: wait for an event
+- `context.notify`: notify an event to make workflows waiting for the event continue
+
+You can [learn more about these methods from our documentation](https://upstash.com/docs/workflow/basics/context).
+
+### Workflow Client
+
+You can use [the Upstash Workflow client](https://upstash.com/docs/workflow/basics/client) to cancel workflows, notify workflows
+waiting for an event or get the workflows waiting for an event:
+
+```ts
+import { Client } from "@upstash/workflow";
+const client = new Client({ token: "<QSTASH_TOKEN>" });
+
+// cancel workflow:
+await client.cancel({ workflowRunId: "<WORKFLOW_RUN_ID>" });
+
+// notify workflows:
+await client.notify({
+  eventId: "my-event-id",
+  eventData: "my-data", // data passed to the workflow run
+});
+
+// get waiters:
+const result = await client.getWaiters({
+  eventId: "my-event-id",
+});
+```
+
+## Contributing
+
+### Setup
+
+This project requires [Bun](https://bun.sh/) to be installed. Please see the [Bun installation documentation](https://bun.sh/docs/installation) for further instructions.
+
+Once you have cloned the project, you will need to install the dependencies and then you can run the project.
+
+```sh
+bun install
+bun run build
+```
+
+### Testing
+
+To begin testing, environment variables will need to be setup. First, create a `.env` file in the root of the project. [`.env.template`](/.env.template) can be used as a template. Your values can be found in the [Qstash Console](https://console.upstash.com/qstash).
+
+```sh
+bun run test
+```

package/astro.d.mts

@@ -0,0 +1,9 @@
+import { APIContext, APIRoute } from 'astro';
+import { b as WorkflowContext, W as WorkflowServeOptions } from './types-p7sxktVE.mjs';
+import '@upstash/qstash';
+
+declare function serve<TInitialPayload = unknown>(routeFunction: (workflowContext: WorkflowContext<TInitialPayload>, apiContext: APIContext) => Promise<void>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">): {
+    POST: APIRoute;
+};
+
+export { serve };

package/astro.d.ts

@@ -0,0 +1,9 @@
+import { APIContext, APIRoute } from 'astro';
+import { b as WorkflowContext, W as WorkflowServeOptions } from './types-p7sxktVE.js';
+import '@upstash/qstash';
+
+declare function serve<TInitialPayload = unknown>(routeFunction: (workflowContext: WorkflowContext<TInitialPayload>, apiContext: APIContext) => Promise<void>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">): {
+    POST: APIRoute;
+};
+
+export { serve };