@devvit/public-api 0.11.0-next-2024-08-06-9a9058384.0 → 0.11.0-next-2024-08-06-2b2a01b37.0

package/devvit/internals/blocks/handler/BlocksHandler.d.ts

@@ -17,7 +17,26 @@ export declare function isRendering(): boolean;
  * See [HookSegment](./types.ts) for more information.
  */
 export declare function assertValidNamespace(input: string): void;
+type RegisterHookOptions<H extends Hook> = HookSegment & {
+    /**
+     * Factory function to build the hook. Only called once for the entire lifecycle of a
+     * BlocksHandler.handle() invocation.
+     */
+    initializer: (p: HookParams) => H;
+    /**
+     * A lifecycle hook that gives you the living reference of the hook being used during render. This enables
+     * you to augment properties on the hook as BlocksHandler.handle() is processing events since the initializer
+     * is only called once.
+     *
+     * We require this as hooks are sometimes cached while evaluating events in BlocksHandler.handle(). The best
+     * use of this function is to ensure that your hooks contain up to date information if they have can have
+     * a relationship with a hook that is evaluated before it (see useAsync for an example).
+     */
+    refresh?: (hook: H) => void;
+};
 /**
+ * This can get called multiple times in a given render. Initialize is only called once!
+ *
  * This is the recommended low-level interface for creating hooks like useState or useAsync.
  *
  * Practically, this initializes your hook if it doesn't already exist, and makes sure
@@ -28,7 +47,7 @@ export declare function assertValidNamespace(input: string): void;
  *    factory for building this hook
  * @returns
  */
-export declare function registerHook<H extends Hook>(options: HookSegment, initializer: (p: HookParams) => H): H;
+export declare function registerHook<H extends Hook>({ initializer, refresh, ...hookSegment }: RegisterHookOptions<H>): H;
 export declare let _latestBlocksHandler: BlocksHandler | null;
 /**
  * Replacing BlocksReconciler, the model is now less of a "reconciliation", and more
@@ -41,4 +60,5 @@ export declare class BlocksHandler {
     constructor(root: JSX.ComponentFunction);
     handle(request: UIRequest, metadata: Metadata): Promise<UIResponse>;
 }
+export {};
 //# sourceMappingURL=BlocksHandler.d.ts.map

package/devvit/internals/blocks/handler/BlocksHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlocksHandler.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/BlocksHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAe,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAgB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAe,IAAI,EAAE,UAAU,EAAE,WAAW,EAAS,MAAM,YAAY,CAAC;AAIpF;;;;;;GAMG;AACH,eAAO,IAAI,oBAAoB,EAAE,aAAa,GAAG,IAAW,CAAC;AAE7D,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CASxD;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,IAAI,EACzC,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,CAAC,GAChC,CAAC,CAkCH;AAED,eAAO,IAAI,oBAAoB,EAAE,aAAa,GAAG,IAAW,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,aAAa;;IAMxB,oBAAoB,EAAE,aAAa,GAAG,IAAI,CAAQ;gBAEtC,IAAI,EAAE,GAAG,CAAC,iBAAiB;IAMjC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CAoX1E"}
+{"version":3,"file":"BlocksHandler.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/BlocksHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAe,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAgB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAe,IAAI,EAAE,UAAU,EAAE,WAAW,EAAS,MAAM,YAAY,CAAC;AAIpF;;;;;;GAMG;AACH,eAAO,IAAI,oBAAoB,EAAE,aAAa,GAAG,IAAW,CAAC;AAE7D,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CASxD;AASD,KAAK,mBAAmB,CAAC,CAAC,SAAS,IAAI,IAAI,WAAW,GAAG;IACvD;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,CAAC,CAAC;IAClC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,IAAI,EAAE,EAC3C,WAAW,EACX,OAAO,EACP,GAAG,WAAW,EACf,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CA0C5B;AAED,eAAO,IAAI,oBAAoB,EAAE,aAAa,GAAG,IAAW,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,aAAa;;IAMxB,oBAAoB,EAAE,aAAa,GAAG,IAAI,CAAQ;gBAEtC,IAAI,EAAE,GAAG,CAAC,iBAAiB;IAMjC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CAkX1E"}

package/devvit/internals/blocks/handler/BlocksHandler.js

@@ -52,6 +52,8 @@ function shouldFireAttemptHookWarning(event) {
     return !event.hook;
 }
 /**
+ * This can get called multiple times in a given render. Initialize is only called once!
+ *
  * This is the recommended low-level interface for creating hooks like useState or useAsync.
  *
  * Practically, this initializes your hook if it doesn't already exist, and makes sure
@@ -62,12 +64,12 @@ function shouldFireAttemptHookWarning(event) {
  *    factory for building this hook
  * @returns
  */
