# Changelog of TTB Alcohol Permittee Scraper (`haketa/ttb-alcohol-permittee-scraper`) Actor

- **URL**: https://apify.com/haketa/ttb-alcohol-permittee-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/haketa/ttb-alcohol-permittee-scraper.md

## Changelog

### 1.2.0 — 2026-11-01

- **Fresh verification run:** Confirmed the actor against the live TTB Federal List of Permittees. Pulled **500 unique permit records in ~16 seconds** with **0 duplicates** on `permitNumber` and **100% coverage** on all identity fields (`permitNumber`, `ownerName`, `permitType`, `permitCategory`, `industryType`, `state`, `city`, `zipCode`, `permitYear`, `isNewPermit`, `scrapedAt`). `operatingName` (DBA) fills ~44–59% and `county` ~66–74% — these are genuinely optional fields that TTB does not file for every permit, not scraper gaps.
- **Verified the mixed-sample default path:** A no-filter run correctly spread 500 records across all six published TTB files (Importers, Wholesalers, Spirits Producers, Wine Producers, "Basic Permits Issued Since the Last Publication", and the Puerto Rico list), returning a balanced mix of `Importer (Alcohol)`, `Wholesaler (Alcohol)`, `Distilled Spirits Plant`, and `Wine Producer` records. No value bugs ("\[object Object]", garbled text, scheme-less URLs) detected.
- **README refreshed to current live data:** Corrected the CSV URL date path, documented the real six-file landing-page layout, and fixed the permit-type reference — TTB's current permit numbers encode single-letter type codes (`W`, `S`, `P`, `I`), so the output `permitType` field now reflects those exactly while `permitCategory`/`industryType` carry TTB's authoritative `Industry_Type` labels. Refreshed the Output example and field table to match the verified sample byte-for-byte.
- **Build hardening:** Removed the `--no-optional` flag from the Dockerfile `npm install` step to avoid a known build-fragility trap; dependency install is otherwise unchanged.
- Added this CHANGELOG file (previously missing) so the Apify Changelog tab renders a maintained history.

### 1.1.0 — 2026-10

- Added the `industryType` field — surfaces TTB's authoritative `Industry_Type` classification (`Wine Producer`, `Distilled Spirits Plant`, `Importer (Alcohol)`, `Wholesaler (Alcohol)`) on every record, and uses it to make `permitCategory` more accurate than deriving it from the permit-number letter alone.

### 1.0.0 — 2026-05

- Initial public release — landing-page CSV URL auto-discovery, four permit categories (wine, spirits, wholesalers, importers), permit-number decoder (state / type / year), `isNewPermit` flag, `stateFilter`, and pay-per-event pricing.
