@teamvibe/poller 0.4.3 → 0.4.4

package/dist/config.d.ts

@@ -28,7 +28,7 @@ declare const configSchema: z.ZodObject<{
     BASE_BRAIN_PATH: z.ZodDefault<z.ZodString>;
     BRAIN_AUTO_UPDATE: z.ZodEffects<z.ZodDefault<z.ZodString>, boolean, string | undefined>;
     BRAIN_UPDATE_COOLDOWN_MS: z.ZodDefault<z.ZodNumber>;
-    POLLER_TZ: z.ZodDefault<z.ZodString>;
+    POLLER_TZ: z.ZodOptional<z.ZodString>;
     HEARTBEAT_CRON: z.ZodDefault<z.ZodString>;
     MAINTENANCE_CRON: z.ZodDefault<z.ZodString>;
     MAINTENANCE_ENABLED: z.ZodEffects<z.ZodDefault<z.ZodString>, boolean, string | undefined>;
@@ -59,7 +59,6 @@ declare const configSchema: z.ZodObject<{
     BASE_BRAIN_PATH: string;
     BRAIN_AUTO_UPDATE: boolean;
     BRAIN_UPDATE_COOLDOWN_MS: number;
-    POLLER_TZ: string;
     HEARTBEAT_CRON: string;
     MAINTENANCE_CRON: string;
     MAINTENANCE_ENABLED: boolean;
@@ -68,6 +67,7 @@ declare const configSchema: z.ZodObject<{
     SQS_QUEUE_URL?: string | undefined;
     SESSIONS_TABLE?: string | undefined;
     TEAMVIBE_POLLER_TOKEN?: string | undefined;
+    POLLER_TZ?: string | undefined;
 }, {
     AWS_REGION?: string | undefined;
     SQS_QUEUE_URL?: string | undefined;
@@ -130,7 +130,6 @@ export declare const config: {
     BASE_BRAIN_PATH: string;
     BRAIN_AUTO_UPDATE: boolean;
     BRAIN_UPDATE_COOLDOWN_MS: number;
-    POLLER_TZ: string;
     HEARTBEAT_CRON: string;
     MAINTENANCE_CRON: string;
     MAINTENANCE_ENABLED: boolean;
@@ -139,5 +138,6 @@ export declare const config: {
     SQS_QUEUE_URL?: string | undefined;
     SESSIONS_TABLE?: string | undefined;
     TEAMVIBE_POLLER_TOKEN?: string | undefined;
+    POLLER_TZ?: string | undefined;
 };
 export {};

package/dist/config.js

@@ -44,13 +44,14 @@ const configSchema = z.object({
         .transform((v) => v.toLowerCase() === 'true'),
     BRAIN_UPDATE_COOLDOWN_MS: z.coerce.number().default(300000), // 5 minutes
     // Brain heartbeat & maintenance (cron-based)
-    // POLLER_TZ: IANA timezone used to interpret HEARTBEAT_CRON & MAINTENANCE_CRON.
-    // Default Europe/Prague — current fleet is CZ-based; ensures `30 3 * * *`
-    // means "03:30 local night," not "03:30 UTC = 05:30 CEST." DST is handled
-    // by croner automatically. Override with `POLLER_TZ=UTC` (or any IANA name).
-    POLLER_TZ: z.string().default('Europe/Prague'),
+    // POLLER_TZ: optional IANA timezone for HEARTBEAT_CRON & MAINTENANCE_CRON.
+    // When unset, croner uses the host system timezone (e.g. `Europe/Prague` on
+    // a CZ Mac mini, `UTC` on a default Railway container). Set explicitly
+    // (e.g. `POLLER_TZ=Europe/Prague` on Railway) when the host TZ doesn't match
+    // the intended cron interpretation. DST is handled by croner automatically.
+    POLLER_TZ: z.string().optional(),
     HEARTBEAT_CRON: z.string().default('0 */6 * * *'), // Every 6 hours
-    MAINTENANCE_CRON: z.string().default('30 3 * * *'), // Daily at 03:30 in POLLER_TZ
+    MAINTENANCE_CRON: z.string().default('30 3 * * *'), // Daily at 03:30 in POLLER_TZ (or host TZ)
     MAINTENANCE_ENABLED: z.string().default('true').transform((v) => v.toLowerCase() === 'true'),
     // Auto-update settings
     AUTO_UPDATE_POLICY: z.enum(['patch', 'minor', 'off']).default('patch'),

package/dist/heartbeat-manager.js

@@ -113,14 +113,21 @@ export function startHeartbeatLoop(processMessageFn) {
         logger.info('[Heartbeat] Maintenance disabled via config');
         return;
     }
+    // Croner uses the host system TZ when `timezone` option is omitted.
+    // Build options conditionally so undefined POLLER_TZ becomes "host TZ"
+    // rather than overriding it with `timezone: undefined`.
+    const cronOpts = config.POLLER_TZ
+        ? { timezone: config.POLLER_TZ, protect: true }
+        : { protect: true };
+    const tzLabel = config.POLLER_TZ ?? `host (${Intl.DateTimeFormat().resolvedOptions().timeZone})`;
     // Heartbeat cron — frequent, lightweight
-    logger.info(`[Heartbeat] Starting heartbeat cron: "${config.HEARTBEAT_CRON}" (tz: ${config.POLLER_TZ})`);
-    heartbeatJob = new Cron(config.HEARTBEAT_CRON, { timezone: config.POLLER_TZ, protect: true }, async () => {
+    logger.info(`[Heartbeat] Starting heartbeat cron: "${config.HEARTBEAT_CRON}" (tz: ${tzLabel})`);
+    heartbeatJob = new Cron(config.HEARTBEAT_CRON, cronOpts, async () => {
         await runHeartbeatJob(processMessageFn);
     });
     // Maintenance cron — daily, heavy (consolidation, memory cleanup)
-    logger.info(`[Maintenance] Starting maintenance cron: "${config.MAINTENANCE_CRON}" (tz: ${config.POLLER_TZ})`);
-    maintenanceJob = new Cron(config.MAINTENANCE_CRON, { timezone: config.POLLER_TZ, protect: true }, async () => {
+    logger.info(`[Maintenance] Starting maintenance cron: "${config.MAINTENANCE_CRON}" (tz: ${tzLabel})`);
+    maintenanceJob = new Cron(config.MAINTENANCE_CRON, cronOpts, async () => {
         await runMaintenanceJob(processMessageFn);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teamvibe/poller",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {