@noambz/app-utils 1.0.0 → 1.2.0

package/dist/dates.d.ts

@@ -6,8 +6,6 @@
  * @example formatDate("Asia/Jerusalem", "he-IL", someDate)
  */
 export declare function formatDate(tz: string, locale?: string, date?: Date): string;
-/** @deprecated Use `formatDate` instead. */
-export declare const nowFormatted: typeof formatDate;
 /**
  * Get today's date as an ISO string (YYYY-MM-DD) in the given timezone.
  * Falls back to UTC if no timezone is provided.
@@ -27,4 +25,26 @@ export declare function getZonedDateAndHour(tz: string, when?: Date): {
     dateKey: string;
     hour: number;
 };
+export interface DateHelpers {
+    now(): string;
+    format(date: Date): string;
+    todayISO(): string;
+    timeHHMM(): string;
+    getZonedDateAndHour(when?: Date): {
+        dateKey: string;
+        hour: number;
+    };
+}
+/**
+ * Create timezone+locale-bound date helpers so each app doesn't need
+ * to pass tz/locale on every call.
+ *
+ * @example
+ * const il = createDateHelpers({ tz: "Asia/Jerusalem", locale: "he-IL" });
+ * il.now() // "30.3.2026, 14:05:30"
+ */
+export declare function createDateHelpers(defaults: {
+    tz: string;
+    locale?: string;
+}): DateHelpers;
 //# sourceMappingURL=dates.d.ts.map

package/dist/dates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAU,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAE5E;AAED,4CAA4C;AAC5C,eAAO,MAAM,YAAY,mBAAa,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,IAAiB,GACtB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgBnC"}
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAU,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAE5E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,IAAiB,GACtB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgBnC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,IAAI,MAAM,CAAC;IACd,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IAC3B,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,IAAI,MAAM,CAAC;IACnB,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,WAAW,CASd"}

package/dist/dates.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.nowFormatted = void 0;
 exports.formatDate = formatDate;
 exports.todayISO = todayISO;
 exports.timeHHMM = timeHHMM;
 exports.getZonedDateAndHour = getZonedDateAndHour;
+exports.createDateHelpers = createDateHelpers;
 /**
  * Format a date for a specific timezone and locale.
  * Defaults to "now" when no date is provided.
@@ -15,8 +15,6 @@ exports.getZonedDateAndHour = getZonedDateAndHour;
 function formatDate(tz, locale = "en-GB", date) {
     return (date ?? new Date()).toLocaleString(locale, { timeZone: tz });
 }
-/** @deprecated Use `formatDate` instead. */
-exports.nowFormatted = formatDate;
 /**
  * Get today's date as an ISO string (YYYY-MM-DD) in the given timezone.
  * Falls back to UTC if no timezone is provided.
@@ -66,4 +64,22 @@ function getZonedDateAndHour(tz, when = new Date()) {
     const hour = parseInt(get("hour"), 10);
     return { dateKey: `${y}-${m}-${d}`, hour: Number.isNaN(hour) ? 0 : hour };
 }
+/**
+ * Create timezone+locale-bound date helpers so each app doesn't need
+ * to pass tz/locale on every call.
+ *
+ * @example
+ * const il = createDateHelpers({ tz: "Asia/Jerusalem", locale: "he-IL" });
+ * il.now() // "30.3.2026, 14:05:30"
+ */
+function createDateHelpers(defaults) {
+    const { tz, locale = "en-GB" } = defaults;
+    return {
+        now: () => formatDate(tz, locale),
+        format: (date) => formatDate(tz, locale, date),
+        todayISO: () => todayISO(tz),
+        timeHHMM: () => timeHHMM(tz),
+        getZonedDateAndHour: (when) => getZonedDateAndHour(tz, when),
+    };
+}
 //# sourceMappingURL=dates.js.map

package/dist/dates.js.map

