townshipamerica 2.0.0 → 2.1.0

package/README.md

@@ -198,7 +198,7 @@ const fc = await client.raw("NW 25 24N 1E 6th Meridian");
 
 Energy parcel report for a PLSS section — state-regulator wells, operators,
 BLM federal leases, ONRR county royalties, orphaned wells, pipelines,
-FracFocus disclosures, and development constraints.
+FracFocus disclosures, development constraints, and renewable siting.
 
 ```typescript
 const report = await client.energyReport("25 24N 1E 6th Meridian");
@@ -217,12 +217,46 @@ const withGeometry = await client.energyReport("25 24N 1E 6th Meridian", {
 ```
 
 **Options:** `include` — any of `wells`, `operators`, `leases`, `royalties`,
-`orphaned_wells`, `pipelines`, `fracfocus`, `constraints`, `geometry`.
+`orphaned_wells`, `pipelines`, `fracfocus`, `constraints`, `renewables`,
+`geometry`.
 
 **Returns:** `EnergyReport`. Array sections are
 `{total, returned, truncated, more, rows}` envelopes; a failed section lands
 in `meta.unavailable` instead of failing the report.
 
+#### Renewable siting (`include: ["renewables"]`)
+
+```typescript
+const siting = await client.energyReport("25 24N 1E 6th Meridian", {
+  include: ["renewables"]
+});
+const r = siting.renewables;
+console.log(siting.summary.nearest_transmission_100kv_plus_miles);
+console.log(r?.grid?.nearest_substation_230kv_plus?.distance_miles);
+console.log(r?.nrel?.find((c) => c.technology === "solar")?.lcoe_all_in_usd_per_mwh);
+console.log(r?.interconnection_queue?.active_requests);
+
+// Each part fails on its own: it is null and listed in meta.unavailable
+const failed = siting.meta.unavailable.filter((u) => u.section.startsWith("renewables."));
+```
+
+`renewables` has nine parts — `grid`, `projects`, `nrel`,
+`lesser_prairie_chicken`, `aviation`, `blm`, `obstacles`, `whooping_crane`,
+`interconnection_queue` — and any of them may be `null` (a failed part is
+listed in `meta.unavailable` as `{section: "renewables.<part>", reason}`).
+`summary` gains `nearest_transmission_100kv_plus_miles` and
+`nearest_substation_230kv_plus_miles`.
+
+- Substations are **inferred** from ORNL/HIFLD transmission-line endpoints
+  (no open federal substation layer exists); every substation row carries
+  `inferred: true`.
+- NREL supply-curve values describe the surrounding 11.5 km cell, not the
+  section itself. NREL (`nrel`) and LBNL Queued Up (`interconnection_queue`)
+  values are licensed CC-BY 4.0; attribute them when you redistribute.
+- The interconnection queue is county-level (`scope: "county"`).
+- Lesser prairie-chicken habitat is the WAFWA range-wide plan, not ESA
+  critical habitat.
+
 ---
 
 ### `client.federalLandReport(legalLocation, options?)`
