hazo_core 2.0.3 → 2.3.0

package/README.md

@@ -70,8 +70,8 @@ import { loadConfig, defineConfig, createLogger, createDebug,
 
 ```ts
 import { withRetry, isUuid, parseListLimit, parseListOffset,
-  createDebouncedSaver } from 'hazo_core';
-// all five are env-agnostic and also available from 'hazo_core/client'
+  createDebouncedSaver, rateLimit, withRateLimit, getClientIp } from 'hazo_core';
+// all are env-agnostic and also available from 'hazo_core/client'
 ```
 
 ### Browser-safe subset

package/config/hazo_core_config.ini

@@ -7,6 +7,10 @@
 ; Override with HAZO_INCLUDE_STACK=1 to force on.
 include_stack = false
 
+[format]
+; BCP 47 locale for number/currency/date formatting (default: en-AU)
+; locale = en-AU
+
 [env]
 ; This section is an example of the per-env overlay convention.
 ; Create hazo_core_config.<env>.ini alongside this file to override values

package/dist/http/rate_limit.d.ts

@@ -0,0 +1,49 @@
+/** Options for {@link rateLimit}. */
+export interface RateLimitOptions {
+    /** Bucket identifier (e.g. IP address or user ID). */
+    key: string;
+    /** Namespace / feature name (prevents cross-feature key collisions). */
+    scope: string;
+    /** Maximum requests allowed within the window. */
+    limit: number;
+    /** Window duration in milliseconds. */
+    window_ms: number;
+}
+export type RateLimitResult = {
+    ok: true;
+} | {
+    ok: false;
+    retry_after_seconds: number;
+};
+/**
+ * Fixed-window token-bucket check. Increments the bucket for `scope:key` and
+ * reports whether the caller is still under `limit` within `window_ms`.
+ *
+ * @example rateLimit({ key: '1.2.3.4', scope: 'login', limit: 5, window_ms: 60_000 })
+ */
+export declare function rateLimit(opts: RateLimitOptions): RateLimitResult;
+/** Clear all buckets. Used in tests only. */
+export declare function _clearBuckets(): void;
+type RateLimitRouteHandler = (req: Request, ...args: unknown[]) => Promise<Response> | Response;
+/**
+ * Wraps an HTTP route handler with rate limiting. Returns 429 with
+ * `Retry-After`/`X-RateLimit-Limit` headers when the limit is exceeded.
+ *
+ * Keys by client IP (`getClientIp`) by default; pass `getKey` to key by
+ * something else (e.g. a session/user id).
+ *
+ * Does NOT import from 'next' — uses the standard Request/Response types.
+ *
+ * @example
+ * export const POST = withRateLimit(myHandler, { scope: 'login', limit: 5, window_ms: 15 * 60 * 1000 });
+ */
+export declare function withRateLimit(handler: RateLimitRouteHandler, opts: Omit<RateLimitOptions, 'key'> & {
+    getKey?: (req: Request) => string;
+}): RateLimitRouteHandler;
+/**
+ * Best-effort client IP from standard proxy headers.
+ * Checks `x-forwarded-for` (first entry), then `x-real-ip`; falls back to `'unknown'`.
+ */
+export declare function getClientIp(req: Request): string;
+export {};
+//# sourceMappingURL=rate_limit.d.ts.map

package/dist/http/rate_limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate_limit.d.ts","sourceRoot":"","sources":["../../src/http/rate_limit.ts"],"names":[],"mappings":"AAeA,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC;AAS/C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAsBjE;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAMD,KAAK,qBAAqB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAEhG;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAA;CAAE,GAC1E,qBAAqB,CAsBvB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAIhD"}

package/dist/http/rate_limit.js

@@ -0,0 +1,84 @@
+// file_description: In-memory token-bucket rate limiter plus a framework-agnostic
+// HTTP route-handler wrapper.
+//
+// `rateLimit`/`_clearBuckets` are a simple per-process Map-backed fixed-window
+// counter — single-process only; swap for a Postgres/Redis-backed store before
+// running multiple instances behind a load balancer.
+//
+// `withRateLimit`/`getClientIp` wrap a route handler using the standard
+// Request/Response types (not 'next/server'), so the same code works as-is in
+// a Next.js App Router route handler — NextRequest extends Request and a
+// returned plain Response is a valid handler return value — mirroring
+// `withRequestIdRouteHandler` in `request_id_middleware.ts`.
+//
+// Promoted from taxclientdocs' lib/rate-limit/{token-bucket,middleware}.ts.
+const _buckets = new Map();
+/**
+ * Fixed-window token-bucket check. Increments the bucket for `scope:key` and
+ * reports whether the caller is still under `limit` within `window_ms`.
+ *
+ * @example rateLimit({ key: '1.2.3.4', scope: 'login', limit: 5, window_ms: 60_000 })
+ */
+export function rateLimit(opts) {
+    const { key, scope, limit, window_ms } = opts;
+    const bucketKey = `${scope}:${key}`;
+    const now = Date.now();
+    const existing = _buckets.get(bucketKey);
+    if (!existing || now - existing.window_start >= window_ms) {
+        // New window
+        _buckets.set(bucketKey, { count: 1, window_start: now });
+        return { ok: true };
+    }
+    if (existing.count < limit) {
+        existing.count += 1;
+        return { ok: true };
+    }
+    // Limit exceeded
+    const elapsed = now - existing.window_start;
+    const retry_after_seconds = Math.ceil((window_ms - elapsed) / 1000);
+    return { ok: false, retry_after_seconds };
+}
+/** Clear all buckets. Used in tests only. */
+export function _clearBuckets() {
+    _buckets.clear();
+}
+/**
+ * Wraps an HTTP route handler with rate limiting. Returns 429 with
+ * `Retry-After`/`X-RateLimit-Limit` headers when the limit is exceeded.
+ *
+ * Keys by client IP (`getClientIp`) by default; pass `getKey` to key by
+ * something else (e.g. a session/user id).
+ *
+ * Does NOT import from 'next' — uses the standard Request/Response types.
+ *
+ * @example
+ * export const POST = withRateLimit(myHandler, { scope: 'login', limit: 5, window_ms: 15 * 60 * 1000 });
+ */
+export function withRateLimit(handler, opts) {
+    const getKey = opts.getKey ?? getClientIp;
+    return async (req, ...args) => {
+        const key = getKey(req);
+        const result = rateLimit({ ...opts, key });
+        if (!result.ok) {
+            return Response.json({ error: 'Too many requests. Please try again later.' }, {
+                status: 429,
+                headers: {
+                    'Retry-After': String(result.retry_after_seconds),
+                    'X-RateLimit-Limit': String(opts.limit),
+                },
+            });
+        }
+        return handler(req, ...args);
+    };
+}
+/**
+ * Best-effort client IP from standard proxy headers.
+ * Checks `x-forwarded-for` (first entry), then `x-real-ip`; falls back to `'unknown'`.
+ */
+export function getClientIp(req) {
+    const xff = req.headers.get('x-forwarded-for');
+    if (xff)
+        return xff.split(',')[0].trim();
+    return req.headers.get('x-real-ip') ?? 'unknown';
+}
+//# sourceMappingURL=rate_limit.js.map

package/dist/http/rate_limit.js.map

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

package/dist/index.client.d.ts

@@ -12,11 +12,13 @@ export { HazoError, HazoValidationError, HazoAuthError, HazoNotFoundError, HazoC
 export type { HazoErrorOptions, HazoValidationErrorOptions, ValidationIssue, HazoAuthErrorOptions, HazoNotFoundErrorOptions, HazoConflictErrorOptions, HazoConfigErrorOptions, HazoExternalErrorOptions, HazoRateLimitErrorOptions, HazoUnavailableErrorOptions, HazoInternalErrorOptions, } from './errors/index.js';
 export { setBrowserCorrelationId, getContext, getCorrelationId, withContext, } from './context/client.js';
 export type { HazoContext } from './context/types.js';
-export { generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, getCurrentEnv, withRetry, isUuid, createDebouncedSaver, } from './utils/index.js';
-export type { DateFormat, RetryOptions, DebouncedSaveContext, CreateDebouncedSaverOptions, DebouncedSaver, FormatCurrencyOptions, } from './utils/index.js';
+export { generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, getCurrentEnv, withRetry, isUuid, createDebouncedSaver, getPartialDatePrecision, isValidPartialDate, isPartialDateRange, parsePartialDate, formatPartialDate, serializePartialDate, comparePartialDate, formatPartialDateString, } from './utils/index.js';
+export type { DateFormat, RetryOptions, DebouncedSaveContext, CreateDebouncedSaverOptions, DebouncedSaver, FormatCurrencyOptions, PartialDatePrecision, PartialDateQualifier, PartialDateEra, PartialDate, PartialDateRange, ParsedPartialDate, } from './utils/index.js';
 export { fetchWithRequestId } from './http/fetch_with_request_id.client.js';
 export { get_origin_url, create_redirect_url } from './http/get_origin_url.js';
 export { parseListLimit, parseListOffset } from './http/list_params.js';
+export { rateLimit, _clearBuckets, withRateLimit, getClientIp } from './http/rate_limit.js';
+export type { RateLimitOptions, RateLimitResult } from './http/rate_limit.js';
 export { createLogger } from './logger/index.client.js';
 export type { HazoCoreLogger } from './logger/index.js';
 //# sourceMappingURL=index.client.d.ts.map

package/dist/index.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../src/index.client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG3F,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGvE,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,MAAM,EACN,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../src/index.client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG3F,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGvE,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,MAAM,EACN,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI9E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.client.js

@@ -15,11 +15,12 @@ export { HazoError, HazoValidationError, HazoAuthError, HazoNotFoundError, HazoC
 // Context (browser — mutable ref, NOT AsyncLocalStorage)
 export { setBrowserCorrelationId, getContext, getCorrelationId, withContext, } from './context/client.js';
 // Safe utils (no Node deps)
-export { generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, getCurrentEnv, withRetry, isUuid, createDebouncedSaver, } from './utils/index.js';
+export { generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, getCurrentEnv, withRetry, isUuid, createDebouncedSaver, getPartialDatePrecision, isValidPartialDate, isPartialDateRange, parsePartialDate, formatPartialDate, serializePartialDate, comparePartialDate, formatPartialDateString, } from './utils/index.js';
 // HTTP — browser-safe variants (Fetch API, no AsyncLocalStorage)
 export { fetchWithRequestId } from './http/fetch_with_request_id.client.js';
 export { get_origin_url, create_redirect_url } from './http/get_origin_url.js';
 export { parseListLimit, parseListOffset } from './http/list_params.js';
+export { rateLimit, _clearBuckets, withRateLimit, getClientIp } from './http/rate_limit.js';
 // Logger — client-side stub emits to the browser console (server version
 // requires node:module + process.stderr, neither available in browsers/edge)
 export { createLogger } from './logger/index.client.js';

package/dist/index.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.client.js","sourceRoot":"","sources":["../src/index.client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,sDAAsD;AACtD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvE,4DAA4D;AAC5D,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAe3B,yDAAyD;AACzD,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,MAAM,EACN,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAU1B,iEAAiE;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExE,yEAAyE;AACzE,6EAA6E;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.client.js","sourceRoot":"","sources":["../src/index.client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,sDAAsD;AACtD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvE,4DAA4D;AAC5D,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAe3B,yDAAyD;AACzD,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,MAAM,EACN,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAgB1B,iEAAiE;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG5F,yEAAyE;AACzE,6EAA6E;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.d.ts

@@ -6,8 +6,8 @@
  */
 export { REQUEST_ID_HEADER, HAZO_ERROR_SYMBOL, HAZO_SINGLETONS_KEY } from './constants.js';
 export { registerSingleton, getSingleton, globalSingleton, resetGlobalSingleton } from './singleton/index.js';
-export { getCurrentEnv, generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, withRetry, isUuid, createDebouncedSaver, } from './utils/index.js';
-export type { DateFormat, RetryOptions, DebouncedSaveContext, CreateDebouncedSaverOptions, DebouncedSaver, FormatCurrencyOptions, } from './utils/index.js';
+export { getCurrentEnv, generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, withRetry, isUuid, createDebouncedSaver, getPartialDatePrecision, isValidPartialDate, isPartialDateRange, parsePartialDate, formatPartialDate, serializePartialDate, comparePartialDate, formatPartialDateString, } from './utils/index.js';
+export type { DateFormat, RetryOptions, DebouncedSaveContext, CreateDebouncedSaverOptions, DebouncedSaver, FormatCurrencyOptions, PartialDatePrecision, PartialDateQualifier, PartialDateEra, PartialDate, PartialDateRange, ParsedPartialDate, } from './utils/index.js';
 export { HazoError, HazoValidationError, HazoAuthError, HazoNotFoundError, HazoConflictError, HazoConfigError, HazoExternalError, HazoRateLimitError, HazoUnavailableError, HazoInternalError, fromZodValidation, fromZodConfig, } from './errors/index.js';
 export type { HazoErrorOptions, HazoValidationErrorOptions, ValidationIssue, HazoAuthErrorOptions, HazoNotFoundErrorOptions, HazoConflictErrorOptions, HazoConfigErrorOptions, HazoExternalErrorOptions, HazoRateLimitErrorOptions, HazoUnavailableErrorOptions, HazoInternalErrorOptions, } from './errors/index.js';
 export { withContext, getContext, getCorrelationId, } from './context/index.js';
@@ -22,4 +22,6 @@ export { createRequestIdMiddleware, withRequestIdRouteHandler, } from './http/re
 export { fetchWithRequestId } from './http/fetch_with_request_id.js';
 export { get_origin_url, create_redirect_url } from './http/get_origin_url.js';
 export { parseListLimit, parseListOffset } from './http/list_params.js';
+export { rateLimit, _clearBuckets, withRateLimit, getClientIp } from './http/rate_limit.js';
+export type { RateLimitOptions, RateLimitResult } from './http/rate_limit.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG3F,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG9G,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,MAAM,EACN,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjH,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG3F,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG9G,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,MAAM,EACN,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjH,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -9,7 +9,7 @@ export { REQUEST_ID_HEADER, HAZO_ERROR_SYMBOL, HAZO_SINGLETONS_KEY } from './con
 // Singleton registry
 export { registerSingleton, getSingleton, globalSingleton, resetGlobalSingleton } from './singleton/index.js';
 // Utilities
-export { getCurrentEnv, generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, withRetry, isUuid, createDebouncedSaver, } from './utils/index.js';
+export { getCurrentEnv, generateRequestId, generateId, optional_import, safeJsonParse, sleep, formatBytes, formatDateShort, formatDateLong, formatDateSlash, formatCurrency, formatPercent, formatNumber, formatBoolean, getInitials, format_date, format_date_range, DEFAULT_DATE_FORMAT, withRetry, isUuid, createDebouncedSaver, getPartialDatePrecision, isValidPartialDate, isPartialDateRange, parsePartialDate, formatPartialDate, serializePartialDate, comparePartialDate, formatPartialDateString, } from './utils/index.js';
 // Errors
 export { HazoError, HazoValidationError, HazoAuthError, HazoNotFoundError, HazoConflictError, HazoConfigError, HazoExternalError, HazoRateLimitError, HazoUnavailableError, HazoInternalError, fromZodValidation, fromZodConfig, } from './errors/index.js';
 // Context (server — AsyncLocalStorage)
@@ -25,4 +25,5 @@ export { createRequestIdMiddleware, withRequestIdRouteHandler, } from './http/re
 export { fetchWithRequestId } from './http/fetch_with_request_id.js';
 export { get_origin_url, create_redirect_url } from './http/get_origin_url.js';
 export { parseListLimit, parseListOffset } from './http/list_params.js';
+export { rateLimit, _clearBuckets, withRateLimit, getClientIp } from './http/rate_limit.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,YAAY;AACZ,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,MAAM,EACN,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAU1B,SAAS;AACT,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAe3B,uCAAuC;AACvC,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGjH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO;AACP,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,YAAY;AACZ,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,MAAM,EACN,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAgB1B,SAAS;AACT,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAe3B,uCAAuC;AACvC,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGjH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO;AACP,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/utils/dates.d.ts

@@ -18,7 +18,14 @@
  *   'iso'    — YYYY-MM-DD (locale-independent, SSR-safe)
  *   'dmy'    — DD/MM/YYYY
  *   'mdy'    — MM/DD/YYYY
- *   'locale' — Use environment locale (NOT SSR-safe; may cause hydration mismatch)
+ *   'locale' — Use environment locale (NOT SSR-safe; may cause hydration mismatch).
+ *              @deprecated SSR-unsafe: the server and browser can resolve different
+ *              default locales, so the same date renders differently on each,
+ *              which is exactly the shape of bug that causes Next.js hydration
+ *              mismatches. `format_date` THROWS when called with 'locale' outside
+ *              production (see below) to surface this during development; in
+ *              production it still renders (unchanged behavior for existing
+ *              deployments). Prefer an explicit locale, or 'iso'/'dmy'/'mdy'.
  */
 export type DateFormat = 'iso' | 'dmy' | 'mdy' | 'locale';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAkB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EACtC,MAAM,GAAE,UAAgC,GACvC,MAAM,CAsCR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EACtC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EACpC,MAAM,GAAE,UAAgC,GACvC,MAAM,CAQR"}
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAkB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EACtC,MAAM,GAAE,UAAgC,GACvC,MAAM,CA8CR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EACtC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EACpC,MAAM,GAAE,UAAgC,GACvC,MAAM,CAQR"}

package/dist/utils/dates.js

@@ -51,7 +51,13 @@ export function format_date(date, format = DEFAULT_DATE_FORMAT) {
         case 'mdy':
             return `${month}/${day}/${year}`;
         case 'locale':
-            // Uses environment locale — not SSR-safe (may cause hydration mismatch in Next.js)
+            // Uses environment locale — not SSR-safe (may cause hydration mismatch in Next.js).
+            // Outside production this throws instead of silently rendering inconsistent output
+            // (FR-032 Stage 4); production behavior is unchanged so already-deployed callers
+            // that rely on it don't break.
+            if (process.env['NODE_ENV'] !== 'production') {
+                throw new Error("format_date('locale') is SSR-unsafe — pass an explicit locale or use 'iso'/'dmy'/'mdy'.");
+            }
             return date_obj.toLocaleDateString();
         default:
             return `${year}-${month}-${day}`;

package/dist/utils/dates.js.map

@@ -1 +1 @@
-{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe,KAAK,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsC,EACtC,SAAqB,mBAAmB;IAExC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,uBAAuB;IACvB,IAAI,QAAc,CAAC;IACnB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,oFAAoF;QACpF,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9B,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAExD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QAEnC,KAAK,KAAK;YACR,OAAO,GAAG,GAAG,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAEnC,KAAK,KAAK;YACR,OAAO,GAAG,KAAK,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAEnC,KAAK,QAAQ;YACX,mFAAmF;YACnF,OAAO,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAEvC;YACE,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAsC,EACtC,EAAoC,EACpC,SAAqB,mBAAmB;IAExC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvC,IAAI,QAAQ,IAAI,MAAM;QAAE,OAAO,GAAG,QAAQ,MAAM,MAAM,EAAE,CAAC;IACzD,IAAI,QAAQ;QAAE,OAAO,QAAQ,QAAQ,EAAE,CAAC;IACxC,IAAI,MAAM;QAAE,OAAO,MAAM,MAAM,EAAE,CAAC;IAClC,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe,KAAK,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsC,EACtC,SAAqB,mBAAmB;IAExC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,uBAAuB;IACvB,IAAI,QAAc,CAAC;IACnB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,oFAAoF;QACpF,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9B,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAExD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QAEnC,KAAK,KAAK;YACR,OAAO,GAAG,GAAG,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAEnC,KAAK,KAAK;YACR,OAAO,GAAG,KAAK,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAEnC,KAAK,QAAQ;YACX,oFAAoF;YACpF,mFAAmF;YACnF,iFAAiF;YACjF,+BAA+B;YAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAEvC;YACE,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAsC,EACtC,EAAoC,EACpC,SAAqB,mBAAmB;IAExC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvC,IAAI,QAAQ,IAAI,MAAM;QAAE,OAAO,GAAG,QAAQ,MAAM,MAAM,EAAE,CAAC;IACzD,IAAI,QAAQ;QAAE,OAAO,QAAQ,QAAQ,EAAE,CAAC;IACxC,IAAI,MAAM;QAAE,OAAO,MAAM,MAAM,EAAE,CAAC;IAClC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/utils/index.d.ts

@@ -34,17 +34,31 @@ export declare function sleep(ms: number): Promise<void>;
 export declare function formatBytes(bytes: number, decimals?: number): string;
 export { format_date, format_date_range, DEFAULT_DATE_FORMAT, } from './dates.js';
 export type { DateFormat } from './dates.js';
+export { getPartialDatePrecision, isValidPartialDate, isPartialDateRange, parsePartialDate, formatPartialDate, serializePartialDate, comparePartialDate, formatPartialDateString, } from './partial_date.js';
+export type { PartialDatePrecision, PartialDateQualifier, PartialDateEra, PartialDate, PartialDateRange, ParsedPartialDate, } from './partial_date.js';
 export { withRetry } from './retry.js';
 export type { RetryOptions } from './retry.js';
 export { isUuid } from './uuid.js';
 export { createDebouncedSaver } from './debounced_saver.js';
 export type { DebouncedSaveContext, CreateDebouncedSaverOptions, DebouncedSaver, } from './debounced_saver.js';
+/**
+ * Best-effort load of `[format].locale` from `hazo_core_config.ini`. Cached
+ * per process; safe to call repeatedly. Exported (module-internal — not part
+ * of the public `hazo_core`/`hazo_core/client` surface) so tests can `await`
+ * it directly instead of polling. `configDir` is test-only; production calls
+ * always use `loadConfig`'s default (`process.cwd()/config`).
+ */
+export declare function __loadIniFormatLocaleForTests(configDir?: string): Promise<void>;
+/** Test-only: clear cached locale resolution state between test cases. */
+export declare function __resetFormatLocaleCacheForTests(): void;
 /**
  * Format a date as "28 May 2026"
+ * @deprecated Use hazo_i18n/format when available
  */
 export declare function formatDateShort(date: Date | string): string;
 /**
  * Format a date as "Wednesday, 28 May 2026"
+ * @deprecated Use hazo_i18n/format when available
  */
 export declare function formatDateLong(date: Date | string): string;
 /**
@@ -69,10 +83,12 @@ export interface FormatCurrencyOptions {
     compact?: boolean;
 }
 /**
- * Format a number as currency in `en-AU` locale.
+ * Format a number as currency. Locale defaults to `en-AU` — override via
+ * HAZO_CORE_FORMAT_LOCALE or hazo_core_config.ini's `[format].locale`.
  *
  * @param amount - The value to format.
  * @param options - {@link FormatCurrencyOptions} (currency, fractionDigits, absolute, compact).
+ * @deprecated Use hazo_i18n/format when available
  */
 export declare function formatCurrency(amount: number, options?: FormatCurrencyOptions): string;
 /**
@@ -80,18 +96,23 @@ export declare function formatCurrency(amount: number, options?: FormatCurrencyO
  *
  * @param fraction - Value in the 0–1 range (0.05 = 5%).
  * @param decimals - Fraction digits to show. Default 1.
+ * @deprecated Use hazo_i18n/format when available
  */
 export declare function formatPercent(fraction: number, decimals?: number): string;
 /**
- * Format a number with optional decimal places.
+ * Format a number with optional decimal places. Locale defaults to `en-AU` —
+ * override via HAZO_CORE_FORMAT_LOCALE or hazo_core_config.ini's
+ * `[format].locale`.
  * @example formatNumber(1234567.89) → "1,234,567.89"
  * @example formatNumber(1234567.89, 0) → "1,234,568"
+ * @deprecated Use hazo_i18n/format when available
  */
 export declare function formatNumber(n: number, decimals?: number): string;
 /**
  * Format a boolean as a human-readable string.
  * @example formatBoolean(true) → "Yes"
  * @example formatBoolean(false) → "No"
+ * @deprecated Use hazo_i18n/format when available — hardcodes "Yes"/"No" (English-only)
  */
 export declare function formatBoolean(val: boolean): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAMD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CASvE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMjE;AAMD;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAW/D;AAMD,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAMnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,GACf,MAAM,sBAAsB,CAAC;AAU9B;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAO3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAQ1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAM3D;AAMD;;;;GAIG;AACH,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;+CAC2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAU1F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAGpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjE;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAElD;AAMD;;;;;GAKG;AACH;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAQpE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.js

@@ -2,6 +2,10 @@
 // The type assertion avoids the TS2305 error when checked against the wrong installed version.
 import * as uuidPkg from 'uuid';
 const uuidv7 = uuidPkg['v7'];
+// zod is a plain dependency (no Node built-ins) so it's safe to import statically
+// here even though this file is also re-exported by the browser entry
+// (index.client.ts) — see the "Format locale resolution" section below.
+import { z } from 'zod';
 export { getCurrentEnv } from './env.js';
 // ---------------------------------------------------------------------------
 // Request ID generation
@@ -88,6 +92,10 @@ export function formatBytes(bytes, decimals = 2) {
 // ---------------------------------------------------------------------------
 export { format_date, format_date_range, DEFAULT_DATE_FORMAT, } from './dates.js';
 // ---------------------------------------------------------------------------
+// Partial/fuzzy dates (year-only, month-year, GEDCOM qualifiers, BCE, ranges)
+// ---------------------------------------------------------------------------
+export { getPartialDatePrecision, isValidPartialDate, isPartialDateRange, parsePartialDate, formatPartialDate, serializePartialDate, comparePartialDate, formatPartialDateString, } from './partial_date.js';
+// ---------------------------------------------------------------------------
 // Retry with backoff
 // ---------------------------------------------------------------------------
 export { withRetry } from './retry.js';
@@ -100,6 +108,102 @@ export { isUuid } from './uuid.js';
 // ---------------------------------------------------------------------------
 export { createDebouncedSaver } from './debounced_saver.js';
 // ---------------------------------------------------------------------------
+// Format locale resolution (FR-032 Stage 3)
+//
+// formatCurrency/formatNumber/formatDateShort/formatDateLong used to hardcode
+// the Intl locale to the literal 'en-AU'. This section makes that
+// configurable while defaulting to 'en-AU' so existing consumers see no
+// output change unless they opt in.
+//
+// Resolution order: HAZO_CORE_FORMAT_LOCALE env var > [format].locale in
+// hazo_core_config.ini (via loadConfig) > 'en-AU' default.
+//
+// The INI lookup goes through `loadConfig`, which pulls in `node:fs` /
+// `dotenv` (via ../config/index.js) — imports that must never land in the
+// browser bundle produced from this same file via index.client.ts. It is
+// therefore loaded with `optional_import`, not a static import, and — per
+// the 2.0.3 CHANGE_LOG entry — the specifier is passed as a *variable*
+// (`configModulePath`), not a string literal: Vite's import-analysis plugin
+// resolves literal dynamic-import specifiers before honoring
+// `@vite-ignore`/`webpackIgnore`/`turbopackIgnore`, so a literal would still
+// get eagerly bundled. In a real browser the load simply fails (no such
+// chunk to fetch); `optional_import` swallows that and formatters fall back
+// to the env var or default. Because the load is async, the INI value can
+// only take effect once it resolves — the very first formatter call(s) in a
+// process may still see the env-var-or-default value even when an INI
+// override exists; subsequent calls pick it up.
+// ---------------------------------------------------------------------------
+const DEFAULT_FORMAT_LOCALE = 'en-AU';
+const formatConfigSchema = z.object({
+    format: z
+        .object({
+        locale: z.string().optional(),
+    })
+        .prefault({}),
+});
+let cachedIniFormatLocale;
+let iniFormatLocalePromise = null;
+let warnedFormatLocale = false;
+/**
+ * Best-effort load of `[format].locale` from `hazo_core_config.ini`. Cached
+ * per process; safe to call repeatedly. Exported (module-internal — not part
+ * of the public `hazo_core`/`hazo_core/client` surface) so tests can `await`
+ * it directly instead of polling. `configDir` is test-only; production calls
+ * always use `loadConfig`'s default (`process.cwd()/config`).
+ */
+export function __loadIniFormatLocaleForTests(configDir) {
+    if (iniFormatLocalePromise)
+        return iniFormatLocalePromise;
+    const configModulePath = '../config/index.js';
+    iniFormatLocalePromise = optional_import(configModulePath).then((mod) => {
+        if (!mod)
+            return;
+        try {
+            // `configDir` is only ever passed by tests (production always uses
+            // loadConfig's cwd-based default) — when present, force a fresh read.
+            // loadConfig's cache key is `${pkg}:${env}` and does not include
+            // configDir, so without this, two tests pointing pkg 'core' at
+            // different temp directories would collide on the same cache entry.
+            if (configDir) {
+                mod.reloadConfig('core');
+            }
+            const config = mod.loadConfig({
+                pkg: 'core',
+                ...(configDir ? { configDir } : {}),
+                schema: formatConfigSchema,
+                envAliases: { 'format.locale': ['HAZO_CORE_FORMAT_LOCALE'] },
+            });
+            cachedIniFormatLocale = config.format.locale;
+        }
+        catch {
+            // Config unavailable or invalid — formatters fall back to env var/default.
+        }
+    });
+    return iniFormatLocalePromise;
+}
+/** Test-only: clear cached locale resolution state between test cases. */
+export function __resetFormatLocaleCacheForTests() {
+    cachedIniFormatLocale = undefined;
+    iniFormatLocalePromise = null;
+    warnedFormatLocale = false;
+}
+/**
+ * Resolve the BCP 47 locale used by formatCurrency/formatNumber/
+ * formatDateShort/formatDateLong. See the section comment above for
+ * resolution order and the async-INI caveat.
+ */
+function resolveFormatLocale() {
+    void __loadIniFormatLocaleForTests();
+    const locale = process.env['HAZO_CORE_FORMAT_LOCALE'] ?? cachedIniFormatLocale ?? DEFAULT_FORMAT_LOCALE;
+    if (process.env['NODE_ENV'] !== 'production' && !warnedFormatLocale) {
+        warnedFormatLocale = true;
+        console.warn(`[hazo_core] Number/currency/date formatters are using locale "${locale}". ` +
+            'Override via the HAZO_CORE_FORMAT_LOCALE env var or a [format].locale key in ' +
+            'hazo_core_config.ini. (This notice only appears outside production.)');
+    }
+    return locale;
+}
+// ---------------------------------------------------------------------------
 // Date formatters
 // ---------------------------------------------------------------------------
 function toDate(date) {
@@ -107,10 +211,11 @@ function toDate(date) {
 }
 /**
  * Format a date as "28 May 2026"
+ * @deprecated Use hazo_i18n/format when available
  */
 export function formatDateShort(date) {
     const d = toDate(date);
-    return d.toLocaleDateString('en-AU', {
+    return d.toLocaleDateString(resolveFormatLocale(), {
         day: 'numeric',
         month: 'short',
         year: 'numeric',
@@ -118,10 +223,11 @@ export function formatDateShort(date) {
 }
 /**
  * Format a date as "Wednesday, 28 May 2026"
+ * @deprecated Use hazo_i18n/format when available
  */
 export function formatDateLong(date) {
     const d = toDate(date);
-    return d.toLocaleDateString('en-AU', {
+    return d.toLocaleDateString(resolveFormatLocale(), {
         weekday: 'long',
         day: 'numeric',
         month: 'long',
@@ -139,15 +245,17 @@ export function formatDateSlash(date) {
     return `${day}/${month}/${year}`;
 }
 /**
- * Format a number as currency in `en-AU` locale.
+ * Format a number as currency. Locale defaults to `en-AU` — override via
+ * HAZO_CORE_FORMAT_LOCALE or hazo_core_config.ini's `[format].locale`.
  *
  * @param amount - The value to format.
  * @param options - {@link FormatCurrencyOptions} (currency, fractionDigits, absolute, compact).
+ * @deprecated Use hazo_i18n/format when available
  */
 export function formatCurrency(amount, options = {}) {
     const { currency = 'AUD', fractionDigits = 2, absolute = false, compact = false } = options;
     const value = absolute ? Math.abs(amount) : amount;
-    return new Intl.NumberFormat('en-AU', {
+    return new Intl.NumberFormat(resolveFormatLocale(), {
         style: 'currency',
         currency,
         minimumFractionDigits: fractionDigits,
@@ -160,18 +268,22 @@ export function formatCurrency(amount, options = {}) {
  *
  * @param fraction - Value in the 0–1 range (0.05 = 5%).
  * @param decimals - Fraction digits to show. Default 1.
+ * @deprecated Use hazo_i18n/format when available
  */
 export function formatPercent(fraction, decimals = 1) {
     const safe = Number.isFinite(fraction) ? fraction : 0;
     return `${(safe * 100).toFixed(decimals)}%`;
 }
 /**
- * Format a number with optional decimal places.
+ * Format a number with optional decimal places. Locale defaults to `en-AU` —
+ * override via HAZO_CORE_FORMAT_LOCALE or hazo_core_config.ini's
+ * `[format].locale`.
  * @example formatNumber(1234567.89) → "1,234,567.89"
  * @example formatNumber(1234567.89, 0) → "1,234,568"
+ * @deprecated Use hazo_i18n/format when available
  */
 export function formatNumber(n, decimals) {
-    return new Intl.NumberFormat('en-AU', {
+    return new Intl.NumberFormat(resolveFormatLocale(), {
         minimumFractionDigits: decimals,
         maximumFractionDigits: decimals,
     }).format(n);
@@ -183,6 +295,7 @@ export function formatNumber(n, decimals) {
  * Format a boolean as a human-readable string.
  * @example formatBoolean(true) → "Yes"
  * @example formatBoolean(false) → "No"
+ * @deprecated Use hazo_i18n/format when available — hardcodes "Yes"/"No" (English-only)
  */
 export function formatBoolean(val) {
     return val ? 'Yes' : 'No';

package/dist/utils/index.js.map

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

package/dist/utils/partial_date.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Pure helpers for genealogy-style partial/fuzzy dates (year-only, year-month,
+ * GEDCOM qualifiers ABT/BEF/AFT/EST/CAL, BET...AND ranges, BCE eras).
+ */
+export type PartialDatePrecision = 'year' | 'month' | 'day';
+export type PartialDateQualifier = 'circa' | 'before' | 'after' | 'estimated' | 'calculated';
+export type PartialDateEra = 'CE' | 'BCE';
+export interface PartialDate {
+    year: number;
+    month?: number;
+    day?: number;
+    qualifier?: PartialDateQualifier;
+    era?: PartialDateEra;
+}
+export interface PartialDateRange {
+    from: PartialDate;
+    to: PartialDate;
+}
+export type ParsedPartialDate = PartialDate | PartialDateRange | {
+    freeform: string;
+};
+/**
+ * Derives precision from which fields are populated. Precision is never
+ * stored on the object — it is always computed from month/day presence.
+ */
+export declare function getPartialDatePrecision(d: PartialDate): PartialDatePrecision;
+/**
+ * Structural invariants for a PartialDate:
+ * - year is a finite positive integer (BCE-ness is carried by `era`, never a negative year)
+ * - month, if present, is an integer 1-12
+ * - day, if present, is an integer 1-31 AND month must also be present
+ * - era, if present, is 'CE' or 'BCE'
+ * - qualifier, if present, is one of the 5 valid qualifiers
+ */
+export declare function isValidPartialDate(d: PartialDate): boolean;
+/** Type guard distinguishing a PartialDateRange from a plain PartialDate/freeform result. */
+export declare function isPartialDateRange(d: ParsedPartialDate): d is PartialDateRange;
+/**
+ * Parses a partial-date string. Tries, in order: strict ISO (YYYY, YYYY-MM,
+ * YYYY-MM-DD), GEDCOM `BET ... AND ...` ranges, GEDCOM qualifier prefixes
+ * (ABT/BEF/AFT/EST/CAL), then bare GEDCOM day/month/year/BCE. Empty or
+ * whitespace-only input returns null; unparseable non-empty input returns
+ * `{ freeform: <trimmed input> }`. Never throws.
+ */
+export declare function parsePartialDate(input: string): ParsedPartialDate | null;
+/**
+ * Renders a PartialDate/PartialDateRange for display. `opts.precision`, when
+ * given, may only coarsen the rendering (e.g. requesting 'year' on a
+ * day-precision date drops the month/day) — it can never invent detail finer
+ * than the value actually has, so a request finer than the value's own
+ * precision is clamped down to that own precision. Never mutates `d`.
+ */
+export declare function formatPartialDate(d: PartialDate | PartialDateRange, opts?: {
+    precision?: PartialDatePrecision;
+    locale?: string;
+}): string;
+/**
+ * Convenience wrapper for callers that hold a raw string rather than an
+ * already-parsed PartialDate (matches the shape of kinstripe's prior
+ * `formatPartialDate(s: string, opts)`, kept as a separate function here
+ * since #formatPartialDate now takes a PartialDate, not a string).
+ */
+export declare function formatPartialDateString(input: string, opts?: {
+    precision?: PartialDatePrecision;
+    locale?: string;
+}): string;
+/**
+ * Serializes a PartialDate/PartialDateRange back to a string. A plain date
+ * (no qualifier, no BCE era) round-trips through the ISO form; a qualified
+ * and/or BCE date round-trips through the GEDCOM form. `parsePartialDate`
+ * accepts the output of this function.
+ */
+export declare function serializePartialDate(d: PartialDate | PartialDateRange): string;
+/**
+ * Chronological comparator, like a standard `Array#sort` comparator
+ * (negative when `a` is earlier than `b`, zero when tied, positive when
+ * `a` is later). Each rule below applies only when every prior rule ties:
+ *
+ *  1. Era     — BCE sorts before CE.
+ *  2. Year    — within CE, smaller year is earlier; within BCE, a LARGER
+ *               year number is chronologically earlier (200 BCE happened
+ *               before 100 BCE, so it sorts first).
+ *  3. Month   — absent (coarser) sorts before present; otherwise numeric.
+ *  4. Day     — same rule as month.
+ *  5. Qualifier — 'before' sorts before no-qualifier/circa/estimated/
+ *               calculated, which all sort before 'after'. circa/estimated/
+ *               calculated/undefined are mutually equal at this step.
+ */
+export declare function comparePartialDate(a: PartialDate, b: PartialDate): number;
+//# sourceMappingURL=partial_date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"partial_date.d.ts","sourceRoot":"","sources":["../../src/utils/partial_date.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAC5D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC;AAC7F,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,KAAK,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,WAAW,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,gBAAgB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAiDtF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,WAAW,GAAG,oBAAoB,CAI5E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAa1D;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,GAAG,CAAC,IAAI,gBAAgB,CAE9E;AA0FD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAmBxE;AAWD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,WAAW,GAAG,gBAAgB,EACjC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CA8BR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CAKR;AAwCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,GAAG,gBAAgB,GAAG,MAAM,CAK9E;AAYD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,MAAM,CAwBzE"}

package/dist/utils/partial_date.js

@@ -0,0 +1,357 @@
+/**
+ * Pure helpers for genealogy-style partial/fuzzy dates (year-only, year-month,
+ * GEDCOM qualifiers ABT/BEF/AFT/EST/CAL, BET...AND ranges, BCE eras).
+ */
+// ---------------------------------------------------------------------------
+// Internal tables
+// ---------------------------------------------------------------------------
+const MONTH_ABBREVS = [
+    'JAN', 'FEB', 'MAR', 'APR', 'MAY', 'JUN', 'JUL', 'AUG', 'SEP', 'OCT', 'NOV', 'DEC',
+];
+const MONTH_ABBREV_TO_INDEX = Object.fromEntries(MONTH_ABBREVS.map((m, i) => [m, i + 1]));
+const QUALIFIER_PREFIX_TO_NAME = {
+    ABT: 'circa',
+    BEF: 'before',
+    AFT: 'after',
+    EST: 'estimated',
+    CAL: 'calculated',
+};
+const QUALIFIER_NAME_TO_PREFIX = {
+    circa: 'ABT',
+    before: 'BEF',
+    after: 'AFT',
+    estimated: 'EST',
+    calculated: 'CAL',
+};
+const QUALIFIER_WORD = {
+    circa: 'circa',
+    before: 'before',
+    after: 'after',
+    estimated: 'estimated',
+    calculated: 'calculated',
+};
+const VALID_QUALIFIERS = [
+    'circa', 'before', 'after', 'estimated', 'calculated',
+];
+const VALID_ERAS = ['CE', 'BCE'];
+const PRECISION_ORDER = { year: 0, month: 1, day: 2 };
+// ---------------------------------------------------------------------------
+// Precision / validity
+// ---------------------------------------------------------------------------
+/**
+ * Derives precision from which fields are populated. Precision is never
+ * stored on the object — it is always computed from month/day presence.
+ */
+export function getPartialDatePrecision(d) {
+    if (d.day !== undefined)
+        return 'day';
+    if (d.month !== undefined)
+        return 'month';
+    return 'year';
+}
+/**
+ * Structural invariants for a PartialDate:
+ * - year is a finite positive integer (BCE-ness is carried by `era`, never a negative year)
+ * - month, if present, is an integer 1-12
+ * - day, if present, is an integer 1-31 AND month must also be present
+ * - era, if present, is 'CE' or 'BCE'
+ * - qualifier, if present, is one of the 5 valid qualifiers
+ */
+export function isValidPartialDate(d) {
+    if (!d || typeof d !== 'object')
+        return false;
+    if (!Number.isInteger(d.year) || d.year <= 0)
+        return false;
+    if (d.month !== undefined && (!Number.isInteger(d.month) || d.month < 1 || d.month > 12)) {
+        return false;
+    }
+    if (d.day !== undefined) {
+        if (!Number.isInteger(d.day) || d.day < 1 || d.day > 31)
+            return false;
+        if (d.month === undefined)
+            return false;
+    }
+    if (d.era !== undefined && !VALID_ERAS.includes(d.era))
+        return false;
+    if (d.qualifier !== undefined && !VALID_QUALIFIERS.includes(d.qualifier))
+        return false;
+    return true;
+}
+/** Type guard distinguishing a PartialDateRange from a plain PartialDate/freeform result. */
+export function isPartialDateRange(d) {
+    return !!d && typeof d === 'object' && 'from' in d && 'to' in d;
+}
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parses a "bare" day/month/year expression with an optional trailing BCE
+ * suffix — no qualifier prefix. Shared by the standalone GEDCOM path and by
+ * each side of a BET...AND range.
+ */
+function parseBareDate(raw) {
+    let s = raw.trim();
+    if (!s)
+        return null;
+    let era;
+    const bceMatch = s.match(/^(.*?)\s+BCE$/i);
+    if (bceMatch) {
+        era = 'BCE';
+        s = bceMatch[1].trim();
+    }
+    const upper = s.toUpperCase();
+    let m = upper.match(/^(\d{1,2})\s+([A-Z]{3})\s+(\d{1,4})$/);
+    if (m) {
+        const monthIdx = MONTH_ABBREV_TO_INDEX[m[2]];
+        if (monthIdx === undefined)
+            return null;
+        const result = { year: parseInt(m[3], 10), month: monthIdx, day: parseInt(m[1], 10) };
+        if (era)
+            result.era = era;
+        return result;
+    }
+    m = upper.match(/^([A-Z]{3})\s+(\d{1,4})$/);
+    if (m) {
+        const monthIdx = MONTH_ABBREV_TO_INDEX[m[1]];
+        if (monthIdx === undefined)
+            return null;
+        const result = { year: parseInt(m[2], 10), month: monthIdx };
+        if (era)
+            result.era = era;
+        return result;
+    }
+    m = upper.match(/^(\d{1,4})$/);
+    if (m) {
+        const result = { year: parseInt(m[1], 10) };
+        if (era)
+            result.era = era;
+        return result;
+    }
+    return null;
+}
+/** Parses a strict ISO date (YYYY, YYYY-MM, or YYYY-MM-DD). */
+function parseIsoDate(s) {
+    const isoMatch = s.match(/^(\d{4})(-(\d{2})(-(\d{2}))?)?$/);
+    if (!isoMatch)
+        return null;
+    const candidate = { year: parseInt(isoMatch[1], 10) };
+    if (isoMatch[3])
+        candidate.month = parseInt(isoMatch[3], 10);
+    if (isoMatch[5])
+        candidate.day = parseInt(isoMatch[5], 10);
+    return isValidPartialDate(candidate) ? candidate : null;
+}
+/**
+ * Parses one "side" of a date expression: either a strict ISO date, or an
+ * optional GEDCOM qualifier prefix (ABT/BEF/AFT/EST/CAL) followed by a bare
+ * day/month/year/BCE expression. Used both standalone and recursively inside
+ * BET...AND ranges (a plain, non-qualified date serializes as ISO even
+ * inside a range, so ranges must accept ISO sides to round-trip).
+ */
+function parseGedcomSide(raw) {
+    const s = raw.trim();
+    if (!s)
+        return null;
+    const iso = parseIsoDate(s);
+    if (iso)
+        return iso;
+    const upper = s.toUpperCase();
+    const prefixMatch = upper.match(/^(ABT|BEF|AFT|EST|CAL)\s+(.+)$/);
+    if (prefixMatch) {
+        const qualifier = QUALIFIER_PREFIX_TO_NAME[prefixMatch[1]];
+        const bare = parseBareDate(prefixMatch[2]);
+        if (!bare)
+            return null;
+        const result = { ...bare, qualifier };
+        return isValidPartialDate(result) ? result : null;
+    }
+    const bare = parseBareDate(upper);
+    if (!bare)
+        return null;
+    return isValidPartialDate(bare) ? bare : null;
+}
+/**
+ * Parses a partial-date string. Tries, in order: strict ISO (YYYY, YYYY-MM,
+ * YYYY-MM-DD), GEDCOM `BET ... AND ...` ranges, GEDCOM qualifier prefixes
+ * (ABT/BEF/AFT/EST/CAL), then bare GEDCOM day/month/year/BCE. Empty or
+ * whitespace-only input returns null; unparseable non-empty input returns
+ * `{ freeform: <trimmed input> }`. Never throws.
+ */
+export function parsePartialDate(input) {
+    if (typeof input !== 'string')
+        return null;
+    const trimmed = input.trim();
+    if (trimmed === '')
+        return null;
+    const iso = parseIsoDate(trimmed);
+    if (iso)
+        return iso;
+    const betMatch = trimmed.match(/^BET\s+(.+?)\s+AND\s+(.+)$/i);
+    if (betMatch) {
+        const from = parseGedcomSide(betMatch[1]);
+        const to = parseGedcomSide(betMatch[2]);
+        if (from && to)
+            return { from, to };
+    }
+    const side = parseGedcomSide(trimmed);
+    if (side)
+        return side;
+    return { freeform: trimmed };
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+function monthName(month, locale) {
+    // Fixed dummy year — only the month field is ever read back out.
+    return new Intl.DateTimeFormat(locale, { month: 'long' }).format(new Date(2000, month - 1, 1));
+}
+/**
+ * Renders a PartialDate/PartialDateRange for display. `opts.precision`, when
+ * given, may only coarsen the rendering (e.g. requesting 'year' on a
+ * day-precision date drops the month/day) — it can never invent detail finer
+ * than the value actually has, so a request finer than the value's own
+ * precision is clamped down to that own precision. Never mutates `d`.
+ */
+export function formatPartialDate(d, opts) {
+    if (isPartialDateRange(d)) {
+        return `between ${formatPartialDate(d.from, opts)} and ${formatPartialDate(d.to, opts)}`;
+    }
+    const ownPrecision = getPartialDatePrecision(d);
+    let effectivePrecision = ownPrecision;
+    if (opts?.precision !== undefined && PRECISION_ORDER[opts.precision] < PRECISION_ORDER[ownPrecision]) {
+        effectivePrecision = opts.precision;
+    }
+    const locale = opts?.locale ?? 'en';
+    let datePart;
+    if (effectivePrecision === 'day') {
+        datePart = `${d.day} ${monthName(d.month, locale)} ${d.year}`;
+    }
+    else if (effectivePrecision === 'month') {
+        datePart = `${monthName(d.month, locale)} ${d.year}`;
+    }
+    else {
+        datePart = `${d.year}`;
+    }
+    if (d.era === 'BCE') {
+        datePart = `${datePart} BCE`;
+    }
+    if (d.qualifier) {
+        datePart = `${QUALIFIER_WORD[d.qualifier]} ${datePart}`;
+    }
+    return datePart;
+}
+/**
+ * Convenience wrapper for callers that hold a raw string rather than an
+ * already-parsed PartialDate (matches the shape of kinstripe's prior
+ * `formatPartialDate(s: string, opts)`, kept as a separate function here
+ * since #formatPartialDate now takes a PartialDate, not a string).
+ */
+export function formatPartialDateString(input, opts) {
+    const parsed = parsePartialDate(input);
+    if (parsed === null)
+        return '';
+    if ('freeform' in parsed)
+        return parsed.freeform;
+    return formatPartialDate(parsed, opts);
+}
+// ---------------------------------------------------------------------------
+// Serialization
+// ---------------------------------------------------------------------------
+function serializeSide(d) {
+    const pad = (n) => String(n).padStart(2, '0');
+    let core;
+    if (d.qualifier || d.era === 'BCE') {
+        // GEDCOM-flavoured rendering (month abbreviation, unpadded day).
+        if (d.day !== undefined && d.month !== undefined) {
+            core = `${d.day} ${MONTH_ABBREVS[d.month - 1]} ${d.year}`;
+        }
+        else if (d.month !== undefined) {
+            core = `${MONTH_ABBREVS[d.month - 1]} ${d.year}`;
+        }
+        else {
+            core = `${d.year}`;
+        }
+        if (d.qualifier) {
+            core = `${QUALIFIER_NAME_TO_PREFIX[d.qualifier]} ${core}`;
+        }
+    }
+    else {
+        // Plain ISO rendering.
+        if (d.day !== undefined && d.month !== undefined) {
+            core = `${d.year}-${pad(d.month)}-${pad(d.day)}`;
+        }
+        else if (d.month !== undefined) {
+            core = `${d.year}-${pad(d.month)}`;
+        }
+        else {
+            core = `${d.year}`;
+        }
+    }
+    if (d.era === 'BCE') {
+        core = `${core} BCE`;
+    }
+    return core;
+}
+/**
+ * Serializes a PartialDate/PartialDateRange back to a string. A plain date
+ * (no qualifier, no BCE era) round-trips through the ISO form; a qualified
+ * and/or BCE date round-trips through the GEDCOM form. `parsePartialDate`
+ * accepts the output of this function.
+ */
+export function serializePartialDate(d) {
+    if (isPartialDateRange(d)) {
+        return `BET ${serializeSide(d.from)} AND ${serializeSide(d.to)}`;
+    }
+    return serializeSide(d);
+}
+// ---------------------------------------------------------------------------
+// Comparison
+// ---------------------------------------------------------------------------
+function qualifierRank(q) {
+    if (q === 'before')
+        return -1;
+    if (q === 'after')
+        return 1;
+    return 0; // circa / estimated / calculated / undefined are mutually equal here
+}
+/**
+ * Chronological comparator, like a standard `Array#sort` comparator
+ * (negative when `a` is earlier than `b`, zero when tied, positive when
+ * `a` is later). Each rule below applies only when every prior rule ties:
+ *
+ *  1. Era     — BCE sorts before CE.
+ *  2. Year    — within CE, smaller year is earlier; within BCE, a LARGER
+ *               year number is chronologically earlier (200 BCE happened
+ *               before 100 BCE, so it sorts first).
+ *  3. Month   — absent (coarser) sorts before present; otherwise numeric.
+ *  4. Day     — same rule as month.
+ *  5. Qualifier — 'before' sorts before no-qualifier/circa/estimated/
+ *               calculated, which all sort before 'after'. circa/estimated/
+ *               calculated/undefined are mutually equal at this step.
+ */
+export function comparePartialDate(a, b) {
+    const eraA = a.era ?? 'CE';
+    const eraB = b.era ?? 'CE';
+    if (eraA !== eraB) {
+        return eraA === 'BCE' ? -1 : 1;
+    }
+    if (a.year !== b.year) {
+        return eraA === 'BCE' ? b.year - a.year : a.year - b.year;
+    }
+    if (a.month === undefined && b.month !== undefined)
+        return -1;
+    if (a.month !== undefined && b.month === undefined)
+        return 1;
+    if (a.month !== undefined && b.month !== undefined && a.month !== b.month) {
+        return a.month - b.month;
+    }
+    if (a.day === undefined && b.day !== undefined)
+        return -1;
+    if (a.day !== undefined && b.day === undefined)
+        return 1;
+    if (a.day !== undefined && b.day !== undefined && a.day !== b.day) {
+        return a.day - b.day;
+    }
+    return qualifierRank(a.qualifier) - qualifierRank(b.qualifier);
+}
+//# sourceMappingURL=partial_date.js.map

package/dist/utils/partial_date.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_core",
-  "version": "2.0.3",
+  "version": "2.3.0",
   "description": "Foundation package for all hazo_* packages — errors, correlation ID, config, logger, debug, singletons, utils",
   "type": "module",
   "main": "dist/index.js",