@mpgd/platform 0.3.1 → 0.4.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,65 @@ 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;
+}
+export interface ShareResult {
+  readonly status: 'shared' | 'cancelled' | 'unavailable';
+}
+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 +176,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/platform",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
   "license": "MIT",
   "repository": {