@syfthub/sdk 0.1.0 → 0.1.1

package/README.md

@@ -157,9 +157,6 @@ if (client.isAuthenticated) {
 | Variable | Description |
 |----------|-------------|
 | `SYFTHUB_URL` | SyftHub API base URL |
-| `SYFTHUB_ACCOUNTING_URL` | Accounting service URL |
-| `SYFTHUB_ACCOUNTING_EMAIL` | Accounting auth email |
-| `SYFTHUB_ACCOUNTING_PASSWORD` | Accounting auth password |
 
 ## Error Handling
 

package/dist/index.cjs

@@ -606,11 +606,7 @@ var AuthResource = class {
     if (!tokens) {
       throw new exports.AuthenticationError("No refresh token available");
     }
-    const response = await this.http.post(
-      "/api/v1/auth/refresh",
-      { refreshToken: tokens.refreshToken },
-      { includeAuth: false }
-    );
+    const response = await this.http.post("/api/v1/auth/refresh", { refreshToken: tokens.refreshToken }, { includeAuth: false });
     this.http.setTokens(response.accessToken, response.refreshToken);
   }
   /**
@@ -887,22 +883,6 @@ var MyEndpointsResource = class {
     }
     return [parts[0], parts[1]];
   }
-  /**
-   * Resolve an endpoint path to its ID.
-   *
-   * @param path - Endpoint path in "owner/slug" format
-   * @returns The endpoint ID
-   */
-  async resolveEndpointId(path) {
-    const [owner, slug] = this.parsePath(path);
-    const response = await this.http.get(`/${owner}/${slug}`);
-    if (response.id === void 0) {
-      throw new Error(
-        `Could not resolve endpoint ID for '${path}'. Make sure you own this endpoint.`
-      );
-    }
-    return response.id;
-  }
   /**
    * List the current user's endpoints.
    *
@@ -943,8 +923,17 @@ var MyEndpointsResource = class {
    * @throws {AuthorizationError} If not authorized to view
    */
   async get(path) {
-    const [owner, slug] = this.parsePath(path);
-    return this.http.get(`/${owner}/${slug}`);
+    const [, slug] = this.parsePath(path);
+    const endpoints = await this.http.get("/api/v1/endpoints", { limit: 100 });
+    for (const ep of endpoints) {
+      if (ep.slug === slug) {
+        return ep;
+      }
+    }
+    const { NotFoundError: NotFoundError2 } = await Promise.resolve().then(() => (init_errors(), errors_exports));
+    throw new NotFoundError2(
+      `Endpoint not found: '${path}'. No endpoint found with slug '${slug}' in your endpoints.`
+    );
   }
   /**
    * Update an endpoint.
@@ -959,8 +948,8 @@ var MyEndpointsResource = class {
    * @throws {AuthorizationError} If not owner/admin
    */
   async update(path, input) {
-    const endpointId = await this.resolveEndpointId(path);
-    return this.http.patch(`/api/v1/endpoints/${endpointId}`, input);
+    const [, slug] = this.parsePath(path);
+    return this.http.patch(`/api/v1/endpoints/slug/${slug}`, input);
   }
   /**
    * Delete an endpoint.
@@ -971,8 +960,44 @@ var MyEndpointsResource = class {
    * @throws {AuthorizationError} If not owner/admin
    */
   async delete(path) {
-    const endpointId = await this.resolveEndpointId(path);
-    await this.http.delete(`/api/v1/endpoints/${endpointId}`);
+    const [, slug] = this.parsePath(path);
+    await this.http.delete(`/api/v1/endpoints/slug/${slug}`);
+  }
+  /**
+   * Synchronize user's endpoints with provided list.
+   *
+   * This is a DESTRUCTIVE operation that:
+   * 1. Deletes ALL existing endpoints owned by the current user
+   * 2. Creates ALL endpoints from the provided list
+   * 3. Is ATOMIC: either all endpoints sync successfully, or none do
+   *
+   * Important Notes:
+   * - Organization endpoints are NOT affected
+   * - Stars on existing endpoints will be lost (reset to 0)
+   * - Endpoint IDs will change (new IDs assigned)
+   * - Maximum 100 endpoints per sync request
+   *
+   * @param endpoints - List of endpoint specifications to sync.
+   *                    Pass an empty array to delete ALL user endpoints.
+   * @returns SyncEndpointsResponse with synced count, deleted count, and created endpoints
+   * @throws {AuthenticationError} If not authenticated
+   * @throws {ValidationError} If any endpoint fails validation (entire batch rejected)
+   *
+   * @example
+   * // Sync with new endpoints
+   * const result = await client.myEndpoints.sync([
+   *   { name: 'Model A', type: 'model', visibility: 'public' },
+   *   { name: 'Data Source B', type: 'data_source', visibility: 'private' },
+   * ]);
+   * console.log(`Deleted ${result.deleted}, created ${result.synced} endpoints`);
+   *
+   * @example
+   * // Clear all endpoints
+   * const result = await client.myEndpoints.sync([]);
+   * console.log(`Deleted ${result.deleted} endpoints`);
+   */
+  async sync(endpoints = []) {
+    return this.http.post("/api/v1/endpoints/sync", { endpoints });
   }
 };
 
