@dalgo/dalgo2typesense 0.0.0-bootstrap.0 → 0.2.1

package/dist/transport.js

@@ -0,0 +1,317 @@
+import { QueryCancelledError, cancelQuietly, createAbortScope, raceAbort, } from "@dalgo/adapter-runtime";
+import { TypesenseHttpError, TypesenseRequestError, TypesenseResponseSizeError } from "./errors.js";
+import { TypesenseJsonNumberError, parseLosslessJson } from "./json.js";
+const API_KEY = "x-typesense-api-key";
+const RESERVED_HEADERS = new Set([
+    "host",
+    "content-length",
+    "transfer-encoding",
+    "connection",
+    "trailer",
+    "upgrade",
+    "proxy-connection",
+    "te",
+    "keep-alive",
+    "accept",
+    "content-type",
+    "user-agent",
+]);
+const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/u;
+export function positive(value, fallback, field, maximum = 16_777_216) {
+    const result = value ?? fallback;
+    if (!Number.isSafeInteger(result) || result < 1 || result > maximum) {
+        throw new TypeError(`${field} must be a safe integer from 1 to ${String(maximum)}`);
+    }
+    return result;
+}
+export function nonNegative(value, fallback, field, maximum) {
+    const result = value ?? fallback;
+    if (!Number.isSafeInteger(result) || result < 0 || result > maximum) {
+        throw new TypeError(`${field} must be a safe integer from 0 to ${String(maximum)}`);
+    }
+    return result;
+}
+export function byteLength(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+export function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function isPlainObject(value) {
+    return isObject(value)
+        && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+export function controlFree(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < 0x20 || code === 0x7f)
+            return false;
+    }
+    return value.isWellFormed();
+}
+function isLoopback(hostname) {
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
+}
+/** Validates and normalises a credential-free Typesense origin. */
+export function validBaseUrl(value, allowInsecureLoopbackHttp) {
+    const url = new URL(value.trim());
+    if (url.protocol === "http:") {
+        if (!isLoopback(url.hostname) || !allowInsecureLoopbackHttp) {
+            throw new TypeError("baseUrl must use HTTPS; loopback HTTP requires allowInsecureLoopbackHttp: true");
+        }
+    }
+    else if (url.protocol !== "https:") {
+        throw new TypeError("baseUrl must use HTTPS except for explicit loopback HTTP");
+    }
+    if (url.username !== "" || url.password !== "" || url.search !== "" || url.hash !== ""
+        || (url.pathname !== "" && url.pathname !== "/")) {
+        throw new TypeError("baseUrl must be an origin without credentials, path, query, or fragment");
+    }
+    return url.origin;
+}
+function headersFrom(value) {
+    if (!isPlainObject(value))
+        throw new TypeError("Typesense headers must be a plain object");
+    const headers = Object.create(null);
+    const seen = new Set();
+    for (const [name, headerValue] of Object.entries(value)) {
+        if (name === "__proto__" || !HEADER_NAME.test(name) || typeof headerValue !== "string"
+            || !/^[\t\x20-\x7e]*$/u.test(headerValue)) {
+            throw new TypeError("Typesense headers must have valid names and control-free string values");
+        }
+        const lower = name.toLowerCase();
+        if (seen.has(lower) || RESERVED_HEADERS.has(lower)) {
+            throw new TypeError("Typesense headers must not duplicate or override protocol headers");
+        }
+        seen.add(lower);
+        headers[name] = headerValue;
+    }
+    const keyName = Object.keys(headers).find((name) => name.toLowerCase() === API_KEY);
+    if (keyName === undefined || headers[keyName] === "") {
+        throw new TypeError("Typesense headers must include a non-empty X-TYPESENSE-API-KEY");
+    }
+    return headers;
+}
+/**
+ * One operation-wide cancellation/deadline scope plus cumulative page and byte
+ * counters. Every physical request of one query, batch or metadata read shares
+ * it, so a large result cannot reset a budget by starting a new page.
+ */
+export class TypesenseTransport {
+    #origin;
+    #headers;
+    #fetch;
+    #timeoutMs;
+    #maxRequestBytes;
+    #maxResponseBytes;
+    #maxTotalBytes;
+    #root;
+    #onDispose;
+    constructor(options) {
+        this.#origin = validBaseUrl(options.baseUrl, options.allowInsecureLoopbackHttp);
+        this.#headers = options.headers;
+        this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.#timeoutMs = options.timeoutMs;
+        this.#maxRequestBytes = options.maxRequestBytes;
+        this.#maxResponseBytes = options.maxResponseBytes;
+        this.#maxTotalBytes = options.maxTotalBytes;
+        this.#root = options.root;
+        this.#onDispose = options.onDispose;
+    }
+    get origin() { return this.#origin; }
+    get timeoutMs() { return this.#timeoutMs; }
+    begin(callerSignal) {
+        return new Operation(this.#timeoutMs, callerSignal, this.#root, this.#onDispose);
+    }
+    async request(path, parameters, operation, accepted = [], observeHeaders) {
+        operation.check();
+        if (operation.bytes >= this.#maxTotalBytes)
+            throw new TypesenseResponseSizeError();
+        let supplied;
+        try {
+            supplied = await raceAbort(Promise.resolve().then(() => typeof this.#headers === "function" ? this.#headers() : (this.#headers ?? {})), operation.signal, operation.cancelled);
+        }
+        catch {
+            if (operation.signal.aborted)
+                throw operation.cancelled();
+            throw operation.failed();
+        }
+        // Accessing an enumerable getter can throw an arbitrary error (including a
+        // RangeError that quotes a secret). Validation failures must therefore
+        // leave through one fixed, cause-free public error.
+        let headers;
+        try {
+            headers = headersFrom(supplied);
+        }
+        catch {
+            if (operation.signal.aborted)
+                throw operation.cancelled();
+            throw operation.failed();
+        }
+        // The internal credential-scope observer may raise a typed cursor refusal,
+        // which must survive; it is adapter-owned and never carries a secret.
+        observeHeaders?.(headers);
+        operation.check();
+        const query = parameters.toString();
+        const relative = `${path}${query.length === 0 ? "" : `?${query}`}`;
+        if (byteLength(relative) > this.#maxRequestBytes) {
+            throw new RangeError("Typesense request exceeds maxRequestBytes");
+        }
+        const pending = Promise.resolve().then(() => this.#fetch(`${this.#origin}${relative}`, {
+            method: "GET",
+            redirect: "error",
+            headers: { ...headers, accept: "application/json" },
+            signal: operation.signal,
+        }));
+        void pending.then((late) => { if (operation.signal.aborted)
+            cancelQuietly(late.body); }, () => undefined);
+        operation.countRequest();
+        let response;
+        try {
+            response = await raceAbort(pending, operation.signal, operation.cancelled);
+        }
+        catch {
+            if (operation.signal.aborted)
+                throw operation.cancelled();
+            throw operation.failed();
+        }
+        if (operation.signal.aborted) {
+            cancelQuietly(response.body);
+            throw operation.cancelled();
+        }
+        const remaining = this.#maxTotalBytes - operation.bytes;
+        const maximum = Math.min(this.#maxResponseBytes, remaining);
+        let consumed;
+        try {
+            consumed = await this.#read(response, maximum, operation);
+        }
+        catch (error) {
+            if (operation.signal.aborted) {
+                cancelQuietly(response.body);
+                throw operation.cancelled();
+            }
+            if (error instanceof TypesenseResponseSizeError)
+                throw error;
+            throw operation.failed();
+        }
+        operation.addBytes(consumed.bytes);
+        operation.check();
+        if (!response.ok && !accepted.includes(response.status)) {
+            throw new TypesenseHttpError(response.status);
+        }
+        let body;
+        if (consumed.text.length > 0) {
+            try {
+                body = parseLosslessJson(consumed.text);
+            }
+            catch (error) {
+                if (error instanceof TypesenseJsonNumberError)
+                    throw error;
+                // The provider body must never become an error cause or message.
+                // eslint-disable-next-line preserve-caught-error
+                throw new TypeError("Typesense returned malformed JSON");
+            }
+        }
+        return { status: response.status, body, bytes: consumed.bytes };
+    }
+    async #read(response, maximum, operation) {
+        const length = response.headers.get("content-length");
+        if (length !== null && (!/^\d+$/u.test(length) || Number(length) > maximum)) {
+            cancelQuietly(response.body);
+            throw new TypesenseResponseSizeError();
+        }
+        if (response.body === null)
+            return { text: "", bytes: 0 };
+        const reader = response.body.getReader();
+        const chunks = [];
+        let total = 0;
+        try {
+            for (;;) {
+                const item = await raceAbort(reader.read(), operation.signal, operation.cancelled);
+                if (item.done)
+                    break;
+                total += item.value.byteLength;
+                if (total > maximum) {
+                    cancelQuietly(reader);
+                    throw new TypesenseResponseSizeError();
+                }
+                chunks.push(item.value);
+            }
+        }
+        finally {
+            if (operation.signal.aborted)
+                cancelQuietly(reader);
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // A cancelled stream can retain its lock.
+            }
+        }
+        const bytes = new Uint8Array(total);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return { text: new TextDecoder().decode(bytes), bytes: total };
+    }
+}
+class Operation {
+    #scope;
+    #root;
+    #controller = new AbortController();
+    #onDispose;
+    #forward = () => { this.#controller.abort(); };
+    deadlineAt;
+    #listening = false;
+    #requests = 0;
+    #bytes = 0;
+    #disposed = false;
+    constructor(timeoutMs, callerSignal, root, onDispose) {
+        this.#root = root;
+        this.#onDispose = onDispose;
+        this.#scope = createAbortScope(callerSignal, timeoutMs);
+        this.deadlineAt = Date.now() + timeoutMs;
+        if (this.#scope.signal.aborted || root.aborted)
+            this.#controller.abort();
+        else {
+            this.#listening = true;
+            this.#scope.signal.addEventListener("abort", this.#forward, { once: true });
+            root.addEventListener("abort", this.#forward, { once: true });
+        }
+    }
+    get signal() { return this.#controller.signal; }
+    get requests() { return this.#requests; }
+    get bytes() { return this.#bytes; }
+    check() {
+        if (this.signal.aborted || this.#root.aborted)
+            throw this.cancelled();
+        if (Date.now() >= this.deadlineAt)
+            throw new QueryCancelledError("deadline");
+    }
+    cancelled = () => {
+        return new QueryCancelledError(this.#scope.deadlineExceeded ? "deadline" : "caller");
+    };
+    failed = () => {
+        return new TypesenseRequestError();
+    };
+    addBytes(bytes) { this.#bytes += bytes; }
+    countRequest() { this.#requests += 1; }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        // Ownership transfer is explicit: every listener this operation registered
+        // on the shared root or the scope is removed on success, error, cancel and
+        // close alike, so completed operations cannot remain retained.
+        if (this.#listening) {
+            this.#listening = false;
+            this.#scope.signal.removeEventListener("abort", this.#forward);
+            this.#root.removeEventListener("abort", this.#forward);
+        }
+        this.#scope.dispose();
+        this.#onDispose(this);
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,19 +1,62 @@
 {
   "name": "@dalgo/dalgo2typesense",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Nonfunctional bootstrap placeholder for CI trusted publishing; use the later released version.",
-  "license": "MIT",
+  "version": "0.2.1",
+  "description": "Bounded read-only native Typesense HTTP adapter for DALgo TypeScript",
+  "type": "module",
+  "packageManager": "pnpm@11.20.0",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:deps": "pnpm --filter \"@dalgo/dalgo2typesense...\" run build",
+    "check": "eslint . && vitest run && tsc -p tsconfig.json --noEmit && tsc -p tsconfig.build.json && tsc -p tsconfig.examples.json",
+    "lint": "eslint .",
+    "prepack": "npm --prefix ../adapter-runtime run build && npm run build",
+    "test": "vitest run",
+    "test:real": "pnpm run build:deps && node scripts/real-typesense.mjs",
+    "test:browser": "pnpm run build:deps && node scripts/real-typesense-browser.mjs"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dal-go/dalgo-http-adapters.git",
     "directory": "packages/typesense"
   },
-  "files": [
-    "README.md",
-    "LICENSE"
-  ],
+  "bugs": {
+    "url": "https://github.com/dal-go/dalgo-http-adapters/issues"
+  },
+  "homepage": "https://github.com/dal-go/dalgo-http-adapters/tree/main/packages/typesense#readme",
+  "license": "MIT",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "peerDependencies": {
+    "@dalgo/adapter-runtime": ">=0.1.0 <1.0.0",
+    "@dalgo/core": ">=0.7.4 <0.9.0"
+  },
+  "devDependencies": {
+    "@dalgo/adapter-runtime": "workspace:^",
+    "@dalgo/core": "^0.7.4",
+    "@eslint/js": "10.0.1",
+    "@playwright/test": "1.64.1",
+    "@types/node": "26.6.5",
+    "esbuild": "0.28.2",
+    "eslint": "10.11.0",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.70.0",
+    "vitest": "5.0.1"
   }
 }

package/LICENSE

@@ -1,22 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Strongo Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-