@tsproxy/js 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * InstantSearch-compatible SearchClient interface.
+ * Can be passed directly to InstantSearch's searchClient prop.
+ */
+interface SearchClient {
+    search(requests: readonly SearchRequest[]): Promise<SearchResponse>;
+    searchForFacetValues?(requests: readonly SearchRequest[]): Promise<SearchResponse>;
+    clearCache?(): void;
+}
+interface SearchRequest {
+    indexName: string;
+    params?: Record<string, unknown>;
+}
+interface Hit {
+    objectID: string;
+    [key: string]: unknown;
+}
+interface FacetValue {
+    value: string;
+    count: number;
+    highlighted: string;
+    isRefined: boolean;
+}
+interface SearchResponseResult {
+    hits: Hit[];
+    nbHits: number;
+    page: number;
+    nbPages: number;
+    hitsPerPage: number;
+    exhaustiveNbHits: boolean;
+    query: string;
+    params: string;
+    index: string;
+    processingTimeMS: number;
+    facets?: Record<string, Record<string, number>>;
+}
+interface SearchResponse {
+    results: SearchResponseResult[];
+}
+
+interface CreateSearchClientOptions {
+    url: string;
+    locale?: string;
+    cache?: boolean;
+}
+/**
+ * Creates an InstantSearch-compatible searchClient that proxies requests
+ * through the tsproxy server.
+ *
+ * Includes built-in request deduplication and result caching.
+ */
+declare function createSearchClient(options: CreateSearchClientOptions): SearchClient;
+
+export { type FacetValue, type Hit, type SearchClient, type SearchRequest, type SearchResponse, type SearchResponseResult, createSearchClient };

package/dist/index.js

@@ -0,0 +1,61 @@
+// src/adapter/index.ts
+function createSearchClient(options) {
+  const { url, cache: enableCache = true } = options;
+  let locale = options.locale;
+  const resultCache = /* @__PURE__ */ new Map();
+  const pendingRequests = /* @__PURE__ */ new Map();
+  function getCacheKey(requests) {
+    return JSON.stringify({ requests, locale });
+  }
+  async function performSearch(requests) {
+    const cacheKey = getCacheKey(requests);
+    if (enableCache) {
+      const cached = resultCache.get(cacheKey);
+      if (cached) {
+        return cached;
+      }
+      const pending = pendingRequests.get(cacheKey);
+      if (pending) {
+        return pending;
+      }
+    }
+    const promise = (async () => {
+      const response = await fetch(`${url}/api/search`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...locale ? { "X-Locale": locale } : {}
+        },
+        body: JSON.stringify({ requests })
+      });
+      if (!response.ok) {
+        throw new Error(`Search request failed: ${response.status} ${response.statusText}`);
+      }
+      const data = await response.json();
+      if (enableCache) {
+        resultCache.set(cacheKey, data);
+      }
+      return data;
+    })();
+    if (enableCache) {
+      pendingRequests.set(cacheKey, promise);
+      promise.finally(() => {
+        pendingRequests.delete(cacheKey);
+      });
+    }
+    return promise;
+  }
+  function clearCache() {
+    resultCache.clear();
+    pendingRequests.clear();
+  }
+  const client = {
+    search: performSearch,
+    searchForFacetValues: performSearch,
+    clearCache
+  };
+  return client;
+}
+export {
+  createSearchClient
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@tsproxy/js",
+  "version": "0.0.1",
+  "description": "InstantSearch-compatible searchClient adapter for tsproxy",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/akshitkrnagpal/tsproxy.git",
+    "directory": "packages/js"
+  },
+  "license": "MIT",
+  "keywords": [
+    "typesense",
+    "instantsearch",
+    "search",
+    "proxy"
+  ],
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.5.3"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "typecheck": "tsc --noEmit"
+  }
+}