@cliwant/mcp-sam-gov 1.0.0 → 1.2.0

package/dist/census-economic.js

@@ -0,0 +1,355 @@
+/**
+ * US Census — County Business Patterns (CBP) — the MARKET-SIZING lane
+ * (ADR-0047, Wave-4 source #1). NAICS × geography establishments / employment /
+ * annual payroll — the demand-side complement to BLS-QCEW + USAspending in the
+ * B2G market-sizing set.
+ *
+ * ★ THIS IS THE SERVER'S FIRST KEY-REQUIRED SOURCE. The Census Data API removed
+ *   its keyless tier — a request WITHOUT a key is 302-redirected to a "Missing
+ *   Key" HTML page. So, honestly: with NO `CENSUS_API_KEY` this tool THROWS an
+ *   `invalid_input` config error BEFORE any fetch (never a fake-empty, never a
+ *   keyless-pretend). The other 111 tools stay keyless — this key is scoped to
+ *   this one source. (Contrast the OPTIONAL keys of datagov/bls/nvd, which lift a
+ *   tier but are not required.)
+ *
+ * DIFFERENT HOST than census.ts (the geocoder, geocoding.geo.census.gov): the
+ * DATA API is `api.census.gov/data/{year}/cbp`. This module COPIES (does NOT
+ * import) the census.ts fixed-host SSRF idiom (a single host const + a
+ * post-construction `new URL().hostname` assertion + `redirect:"error"`) and does
+ * NOT touch census_geocode.
+ *
+ * Coercion/meta code is REUSED (`driftError`, `errorFromResponse`, `num`
+ * coerce.ts null-never-0, `withMeta`/`buildMeta`). The ONE bespoke bit is the
+ * fetch: a single `fetch(redirect:"manual")` (NOT the shared getJson) so a
+ * missing/invalid-key 302 surfaces as an INSPECTABLE opaque-redirect → honest
+ * invalid_input, instead of undici's redirect:"error" TypeError that
+ * fetchWithRetry would mask as a retryable outage (see the fetch block). The
+ * optional-key leak discipline is MIRRORED from datagovKey.ts/bls.ts — but here
+ * the key is REQUIRED and rides ONLY in the `&key=` query param, NOWHERE else
+ * (never the label, `_meta.source`, notes, or a log — the K-test).
+ *
+ *   GET https://api.census.gov/data/{year}/cbp
+ *       ?get=NAME,NAICS2017_LABEL,ESTAB,EMP,PAYANN,GEO_ID
+ *       &for=<geoClause>            (us:* | state:* | state:NN | county:*)
+ *       &in=state:NN                (county queries only)
+ *       &NAICS2017=<naics>          (optional NAICS filter)
+ *       &key=<CENSUS_API_KEY>       (REQUIRED)
+ *   → a 2D JSON ARRAY: row 0 = column headers, rows 1..N = data. e.g.
+ *     [["NAME","ESTAB","EMP","PAYANN","NAICS2017","NAICS2017_LABEL","state"],
+ *      ["California","39755","...","...","5415","...","06"], ...]
+ *
+ * ★ HONESTY (ADR-0047 P1–P5):
+ *   [KEY]  no key ⇒ invalid_input THROW pre-fetch (0 fetch); the message names
+ *          CENSUS_API_KEY + the free-signup URL. A wire 302 (a key that IS set but is
+ *          invalid → the Missing-Key page) is caught via redirect:"manual" as an
+ *          opaque-redirect ⇒ invalid_input "check CENSUS_API_KEY" (never a
+ *          fake-empty, never a masked outage).
+ *   [P1]   CBP returns the COMPLETE geography set for the filter (no server
+ *          pagination) ⇒ totalAvailable = the row count, complete:true. NEVER
+ *          fabricated (RED if totalAvailable = header-length or invented).
+ *   [P3]   ★the sentinel→null crux: Census suppresses/withholds cells with large
+ *          NEGATIVE sentinels (-999999999 / -888888888 / -666666666 …). `censusNum`
+ *          maps any value ≤ -100000000 to **null** (withheld) — NEVER a negative
+ *          number, NEVER 0. A genuine 0 stays 0. `annualPayrollUsd = PAYANN×1000`
+ *          (PAYANN is in $1,000 units), null-preserving.
+ *   [P2]   a 302 ⇒ invalid_input (key); a header-only body ⇒ honest empty
+ *          (returned:0, complete:true); a 5xx ⇒ upstream_unavailable THROW; a 200
+ *          non-JSON ⇒ schema_drift.
+ *   [P4]   a body that is not an array, or whose row 0 is not a string[] header
+ *          row ⇒ driftError (never a fabricated empty).
+ *   [SSRF] fixed host; `year` re-guarded ^\d{4}$ (it rides in the PATH); `naics`
+ *          ^\d{2,6}$; `state` ^\d{2}$; geography enum {us,state,county}. All
+ *          predicate VALUES ride in URLSearchParams. The key rides `&key=` ONLY.
+ */
+import { ToolErrorCarrier, errorFromResponse } from "./errors.js";
+import { 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. NO local
+// num/str.
+export { num };
+// ─── SSRF core: the single fixed host (DIFFERENT from census.ts) ──
+const CENSUS_DATA_HOST = "api.census.gov";
+const CENSUS_DATA_LABEL = "census:/data/cbp"; // host-only ToolError surface; NO token, NO key
+// ─── Validation charclasses (SSRF + "verify the input" honesty) ───
+const YEAR_RE = /^\d{4}$/; // rides in the PATH — strict 4-digit (no path injection)
+const NAICS_RE = /^\d{2,6}$/; // 2–6 digit NAICS-2017 sector/code
+const STATE_FIPS_RE = /^\d{2}$/; // 2-digit state FIPS
+const GEOGRAPHIES = new Set(["us", "state", "county"]);
+// The Census suppression/withhold sentinel floor. Census encodes a suppressed or
+// unavailable cell as a large NEGATIVE value (-999999999 / -888888888 /
+// -666666666 …). Establishment/employment/payroll counts are non-negative, so any
+// value at/below this floor is a sentinel, NOT data.
+const CENSUS_SENTINEL_FLOOR = -100000000;
+const DEFAULT_YEAR = "2022"; // the latest confirmed CBP vintage (ADR-0047)
+// ─── Honesty notes (ADR-0047 required set) ────────────────────────
+const KEY_REQUIRED_NOTE = "This source REQUIRES a free CENSUS_API_KEY (the Census Data API has no keyless tier). The key is sent ONLY as the &key= query parameter to api.census.gov and is NEVER logged, echoed, or placed in this response.";
+const PAYROLL_UNITS_NOTE = "annualPayrollUsd is ANNUAL payroll in US dollars, converted from the Census PAYANN field's $1,000 units (×1000). establishments and employees are integer counts (as-of the reference year).";
+const SUPPRESSED_NOTE = "Census suppresses cells for confidentiality/reliability using large negative sentinels (e.g. -999999999); such values are mapped to null (withheld) — NEVER a negative number and NEVER 0. A genuine 0 is preserved as 0.";
+const NO_PAGINATION_NOTE = "CBP returns the COMPLETE set of geographies matching the filter (no server-side pagination); totalAvailable equals the number of rows returned. Narrow with naics / geography to reduce the row count.";
+// ─── The key seam (REQUIRED; value NEVER leaked past the &key= param) ──
+/** Read CENSUS_API_KEY from env; trim; return the value or undefined (unset/blank). */
+export function censusApiKey() {
+    const raw = process.env.CENSUS_API_KEY;
+    const trimmed = typeof raw === "string" ? raw.trim() : "";
+    return trimmed ? trimmed : undefined;
+}
+/** num(), but map the Census negative suppression sentinel family → null (withheld). */
+function censusNum(v) {
+    const n = num(v);
+    if (n === null)
+        return null;
+    // A large-negative sentinel is a WITHHELD/suppressed cell, never data. A genuine
+    // 0 (n > floor) passes through as 0.
+    if (n <= CENSUS_SENTINEL_FLOOR)
+        return null;
+    return n;
+}
+/** Annual payroll: PAYANN is in $1,000 units → ×1000; null-preserving. */
+function mul1000(n) {
+    return n === null ? null : n * 1000;
+}
+/**
+ * Fetch County Business Patterns rows for a NAICS × geography filter → normalized
+ * establishment / employment / annual-payroll rows + honest `_meta`. REQUIRES
+ * CENSUS_API_KEY (throws invalid_input pre-fetch when unset). The 2D-array body is
+ * parsed by HEADER NAME (order-independent); suppressed cells map to null.
+ */
+export async function businessPatterns(args) {
+    // ── [KEY] REQUIRED key — throw an honest config error BEFORE any fetch. ──
+    const key = censusApiKey();
+    if (key === undefined) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: "Census Data API requires a free key. Get one at https://api.census.gov/data/key_signup.html and set CENSUS_API_KEY.",
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    // ── Validate + default the inputs (belt-and-suspenders behind the server Zod;
+    //    a DIRECT handler call bypasses Zod). ──
+    const year = args.year ?? DEFAULT_YEAR;
+    if (!YEAR_RE.test(year)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid year ${JSON.stringify(year)} — expected a 4-digit year (^\\d{4}$), e.g. "2022". (year rides in the request PATH; it is strictly validated.)`,
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    const geography = args.geography ?? "us";
+    if (!GEOGRAPHIES.has(geography)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid geography ${JSON.stringify(geography)} — expected one of us, state, county.`,
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    if (args.state !== undefined && !STATE_FIPS_RE.test(args.state)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid state ${JSON.stringify(args.state)} — expected a 2-digit state FIPS code (^\\d{2}$), e.g. "06" (California).`,
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    if (args.naics !== undefined && !NAICS_RE.test(args.naics)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Invalid naics ${JSON.stringify(args.naics)} — expected a 2–6 digit NAICS-2017 code (^\\d{2,6}$), e.g. "5415" (Computer Systems Design).`,
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    // ── Resolve the geography clause (for=… [+ in=state:…]). ──
+    let forClause;
+    let inClause;
+    let geoFilter;
+    if (geography === "us") {
+        forClause = "us:*";
+        geoFilter = "geography:us";
+    }
+    else if (geography === "state") {
+        forClause = args.state !== undefined ? `state:${args.state}` : "state:*";
+        geoFilter = `geography:state:${args.state ?? "*"}`;
+    }
+    else {
+        // county — requires a state (the CBP `in=state:` predicate is mandatory).
+        if (args.state === undefined) {
+            throw new ToolErrorCarrier({
+                kind: "invalid_input",
+                retryable: false,
+                message: "geography 'county' requires `state` (a 2-digit FIPS) — CBP county queries need an `in=state:NN` predicate. Pass state, e.g. state:'06'.",
+                upstreamEndpoint: CENSUS_DATA_LABEL,
+            });
+        }
+        forClause = "county:*";
+        inClause = `state:${args.state}`;
+        geoFilter = `geography:county:* in state:${args.state}`;
+    }
+    // ── Build the query (all VALUES via URLSearchParams — no host/path steer; the
+    //    REQUIRED key rides ONLY here in &key=). ──
+    const params = new URLSearchParams();
+    params.set("get", "NAME,NAICS2017_LABEL,ESTAB,EMP,PAYANN,GEO_ID");
+    params.set("for", forClause);
+    if (inClause !== undefined)
+        params.set("in", inClause);
+    if (args.naics !== undefined)
+        params.set("NAICS2017", args.naics);
+    params.set("key", key);
+    const url = `https://${CENSUS_DATA_HOST}/data/${year}/cbp?${params.toString()}`;
+    // Belt-and-suspenders: the fixed host + strictly-validated path leave nothing to
+    // steer the authority; assert the built URL cannot have been moved off-host.
+    const built = new URL(url);
+    if (built.hostname !== CENSUS_DATA_HOST || built.protocol !== "https:") {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: `Constructed Census Data URL host ${JSON.stringify(built.hostname)} (${built.protocol}) is not ${CENSUS_DATA_HOST} over https — refusing to fetch (SSRF safety).`,
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    // ── Fetch with redirect:"manual" — the KEY-ERROR DETECTION crux. A missing or
+    //    invalid key makes the Census Data API 302-redirect to its "Missing Key" page
+    //    (live-verified: `HTTP 302` + `Location: /data/missing_key.html` +
+    //    `X-DataWebAPI-KeyError: 1`). We must NOT use redirect:"error" via getJson
+    //    here: undici rejects an "error"-mode redirect with a TypeError that the
+    //    shared fetchWithRetry catch reclassifies to a *retryable upstream_unavailable*
+    //    — masking a key-config error as a transient outage. redirect:"manual" instead
+    //    yields an INSPECTABLE opaque-redirect (type "opaqueredirect", status 0), so
+    //    the missing/invalid key surfaces as an honest invalid_input. This is a
+    //    SINGLE classified attempt (no auto-retry): a transient 5xx THROWS
+    //    upstream_unavailable — re-invoke the tool to retry. The 5xx/404/400 taxonomy
+    //    is delegated to the shared errors.ts `errorFromResponse`; a 200 non-JSON body
+    //    ⇒ r.json() SyntaxError ⇒ schema_drift. The redirect is NEVER followed, so no
+    //    off-host hop can occur (a stronger SSRF posture than redirect:"error"). ──
+    let res;
+    try {
+        res = await fetch(built.toString(), {
+            redirect: "manual",
+            signal: AbortSignal.timeout(15_000),
+        });
+    }
+    catch (e) {
+        // Timeout/abort ⇒ non-retryable (the same aborted signal would re-reject);
+        // a genuine network TypeError ⇒ retryable upstream_unavailable. NEVER empty.
+        if (e instanceof Error &&
+            (e.name === "TimeoutError" || e.name === "AbortError")) {
+            throw new ToolErrorCarrier({
+                kind: "upstream_unavailable",
+                message: `Request to ${CENSUS_DATA_LABEL} timed out.`,
+                retryable: false,
+                upstreamEndpoint: CENSUS_DATA_LABEL,
+            });
+        }
+        throw new ToolErrorCarrier({
+            kind: "upstream_unavailable",
+            message: `Network error reaching ${CENSUS_DATA_LABEL}: ${e instanceof Error ? e.message : String(e)}`,
+            retryable: true,
+            retryAfterSeconds: 30,
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    // [KEY] A redirect (opaque-redirect via redirect:"manual", or a raw 3xx status) ⇒
+    // the missing/invalid-key "Missing Key" page ⇒ an honest key-config error, NEVER
+    // a fake-empty (swallowing this as empty ⇒ RED in the fault suite).
+    if (res.type === "opaqueredirect" || (res.status >= 300 && res.status < 400)) {
+        throw new ToolErrorCarrier({
+            kind: "invalid_input",
+            retryable: false,
+            message: "Census Data API redirected the request to its 'Missing Key' page — CENSUS_API_KEY is missing or invalid. Get or check a free key at https://api.census.gov/data/key_signup.html.",
+            upstreamEndpoint: CENSUS_DATA_LABEL,
+        });
+    }
+    // [P2] 404/429/5xx/4xx ⇒ the shared errors.ts taxonomy (a DOWN service is NEVER
+    // an empty result; 400 → invalid_input, 5xx → upstream_unavailable, …).
+    if (!res.ok) {
+        throw new ToolErrorCarrier(errorFromResponse(res, CENSUS_DATA_LABEL));
+    }
+    // [P4] 200 ⇒ parse JSON; a non-JSON body (an HTML error page at 200) makes
+    // r.json() throw a SyntaxError ⇒ schema_drift (never read as an empty result).
+    let body;
+    try {
+        body = await res.json();
+    }
+    catch (e) {
+        if (e instanceof SyntaxError) {
+            throw driftError(CENSUS_DATA_LABEL, "Census CBP returned a non-JSON body at HTTP 200 (likely an HTML 'Missing Key' / error page) — treating as schema drift (never read as an empty result).");
+        }
+        throw e;
+    }
+    // ── [P4] Parse the 2D array: row 0 = string[] header, rows 1..N = data. ──
+    if (!Array.isArray(body) || body.length === 0) {
+        throw driftError(CENSUS_DATA_LABEL, "Census CBP returned a body that is not a non-empty 2D array — treating as schema drift (never a fabricated empty).");
+    }
+    const header = body[0];
+    if (!Array.isArray(header) ||
+        header.length === 0 ||
+        !header.every((h) => typeof h === "string")) {
+        throw driftError(CENSUS_DATA_LABEL, "Census CBP row 0 is not a string[] header row — treating as schema drift (the 2D-array contract changed; never a fabricated empty).");
+    }
+    // Header-name → column index (order-independent; a missing column ⇒ index -1 ⇒
+    // the field maps to null, never a positional mis-read).
+    const idx = new Map();
+    header.forEach((h, i) => idx.set(h, i));
+    const col = (row, name) => {
+        const i = idx.get(name);
+        return i === undefined || i < 0 ? undefined : row[i];
+    };
+    const allRows = [];
+    for (let i = 1; i < body.length; i++) {
+        const raw = body[i];
+        if (!Array.isArray(raw)) {
+            throw driftError(CENSUS_DATA_LABEL, `Census CBP data row ${i} is not an array — treating as schema drift (never a fabricated empty).`);
+        }
+        const row = raw;
+        allRows.push({
+            name: str(col(row, "NAME")),
+            geoId: str(col(row, "GEO_ID")),
+            naicsCode: str(col(row, "NAICS2017")),
+            naicsLabel: str(col(row, "NAICS2017_LABEL")),
+            establishments: censusNum(col(row, "ESTAB")),
+            employees: censusNum(col(row, "EMP")),
+            annualPayrollUsd: mul1000(censusNum(col(row, "PAYANN"))),
+            state: str(col(row, "state")),
+        });
+    }
+    // ── [P1] The COMPLETE set for the filter (no server pagination). An OPTIONAL
+    //    client-side top-N slice is disclosed (totalAvailable stays the full count,
+    //    so buildMeta derives truncated/complete honestly). ──
+    const totalAvailable = allRows.length;
+    const notes = [
+        KEY_REQUIRED_NOTE,
+        PAYROLL_UNITS_NOTE,
+        SUPPRESSED_NOTE,
+        NO_PAGINATION_NOTE,
+    ];
+    let rows = allRows;
+    if (typeof args.limit === "number" &&
+        Number.isFinite(args.limit) &&
+        args.limit >= 0 &&
+        args.limit < allRows.length) {
+        rows = allRows.slice(0, args.limit);
+        notes.push(`Returned the first ${rows.length} of ${totalAvailable} rows (client-side limit=${args.limit}); CBP has NO server-side pagination, so the remaining ${totalAvailable - rows.length} are not fetched separately — raise limit or narrow the filter to see them.`);
+    }
+    const filtersApplied = [
+        args.naics !== undefined ? `naics:${args.naics}` : "naics:(all)",
+        geoFilter,
+        `year:${year}`,
+    ];
+    const meta = {
+        // MODE only — never the key value (K-test).
+        source: `api.census.gov /data/${year}/cbp (County Business Patterns; CENSUS_API_KEY)`,
+        keylessMode: false, // ★KEYED — the first key-required source
+        returned: rows.length,
+        totalAvailable,
+        filtersApplied,
+        filtersDropped: [],
+        fieldsUnavailable: [],
+        notes,
+    };
+    return withMeta({ rows }, meta);
+}
+//# sourceMappingURL=census-economic.js.map

package/dist/census-economic.js.map

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

package/dist/fred.d.ts

@@ -0,0 +1,108 @@
+/**
+ * fred.ts — FRED (Federal Reserve Economic Data, St. Louis Fed) — the MACRO
+ * CONTEXT lane (ADR-0048, Wave-4 source #2). GDP · CPI · interest rates ·
+ * unemployment · PPI … — the economy-wide backdrop for B2G bid escalation and
+ * market-timing that no contract/spending source carries.
+ *
+ * ★ THIS IS THE SERVER'S SECOND KEY-REQUIRED SOURCE (Census CBP was the first).
+ *   FRED has NO keyless tier: every request needs `&api_key=`, and a missing/bad
+ *   key returns HTTP 400 `{error_code, error_message}`. So, honestly: with NO
+ *   `FRED_API_KEY` these two tools THROW an `invalid_input` config error BEFORE any
+ *   fetch (never a fake-empty, never a keyless-pretend). The other 112 tools stay
+ *   keyless — this key is scoped to this one source. (Contrast the OPTIONAL keys of
+ *   datagov/bls/nvd, which lift a tier but are not required.)
+ *
+ * This module MIRRORS the census-economic.ts optional-key precedent: a `fredApiKey()`
+ * env seam, a pre-fetch `invalid_input` THROW when unset, the fixed-host SSRF assert
+ * + `redirect:"error"`, and the missing-sentinel→null idiom (Census's negative
+ * suppression sentinel there; FRED's `value === "."` here — the BLS `"-"` lineage).
+ * It writes ZERO coercion/meta code of its own: it REUSES `getJson` (the shared
+ * fetch envelope) / `driftError` / `num`·`str` (coerce.ts, null-never-0/empty) /
+ * `withMeta`·`buildMeta` (offset pagination via count-exact totals).
+ *
+ *   GET https://api.stlouisfed.org/fred/series/search
+ *       ?search_text=<q>&limit=&offset=&api_key=<KEY>&file_type=json
+ *   → { seriess:[{ id,title,frequency,frequency_short,units,seasonal_adjustment,
+ *        observation_start,observation_end,last_updated,popularity,notes }],
+ *       count, limit, offset }
+ *
+ *   GET https://api.stlouisfed.org/fred/series/observations
+ *       ?series_id=<id>&observation_start=&observation_end=&limit=&offset=
+ *        &sort_order=&api_key=<KEY>&file_type=json
+ *   → { observations:[{ date, value }], count, … }   ★value === "." ⇒ missing (null)
+ *
+ * ★ HONESTY (ADR-0048 P1–P5):
+ *   [KEY]  no key ⇒ invalid_input THROW pre-fetch (0 fetch); the message names
+ *          FRED_API_KEY + the free-signup URL. A 400 carrying `{error_message}` (a
+ *          bad series_id / expired key) ⇒ reclassified to invalid_input CARRYING the
+ *          FRED error_message — honestly reported, never a fake empty.
+ *   [P1]   both endpoints report `count` (the total) ⇒ totalAvailable = num(count)
+ *          EXACT; offset pagination (hasMore = offset+returned < count, nextOffset).
+ *          NEVER fabricated (RED if totalAvailable = returned).
+ *   [P3]   ★the missing crux: an observation `value === "."` ⇒ **null** (FRED's
+ *          missing sentinel — the BLS `"-"` lineage), NEVER 0. A genuine "0" ⇒ 0.
+ *   [P2]   a 400 ⇒ invalid_input (carrying error_message); a genuine no-match
+ *          (seriess:[] / observations:[]) ⇒ honest empty; a 5xx ⇒ upstream_unavailable
+ *          THROW; a 200 non-JSON ⇒ schema_drift.
+ *   [P4]   a body whose `seriess` / `observations` is absent or non-array ⇒ driftError
+ *          (never a fabricated empty).
+ *   [SSRF] fixed host `api.stlouisfed.org`; `series_id` charclass `^[A-Za-z0-9._-]+$`;
+ *          dates `^\d{4}-\d{2}-\d{2}$`; sort_order enum {asc,desc}. All VALUES ride
+ *          URLSearchParams; the key rides `&api_key=` ONLY — never a label/_meta/note
+ *          (the K-test).
+ */
+import { num } from "./coerce.js";
+import { type MetaBundle } from "./meta.js";
+export { num };
+export declare const FRED_HOST = "api.stlouisfed.org";
+/** Read FRED_API_KEY from env; trim; return the value or undefined (unset/blank). */
+export declare function fredApiKey(): string | undefined;
+/**
+ * num(), but map FRED's missing-observation sentinel `"."` → null (missing). A
+ * genuine "0" stays 0 (num("0") === 0); a real numeric string parses. This is the
+ * BLS `"-"` lineage — a data-absence marker, never a fabricated 0.
+ */
+export declare function fredValue(v: unknown): number | null;
+export type FredSearchSeriesArgs = {
+    query?: string;
+    limit?: number;
+    offset?: number;
+};
+export type FredSeries = {
+    id: string | null;
+    title: string | null;
+    frequency: string | null;
+    frequencyShort: string | null;
+    units: string | null;
+    seasonalAdjustment: string | null;
+    observationStart: string | null;
+    observationEnd: string | null;
+    lastUpdated: string | null;
+    popularity: number | null;
+};
+/**
+ * Search FRED series (`/fred/series/search`) by `search_text` → curated series
+ * rows + honest `_meta`. REQUIRES FRED_API_KEY (throws invalid_input pre-fetch when
+ * unset). totalAvailable = FRED's exact `count`; offset pagination.
+ */
+export declare function searchSeries(args: FredSearchSeriesArgs): Promise<MetaBundle>;
+export type FredSeriesObservationsArgs = {
+    seriesId?: string;
+    startDate?: string;
+    endDate?: string;
+    limit?: number;
+    offset?: number;
+    sortOrder?: string;
+};
+export type FredObservation = {
+    date: string | null;
+    value: number | null;
+};
+/**
+ * Fetch a FRED series' time series (`/fred/series/observations`) → date/value rows
+ * + honest `_meta`. REQUIRES FRED_API_KEY (throws invalid_input pre-fetch when
+ * unset). ★A missing observation (`value === "."`) maps to null, never 0.
+ * totalAvailable = FRED's exact `count`; offset pagination.
+ */
+export declare function seriesObservations(args: FredSeriesObservationsArgs): Promise<MetaBundle>;
+//# sourceMappingURL=fred.d.ts.map

package/dist/fred.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fred.d.ts","sourceRoot":"","sources":["../src/fred.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAIH,OAAO,EAAE,GAAG,EAAO,MAAM,aAAa,CAAC;AACvC,OAAO,EAAY,KAAK,UAAU,EAAqB,MAAM,WAAW,CAAC;AAKzE,OAAO,EAAE,GAAG,EAAE,CAAC;AAGf,eAAO,MAAM,SAAS,uBAAuB,CAAC;AA2B9C,qFAAqF;AACrF,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAI/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGnD;AAgFD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CA4FrB;AAGD,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CAsHrB"}