@devvit/client 0.12.1-next-2025-10-01-18-10-24-62f08d94f.0 → 0.12.1-next-2025-10-02-15-00-39-af5d076c7.0

package/effects/web-view-mode.d.ts

@@ -2,26 +2,32 @@
  * The presentation mode of the web view.
  * 'inline' The web view is displayed inline within a feed or post detail page
  * 'expanded' The web view is displayed in a larger modal presentation
+ * @experimental
  */
 export type WebViewMode = 'inline' | 'expanded';
 /**
  * A listener that is called when the web view mode changes.
  * @param mode The new mode, either 'inline' or 'expanded'.
+ * @experimental
  */
 export type WebViewModeListener = (mode: WebViewMode) => void;
 /**
  * Represents the current web view mode state for the application.
  *
- * @defaultValue 'inline'
+ * @experimental
  */
 export declare const getWebViewMode: () => WebViewMode;
 /**
  * Requests expanded mode for the web view.
  * This will display the web view in a larger modal presentation.
  *
- * @param event The event that triggered the request, must be a trusted event.
+ * @param event The gesture that triggered the request, must be a trusted event.
+ * @param entry The destination URI name. Eg, `'splash'` or `'default'`. Entry
+ *              names are the `devvit.json` `post.entrypoints` keys. Passing the
+ *              same entrypoint as currently loaded causes a reload.
  * @returns A promise that resolves request has been received.
  *
+ * @experimental
  * @example
  * ```ts
  * button.addEventListener('click', async (event) => {
@@ -29,7 +35,7 @@ export declare const getWebViewMode: () => WebViewMode;
  * });
  * ```
  */
-export declare function requestExpandedMode(event: PointerEvent): Promise<void>;
+export declare function requestExpandedMode(event: PointerEvent, entry: string): Promise<void>;
 /**
  * Exits expanded mode for the web view.
  * This will display the web view in an inline presentation.
@@ -37,6 +43,7 @@ export declare function requestExpandedMode(event: PointerEvent): Promise<void>;
  * @param event The event that triggered the request, must be a trusted event.
  * @returns A promise that resolves request has been received.
  *
+ * @experimental
  * @example
  * ```ts
  * button.addEventListener('click', async (event) => {
@@ -50,12 +57,14 @@ export declare function exitExpandedMode(event: PointerEvent): Promise<void>;
  * The listener will be called with the new mode, either 'inline' or 'expanded'.
  *
  * @param callback The callback to be called when the mode changes.
+ * @experimental
  */
 export declare function addWebViewModeListener(callback: WebViewModeListener): void;
 /**
  * Removes a listener that was previously added with `addWebViewModeListener`.
  *
  * @param callback The callback to be removed.
+ * @experimental
  */
 export declare function removeWebViewModeListener(callback: WebViewModeListener): void;
 /**

package/effects/web-view-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-view-mode.d.ts","sourceRoot":"","sources":["../../src/effects/web-view-mode.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;AAI9D;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,WAA8C,CAAC;AAEjF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAE7E;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,SAiB/B"}
+{"version":3,"file":"web-view-mode.d.ts","sourceRoot":"","sources":["../../src/effects/web-view-mode.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;AAI9D;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,WAA8C,CAAC;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAE7E;AA2BD;;;GAGG;AACH,wBAAgB,gBAAgB,SAgB/B"}

package/effects/web-view-mode.js

@@ -4,16 +4,20 @@ const modeListeners = new Set();
 /**
  * Represents the current web view mode state for the application.
  *
- * @defaultValue 'inline'
+ * @experimental
  */
 export const getWebViewMode = () => webViewMode(devvit.webViewMode);
 /**
  * Requests expanded mode for the web view.
  * This will display the web view in a larger modal presentation.
  *
- * @param event The event that triggered the request, must be a trusted event.
+ * @param event The gesture that triggered the request, must be a trusted event.
+ * @param entry The destination URI name. Eg, `'splash'` or `'default'`. Entry
+ *              names are the `devvit.json` `post.entrypoints` keys. Passing the
+ *              same entrypoint as currently loaded causes a reload.
  * @returns A promise that resolves request has been received.
  *
+ * @experimental
  * @example
  * ```ts
  * button.addEventListener('click', async (event) => {
@@ -21,8 +25,8 @@ export const getWebViewMode = () => webViewMode(devvit.webViewMode);
  * });
  * ```
  */
