@yunfie/search-js 1.0.0

package/dist/request/queue.d.ts

@@ -0,0 +1,11 @@
+export type PriorityValue = 0 | 1 | 2;
+export declare const Priority: {
+    readonly LOW: PriorityValue;
+    readonly NORMAL: PriorityValue;
+    readonly HIGH: PriorityValue;
+};
+type Task = () => Promise<void>;
+export declare function enqueue(task: Task, priority?: PriorityValue): void;
+export declare function clearQueues(): void;
+export {};
+//# sourceMappingURL=queue.d.ts.map

package/dist/request/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/request/queue.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtC,eAAO,MAAM,QAAQ;kBACT,aAAa;qBACV,aAAa;mBACf,aAAa;CAChB,CAAC;AAEX,KAAK,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAKhC,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,GAAE,aAA+B,GAAG,IAAI,CAGnF;AAED,wBAAgB,WAAW,IAAI,IAAI,CAIlC"}

package/dist/request/queue.js

@@ -0,0 +1,31 @@
+// src/request/queue.ts
+import { getConfig } from "../config.js";
+import { getIsLowMemory } from "../memory.js";
+export const Priority = {
+    LOW: 0,
+    NORMAL: 1,
+    HIGH: 2,
+};
+const _queues = [[], [], []];
+let _running = 0;
+export function enqueue(task, priority = Priority.NORMAL) {
+    _queues[priority].push(task);
+    _drain();
+}
+export function clearQueues() {
+    _queues[0].length = 0;
+    _queues[1].length = 0;
+    _queues[2].length = 0;
+}
+function _drain() {
+    const cfg = getConfig();
+    const max = getIsLowMemory() ? cfg.MAX_CONCURRENT_LOW_MEMORY : cfg.MAX_CONCURRENT_REQUESTS;
+    while (_running < max) {
+        const task = _queues[2].shift() ?? _queues[1].shift() ?? _queues[0].shift();
+        if (!task)
+            break;
+        _running++;
+        task().finally(() => { _running--; _drain(); });
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/request/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/request/queue.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,CAAkB;IACvB,MAAM,EAAE,CAAkB;IAC1B,IAAI,EAAE,CAAkB;CAChB,CAAC;AAIX,MAAM,OAAO,GAA6B,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACvD,IAAI,QAAQ,GAAG,CAAC,CAAC;AAEjB,MAAM,UAAU,OAAO,CAAC,IAAU,EAAE,WAA0B,QAAQ,CAAC,MAAM;IAC3E,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,MAAM;IACb,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC3F,OAAO,QAAQ,GAAG,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5E,IAAI,CAAC,IAAI;YAAE,MAAM;QACjB,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/request/retry.d.ts

@@ -0,0 +1,14 @@
+export interface FetchResult {
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+    status?: number;
+    cached?: boolean;
+    stale?: boolean;
+    persistent?: boolean;
+    streamed?: boolean;
+}
+export declare function cancel(key: string): void;
+export declare function cancelAll(): void;
+export declare function fetchWithRetry(url: string, opts: RequestInit, key: string, onChunk?: (chunk: unknown) => void): Promise<FetchResult>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/request/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/request/retry.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGxC;AAED,wBAAgB,SAAS,IAAI,IAAI,CAGhC;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,OAAO,CAAC,WAAW,CAAC,CA+DtB"}

package/dist/request/retry.js

@@ -0,0 +1,155 @@
+// src/request/retry.ts
+import { getConfig } from "../config.js";
+const controllers = new Map();
+export function cancel(key) {
+    controllers.get(key)?.abort();
+    controllers.delete(key);
+}
+export function cancelAll() {
+    for (const ctrl of controllers.values())
+        ctrl.abort();
+    controllers.clear();
+}
+export async function fetchWithRetry(url, opts, key, onChunk) {
+    const cfg = getConfig();
+    const canAbort = typeof AbortController !== "undefined";
+    const canStream = typeof ReadableStream !== "undefined" && !!onChunk;
+    for (let attempt = 0; attempt <= cfg.RETRIES; attempt++) {
+        controllers.get(key)?.abort();
+        const ctrl = canAbort ? new AbortController() : null;
+        if (ctrl)
+            controllers.set(key, ctrl);
+        const externalSignal = opts.signal;
+        let mergedSignal;
+        if (ctrl && externalSignal) {
+            if (typeof AbortSignal.any === "function") {
+                mergedSignal = AbortSignal.any([ctrl.signal, externalSignal]);
+            }
+            else {
+                const bridge = () => ctrl.abort();
+                externalSignal.addEventListener("abort", bridge, { once: true });
+                mergedSignal = ctrl.signal;
+            }
+        }
+        else {
+            mergedSignal = ctrl?.signal ?? externalSignal ?? undefined;
+        }
+        const fetchOpts = mergedSignal ? { ...opts, signal: mergedSignal } : opts;
+        const tid = ctrl ? setTimeout(() => ctrl.abort(), cfg.TIMEOUT) : undefined;
+        try {
+            const res = await fetch(url, fetchOpts);
+            clearTimeout(tid);
+            controllers.delete(key);
+            if (!res.ok) {
+                return {
+                    ok: false,
+                    error: res.status >= 500 ? "server_error" : "client_error",
+                    status: res.status,
+                };
+            }
+            if (canStream && res.body)
+                return await _readStream(res.body, ctrl, onChunk, cfg);
+            return { ok: true, data: await res.json() };
+        }
+        catch (err) {
+            clearTimeout(tid);
+            controllers.delete(key);
+            if (err instanceof Error) {
+                if (err.name === "AbortError" || err.message?.includes("aborted")) {
+                    return { ok: false, error: "cancelled" };
+                }
+                if (err instanceof TypeError) {
+                    if (attempt === cfg.RETRIES)
+                        return { ok: false, error: "network_error" };
+                    await _sleep(cfg.RETRY_BACKOFF_BASE * 2 ** attempt);
+                    continue;
+                }
+            }
+            return { ok: false, error: "unknown_error" };
+        }
+    }
+    return { ok: false, error: "max_retries_exceeded" };
+}
+const _sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function _readStream(body, ctrl, onChunk, cfg) {
+    const reader = body.getReader();
+    const dec = new TextDecoder();
+    let buf = "";
+    let braces = 0;
+    let inStr = false;
+    let esc = false;
+    let aborted = false;
+    const chunks = [];
+    const onAbort = () => { aborted = true; reader.cancel().catch(() => { }); };
+    ctrl?.signal.addEventListener("abort", onAbort, { once: true });
+    try {
+        outer: while (!aborted) {
+            let readResult;
+            try {
+                readResult = await reader.read();
+            }
+            catch {
+                break outer;
+            }
+            if (readResult.done)
+                break;
+            buf += dec.decode(readResult.value, { stream: true });
+            if (buf.length > cfg.STREAMING_BUFFER_SIZE)
+                _flush();
+        }
+        if (!aborted)
+            _flush();
+    }
+    finally {
+        ctrl?.signal.removeEventListener("abort", onAbort);
+        try {
+            reader.releaseLock();
+        }
+        catch { /* already released */ }
+        buf = "";
+    }
+    return {
+        ok: !aborted,
+        ...(aborted ? { error: "cancelled" } : {}),
+        data: chunks.length === 1 ? chunks[0] : chunks,
+        streamed: true,
+    };
+    function _flush() {
+        let start = 0;
+        for (let i = 0; i < buf.length; i++) {
+            const c = buf[i];
+            if (esc) {
+                esc = false;
+                continue;
+            }
+            if (c === "\\") {
+                esc = true;
+                continue;
+            }
+            if (c === '"') {
+                inStr = !inStr;
+                continue;
+            }
+            if (inStr)
+                continue;
+            if (c === "{") {
+                if (!braces)
+                    start = i;
+                braces++;
+            }
+            else if (c === "}") {
+                if (!--braces) {
+                    try {
+                        const obj = JSON.parse(buf.slice(start, i + 1));
+                        chunks.push(obj);
+                        onChunk(obj);
+                    }
+                    catch { /* malformed JSON */ }
+                    buf = buf.slice(i + 1);
+                    i = -1;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/request/retry.js.map

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

package/dist/suggest.d.ts

@@ -0,0 +1,14 @@
+export interface SuggestItem {
+    title: string;
+}
+export interface SuggestResult {
+    ok: boolean;
+    query: string;
+    items: SuggestItem[];
+    cached?: boolean;
+    error?: string;
+}
+export declare function clearSuggestCache(): void;
+export declare function getSuggest(q: string): Promise<SuggestResult>;
+export declare function getSuggestDebounced(q: string, callback: (result: SuggestResult) => void, wait?: number): void;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../src/suggest.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAAG,KAAK,EAAE,MAAM,CAAC;CAAE;AAE/C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8CD,wBAAgB,iBAAiB,IAAI,IAAI,CAAoB;AAyE7D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAW5D;AAED,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,EACzC,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAEN"}

package/dist/suggest.js

@@ -0,0 +1,159 @@
+// src/suggest.ts
+import { getConfig } from "./config.js";
+import { getIsLowMemory } from "./memory.js";
+import { fetchWithRetry } from "./request/retry.js";
+import { enqueue, Priority } from "./request/queue.js";
+import { debounce } from "./utils.js";
+const _cache = new Map();
+const SUGGEST_CACHE_MAX = 50;
+function _cacheKey(q) { return q.trim().toLowerCase(); }
+function _cacheGet(key) {
+    const entry = _cache.get(key);
+    if (!entry)
+        return null;
+    if (Date.now() - entry.time > getConfig().SUGGEST_TTL) {
+        _cache.delete(key);
+        return null;
+    }
+    _cache.delete(key);
+    _cache.set(key, entry);
+    return entry;
+}
+function _cacheSet(key, items) {
+    if (_cache.has(key))
+        _cache.delete(key);
+    while (_cache.size >= SUGGEST_CACHE_MAX) {
+        const first = _cache.keys().next().value;
+        if (first !== undefined)
+            _cache.delete(first);
+        else
+            break;
+    }
+    _cache.set(key, { items, time: Date.now() });
+}
+function _cacheFindPrefix(q) {
+    const key = _cacheKey(q);
+    const exact = _cacheGet(key);
+    if (exact)
+        return exact;
+    const now = Date.now();
+    const ttl = getConfig().SUGGEST_TTL;
+    for (const [k, entry] of _cache) {
+        if (now - entry.time > ttl) {
+            _cache.delete(k);
+            continue;
+        }
+        if (key.startsWith(k)) {
+            _cache.delete(k);
+            _cache.set(k, entry);
+            const filtered = entry.items.filter((item) => item.title.toLowerCase().includes(key));
+            if (filtered.length > 0)
+                return { items: filtered, time: entry.time };
+        }
+    }
+    return null;
+}
+export function clearSuggestCache() { _cache.clear(); }
+const _inFlight = new Map();
+const _fetchOpts = Object.freeze({
+    method: "GET",
+    headers: Object.freeze({ Accept: "application/json" }),
+});
+async function _fetchSuggest(q) {
+    const key = _cacheKey(q);
+    const cached = _cacheFindPrefix(q);
+    if (cached)
+        return { ok: true, query: q, items: cached.items, cached: true };
+    const existing = _inFlight.get(key);
+    if (existing)
+        return existing;
+    const cfg = getConfig();
+    const url = new URL(cfg.API_BASE + "/search");
+    url.searchParams.set("q", q.trim());
+    url.searchParams.set("type", "suggest");
+    const promise = new Promise((resolve) => {
+        enqueue(async () => {
+            try {
+                const result = await fetchWithRetry(url.toString(), _fetchOpts, "suggest\x00" + key);
+                if (!result.ok) {
+                    resolve({ ok: false, query: q, items: [], error: result.error });
+                    return;
+                }
+                const items = _parse(result.data);
+                _cacheSet(key, items);
+                resolve({ ok: true, query: q, items });
+            }
+            catch {
+                resolve({ ok: false, query: q, items: [], error: "unknown_error" });
+            }
+            finally {
+                _inFlight.delete(key);
+            }
+        }, Priority.HIGH);
+    });
+    _inFlight.set(key, promise);
+    return promise;
+}
+function _parse(data) {
+    return _toArray(data).reduce((acc, item) => {
+        const title = _title(item);
+        if (title)
+            acc.push({ title });
+        return acc;
+    }, []);
+}
+function _title(item) {
+    if (typeof item === "string" && item.length > 0)
+        return item;
+    if (item && typeof item === "object") {
+        const obj = item;
+        const v = obj.title ?? obj.text ?? obj.value ?? obj.query;
+        if (typeof v === "string" && v.length > 0)
+            return v;
+    }
+    return undefined;
+}
+function _toArray(data) {
+    if (Array.isArray(data))
+        return data;
+    if (data && typeof data === "object") {
+        const obj = data;
+        for (const key of ["results", "items", "suggestions", "data"]) {
+            if (Array.isArray(obj[key]))
+                return obj[key];
+        }
+    }
+    return [];
+}
+export function getSuggest(q) {
+    if (!q.trim())
+        return Promise.resolve({ ok: true, query: q, items: [] });
+    if (getIsLowMemory()) {
+        const half = Math.ceil(SUGGEST_CACHE_MAX / 2);
+        while (_cache.size > half) {
+            const first = _cache.keys().next().value;
+            if (first !== undefined)
+                _cache.delete(first);
+            else
+                break;
+        }
+    }
+    return _fetchSuggest(q);
+}
+export function getSuggestDebounced(q, callback, wait) {
+    _debouncedInner(q, callback, wait ?? getConfig().SUGGEST_DEBOUNCE_MS);
+}
+const _debouncedFns = new Map();
+function _debouncedInner(q, callback, wait) {
+    if (!_debouncedFns.has(wait)) {
+        // debounce に渡すラッパーを明示的に unknown[] 型にする
+        const fn = (innerQ, cb) => {
+            getSuggest(innerQ)
+                .then(cb)
+                .catch(() => cb({ ok: false, query: innerQ, items: [], error: "unknown" }));
+        };
+        _debouncedFns.set(wait, debounce(fn, { delay: wait, usePromise: false }));
+    }
+    _debouncedFns.get(wait)(q, callback);
+}
+//# sourceMappingURL=suggest.js.map

package/dist/suggest.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+type AnyFunction = (...args: never[]) => unknown;
+interface DebounceOptions {
+    delay?: number;
+    leading?: boolean;
+    trailing?: boolean;
+    usePromise?: boolean;
+}
+export declare function debounce<T extends AnyFunction>(fn: T, options?: DebounceOptions | number): {
+    (...args: Parameters<T>): Promise<ReturnType<T>> | void;
+    cancel(): void;
+    flush(): Promise<ReturnType<T>> | undefined;
+} & {
+    cancel: () => void;
+    flush: () => Promise<ReturnType<T>> | undefined;
+};
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAEjD,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,eAAe,GAAG,MAAW,GAiFlB;cA/CQ,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;cAkClD,IAAI;aAML,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAOjB;IACrC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CACjD,CACF"}

package/dist/utils.js

@@ -0,0 +1,72 @@
+// src/utils.ts
+import { getIsLowMemory } from "./memory.js";
+export function debounce(fn, options = {}) {
+    const opts = typeof options === "number" ? { delay: options } : options;
+    const { delay = 300, leading = false, trailing = true, usePromise = true, } = opts;
+    let timer;
+    let lastArgs;
+    let pending;
+    const getDelay = () => (getIsLowMemory() ? delay * 2 : delay);
+    const execute = async () => {
+        if (!lastArgs)
+            return undefined;
+        try {
+            const result = await fn(...lastArgs);
+            pending?.resolve(result);
+            return result;
+        }
+        catch (e) {
+            pending?.reject(e);
+            throw e;
+        }
+        finally {
+            pending = undefined;
+        }
+    };
+    const debounced = (...args) => {
+        lastArgs = args;
+        const shouldCallNow = leading && !timer;
+        if (timer)
+            clearTimeout(timer);
+        if (shouldCallNow) {
+            if (usePromise) {
+                return Promise.resolve(fn(...args));
+            }
+            fn(...args);
+            return;
+        }
+        if (!trailing)
+            return;
+        if (usePromise) {
+            return new Promise((resolve, reject) => {
+                pending?.reject(new Error("debounced_cancelled"));
+                pending = { resolve, reject };
+                timer = setTimeout(() => {
+                    timer = undefined;
+                    void execute();
+                }, getDelay());
+            });
+        }
+        timer = setTimeout(() => {
+            timer = undefined;
+            void fn(...lastArgs);
+        }, getDelay());
+    };
+    debounced.cancel = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        pending?.reject(new Error("debounced_cancelled"));
+        pending = undefined;
+    };
+    debounced.flush = () => {
+        if (!timer)
+            return;
+        clearTimeout(timer);
+        timer = undefined;
+        return execute();
+    };
+    return debounced;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@yunfie/search-js",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "license": "Apache-2.0",
+  "description": "",
+  "directories": {
+    "doc": "docs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yunfie-twitter/search-js.git"
+  },
+  "keywords": [],
+  "author": "yunfie",
+  "bugs": {
+    "url": "https://github.com/yunfie-twitter/search-js/issues"
+  },
+  "homepage": "https://github.com/yunfie-twitter/search-js#readme"
+}

package/src/cache/memory.ts

@@ -0,0 +1,79 @@
+// src/cache/memory.ts
+import { getConfig } from "../config.js";
+import { getCurrentCacheMax, getIsCriticalMemory } from "../memory.js";
+
+interface CacheItem {
+  time: number;
+  data: string | unknown;
+  parsed?: unknown;
+}
+
+interface CacheHit {
+  data: unknown;
+  expired: boolean;
+}
+
+export const store = new Map<string, CacheItem>();
+
+const _SEP = "\x00";
+export function getCacheKey(endpoint: string, params: Record<string, unknown>): string {
+  const sorted = Object.keys(params).sort();
+  let key = endpoint;
+  for (const k of sorted) {
+    const v = params[k];
+    if (v != null) key += _SEP + k + "=" + String(v);
+  }
+  return key;
+}
+
+export function get(key: string): CacheHit | null {
+  const item = store.get(key);
+  if (!item) return null;
+  store.delete(key);
+  store.set(key, item);
+  if (typeof item.data === "string" && item.parsed === undefined) {
+    try { item.parsed = JSON.parse(item.data); }
+    catch { item.parsed = item.data; }
+  }
+  return { data: item.parsed ?? item.data, expired: Date.now() - item.time > getConfig().CACHE_TTL };
+}
+
+export function set(key: string, data: unknown): void {
+  if (data == null) return;
+  const max = getCurrentCacheMax();
+  if (store.has(key)) store.delete(key);
+  while (store.size >= max) {
+    const firstKey = store.keys().next().value;
+    if (firstKey !== undefined) store.delete(firstKey as string);
+    else break;
+  }
+  const cfg = getConfig();
+  let jsonStr: string;
+  try {
+    jsonStr = typeof data === "string" ? data : JSON.stringify(data);
+  } catch { return; }
+  store.set(key, {
+    time: Date.now(),
+    data: jsonStr.length < cfg.STRINGIFY_SIZE_THRESHOLD ? jsonStr : data,
+  });
+}
+
+export function evictExpired(): void {
+  const ttl = getConfig().CACHE_TTL;
+  const now = Date.now();
+  for (const [key, item] of store) {
+    if (now - item.time > ttl) store.delete(key);
+  }
+}
+
+export function trimToHalf(): void {
+  if (!getIsCriticalMemory()) return;
+  const half = Math.ceil(store.size / 2);
+  while (store.size > half) {
+    const firstKey = store.keys().next().value;
+    if (firstKey !== undefined) store.delete(firstKey as string);
+    else break;
+  }
+}
+
+export function clearStore(): void { store.clear(); }