us-gov-open-data-mcp 1.0.0

package/dist/sdk/federal-register.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Federal Register SDK — typed API client for the Federal Register.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchExecutiveOrders, searchPresidentialDocuments } from "us-gov-open-data/sdk/federal-register";
+ *
+ * No API key required — completely open.
+ * Docs: https://www.federalregister.gov/developers/documentation/api/v1
+ */
+export interface FRDocument {
+    title: string;
+    type: string;
+    subtype?: string;
+    abstract?: string;
+    document_number: string;
+    html_url: string;
+    publication_date: string;
+    signing_date?: string;
+    executive_order_number?: number;
+    presidential_document_type_id?: string;
+    president?: {
+        name: string;
+        identifier: string;
+    };
+    agencies?: {
+        name?: string;
+        raw_name?: string;
+        id?: number;
+    }[];
+    pdf_url?: string;
+    citation?: string;
+}
+export interface FRSearchResult {
+    count: number;
+    total_pages: number;
+    results: FRDocument[];
+}
+/** Search for presidential executive orders. Filter by president, year, or keyword. */
+export declare function searchExecutiveOrders(opts?: {
+    keyword?: string;
+    president?: string;
+    year?: number;
+    per_page?: number;
+    page?: number;
+}): Promise<FRSearchResult>;
+/** Search all presidential documents: executive orders, memoranda, proclamations, etc. */
+export declare function searchPresidentialDocuments(opts?: {
+    keyword?: string;
+    doc_type?: string;
+    president?: string;
+    start_date?: string;
+    end_date?: string;
+    per_page?: number;
+}): Promise<FRSearchResult>;
+/** Search for proposed rules, final rules, and agency notices. */
+export declare function searchRules(opts?: {
+    keyword?: string;
+    doc_type?: string;
+    agency?: string;
+    start_date?: string;
+    end_date?: string;
+    per_page?: number;
+    significant?: boolean;
+}): Promise<FRSearchResult>;
+/**
+ * Get details for a specific Federal Register document by document number.
+ *
+ * Example:
+ *   const doc = await getDocumentDetail('2024-00001');
+ */
+export declare function getDocumentDetail(documentNumber: string): Promise<FRDocument>;
+/**
+ * List all Federal Register agencies with metadata.
+ * Returns agency names, short names, URLs, parent agencies, etc.
+ */
+export declare function listAgencies(): Promise<Array<{
+    name: string;
+    short_name?: string;
+    slug: string;
+    url: string;
+    parent_id?: number;
+    id: number;
+    [key: string]: unknown;
+}>>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=federal-register.d.ts.map

package/dist/sdk/federal-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federal-register.d.ts","sourceRoot":"","sources":["../../src/sdk/federal-register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAID,uFAAuF;AACvF,wBAAsB,qBAAqB,CAAC,IAAI,GAAE;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACV,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB/B;AAED,0FAA0F;AAC1F,wBAAsB,2BAA2B,CAAC,IAAI,GAAE;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,cAAc,CAAC,CAe/B;AAED,kEAAkE;AAClE,wBAAsB,WAAW,CAAC,IAAI,GAAE;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,cAAc,CAAC,CAe/B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAEnF;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,CAAC,CAE7K;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/sdk/federal-register.js