-export function requestExpandedMode(event) {
-    return emitModeEffect(WebViewImmersiveMode.IMMERSIVE_MODE, event);
+export function requestExpandedMode(event, entry) {
+    return emitModeEffect(WebViewImmersiveMode.IMMERSIVE_MODE, event, entry);
 }
 /**
  * Exits expanded mode for the web view.
@@ -31,6 +35,7 @@ export function requestExpandedMode(event) {
  * @param event The event that triggered the request, must be a trusted event.
  * @returns A promise that resolves request has been received.
  *
+ * @experimental
  * @example
  * ```ts
  * button.addEventListener('click', async (event) => {
@@ -39,13 +44,14 @@ export function requestExpandedMode(event) {
  * ```
  */
 export function exitExpandedMode(event) {
-    return emitModeEffect(WebViewImmersiveMode.INLINE_MODE, event);
+    return emitModeEffect(WebViewImmersiveMode.INLINE_MODE, event, undefined);
 }
 /**
  * Adds a listener that is called when the web view mode changes.
  * The listener will be called with the new mode, either 'inline' or 'expanded'.
  *
  * @param callback The callback to be called when the mode changes.
+ * @experimental
  */
 export function addWebViewModeListener(callback) {
     modeListeners.add(callback);
@@ -54,24 +60,32 @@ export function addWebViewModeListener(callback) {
  * Removes a listener that was previously added with `addWebViewModeListener`.
  *
  * @param callback The callback to be removed.
+ * @experimental
  */
 export function removeWebViewModeListener(callback) {
     modeListeners.delete(callback);
 }
-async function emitModeEffect(mode, event) {
+async function emitModeEffect(mode, event, entry) {
     if (!event.isTrusted || event.type !== 'click') {
         console.error('Expanded mode effect ignored due to untrusted event');
         throw new Error('Untrusted event');
     }
+    if (entry != null && !devvit.entrypoints[entry])
+        throw Error(`no entrypoint named "${entry}"; all entrypoints must appear in \`devvit.json\` \`post.entrypoints\``);
     const type = 9;
-    await emitEffect({ type, immersiveMode: { immersiveMode: mode } });
+    await emitEffect({
+        type,
+        immersiveMode: {
+            entryUrl: devvit.entrypoints[entry ?? ''],
+            immersiveMode: mode,
+        },
+    });
 }
 /**
  * @internal
  * Handles incoming messages from the client, like when the user closes the immersive modal
  */
 export function registerListener() {
-    console.log('Registering web view mode listener');
     addEventListener('message', (event) => {
         const { type, data } = event.data;
         if (type !== 'devvit-message') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devvit/client",
-  "version": "0.12.1-next-2025-10-01-18-10-24-62f08d94f.0",
+  "version": "0.12.1-next-2025-10-02-15-00-39-af5d076c7.0",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
@@ -33,15 +33,15 @@
     "test:unit-with-coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@devvit/protos": "0.12.1-next-2025-10-01-18-10-24-62f08d94f.0",
-    "@devvit/shared": "0.12.1-next-2025-10-01-18-10-24-62f08d94f.0",
-    "@devvit/shared-types": "0.12.1-next-2025-10-01-18-10-24-62f08d94f.0",
-    "@devvit/web-view-scripts": "0.12.1-next-2025-10-01-18-10-24-62f08d94f.0"
+    "@devvit/protos": "0.12.1-next-2025-10-02-15-00-39-af5d076c7.0",
+    "@devvit/shared": "0.12.1-next-2025-10-02-15-00-39-af5d076c7.0",
+    "@devvit/shared-types": "0.12.1-next-2025-10-02-15-00-39-af5d076c7.0",
+    "@devvit/web-view-scripts": "0.12.1-next-2025-10-02-15-00-39-af5d076c7.0"
   },
   "devDependencies": {
     "@ampproject/filesize": "4.3.0",
-    "@devvit/repo-tools": "0.12.1-next-2025-10-01-18-10-24-62f08d94f.0",
-    "@devvit/tsconfig": "0.12.1-next-2025-10-01-18-10-24-62f08d94f.0",
+    "@devvit/repo-tools": "0.12.1-next-2025-10-02-15-00-39-af5d076c7.0",
+    "@devvit/tsconfig": "0.12.1-next-2025-10-02-15-00-39-af5d076c7.0",
     "esbuild": "0.25.9",
     "eslint": "9.11.1",
     "typescript": "5.8.3",
@@ -53,5 +53,5 @@
       "none": "106 KB"
     }
   },
-  "gitHead": "2fda14fe0187efebee457e09ac011bc15939d754"
+  "gitHead": "6fd0be0d6288a41e40c93579d4f16abe272beb69"
 }