@syfthub/sdk 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -170,6 +170,8 @@ interface User {
     readonly updatedAt: Date | null;
     /** Domain for endpoint URL construction (e.g., "api.example.com" or "api.example.com:8080") */
     readonly domain: string | null;
+    /** Custom aggregator URL for RAG/chat workflows */
+    readonly aggregatorUrl: string | null;
 }
 /**
  * Input for user registration.
@@ -204,6 +206,8 @@ interface UserUpdateInput {
     avatarUrl?: string;
     /** Domain for endpoint URL construction (no protocol, e.g., "api.example.com:8080") */
     domain?: string;
+    /** Custom aggregator URL for RAG/chat workflows */
+    aggregatorUrl?: string;
 }
 /**
  * Input for changing password.
@@ -287,6 +291,42 @@ interface EndpointPublic {
     readonly createdAt: Date;
     readonly updatedAt: Date;
 }
+/**
+ * Search result with relevance score from semantic search.
+ *
+ * Extends the public endpoint fields with a relevance score indicating
+ * how well the endpoint matches the search query.
+ */
+interface EndpointSearchResult {
+    readonly name: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly type: EndpointType;
+    readonly ownerUsername: string;
+    /** Number of contributors (user IDs not exposed for privacy) */
+    readonly contributorsCount: number;
+    readonly version: string;
+    readonly readme: string;
+    readonly tags: readonly string[];
+    readonly starsCount: number;
+    readonly policies: readonly Policy[];
+    readonly connect: readonly Connection[];
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+    /** Relevance score from semantic search (0.0-1.0) */
+    readonly relevanceScore: number;
+}
+/**
+ * Options for semantic search.
+ */
+interface SearchOptions {
+    /** Maximum number of results to return (default: 10) */
+    topK?: number;
+    /** Filter by endpoint type */
+    type?: EndpointType;
+    /** Minimum relevance score threshold (0.0-1.0, default: 0.0) */
+    minScore?: number;
+}
 /**
  * Input for creating a new endpoint.
  */
@@ -331,6 +371,20 @@ declare function getEndpointOwnerType(endpoint: Endpoint): 'user' | 'organizatio
  * @returns The path in "owner/slug" format
  */
 declare function getEndpointPublicPath(endpoint: EndpointPublic): string;
+/**
+ * Response from the sync endpoints operation.
+ *
+ * Contains details about the sync operation including how many endpoints
+ * were deleted, how many were created, and the full list of created endpoints.
+ */
+interface SyncEndpointsResponse {
+    /** Number of endpoints created */
+    readonly synced: number;
+    /** Number of endpoints deleted */
+    readonly deleted: number;
+    /** List of created endpoints with full details */
+    readonly endpoints: readonly Endpoint[];
+}
 
 /**
  * Accounting Models
@@ -609,6 +663,8 @@ interface ChatOptions {
     similarityThreshold?: number;
     /** AbortSignal for request cancellation */
     signal?: AbortSignal;
+    /** Custom aggregator URL to use instead of the default */
+    aggregatorUrl?: string;
 }
 /**
  * Options for querying a data source directly.
@@ -1110,13 +1166,6 @@ declare class MyEndpointsResource {
      * @throws {Error} If path format is invalid
      */
     private parsePath;
-    /**
-     * Resolve an endpoint path to its ID.
-     *
-     * @param path - Endpoint path in "owner/slug" format
-     * @returns The endpoint ID
-     */
-    private resolveEndpointId;
     /**
      * List the current user's endpoints.
      *
@@ -1167,6 +1216,40 @@ declare class MyEndpointsResource {
      * @throws {AuthorizationError} If not owner/admin
      */
     delete(path: string): Promise<void>;
