@embed-ai/sdk 0.1.3 → 0.2.1

package/README.md

@@ -330,7 +330,7 @@ await client.feed.byWalletAddress(walletAddress: string, options?: FeedOptions)
 // Feed management to create new feeds and manage these custom feeds e.g. as custom feed per user in your app, which can be built on top of base feeds
 await client.feed.createConfig(options: CreateFeedOptions)
 await client.feed.getConfig(configId: string)
-await client.feed.listConfigs(visibility?: "private" | "public")
+await client.feed.listConfigs(visibility?: "private" | "template" | "public")
 await client.feed.updateConfig(options: UpdateFeedOptions)
 ```
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@embed-ai/sdk",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "main": "src/index.js",
   "license": "BSD-3-Clause",
   "description": "The typescript sdk package for embed AI APIs.",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ZKAI-Network/embed-sdk/",
+    "url": "git+https://github.com/ZKAI-Network/embed-sdk.git",
     "directory": "packages/sdk"
   },
   "files": [
@@ -26,11 +26,20 @@
     "build-annotate": "babel dist --plugins annotate-pure-calls --out-dir dist --source-maps",
     "fix-deps": "bun scripts/fix-deps.js",
     "check": "tsc -b tsconfig.json",
-    "test": "vitest",
+    "test": "echo '⚠️  No unit tests available - SDK tests require API keys' && echo '   Run test:integration instead'",
+    "test:integration": "vitest run --reporter=verbose",
+    "test:ui": "vitest --ui",
+    "test:posts": "vitest run test/search-posts.test.ts",
+    "test:users": "vitest run test/search-users.test.ts",
+    "test:feed": "vitest run test/feed.test.ts",
     "coverage": "vitest --coverage"
   },
   "dependencies": {
-    "@embed-ai/types": "^0.1.2"
+    "@embed-ai/types": "^0.1.4"
+  },
+  "devDependencies": {
+    "@effect/vitest": "latest",
+    "vitest": "latest"
   },
   "peerDependencies": {
     "effect": ">=3.0.0"

package/src/client.js

@@ -63,7 +63,7 @@ class HttpClient {
   constructor(config) {
     this.config = {
       baseUrl: config.baseUrl ?? DEFAULT_CONFIG.baseUrl,
-      title: config.title ?? DEFAULT_CONFIG.title,
+      title: config.title ?? "",
       referer: config.referer ?? "",
       token: config.token,
       retry: {
@@ -105,14 +105,19 @@ class HttpClient {
     const url = this.buildUrl(endpoint, baseUrl, queryParams);
     return Effect.tryPromise({
       try: async () => {
+        const headers = {
+          "Authorization": useBasicAuth ? `Basic ${this.config.token}` : `Bearer ${this.config.token}`,
+          "Accept": "application/json"
+        };
+        if (this.config.referer) {
+          headers["HTTP-Referer"] = this.config.referer;
+        }
+        if (this.config.title) {
+          headers["X-Title"] = this.config.title;
+        }
         const requestOptions = {
           method,
-          headers: {
-            "Authorization": useBasicAuth ? `Basic ${this.config.token}` : `Bearer ${this.config.token}`,
-            "Accept": "application/json",
-            "HTTP-Referer": this.config.referer,
-            "X-Title": this.config.title
-          }
+          headers
         };
         // Add Content-Type and body for POST/PATCH requests
         if (method !== "GET" && body) {

package/src/feed/feed.js

@@ -16,7 +16,7 @@ async function byUserId(httpClient, userId, feedId, options) {
     feed_id: feedId,
     ...options
   };
-  const response = await httpClient.post("/v2/farcaster/casts/feed/for-you", params);
+  const response = await httpClient.post("/v3/for-you", params);
   return [...response.body];
 }
 async function byWalletAddress(httpClient, walletAddress, feedId, options) {
@@ -30,7 +30,7 @@ async function byWalletAddress(httpClient, walletAddress, feedId, options) {
     feed_id: feedId,
     ...options
   };
-  const response = await httpClient.post("/v2/farcaster/casts/feed/for-you", params);
+  const response = await httpClient.post("/v3/for-you", params);
   return [...response.body];
 }
 //# sourceMappingURL=feed.js.map

package/src/feed/namespace.d.ts

@@ -40,7 +40,7 @@ export declare class FeedNamespace {
      * console.log(feed[0].metadata?.author.username) // Access author username
      * ```
      */
