@embed-ai/sdk 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embed-ai/sdk",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "src/index.js",
   "license": "BSD-3-Clause",
   "description": "The typescript sdk package for embed AI APIs.",
@@ -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.3"
+  },
+  "devDependencies": {
+    "@effect/vitest": "latest",
+    "vitest": "latest"
   },
   "peerDependencies": {
     "effect": ">=3.0.0"

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