openings 0.1.8 → 0.1.9

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Find evidence-grounded jobs, including relevant roles you may not have searched for, without accounts or API keys.",
   "author": { "name": "Openings contributors" },
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "A free, candidate-safe job-search substrate for AI agents",
   "license": "MIT",
   "repository": { "type": "git", "url": "git+https://github.com/abhay-avagama/hiring-agent.git" },

package/src/locations.ts

@@ -101,12 +101,26 @@ function detectRegions(location: string, description: string): string[] {
   return [...new Set([...fromLocation, ...fromDescription])];
 }
 
+/** US state and district postal codes. Many collide with ISO country codes (IN, CA, DE, CO, GA, ID, IL, LA, MA, MD, MO, MT, NE, PA, SC, SD, TN, VA). */
+const US_STATE_CODES = new Set(["AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "DC"]);
+const US_CITY_STATE = /,\s*([A-Z]{2})(?=\s*(?:$|,|\d{5}|\(|\/|-))/g;
+
 function detectCountries(location: string): string[] {
-  const matches: string[] = [];
+  const byName: string[] = [];
+  const byCode: string[] = [];
   for (const rule of countryRules()) {
-    if (rule.location.test(location) || rule.codeLocation.test(location)) matches.push(rule.code);
+    if (rule.location.test(location)) byName.push(rule.code);
+    else if (rule.codeLocation.test(location)) byCode.push(rule.code);
   }
-  return matches;
+  // "Indianapolis, IN" is Indiana, not India: a bare code in the US "City, ST" position is a state unless a country name
+  // or a known Indian place says otherwise.
+  // Case matters: "Berlin, de" is a lowercase country code, "Gary, IN" is a state.
+  const stateCodes = [...location.matchAll(US_CITY_STATE)].map((match) => match[1]!).filter((code) => US_STATE_CODES.has(code));
+  if (stateCodes.length && byName.length === 0 && !INDIA_PATTERN.test(location)) {
+    return [...new Set(["US", ...byCode.filter((code) => !US_STATE_CODES.has(code))])];
+  }
+  if (byName.includes("US")) return [...new Set([...byName, ...byCode.filter((code) => !US_STATE_CODES.has(code))])];
+  return [...new Set([...byName, ...byCode])];
 }
 
 function detectEligibleCountries(description: string): string[] {

package/src/providers.ts

@@ -65,7 +65,7 @@ const smartrecruiters: ProviderSpec = {
   normalize(company, job) {
     const loc = isRecord(job.location) ? job.location : {};
     const country = str(loc.country);
-    const location = str(loc.fullLocation) || [str(loc.city), str(loc.region), country.length === 2 ? country.toUpperCase() : country].filter(Boolean).join(", ") || "Unspecified";
+    const location = str(loc.fullLocation) || [str(loc.city), str(loc.region), countryLabel(country)].filter(Boolean).join(", ") || "Unspecified";
     const remote = loc.remote === true;
     return classifyJob({
       id: `smartrecruiters:${company.slug}:${str(job.id)}`, company: company.name, title: str(job.name), location,
@@ -168,7 +168,7 @@ const freshteam: ProviderSpec = {
   payloadVersion: () => "freshteam-widget:v1",
   normalize(company, job) {
     const branch = isRecord(job.branch) ? job.branch : {};
-    const location = [str(branch.city), str(branch.state), str(branch.country_code).toUpperCase()].filter(Boolean).join(", ") || (job.remote === true ? "Remote" : "Unspecified");
+    const location = [str(branch.city), str(branch.state), countryLabel(str(branch.country_code))].filter(Boolean).join(", ") || (job.remote === true ? "Remote" : "Unspecified");
     const remote = job.remote === true;
     return classifyJob({
       id: `freshteam:${company.slug}:${str(job.unique_id) || str(job.id)}`, company: company.name, title: str(job.title), location,
@@ -196,6 +196,14 @@ export function resolveProviderSource(value: string): { ats: Ats; token: string;
   return null;
 }
 
+const regionNames = new Intl.DisplayNames(["en"], { type: "region" });
+/** ISO code to English name (US -> United States); anything that is not a two-letter code passes through. */
+export function countryLabel(value: string): string {
+  const code = value.trim().toUpperCase();
+  if (!/^[A-Z]{2}$/.test(code)) return value.trim();
+  try { const name = regionNames.of(code); return name && name !== code ? name : value.trim(); } catch { return value.trim(); }
+}
+
 function validToken(value: string | undefined): string | null {
   return value && /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value) ? value : null;
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.1.8";
+export const VERSION = "0.1.9";