-export function registerHook(options, initializer) {
+export function registerHook({ initializer, refresh, ...hookSegment }) {
     if (!_activeRenderContext) {
         throw new Error("Hooks can only be declared at the top of a component.  You cannot declare hooks outside of components or inside of event handlers.  It's almost always a mistake to declare hooks inside of loops or conditionals.");
     }
-    assertValidNamespace(options.namespace);
-    const hookId = _activeRenderContext.nextHookId(options);
+    assertValidNamespace(hookSegment.namespace);
+    const hookId = _activeRenderContext.nextHookId(hookSegment);
     const context = _activeRenderContext;
     context._touched[hookId] = true;
     const params = {
@@ -82,6 +84,13 @@ export function registerHook(options, initializer) {
         _isTombstone(_activeRenderContext._state[hookId]);
     _activeRenderContext._hooks[hookId] = _activeRenderContext._hooks[hookId] ?? initializer(params);
     const hook = _activeRenderContext._hooks[hookId];
+    /**
+     * We now cache hooks sometimes during the lifecycle of a request. However,
+     * certain hooks (useAsync) needs the latest information to make sure it works correctly
+     * refresh gives callers the living reference as a parameter so that they can
+     * mutate it as they see fit.
+     */
+    refresh?.(hook);
     if (!fromNull) {
         hook.state = _activeRenderContext._state[hookId];
     }
@@ -409,11 +418,12 @@ async function _BlocksHandler_handleAsyncQueues(context, ...batch) {
             const hook = registerHook({
                 namespace: key,
                 key: false,
-            }, ({ hookId }) => ({
-                hookId,
-                state: null,
-                onUIEvent: (event) => props[key](event.userAction?.data),
-            }));
+                initializer: ({ hookId }) => ({
+                    hookId,
+                    state: null,
+                    onUIEvent: (event) => props[key](event.userAction?.data),
+                }),
+            });
             reifiedProps[key] = hook.hookId;
             if ('captureHookRef' in props[key]) {
                 props[key].captureHookRef();

package/devvit/internals/blocks/handler/RenderContext.d.ts

@@ -33,7 +33,18 @@ export declare class RenderContext implements EffectEmitter {
      * reuse it.
      */
     _latestRenderContent: ReifiedBlockElement | undefined;
-    /** Has this state been mutated since initially loaded? */
+    /**
+     * Has this state been mutated since initially loaded?
+     *
+     * _changed is used to determine the state deltas to report in the response
+     * of the handle function inside of BlocksHandler. It's very important
+     * that this list contains a comprehensive list of all hooks that have
+     * changed during the entire invocation of BlocksHandler.handle.
+     *
+     * It may be tempting to clear the state deltas on every iteration via the
+     * loop, but in doing so you'll create many roundtrips from the client to
+     * the runtime resulting in the UI flickering.
+     */
     _changed: {
         [hookID: string]: true;
     };

package/devvit/internals/blocks/handler/RenderContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/RenderContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAelE;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,aAAa;;IACjD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAElC,SAAS,EAAE,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAM;IACnD,MAAM,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAM;IACxC,WAAW,EAAE,MAAM,CAAM;IACzB,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAM;IAEzC;;;;OAIG;IACH,oBAAoB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAEtD,0DAA0D;IAC1D,QAAQ,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAM;IAC1C,4DAA4D;IAC5D,QAAQ,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAM;IAC1C,qDAAqD;IACrD,cAAc,EAAE,OAAO,EAAE,CAAM;IAE/B,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAM;IACxC,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAM;IAC5C,MAAM,CAAC,0BAA0B,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;KAAE,CAAM;IACxE,oBAAoB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;KAAE,CAAM;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IAEhC,IAAI,aAAa,IAAI,MAAM,CAAC,OAAO,CAKlC;IAED,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAExC;gBAEW,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ;IAS9C,0CAA0C;IAC1C,IAAI,aAAa,IAAI,WAAW,CAsB/B;IAED,IAAI,KAAK,IAAI;QAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAE/C;IAED,iCAAiC;IACjC,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,4DAA4D;IAC5D,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,EAI5B;IAED,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAIhC,GAAG,IAAI,IAAI;IAIX,0BAA0B,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAInE,gCAAgC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAIzE,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAG3B,4GAA4G;IAC5G,MAAM,CAAC,gCAAgC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAI1E,sBAAsB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAUnE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACH,kBAAkB,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAmB9C,IAAI,OAAO,IAAI,MAAM,EAAE,CAEtB;IAED,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;CA0CzC"}
+{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/RenderContext.ts"],"names":[],"mappings":"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"}

package/devvit/internals/blocks/handler/RenderContext.js

@@ -40,7 +40,18 @@ export class RenderContext {
         this._hooks = {};
         this._prevHookId = '';
         this._effects = {};
-        /** Has this state been mutated since initially loaded? */
+        /**
+         * Has this state been mutated since initially loaded?
+         *
+         * _changed is used to determine the state deltas to report in the response
+         * of the handle function inside of BlocksHandler. It's very important
+         * that this list contains a comprehensive list of all hooks that have
+         * changed during the entire invocation of BlocksHandler.handle.
+         *
+         * It may be tempting to clear the state deltas on every iteration via the
+         * loop, but in doing so you'll create many roundtrips from the client to
+         * the runtime resulting in the UI flickering.
+         */
         this._changed = {};
         /** Does this hook still exist in the most recent render? */
         this._touched = {};
@@ -89,7 +100,11 @@ export class RenderContext {
     }
     /** Replacing state resets the delta for the next render. */
     set _state(state) {
-        this._changed = {};
+        // You may be tempted to put `this._changed = {}` here, please DON'T!
+        // There are many times we may choose to reset the state while processing
+        // events. Remember that the BlocksHandler can do N number of passes before
+        // it determines it is time to send a response back to the client. _changed
+        // needs to encompass all of those changes.
         this._hooks = {};
         __classPrivateFieldSet(this, _RenderContext_state, state, "f");
     }

package/devvit/internals/blocks/handler/useAsync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAsync.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/useAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAS3F,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,OAAO,GAAG;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA;AAkGD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,EAC1C,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC,EACxC,OAAO,GAAE,YAAiB,GACzB,cAAc,CAAC,CAAC,CAAC,CAUnB"}
+{"version":3,"file":"useAsync.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/useAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAS3F,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,OAAO,GAAG;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA;AAmGD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,EAC1C,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC,EACxC,OAAO,GAAE,YAAiB,GACzB,cAAc,CAAC,CAAC,CAAC,CAwBnB"}

package/devvit/internals/blocks/handler/useAsync.js

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _AsyncHook_debug, _AsyncHook_hookId, _AsyncHook_initializer, _AsyncHook_invalidate, _AsyncHook_ctx, _AsyncHook_localDepends;
+var _AsyncHook_debug, _AsyncHook_hookId, _AsyncHook_invalidate, _AsyncHook_ctx;
 import { CIRCUIT_BREAKER_MSG } from '@devvit/shared-types/CircuitBreaker.js';
 import isEqual from 'lodash.isequal';
 import { registerHook } from './BlocksHandler.js';
@@ -37,19 +37,17 @@ class AsyncHook {
     constructor(initializer, options, params) {
         _AsyncHook_debug.set(this, void 0);
         _AsyncHook_hookId.set(this, void 0);
-        _AsyncHook_initializer.set(this, void 0);
         _AsyncHook_invalidate.set(this, void 0);
         _AsyncHook_ctx.set(this, void 0);
-        _AsyncHook_localDepends.set(this, void 0);
         __classPrivateFieldSet(this, _AsyncHook_debug, !!params.context.devvitContext.debug.useAsync, "f");
         if (__classPrivateFieldGet(this, _AsyncHook_debug, "f"))
             console.debug('[useAsync] v1', options);
         this.state = { data: null, load_state: 'initial', error: null, depends: null };
         __classPrivateFieldSet(this, _AsyncHook_hookId, params.hookId, "f");
-        __classPrivateFieldSet(this, _AsyncHook_initializer, initializer, "f");
+        this.initializer = initializer;
         __classPrivateFieldSet(this, _AsyncHook_invalidate, params.invalidate, "f");
         __classPrivateFieldSet(this, _AsyncHook_ctx, params.context, "f");
-        __classPrivateFieldSet(this, _AsyncHook_localDepends, options.depends ?? null, "f");
+        this.localDepends = options.depends ?? null;
     }
     /**
      * After we look at our state, we need to decide if we need to dispatch a request to load the data.
@@ -61,10 +59,12 @@ class AsyncHook {
         if (__classPrivateFieldGet(this, _AsyncHook_debug, "f"))
             console.debug('[useAsync] async onLoad ', __classPrivateFieldGet(this, _AsyncHook_hookId, "f"), this.state);
         if (__classPrivateFieldGet(this, _AsyncHook_debug, "f"))
-            console.debug('[useAsync] async onLoad have ', __classPrivateFieldGet(this, _AsyncHook_localDepends, "f"), 'and', this.state.depends);
-        if (!isEqual(__classPrivateFieldGet(this, _AsyncHook_localDepends, "f"), this.state.depends) || this.state.load_state === 'initial') {
+            console.debug('[useAsync] async onLoad have ', this.localDepends, 'and', this.state.depends);
+        if (!isEqual(this.localDepends, this.state.depends) || this.state.load_state === 'initial') {
+            if (__classPrivateFieldGet(this, _AsyncHook_debug, "f"))
+                console.debug(`[useAsync] attempting to resolve for hookId`, __classPrivateFieldGet(this, _AsyncHook_hookId, "f"));
             this.state.load_state = 'loading';
-            this.state.depends = __classPrivateFieldGet(this, _AsyncHook_localDepends, "f");
+            this.state.depends = this.localDepends;
             __classPrivateFieldGet(this, _AsyncHook_invalidate, "f").call(this);
             const requeueEvent = {
                 hook: __classPrivateFieldGet(this, _AsyncHook_hookId, "f"),
@@ -89,7 +89,7 @@ class AsyncHook {
             const asyncResponse = { requestId: event.asyncRequest.requestId };
             try {
                 asyncResponse.data = {
-                    value: await __classPrivateFieldGet(this, _AsyncHook_initializer, "f").call(this),
+                    value: await this.initializer(),
                 };
             }
             catch (e) {
@@ -124,7 +124,7 @@ class AsyncHook {
         }
     }
 }
-_AsyncHook_debug = new WeakMap(), _AsyncHook_hookId = new WeakMap(), _AsyncHook_initializer = new WeakMap(), _AsyncHook_invalidate = new WeakMap(), _AsyncHook_ctx = new WeakMap(), _AsyncHook_localDepends = new WeakMap();
+_AsyncHook_debug = new WeakMap(), _AsyncHook_hookId = new WeakMap(), _AsyncHook_invalidate = new WeakMap(), _AsyncHook_ctx = new WeakMap();
 /**
  * This is the preferred way to handle async state in Devvit.
  *
@@ -132,8 +132,22 @@ _AsyncHook_debug = new WeakMap(), _AsyncHook_hookId = new WeakMap(), _AsyncHook_
  * @returns UseAsyncResult<S>
  */
 export function useAsync(initializer, options = {}) {
-    const hook = registerHook({ namespace: 'useAsync' }, (params) => {
-        return new AsyncHook(initializer, options, params);
+    const hook = registerHook({
+        namespace: 'useAsync',
+        initializer: (params) => {
+            return new AsyncHook(initializer, options, params);
+        },
+        /**
+         * This is required due to hook caching. We need a way for certain values to always have the most
+         * up to date information before evaluating the hook again.
+         *
+         * initializer can use values from other stateful hook and always needs the latest values to be accurate
+         * localDepends is needed so that the dependency check is against the latest values
+         */
+        refresh: (h) => {
+            h.initializer = initializer;
+            h.localDepends = options.depends ?? null;
+        },
     });
     return {
         data: hook.state.data,

package/devvit/internals/blocks/handler/useChannel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChannel.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/useChannel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AA+HpE,wBAAgB,UAAU,CAAC,OAAO,SAAS,SAAS,EAClD,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,GACtC,gBAAgB,CAAC,OAAO,CAAC,CAU3B"}
+{"version":3,"file":"useChannel.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/useChannel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AA+HpE,wBAAgB,UAAU,CAAC,OAAO,SAAS,SAAS,EAClD,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,GACtC,gBAAgB,CAAC,OAAO,CAAC,CAc3B"}

package/devvit/internals/blocks/handler/useChannel.js

@@ -125,5 +125,9 @@ export function useChannel(opts) {
     // allow RealtimeEffectHandler to compute hook ID. maintain compatibility with
     // realtimeChannelToHookID().
     const id = `useChannel:${opts.name}`;
-    return registerHook({ id, namespace: id }, (params) => new ChannelHook(opts, params));
+    return registerHook({
+        id,
+        namespace: id,
+        initializer: (params) => new ChannelHook(opts, params),
+    });
 }

package/devvit/internals/blocks/handler/useForm.js

@@ -15,7 +15,10 @@ class UseFormHook {
     }
 }
 export function useForm(form, onSubmit) {
-    const hook = registerHook({ namespace: 'useForm' }, (params) => new UseFormHook(params, form, onSubmit));
+    const hook = registerHook({
+        namespace: 'useForm',
+        initializer: (params) => new UseFormHook(params, form, onSubmit),
+    });
     return hookRefToFormKey({ id: hook.hookId });
 }
 export function hookRefToFormKey(hookRef) {

package/devvit/internals/blocks/handler/useInterval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useInterval.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/useInterval.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAqEpE,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACpC,gBAAgB,EAAE,MAAM,GACvB,iBAAiB,CASnB"}
+{"version":3,"file":"useInterval.d.ts","sourceRoot":"","sources":["../../../../../src/devvit/internals/blocks/handler/useInterval.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAqEpE,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACpC,gBAAgB,EAAE,MAAM,GACvB,iBAAiB,CAYnB"}

package/devvit/internals/blocks/handler/useInterval.js

@@ -73,8 +73,11 @@ class IntervalHook {
 }
 _IntervalHook_hookId = new WeakMap(), _IntervalHook_invalidate = new WeakMap(), _IntervalHook_callback = new WeakMap(), _IntervalHook_context = new WeakMap();
 export function useInterval(callback, requestedDelayMs) {
-    const hook = registerHook({ namespace: 'useInterval' }, (params) => {
-        return new IntervalHook(callback, requestedDelayMs, params);
+    const hook = registerHook({
+        namespace: 'useInterval',
+        initializer: (params) => {
+            return new IntervalHook(callback, requestedDelayMs, params);
+        },
     });
     return {
         start: () => hook.start(),

package/devvit/internals/blocks/handler/useState.js

@@ -110,6 +110,9 @@ class UseStateHook {
 }
 _UseStateHook_changed = new WeakMap(), _UseStateHook_ctx = new WeakMap(), _UseStateHook_initializer = new WeakMap(), _UseStateHook_hookId = new WeakMap(), _UseStateHook_promise = new WeakMap();
 export function useState(initialState) {
-    const hook = registerHook({ namespace: 'useState' }, (params) => new UseStateHook(initialState, params));
+    const hook = registerHook({
+        namespace: 'useState',
+        initializer: (params) => new UseStateHook(initialState, params),
+    });
     return [hook.state.value, hook.setter.bind(hook)];
 }

package/meta.json

@@ -2777,18 +2777,13 @@
       "format": "esm"
     },
     "../protos/dist/types/devvit/runtime/runtime_common.js": {
-      "bytes": 7348,
+      "bytes": 1828,
       "imports": [
         {
           "path": "../../node_modules/protobufjs/minimal.js",
           "kind": "import-statement",
           "original": "protobufjs/minimal.js"
         },
-        {
-          "path": "../protos/dist/types/google/protobuf/struct.js",
-          "kind": "import-statement",
-          "original": "../../google/protobuf/struct.js"
-        },
         {
           "path": "../protos/dist/types/typeRegistry.js",
           "kind": "import-statement",
@@ -8056,7 +8051,7 @@
       "format": "esm"
     },
     "../protos/dist/types/devvit/runtime/actor/echo.js": {
-      "bytes": 973,
+      "bytes": 1029,
       "imports": [
         {
           "path": "../../node_modules/protobufjs/minimal.js",
@@ -8064,9 +8059,9 @@
           "original": "protobufjs/minimal.js"
         },
         {
-          "path": "../protos/dist/types/devvit/runtime/runtime_common.js",
+          "path": "../protos/dist/types/google/protobuf/wrappers.js",
           "kind": "import-statement",
-          "original": "../runtime_common.js"
+          "original": "../../../google/protobuf/wrappers.js"
         }
       ],
       "format": "esm"
@@ -12204,7 +12199,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useForm.ts": {
-      "bytes": 1910,
+      "bytes": 1922,
       "imports": [
         {
           "path": "../shared-types/dist/useForm.js",
@@ -12261,7 +12256,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useChannel.ts": {
-      "bytes": 5738,
+      "bytes": 5766,
       "imports": [
         {
           "path": "../protos/dist/index.js",
@@ -12292,7 +12287,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/RenderContext.ts": {
-      "bytes": 7063,
+      "bytes": 7910,
       "imports": [
         {
           "path": "<runtime>",
@@ -12303,7 +12298,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useInterval.ts": {
-      "bytes": 2540,
+      "bytes": 2568,
       "imports": [
         {
           "path": "../protos/dist/index.js",
@@ -12339,7 +12334,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useAsync.ts": {
-      "bytes": 5534,
+      "bytes": 6151,
       "imports": [
         {
           "path": "../shared-types/dist/CircuitBreaker.js",
@@ -12370,7 +12365,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useState.ts": {
-      "bytes": 4615,
+      "bytes": 4627,
       "imports": [
         {
           "path": "src/devvit/internals/blocks/handler/BlocksHandler.ts",
@@ -12509,7 +12504,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/BlocksHandler.ts": {
-      "bytes": 18389,
+      "bytes": 19643,
       "imports": [
         {
           "path": "@devvit/protos",
@@ -13881,7 +13876,7 @@
           "bytesInOutput": 9450
         },
         "../protos/dist/types/devvit/runtime/runtime_common.js": {
-          "bytesInOutput": 6812
+          "bytesInOutput": 1631
         },
         "../protos/dist/types/devvit/service/bundle_service.js": {
           "bytesInOutput": 1728
@@ -13890,7 +13885,7 @@
           "bytesInOutput": 37009
         },
         "../protos/dist/types/devvit/runtime/serializable.js": {
-          "bytesInOutput": 7835
+          "bytesInOutput": 7825
         },
         "../protos/dist/types/devvit/remote_logger/remote_logger.js": {
           "bytesInOutput": 18042
@@ -14208,7 +14203,7 @@
           "bytesInOutput": 11853
         },
         "../protos/dist/types/devvit/plugin/redditapi/privatemessages/privatemessages_msg.js": {
-          "bytesInOutput": 11866
+          "bytesInOutput": 11851
         },
         "../protos/dist/types/devvit/plugin/redditapi/postcollections/postcollections_svc.js": {
           "bytesInOutput": 3667
@@ -14415,19 +14410,19 @@
           "bytesInOutput": 162
         },
         "src/devvit/internals/blocks/handler/useForm.ts": {
-          "bytesInOutput": 819
+          "bytesInOutput": 830
         },
         "src/devvit/internals/blocks/handler/UIClient.ts": {
           "bytesInOutput": 2041
         },
         "src/devvit/internals/blocks/handler/useChannel.ts": {
-          "bytesInOutput": 5112
+          "bytesInOutput": 5147
         },
         "src/devvit/internals/blocks/handler/RenderContext.ts": {
-          "bytesInOutput": 5070
+          "bytesInOutput": 5599
         },
         "src/devvit/internals/blocks/handler/useInterval.ts": {
-          "bytesInOutput": 2414
+          "bytesInOutput": 2447
         },
         "src/devvit/internals/blocks/handler/types.ts": {
           "bytesInOutput": 56
@@ -14436,10 +14431,10 @@
           "bytesInOutput": 138
         },
         "src/devvit/internals/blocks/handler/useAsync.ts": {
-          "bytesInOutput": 4317
+          "bytesInOutput": 4725
         },
         "src/devvit/internals/blocks/handler/useState.ts": {
-          "bytesInOutput": 3762
+          "bytesInOutput": 3766
         },
         "src/devvit/internals/blocks/handler/promise_cache.ts": {
           "bytesInOutput": 7624
@@ -14451,7 +14446,7 @@
           "bytesInOutput": 1362
         },
         "src/devvit/internals/blocks/handler/BlocksHandler.ts": {
-          "bytesInOutput": 14625
+          "bytesInOutput": 14675
         },
         "src/devvit/internals/ui-request-handler.ts": {
           "bytesInOutput": 639
@@ -14535,7 +14530,7 @@
           "bytesInOutput": 370
         }
       },
-      "bytes": 14799051
+      "bytes": 14786471
     }
   }
 }

package/meta.min.json

@@ -3528,7 +3528,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useForm.ts": {
-      "bytes": 1910,
+      "bytes": 1922,
       "imports": [
         {
           "path": "../shared-types/dist/useForm.js",
@@ -3585,7 +3585,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useChannel.ts": {
-      "bytes": 5738,
+      "bytes": 5766,
       "imports": [
         {
           "path": "@devvit/protos",
@@ -3616,7 +3616,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/RenderContext.ts": {
-      "bytes": 7063,
+      "bytes": 7910,
       "imports": [
         {
           "path": "<runtime>",
@@ -3627,7 +3627,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useInterval.ts": {
-      "bytes": 2540,
+      "bytes": 2568,
       "imports": [
         {
           "path": "@devvit/protos",
@@ -3663,7 +3663,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useAsync.ts": {
-      "bytes": 5534,
+      "bytes": 6151,
       "imports": [
         {
           "path": "../shared-types/dist/CircuitBreaker.js",
@@ -3694,7 +3694,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/useState.ts": {
-      "bytes": 4615,
+      "bytes": 4627,
       "imports": [
         {
           "path": "src/devvit/internals/blocks/handler/BlocksHandler.ts",
@@ -3833,7 +3833,7 @@
       "format": "esm"
     },
     "src/devvit/internals/blocks/handler/BlocksHandler.ts": {
-      "bytes": 18389,
+      "bytes": 19643,
       "imports": [
         {
           "path": "@devvit/protos",
@@ -4738,7 +4738,7 @@
       "imports": [],
       "exports": [],
       "inputs": {},
-      "bytes": 1188297
+      "bytes": 1191226
     },
     "dist/public-api.min.js": {
       "imports": [
@@ -5439,16 +5439,16 @@
           "bytesInOutput": 74
         },
         "src/devvit/internals/blocks/handler/useForm.ts": {
-          "bytesInOutput": 367
+          "bytesInOutput": 379
         },
         "src/devvit/internals/blocks/handler/useChannel.ts": {
-          "bytesInOutput": 2947
+          "bytesInOutput": 2959
         },
         "src/devvit/internals/blocks/handler/useInterval.ts": {
-          "bytesInOutput": 1201
+          "bytesInOutput": 1213
         },
         "src/devvit/internals/blocks/handler/RenderContext.ts": {
-          "bytesInOutput": 2404
+          "bytesInOutput": 2387
         },
         "src/devvit/internals/blocks/handler/types.ts": {
           "bytesInOutput": 29
@@ -5457,10 +5457,10 @@
           "bytesInOutput": 66
         },
         "src/devvit/internals/blocks/handler/useAsync.ts": {
-          "bytesInOutput": 2077
+          "bytesInOutput": 2206
         },
         "src/devvit/internals/blocks/handler/useState.ts": {
-          "bytesInOutput": 1486
+          "bytesInOutput": 1498
         },
         "src/devvit/internals/blocks/handler/promise_cache.ts": {
           "bytesInOutput": 2598
@@ -5472,7 +5472,7 @@
           "bytesInOutput": 530
         },
         "src/devvit/internals/blocks/handler/BlocksHandler.ts": {
-          "bytesInOutput": 6630
+          "bytesInOutput": 6676
         },
         "src/apis/reddit/helpers/makeGettersEnumerable.ts": {
           "bytesInOutput": 166
@@ -5550,7 +5550,7 @@
           "bytesInOutput": 178
         }
       },
-      "bytes": 250694
+      "bytes": 250900
     }
   }
 }