@mpgd/cli 0.57.0 → 0.58.0

package/dist/native-deploy-run.js

@@ -187,6 +187,10 @@ async function buildAndRecordTarget(input, workspace, target, reserved, environm
         BUILD_ID: reserved.buildId,
         MPGD_RELEASE_REVISION: String(reserved.releaseRevision),
         MPGD_RELEASE_LABEL: reserved.releaseLabel,
+        // The reserved numbers are stamped into the build's staged shell copy, so
+        // a release does not need a hand commit of versionCode/build number; the
+        // signed-artifact inspection still compares the emitted values with them.
+        MPGD_NATIVE_VERSION_STAMP: '1',
         ...(target === 'android' ? {
             MPGD_TARGET_VERSION_CODE: String(version.versionCode),
             MPGD_TARGET_VERSION_NAME: String(version.versionName),

package/dist/native-shell-store-policy.d.ts

@@ -0,0 +1,123 @@
+/**
+* Store-facing settings of the game-owned Capacitor shell: the iOS
+* Info.plist keys App Store Connect reads (export compliance, device
+* capabilities). The starter writes them into a newly generated project;
+* a production build only reports what an existing shell still lacks, so
+* game-owned native files are never rewritten behind the game's back.
+*/
+export interface NativeShellPolicyIssue {
+  /** `error` fails a production build; `warning` is printed. */
+  readonly level: 'error' | 'warning';
+  readonly message: string;
+}
+/**
+* Adds the iOS keys every kit shell should ship with, keeping any value the
+* game already set:
+* - `ITSAppUsesNonExemptEncryption` = false. The kit itself only uses HTTPS
+*   through the OS and OS crypto, which Apple's export rules exempt, so
+*   App Store Connect does not ask the export-compliance question per build.
+*   A game that adds its own encryption sets the key to true and answers it.
+* - `UIRequiredDeviceCapabilities` lists `arm64` instead of the 32-bit
+*   `armv7` left over from the Capacitor template.
+*/
+export declare function applyIosInfoPlistStorePolicy(plist: string): string;
+/** What a shell's release Info.plist still lacks compared with `applyIosInfoPlistStorePolicy`. */
+export declare function inspectIosInfoPlistStorePolicy(plist: string): readonly NativeShellPolicyIssue[];
+export interface PlistValue {
+  readonly start: number;
+  readonly end: number;
+  readonly xml: string;
+}
+/**
+* The value element following `<key>name</key>` (first occurrence), or
+* undefined. Only for keys that appear once in the document, such as the
+* top-level Info.plist keys this module manages.
+*/
+export declare function readPlistTopLevelValue(plist: string, key: string): PlistValue | undefined;
+/** Replaces the value of `key`, or appends the entry to the root dictionary. */
+export declare function setPlistTopLevelValue(plist: string, key: string, valueXml: string): string;
+/** The game's design orientation (`mpgd.game.json` `native.orientation`). */
+export type NativeShellOrientation = 'portrait' | 'landscape' | 'any';
+/** iOS devices the App Store offers the game on (`mpgd.targets.json` ios `metadata.iosDeviceFamily`). */
+export type IosDeviceFamily = 'universal' | 'iphone';
+/**
+* Reads `native.orientation` from a parsed `mpgd.game.json`; undefined when
+* the game has not chosen one, in which case nothing is enforced.
+*/
+export declare function readGameNativeOrientation(gameConfig: unknown): NativeShellOrientation | undefined;
+/** Reads `metadata.iosDeviceFamily` of the ios target; undefined when not chosen. */
+export declare function readIosDeviceFamily(metadata: unknown): IosDeviceFamily | undefined;
+/** iPhone orientations for a design orientation (upside-down portrait stays off, as in Xcode's template). */
+export declare function iosIphoneOrientations(orientation: NativeShellOrientation): readonly string[];
+/**
+* iPad always lists all four orientations. Apple deprecated
+* `UIRequiresFullScreen` in iPadOS 26 and asks apps to support every
+* orientation (TN3192); iPadOS keeps a game that prefers one orientation at a
+* consistent scene size, and the kit's runtime orientation policy letterboxes
+* or asks the player to rotate.
+*/
+export declare const iosIpadOrientations: readonly string[];
+/** Writes the iPhone and iPad orientation lists for the game's design orientation. */
+export declare function applyIosInfoPlistOrientation(plist: string, orientation: NativeShellOrientation): string;
+export declare function inspectIosInfoPlistOrientation(plist: string, orientation: NativeShellOrientation | undefined, deviceFamily: IosDeviceFamily): readonly NativeShellPolicyIssue[];
+/** `TARGETED_DEVICE_FAMILY` value: 1 = iPhone, 2 = iPad. */
+export declare function iosTargetedDeviceFamily(family: IosDeviceFamily): string;
+/** Sets `TARGETED_DEVICE_FAMILY` in every build configuration of the App target. */
+export declare function applyIosProjectDeviceFamily(project: string, family: IosDeviceFamily): string;
+/** The App target's Release `TARGETED_DEVICE_FAMILY`, without quotes, or undefined. */
+export declare function readIosAppReleaseDeviceFamily(project: string): string | undefined;
+export declare function inspectIosProjectDeviceFamily(project: string, family: IosDeviceFamily | undefined): readonly NativeShellPolicyIssue[];
+/**
+* Sets the launcher activity's `android:screenOrientation` (`portrait`,
+* `sensorLandscape`, or none for `any`) and marks the application
+* `android:appCategory="game"`. Android 16 ignores orientation restrictions
+* on large screens for apps targeting API 36 unless the app is a game.
+*/
+export declare function applyAndroidManifestOrientation(manifest: string, orientation: NativeShellOrientation): string;
+export declare function inspectAndroidManifestOrientation(manifest: string, orientation: NativeShellOrientation | undefined): readonly NativeShellPolicyIssue[];
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare const iosAppPrivacyManifestFile = "PrivacyInfo.xcprivacy";
+/**
+* App-level privacy manifest of a kit shell. The App target's own code
+* (AppDelegate, SceneDelegate) calls no required-reason API and the kit does
+* no tracking; Capacitor core and the kit's game-services plugin ship their
+* own manifests (the plugin declares UserDefaults CA92.1). The collected
+* data array is empty only because the kit-owned shell code collects
+* nothing: a game adds the required-reason APIs its own native code uses
+* and an entry for each data type it collects
+* (docs/STORE_PRIVACY_DISCLOSURES.md).
+*/
+export declare const iosAppPrivacyManifestXml: string;
+/**
+* Adds a file in the App group to the App target's Resources phase of a
+* Capacitor-generated project. Returns undefined when the project does not
+* have that layout (an App group with `path = App`, a Resources phase, the
+* PBXBuildFile/PBXFileReference section markers), so the caller can leave the
+* project alone. A project whose Resources phase already bundles the file is
+* returned unchanged; one whose App group references it without bundling it
+* is left to the game (undefined).
+*/
+export declare function addIosAppResource(project: string, fileName: string): string | undefined;
+/** Whether the App target's Resources phase bundles `fileName`. */
+export declare function iosAppBundlesResource(project: string, fileName: string): boolean;
+export declare function inspectIosAppPrivacyManifest(project: string): readonly NativeShellPolicyIssue[];
+export declare const admobCapacitorPlugin = "@capacitor-community/admob";
+export declare const androidAdIdPermission = "com.google.android.gms.permission.AD_ID";
+/** Whether the shell's package.json installs the AdMob Capacitor plugin. */
+export declare function shellUsesAdMob(shellPackage: unknown): boolean;
+/** `declared`, `removed` (tools:node="remove"), or `absent` from the app manifest. */
+export declare function readAndroidAdIdDeclaration(manifest: string): 'declared' | 'removed' | 'absent';
+/**
+* Declares the advertising ID permission when the game shows AdMob ads
+* (Google Mobile Ads also merges it) and removes it from the merged manifest
+* otherwise, so the Play Console advertising ID answer matches the binary.
+*/
+export declare function applyAndroidManifestAdId(manifest: string, usesAds: boolean): string;
+/**
+* `ads.admob.advertisingId` in `mpgd.game.json`: `removed` records a
+* deliberate no-advertising-ID policy (for example a child-directed game)
+* for a shell that installs AdMob; anything else expects the permission.
+*/
+export declare function readGameAdvertisingIdPolicy(gameConfig: unknown): 'declared' | 'removed';
+export declare function inspectAndroidManifestAds(manifest: string, usesAds: boolean, advertisingIdPolicy?: 'declared' | 'removed'): readonly NativeShellPolicyIssue[];
+export declare function inspectIosInfoPlistAds(plist: string, usesAds: boolean): readonly NativeShellPolicyIssue[];