+    /**
+     * 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`);
+     */
+    sync(endpoints?: EndpointCreateInput[]): Promise<SyncEndpointsResponse>;
 }
 
 /**
@@ -1203,6 +1286,13 @@ interface TrendingOptions {
  * }
  *
  * @example
+ * // Semantic search for endpoints
+ * const results = await client.hub.search('machine learning for images');
+ * for (const result of results) {
+ *   console.log(`${result.ownerUsername}/${result.slug}: ${result.relevanceScore.toFixed(2)}`);
+ * }
+ *
+ * @example
  * // Get a specific endpoint
  * const endpoint = await client.hub.get('alice/cool-api');
  * console.log(endpoint.readme);
@@ -1248,6 +1338,35 @@ declare class HubResource {
      * @returns PageIterator that lazily fetches endpoints
      */
     trending(options?: TrendingOptions): PageIterator<EndpointPublic>;
+    /**
+     * 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,
+     * });
+     */
+    search(query: string, options?: SearchOptions): Promise<EndpointSearchResult[]>;
     /**
      * Get an endpoint by its path.
      *
@@ -1968,21 +2087,6 @@ interface SyftHubClientOptions {
      * Defaults to {baseUrl}/aggregator/api/v1
      */
     aggregatorUrl?: string;
-    /**
-     * Base URL for the accounting service (optional).
-     * Falls back to SYFTHUB_ACCOUNTING_URL environment variable.
-     */
-    accountingUrl?: string;
-    /**
-     * Email for accounting service authentication (optional).
-     * Falls back to SYFTHUB_ACCOUNTING_EMAIL environment variable.
-     */
-    accountingEmail?: string;
-    /**
-     * Password for accounting service authentication (optional).
-     * Falls back to SYFTHUB_ACCOUNTING_PASSWORD environment variable.
-     */
-    accountingPassword?: string;
 }
 /**
  * SyftHub SDK client for interacting with the SyftHub API.
@@ -2036,6 +2140,7 @@ declare class SyftHubClient {
     private _myEndpoints?;
     private _hub?;
     private _accounting?;
+    private _accountingInitPromise;
     private _chat?;
     private _syftai?;
     /**
@@ -2084,23 +2189,43 @@ declare class SyftHubClient {
      * 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(): AccountingResource;
+    /**
+     * 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();
+     */
+    initAccounting(): Promise<AccountingResource>;
+    /**
+     * Internal method to perform accounting initialization.
+     */
+    private _doInitAccounting;
     /**
      * Chat resource for RAG-augmented conversations via the Aggregator.
      *
@@ -2188,19 +2313,19 @@ declare class SyftHubClient {
      */
     get isAuthenticated(): boolean;
     /**
-     * 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(): boolean;
+    get isAccountingInitialized(): boolean;
     /**
      * Close the client and clean up resources.
      *
@@ -2209,4 +2334,4 @@ declare class SyftHubClient {
     close(): void;
 }
 
-export { APIError, AccountingAccountExistsError, type AccountingCredentials, AccountingResource, type AccountingResourceOptions, AccountingServiceUnavailableError, type AccountingUser, AggregatorError, type AuthTokens, AuthenticationError, AuthorizationError, type BrowseOptions, type ChatMetadata, type ChatOptions, ChatResource, type ChatResponse, type ChatStreamEvent, ConfigurationError, type Connection, type CreateDelegatedTransactionInput, type CreateTransactionInput, CreatorType, type Document, type DoneEvent, type Endpoint, type EndpointCreateInput, type EndpointPublic, type EndpointRef, EndpointResolutionError, EndpointType, type EndpointUpdateInput, type ErrorEvent, GenerationError, type GenerationStartEvent, InvalidAccountingPasswordError, type ListEndpointsOptions, type Message, NetworkError, NotFoundError, OrganizationRole, type PageFetcher, PageIterator, type PasswordChangeInput, type Policy, type QueryDataSourceOptions, type QueryModelOptions, type RetrievalCompleteEvent, RetrievalError, type RetrievalStartEvent, type SourceCompleteEvent, type SourceInfo, type SourceStatus, SyftAIResource, SyftHubClient, type SyftHubClientOptions, SyftHubError, type TokenEvent, type Transaction, type TransactionResponse, TransactionStatus, type TransactionTokenResponse, type TransactionsOptions, type TrendingOptions, type UpdatePasswordInput, type User, UserAlreadyExistsError, type UserRegisterInput, UserRole, type UserUpdateInput, ValidationError, Visibility, createAccountingResource, getEndpointOwnerType, getEndpointPublicPath, isTransactionCancelled, isTransactionCompleted, isTransactionPending, parseTransaction };
+export { APIError, AccountingAccountExistsError, type AccountingCredentials, AccountingResource, type AccountingResourceOptions, AccountingServiceUnavailableError, type AccountingUser, AggregatorError, type AuthTokens, AuthenticationError, AuthorizationError, type BrowseOptions, type ChatMetadata, type ChatOptions, ChatResource, type ChatResponse, type ChatStreamEvent, ConfigurationError, type Connection, type CreateDelegatedTransactionInput, type CreateTransactionInput, CreatorType, type Document, type DoneEvent, type Endpoint, type EndpointCreateInput, type EndpointPublic, type EndpointRef, EndpointResolutionError, EndpointType, type EndpointUpdateInput, type ErrorEvent, GenerationError, type GenerationStartEvent, InvalidAccountingPasswordError, type ListEndpointsOptions, type Message, NetworkError, NotFoundError, OrganizationRole, type PageFetcher, PageIterator, type PasswordChangeInput, type Policy, type QueryDataSourceOptions, type QueryModelOptions, type RetrievalCompleteEvent, RetrievalError, type RetrievalStartEvent, type SourceCompleteEvent, type SourceInfo, type SourceStatus, SyftAIResource, SyftHubClient, type SyftHubClientOptions, SyftHubError, type SyncEndpointsResponse, type TokenEvent, type Transaction, type TransactionResponse, TransactionStatus, type TransactionTokenResponse, type TransactionsOptions, type TrendingOptions, type UpdatePasswordInput, type User, UserAlreadyExistsError, type UserRegisterInput, UserRole, type UserUpdateInput, ValidationError, Visibility, createAccountingResource, getEndpointOwnerType, getEndpointPublicPath, isTransactionCancelled, isTransactionCompleted, isTransactionPending, parseTransaction };

package/dist/index.d.ts

@@ -170,6 +170,8 @@ interface User {
     readonly updatedAt: Date | null;
     /** Domain for endpoint URL construction (e.g., "api.example.com" or "api.example.com:8080") */
     readonly domain: string | null;
