@mpgd/game-services 0.27.1 → 0.27.2

package/dist/notifications/ait-functional-delivery.d.ts

@@ -133,7 +133,15 @@ export interface CreateAitFunctionalMessageDeliveryProviderOptions {
   readonly timeoutMs?: number;
   /** `FAIL` error codes that mean the recipient has not agreed to the template. */
   readonly agreementErrorCodes?: readonly string[];
-  /** `reachedFailReason` texts (trimmed) that mean the recipient has not agreed to the template. */
+  /**
+  * `reachedFailReason` texts (trimmed) that mean the recipient has not
+  * agreed to the template. Each is 1 to 1,024 characters (UTF-16 code
+  * units) once trimmed: the provider reads at most the first 1,024
+  * characters of a `reachedFailReason` and then trims it, so a longer entry
+  * could never match, and an empty one would match a blank reason. The
+  * provider refuses either at creation. A received reason with leading
+  * whitespace loses as much of its end to that cut.
+  */
   readonly agreementFailReasons?: readonly string[];
   /** Further `FAIL` error codes that mean this recipient cannot receive the message. */
   readonly recipientErrorCodes?: readonly string[];

package/dist/notifications/ait-functional-delivery.js

@@ -78,6 +78,8 @@ const channelFields = {
     friendtalk: 'sentFriendtalk',
 };
 const maximumResponseBodyBytes = 256 * 1_024;
+/** The longest `reachedFailReason` the provider keeps; a longer one is cut to this. */
+const maximumFailReasonLength = 1_024;
 const maximumIdentifierLength = 2_048;
 const maximumTimeoutMs = 60_000;
 /**
@@ -126,7 +128,7 @@ export function createAitFunctionalMessageDeliveryProvider(options) {
     const timeoutMs = normalizeTimeout(options.timeoutMs);
     const agreementErrorCodes = new Set(options.agreementErrorCodes ?? []);
     const recipientErrorCodes = new Set(options.recipientErrorCodes ?? []);
-    const agreementFailReasons = new Set((options.agreementFailReasons ?? []).map((reason) => reason.trim()));
+    const agreementFailReasons = new Set((options.agreementFailReasons ?? []).map((reason, index) => readAgreementFailReason(reason, index)));
     // Documented codes come first (RFC "Delivery providers -> Apps in Toss"),
     // then the deployment's. A list must not turn 4095 into an agreement denial.
     const classifyFailCode = (code, status) => {
@@ -224,6 +226,14 @@ export function createAitFunctionalMessageDeliveryProvider(options) {
         },
     };
 }
+/** One `agreementFailReasons` entry, trimmed, or a `TypeError` for one that could never match. */
+function readAgreementFailReason(reason, index) {
+    const trimmed = typeof reason === 'string' ? reason.trim() : '';
+    if (trimmed.length === 0 || trimmed.length > maximumFailReasonLength) {
+        throw new TypeError(`agreementFailReasons[${index}]: entries must be 1 to ${maximumFailReasonLength} characters once trimmed: a reachedFailReason is read up to ${maximumFailReasonLength} characters, so a longer entry could never match and an empty one would match a blank reason.`);
+    }
+    return trimmed;
+}
 function readSuccess(success, agreementFailReasons) {
     if (!isRecord(success)) {
         return { status: 'ambiguous', providerCode: 'SUCCESS' };
@@ -274,7 +284,9 @@ function readContents(input) {
         const reason = item['reachedFailReason'];
         contents.push({
             contentId: item['contentId'].slice(0, 256),
-            ...(typeof reason === 'string' ? { reachedFailReason: reason.slice(0, 1_024) } : {}),
+            ...(typeof reason === 'string'
+                ? { reachedFailReason: reason.slice(0, maximumFailReasonLength) }
+                : {}),
         });
     }
     return contents;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/game-services",
-  "version": "0.27.1",
+  "version": "0.27.2",
   "description": "Client, contract, server, store, and test helpers for authoritative mpgd game services.",
   "license": "MIT",
   "repository": {
@@ -219,9 +219,9 @@
     "@orpc/client": "2.0.0-beta.14",
     "@orpc/contract": "2.0.0-beta.14",
     "@orpc/server": "2.0.0-beta.14",
-    "@mpgd/analytics": "0.4.15",
-    "@mpgd/platform": "0.27.1",
-    "@mpgd/catalog": "0.10.6"
+    "@mpgd/analytics": "0.4.16",
+    "@mpgd/platform": "0.27.2",
+    "@mpgd/catalog": "0.10.7"
   },
   "peerDependencies": {
     "@apple/app-store-server-library": "^3.1.0"