@noambz/app-utils 1.0.0

package/dist/dates.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Format a date for a specific timezone and locale.
+ * Defaults to "now" when no date is provided.
+ *
+ * @example formatDate("Asia/Jerusalem", "he-IL") // "30.3.2026, 14:05:30"
+ * @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.
+ */
+export declare function todayISO(tz?: string): string;
+/**
+ * Get the current time as HH:mm in the given timezone.
+ */
+export declare function timeHHMM(tz: string): string;
+/**
+ * Get both the calendar date (YYYY-MM-DD) and the hour (0-23)
+ * for a given point in time in a specific timezone.
+ *
+ * Useful for scheduling daily summaries / actions by local hour.
+ */
+export declare function getZonedDateAndHour(tz: string, when?: Date): {
+    dateKey: string;
+    hour: number;
+};
+//# sourceMappingURL=dates.d.ts.map

package/dist/dates.d.ts.map

@@ -0,0 +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"}

package/dist/dates.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nowFormatted = void 0;
+exports.formatDate = formatDate;
+exports.todayISO = todayISO;
+exports.timeHHMM = timeHHMM;
+exports.getZonedDateAndHour = getZonedDateAndHour;
+/**
+ * Format a date for a specific timezone and locale.
+ * Defaults to "now" when no date is provided.
+ *
+ * @example formatDate("Asia/Jerusalem", "he-IL") // "30.3.2026, 14:05:30"
+ * @example formatDate("Asia/Jerusalem", "he-IL", someDate)
+ */
+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.
+ */
+function todayISO(tz) {
+    if (!tz)
+        return new Date().toISOString().slice(0, 10);
+    const parts = new Intl.DateTimeFormat("en-CA", {
+        timeZone: tz,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    }).formatToParts(new Date());
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    return `${get("year")}-${get("month")}-${get("day")}`;
+}
+/**
+ * Get the current time as HH:mm in the given timezone.
+ */
+function timeHHMM(tz) {
+    return new Date().toLocaleTimeString("en-GB", {
+        timeZone: tz,
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+}
+/**
+ * Get both the calendar date (YYYY-MM-DD) and the hour (0-23)
+ * for a given point in time in a specific timezone.
+ *
+ * Useful for scheduling daily summaries / actions by local hour.
+ */
+function getZonedDateAndHour(tz, when = new Date()) {
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "numeric",
+        hour12: false,
+    }).formatToParts(when);
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    const y = get("year");
+    const m = get("month");
+    const d = get("day");
+    const hour = parseInt(get("hour"), 10);
+    return { dateKey: `${y}-${m}-${d}`, hour: Number.isNaN(hour) ? 0 : hour };
+}
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

@@ -0,0 +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"}

package/dist/fetch-retry.d.ts

@@ -0,0 +1,12 @@
+export interface FetchRetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    /** Optional log function called on retries. */
+    onRetry?: (attempt: number, delayMs: number, reason: string) => void;
+}
+/**
+ * Fetch with automatic retries on 429 (rate-limit) and network errors.
+ * Uses exponential backoff.
+ */
+export declare function fetchWithRetry(url: string, init?: RequestInit, options?: FetchRetryOptions): Promise<Response>;
+//# sourceMappingURL=fetch-retry.d.ts.map

package/dist/fetch-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-retry.d.ts","sourceRoot":"","sources":["../src/fetch-retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CA4BnB"}

package/dist/fetch-retry.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchWithRetry = fetchWithRetry;
+/**
+ * Fetch with automatic retries on 429 (rate-limit) and network errors.
+ * Uses exponential backoff.
+ */
+async function fetchWithRetry(url, init, options) {
+    const maxRetries = options?.maxRetries ?? 3;
+    const baseDelayMs = options?.baseDelayMs ?? 1000;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const res = await fetch(url, init);
+            if (res.status === 429 && attempt < maxRetries) {
+                const delay = baseDelayMs * Math.pow(2, attempt);
+                options?.onRetry?.(attempt + 1, delay, "429 rate-limited");
+                await sleep(delay);
+                continue;
+            }
+            return res;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            if (attempt < maxRetries) {
+                const delay = baseDelayMs * Math.pow(2, attempt);
+                options?.onRetry?.(attempt + 1, delay, lastError.message);
+                await sleep(delay);
+            }
+        }
+    }
+    throw lastError ?? new Error("fetchWithRetry exhausted all retries");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=fetch-retry.js.map