+    /** Custom aggregator URL for RAG/chat workflows */
+    readonly aggregatorUrl: string | null;
 }
 /**
  * Input for user registration.
@@ -204,6 +206,8 @@ interface UserUpdateInput {
     avatarUrl?: string;
     /** Domain for endpoint URL construction (no protocol, e.g., "api.example.com:8080") */
     domain?: string;
+    /** Custom aggregator URL for RAG/chat workflows */
+    aggregatorUrl?: string;
 }
 /**
  * Input for changing password.
@@ -287,6 +291,42 @@ interface EndpointPublic {
     readonly createdAt: Date;
     readonly updatedAt: Date;
 }
+/**
+ * Search result with relevance score from semantic search.
+ *
+ * Extends the public endpoint fields with a relevance score indicating
+ * how well the endpoint matches the search query.
+ */
+interface EndpointSearchResult {
+    readonly name: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly type: EndpointType;
+    readonly ownerUsername: string;
+    /** Number of contributors (user IDs not exposed for privacy) */
+    readonly contributorsCount: number;
+    readonly version: string;
+    readonly readme: string;
+    readonly tags: readonly string[];
+    readonly starsCount: number;
+    readonly policies: readonly Policy[];
+    readonly connect: readonly Connection[];
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+    /** Relevance score from semantic search (0.0-1.0) */
+    readonly relevanceScore: number;
+}
+/**
+ * Options for semantic search.
+ */
+interface SearchOptions {
+    /** Maximum number of results to return (default: 10) */
+    topK?: number;
+    /** Filter by endpoint type */
+    type?: EndpointType;
+    /** Minimum relevance score threshold (0.0-1.0, default: 0.0) */
+    minScore?: number;
+}
 /**
  * Input for creating a new endpoint.
  */
