@iflow-ai/search-core 0.1.0-pre.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iFlow AI
+
+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.

package/README.md

@@ -0,0 +1,49 @@
+# @iflow-ai/search-core
+
+Framework-agnostic SDK for the [iFlow Search API](https://platform.iflow.cn/docs/) — web search, image search, web fetch.
+
+- Zero runtime dependencies
+- Node ≥ 18 (uses global `fetch`)
+- Injectable `fetch` for tests
+- Per-request timeout + external `AbortSignal`
+- Plain-object result envelope; never throws on API errors
+- Attribution headers built in (every request advertises which integration sent it)
+
+This package is the shared core consumed by:
+
+- `@iflow-ai/search-langchain` — LangChain JS tool adapter
+- `@iflow-ai/search-mcp` — MCP server
+
+## Install
+
+```bash
+npm i @iflow-ai/search-core
+```
+
+## Quick start
+
+```ts
+import { createIFlowSearchClient } from "@iflow-ai/search-core";
+
+const client = createIFlowSearchClient({
+  apiKey: process.env.IFLOW_API_KEY!,
+  source: "core",
+  integrationName: "my-app",
+  integrationVersion: "1.0.0",
+});
+
+const result = await client.webSearch({ query: "flash attention", count: 5 });
+if (!result.ok) {
+  console.error(result.error.code, result.error.message);
+} else {
+  for (const r of result.data.results) console.log(r.title, r.url);
+}
+```
+
+## API
+
+See [`src/index.ts`](./src/index.ts) for the full public surface.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * IFlowSearchClient — Bearer-authenticated POST client for iFlow Search.
+ *
+ *   - global fetch (Node ≥18), injectable for tests
+ *   - per-request timeout via AbortController; external signal forwarded
+ *   - never throws on API errors; returns IFlowResult<T>
+ *   - never logs the API key
+ *   - no retry, no cache (adapters add those when needed)
+ */
+import type { IFlowResult, IFlowSearchClientOptions, ImageSearchParams, NormalizedImageSearch, NormalizedWebFetch, NormalizedWebSearch, WebFetchParams, WebSearchParams } from "./types.js";
+export declare class IFlowSearchClient {
+    private readonly config;
+    constructor(opts: IFlowSearchClientOptions);
+    webSearch(params: WebSearchParams, signal?: AbortSignal): Promise<IFlowResult<NormalizedWebSearch>>;
+    imageSearch(params: ImageSearchParams, signal?: AbortSignal): Promise<IFlowResult<NormalizedImageSearch>>;
+    webFetch(params: WebFetchParams, signal?: AbortSignal): Promise<IFlowResult<NormalizedWebFetch>>;
+    private checkApiKey;
+    private call;
+}
+export declare function createIFlowSearchClient(opts: IFlowSearchClientOptions): IFlowSearchClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8BH,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AA4CpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,IAAI,EAAE,wBAAwB;IAIpC,SAAS,CACb,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAwBtC,WAAW,CACf,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAwBxC,QAAQ,CACZ,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAoB3C,OAAO,CAAC,WAAW;YAIL,IAAI;CAoFnB;AAkBD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,iBAAiB,CAEzF"}

package/dist/client.js

@@ -0,0 +1,200 @@
+/**
+ * IFlowSearchClient — Bearer-authenticated POST client for iFlow Search.
+ *
+ *   - global fetch (Node ≥18), injectable for tests
+ *   - per-request timeout via AbortController; external signal forwarded
+ *   - never throws on API errors; returns IFlowResult<T>
+ *   - never logs the API key
+ *   - no retry, no cache (adapters add those when needed)
+ */
+import { DEFAULT_TIMEOUT_MS, IMAGE_SEARCH_DEFAULT_COUNT, IMAGE_SEARCH_MAX_COUNT, WEB_SEARCH_DEFAULT_COUNT, WEB_SEARCH_MAX_COUNT, normalizeBaseUrl, } from "./config.js";
+import { apiBusinessError, apiHttpError, invalidParamError, missingApiKeyError, missingParamError, networkError, networkTimeoutError, } from "./errors.js";
+import { buildAttributionHeaders } from "./headers.js";
+import { normalizeImageSearch, normalizeWebFetch, normalizeWebSearch, } from "./normalize.js";
+const ENDPOINTS = {
+    webSearch: "/api/search/webSearch",
+    imageSearch: "/api/search/imageSearch",
+    webFetch: "/api/search/webFetch",
+};
+function resolveOptions(opts) {
+    const fetchImpl = opts.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+        throw new Error("IFlowSearchClient: global fetch is not available; pass `fetch` explicitly (Node <18 or non-standard runtime).");
+    }
+    const timeoutMs = typeof opts.timeoutMs === "number" && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0
+        ? opts.timeoutMs
+        : DEFAULT_TIMEOUT_MS;
+    return {
+        apiKey: typeof opts.apiKey === "string" ? opts.apiKey : "",
+        baseUrl: normalizeBaseUrl(opts.baseUrl),
+        timeoutMs,
+        fetchImpl,
+        attributionHeaders: buildAttributionHeaders({
+            source: opts.source,
+            integrationName: opts.integrationName,
+            integrationVersion: opts.integrationVersion,
+        }),
+    };
+}
+export class IFlowSearchClient {
+    config;
+    constructor(opts) {
+        this.config = resolveOptions(opts);
+    }
+    async webSearch(params, signal) {
+        const keyMissing = this.checkApiKey();
+        if (keyMissing)
+            return { ok: false, error: keyMissing };
+        const query = (params?.query ?? "").trim();
+        if (!query)
+            return { ok: false, error: missingParamError("query") };
+        const count = params.count ?? WEB_SEARCH_DEFAULT_COUNT;
+        const countError = validateCount(count, WEB_SEARCH_MAX_COUNT);
+        if (countError)
+            return { ok: false, error: countError };
+        const started = Date.now();
+        const httpResult = await this.call("webSearch", { keywords: query, num: count }, signal);
+        if (!httpResult.ok)
+            return httpResult;
+        return {
+            ok: true,
+            data: normalizeWebSearch(httpResult.data, query, Date.now() - started),
+        };
+    }
+    async imageSearch(params, signal) {
+        const keyMissing = this.checkApiKey();
+        if (keyMissing)
+            return { ok: false, error: keyMissing };
+        const query = (params?.query ?? "").trim();
+        if (!query)
+            return { ok: false, error: missingParamError("query") };
+        const count = params.count ?? IMAGE_SEARCH_DEFAULT_COUNT;
+        const countError = validateCount(count, IMAGE_SEARCH_MAX_COUNT);
+        if (countError)
+            return { ok: false, error: countError };
+        const started = Date.now();
+        const httpResult = await this.call("imageSearch", { keywords: query, num: count }, signal);
+        if (!httpResult.ok)
+            return httpResult;
+        return {
+            ok: true,
+            data: normalizeImageSearch(httpResult.data, query, Date.now() - started),
+        };
+    }
+    async webFetch(params, signal) {
+        const keyMissing = this.checkApiKey();
+        if (keyMissing)
+            return { ok: false, error: keyMissing };
+        const url = (params?.url ?? "").trim();
+        if (!url)
+            return { ok: false, error: missingParamError("url") };
+        const started = Date.now();
+        const httpResult = await this.call("webFetch", { url }, signal);
+        if (!httpResult.ok)
+            return httpResult;
+        return {
+            ok: true,
+            data: normalizeWebFetch(httpResult.data, url, Date.now() - started),
+        };
+    }
+    checkApiKey() {
+        return this.config.apiKey ? null : missingApiKeyError();
+    }
+    async call(endpoint, body, externalSignal) {
+        const { baseUrl, timeoutMs, fetchImpl, apiKey, attributionHeaders } = this.config;
+        const url = `${baseUrl}${ENDPOINTS[endpoint]}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        if (externalSignal) {
+            if (externalSignal.aborted) {
+                controller.abort();
+            }
+            else {
+                externalSignal.addEventListener("abort", () => controller.abort(), { once: true });
+            }
+        }
+        let response;
+        try {
+            response = await fetchImpl(url, {
+                method: "POST",
+                headers: {
+                    ...attributionHeaders,
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            const e = err;
+            if (e?.name === "AbortError") {
+                return { ok: false, error: networkTimeoutError(timeoutMs) };
+            }
+            return { ok: false, error: networkError(e?.message ?? String(err)) };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok) {
+            let detail = "";
+            try {
+                detail = (await response.text()).slice(0, 500);
+            }
+            catch {
+                // ignore
+            }
+            return { ok: false, error: apiHttpError(response.status, detail || response.statusText) };
+        }
+        let parsed;
+        try {
+            parsed = await response.json();
+        }
+        catch {
+            return {
+                ok: false,
+                error: {
+                    code: "api_error",
+                    message: "iFlow returned a non-JSON response.",
+                    status: response.status,
+                },
+            };
+        }
+        const envelope = parsed;
+        if (envelope?.success !== true) {
+            const dataObj = envelope?.data && typeof envelope.data === "object" && !Array.isArray(envelope.data)
+                ? envelope.data
+                : undefined;
+            return {
+                ok: false,
+                error: apiBusinessError({
+                    code: envelope?.code ?? null,
+                    message: envelope?.message ?? null,
+                    errorMsg: dataObj?.errorMsg ?? null,
+                    errorCode: dataObj?.errorCode ?? null,
+                }),
+            };
+        }
+        return { ok: true, data: parsed };
+    }
+}
+function validateCount(count, max) {
+    if (typeof count !== "number" || !Number.isFinite(count)) {
+        return invalidParamError("count", "must be a finite number");
+    }
+    if (!Number.isInteger(count)) {
+        return invalidParamError("count", "must be an integer");
+    }
+    if (count < 1) {
+        return invalidParamError("count", "must be ≥ 1");
+    }
+    if (count > max) {
+        return invalidParamError("count", `must be ≤ ${max}`);
+    }
+    return null;
+}
+export function createIFlowSearchClient(opts) {
+    return new IFlowSearchClient(opts);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Defaults and the env-var name for the iFlow API key. Adapters that want
+ * the env fallback can read it themselves — the core client requires an
+ * explicit apiKey to avoid surprising production behavior.
+ */
+export declare const DEFAULT_BASE_URL = "https://platform.iflow.cn";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const ENV_API_KEY = "IFLOW_API_KEY";
+export declare const WEB_SEARCH_MAX_COUNT = 20;
+export declare const WEB_SEARCH_DEFAULT_COUNT = 10;
+export declare const IMAGE_SEARCH_MAX_COUNT = 20;
+export declare const IMAGE_SEARCH_DEFAULT_COUNT = 10;
+/** Strip trailing slashes so concatenating "/api/..." never double-slashes. */
+export declare function normalizeBaseUrl(raw: string | undefined): string;
+/** Mask an API key for logs. Adapters should use this; core never logs keys. */
+export declare function redactApiKey(key: string | undefined): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,WAAW,kBAAkB,CAAC;AAE3C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIhE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI5D"}

package/dist/config.js

@@ -0,0 +1,28 @@
+/**
+ * Defaults and the env-var name for the iFlow API key. Adapters that want
+ * the env fallback can read it themselves — the core client requires an
+ * explicit apiKey to avoid surprising production behavior.
+ */
+export const DEFAULT_BASE_URL = "https://platform.iflow.cn";
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const ENV_API_KEY = "IFLOW_API_KEY";
+export const WEB_SEARCH_MAX_COUNT = 20;
+export const WEB_SEARCH_DEFAULT_COUNT = 10;
+export const IMAGE_SEARCH_MAX_COUNT = 20;
+export const IMAGE_SEARCH_DEFAULT_COUNT = 10;
+/** Strip trailing slashes so concatenating "/api/..." never double-slashes. */
+export function normalizeBaseUrl(raw) {
+    const value = (raw ?? DEFAULT_BASE_URL).trim();
+    if (!value)
+        return DEFAULT_BASE_URL;
+    return value.replace(/\/+$/u, "") || DEFAULT_BASE_URL;
+}
+/** Mask an API key for logs. Adapters should use this; core never logs keys. */
+export function redactApiKey(key) {
+    if (!key)
+        return "<unset>";
+    if (key.length <= 8)
+        return "***";
+    return `${key.slice(0, 4)}***${key.slice(-2)}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAE3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,GAAuB;IACtD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,gBAAgB,CAAC;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC;AACxD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Error taxonomy. Plain objects, never Error subclasses, so adapters can
+ * serialize them straight to JSON without losing fields.
+ */
+export type IFlowErrorCode = "missing_api_key" | "missing_param" | "invalid_param" | "network_timeout" | "network_error" | "api_error" | "api_business_error";
+export interface IFlowError {
+    code: IFlowErrorCode;
+    message: string;
+    status?: number;
+    detail?: unknown;
+}
+export declare function isIFlowError(value: unknown): value is IFlowError;
+export declare function missingApiKeyError(): IFlowError;
+export declare function missingParamError(name: string): IFlowError;
+export declare function invalidParamError(name: string, detail: string): IFlowError;
+export declare function networkTimeoutError(timeoutMs: number): IFlowError;
+export declare function networkError(detail: string): IFlowError;
+export declare function apiHttpError(status: number, detailText: string): IFlowError;
+export interface BusinessErrorInput {
+    code?: string | number | null;
+    message?: string | null;
+    errorMsg?: string | null;
+    errorCode?: string | number | null;
+}
+export declare function apiBusinessError(input: BusinessErrorInput): IFlowError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,WAAW,GACX,oBAAoB,CAAC;AAEzB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAIhE;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAO/C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAK1E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAKjE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAKvD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAM3E;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CAetE"}

package/dist/errors.js

@@ -0,0 +1,66 @@
+/**
+ * Error taxonomy. Plain objects, never Error subclasses, so adapters can
+ * serialize them straight to JSON without losing fields.
+ */
+export function isIFlowError(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return typeof v.code === "string" && typeof v.message === "string";
+}
+export function missingApiKeyError() {
+    return {
+        code: "missing_api_key",
+        message: "iFlow Search needs an API key. Set IFLOW_API_KEY in the environment, " +
+            "or pass apiKey when constructing the client.",
+    };
+}
+export function missingParamError(name) {
+    return { code: "missing_param", message: `Parameter "${name}" is required.` };
+}
+export function invalidParamError(name, detail) {
+    return {
+        code: "invalid_param",
+        message: `Parameter "${name}" is invalid: ${detail}`,
+    };
+}
+export function networkTimeoutError(timeoutMs) {
+    return {
+        code: "network_timeout",
+        message: `Request to iFlow timed out after ${Math.round(timeoutMs)}ms.`,
+    };
+}
+export function networkError(detail) {
+    return {
+        code: "network_error",
+        message: `Network error talking to iFlow: ${detail}`,
+    };
+}
+export function apiHttpError(status, detailText) {
+    let message = detailText || `HTTP ${status}`;
+    if (status === 401)
+        message = "401 Unauthorized — iFlow API key missing or invalid.";
+    else if (status === 403)
+        message = "403 Forbidden — iFlow API key is not allowed for this endpoint.";
+    else if (status === 429)
+        message = "429 Too Many Requests — iFlow rate limit reached.";
+    return { code: "api_error", status, message, detail: detailText || undefined };
+}
+export function apiBusinessError(input) {
+    const parts = [];
+    if (input.message)
+        parts.push(String(input.message));
+    if (input.errorMsg && input.errorMsg !== input.message) {
+        parts.push(`detail: ${input.errorMsg}`);
+    }
+    const message = parts.join(" — ") || "iFlow API returned success=false without a message.";
+    return {
+        code: "api_business_error",
+        message,
+        detail: {
+            code: input.errorCode ?? input.code ?? null,
+            errorMsg: input.errorMsg ?? null,
+        },
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAA8C,CAAC;IACzD,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,OAAO,EACL,uEAAuE;YACvE,8CAA8C;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,IAAI,gBAAgB,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAc;IAC5D,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,cAAc,IAAI,iBAAiB,MAAM,EAAE;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,oCAAoC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,mCAAmC,MAAM,EAAE;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAAkB;IAC7D,IAAI,OAAO,GAAG,UAAU,IAAI,QAAQ,MAAM,EAAE,CAAC;IAC7C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,GAAG,sDAAsD,CAAC;SAChF,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,GAAG,iEAAiE,CAAC;SAChG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,GAAG,mDAAmD,CAAC;IACvF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC;AACjF,CAAC;AASD,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,qDAAqD,CAAC;IAC3F,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,OAAO;QACP,MAAM,EAAE;YACN,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;YAC3C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;SACjC;KACF,CAAC;AACJ,CAAC"}

package/dist/headers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Attribution header builder.
+ *
+ * Every outbound iFlow Search request carries:
+ *
+ *   IFlow-Source:              who's calling (framework name, e.g. "langchain")
+ *   IFlow-Integration:         the npm package making the call
+ *   IFlow-Integration-Version: that package's version
+ *   User-Agent:                "<integrationName>/<integrationVersion>"
+ *
+ * Caller supplies all three values — search-core does not hard-code a source.
+ */
+export interface AttributionInput {
+    source: string;
+    integrationName: string;
+    integrationVersion: string;
+}
+export interface AttributionHeaders {
+    "IFlow-Source": string;
+    "IFlow-Integration": string;
+    "IFlow-Integration-Version": string;
+    "User-Agent": string;
+}
+export declare function buildAttributionHeaders(input: AttributionInput): AttributionHeaders;
+//# sourceMappingURL=headers.d.ts.map

package/dist/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2BAA2B,EAAE,MAAM,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,CAUnF"}

package/dist/headers.js

@@ -0,0 +1,29 @@
+/**
+ * Attribution header builder.
+ *
+ * Every outbound iFlow Search request carries:
+ *
+ *   IFlow-Source:              who's calling (framework name, e.g. "langchain")
+ *   IFlow-Integration:         the npm package making the call
+ *   IFlow-Integration-Version: that package's version
+ *   User-Agent:                "<integrationName>/<integrationVersion>"
+ *
+ * Caller supplies all three values — search-core does not hard-code a source.
+ */
+function requireNonEmpty(name, value) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`buildAttributionHeaders: "${name}" must be a non-empty string.`);
+    }
+}
+export function buildAttributionHeaders(input) {
+    requireNonEmpty("source", input.source);
+    requireNonEmpty("integrationName", input.integrationName);
+    requireNonEmpty("integrationVersion", input.integrationVersion);
+    return {
+        "IFlow-Source": input.source,
+        "IFlow-Integration": input.integrationName,
+        "IFlow-Integration-Version": input.integrationVersion,
+        "User-Agent": `${input.integrationName}/${input.integrationVersion}`,
+    };
+}
+//# sourceMappingURL=headers.js.map

package/dist/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,+BAA+B,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAuB;IAC7D,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,eAAe,CAAC,iBAAiB,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAC1D,eAAe,CAAC,oBAAoB,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChE,OAAO;QACL,cAAc,EAAE,KAAK,CAAC,MAAM;QAC5B,mBAAmB,EAAE,KAAK,CAAC,eAAe;QAC1C,2BAA2B,EAAE,KAAK,CAAC,kBAAkB;QACrD,YAAY,EAAE,GAAG,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,kBAAkB,EAAE;KACrE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @iflow-ai/search-core — framework-agnostic SDK for the iFlow Search API.
+ *
+ * See README.md for usage.
+ */
+export { IFlowSearchClient, createIFlowSearchClient, } from "./client.js";
+export { buildAttributionHeaders, type AttributionHeaders, type AttributionInput, } from "./headers.js";
+export { isIFlowError, type IFlowError, type IFlowErrorCode, } from "./errors.js";
+export { normalizeImageSearch, normalizeWebFetch, normalizeWebSearch, type IFlowEnvelope, } from "./normalize.js";
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, ENV_API_KEY, IMAGE_SEARCH_DEFAULT_COUNT, IMAGE_SEARCH_MAX_COUNT, WEB_SEARCH_DEFAULT_COUNT, WEB_SEARCH_MAX_COUNT, redactApiKey, } from "./config.js";
+export type { IFlowResult, IFlowSearchClientOptions, ImageSearchParams, NormalizedImage, NormalizedImageSearch, NormalizedWebFetch, NormalizedWebSearch, NormalizedWebSearchResult, WebFetchParams, WebSearchParams, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @iflow-ai/search-core — framework-agnostic SDK for the iFlow Search API.
+ *
+ * See README.md for usage.
+ */
+export { IFlowSearchClient, createIFlowSearchClient, } from "./client.js";
+export { buildAttributionHeaders, } from "./headers.js";
+export { isIFlowError, } from "./errors.js";
+export { normalizeImageSearch, normalizeWebFetch, normalizeWebSearch, } from "./normalize.js";
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, ENV_API_KEY, IMAGE_SEARCH_DEFAULT_COUNT, IMAGE_SEARCH_MAX_COUNT, WEB_SEARCH_DEFAULT_COUNT, WEB_SEARCH_MAX_COUNT, redactApiKey, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,GAGxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,GAGb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Map raw iFlow API responses into framework-agnostic normalized shapes.
+ *
+ * Field mapping mirrors observed iFlow API responses (see openclaw plugin
+ * normalize.ts header comment for the schema reference). Defensive coercion
+ * keeps the LLM-facing payload predictable even when iFlow emits null or
+ * unexpected types.
+ */
+import type { NormalizedImageSearch, NormalizedWebFetch, NormalizedWebSearch } from "./types.js";
+export interface IFlowEnvelope<T> {
+    success?: boolean;
+    code?: string | number;
+    message?: string;
+    data?: T;
+}
+export interface RawOrganicItem {
+    title?: unknown;
+    link?: unknown;
+    snippet?: unknown;
+    position?: unknown;
+    date?: unknown;
+}
+export interface RawWebSearchData {
+    query?: unknown;
+    organic?: RawOrganicItem[] | null;
+}
+export interface RawImageItem {
+    url?: unknown;
+    title?: unknown;
+    refUrl?: unknown;
+    width?: unknown;
+    height?: unknown;
+    position?: unknown;
+}
+export type RawImageSearchData = RawImageItem[];
+export interface RawWebFetchData {
+    title?: unknown;
+    content?: unknown;
+    url?: unknown;
+    fromCache?: unknown;
+}
+export declare function normalizeWebSearch(raw: IFlowEnvelope<RawWebSearchData> | null | undefined, requestQuery: string, tookMs: number): NormalizedWebSearch;
+export declare function normalizeImageSearch(raw: IFlowEnvelope<RawImageSearchData> | null | undefined, requestQuery: string, tookMs: number): NormalizedImageSearch;
+export declare function normalizeWebFetch(raw: IFlowEnvelope<RawWebFetchData> | null | undefined, requestUrl: string, tookMs: number): NormalizedWebFetch;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,EAAE,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAcD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,IAAI,GAAG,SAAS,EACvD,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,mBAAmB,CAkBrB;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,GAAG,SAAS,EACzD,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,qBAAqB,CAoBvB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,kBAAkB,CAWpB"}

package/dist/normalize.js

@@ -0,0 +1,69 @@
+/**
+ * Map raw iFlow API responses into framework-agnostic normalized shapes.
+ *
+ * Field mapping mirrors observed iFlow API responses (see openclaw plugin
+ * normalize.ts header comment for the schema reference). Defensive coercion
+ * keeps the LLM-facing payload predictable even when iFlow emits null or
+ * unexpected types.
+ */
+function asString(v, fallback = "") {
+    return typeof v === "string" ? v : fallback;
+}
+function asNullableString(v) {
+    return typeof v === "string" && v.length > 0 ? v : null;
+}
+function asNullableNumber(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+export function normalizeWebSearch(raw, requestQuery, tookMs) {
+    const data = raw?.data;
+    const organic = Array.isArray(data?.organic) ? data.organic : [];
+    const results = organic
+        .filter((r) => r !== null && typeof r === "object")
+        .map((r) => ({
+        title: asString(r.title),
+        url: asString(r.link),
+        snippet: asString(r.snippet),
+        position: asNullableNumber(r.position),
+        date: asNullableString(r.date),
+    }));
+    return {
+        query: asString(data?.query, requestQuery),
+        count: results.length,
+        tookMs,
+        results,
+    };
+}
+export function normalizeImageSearch(raw, requestQuery, tookMs) {
+    const data = raw?.data;
+    const arr = Array.isArray(data) ? data : [];
+    const images = arr
+        .filter((r) => r !== null && typeof r === "object")
+        .map((r) => ({
+        imageUrl: asString(r.url),
+        title: asNullableString(r.title),
+        sourceUrl: asNullableString(r.refUrl),
+        width: asNullableNumber(r.width),
+        height: asNullableNumber(r.height),
+        position: asNullableNumber(r.position),
+    }))
+        .filter((img) => img.imageUrl.length > 0);
+    return {
+        query: requestQuery,
+        count: images.length,
+        tookMs,
+        images,
+    };
+}
+export function normalizeWebFetch(raw, requestUrl, tookMs) {
+    const data = raw?.data;
+    const fromCache = typeof data?.fromCache === "boolean" ? data.fromCache : null;
+    return {
+        url: asString(data?.url, requestUrl),
+        title: asNullableString(data?.title),
+        content: asString(data?.content),
+        fromCache,
+        tookMs,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Public types for @iflow-ai/search-core.
+ *
+ * Plain objects only. No framework couplings.
+ */
+export interface WebSearchParams {
+    query: string;
+    /** Number of results. Default 10, range 1..20. */
+    count?: number;
+}
+export interface ImageSearchParams {
+    query: string;
+    count?: number;
+}
+export interface WebFetchParams {
+    url: string;
+}
+export interface NormalizedWebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    position: number | null;
+    date: string | null;
+}
+export interface NormalizedWebSearch {
+    query: string;
+    count: number;
+    tookMs: number;
+    results: NormalizedWebSearchResult[];
+}
+export interface NormalizedImage {
+    imageUrl: string;
+    title: string | null;
+    sourceUrl: string | null;
+    width: number | null;
+    height: number | null;
+    position: number | null;
+}
+export interface NormalizedImageSearch {
+    query: string;
+    count: number;
+    tookMs: number;
+    images: NormalizedImage[];
+}
+export interface NormalizedWebFetch {
+    url: string;
+    title: string | null;
+    content: string;
+    fromCache: boolean | null;
+    tookMs: number;
+}
+import type { IFlowError } from "./errors.js";
+export type IFlowResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: IFlowError;
+};
+export interface IFlowSearchClientOptions {
+    apiKey: string;
+    /** Default https://platform.iflow.cn. Trailing slashes stripped. */
+    baseUrl?: string;
+    /** Per-request timeout in ms. Default 30000. */
+    timeoutMs?: number;
+    /** Injectable for tests. Falls back to global fetch (Node ≥18). */
+    fetch?: typeof fetch;
+    /** e.g. "langchain" | "mcp" | "openclaw" | "core". Required. */
+    source: string;
+    /** e.g. "@iflow-ai/search-langchain". Required. */
+    integrationName: string;
+    /** e.g. "1.2.3". Required. */
+    integrationVersion: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAID,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAIrC,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Public types for @iflow-ai/search-core.
+ *
+ * Plain objects only. No framework couplings.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@iflow-ai/search-core",
+  "version": "0.1.0-pre.0",
+  "description": "Framework-agnostic SDK for the iFlow Search API (web search, image search, web fetch). Zero runtime dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhengyanglsun/iflow-search-js.git",
+    "directory": "packages/search-core"
+  },
+  "bugs": {
+    "url": "https://github.com/zhengyanglsun/iflow-search-js/issues"
+  },
+  "homepage": "https://github.com/zhengyanglsun/iflow-search-js/tree/main/packages/search-core#readme",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "iflow",
+    "iflow-search",
+    "web-search",
+    "image-search",
+    "web-fetch",
+    "ai-search",
+    "search-sdk"
+  ],
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}