@@ -1 +1 @@
-{"version":3,"file":"dates.js","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":";;;AAOA,gCAEC;AASD,4BAUC;AAKD,4BAOC;AAQD,kDAmBC;AAnED;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,EAAU,EAAE,MAAM,GAAG,OAAO,EAAE,IAAW;IAClE,OAAO,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,4CAA4C;AAC/B,QAAA,YAAY,GAAG,UAAU,CAAC;AAEvC;;;GAGG;AACH,SAAgB,QAAQ,CAAC,EAAW;IAClC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC7C,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;KACf,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IAC9E,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,EAAU;IACjC,OAAO,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC5C,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,EAAU,EACV,OAAa,IAAI,IAAI,EAAE;IAEvB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC7C,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,KAAK;KACd,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAEvB,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IAC9E,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"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"}

package/dist/env.d.ts

@@ -0,0 +1,21 @@
+interface ZodLikeIssue {
+    path: (string | number)[];
+    message: string;
+}
+interface ZodLikeResult<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        issues: ZodLikeIssue[];
+    };
+}
+interface ZodLikeSchema<T> {
+    safeParse(data: unknown): ZodLikeResult<T>;
+}
+/**
+ * Validate `process.env` against a Zod schema.
+ * Returns the parsed config on success; throws a formatted error on failure.
+ */
+export declare function validateEnv<T>(schema: ZodLikeSchema<T>): T;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa,CAAC,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC;CACpC;AAED,UAAU,aAAa,CAAC,CAAC;IACvB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAQ1D"}

package/dist/env.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEnv = validateEnv;
+/**
+ * Validate `process.env` against a Zod schema.
+ * Returns the parsed config on success; throws a formatted error on failure.
+ */
+function validateEnv(schema) {
+    const result = schema.safeParse(process.env);
+    if (result.success)
+        return result.data;
+    const formatted = result.error.issues
+        .map((i) => `  ${i.path.join(".")}: ${i.message}`)
+        .join("\n");
+    throw new Error(`Environment validation failed:\n${formatted}`);
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":";;AAmBA,kCAQC;AAZD;;;GAGG;AACH,SAAgB,WAAW,CAAI,MAAwB;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAK,CAAC;IAExC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAM,CAAC,MAAM;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/health.d.ts

@@ -0,0 +1,20 @@
+export type HealthStatus = "ok" | "degraded" | "error";
+export interface CheckResult {
+    ok: boolean;
+    degraded?: boolean;
+    detail?: string;
+}
+export type HealthCheckFn = () => CheckResult | Promise<CheckResult>;
+export interface HealthCheckResult {
+    status: HealthStatus;
+    timestamp: string;
+    checks: Record<string, CheckResult>;
+}
+/**
+ * Run all named health checks and aggregate into a single status.
+ * Any check returning `ok: false` sets status to "error".
+ * Any check returning `degraded: true` (with `ok: true`) sets status to "degraded".
+ */
+export declare function runHealthChecks(checks: Record<string, HealthCheckFn>): Promise<HealthCheckResult>;
+export declare function healthStatusCode(status: HealthStatus): number;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAuB5B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE7D"}

package/dist/health.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHealthChecks = runHealthChecks;
+exports.healthStatusCode = healthStatusCode;
+/**
+ * Run all named health checks and aggregate into a single status.
+ * Any check returning `ok: false` sets status to "error".
+ * Any check returning `degraded: true` (with `ok: true`) sets status to "degraded".
+ */
+async function runHealthChecks(checks) {
+    let status = "ok";
+    const results = {};
+    for (const [name, fn] of Object.entries(checks)) {
+        try {
+            const result = await fn();
+            results[name] = result;
+            if (!result.ok) {
+                status = "error";
+            }
+            else if (result.degraded && status !== "error") {
+                status = "degraded";
+            }
+        }
+        catch (err) {
+            results[name] = {
+                ok: false,
+                detail: err instanceof Error ? err.message : "unknown error",
+            };
+            status = "error";
+        }
+    }
+    return { status, timestamp: new Date().toISOString(), checks: results };
+}
+function healthStatusCode(status) {
+    return status === "error" ? 503 : 200;
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":";;AAqBA,0CAyBC;AAED,4CAEC;AAlCD;;;;GAIG;AACI,KAAK,UAAU,eAAe,CACnC,MAAqC;IAErC,IAAI,MAAM,GAAiB,IAAI,CAAC;IAChC,MAAM,OAAO,GAAgC,EAAE,CAAC;IAEhD,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,GAAG,OAAO,CAAC;YACnB,CAAC;iBAAM,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACjD,MAAM,GAAG,UAAU,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,GAAG;gBACd,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAC7D,CAAC;YACF,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1E,CAAC;AAED,SAAgB,gBAAgB,CAAC,MAAoB;IACnD,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -2,8 +2,16 @@ export { createLogger } from "./logger";
 export type { CreateLoggerOptions } from "./logger";
 export { fetchWithRetry } from "./fetch-retry";
 export type { FetchRetryOptions } from "./fetch-retry";
-export { nowFormatted, todayISO, timeHHMM, getZonedDateAndHour } from "./dates";
+export { formatDate, todayISO, timeHHMM, getZonedDateAndHour, createDateHelpers } from "./dates";
+export type { DateHelpers } from "./dates";
 export { sleep } from "./sleep";
 export { checkRateLimit } from "./rate-limit";
 export type { RateLimitResult } from "./rate-limit";
+export { runHealthChecks, healthStatusCode } from "./health";
+export { validateEnv } from "./env";
+export { createSqliteKVStore, createJsonFileKVStore } from "./kv";
+export type { KVStore } from "./kv";
+export { initSqlitePragmas, backupSqliteDb, pruneOldBackups } from "./sqlite";
+export type { SqlitePragmaDb, SqliteBackupDb, InitSqliteOptions, BackupSqliteOptions, } from "./sqlite";
+export type { HealthStatus, CheckResult, HealthCheckFn, HealthCheckResult, } from "./health";
 //# 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,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjG,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,MAAM,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9E,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,17 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkRateLimit = exports.sleep = exports.getZonedDateAndHour = exports.timeHHMM = exports.todayISO = exports.nowFormatted = exports.fetchWithRetry = exports.createLogger = void 0;
+exports.pruneOldBackups = exports.backupSqliteDb = exports.initSqlitePragmas = exports.createJsonFileKVStore = exports.createSqliteKVStore = exports.validateEnv = exports.healthStatusCode = exports.runHealthChecks = exports.checkRateLimit = exports.sleep = exports.createDateHelpers = exports.getZonedDateAndHour = exports.timeHHMM = exports.todayISO = exports.formatDate = exports.fetchWithRetry = exports.createLogger = void 0;
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
 var fetch_retry_1 = require("./fetch-retry");
 Object.defineProperty(exports, "fetchWithRetry", { enumerable: true, get: function () { return fetch_retry_1.fetchWithRetry; } });
 var dates_1 = require("./dates");
-Object.defineProperty(exports, "nowFormatted", { enumerable: true, get: function () { return dates_1.nowFormatted; } });
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return dates_1.formatDate; } });
 Object.defineProperty(exports, "todayISO", { enumerable: true, get: function () { return dates_1.todayISO; } });
 Object.defineProperty(exports, "timeHHMM", { enumerable: true, get: function () { return dates_1.timeHHMM; } });
 Object.defineProperty(exports, "getZonedDateAndHour", { enumerable: true, get: function () { return dates_1.getZonedDateAndHour; } });