@@ -364,6 +398,17 @@ try {
 }
 ```
 
+## What's new in v2.1.0
+
+- `energyReport` accepts `include: ["renewables"]` and types the new
+  `renewables` section (`EnergyRenewables` and its part types: grid
+  proximity with inferred substations, EIA-860M generators, USPVDB
+  footprints, USGS turbines, NREL 2024 supply-curve cells, lesser
+  prairie-chicken habitat, FAA aviation and obstacles, BLM designations
+  and ROW cases, whooping crane corridor, LBNL interconnection queue).
+- `EnergySummary` gains `nearest_transmission_100kv_plus_miles` and
+  `nearest_substation_230kv_plus_miles`.
+
 ## What's new in v2.0.0
 
 v2.0.0 adds the parcel-report APIs:

package/dist/index.cjs

@@ -117,7 +117,7 @@ var TownshipClient = class {
         ...init,
         headers: {
           "X-API-Key": this.apiKey,
-          "User-Agent": "townshipamerica-js/2.0.0",
+          "User-Agent": "townshipamerica-js/2.1.0",
           ...init?.headers ?? {}
         },
         signal: controller.signal
@@ -337,7 +337,9 @@ var TownshipClient = class {
   /**
    * Get the energy parcel report for a PLSS section. Covers state-regulator
    * wells, operators, federal leases, county royalties, orphaned wells,
-   * pipelines, FracFocus disclosures, and development constraints.
+   * pipelines, FracFocus disclosures, development constraints, and
+   * renewable siting (grid proximity, generators, NREL supply curve,
+   * wildlife, aviation, BLM designations, obstacles, interconnection queue).
    *
    * @param legalLocation - A PLSS legal description, e.g. "NW 25 24N 1E 6th Meridian"
    * @param options - Optional section projection (`include`)
@@ -353,6 +355,12 @@ var TownshipClient = class {
    * const slim = await client.energyReport('25 24N 1E 6th Meridian', {
    *   include: ['wells', 'pipelines']
    * })
+   *
+   * // Renewable siting only
+   * const siting = await client.energyReport('25 24N 1E 6th Meridian', {
+   *   include: ['renewables']
+   * })
+   * console.log(siting.renewables?.grid?.nearest_line_100kv_plus?.distance_miles)
    * ```
    */
   async energyReport(legalLocation, options) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export { TownshipClient } from \"./client.js\";\nexport {\n  TownshipError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  ValidationError,\n  PayloadTooLargeError\n} from \"./errors.js\";\nexport type {\n  TownshipClientOptions,\n  GeoJSONPoint,\n  GeoJSONPolygon,\n  GeoJSONMultiPolygon,\n  GeoJSONBoundary,\n  GeoJSONFeature,\n  GeoJSONFeatureCollection,\n  FeatureProperties,\n  Unit,\n  SurveySystem,\n  SearchResult,\n  ReverseOptions,\n  AutocompleteOptions,\n  BatchSearchOptions,\n  BatchReverseOptions,\n  // Shared report types\n  LatLng,\n  EntityRef,\n  SectionEnvelope,\n  UnavailableSection,\n  SectionSource,\n  ReportMeta,\n  ReportParcel,\n  // Energy API\n  EnergyReportSection,\n  EnergyReportOptions,\n  EnergyWellRow,\n  EnergyOrphanedWellRow,\n  EnergyLeaseRow,\n  EnergyOperatorRow,\n  EnergyRoyaltyItem,\n  EnergyRoyalties,\n  EnergyPipelineRow,\n  FracFocusRow,\n  EnergySplitEstateSide,\n  EnergySplitEstate,\n  EnergySageGrouseHabitat,\n  EnergySageGrouse,\n  EnergyRenewableSiting,\n  EnergyConstraints,\n  EnergySummary,\n  EnergyWells,\n  EnergyReport,\n  // Federal Land API\n  FederalLandReportSection,\n  FederalLandReportOptions,\n  SurfaceManagementRow,\n  FederalLeaseRow,\n  RightOfWayRow,\n  FloodZoneRow,\n  MiningClaimRow,\n  WetlandRow,\n  FireshedRow,\n  SoilRow,\n  OrphanedWellRow,\n  CriticalHabitatRow,\n  PublicAccessRow,\n  WildfireRiskRow,\n  CropHistory,\n  Elevation,\n  FederalLandReport,\n  // Texas API\n  TexasReportSection,\n  TexasReportOptions,\n  TexasStateLeaseRow,\n  TexasStateUnitRow,\n  TexasPsfLandRow,\n  TexasStateAgencyLandRow,\n  TexasUplandLeaseRow,\n  TexasActiveWellRow,\n  TexasPipelineRow,\n  TexasPendingPermitRow,\n  TexasCoastalErosionRow,\n  TexasMonthlyVolume,\n  TexasProductionLease,\n  TexasAbstractRef,\n  TexasProductionSummary,\n  TexasProductionBlock,\n  TexasProduction,\n  TexasReport,\n  TexasProductionOptions,\n  TexasWellLocation,\n  TexasWellUnit,\n  TexasWellSeriesPoint,\n  TexasDeclineFit,\n  TexasDecline,\n  TexasDeclineCurvePoint,\n  TexasWellSeriesUnit,\n  TexasWell\n} from \"./types.js\";\n","/**\n * Base error class for all Township SDK errors.\n *\n * `code` carries the machine-readable error code the Energy, Federal Land,\n * and Texas APIs return in v1 error bodies (`{\"error\": {\"code\", \"message\"}}`),\n * e.g. `invalid_parameter`, `missing_parameter`, `plss_not_supported`,\n * `ambiguous_location`, `not_found`, `rate_limit_exceeded`. It is null for\n * endpoints that do not send one.\n */\nexport class TownshipError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number | null = null,\n    public readonly code: string | null = null\n  ) {\n    super(message);\n    this.name = \"TownshipError\";\n  }\n}\n\n/**\n * Thrown when the API key is missing or invalid (HTTP 401).\n */\nexport class AuthenticationError extends TownshipError {\n  constructor(message = \"Invalid or missing API key\", code: string | null = null) {\n    super(message, 401, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/**\n * Thrown when no result is found for the given input.\n */\nexport class NotFoundError extends TownshipError {\n  constructor(message = \"Location not found\", code: string | null = null) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * Thrown when the API rate limit is exceeded (HTTP 429).\n */\nexport class RateLimitError extends TownshipError {\n  constructor(\n    message = \"Rate limit exceeded. Please slow down your requests.\",\n    code: string | null = null\n  ) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n  }\n}\n\n/**\n * Thrown when the request is malformed (HTTP 400).\n */\nexport class ValidationError extends TownshipError {\n  constructor(message = \"Invalid request\", code: string | null = null) {\n    super(message, 400, code);\n    this.name = \"ValidationError\";\n  }\n}\n\n/**\n * Thrown when the batch payload exceeds the maximum size (HTTP 413).\n */\nexport class PayloadTooLargeError extends TownshipError {\n  constructor(\n    message = \"Batch payload exceeds the maximum of 100 records per request\",\n    code: string | null = null\n  ) {\n    super(message, 413, code);\n    this.name = \"PayloadTooLargeError\";\n  }\n}\n","import {\n  AuthenticationError,\n  NotFoundError,\n  PayloadTooLargeError,\n  RateLimitError,\n  TownshipError,\n  ValidationError\n} from \"./errors.js\";\nimport type {\n  AutocompleteOptions,\n  BatchReverseOptions,\n  BatchSearchOptions,\n  EnergyReport,\n  EnergyReportOptions,\n  FederalLandReport,\n  FederalLandReportOptions,\n  GeoJSONBoundary,\n  GeoJSONFeatureCollection,\n  ReverseOptions,\n  SearchResult,\n  TexasProduction,\n  TexasProductionOptions,\n  TexasReport,\n  TexasReportOptions,\n  TexasWell,\n  TownshipClientOptions\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://developer.townshipamerica.com\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst MAX_BATCH_SIZE = 100;\n\nfunction toSearchResult(fc: GeoJSONFeatureCollection): SearchResult {\n  const centroid = fc.features.find((f) => f.properties.shape === \"centroid\");\n  const grid = fc.features.find((f) => f.properties.shape === \"grid\");\n\n  const props = centroid?.properties ?? grid?.properties;\n  if (!props) {\n    throw new TownshipError(\"Unexpected API response: no features returned\");\n  }\n\n  const [lng, lat] = centroid ? (centroid.geometry.coordinates as [number, number]) : [0, 0];\n\n  return {\n    legalLocation: props.legal_location,\n    latitude: lat,\n    longitude: lng,\n    state: props.state,\n    county: props.county,\n    unit: props.unit,\n    surveySystem: props.survey_system,\n    alternateLegalLocation: props.alternate_legal_location,\n    boundary: grid ? (grid.geometry as GeoJSONBoundary) : null,\n    raw: fc\n  };\n}\n\nexport class TownshipClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeout: number;\n\n  constructor(options: TownshipClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n\n    if (!this.apiKey) {\n      throw new TownshipError(\"apiKey is required\");\n    }\n  }\n\n  // --- Internal ---\n\n  private async request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers: {\n          \"X-API-Key\": this.apiKey,\n          \"User-Agent\": \"townshipamerica-js/2.0.0\",\n          ...(init?.headers ?? {})\n        },\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        await this.handleError(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof TownshipError) throw error;\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new TownshipError(\"Request timed out\");\n      }\n      throw new TownshipError(error instanceof Error ? error.message : \"Unknown error\");\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async handleError(response: Response): Promise<never> {\n    let message: string;\n    let code: string | null = null;\n    try {\n      const body = (await response.json()) as {\n        error?: { code?: string; message?: string } | string;\n        message?: string;\n      };\n      // Energy/Federal Land/Texas v1 error bodies are {\"error\": {\"code\", \"message\"}}\n      if (body.error && typeof body.error === \"object\") {\n        message = body.error.message ?? response.statusText;\n        code = body.error.code ?? null;\n      } else {\n        message =\n          (typeof body.error === \"string\" ? body.error : undefined) ??\n          body.message ??\n          response.statusText;\n      }\n    } catch {\n      message = response.statusText;\n    }\n\n    const status = response.status;\n    if (status === 400) throw new ValidationError(message, code);\n    if (status === 401) throw new AuthenticationError(message, code);\n    if (status === 404) throw new NotFoundError(message, code);\n    if (status === 413) throw new PayloadTooLargeError(message, code);\n    if (status === 429) throw new RateLimitError(message, code);\n    throw new TownshipError(message, status, code);\n  }\n\n  // --- Search ---\n\n  /**\n   * Convert a PLSS or Texas TXSS legal land description to GPS coordinates.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\" or \"A-175 Reeves County\"\n   * @returns A SearchResult with coordinates, boundary, and metadata.\n   * @throws {ValidationError} If the location string is invalid.\n   * @throws {NotFoundError} If no match is found.\n   */\n  async search(legalLocation: string): Promise<SearchResult> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for \"${legalLocation}\"`);\n    }\n\n    return toSearchResult(data as GeoJSONFeatureCollection);\n  }\n\n  /**\n   * Find the legal land description at the given GPS coordinates (PLSS or Texas TXSS).\n   *\n   * @param longitude - Longitude (x) coordinate.\n   * @param latitude - Latitude (y) coordinate.\n   * @param options - Optional PLSS unit filter (ignored for TXSS results).\n   * @returns A SearchResult or array of SearchResults (when unit is 'all').\n   */\n  async reverse(\n    longitude: number,\n    latitude: number,\n    options?: ReverseOptions\n  ): Promise<SearchResult | SearchResult[]> {\n    const params = new URLSearchParams({\n      location: `${longitude},${latitude}`\n    });\n    if (options?.unit) {\n      params.set(\"unit\", options.unit);\n    }\n\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/coordinates?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for coordinates [${longitude}, ${latitude}]`);\n    }\n\n    const fc = data as GeoJSONFeatureCollection;\n\n    if (options?.unit === \"all\") {\n      const groups = new Map<string, typeof fc.features>();\n      for (const feature of fc.features) {\n        const key = feature.properties.legal_location;\n        if (!groups.has(key)) groups.set(key, []);\n        groups.get(key)!.push(feature);\n      }\n\n      return Array.from(groups.values()).map((features) => {\n        return toSearchResult({ type: \"FeatureCollection\", features });\n      });\n    }\n\n    return toSearchResult(fc);\n  }\n\n  // --- Autocomplete ---\n\n  /**\n   * Get autocomplete suggestions for a partial PLSS or Texas TXSS description.\n   *\n   * @param query - Partial search query (minimum 2 characters).\n   * @param options - Optional limit (1–10, default 3) and proximity.\n   * @returns Raw GeoJSON FeatureCollection with suggestion features.\n   */\n  async autocomplete(\n    query: string,\n    options?: AutocompleteOptions\n  ): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: query });\n    if (options?.limit != null) {\n      params.set(\"limit\", String(options.limit));\n    }\n    if (options?.proximity) {\n      params.set(\"proximity\", `${options.proximity[0]},${options.proximity[1]}`);\n    }\n\n    return this.request<GeoJSONFeatureCollection>(`/autocomplete/legal-location?${params}`);\n  }\n\n  // --- Batch ---\n\n  /**\n   * Convert multiple legal land descriptions to GPS coordinates in one request.\n   * Auto-chunks if more than 100 items. Mix PLSS and Texas TXSS inputs freely.\n   *\n   * @param locations - Array of legal land descriptions.\n   * @param options - Optional chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchSearch(\n    locations: string[],\n    options?: BatchSearchOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < locations.length; i += chunkSize) {\n      const chunk = locations.slice(i, i + chunkSize);\n      const data = await this.request<(GeoJSONFeatureCollection | null)[]>(\n        \"/batch/legal-location\",\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(chunk)\n        }\n      );\n\n      for (const fc of data) {\n        if (!fc || !fc.features?.length) {\n          results.push(null);\n        } else {\n          results.push(toSearchResult(fc));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Find legal land descriptions for multiple coordinate pairs in one request.\n   * Auto-chunks if more than 100 items.\n   *\n   * @param coordinates - Array of [longitude, latitude] pairs.\n   * @param options - Optional PLSS unit filter and chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchReverse(\n    coordinates: [number, number][],\n    options?: BatchReverseOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < coordinates.length; i += chunkSize) {\n      const chunk = coordinates.slice(i, i + chunkSize);\n      const body: Record<string, unknown> = { coordinates: chunk };\n      if (options?.unit) {\n        body.unit = options.unit;\n      }\n\n      const data = await this.request<\n        (GeoJSONFeatureCollection | null)[] | GeoJSONFeatureCollection\n      >(\"/batch/coordinates\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body)\n      });\n\n      if (Array.isArray(data)) {\n        for (const fc of data) {\n          if (!fc || !fc.features?.length) {\n            results.push(null);\n          } else {\n            results.push(toSearchResult(fc));\n          }\n        }\n      } else if (data && \"features\" in data) {\n        // unit=all returns a single FeatureCollection — split by legal_location\n        const groups = new Map<string, typeof data.features>();\n        for (const feature of data.features) {\n          const key = JSON.stringify(feature.properties.search_term);\n          if (!groups.has(key)) groups.set(key, []);\n          groups.get(key)!.push(feature);\n        }\n        for (const features of groups.values()) {\n          results.push(toSearchResult({ type: \"FeatureCollection\", features }));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  // --- Convenience ---\n\n  /**\n   * Get the boundary polygon for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The boundary GeoJSON Polygon, or null if not found.\n   */\n  async boundary(legalLocation: string): Promise<GeoJSONBoundary | null> {\n    const result = await this.search(legalLocation);\n    return result.boundary;\n  }\n\n  /**\n   * Get the raw GeoJSON FeatureCollection for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The raw GeoJSON FeatureCollection from the API.\n   */\n  async raw(legalLocation: string): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data)) {\n      return { type: \"FeatureCollection\", features: [] };\n    }\n\n    return data as GeoJSONFeatureCollection;\n  }\n\n  // --- Energy API ---\n\n  /**\n   * Get the energy parcel report for a PLSS section. Covers state-regulator\n   * wells, operators, federal leases, county royalties, orphaned wells,\n   * pipelines, FracFocus disclosures, and development constraints.\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The energy report\n   *\n   * @example\n   * ```ts\n   * const report = await client.energyReport('25 24N 1E 6th Meridian')\n   * console.log(report.summary.wells_in_section)\n   * console.log(report.wells?.in_section.rows[0]?.api_number)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.energyReport('25 24N 1E 6th Meridian', {\n   *   include: ['wells', 'pipelines']\n   * })\n   * ```\n   */\n  async energyReport(legalLocation: string, options?: EnergyReportOptions): Promise<EnergyReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<EnergyReport>(`/energy/report?${params}`);\n  }\n\n  // --- Federal Land API ---\n\n  /**\n   * Get the federal-land parcel report for a PLSS tract. Covers surface\n   * management, BLM leases and rights-of-way, flood zones, mining claims,\n   * wetlands, firesheds, soils, crop history, orphaned wells, critical\n   * habitat, public access, wildfire risk, and elevation.\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The federal-land report\n   *\n   * @example\n   * ```ts\n   * const report = await client.federalLandReport('NW 25 24N 1E 6th Meridian')\n   * console.log(report.surface_management?.rows[0]?.agency)\n   *\n   * // Only the sections you need — the pruned layers' queries never run\n   * const slim = await client.federalLandReport('NW 25 24N 1E 6th Meridian', {\n   *   include: ['og_leases', 'flood_zones']\n   * })\n   * ```\n   */\n  async federalLandReport(\n    legalLocation: string,\n    options?: FederalLandReportOptions\n  ): Promise<FederalLandReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<FederalLandReport>(`/federal-land/report?${params}`);\n  }\n\n  // --- Texas API ---\n\n  /**\n   * Get the Texas abstract report for a TXSS legal description. Covers GLO\n   * state leases and units, PSF lands, RRC wells and pipelines, pending\n   * permits, coastal erosion, federal overlays, and RRC lease production.\n   *\n   * @param legalLocation - A Texas legal description, e.g. \"A-175 Reeves County\"\n   * @param options - Optional section projection (`include`)\n   * @returns The Texas report\n   *\n   * @example\n   * ```ts\n   * const report = await client.texasReport('A-175 Reeves County')\n   * console.log(report.active_wells?.rows[0]?.api_number)\n   * console.log(report.production?.summary.total_cum_boe)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.texasReport('A-175 Reeves County', {\n   *   include: ['state_leases', 'production']\n   * })\n   * ```\n   */\n  async texasReport(legalLocation: string, options?: TexasReportOptions): Promise<TexasReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<TexasReport>(`/texas/report?${params}`);\n  }\n\n  /**\n   * Get RRC lease production for a Texas abstract — per-lease lifetime\n   * totals, trailing-12-month volumes, and the 60-month monthly series.\n   * Production is reported by RRC at the LEASE level: rows are the leases\n   * whose wells fall on the abstract, never sub-allocated to the tract.\n   *\n   * @param options - Either `{legalLocation}` or `{countyFips, abstractNo, blockNo?}`\n   * @returns The abstract production rollup\n   *\n   * @example\n   * ```ts\n   * const byLocation = await client.texasProduction({ legalLocation: 'A-175 Reeves County' })\n   * const byKeys = await client.texasProduction({ countyFips: '48389', abstractNo: '175' })\n   * console.log(byKeys.summary.total_cum_boe)\n   * ```\n   */\n  async texasProduction(options: TexasProductionOptions): Promise<TexasProduction> {\n    const params = new URLSearchParams();\n    if (options.legalLocation != null) {\n      params.set(\"legal_location\", options.legalLocation);\n    } else if (options.countyFips != null && options.abstractNo != null) {\n      params.set(\"county_fips\", options.countyFips);\n      params.set(\"abstract_no\", options.abstractNo);\n      if (options.blockNo != null) params.set(\"block_no\", options.blockNo);\n    } else {\n      throw new TownshipError(\n        \"texasProduction requires either legalLocation or countyFips + abstractNo\"\n      );\n    }\n    return this.request<TexasProduction>(`/texas/production?${params}`);\n  }\n\n  /**\n   * Get per-well allocated production for a Texas well by API number —\n   * summary scalars for every lease edge, the monthly series (when\n   * provisioned), and an Arps decline fit. Volumes are allocated estimates:\n   * RRC reports production by lease, never by well.\n   *\n   * @param api - API-8 or API-14 number (e.g. \"42-389-32345\" or \"42389323450000\")\n   * @returns The well's units, series, and decline analysis\n   *\n   * @example\n   * ```ts\n   * const well = await client.texasWell('42-389-32345')\n   * console.log(well.units[0]?.cum_boe)\n   * console.log(well.decline.available && well.decline.value?.di)\n   * ```\n   */\n  async texasWell(api: string): Promise<TexasWell> {\n    return this.request<TexasWell>(`/texas/wells/${encodeURIComponent(api)}`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export { TownshipClient } from \"./client.js\";\nexport {\n  TownshipError,\n  AuthenticationError,\n  NotFoundError,\n  RateLimitError,\n  ValidationError,\n  PayloadTooLargeError\n} from \"./errors.js\";\nexport type {\n  TownshipClientOptions,\n  GeoJSONPoint,\n  GeoJSONPolygon,\n  GeoJSONMultiPolygon,\n  GeoJSONBoundary,\n  GeoJSONFeature,\n  GeoJSONFeatureCollection,\n  FeatureProperties,\n  Unit,\n  SurveySystem,\n  SearchResult,\n  ReverseOptions,\n  AutocompleteOptions,\n  BatchSearchOptions,\n  BatchReverseOptions,\n  // Shared report types\n  LatLng,\n  EntityRef,\n  SectionEnvelope,\n  UnavailableSection,\n  SectionSource,\n  ReportMeta,\n  ReportParcel,\n  // Energy API\n  EnergyReportSection,\n  EnergyReportOptions,\n  EnergyWellRow,\n  EnergyOrphanedWellRow,\n  EnergyLeaseRow,\n  EnergyOperatorRow,\n  EnergyRoyaltyItem,\n  EnergyRoyalties,\n  EnergyPipelineRow,\n  FracFocusRow,\n  EnergySplitEstateSide,\n  EnergySplitEstate,\n  EnergySageGrouseHabitat,\n  EnergySageGrouse,\n  EnergyRenewableSiting,\n  EnergyConstraints,\n  EnergyTransmissionLine,\n  EnergyInferredSubstation,\n  EnergyRenewablesGrid,\n  EnergyGeneratorGroup,\n  EnergyGeneratorTotals,\n  EnergyPlant,\n  EnergyPvFootprint,\n  EnergyWindTurbines,\n  EnergyRenewablesProjects,\n  EnergyNrelCell,\n  EnergyLpcCategory,\n  EnergyLesserPrairieChicken,\n  EnergyAltitude,\n  EnergyMilitaryTrainingRoute,\n  EnergySpecialUseAirspace,\n  EnergyRenewablesAviation,\n  EnergySolarEnergyZone,\n  EnergySection368Corridor,\n  EnergyRenewableRowCase,\n  EnergyRenewablesBlm,\n  EnergyObstacleGroup,\n  EnergyTallestObstacle,\n  EnergyObstacles,\n  EnergyWhoopingCrane,\n  EnergyQueueProject,\n  EnergyInterconnectionQueue,\n  EnergyRenewables,\n  EnergySummary,\n  EnergyWells,\n  EnergyReport,\n  // Federal Land API\n  FederalLandReportSection,\n  FederalLandReportOptions,\n  SurfaceManagementRow,\n  FederalLeaseRow,\n  RightOfWayRow,\n  FloodZoneRow,\n  MiningClaimRow,\n  WetlandRow,\n  FireshedRow,\n  SoilRow,\n  OrphanedWellRow,\n  CriticalHabitatRow,\n  PublicAccessRow,\n  WildfireRiskRow,\n  CropHistory,\n  Elevation,\n  FederalLandReport,\n  // Texas API\n  TexasReportSection,\n  TexasReportOptions,\n  TexasStateLeaseRow,\n  TexasStateUnitRow,\n  TexasPsfLandRow,\n  TexasStateAgencyLandRow,\n  TexasUplandLeaseRow,\n  TexasActiveWellRow,\n  TexasPipelineRow,\n  TexasPendingPermitRow,\n  TexasCoastalErosionRow,\n  TexasMonthlyVolume,\n  TexasProductionLease,\n  TexasAbstractRef,\n  TexasProductionSummary,\n  TexasProductionBlock,\n  TexasProduction,\n  TexasReport,\n  TexasProductionOptions,\n  TexasWellLocation,\n  TexasWellUnit,\n  TexasWellSeriesPoint,\n  TexasDeclineFit,\n  TexasDecline,\n  TexasDeclineCurvePoint,\n  TexasWellSeriesUnit,\n  TexasWell\n} from \"./types.js\";\n","/**\n * Base error class for all Township SDK errors.\n *\n * `code` carries the machine-readable error code the Energy, Federal Land,\n * and Texas APIs return in v1 error bodies (`{\"error\": {\"code\", \"message\"}}`),\n * e.g. `invalid_parameter`, `missing_parameter`, `plss_not_supported`,\n * `ambiguous_location`, `not_found`, `rate_limit_exceeded`. It is null for\n * endpoints that do not send one.\n */\nexport class TownshipError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number | null = null,\n    public readonly code: string | null = null\n  ) {\n    super(message);\n    this.name = \"TownshipError\";\n  }\n}\n\n/**\n * Thrown when the API key is missing or invalid (HTTP 401).\n */\nexport class AuthenticationError extends TownshipError {\n  constructor(message = \"Invalid or missing API key\", code: string | null = null) {\n    super(message, 401, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/**\n * Thrown when no result is found for the given input.\n */\nexport class NotFoundError extends TownshipError {\n  constructor(message = \"Location not found\", code: string | null = null) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * Thrown when the API rate limit is exceeded (HTTP 429).\n */\nexport class RateLimitError extends TownshipError {\n  constructor(\n    message = \"Rate limit exceeded. Please slow down your requests.\",\n    code: string | null = null\n  ) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n  }\n}\n\n/**\n * Thrown when the request is malformed (HTTP 400).\n */\nexport class ValidationError extends TownshipError {\n  constructor(message = \"Invalid request\", code: string | null = null) {\n    super(message, 400, code);\n    this.name = \"ValidationError\";\n  }\n}\n\n/**\n * Thrown when the batch payload exceeds the maximum size (HTTP 413).\n */\nexport class PayloadTooLargeError extends TownshipError {\n  constructor(\n    message = \"Batch payload exceeds the maximum of 100 records per request\",\n    code: string | null = null\n  ) {\n    super(message, 413, code);\n    this.name = \"PayloadTooLargeError\";\n  }\n}\n","import {\n  AuthenticationError,\n  NotFoundError,\n  PayloadTooLargeError,\n  RateLimitError,\n  TownshipError,\n  ValidationError\n} from \"./errors.js\";\nimport type {\n  AutocompleteOptions,\n  BatchReverseOptions,\n  BatchSearchOptions,\n  EnergyReport,\n  EnergyReportOptions,\n  FederalLandReport,\n  FederalLandReportOptions,\n  GeoJSONBoundary,\n  GeoJSONFeatureCollection,\n  ReverseOptions,\n  SearchResult,\n  TexasProduction,\n  TexasProductionOptions,\n  TexasReport,\n  TexasReportOptions,\n  TexasWell,\n  TownshipClientOptions\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://developer.townshipamerica.com\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst MAX_BATCH_SIZE = 100;\n\nfunction toSearchResult(fc: GeoJSONFeatureCollection): SearchResult {\n  const centroid = fc.features.find((f) => f.properties.shape === \"centroid\");\n  const grid = fc.features.find((f) => f.properties.shape === \"grid\");\n\n  const props = centroid?.properties ?? grid?.properties;\n  if (!props) {\n    throw new TownshipError(\"Unexpected API response: no features returned\");\n  }\n\n  const [lng, lat] = centroid ? (centroid.geometry.coordinates as [number, number]) : [0, 0];\n\n  return {\n    legalLocation: props.legal_location,\n    latitude: lat,\n    longitude: lng,\n    state: props.state,\n    county: props.county,\n    unit: props.unit,\n    surveySystem: props.survey_system,\n    alternateLegalLocation: props.alternate_legal_location,\n    boundary: grid ? (grid.geometry as GeoJSONBoundary) : null,\n    raw: fc\n  };\n}\n\nexport class TownshipClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeout: number;\n\n  constructor(options: TownshipClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n\n    if (!this.apiKey) {\n      throw new TownshipError(\"apiKey is required\");\n    }\n  }\n\n  // --- Internal ---\n\n  private async request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers: {\n          \"X-API-Key\": this.apiKey,\n          \"User-Agent\": \"townshipamerica-js/2.1.0\",\n          ...(init?.headers ?? {})\n        },\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        await this.handleError(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof TownshipError) throw error;\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new TownshipError(\"Request timed out\");\n      }\n      throw new TownshipError(error instanceof Error ? error.message : \"Unknown error\");\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async handleError(response: Response): Promise<never> {\n    let message: string;\n    let code: string | null = null;\n    try {\n      const body = (await response.json()) as {\n        error?: { code?: string; message?: string } | string;\n        message?: string;\n      };\n      // Energy/Federal Land/Texas v1 error bodies are {\"error\": {\"code\", \"message\"}}\n      if (body.error && typeof body.error === \"object\") {\n        message = body.error.message ?? response.statusText;\n        code = body.error.code ?? null;\n      } else {\n        message =\n          (typeof body.error === \"string\" ? body.error : undefined) ??\n          body.message ??\n          response.statusText;\n      }\n    } catch {\n      message = response.statusText;\n    }\n\n    const status = response.status;\n    if (status === 400) throw new ValidationError(message, code);\n    if (status === 401) throw new AuthenticationError(message, code);\n    if (status === 404) throw new NotFoundError(message, code);\n    if (status === 413) throw new PayloadTooLargeError(message, code);\n    if (status === 429) throw new RateLimitError(message, code);\n    throw new TownshipError(message, status, code);\n  }\n\n  // --- Search ---\n\n  /**\n   * Convert a PLSS or Texas TXSS legal land description to GPS coordinates.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\" or \"A-175 Reeves County\"\n   * @returns A SearchResult with coordinates, boundary, and metadata.\n   * @throws {ValidationError} If the location string is invalid.\n   * @throws {NotFoundError} If no match is found.\n   */\n  async search(legalLocation: string): Promise<SearchResult> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for \"${legalLocation}\"`);\n    }\n\n    return toSearchResult(data as GeoJSONFeatureCollection);\n  }\n\n  /**\n   * Find the legal land description at the given GPS coordinates (PLSS or Texas TXSS).\n   *\n   * @param longitude - Longitude (x) coordinate.\n   * @param latitude - Latitude (y) coordinate.\n   * @param options - Optional PLSS unit filter (ignored for TXSS results).\n   * @returns A SearchResult or array of SearchResults (when unit is 'all').\n   */\n  async reverse(\n    longitude: number,\n    latitude: number,\n    options?: ReverseOptions\n  ): Promise<SearchResult | SearchResult[]> {\n    const params = new URLSearchParams({\n      location: `${longitude},${latitude}`\n    });\n    if (options?.unit) {\n      params.set(\"unit\", options.unit);\n    }\n\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/coordinates?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for coordinates [${longitude}, ${latitude}]`);\n    }\n\n    const fc = data as GeoJSONFeatureCollection;\n\n    if (options?.unit === \"all\") {\n      const groups = new Map<string, typeof fc.features>();\n      for (const feature of fc.features) {\n        const key = feature.properties.legal_location;\n        if (!groups.has(key)) groups.set(key, []);\n        groups.get(key)!.push(feature);\n      }\n\n      return Array.from(groups.values()).map((features) => {\n        return toSearchResult({ type: \"FeatureCollection\", features });\n      });\n    }\n\n    return toSearchResult(fc);\n  }\n\n  // --- Autocomplete ---\n\n  /**\n   * Get autocomplete suggestions for a partial PLSS or Texas TXSS description.\n   *\n   * @param query - Partial search query (minimum 2 characters).\n   * @param options - Optional limit (1–10, default 3) and proximity.\n   * @returns Raw GeoJSON FeatureCollection with suggestion features.\n   */\n  async autocomplete(\n    query: string,\n    options?: AutocompleteOptions\n  ): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: query });\n    if (options?.limit != null) {\n      params.set(\"limit\", String(options.limit));\n    }\n    if (options?.proximity) {\n      params.set(\"proximity\", `${options.proximity[0]},${options.proximity[1]}`);\n    }\n\n    return this.request<GeoJSONFeatureCollection>(`/autocomplete/legal-location?${params}`);\n  }\n\n  // --- Batch ---\n\n  /**\n   * Convert multiple legal land descriptions to GPS coordinates in one request.\n   * Auto-chunks if more than 100 items. Mix PLSS and Texas TXSS inputs freely.\n   *\n   * @param locations - Array of legal land descriptions.\n   * @param options - Optional chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchSearch(\n    locations: string[],\n    options?: BatchSearchOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < locations.length; i += chunkSize) {\n      const chunk = locations.slice(i, i + chunkSize);\n      const data = await this.request<(GeoJSONFeatureCollection | null)[]>(\n        \"/batch/legal-location\",\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(chunk)\n        }\n      );\n\n      for (const fc of data) {\n        if (!fc || !fc.features?.length) {\n          results.push(null);\n        } else {\n          results.push(toSearchResult(fc));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Find legal land descriptions for multiple coordinate pairs in one request.\n   * Auto-chunks if more than 100 items.\n   *\n   * @param coordinates - Array of [longitude, latitude] pairs.\n   * @param options - Optional PLSS unit filter and chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchReverse(\n    coordinates: [number, number][],\n    options?: BatchReverseOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < coordinates.length; i += chunkSize) {\n      const chunk = coordinates.slice(i, i + chunkSize);\n      const body: Record<string, unknown> = { coordinates: chunk };\n      if (options?.unit) {\n        body.unit = options.unit;\n      }\n\n      const data = await this.request<\n        (GeoJSONFeatureCollection | null)[] | GeoJSONFeatureCollection\n      >(\"/batch/coordinates\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body)\n      });\n\n      if (Array.isArray(data)) {\n        for (const fc of data) {\n          if (!fc || !fc.features?.length) {\n            results.push(null);\n          } else {\n            results.push(toSearchResult(fc));\n          }\n        }\n      } else if (data && \"features\" in data) {\n        // unit=all returns a single FeatureCollection — split by legal_location\n        const groups = new Map<string, typeof data.features>();\n        for (const feature of data.features) {\n          const key = JSON.stringify(feature.properties.search_term);\n          if (!groups.has(key)) groups.set(key, []);\n          groups.get(key)!.push(feature);\n        }\n        for (const features of groups.values()) {\n          results.push(toSearchResult({ type: \"FeatureCollection\", features }));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  // --- Convenience ---\n\n  /**\n   * Get the boundary polygon for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The boundary GeoJSON Polygon, or null if not found.\n   */\n  async boundary(legalLocation: string): Promise<GeoJSONBoundary | null> {\n    const result = await this.search(legalLocation);\n    return result.boundary;\n  }\n\n  /**\n   * Get the raw GeoJSON FeatureCollection for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The raw GeoJSON FeatureCollection from the API.\n   */\n  async raw(legalLocation: string): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data)) {\n      return { type: \"FeatureCollection\", features: [] };\n    }\n\n    return data as GeoJSONFeatureCollection;\n  }\n\n  // --- Energy API ---\n\n  /**\n   * Get the energy parcel report for a PLSS section. Covers state-regulator\n   * wells, operators, federal leases, county royalties, orphaned wells,\n   * pipelines, FracFocus disclosures, development constraints, and\n   * renewable siting (grid proximity, generators, NREL supply curve,\n   * wildlife, aviation, BLM designations, obstacles, interconnection queue).\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The energy report\n   *\n   * @example\n   * ```ts\n   * const report = await client.energyReport('25 24N 1E 6th Meridian')\n   * console.log(report.summary.wells_in_section)\n   * console.log(report.wells?.in_section.rows[0]?.api_number)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.energyReport('25 24N 1E 6th Meridian', {\n   *   include: ['wells', 'pipelines']\n   * })\n   *\n   * // Renewable siting only\n   * const siting = await client.energyReport('25 24N 1E 6th Meridian', {\n   *   include: ['renewables']\n   * })\n   * console.log(siting.renewables?.grid?.nearest_line_100kv_plus?.distance_miles)\n   * ```\n   */\n  async energyReport(legalLocation: string, options?: EnergyReportOptions): Promise<EnergyReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<EnergyReport>(`/energy/report?${params}`);\n  }\n\n  // --- Federal Land API ---\n\n  /**\n   * Get the federal-land parcel report for a PLSS tract. Covers surface\n   * management, BLM leases and rights-of-way, flood zones, mining claims,\n   * wetlands, firesheds, soils, crop history, orphaned wells, critical\n   * habitat, public access, wildfire risk, and elevation.\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The federal-land report\n   *\n   * @example\n   * ```ts\n   * const report = await client.federalLandReport('NW 25 24N 1E 6th Meridian')\n   * console.log(report.surface_management?.rows[0]?.agency)\n   *\n   * // Only the sections you need — the pruned layers' queries never run\n   * const slim = await client.federalLandReport('NW 25 24N 1E 6th Meridian', {\n   *   include: ['og_leases', 'flood_zones']\n   * })\n   * ```\n   */\n  async federalLandReport(\n    legalLocation: string,\n    options?: FederalLandReportOptions\n  ): Promise<FederalLandReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<FederalLandReport>(`/federal-land/report?${params}`);\n  }\n\n  // --- Texas API ---\n\n  /**\n   * Get the Texas abstract report for a TXSS legal description. Covers GLO\n   * state leases and units, PSF lands, RRC wells and pipelines, pending\n   * permits, coastal erosion, federal overlays, and RRC lease production.\n   *\n   * @param legalLocation - A Texas legal description, e.g. \"A-175 Reeves County\"\n   * @param options - Optional section projection (`include`)\n   * @returns The Texas report\n   *\n   * @example\n   * ```ts\n   * const report = await client.texasReport('A-175 Reeves County')\n   * console.log(report.active_wells?.rows[0]?.api_number)\n   * console.log(report.production?.summary.total_cum_boe)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.texasReport('A-175 Reeves County', {\n   *   include: ['state_leases', 'production']\n   * })\n   * ```\n   */\n  async texasReport(legalLocation: string, options?: TexasReportOptions): Promise<TexasReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<TexasReport>(`/texas/report?${params}`);\n  }\n\n  /**\n   * Get RRC lease production for a Texas abstract — per-lease lifetime\n   * totals, trailing-12-month volumes, and the 60-month monthly series.\n   * Production is reported by RRC at the LEASE level: rows are the leases\n   * whose wells fall on the abstract, never sub-allocated to the tract.\n   *\n   * @param options - Either `{legalLocation}` or `{countyFips, abstractNo, blockNo?}`\n   * @returns The abstract production rollup\n   *\n   * @example\n   * ```ts\n   * const byLocation = await client.texasProduction({ legalLocation: 'A-175 Reeves County' })\n   * const byKeys = await client.texasProduction({ countyFips: '48389', abstractNo: '175' })\n   * console.log(byKeys.summary.total_cum_boe)\n   * ```\n   */\n  async texasProduction(options: TexasProductionOptions): Promise<TexasProduction> {\n    const params = new URLSearchParams();\n    if (options.legalLocation != null) {\n      params.set(\"legal_location\", options.legalLocation);\n    } else if (options.countyFips != null && options.abstractNo != null) {\n      params.set(\"county_fips\", options.countyFips);\n      params.set(\"abstract_no\", options.abstractNo);\n      if (options.blockNo != null) params.set(\"block_no\", options.blockNo);\n    } else {\n      throw new TownshipError(\n        \"texasProduction requires either legalLocation or countyFips + abstractNo\"\n      );\n    }\n    return this.request<TexasProduction>(`/texas/production?${params}`);\n  }\n\n  /**\n   * Get per-well allocated production for a Texas well by API number —\n   * summary scalars for every lease edge, the monthly series (when\n   * provisioned), and an Arps decline fit. Volumes are allocated estimates:\n   * RRC reports production by lease, never by well.\n   *\n   * @param api - API-8 or API-14 number (e.g. \"42-389-32345\" or \"42389323450000\")\n   * @returns The well's units, series, and decline analysis\n   *\n   * @example\n   * ```ts\n   * const well = await client.texasWell('42-389-32345')\n   * console.log(well.units[0]?.cum_boe)\n   * console.log(well.decline.available && well.decline.value?.di)\n   * ```\n   */\n  async texasWell(api: string): Promise<TexasWell> {\n    return this.request<TexasWell>(`/texas/wells/${encodeURIComponent(api)}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSO,IAAM,gBAAN,cAA4B,MAAM;AAAA,EACvC,YACE,SACgB,aAA4B,MAC5B,OAAsB,MACtC;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,sBAAN,cAAkC,cAAc;AAAA,EACrD,YAAY,UAAU,8BAA8B,OAAsB,MAAM;AAC9E,UAAM,SAAS,KAAK,IAAI;AACxB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,gBAAN,cAA4B,cAAc;AAAA,EAC/C,YAAY,UAAU,sBAAsB,OAAsB,MAAM;AACtE,UAAM,SAAS,KAAK,IAAI;AACxB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,iBAAN,cAA6B,cAAc;AAAA,EAChD,YACE,UAAU,wDACV,OAAsB,MACtB;AACA,UAAM,SAAS,KAAK,IAAI;AACxB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,kBAAN,cAA8B,cAAc;AAAA,EACjD,YAAY,UAAU,mBAAmB,OAAsB,MAAM;AACnE,UAAM,SAAS,KAAK,IAAI;AACxB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,uBAAN,cAAmC,cAAc;AAAA,EACtD,YACE,UAAU,gEACV,OAAsB,MACtB;AACA,UAAM,SAAS,KAAK,IAAI;AACxB,SAAK,OAAO;AAAA,EACd;AACF;;;AC9CA,IAAM,mBAAmB;AACzB,IAAM,kBAAkB;AACxB,IAAM,iBAAiB;AAEvB,SAAS,eAAe,IAA4C;AAClE,QAAM,WAAW,GAAG,SAAS,KAAK,CAAC,MAAM,EAAE,WAAW,UAAU,UAAU;AAC1E,QAAM,OAAO,GAAG,SAAS,KAAK,CAAC,MAAM,EAAE,WAAW,UAAU,MAAM;AAElE,QAAM,QAAQ,UAAU,cAAc,MAAM;AAC5C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,cAAc,+CAA+C;AAAA,EACzE;AAEA,QAAM,CAAC,KAAK,GAAG,IAAI,WAAY,SAAS,SAAS,cAAmC,CAAC,GAAG,CAAC;AAEzF,SAAO;AAAA,IACL,eAAe,MAAM;AAAA,IACrB,UAAU;AAAA,IACV,WAAW;AAAA,IACX,OAAO,MAAM;AAAA,IACb,QAAQ,MAAM;AAAA,IACd,MAAM,MAAM;AAAA,IACZ,cAAc,MAAM;AAAA,IACpB,wBAAwB,MAAM;AAAA,IAC9B,UAAU,OAAQ,KAAK,WAA+B;AAAA,IACtD,KAAK;AAAA,EACP;AACF;AAEO,IAAM,iBAAN,MAAqB;AAAA,EACT;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,SAAgC;AAC1C,SAAK,SAAS,QAAQ;AACtB,SAAK,WAAW,QAAQ,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AACvE,SAAK,UAAU,QAAQ,WAAW;AAElC,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,cAAc,oBAAoB;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA,EAIA,MAAc,QAAW,MAAc,MAAgC;AACrE,UAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI;AAClC,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,OAAO;AAE/D,QAAI;AACF,YAAM,WAAW,MAAM,MAAM,KAAK;AAAA,QAChC,GAAG;AAAA,QACH,SAAS;AAAA,UACP,aAAa,KAAK;AAAA,UAClB,cAAc;AAAA,UACd,GAAI,MAAM,WAAW,CAAC;AAAA,QACxB;AAAA,QACA,QAAQ,WAAW;AAAA,MACrB,CAAC;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,KAAK,YAAY,QAAQ;AAAA,MACjC;AAEA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,SAAS,OAAO;AACd,UAAI,iBAAiB,cAAe,OAAM;AAC1C,UAAI,iBAAiB,gBAAgB,MAAM,SAAS,cAAc;AAChE,cAAM,IAAI,cAAc,mBAAmB;AAAA,MAC7C;AACA,YAAM,IAAI,cAAc,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,IAClF,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,MAAc,YAAY,UAAoC;AAC5D,QAAI;AACJ,QAAI,OAAsB;AAC1B,QAAI;AACF,YAAM,OAAQ,MAAM,SAAS,KAAK;AAKlC,UAAI,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AAChD,kBAAU,KAAK,MAAM,WAAW,SAAS;AACzC,eAAO,KAAK,MAAM,QAAQ;AAAA,MAC5B,OAAO;AACL,mBACG,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,WAC/C,KAAK,WACL,SAAS;AAAA,MACb;AAAA,IACF,QAAQ;AACN,gBAAU,SAAS;AAAA,IACrB;AAEA,UAAM,SAAS,SAAS;AACxB,QAAI,WAAW,IAAK,OAAM,IAAI,gBAAgB,SAAS,IAAI;AAC3D,QAAI,WAAW,IAAK,OAAM,IAAI,oBAAoB,SAAS,IAAI;AAC/D,QAAI,WAAW,IAAK,OAAM,IAAI,cAAc,SAAS,IAAI;AACzD,QAAI,WAAW,IAAK,OAAM,IAAI,qBAAqB,SAAS,IAAI;AAChE,QAAI,WAAW,IAAK,OAAM,IAAI,eAAe,SAAS,IAAI;AAC1D,UAAM,IAAI,cAAc,SAAS,QAAQ,IAAI;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,OAAO,eAA8C;AACzD,UAAM,SAAS,IAAI,gBAAgB,EAAE,UAAU,cAAc,CAAC;AAC9D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,0BAA0B,MAAM;AAAA,IAClC;AAEA,QAAI,EAAE,cAAc,SAAS,CAAC,KAAK,UAAU,QAAQ;AACnD,YAAM,IAAI,cAAc,yBAAyB,aAAa,GAAG;AAAA,IACnE;AAEA,WAAO,eAAe,IAAgC;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,QACJ,WACA,UACA,SACwC;AACxC,UAAM,SAAS,IAAI,gBAAgB;AAAA,MACjC,UAAU,GAAG,SAAS,IAAI,QAAQ;AAAA,IACpC,CAAC;AACD,QAAI,SAAS,MAAM;AACjB,aAAO,IAAI,QAAQ,QAAQ,IAAI;AAAA,IACjC;AAEA,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,uBAAuB,MAAM;AAAA,IAC/B;AAEA,QAAI,EAAE,cAAc,SAAS,CAAC,KAAK,UAAU,QAAQ;AACnD,YAAM,IAAI,cAAc,qCAAqC,SAAS,KAAK,QAAQ,GAAG;AAAA,IACxF;AAEA,UAAM,KAAK;AAEX,QAAI,SAAS,SAAS,OAAO;AAC3B,YAAM,SAAS,oBAAI,IAAgC;AACnD,iBAAW,WAAW,GAAG,UAAU;AACjC,cAAM,MAAM,QAAQ,WAAW;AAC/B,YAAI,CAAC,OAAO,IAAI,GAAG,EAAG,QAAO,IAAI,KAAK,CAAC,CAAC;AACxC,eAAO,IAAI,GAAG,EAAG,KAAK,OAAO;AAAA,MAC/B;AAEA,aAAO,MAAM,KAAK,OAAO,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa;AACnD,eAAO,eAAe,EAAE,MAAM,qBAAqB,SAAS,CAAC;AAAA,MAC/D,CAAC;AAAA,IACH;AAEA,WAAO,eAAe,EAAE;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,aACJ,OACA,SACmC;AACnC,UAAM,SAAS,IAAI,gBAAgB,EAAE,UAAU,MAAM,CAAC;AACtD,QAAI,SAAS,SAAS,MAAM;AAC1B,aAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAAA,IAC3C;AACA,QAAI,SAAS,WAAW;AACtB,aAAO,IAAI,aAAa,GAAG,QAAQ,UAAU,CAAC,CAAC,IAAI,QAAQ,UAAU,CAAC,CAAC,EAAE;AAAA,IAC3E;AAEA,WAAO,KAAK,QAAkC,gCAAgC,MAAM,EAAE;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,YACJ,WACA,SACkC;AAClC,UAAM,YAAY,KAAK,IAAI,SAAS,aAAa,gBAAgB,cAAc;AAC/E,UAAM,UAAmC,CAAC;AAE1C,aAAS,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,WAAW;AACpD,YAAM,QAAQ,UAAU,MAAM,GAAG,IAAI,SAAS;AAC9C,YAAM,OAAO,MAAM,KAAK;AAAA,QACtB;AAAA,QACA;AAAA,UACE,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,KAAK;AAAA,QAC5B;AAAA,MACF;AAEA,iBAAW,MAAM,MAAM;AACrB,YAAI,CAAC,MAAM,CAAC,GAAG,UAAU,QAAQ;AAC/B,kBAAQ,KAAK,IAAI;AAAA,QACnB,OAAO;AACL,kBAAQ,KAAK,eAAe,EAAE,CAAC;AAAA,QACjC;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,aACJ,aACA,SACkC;AAClC,UAAM,YAAY,KAAK,IAAI,SAAS,aAAa,gBAAgB,cAAc;AAC/E,UAAM,UAAmC,CAAC;AAE1C,aAAS,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK,WAAW;AACtD,YAAM,QAAQ,YAAY,MAAM,GAAG,IAAI,SAAS;AAChD,YAAM,OAAgC,EAAE,aAAa,MAAM;AAC3D,UAAI,SAAS,MAAM;AACjB,aAAK,OAAO,QAAQ;AAAA,MACtB;AAEA,YAAM,OAAO,MAAM,KAAK,QAEtB,sBAAsB;AAAA,QACtB,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B,CAAC;AAED,UAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,mBAAW,MAAM,MAAM;AACrB,cAAI,CAAC,MAAM,CAAC,GAAG,UAAU,QAAQ;AAC/B,oBAAQ,KAAK,IAAI;AAAA,UACnB,OAAO;AACL,oBAAQ,KAAK,eAAe,EAAE,CAAC;AAAA,UACjC;AAAA,QACF;AAAA,MACF,WAAW,QAAQ,cAAc,MAAM;AAErC,cAAM,SAAS,oBAAI,IAAkC;AACrD,mBAAW,WAAW,KAAK,UAAU;AACnC,gBAAM,MAAM,KAAK,UAAU,QAAQ,WAAW,WAAW;AACzD,cAAI,CAAC,OAAO,IAAI,GAAG,EAAG,QAAO,IAAI,KAAK,CAAC,CAAC;AACxC,iBAAO,IAAI,GAAG,EAAG,KAAK,OAAO;AAAA,QAC/B;AACA,mBAAW,YAAY,OAAO,OAAO,GAAG;AACtC,kBAAQ,KAAK,eAAe,EAAE,MAAM,qBAAqB,SAAS,CAAC,CAAC;AAAA,QACtE;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,SAAS,eAAwD;AACrE,UAAM,SAAS,MAAM,KAAK,OAAO,aAAa;AAC9C,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,eAA0D;AAClE,UAAM,SAAS,IAAI,gBAAgB,EAAE,UAAU,cAAc,CAAC;AAC9D,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,0BAA0B,MAAM;AAAA,IAClC;AAEA,QAAI,EAAE,cAAc,OAAO;AACzB,aAAO,EAAE,MAAM,qBAAqB,UAAU,CAAC,EAAE;AAAA,IACnD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiCA,MAAM,aAAa,eAAuB,SAAsD;AAC9F,UAAM,SAAS,IAAI,gBAAgB,EAAE,gBAAgB,cAAc,CAAC;AACpE,QAAI,SAAS,SAAS,OAAQ,QAAO,IAAI,WAAW,QAAQ,QAAQ,KAAK,GAAG,CAAC;AAC7E,WAAO,KAAK,QAAsB,kBAAkB,MAAM,EAAE;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,MAAM,kBACJ,eACA,SAC4B;AAC5B,UAAM,SAAS,IAAI,gBAAgB,EAAE,gBAAgB,cAAc,CAAC;AACpE,QAAI,SAAS,SAAS,OAAQ,QAAO,IAAI,WAAW,QAAQ,QAAQ,KAAK,GAAG,CAAC;AAC7E,WAAO,KAAK,QAA2B,wBAAwB,MAAM,EAAE;AAAA,EACzE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,MAAM,YAAY,eAAuB,SAAoD;AAC3F,UAAM,SAAS,IAAI,gBAAgB,EAAE,gBAAgB,cAAc,CAAC;AACpE,QAAI,SAAS,SAAS,OAAQ,QAAO,IAAI,WAAW,QAAQ,QAAQ,KAAK,GAAG,CAAC;AAC7E,WAAO,KAAK,QAAqB,iBAAiB,MAAM,EAAE;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,MAAM,gBAAgB,SAA2D;AAC/E,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,QAAQ,iBAAiB,MAAM;AACjC,aAAO,IAAI,kBAAkB,QAAQ,aAAa;AAAA,IACpD,WAAW,QAAQ,cAAc,QAAQ,QAAQ,cAAc,MAAM;AACnE,aAAO,IAAI,eAAe,QAAQ,UAAU;AAC5C,aAAO,IAAI,eAAe,QAAQ,UAAU;AAC5C,UAAI,QAAQ,WAAW,KAAM,QAAO,IAAI,YAAY,QAAQ,OAAO;AAAA,IACrE,OAAO;AACL,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,WAAO,KAAK,QAAyB,qBAAqB,MAAM,EAAE;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,MAAM,UAAU,KAAiC;AAC/C,WAAO,KAAK,QAAmB,gBAAgB,mBAAmB,GAAG,CAAC,EAAE;AAAA,EAC1E;AACF;","names":[]}

