@seizn/summer 0.1.0

package/dist/index.mjs

@@ -0,0 +1,270 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://seizn.com/api/summer";
+var DEFAULT_TIMEOUT = 6e4;
+var DEFAULT_RETRIES = 3;
+var SummerClient = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+    this.retries = config.retries ?? DEFAULT_RETRIES;
+    this.onError = config.onError;
+  }
+  // ============================================
+  // Collection Management
+  // ============================================
+  /**
+   * Create a new collection
+   */
+  async createCollection(request) {
+    const response = await this.request("/collections", {
+      method: "POST",
+      body: request
+    });
+    return response.collection;
+  }
+  /**
+   * List all collections
+   */
+  async listCollections() {
+    const response = await this.request("/collections");
+    return response.collections;
+  }
+  /**
+   * Get collection by ID
+   */
+  async getCollection(collectionId) {
+    const response = await this.request(
+      `/collections/${collectionId}`
+    );
+    return response.collection;
+  }
+  /**
+   * Delete a collection
+   */
+  async deleteCollection(collectionId) {
+    await this.request(`/collections/${collectionId}`, { method: "DELETE" });
+  }
+  /**
+   * Get collection statistics
+   */
+  async getCollectionStats(collectionId) {
+    return this.request(`/collections/${collectionId}/stats`);
+  }
+  // ============================================
+  // Document Indexing
+  // ============================================
+  /**
+   * Index a single document
+   */
+  async index(request) {
+    return this.request("/index", {
+      method: "POST",
+      body: request
+    });
+  }
+  /**
+   * Bulk index multiple documents
+   */
+  async bulkIndex(request) {
+    return this.request("/index/bulk", {
+      method: "POST",
+      body: request
+    });
+  }
+  /**
+   * Get document by ID
+   */
+  async getDocument(documentId) {
+    const response = await this.request(
+      `/documents/${documentId}`
+    );
+    return response.document;
+  }
+  /**
+   * Delete a document
+   */
+  async deleteDocument(documentId) {
+    await this.request(`/documents/${documentId}`, { method: "DELETE" });
+  }
+  /**
+   * Update document metadata
+   */
+  async updateDocumentMetadata(documentId, metadata) {
+    const response = await this.request(
+      `/documents/${documentId}`,
+      {
+        method: "PATCH",
+        body: { metadata }
+      }
+    );
+    return response.document;
+  }
+  // ============================================
+  // Search
+  // ============================================
+  /**
+   * Search within a collection
+   */
+  async search(request) {
+    return this.request("/search", {
+      method: "POST",
+      body: request
+    });
+  }
+  /**
+   * Quick search shorthand
+   */
+  async query(collectionId, query, options) {
+    return this.search({
+      collectionId,
+      query,
+      topK: options?.topK ?? 10,
+      mode: options?.mode ?? "hybrid",
+      rerank: options?.rerank ?? false
+    });
+  }
+  /**
+   * Federated search across multiple sources
+   */
+  async federatedSearch(request) {
+    return this.request("/search/federated", {
+      method: "POST",
+      body: request
+    });
+  }
+  // ============================================
+  // RAG Query
+  // ============================================
+  /**
+   * RAG query with answer generation
+   */
+  async rag(request) {
+    return this.request("/rag", {
+      method: "POST",
+      body: request
+    });
+  }
+  /**
+   * Quick RAG query shorthand
+   */
+  async ask(collectionId, question, options) {
+    return this.rag({
+      collectionId,
+      query: question,
+      systemPrompt: options?.systemPrompt,
+      contextLimit: options?.contextLimit ?? 8e3,
+      citationStyle: "inline"
+    });
+  }
+  // ============================================
+  // Analytics
+  // ============================================
+  /**
+   * Get search analytics
+   */
+  async getAnalytics(collectionId, period = "week") {
+    return this.request(
+      `/collections/${collectionId}/analytics?period=${period}`
+    );
+  }
+  // ============================================
+  // Utilities
+  // ============================================
+  /**
+   * Generate embedding for text (for external use)
+   */
+  async embed(text) {
+    const texts = Array.isArray(text) ? text : [text];
+    const response = await this.request("/embed", {
+      method: "POST",
+      body: { texts }
+    });
+    return response.embeddings;
+  }
+  /**
+   * Rerank results
+   */
+  async rerank(query, documents, topN) {
+    const response = await this.request(
+      "/rerank",
+      {
+        method: "POST",
+        body: { query, documents, topN }
+      }
+    );
+    return response.results;
+  }
+  // ============================================
+  // Internal
+  // ============================================
+  async request(path, options) {
+    const url = `${this.baseUrl}${path}`;
+    const method = options?.method ?? "GET";
+    let lastError = null;
+    for (let attempt = 0; attempt < this.retries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json"
+          },
+          body: options?.body ? JSON.stringify(options.body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+          const errorData = await response.json().catch(() => ({}));
+          const error = {
+            code: errorData.code ?? "REQUEST_FAILED",
+            message: errorData.error ?? errorData.message ?? `Request failed with status ${response.status}`,
+            status: response.status,
+            details: errorData
+          };
+          if (response.status >= 400 && response.status < 500) {
+            this.onError?.(error);
+            throw error;
+          }
+          lastError = error;
+          continue;
+        }
+        return response.json();
+      } catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+          lastError = {
+            code: "TIMEOUT",
+            message: `Request timed out after ${this.timeout}ms`
+          };
+        } else if (error.code) {
+          throw error;
+        } else {
+          lastError = {
+            code: "NETWORK_ERROR",
+            message: error instanceof Error ? error.message : "Network error"
+          };
+        }
+        if (attempt < this.retries - 1) {
+          await new Promise((resolve) => setTimeout(resolve, Math.pow(2, attempt) * 1e3));
+        }
+      }
+    }
+    if (lastError) {
+      this.onError?.(lastError);
+      throw lastError;
+    }
+    throw { code: "UNKNOWN", message: "Unknown error" };
+  }
+};
+function createSummerClient(config) {
+  return new SummerClient(config);
+}
+export {
+  SummerClient,
+  createSummerClient
+};

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@seizn/summer",
+  "version": "0.1.0",
+  "description": "Seizn Summer - RAG Infrastructure SDK for AI Applications",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "seizn",
+    "summer",
+    "rag",
+    "retrieval-augmented-generation",
+    "ai",
+    "vector-search",
+    "semantic-search",
+    "llm",
+    "embeddings"
+  ],
+  "author": "Seizn <support@seizn.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iruhana/seizn.git",
+    "directory": "packages/summer-sdk"
+  },
+  "homepage": "https://docs.seizn.com/summer",
+  "bugs": {
+    "url": "https://github.com/iruhana/seizn/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  }
+}