@tribe-nest/forge 1.18.0 → 1.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tribe-nest/forge",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "publishConfig": {
     "access": "public"
   },

package/src/server/jobs.ts

@@ -14,8 +14,21 @@ export interface AppJobsEnv {
 }
 
 interface AppJobsStub {
-  reconcile: (script: string, appId: string, desired: JobSchedule[], hash: string) => Promise<{ changed: boolean }>;
-  enqueue: (script: string, appId: string, name: string, payload: unknown, delayMs: number) => Promise<void>;
+  reconcile: (
+    script: string,
+    appId: string,
+    desired: JobSchedule[],
+    hash: string,
+    host: string,
+  ) => Promise<{ changed: boolean }>;
+  enqueue: (
+    script: string,
+    appId: string,
+    name: string,
+    payload: unknown,
+    delayMs: number,
+    host: string,
+  ) => Promise<void>;
   status: () => Promise<AppJobsStatus>;
 }
 
@@ -24,12 +37,18 @@ interface AppJobsStub {
  * and what happened on the LAST delivery attempt. Because jobs fail silently (no
  * logs / dead-letter), this is how you SEE why one didn't run:
  *  - `lastDispatchAt` null while `alarmAt` is in the past → the alarm isn't firing;
- *  - `lastError` starting "dispatch threw:" → the callback never reached your app;
+ *  - `appHost` null → this app predates host registration; redeploy it;
+ *  - `lastError` starting "dispatch threw:" → the callback never reached your app
+ *    (host unroutable / your Worker is down);
  *  - `lastDispatchStatus` "401" → your app was reached but rejected the token
- *    (the dispatch-worker's APP_SYNC_SECRET ≠ the backend JWT_SECRET).
+ *    (the dispatch-worker's APP_SYNC_SECRET ≠ the backend JWT_SECRET);
+ *  - `lastDispatchStatus` "402" → the site is suspended for billing;
+ *  - `lastDispatchStatus` "404" → no /api/tn-jobs/run route (or an unknown job name).
  */
 export interface AppJobsStatus {
   appId: string | null;
+  /** The public host job runs are posted to. Null on apps deployed before this existed. */
+  appHost: string | null;
   now: number;
   alarmAt: number | null;
   schedules: Array<{ name: string; intervalMs: number | null; cron: string | null; nextRun: number }>;
@@ -72,6 +91,14 @@ export interface AppJobsConfig {
   script: string;
   /** The TribeNest public API base (VITE_API_URL) — used to verify the callback token. */
   apiUrl: string;
+  /**
+   * This app's public host, no scheme (VITE_APP_HOST) — e.g. "acme.tribenest.co".
+   * The job runtime posts each run to `https://<host>/api/tn-jobs/run`; it cannot
+   * reach the app any other way, so an app that never registers a host will not
+   * run jobs (its status reports "no app host recorded"). Injected at deploy —
+   * do not hand-set it.
+   */
+  host: string;
 }
 
 const stub = (env: AppJobsEnv, appId: string): AppJobsStub => env.JOBS.get(env.JOBS.idFromName(appId));
@@ -93,7 +120,7 @@ function scheduleHash(schedules: JobSchedule[]): string {
  * one, a removed one is pruned.
  */
 export async function reconcileAppJobs(env: AppJobsEnv, cfg: AppJobsConfig, schedules: JobSchedule[]): Promise<void> {
-  await stub(env, cfg.appId).reconcile(cfg.script, cfg.appId, schedules, scheduleHash(schedules));
+  await stub(env, cfg.appId).reconcile(cfg.script, cfg.appId, schedules, scheduleHash(schedules), cfg.host);
 }
 
 /** Enqueue a durable one-time job (survives redeploys, retried on failure). */
@@ -104,7 +131,7 @@ export async function enqueueAppJob(
   payload?: unknown,
   delayMs = 0,
 ): Promise<void> {
-  await stub(env, cfg.appId).enqueue(cfg.script, cfg.appId, name, payload ?? null, delayMs);
+  await stub(env, cfg.appId).enqueue(cfg.script, cfg.appId, name, payload ?? null, delayMs, cfg.host);
 }
 
 /**