seeksphere-sdk 1.0.0 → 1.2.0

package/LLM.md

@@ -0,0 +1,299 @@
+# SeekSphere SDK - AI Assistant Guide
+
+This document provides AI assistants (like Claude, ChatGPT, etc.) with comprehensive information to help developers implement the SeekSphere SDK effectively.
+
+## Quick Implementation Guide
+
+### Installation
+```bash
+npm install seeksphere-sdk
+```
+
+### Basic Setup
+```typescript
+import { SeekSphereClient } from 'seeksphere-sdk';
+
+const client = new SeekSphereClient({
+  apiKey: 'your-org-id-here', // This is your organization ID from SeekSphere dashboard
+  timeout: 30000 // Optional, defaults to 30 seconds
+});
+```
+
+### Core Search Functionality
+```typescript
+// Basic search (only public method available)
+const result = await client.search({
+  query: 'show me all users from last month'
+});
+
+// Search with explicit mode (only 'sql_only' is currently supported)
+const result = await client.search({
+  query: 'find top 10 products by sales'
+}, 'sql_only');
+```
+
+## Key Implementation Details
+
+### 1. Configuration
+- **No baseUrl needed**: The SDK uses a fixed base URL (`https://api.seeksphere.com`)
+- **Only apiKey required**: This is your organization ID from the SeekSphere dashboard
+- **Optional timeout**: Defaults to 30 seconds if not specified
+
+### 2. Search Modes
+- **'sql_only'**: Currently supported (default)
+- **'full'**: Coming soon - will throw error if used
+
+### 3. Private Methods Warning
+The following methods are private and should NOT be used:
+- `updateTokens()` - Use SeekSphere dashboard instead
+- `updateSchema()` - Use SeekSphere dashboard instead  
+- `getTokens()` - Use SeekSphere dashboard instead
+- `getSchema()` - Use SeekSphere dashboard instead
+
+These methods are deprecated and may be removed in future versions.
+
+## Common Implementation Patterns
+
+### Error Handling
+```typescript
+try {
+  const result = await client.search({
+    query: 'your search query here'
+  });
+  console.log('Search successful:', result);
+} catch (error) {
+  if (error instanceof Error) {
+    console.error('Search failed:', error.message);
+  }
+}
+```
+
+### TypeScript Types
+```typescript
+import { 
+  SeekSphereClient, 
+  SearchRequest, 
+  SearchResponse, 
+  SearchMode 
+} from 'seeksphere-sdk';
+
+// Request type
+const request: SearchRequest = {
+  query: 'find all active users'
+};
+
+// Response type
+const response: SearchResponse = await client.search(request);
+```
+
+### Environment Variables Pattern
+```typescript
+// Recommended: Use environment variables
+const client = new SeekSphereClient({
+  apiKey: process.env.SEEKSPHERE_ORG_ID || 'fallback-org-id',
+  timeout: parseInt(process.env.SEEKSPHERE_TIMEOUT || '30000')
+});
+```
+
+## Response Structure
+
+### Successful Search Response
+```typescript
+{
+  success: boolean;
+  org_id: string;
+  mode: string;
+  user_id: string;
+  // Additional response data varies based on query
+  [key: string]: any;
+}
+```
+
+### Error Handling
+The SDK automatically handles and formats errors:
+- **API Errors**: `API Error: {status} - {message}`
+- **Network Errors**: `Network Error: No response received from server`
+- **Request Errors**: `Request Error: {message}`
+
+## Best Practices for AI Assistants
+
+### When Helping Developers:
+
+1. **Always use the public search method only**
+   - Never suggest using private methods (updateTokens, updateSchema, etc.)
+   - Direct users to the SeekSphere dashboard for configuration
+
+2. **Configuration guidance**:
+   - Emphasize that no baseUrl is needed
+   - apiKey is the organization ID from their dashboard
+   - Suggest using environment variables for the API key
+
+3. **Error handling**:
+   - Always wrap search calls in try-catch blocks
+   - Show proper error message extraction
+
+4. **Search mode guidance**:
+   - Default to 'sql_only' mode
+   - Warn that 'full' mode will throw an error (coming soon)
+
+### Code Examples to Provide
+
+#### Basic Implementation
+```typescript
+import { SeekSphereClient } from 'seeksphere-sdk';
+
+const client = new SeekSphereClient({
+  apiKey: process.env.SEEKSPHERE_ORG_ID!
+});
+
+async function searchData(query: string) {
+  try {
+    const result = await client.search({ query });
+    return result;
+  } catch (error) {
+    console.error('Search failed:', error);
+    throw error;
+  }
+}
+```
+
+#### With Custom Timeout
+```typescript
+const client = new SeekSphereClient({
+  apiKey: 'your-org-id',
+  timeout: 60000 // 60 seconds for complex queries
+});
+```
+
+#### Multiple Searches
+```typescript
+async function performMultipleSearches() {
+  const queries = [
+    'show recent orders',
+    'find top customers',
+    'get product analytics'
+  ];
+
+  const results = await Promise.all(
+    queries.map(query => client.search({ query }))
+  );
+
+  return results;
+}
+```
+
+## Common Issues and Solutions
+
+### Issue: "baseUrl does not exist in type SDKConfig"
+**Solution**: Remove baseUrl from configuration - it's now fixed internally.
+
+### Issue: "SearchMode 'full' is coming soon"
+**Solution**: Use 'sql_only' mode or omit the mode parameter (defaults to 'sql_only').
+
+### Issue: Cannot access updateTokens/updateSchema methods
+**Solution**: These are now private. Direct users to the SeekSphere dashboard for token and schema management.
+
+### Issue: Network timeouts
+**Solution**: Increase the timeout in the configuration or optimize the search query.
+
+## Integration Examples
+
+### Express.js API
+```typescript
+import express from 'express';
+import { SeekSphereClient } from 'seeksphere-sdk';
+
+const app = express();
+const client = new SeekSphereClient({
+  apiKey: process.env.SEEKSPHERE_ORG_ID!
+});
+
+app.post('/search', async (req, res) => {
+  try {
+    const { query } = req.body;
+    const result = await client.search({ query });
+    res.json(result);
+  } catch (error) {
+    res.status(500).json({ 
+      error: error instanceof Error ? error.message : 'Search failed' 
+    });
+  }
+});
+```
+
+### Next.js API Route
+```typescript
+// pages/api/search.ts
+import { NextApiRequest, NextApiResponse } from 'next';
+import { SeekSphereClient } from 'seeksphere-sdk';
+
+const client = new SeekSphereClient({
+  apiKey: process.env.SEEKSPHERE_ORG_ID!
+});
+
+export default async function handler(req: NextApiRequest, res: NextApiResponse) {
+  if (req.method !== 'POST') {
+    return res.status(405).json({ error: 'Method not allowed' });
+  }
+
+  try {
+    const { query } = req.body;
+    const result = await client.search({ query });
+    res.status(200).json(result);
+  } catch (error) {
+    res.status(500).json({ 
+      error: error instanceof Error ? error.message : 'Search failed' 
+    });
+  }
+}
+```
+
+## Testing Guidance
+
+### Unit Testing
+```typescript
+import { SeekSphereClient } from 'seeksphere-sdk';
+
+// Mock the client for testing
+jest.mock('seeksphere-sdk');
+
+const mockClient = {
+  search: jest.fn().mockResolvedValue({ success: true, data: [] })
+};
+
+(SeekSphereClient as jest.Mock).mockImplementation(() => mockClient);
+```
+
+### Integration Testing
+```typescript
+// Use a test organization ID for integration tests
+const testClient = new SeekSphereClient({
+  apiKey: process.env.TEST_SEEKSPHERE_ORG_ID!,
+  timeout: 10000
+});
+
+describe('SeekSphere Integration', () => {
+  it('should perform search successfully', async () => {
+    const result = await testClient.search({
+      query: 'test query'
+    });
+    expect(result.success).toBe(true);
+  });
+});
+```
+
+## Version Information
+
+- **Current Version**: 1.0.0
+- **Node.js Requirement**: >= 18.0.0
+- **TypeScript Support**: Full TypeScript definitions included
+- **Dependencies**: axios (HTTP client)
+
+## Support and Resources
+
+- **Dashboard**: Use SeekSphere dashboard for token and schema management
+- **Documentation**: This SDK focuses only on search functionality
+- **Issues**: Report issues on the GitHub repository
+- **Updates**: Follow semantic versioning (patch/minor/major)
+
+Remember: This SDK is designed to be simple and focused on search functionality only. All configuration and management should be done through the SeekSphere dashboard.