package/dist/index.d.cts

@@ -143,7 +143,7 @@ interface ReportParcel {
     [key: string]: unknown;
 }
 /** Sections of the energy report addressable through `include=`. */
-type EnergyReportSection = "wells" | "operators" | "leases" | "royalties" | "orphaned_wells" | "pipelines" | "fracfocus" | "constraints" | "geometry";
+type EnergyReportSection = "wells" | "operators" | "leases" | "royalties" | "orphaned_wells" | "pipelines" | "fracfocus" | "constraints" | "renewables" | "geometry";
 /** Options for `energyReport`. */
 interface EnergyReportOptions {
     /**
@@ -282,6 +282,280 @@ interface EnergyConstraints {
     renewable_siting: EnergyRenewableSiting | null;
     [key: string]: unknown;
 }
+/** Nearest ORNL/HIFLD transmission line of one voltage class. */
+interface EnergyTransmissionLine {
+    /** "100-161", "220-287", "345", "500", "735 AND ABOVE", or "DC" */
+    volt_class: string | null;
+    voltage_kv: number | null;
+    owner: EntityRef | null;
+    status: string | null;
+    distance_miles: number | null;
+    /** True when the line runs through the section (distance under 1 m). */
+    crosses_section: boolean;
+    [key: string]: unknown;
+}
+/**
+ * A substation inferred from ORNL/HIFLD transmission-line endpoints. No open
+ * federal substation layer exists, so every row is inferred (`inferred: true`).
+ */
+interface EnergyInferredSubstation {
+    name: string | null;
+    max_voltage_kv: number | null;
+    max_volt_class: string | null;
+    line_count: number;
+    distance_miles: number | null;
+    inferred: true;
+    [key: string]: unknown;
+}
+/** Grid proximity: nearest line per kV class + inferred substations. */
+interface EnergyRenewablesGrid {
+    radius_mi: number;
+    /** Nearest line per voltage class within `radius_mi`, ordered by class. */
+    transmission_by_class: EnergyTransmissionLine[];
+    /** Nearest AC line of 100 kV or more (DC lines excluded). */
+    nearest_line_100kv_plus: EnergyTransmissionLine | null;
+    /** Up to five nearest inferred substations. */
+    substations: EnergyInferredSubstation[];
+    nearest_substation_230kv_plus: EnergyInferredSubstation | null;
+    nearest_substation_345kv_plus: EnergyInferredSubstation | null;
+    [key: string]: unknown;
+}
+/** Generator group an EIA-860M energy source rolls up to. */
+type EnergyGeneratorGroup = "solar" | "wind" | "storage" | "hydro" | "geothermal" | "gas" | "nuclear" | "coal" | "other" | (string & {});
+/** Operating vs planned nameplate MW for one generator group. */
+interface EnergyGeneratorTotals {
+    operating: number;
+    planned: number;
+    [key: string]: unknown;
+}
+/** One EIA-860M plant (operating or planned) near the section. */
+interface EnergyPlant {
+    eia_plant_id: number;
+    name: string | null;
+    operator: EntityRef | null;
+    inventory: "operating" | "planned" | (string & {});
+    /** The group holding the plant's largest share of capacity. */
+    group: EnergyGeneratorGroup;
+    technologies: string[];
+    capacity_mw: number;
+    capacity_mw_by_group: Partial<Record<EnergyGeneratorGroup, number>>;
+    online_year: number | null;
+    status: string | null;
+    distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One USGS/LBNL USPVDB solar-array footprint. */
+interface EnergyPvFootprint {
+    uspvdb_case_id: number | null;
+    eia_plant_id: number | null;
+    name: string | null;
+    capacity_ac_mw: number | null;
+    online_year: number | null;
+    on_section: boolean;
+    distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** USGS wind-turbine (USWTDB) counts near the section. */
+interface EnergyWindTurbines {
+    within_2mi: number;
+    within_5mi: number;
+    projects_within_5mi: string[];
+    [key: string]: unknown;
+}
+/** Existing + planned generators, solar footprints, and turbines. */
+interface EnergyRenewablesProjects {
+    radius_mi: number;
+    totals_mw: Partial<Record<EnergyGeneratorGroup, EnergyGeneratorTotals>>;
+    /** Up to 40 nearest plants. */
+    plants: EnergyPlant[];
+    pv_footprints: EnergyPvFootprint[];
+    wind_turbines: EnergyWindTurbines;
+    [key: string]: unknown;
+}
+/**
+ * NREL 2024 supply-curve cell nearest the section, one per technology.
+ * Values describe the surrounding 11.5 km cell, not the section itself.
+ * NREL values are CC-BY 4.0.
+ */
+interface EnergyNrelCell {
+    technology: "solar" | "wind" | (string & {});
+    sc_point_gid: number | null;
+    resource: number | null;
+    /** "kWh/m2/day (GHI)" for solar, "m/s (115 m hub height)" for wind */
+    resource_unit: string;
+    capacity_factor_pct: number | null;
+    lcoe_all_in_usd_per_mwh: number | null;
+    lcoe_site_usd_per_mwh: number | null;
+    /** National percentile of all-in LCOE within the technology (0 = cheapest). */
+    lcoe_percentile: number | null;
+    capacity_ac_mw: number | null;
+    dist_spur_miles: number | null;
+    dist_reinforcement_miles: number | null;
+    cell_distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One WAFWA CHAT habitat category overlapping the section. */
+interface EnergyLpcCategory {
+    chat_category: number;
+    label: string | null;
+    overlap_acres: number | null;
+    [key: string]: unknown;
+}
+/**
+ * Lesser prairie-chicken range-wide plan habitat (WAFWA CHAT). Not ESA
+ * critical habitat.
+ */
+interface EnergyLesserPrairieChicken {
+    in_occupied_range: boolean;
+    ecoregion: string | null;
+    /** Lowest (highest-priority) CHAT category on the section. */
+    top_category: number | null;
+    categories: EnergyLpcCategory[];
+    status_note: string;
+    [key: string]: unknown;
+}
+/** An airspace floor or ceiling. */
+interface EnergyAltitude {
+    /** Feet; null when the source unit is not feet. */
+    value_ft: number | null;
+    /** "SFC", "AGL", "MSL", or the raw source code */
+    reference: string | null;
+    label: string;
+    [key: string]: unknown;
+}
+/** One FAA military training route near the section. */
+interface EnergyMilitaryTrainingRoute {
+    ident: string | null;
+    floor: EnergyAltitude | null;
+    ceiling: EnergyAltitude | null;
+    inside_corridor: boolean;
+    centerline_distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One FAA special use airspace overlapping the section. */
+interface EnergySpecialUseAirspace {
+    name: string | null;
+    type_code: string | null;
+    floor: EnergyAltitude | null;
+    ceiling: EnergyAltitude | null;
+    times_of_use: string | null;
+    controlling_agency: string | null;
+    [key: string]: unknown;
+}
+/** FAA military training routes + special use airspace. */
+interface EnergyRenewablesAviation {
+    military_training_routes: EnergyMilitaryTrainingRoute[];
+    special_use_airspace: EnergySpecialUseAirspace[];
+    [key: string]: unknown;
+}
+/** One BLM Solar Energy Zone the section sits in. */
+interface EnergySolarEnergyZone {
+    name: string | null;
+    status: string | null;
+    state_office: string | null;
+    [key: string]: unknown;
+}
+/** One BLM Section 368 energy corridor near the section. */
+interface EnergySection368Corridor {
+    name: string | null;
+    status: string | null;
+    width_feet: number | null;
+    distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One BLM solar/wind right-of-way case near the section. */
+interface EnergyRenewableRowCase {
+    serial_number: string | null;
+    case_type: string | null;
+    status: string | null;
+    holder: EntityRef | null;
+    acres: number | null;
+    on_section: boolean;
+    [key: string]: unknown;
+}
+/** BLM Solar Energy Zones, Section 368 corridors, and renewable ROW cases. */
+interface EnergyRenewablesBlm {
+    solar_energy_zones: EnergySolarEnergyZone[];
+    section_368_corridors: EnergySection368Corridor[];
+    renewable_row_cases: EnergyRenewableRowCase[];
+    [key: string]: unknown;
+}
+/** Group an FAA Digital Obstacle File obstacle type rolls up to. */
+type EnergyObstacleGroup = "wind_turbine" | "met_tower" | "transmission_tower" | "tower" | "stack" | "other" | (string & {});
+/** The tallest obstacle within the obstacle radius. */
+interface EnergyTallestObstacle {
+    type: string | null;
+    agl_ft: number | null;
+    distance_miles: number | null;
+    faa_study: string | null;
+    [key: string]: unknown;
+}
+/** FAA Digital Obstacle File summary near the section. */
+interface EnergyObstacles {
+    radius_mi: number;
+    total: number;
+    at_least_200ft_agl: number;
+    on_section: number;
+    by_group: Partial<Record<EnergyObstacleGroup, number>>;
+    tallest: EnergyTallestObstacle | null;
+    /** Nearest meteorological tower within 10 miles. */
+    nearest_met_tower_miles: number | null;
+    [key: string]: unknown;
+}
+/** USGS whooping crane migration corridor. */
+interface EnergyWhoopingCrane {
+    /** Narrowest corridor band (percent) the section falls in; null when outside. */
+    band_pct: number | null;
+    note: string;
+    [key: string]: unknown;
+}
+/** One active LBNL Queued Up interconnection request in the county. */
+interface EnergyQueueProject {
+    name: string | null;
+    type: string | null;
+    mw: number | null;
+    point_of_interconnection: string | null;
+    ia_phase: string | null;
+    proposed_year: number | null;
+    developer: EntityRef | null;
+    transmission_provider: string | null;
+    [key: string]: unknown;
+}
+/**
+ * LBNL Queued Up interconnection queue, county-wide (never parcel-precise).
+ * LBNL values are CC-BY 4.0.
+ */
+interface EnergyInterconnectionQueue {
+    scope: "county" | (string & {});
+    county: string;
+    state_code: string;
+    vintage: string | null;
+    active_requests: number;
+    active_mw_by_type: Record<string, number>;
+    withdrawn_requests: number;
+    operational_requests: number;
+    /** Up to 10 largest active requests. */
+    active_projects: EnergyQueueProject[];
+    [key: string]: unknown;
+}
+/**
+ * Renewable-siting section. Every part degrades on its own: a failed part is
+ * null and listed in `meta.unavailable` as `{section: "renewables.<part>"}`.
+ */
+interface EnergyRenewables {
+    grid: EnergyRenewablesGrid | null;
+    projects: EnergyRenewablesProjects | null;
+    /** Up to one cell per technology (solar, wind) within 12 km. */
+    nrel: EnergyNrelCell[] | null;
+    lesser_prairie_chicken: EnergyLesserPrairieChicken | null;
+    aviation: EnergyRenewablesAviation | null;
+    blm: EnergyRenewablesBlm | null;
+    obstacles: EnergyObstacles | null;
+    whooping_crane: EnergyWhoopingCrane | null;
+    /** Also null when the section has no state/county to match on. */
+    interconnection_queue: EnergyInterconnectionQueue | null;
+    [key: string]: unknown;
+}
 /** Per-section counts. A null count means that section was not fetched. */
 interface EnergySummary {
     wells_in_section: number | null;
@@ -291,6 +565,10 @@ interface EnergySummary {
     orphaned_wells: number | null;
     pipelines_within_radius: number | null;
     fracfocus_disclosures: number | null;
+    /** From `renewables.grid`; null when not fetched or nothing within range. */
+    nearest_transmission_100kv_plus_miles: number | null;
+    /** From `renewables.grid`; null when not fetched or nothing within range. */
+    nearest_substation_230kv_plus_miles: number | null;
     [key: string]: unknown;
 }
 /** Wells section: in-section rows + the nearby radius envelope. */
@@ -335,6 +613,7 @@ interface EnergyReport {
         radius_mi: number;
     } & SectionEnvelope<FracFocusRow>;
     constraints?: EnergyConstraints | null;
+    renewables?: EnergyRenewables | null;
     meta: ReportMeta;
     [key: string]: unknown;
 }
@@ -876,7 +1155,9 @@ declare class TownshipClient {
     /**
      * Get the energy parcel report for a PLSS section. Covers state-regulator
      * wells, operators, federal leases, county royalties, orphaned wells,
-     * pipelines, FracFocus disclosures, and development constraints.
+     * pipelines, FracFocus disclosures, development constraints, and
+     * renewable siting (grid proximity, generators, NREL supply curve,
+     * wildlife, aviation, BLM designations, obstacles, interconnection queue).
      *
      * @param legalLocation - A PLSS legal description, e.g. "NW 25 24N 1E 6th Meridian"
      * @param options - Optional section projection (`include`)
@@ -892,6 +1173,12 @@ declare class TownshipClient {
      * const slim = await client.energyReport('25 24N 1E 6th Meridian', {
      *   include: ['wells', 'pipelines']
      * })
+     *
+     * // Renewable siting only
+     * const siting = await client.energyReport('25 24N 1E 6th Meridian', {
+     *   include: ['renewables']
+     * })
+     * console.log(siting.renewables?.grid?.nearest_line_100kv_plus?.distance_miles)
      * ```
      */
     energyReport(legalLocation: string, options?: EnergyReportOptions): Promise<EnergyReport>;
@@ -1020,4 +1307,4 @@ declare class PayloadTooLargeError extends TownshipError {
     constructor(message?: string, code?: string | null);
 }
 
-export { AuthenticationError, type AutocompleteOptions, type BatchReverseOptions, type BatchSearchOptions, type CriticalHabitatRow, type CropHistory, type Elevation, type EnergyConstraints, type EnergyLeaseRow, type EnergyOperatorRow, type EnergyOrphanedWellRow, type EnergyPipelineRow, type EnergyRenewableSiting, type EnergyReport, type EnergyReportOptions, type EnergyReportSection, type EnergyRoyalties, type EnergyRoyaltyItem, type EnergySageGrouse, type EnergySageGrouseHabitat, type EnergySplitEstate, type EnergySplitEstateSide, type EnergySummary, type EnergyWellRow, type EnergyWells, type EntityRef, type FeatureProperties, type FederalLandReport, type FederalLandReportOptions, type FederalLandReportSection, type FederalLeaseRow, type FireshedRow, type FloodZoneRow, type FracFocusRow, type GeoJSONBoundary, type GeoJSONFeature, type GeoJSONFeatureCollection, type GeoJSONMultiPolygon, type GeoJSONPoint, type GeoJSONPolygon, type LatLng, type MiningClaimRow, NotFoundError, type OrphanedWellRow, PayloadTooLargeError, type PublicAccessRow, RateLimitError, type ReportMeta, type ReportParcel, type ReverseOptions, type RightOfWayRow, type SearchResult, type SectionEnvelope, type SectionSource, type SoilRow, type SurfaceManagementRow, type SurveySystem, type TexasAbstractRef, type TexasActiveWellRow, type TexasCoastalErosionRow, type TexasDecline, type TexasDeclineCurvePoint, type TexasDeclineFit, type TexasMonthlyVolume, type TexasPendingPermitRow, type TexasPipelineRow, type TexasProduction, type TexasProductionBlock, type TexasProductionLease, type TexasProductionOptions, type TexasProductionSummary, type TexasPsfLandRow, type TexasReport, type TexasReportOptions, type TexasReportSection, type TexasStateAgencyLandRow, type TexasStateLeaseRow, type TexasStateUnitRow, type TexasUplandLeaseRow, type TexasWell, type TexasWellLocation, type TexasWellSeriesPoint, type TexasWellSeriesUnit, type TexasWellUnit, TownshipClient, type TownshipClientOptions, TownshipError, type UnavailableSection, type Unit, ValidationError, type WetlandRow, type WildfireRiskRow };
+export { AuthenticationError, type AutocompleteOptions, type BatchReverseOptions, type BatchSearchOptions, type CriticalHabitatRow, type CropHistory, type Elevation, type EnergyAltitude, type EnergyConstraints, type EnergyGeneratorGroup, type EnergyGeneratorTotals, type EnergyInferredSubstation, type EnergyInterconnectionQueue, type EnergyLeaseRow, type EnergyLesserPrairieChicken, type EnergyLpcCategory, type EnergyMilitaryTrainingRoute, type EnergyNrelCell, type EnergyObstacleGroup, type EnergyObstacles, type EnergyOperatorRow, type EnergyOrphanedWellRow, type EnergyPipelineRow, type EnergyPlant, type EnergyPvFootprint, type EnergyQueueProject, type EnergyRenewableRowCase, type EnergyRenewableSiting, type EnergyRenewables, type EnergyRenewablesAviation, type EnergyRenewablesBlm, type EnergyRenewablesGrid, type EnergyRenewablesProjects, type EnergyReport, type EnergyReportOptions, type EnergyReportSection, type EnergyRoyalties, type EnergyRoyaltyItem, type EnergySageGrouse, type EnergySageGrouseHabitat, type EnergySection368Corridor, type EnergySolarEnergyZone, type EnergySpecialUseAirspace, type EnergySplitEstate, type EnergySplitEstateSide, type EnergySummary, type EnergyTallestObstacle, type EnergyTransmissionLine, type EnergyWellRow, type EnergyWells, type EnergyWhoopingCrane, type EnergyWindTurbines, type EntityRef, type FeatureProperties, type FederalLandReport, type FederalLandReportOptions, type FederalLandReportSection, type FederalLeaseRow, type FireshedRow, type FloodZoneRow, type FracFocusRow, type GeoJSONBoundary, type GeoJSONFeature, type GeoJSONFeatureCollection, type GeoJSONMultiPolygon, type GeoJSONPoint, type GeoJSONPolygon, type LatLng, type MiningClaimRow, NotFoundError, type OrphanedWellRow, PayloadTooLargeError, type PublicAccessRow, RateLimitError, type ReportMeta, type ReportParcel, type ReverseOptions, type RightOfWayRow, type SearchResult, type SectionEnvelope, type SectionSource, type SoilRow, type SurfaceManagementRow, type SurveySystem, type TexasAbstractRef, type TexasActiveWellRow, type TexasCoastalErosionRow, type TexasDecline, type TexasDeclineCurvePoint, type TexasDeclineFit, type TexasMonthlyVolume, type TexasPendingPermitRow, type TexasPipelineRow, type TexasProduction, type TexasProductionBlock, type TexasProductionLease, type TexasProductionOptions, type TexasProductionSummary, type TexasPsfLandRow, type TexasReport, type TexasReportOptions, type TexasReportSection, type TexasStateAgencyLandRow, type TexasStateLeaseRow, type TexasStateUnitRow, type TexasUplandLeaseRow, type TexasWell, type TexasWellLocation, type TexasWellSeriesPoint, type TexasWellSeriesUnit, type TexasWellUnit, TownshipClient, type TownshipClientOptions, TownshipError, type UnavailableSection, type Unit, ValidationError, type WetlandRow, type WildfireRiskRow };

package/dist/index.d.ts

@@ -143,7 +143,7 @@ interface ReportParcel {
     [key: string]: unknown;
 }
 /** Sections of the energy report addressable through `include=`. */
-type EnergyReportSection = "wells" | "operators" | "leases" | "royalties" | "orphaned_wells" | "pipelines" | "fracfocus" | "constraints" | "geometry";
+type EnergyReportSection = "wells" | "operators" | "leases" | "royalties" | "orphaned_wells" | "pipelines" | "fracfocus" | "constraints" | "renewables" | "geometry";
 /** Options for `energyReport`. */
 interface EnergyReportOptions {
     /**
@@ -282,6 +282,280 @@ interface EnergyConstraints {
     renewable_siting: EnergyRenewableSiting | null;
     [key: string]: unknown;
 }
+/** Nearest ORNL/HIFLD transmission line of one voltage class. */
+interface EnergyTransmissionLine {
+    /** "100-161", "220-287", "345", "500", "735 AND ABOVE", or "DC" */
+    volt_class: string | null;
+    voltage_kv: number | null;
+    owner: EntityRef | null;
+    status: string | null;
+    distance_miles: number | null;
+    /** True when the line runs through the section (distance under 1 m). */
+    crosses_section: boolean;
+    [key: string]: unknown;
+}
+/**
+ * A substation inferred from ORNL/HIFLD transmission-line endpoints. No open
+ * federal substation layer exists, so every row is inferred (`inferred: true`).
+ */
+interface EnergyInferredSubstation {
+    name: string | null;
+    max_voltage_kv: number | null;
+    max_volt_class: string | null;
+    line_count: number;
+    distance_miles: number | null;
+    inferred: true;
+    [key: string]: unknown;
+}
+/** Grid proximity: nearest line per kV class + inferred substations. */
+interface EnergyRenewablesGrid {
+    radius_mi: number;
+    /** Nearest line per voltage class within `radius_mi`, ordered by class. */
+    transmission_by_class: EnergyTransmissionLine[];
+    /** Nearest AC line of 100 kV or more (DC lines excluded). */
+    nearest_line_100kv_plus: EnergyTransmissionLine | null;
+    /** Up to five nearest inferred substations. */
+    substations: EnergyInferredSubstation[];
+    nearest_substation_230kv_plus: EnergyInferredSubstation | null;
+    nearest_substation_345kv_plus: EnergyInferredSubstation | null;
+    [key: string]: unknown;
+}
+/** Generator group an EIA-860M energy source rolls up to. */
+type EnergyGeneratorGroup = "solar" | "wind" | "storage" | "hydro" | "geothermal" | "gas" | "nuclear" | "coal" | "other" | (string & {});
+/** Operating vs planned nameplate MW for one generator group. */
+interface EnergyGeneratorTotals {
+    operating: number;
+    planned: number;
+    [key: string]: unknown;
+}
+/** One EIA-860M plant (operating or planned) near the section. */
+interface EnergyPlant {
+    eia_plant_id: number;
+    name: string | null;
+    operator: EntityRef | null;
+    inventory: "operating" | "planned" | (string & {});
+    /** The group holding the plant's largest share of capacity. */
+    group: EnergyGeneratorGroup;
+    technologies: string[];
+    capacity_mw: number;
+    capacity_mw_by_group: Partial<Record<EnergyGeneratorGroup, number>>;
+    online_year: number | null;
+    status: string | null;
+    distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One USGS/LBNL USPVDB solar-array footprint. */
+interface EnergyPvFootprint {
+    uspvdb_case_id: number | null;
+    eia_plant_id: number | null;
+    name: string | null;
+    capacity_ac_mw: number | null;
+    online_year: number | null;
+    on_section: boolean;
+    distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** USGS wind-turbine (USWTDB) counts near the section. */
+interface EnergyWindTurbines {
+    within_2mi: number;
+    within_5mi: number;
+    projects_within_5mi: string[];
+    [key: string]: unknown;
+}
+/** Existing + planned generators, solar footprints, and turbines. */
+interface EnergyRenewablesProjects {
+    radius_mi: number;
+    totals_mw: Partial<Record<EnergyGeneratorGroup, EnergyGeneratorTotals>>;
+    /** Up to 40 nearest plants. */
+    plants: EnergyPlant[];
+    pv_footprints: EnergyPvFootprint[];
+    wind_turbines: EnergyWindTurbines;
+    [key: string]: unknown;
+}
+/**
+ * NREL 2024 supply-curve cell nearest the section, one per technology.
+ * Values describe the surrounding 11.5 km cell, not the section itself.
+ * NREL values are CC-BY 4.0.
+ */
+interface EnergyNrelCell {
+    technology: "solar" | "wind" | (string & {});
+    sc_point_gid: number | null;
+    resource: number | null;
+    /** "kWh/m2/day (GHI)" for solar, "m/s (115 m hub height)" for wind */
+    resource_unit: string;
+    capacity_factor_pct: number | null;
+    lcoe_all_in_usd_per_mwh: number | null;
+    lcoe_site_usd_per_mwh: number | null;
+    /** National percentile of all-in LCOE within the technology (0 = cheapest). */
+    lcoe_percentile: number | null;
+    capacity_ac_mw: number | null;
+    dist_spur_miles: number | null;
+    dist_reinforcement_miles: number | null;
+    cell_distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One WAFWA CHAT habitat category overlapping the section. */
+interface EnergyLpcCategory {
+    chat_category: number;
+    label: string | null;
+    overlap_acres: number | null;
+    [key: string]: unknown;
+}
+/**
+ * Lesser prairie-chicken range-wide plan habitat (WAFWA CHAT). Not ESA
+ * critical habitat.
+ */
+interface EnergyLesserPrairieChicken {
+    in_occupied_range: boolean;
+    ecoregion: string | null;
+    /** Lowest (highest-priority) CHAT category on the section. */
+    top_category: number | null;
+    categories: EnergyLpcCategory[];
+    status_note: string;
+    [key: string]: unknown;
+}
+/** An airspace floor or ceiling. */
+interface EnergyAltitude {
+    /** Feet; null when the source unit is not feet. */
+    value_ft: number | null;
+    /** "SFC", "AGL", "MSL", or the raw source code */
+    reference: string | null;
+    label: string;
+    [key: string]: unknown;
+}
+/** One FAA military training route near the section. */
+interface EnergyMilitaryTrainingRoute {
+    ident: string | null;
+    floor: EnergyAltitude | null;
+    ceiling: EnergyAltitude | null;
+    inside_corridor: boolean;
+    centerline_distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One FAA special use airspace overlapping the section. */
+interface EnergySpecialUseAirspace {
+    name: string | null;
+    type_code: string | null;
+    floor: EnergyAltitude | null;
+    ceiling: EnergyAltitude | null;
+    times_of_use: string | null;
+    controlling_agency: string | null;
+    [key: string]: unknown;
+}
+/** FAA military training routes + special use airspace. */
+interface EnergyRenewablesAviation {
+    military_training_routes: EnergyMilitaryTrainingRoute[];
+    special_use_airspace: EnergySpecialUseAirspace[];
+    [key: string]: unknown;
+}
+/** One BLM Solar Energy Zone the section sits in. */
+interface EnergySolarEnergyZone {
+    name: string | null;
+    status: string | null;
+    state_office: string | null;
+    [key: string]: unknown;
+}
+/** One BLM Section 368 energy corridor near the section. */
+interface EnergySection368Corridor {
+    name: string | null;
+    status: string | null;
+    width_feet: number | null;
+    distance_miles: number | null;
+    [key: string]: unknown;
+}
+/** One BLM solar/wind right-of-way case near the section. */
+interface EnergyRenewableRowCase {
+    serial_number: string | null;
+    case_type: string | null;
+    status: string | null;
+    holder: EntityRef | null;
+    acres: number | null;
+    on_section: boolean;
+    [key: string]: unknown;
+}
+/** BLM Solar Energy Zones, Section 368 corridors, and renewable ROW cases. */
+interface EnergyRenewablesBlm {
+    solar_energy_zones: EnergySolarEnergyZone[];
+    section_368_corridors: EnergySection368Corridor[];
+    renewable_row_cases: EnergyRenewableRowCase[];
+    [key: string]: unknown;
+}
+/** Group an FAA Digital Obstacle File obstacle type rolls up to. */
+type EnergyObstacleGroup = "wind_turbine" | "met_tower" | "transmission_tower" | "tower" | "stack" | "other" | (string & {});
+/** The tallest obstacle within the obstacle radius. */
+interface EnergyTallestObstacle {
+    type: string | null;
+    agl_ft: number | null;
+    distance_miles: number | null;
+    faa_study: string | null;
+    [key: string]: unknown;
+}
+/** FAA Digital Obstacle File summary near the section. */
+interface EnergyObstacles {
+    radius_mi: number;
+    total: number;
+    at_least_200ft_agl: number;
+    on_section: number;
+    by_group: Partial<Record<EnergyObstacleGroup, number>>;
+    tallest: EnergyTallestObstacle | null;
+    /** Nearest meteorological tower within 10 miles. */
+    nearest_met_tower_miles: number | null;
+    [key: string]: unknown;
+}
+/** USGS whooping crane migration corridor. */
+interface EnergyWhoopingCrane {
+    /** Narrowest corridor band (percent) the section falls in; null when outside. */
+    band_pct: number | null;
+    note: string;
+    [key: string]: unknown;
+}
+/** One active LBNL Queued Up interconnection request in the county. */
+interface EnergyQueueProject {
+    name: string | null;
+    type: string | null;
+    mw: number | null;
+    point_of_interconnection: string | null;
+    ia_phase: string | null;
+    proposed_year: number | null;
+    developer: EntityRef | null;
+    transmission_provider: string | null;
+    [key: string]: unknown;
+}
+/**
+ * LBNL Queued Up interconnection queue, county-wide (never parcel-precise).
+ * LBNL values are CC-BY 4.0.
+ */
+interface EnergyInterconnectionQueue {
+    scope: "county" | (string & {});
+    county: string;
+    state_code: string;
+    vintage: string | null;
+    active_requests: number;
+    active_mw_by_type: Record<string, number>;
+    withdrawn_requests: number;
+    operational_requests: number;
+    /** Up to 10 largest active requests. */
+    active_projects: EnergyQueueProject[];
+    [key: string]: unknown;
+}
+/**
+ * Renewable-siting section. Every part degrades on its own: a failed part is
+ * null and listed in `meta.unavailable` as `{section: "renewables.<part>"}`.
+ */
+interface EnergyRenewables {
+    grid: EnergyRenewablesGrid | null;
+    projects: EnergyRenewablesProjects | null;
+    /** Up to one cell per technology (solar, wind) within 12 km. */
+    nrel: EnergyNrelCell[] | null;
+    lesser_prairie_chicken: EnergyLesserPrairieChicken | null;
+    aviation: EnergyRenewablesAviation | null;
+    blm: EnergyRenewablesBlm | null;
+    obstacles: EnergyObstacles | null;
+    whooping_crane: EnergyWhoopingCrane | null;
+    /** Also null when the section has no state/county to match on. */
+    interconnection_queue: EnergyInterconnectionQueue | null;
+    [key: string]: unknown;
+}
 /** Per-section counts. A null count means that section was not fetched. */
 interface EnergySummary {
     wells_in_section: number | null;
@@ -291,6 +565,10 @@ interface EnergySummary {
     orphaned_wells: number | null;
     pipelines_within_radius: number | null;
     fracfocus_disclosures: number | null;
+    /** From `renewables.grid`; null when not fetched or nothing within range. */
+    nearest_transmission_100kv_plus_miles: number | null;
+    /** From `renewables.grid`; null when not fetched or nothing within range. */
+    nearest_substation_230kv_plus_miles: number | null;
     [key: string]: unknown;
 }
 /** Wells section: in-section rows + the nearby radius envelope. */
@@ -335,6 +613,7 @@ interface EnergyReport {
         radius_mi: number;
     } & SectionEnvelope<FracFocusRow>;
     constraints?: EnergyConstraints | null;
+    renewables?: EnergyRenewables | null;
     meta: ReportMeta;
     [key: string]: unknown;
 }
@@ -876,7 +1155,9 @@ declare class TownshipClient {
     /**
      * Get the energy parcel report for a PLSS section. Covers state-regulator
      * wells, operators, federal leases, county royalties, orphaned wells,
-     * pipelines, FracFocus disclosures, and development constraints.
+     * pipelines, FracFocus disclosures, development constraints, and
+     * renewable siting (grid proximity, generators, NREL supply curve,
+     * wildlife, aviation, BLM designations, obstacles, interconnection queue).
      *
      * @param legalLocation - A PLSS legal description, e.g. "NW 25 24N 1E 6th Meridian"
      * @param options - Optional section projection (`include`)
@@ -892,6 +1173,12 @@ declare class TownshipClient {
      * const slim = await client.energyReport('25 24N 1E 6th Meridian', {
      *   include: ['wells', 'pipelines']
      * })
+     *
+     * // Renewable siting only
+     * const siting = await client.energyReport('25 24N 1E 6th Meridian', {
+     *   include: ['renewables']
+     * })
+     * console.log(siting.renewables?.grid?.nearest_line_100kv_plus?.distance_miles)
      * ```
      */
     energyReport(legalLocation: string, options?: EnergyReportOptions): Promise<EnergyReport>;
@@ -1020,4 +1307,4 @@ declare class PayloadTooLargeError extends TownshipError {
     constructor(message?: string, code?: string | null);
 }
 
-export { AuthenticationError, type AutocompleteOptions, type BatchReverseOptions, type BatchSearchOptions, type CriticalHabitatRow, type CropHistory, type Elevation, type EnergyConstraints, type EnergyLeaseRow, type EnergyOperatorRow, type EnergyOrphanedWellRow, type EnergyPipelineRow, type EnergyRenewableSiting, type EnergyReport, type EnergyReportOptions, type EnergyReportSection, type EnergyRoyalties, type EnergyRoyaltyItem, type EnergySageGrouse, type EnergySageGrouseHabitat, type EnergySplitEstate, type EnergySplitEstateSide, type EnergySummary, type EnergyWellRow, type EnergyWells, type EntityRef, type FeatureProperties, type FederalLandReport, type FederalLandReportOptions, type FederalLandReportSection, type FederalLeaseRow, type FireshedRow, type FloodZoneRow, type FracFocusRow, type GeoJSONBoundary, type GeoJSONFeature, type GeoJSONFeatureCollection, type GeoJSONMultiPolygon, type GeoJSONPoint, type GeoJSONPolygon, type LatLng, type MiningClaimRow, NotFoundError, type OrphanedWellRow, PayloadTooLargeError, type PublicAccessRow, RateLimitError, type ReportMeta, type ReportParcel, type ReverseOptions, type RightOfWayRow, type SearchResult, type SectionEnvelope, type SectionSource, type SoilRow, type SurfaceManagementRow, type SurveySystem, type TexasAbstractRef, type TexasActiveWellRow, type TexasCoastalErosionRow, type TexasDecline, type TexasDeclineCurvePoint, type TexasDeclineFit, type TexasMonthlyVolume, type TexasPendingPermitRow, type TexasPipelineRow, type TexasProduction, type TexasProductionBlock, type TexasProductionLease, type TexasProductionOptions, type TexasProductionSummary, type TexasPsfLandRow, type TexasReport, type TexasReportOptions, type TexasReportSection, type TexasStateAgencyLandRow, type TexasStateLeaseRow, type TexasStateUnitRow, type TexasUplandLeaseRow, type TexasWell, type TexasWellLocation, type TexasWellSeriesPoint, type TexasWellSeriesUnit, type TexasWellUnit, TownshipClient, type TownshipClientOptions, TownshipError, type UnavailableSection, type Unit, ValidationError, type WetlandRow, type WildfireRiskRow };
+export { AuthenticationError, type AutocompleteOptions, type BatchReverseOptions, type BatchSearchOptions, type CriticalHabitatRow, type CropHistory, type Elevation, type EnergyAltitude, type EnergyConstraints, type EnergyGeneratorGroup, type EnergyGeneratorTotals, type EnergyInferredSubstation, type EnergyInterconnectionQueue, type EnergyLeaseRow, type EnergyLesserPrairieChicken, type EnergyLpcCategory, type EnergyMilitaryTrainingRoute, type EnergyNrelCell, type EnergyObstacleGroup, type EnergyObstacles, type EnergyOperatorRow, type EnergyOrphanedWellRow, type EnergyPipelineRow, type EnergyPlant, type EnergyPvFootprint, type EnergyQueueProject, type EnergyRenewableRowCase, type EnergyRenewableSiting, type EnergyRenewables, type EnergyRenewablesAviation, type EnergyRenewablesBlm, type EnergyRenewablesGrid, type EnergyRenewablesProjects, type EnergyReport, type EnergyReportOptions, type EnergyReportSection, type EnergyRoyalties, type EnergyRoyaltyItem, type EnergySageGrouse, type EnergySageGrouseHabitat, type EnergySection368Corridor, type EnergySolarEnergyZone, type EnergySpecialUseAirspace, type EnergySplitEstate, type EnergySplitEstateSide, type EnergySummary, type EnergyTallestObstacle, type EnergyTransmissionLine, type EnergyWellRow, type EnergyWells, type EnergyWhoopingCrane, type EnergyWindTurbines, type EntityRef, type FeatureProperties, type FederalLandReport, type FederalLandReportOptions, type FederalLandReportSection, type FederalLeaseRow, type FireshedRow, type FloodZoneRow, type FracFocusRow, type GeoJSONBoundary, type GeoJSONFeature, type GeoJSONFeatureCollection, type GeoJSONMultiPolygon, type GeoJSONPoint, type GeoJSONPolygon, type LatLng, type MiningClaimRow, NotFoundError, type OrphanedWellRow, PayloadTooLargeError, type PublicAccessRow, RateLimitError, type ReportMeta, type ReportParcel, type ReverseOptions, type RightOfWayRow, type SearchResult, type SectionEnvelope, type SectionSource, type SoilRow, type SurfaceManagementRow, type SurveySystem, type TexasAbstractRef, type TexasActiveWellRow, type TexasCoastalErosionRow, type TexasDecline, type TexasDeclineCurvePoint, type TexasDeclineFit, type TexasMonthlyVolume, type TexasPendingPermitRow, type TexasPipelineRow, type TexasProduction, type TexasProductionBlock, type TexasProductionLease, type TexasProductionOptions, type TexasProductionSummary, type TexasPsfLandRow, type TexasReport, type TexasReportOptions, type TexasReportSection, type TexasStateAgencyLandRow, type TexasStateLeaseRow, type TexasStateUnitRow, type TexasUplandLeaseRow, type TexasWell, type TexasWellLocation, type TexasWellSeriesPoint, type TexasWellSeriesUnit, type TexasWellUnit, TownshipClient, type TownshipClientOptions, TownshipError, type UnavailableSection, type Unit, ValidationError, type WetlandRow, type WildfireRiskRow };

package/dist/index.js

@@ -85,7 +85,7 @@ var TownshipClient = class {
         ...init,
         headers: {
           "X-API-Key": this.apiKey,
-          "User-Agent": "townshipamerica-js/2.0.0",
+          "User-Agent": "townshipamerica-js/2.1.0",
           ...init?.headers ?? {}
         },
         signal: controller.signal
@@ -305,7 +305,9 @@ var TownshipClient = class {
   /**
    * Get the energy parcel report for a PLSS section. Covers state-regulator
    * wells, operators, federal leases, county royalties, orphaned wells,
-   * pipelines, FracFocus disclosures, and development constraints.
+   * pipelines, FracFocus disclosures, development constraints, and
+   * renewable siting (grid proximity, generators, NREL supply curve,
+   * wildlife, aviation, BLM designations, obstacles, interconnection queue).
    *
    * @param legalLocation - A PLSS legal description, e.g. "NW 25 24N 1E 6th Meridian"
    * @param options - Optional section projection (`include`)
@@ -321,6 +323,12 @@ var TownshipClient = class {
    * const slim = await client.energyReport('25 24N 1E 6th Meridian', {
    *   include: ['wells', 'pipelines']
    * })
+   *
+   * // Renewable siting only
+   * const siting = await client.energyReport('25 24N 1E 6th Meridian', {
+   *   include: ['renewables']
+   * })
+   * console.log(siting.renewables?.grid?.nearest_line_100kv_plus?.distance_miles)
    * ```
    */
   async energyReport(legalLocation, options) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * Base error class for all Township SDK errors.\n *\n * `code` carries the machine-readable error code the Energy, Federal Land,\n * and Texas APIs return in v1 error bodies (`{\"error\": {\"code\", \"message\"}}`),\n * e.g. `invalid_parameter`, `missing_parameter`, `plss_not_supported`,\n * `ambiguous_location`, `not_found`, `rate_limit_exceeded`. It is null for\n * endpoints that do not send one.\n */\nexport class TownshipError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number | null = null,\n    public readonly code: string | null = null\n  ) {\n    super(message);\n    this.name = \"TownshipError\";\n  }\n}\n\n/**\n * Thrown when the API key is missing or invalid (HTTP 401).\n */\nexport class AuthenticationError extends TownshipError {\n  constructor(message = \"Invalid or missing API key\", code: string | null = null) {\n    super(message, 401, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/**\n * Thrown when no result is found for the given input.\n */\nexport class NotFoundError extends TownshipError {\n  constructor(message = \"Location not found\", code: string | null = null) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * Thrown when the API rate limit is exceeded (HTTP 429).\n */\nexport class RateLimitError extends TownshipError {\n  constructor(\n    message = \"Rate limit exceeded. Please slow down your requests.\",\n    code: string | null = null\n  ) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n  }\n}\n\n/**\n * Thrown when the request is malformed (HTTP 400).\n */\nexport class ValidationError extends TownshipError {\n  constructor(message = \"Invalid request\", code: string | null = null) {\n    super(message, 400, code);\n    this.name = \"ValidationError\";\n  }\n}\n\n/**\n * Thrown when the batch payload exceeds the maximum size (HTTP 413).\n */\nexport class PayloadTooLargeError extends TownshipError {\n  constructor(\n    message = \"Batch payload exceeds the maximum of 100 records per request\",\n    code: string | null = null\n  ) {\n    super(message, 413, code);\n    this.name = \"PayloadTooLargeError\";\n  }\n}\n","import {\n  AuthenticationError,\n  NotFoundError,\n  PayloadTooLargeError,\n  RateLimitError,\n  TownshipError,\n  ValidationError\n} from \"./errors.js\";\nimport type {\n  AutocompleteOptions,\n  BatchReverseOptions,\n  BatchSearchOptions,\n  EnergyReport,\n  EnergyReportOptions,\n  FederalLandReport,\n  FederalLandReportOptions,\n  GeoJSONBoundary,\n  GeoJSONFeatureCollection,\n  ReverseOptions,\n  SearchResult,\n  TexasProduction,\n  TexasProductionOptions,\n  TexasReport,\n  TexasReportOptions,\n  TexasWell,\n  TownshipClientOptions\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://developer.townshipamerica.com\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst MAX_BATCH_SIZE = 100;\n\nfunction toSearchResult(fc: GeoJSONFeatureCollection): SearchResult {\n  const centroid = fc.features.find((f) => f.properties.shape === \"centroid\");\n  const grid = fc.features.find((f) => f.properties.shape === \"grid\");\n\n  const props = centroid?.properties ?? grid?.properties;\n  if (!props) {\n    throw new TownshipError(\"Unexpected API response: no features returned\");\n  }\n\n  const [lng, lat] = centroid ? (centroid.geometry.coordinates as [number, number]) : [0, 0];\n\n  return {\n    legalLocation: props.legal_location,\n    latitude: lat,\n    longitude: lng,\n    state: props.state,\n    county: props.county,\n    unit: props.unit,\n    surveySystem: props.survey_system,\n    alternateLegalLocation: props.alternate_legal_location,\n    boundary: grid ? (grid.geometry as GeoJSONBoundary) : null,\n    raw: fc\n  };\n}\n\nexport class TownshipClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeout: number;\n\n  constructor(options: TownshipClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n\n    if (!this.apiKey) {\n      throw new TownshipError(\"apiKey is required\");\n    }\n  }\n\n  // --- Internal ---\n\n  private async request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers: {\n          \"X-API-Key\": this.apiKey,\n          \"User-Agent\": \"townshipamerica-js/2.0.0\",\n          ...(init?.headers ?? {})\n        },\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        await this.handleError(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof TownshipError) throw error;\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new TownshipError(\"Request timed out\");\n      }\n      throw new TownshipError(error instanceof Error ? error.message : \"Unknown error\");\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async handleError(response: Response): Promise<never> {\n    let message: string;\n    let code: string | null = null;\n    try {\n      const body = (await response.json()) as {\n        error?: { code?: string; message?: string } | string;\n        message?: string;\n      };\n      // Energy/Federal Land/Texas v1 error bodies are {\"error\": {\"code\", \"message\"}}\n      if (body.error && typeof body.error === \"object\") {\n        message = body.error.message ?? response.statusText;\n        code = body.error.code ?? null;\n      } else {\n        message =\n          (typeof body.error === \"string\" ? body.error : undefined) ??\n          body.message ??\n          response.statusText;\n      }\n    } catch {\n      message = response.statusText;\n    }\n\n    const status = response.status;\n    if (status === 400) throw new ValidationError(message, code);\n    if (status === 401) throw new AuthenticationError(message, code);\n    if (status === 404) throw new NotFoundError(message, code);\n    if (status === 413) throw new PayloadTooLargeError(message, code);\n    if (status === 429) throw new RateLimitError(message, code);\n    throw new TownshipError(message, status, code);\n  }\n\n  // --- Search ---\n\n  /**\n   * Convert a PLSS or Texas TXSS legal land description to GPS coordinates.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\" or \"A-175 Reeves County\"\n   * @returns A SearchResult with coordinates, boundary, and metadata.\n   * @throws {ValidationError} If the location string is invalid.\n   * @throws {NotFoundError} If no match is found.\n   */\n  async search(legalLocation: string): Promise<SearchResult> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for \"${legalLocation}\"`);\n    }\n\n    return toSearchResult(data as GeoJSONFeatureCollection);\n  }\n\n  /**\n   * Find the legal land description at the given GPS coordinates (PLSS or Texas TXSS).\n   *\n   * @param longitude - Longitude (x) coordinate.\n   * @param latitude - Latitude (y) coordinate.\n   * @param options - Optional PLSS unit filter (ignored for TXSS results).\n   * @returns A SearchResult or array of SearchResults (when unit is 'all').\n   */\n  async reverse(\n    longitude: number,\n    latitude: number,\n    options?: ReverseOptions\n  ): Promise<SearchResult | SearchResult[]> {\n    const params = new URLSearchParams({\n      location: `${longitude},${latitude}`\n    });\n    if (options?.unit) {\n      params.set(\"unit\", options.unit);\n    }\n\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/coordinates?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for coordinates [${longitude}, ${latitude}]`);\n    }\n\n    const fc = data as GeoJSONFeatureCollection;\n\n    if (options?.unit === \"all\") {\n      const groups = new Map<string, typeof fc.features>();\n      for (const feature of fc.features) {\n        const key = feature.properties.legal_location;\n        if (!groups.has(key)) groups.set(key, []);\n        groups.get(key)!.push(feature);\n      }\n\n      return Array.from(groups.values()).map((features) => {\n        return toSearchResult({ type: \"FeatureCollection\", features });\n      });\n    }\n\n    return toSearchResult(fc);\n  }\n\n  // --- Autocomplete ---\n\n  /**\n   * Get autocomplete suggestions for a partial PLSS or Texas TXSS description.\n   *\n   * @param query - Partial search query (minimum 2 characters).\n   * @param options - Optional limit (1–10, default 3) and proximity.\n   * @returns Raw GeoJSON FeatureCollection with suggestion features.\n   */\n  async autocomplete(\n    query: string,\n    options?: AutocompleteOptions\n  ): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: query });\n    if (options?.limit != null) {\n      params.set(\"limit\", String(options.limit));\n    }\n    if (options?.proximity) {\n      params.set(\"proximity\", `${options.proximity[0]},${options.proximity[1]}`);\n    }\n\n    return this.request<GeoJSONFeatureCollection>(`/autocomplete/legal-location?${params}`);\n  }\n\n  // --- Batch ---\n\n  /**\n   * Convert multiple legal land descriptions to GPS coordinates in one request.\n   * Auto-chunks if more than 100 items. Mix PLSS and Texas TXSS inputs freely.\n   *\n   * @param locations - Array of legal land descriptions.\n   * @param options - Optional chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchSearch(\n    locations: string[],\n    options?: BatchSearchOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < locations.length; i += chunkSize) {\n      const chunk = locations.slice(i, i + chunkSize);\n      const data = await this.request<(GeoJSONFeatureCollection | null)[]>(\n        \"/batch/legal-location\",\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(chunk)\n        }\n      );\n\n      for (const fc of data) {\n        if (!fc || !fc.features?.length) {\n          results.push(null);\n        } else {\n          results.push(toSearchResult(fc));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Find legal land descriptions for multiple coordinate pairs in one request.\n   * Auto-chunks if more than 100 items.\n   *\n   * @param coordinates - Array of [longitude, latitude] pairs.\n   * @param options - Optional PLSS unit filter and chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchReverse(\n    coordinates: [number, number][],\n    options?: BatchReverseOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < coordinates.length; i += chunkSize) {\n      const chunk = coordinates.slice(i, i + chunkSize);\n      const body: Record<string, unknown> = { coordinates: chunk };\n      if (options?.unit) {\n        body.unit = options.unit;\n      }\n\n      const data = await this.request<\n        (GeoJSONFeatureCollection | null)[] | GeoJSONFeatureCollection\n      >(\"/batch/coordinates\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body)\n      });\n\n      if (Array.isArray(data)) {\n        for (const fc of data) {\n          if (!fc || !fc.features?.length) {\n            results.push(null);\n          } else {\n            results.push(toSearchResult(fc));\n          }\n        }\n      } else if (data && \"features\" in data) {\n        // unit=all returns a single FeatureCollection — split by legal_location\n        const groups = new Map<string, typeof data.features>();\n        for (const feature of data.features) {\n          const key = JSON.stringify(feature.properties.search_term);\n          if (!groups.has(key)) groups.set(key, []);\n          groups.get(key)!.push(feature);\n        }\n        for (const features of groups.values()) {\n          results.push(toSearchResult({ type: \"FeatureCollection\", features }));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  // --- Convenience ---\n\n  /**\n   * Get the boundary polygon for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The boundary GeoJSON Polygon, or null if not found.\n   */\n  async boundary(legalLocation: string): Promise<GeoJSONBoundary | null> {\n    const result = await this.search(legalLocation);\n    return result.boundary;\n  }\n\n  /**\n   * Get the raw GeoJSON FeatureCollection for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The raw GeoJSON FeatureCollection from the API.\n   */\n  async raw(legalLocation: string): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data)) {\n      return { type: \"FeatureCollection\", features: [] };\n    }\n\n    return data as GeoJSONFeatureCollection;\n  }\n\n  // --- Energy API ---\n\n  /**\n   * Get the energy parcel report for a PLSS section. Covers state-regulator\n   * wells, operators, federal leases, county royalties, orphaned wells,\n   * pipelines, FracFocus disclosures, and development constraints.\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The energy report\n   *\n   * @example\n   * ```ts\n   * const report = await client.energyReport('25 24N 1E 6th Meridian')\n   * console.log(report.summary.wells_in_section)\n   * console.log(report.wells?.in_section.rows[0]?.api_number)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.energyReport('25 24N 1E 6th Meridian', {\n   *   include: ['wells', 'pipelines']\n   * })\n   * ```\n   */\n  async energyReport(legalLocation: string, options?: EnergyReportOptions): Promise<EnergyReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<EnergyReport>(`/energy/report?${params}`);\n  }\n\n  // --- Federal Land API ---\n\n  /**\n   * Get the federal-land parcel report for a PLSS tract. Covers surface\n   * management, BLM leases and rights-of-way, flood zones, mining claims,\n   * wetlands, firesheds, soils, crop history, orphaned wells, critical\n   * habitat, public access, wildfire risk, and elevation.\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The federal-land report\n   *\n   * @example\n   * ```ts\n   * const report = await client.federalLandReport('NW 25 24N 1E 6th Meridian')\n   * console.log(report.surface_management?.rows[0]?.agency)\n   *\n   * // Only the sections you need — the pruned layers' queries never run\n   * const slim = await client.federalLandReport('NW 25 24N 1E 6th Meridian', {\n   *   include: ['og_leases', 'flood_zones']\n   * })\n   * ```\n   */\n  async federalLandReport(\n    legalLocation: string,\n    options?: FederalLandReportOptions\n  ): Promise<FederalLandReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<FederalLandReport>(`/federal-land/report?${params}`);\n  }\n\n  // --- Texas API ---\n\n  /**\n   * Get the Texas abstract report for a TXSS legal description. Covers GLO\n   * state leases and units, PSF lands, RRC wells and pipelines, pending\n   * permits, coastal erosion, federal overlays, and RRC lease production.\n   *\n   * @param legalLocation - A Texas legal description, e.g. \"A-175 Reeves County\"\n   * @param options - Optional section projection (`include`)\n   * @returns The Texas report\n   *\n   * @example\n   * ```ts\n   * const report = await client.texasReport('A-175 Reeves County')\n   * console.log(report.active_wells?.rows[0]?.api_number)\n   * console.log(report.production?.summary.total_cum_boe)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.texasReport('A-175 Reeves County', {\n   *   include: ['state_leases', 'production']\n   * })\n   * ```\n   */\n  async texasReport(legalLocation: string, options?: TexasReportOptions): Promise<TexasReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<TexasReport>(`/texas/report?${params}`);\n  }\n\n  /**\n   * Get RRC lease production for a Texas abstract — per-lease lifetime\n   * totals, trailing-12-month volumes, and the 60-month monthly series.\n   * Production is reported by RRC at the LEASE level: rows are the leases\n   * whose wells fall on the abstract, never sub-allocated to the tract.\n   *\n   * @param options - Either `{legalLocation}` or `{countyFips, abstractNo, blockNo?}`\n   * @returns The abstract production rollup\n   *\n   * @example\n   * ```ts\n   * const byLocation = await client.texasProduction({ legalLocation: 'A-175 Reeves County' })\n   * const byKeys = await client.texasProduction({ countyFips: '48389', abstractNo: '175' })\n   * console.log(byKeys.summary.total_cum_boe)\n   * ```\n   */\n  async texasProduction(options: TexasProductionOptions): Promise<TexasProduction> {\n    const params = new URLSearchParams();\n    if (options.legalLocation != null) {\n      params.set(\"legal_location\", options.legalLocation);\n    } else if (options.countyFips != null && options.abstractNo != null) {\n      params.set(\"county_fips\", options.countyFips);\n      params.set(\"abstract_no\", options.abstractNo);\n      if (options.blockNo != null) params.set(\"block_no\", options.blockNo);\n    } else {\n      throw new TownshipError(\n        \"texasProduction requires either legalLocation or countyFips + abstractNo\"\n      );\n    }\n    return this.request<TexasProduction>(`/texas/production?${params}`);\n  }\n\n  /**\n   * Get per-well allocated production for a Texas well by API number —\n   * summary scalars for every lease edge, the monthly series (when\n   * provisioned), and an Arps decline fit. Volumes are allocated estimates:\n   * RRC reports production by lease, never by well.\n   *\n   * @param api - API-8 or API-14 number (e.g. \"42-389-32345\" or \"42389323450000\")\n   * @returns The well's units, series, and decline analysis\n   *\n   * @example\n   * ```ts\n   * const well = await client.texasWell('42-389-32345')\n   * console.log(well.units[0]?.cum_boe)\n   * console.log(well.decline.available && well.decline.value?.di)\n   * ```\n   */\n  async texasWell(api: string): Promise<TexasWell> {\n    return this.request<TexasWell>(`/texas/wells/${encodeURIComponent(api)}`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * Base error class for all Township SDK errors.\n *\n * `code` carries the machine-readable error code the Energy, Federal Land,\n * and Texas APIs return in v1 error bodies (`{\"error\": {\"code\", \"message\"}}`),\n * e.g. `invalid_parameter`, `missing_parameter`, `plss_not_supported`,\n * `ambiguous_location`, `not_found`, `rate_limit_exceeded`. It is null for\n * endpoints that do not send one.\n */\nexport class TownshipError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number | null = null,\n    public readonly code: string | null = null\n  ) {\n    super(message);\n    this.name = \"TownshipError\";\n  }\n}\n\n/**\n * Thrown when the API key is missing or invalid (HTTP 401).\n */\nexport class AuthenticationError extends TownshipError {\n  constructor(message = \"Invalid or missing API key\", code: string | null = null) {\n    super(message, 401, code);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/**\n * Thrown when no result is found for the given input.\n */\nexport class NotFoundError extends TownshipError {\n  constructor(message = \"Location not found\", code: string | null = null) {\n    super(message, 404, code);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * Thrown when the API rate limit is exceeded (HTTP 429).\n */\nexport class RateLimitError extends TownshipError {\n  constructor(\n    message = \"Rate limit exceeded. Please slow down your requests.\",\n    code: string | null = null\n  ) {\n    super(message, 429, code);\n    this.name = \"RateLimitError\";\n  }\n}\n\n/**\n * Thrown when the request is malformed (HTTP 400).\n */\nexport class ValidationError extends TownshipError {\n  constructor(message = \"Invalid request\", code: string | null = null) {\n    super(message, 400, code);\n    this.name = \"ValidationError\";\n  }\n}\n\n/**\n * Thrown when the batch payload exceeds the maximum size (HTTP 413).\n */\nexport class PayloadTooLargeError extends TownshipError {\n  constructor(\n    message = \"Batch payload exceeds the maximum of 100 records per request\",\n    code: string | null = null\n  ) {\n    super(message, 413, code);\n    this.name = \"PayloadTooLargeError\";\n  }\n}\n","import {\n  AuthenticationError,\n  NotFoundError,\n  PayloadTooLargeError,\n  RateLimitError,\n  TownshipError,\n  ValidationError\n} from \"./errors.js\";\nimport type {\n  AutocompleteOptions,\n  BatchReverseOptions,\n  BatchSearchOptions,\n  EnergyReport,\n  EnergyReportOptions,\n  FederalLandReport,\n  FederalLandReportOptions,\n  GeoJSONBoundary,\n  GeoJSONFeatureCollection,\n  ReverseOptions,\n  SearchResult,\n  TexasProduction,\n  TexasProductionOptions,\n  TexasReport,\n  TexasReportOptions,\n  TexasWell,\n  TownshipClientOptions\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://developer.townshipamerica.com\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst MAX_BATCH_SIZE = 100;\n\nfunction toSearchResult(fc: GeoJSONFeatureCollection): SearchResult {\n  const centroid = fc.features.find((f) => f.properties.shape === \"centroid\");\n  const grid = fc.features.find((f) => f.properties.shape === \"grid\");\n\n  const props = centroid?.properties ?? grid?.properties;\n  if (!props) {\n    throw new TownshipError(\"Unexpected API response: no features returned\");\n  }\n\n  const [lng, lat] = centroid ? (centroid.geometry.coordinates as [number, number]) : [0, 0];\n\n  return {\n    legalLocation: props.legal_location,\n    latitude: lat,\n    longitude: lng,\n    state: props.state,\n    county: props.county,\n    unit: props.unit,\n    surveySystem: props.survey_system,\n    alternateLegalLocation: props.alternate_legal_location,\n    boundary: grid ? (grid.geometry as GeoJSONBoundary) : null,\n    raw: fc\n  };\n}\n\nexport class TownshipClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeout: number;\n\n  constructor(options: TownshipClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n\n    if (!this.apiKey) {\n      throw new TownshipError(\"apiKey is required\");\n    }\n  }\n\n  // --- Internal ---\n\n  private async request<T>(path: string, init?: RequestInit): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers: {\n          \"X-API-Key\": this.apiKey,\n          \"User-Agent\": \"townshipamerica-js/2.1.0\",\n          ...(init?.headers ?? {})\n        },\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        await this.handleError(response);\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      if (error instanceof TownshipError) throw error;\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new TownshipError(\"Request timed out\");\n      }\n      throw new TownshipError(error instanceof Error ? error.message : \"Unknown error\");\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async handleError(response: Response): Promise<never> {\n    let message: string;\n    let code: string | null = null;\n    try {\n      const body = (await response.json()) as {\n        error?: { code?: string; message?: string } | string;\n        message?: string;\n      };\n      // Energy/Federal Land/Texas v1 error bodies are {\"error\": {\"code\", \"message\"}}\n      if (body.error && typeof body.error === \"object\") {\n        message = body.error.message ?? response.statusText;\n        code = body.error.code ?? null;\n      } else {\n        message =\n          (typeof body.error === \"string\" ? body.error : undefined) ??\n          body.message ??\n          response.statusText;\n      }\n    } catch {\n      message = response.statusText;\n    }\n\n    const status = response.status;\n    if (status === 400) throw new ValidationError(message, code);\n    if (status === 401) throw new AuthenticationError(message, code);\n    if (status === 404) throw new NotFoundError(message, code);\n    if (status === 413) throw new PayloadTooLargeError(message, code);\n    if (status === 429) throw new RateLimitError(message, code);\n    throw new TownshipError(message, status, code);\n  }\n\n  // --- Search ---\n\n  /**\n   * Convert a PLSS or Texas TXSS legal land description to GPS coordinates.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\" or \"A-175 Reeves County\"\n   * @returns A SearchResult with coordinates, boundary, and metadata.\n   * @throws {ValidationError} If the location string is invalid.\n   * @throws {NotFoundError} If no match is found.\n   */\n  async search(legalLocation: string): Promise<SearchResult> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for \"${legalLocation}\"`);\n    }\n\n    return toSearchResult(data as GeoJSONFeatureCollection);\n  }\n\n  /**\n   * Find the legal land description at the given GPS coordinates (PLSS or Texas TXSS).\n   *\n   * @param longitude - Longitude (x) coordinate.\n   * @param latitude - Latitude (y) coordinate.\n   * @param options - Optional PLSS unit filter (ignored for TXSS results).\n   * @returns A SearchResult or array of SearchResults (when unit is 'all').\n   */\n  async reverse(\n    longitude: number,\n    latitude: number,\n    options?: ReverseOptions\n  ): Promise<SearchResult | SearchResult[]> {\n    const params = new URLSearchParams({\n      location: `${longitude},${latitude}`\n    });\n    if (options?.unit) {\n      params.set(\"unit\", options.unit);\n    }\n\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/coordinates?${params}`\n    );\n\n    if (!(\"features\" in data) || !data.features?.length) {\n      throw new NotFoundError(`No results found for coordinates [${longitude}, ${latitude}]`);\n    }\n\n    const fc = data as GeoJSONFeatureCollection;\n\n    if (options?.unit === \"all\") {\n      const groups = new Map<string, typeof fc.features>();\n      for (const feature of fc.features) {\n        const key = feature.properties.legal_location;\n        if (!groups.has(key)) groups.set(key, []);\n        groups.get(key)!.push(feature);\n      }\n\n      return Array.from(groups.values()).map((features) => {\n        return toSearchResult({ type: \"FeatureCollection\", features });\n      });\n    }\n\n    return toSearchResult(fc);\n  }\n\n  // --- Autocomplete ---\n\n  /**\n   * Get autocomplete suggestions for a partial PLSS or Texas TXSS description.\n   *\n   * @param query - Partial search query (minimum 2 characters).\n   * @param options - Optional limit (1–10, default 3) and proximity.\n   * @returns Raw GeoJSON FeatureCollection with suggestion features.\n   */\n  async autocomplete(\n    query: string,\n    options?: AutocompleteOptions\n  ): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: query });\n    if (options?.limit != null) {\n      params.set(\"limit\", String(options.limit));\n    }\n    if (options?.proximity) {\n      params.set(\"proximity\", `${options.proximity[0]},${options.proximity[1]}`);\n    }\n\n    return this.request<GeoJSONFeatureCollection>(`/autocomplete/legal-location?${params}`);\n  }\n\n  // --- Batch ---\n\n  /**\n   * Convert multiple legal land descriptions to GPS coordinates in one request.\n   * Auto-chunks if more than 100 items. Mix PLSS and Texas TXSS inputs freely.\n   *\n   * @param locations - Array of legal land descriptions.\n   * @param options - Optional chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchSearch(\n    locations: string[],\n    options?: BatchSearchOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < locations.length; i += chunkSize) {\n      const chunk = locations.slice(i, i + chunkSize);\n      const data = await this.request<(GeoJSONFeatureCollection | null)[]>(\n        \"/batch/legal-location\",\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(chunk)\n        }\n      );\n\n      for (const fc of data) {\n        if (!fc || !fc.features?.length) {\n          results.push(null);\n        } else {\n          results.push(toSearchResult(fc));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Find legal land descriptions for multiple coordinate pairs in one request.\n   * Auto-chunks if more than 100 items.\n   *\n   * @param coordinates - Array of [longitude, latitude] pairs.\n   * @param options - Optional PLSS unit filter and chunk size.\n   * @returns Array of SearchResult or null for each input.\n   */\n  async batchReverse(\n    coordinates: [number, number][],\n    options?: BatchReverseOptions\n  ): Promise<(SearchResult | null)[]> {\n    const chunkSize = Math.min(options?.chunkSize ?? MAX_BATCH_SIZE, MAX_BATCH_SIZE);\n    const results: (SearchResult | null)[] = [];\n\n    for (let i = 0; i < coordinates.length; i += chunkSize) {\n      const chunk = coordinates.slice(i, i + chunkSize);\n      const body: Record<string, unknown> = { coordinates: chunk };\n      if (options?.unit) {\n        body.unit = options.unit;\n      }\n\n      const data = await this.request<\n        (GeoJSONFeatureCollection | null)[] | GeoJSONFeatureCollection\n      >(\"/batch/coordinates\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body)\n      });\n\n      if (Array.isArray(data)) {\n        for (const fc of data) {\n          if (!fc || !fc.features?.length) {\n            results.push(null);\n          } else {\n            results.push(toSearchResult(fc));\n          }\n        }\n      } else if (data && \"features\" in data) {\n        // unit=all returns a single FeatureCollection — split by legal_location\n        const groups = new Map<string, typeof data.features>();\n        for (const feature of data.features) {\n          const key = JSON.stringify(feature.properties.search_term);\n          if (!groups.has(key)) groups.set(key, []);\n          groups.get(key)!.push(feature);\n        }\n        for (const features of groups.values()) {\n          results.push(toSearchResult({ type: \"FeatureCollection\", features }));\n        }\n      }\n    }\n\n    return results;\n  }\n\n  // --- Convenience ---\n\n  /**\n   * Get the boundary polygon for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The boundary GeoJSON Polygon, or null if not found.\n   */\n  async boundary(legalLocation: string): Promise<GeoJSONBoundary | null> {\n    const result = await this.search(legalLocation);\n    return result.boundary;\n  }\n\n  /**\n   * Get the raw GeoJSON FeatureCollection for a legal land description.\n   *\n   * @param legalLocation - e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @returns The raw GeoJSON FeatureCollection from the API.\n   */\n  async raw(legalLocation: string): Promise<GeoJSONFeatureCollection> {\n    const params = new URLSearchParams({ location: legalLocation });\n    const data = await this.request<GeoJSONFeatureCollection | Record<string, never>>(\n      `/search/legal-location?${params}`\n    );\n\n    if (!(\"features\" in data)) {\n      return { type: \"FeatureCollection\", features: [] };\n    }\n\n    return data as GeoJSONFeatureCollection;\n  }\n\n  // --- Energy API ---\n\n  /**\n   * Get the energy parcel report for a PLSS section. Covers state-regulator\n   * wells, operators, federal leases, county royalties, orphaned wells,\n   * pipelines, FracFocus disclosures, development constraints, and\n   * renewable siting (grid proximity, generators, NREL supply curve,\n   * wildlife, aviation, BLM designations, obstacles, interconnection queue).\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The energy report\n   *\n   * @example\n   * ```ts\n   * const report = await client.energyReport('25 24N 1E 6th Meridian')\n   * console.log(report.summary.wells_in_section)\n   * console.log(report.wells?.in_section.rows[0]?.api_number)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.energyReport('25 24N 1E 6th Meridian', {\n   *   include: ['wells', 'pipelines']\n   * })\n   *\n   * // Renewable siting only\n   * const siting = await client.energyReport('25 24N 1E 6th Meridian', {\n   *   include: ['renewables']\n   * })\n   * console.log(siting.renewables?.grid?.nearest_line_100kv_plus?.distance_miles)\n   * ```\n   */\n  async energyReport(legalLocation: string, options?: EnergyReportOptions): Promise<EnergyReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<EnergyReport>(`/energy/report?${params}`);\n  }\n\n  // --- Federal Land API ---\n\n  /**\n   * Get the federal-land parcel report for a PLSS tract. Covers surface\n   * management, BLM leases and rights-of-way, flood zones, mining claims,\n   * wetlands, firesheds, soils, crop history, orphaned wells, critical\n   * habitat, public access, wildfire risk, and elevation.\n   *\n   * @param legalLocation - A PLSS legal description, e.g. \"NW 25 24N 1E 6th Meridian\"\n   * @param options - Optional section projection (`include`)\n   * @returns The federal-land report\n   *\n   * @example\n   * ```ts\n   * const report = await client.federalLandReport('NW 25 24N 1E 6th Meridian')\n   * console.log(report.surface_management?.rows[0]?.agency)\n   *\n   * // Only the sections you need — the pruned layers' queries never run\n   * const slim = await client.federalLandReport('NW 25 24N 1E 6th Meridian', {\n   *   include: ['og_leases', 'flood_zones']\n   * })\n   * ```\n   */\n  async federalLandReport(\n    legalLocation: string,\n    options?: FederalLandReportOptions\n  ): Promise<FederalLandReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<FederalLandReport>(`/federal-land/report?${params}`);\n  }\n\n  // --- Texas API ---\n\n  /**\n   * Get the Texas abstract report for a TXSS legal description. Covers GLO\n   * state leases and units, PSF lands, RRC wells and pipelines, pending\n   * permits, coastal erosion, federal overlays, and RRC lease production.\n   *\n   * @param legalLocation - A Texas legal description, e.g. \"A-175 Reeves County\"\n   * @param options - Optional section projection (`include`)\n   * @returns The Texas report\n   *\n   * @example\n   * ```ts\n   * const report = await client.texasReport('A-175 Reeves County')\n   * console.log(report.active_wells?.rows[0]?.api_number)\n   * console.log(report.production?.summary.total_cum_boe)\n   *\n   * // Only the sections you need — the rest are never queried\n   * const slim = await client.texasReport('A-175 Reeves County', {\n   *   include: ['state_leases', 'production']\n   * })\n   * ```\n   */\n  async texasReport(legalLocation: string, options?: TexasReportOptions): Promise<TexasReport> {\n    const params = new URLSearchParams({ legal_location: legalLocation });\n    if (options?.include?.length) params.set(\"include\", options.include.join(\",\"));\n    return this.request<TexasReport>(`/texas/report?${params}`);\n  }\n\n  /**\n   * Get RRC lease production for a Texas abstract — per-lease lifetime\n   * totals, trailing-12-month volumes, and the 60-month monthly series.\n   * Production is reported by RRC at the LEASE level: rows are the leases\n   * whose wells fall on the abstract, never sub-allocated to the tract.\n   *\n   * @param options - Either `{legalLocation}` or `{countyFips, abstractNo, blockNo?}`\n   * @returns The abstract production rollup\n   *\n   * @example\n   * ```ts\n   * const byLocation = await client.texasProduction({ legalLocation: 'A-175 Reeves County' })\n   * const byKeys = await client.texasProduction({ countyFips: '48389', abstractNo: '175' })\n   * console.log(byKeys.summary.total_cum_boe)\n   * ```\n   */\n  async texasProduction(options: TexasProductionOptions): Promise<TexasProduction> {\n    const params = new URLSearchParams();\n    if (options.legalLocation != null) {\n      params.set(\"legal_location\", options.legalLocation);\n    } else if (options.countyFips != null && options.abstractNo != null) {\n      params.set(\"county_fips\", options.countyFips);\n      params.set(\"abstract_no\", options.abstractNo);\n      if (options.blockNo != null) params.set(\"block_no\", options.blockNo);\n    } else {\n      throw new TownshipError(\n        \"texasProduction requires either legalLocation or countyFips + abstractNo\"\n      );\n    }\n    return this.request<TexasProduction>(`/texas/production?${params}`);\n  }\n\n  /**\n   * Get per-well allocated production for a Texas well by API number —\n   * summary scalars for every lease edge, the monthly series (when\n   * provisioned), and an Arps decline fit. Volumes are allocated estimates:\n   * RRC reports production by lease, never by well.\n   *\n   * @param api - API-8 or API-14 number (e.g. \"42-389-32345\" or \"42389323450000\")\n   * @returns The well's units, series, and decline analysis\n   *\n   * @example\n   * ```ts\n   * const well = await client.texasWell('42-389-32345')\n   * console.log(well.units[0]?.cum_boe)\n   * console.log(well.decline.available && well.decline.value?.di)\n   * ```\n   */\n  async texasWell(api: string): Promise<TexasWell> {\n    return this.request<TexasWell>(`/texas/wells/${encodeURIComponent(api)}`);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "townshipamerica",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Official TypeScript SDK for the Township America API — convert PLSS and Texas TXSS legal land descriptions to GPS coordinates and back, plus Energy, Federal Land, and Texas parcel reports.",
   "type": "module",
   "main": "./dist/index.cjs",