@mpgd/cli 0.56.0 → 0.58.0

package/dist/legal-site-output.js

@@ -157,7 +157,7 @@ function assertNoLegalSymlink(root, target, label) {
     if (relative.startsWith('..') || path.isAbsolute(relative)) {
         throw new Error(`${label} must be inside the project root: ${target}`);
     }
-    const verb = label === 'legal-dir' ? 'read legal sources' : 'write legal site output';
+    const verb = label === 'out-dir' ? 'write legal site output' : 'read legal sources';
     let current = root;
     for (const part of relative.split(path.sep)) {
         if (part === '' || part === '.') {
@@ -224,3 +224,48 @@ function ensureLegalDirectory(directory) {
 function isErrno(error, code) {
     return error !== null && typeof error === 'object' && 'code' in error && error.code === code;
 }
+/**
+ * Google's AdMob line for `app-ads.txt` (`f08c47fec0942fa0` is Google's
+ * certification authority ID). AdMob shows the exact line for an account
+ * under Apps > View all apps > app-ads.txt; use a game-owned
+ * `legal/app-ads.txt` instead when it differs or mediation partners add lines.
+ */
+export function admobAppAdsTxtLine(publisherId) {
+    if (!/^pub-\d{16}$/u.test(publisherId)) {
+        throw new Error('mpgd.game.json ads.admob.publisherId must look like pub-0000000000000000.');
+    }
+    return `google.com, ${publisherId}, DIRECT, f08c47fec0942fa0`;
+}
+/**
+ * The `app-ads.txt` the legal site serves at its root, or undefined: a
+ * game-owned `<legal-dir>/app-ads.txt` verbatim, else the AdMob line for
+ * `ads.admob.publisherId` in the game's `mpgd.game.json`. Store listings
+ * name this site as the developer website (Play) or marketing URL (App
+ * Store), which is where ad buyers look for the file.
+ */
+export function resolveAppAdsTxt(input) {
+    if (input.ownFile !== undefined) {
+        if (input.ownFile.trim().length === 0) {
+            throw new Error('app-ads.txt in the legal directory is empty.');
+        }
+        return input.ownFile.endsWith('\n') ? input.ownFile : `${input.ownFile}\n`;
+    }
+    const config = input.gameConfig;
+    if (typeof config !== 'object' || config === null || !('ads' in config)) {
+        return undefined;
+    }
+    const ads = config.ads;
+    const admob = typeof ads === 'object' && ads !== null
+        ? ads.admob
+        : undefined;
+    const publisherId = typeof admob === 'object' && admob !== null
+        ? admob.publisherId
+        : undefined;
+    if (publisherId === undefined) {
+        return undefined;
+    }
+    if (typeof publisherId !== 'string') {
+        throw new Error('mpgd.game.json ads.admob.publisherId must be a string.');
+    }
+    return `${admobAppAdsTxtLine(publisherId)}\n`;
+}

package/dist/native-build-info.json

@@ -1,5 +1,5 @@
 {
-  "kitGitSha": "dc28031ea2d85c442c084cd118cdd3fa2cecadba",
+  "kitGitSha": "f90c1b77055c4700195f5e393c3c17b6db23f9bc",
   "kitDirty": false,
-  "packageVersion": "0.56.0"
+  "packageVersion": "0.58.0"
 }