@avaprotocol/sdk-js 1.3.6 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,70 @@
+# @avaprotocol/sdk-js
+
+## 1.4.0
+
+### Minor Changes
+
+- 5a4bad7: Added getWorkflowCount and getExecutionCount methods
+- 4769b3c: Added Output and Step properties to Execution response
+
+### Patch Changes
+
+- ba9b001: Sync to the latest grpc_codegen and remove step.outputdata that caused build error
+
+## 1.3.8
+
+### Patch Changes
+
+- Made Client a regular export instead of default
+
+## 1.3.7
+
+### Patch Changes
+
+- Added Secret and TriggerReason
+
+## 1.3.6
+
+### Patch Changes
+
+- Fix the build file problem in 1.3.5
+
+## 1.3.5
+
+### Patch Changes
+
+- b04cca3: Improved secret related code and tests
+
+## 1.3.4
+
+### Patch Changes
+
+- Migrated getKeyRequestMessage to types; Added secret functions
+- Updated dependencies
+  - @avaprotocol/types@0.9.4
+
+## 1.3.3
+
+### Patch Changes
+
+- update the new auth method and trigger matcher array
+
+## 1.3.2
+
+### Patch Changes
+
+- Updated Task.memo to Task.name and fixed a build warning in types package
+- Updated dependencies
+  - @avaprotocol/types@0.9.3
+
+## 1.3.1
+
+### Patch Changes
+
+- Update reference to types
+
+## 1.3.0
+
+### Minor Changes
+
+- Initialize types package

package/README.md

@@ -0,0 +1,122 @@
+# Ava SDK for JavaScript/TypeScript
+
+`@avaprotocol/sdk-js` is a simple, type-safe wrapper around gRPC designed to simplify integration with Ava Protocol’s AVS. It enables developers to interact with Ava Protocol efficiently, whether on the client-side or server-side, and provides full TypeScript support for a seamless development experience.
+
+## Features
+
+- Type-Safe SDK: Automatically generated TypeScript types from gRPC protocol buffers ensure type safety and reduce errors during development.
+- Seamless Integration: Works in both Node.js and browser environments, optimized for frameworks like Next.js.
+- Easy to Use: Abstracts the complexity of gRPC with a simple JavaScript/TypeScript API.
+- Efficient Communication: Leverages gRPC for fast, efficient communication with Ava Protocol’s AVS (Actively Validated Services).
+
+## Installation
+
+To install `@avaprotocol/sdk-js`, run the following command:
+
+```bash
+npm install @avaprotocol/sdk-js
+```
+
+Or with Yarn:
+
+```bash
+yarn add @avaprotocol/sdk-js
+```
+
+## Getting Started
+
+Here’s a quick example of how to use the SDK to get started with Ava Protocol:
+
+```typescript
+import { Client } from "@avaprotocol/sdk-js";
+import { getServerSession } from "next-auth";
+import { isAuthKeyValid } from "./utils";
+import { authOptions } from "./auth/[...nextauth]/route";
+
+let avaClient: Client | null = null;
+const EXPIRED_AT = Math.floor(Date.now() / 1000) + 24 * 60 * 60; // 24 hours from now
+
+async function initializeClient() {
+  if (avaClient) return avaClient;
+
+  if (!process.env.AVS_ENDPOINT) {
+    throw new Error("AVS_ENDPOINT is not set in environment variables.");
+  }
+
+  avaClient = new Client({
+    endpoint: process.env.AVS_ENDPOINT,
+  });
+
+  return avaClient;
+}
+
+/**
+ * Get the client instance, lazy initialize it if it's not initialized yet
+ * @returns
+ */
+export async function getClient() {
+  if (avaClient) {
+    return avaClient;
+  }
+
+  return await initializeClient();
+}
+
+/**
+ * Get the auth key using authWithAPIKey() for a wallet address before user signs in with a wallet signature
+ * @param walletAddress
+ * @returns
+ */
+async function getPresignAuthKey(walletAddress: string): Promise<string> {
+  const client = await getClient();
+
+  // Since we almost certainly need this env variable, we throw an error if it's not set
+  if (!process.env.AVS_API_KEY) {
+    throw new Error("AVS_API_KEY is not set in environment variables.");
+  }
+
+  const resp = await client.authWithAPIKey(
+    walletAddress,
+    process.env.AVS_API_KEY,
+    EXPIRED_AT
+  );
+  return resp.authKey;
+}
+
+/**
+ * Get the auth key for a wallet address
+ * First checks if the current session contains a valid auth key
+ * If not, it will get the auth key using authWithAPIKey() for the wallet address
+ * @param walletAddress
+ * @returns
+ */
+export async function getAuthKey(
+  walletAddress: string | undefined
+): Promise<string | undefined> {
+  const session = await getServerSession(authOptions);
+
+  if (session?.user?.authKey) {
+    if (isAuthKeyValid(session?.user?.authKey)) {
+      return session?.user?.authKey;
+    } else {
+      console.warn(
+        `AuthKey is found for ${session?.user?.walletAddress} in session, but expired. Atempting to use authWithAPIKey`
+      );
+    }
+  }
+
+  if (walletAddress) {
+    return await getPresignAuthKey(walletAddress);
+  }
+
+  return undefined;
+}
+```
+
+## Contributing
+
+We welcome contributions! Feel free to submit pull requests or open issues for any bugs or feature requests.
+
+## License
+
+This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.