@usa-open-data-connectors/usa-sources 0.1.2 → 0.1.4

package/dist/epaEnvirofactsFacilities.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/** Adapter id for the EPA Envirofacts facility source. */
+export const EPA_ENVIROFACTS_FACILITIES_SOURCE_ID = 'epa-envirofacts-facilities';
+/** Base URL for the EPA Envirofacts service. */
+export const EPA_ENVIROFACTS_API_BASE = 'https://data.epa.gov/efservice';
+/** Envirofacts table that holds the Toxics Release Inventory facility records. */
+export const EPA_ENVIROFACTS_TABLE = 'TRI_FACILITY';
+/** Envirofacts column the state filter reads. */
+export const EPA_ENVIROFACTS_STATE_COLUMN = 'STATE_ABBR';
+/** State the default URL asks for. */
+export const EPA_ENVIROFACTS_STATE_ABBR = 'RI';
+/** Row window one request reads, the first ten rows. */
+export const EPA_ENVIROFACTS_ROW_WINDOW = '0:9';
+/** Committed snapshot, so a build works when the Envirofacts host is unreachable. */
+const EPA_ENVIROFACTS_FIXTURE_FILENAME = 'epa-envirofacts-facilities-2026-10-05.json';
+// The service answers with a bare JSON array, and a rejected query answers
+// with a body of {error}. The filter segment takes the value on its own: an
+// "equals" operator is accepted in the URL but never narrows the rows, so the
+// URL builder below does not use one.
+const EPA_ENVIROFACTS_FACILITY_SCHEMA = z.object({
+    tri_facility_id: z.string(),
+    facility_name: z.string(),
+    street_address: z.string().nullable().optional(),
+    city_name: z.string().nullable().optional(),
+    county_name: z.string().nullable().optional(),
+    state_abbr: z.string(),
+    zip_code: z.string().nullable().optional(),
+    region: z.string().nullable().optional(),
+    fac_closed_ind: z.string().nullable().optional(),
+    parent_co_name: z.string().nullable().optional(),
+});
+const EPA_ENVIROFACTS_PAYLOAD_SCHEMA = z.union([
+    z.array(EPA_ENVIROFACTS_FACILITY_SCHEMA),
+    z.object({ error: z.string().optional() }),
+]);
+/** Reads the parent company, treating the register's "NA" as absent. */
+function readEpaParentCompany(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed === '' || trimmed === 'NA' ? null : trimmed;
+}
+/** Counts facilities per county, most facilities first, then by name. */
+function countEpaEnvirofactsCounties(facilities) {
+    const counts = new Map();
+    for (const facility of facilities) {
+        counts.set(facility.countyName, (counts.get(facility.countyName) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .sort(([leftCounty, leftCount], [rightCounty, rightCount]) => leftCount === rightCount ? leftCounty.localeCompare(rightCounty) : rightCount - leftCount)
+        .map(([countyName, facilityCount]) => ({ countyName, facilityCount }));
+}
+/**
+ * Builds the request URL for one page of Toxics Release Inventory facilities.
+ *
+ * The endpoint is keyless, and the state segment does narrow the rows: the
+ * value sits directly after the column name, with no `equals` operator.
+ * Envirofacts accepts an `equals` segment without complaining but then
+ * returns the table's first rows instead of the ones asked for.
+ *
+ * @param options - an optional state code and row window
+ * @returns the full request URL
+ */
+export function buildEpaEnvirofactsFacilitiesUrl(options) {
+    const stateAbbr = options?.stateAbbr ?? EPA_ENVIROFACTS_STATE_ABBR;
+    const rowWindow = options?.rowWindow ?? EPA_ENVIROFACTS_ROW_WINDOW;
+    return `${EPA_ENVIROFACTS_API_BASE}/${EPA_ENVIROFACTS_TABLE}/${EPA_ENVIROFACTS_STATE_COLUMN}/${stateAbbr}/rows/${rowWindow}/JSON`;
+}
+/**
+ * Parses one response into the facilities in the page and its rollups.
+ *
+ * A row without a facility id, name, or state code fails the schema and stops
+ * the parse. An empty array is treated as a changed source, because the
+ * default query always returns rows.
+ *
+ * @param payload - the JSON body from the Envirofacts service
+ * @returns the facilities in the page, the open and closed counts, and the counties
+ */
+export function parseEpaEnvirofactsFacilitiesPayload(payload) {
+    const parsed = EPA_ENVIROFACTS_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(EPA_ENVIROFACTS_FACILITIES_SOURCE_ID, parsed.error.message);
+    }
+    if (!Array.isArray(parsed.data)) {
+        throw new UsSourceApiError(EPA_ENVIROFACTS_FACILITIES_SOURCE_ID, parsed.data.error ?? 'The service rejected the query');
+    }
+    if (parsed.data.length === 0) {
+        throw new UsSourceParseError(EPA_ENVIROFACTS_FACILITIES_SOURCE_ID, 'The response carried no rows');
+    }
+    const facilities = parsed.data.map((row) => ({
+        facilityId: row.tri_facility_id,
+        facilityName: row.facility_name,
+        streetAddress: row.street_address ?? '',
+        city: row.city_name ?? '',
+        countyName: row.county_name ?? '',
+        stateAbbr: row.state_abbr,
+        postalCode: row.zip_code ?? '',
+        region: row.region ?? '',
+        closed: row.fac_closed_ind === '1',
+        parentCompanyName: readEpaParentCompany(row.parent_co_name),
+    }));
+    const closedCount = facilities.filter((facility) => facility.closed).length;
+    return {
+        facilities,
+        facilityCount: facilities.length,
+        openCount: facilities.length - closedCount,
+        closedCount,
+        counties: countEpaEnvirofactsCounties(facilities),
+    };
+}
+/**
+ * Reads one page of Toxics Release Inventory facilities from Envirofacts.
+ *
+ * One keyless request covers the page. The state segment in the URL narrows
+ * the rows, so the page holds facilities from the state that was asked for.
+ *
+ * @param options - an optional state code, row window, and fetch stub
+ * @returns the facilities in the page and its rollups
+ */
+export async function fetchEpaEnvirofactsFacilities(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildEpaEnvirofactsFacilitiesUrl(options?.stateAbbr === undefined ? {} : { stateAbbr: options.stateAbbr });
+    const response = await httpGet(EPA_ENVIROFACTS_FACILITIES_SOURCE_ID, url, { fetchImpl });
+    return parseEpaEnvirofactsFacilitiesPayload(await response.json());
+}
+/** EPA Envirofacts Toxics Release Inventory facilities, keyless. */
+export const epaEnvirofactsFacilitiesAdapter = {
+    id: EPA_ENVIROFACTS_FACILITIES_SOURCE_ID,
+    name: 'EPA Envirofacts facilities',
+    auth: 'none',
+    description: 'Toxics Release Inventory facilities from the EPA Envirofacts service, one row per site, with its county, address, and open or closed status.',
+    fetchLive: async (options) => fetchEpaEnvirofactsFacilities(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseEpaEnvirofactsFacilitiesPayload(payload),
+    loadFixture: () => parseEpaEnvirofactsFacilitiesPayload(readFixtureJson(EPA_ENVIROFACTS_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=epaEnvirofactsFacilities.js.map

package/dist/epaEnvirofactsFacilities.js.map

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

package/dist/errors.d.ts

@@ -2,10 +2,20 @@
 export declare class UsSourceError extends Error {
     constructor(message: string, options?: ErrorOptions);
 }
+/** Extra detail carried by an API error. */
+export interface UsSourceApiErrorDetails extends ErrorOptions {
+    /** HTTP status code, when the failure arrived as a response. */
+    status?: number | undefined;
+    /** Whether retrying the same request could succeed. */
+    retryable?: boolean | undefined;
+}
 /** The remote API rejected the request (HTTP error or bad payload). */
 export declare class UsSourceApiError extends UsSourceError {
-    readonly source: string;
-    constructor(source: string, message: string, options?: ErrorOptions);
+    /** HTTP status code, when the failure arrived as a response. */
+    readonly status: number | undefined;
+    /** Whether retrying the same request could succeed. */
+    readonly retryable: boolean;
+    constructor(source: string, message: string, details?: UsSourceApiErrorDetails);
 }
 /** The remote payload did not match the expected shape. */
 export declare class UsSourceParseError extends UsSourceError {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,aAAa;aAE/B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,aAAa;aAEjC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qBAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,EAKjF;CACF;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,aAAa;aAEjC,MAAM,EAAE,MAAM;IADhC,YACkB,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF"}

package/dist/errors.js

@@ -7,11 +7,15 @@ export class UsSourceError extends Error {
 }
 /** The remote API rejected the request (HTTP error or bad payload). */
 export class UsSourceApiError extends UsSourceError {
-    source;
-    constructor(source, message, options) {
-        super(`${source}: ${message}`, options);
-        this.source = source;
+    /** HTTP status code, when the failure arrived as a response. */
+    status;
+    /** Whether retrying the same request could succeed. */
+    retryable;
+    constructor(source, message, details = {}) {
+        super(`${source}: ${message}`, details);
         this.name = 'UsSourceApiError';
+        this.status = details.status;
+        this.retryable = details.retryable ?? false;
     }
 }
 /** The remote payload did not match the expected shape. */

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAE/B;IADlB,YACkB,MAAc,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAJxB,WAAM,GAAN,MAAM,CAAQ;QAK9B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAEjC;IADlB,YACkB,MAAc,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAJxB,WAAM,GAAN,MAAM,CAAQ;QAK9B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAUD,uEAAuE;AACvE,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,gEAAgE;IACvD,MAAM,CAAqB;IACpC,uDAAuD;IAC9C,SAAS,CAAU;IAE5B,YAAY,MAAc,EAAE,OAAe,EAAE,OAAO,GAA4B,EAAE;QAChF,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAEjC,MAAM;IADxB,YACkB,MAAc,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;sBAJxB,MAAM;QAKtB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/estimatetaxIncomeTax.d.ts

@@ -0,0 +1,140 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the EstimateTax income tax source. */
+export declare const ESTIMATETAX_INCOME_TAX_SOURCE_ID = "estimatetax-income-tax";
+/** Base URL for the EstimateTax API. */
+export declare const ESTIMATETAX_API_BASE = "https://estimatetax.net";
+/** Path of the one calculation endpoint. */
+export declare const ESTIMATETAX_CALCULATE_PATH = "/api/v1/calculate";
+/** Default annual income in the worked example. */
+export declare const ESTIMATETAX_DEFAULT_INCOME = 85000;
+/** Default state in the worked example. */
+export declare const ESTIMATETAX_DEFAULT_STATE = "NY";
+/** Default local jurisdiction in the worked example. */
+export declare const ESTIMATETAX_DEFAULT_CITY = "new-york-city";
+/** Filing statuses the API accepts. */
+export declare const ESTIMATETAX_FILING_STATUSES: readonly ['single', 'married_jointly', 'married_separately', 'head_of_household'];
+/** One filing status the API accepts. */
+export type EstimateTaxFilingStatus = (typeof ESTIMATETAX_FILING_STATUSES)[number];
+/** Inputs for one tax calculation. */
+export interface EstimateTaxQuery {
+    /** Gross annual employment income, in US dollars. */
+    income: number;
+    /** How the taxpayer files. Defaults to single. */
+    filingStatus?: EstimateTaxFilingStatus;
+    /** Two-letter state code, or null for federal tax only. */
+    state?: string | null;
+    /** Local jurisdiction slug, where the state levies a local income tax. */
+    city?: string | null;
+    /** Pre-tax deductions such as a 401(k) or health premiums. */
+    preTaxDeductions?: number;
+    /** Net self-employment income. */
+    selfEmploymentIncome?: number;
+}
+/** The input block echoed back in a calculation. */
+export interface EstimateTaxInput {
+    income: number;
+    filingStatus: EstimateTaxFilingStatus;
+    state: string | null;
+    city: string | null;
+    preTaxDeductions: number;
+    selfEmploymentIncome: number;
+}
+/** One federal bracket and how much tax the income paid in it. */
+export interface EstimateTaxBracket {
+    rate: number;
+    taxableIncome: number;
+    tax: number;
+}
+/** Federal income tax, payroll tax, and the brackets the income crossed. */
+export interface EstimateTaxFederal {
+    incomeTax: number;
+    totalFica: number;
+    marginalRate: number;
+    brackets: EstimateTaxBracket[];
+}
+/** State income tax for the chosen jurisdiction. */
+export interface EstimateTaxState {
+    code: string;
+    name: string;
+    tax: number;
+    system: string;
+}
+/** Local income tax for the chosen city, county, or school district. */
+export interface EstimateTaxLocal {
+    jurisdiction: string;
+    tax: number;
+    rate: number;
+    base: string;
+}
+/** The total tax and the income left after it. */
+export interface EstimateTaxTotals {
+    totalTax: number;
+    netIncome: number;
+    effectiveRate: number;
+    effectiveIncomeTaxRate: number;
+}
+/** The official document behind one layer of the calculation. */
+export interface EstimateTaxSource {
+    citation?: string;
+    authority?: string;
+    document?: string;
+    url: string;
+    /** The date the publisher checked the figure, under either API field name. */
+    checkedDate?: string;
+}
+/** Every source a calculation cites. */
+export interface EstimateTaxSources {
+    federal: EstimateTaxSource;
+    state: EstimateTaxSource | null;
+    local: EstimateTaxSource | null;
+}
+/** One complete tax calculation. */
+export interface EstimateTaxCalculation {
+    taxYear: number;
+    input: EstimateTaxInput;
+    federal: EstimateTaxFederal;
+    state: EstimateTaxState | null;
+    local: EstimateTaxLocal | null;
+    totals: EstimateTaxTotals;
+    sources: EstimateTaxSources;
+}
+/** The query the adapter uses when the caller gives none. */
+export declare const ESTIMATETAX_DEFAULT_QUERY: EstimateTaxQuery;
+/**
+ * Builds the request URL for one tax calculation.
+ *
+ * The endpoint is keyless and limited to 60 requests a minute. The default
+ * query is the $85,000 New York City case the committed fixture records.
+ *
+ * @param query - income and optional place, filing status, and deductions
+ * @returns the full request URL
+ */
+export declare function buildEstimateTaxUrl(query?: EstimateTaxQuery): string;
+/**
+ * Parses one calculation into the tax parts and their cited sources.
+ *
+ * A state or local layer is null when the calculation does not include it.
+ * The parser refuses a missing federal bracket list, a negative amount, or a
+ * source block without the document URL, so a changed response cannot quietly
+ * produce a figure with no provenance.
+ *
+ * @param payload - the JSON body from the calculation endpoint
+ * @returns the calculation in the adapter's shape
+ */
+export declare function parseEstimateTaxCalculation(payload: unknown): EstimateTaxCalculation;
+/**
+ * Reads one US income tax calculation.
+ *
+ * One keyless request answers the federal, state, and local layers together.
+ * Every layer carries the official document its figures came from.
+ *
+ * @param options - the calculation query and an optional fetch stub
+ * @returns the calculation in the adapter's shape
+ */
+export declare function fetchEstimateTaxCalculation(options?: {
+    query?: EstimateTaxQuery;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<EstimateTaxCalculation>;
+/** EstimateTax US federal, state, and local income tax, keyless. */
+export declare const estimatetaxIncomeTaxAdapter: UsDataAdapter<EstimateTaxCalculation>;
+//# sourceMappingURL=estimatetaxIncomeTax.d.ts.map

package/dist/estimatetaxIncomeTax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimatetaxIncomeTax.d.ts","sourceRoot":"","sources":["../src/estimatetaxIncomeTax.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wDAAwD;AACxD,eAAO,MAAM,gCAAgC,2BAA2B,CAAC;AAEzE,wCAAwC;AACxC,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAE9D,4CAA4C;AAC5C,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,wDAAwD;AACxD,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD,uCAAuC;AACvC,eAAO,MAAM,2BAA2B,YACtC,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,CACX,CAAC;AAEX,yCAAyC;AACzC,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,uBAAuB,CAAC;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACjC;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAuED,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,EAAE,gBAKvC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,gBAA4C,GAAG,MAAM,CAkB/F;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CA8DpF;AAED;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IAC1D,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAKlC;AAED,oEAAoE;AACpE,eAAO,MAAM,2BAA2B,EAAE,aAAa,CAAC,sBAAsB,CAY7E,CAAC"}

package/dist/estimatetaxIncomeTax.js

@@ -0,0 +1,225 @@
+import { z } from 'zod';
+import { UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+import { httpGet } from './http.js';
+/** Adapter id for the EstimateTax income tax source. */
+export const ESTIMATETAX_INCOME_TAX_SOURCE_ID = 'estimatetax-income-tax';
+/** Base URL for the EstimateTax API. */
+export const ESTIMATETAX_API_BASE = 'https://estimatetax.net';
+/** Path of the one calculation endpoint. */
+export const ESTIMATETAX_CALCULATE_PATH = '/api/v1/calculate';
+/** Default annual income in the worked example. */
+export const ESTIMATETAX_DEFAULT_INCOME = 85_000;
+/** Default state in the worked example. */
+export const ESTIMATETAX_DEFAULT_STATE = 'NY';
+/** Default local jurisdiction in the worked example. */
+export const ESTIMATETAX_DEFAULT_CITY = 'new-york-city';
+/** Filing statuses the API accepts. */
+export const ESTIMATETAX_FILING_STATUSES = [
+    'single',
+    'married_jointly',
+    'married_separately',
+    'head_of_household',
+];
+/** Committed snapshot, so a build works when EstimateTax is unreachable. */
+const ESTIMATETAX_FIXTURE_FILENAME = 'estimatetax-income-tax-2026-10-18.json';
+const ESTIMATETAX_SOURCE_SCHEMA = z.object({
+    citation: z.string().optional(),
+    authority: z.string().optional(),
+    document: z.string().optional(),
+    url: z.string().url(),
+    verified: z.string().optional(),
+    checked: z.string().optional(),
+});
+const ESTIMATETAX_INPUT_SCHEMA = z.object({
+    income: z.number().nonnegative(),
+    filingStatus: z.enum(ESTIMATETAX_FILING_STATUSES),
+    state: z.string().nullable().optional(),
+    city: z.string().nullable().optional(),
+    preTaxDeductions: z.number().nonnegative().optional(),
+    selfEmploymentIncome: z.number().nonnegative().optional(),
+});
+const ESTIMATETAX_BRACKET_SCHEMA = z.object({
+    rate: z.number().nonnegative(),
+    taxableInBracket: z.number().nonnegative(),
+    tax: z.number().nonnegative(),
+});
+const ESTIMATETAX_FEDERAL_SCHEMA = z.object({
+    incomeTax: z.number().nonnegative(),
+    totalFica: z.number().nonnegative(),
+    marginalRate: z.number().nonnegative(),
+    brackets: z.array(ESTIMATETAX_BRACKET_SCHEMA).min(1),
+});
+const ESTIMATETAX_STATE_SCHEMA = z.object({
+    code: z.string().min(2),
+    name: z.string().min(1),
+    tax: z.number().nonnegative(),
+    system: z.string().min(1),
+});
+const ESTIMATETAX_LOCAL_SCHEMA = z.object({
+    jurisdiction: z.string().min(1),
+    tax: z.number().nonnegative(),
+    rate: z.number().nonnegative(),
+    base: z.string().min(1),
+});
+const ESTIMATETAX_TOTALS_SCHEMA = z.object({
+    totalTax: z.number().nonnegative(),
+    netIncome: z.number().nonnegative(),
+    effectiveRate: z.number().nonnegative(),
+    effectiveIncomeTaxRate: z.number().nonnegative(),
+});
+const ESTIMATETAX_PAYLOAD_SCHEMA = z.object({
+    taxYear: z.number().int().positive(),
+    input: ESTIMATETAX_INPUT_SCHEMA,
+    federal: ESTIMATETAX_FEDERAL_SCHEMA,
+    state: ESTIMATETAX_STATE_SCHEMA.nullable().optional(),
+    local: ESTIMATETAX_LOCAL_SCHEMA.nullable().optional(),
+    totals: ESTIMATETAX_TOTALS_SCHEMA,
+    sources: z.object({
+        federal: ESTIMATETAX_SOURCE_SCHEMA,
+        state: ESTIMATETAX_SOURCE_SCHEMA.nullable().optional(),
+        local: ESTIMATETAX_SOURCE_SCHEMA.nullable().optional(),
+    }),
+});
+/** The query the adapter uses when the caller gives none. */
+export const ESTIMATETAX_DEFAULT_QUERY = {
+    income: ESTIMATETAX_DEFAULT_INCOME,
+    filingStatus: 'single',
+    state: ESTIMATETAX_DEFAULT_STATE,
+    city: ESTIMATETAX_DEFAULT_CITY,
+};
+/**
+ * Builds the request URL for one tax calculation.
+ *
+ * The endpoint is keyless and limited to 60 requests a minute. The default
+ * query is the $85,000 New York City case the committed fixture records.
+ *
+ * @param query - income and optional place, filing status, and deductions
+ * @returns the full request URL
+ */
+export function buildEstimateTaxUrl(query = ESTIMATETAX_DEFAULT_QUERY) {
+    const params = new URLSearchParams({ income: String(query.income) });
+    if (query.filingStatus !== undefined) {
+        params.set('filingStatus', query.filingStatus);
+    }
+    if (query.state !== undefined && query.state !== null) {
+        params.set('state', query.state);
+    }
+    if (query.city !== undefined && query.city !== null) {
+        params.set('city', query.city);
+    }
+    if (query.preTaxDeductions !== undefined) {
+        params.set('preTaxDeductions', String(query.preTaxDeductions));
+    }
+    if (query.selfEmploymentIncome !== undefined) {
+        params.set('selfEmploymentIncome', String(query.selfEmploymentIncome));
+    }
+    return `${ESTIMATETAX_API_BASE}${ESTIMATETAX_CALCULATE_PATH}?${params.toString()}`;
+}
+/** Turns the API's source block into the adapter's shape. */
+function readEstimateTaxSource(source) {
+    const checkedDate = source.checked ?? source.verified;
+    return {
+        url: source.url,
+        ...(source.citation === undefined ? {} : { citation: source.citation }),
+        ...(source.authority === undefined ? {} : { authority: source.authority }),
+        ...(source.document === undefined ? {} : { document: source.document }),
+        ...(checkedDate === undefined ? {} : { checkedDate }),
+    };
+}
+/**
+ * Parses one calculation into the tax parts and their cited sources.
+ *
+ * A state or local layer is null when the calculation does not include it.
+ * The parser refuses a missing federal bracket list, a negative amount, or a
+ * source block without the document URL, so a changed response cannot quietly
+ * produce a figure with no provenance.
+ *
+ * @param payload - the JSON body from the calculation endpoint
+ * @returns the calculation in the adapter's shape
+ */
+export function parseEstimateTaxCalculation(payload) {
+    const parsed = ESTIMATETAX_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(ESTIMATETAX_INCOME_TAX_SOURCE_ID, parsed.error.message);
+    }
+    const value = parsed.data;
+    return {
+        taxYear: value.taxYear,
+        input: {
+            income: value.input.income,
+            filingStatus: value.input.filingStatus,
+            state: value.input.state ?? null,
+            city: value.input.city ?? null,
+            preTaxDeductions: value.input.preTaxDeductions ?? 0,
+            selfEmploymentIncome: value.input.selfEmploymentIncome ?? 0,
+        },
+        federal: {
+            incomeTax: value.federal.incomeTax,
+            totalFica: value.federal.totalFica,
+            marginalRate: value.federal.marginalRate,
+            brackets: value.federal.brackets.map((bracket) => ({
+                rate: bracket.rate,
+                taxableIncome: bracket.taxableInBracket,
+                tax: bracket.tax,
+            })),
+        },
+        state: value.state === null || value.state === undefined
+            ? null
+            : {
+                code: value.state.code,
+                name: value.state.name,
+                tax: value.state.tax,
+                system: value.state.system,
+            },
+        local: value.local === null || value.local === undefined
+            ? null
+            : {
+                jurisdiction: value.local.jurisdiction,
+                tax: value.local.tax,
+                rate: value.local.rate,
+                base: value.local.base,
+            },
+        totals: {
+            totalTax: value.totals.totalTax,
+            netIncome: value.totals.netIncome,
+            effectiveRate: value.totals.effectiveRate,
+            effectiveIncomeTaxRate: value.totals.effectiveIncomeTaxRate,
+        },
+        sources: {
+            federal: readEstimateTaxSource(value.sources.federal),
+            state: value.sources.state === null || value.sources.state === undefined
+                ? null
+                : readEstimateTaxSource(value.sources.state),
+            local: value.sources.local === null || value.sources.local === undefined
+                ? null
+                : readEstimateTaxSource(value.sources.local),
+        },
+    };
+}
+/**
+ * Reads one US income tax calculation.
+ *
+ * One keyless request answers the federal, state, and local layers together.
+ * Every layer carries the official document its figures came from.
+ *
+ * @param options - the calculation query and an optional fetch stub
+ * @returns the calculation in the adapter's shape
+ */
+export async function fetchEstimateTaxCalculation(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildEstimateTaxUrl(options?.query ?? ESTIMATETAX_DEFAULT_QUERY);
+    const response = await httpGet(ESTIMATETAX_INCOME_TAX_SOURCE_ID, url, { fetchImpl });
+    return parseEstimateTaxCalculation(await response.json());
+}
+/** EstimateTax US federal, state, and local income tax, keyless. */
+export const estimatetaxIncomeTaxAdapter = {
+    id: ESTIMATETAX_INCOME_TAX_SOURCE_ID,
+    name: 'EstimateTax US income tax',
+    auth: 'none',
+    description: 'US federal, state, and local income tax for one salary, with the official document behind every figure.',
+    fetchLive: async (options) => fetchEstimateTaxCalculation(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseEstimateTaxCalculation(payload),
+    loadFixture: () => parseEstimateTaxCalculation(readFixtureJson(ESTIMATETAX_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=estimatetaxIncomeTax.js.map

package/dist/estimatetaxIncomeTax.js.map

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