Initialize the API and add managed app banners.

Co-authored-by: Cursor <cursoragent@cursor.com>

src/common/utils/tehran-time.ts

@@ -0,0 +1,42 @@
+/**
+ * محاسبات تقویمی باید مستقل از تایم‌زون سرور باشد؛ کانتینرها روی UTC اجرا می‌شوند.
+ * ایران از ۱۴۰۱ تغییر ساعت تابستانی ندارد، پس آفست ثابت +۰۳:۳۰ درست است.
+ */
+const TEHRAN_OFFSET_MS = (3 * 60 + 30) * 60 * 1000;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+function utcStartOfDay(date: Date): Date {
+  const d = new Date(date);
+  d.setUTCHours(0, 0, 0, 0);
+  return d;
+}
+
+/**
+ * روز تقویمی تهرانِ یک لحظه را به‌صورت نیمه‌شب UTC همان روز برمی‌گرداند.
+ * خروجی برای اختلاف‌گیری روزانه و سریال‌سازی `YYYY-MM-DD` امن است.
+ */
+export function tehranCalendarDay(date: Date): Date {
+  return utcStartOfDay(new Date(date.getTime() + TEHRAN_OFFSET_MS));
+}
+
+/** تاریخ سررسید فقط-روز است و نیمه‌شب UTC ذخیره می‌شود. */
+export function calendarDayOf(date: Date | string): Date {
+  return utcStartOfDay(new Date(date));
+}
+
+export function addDays(date: Date, days: number): Date {
+  return new Date(date.getTime() + days * DAY_MS);
+}
+
+export function diffInDays(from: Date, to: Date): number {
+  return Math.round((to.getTime() - from.getTime()) / DAY_MS);
+}
+
+/** لحظه‌ای که در تهران ساعتِ داده‌شده از همان روزِ تقویمی است. */
+export function tehranAtHour(date: Date, hour: number): Date {
+  return new Date(
+    tehranCalendarDay(date).getTime() +
+      hour * 60 * 60 * 1000 -
+      TEHRAN_OFFSET_MS,
+  );
+}