+Object.defineProperty(exports, "createDateHelpers", { enumerable: true, get: function () { return dates_1.createDateHelpers; } });
 var sleep_1 = require("./sleep");
 Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return sleep_1.sleep; } });
 var rate_limit_1 = require("./rate-limit");
 Object.defineProperty(exports, "checkRateLimit", { enumerable: true, get: function () { return rate_limit_1.checkRateLimit; } });
+var health_1 = require("./health");
+Object.defineProperty(exports, "runHealthChecks", { enumerable: true, get: function () { return health_1.runHealthChecks; } });
+Object.defineProperty(exports, "healthStatusCode", { enumerable: true, get: function () { return health_1.healthStatusCode; } });
+var env_1 = require("./env");
+Object.defineProperty(exports, "validateEnv", { enumerable: true, get: function () { return env_1.validateEnv; } });
+var kv_1 = require("./kv");
+Object.defineProperty(exports, "createSqliteKVStore", { enumerable: true, get: function () { return kv_1.createSqliteKVStore; } });
+Object.defineProperty(exports, "createJsonFileKVStore", { enumerable: true, get: function () { return kv_1.createJsonFileKVStore; } });
+var sqlite_1 = require("./sqlite");
+Object.defineProperty(exports, "initSqlitePragmas", { enumerable: true, get: function () { return sqlite_1.initSqlitePragmas; } });
+Object.defineProperty(exports, "backupSqliteDb", { enumerable: true, get: function () { return sqlite_1.backupSqliteDb; } });
+Object.defineProperty(exports, "pruneOldBackups", { enumerable: true, get: function () { return sqlite_1.pruneOldBackups; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AAGrB,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AAGvB,iCAAgF;AAAvE,qGAAA,YAAY,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAE9D,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd,2CAA8C;AAArC,4GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AAGrB,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AAGvB,iCAAiG;AAAxF,mGAAA,UAAU,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAG/E,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAGvB,mCAA6D;AAApD,yGAAA,eAAe,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAE1C,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AAEpB,2BAAkE;AAAzD,yGAAA,mBAAmB,OAAA;AAAE,2GAAA,qBAAqB,OAAA;AAGnD,mCAA8E;AAArE,2GAAA,iBAAiB,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,yGAAA,eAAe,OAAA"}

package/dist/kv.d.ts

@@ -0,0 +1,29 @@
+export interface KVStore {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+}
+/**
+ * Minimal SQLite db shape needed by the KV store.
+ * Compatible with better-sqlite3's Database.
+ */
+interface SqliteKVDb {
+    prepare(sql: string): {
+        get(...params: unknown[]): {
+            value: string;
+        } | undefined;
+        run(...params: unknown[]): unknown;
+    };
+}
+/**
+ * KV store backed by a SQLite table with `key TEXT PRIMARY KEY, value TEXT`.
+ * The table must already exist.
+ */
+export declare function createSqliteKVStore(db: SqliteKVDb, table?: string): KVStore;
+/**
+ * KV store backed by a single JSON file `{ [key]: value }`.
+ * Reads the entire file on each `get`, writes on each `set`/`delete`.
+ */
+export declare function createJsonFileKVStore(filePath: string): KVStore;
+export {};
+//# sourceMappingURL=kv.d.ts.map

package/dist/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,UAAU,UAAU;IAClB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QACpB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC;QACzD,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;KACpC,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,UAAU,EACd,KAAK,SAAO,GACX,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA8B/D"}

package/dist/kv.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSqliteKVStore = createSqliteKVStore;
+exports.createJsonFileKVStore = createJsonFileKVStore;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * KV store backed by a SQLite table with `key TEXT PRIMARY KEY, value TEXT`.
+ * The table must already exist.
+ */
+function createSqliteKVStore(db, table = "kv") {
+    return {
+        get(key) {
+            const row = db.prepare(`SELECT value FROM ${table} WHERE key = ?`).get(key);
+            return row?.value ?? null;
+        },
+        set(key, value) {
+            db.prepare(`INSERT OR REPLACE INTO ${table} (key, value) VALUES (?, ?)`).run(key, value);
+        },
+        delete(key) {
+            db.prepare(`DELETE FROM ${table} WHERE key = ?`).run(key);
+        },
+    };
+}
+/**
+ * KV store backed by a single JSON file `{ [key]: value }`.
+ * Reads the entire file on each `get`, writes on each `set`/`delete`.
+ */
+function createJsonFileKVStore(filePath) {
+    function read() {
+        try {
+            return JSON.parse((0, fs_1.readFileSync)(filePath, "utf-8"));
+        }
+        catch {
+            return {};
+        }
+    }
+    function write(data) {
+        const dir = (0, path_1.dirname)(filePath);
+        if (!(0, fs_1.existsSync)(dir))
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+        (0, fs_1.writeFileSync)(filePath, JSON.stringify(data, null, 2), "utf-8");
+    }
+    return {
+        get(key) {
+            return read()[key] ?? null;
+        },
+        set(key, value) {
+            const data = read();
+            data[key] = value;
+            write(data);
+        },
+        delete(key) {
+            const data = read();
+            delete data[key];
+            write(data);
+        },
+    };
+}
+//# sourceMappingURL=kv.js.map

package/dist/kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.js","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":";;AAwBA,kDAgBC;AAMD,sDA8BC;AA5ED,2BAAwE;AACxE,+BAA+B;AAmB/B;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,EAAc,EACd,KAAK,GAAG,IAAI;IAEZ,OAAO;QACL,GAAG,CAAC,GAAW;YACb,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qBAAqB,KAAK,gBAAgB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5E,OAAO,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;QAC5B,CAAC;QACD,GAAG,CAAC,GAAW,EAAE,KAAa;YAC5B,EAAE,CAAC,OAAO,CAAC,0BAA0B,KAAK,6BAA6B,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,CAAC,GAAW;YAChB,EAAE,CAAC,OAAO,CAAC,eAAe,KAAK,gBAAgB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,QAAgB;IACpD,SAAS,IAAI;QACX,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,SAAS,KAAK,CAAC,IAA4B;QACzC,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC;YAAE,IAAA,cAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAA,kBAAa,EAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,GAAG,CAAC,GAAW;YACb,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,GAAW,EAAE,KAAa;YAC5B,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,CAAC;QACd,CAAC;QACD,MAAM,CAAC,GAAW;YAChB,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sqlite.d.ts

@@ -0,0 +1,29 @@
+export interface SqlitePragmaDb {
+    pragma(statement: string): unknown;
+}
+export interface SqliteBackupDb {
+    backup(destPath: string): Promise<unknown>;
+}
+export interface InitSqliteOptions {
+    wal?: boolean;
+    foreignKeys?: boolean;
+    busyTimeout?: number;
+}
+/**
+ * Apply standard pragmas (WAL, foreign keys, busy timeout) to a better-sqlite3 Database.
+ */
+export declare function initSqlitePragmas(db: SqlitePragmaDb, options?: InitSqliteOptions): void;
+export interface BackupSqliteOptions {
+    prefix?: string;
+    maxBackups?: number;
+}
+/**
+ * Create a timestamped SQLite backup using the better-sqlite3 backup() API.
+ * Returns the backup file path, or null if backup failed.
+ */
+export declare function backupSqliteDb(db: SqliteBackupDb, backupDir: string, options?: BackupSqliteOptions): Promise<string | null>;
+/**
+ * Remove old backup files, keeping the most recent `keep` files.
+ */
+export declare function pruneOldBackups(dir: string, prefix: string, keep: number): string[];
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE,iBAAsB,GAC9B,IAAI,CAKN;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAgBV"}

package/dist/sqlite.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initSqlitePragmas = initSqlitePragmas;
+exports.backupSqliteDb = backupSqliteDb;
+exports.pruneOldBackups = pruneOldBackups;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Apply standard pragmas (WAL, foreign keys, busy timeout) to a better-sqlite3 Database.
+ */
+function initSqlitePragmas(db, options = {}) {
+    const { wal = true, foreignKeys = true, busyTimeout = 5000 } = options;
+    if (wal)
+        db.pragma("journal_mode = WAL");
+    if (foreignKeys)
+        db.pragma("foreign_keys = ON");
+    if (busyTimeout > 0)
+        db.pragma(`busy_timeout = ${busyTimeout}`);
+}
+/**
+ * Create a timestamped SQLite backup using the better-sqlite3 backup() API.
+ * Returns the backup file path, or null if backup failed.
+ */
+async function backupSqliteDb(db, backupDir, options = {}) {
+    const { prefix = "backup", maxBackups = 7 } = options;
+    if (!fs_1.default.existsSync(backupDir)) {
+        fs_1.default.mkdirSync(backupDir, { recursive: true });
+    }
+    const ts = new Date().toISOString().slice(0, 19).replace(/[T:]/g, "-");
+    const backupPath = path_1.default.join(backupDir, `${prefix}-${ts}.db`);
+    await db.backup(backupPath);
+    pruneOldBackups(backupDir, prefix, maxBackups);
+    return backupPath;
+}
+/**
+ * Remove old backup files, keeping the most recent `keep` files.
+ */
+function pruneOldBackups(dir, prefix, keep) {
+    if (!fs_1.default.existsSync(dir))
+        return [];
+    const files = fs_1.default
+        .readdirSync(dir)
+        .filter((f) => f.startsWith(`${prefix}-`) && f.endsWith(".db"))
+        .sort()
+        .reverse();
+    const removed = [];
+    for (const file of files.slice(keep)) {
+        const filePath = path_1.default.join(dir, file);
+        fs_1.default.unlinkSync(filePath);
+        removed.push(file);
+    }
+    return removed;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":";;;;;AAoBA,8CAQC;AAWD,wCAiBC;AAKD,0CAoBC;AAjFD,4CAAoB;AACpB,gDAAwB;AAgBxB;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,EAAkB,EAClB,UAA6B,EAAE;IAE/B,MAAM,EAAE,GAAG,GAAG,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACvE,IAAI,GAAG;QAAE,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACzC,IAAI,WAAW;QAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,WAAW,GAAG,CAAC;QAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC;AAOD;;;GAGG;AACI,KAAK,UAAU,cAAc,CAClC,EAAkB,EAClB,SAAiB,EACjB,UAA+B,EAAE;IAEjC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,UAAU,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAEtD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC;IAE9D,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC7B,GAAW,EACX,MAAc,EACd,IAAY;IAEZ,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,YAAE;SACb,WAAW,CAAC,GAAG,CAAC;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC9D,IAAI,EAAE;SACN,OAAO,EAAE,CAAC;IAEb,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@noambz/app-utils",
-  "version": "1.0.0",
-  "description": "Shared utilities: logger, fetchWithRetry, timezone helpers, sleep, rate limiter",
+  "version": "1.2.0",
+  "description": "Shared utilities: logger, fetchWithRetry, timezone helpers, sleep, rate limiter, health checks, SQLite, KV store, env validation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {