@mpgd/platform 0.3.2 → 0.5.0

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 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 StarterLogicalProductId = 'COINS_100' | 'COINS_500' | 'REMOVE_ADS';
+export type LogicalProductId = StarterLogicalProductId | (string & Record<never, never>);
+export type StarterLogicalAdPlacementId = 'CONTINUE_AFTER_FAIL' | 'STAGE_END_INTERSTITIAL';
+export type LogicalAdPlacementId = StarterLogicalAdPlacementId | (string & Record<never, never>);
 export type ProductType = 'consumable' | 'non_consumable' | 'subscription';
 export interface ProductInfo {
   readonly id: LogicalProductId;
@@ -89,8 +91,79 @@ export interface PlayerIdentity {
   readonly displayName?: string;
   readonly avatarUrl?: string;
 }
+export type IdentityLevel = 'guest' | 'platform-anonymous' | 'authenticated';
+export type IdentityTrustLevel = 'local' | 'platform-asserted' | 'server-verified';
+export interface IdentitySession {
+  readonly identityLevel: IdentityLevel;
+  readonly playerId?: string;
+  readonly trustLevel: IdentityTrustLevel;
+}
+export type IdentityUpgradeReason = 'save' | 'leaderboard' | 'share' | 'notifications';
+export interface IdentityUpgradeResult {
+  readonly status: 'completed' | 'cancelled' | 'unavailable';
+  readonly reloadExpected: boolean;
+}
 export interface IdentityAdapter {
   getPlayer(): Promise<PlayerIdentity | null>;
+  getSession?(): Promise<IdentitySession>;
+  requestUpgrade?(input: {
+    readonly reason: IdentityUpgradeReason;
+  }): Promise<IdentityUpgradeResult>;
+}
+export type LaunchEntry = 'home' | 'daily' | 'practice' | 'free-play' | 'continue' | 'leaderboard' | 'friend-challenge';
+export interface LaunchIntent {
+  readonly entry: LaunchEntry;
+  readonly puzzleId?: string;
+  readonly referralToken?: string;
+}
+export type PresentationResult = 'opened' | 'already-fullscreen' | 'unavailable';
+export interface PresentationAdapter {
+  getLaunchIntent(): Promise<LaunchIntent>;
+  requestGameSurface(intent: LaunchIntent): Promise<PresentationResult>;
+}
+export interface SharePayload {
+  readonly puzzleId?: string;
+  readonly challengeToken?: string;
+}
+export interface ShareIntent {
+  readonly kind: 'daily-result' | 'friend-challenge' | 'invite';
+  readonly title: string;
+  readonly text: string;
+  readonly deepLink: string;
+  readonly payload?: SharePayload;
+  readonly previewImageUrl?: string;
+}
+/**
+* Evidence available after a platform reports a successful share operation.
+* `presented` means the platform share surface opened, not that the user
+* finished sharing. `completed` means the adapter observed completion.
+*/
+export type ShareCompletion = 'presented' | 'completed';
+export interface ShareResult {
+  readonly status: 'shared' | 'cancelled' | 'unavailable';
+  /**
+  * Optional for backward compatibility. A legacy `shared` result without this
+  * field normalizes to `completed`; new adapters should set it explicitly when
+  * they can only prove that a share surface was presented.
+  */
+  readonly completion?: ShareCompletion;
+}
+export declare function resolveShareCompletion(result: ShareResult): ShareCompletion | undefined;
+export declare function isShareCompleted(result: ShareResult): boolean;
+export interface InboundShare {
+  readonly puzzleId?: string;
+  readonly challengeToken?: string;
+}
+export interface ShareAdapter {
+  share?(intent: ShareIntent): Promise<ShareResult>;
+  readInboundShare?(): Promise<InboundShare | null>;
+}
+export type NotificationTopic = 'daily-ready' | 'streak-at-risk' | 'friend-challenge';
+export type NotificationSubscriptionStatus = 'subscribed' | 'not-subscribed' | 'approval-required' | 'configuration-required' | 'unsupported';
+export type NotificationSubscriptionResult = 'subscribed' | 'rejected' | 'unavailable';
+export interface NotificationSubscriptionAdapter {
+  getStatus(topic: NotificationTopic): Promise<NotificationSubscriptionStatus>;
+  requestSubscription(topic: NotificationTopic): Promise<NotificationSubscriptionResult>;
 }
 export interface LifecycleAdapter {
   onPause(callback: () => void): () => void;
@@ -117,5 +190,8 @@ export interface PlatformGateway {
   readonly leaderboard: LeaderboardAdapter;
   readonly lifecycle: LifecycleAdapter;
   readonly storage: StorageAdapter;
+  readonly presentation?: PresentationAdapter;
+  readonly sharing?: ShareAdapter;
+  readonly notifications?: NotificationSubscriptionAdapter;
 }
 export declare function createUnsupportedCapabilities(): PlatformCapabilities;

package/dist/index.js

@@ -1,3 +1,12 @@
+export function resolveShareCompletion(result) {
+    if (result.status !== 'shared') {
+        return undefined;
+    }
+    return result.completion ?? 'completed';
+}
+export function isShareCompleted(result) {
+    return resolveShareCompletion(result) === 'completed';
+}
 export function createUnsupportedCapabilities() {
     return {
         nativeIap: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/platform",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
   "license": "MIT",
   "repository": {
@@ -35,7 +35,8 @@
   ],
   "devDependencies": {
     "ttsc": "0.16.9",
-    "typescript": "7.0.1-rc"
+    "typescript": "7.0.1-rc",
+    "vitest": "^4.0.0"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -46,6 +47,7 @@
     "check": "ttsc --noEmit",
     "lint": "ttsc --noEmit",
     "format": "ttsc format",
-    "fix": "ttsc fix"
+    "fix": "ttsc fix",
+    "test": "vitest run"
   }
 }