@@ -0,0 +1,100 @@
+/**
+ * Federal Register SDK — typed API client for the Federal Register.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchExecutiveOrders, searchPresidentialDocuments } from "us-gov-open-data/sdk/federal-register";
+ *
+ * No API key required — completely open.
+ * Docs: https://www.federalregister.gov/developers/documentation/api/v1
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://www.federalregister.gov/api/v1",
+    name: "federal-register",
+    cacheTtlMs: 30 * 60 * 1000, // 30 min — documents don't change often
+});
+// ─── Public API ──────────────────────────────────────────────────────
+/** Search for presidential executive orders. Filter by president, year, or keyword. */
+export async function searchExecutiveOrders(opts = {}) {
+    const params = {
+        "conditions[type][]": "PRESDOCU",
+        "conditions[presidential_document_type][]": "executive_order",
+        "conditions[correction]": "0",
+        per_page: opts.per_page ?? 20,
+        page: opts.page ?? 1,
+        order: "newest",
+    };
+    if (opts.keyword)
+        params["conditions[term]"] = opts.keyword;
+    if (opts.president)
+        params["conditions[president][]"] = opts.president;
+    if (opts.year) {
+        params["conditions[publication_date][gte]"] = `${opts.year}-01-01`;
+        params["conditions[publication_date][lte]"] = `${opts.year}-12-31`;
+    }
+    return api.get("/documents.json", params);
+}
+/** Search all presidential documents: executive orders, memoranda, proclamations, etc. */
+export async function searchPresidentialDocuments(opts = {}) {
+    const params = {
+        "conditions[type][]": "PRESDOCU",
+        "conditions[correction]": "0",
+        per_page: opts.per_page ?? 20,
+        order: "newest",
+    };
+    if (opts.doc_type)
+        params["conditions[presidential_document_type][]"] = opts.doc_type;
+    if (opts.keyword)
+        params["conditions[term]"] = opts.keyword;
+    if (opts.president)
+        params["conditions[president][]"] = opts.president;
+    if (opts.start_date)
+        params["conditions[publication_date][gte]"] = opts.start_date;
+    if (opts.end_date)
+        params["conditions[publication_date][lte]"] = opts.end_date;
+    return api.get("/documents.json", params);
+}
+/** Search for proposed rules, final rules, and agency notices. */
+export async function searchRules(opts = {}) {
+    const params = {
+        "conditions[correction]": "0",
+        per_page: opts.per_page ?? 20,
+        order: "newest",
+    };
+    if (opts.doc_type)
+        params["conditions[type][]"] = opts.doc_type;
+    if (opts.keyword)
+        params["conditions[term]"] = opts.keyword;
+    if (opts.agency)
+        params["conditions[agencies][]"] = opts.agency;
+    if (opts.start_date)
+        params["conditions[publication_date][gte]"] = opts.start_date;
+    if (opts.end_date)
+        params["conditions[publication_date][lte]"] = opts.end_date;
+    if (opts.significant)
+        params["conditions[significant]"] = "1";
+    return api.get("/documents.json", params);
+}
+/**
+ * Get details for a specific Federal Register document by document number.
+ *
+ * Example:
+ *   const doc = await getDocumentDetail('2024-00001');
+ */
+export async function getDocumentDetail(documentNumber) {
+    return api.get(`/documents/${documentNumber}.json`);
+}
+/**
+ * List all Federal Register agencies with metadata.
+ * Returns agency names, short names, URLs, parent agencies, etc.
+ */
+export async function listAgencies() {
+    return api.get("/agencies");
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=federal-register.js.map

package/dist/sdk/federal-register.js.map

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

package/dist/sdk/fema.d.ts

@@ -0,0 +1,137 @@
+/**
+ * FEMA OpenFEMA SDK — typed API client for disaster declarations, grants, and assistance data.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getDisasterDeclarations, getHousingAssistance } from "us-gov-open-data/sdk/fema";
+ *
+ * No API key required.
+ * Docs: https://www.fema.gov/about/openfema/api
+ */
+export interface DisasterDeclaration {
+    disasterNumber?: number;
+    declarationDate?: string;
+    disasterName?: string;
+    incidentType?: string;
+    declarationType?: string;
+    state?: string;
+    fipsStateCode?: string;
+    fipsCountyCode?: string;
+    designatedArea?: string;
+    ihProgramDeclared?: boolean;
+    iaProgramDeclared?: boolean;
+    paProgramDeclared?: boolean;
+    hmProgramDeclared?: boolean;
+    incidentBeginDate?: string;
+    incidentEndDate?: string;
+    lastRefresh?: string;
+    [key: string]: unknown;
+}
+export interface HousingAssistanceRecord {
+    disasterNumber?: number;
+    state?: string;
+    county?: string;
+    zipCode?: string;
+    validRegistrations?: number;
+    totalInspected?: number;
+    totalDamage?: number;
+    totalApprovedIhpAmount?: number;
+    repairReplaceAmount?: number;
+    rentalAmount?: number;
+    otherNeedsAmount?: number;
+    approvedForFemaAssistance?: number;
+    [key: string]: unknown;
+}
+export interface PublicAssistanceRecord {
+    disasterNumber?: number;
+    state?: string;
+    applicantName?: string;
+    county?: string;
+    damageCategory?: string;
+    projectAmount?: number;
+    federalShareObligated?: number;
+    obligatedDate?: string;
+    projectTitle?: string;
+    [key: string]: unknown;
+}
+export interface NfipClaim {
+    state?: string;
+    countyCode?: string;
+    dateOfLoss?: string;
+    amountPaidOnBuildingClaim?: number;
+    amountPaidOnContentsClaim?: number;
+    totalBuildingInsuranceCoverage?: number;
+    floodZone?: string;
+    yearOfLoss?: number;
+    [key: string]: unknown;
+}
+export interface FemaRegion {
+    regionNumber?: number;
+    regionName?: string;
+    regionAddress?: string;
+    states?: string;
+    [key: string]: unknown;
+}
+export interface FemaListResponse<T> {
+    metadata?: {
+        count?: number;
+        skip?: number;
+        top?: number;
+        entityName?: string;
+    };
+    [key: string]: unknown;
+}
+export declare const DATASETS: Record<string, {
+    endpoint: string;
+    name: string;
+    description: string;
+}>;
+/**
+ * Search for disaster declarations. Supports OData-style filtering.
+ */
+export declare function getDisasterDeclarations(opts?: {
+    state?: string;
+    year?: number;
+    incidentType?: string;
+    declarationType?: string;
+    top?: number;
+    skip?: number;
+    orderBy?: string;
+}): Promise<DisasterDeclaration[]>;
+/**
+ * Get housing assistance data for homeowners by disaster/state/county.
+ */
+export declare function getHousingAssistance(opts?: {
+    disasterNumber?: number;
+    state?: string;
+    county?: string;
+    top?: number;
+    skip?: number;
+}): Promise<HousingAssistanceRecord[]>;
+/**
+ * Get Public Assistance grant award activities.
+ */
+export declare function getPublicAssistance(opts?: {
+    disasterNumber?: number;
+    state?: string;
+    top?: number;
+    skip?: number;
+}): Promise<PublicAssistanceRecord[]>;
+/**
+ * Get FEMA regions.
+ */
+export declare function getFemaRegions(): Promise<FemaRegion[]>;
+/**
+ * General-purpose query against any OpenFEMA v2 dataset.
+ */
+export declare function queryDataset(opts: {
+    dataset: string;
+    filter?: string;
+    select?: string;
+    orderBy?: string;
+    top?: number;
+    skip?: number;
+}): Promise<unknown[]>;
+/** Clear the FEMA SDK cache. */
+export declare function clearCache(): void;
+//# sourceMappingURL=fema.d.ts.map

package/dist/sdk/fema.d.ts.map

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

package/dist/sdk/fema.js

@@ -0,0 +1,197 @@
+/**
+ * FEMA OpenFEMA SDK — typed API client for disaster declarations, grants, and assistance data.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getDisasterDeclarations, getHousingAssistance } from "us-gov-open-data/sdk/fema";
+ *
+ * No API key required.
+ * Docs: https://www.fema.gov/about/openfema/api
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://www.fema.gov/api/open/v2",
+    name: "fema",
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour — disaster data updates periodically
+});
+// ─── Datasets ────────────────────────────────────────────────────────
+export const DATASETS = {
+    disaster_declarations: {
+        endpoint: "DisasterDeclarationsSummaries",
+        name: "Disaster Declarations",
+        description: "All federally declared disasters since 1953: major disasters, emergencies, fire management",
+    },
+    housing_owners: {
+        endpoint: "HousingAssistanceOwners",
+        name: "Housing Assistance (Owners)",
+        description: "Individual Assistance for homeowners: inspections, damage severity, assistance amounts by county/zip",
+    },
+    housing_renters: {
+        endpoint: "HousingAssistanceRenters",
+        name: "Housing Assistance (Renters)",
+        description: "Individual Assistance for renters: inspections, damage severity, assistance amounts by county/zip",
+    },
+    public_assistance: {
+        endpoint: "PublicAssistanceGrantAwardActivities",
+        name: "Public Assistance Awards",
+        description: "PA project awards: applicant, county, damage category, federal share obligated",
+    },
+    public_assistance_details: {
+        endpoint: "PublicAssistanceFundedProjectsDetails",
+        name: "PA Funded Projects",
+        description: "Detailed public assistance funded projects with damage categories and amounts",
+    },
+    nfip_claims: {
+        endpoint: "FimaNfipClaims",
+        name: "NFIP Flood Insurance Claims",
+        description: "National Flood Insurance Program claims: loss amounts, flood zones, damage details",
+    },
+    nfip_policies: {
+        endpoint: "FimaNfipPolicies",
+        name: "NFIP Flood Insurance Policies",
+        description: "National Flood Insurance Program policy transactions: coverage, premiums, locations",
+    },
+    hazard_mitigation: {
+        endpoint: "HazardMitigationGrantProgramDisasterSummaries",
+        name: "Hazard Mitigation Grants",
+        description: "HMGP disaster-level financial summaries: obligations, project counts",
+    },
+    mission_assignments: {
+        endpoint: "MissionAssignments",
+        name: "Mission Assignments",
+        description: "Work orders from FEMA to other federal agencies for disaster response (FY2013+)",
+    },
+    fema_regions: {
+        endpoint: "FemaRegions",
+        name: "FEMA Regions",
+        description: "FEMA region boundaries, headquarters, and associated states",
+    },
+    registrations: {
+        endpoint: "RegistrationIntakeIndividualsHouseholdPrograms",
+        name: "IHP Registrations",
+        description: "Registration and IHP data by city: call center, web, mobile registrations, eligible amounts",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function extractArray(res, endpoint) {
+    if (typeof res === "object" && res !== null) {
+        const obj = res;
+        // OpenFEMA returns data in a key matching the endpoint name
+        if (Array.isArray(obj[endpoint]))
+            return obj[endpoint];
+        // Fallback search
+        for (const key of Object.keys(obj)) {
+            if (Array.isArray(obj[key]) && key !== "metadata")
+                return obj[key];
+        }
+    }
+    if (Array.isArray(res))
+        return res;
+    return [];
+}
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Search for disaster declarations. Supports OData-style filtering.
+ */
+export async function getDisasterDeclarations(opts) {
+    const params = {
+        $format: "json",
+        $top: String(opts?.top ?? 50),
+        $orderby: opts?.orderBy ?? "declarationDate desc",
+    };
+    if (opts?.skip)
+        params.$skip = String(opts.skip);
+    const filters = [];
+    if (opts?.state)
+        filters.push(`state eq '${opts.state.toUpperCase()}'`);
+    if (opts?.year) {
+        filters.push(`declarationDate ge '${opts.year}-01-01T00:00:00.000z'`);
+        filters.push(`declarationDate le '${opts.year}-12-31T23:59:59.999z'`);
+    }
+    if (opts?.incidentType)
+        filters.push(`incidentType eq '${opts.incidentType}'`);
+    if (opts?.declarationType)
+        filters.push(`declarationType eq '${opts.declarationType}'`);
+    if (filters.length)
+        params.$filter = filters.join(" and ");
+    const res = await api.get("/DisasterDeclarationsSummaries", params);
+    return extractArray(res, "DisasterDeclarationsSummaries");
+}
+/**
+ * Get housing assistance data for homeowners by disaster/state/county.
+ */
+export async function getHousingAssistance(opts) {
+    const params = {
+        $format: "json",
+        $top: String(opts?.top ?? 50),
+        $orderby: "totalApprovedIhpAmount desc",
+    };
+    if (opts?.skip)
+        params.$skip = String(opts.skip);
+    const filters = [];
+    if (opts?.disasterNumber)
+        filters.push(`disasterNumber eq '${opts.disasterNumber}'`);
+    if (opts?.state)
+        filters.push(`state eq '${opts.state.toUpperCase()}'`);
+    if (opts?.county)
+        filters.push(`county eq '${opts.county}'`);
+    if (filters.length)
+        params.$filter = filters.join(" and ");
+    const res = await api.get("/HousingAssistanceOwners", params);
+    return extractArray(res, "HousingAssistanceOwners");
+}
+/**
+ * Get Public Assistance grant award activities.
+ */
+export async function getPublicAssistance(opts) {
+    const params = {
+        $format: "json",
+        $top: String(opts?.top ?? 50),
+        $orderby: "obligatedDate desc",
+    };
+    if (opts?.skip)
+        params.$skip = String(opts.skip);
+    const filters = [];
+    if (opts?.disasterNumber)
+        filters.push(`disasterNumber eq '${opts.disasterNumber}'`);
+    if (opts?.state)
+        filters.push(`state eq '${opts.state.toUpperCase()}'`);
+    if (filters.length)
+        params.$filter = filters.join(" and ");
+    const res = await api.get("/PublicAssistanceGrantAwardActivities", params);
+    return extractArray(res, "PublicAssistanceGrantAwardActivities");
+}
+/**
+ * Get FEMA regions.
+ */
+export async function getFemaRegions() {
+    const res = await api.get("/FemaRegions", { $format: "json" });
+    return extractArray(res, "FemaRegions");
+}
+/**
+ * General-purpose query against any OpenFEMA v2 dataset.
+ */
+export async function queryDataset(opts) {
+    const endpoint = DATASETS[opts.dataset]?.endpoint ?? opts.dataset;
+    const params = {
+        $format: "json",
+        $top: String(opts.top ?? 50),
+    };
+    if (opts.filter)
+        params.$filter = opts.filter;
+    if (opts.select)
+        params.$select = opts.select;
+    if (opts.orderBy)
+        params.$orderby = opts.orderBy;
+    if (opts.skip)
+        params.$skip = String(opts.skip);
+    const res = await api.get(`/${endpoint}`, params);
+    return extractArray(res, endpoint);
+}
+/** Clear the FEMA SDK cache. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=fema.js.map

package/dist/sdk/fema.js.map

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

package/dist/sdk/fred.d.ts

@@ -0,0 +1,72 @@
+/**
+ * FRED SDK — typed API client for FRED (Federal Reserve Economic Data).
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getObservations, searchSeries } from "us-gov-open-data/sdk/fred";
+ *
+ *   const gdp = await getObservations("GDP", { start: "2024-01-01" });
+ *   console.log(gdp.observations);
+ *
+ * Requires FRED_API_KEY env var. Get one at https://fredaccount.stlouisfed.org/apikeys
+ */
+export interface FredSeries {
+    id: string;
+    title: string;
+    frequency: string;
+    units: string;
+    seasonal_adjustment: string;
+    last_updated: string;
+    popularity: number;
+    notes: string;
+    observation_start: string;
+    observation_end: string;
+}
+export interface FredSearchResult {
+    count: number;
+    seriess: FredSeries[];
+}
+export interface FredObservation {
+    date: string;
+    value: string;
+}
+export interface FredObservations {
+    count: number;
+    observation_start: string;
+    observation_end: string;
+    observations: FredObservation[];
+}
+export interface FredReleaseSeries {
+    series_id: string;
+    title: string;
+    frequency: string;
+    units: string;
+    seasonal_adjustment: string;
+    observations: FredObservation[];
+}
+export interface FredReleaseResult {
+    has_more: boolean;
+    next_cursor?: string;
+    release: {
+        release_id: number;
+        name: string;
+    };
+    series: FredReleaseSeries[];
+}
+/** Search FRED series by keyword. */
+export declare function searchSeries(query: string, limit?: number): Promise<FredSearchResult>;
+/** Get metadata for a single series. */
+export declare function getSeriesInfo(seriesId: string): Promise<FredSeries | null>;
+/** Get observation values for a series. */
+export declare function getObservations(seriesId: string, opts?: {
+    start?: string;
+    end?: string;
+    limit?: number;
+    sort?: "asc" | "desc";
+    frequency?: string;
+}): Promise<FredObservations>;
+/** Bulk fetch all series in a FRED release (v2 API). */
+export declare function getReleaseData(releaseId: number, limit?: number): Promise<FredReleaseResult>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=fred.d.ts.map

package/dist/sdk/fred.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fred.d.ts","sourceRoot":"","sources":["../../src/sdk/fred.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAID,qCAAqC;AACrC,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIvF;AAED,wCAAwC;AACxC,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAKhF;AAED,2CAA2C;AAC3C,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYjC;AAED,wDAAwD;AACxD,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAIlG;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}