@@ -1047,12 +1072,61 @@ var HubResource = class {
       if (options?.minStars !== void 0) {
         params["minStars"] = options.minStars;
       }
-      return this.http.get(
-        "/api/v1/endpoints/trending",
-        params,
+      return this.http.get("/api/v1/endpoints/trending", params, {
+        includeAuth: false
+      });
+    }, pageSize);
+  }
+  /**
+   * Search for endpoints using semantic search.
+   *
+   * Uses RAG-powered semantic search to find endpoints that match the
+   * natural language query. Returns results sorted by relevance score.
+   *
+   * Note: If RAG is not configured on the server (no OpenAI API key),
+   * this method returns an empty array.
+   *
+   * @param query - Natural language search query (e.g., "machine learning models for image classification")
+   * @param options - Search options (topK, type filter, minScore)
+   * @returns Promise resolving to array of EndpointSearchResult with relevance scores.
+   *          Returns empty array if query is too short (<3 chars) or no matches found.
+   *
+   * @example
+   * // Search for machine learning models
+   * const results = await client.hub.search('image classification models');
+   * for (const result of results) {
+   *   console.log(`${result.ownerUsername}/${result.slug}: ${result.relevanceScore.toFixed(2)}`);
+   * }
+   *
+   * @example
+   * // Filter by type and minimum score
+   * const dataSources = await client.hub.search('customer data', {
+   *   type: EndpointType.DATA_SOURCE,
+   *   minScore: 0.5,
+   * });
+   */
+  async search(query, options = {}) {
+    const { topK = 10, type, minScore = 0 } = options;
+    if (!query || query.trim().length < 3) {
+      return [];
+    }
+    const body = {
+      query: query.trim(),
+      top_k: topK
+    };
+    if (type !== void 0) {
+      body["type"] = type;
+    }
+    try {
+      const response = await this.http.post(
+        "/api/v1/endpoints/search",
+        body,
         { includeAuth: false }
       );
-    }, pageSize);
+      return (response.results ?? []).filter((result) => result.relevanceScore >= minScore);
+    } catch {
+      return [];
+    }
   }
   /**
    * Get an endpoint by its path.
@@ -1085,7 +1159,7 @@ var HubResource = class {
    */
   async star(path) {
     const endpointId = await this.resolveEndpointId(path);
-    await this.http.patch(`/api/v1/endpoints/${endpointId}/star`);
+    await this.http.post(`/api/v1/endpoints/${endpointId}/star`);
   }
   /**
    * Unstar an endpoint.
@@ -1096,7 +1170,7 @@ var HubResource = class {
    */
   async unstar(path) {
     const endpointId = await this.resolveEndpointId(path);
-    await this.http.patch(`/api/v1/endpoints/${endpointId}/unstar`);
+    await this.http.delete(`/api/v1/endpoints/${endpointId}/star`);
   }
   /**
    * Check if you have starred an endpoint.
@@ -1250,9 +1324,9 @@ var AccountingResource = class {
       const response = await fetch(url.toString(), {
         method,
         headers: {
-          "Authorization": this.authHeader,
+          Authorization: this.authHeader,
           "Content-Type": "application/json",
-          "Accept": "application/json"
+          Accept: "application/json"
         },
         body: options?.body ? JSON.stringify(options.body) : void 0,
         signal: controller.signal
@@ -1269,7 +1343,10 @@ var AccountingResource = class {
       if (error instanceof Error && error.name === "AbortError") {
         throw new exports.APIError("Request timeout", 408);
       }
-      throw new exports.APIError(`Accounting request failed: ${error instanceof Error ? error.message : "Unknown error"}`, 0);
+      throw new exports.APIError(
+        `Accounting request failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        0
+      );
     } finally {
       clearTimeout(timeoutId);
     }
@@ -1285,9 +1362,9 @@ var AccountingResource = class {
       const response = await fetch(url.toString(), {
         method,
         headers: {
-          "Authorization": `Bearer ${token}`,
+          Authorization: `Bearer ${token}`,
           "Content-Type": "application/json",
-          "Accept": "application/json"
+          Accept: "application/json"
         },
         body: options?.body ? JSON.stringify(options.body) : void 0,
         signal: controller.signal
@@ -1304,7 +1381,10 @@ var AccountingResource = class {
       if (error instanceof Error && error.name === "AbortError") {
         throw new exports.APIError("Request timeout", 408);
       }
-      throw new exports.APIError(`Accounting request failed: ${error instanceof Error ? error.message : "Unknown error"}`, 0);
+      throw new exports.APIError(
+        `Accounting request failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        0
+      );
     } finally {
       clearTimeout(timeoutId);
     }
@@ -1393,15 +1473,12 @@ var AccountingResource = class {
    */
   getTransactions(options) {
     const pageSize = options?.pageSize ?? 20;
-    return new PageIterator(
-      async (skip, limit) => {
-        const response = await this.request("GET", "/transactions", {
-          params: { skip, limit }
-        });
-        return response.map(parseTransaction);
-      },
-      pageSize
-    );
+    return new PageIterator(async (skip, limit) => {
+      const response = await this.request("GET", "/transactions", {
+        params: { skip, limit }
+      });
+      return response.map(parseTransaction);
+    }, pageSize);
   }
   /**
    * Get a specific transaction by ID.
@@ -1851,7 +1928,11 @@ var ChatResource = class {
         stream: false
       }
     );
-    const url = `${this.aggregatorUrl}/chat`;
+    const effectiveAggregatorUrl = (options.aggregatorUrl ?? this.aggregatorUrl).replace(
+      /\/+$/,
+      ""
+    );
+    const url = `${effectiveAggregatorUrl}/chat`;
     const response = await fetch(url, {
       method: "POST",
       headers: {
@@ -1920,7 +2001,11 @@ var ChatResource = class {
         stream: true
       }
     );
-    const url = `${this.aggregatorUrl}/chat/stream`;
+    const effectiveAggregatorUrl = (options.aggregatorUrl ?? this.aggregatorUrl).replace(
+      /\/+$/,
+      ""
+    );
+    const url = `${effectiveAggregatorUrl}/chat/stream`;
     const response = await fetch(url, {
       method: "POST",
       headers: {
@@ -2046,9 +2131,7 @@ var ChatResource = class {
     for await (const endpoint of this.hub.browse()) {
       if (results.length >= limit) break;
       if (endpoint.type !== EndpointType.MODEL) continue;
-      const hasUrl = endpoint.connect.some(
-        (conn) => conn.enabled && conn.config["url"]
-      );
+      const hasUrl = endpoint.connect.some((conn) => conn.enabled && conn.config["url"]);
       if (hasUrl) {
         results.push(endpoint);
       }
@@ -2066,9 +2149,7 @@ var ChatResource = class {
     for await (const endpoint of this.hub.browse()) {
       if (results.length >= limit) break;
       if (endpoint.type !== EndpointType.DATA_SOURCE) continue;
-      const hasUrl = endpoint.connect.some(
-        (conn) => conn.enabled && conn.config["url"]
-      );
+      const hasUrl = endpoint.connect.some((conn) => conn.enabled && conn.config["url"]);
       if (hasUrl) {
         results.push(endpoint);
       }
@@ -2322,6 +2403,7 @@ var SyftHubClient = class {
   _myEndpoints;
   _hub;
   _accounting;
+  _accountingInitPromise = null;
   _chat;
   _syftai;
   /**
@@ -2402,44 +2484,86 @@ var SyftHubClient = class {
    * The accounting service is external and uses separate credentials
    * (email/password Basic auth) from SyftHub's JWT authentication.
    *
-   * Credentials can be provided via:
-   * - Constructor options: accountingUrl, accountingEmail, accountingPassword
-   * - Environment variables: SYFTHUB_ACCOUNTING_URL, SYFTHUB_ACCOUNTING_EMAIL, SYFTHUB_ACCOUNTING_PASSWORD
+   * Credentials are automatically retrieved from the backend after login.
+   * You must call `initAccounting()` after login to initialize this resource.
    *
-   * @throws {SyftHubError} If accounting credentials are not configured
+   * @throws {AuthenticationError} If not initialized
    *
    * @example
-   * const user = await client.accounting.getUser();
-   * console.log(`Balance: ${user.balance}`);
+   * // Login first, then initialize accounting
+   * await client.auth.login('alice', 'password');
+   * await client.initAccounting();
    *
-   * // Create a transaction
-   * const tx = await client.accounting.createTransaction({
-   *   recipientEmail: 'bob@example.com',
-   *   amount: 10.0
-   * });
+   * // Now accounting is available
+   * const user = await client.accounting.getUser();
    */
   get accounting() {
-    if (!this._accounting) {
-      const url = this.options.accountingUrl ?? getEnv("SYFTHUB_ACCOUNTING_URL");
-      const email = this.options.accountingEmail ?? getEnv("SYFTHUB_ACCOUNTING_EMAIL");
-      const password = this.options.accountingPassword ?? getEnv("SYFTHUB_ACCOUNTING_PASSWORD");
-      if (!url || !email || !password) {
-        const missing = [];
-        if (!url) missing.push("SYFTHUB_ACCOUNTING_URL");
-        if (!email) missing.push("SYFTHUB_ACCOUNTING_EMAIL");
-        if (!password) missing.push("SYFTHUB_ACCOUNTING_PASSWORD");
-        throw new exports.ConfigurationError(
-          `Accounting not configured. Missing: ${missing.join(", ")}. Set environment variables or pass credentials to SyftHubClient.`
-        );
-      }
-      this._accounting = new AccountingResource({
-        url,
-        email,
-        password,
-        timeout: this.options.timeout
-      });
+    if (this._accounting) {
+      return this._accounting;
+    }
+    throw new exports.AuthenticationError(
+      "Accounting not initialized. Call `await client.initAccounting()` after login."
+    );
+  }
+  /**
+   * Initialize accounting resource by fetching credentials from the backend.
+   *
+   * This method retrieves accounting credentials from the SyftHub backend
+   * and initializes the accounting resource. Requires authentication.
+   *
+   * @returns The initialized AccountingResource
+   * @throws {AuthenticationError} If not authenticated
+   * @throws {ConfigurationError} If user has no accounting service configured
+   *
+   * @example
+   * // Login first, then initialize accounting
+   * await client.auth.login('alice', 'password');
+   * await client.initAccounting();
+   *
+   * // Now accounting is available
+   * const user = await client.accounting.getUser();
+   */
+  async initAccounting() {
+    if (this._accounting) {
+      return this._accounting;
+    }
+    if (this._accountingInitPromise) {
+      return this._accountingInitPromise;
+    }
+    this._accountingInitPromise = this._doInitAccounting();
+    try {
+      this._accounting = await this._accountingInitPromise;
+      return this._accounting;
+    } finally {
+      this._accountingInitPromise = null;
     }
-    return this._accounting;
+  }
+  /**
+   * Internal method to perform accounting initialization.
+   */
+  async _doInitAccounting() {
+    if (!this.isAuthenticated) {
+      throw new exports.AuthenticationError(
+        "Must be logged in to use accounting. Call client.auth.login() first."
+      );
+    }
+    const creds = await this.users.getAccountingCredentials();
+    if (!creds.url) {
+      throw new exports.ConfigurationError(
+        "No accounting service configured for this user. Contact your administrator to set up accounting."
+      );
+    }
+    if (!creds.password) {
+      throw new exports.ConfigurationError(
+        "Accounting password not available. This may indicate an issue with your account setup."
+      );
+    }
+    return new AccountingResource({
+      url: creds.url,
+      email: creds.email,
+      password: creds.password,
+      timeout: this.options.timeout
+    });
   }
   /**
    * Chat resource for RAG-augmented conversations via the Aggregator.
@@ -2469,11 +2593,7 @@ var SyftHubClient = class {
    */
   get chat() {
     if (!this._chat) {
-      this._chat = new ChatResource(
-        this.hub,
-        this.auth,
-        this.aggregatorUrl
-      );
+      this._chat = new ChatResource(this.hub, this.auth, this.aggregatorUrl);
     }
     return this._chat;
   }
@@ -2548,23 +2668,20 @@ var SyftHubClient = class {
     return this.http.hasTokens();
   }
   /**
-   * Check if accounting service is configured.
+   * Check if accounting has been initialized.
    *
-   * Use this to check if accounting credentials are available before
-   * accessing the `accounting` property, which will throw if not configured.
+   * Use this to check if accounting is available before accessing
+   * the `accounting` property, which will throw if not initialized.
    *
-   * @returns True if accounting url, email, and password are all configured
+   * @returns True if accounting has been initialized via `initAccounting()`
    *
    * @example
-   * if (client.isAccountingConfigured) {
+   * if (client.isAccountingInitialized) {
    *   const user = await client.accounting.getUser();
    * }
    */
-  get isAccountingConfigured() {
-    const url = this.options.accountingUrl ?? getEnv("SYFTHUB_ACCOUNTING_URL");
-    const email = this.options.accountingEmail ?? getEnv("SYFTHUB_ACCOUNTING_EMAIL");
-    const password = this.options.accountingPassword ?? getEnv("SYFTHUB_ACCOUNTING_PASSWORD");
-    return Boolean(url && email && password);
+  get isAccountingInitialized() {
+    return this._accounting !== void 0 && this._accounting !== null;
   }
   /**
    * Close the client and clean up resources.