@bash-app/bash-common 30.285.0 → 30.289.0

package/dist/dist/utils/eventTimezoneIana.js

@@ -0,0 +1,282 @@
+import { DateTime } from "luxon";
+/** Primary IANA zone for each US state + DC (contiguous conventions; AZ/HI/AK use canonical zones). */
+const US_STATE_CODE_TO_IANA = {
+    AL: "America/Chicago",
+    AK: "America/Anchorage",
+    AZ: "America/Phoenix",
+    AR: "America/Chicago",
+    CA: "America/Los_Angeles",
+    CO: "America/Denver",
+    CT: "America/New_York",
+    DE: "America/New_York",
+    DC: "America/New_York",
+    FL: "America/New_York",
+    GA: "America/New_York",
+    HI: "Pacific/Honolulu",
+    ID: "America/Boise",
+    IL: "America/Chicago",
+    IN: "America/Indiana/Indianapolis",
+    IA: "America/Chicago",
+    KS: "America/Chicago",
+    KY: "America/New_York",
+    LA: "America/Chicago",
+    ME: "America/New_York",
+    MD: "America/New_York",
+    MA: "America/New_York",
+    MI: "America/Detroit",
+    MN: "America/Chicago",
+    MS: "America/Chicago",
+    MO: "America/Chicago",
+    MT: "America/Denver",
+    NE: "America/Chicago",
+    NV: "America/Los_Angeles",
+    NH: "America/New_York",
+    NJ: "America/New_York",
+    NM: "America/Denver",
+    NY: "America/New_York",
+    NC: "America/New_York",
+    ND: "America/Chicago",
+    OH: "America/New_York",
+    OK: "America/Chicago",
+    OR: "America/Los_Angeles",
+    PA: "America/New_York",
+    RI: "America/New_York",
+    SC: "America/New_York",
+    SD: "America/Chicago",
+    TN: "America/Chicago",
+    TX: "America/Chicago",
+    UT: "America/Denver",
+    VT: "America/New_York",
+    VA: "America/New_York",
+    WA: "America/Los_Angeles",
+    WV: "America/New_York",
+    WI: "America/Chicago",
+    WY: "America/Denver",
+};
+function isUsCountry(country) {
+    if (!country?.trim())
+        return true;
+    const c = country.trim().toLowerCase();
+    return (c === "us" ||
+        c === "usa" ||
+        c === "united states" ||
+        c === "united states of america");
+}
+/**
+ * Maps a US state code (e.g. "UT") to IANA when country is US/unknown.
+ * Returns null if state is missing or not a 2-letter US code.
+ */
+export function getIanaTimezoneFromUsStateCode(state, country) {
+    if (!state?.trim())
+        return null;
+    const code = state.trim().toUpperCase();
+    if (code.length !== 2)
+        return null;
+    if (!isUsCountry(country))
+        return null;
+    return US_STATE_CODE_TO_IANA[code] ?? null;
+}
+export function isValidIanaTimezone(timezone) {
+    const t = timezone?.trim();
+    if (!t)
+        return false;
+    return DateTime.now().setZone(t).isValid;
+}
+/**
+ * Longitude/latitude → IANA for common regions. Returns null when coords are missing
+ * or no region matches (caller should fall back to address hints or UTC).
+ */
+export function getIanaTimezoneFromCoordinates(latitude, longitude) {
+    if (latitude === null ||
+        latitude === undefined ||
+        longitude === null ||
+        longitude === undefined) {
+        return null;
+    }
+    if (!Number.isFinite(latitude) || !Number.isFinite(longitude)) {
+        return null;
+    }
+    // Null Island / indeterminate — do not guess a zone from (0, 0).
+    if (latitude === 0 && longitude === 0) {
+        return null;
+    }
+    // Hawaii first
+    if (longitude >= -160 &&
+        longitude <= -154 &&
+        latitude >= 18.9 &&
+        latitude <= 22.5) {
+        return "Pacific/Honolulu";
+    }
+    // Alaska / Aleutian
+    if (longitude >= -180 && longitude <= -140) {
+        if (longitude <= -169.5) {
+            return "America/Adak";
+        }
+        return "America/Anchorage";
+    }
+    // Continental US — fixed west-to-east bands (avoids misclassifying Mountain vs Central)
+    if (latitude >= 18.9 && latitude <= 71.5388) {
+        if (longitude <= -114) {
+            return "America/Los_Angeles";
+        }
+        if (longitude > -114 && longitude <= -102) {
+            if (latitude >= 31.3 &&
+                latitude <= 37.0 &&
+                longitude >= -114.8 &&
+                longitude <= -109.0) {
+                return "America/Phoenix";
+            }
+            return "America/Denver";
+        }
+        if (longitude > -102 && longitude <= -87) {
+            return "America/Chicago";
+        }
+        if (longitude > -87 && longitude <= -67) {
+            return "America/New_York";
+        }
+    }
+    // Europe / Africa (coarse)
+    if (longitude >= -10 && longitude <= 40) {
+        if (longitude >= -1 && longitude <= 1) {
+            return "Europe/London";
+        }
+        if (longitude >= 1 && longitude <= 3) {
+            return "Europe/Paris";
+        }
+        if (longitude >= 13 && longitude <= 15) {
+            return "Europe/Berlin";
+        }
+        if (longitude >= 20 && longitude <= 30) {
+            return "Europe/Helsinki";
+        }
+    }
+    else if (longitude >= 100 && longitude <= 180) {
+        if (longitude >= 139 && longitude <= 141) {
+            return "Asia/Tokyo";
+        }
+        if (longitude >= 116 && longitude <= 118) {
+            return "Asia/Shanghai";
+        }
+        if (longitude >= 150 && longitude <= 155) {
+            return "Australia/Sydney";
+        }
+        if (longitude >= 115 && longitude <= 120) {
+            return "Australia/Perth";
+        }
+    }
+    else if (longitude >= -80 && longitude <= -30) {
+        if (latitude !== null && latitude !== undefined && latitude >= 45) {
+            if (longitude >= -80 && longitude <= -74) {
+                return "America/Toronto";
+            }
+            if (longitude >= -110 && longitude <= -100) {
+                return "America/Winnipeg";
+            }
+            if (longitude >= -125 && longitude <= -115) {
+                return "America/Vancouver";
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Substring hints for free-text location (pipe-delimited or legacy). Avoids single-letter
+ * state codes like "ut" that false-positive inside unrelated words.
+ */
+export function getIanaTimezoneFromLocationStringHints(location) {
+    if (!location?.trim())
+        return null;
+    const locationLower = location.toLowerCase();
+    if (locationLower.includes("new jersey") ||
+        /\bnj\b/.test(locationLower) ||
+        locationLower.includes("new york") ||
+        /\bny\b/.test(locationLower) ||
+        locationLower.includes("massachusetts") ||
+        /\bma\b/.test(locationLower) ||
+        locationLower.includes("florida") ||
+        /\bfl\b/.test(locationLower) ||
+        locationLower.includes("georgia") ||
+        /\bga\b/.test(locationLower) ||
+        locationLower.includes("keansburg")) {
+        return "America/New_York";
+    }
+    if (locationLower.includes("california") ||
+        locationLower.includes(", ca") ||
+        locationLower.endsWith(" ca") ||
+        locationLower.includes("washington") ||
+        locationLower.includes(", wa") ||
+        locationLower.endsWith(" wa") ||
+        locationLower.includes("oregon") ||
+        locationLower.includes("nevada") ||
+        /\bnv\b/.test(locationLower)) {
+        return "America/Los_Angeles";
+    }
+    if (locationLower.includes("texas") ||
+        /\btx\b/.test(locationLower) ||
+        locationLower.includes("illinois") ||
+        /\bil\b/.test(locationLower) ||
+        locationLower.includes("chicago")) {
+        return "America/Chicago";
+    }
+    if (locationLower.includes("arizona") || /\baz\b/.test(locationLower)) {
+        return "America/Phoenix";
+    }
+    if (locationLower.includes("colorado") ||
+        locationLower.includes(", co") ||
+        locationLower.endsWith(" co") ||
+        locationLower.includes("utah") ||
+        locationLower.includes(", ut") ||
+        locationLower.includes(" ut,") ||
+        locationLower.endsWith(" ut")) {
+        return "America/Denver";
+    }
+    if (locationLower.includes("london") || locationLower.includes("uk")) {
+        return "Europe/London";
+    }
+    if (locationLower.includes("paris") || locationLower.includes("france")) {
+        return "Europe/Paris";
+    }
+    if (locationLower.includes("tokyo") || locationLower.includes("japan")) {
+        return "Asia/Tokyo";
+    }
+    return null;
+}
+/**
+ * Infer IANA from coordinates, then US state, then location/city string hints.
+ * Never uses the viewer's device timezone. Falls back to UTC.
+ */
+export function inferEventTimezoneIana(args) {
+    const fromCoords = getIanaTimezoneFromCoordinates(args.latitude, args.longitude);
+    if (fromCoords)
+        return fromCoords;
+    const fromState = getIanaTimezoneFromUsStateCode(args.state, args.country);
+    if (fromState)
+        return fromState;
+    const fromLoc = getIanaTimezoneFromLocationStringHints(args.location);
+    if (fromLoc)
+        return fromLoc;
+    const cityLine = [args.city, args.state, args.country]
+        .filter((p) => !!p?.trim())
+        .join(", ");
+    const fromCityLine = getIanaTimezoneFromLocationStringHints(cityLine);
+    if (fromCityLine)
+        return fromCityLine;
+    return "UTC";
+}
+/**
+ * For public surfaces (e.g. BashCard): prefer geographic inference when location
+ * data is available — it is more reliable than the stored timezone which may have
+ * been set by AI or defaulted incorrectly. Falls back to the stored IANA only when
+ * geographic inference produces no opinion (returns UTC). Never uses the viewer's
+ * device timezone.
+ */
+export function resolveEventTimezoneIanaForDisplay(args) {
+    const inferred = inferEventTimezoneIana(args);
+    if (inferred !== "UTC")
+        return inferred;
+    const stored = args.timezone?.trim();
+    if (stored && isValidIanaTimezone(stored))
+        return stored;
+    return "UTC";
+}
+//# sourceMappingURL=eventTimezoneIana.js.map

package/dist/dist/utils/eventTimezoneIana.js.map

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

package/dist/dist/utils/featuredDiscoveryGeo.d.ts

@@ -0,0 +1,30 @@
+/** Default featured-discovery radius when the client omits `featuredRadiusMiles`. */
+export declare const DEFAULT_FEATURED_RADIUS_MILES = 200;
+/**
+ * Haversine distance in miles between two WGS84 points.
+ */
+export declare function haversineMiles(lat1: number, lng1: number, lat2: number, lng2: number): number;
+export interface ViewerGeoScope {
+    lat: number;
+    lng: number;
+    radiusMiles: number;
+}
+export declare function effectiveFeaturedForGeoScope(isFeatured: boolean, coordinates: Array<{
+    lat: number | null;
+    lng: number | null;
+}> | null | undefined, viewer: ViewerGeoScope | undefined): boolean;
+export type EventWithFeaturedAndCoords = {
+    id: string;
+    isFeatured: boolean | null;
+    featuredUntil?: Date | null;
+    startDateTime: Date | string | null;
+    coordinates?: Array<{
+        lat: number | null;
+        lng: number | null;
+    }> | null;
+};
+/**
+ * Sort: effective featured (in geo scope if viewer set) first, then by startDateTime.
+ */
+export declare function sortPublicEventsForFeaturedDiscovery<T extends EventWithFeaturedAndCoords>(events: T[], viewer: ViewerGeoScope | undefined): T[];
+//# sourceMappingURL=featuredDiscoveryGeo.d.ts.map

package/dist/dist/utils/featuredDiscoveryGeo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featuredDiscoveryGeo.d.ts","sourceRoot":"","sources":["../../src/utils/featuredDiscoveryGeo.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAYR;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EACjF,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,OAAO,CAOT;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CACxE,CAAC;AAEF;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,CAAC,SAAS,0BAA0B,EACpC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,CAAC,EAAE,CAiBtD"}

package/dist/dist/utils/featuredDiscoveryGeo.js

@@ -0,0 +1,47 @@
+/** Default featured-discovery radius when the client omits `featuredRadiusMiles`. */
+export const DEFAULT_FEATURED_RADIUS_MILES = 200;
+/**
+ * Haversine distance in miles between two WGS84 points.
+ */
+export function haversineMiles(lat1, lng1, lat2, lng2) {
+    const R = 3958.8;
+    const dLat = ((lat2 - lat1) * Math.PI) / 180;
+    const dLng = ((lng2 - lng1) * Math.PI) / 180;
+    const a = Math.sin(dLat / 2) * Math.sin(dLat / 2) +
+        Math.cos((lat1 * Math.PI) / 180) *
+            Math.cos((lat2 * Math.PI) / 180) *
+            Math.sin(dLng / 2) *
+            Math.sin(dLng / 2);
+    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+    return R * c;
+}
+export function effectiveFeaturedForGeoScope(isFeatured, coordinates, viewer) {
+    if (!isFeatured)
+        return false;
+    if (!viewer)
+        return true;
+    const first = coordinates?.find((c) => c.lat != null && c.lng != null);
+    if (!first || first.lat == null || first.lng == null)
+        return false;
+    const d = haversineMiles(first.lat, first.lng, viewer.lat, viewer.lng);
+    return d <= viewer.radiusMiles;
+}
+/**
+ * Sort: effective featured (in geo scope if viewer set) first, then by startDateTime.
+ */
+export function sortPublicEventsForFeaturedDiscovery(events, viewer) {
+    const withKeys = events.map((e) => {
+        const eff = effectiveFeaturedForGeoScope(!!e.isFeatured, e.coordinates, viewer);
+        const start = e.startDateTime
+            ? new Date(e.startDateTime).getTime()
+            : 0;
+        return { e, eff, start };
+    });
+    withKeys.sort((a, b) => {
+        if (a.eff !== b.eff)
+            return (b.eff ? 1 : 0) - (a.eff ? 1 : 0);
+        return a.start - b.start;
+    });
+    return withKeys.map((x) => x.e);
+}
+//# sourceMappingURL=featuredDiscoveryGeo.js.map

package/dist/dist/utils/featuredDiscoveryGeo.js.map

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

package/dist/dist/utils/flyerUtils.d.ts

@@ -0,0 +1,66 @@
+/**
+ * USPS EDDM flat minimum: 6.125" × 11" (one dimension must be at least 11").
+ * Product standard used by Flyer Blast: 6.25" × 11" portrait.
+ */
+export declare const FLYER_EDDM_WIDTH_IN = 6.25;
+export declare const FLYER_EDDM_HEIGHT_IN = 11;
+export declare const FLYER_EDDM_MIN_WIDTH_IN = 6.125;
+export declare const FLYER_EDDM_MIN_HEIGHT_IN = 11;
+/** USPS EDDM Retail per-piece postage (2026 — verify periodically). */
+export declare const USPS_EDDM_RETAIL_PER_PIECE_CENTS = 24.7;
+/**
+ * USPS EDDM Retail minimum mailpieces per mailing (saturation).
+ * Aligns with starter tier lower bound in `FLYER_PRICING_TIERS`.
+ */
+export declare const USPS_EDDM_RETAIL_MIN_MAILPIECES = 200;
+export type FlyerPricingTierId = "starter" | "neighborhood" | "district" | "metro";
+export interface FlyerTierQuote {
+    tierId: FlyerPricingTierId;
+    label: string;
+    minHouseholds: number;
+    maxHouseholds: number;
+    hostPriceCents: number;
+}
+export declare const FLYER_PRICING_TIERS: FlyerTierQuote[];
+/** Default sponsor slot list prices (Utah / intermountain — cents). */
+export declare const FLYER_SPONSOR_DEFAULT_FEATURED_CENTS = 10000;
+export declare const FLYER_SPONSOR_DEFAULT_SUPPORTING_CENTS = 5000;
+export declare const FLYER_SPONSOR_BUSINESS_NAME_MAX_LENGTH = 48;
+export declare const FLYER_SPONSOR_CTA_MAX_LENGTH = 72;
+export declare const FLYER_SPONSOR_CATEGORY_MAX_LENGTH = 40;
+export declare const FLYER_SPONSOR_LOGO_ALT_MAX_LENGTH = 90;
+export declare const FLYER_SPONSOR_LOGO_MAX_BYTES: number;
+export declare const FLYER_SPONSOR_ALLOWED_LOGO_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/webp", "image/svg+xml"];
+export interface FlyerSponsorCreativeInput {
+    businessName?: string | null;
+    ctaText?: string | null;
+    category?: string | null;
+    logoAltText?: string | null;
+}
+export interface FlyerSponsorCreativeValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+export declare function validateFlyerSponsorCreative(input: FlyerSponsorCreativeInput): FlyerSponsorCreativeValidationResult;
+export declare function isEddmFlatSizeCompliant(widthIn: number, heightIn: number): boolean;
+/**
+ * Map total selected households to a pricing tier. Returns null if below minimum (200 for EDDM Retail).
+ */
+export declare function quoteFlyerTierForHouseholds(totalHouseholds: number): FlyerTierQuote | null;
+export declare function computeHostTotalAfterSponsors(printPostageCostCents: number, sponsorRevenueCents: number): number;
+/** Default slot price in cents for Featured vs Supporting flyer slots. */
+export declare function flyerSponsorSlotPriceCents(slot: "FEATURED" | "SUPPORTING_1" | "SUPPORTING_2", requestedPrice?: number): number;
+/** Host revenue share for a flyer sponsor slot. */
+export declare function flyerSponsorSlotHostPct(slot: "FEATURED" | "SUPPORTING_1" | "SUPPORTING_2"): number;
+export declare function flyerSponsorSlotLabel(slot: "FEATURED" | "SUPPORTING_1" | "SUPPORTING_2"): string;
+/** Haversine distance in miles between two WGS84 points. */
+export declare function distanceMiles(lat1: number, lng1: number, lat2: number, lng2: number): number;
+/** URL path for the public QR scan endpoint (prepend API origin in clients). */
+export declare function flyerQrScanPath(campaignQrSlug: string): string;
+/** URL path for sponsor-specific scans on a campaign flyer. */
+export declare function flyerSponsorQrScanPath(campaignQrSlug: string, sponsorQrSlug: string): string;
+/**
+ * Short slug for campaign QR (avoid ambiguous chars); unique enforced in DB.
+ */
+export declare function generateFlyerCampaignSlug(): string;
+//# sourceMappingURL=flyerUtils.d.ts.map

package/dist/dist/utils/flyerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flyerUtils.d.ts","sourceRoot":"","sources":["../../src/utils/flyerUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,uEAAuE;AACvE,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,OAAO,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,mBAAmB,EAAE,cAAc,EA6B/C,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,oCAAoC,QAAQ,CAAC;AAC1D,eAAO,MAAM,sCAAsC,OAAO,CAAC;AAC3D,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,4BAA4B,QAAkB,CAAC;AAC5D,eAAO,MAAM,qCAAqC,qEAKxC,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oCAAoC;IACnD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,yBAAyB,GAC/B,oCAAoC,CAgCtC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIlF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,MAAM,GACtB,cAAc,GAAG,IAAI,CAkBvB;AAED,wBAAgB,6BAA6B,CAC3C,qBAAqB,EAAE,MAAM,EAC7B,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAER;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,EAClD,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAKR;AAED,mDAAmD;AACnD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,GACjD,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,GACjD,MAAM,CAWR;AAID,4DAA4D;AAC5D,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAUR;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAOlD"}

package/dist/dist/utils/flyerUtils.js

@@ -0,0 +1,166 @@
+/**
+ * USPS EDDM flat minimum: 6.125" × 11" (one dimension must be at least 11").
+ * Product standard used by Flyer Blast: 6.25" × 11" portrait.
+ */
+export const FLYER_EDDM_WIDTH_IN = 6.25;
+export const FLYER_EDDM_HEIGHT_IN = 11;
+export const FLYER_EDDM_MIN_WIDTH_IN = 6.125;
+export const FLYER_EDDM_MIN_HEIGHT_IN = 11;
+/** USPS EDDM Retail per-piece postage (2026 — verify periodically). */
+export const USPS_EDDM_RETAIL_PER_PIECE_CENTS = 24.7;
+/**
+ * USPS EDDM Retail minimum mailpieces per mailing (saturation).
+ * Aligns with starter tier lower bound in `FLYER_PRICING_TIERS`.
+ */
+export const USPS_EDDM_RETAIL_MIN_MAILPIECES = 200;
+export const FLYER_PRICING_TIERS = [
+    {
+        tierId: "starter",
+        label: "Starter",
+        minHouseholds: 200,
+        maxHouseholds: 499,
+        hostPriceCents: 14900,
+    },
+    {
+        tierId: "neighborhood",
+        label: "Neighborhood",
+        minHouseholds: 500,
+        maxHouseholds: 1499,
+        hostPriceCents: 32900,
+    },
+    {
+        tierId: "district",
+        label: "District",
+        minHouseholds: 1500,
+        maxHouseholds: 3999,
+        hostPriceCents: 69900,
+    },
+    {
+        tierId: "metro",
+        label: "Metro",
+        minHouseholds: 4000,
+        maxHouseholds: 9999,
+        hostPriceCents: 139900,
+    },
+];
+/** Default sponsor slot list prices (Utah / intermountain — cents). */
+export const FLYER_SPONSOR_DEFAULT_FEATURED_CENTS = 10000;
+export const FLYER_SPONSOR_DEFAULT_SUPPORTING_CENTS = 5000;
+export const FLYER_SPONSOR_BUSINESS_NAME_MAX_LENGTH = 48;
+export const FLYER_SPONSOR_CTA_MAX_LENGTH = 72;
+export const FLYER_SPONSOR_CATEGORY_MAX_LENGTH = 40;
+export const FLYER_SPONSOR_LOGO_ALT_MAX_LENGTH = 90;
+export const FLYER_SPONSOR_LOGO_MAX_BYTES = 2 * 1024 * 1024;
+export const FLYER_SPONSOR_ALLOWED_LOGO_MIME_TYPES = [
+    "image/jpeg",
+    "image/png",
+    "image/webp",
+    "image/svg+xml",
+];
+export function validateFlyerSponsorCreative(input) {
+    const errors = [];
+    const businessName = input.businessName?.trim() ?? "";
+    const ctaText = input.ctaText?.trim() ?? "";
+    const category = input.category?.trim() ?? "";
+    const logoAltText = input.logoAltText?.trim() ?? "";
+    if (!businessName) {
+        errors.push("Business name is required.");
+    }
+    if (businessName.length > FLYER_SPONSOR_BUSINESS_NAME_MAX_LENGTH) {
+        errors.push(`Business name must be ${FLYER_SPONSOR_BUSINESS_NAME_MAX_LENGTH} characters or fewer.`);
+    }
+    if (ctaText.length > FLYER_SPONSOR_CTA_MAX_LENGTH) {
+        errors.push(`Sponsor offer must be ${FLYER_SPONSOR_CTA_MAX_LENGTH} characters or fewer.`);
+    }
+    if (category.length > FLYER_SPONSOR_CATEGORY_MAX_LENGTH) {
+        errors.push(`Sponsor category must be ${FLYER_SPONSOR_CATEGORY_MAX_LENGTH} characters or fewer.`);
+    }
+    if (logoAltText.length > FLYER_SPONSOR_LOGO_ALT_MAX_LENGTH) {
+        errors.push(`Logo description must be ${FLYER_SPONSOR_LOGO_ALT_MAX_LENGTH} characters or fewer.`);
+    }
+    return { ok: errors.length === 0, errors };
+}
+export function isEddmFlatSizeCompliant(widthIn, heightIn) {
+    const long = Math.max(widthIn, heightIn);
+    const short = Math.min(widthIn, heightIn);
+    return long >= FLYER_EDDM_MIN_HEIGHT_IN && short >= FLYER_EDDM_MIN_WIDTH_IN;
+}
+/**
+ * Map total selected households to a pricing tier. Returns null if below minimum (200 for EDDM Retail).
+ */
+export function quoteFlyerTierForHouseholds(totalHouseholds) {
+    if (totalHouseholds < FLYER_PRICING_TIERS[0].minHouseholds) {
+        return null;
+    }
+    for (const tier of FLYER_PRICING_TIERS) {
+        if (totalHouseholds >= tier.minHouseholds &&
+            totalHouseholds <= tier.maxHouseholds) {
+            return tier;
+        }
+    }
+    // Above metro max — use metro as ceiling for MVP
+    const last = FLYER_PRICING_TIERS[FLYER_PRICING_TIERS.length - 1];
+    if (totalHouseholds > last.maxHouseholds) {
+        return last;
+    }
+    return null;
+}
+export function computeHostTotalAfterSponsors(printPostageCostCents, sponsorRevenueCents) {
+    return Math.max(0, printPostageCostCents - sponsorRevenueCents);
+}
+/** Default slot price in cents for Featured vs Supporting flyer slots. */
+export function flyerSponsorSlotPriceCents(slot, requestedPrice) {
+    if (requestedPrice != null)
+        return requestedPrice;
+    return slot === "FEATURED"
+        ? FLYER_SPONSOR_DEFAULT_FEATURED_CENTS
+        : FLYER_SPONSOR_DEFAULT_SUPPORTING_CENTS;
+}
+/** Host revenue share for a flyer sponsor slot. */
+export function flyerSponsorSlotHostPct(slot) {
+    return slot === "FEATURED" ? 0.6 : 0.65;
+}
+export function flyerSponsorSlotLabel(slot) {
+    switch (slot) {
+        case "FEATURED":
+            return "Featured";
+        case "SUPPORTING_1":
+            return "Supporting 1";
+        case "SUPPORTING_2":
+            return "Supporting 2";
+        default:
+            return slot;
+    }
+}
+const EARTH_RADIUS_MI = 3958.8;
+/** Haversine distance in miles between two WGS84 points. */
+export function distanceMiles(lat1, lng1, lat2, lng2) {
+    const rlat1 = (lat1 * Math.PI) / 180;
+    const rlat2 = (lat2 * Math.PI) / 180;
+    const dLat = rlat2 - rlat1;
+    const dLng = ((lng2 - lng1) * Math.PI) / 180;
+    const a = Math.sin(dLat / 2) * Math.sin(dLat / 2) +
+        Math.cos(rlat1) * Math.cos(rlat2) * Math.sin(dLng / 2) * Math.sin(dLng / 2);
+    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+    return EARTH_RADIUS_MI * c;
+}
+/** URL path for the public QR scan endpoint (prepend API origin in clients). */
+export function flyerQrScanPath(campaignQrSlug) {
+    return `/api/flyer/qr-scan?c=${encodeURIComponent(campaignQrSlug)}`;
+}
+/** URL path for sponsor-specific scans on a campaign flyer. */
+export function flyerSponsorQrScanPath(campaignQrSlug, sponsorQrSlug) {
+    return `${flyerQrScanPath(campaignQrSlug)}&s=${encodeURIComponent(sponsorQrSlug)}`;
+}
+/**
+ * Short slug for campaign QR (avoid ambiguous chars); unique enforced in DB.
+ */
+export function generateFlyerCampaignSlug() {
+    const alphabet = "23456789abcdefghjkmnpqrstuvwxyz";
+    let out = "fb";
+    for (let i = 0; i < 12; i++) {
+        out += alphabet[Math.floor(Math.random() * alphabet.length)];
+    }
+    return out;
+}
+//# sourceMappingURL=flyerUtils.js.map

package/dist/dist/utils/flyerUtils.js.map

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

package/dist/dist/utils/generalDateTimeUtils.d.ts

@@ -0,0 +1,15 @@
+import { DayOfWeek } from "@prisma/client";
+export type DayOfWeekIdx = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export declare const dayOfWeekToString: {
+    [key in DayOfWeek]: string;
+};
+export declare const dayOfWeekToIdx: {
+    [key in DayOfWeek]: DayOfWeekIdx;
+};
+export declare const dayOfWeekIdxToDayOfWeek: {
+    [key in DayOfWeekIdx]: DayOfWeek;
+};
+export declare const dayOfWeekIdxToDay: {
+    [key in DayOfWeekIdx]: DayOfWeekIdx;
+};
+//# sourceMappingURL=generalDateTimeUtils.d.ts.map

package/dist/dist/utils/generalDateTimeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generalDateTimeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/generalDateTimeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAErD,eAAO,MAAM,iBAAiB,EAAE;KAAG,GAAG,IAAI,SAAS,GAAG,MAAM;CAQlD,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE;KAAG,GAAG,IAAI,SAAS,GAAG,YAAY;CAQrD,CAAC;AAEX,eAAO,MAAM,uBAAuB,EAAE;KAAG,GAAG,IAAI,YAAY,GAAG,SAAS;CAQ9D,CAAC;AAEX,eAAO,MAAM,iBAAiB,EAAE;KAAG,GAAG,IAAI,YAAY,GAAG,YAAY;CAQ3D,CAAC"}