@@ -331,6 +371,20 @@ declare function getEndpointOwnerType(endpoint: Endpoint): 'user' | 'organizatio
  * @returns The path in "owner/slug" format
  */
 declare function getEndpointPublicPath(endpoint: EndpointPublic): string;
+/**
+ * Response from the sync endpoints operation.
+ *
+ * Contains details about the sync operation including how many endpoints
+ * were deleted, how many were created, and the full list of created endpoints.
+ */
+interface SyncEndpointsResponse {
+    /** Number of endpoints created */
+    readonly synced: number;
+    /** Number of endpoints deleted */
+    readonly deleted: number;
+    /** List of created endpoints with full details */
+    readonly endpoints: readonly Endpoint[];
+}
 
 /**
  * Accounting Models
@@ -609,6 +663,8 @@ interface ChatOptions {
     similarityThreshold?: number;
     /** AbortSignal for request cancellation */
     signal?: AbortSignal;
+    /** Custom aggregator URL to use instead of the default */
+    aggregatorUrl?: string;
 }
 /**
  * Options for querying a data source directly.
@@ -1110,13 +1166,6 @@ declare class MyEndpointsResource {
      * @throws {Error} If path format is invalid
      */
     private parsePath;
-    /**
-     * Resolve an endpoint path to its ID.
-     *
-     * @param path - Endpoint path in "owner/slug" format
-     * @returns The endpoint ID
-     */
-    private resolveEndpointId;
     /**
      * List the current user's endpoints.
      *
@@ -1167,6 +1216,40 @@ declare class MyEndpointsResource {
      * @throws {AuthorizationError} If not owner/admin
      */
     delete(path: string): Promise<void>;
+    /**
+     * 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`);
+     */
+    sync(endpoints?: EndpointCreateInput[]): Promise<SyncEndpointsResponse>;
 }
 
 /**
@@ -1203,6 +1286,13 @@ interface TrendingOptions {
  * }
  *
  * @example
+ * // Semantic search for endpoints
+ * const results = await client.hub.search('machine learning for images');
+ * for (const result of results) {
+ *   console.log(`${result.ownerUsername}/${result.slug}: ${result.relevanceScore.toFixed(2)}`);
+ * }
+ *
+ * @example
  * // Get a specific endpoint
  * const endpoint = await client.hub.get('alice/cool-api');
  * console.log(endpoint.readme);
@@ -1248,6 +1338,35 @@ declare class HubResource {
      * @returns PageIterator that lazily fetches endpoints
      */
     trending(options?: TrendingOptions): PageIterator<EndpointPublic>;
+    /**
+     * 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,
+     * });
+     */
+    search(query: string, options?: SearchOptions): Promise<EndpointSearchResult[]>;
     /**
      * Get an endpoint by its path.
      *
@@ -1968,21 +2087,6 @@ interface SyftHubClientOptions {
      * Defaults to {baseUrl}/aggregator/api/v1
      */
     aggregatorUrl?: string;