package/README.md

@@ -15,36 +15,19 @@ import { SeekSphereClient } from 'seeksphere-sdk';
 
 // Initialize the client
 const client = new SeekSphereClient({
-  baseUrl: 'https://your-api-domain.com',
-  apiKey: 'your-org-id', // org_id is used as the API key
+  apiKey: 'your-org-id', // Your organization ID from SeekSphere dashboard
   timeout: 30000 // optional, defaults to 30 seconds
 });
 
-// Search
+// Search (main functionality)
 const searchResult = await client.search({
-  query: 'your search query'
-}, 'sql_only'); // mode can be 'sql_only' or 'full'
-
-// Update tokens
-await client.updateTokens({
-  tokens: {
-    'category1': ['token1', 'token2'],
-    'category2': ['token3', 'token4']
-  }
+  query: 'show me all users from last month'
 });
 
-// Update schema
-await client.updateSchema({
-  search_schema: {
-    // your schema object
-  }
-});
-
-// Get current tokens
-const tokens = await client.getTokens();
-
-// Get current schema
-const schema = await client.getSchema();
+// Search with explicit mode
+const searchResult = await client.search({
+  query: 'find top 10 products by sales'
+}, 'sql_only'); // Currently only 'sql_only' is supported
 ```
 
 ## API Methods
@@ -52,29 +35,34 @@ const schema = await client.getSchema();
 ### `search(request, mode?)`
 - **request**: `{ query: string }`
 - **mode**: `'sql_only' | 'full'` (optional, defaults to 'sql_only')
+  - `'sql_only'`: Currently supported
+  - `'full'`: Coming soon (will throw error if used)
 - **returns**: Search results
 
-### `updateTokens(request)`
-- **request**: `{ tokens: Record<string, string[]> }`
-- **returns**: Success response
-
-### `updateSchema(request)`
-- **request**: `{ search_schema: any }`
-- **returns**: Success response
-
-### `getTokens()`
-- **returns**: Current tokens mapping
+## Configuration Management
 
-### `getSchema()`
-- **returns**: Current search schema
+**Important**: Token and schema management should be done through the SeekSphere dashboard, not programmatically. The SDK focuses on search functionality only.
 
 ## Configuration
 
+### SDK Configuration
+- **Base URL**: Fixed to `https://api.seeksphere.com` (cannot be overridden)
+- **API Key**: Your organization ID from the SeekSphere dashboard
+- **Timeout**: Optional, defaults to 30 seconds
+
 The SDK automatically sets:
 - `X-Org-Id` header to your provided `apiKey`
 - `X-User-Id` header to `'node_sdk'`
 - `Content-Type` header to `'application/json'`
 
