@mpgd/adapter-devvit 0.9.2 → 0.9.3

package/dist/view-mode.d.ts

@@ -1,7 +1,12 @@
+import { type DevvitSurfaceOptions, type DevvitSurfaceResult } from './surface.js';
 export type DevvitViewMode = 'inline' | 'expanded';
 export interface DevvitViewModeClient {
   getWebViewMode(): DevvitViewMode;
 }
+export type DevvitPreviewViewModeOptions = DevvitSurfaceOptions;
+export type DevvitPreviewViewModeResult = {
+  readonly surface: DevvitSurfaceResult;
+};
 export interface DevvitInlineModeContext {
   /**
   * Loads gameplay in the current inline mode. Call this only from an explicit
@@ -22,10 +27,24 @@ export interface DevvitViewModeOptions {
   readonly onModeUnavailable?: (error: unknown) => void;
 }
 /**
+* Preview-only inline entry contract. This is intentionally a thin alias of
+* {@link startDevvitSurface}; generated games pin this policy-facing name while
+* the lower-level surface API remains independently available.
+*
+* Use this contract by default for generated games. Games that intentionally
+* support policy-compliant inline gameplay can opt in through
+* {@link startDevvitViewMode} instead.
+*/
+export declare function startDevvitPreviewViewMode(options: DevvitPreviewViewModeOptions): Promise<DevvitPreviewViewModeResult>;
+/**
 * Starts a Devvit web view using Reddit's official inline and expanded mode
 * terminology. Inline mode mounts lightweight content first and exposes a
 * retryable, concurrency-safe gameplay loader for a later user action.
 * Expanded mode loads gameplay immediately. Outside a Devvit host, expanded
 * mode is used as the local-browser fallback.
+*
+* This is an explicit inline-gameplay opt-in. Prefer
+* {@link startDevvitPreviewViewMode} unless the game's inline interaction and
+* gesture model has been reviewed against current Reddit requirements.
 */
 export declare function startDevvitViewMode(options: DevvitViewModeOptions): Promise<DevvitViewModeResult>;

package/dist/view-mode.js

@@ -1,9 +1,27 @@
+import { startDevvitSurface, } from './surface.js';
+/**
+ * Preview-only inline entry contract. This is intentionally a thin alias of
+ * {@link startDevvitSurface}; generated games pin this policy-facing name while
+ * the lower-level surface API remains independently available.
+ *
+ * Use this contract by default for generated games. Games that intentionally
+ * support policy-compliant inline gameplay can opt in through
+ * {@link startDevvitViewMode} instead.
+ */
+export async function startDevvitPreviewViewMode(options) {
+    const surface = await startDevvitSurface(options);
+    return { surface };
+}
 /**
  * Starts a Devvit web view using Reddit's official inline and expanded mode
  * terminology. Inline mode mounts lightweight content first and exposes a
  * retryable, concurrency-safe gameplay loader for a later user action.
  * Expanded mode loads gameplay immediately. Outside a Devvit host, expanded
  * mode is used as the local-browser fallback.
+ *
+ * This is an explicit inline-gameplay opt-in. Prefer
+ * {@link startDevvitPreviewViewMode} unless the game's inline interaction and
+ * gesture model has been reviewed against current Reddit requirements.
  */
 export async function startDevvitViewMode(options) {
     let mode;

package/dist/web.d.ts

@@ -1,9 +1,10 @@
 import type { ShareResult } from '@mpgd/platform';
 import { type DevvitSurfaceOptions, type DevvitSurfaceResult } from './surface.js';
-import { type DevvitViewModeOptions, type DevvitViewModeResult } from './view-mode.js';
+import { type DevvitPreviewViewModeOptions, type DevvitPreviewViewModeResult, type DevvitViewModeOptions, type DevvitViewModeResult } from './view-mode.js';
 export type { DevvitSurfaceClient, DevvitSurfaceMode, DevvitSurfaceOptions, DevvitSurfaceResult, } from './surface.js';
-export type { DevvitInlineModeContext, DevvitViewMode, DevvitViewModeClient, DevvitViewModeOptions, DevvitViewModeResult, } from './view-mode.js';
+export type { DevvitInlineModeContext, DevvitPreviewViewModeOptions, DevvitPreviewViewModeResult, DevvitViewMode, DevvitViewModeClient, DevvitViewModeOptions, DevvitViewModeResult, } from './view-mode.js';
 export type DevvitWebSurfaceOptions = Omit<DevvitSurfaceOptions, 'client'>;
+export type DevvitWebPreviewOptions = Omit<DevvitPreviewViewModeOptions, 'client'>;
 export type DevvitWebViewOptions = Omit<DevvitViewModeOptions, 'client'>;
 export interface DevvitShareSheetOptions {
   readonly data?: string;
@@ -12,8 +13,15 @@ export interface DevvitShareSheetOptions {
 }
 export declare function startDevvitWebSurface(options: DevvitWebSurfaceOptions): Promise<DevvitSurfaceResult>;
 /**
+* Starts a preview-only inline entry and loads gameplay only in expanded mode.
+* This is the safe default for generated Devvit games.
+*/
+export declare function startDevvitPreviewWebView(options: DevvitWebPreviewOptions): Promise<DevvitPreviewViewModeResult>;
+/**
 * Starts a Devvit web view in inline or expanded mode. Inline mode can defer
 * gameplay until an explicit user action while remaining inside the post.
+* This is an explicit inline-gameplay opt-in; generated games use
+* {@link startDevvitPreviewWebView} by default.
 */
 export declare function startDevvitWebView(options: DevvitWebViewOptions): Promise<DevvitViewModeResult>;
 export declare function requestDevvitExpandedMode(event: MouseEvent, entry: string): Promise<void>;

package/dist/web.js

@@ -1,24 +1,39 @@
 import * as devvitWebClient from '@devvit/web/client';
 import { startDevvitSurface, } from './surface.js';
-import { startDevvitViewMode, } from './view-mode.js';
+import { startDevvitPreviewViewMode, startDevvitViewMode, } from './view-mode.js';
 // The Devvit package publishes browser implementations behind an export
 // condition while its default declaration is a server-side panic module.
 // Keep the narrow browser contract explicit until its default types expose it.
 const browserClient = devvitWebClient;
+const browserSurfaceClient = {
+    getWebViewMode: browserClient.getWebViewMode,
+};
 export function startDevvitWebSurface(options) {
     return startDevvitSurface({
         ...options,
-        client: { getWebViewMode: browserClient.getWebViewMode },
+        client: browserSurfaceClient,
+    });
+}
+/**
+ * Starts a preview-only inline entry and loads gameplay only in expanded mode.
+ * This is the safe default for generated Devvit games.
+ */
+export function startDevvitPreviewWebView(options) {
+    return startDevvitPreviewViewMode({
+        ...options,
+        client: browserSurfaceClient,
     });
 }
 /**
  * Starts a Devvit web view in inline or expanded mode. Inline mode can defer
  * gameplay until an explicit user action while remaining inside the post.
+ * This is an explicit inline-gameplay opt-in; generated games use
+ * {@link startDevvitPreviewWebView} by default.
  */
 export function startDevvitWebView(options) {
     return startDevvitViewMode({
         ...options,
-        client: { getWebViewMode: browserClient.getWebViewMode },
+        client: browserSurfaceClient,
     });
 }
 export async function requestDevvitExpandedMode(event, entry) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/adapter-devvit",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Reddit Devvit Web platform adapter for mpgd games.",
   "license": "MIT",
   "repository": {
@@ -55,9 +55,9 @@
   ],
   "dependencies": {
     "@devvit/web": "0.14.1",
-    "@mpgd/game-services": "0.12.1",
+    "@mpgd/platform": "0.10.0",
     "@mpgd/bridge": "0.9.0",
-    "@mpgd/platform": "0.10.0"
+    "@mpgd/game-services": "0.12.1"
   },
   "devDependencies": {
     "ttsc": "0.18.4",