@fluxsoft/fluxvector 0.1.0

package/dist/index.js

@@ -0,0 +1,480 @@
+// src/errors.ts
+var FluxVectorError = class extends Error {
+  status;
+  code;
+  requestId;
+  constructor(message, status, code = "unknown_error", requestId) {
+    super(message);
+    this.name = "FluxVectorError";
+    this.status = status;
+    this.code = code;
+    this.requestId = requestId;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AuthenticationError = class extends FluxVectorError {
+  constructor(message = "Invalid or missing API key", requestId) {
+    super(message, 401, "authentication_error", requestId);
+    this.name = "AuthenticationError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var NotFoundError = class extends FluxVectorError {
+  constructor(message = "Resource not found", requestId) {
+    super(message, 404, "not_found", requestId);
+    this.name = "NotFoundError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var RateLimitError = class extends FluxVectorError {
+  retryAfter;
+  constructor(message = "Rate limit exceeded", retryAfter, requestId) {
+    super(message, 429, "rate_limit_exceeded", requestId);
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ValidationError = class extends FluxVectorError {
+  constructor(message = "Validation failed", requestId) {
+    super(message, 422, "validation_error", requestId);
+    this.name = "ValidationError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ServerError = class extends FluxVectorError {
+  constructor(message = "Internal server error", status = 500, requestId) {
+    super(message, status, "server_error", requestId);
+    this.name = "ServerError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://fluxvector.dev";
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_TIMEOUT = 3e4;
+var RETRY_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var HttpClient = class {
+  config;
+  constructor(config) {
+    this.config = {
+      apiKey: config.apiKey,
+      baseUrl: (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, ""),
+      maxRetries: config.maxRetries ?? DEFAULT_MAX_RETRIES,
+      timeout: config.timeout ?? DEFAULT_TIMEOUT
+    };
+  }
+  async request(options) {
+    const url = this.buildUrl(options.path, options.query);
+    const headers = {
+      "Authorization": `Bearer ${this.config.apiKey}`,
+      "Content-Type": "application/json",
+      "User-Agent": "@fluxsoft/fluxvector/0.1.0"
+    };
+    const init = {
+      method: options.method,
+      headers,
+      body: options.body !== void 0 ? JSON.stringify(options.body) : void 0,
+      signal: AbortSignal.timeout(this.config.timeout)
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+      if (attempt > 0) {
+        await this.sleep(this.getRetryDelay(attempt, lastError));
+      }
+      try {
+        const response = await fetch(url, init);
+        if (response.ok) {
+          return await response.json();
+        }
+        const requestId = response.headers.get("x-request-id") ?? void 0;
+        if (!RETRY_STATUS_CODES.has(response.status) || attempt === this.config.maxRetries) {
+          throw this.buildError(response.status, await this.safeJson(response), requestId);
+        }
+        lastError = this.buildError(response.status, await this.safeJson(response), requestId);
+        if (response.status === 429) {
+          const retryAfter = response.headers.get("retry-after");
+          if (retryAfter && lastError instanceof RateLimitError) {
+            lastError.retryAfter = Number(retryAfter);
+          }
+        }
+      } catch (error) {
+        if (error instanceof FluxVectorError) {
+          throw error;
+        }
+        if (attempt === this.config.maxRetries) {
+          if (error instanceof DOMException && error.name === "TimeoutError") {
+            throw new FluxVectorError("Request timed out", 0, "timeout");
+          }
+          throw new FluxVectorError(
+            error instanceof Error ? error.message : "Unknown network error",
+            0,
+            "network_error"
+          );
+        }
+        lastError = error instanceof Error ? error : new Error(String(error));
+      }
+    }
+    throw lastError ?? new FluxVectorError("Request failed after retries", 0, "retry_exhausted");
+  }
+  buildUrl(path, query) {
+    const url = new URL(`${this.config.baseUrl}${path}`);
+    if (query) {
+      for (const [key, value] of Object.entries(query)) {
+        if (value !== void 0) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    return url.toString();
+  }
+  buildError(status, body, requestId) {
+    const message = body?.message ?? body?.error ?? `Request failed with status ${status}`;
+    switch (status) {
+      case 401:
+        return new AuthenticationError(message, requestId);
+      case 404:
+        return new NotFoundError(message, requestId);
+      case 422:
+        return new ValidationError(message, requestId);
+      case 429: {
+        const retryAfter = body?.retry_after;
+        return new RateLimitError(message, retryAfter, requestId);
+      }
+      default:
+        if (status >= 500) {
+          return new ServerError(message, status, requestId);
+        }
+        return new FluxVectorError(message, status, "api_error", requestId);
+    }
+  }
+  async safeJson(response) {
+    try {
+      return await response.json();
+    } catch {
+      return null;
+    }
+  }
+  getRetryDelay(attempt, lastError) {
+    if (lastError instanceof RateLimitError && lastError.retryAfter) {
+      return lastError.retryAfter * 1e3;
+    }
+    const base = Math.min(500 * Math.pow(2, attempt - 1), 4e3);
+    const jitter = Math.random() * base * 0.5;
+    return base + jitter;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/resources/collections.ts
+var Collections = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new collection.
+   */
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/collections",
+      body: params
+    });
+  }
+  /**
+   * List all collections with cursor-based pagination.
+   */
+  async list(params) {
+    return this.client.request({
+      method: "GET",
+      path: "/v1/collections",
+      query: {
+        cursor: params?.cursor,
+        limit: params?.limit
+      }
+    });
+  }
+  /**
+   * Get a collection by name.
+   */
+  async get(name) {
+    return this.client.request({
+      method: "GET",
+      path: `/v1/collections/${encodeURIComponent(name)}`
+    });
+  }
+  /**
+   * Delete a collection by name.
+   */
+  async delete(name) {
+    return this.client.request({
+      method: "DELETE",
+      path: `/v1/collections/${encodeURIComponent(name)}`
+    });
+  }
+};
+
+// src/resources/vectors.ts
+var MAX_UPSERT_BATCH_SIZE = 1e3;
+var Vectors = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Upsert vectors into a collection.
+   * Automatically chunks into batches of 1000 vectors.
+   */
+  async upsert(collection, vectors) {
+    if (vectors.length <= MAX_UPSERT_BATCH_SIZE) {
+      return this.client.request({
+        method: "POST",
+        path: "/v1/vectors/upsert",
+        body: { collection, vectors }
+      });
+    }
+    let totalUpserted = 0;
+    for (let i = 0; i < vectors.length; i += MAX_UPSERT_BATCH_SIZE) {
+      const chunk = vectors.slice(i, i + MAX_UPSERT_BATCH_SIZE);
+      const result = await this.client.request({
+        method: "POST",
+        path: "/v1/vectors/upsert",
+        body: { collection, vectors: chunk }
+      });
+      totalUpserted += result.upserted;
+    }
+    return { upserted: totalUpserted };
+  }
+  /**
+   * Query vectors by text or vector with optional filtering.
+   */
+  async query(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/vectors/query",
+      body: {
+        collection: params.collection,
+        text: params.text,
+        vector: params.vector,
+        top_k: params.top_k,
+        filter: params.filter,
+        include_metadata: params.include_metadata,
+        include_text: params.include_text,
+        mode: params.mode
+      }
+    });
+  }
+  /**
+   * Delete vectors by IDs or filter.
+   */
+  async delete(collection, options) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/vectors/delete",
+      body: {
+        collection,
+        ids: options.ids,
+        filter: options.filter
+      }
+    });
+  }
+  /**
+   * Fetch vectors by their IDs.
+   */
+  async fetch(collection, ids) {
+    return this.client.request({
+      method: "GET",
+      path: "/v1/vectors/fetch",
+      query: {
+        collection,
+        ids: ids.join(",")
+      }
+    });
+  }
+};
+
+// src/resources/search.ts
+var Search = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Semantic search across a collection.
+   * Returns matching results ranked by relevance.
+   */
+  async query(collection, text, options) {
+    const response = await this.client.request({
+      method: "POST",
+      path: "/v1/search",
+      body: {
+        collection,
+        text,
+        top_k: options?.topK,
+        filter: options?.filter,
+        mode: options?.mode
+      }
+    });
+    return response.results;
+  }
+  /**
+   * Semantic search with full response (includes usage and timing).
+   */
+  async queryWithMeta(collection, text, options) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/search",
+      body: {
+        collection,
+        text,
+        top_k: options?.topK,
+        filter: options?.filter,
+        mode: options?.mode
+      }
+    });
+  }
+};
+
+// src/resources/embeddings.ts
+var Embeddings = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Generate an embedding for a single text.
+   */
+  async create(text) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/embed",
+      body: { text }
+    });
+  }
+  /**
+   * Generate embeddings for multiple texts in a single request.
+   */
+  async createBatch(texts) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/embed/batch",
+      body: { texts }
+    });
+  }
+};
+
+// src/resources/api-keys.ts
+var ApiKeys = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new API key.
+   */
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/api-keys",
+      body: params
+    });
+  }
+  /**
+   * List all API keys.
+   */
+  async list() {
+    return this.client.request({
+      method: "GET",
+      path: "/v1/api-keys"
+    });
+  }
+  /**
+   * Update an API key's name.
+   */
+  async update(id, params) {
+    return this.client.request({
+      method: "PATCH",
+      path: `/v1/api-keys/${encodeURIComponent(id)}`,
+      body: params
+    });
+  }
+  /**
+   * Delete an API key.
+   */
+  async delete(id) {
+    return this.client.request({
+      method: "DELETE",
+      path: `/v1/api-keys/${encodeURIComponent(id)}`
+    });
+  }
+};
+
+// src/resources/usage.ts
+var Usage = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get current usage overview for the billing period.
+   */
+  async get() {
+    return this.client.request({
+      method: "GET",
+      path: "/v1/usage"
+    });
+  }
+  /**
+   * Get historical usage data.
+   */
+  async history(params) {
+    return this.client.request({
+      method: "GET",
+      path: "/v1/usage/history",
+      query: {
+        days: params?.days
+      }
+    });
+  }
+};
+
+// src/index.ts
+var FluxVector = class {
+  collections;
+  vectors;
+  embeddings;
+  apiKeys;
+  usage;
+  searchResource;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("FluxVector: apiKey is required");
+    }
+    const client = new HttpClient({
+      apiKey: config.apiKey,
+      baseUrl: config.baseUrl,
+      maxRetries: config.maxRetries,
+      timeout: config.timeout
+    });
+    this.collections = new Collections(client);
+    this.vectors = new Vectors(client);
+    this.searchResource = new Search(client);
+    this.embeddings = new Embeddings(client);
+    this.apiKeys = new ApiKeys(client);
+    this.usage = new Usage(client);
+  }
+  /**
+   * Semantic search across a collection.
+   *
+   * @example
+   * const results = await fv.search('products', 'comfortable shoes', {
+   *   topK: 5,
+   *   filter: { price: { $lt: 100 } },
+   * });
+   */
+  async search(collection, text, options) {
+    return this.searchResource.query(collection, text, options);
+  }
+};
+
+export { ApiKeys, AuthenticationError, Collections, Embeddings, FluxVector, FluxVectorError, HttpClient, NotFoundError, RateLimitError, Search, ServerError, Usage, ValidationError, Vectors };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/resources/collections.ts","../src/resources/vectors.ts","../src/resources/search.ts","../src/resources/embeddings.ts","../src/resources/api-keys.ts","../src/resources/usage.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export class FluxVectorError extends Error {\n  readonly status: number;\n  readonly code: string;\n  readonly requestId: string | undefined;\n\n  constructor(\n    message: string,\n    status: number,\n    code: string = 'unknown_error',\n    requestId?: string,\n  ) {\n    super(message);\n    this.name = 'FluxVectorError';\n    this.status = status;\n    this.code = code;\n    this.requestId = requestId;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class AuthenticationError extends FluxVectorError {\n  constructor(message: string = 'Invalid or missing API key', requestId?: string) {\n    super(message, 401, 'authentication_error', requestId);\n    this.name = 'AuthenticationError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class NotFoundError extends FluxVectorError {\n  constructor(message: string = 'Resource not found', requestId?: string) {\n    super(message, 404, 'not_found', requestId);\n    this.name = 'NotFoundError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class RateLimitError extends FluxVectorError {\n  readonly retryAfter: number | undefined;\n\n  constructor(message: string = 'Rate limit exceeded', retryAfter?: number, requestId?: string) {\n    super(message, 429, 'rate_limit_exceeded', requestId);\n    this.name = 'RateLimitError';\n    this.retryAfter = retryAfter;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class ValidationError extends FluxVectorError {\n  constructor(message: string = 'Validation failed', requestId?: string) {\n    super(message, 422, 'validation_error', requestId);\n    this.name = 'ValidationError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class ServerError extends FluxVectorError {\n  constructor(message: string = 'Internal server error', status: number = 500, requestId?: string) {\n    super(message, status, 'server_error', requestId);\n    this.name = 'ServerError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import type { RequestOptions } from './types.js';\nimport {\n  FluxVectorError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  ValidationError,\n  ServerError,\n} from './errors.js';\n\nconst DEFAULT_BASE_URL = 'https://fluxvector.dev';\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_TIMEOUT = 30_000;\nconst RETRY_STATUS_CODES = new Set([429, 500, 502, 503, 504]);\n\ninterface ClientConfig {\n  apiKey: string;\n  baseUrl: string;\n  maxRetries: number;\n  timeout: number;\n}\n\nexport class HttpClient {\n  private readonly config: ClientConfig;\n\n  constructor(config: {\n    apiKey: string;\n    baseUrl?: string;\n    maxRetries?: number;\n    timeout?: number;\n  }) {\n    this.config = {\n      apiKey: config.apiKey,\n      baseUrl: (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, ''),\n      maxRetries: config.maxRetries ?? DEFAULT_MAX_RETRIES,\n      timeout: config.timeout ?? DEFAULT_TIMEOUT,\n    };\n  }\n\n  async request<T>(options: RequestOptions): Promise<T> {\n    const url = this.buildUrl(options.path, options.query);\n    const headers: Record<string, string> = {\n      'Authorization': `Bearer ${this.config.apiKey}`,\n      'Content-Type': 'application/json',\n      'User-Agent': '@fluxsoft/fluxvector/0.1.0',\n    };\n\n    const init: RequestInit = {\n      method: options.method,\n      headers,\n      body: options.body !== undefined ? JSON.stringify(options.body) : undefined,\n      signal: AbortSignal.timeout(this.config.timeout),\n    };\n\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {\n      if (attempt > 0) {\n        await this.sleep(this.getRetryDelay(attempt, lastError));\n      }\n\n      try {\n        const response = await fetch(url, init);\n\n        if (response.ok) {\n          return await response.json() as T;\n        }\n\n        const requestId = response.headers.get('x-request-id') ?? undefined;\n\n        if (!RETRY_STATUS_CODES.has(response.status) || attempt === this.config.maxRetries) {\n          throw this.buildError(response.status, await this.safeJson(response), requestId);\n        }\n\n        lastError = this.buildError(response.status, await this.safeJson(response), requestId);\n        if (response.status === 429) {\n          const retryAfter = response.headers.get('retry-after');\n          if (retryAfter && lastError instanceof RateLimitError) {\n            (lastError as RateLimitError & { retryAfter: number | undefined }).retryAfter = Number(retryAfter);\n          }\n        }\n      } catch (error) {\n        if (error instanceof FluxVectorError) {\n          throw error;\n        }\n\n        if (attempt === this.config.maxRetries) {\n          if (error instanceof DOMException && error.name === 'TimeoutError') {\n            throw new FluxVectorError('Request timed out', 0, 'timeout');\n          }\n          throw new FluxVectorError(\n            error instanceof Error ? error.message : 'Unknown network error',\n            0,\n            'network_error',\n          );\n        }\n\n        lastError = error instanceof Error ? error : new Error(String(error));\n      }\n    }\n\n    throw lastError ?? new FluxVectorError('Request failed after retries', 0, 'retry_exhausted');\n  }\n\n  private buildUrl(path: string, query?: Record<string, string | number | undefined>): string {\n    const url = new URL(`${this.config.baseUrl}${path}`);\n    if (query) {\n      for (const [key, value] of Object.entries(query)) {\n        if (value !== undefined) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n    return url.toString();\n  }\n\n  private buildError(\n    status: number,\n    body: Record<string, unknown> | null,\n    requestId: string | undefined,\n  ): FluxVectorError {\n    const message = (body?.message as string | undefined)\n      ?? (body?.error as string | undefined)\n      ?? `Request failed with status ${status}`;\n\n    switch (status) {\n      case 401:\n        return new AuthenticationError(message, requestId);\n      case 404:\n        return new NotFoundError(message, requestId);\n      case 422:\n        return new ValidationError(message, requestId);\n      case 429: {\n        const retryAfter = body?.retry_after as number | undefined;\n        return new RateLimitError(message, retryAfter, requestId);\n      }\n      default:\n        if (status >= 500) {\n          return new ServerError(message, status, requestId);\n        }\n        return new FluxVectorError(message, status, 'api_error', requestId);\n    }\n  }\n\n  private async safeJson(response: Response): Promise<Record<string, unknown> | null> {\n    try {\n      return await response.json() as Record<string, unknown>;\n    } catch {\n      return null;\n    }\n  }\n\n  private getRetryDelay(attempt: number, lastError?: Error): number {\n    if (lastError instanceof RateLimitError && lastError.retryAfter) {\n      return lastError.retryAfter * 1000;\n    }\n    // Exponential backoff: 500ms, 1s, 2s + jitter\n    const base = Math.min(500 * Math.pow(2, attempt - 1), 4000);\n    const jitter = Math.random() * base * 0.5;\n    return base + jitter;\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n","import type { HttpClient } from '../client.js';\nimport type {\n  Collection,\n  CreateCollectionParams,\n  ListCollectionsParams,\n  ListCollectionsResponse,\n} from '../types.js';\n\nexport class Collections {\n  constructor(private readonly client: HttpClient) {}\n\n  /**\n   * Create a new collection.\n   */\n  async create(params: CreateCollectionParams): Promise<Collection> {\n    return this.client.request<Collection>({\n      method: 'POST',\n      path: '/v1/collections',\n      body: params,\n    });\n  }\n\n  /**\n   * List all collections with cursor-based pagination.\n   */\n  async list(params?: ListCollectionsParams): Promise<ListCollectionsResponse> {\n    return this.client.request<ListCollectionsResponse>({\n      method: 'GET',\n      path: '/v1/collections',\n      query: {\n        cursor: params?.cursor,\n        limit: params?.limit,\n      },\n    });\n  }\n\n  /**\n   * Get a collection by name.\n   */\n  async get(name: string): Promise<Collection> {\n    return this.client.request<Collection>({\n      method: 'GET',\n      path: `/v1/collections/${encodeURIComponent(name)}`,\n    });\n  }\n\n  /**\n   * Delete a collection by name.\n   */\n  async delete(name: string): Promise<{ deleted: true }> {\n    return this.client.request<{ deleted: true }>({\n      method: 'DELETE',\n      path: `/v1/collections/${encodeURIComponent(name)}`,\n    });\n  }\n}\n","import type { HttpClient } from '../client.js';\nimport type {\n  VectorInput,\n  UpsertResponse,\n  QueryParams,\n  QueryResponse,\n  MetadataFilter,\n  FetchVectorsResponse,\n} from '../types.js';\n\nconst MAX_UPSERT_BATCH_SIZE = 1000;\n\nexport class Vectors {\n  constructor(private readonly client: HttpClient) {}\n\n  /**\n   * Upsert vectors into a collection.\n   * Automatically chunks into batches of 1000 vectors.\n   */\n  async upsert(collection: string, vectors: VectorInput[]): Promise<UpsertResponse> {\n    if (vectors.length <= MAX_UPSERT_BATCH_SIZE) {\n      return this.client.request<UpsertResponse>({\n        method: 'POST',\n        path: '/v1/vectors/upsert',\n        body: { collection, vectors },\n      });\n    }\n\n    let totalUpserted = 0;\n\n    for (let i = 0; i < vectors.length; i += MAX_UPSERT_BATCH_SIZE) {\n      const chunk = vectors.slice(i, i + MAX_UPSERT_BATCH_SIZE);\n      const result = await this.client.request<UpsertResponse>({\n        method: 'POST',\n        path: '/v1/vectors/upsert',\n        body: { collection, vectors: chunk },\n      });\n      totalUpserted += result.upserted;\n    }\n\n    return { upserted: totalUpserted };\n  }\n\n  /**\n   * Query vectors by text or vector with optional filtering.\n   */\n  async query(params: QueryParams): Promise<QueryResponse> {\n    return this.client.request<QueryResponse>({\n      method: 'POST',\n      path: '/v1/vectors/query',\n      body: {\n        collection: params.collection,\n        text: params.text,\n        vector: params.vector,\n        top_k: params.top_k,\n        filter: params.filter,\n        include_metadata: params.include_metadata,\n        include_text: params.include_text,\n        mode: params.mode,\n      },\n    });\n  }\n\n  /**\n   * Delete vectors by IDs or filter.\n   */\n  async delete(\n    collection: string,\n    options: { ids?: string[]; filter?: MetadataFilter },\n  ): Promise<{ deleted: true }> {\n    return this.client.request<{ deleted: true }>({\n      method: 'POST',\n      path: '/v1/vectors/delete',\n      body: {\n        collection,\n        ids: options.ids,\n        filter: options.filter,\n      },\n    });\n  }\n\n  /**\n   * Fetch vectors by their IDs.\n   */\n  async fetch(collection: string, ids: string[]): Promise<FetchVectorsResponse> {\n    return this.client.request<FetchVectorsResponse>({\n      method: 'GET',\n      path: '/v1/vectors/fetch',\n      query: {\n        collection,\n        ids: ids.join(','),\n      },\n    });\n  }\n}\n","import type { HttpClient } from '../client.js';\nimport type { MetadataFilter, QueryResult, SearchResponse } from '../types.js';\n\nexport interface SearchOptions {\n  topK?: number;\n  filter?: MetadataFilter;\n  mode?: string;\n}\n\nexport class Search {\n  constructor(private readonly client: HttpClient) {}\n\n  /**\n   * Semantic search across a collection.\n   * Returns matching results ranked by relevance.\n   */\n  async query(\n    collection: string,\n    text: string,\n    options?: SearchOptions,\n  ): Promise<QueryResult[]> {\n    const response = await this.client.request<SearchResponse>({\n      method: 'POST',\n      path: '/v1/search',\n      body: {\n        collection,\n        text,\n        top_k: options?.topK,\n        filter: options?.filter,\n        mode: options?.mode,\n      },\n    });\n    return response.results;\n  }\n\n  /**\n   * Semantic search with full response (includes usage and timing).\n   */\n  async queryWithMeta(\n    collection: string,\n    text: string,\n    options?: SearchOptions,\n  ): Promise<SearchResponse> {\n    return this.client.request<SearchResponse>({\n      method: 'POST',\n      path: '/v1/search',\n      body: {\n        collection,\n        text,\n        top_k: options?.topK,\n        filter: options?.filter,\n        mode: options?.mode,\n      },\n    });\n  }\n}\n","import type { HttpClient } from '../client.js';\nimport type { EmbedResponse, EmbedBatchResponse } from '../types.js';\n\nexport class Embeddings {\n  constructor(private readonly client: HttpClient) {}\n\n  /**\n   * Generate an embedding for a single text.\n   */\n  async create(text: string): Promise<EmbedResponse> {\n    return this.client.request<EmbedResponse>({\n      method: 'POST',\n      path: '/v1/embed',\n      body: { text },\n    });\n  }\n\n  /**\n   * Generate embeddings for multiple texts in a single request.\n   */\n  async createBatch(texts: string[]): Promise<EmbedBatchResponse> {\n    return this.client.request<EmbedBatchResponse>({\n      method: 'POST',\n      path: '/v1/embed/batch',\n      body: { texts },\n    });\n  }\n}\n","import type { HttpClient } from '../client.js';\nimport type {\n  ApiKey,\n  CreateApiKeyParams,\n  ListApiKeysResponse,\n  UpdateApiKeyParams,\n} from '../types.js';\n\nexport class ApiKeys {\n  constructor(private readonly client: HttpClient) {}\n\n  /**\n   * Create a new API key.\n   */\n  async create(params: CreateApiKeyParams): Promise<ApiKey> {\n    return this.client.request<ApiKey>({\n      method: 'POST',\n      path: '/v1/api-keys',\n      body: params,\n    });\n  }\n\n  /**\n   * List all API keys.\n   */\n  async list(): Promise<ListApiKeysResponse> {\n    return this.client.request<ListApiKeysResponse>({\n      method: 'GET',\n      path: '/v1/api-keys',\n    });\n  }\n\n  /**\n   * Update an API key's name.\n   */\n  async update(id: string, params: UpdateApiKeyParams): Promise<ApiKey> {\n    return this.client.request<ApiKey>({\n      method: 'PATCH',\n      path: `/v1/api-keys/${encodeURIComponent(id)}`,\n      body: params,\n    });\n  }\n\n  /**\n   * Delete an API key.\n   */\n  async delete(id: string): Promise<{ deleted: true }> {\n    return this.client.request<{ deleted: true }>({\n      method: 'DELETE',\n      path: `/v1/api-keys/${encodeURIComponent(id)}`,\n    });\n  }\n}\n","import type { HttpClient } from '../client.js';\nimport type {\n  UsageOverview,\n  UsageHistoryParams,\n  UsageHistoryResponse,\n} from '../types.js';\n\nexport class Usage {\n  constructor(private readonly client: HttpClient) {}\n\n  /**\n   * Get current usage overview for the billing period.\n   */\n  async get(): Promise<UsageOverview> {\n    return this.client.request<UsageOverview>({\n      method: 'GET',\n      path: '/v1/usage',\n    });\n  }\n\n  /**\n   * Get historical usage data.\n   */\n  async history(params?: UsageHistoryParams): Promise<UsageHistoryResponse> {\n    return this.client.request<UsageHistoryResponse>({\n      method: 'GET',\n      path: '/v1/usage/history',\n      query: {\n        days: params?.days,\n      },\n    });\n  }\n}\n","import { HttpClient } from './client.js';\nimport { Collections } from './resources/collections.js';\nimport { Vectors } from './resources/vectors.js';\nimport { Search } from './resources/search.js';\nimport type { SearchOptions } from './resources/search.js';\nimport { Embeddings } from './resources/embeddings.js';\nimport { ApiKeys } from './resources/api-keys.js';\nimport { Usage } from './resources/usage.js';\nimport type { FluxVectorConfig, QueryResult } from './types.js';\n\nexport class FluxVector {\n  readonly collections: Collections;\n  readonly vectors: Vectors;\n  readonly embeddings: Embeddings;\n  readonly apiKeys: ApiKeys;\n  readonly usage: Usage;\n\n  private readonly searchResource: Search;\n\n  constructor(config: FluxVectorConfig) {\n    if (!config.apiKey) {\n      throw new Error('FluxVector: apiKey is required');\n    }\n\n    const client = new HttpClient({\n      apiKey: config.apiKey,\n      baseUrl: config.baseUrl,\n      maxRetries: config.maxRetries,\n      timeout: config.timeout,\n    });\n\n    this.collections = new Collections(client);\n    this.vectors = new Vectors(client);\n    this.searchResource = new Search(client);\n    this.embeddings = new Embeddings(client);\n    this.apiKeys = new ApiKeys(client);\n    this.usage = new Usage(client);\n  }\n\n  /**\n   * Semantic search across a collection.\n   *\n   * @example\n   * const results = await fv.search('products', 'comfortable shoes', {\n   *   topK: 5,\n   *   filter: { price: { $lt: 100 } },\n   * });\n   */\n  async search(\n    collection: string,\n    text: string,\n    options?: SearchOptions,\n  ): Promise<QueryResult[]> {\n    return this.searchResource.query(collection, text, options);\n  }\n}\n\n// Re-export everything\nexport { HttpClient } from './client.js';\nexport { Collections } from './resources/collections.js';\nexport { Vectors } from './resources/vectors.js';\nexport { Search } from './resources/search.js';\nexport type { SearchOptions } from './resources/search.js';\nexport { Embeddings } from './resources/embeddings.js';\nexport { ApiKeys } from './resources/api-keys.js';\nexport { Usage } from './resources/usage.js';\n\nexport {\n  FluxVectorError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  ValidationError,\n  ServerError,\n} from './errors.js';\n\nexport type {\n  FluxVectorConfig,\n  FilterOperator,\n  FilterValue,\n  FilterCondition,\n  MetadataFilter,\n  CreateCollectionParams,\n  Collection,\n  ListCollectionsParams,\n  ListCollectionsResponse,\n  VectorInput,\n  Vector,\n  UpsertResponse,\n  QueryParams,\n  QueryResult,\n  QueryResponse,\n  DeleteVectorsParams,\n  FetchVectorsParams,\n  FetchVectorsResponse,\n  SearchParams,\n  SearchResponse,\n  EmbedResponse,\n  EmbedBatchResponse,\n  CreateApiKeyParams,\n  ApiKey,\n  UpdateApiKeyParams,\n  ListApiKeysResponse,\n  UsageInfo,\n  UsageOverview,\n  UsageHistoryParams,\n  UsageHistoryEntry,\n  UsageHistoryResponse,\n} from './types.js';\n"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@fluxsoft/fluxvector",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for FluxVector — semantic search API by FluxSoft Labs",
+  "author": "FluxSoft Technologies, LLC",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "echo skip"
+  },
+  "devDependencies": {
+    "msw": "^2.6.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "fluxvector",
+    "vector",
+    "semantic-search",
+    "embeddings",
+    "ai",
+    "sdk",
+    "fluxsoft"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluxsoft-labs/fluxvector-js"
+  },
+  "homepage": "https://fluxsoftlabs.com/fluxvector",
+  "bugs": {
+    "url": "https://github.com/fluxsoft-labs/fluxvector-js/issues"
+  }
+}