@usa-open-data-connectors/usa-sources 0.1.0

package/dist/noaaSeaLevel.d.ts

@@ -0,0 +1,144 @@
+import type { UsDataAdapter } from './types.js';
+/** One month of mean sea level at a tide gauge. */
+export interface NoaaSeaLevelMonth {
+    /** Calendar year the month belongs to. */
+    year: number;
+    /** Calendar month, 1 for January. */
+    month: number;
+    /**
+     * Mean sea level for the month, in metres against the station's tidal
+     * datum: the 1983-2001 National Tidal Datum Epoch.
+     */
+    meanSeaLevelMeters: number;
+}
+/** One calendar year, averaged from the months the gauge published. */
+export interface NoaaSeaLevelYear {
+    /** Calendar year the average covers. */
+    year: number;
+    /** Mean of the monthly values published that year. */
+    meanSeaLevelMeters: number;
+    /** Months that went into the average. A complete year holds twelve. */
+    monthCount: number;
+}
+/** The gauge a series came from. */
+export interface NoaaSeaLevelStation {
+    /** Station id as the agency publishes it, e.g. "8518750". */
+    id: string;
+    /** Station name as the agency publishes it, e.g. "The Battery". */
+    name: string;
+}
+/** One response, as the monthly rows plus the station they came from. */
+export interface NoaaSeaLevelPayload {
+    station: NoaaSeaLevelStation;
+    /** Months with a published value, in the order the agency sent them. */
+    months: NoaaSeaLevelMonth[];
+}
+/** One gauge's record, folded down to the points a story leans on. */
+export interface NoaaSeaLevelSeries {
+    station: NoaaSeaLevelStation;
+    /** One entry per calendar year that has a value, oldest first. */
+    years: NoaaSeaLevelYear[];
+    yearCount: number;
+    firstYear: NoaaSeaLevelYear;
+    lastYear: NoaaSeaLevelYear;
+    highest: NoaaSeaLevelYear;
+    lowest: NoaaSeaLevelYear;
+    /** Least-squares trend through the annual means, in millimetres per year. */
+    trendMillimetresPerYear: number;
+    /** Change from the first year to the last, in metres. */
+    changeFirstToLastMeters: number;
+}
+/** The station and the window one request asks for. */
+export interface NoaaSeaLevelQuery {
+    /** Station id, e.g. "8518750" for The Battery. */
+    stationId: string;
+    /** First calendar year in the window. */
+    startYear: number;
+    /** Last calendar year in the window. */
+    endYear: number;
+}
+/** Base URL for the NOAA CO-OPS data retrieval API. */
+export declare const NOAA_COOPS_API_BASE = "https://api.tidesandcurrents.noaa.gov/api/prod/datagetter";
+/** CO-OPS product id for one row of monthly statistics per month. */
+export declare const NOAA_SEA_LEVEL_PRODUCT = "monthly_mean";
+/**
+ * Datum the values are read against.
+ *
+ * MSL is the station's mean sea level datum, the average of hourly heights
+ * over the 1983-2001 National Tidal Datum Epoch. Reading against one fixed
+ * epoch is what makes two years in the record comparable.
+ */
+export declare const NOAA_SEA_LEVEL_DATUM = "MSL";
+/** Units the adapter asks for: metres. */
+export declare const NOAA_SEA_LEVEL_UNITS = "metric";
+/** Station id for The Battery, New York, the longest sea level record in the country. */
+export declare const NOAA_BATTERY_STATION_ID = "8518750";
+/** Name the agency publishes for that gauge. */
+export declare const NOAA_BATTERY_STATION_NAME = "The Battery";
+/** First year the gauge published a monthly mean. */
+export declare const NOAA_SEA_LEVEL_FIRST_YEAR = 1856;
+/** Application id sent with each request, so the agency can see the caller. */
+export declare const NOAA_SEA_LEVEL_APPLICATION_ID = "nzlab-usa-sources";
+/**
+ * Builds the download URL for one gauge and window.
+ *
+ * One request covers the whole window, because the product returns one row
+ * per month rather than one row per reading. The endpoint is keyless.
+ *
+ * @param query - the station and the first and last year to read
+ * @returns the full request URL
+ */
+export declare function buildNoaaSeaLevelUrl(query: NoaaSeaLevelQuery): string;
+/**
+ * Parses one response into the months that carry a value.
+ *
+ * The gauge answers with a row for every month in the window. A month it
+ * could not compute comes back with a blank value, which is how the early
+ * gaps in the record arrive, so those rows are left out rather than counted
+ * as zero. A row missing its year or month, or a non-blank value that is not
+ * a number, is a changed shape and stops the parse.
+ *
+ * @param payload - the JSON body from the CO-OPS data retrieval API
+ * @returns the station and the months that carry a value
+ */
+export declare function parseNoaaSeaLevelPayload(payload: unknown): NoaaSeaLevelPayload;
+/**
+ * Fits a straight line through the annual means.
+ *
+ * The slope of that line is the average rise per year over the window. A
+ * positive number means the record climbed; the size of it is how fast, in
+ * millimetres per year.
+ *
+ * @param years - the annual means, in any order
+ * @returns the fitted slope in millimetres per year
+ */
+export declare function noaaSeaLevelTrendMillimetresPerYear(years: NoaaSeaLevelYear[]): number;
+/**
+ * Folds the parsed months into one series of calendar-year averages.
+ *
+ * A year's average is taken over the months the gauge published, so a year
+ * with part of its months missing is still counted, and its monthCount says
+ * how much of the year it covers.
+ *
+ * @param payload - the parsed response
+ * @returns the annual means, oldest first, plus the highest, the lowest, and the trend
+ */
+export declare function buildNoaaSeaLevelSeries(payload: NoaaSeaLevelPayload): NoaaSeaLevelSeries;
+/**
+ * Reads a sea level record from NOAA CO-OPS.
+ *
+ * The window defaults to the whole record at The Battery, which the gauge
+ * has been publishing since 1856.
+ *
+ * @param options - an optional station, window, and fetch stub
+ * @returns the annual means, the headline years, and the trend
+ */
+export declare function fetchNoaaSeaLevel(options?: {
+    stationId?: string;
+    startYear?: number;
+    endYear?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<NoaaSeaLevelSeries>;
+/** NOAA CO-OPS monthly mean sea level, keyless. */
+export declare const noaaSeaLevelAdapter: UsDataAdapter<NoaaSeaLevelSeries>;
+//# sourceMappingURL=noaaSeaLevel.d.ts.map

package/dist/noaaSeaLevel.d.ts.map

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

package/dist/noaaSeaLevel.js

@@ -0,0 +1,252 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Base URL for the NOAA CO-OPS data retrieval API. */
+export const NOAA_COOPS_API_BASE = 'https://api.tidesandcurrents.noaa.gov/api/prod/datagetter';
+/** CO-OPS product id for one row of monthly statistics per month. */
+export const NOAA_SEA_LEVEL_PRODUCT = 'monthly_mean';
+/**
+ * Datum the values are read against.
+ *
+ * MSL is the station's mean sea level datum, the average of hourly heights
+ * over the 1983-2001 National Tidal Datum Epoch. Reading against one fixed
+ * epoch is what makes two years in the record comparable.
+ */
+export const NOAA_SEA_LEVEL_DATUM = 'MSL';
+/** Units the adapter asks for: metres. */
+export const NOAA_SEA_LEVEL_UNITS = 'metric';
+/** Station id for The Battery, New York, the longest sea level record in the country. */
+export const NOAA_BATTERY_STATION_ID = '8518750';
+/** Name the agency publishes for that gauge. */
+export const NOAA_BATTERY_STATION_NAME = 'The Battery';
+/** First year the gauge published a monthly mean. */
+export const NOAA_SEA_LEVEL_FIRST_YEAR = 1856;
+/** Application id sent with each request, so the agency can see the caller. */
+export const NOAA_SEA_LEVEL_APPLICATION_ID = 'nzlab-usa-sources';
+/** Millimetres in a metre, for the trend's units. */
+const MILLIMETRES_PER_METRE = 1000;
+/** First day of January, at the start of the month the window opens on. */
+const WINDOW_START_DAY = '0101';
+/** Last day of December, at the end of the month the window closes on. */
+const WINDOW_END_DAY = '1231';
+/** Committed snapshot, so a build works when the agency host is unreachable. */
+const NOAA_SEA_LEVEL_FIXTURE_FILENAME = 'noaa-sea-level-2026-09-27.json';
+// The API sends every field as a string and leaves a blank string where it
+// has no value, so each field is optional and read defensively. A JSON level
+// error arrives in place of the data when the request is not understood.
+const NOAA_MONTH_ROW_SCHEMA = z.object({
+    year: z.string().optional(),
+    month: z.string().optional(),
+    MSL: z.string().optional(),
+});
+const NOAA_PAYLOAD_SCHEMA = z.object({
+    metadata: z
+        .object({
+        id: z.string().optional(),
+        name: z.string().optional(),
+    })
+        .optional(),
+    data: z.array(NOAA_MONTH_ROW_SCHEMA).optional(),
+    error: z
+        .object({
+        message: z.string().optional(),
+    })
+        .optional(),
+});
+/** Reads a whole number the API sends as a string, or undefined. */
+function readNoaaWholeNumber(value) {
+    if (value === undefined || value.trim() === '') {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : undefined;
+}
+/**
+ * Builds the download URL for one gauge and window.
+ *
+ * One request covers the whole window, because the product returns one row
+ * per month rather than one row per reading. The endpoint is keyless.
+ *
+ * @param query - the station and the first and last year to read
+ * @returns the full request URL
+ */
+export function buildNoaaSeaLevelUrl(query) {
+    const params = new URLSearchParams({
+        product: NOAA_SEA_LEVEL_PRODUCT,
+        application: NOAA_SEA_LEVEL_APPLICATION_ID,
+        begin_date: `${query.startYear}${WINDOW_START_DAY}`,
+        end_date: `${query.endYear}${WINDOW_END_DAY}`,
+        datum: NOAA_SEA_LEVEL_DATUM,
+        station: query.stationId,
+        time_zone: 'gmt',
+        units: NOAA_SEA_LEVEL_UNITS,
+        format: 'json',
+    });
+    return `${NOAA_COOPS_API_BASE}?${params.toString()}`;
+}
+/**
+ * Parses one response into the months that carry a value.
+ *
+ * The gauge answers with a row for every month in the window. A month it
+ * could not compute comes back with a blank value, which is how the early
+ * gaps in the record arrive, so those rows are left out rather than counted
+ * as zero. A row missing its year or month, or a non-blank value that is not
+ * a number, is a changed shape and stops the parse.
+ *
+ * @param payload - the JSON body from the CO-OPS data retrieval API
+ * @returns the station and the months that carry a value
+ */
+export function parseNoaaSeaLevelPayload(payload) {
+    const parsed = NOAA_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError('noaa', parsed.error.message);
+    }
+    if (parsed.data.error !== undefined) {
+        throw new UsSourceApiError('noaa', parsed.data.error.message ?? 'The API rejected the request');
+    }
+    const stationId = parsed.data.metadata?.id;
+    const stationName = parsed.data.metadata?.name;
+    if (stationId === undefined || stationName === undefined) {
+        throw new UsSourceParseError('noaa', 'The response carried no station metadata');
+    }
+    const months = [];
+    for (const row of parsed.data.data ?? []) {
+        const year = readNoaaWholeNumber(row.year);
+        const month = readNoaaWholeNumber(row.month);
+        if (year === undefined || month === undefined) {
+            throw new UsSourceParseError('noaa', `A monthly row has no year or month: ${JSON.stringify(row)}`);
+        }
+        if (row.MSL === undefined || row.MSL.trim() === '') {
+            continue;
+        }
+        const meanSeaLevelMeters = Number(row.MSL);
+        if (!Number.isFinite(meanSeaLevelMeters)) {
+            throw new UsSourceParseError('noaa', `Unreadable mean sea level: ${row.MSL}`);
+        }
+        months.push({ year, month, meanSeaLevelMeters });
+    }
+    if (months.length === 0) {
+        throw new UsSourceParseError('noaa', 'No monthly values in the response');
+    }
+    return { station: { id: stationId, name: stationName }, months };
+}
+/**
+ * Fits a straight line through the annual means.
+ *
+ * The slope of that line is the average rise per year over the window. A
+ * positive number means the record climbed; the size of it is how fast, in
+ * millimetres per year.
+ *
+ * @param years - the annual means, in any order
+ * @returns the fitted slope in millimetres per year
+ */
+export function noaaSeaLevelTrendMillimetresPerYear(years) {
+    if (years.length < 2) {
+        throw new UsSourceParseError('noaa', 'A trend needs at least two years');
+    }
+    let sumYears = 0;
+    let sumLevels = 0;
+    let sumProducts = 0;
+    let sumSquares = 0;
+    for (const year of years) {
+        sumYears += year.year;
+        sumLevels += year.meanSeaLevelMeters;
+        sumProducts += year.year * year.meanSeaLevelMeters;
+        sumSquares += year.year * year.year;
+    }
+    const count = years.length;
+    const denominator = count * sumSquares - sumYears * sumYears;
+    if (denominator === 0) {
+        throw new UsSourceParseError('noaa', 'Every year in the window is the same year');
+    }
+    const slope = (count * sumProducts - sumYears * sumLevels) / denominator;
+    return slope * MILLIMETRES_PER_METRE;
+}
+/**
+ * Folds the parsed months into one series of calendar-year averages.
+ *
+ * A year's average is taken over the months the gauge published, so a year
+ * with part of its months missing is still counted, and its monthCount says
+ * how much of the year it covers.
+ *
+ * @param payload - the parsed response
+ * @returns the annual means, oldest first, plus the highest, the lowest, and the trend
+ */
+export function buildNoaaSeaLevelSeries(payload) {
+    const monthsByYear = new Map();
+    for (const month of payload.months) {
+        const values = monthsByYear.get(month.year);
+        if (values === undefined) {
+            monthsByYear.set(month.year, [month.meanSeaLevelMeters]);
+        }
+        else {
+            values.push(month.meanSeaLevelMeters);
+        }
+    }
+    const years = [...monthsByYear.entries()]
+        .sort(([left], [right]) => left - right)
+        .map(([year, values]) => ({
+        year,
+        meanSeaLevelMeters: values.reduce((total, value) => total + value, 0) / values.length,
+        monthCount: values.length,
+    }));
+    const first = years[0];
+    const last = years[years.length - 1];
+    if (first === undefined || last === undefined) {
+        throw new UsSourceParseError('noaa', 'No years to summarise');
+    }
+    let highest = first;
+    let lowest = first;
+    for (const year of years) {
+        if (year.meanSeaLevelMeters > highest.meanSeaLevelMeters) {
+            highest = year;
+        }
+        if (year.meanSeaLevelMeters < lowest.meanSeaLevelMeters) {
+            lowest = year;
+        }
+    }
+    return {
+        station: payload.station,
+        years,
+        yearCount: years.length,
+        firstYear: first,
+        lastYear: last,
+        highest,
+        lowest,
+        trendMillimetresPerYear: noaaSeaLevelTrendMillimetresPerYear(years),
+        changeFirstToLastMeters: last.meanSeaLevelMeters - first.meanSeaLevelMeters,
+    };
+}
+/**
+ * Reads a sea level record from NOAA CO-OPS.
+ *
+ * The window defaults to the whole record at The Battery, which the gauge
+ * has been publishing since 1856.
+ *
+ * @param options - an optional station, window, and fetch stub
+ * @returns the annual means, the headline years, and the trend
+ */
+export async function fetchNoaaSeaLevel(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildNoaaSeaLevelUrl({
+        stationId: options?.stationId ?? NOAA_BATTERY_STATION_ID,
+        startYear: options?.startYear ?? NOAA_SEA_LEVEL_FIRST_YEAR,
+        endYear: options?.endYear ?? new Date().getFullYear(),
+    });
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UsSourceApiError('noaa', `HTTP ${response.status} reading the sea level record`);
+    }
+    return buildNoaaSeaLevelSeries(parseNoaaSeaLevelPayload(await response.json()));
+}
+/** NOAA CO-OPS monthly mean sea level, keyless. */
+export const noaaSeaLevelAdapter = {
+    id: 'noaa-sea-level',
+    name: 'NOAA CO-OPS sea level',
+    auth: 'none',
+    description: 'Monthly mean sea level at a NOAA tide gauge, folded into calendar-year averages with a fitted trend.',
+    fetchLive: async (options) => fetchNoaaSeaLevel(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => buildNoaaSeaLevelSeries(parseNoaaSeaLevelPayload(payload)),
+    loadFixture: () => buildNoaaSeaLevelSeries(parseNoaaSeaLevelPayload(readFixtureJson(NOAA_SEA_LEVEL_FIXTURE_FILENAME))),
+};
+//# sourceMappingURL=noaaSeaLevel.js.map

package/dist/noaaSeaLevel.js.map

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

package/dist/openFdaFoodRecalls.d.ts

@@ -0,0 +1,154 @@
+import type { UsDataAdapter } from './types.js';
+/** One value of a counted openFDA field, with how many records carry it. */
+export interface OpenFdaRecallCount {
+    /** The value as the agency publishes it, e.g. "Class I". */
+    name: string;
+    count: number;
+}
+/** One publication date and the recalls the agency published on it. */
+export interface OpenFdaRecallDateCount {
+    /** The agency's date stamp, e.g. "20120620". */
+    date: string;
+    count: number;
+}
+/**
+ * Every response one summary is built from.
+ *
+ * The live endpoint answers one question per request, so the adapter folds
+ * four responses into this shape before it counts anything.
+ */
+export interface OpenFdaFoodRecallSnapshot {
+    /** Enforcement reports in the food endpoint, from the response metadata. */
+    recallCount: number;
+    /** Recalls published on each date, every classification. */
+    reportDates: OpenFdaRecallDateCount[];
+    /** Recalls published on each date whose classification is Class I. */
+    classOneDates: OpenFdaRecallDateCount[];
+    /** Recalls per classification, most first. */
+    classifications: OpenFdaRecallCount[];
+    /** Recalls per initiator, most first. */
+    voluntary: OpenFdaRecallCount[];
+}
+/** One calendar year of food enforcement reports. */
+export interface OpenFdaFoodRecallYear {
+    year: number;
+    total: number;
+    /** Class I recalls: a reasonable chance of serious harm or death. */
+    classOne: number;
+    /** Every other classification, including Class II and Class III. */
+    other: number;
+}
+/** The food recall file folded into the shape a story reads. */
+export interface OpenFdaFoodRecallSummary {
+    recallCount: number;
+    /** Distinct publication dates in the file. */
+    reportDateCount: number;
+    /** Oldest publication date, e.g. "2012-06-20". */
+    firstReportDate: string;
+    /** Newest publication date, e.g. "2026-09-23". */
+    newestReportDate: string;
+    firstYear: number;
+    /** Newest year in the file, which is still open. */
+    newestYear: number;
+    /** Recalls published against the newest year so far. */
+    newestYearCount: number;
+    /** One entry per calendar year in the file, oldest first. */
+    years: OpenFdaFoodRecallYear[];
+    busiestYear: OpenFdaFoodRecallYear;
+    classOneCount: number;
+    /** Class I recalls as a share of the file, in percent. */
+    classOneSharePercent: number;
+    classifications: OpenFdaRecallCount[];
+    voluntaryCount: number;
+    mandatedCount: number;
+}
+/** Base URL for the openFDA food enforcement endpoint. */
+export declare const OPENFDA_FOOD_ENFORCEMENT_BASE = "https://api.fda.gov/food/enforcement.json";
+/**
+ * Classification FDA gives a recall that can seriously harm or kill.
+ *
+ * The endpoint carries Class I, Class II, Class III, and a handful of
+ * unclassified records; Class I is the one the story separates out.
+ */
+export declare const OPENFDA_CLASS_ONE = "Class I";
+/** Initiator terms the agency uses for a firm's own recall and a mandated one. */
+export declare const OPENFDA_VOLUNTARY_TERM = "Voluntary: Firm initiated";
+export declare const OPENFDA_MANDATED_TERM = "FDA Mandated";
+/** Fields the adapter counts on. The endpoint carries exact-term variants. */
+export declare const OPENFDA_REPORT_DATE_FIELD = "report_date";
+export declare const OPENFDA_CLASSIFICATION_COUNT_FIELD = "classification.exact";
+export declare const OPENFDA_VOLUNTARY_COUNT_FIELD = "voluntary_mandated.exact";
+/**
+ * Builds the URL that reports how many records the endpoint holds.
+ *
+ * @returns the request URL
+ */
+export declare function buildOpenFdaFoodRecallTotalUrl(): string;
+/**
+ * Builds the URL for one counted field, optionally inside a search.
+ *
+ * @param options - the field to count, and an optional openFDA search clause
+ * @returns the request URL
+ */
+export declare function buildOpenFdaFoodRecallCountUrl(options?: {
+    field?: string;
+    search?: string;
+}): string;
+/**
+ * Reads the record count out of the metadata block.
+ *
+ * @param payload - the JSON body from the limit=1 request
+ * @returns how many enforcement reports the endpoint holds
+ */
+export declare function parseOpenFdaRecallTotal(payload: unknown): number;
+/**
+ * Reads one counted field into value and count pairs.
+ *
+ * @param payload - the JSON body from a count request
+ * @returns the values with their counts, in the order the agency sent them
+ */
+export declare function parseOpenFdaRecallCounts(payload: unknown): OpenFdaRecallCount[];
+/**
+ * Reads a count of the date field into dated counts.
+ *
+ * @param payload - the JSON body from a count=report_date request
+ * @returns one entry per publication date, in the order the agency sent them
+ */
+export declare function parseOpenFdaRecallDateCounts(payload: unknown): OpenFdaRecallDateCount[];
+/**
+ * Reads the committed snapshot: four responses under the keys that name them.
+ *
+ * @param payload - the parsed contents of the snapshot file
+ * @returns the snapshot in the shape the summary builder reads
+ */
+export declare function parseOpenFdaFoodRecallSnapshot(payload: unknown): OpenFdaFoodRecallSnapshot;
+/** Turns the agency's date stamp into the ISO date a reader recognises. */
+export declare function openFdaReportDateLabel(date: string): string;
+/**
+ * Folds the four responses into the per-year counts a story reads.
+ *
+ * Every recall in the file carries a publication date and a classification,
+ * so the two counts have to agree: a snapshot whose dates cover fewer recalls
+ * than the metadata reports is refused rather than charted short.
+ *
+ * @param snapshot - the counted responses, all from the same day
+ * @returns the per-year counts and the figures the copy quotes
+ */
+export declare function buildOpenFdaFoodRecallSummary(snapshot: OpenFdaFoodRecallSnapshot): OpenFdaFoodRecallSummary;
+/**
+ * Reads the food enforcement file as four counted responses.
+ *
+ * Keyless. The endpoint answers one question per request and cannot group by
+ * two fields at once, so the per-year Class I counts come from a second date
+ * count under a search clause. Without an API key the endpoint allows 240
+ * requests a minute and 1,000 a day, and five requests cover the whole file.
+ *
+ * @param options - an optional fetch stub
+ * @returns the per-year counts and the figures the copy quotes
+ */
+export declare function fetchOpenFdaFoodRecalls(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<OpenFdaFoodRecallSummary>;
+/** openFDA food enforcement reports, keyless. */
+export declare const openFdaFoodRecallsAdapter: UsDataAdapter<OpenFdaFoodRecallSummary>;
+//# sourceMappingURL=openFdaFoodRecalls.d.ts.map

package/dist/openFdaFoodRecalls.d.ts.map

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