@mpgd/cli 0.50.1 → 0.51.0

package/dist/native-build-info.json

@@ -1,5 +1,5 @@
 {
-  "kitGitSha": "81660b13605730116d99c58c4ab7d3deb62586d1",
+  "kitGitSha": "f3eb7e939f75b2736dcea741a112b50a3de096fa",
   "kitDirty": false,
-  "packageVersion": "0.50.1"
+  "packageVersion": "0.51.0"
 }

package/dist/native-build-target.js

@@ -6895,6 +6895,76 @@ var maximumLeaseTtlMs = 60 * 60 * 1e3;
 // node_modules/.cache/mpgd-native-build/packages/game-services/src/verified-leaderboard.js
 var timestampPattern = new RegExp("^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,3}))?(Z|([+-])(\\d{2}):(\\d{2}))$");
 
+// node_modules/.cache/mpgd-native-build/packages/game-services/src/notifications/fcm.js
+var fcmAddressKinds = Object.freeze(["fcm-token"]);
+var fcmReservedDataKeys = Object.freeze(["topic", "route"]);
+var tokenRefreshMarginMs = 5 * 60 * 1e3;
+
+// node_modules/.cache/mpgd-native-build/packages/game-services/src/notifications/registry.js
+var notificationHistoryRetentionDays = 30;
+var maxHistoryWindowSeconds = notificationHistoryRetentionDays * 86400;
+
+// node_modules/.cache/mpgd-native-build/packages/game-services/src/notifications/store.js
+var notificationAmbiguousReplayHours = 24;
+var ambiguousReplayMs = notificationAmbiguousReplayHours * 36e5;
+
+// node_modules/.cache/mpgd-native-build/packages/game-services/src/notifications/service.js
+var secondMs = 1e3;
+var dayMs2 = 86400 * secondMs;
+var keyRetentionMs = 30 * dayMs2;
+var endpointStaleMs = 60 * dayMs2;
+var endpointPurgeDelayMs = 30 * dayMs2;
+var historyRetentionMs = notificationHistoryRetentionDays * dayMs2;
+var ambiguousReplayMs2 = notificationAmbiguousReplayHours * 36e5;
+var maxTextLength = 2048;
+var maxRowKeyLength = maxTextLength + 1 + 9 * maxTextLength;
+var schedulerRetryMs = 60 * secondMs;
+var releaseBackoffMs = 60 * secondMs;
+
+// node_modules/.cache/mpgd-native-build/adapters/devvit/src/server/redis-notification-store.js
+var defaultPurgeLimit = Number.POSITIVE_INFINITY;
+
+// node_modules/.cache/mpgd-native-build/adapters/devvit/src/notifications-contract.js
+var devvitHostCodeCharacters = "[A-Za-z0-9_.:-]{1,128}";
+
+// node_modules/.cache/mpgd-native-build/adapters/devvit/src/server/notifications-delivery.js
+var devvitNotificationProviderCodes = Object.freeze({
+  deviceRecipient: "DEVVIT_DEVICE_RECIPIENT",
+  recipientInvalid: "DEVVIT_RECIPIENT_INVALID",
+  linkInvalid: "DEVVIT_LINK_INVALID",
+  textMissing: "DEVVIT_TEXT_MISSING",
+  titleTooLong: "DEVVIT_TITLE_TOO_LONG",
+  bodyTooLong: "DEVVIT_BODY_TOO_LONG",
+  templateSyntax: "DEVVIT_TEMPLATE_SYNTAX",
+  enqueueFailed: "DEVVIT_ENQUEUE_FAILED",
+  enqueueRejected: "DEVVIT_ENQUEUE_REJECTED",
+  enqueueUnanswered: "DEVVIT_ENQUEUE_UNANSWERED",
+  enqueueUnclassified: "DEVVIT_ENQUEUE_UNCLASSIFIED"
+});
+var dailyPeriodSource = String.raw`daily|per[- ]?(?:day|user|app)|today'?s?`;
+var dailyLimitWords = new RegExp(String.raw`\b(?:${dailyPeriodSource})\b`, "iu");
+var adjacentCountedLimit = new RegExp(String.raw`\b(?:${dailyPeriodSource}|send(?:ing)?|notifications?) limits?\b`, "iu");
+var devvitNotificationSchedulerTasks = Object.freeze({
+  dispatch: Object.freeze({
+    name: "mpgd-notifications-dispatch",
+    endpoint: "/internal/scheduler/mpgd-notifications-dispatch",
+    cron: "* * * * *"
+  }),
+  purge: Object.freeze({
+    name: "mpgd-notifications-purge",
+    endpoint: "/internal/scheduler/mpgd-notifications-purge",
+    cron: "*/5 * * * *"
+  })
+});
+
+// node_modules/.cache/mpgd-native-build/adapters/devvit/src/server/notifications-bridge.js
+var devvitNotificationHostCodes = Object.freeze({
+  optInRefused: "DEVVIT_OPT_IN_REFUSED",
+  optOutRefused: "DEVVIT_OPT_OUT_REFUSED",
+  pluginFailed: "DEVVIT_NOTIFICATIONS_PLUGIN_FAILED"
+});
+var hostCodeValue = new RegExp(`^${devvitHostCodeCharacters}$`, "u");
+
 // node_modules/.cache/mpgd-native-build/packages/cli/src/target-name.js
 var deploymentTargetNamePattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 var reservedDeploymentTargetNames2 = /* @__PURE__ */ new Set([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.50.1",
+  "version": "0.51.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -70,10 +70,10 @@
     "parse5": "7.3.0",
     "postcss": "8.5.28",
     "postcss-value-parser": "4.2.0",
-    "@mpgd/catalog": "0.10.1",
-    "@mpgd/platform": "0.23.1",
+    "@mpgd/catalog": "0.10.2",
     "@mpgd/phaser-assets": "0.9.1",
-    "@mpgd/target-config": "0.23.1"
+    "@mpgd/platform": "0.24.0",
+    "@mpgd/target-config": "0.23.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -81,18 +81,18 @@
     "@types/yauzl": "3.4.0",
     "ttsc": "0.32.1",
     "typescript": "7.0.2",
-    "@mpgd/adapter-ait": "0.17.1",
-    "@mpgd/adapter-browser": "0.11.1",
-    "@mpgd/adapter-verse8": "0.7.1",
-    "@mpgd/adapter-devvit": "0.12.1",
-    "@mpgd/analytics": "0.4.10",
-    "@mpgd/adapter-capacitor": "0.10.1",
-    "@mpgd/bridge": "0.13.1",
-    "@mpgd/capacitor-play-billing": "0.3.1",
-    "@mpgd/game-runtime": "0.7.1",
-    "@mpgd/capacitor-storekit": "0.3.1",
-    "@mpgd/game-services": "0.24.1",
-    "@mpgd/i18n": "0.6.15",
+    "@mpgd/adapter-ait": "0.18.0",
+    "@mpgd/adapter-capacitor": "0.11.0",
+    "@mpgd/adapter-devvit": "0.13.0",
+    "@mpgd/adapter-browser": "0.11.2",
+    "@mpgd/adapter-verse8": "0.7.2",
+    "@mpgd/capacitor-play-billing": "0.3.2",
+    "@mpgd/analytics": "0.4.11",
+    "@mpgd/capacitor-storekit": "0.3.2",
+    "@mpgd/bridge": "0.13.2",
+    "@mpgd/game-services": "0.25.0",
+    "@mpgd/game-runtime": "0.7.2",
+    "@mpgd/i18n": "0.6.16",
     "@mpgd/lite-shell": "0.1.0"
   },
   "main": "./dist/index.js",

package/templates/phaser-game/apps/target-devvit/devvit.json

@@ -43,5 +43,17 @@
   "scripts": {
     "dev": "vite build --mode staging --watch",
     "build": "pnpm build"
+  },
+  "scheduler": {
+    "tasks": {
+      "mpgd-notifications-dispatch": {
+        "endpoint": "/internal/scheduler/mpgd-notifications-dispatch",
+        "cron": "* * * * *"
+      },
+      "mpgd-notifications-purge": {
+        "endpoint": "/internal/scheduler/mpgd-notifications-purge",
+        "cron": "*/5 * * * *"
+      }
+    }
   }
 }

