@upstash/qstash 2.6.3 → 2.6.4-workflow-alpha.0

package/README.md

@@ -55,11 +55,11 @@ import { Client } from "@upstash/qstash";
  */
 import "isomorphic-fetch";
 
-const client = new Client({
+const c = new Client({
   token: "<QSTASH_TOKEN>",
 });
 
-const res = await client.publishJSON({
+const res = await c.publishJSON({
   url: "https://my-api...",
   // or urlGroup: "the name or id of a url group"
   body: {
@@ -107,7 +107,7 @@ No need for complicated setup your LLM request. We'll call LLM and schedule it f
 ```ts
 import { Client, openai } from "@upstash/qstash";
 
-const client = new Client({
+const c = new Client({
   token: "<QSTASH_TOKEN>",
 });
 
@@ -131,11 +131,7 @@ const result = await client.publishJSON({
 You can easily start streaming Upstash or OpenAI responses from your favorite framework(Next.js) or library
 
 ```ts
-import { Client, upstash } from "@upstash/qstash";
-
-const client = new Client({
-  token: "<QSTASH_TOKEN>",
-});
+import { upstash } from "@upstash/qstash";
 
 const response = await client.chat().create({
   provider: upstash(), // Optionally, provider: "custom({token: "XXX", baseUrl: "https://api.openai.com"})". This will allow you to call every OpenAI compatible API out there.
@@ -155,43 +151,6 @@ const response = await client.chat().create({
 });
 ```
 
-### Add Observability via Helicone
-
-Helicone is a powerful observability platform that provides valuable insights into your LLM usage. Integrating Helicone with QStash is straightforward.
-
-To enable Helicone observability in QStash, you simply need to pass your Helicone API key when initializing your model. Here's how to do it for both custom models and OpenAI:
-
-#### For Custom Models (e.g., Meta-Llama)
-
-```ts
-import { Client, custom } from "@upstash/qstash";
-
-const client = new Client({
-  token: "<QSTASH_TOKEN>",
-});
-
-await client.publishJSON({
-  api: {
-    name: "llm",
-    provider: custom({
-      token: "XXX",
-      baseUrl: "https://api.together.xyz",
-    }),
-    analytics: { name: "helicone", token: process.env.HELICONE_API_KEY! },
-  },
-  body: {
-    model: "meta-llama/Llama-3-8b-chat-hf",
-    messages: [
-      {
-        role: "user",
-        content: "hello",
-      },
-    ],
-  },
-  callback: "https://oz.requestcatcher.com/",
-});
-```
-
 ## Docs
 
 See [the documentation](https://docs.upstash.com/qstash) for details.
@@ -199,7 +158,3 @@ See [the documentation](https://docs.upstash.com/qstash) for details.
 ## Contributing
 
 ### [Install Deno](https://deno.land/#installation)
-
-```
-
-```

package/dist/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Upstash, Inc.
+
+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/dist/README.md

@@ -0,0 +1,160 @@
+# Upstash QStash SDK
+
+![npm (scoped)](https://img.shields.io/npm/v/@upstash/qstash)
+
+> [!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.
+
+**QStash** is an HTTP based messaging and scheduling solution for serverless and
+edge runtimes.
+
+It is 100% built on stateless HTTP requests and designed for:
+
+- Serverless functions (AWS Lambda ...)
+- Cloudflare Workers (see
+  [the example](https://github.com/upstash/sdk-qstash-ts/tree/main/examples/cloudflare-workers))
+- Fastly Compute@Edge
+- Next.js, including [edge](https://nextjs.org/docs/api-reference/edge-runtime)
+- Deno
+- Client side web/mobile applications
+- WebAssembly
+- and other environments where HTTP is preferred over TCP.
+
+## How does QStash work?
+
+QStash is the message broker between your serverless apps. You send an HTTP
+request to QStash, that includes a destination, a payload and optional settings.
+We durably store your message and will deliver it to the destination API via
+HTTP. In case the destination is not ready to receive the message, we will retry
+the message later, to guarentee at-least-once delivery.
+
+## Quick Start
+
+### Install
+
+#### npm
+
+```bash
+npm install @upstash/qstash
+```
+
+### Get your authorization token
+
+Go to [Upstash Console](https://console.upstash.com/qstash) and copy the QSTASH_TOKEN.
+
+## Basic Usage:
+
+### Publishing a message
+
+```ts
+import { Client } from "@upstash/qstash";
+/**
+ * Import a fetch polyfill only if you are using node prior to v18.
+ * This is not necessary for nextjs, deno or cloudflare workers.
+ */
+import "isomorphic-fetch";
+
+const c = new Client({
+  token: "<QSTASH_TOKEN>",
+});
+
+const res = await c.publishJSON({
+  url: "https://my-api...",
+  // or urlGroup: "the name or id of a url group"
+  body: {
+    hello: "world",
+  },
+});
+console.log(res);
+// { messageId: "msg_xxxxxxxxxxxxxxxx" }
+```
+
+### Receiving a message
+
+How to receive a message depends on your http server. The `Receiver.verify`
+method should be called by you as the first step in your handler function.
+
+```ts
+import { Receiver } from "@upstash/qstash";
+
+const r = new Receiver({
+  currentSigningKey: "..",
+  nextSigningKey: "..",
+});
+
+const isValid = await r.verify({
+  /**
+   * The signature from the `Upstash-Signature` header.
+   *
+   * Please note that on some platforms (e.g. Vercel or Netlify) you might
+   * receive the header in lower case: `upstash-signature`
+   *
+   */
+  signature: "string";
+
+  /**
+   * The raw request body.
+   */
+  body: "string";
+})
+```
+
+### Publishing a message to Open AI or any Open AI Compatible LLM
+
+No need for complicated setup your LLM request. We'll call LLM and schedule it for your serverless needs.
+
+```ts
+import { Client, openai } from "@upstash/qstash";
+
+const c = new Client({
+  token: "<QSTASH_TOKEN>",
+});
+
+const result = await client.publishJSON({
+  api: { name: "llm", provider: openai({ token: process.env.OPENAI_API_KEY! }) },
+  body: {
+    model: "gpt-3.5-turbo",
+    messages: [
+      {
+        role: "user",
+        content: "Where is the capital of Turkey?",
+      },
+    ],
+  },
+  callback: "https://oz.requestcatcher.com/",
+});
+```
+
+### Chatting with your favorite LLM
+
+You can easily start streaming Upstash or OpenAI responses from your favorite framework(Next.js) or library
+
+```ts
+import { upstash } from "@upstash/qstash";
+
+const response = await client.chat().create({
+  provider: upstash(), // Optionally, provider: "custom({token: "XXX", baseUrl: "https://api.openai.com"})". This will allow you to call every OpenAI compatible API out there.
+  model: "meta-llama/Meta-Llama-3-8B-Instruct", // Optionally, model: "gpt-3.5-turbo",
+  messages: [
+    {
+      role: "system",
+      content: "from now on, foo is whale",
+    },
+    {
+      role: "user",
+      content: "what exactly is foo?",
+    },
+  ],
+  stream: true,
+  temperature: 0.5,
+});
+```
+
+## Docs
+
+See [the documentation](https://docs.upstash.com/qstash) for details.
+
+## Contributing
+
+### [Install Deno](https://deno.land/#installation)