-    /**
-     * Base URL for the accounting service (optional).
-     * Falls back to SYFTHUB_ACCOUNTING_URL environment variable.
-     */
-    accountingUrl?: string;
-    /**
-     * Email for accounting service authentication (optional).
-     * Falls back to SYFTHUB_ACCOUNTING_EMAIL environment variable.
-     */
-    accountingEmail?: string;
-    /**
-     * Password for accounting service authentication (optional).
-     * Falls back to SYFTHUB_ACCOUNTING_PASSWORD environment variable.
-     */
-    accountingPassword?: string;
 }
 /**
  * SyftHub SDK client for interacting with the SyftHub API.
@@ -2036,6 +2140,7 @@ declare class SyftHubClient {
     private _myEndpoints?;
     private _hub?;
     private _accounting?;
+    private _accountingInitPromise;
     private _chat?;
     private _syftai?;
     /**
@@ -2084,23 +2189,43 @@ declare class SyftHubClient {
      * 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(): AccountingResource;
+    /**
+     * 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();
+     */
+    initAccounting(): Promise<AccountingResource>;
+    /**
+     * Internal method to perform accounting initialization.
+     */
+    private _doInitAccounting;
     /**
      * Chat resource for RAG-augmented conversations via the Aggregator.
      *
@@ -2188,19 +2313,19 @@ declare class SyftHubClient {
      */
     get isAuthenticated(): boolean;
     /**
-     * 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(): boolean;
+    get isAccountingInitialized(): boolean;
     /**
      * Close the client and clean up resources.
      *
@@ -2209,4 +2334,4 @@ declare class SyftHubClient {
     close(): void;
 }
 
-export { APIError, AccountingAccountExistsError, type AccountingCredentials, AccountingResource, type AccountingResourceOptions, AccountingServiceUnavailableError, type AccountingUser, AggregatorError, type AuthTokens, AuthenticationError, AuthorizationError, type BrowseOptions, type ChatMetadata, type ChatOptions, ChatResource, type ChatResponse, type ChatStreamEvent, ConfigurationError, type Connection, type CreateDelegatedTransactionInput, type CreateTransactionInput, CreatorType, type Document, type DoneEvent, type Endpoint, type EndpointCreateInput, type EndpointPublic, type EndpointRef, EndpointResolutionError, EndpointType, type EndpointUpdateInput, type ErrorEvent, GenerationError, type GenerationStartEvent, InvalidAccountingPasswordError, type ListEndpointsOptions, type Message, NetworkError, NotFoundError, OrganizationRole, type PageFetcher, PageIterator, type PasswordChangeInput, type Policy, type QueryDataSourceOptions, type QueryModelOptions, type RetrievalCompleteEvent, RetrievalError, type RetrievalStartEvent, type SourceCompleteEvent, type SourceInfo, type SourceStatus, SyftAIResource, SyftHubClient, type SyftHubClientOptions, SyftHubError, type TokenEvent, type Transaction, type TransactionResponse, TransactionStatus, type TransactionTokenResponse, type TransactionsOptions, type TrendingOptions, type UpdatePasswordInput, type User, UserAlreadyExistsError, type UserRegisterInput, UserRole, type UserUpdateInput, ValidationError, Visibility, createAccountingResource, getEndpointOwnerType, getEndpointPublicPath, isTransactionCancelled, isTransactionCompleted, isTransactionPending, parseTransaction };
+export { APIError, AccountingAccountExistsError, type AccountingCredentials, AccountingResource, type AccountingResourceOptions, AccountingServiceUnavailableError, type AccountingUser, AggregatorError, type AuthTokens, AuthenticationError, AuthorizationError, type BrowseOptions, type ChatMetadata, type ChatOptions, ChatResource, type ChatResponse, type ChatStreamEvent, ConfigurationError, type Connection, type CreateDelegatedTransactionInput, type CreateTransactionInput, CreatorType, type Document, type DoneEvent, type Endpoint, type EndpointCreateInput, type EndpointPublic, type EndpointRef, EndpointResolutionError, EndpointType, type EndpointUpdateInput, type ErrorEvent, GenerationError, type GenerationStartEvent, InvalidAccountingPasswordError, type ListEndpointsOptions, type Message, NetworkError, NotFoundError, OrganizationRole, type PageFetcher, PageIterator, type PasswordChangeInput, type Policy, type QueryDataSourceOptions, type QueryModelOptions, type RetrievalCompleteEvent, RetrievalError, type RetrievalStartEvent, type SourceCompleteEvent, type SourceInfo, type SourceStatus, SyftAIResource, SyftHubClient, type SyftHubClientOptions, SyftHubError, type SyncEndpointsResponse, type TokenEvent, type Transaction, type TransactionResponse, TransactionStatus, type TransactionTokenResponse, type TransactionsOptions, type TrendingOptions, type UpdatePasswordInput, type User, UserAlreadyExistsError, type UserRegisterInput, UserRole, type UserUpdateInput, ValidationError, Visibility, createAccountingResource, getEndpointOwnerType, getEndpointPublicPath, isTransactionCancelled, isTransactionCompleted, isTransactionPending, parseTransaction };