package/templates/phaser-game/apps/target-devvit/src/server/bridge.ts

@@ -59,6 +59,15 @@ export interface DevvitBridgeCommerceHandler {
   request(input: BridgeRequest): Promise<BridgeResponse>;
 }
 
+/**
+ * Serves the nine `notifications.v2.*` bridge methods:
+ * `createDevvitNotificationsV2BridgeHandler` from `@mpgd/adapter-devvit/server`
+ * over the Devvit `notifications` plugin and the request's logged-in user.
+ */
+export interface DevvitBridgeNotificationsHandler {
+  request(input: BridgeRequest): Promise<BridgeResponse>;
+}
+
 export interface DevvitBridgeHandlerDependencies {
   readonly redis: DevvitBridgeRedisLike;
   /** Authenticated Reddit user ID from the Devvit request context, never from the payload. */
@@ -75,6 +84,13 @@ export interface DevvitBridgeHandlerDependencies {
    * plugin wired never lists orders or products.
    */
   readonly commerce?: DevvitBridgeCommerceHandler | undefined;
+  /**
+   * Notifications v2: the game-rendered opt-in and opt-out. Absent, every
+   * `notifications.v2.*` method answers `NOTIFICATIONS_V2_UNAVAILABLE`, and
+   * the v1 `notifications.*` answers stay `approval-required` and
+   * `unavailable`.
+   */
+  readonly notifications?: DevvitBridgeNotificationsHandler | undefined;
   readonly warn?: ((message: string) => void) | undefined;
 }
 
@@ -93,11 +109,25 @@ export function createDevvitBridgeHandler(
   }
 
   return async function handleBridgeRequest(input: BridgeRequest): Promise<BridgeResponse> {
-    // Notifications v2 arrives with the Devvit provider (P3), which serves the
-    // game-rendered opt-in from this bridge; until then every v2 method
-    // answers the dedicated code, and the v1 `notifications.*` answers stay.
+    // Notifications v2: the configured handler serves the game-rendered
+    // opt-in; without one every v2 method answers the dedicated code. The v1
+    // `notifications.*` answers below stay; a gateway that exposes v2 serves
+    // v1 from it instead.
     if (isBridgeNotificationsV2Method(input.method)) {
-      return createNotificationsV2UnavailableBridgeError(input, 'Devvit server bridge');
+      if (dependencies.notifications === undefined) {
+        return createNotificationsV2UnavailableBridgeError(input, 'Devvit server bridge');
+      }
+      try {
+        return await dependencies.notifications.request(input);
+      } catch (error) {
+        warn(`devvit notifications ${input.method} failed: ${errorMessage(error)}`);
+        return createBridgeError(
+          input.id,
+          'NOTIFICATIONS_TEMPORARILY_UNAVAILABLE',
+          `${input.method} failed on the Devvit server.`,
+          true,
+        );
+      }
     }
     switch (input.method) {
       case 'runtime.getCapabilities':

package/templates/phaser-game/apps/target-devvit/src/server/index.ts

@@ -13,6 +13,7 @@ import productCatalogJson from '@mpgd/catalog/catalog.json';
 
 import devvitManifest from '../../devvit.json';
 import { createDevvitBridgeHandler } from './bridge.js';
+import { handleNotificationTask, notificationTaskForPath } from './notificationTasks.js';
 
 const maxRequestBodySize = 1_048_576;
 const gameName = '__GAME_NAME__';
@@ -45,6 +46,12 @@ const handleBridgeRequest = createDevvitBridgeHandler({
   storageKeyNamespace: gameName,
   ...(commerce === undefined ? {} : { commerce }),
 });
+/**
+ * The notifications v2 service (`createDevvitNotificationService` from
+ * `@mpgd/adapter-devvit/server`). None until the game declares a topic
+ * catalog, so the scheduler tasks below do no work.
+ */
+const notificationService: Parameters<typeof handleNotificationTask>[0]['notifications'] = undefined;
 const bridgeRpcHandler = createBridgeRpcNodeHandler(createBridgeRpcRouter(handleBridgeRequest), {
   maxBodySize: maxRequestBodySize,
   prefix: defaultBridgeRpcEndpoint,
@@ -57,17 +64,7 @@ async function handleHttpRequest(
   setResponseSecurityHeaders(response);
 
   if (request.method === 'POST' && requestPathname(request) === '/internal/menu/create-post') {
-    try {
-      await drainRequestBody(request, maxRequestBodySize);
-    } catch (error) {
-      if (!(error instanceof RequestBodyTooLargeError)) {
-        throw error;
-      }
-
-      discardOversizedRequestBody(request, response);
-      sendJson(response, 413, {
-        error: 'REQUEST_BODY_TOO_LARGE',
-      });
+    if (!(await drainOrRejectBody(request, response))) {
       return;
     }
 
@@ -75,6 +72,21 @@ async function handleHttpRequest(
     return;
   }
 
+  const notificationTask = request.method === 'POST'
+    ? notificationTaskForPath(requestPathname(request))
+    : undefined;
+  if (notificationTask !== undefined) {
+    if (!(await drainOrRejectBody(request, response))) {
+      return;
+    }
+    const answer = await handleNotificationTask({
+      task: notificationTask,
+      notifications: notificationService,
+    });
+    sendJson(response, answer.status, answer.body);
+    return;
+  }
+
   if (await bridgeRpcHandler(request, response)) {
     return;
   }
@@ -220,6 +232,21 @@ async function* readRequestBodyChunks(
   }
 }
 
+/** Drains a bounded internal request body; answers 413 and false when it is too large. */
+async function drainOrRejectBody(request: IncomingMessage, response: ServerResponse): Promise<boolean> {
+  try {
+    await drainRequestBody(request, maxRequestBodySize);
+    return true;
+  } catch (error) {
+    if (!(error instanceof RequestBodyTooLargeError)) {
+      throw error;
+    }
+    discardOversizedRequestBody(request, response);
+    sendJson(response, 413, { error: 'REQUEST_BODY_TOO_LARGE' });
+    return false;
+  }
+}
+
 async function drainRequestBody(
   request: IncomingMessage,
   maxBodySize: number,

package/templates/phaser-game/apps/target-devvit/src/server/notificationTasks.ts

@@ -0,0 +1,64 @@
+import {
+  devvitNotificationTaskForEndpoint,
+  runDevvitNotificationTask,
+  type DevvitNotificationTask,
+  type DevvitNotificationTaskResult,
+} from '@mpgd/adapter-devvit/server';
+
+/**
+ * The notifications scheduler tasks of `devvit.json` (`scheduler.tasks`):
+ * `mpgd-notifications-dispatch` runs the notifications scheduler every
+ * minute (due server reminders and due sends, starting no round after 20
+ * seconds) and `mpgd-notifications-purge` purges old rows in bounded
+ * batches every five minutes (`runDevvitNotificationTask` from
+ * `@mpgd/adapter-devvit/server`).
+ * A server without a notifications service (no topic catalog yet) answers
+ * the tasks without work.
+ */
+export interface NotificationTaskAnswer {
+  readonly status: number;
+  /** A `TaskResponse` (`{}`) from `@devvit/web/server`. */
+  readonly body: Record<string, never>;
+  readonly task: DevvitNotificationTask;
+  readonly result?: DevvitNotificationTaskResult;
+}
+
+/** The task an internal scheduler path names, or `undefined` for any other path. */
+export function notificationTaskForPath(pathname: string): DevvitNotificationTask | undefined {
+  return devvitNotificationTaskForEndpoint(pathname);
+}
+
+/**
+ * Runs `task`. A failure answers 500 (so the Devvit
+ * logs show it) and is logged; the next run tries again.
+ */
+export async function handleNotificationTask(input: {
+  readonly task: DevvitNotificationTask;
+  /** The service's `runScheduler` and `purge` (`createDevvitNotificationService(...).service`). */
+  readonly notifications: Parameters<typeof runDevvitNotificationTask>[0] | undefined;
+  readonly log?: (message: string, error?: unknown) => void;
+}): Promise<NotificationTaskAnswer> {
+  const log = input.log ?? ((message: string, error?: unknown) => {
+    if (error === undefined) {
+      console.log(message);
+    } else {
+      console.error(message, error);
+    }
+  });
+  if (input.notifications === undefined) {
+    return { status: 200, body: {}, task: input.task };
+  }
+  try {
+    const result = await runDevvitNotificationTask(input.notifications, input.task);
+    if (
+      (result.task === 'dispatch' && (result.touched > 0 || result.failed > 0))
+      || (result.task === 'purge' && result.sends + result.history + result.endpoints > 0)
+    ) {
+      log(`devvit notifications ${result.task}: ${JSON.stringify(result)}`);
+    }
+    return { status: 200, body: {}, task: input.task, result };
+  } catch (error) {
+    log(`devvit notifications ${input.task} task failed`, error);
+    return { status: 500, body: {}, task: input.task };
+  }
+}