@mpgd/adapter-browser 0.3.1 → 0.4.0

package/dist/index.d.ts

@@ -1,2 +1,7 @@
 import { type PlatformGateway } from '@mpgd/platform';
-export declare function createBrowserPlatformGateway(): PlatformGateway;
+export interface BrowserPlatformGatewayOptions {
+  readonly locationHref?: string;
+  readonly share?: (data: ShareData) => Promise<void>;
+  readonly writeClipboardText?: (text: string) => Promise<void>;
+}
+export declare function createBrowserPlatformGateway(options?: BrowserPlatformGatewayOptions): PlatformGateway;

package/dist/index.js

@@ -11,9 +11,10 @@ const mockProducts = [
         },
     },
 ];
-export function createBrowserPlatformGateway() {
+export function createBrowserPlatformGateway(options = {}) {
     const pauseListeners = new Set();
     const resumeListeners = new Set();
+    const shareSupported = canShare(options);
     if (typeof document !== 'undefined') {
         document.addEventListener('visibilitychange', () => {
             const listeners = document.hidden ? pauseListeners : resumeListeners;
@@ -30,6 +31,7 @@ export function createBrowserPlatformGateway() {
                 rewardedAds: true,
                 interstitialAds: true,
                 cloudSave: true,
+                socialShare: shareSupported,
                 localizedContent: true,
             };
         },
@@ -40,6 +42,47 @@ export function createBrowserPlatformGateway() {
                     displayName: 'Browser Player',
                 };
             },
+            async getSession() {
+                return {
+                    identityLevel: 'guest',
+                    playerId: 'browser-player',
+                    trustLevel: 'local',
+                };
+            },
+            async requestUpgrade() {
+                return {
+                    status: 'unavailable',
+                    reloadExpected: false,
+                };
+            },
+        },
+        presentation: {
+            async getLaunchIntent() {
+                return launchIntentFromUrl(resolveBrowserUrl(options.locationHref));
+            },
+            async requestGameSurface() {
+                return 'already-fullscreen';
+            },
+        },
+        sharing: {
+            ...(shareSupported
+                ? {
+                    async share(intent) {
+                        return shareFromBrowser(intent, options);
+                    },
+                }
+                : {}),
+            async readInboundShare() {
+                return inboundShareFromUrl(resolveBrowserUrl(options.locationHref));
+            },
+        },
+        notifications: {
+            async getStatus() {
+                return 'unsupported';
+            },
+            async requestSubscription() {
+                return 'unavailable';
+            },
         },
         commerce: {
             async getProducts() {
@@ -105,3 +148,128 @@ export function createBrowserPlatformGateway() {
         },
     };
 }
+const launchEntries = new Set([
+    'home',
+    'daily',
+    'practice',
+    'free-play',
+    'continue',
+    'leaderboard',
+    'friend-challenge',
+]);
+function launchIntentFromUrl(url) {
+    const params = mergedSearchParams(url);
+    const requestedEntry = params.get('entry');
+    const inbound = inboundShareFromParams(params);
+    let entry;
+    if (requestedEntry !== null && launchEntries.has(requestedEntry)) {
+        entry = requestedEntry;
+    }
+    else if (inbound?.challengeToken === undefined) {
+        entry = 'home';
+    }
+    else {
+        entry = 'friend-challenge';
+    }
+    return {
+        entry,
+        ...(inbound?.puzzleId === undefined ? {} : { puzzleId: inbound.puzzleId }),
+        ...(inbound?.challengeToken === undefined
+            ? {}
+            : { referralToken: inbound.challengeToken }),
+    };
+}
+function inboundShareFromUrl(url) {
+    return inboundShareFromParams(mergedSearchParams(url));
+}
+function inboundShareFromParams(params) {
+    const puzzleId = nonEmptyParam(params.get('puzzleId'));
+    const challengeToken = nonEmptyParam(params.get('challengeToken'));
+    if (puzzleId === undefined && challengeToken === undefined) {
+        return null;
+    }
+    return {
+        ...(puzzleId === undefined ? {} : { puzzleId }),
+        ...(challengeToken === undefined ? {} : { challengeToken }),
+    };
+}
+function mergedSearchParams(url) {
+    const params = new URLSearchParams(url?.search ?? '');
+    const nestedParams = params.get('queryParams');
+    if (nestedParams === null) {
+        return params;
+    }
+    try {
+        const parsed = JSON.parse(nestedParams);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            for (const [key, value] of Object.entries(parsed)) {
+                if (typeof value === 'string' && !params.has(key)) {
+                    params.set(key, value);
+                }
+            }
+        }
+    }
+    catch {
+        // Inbound query payloads are untrusted. Invalid nested data is ignored.
+    }
+    return params;
+}
+async function shareFromBrowser(intent, options) {
+    const share = options.share ?? globalThis.navigator?.share?.bind(globalThis.navigator);
+    if (share !== undefined) {
+        try {
+            await share({
+                title: intent.title,
+                text: intent.text,
+                url: intent.deepLink,
+            });
+            return { status: 'shared' };
+        }
+        catch (error) {
+            if (isAbortError(error)) {
+                return { status: 'cancelled' };
+            }
+            console.warn('Browser share failed; falling back to clipboard.', error);
+        }
+    }
+    const writeClipboardText = options.writeClipboardText
+        ?? globalThis.navigator?.clipboard?.writeText?.bind(globalThis.navigator.clipboard);
+    if (writeClipboardText === undefined) {
+        return { status: 'unavailable' };
+    }
+    try {
+        await writeClipboardText(`${intent.text}\n${intent.deepLink}`);
+        return { status: 'shared' };
+    }
+    catch {
+        return { status: 'unavailable' };
+    }
+}
+function canShare(options) {
+    return (options.share !== undefined
+        || options.writeClipboardText !== undefined
+        || typeof globalThis.navigator?.share === 'function'
+        || typeof globalThis.navigator?.clipboard?.writeText === 'function');
+}
+function resolveBrowserUrl(locationHref) {
+    const href = locationHref ?? globalThis.location?.href;
+    if (href === undefined) {
+        return undefined;
+    }
+    try {
+        return new URL(href);
+    }
+    catch {
+        return undefined;
+    }
+}
+function nonEmptyParam(value) {
+    return value === null || value.length === 0 ? undefined : value;
+}
+function isAbortError(error) {
+    return typeof DOMException !== 'undefined' && error instanceof DOMException
+        ? error.name === 'AbortError'
+        : typeof error === 'object'
+            && error !== null
+            && error.name === 'AbortError';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/adapter-browser",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Browser preview platform adapter for mpgd games.",
   "license": "MIT",
   "repository": {
@@ -34,7 +34,7 @@
     "dist"
   ],
   "dependencies": {
-    "@mpgd/platform": "0.3.1"
+    "@mpgd/platform": "0.4.0"
   },
   "devDependencies": {
     "ttsc": "0.16.9",