-    byUserId(userId: string, feedId?: string, options?: FeedOptions): Promise<ForYouResponse>;
+    byUserId(userId: string, feedId: string, options?: FeedOptions): Promise<ForYouResponse>;
     /**
      * Get personalized "For You" feed by wallet address
      *

package/src/search/namespace.d.ts

@@ -1,5 +1,6 @@
-import type { AllLabels, LabelCategories, UserLabelsResponse, UserSemanticSearchResponse, UserSimilarityResponse, UserTopByLabelResponse } from "@embed-ai/types";
+import type { AllLabels, LabelCategories, PostLabelsResponse, PostSemanticSearchResponse, UserLabelsResponse, UserSemanticSearchResponse, UserSimilarityResponse, UserTopByLabelResponse } from "@embed-ai/types";
 import type { IHttpClient } from "../interfaces/index.js";
+import type { PostLabelsOptions, PostSemanticSearchOptions } from "./post.js";
 import type { UserLabelsOptions, UserSemanticSearchOptions, UserSimilarOptions, UserTopByLabelOptions } from "./user.js";
 /**
  * Users namespace containing all user search operations
@@ -98,6 +99,64 @@ export declare class UsersNamespace {
      */
     getLabels(userList: Array<string>, labelCategory?: LabelCategories, options?: UserLabelsOptions): Promise<UserLabelsResponse>;
 }
+/**
+ * Posts namespace containing all post search operations
+ *
+ * @example
+ * ```typescript
+ * const client = getClient('your-api-key')
+ *
+ * // Get labels for posts
+ * const postLabels = await client.search.posts.getLabels(['0x123...', '0x456...'])
+ *
+ * // Search posts by query
+ * const posts = await client.search.posts.byQuery('web3 developments')
+ * ```
+ */
+export declare class PostsNamespace {
+    private http;
+    constructor(http: IHttpClient);
+    /**
+     * Get AI labels for a list of casts
+     *
+     * @param itemsList - Array of cast IDs to get labels for
+     * @param labelCategory - The category of labels to retrieve (default: "all")
+     * @param options - Optional configuration
+     * @returns Promise<PostLabelsResponse> - Array of casts with their AI labels
+     *
+     * @example
+     * ```typescript
+     * const client = getClient("your-api-key")
+     * const postLabels = await client.search.posts.getLabels([
+     *   "0x4888649440c8cfd3ef6e28f2096a201d20253176",
+     *   "0x0ecf95b73aa54d583877821ece241e94de701404"
+     * ], "moderation")
+     * console.log(postLabels[0].moderation[0].label) // "sexual"
+     * console.log(postLabels[0].moderation[0].score) // 0.0006675918
+     * ```
+     */
+    getLabels(itemsList: Array<string>, labelCategory?: LabelCategories, options?: PostLabelsOptions): Promise<PostLabelsResponse>;
+    /**
+     * Search for casts by semantic query
+     *
+     * @param query - The text query to search for similar casts
+     * @param options - Optional configuration with top_k (default: 10, max: 100), return_ai_labels, return_metadata, and filters
+     * @returns Promise<PostSemanticSearchResponse> - Array of posts with item_id and scores
+     *
+     * @example
+     * ```typescript
+     * const client = getClient("your-api-key")
+     * const posts = await client.search.posts.byQuery("web3 developments", {
+     *   top_k: 10,
+     *   return_ai_labels: true,
+     *   return_metadata: true
+     * })
+     * console.log(posts[0].item_id) // "0x4c8e2e329dc481f4c445ff8c367a1df4a8694317"
+     * console.log(posts[0].score) // 0.864244163
+     * ```
+     */
+    byQuery(query: string, options?: PostSemanticSearchOptions): Promise<PostSemanticSearchResponse>;
+}
 /**
  * Search namespace containing all search-related operations
  *
@@ -108,11 +167,16 @@ export declare class UsersNamespace {
  * // Access user search methods
  * const similarUsers = await client.search.users.similar('16085')
  * const searchResults = await client.search.users.byQuery('web3 developers')
+ *
+ * // Access post search methods
+ * const posts = await client.search.posts.byQuery('web3 developments')
+ * const postLabels = await client.search.posts.getLabels(['0x123...'])
  * ```
  */
 export declare class SearchNamespace {
     private http;
     readonly users: UsersNamespace;
+    readonly posts: PostsNamespace;
     constructor(http: IHttpClient);
 }
 //# sourceMappingURL=namespace.d.ts.map

