Offline ZIP/postal derivation

[Aryama-srivastav]

name: 🚀 Feature Request
about: Suggest an idea or a new capability for FireForm.
title: "[FEAT]: Offline ZIP Code Derivation for Missing Postal Fields"
labels: enhancement
assignees: ''"

📝 Description

Add an offline ZIP/postal derivation capability so FireForm can auto-fill missing ZIP fields when users provide district, town, city, county, state, or full address text but do not recall ZIP code.

💡 Rationale

Cal Fire and partner agencies often require complete address blocks including ZIP code. During field reporting, responders may remember location context (town/district/address) but not ZIP. FireForm should infer ZIP offline to reduce manual correction and speed report completion in low-connectivity environments.

📌 Additional Context

Scope is US-first (Cal Fire use case).
Resolver should handle common input patterns such as:
"Pine Valley, CA"
"Sacramento County, California"
"123 Main St, Sacramento, CA"

[Aryama-srivastav]

Hi! I've gone ahead and raised a PR for this issue.

The implementation adds an OfflineUSZipResolver class using pgeocode (fully offline, no network calls at runtime) that handles all the patterns mentioned — "Pine Valley, CA", "Sacramento County, California", and full address strings with embedded ZIPs....

@SamarthTechKing That sounds duplicate to #438

[CrepuscularIRIS]

Hi! I'd like to take a stab at this. I'm working on a ZipResolver using uszipcode (US-specific offline SQLite DB), which handles three inference patterns — embedded ZIP in address text, city+state lookup, and "City, ST" parsing from address/county fields. The implementation is non-breaking: existing valid ZIPs are never overwritten, and if no ZIP can be inferred it leaves the field as-is.

Happy to adjust the approach or library choice if it doesn't fit the project direction. Will open a PR shortly.