package/dist/fetch-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-retry.js","sourceRoot":"","sources":["../src/fetch-retry.ts"],"names":[],"mappings":";;AAWA,wCAgCC;AApCD;;;GAGG;AACI,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,IAAkB,EAClB,OAA2B;IAE3B,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IACjD,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAEnC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBAC/C,MAAM,KAAK,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACjD,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,GAAG,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;gBAC3D,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACjD,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC1D,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+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 { sleep } from "./sleep";
+export { checkRateLimit } from "./rate-limit";
+export type { RateLimitResult } from "./rate-limit";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,17 @@
+"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;
+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, "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; } });
+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; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/logger.d.ts

@@ -0,0 +1,12 @@
+import pino from "pino";
+export interface CreateLoggerOptions {
+    level?: string;
+    name?: string;
+}
+/**
+ * Create a pino logger with sensible defaults:
+ * - Level from `LOG_LEVEL` env or "info"
+ * - Pretty-printing in non-production
+ */
+export declare function createLogger(opts?: CreateLoggerOptions): pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAWpE"}

package/dist/logger.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const pino_1 = __importDefault(require("pino"));
+/**
+ * Create a pino logger with sensible defaults:
+ * - Level from `LOG_LEVEL` env or "info"
+ * - Pretty-printing in non-production
+ */
+function createLogger(opts) {
+    return (0, pino_1.default)({
+        level: opts?.level ?? process.env.LOG_LEVEL ?? "info",
+        ...(opts?.name && { name: opts.name }),
+        ...(process.env.NODE_ENV !== "production" && {
+            transport: {
+                target: "pino-pretty",
+                options: { colorize: true },
+            },
+        }),
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;;;AAYA,oCAWC;AAvBD,gDAAwB;AAOxB;;;;GAIG;AACH,SAAgB,YAAY,CAAC,IAA0B;IACrD,OAAO,IAAA,cAAI,EAAC;QACV,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACrD,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACtC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI;YAC3C,SAAS,EAAE;gBACT,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC5B;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/rate-limit.d.ts

@@ -0,0 +1,14 @@
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: number;
+}
+/**
+ * In-memory sliding-window rate limiter.
+ *
+ * @param key    - Unique identifier (e.g. `"login:${chatId}"`).
+ * @param max    - Maximum attempts within the window.
+ * @param windowMs - Window duration in milliseconds.
+ */
+export declare function checkRateLimit(key: string, max: number, windowMs: number): RateLimitResult;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,eAAe,CAgBjB"}

package/dist/rate-limit.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkRateLimit = checkRateLimit;
+const store = new Map();
+const CLEANUP_INTERVAL = 60_000;
+let lastCleanup = Date.now();
+function cleanup() {
+    const now = Date.now();
+    if (now - lastCleanup < CLEANUP_INTERVAL)
+        return;
+    lastCleanup = now;
+    for (const [key, entry] of store) {
+        if (entry.resetAt <= now)
+            store.delete(key);
+    }
+}
+/**
+ * In-memory sliding-window rate limiter.
+ *
+ * @param key    - Unique identifier (e.g. `"login:${chatId}"`).
+ * @param max    - Maximum attempts within the window.
+ * @param windowMs - Window duration in milliseconds.
+ */
+function checkRateLimit(key, max, windowMs) {
+    cleanup();
+    const now = Date.now();
+    const entry = store.get(key);
+    if (!entry || entry.resetAt <= now) {
+        store.set(key, { count: 1, resetAt: now + windowMs });
+        return { allowed: true, remaining: max - 1, resetAt: now + windowMs };
+    }
+    if (entry.count >= max) {
+        return { allowed: false, remaining: 0, resetAt: entry.resetAt };
+    }
+    entry.count++;
+    return { allowed: true, remaining: max - entry.count, resetAt: entry.resetAt };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":";;AA2BA,wCAoBC;AAzCD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8C,CAAC;AAEpE,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,IAAI,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAE7B,SAAS,OAAO;IACd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,WAAW,GAAG,gBAAgB;QAAE,OAAO;IACjD,WAAW,GAAG,GAAG,CAAC;IAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,GAAW,EACX,GAAW,EACX,QAAgB;IAEhB,OAAO,EAAE,CAAC;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE7B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;QACnC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAC;IACxE,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;AACjF,CAAC"}

package/dist/sleep.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Promise-based delay.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../src/sleep.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/sleep.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+/**
+ * Promise-based delay.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../src/sleep.ts"],"names":[],"mappings":";;AAGA,sBAEC;AALD;;GAEG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@noambz/app-utils",
+  "version": "1.0.0",
+  "description": "Shared utilities: logger, fetchWithRetry, timezone helpers, sleep, rate limiter",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "utils",
+    "logger",
+    "fetch",
+    "timezone"
+  ],
+  "author": "noambz",
+  "license": "MIT",
+  "dependencies": {
+    "pino": "^10.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "pino-pretty": "^13.1.3",
+    "typescript": "^5.7.0"
+  }
+}