package/src/search/namespace.js

@@ -3,7 +3,8 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.SearchNamespace = exports.UsersNamespace = void 0;
+exports.SearchNamespace = exports.PostsNamespace = exports.UsersNamespace = void 0;
+const post_js_1 = /*#__PURE__*/require("./post.js");
 const user_js_1 = /*#__PURE__*/require("./user.js");
 /**
  * Users namespace containing all user search operations
@@ -113,6 +114,71 @@ class UsersNamespace {
   }
 }
 exports.UsersNamespace = UsersNamespace;
+/**
+ * Posts namespace containing all post search operations
+ *
+ * @example
+ * ```typescript
+ * const client = getClient('your-api-key')
+ *
+ * // Get labels for posts
+ * const postLabels = await client.search.posts.getLabels(['0x123...', '0x456...'])
+ *
+ * // Search posts by query
+ * const posts = await client.search.posts.byQuery('web3 developments')
+ * ```
+ */
+class PostsNamespace {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get AI labels for a list of casts
+   *
+   * @param itemsList - Array of cast IDs to get labels for
+   * @param labelCategory - The category of labels to retrieve (default: "all")
+   * @param options - Optional configuration
+   * @returns Promise<PostLabelsResponse> - Array of casts with their AI labels
+   *
+   * @example
+   * ```typescript
+   * const client = getClient("your-api-key")
+   * const postLabels = await client.search.posts.getLabels([
+   *   "0x4888649440c8cfd3ef6e28f2096a201d20253176",
+   *   "0x0ecf95b73aa54d583877821ece241e94de701404"
+   * ], "moderation")
+   * console.log(postLabels[0].moderation[0].label) // "sexual"
+   * console.log(postLabels[0].moderation[0].score) // 0.0006675918
+   * ```
+   */
+  async getLabels(itemsList, labelCategory = "all", options) {
+    return (0, post_js_1.getLabels)(this.http, itemsList, labelCategory, options);
+  }
+  /**
+   * Search for casts by semantic query
+   *
+   * @param query - The text query to search for similar casts
+   * @param options - Optional configuration with top_k (default: 10, max: 100), return_ai_labels, return_metadata, and filters
+   * @returns Promise<PostSemanticSearchResponse> - Array of posts with item_id and scores
+   *
+   * @example
+   * ```typescript
+   * const client = getClient("your-api-key")
+   * const posts = await client.search.posts.byQuery("web3 developments", {
+   *   top_k: 10,
+   *   return_ai_labels: true,
+   *   return_metadata: true
+   * })
+   * console.log(posts[0].item_id) // "0x4c8e2e329dc481f4c445ff8c367a1df4a8694317"
+   * console.log(posts[0].score) // 0.864244163
+   * ```
+   */
+  async byQuery(query, options) {
+    return (0, post_js_1.byQuery)(this.http, query, options);
+  }
+}
+exports.PostsNamespace = PostsNamespace;
 /**
  * Search namespace containing all search-related operations
  *
@@ -123,14 +189,20 @@ exports.UsersNamespace = UsersNamespace;
  * // Access user search methods
  * const similarUsers = await client.search.users.similar('16085')
  * const searchResults = await client.search.users.byQuery('web3 developers')
+ *
+ * // Access post search methods
+ * const posts = await client.search.posts.byQuery('web3 developments')
+ * const postLabels = await client.search.posts.getLabels(['0x123...'])
  * ```
  */
 class SearchNamespace {
   http;
   users;
+  posts;
   constructor(http) {
     this.http = http;
     this.users = new UsersNamespace(this.http);
+    this.posts = new PostsNamespace(this.http);
   }
 }
 exports.SearchNamespace = SearchNamespace;

package/src/search/post.d.ts

