@mpgd/platform 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imjlk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,121 @@
+export type PlatformTarget = 'browser' | 'android' | 'ios' | 'ait' | 'reddit' | 'telegram' | 'tauri';
+export type LogicalProductId = 'COINS_100' | 'COINS_500' | 'REMOVE_ADS';
+export type LogicalAdPlacementId = 'CONTINUE_AFTER_FAIL' | 'STAGE_END_INTERSTITIAL';
+export type ProductType = 'consumable' | 'non_consumable' | 'subscription';
+export interface ProductInfo {
+  readonly id: LogicalProductId;
+  readonly type: ProductType;
+  readonly title: string;
+  readonly description: string;
+  readonly price: {
+    readonly formatted: string;
+    readonly currencyCode: string;
+  };
+}
+export interface Entitlement {
+  readonly id: string;
+  readonly source: 'purchase' | 'promotion' | 'admin';
+  readonly grantedAt: string;
+  readonly expiresAt?: string;
+}
+export interface PurchaseResult {
+  readonly status: 'completed' | 'cancelled' | 'pending' | 'failed';
+  readonly transactionId?: string;
+  readonly entitlementIds: readonly string[];
+}
+export interface PurchaseRestoreResult {
+  readonly restoredEntitlements: readonly Entitlement[];
+}
+export interface RewardedAdResult {
+  readonly status: 'completed' | 'skipped' | 'unavailable' | 'failed';
+  readonly rewardGranted: boolean;
+  readonly ledgerEntryId?: string;
+}
+export interface InterstitialAdResult {
+  readonly status: 'shown' | 'skipped' | 'unavailable';
+}
+export interface CommerceAdapter {
+  getProducts(): Promise<readonly ProductInfo[]>;
+  purchase(input: {
+    readonly productId: LogicalProductId;
+    readonly source: 'shop' | 'stage_fail' | 'result' | 'event';
+    readonly idempotencyKey: string;
+  }): Promise<PurchaseResult>;
+  restore?(): Promise<PurchaseRestoreResult>;
+  getEntitlements(): Promise<readonly Entitlement[]>;
+}
+export interface AdAdapter {
+  preload(input: {
+    readonly placementId: LogicalAdPlacementId;
+  }): Promise<void>;
+  showRewarded(input: {
+    readonly placementId: LogicalAdPlacementId;
+    readonly idempotencyKey: string;
+  }): Promise<RewardedAdResult>;
+  showInterstitial?(input: {
+    readonly placementId: LogicalAdPlacementId;
+  }): Promise<InterstitialAdResult>;
+}
+export interface LeaderboardScoreInput {
+  readonly leaderboardId: string;
+  readonly score: number;
+  readonly runId: string;
+  readonly submittedAt: string;
+}
+export interface LeaderboardSubmitResult {
+  readonly submitted: boolean;
+  readonly rank?: number;
+}
+export interface LeaderboardAdapter {
+  submitScore(input: LeaderboardScoreInput): Promise<LeaderboardSubmitResult>;
+  open(input?: {
+    readonly leaderboardId?: string;
+  }): Promise<void>;
+}
+export interface PlatformCapabilities {
+  readonly nativeIap: boolean;
+  readonly nativeAds: boolean;
+  readonly rewardedAds: boolean;
+  readonly interstitialAds: boolean;
+  readonly nativeLeaderboard: boolean;
+  readonly achievements: boolean;
+  readonly cloudSave: boolean;
+  readonly socialShare: boolean;
+  readonly haptics: boolean;
+  readonly localizedContent: boolean;
+}
+export interface PlayerIdentity {
+  readonly playerId: string;
+  readonly displayName?: string;
+  readonly avatarUrl?: string;
+}
+export interface IdentityAdapter {
+  getPlayer(): Promise<PlayerIdentity | null>;
+}
+export interface LifecycleAdapter {
+  onPause(callback: () => void): () => void;
+  onResume(callback: () => void): () => void;
+}
+export interface StorageLoadResult {
+  readonly value: unknown;
+}
+export interface StorageAdapter {
+  load(input: {
+    readonly key: string;
+  }): Promise<StorageLoadResult | null>;
+  save(input: {
+    readonly key: string;
+    readonly value: unknown;
+  }): Promise<void>;
+}
+export interface PlatformGateway {
+  readonly target: PlatformTarget;
+  getCapabilities(): Promise<PlatformCapabilities>;
+  readonly identity: IdentityAdapter;
+  readonly commerce: CommerceAdapter;
+  readonly ads: AdAdapter;
+  readonly leaderboard: LeaderboardAdapter;
+  readonly lifecycle: LifecycleAdapter;
+  readonly storage: StorageAdapter;
+}
+export declare function createUnsupportedCapabilities(): PlatformCapabilities;

package/dist/index.js

@@ -0,0 +1,14 @@
+export function createUnsupportedCapabilities() {
+    return {
+        nativeIap: false,
+        nativeAds: false,
+        rewardedAds: false,
+        interstitialAds: false,
+        nativeLeaderboard: false,
+        achievements: false,
+        cloudSave: false,
+        socialShare: false,
+        haptics: false,
+        localizedContent: false,
+    };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@mpgd/platform",
+  "version": "0.1.0",
+  "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imjlk/mpgd-kit.git",
+    "directory": "packages/platform"
+  },
+  "bugs": {
+    "url": "https://github.com/imjlk/mpgd-kit/issues"
+  },
+  "homepage": "https://github.com/imjlk/mpgd-kit#readme",
+  "keywords": [
+    "mpgd",
+    "phaser",
+    "vite",
+    "typescript",
+    "capacitor",
+    "apps-in-toss",
+    "game-development",
+    "game-distribution"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "ttsc": "0.16.9",
+    "typescript": "7.0.1-rc"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "check": "ttsc --noEmit",
+    "lint": "ttsc --noEmit",
+    "format": "ttsc format",
+    "fix": "ttsc fix"
+  }
+}