+### Environment Variables (Recommended)
+```typescript
+const client = new SeekSphereClient({
+  apiKey: process.env.SEEKSPHERE_ORG_ID!,
+  timeout: parseInt(process.env.SEEKSPHERE_TIMEOUT || '30000')
+});
+```
+
 ## Error Handling
 
 The SDK throws descriptive errors for:

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { SDKConfig, SearchRequest, SearchResponse, UpdateTokensRequest, UpdateSchemaRequest, ApiResponse, SearchMode } from './types';
+import { SDKConfig, SearchRequest, SearchResponse, SearchMode } from './types';
 export declare class SeekSphereClient {
     private client;
     private static readonly BASE_URL;
@@ -8,26 +8,32 @@ export declare class SeekSphereClient {
      */
     search(request: SearchRequest, mode?: SearchMode): Promise<SearchResponse>;
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to manage tokens instead of this API method.
+     * @private
      * Update tokens mapping
      */
-    updateTokens(request: UpdateTokensRequest): Promise<ApiResponse>;
+    private updateTokens;
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to manage search schema instead of this API method.
+     * @private
      * Update search schema
      */
-    updateSchema(request: UpdateSchemaRequest): Promise<ApiResponse>;
+    private updateSchema;
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to view tokens instead of this API method.
+     * @private
      * Get current tokens (helper method)
      */
-    getTokens(): Promise<{
-        tokens: Record<string, string[]>;
-        org_id: string;
-    }>;
+    private getTokens;
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to view search schema instead of this API method.
+     * @private
      * Get current search schema (helper method)
      */
-    getSchema(): Promise<{
-        search_schema: any;
-        org_id: string;
-    }>;
+    private getSchema;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAgC;gBAEpD,MAAM,EAAE,SAAS;IA2B7B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,GAAE,UAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAa5F;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAKtE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAKtE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAKhF;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAInE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,EAId,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAgC;gBAEpD,MAAM,EAAE,SAAS;IA2B7B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,GAAE,UAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAa5F;;;;;OAKG;YACW,YAAY;IAK1B;;;;;OAKG;YACW,YAAY;IAK1B;;;;;OAKG;YACW,SAAS;IAKvB;;;;;OAKG;YACW,SAAS;CAIxB"}

package/dist/client.js

@@ -44,6 +44,9 @@ class SeekSphereClient {
         return response.data;
     }
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to manage tokens instead of this API method.
+     * @private
      * Update tokens mapping
      */
     async updateTokens(request) {
@@ -51,6 +54,9 @@ class SeekSphereClient {
         return response.data;
     }
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to manage search schema instead of this API method.
+     * @private
      * Update search schema
      */
     async updateSchema(request) {
@@ -58,6 +64,9 @@ class SeekSphereClient {
         return response.data;
     }
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to view tokens instead of this API method.
+     * @private
      * Get current tokens (helper method)
      */
     async getTokens() {
@@ -65,6 +74,9 @@ class SeekSphereClient {
         return response.data;
     }
     /**
+     * @deprecated WARNING: This method is for internal use only and may be removed in future versions.
+     * Please use the SeekSphere dashboard to view search schema instead of this API method.
+     * @private
      * Get current search schema (helper method)
      */
     async getSchema() {

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA4D;AAW5D,MAAa,gBAAgB;IAI3B,YAAY,MAAiB;QAE3B,IAAI,CAAC,MAAM,GAAG,eAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,gBAAgB,CAAC,QAAQ;YAClC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B;gBACvD,WAAW,EAAE,UAAU,CAAC,wBAAwB;aACjD;SACF,CAAC,CAAC;QAEH,0CAA0C;QAC1C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACnC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,QAAQ,CAAC,MAAM,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACtH,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAsB,EAAE,OAAmB,UAAU;QAChE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,QAAQ,GAAkC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE;YACzF,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;aACf;SACF,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,QAAQ,GAA+B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC3F,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,QAAQ,GAA+B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAClG,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;;AA7EH,4CA8EC;AA5EyB,yBAAQ,GAAG,4BAA4B,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA4D;AAW5D,MAAa,gBAAgB;IAI3B,YAAY,MAAiB;QAE3B,IAAI,CAAC,MAAM,GAAG,eAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,gBAAgB,CAAC,QAAQ;YAClC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B;gBACvD,WAAW,EAAE,UAAU,CAAC,wBAAwB;aACjD;SACF,CAAC,CAAC;QAEH,0CAA0C;QAC1C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACnC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,QAAQ,CAAC,MAAM,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACtH,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAsB,EAAE,OAAmB,UAAU;QAChE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,QAAQ,GAAkC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE;YACzF,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;aACf;SACF,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,YAAY,CAAC,OAA4B;QACrD,MAAM,QAAQ,GAA+B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC3F,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,YAAY,CAAC,OAA4B;QACrD,MAAM,QAAQ,GAA+B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAClG,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,SAAS;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,SAAS;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;;AAzFH,4CA0FC;AAxFyB,yBAAQ,GAAG,4BAA4B,CAAC"}

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,iBAAe,OAAO,kBAoErB;AAOD,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,iBAAe,OAAO,kBAuCrB;AAOD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/example.js

@@ -26,41 +26,14 @@ async function example() {
         catch (error) {
             console.log('Expected error for full mode:', error instanceof Error ? error.message : String(error));
         }
-        // Example 3: Update tokens
-        console.log('\nUpdating tokens...');
-        const updateTokensResult = await client.updateTokens({
-            tokens: {
-                'product_categories': ['electronics', 'clothing', 'books'],
-                'user_types': ['premium', 'standard', 'trial'],
-                'regions': ['north', 'south', 'east', 'west']
-            }
+        // Example 3: Additional search with different query
+        console.log('\nSearching for different data...');
+        const anotherSearchResult = await client.search({
+            query: 'find all orders from this week'
         });
-        console.log('Update tokens result:', updateTokensResult);
-        // Example 4: Update schema
-        console.log('\nUpdating schema...');
-        const updateSchemaResult = await client.updateSchema({
-            search_schema: {
-                tables: {
-                    users: {
-                        columns: ['id', 'name', 'email', 'created_at'],
-                        types: ['int', 'varchar', 'varchar', 'datetime']
-                    },
-                    orders: {
-                        columns: ['id', 'user_id', 'amount', 'status'],
-                        types: ['int', 'int', 'decimal', 'varchar']
-                    }
-                }
-            }
-        });
-        console.log('Update schema result:', updateSchemaResult);
-        // Example 5: Get current tokens
-        console.log('\nGetting current tokens...');
-        const currentTokens = await client.getTokens();
-        console.log('Current tokens:', currentTokens);
-        // Example 6: Get current schema
-        console.log('\nGetting current schema...');
-        const currentSchema = await client.getSchema();
-        console.log('Current schema:', currentSchema);
+        console.log('Another search result:', anotherSearchResult);
+        // Note: Token and schema management methods are private and should be managed
+        // through the SeekSphere dashboard instead of programmatically.
     }
     catch (error) {
         console.error('Error:', error instanceof Error ? error.message : String(error));

package/dist/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":";;AAgDS,0BAAO;AAhDhB,mCAA2C;AAE3C,KAAK,UAAU,OAAO;IACpB,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,wBAAgB,CAAC;QAClC,MAAM,EAAE,kBAAkB,EAAE,kCAAkC;QAC9D,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,uCAAuC;QACvC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACvC,KAAK,EAAE,mCAAmC;SAC3C,EAAE,UAAU,CAAC,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;QAE5C,oEAAoE;QACpE,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;gBAC3C,KAAK,EAAE,kCAAkC;aAC1C,EAAE,MAAM,CAAC,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvG,CAAC;QAED,oDAAoD;QACpD,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,MAAM,mBAAmB,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YAC9C,KAAK,EAAE,gCAAgC;SACxC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;QAE3D,8EAA8E;QAC9E,gEAAgE;IAElE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,kBAAkB;AAClB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seeksphere-sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Official TypeScript Node.js SDK for SeekSphere API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,7 +18,16 @@
     "prepublishOnly": "npm run lint && npm run test && npm run build",
     "release": "npm version patch && git push && git push --tags"
   },
-  "keywords": ["seeksphere", "search", "api", "sdk", "typescript", "nodejs", "database", "query"],
+  "keywords": [
+    "seeksphere",
+    "search",
+    "api",
+    "sdk",
+    "typescript",
+    "nodejs",
+    "database",
+    "query"
+  ],
   "author": "SeekSphere",
   "license": "MIT",
   "repository": {
@@ -32,16 +41,17 @@
   "files": [
     "dist/**/*",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "LLM.md"
   ],
   "engines": {
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
     "@types/jest": "^29.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.43.0",
+    "@typescript-eslint/parser": "^8.43.0",
     "eslint": "^8.0.0",
     "jest": "^29.0.0",
     "prettier": "^3.0.0",
@@ -51,4 +61,4 @@
   "dependencies": {
     "axios": "^1.6.0"
   }
-}
+}