@cliwant/mcp-sam-gov 1.2.0 → 1.4.0

package/dist/nonprofit.js

@@ -0,0 +1,342 @@
+/**
+ * nonprofit.ts — US TAX-EXEMPT NONPROFITS (IRS Form 990) — the nonprofit /
+ * grantee / subcontractor vetting lane (ADR-0060). Who a tax-exempt organization
+ * IS (EIN, NTEE code, subsection, ruling date, status) and what its Form 990
+ * FINANCIALS look like (revenue, expenses, assets, liabilities by tax year) —
+ * the 501(c) signal no contract/spending/grant/lobbying source carries.
+ *
+ * ★ PROVENANCE — THIS IS NOT A .gov API (must be disclosed). The DATA is IRS Form
+ *   990 filings — FEDERAL tax-exempt PUBLIC RECORDS — but the API is **ProPublica
+ *   Nonprofit Explorer**, operated by **ProPublica** (a non-profit newsroom) which
+ *   republishes those records KEYLESS. The IRS itself offers NO clean query API
+ *   (only bulk downloads / a web UI). So every response's `_meta.source` AND a note
+ *   name "IRS Form 990 data via ProPublica Nonprofit Explorer" — the tool NEVER
+ *   presents itself as a government API.
+ *
+ * ★ KEYLESS — no key of any kind. Anonymous GETs return HTTP 200. There is NO
+ *   KEY_REGISTRY / keys.ts / API_KEYS.md entry for this source.
+ *
+ * The module writes ZERO fetch/coercion/error/meta code of its own: it REUSES
+ * `getJson` (the shared fetch envelope, redirect:"error") / `driftError` /
+ * `num`·`str` (coerce.ts, null-never-0/empty) / `withMeta`·`buildMeta`.
+ *
+ *   SEARCH  GET https://projects.propublica.org/nonprofits/api/v2/search.json
+ *       ?q=&state[id]=&ntee[id]=&page=
+ *     → { total_results, organizations:[{ ein, name, sub_name, city, state,
+ *          ntee_code, subseccd, score }], num_pages, cur_page, per_page,
+ *          page_offset }
+ *   DETAIL  GET https://projects.propublica.org/nonprofits/api/v2/organizations/{ein}.json
+ *     → { organization:{ ein, name, address, city, state, zipcode, ntee_code,
+ *          subsection_code, ruling_date, exempt_organization_status_code,
+ *          foundation_code }, filings_with_data:[{ tax_prd_yr, formtype, pdf_url,
+ *          totrevenue, totfuncexpns, totassetsend, totliabend }] }
+ *
+ * ★ HONESTY (ADR-0060 P1–P5):
+ *   [P1]   SEARCH totalAvailable = `total_results` (the API's REAL total for the
+ *          query) — NEVER organizations.length. Page pagination (page is 0-based):
+ *          hasMore = (cur_page+1) < num_pages; the next page number is surfaced in
+ *          a note. DETAIL totalAvailable = filings.length (the COMPLETE filing set
+ *          from the one detail doc — no pagination). Reverting the search total to
+ *          organizations.length must go RED.
+ *   [P2]   SEARCH a genuine no-match (organizations:[]) ⇒ honest empty (returned:0,
+ *          complete:true). DETAIL an unknown EIN (HTTP 404) ⇒ not_found (NEVER a
+ *          fabricated empty org). A 4xx ⇒ invalid_input; a 5xx/timeout ⇒
+ *          upstream_unavailable THROW; a 200 non-JSON ⇒ schema_drift.
+ *   [P3]   The four Form 990 figures (totrevenue/totfuncexpns/totassetsend/
+ *          totliabend) ride `num()` — a genuine 0 STAYS 0, an absent figure ⇒ null
+ *          (NEVER 0-faked). EIN + the codes are strings; ruling_date is a string.
+ *   [P4]   SEARCH `organizations` non-array OR `total_results` non-number ⇒
+ *          driftError. DETAIL `organization` non-object OR `filings_with_data`
+ *          non-array ⇒ driftError (never a fabricated empty/total).
+ *   [SSRF] fixed host `projects.propublica.org`; a post-construction hostname/
+ *          protocol assert + `redirect:"error"`; the query VALUES ride
+ *          URLSearchParams (incl. the `state[id]`/`ntee[id]` bracket keys);
+ *          `ein` charclass `^\d{1,9}$` (path segment); `state` `^[A-Za-z]{2}$`;
+ *          `ntee` an integer 1..10.
+ */
+import { ToolErrorCarrier } from "./errors.js";
+import { getJson, driftError } from "./datasource.js";
+import { num, str } from "./coerce.js";
+import { withMeta } from "./meta.js";
+// Re-export the shared honesty coercion (single audited copy in ./coerce.js —
+// ADR-0005 v2 FIX-C) so a `num` regression fails together across sources.
+export { num };
+// ─── SSRF core: the single fixed host + base path ─────────────────
+export const NONPROFIT_HOST = "projects.propublica.org";
+const NONPROFIT_BASE = "/nonprofits/api/v2";
+// HOST+path labels — surface in ToolError.upstreamEndpoint. No token exists for
+// this keyless source, so no secret can ever appear here.
+const NONPROFIT_SEARCH_LABEL = "propublica-nonprofit:/nonprofits/api/v2/search";
+const NONPROFIT_ORG_LABEL = "propublica-nonprofit:/nonprofits/api/v2/organizations";
+// ─── Validation (SSRF + "verify the input" honesty) ───────────────
+const STATE_RE = /^[A-Za-z]{2}$/; // a 2-letter US state/territory code
+const EIN_RE = /^\d{1,9}$/; // a numeric EIN (1..9 digits), rides the PATH
+// ★ProPublica's not-found SENTINEL (live-verified, NOT in the ADR): an EIN with no
+// matching IRS record does NOT always 404 — an in-range unknown EIN (e.g. 999999999)
+// returns HTTP 200 carrying a SYNTHETIC placeholder org `{ name:"Unknown Organization",
+// …all-null }` with ZERO filings_with_data. Surfacing that verbatim would present a
+// FABRICATED empty org as a real hit (a P2 honesty violation). We detect the exact
+// sentinel name + empty structured filings and map it to not_found, EXACTLY like a 404.
+const PROPUBLICA_NOT_FOUND_NAME = "Unknown Organization";
+const NTEE_MIN = 1;
+const NTEE_MAX = 10; // the NTEE major-category filter, 1..10
+const DEFAULT_PAGE = 0; // the API's page is 0-BASED
+const FALLBACK_PER_PAGE = 25; // the API's fixed page size (~25); a defensive fallback
+// ─── Honesty notes (ADR-0060 required set) ────────────────────────
+const PROVENANCE_NOTE = "Data = IRS Form 990 filings (federal tax-exempt public records), served by ProPublica Nonprofit Explorer (ProPublica, a non-profit newsroom, which republishes them keyless) — NOT a .gov API. The IRS itself has no clean query API (only bulk downloads / a web UI). Treat figures as of ProPublica's last IRS ingest.";
+const SEARCH_TOTAL_NOTE = "totalAvailable is the API's real total_results — the total match count for the query (NOT the organizations on this page). Pagination is page-based and 0-INDEXED (pass page=cur_page+1 for the next page while hasMore).";
+const FINANCIALS_TOTAL_NOTE = "totalAvailable is filings.length — the COMPLETE set of Form 990 filings-with-data carried by this organization's detail document (there is no pagination; this is the whole set, not a page).";
+const FINANCIALS_MONEY_NOTE = "revenueUsd / expensesUsd / assetsUsd / liabilitiesUsd are parsed from the Form 990 totrevenue / totfuncexpns / totassetsend / totliabend. A genuine reported 0 is preserved as 0; an absent figure maps to null — NEVER 0.";
+/** Map ONE search `organizations[]` row → the curated summary shape. */
+function mapOrgSummary(raw) {
+    const o = (raw ?? {});
+    return {
+        // EIN + codes are IDENTIFIERS ⇒ strings (never num-coerced).
+        ein: str(o.ein),
+        name: str(o.name),
+        city: str(o.city),
+        state: str(o.state),
+        nteeCode: str(o.ntee_code),
+        subsectionCode: str(o.subseccd),
+    };
+}
+/** Map the detail `organization` object → the curated organization shape. */
+function mapOrganization(raw) {
+    const o = (raw ?? {});
+    return {
+        ein: str(o.ein),
+        name: str(o.name),
+        address: str(o.address),
+        city: str(o.city),
+        state: str(o.state),
+        zip: str(o.zipcode),
+        nteeCode: str(o.ntee_code),
+        subsectionCode: str(o.subsection_code),
+        rulingDate: str(o.ruling_date),
+        statusCode: str(o.exempt_organization_status_code),
+    };
+}
+/** Map ONE `filings_with_data[]` row → the curated filing shape (money via num). */
+function mapFiling(raw) {
+    const f = (raw ?? {});
+    return {
+        taxYear: num(f.tax_prd_yr),
+        formType: str(f.formtype),
+        // [P3] a genuine 0 STAYS 0; absent ⇒ null (NEVER 0-faked).
+        revenueUsd: num(f.totrevenue),
+        expensesUsd: num(f.totfuncexpns),
+        assetsUsd: num(f.totassetsend),
+        liabilitiesUsd: num(f.totliabend),
+        pdfUrl: str(f.pdf_url),
+    };
+}
+/**
+ * Search US tax-exempt nonprofits (IRS Form 990) via ProPublica Nonprofit Explorer
+ * (`/nonprofits/api/v2/search.json`) → curated org summaries + honest `_meta`.
+ * KEYLESS. ★PROVENANCE: this is ProPublica (a non-profit newsroom) republishing
+ * IRS Form 990 public records — NOT a .gov API. ★totalAvailable is the API's REAL
+ * `total_results` — never organizations.length; page-based (0-indexed) pagination.
+ */
+export async function search(args) {
+    const label = NONPROFIT_SEARCH_LABEL;
+    // ── Validate + default (belt-and-suspenders behind the server Zod; a DIRECT
+    //    handler call bypasses Zod). state/ntee/page are charclass/range-guarded;
+    //    the free-text query rides URLSearchParams (encoded). ──
+    if (args.state !== undefined && !STATE_RE.test(args.state)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid state ${JSON.stringify(args.state)} — expected a 2-letter US state/territory code (^[A-Za-z]{2}$), e.g. "VA".`,
+            upstreamEndpoint: label,
+        });
+    }
+    if (args.ntee !== undefined &&
+        (!Number.isInteger(args.ntee) || args.ntee < NTEE_MIN || args.ntee > NTEE_MAX)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid ntee ${JSON.stringify(args.ntee)} — expected an integer NTEE major category 1..10.`,
+            upstreamEndpoint: label,
+        });
+    }
+    const page = clampPage(args.page);
+    // ── Build the query from VALIDATED typed args, key-by-key (SSRF: no raw
+    //    passthrough; every VALUE is URLSearchParams-encoded, incl. the bracket keys
+    //    `state[id]`/`ntee[id]`). ──
+    const params = new URLSearchParams();
+    const filtersApplied = [];
+    if (args.query !== undefined && args.query !== "") {
+        params.set("q", args.query);
+        filtersApplied.push("query");
+    }
+    if (args.state !== undefined) {
+        params.set("state[id]", args.state.toUpperCase());
+        filtersApplied.push("state");
+    }
+    if (args.ntee !== undefined) {
+        params.set("ntee[id]", String(args.ntee));
+        filtersApplied.push("ntee");
+    }
+    params.set("page", String(page));
+    const url = `https://${NONPROFIT_HOST}${NONPROFIT_BASE}/search.json?${params.toString()}`;
+    assertOnHost(url, label);
+    // ── Fetch through the shared envelope. redirect:"error" fails closed on any
+    //    off-host 3xx. A 4xx ⇒ invalid_input; a 5xx/timeout ⇒ upstream_unavailable
+    //    THROW; a 429 ⇒ rate_limited THROW; a 200 non-JSON ⇒ getJson's r.json()
+    //    throws a SyntaxError ⇒ schema_drift. ──
+    let body;
+    try {
+        body = await getJson(url, { label, redirect: "error" });
+    }
+    catch (e) {
+        if (e instanceof SyntaxError) {
+            throw driftError(label, "ProPublica Nonprofit search returned a non-JSON body at HTTP 200 — schema drift (never read as an empty result).");
+        }
+        throw e; // 5xx → upstream_unavailable, 4xx → invalid_input, 429 → rate_limited …
+    }
+    // ── [P4] `organizations` MUST be an array and `total_results` MUST be a number
+    //    (a missing/wrong-typed either is drift, never a fabricated empty/total). ──
+    const b = (body ?? {});
+    if (!Array.isArray(b.organizations)) {
+        throw driftError(label, "ProPublica Nonprofit search shape drift — `organizations` must be an array.");
+    }
+    if (typeof b.total_results !== "number" || !Number.isFinite(b.total_results)) {
+        throw driftError(label, "ProPublica Nonprofit search shape drift — `total_results` (the total match count) must be a number.");
+    }
+    const organizations = b.organizations.map(mapOrgSummary);
+    const returned = organizations.length;
+    // ── [P1] totalAvailable is the API's REAL total_results, NEVER organizations.length.
+    //    Page-based + 0-INDEXED: hasMore = (cur_page+1) < num_pages; surface the next
+    //    page. cur_page/num_pages/per_page/page_offset via num() (defensive fallbacks). ──
+    const totalAvailable = b.total_results;
+    const curPage = num(b.cur_page) ?? page;
+    const numPages = num(b.num_pages);
+    const perPage = num(b.per_page) ?? (returned > 0 ? returned : FALLBACK_PER_PAGE);
+    const hasMore = numPages !== null ? curPage + 1 < numPages : false;
+    const offset = num(b.page_offset) ?? curPage * perPage;
+    const nextOffset = hasMore ? (curPage + 1) * perPage : null;
+    const notes = [PROVENANCE_NOTE, SEARCH_TOTAL_NOTE];
+    if (hasMore && numPages !== null) {
+        notes.push(`This is page ${curPage} (0-indexed) of ${numPages} — pass page=${curPage + 1} for the next page.`);
+    }
+    return withMeta({ organizations }, {
+        source: `${NONPROFIT_HOST} /nonprofits/api/v2/search (IRS Form 990 data via ProPublica Nonprofit Explorer — not a .gov API; keyless)`,
+        keylessMode: true,
+        returned,
+        totalAvailable,
+        filtersApplied,
+        filtersDropped: [],
+        fieldsUnavailable: [],
+        pagination: { offset, limit: perPage, hasMore, nextOffset },
+        notes,
+    });
+}
+/**
+ * Fetch ONE nonprofit's IRS Form 990 profile + financials via ProPublica Nonprofit
+ * Explorer (`/nonprofits/api/v2/organizations/{ein}.json`) → curated organization +
+ * filings + honest `_meta`. KEYLESS. ★PROVENANCE: ProPublica (a non-profit newsroom)
+ * republishing IRS Form 990 public records — NOT a .gov API. An unknown EIN (HTTP
+ * 404) ⇒ not_found (never a fabricated empty org). The four Form 990 figures ride
+ * num() (null-never-0). totalAvailable = filings.length (the COMPLETE set).
+ */
+export async function financials(args) {
+    const label = NONPROFIT_ORG_LABEL;
+    // ── Validate (belt-and-suspenders behind the server Zod). ein is charclass-
+    //    guarded PRE-fetch — it rides the URL PATH, so it MUST be digits-only. ──
+    if (typeof args.ein !== "string" || !EIN_RE.test(args.ein)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid ein ${JSON.stringify(args.ein)} — expected a numeric EIN of 1..9 digits (^\\d{1,9}$), e.g. "530196605".`,
+            upstreamEndpoint: label,
+        });
+    }
+    // ein is digits-only (EIN_RE) ⇒ safe as a path segment; no separators can steer
+    // the authority. Build + re-assert the host (SSRF belt-and-suspenders).
+    const url = `https://${NONPROFIT_HOST}${NONPROFIT_BASE}/organizations/${args.ein}.json`;
+    assertOnHost(url, label);
+    // ── Fetch through the shared envelope. A 404 (unknown EIN) ⇒ not_found (the
+    //    shared taxonomy — never a fabricated empty org); a 4xx ⇒ invalid_input; a
+    //    5xx/timeout ⇒ upstream_unavailable THROW; a 200 non-JSON ⇒ schema_drift. ──
+    let body;
+    try {
+        body = await getJson(url, { label, redirect: "error" });
+    }
+    catch (e) {
+        if (e instanceof SyntaxError) {
+            throw driftError(label, "ProPublica Nonprofit organization detail returned a non-JSON body at HTTP 200 — schema drift (never read as an empty result).");
+        }
+        throw e; // 404 → not_found, 5xx → upstream_unavailable, 4xx → invalid_input …
+    }
+    // ── [P4] `organization` MUST be an object and `filings_with_data` MUST be an
+    //    array (a missing/wrong-typed either is drift, never a fabricated empty). ──
+    const b = (body ?? {});
+    if (b.organization === null ||
+        typeof b.organization !== "object" ||
+        Array.isArray(b.organization)) {
+        throw driftError(label, "ProPublica Nonprofit organization detail shape drift — `organization` must be an object.");
+    }
+    if (!Array.isArray(b.filings_with_data)) {
+        throw driftError(label, "ProPublica Nonprofit organization detail shape drift — `filings_with_data` must be an array.");
+    }
+    const organization = mapOrganization(b.organization);
+    const filings = b.filings_with_data.map(mapFiling);
+    const returned = filings.length;
+    // ── [P2] ★not-found SENTINEL: ProPublica returns HTTP 200 + a synthetic
+    //    `{ name:"Unknown Organization", …all-null }` placeholder (zero
+    //    filings_with_data) for an in-range EIN with no IRS record. That is a
+    //    FABRICATED empty org — surface it as not_found (identical to a 404), NEVER
+    //    as a real hit. Gated on BOTH the exact sentinel name AND empty structured
+    //    filings, so a real org (which would carry its true name / filings) is safe. ──
+    if (organization.name === PROPUBLICA_NOT_FOUND_NAME && returned === 0) {
+        throw new ToolErrorCarrier({
+            kind: "not_found",
+            retryable: false,
+            message: `No IRS Form 990 record for EIN ${args.ein} — ProPublica returned its "${PROPUBLICA_NOT_FOUND_NAME}" placeholder (no matching tax-exempt organization). Verify the EIN.`,
+            upstreamEndpoint: label,
+        });
+    }
+    // ── [P1] totalAvailable = filings.length — the COMPLETE filing set from the one
+    //    detail document (no pagination). ──
+    const notes = [
+        PROVENANCE_NOTE,
+        FINANCIALS_TOTAL_NOTE,
+        FINANCIALS_MONEY_NOTE,
+    ];
+    return withMeta({ organization, filings }, {
+        source: `${NONPROFIT_HOST} /nonprofits/api/v2/organizations (IRS Form 990 data via ProPublica Nonprofit Explorer — not a .gov API; keyless)`,
+        keylessMode: true,
+        returned,
+        totalAvailable: returned,
+        filtersApplied: [],
+        filtersDropped: [],
+        fieldsUnavailable: [],
+        // The complete set is in one document — no pagination, hasMore:false.
+        pagination: { offset: 0, limit: returned, hasMore: false, nextOffset: null },
+        notes,
+    });
+}
+// ─── SSRF host assert (shared by both tools) ──────────────────────
+/**
+ * Belt-and-suspenders: the fixed host + strictly-built URL leave nothing to steer
+ * the authority; assert the built URL cannot have been moved off-host / downgraded.
+ */
+function assertOnHost(url, label) {
+    const built = new URL(url);
+    if (built.hostname !== NONPROFIT_HOST || built.protocol !== "https:") {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Constructed ProPublica Nonprofit URL host ${JSON.stringify(built.hostname)} (${built.protocol}) is not ${NONPROFIT_HOST} over https — refusing to fetch (SSRF safety).`,
+            upstreamEndpoint: label,
+        });
+    }
+}
+// ─── Small clamp (defensive, behind the server Zod bounds) ─────────
+function clampPage(v) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        return DEFAULT_PAGE;
+    const n = Math.floor(v);
+    return n < 0 ? 0 : n;
+}
+//# sourceMappingURL=nonprofit.js.map

package/dist/nonprofit.js.map

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

package/dist/openfda-device.d.ts

@@ -0,0 +1,85 @@
+/**
+ * openfda-device.ts — openFDA 510(k) DEVICE CLEARANCES (api.fda.gov) — the
+ * MEDICAL-DEVICE REGULATORY lane (ADR-0056). The FDA's premarket-notification
+ * (510(k)) clearances: the applicant, the device, the clearance number (K-number),
+ * the decision (date + description), the clearance type, the product code, the
+ * advisory committee, and geography.
+ *
+ * ★ THIS IS THE SAME SOURCE + ENVELOPE + CRUX as openfda.ts (ADR-0054). Same host
+ *   (api.fda.gov), same response envelope `{ meta:{ results:{ skip, limit, total }},
+ *   results:[…] }`, same ★no-match→HTTP-404-NOT_FOUND-as-honest-empty crux, same
+ *   optional query-key K-test, same fixed-host SSRF idiom, same structured-only
+ *   (no raw Lucene passthrough) search assembly. It REUSES openfda.ts's `fetchOpenfda`
+ *   (the SSRF-guarded classified fetch) and `readOpenfdaError` (the error-body reader)
+ *   verbatim — the 404-reclassification logic is NOT reinvented — plus `luceneQuote`
+ *   (the phrase-escape), `openfdaApiKey` (the optional-key env seam), and `OPENFDA_HOST`.
+ *
+ *   GET https://api.fda.gov/device/510k.json
+ *       ?search=<lucene>&limit=<1..100>&skip=<offset>[&api_key=<KEY>]
+ *   → { meta:{ disclaimer, results:{ skip, limit, total }}, results:[ {…} ] }
+ *     (live total ~175507).
+ *
+ * ★ HONESTY (mirrors openfda.ts exactly):
+ *   [P1]  totalAvailable = `meta.results.total` EXACT (e.g. 175507), NEVER
+ *         results.length. skip/limit offset pagination:
+ *         hasMore = skip + returned < total; nextOffset = hasMore ? skip+returned : null.
+ *   [★P2] a 404 whose body is `{error:{code:"NOT_FOUND"}}` (a no-match query OR an
+ *         unknown field) ⇒ HONEST EMPTY (returned:0, totalAvailable:0) — NOT thrown,
+ *         NOT not_found. Any OTHER 4xx (e.g. a 400 syntax error) ⇒ invalid_input
+ *         surfacing openFDA's message. 5xx/timeout ⇒ upstream_unavailable THROW. A
+ *         200 non-JSON body ⇒ schema_drift. (Reuses openfda.ts's exact fetch path.)
+ *   [P3]  dates (`decision_date`, YYYY-MM-DD) and every scalar surfaced as a STRING
+ *         via `str` (null-never-empty-string) — no numeric coercion; never fabricated.
+ *   [P4]  `meta.results` or `results` absent / non-array ⇒ driftError (never a
+ *         fabricated empty).
+ *   [K-test] OPTIONAL OPENFDA_API_KEY: when set it rides `&api_key=` ONLY (openFDA has
+ *         no header option — the query-key is inherent). Mitigation: the `label` is
+ *         host+path ONLY (`openfda:/device/510k`, NO query), so no token reaches
+ *         ToolError.upstreamEndpoint; `_meta.source` names the MODE only; the key is
+ *         ABSENT from the serialized {data,_meta}, notes, and any log. Unset ⇒ keyless.
+ *   [SSRF] fixed host `api.fda.gov` (fetchOpenfda asserts hostname/protocol +
+ *         redirect:"error"); all filter VALUES are Lucene-escaped + phrase-quoted and
+ *         ride URLSearchParams `search=`; limit/skip are integers; state is charclass
+ *         `^[A-Za-z]{2}$`. No raw Lucene passthrough — structured only, injection-safe.
+ */
+import { type MetaBundle } from "./meta.js";
+export type OpenfdaClearance = {
+    applicant: string | null;
+    deviceName: string | null;
+    kNumber: string | null;
+    decisionDate: string | null;
+    decisionDescription: string | null;
+    clearanceType: string | null;
+    productCode: string | null;
+    advisoryCommittee: string | null;
+    state: string | null;
+};
+/** The structured filter set → openFDA `field:value` clauses (510(k) fields). */
+export type OpenfdaDeviceFilters = {
+    applicant?: string;
+    deviceName?: string;
+    productCode?: string;
+    clearanceType?: string;
+    kNumber?: string;
+    state?: string;
+};
+/**
+ * Assemble the openFDA `search=` Lucene string from structured 510(k) filters — each
+ * value Lucene-escaped + phrase-quoted (reusing openfda.ts's `luceneQuote`), joined by
+ * ` AND `. Returns "" when no filter is present (openFDA then returns the whole
+ * collection). The clause → field mapping is FIXED here; a caller can never inject a
+ * raw field:value (no raw Lucene passthrough).
+ */
+export declare function buildDeviceSearch(f: OpenfdaDeviceFilters): string;
+export type OpenfdaDeviceClearancesArgs = OpenfdaDeviceFilters & {
+    limit?: number;
+    skip?: number;
+};
+/**
+ * Search openFDA 510(k) DEVICE CLEARANCES with structured filters → curated clearance
+ * rows + honest `_meta`. KEYLESS (an OPTIONAL OPENFDA_API_KEY only raises the rate
+ * limit). totalAvailable = meta.results.total (EXACT); skip/limit offset pagination.
+ * ★A no-match query (openFDA HTTP 404 NOT_FOUND) ⇒ an honest empty, never a throw.
+ */
+export declare function deviceClearances(args: OpenfdaDeviceClearancesArgs): Promise<MetaBundle>;
+//# sourceMappingURL=openfda-device.d.ts.map

package/dist/openfda-device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openfda-device.d.ts","sourceRoot":"","sources":["../src/openfda-device.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAKH,OAAO,EAAY,KAAK,UAAU,EAAqB,MAAM,WAAW,CAAC;AA6BzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAmBF,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAejE;AAGD,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,GAAG;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,UAAU,CAAC,CAyJrB"}