@memberjunction/web-search-engine 0.0.1-seed.2 → 6.2.0-edge.0

package/dist/providers/httpFailure.js

@@ -0,0 +1,136 @@
+/**
+ * @fileoverview Shared HTTP failure classification for web search drivers.
+ * @module @memberjunction/web-search-engine
+ */
+import { IsHttpError } from '@memberjunction/network-utils';
+/**
+ * Phrases a vendor uses when the *credential* was rejected, matched against the response body.
+ *
+ * Lowercased, and compared with `String.includes` rather than a regular expression — this package
+ * deliberately runs no regex over remote input, and that property is worth more than the brevity.
+ *
+ * Kept specific enough not to fire on a genuine query rejection: "api key" alone would match a
+ * search *for* the phrase, so each entry carries the verb that makes it a credential verdict.
+ */
+const CREDENTIAL_REJECTION_MARKERS = [
+    // Google Custom Search: HTTP 400 with reason `keyInvalid`
+    'api key not valid',
+    'keyinvalid',
+    'keyexpired',
+    'api key expired',
+    // Widely used phrasings across the other vendors
+    'invalid api key',
+    'api key is invalid',
+    'invalid_api_key',
+    'api_key_invalid',
+    'missing api key',
+    'no api key',
+    'invalid authentication',
+    'unauthorized',
+];
+/**
+ * Whether a 400-class body is really an authentication verdict rather than a bad query.
+ *
+ * Both the extracted detail and the raw serialized body are searched, because the marker is not
+ * always in the field {@link describeErrorBody} picks: Google puts `"message": "API key not
+ * valid…"` at `error.message` but the machine-readable `"reason": "keyInvalid"` inside
+ * `error.errors[]`, which the extractor never reaches.
+ */
+function isCredentialRejection(detail, error) {
+    const haystack = `${detail} ${serializeBody(error.Data)}`.toLowerCase();
+    return CREDENTIAL_REJECTION_MARKERS.some((marker) => haystack.includes(marker));
+}
+/** Flatten a response body to searchable text, bounded so a large body cannot dominate the scan. */
+function serializeBody(data) {
+    if (typeof data === 'string') {
+        return data.slice(0, 2000);
+    }
+    if (data && typeof data === 'object') {
+        try {
+            return JSON.stringify(data).slice(0, 2000);
+        }
+        catch {
+            // Circular or otherwise unserialisable — the extracted detail still carries a verdict.
+            return '';
+        }
+    }
+    return '';
+}
+/**
+ * Classify an error thrown by a vendor call into the kind that drives engine failover.
+ *
+ * The distinction is about **the request, not the vendor**: a 400/422 normally means this query is
+ * malformed and every other provider will reject it too, so the engine must stop rather than
+ * spend four more paid calls learning the same thing. Everything else — auth, quota, 5xx,
+ * timeouts — is specific to this vendor and another may well succeed.
+ *
+ * A missing or invalid API key is deliberately `transient` in that sense: the request is fine,
+ * *this* provider just cannot serve it, so moving on is exactly right.
+ *
+ * **Status alone does not decide that**, which is why a 400 is inspected before it is trusted.
+ * Google Custom Search answers an invalid key with HTTP 400 (`reason: keyInvalid`), not 401 — so
+ * classifying by status alone made a dead Google key stop the whole run, on precisely the vendor
+ * whose keys are expected to stop working when the API is discontinued on 2027-01-01. Perplexity
+ * answers the same condition with 401 and failed over correctly, which is what made the
+ * inconsistency easy to miss.
+ */
+export function classifyHttpFailure(error, vendor) {
+    // Status 0 is HttpError's "the request never produced a response" — a timeout or network
+    // failure, which is transient by definition.
+    if (IsHttpError(error) && error.Status > 0) {
+        const status = error.Status;
+        const detail = describeErrorBody(error) || error.message;
+        if (status === 400 || status === 422) {
+            // An auth verdict dressed as a bad request: another provider may well serve this query.
+            if (isCredentialRejection(detail, error)) {
+                return failure('transient', `${vendor} rejected the API key (HTTP ${status}): ${detail}`);
+            }
+            return failure('permanent', `${vendor} rejected the request (HTTP ${status}): ${detail}`);
+        }
+        if (status === 401 || status === 403) {
+            return failure('transient', `${vendor} rejected the API key (HTTP ${status}): ${detail}`);
+        }
+        if (status === 429) {
+            return failure('transient', `${vendor} rate limit or quota exceeded: ${detail}`);
+        }
+        return failure('transient', `${vendor} API error (HTTP ${status}): ${detail}`);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return failure('transient', `${vendor} request failed: ${message}`);
+}
+/** Build a failed provider response. */
+export function failure(kind, message) {
+    return { Success: false, Hits: [], FailureKind: kind, ErrorMessage: message };
+}
+/** Pull whatever explanation an error body carries, without assuming a shape. */
+function describeErrorBody(error) {
+    const data = error.Data;
+    if (typeof data === 'string') {
+        return data.slice(0, 500);
+    }
+    if (data && typeof data === 'object') {
+        const record = data;
+        for (const key of ['detail', 'message', 'error']) {
+            const value = record[key];
+            if (typeof value === 'string' && value.length > 0) {
+                return value;
+            }
+            // Several vendors nest as { error: { message | detail } }.
+            if (value && typeof value === 'object') {
+                const nested = value;
+                for (const nestedKey of ['message', 'detail', 'code']) {
+                    const nestedValue = nested[nestedKey];
+                    if (typeof nestedValue === 'string' && nestedValue.length > 0) {
+                        return nestedValue;
+                    }
+                }
+            }
+        }
+    }
+    return '';
+}
+/** Map a relative freshness window onto a vendor's own code table. */
+export function mapFreshnessWindow(window, codes) {
+    return codes[window];
+}
+//# sourceMappingURL=httpFailure.js.map

package/dist/providers/httpFailure.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,214 @@
+/**
+ * @fileoverview Public types for the MemberJunction web search engine.
+ *
+ * Web search is deliberately a **separate concern** from `@memberjunction/search-engine`.
+ * That engine searches content MJ owns — entity records, vectors, full-text indexes, storage
+ * files — and its `SearchResultItem` requires `EntityName` and `RecordID`, the primary key of a
+ * source record. A web result has a URL and none of those. Fitting one in would mean lying in
+ * the type and dragging the hit through enrichment built to decorate entity records.
+ *
+ * What the two DO share is the plugin *pattern*: a provider table carrying `DriverClass`,
+ * `Priority`, `Status` and `CredentialID`; ClassFactory resolution; and the
+ * `Initialize()` → `CheckAvailability()` → `IsAvailable()` lifecycle.
+ *
+ * @module @memberjunction/web-search-engine
+ */
+/**
+ * One result from a web search provider, normalised across vendors.
+ *
+ * The first three fields are the contract every provider must satisfy, and they are
+ * deliberately the same shape the retiring `Google Custom Search` action returns — which is
+ * what makes migrating off it a rename rather than a rewrite.
+ */
+export interface WebSearchHit {
+    /** Page title as the provider reports it. */
+    Title: string;
+    /** Absolute URL of the result. */
+    URL: string;
+    /** Snippet or extracted content. Length and style vary by provider. */
+    Snippet: string;
+    /** Host as the provider displays it, e.g. `irs.gov`. Absent when the provider omits it. */
+    DisplayURL?: string;
+    /** Publication or last-modified date, when the provider resolved one. */
+    PublishedAt?: Date;
+    /**
+     * The provider's own relevance score for this hit.
+     *
+     * **Provider-relative and not comparable across providers** — Brave, Tavily and Perplexity
+     * each compute it differently and none is a calibrated probability. Use it to order hits
+     * within one response; never threshold on it, and never compare it between providers.
+     */
+    Score?: number;
+    /**
+     * Provider-specific extras that do not fit the normalised shape — Brave's extra snippets,
+     * Tavily's raw page content, Perplexity's last-updated stamp.
+     *
+     * This exists so normalisation does not become a lowest-common-denominator: a caller that
+     * knows which provider answered (via {@link WebSearchResult.ProviderUsed}) can reach for
+     * what makes that provider worth having.
+     */
+    ProviderExtras?: Record<string, unknown>;
+}
+/** Relative freshness windows every provider can express in some form. */
+export type WebSearchFreshnessWindow = 'day' | 'week' | 'month' | 'year';
+/** An absolute date range. Providers that cannot express one fall back to their nearest window. */
+export interface WebSearchDateRange {
+    From: Date;
+    To: Date;
+}
+export type WebSearchFreshness = WebSearchFreshnessWindow | WebSearchDateRange;
+/** Adult-content filtering level. */
+export type WebSearchSafeSearch = 'off' | 'moderate' | 'strict';
+/**
+ * What a driver can do. Declared on the **class**, not stored in the database.
+ *
+ * Capability is a property of the driver implementation; the database row holds *configuration*
+ * — on/off, order, credentials, limits. This mirrors how `search-engine` declares `SourceType`
+ * on `BaseSearchProvider` rather than in the `SearchProvider` table.
+ */
+export interface WebSearchCapabilities {
+    /** Can return a synthesized answer alongside hits (Tavily, Perplexity — not Brave). */
+    Answer: boolean;
+    /** Honours `IncludeDomains` / `ExcludeDomains`. */
+    DomainFilter: boolean;
+    /** Honours `Freshness`. */
+    Freshness: boolean;
+    /** Honours `Country` / `Language`. */
+    Region: boolean;
+    /** The vendor's hard cap on results per request. Requests above it are clamped, not rejected. */
+    MaxResultsCap: number;
+}
+/** Parameters for a web search. Only `Query` is required. */
+export interface WebSearchParams {
+    /** The search query. Required, non-empty. */
+    Query: string;
+    /** Desired result count. Clamped to the serving provider's cap. Default 10. */
+    MaxResults?: number;
+    /**
+     * Pin the search to one provider, by `Name` (case-insensitive) or `DriverClass`.
+     *
+     * **When set, there is no failover.** If the named provider is missing, inactive,
+     * unavailable or incapable of what was asked, the call fails with a specific result code.
+     * A silent substitution is how you discover in production that a "semantic research"
+     * search has been served by a keyword engine for a month.
+     */
+    Provider?: string;
+    /** Restrict results to these domains, where the provider supports it. */
+    IncludeDomains?: string[];
+    /** Exclude these domains, where the provider supports it. */
+    ExcludeDomains?: string[];
+    /** Restrict by recency. */
+    Freshness?: WebSearchFreshness;
+    /** Two-letter country code for localisation, e.g. `US`, `GB`. */
+    Country?: string;
+    /** Language code for results, e.g. `en`. */
+    Language?: string;
+    /** Adult-content filter. Default `moderate`. */
+    SafeSearch?: WebSearchSafeSearch;
+    /**
+     * Ask for a synthesized answer as well as hits.
+     *
+     * Restricts selection to providers whose {@link WebSearchCapabilities.Answer} is true — so
+     * it changes *which* provider serves the request, not just what comes back.
+     */
+    IncludeAnswer?: boolean;
+}
+/** Outcome codes. `SUCCESS` is the only one where {@link WebSearchResult.Success} is true. */
+export type WebSearchResultCode = 'SUCCESS'
+/** `Query` was missing or blank. */
+ | 'MISSING_QUERY'
+/** No web search providers exist in metadata at all — a setup problem, not a search failure. */
+ | 'NO_PROVIDERS_CONFIGURED'
+/**
+ * The provider list could not be READ — the view query failed, the entity is absent from
+ * metadata, or the caller lacks permission. Deliberately distinct from
+ * `NO_PROVIDERS_CONFIGURED`: that one tells an operator to add a record, which is the wrong
+ * instruction (and an actively misleading one) when the read itself never succeeded.
+ */
+ | 'PROVIDER_LOAD_FAILED'
+/** Providers exist, but none is Active, available and capable of this request. */
+ | 'NO_ELIGIBLE_PROVIDER'
+/** An explicit `Provider` was named and no such provider exists in metadata. */
+ | 'PROVIDER_NOT_FOUND'
+/** The named provider exists but its `Status` is not `Active`. */
+ | 'PROVIDER_NOT_ACTIVE'
+/** The named provider is Active but not operational — usually a missing credential. */
+ | 'PROVIDER_UNAVAILABLE'
+/** The named provider cannot do what was asked, e.g. `IncludeAnswer` on a hits-only provider. */
+ | 'PROVIDER_LACKS_CAPABILITY'
+/** Every eligible provider was tried and each failed. See `Attempts`. */
+ | 'ALL_PROVIDERS_FAILED'
+/** The request itself was rejected and retrying elsewhere cannot help. */
+ | 'INVALID_REQUEST';
+/**
+ * Why a provider call failed, which decides whether the engine tries the next provider.
+ *
+ * - `transient` — rate limit, 5xx, timeout, network. Another provider may well succeed.
+ * - `permanent` — the *request* is the problem (query too long, malformed parameters). Every
+ *   other provider will reject it too, so the engine stops rather than burning paid calls on
+ *   a request that cannot succeed and burying the real error behind N identical failures.
+ */
+export type WebSearchFailureKind = 'transient' | 'permanent';
+/** One provider's turn, recorded whether it succeeded or not. */
+export interface WebSearchAttempt {
+    /** The provider's `Name` from metadata. */
+    ProviderName: string;
+    /** The provider's `DriverClass`. */
+    DriverClass: string;
+    Succeeded: boolean;
+    /** Wall-clock duration of the provider call. */
+    DurationMs: number;
+    /** How many hits it returned. Zero is a legitimate answer, not a failure. */
+    HitCount?: number;
+    FailureKind?: WebSearchFailureKind;
+    ErrorMessage?: string;
+}
+/** The result of {@link WebSearchEngine.Search}. */
+export interface WebSearchResult {
+    Success: boolean;
+    ResultCode: WebSearchResultCode;
+    /** Normalised hits. Empty on failure, and legitimately empty on a narrow query. */
+    Hits: WebSearchHit[];
+    /** Synthesized answer, only when `IncludeAnswer` was requested and the provider produced one. */
+    Answer?: string;
+    /** `Name` of the provider that actually served the result. Always set when `Success`. */
+    ProviderUsed?: string;
+    /**
+     * Every provider tried, in order.
+     *
+     * **Populated on the success path too**, deliberately. If the primary provider rate-limits
+     * every call and the secondary quietly serves everything, the system looks healthy while
+     * the bill moves to a vendor nobody chose. This is what makes that visible.
+     */
+    Attempts: WebSearchAttempt[];
+    ErrorMessage?: string;
+}
+/** Configuration handed to a driver during {@link BaseWebSearchProvider.Initialize}. */
+export interface WebSearchProviderConfig {
+    /** The provider's `Name` from its metadata record. */
+    Name: string;
+    /** Parsed `ProviderConfig` JSON, or null when the column was empty or unparseable. */
+    ProviderConfig: Record<string, unknown> | null;
+    /** Decrypted credential values, when the record carried a `CredentialID`. */
+    CredentialValues: Record<string, unknown> | null;
+    /** Per-provider result cap from metadata, or null to use the driver's own cap. */
+    MaxResultsOverride: number | null;
+    /** Ordering value from metadata; lower is higher priority. */
+    Priority: number;
+}
+/** What a driver returns from {@link BaseWebSearchProvider.ExecuteSearch}. */
+export interface WebSearchProviderResponse {
+    Success: boolean;
+    Hits: WebSearchHit[];
+    Answer?: string;
+    /** Required when `Success` is false — decides failover. */
+    FailureKind?: WebSearchFailureKind;
+    ErrorMessage?: string;
+}
+/** Catalog entry for a registered driver, for admin UI population. */
+export interface RegisteredWebSearchProviderInfo {
+    /** ClassFactory registration key — the `WebSearchProvider.DriverClass` column value. */
+    DriverClass: string;
+    Capabilities: WebSearchCapabilities;
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Public types for the MemberJunction web search engine.
+ *
+ * Web search is deliberately a **separate concern** from `@memberjunction/search-engine`.
+ * That engine searches content MJ owns — entity records, vectors, full-text indexes, storage
+ * files — and its `SearchResultItem` requires `EntityName` and `RecordID`, the primary key of a
+ * source record. A web result has a URL and none of those. Fitting one in would mean lying in
+ * the type and dragging the hit through enrichment built to decorate entity records.
+ *
+ * What the two DO share is the plugin *pattern*: a provider table carrying `DriverClass`,
+ * `Priority`, `Status` and `CredentialID`; ClassFactory resolution; and the
+ * `Initialize()` → `CheckAvailability()` → `IsAvailable()` lifecycle.
+ *
+ * @module @memberjunction/web-search-engine
+ */
+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;;;;;;;;;;;;;;GAcG"}

package/package.json

@@ -1,10 +1,33 @@
 {
   "name": "@memberjunction/web-search-engine",
-  "version": "0.0.1-seed.2",
-  "description": "Trusted-publishing seed. Proves OIDC is configured; contains no code.",
-  "license": "ISC",
+  "type": "module",
+  "version": "6.2.0-edge.0",
+  "description": "MemberJunction: Metadata-driven web search engine — pluggable external search providers with priority failover",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "author": "MemberJunction.com",
+  "license": "BUSL-1.1",
+  "dependencies": {
+    "@memberjunction/core": "6.2.0-edge.0",
+    "@memberjunction/core-entities": "6.2.0-edge.0",
+    "@memberjunction/credentials": "6.2.0-edge.0",
+    "@memberjunction/global": "6.2.0-edge.0",
+    "@memberjunction/network-utils": "6.2.0-edge.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "typescript": "^5.9.3"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/MemberJunction/MJ.git"
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}