@@ -0,0 +1,45 @@
+import type { LabelCategories, LabelsForItems, PostLabelsResponse, PostSemanticSearchResponse, SemanticSearch } from "@embed-ai/types";
+import type { IHttpClient } from "../interfaces/index.js";
+export type PostLabelsOptions = Omit<LabelsForItems, "items_list" | "label_category">;
+export type PostSemanticSearchOptions = Omit<SemanticSearch, "query">;
+/**
+ * Get AI labels for a list of casts
+ *
+ * @param httpClient - HTTP client instance
+ * @param itemsList - Array of cast IDs to get labels for
+ * @param labelCategory - The category of labels to retrieve (default: "all")
+ * @param options - Optional configuration
+ * @returns Promise<PostLabelsResponse> - Array of casts with their AI labels
+ *
+ * @example
+ * ```typescript
+ * const postLabels = await client.search.posts.getLabels([
+ *   "0x4888649440c8cfd3ef6e28f2096a201d20253176",
+ *   "0x0ecf95b73aa54d583877821ece241e94de701404"
+ * ], "moderation")
+ * console.log(postLabels[0].moderation[0].label) // "sexual"
+ * console.log(postLabels[0].moderation[0].score) // 0.0006675918
+ * ```
+ */
+export declare function getLabels(httpClient: IHttpClient, itemsList: Array<string>, labelCategory?: LabelCategories, options?: PostLabelsOptions): Promise<PostLabelsResponse>;
+/**
+ * Search for casts by semantic query
+ *
+ * @param httpClient - HTTP client instance
+ * @param query - The text query to search for similar casts
+ * @param options - Optional configuration with top_k (default: 10, max: 100), return_ai_labels, return_metadata, and filters
+ * @returns Promise<PostSemanticSearchResponse> - Object with items_list containing cast IDs and scores
+ *
+ * @example
+ * ```typescript
+ * const posts = await client.search.posts.byQuery("web3 developments", {
+ *   top_k: 10,
+ *   return_ai_labels: true,
+ *   return_metadata: true
+ * })
+ * console.log(posts.items_list[0].item_id) // "0x4c8e2e329dc481f4c445ff8c367a1df4a8694317"
+ * console.log(posts.items_list[0].score) // 0.864244163
+ * ```
+ */
+export declare function byQuery(httpClient: IHttpClient, query: string, options?: PostSemanticSearchOptions): Promise<PostSemanticSearchResponse>;
+//# sourceMappingURL=post.d.ts.map

package/src/search/post.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getLabels = getLabels;
+exports.byQuery = byQuery;
+/**
+ * Get AI labels for a list of casts
+ *
+ * @param httpClient - HTTP client instance
+ * @param itemsList - Array of cast IDs to get labels for
+ * @param labelCategory - The category of labels to retrieve (default: "all")
+ * @param options - Optional configuration
+ * @returns Promise<PostLabelsResponse> - Array of casts with their AI labels
+ *
+ * @example
+ * ```typescript
+ * const postLabels = await client.search.posts.getLabels([
+ *   "0x4888649440c8cfd3ef6e28f2096a201d20253176",
+ *   "0x0ecf95b73aa54d583877821ece241e94de701404"
+ * ], "moderation")
+ * console.log(postLabels[0].moderation[0].label) // "sexual"
+ * console.log(postLabels[0].moderation[0].score) // 0.0006675918
+ * ```
+ */
+async function getLabels(httpClient, itemsList, labelCategory = "all", options) {
+  const params = {
+    items_list: itemsList,
+    label_category: labelCategory,
+    ...options
+  };
+  const response = await httpClient.post("/v2/farcaster/casts/labels/for-items", params);
+  return response.body;
+}
+/**
+ * Search for casts by semantic query
+ *
+ * @param httpClient - HTTP client instance
+ * @param query - The text query to search for similar casts
+ * @param options - Optional configuration with top_k (default: 10, max: 100), return_ai_labels, return_metadata, and filters
+ * @returns Promise<PostSemanticSearchResponse> - Object with items_list containing cast IDs and scores
+ *
+ * @example
+ * ```typescript
+ * const posts = await client.search.posts.byQuery("web3 developments", {
+ *   top_k: 10,
+ *   return_ai_labels: true,
+ *   return_metadata: true
+ * })
+ * console.log(posts.items_list[0].item_id) // "0x4c8e2e329dc481f4c445ff8c367a1df4a8694317"
+ * console.log(posts.items_list[0].score) // 0.864244163
+ * ```
+ */
+async function byQuery(httpClient, query, options) {
+  const top_k = options?.top_k ?? 10;
+  const params = {
+    query,
+    top_k,
+    ...options
+  };
+  const response = await httpClient.post("/v2/farcaster/casts/search/semantic", params);
+  // Handle both response formats - sometimes it's a direct array, sometimes it's wrapped in items_list
+  if (Array.isArray(response.body)) {
+    return response.body;
+  } else {
+    return response.body.items_list;
+  }
+}
+//# sourceMappingURL=post.js.map

package/src/search/item.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=item.d.ts.map

package/src/search/item.js

@@ -1,6 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-//# sourceMappingURL=item.js.map