@devvit/ui-renderer 0.10.17-next-2024-02-23-065bf7067.0 → 0.10.17-next-2024-02-26-9e49b4eeb.0

package/client/app-ui-looper.d.ts

@@ -0,0 +1,67 @@
+import { BlockRenderEventType, Effect, LinkedBundle, Metadata, RenderPostRequest, RenderPostResponse, Struct, UIEvent } from '@devvit/protos';
+import { ErrorCallback, LiteClient } from '@devvit/runtime-lite/client/BrowserLiteClient.js';
+import { PluginCallback } from '@devvit/runtime-lite/runtime/RuntimeLite.js';
+import { T3ID, TID } from '@devvit/shared-types/tid.js';
+import { UIApp } from './ui-app.js';
+type AppState = {
+    __postData?: {
+        thingId: TID | undefined;
+        config: Struct['fields'] | undefined;
+    };
+    [key: string]: unknown;
+};
+type EventData = {
+    [key: string]: unknown;
+};
+/**
+ * App render and effect looping logic. Rendering and event processing is as
+ * follows:
+ *
+ * 1. Try the local runtime, if available.
+ * 2. If a local runtime or bundle is unavailable, or local execution fails
+ *    (including CircuitBreak), try the remote.
+ * 3. Report execution errors by callback only. In general, all errors are
+ *    attempted to be tolerated.
+ *
+ * App / render state is always preserved even on error so a buggy app will try
+ * not to show any issues. A bundle or runtime can be replaced on the fly with
+ * losing state.
+ */
+export declare class AppUILooper {
+    #private;
+    meta?: Metadata | undefined;
+    onError?: ErrorCallback | undefined;
+    onPluginCall?: PluginCallback | undefined;
+    onRenderPost?: ((req: RenderPostRequest, rsp: RenderPostResponse) => void) | undefined;
+    onUserAction?: ((fx: Effect) => void) | undefined;
+    postConfig?: Struct['fields'] | undefined;
+    postID?: T3ID | undefined;
+    /** A client to the remote runtime. */
+    remote?: UIApp | undefined;
+    /**
+     * A client to the local runtime.
+     * @internal
+     */
+    _local?: LiteClient | undefined;
+    /** Get the current app state with the current post state. */
+    get appState(): AppState;
+    /**
+     * Load an app bundle into the local runtime, if available. The bundle is
+     * assumed to implement a UIApp.
+     */
+    load(app: Readonly<LinkedBundle>, sandbox: boolean): Promise<void>;
+    queueEvent(ev: UIEvent): void;
+    queueRenderPost(type: BlockRenderEventType, id: string | undefined, data: EventData): void;
+    get rendered(): boolean;
+    /**
+     * Discard app and render state. This is used indirectly by devvit-preview
+     * which frequently loads new bundles.
+     */
+    resetAppState(): void;
+    /** Set the runtime source code. */
+    setLocalSrc(src: Blob | undefined): void;
+    /** Unload the app and reject any open requests. */
+    unload(): void;
+}
+export {};
+//# sourceMappingURL=app-ui-looper.d.ts.map

package/client/app-ui-looper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-ui-looper.d.ts","sourceRoot":"","sources":["../../library/src/client/app-ui-looper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,MAAM,EAGN,YAAY,EACZ,QAAQ,EAER,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,EACN,OAAO,EACR,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,aAAa,EACb,UAAU,EACX,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAE7E,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAGxD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQpC,KAAK,QAAQ,GAAG;IACd,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,GAAG,GAAG,SAAS,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;KACtC,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AACF,KAAK,SAAS,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;;IACtB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC1C,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvF,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC1C,MAAM,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC1B,sCAAsC;IACtC,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAU3B;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAWhC,6DAA6D;IAC7D,IAAI,QAAQ,IAAI,QAAQ,CAGvB;IAED;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASxE,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAU7B,eAAe,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAI1F,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;OAGG;IACH,aAAa,IAAI,IAAI;IAKrB,mCAAmC;IACnC,WAAW,CAAC,GAAG,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI;IAUxC,mDAAmD;IACnD,MAAM,IAAI,IAAI;CAoGf"}

package/client/app-ui-looper.js

@@ -0,0 +1,206 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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 __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _AppUILooper_instances, _AppUILooper_appState, _AppUILooper_q, _AppUILooper_rendered, _AppUILooper_rerenderTimeout, _AppUILooper_onEffects, _AppUILooper_onPluginCall, _AppUILooper_processEvent, _AppUILooper_renderPost;
+import { BlockRenderEventType, RealtimeDefinition, } from '@devvit/protos';
+import { BrowserLiteClient, } from '@devvit/runtime-lite/client/BrowserLiteClient.js';
+import { isCircuitBreaker } from '@devvit/runtime-lite/types/CircuitBreaker.js';
+import PQueue from 'p-queue';
+import { initDevvitGlobal } from '../types/devvit-global.js';
+// Effects that can only be fired as the result of a user action
+const userActionEffects = ['showToast', 'showForm', 'navigateToUrl'];
+initDevvitGlobal();
+/**
+ * App render and effect looping logic. Rendering and event processing is as
+ * follows:
+ *
+ * 1. Try the local runtime, if available.
+ * 2. If a local runtime or bundle is unavailable, or local execution fails
+ *    (including CircuitBreak), try the remote.
+ * 3. Report execution errors by callback only. In general, all errors are
+ *    attempted to be tolerated.
+ *
+ * App / render state is always preserved even on error so a buggy app will try
+ * not to show any issues. A bundle or runtime can be replaced on the fly with
+ * losing state.
+ */
+export class AppUILooper {
+    constructor() {
+        _AppUILooper_instances.add(this);
+        /**
+         * App state is never reset in production. Prior remote executions may have
+         * occurred. The next loop will replace the state. Do not lose the current
+         * state even after a bundle has been downloaded and is ready to load. The
+         * only time state should be reinitialized is when a bundle has been
+         * _replaced_ such as by devvit-preview.
+         */
+        _AppUILooper_appState.set(this, {});
+        /** No concurrency is used to enforce order. to-do: replace with array? */
+        _AppUILooper_q.set(this, new PQueue({ concurrency: 1 }));
+        /**
+         * True if app has rendered since loaded. Since a successful render isn't
+         * known at queue time, it's possible for multiple redundant renders to be
+         * enqueued.
+         */
+        _AppUILooper_rendered.set(this, false);
+        _AppUILooper_rerenderTimeout.set(this, void 0);
+        _AppUILooper_onPluginCall.set(this, (id, serviceName, method, args, meta) => {
+            this.onPluginCall?.(id, serviceName, method, args, meta);
+            if (serviceName === RealtimeDefinition.fullName &&
+                method === RealtimeDefinition.methods.send.name)
+                this._local?.onPluginResponse(id, { error: undefined, success: true, value: {} });
+        });
+    }
+    /** Get the current app state with the current post state. */
+    get appState() {
+        __classPrivateFieldGet(this, _AppUILooper_appState, "f").__postData = { thingId: this.postID, config: this.postConfig };
+        return __classPrivateFieldGet(this, _AppUILooper_appState, "f");
+    }
+    /**
+     * Load an app bundle into the local runtime, if available. The bundle is
+     * assumed to implement a UIApp.
+     */
+    async load(app, sandbox) {
+        this.unload();
+        try {
+            await this._local?.loadBundle(app, sandbox);
+        }
+        catch (err) {
+            this.onError?.('Error', err);
+        }
+    }
+    queueEvent(ev) {
+        if (ev.queue) {
+            // TODO: Add QoS for different types of events on alternate queues. For
+            // now, treat alternate queues as having infinite concurrency.
+            void __classPrivateFieldGet(this, _AppUILooper_instances, "m", _AppUILooper_processEvent).call(this, ev);
+        }
+        else {
+            void __classPrivateFieldGet(this, _AppUILooper_q, "f").add(() => __classPrivateFieldGet(this, _AppUILooper_instances, "m", _AppUILooper_processEvent).call(this, ev));
+        }
+    }
+    queueRenderPost(type, id, data) {
+        void __classPrivateFieldGet(this, _AppUILooper_q, "f").add(() => __classPrivateFieldGet(this, _AppUILooper_instances, "m", _AppUILooper_renderPost).call(this, type, id, data));
+    }
+    get rendered() {
+        return __classPrivateFieldGet(this, _AppUILooper_rendered, "f");
+    }
+    /**
+     * Discard app and render state. This is used indirectly by devvit-preview
+     * which frequently loads new bundles.
+     */
+    resetAppState() {
+        __classPrivateFieldSet(this, _AppUILooper_rendered, false, "f");
+        __classPrivateFieldSet(this, _AppUILooper_appState, {}, "f");
+    }
+    /** Set the runtime source code. */
+    setLocalSrc(src) {
+        this.unload();
+        this._local = src
+            ? new BrowserLiteClient(src, (type, err) => this.onError?.(type, err), {
+                callback: __classPrivateFieldGet(this, _AppUILooper_onPluginCall, "f"),
+                plugins: [RealtimeDefinition.fullName],
+            })
+            : undefined;
+    }
+    /** Unload the app and reject any open requests. */
+    unload() {
+        if (__classPrivateFieldGet(this, _AppUILooper_rerenderTimeout, "f") != null)
+            clearTimeout(__classPrivateFieldGet(this, _AppUILooper_rerenderTimeout, "f"));
+        // Disable errors, wipe the old client rejecting any open promises, then
+        // re-enable errors. Leave app state as-is.
+        const onError = this.onError;
+        this.onError = undefined;
+        this._local?.quit();
+        this.onError = onError;
+    }
+}
+_AppUILooper_appState = new WeakMap(), _AppUILooper_q = new WeakMap(), _AppUILooper_rendered = new WeakMap(), _AppUILooper_rerenderTimeout = new WeakMap(), _AppUILooper_onPluginCall = new WeakMap(), _AppUILooper_instances = new WeakSet(), _AppUILooper_onEffects = function _AppUILooper_onEffects(renderType, effects) {
+    for (const effect of effects) {
+        if (effect.rerenderUi) {
+            if (__classPrivateFieldGet(this, _AppUILooper_rerenderTimeout, "f") != null)
+                clearTimeout(__classPrivateFieldGet(this, _AppUILooper_rerenderTimeout, "f"));
+            __classPrivateFieldSet(this, _AppUILooper_rerenderTimeout, setTimeout(() => {
+                this.queueRenderPost(BlockRenderEventType.RENDER_EFFECT_EVENT, 'rerender-effect', {});
+            }, (effect.rerenderUi.delaySeconds ?? 0) * 1000), "f");
+        }
+        else if (effect.sendEvent?.event) {
+            this.queueEvent(effect.sendEvent.event);
+        }
+        else if (renderType !== BlockRenderEventType.RENDER_USER_ACTION ||
+            userActionEffects.some((type) => effect[type])) {
+            this.onUserAction?.(effect);
+        }
+    }
+}, _AppUILooper_processEvent = async function _AppUILooper_processEvent(ev) {
+    let rsp;
+    const req = { event: ev, state: this.appState };
+    if (this._local?.ready) {
+        try {
+            rsp = (await this._local.call('HandleUIEvent', req, this.meta));
+        }
+        catch (err) {
+            if (!isCircuitBreaker(err) || !this.remote)
+                this.onError?.('Error', err);
+            if (devvit?.logLocalErrors)
+                console.info('remote call', err);
+        }
+    }
+    if (!rsp) {
+        try {
+            rsp = await this.remote?.HandleUIEvent(req, this.meta);
+        }
+        catch (err) {
+            this.onError?.('Error', err);
+        }
+    }
+    if (rsp) {
+        // Can only change state on the main queue.
+        if (!ev.queue) {
+            __classPrivateFieldSet(this, _AppUILooper_appState, rsp.state ?? {}, "f");
+        }
+        const renderType = ev.realtimeEvent
+            ? BlockRenderEventType.RENDER_EFFECT_EVENT
+            : BlockRenderEventType.RENDER_USER_ACTION;
+        __classPrivateFieldGet(this, _AppUILooper_instances, "m", _AppUILooper_onEffects).call(this, renderType, rsp.effects);
+    }
+}, _AppUILooper_renderPost = async function _AppUILooper_renderPost(type, id, data) {
+    const req = { blocks: { type, id, data }, state: this.appState };
+    let rsp;
+    if (this._local?.ready) {
+        try {
+            rsp = (await this._local?.call('RenderPost', req, this.meta));
+        }
+        catch (err) {
+            if (isCircuitBreaker(err) && err.response)
+                rsp = err.response;
+            if (!isCircuitBreaker(err) || !this.remote)
+                this.onError?.('Error', err);
+            if (devvit?.logLocalErrors)
+                console.info('remote call', err);
+        }
+    }
+    if (!rsp) {
+        try {
+            rsp = await this.remote?.RenderPost(req, this.meta);
+        }
+        catch (err) {
+            this.onError?.('Error', err);
+        }
+    }
+    if (rsp) {
+        __classPrivateFieldSet(this, _AppUILooper_rendered, true, "f");
+        if (rsp.state)
+            __classPrivateFieldSet(this, _AppUILooper_appState, rsp.state, "f");
+        this.onRenderPost?.(req, rsp);
+        __classPrivateFieldGet(this, _AppUILooper_instances, "m", _AppUILooper_onEffects).call(this, req.blocks.type, rsp.effects);
+    }
+};

package/client/app-ui-looper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-ui-looper.test.d.ts","sourceRoot":"","sources":["../../library/src/client/app-ui-looper.test.ts"],"names":[],"mappings":""}

package/client/devvit-custom-post.d.ts

@@ -5,6 +5,7 @@ import { WorkerErrorType } from '@devvit/runtime-lite/client/BrowserLiteClient.j
 import type { ActorRef } from '@devvit/runtimes/common/runtime/ActorRef.js';
 import { FaceplateEvent } from '@reddit/faceplate/event-types.js';
 import { LitElement, PropertyValues } from 'lit';
+import { UIApp } from './ui-app.js';
 import '../blocks/components/devvit-blocks-renderer.js';
 import '../blocks/components/devvit-blocks-webview.js';
 import './devvit-animation-player.js';
@@ -49,12 +50,16 @@ export type DevvitUserActionEvent = FaceplateEvent<'devvit-user-action'> & {
  *
  * Assumes the loaded program is a CustomPost & UIEventHandler.
  *
+ * The complexity of this class should only be the UI itself and proxying state
+ * to devvit-blocks-renderer and AppUILooper. Don't put logic here that you
+ * can't unit test.
+ *
  * @slot - Loading / unloaded state.
  */
 export declare class DevvitCustomPost extends LitElement {
     #private;
     /** Probably a wrapper around the remote runtime (compute-go). */
-    actorRef?: ActorRef | undefined;
+    actorRef?: ActorRef | UIApp | undefined;
     bundle?: LinkedBundle | undefined;
     localRuntimeCode?: Blob | undefined;
     metadata?: Metadata | undefined;
@@ -68,6 +73,7 @@ export declare class DevvitCustomPost extends LitElement {
     private _isSuspended;
     private _rootBlock?;
     constructor();
+    connectedCallback(): Promise<void>;
     disconnectedCallback(): void;
     get blocksConfig(): string;
     rerender(): void;

package/client/devvit-custom-post.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devvit-custom-post.d.ts","sourceRoot":"","sources":["../../library/src/client/devvit-custom-post.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"devvit-custom-post.d.ts","sourceRoot":"","sources":["../../library/src/client/devvit-custom-post.ts"],"names":[],"mappings":"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"}

package/client/devvit-custom-post.js

@@ -18,36 +18,33 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _DevvitCustomPost_instances, _DevvitCustomPost_appState, _DevvitCustomPost_customPostActor, _DevvitCustomPost_hasInitialRender, _DevvitCustomPost_lastRequest, _DevvitCustomPost_localClient, _DevvitCustomPost_rerenderTimeout, _DevvitCustomPost_rootHeight, _DevvitCustomPost_rpcQueue, _DevvitCustomPost_uiEventHandlerActor, _DevvitCustomPost_bubble, _DevvitCustomPost_effectEventRender, _DevvitCustomPost_handleEffects, _DevvitCustomPost_handleUserAction, _DevvitCustomPost_initialRender, _DevvitCustomPost_makeRenderContext, _DevvitCustomPost_newRenderRequest, _DevvitCustomPost_onPluginCall, _DevvitCustomPost_processEvent, _DevvitCustomPost_queueEvent, _DevvitCustomPost_queueRenderPost, _DevvitCustomPost_renderPost, _DevvitCustomPost_state_get, _DevvitCustomPost_suspendPost, _DevvitCustomPost_userActionRender;
+var _DevvitCustomPost_instances, _DevvitCustomPost_lastRequest, _DevvitCustomPost_looper, _DevvitCustomPost_rootHeight, _DevvitCustomPost_bubble, _DevvitCustomPost_newRenderContext, _DevvitCustomPost_onError, _DevvitCustomPost_onPluginCall, _DevvitCustomPost_onRenderPost, _DevvitCustomPost_onUserActionEffect, _DevvitCustomPost_onUserActionEvent;
 import '@reddit/faceplate-ui/templateRenderingStrategy/clientStrategy.js';
 import { Block } from '@devvit/protos';
-import { BlockConfig_Root, BlockRenderEventType, BlockStackDirection, CustomPostDefinition, EffectType, RealtimeDefinition, UIEventHandlerDefinition, } from '@devvit/protos';
+import { BlockConfig_Root, BlockRenderEventType, BlockStackDirection, RealtimeDefinition, } from '@devvit/protos';
 import * as b64 from 'base64-js';
-import { BrowserLiteClient, } from '@devvit/runtime-lite/client/BrowserLiteClient.js';
-import { isCircuitBreaker, } from '@devvit/runtime-lite/types/CircuitBreaker.js';
+import { isCircuitBreaker } from '@devvit/runtime-lite/types/CircuitBreaker.js';
+import { asT3ID } from '@devvit/shared-types/tid.js';
 import { customEvent } from '@reddit/faceplate/lib/custom-event.js';
-import { LitElement, html } from 'lit';
+import { LitElement, html, nothing } from 'lit';
 import { customElement, property, query, state } from 'lit/decorators.js';
-import PQueue from 'p-queue';
 import { DevvitBlocksRenderer } from '../blocks/components/devvit-blocks-renderer.js';
 import { DEFAULT_ROOT_HEIGHT } from '../blocks/templates/renderBlock.js';
 import { styles } from '../styles.js';
-import { initDevvitGlobal } from '../types/devvit-global.js';
+import { AppUILooper } from './app-ui-looper.js';
+import { RemoteApp } from './ui-app.js';
 import '../blocks/components/devvit-blocks-renderer.js';
 import '../blocks/components/devvit-blocks-webview.js';
 import './devvit-animation-player.js';
-initDevvitGlobal();
-// Effects that can only be fired as the result of a user action
-const USER_ACTION_EFFECTS = [
-    EffectType.EFFECT_SHOW_TOAST,
-    EffectType.EFFECT_SHOW_FORM,
-    EffectType.EFFECT_NAVIGATE_TO_URL,
-];
 /**
  * Blocks program renderer.
  *
  * Assumes the loaded program is a CustomPost & UIEventHandler.
  *
+ * The complexity of this class should only be the UI itself and proxying state
+ * to devvit-blocks-renderer and AppUILooper. Don't put logic here that you
+ * can't unit test.
+ *
  * @slot - Loading / unloaded state.
  */
 let DevvitCustomPost = class DevvitCustomPost extends LitElement {
@@ -58,53 +55,66 @@ let DevvitCustomPost = class DevvitCustomPost extends LitElement {
         // to-do: don't use attributes initialized to true. They cannot be passed by
         // attributes.
         this.useSandbox = true;
-        _DevvitCustomPost_appState.set(this, {});
-        _DevvitCustomPost_customPostActor.set(this, void 0);
-        _DevvitCustomPost_hasInitialRender.set(this, false);
         this._isSuspended = false; // eslint-disable-line @typescript-eslint/naming-convention
         _DevvitCustomPost_lastRequest.set(this, void 0);
-        _DevvitCustomPost_localClient.set(this, void 0);
-        _DevvitCustomPost_rerenderTimeout.set(this, void 0);
+        _DevvitCustomPost_looper.set(this, new AppUILooper());
         _DevvitCustomPost_rootHeight.set(this, void 0);
-        // No concurrency is used to enforce order. Priority is used to allow server
-        // responses to jump to the front when received.
-        _DevvitCustomPost_rpcQueue.set(this, new PQueue({ concurrency: 1 }));
-        _DevvitCustomPost_uiEventHandlerActor.set(this, void 0);
-        _DevvitCustomPost_handleUserAction.set(this, async (event) => {
-            await __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_userActionRender).call(this, event.detail.action.id, event.detail.action.data);
-        });
-        _DevvitCustomPost_makeRenderContext.set(this, () => ({
+        _DevvitCustomPost_newRenderContext.set(this, () => ({
+            experimental: this.useExperimentalBlocks,
+            onAction: (action) => __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").queueRenderPost(BlockRenderEventType.RENDER_USER_ACTION, action.id, action.data ?? {}),
             request: __classPrivateFieldGet(this, _DevvitCustomPost_lastRequest, "f"),
-            state: __classPrivateFieldGet(this, _DevvitCustomPost_instances, "a", _DevvitCustomPost_state_get),
             stackDirection: BlockStackDirection.UNRECOGNIZED,
-            onAction: (action) => void __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_userActionRender).call(this, action.id, action.data),
-            experimental: this.useExperimentalBlocks,
+            state: __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").appState,
         }));
-        _DevvitCustomPost_newRenderRequest.set(this, (type, id, data = {}) => ({
-            blocks: { type, id, data },
-        }));
-        _DevvitCustomPost_onPluginCall.set(this, (id, serviceName, method, args) => {
+        _DevvitCustomPost_onError.set(this, (type, err) => {
+            if (!isCircuitBreaker(err))
+                console.error(err);
+            __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-error', { err, type });
+        });
+        _DevvitCustomPost_onPluginCall.set(this, (_id, serviceName, method, args, _meta) => {
             if (serviceName === RealtimeDefinition.fullName &&
-                method === RealtimeDefinition.methods.send.name) {
+                method === RealtimeDefinition.methods.send.name)
                 __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-realtime-send', { event: args });
-                __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.onPluginResponse(id, { error: undefined, success: true, value: {} });
-            }
         });
-        _DevvitCustomPost_queueEvent.set(this, (ev) => {
-            if (ev.queue) {
-                // TODO: Add QoS for different types of events on alternate queues.  For now, treat alternate queues as having
-                // infinite concurrency.
-                void __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_processEvent).call(this, ev);
-            }
-            else {
-                void __classPrivateFieldGet(this, _DevvitCustomPost_rpcQueue, "f").add(() => __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_processEvent).call(this, ev));
+        _DevvitCustomPost_onRenderPost.set(this, (req, rsp) => {
+            var _a, _b;
+            this.renderResponse = rsp;
+            if (this.renderResponse?.blocks?.ui) {
+                __classPrivateFieldSet(this, _DevvitCustomPost_lastRequest, req.blocks, "f");
+                this._rootBlock = this.renderResponse.blocks.ui;
+                if (!__classPrivateFieldGet(this, _DevvitCustomPost_rootHeight, "f")) {
+                    // Lock in the initial height
+                    __classPrivateFieldSet(this, _DevvitCustomPost_rootHeight, this._rootBlock.config?.rootConfig?.height || DEFAULT_ROOT_HEIGHT, "f");
+                }
+                else {
+                    (_a = this._rootBlock).config ?? (_a.config = {});
+                    (_b = this._rootBlock.config).rootConfig ?? (_b.rootConfig = BlockConfig_Root.fromPartial({}));
+                    this._rootBlock.config.rootConfig.height = __classPrivateFieldGet(this, _DevvitCustomPost_rootHeight, "f");
+                }
             }
         });
-        // eslint-disable-next-line @typescript-eslint/no-misused-promises
-        this.addEventListener('devvit-user-action', __classPrivateFieldGet(this, _DevvitCustomPost_handleUserAction, "f"));
+        _DevvitCustomPost_onUserActionEffect.set(this, (fx) => {
+            __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-effect', {
+                effect: fx,
+                onEvent: (ev) => __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").queueEvent(ev),
+            });
+        });
+        _DevvitCustomPost_onUserActionEvent.set(this, (ev) => {
+            __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").queueRenderPost(BlockRenderEventType.RENDER_USER_ACTION, ev.detail.action.id, ev.detail.action.data);
+        });
+        this.addEventListener('devvit-user-action', __classPrivateFieldGet(this, _DevvitCustomPost_onUserActionEvent, "f"));
+        __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").onError = __classPrivateFieldGet(this, _DevvitCustomPost_onError, "f");
+        __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").onPluginCall = __classPrivateFieldGet(this, _DevvitCustomPost_onPluginCall, "f");
+        __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").onRenderPost = __classPrivateFieldGet(this, _DevvitCustomPost_onRenderPost, "f");
+        __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").onUserAction = __classPrivateFieldGet(this, _DevvitCustomPost_onUserActionEffect, "f");
+    }
+    async connectedCallback() {
+        super.connectedCallback();
+        this._isSuspended = false;
     }
     disconnectedCallback() {
-        __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_suspendPost).call(this);
+        this._isSuspended = true;
+        __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").unload();
         super.disconnectedCallback();
     }
     get blocksConfig() {
@@ -112,6 +122,7 @@ let DevvitCustomPost = class DevvitCustomPost extends LitElement {
             return '';
         return b64.fromByteArray(Block.encode(this._rootBlock).finish());
     }
+    // to-do [studio]: remove.
     rerender() {
         this._blocksRenderer?.requestUpdate();
     }
@@ -127,225 +138,54 @@ let DevvitCustomPost = class DevvitCustomPost extends LitElement {
       <devvit-blocks-renderer
         class="${this.scheme ?? ''}"
         .block="${this._rootBlock}"
-        .renderContext="${__classPrivateFieldGet(this, _DevvitCustomPost_makeRenderContext, "f")}"
+        .renderContext="${__classPrivateFieldGet(this, _DevvitCustomPost_newRenderContext, "f")}"
       >
         <slot slot="empty-state-image" name="empty-state-image"></slot>
       </devvit-blocks-renderer>
       ${this._isSuspended
             ? html `<div class="absolute top-0 left-0 w-full h-full bg-transparent border-none"></div>`
-            : html ``}
+            : nothing}
     </div>`;
     }
     async willUpdate(props) {
-        if (props.has('localRuntimeCode') || props.has('bundle') || props.has('useSandbox')) {
-            // The runtime or the bundle has changed. Reset.
-            __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.quit();
-            __classPrivateFieldGet(this, _DevvitCustomPost_rpcQueue, "f").clear();
-            if (__classPrivateFieldGet(this, _DevvitCustomPost_rerenderTimeout, "f") != null)
-                clearTimeout(__classPrivateFieldGet(this, _DevvitCustomPost_rerenderTimeout, "f"));
-            __classPrivateFieldSet(this, _DevvitCustomPost_rerenderTimeout, undefined, "f");
-        }
-        if (props.has('localRuntimeCode') && this.localRuntimeCode) {
-            __classPrivateFieldSet(this, _DevvitCustomPost_localClient, new BrowserLiteClient(this.localRuntimeCode, (type, err) => __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-error', { type, err }), { callback: __classPrivateFieldGet(this, _DevvitCustomPost_onPluginCall, "f"), plugins: [RealtimeDefinition.fullName] }), "f");
+        __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").meta = this.metadata;
+        __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").postConfig = this.postConfig;
+        if (props.has('postId')) {
+            __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").postID = this.postId ? asT3ID(this.postId) : undefined;
         }
         if (props.has('actorRef')) {
-            __classPrivateFieldSet(this, _DevvitCustomPost_customPostActor, this.actorRef?.As(CustomPostDefinition), "f");
-            __classPrivateFieldSet(this, _DevvitCustomPost_uiEventHandlerActor, this.actorRef?.As(UIEventHandlerDefinition), "f");
-        }
-        if (props.has('actorRef') || props.has('bundle') || props.has('useSandbox')) {
-            if (this.bundle) {
-                // offline/online, defer initialRender for offline client
-                try {
-                    await __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.loadBundle(this.bundle, this.useSandbox);
-                }
-                catch (err) {
-                    __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-error', { type: 'Error', err });
-                    throw err;
-                }
-                // No remote runtime. Queue initial render.
-                if (!this.actorRef)
-                    __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_initialRender).call(this);
-            }
-            else if ((this.bundle && props.has('bundle')) || !__classPrivateFieldGet(this, _DevvitCustomPost_hasInitialRender, "f")) {
-                // online only
-                __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_initialRender).call(this);
-            }
-        }
-        else if (props.has('useExperimentalBlocks')) {
-            __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_initialRender).call(this);
-        }
+            if (!this.actorRef)
+                __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").remote = undefined;
+            else if ('As' in this.actorRef)
+                __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").remote = new RemoteApp(this.actorRef);
+            else
+                __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").remote = this.actorRef;
+        }
+        if (props.has('localRuntimeCode'))
+            __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").setLocalSrc(this.localRuntimeCode);
+        if (props.has('bundle') && this.bundle) {
+            await __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").load(this.bundle, this.useSandbox);
+            // Bundle was _replaced_. Require a new render.
+            if (props.get('bundle'))
+                __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").resetAppState();
+        }
+        if (!__classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").rendered)
+            __classPrivateFieldGet(this, _DevvitCustomPost_looper, "f").queueRenderPost(BlockRenderEventType.RENDER_INITIAL, undefined, {});
     }
 };
-_DevvitCustomPost_appState = new WeakMap();
-_DevvitCustomPost_customPostActor = new WeakMap();
-_DevvitCustomPost_hasInitialRender = new WeakMap();
 _DevvitCustomPost_lastRequest = new WeakMap();
-_DevvitCustomPost_localClient = new WeakMap();
-_DevvitCustomPost_rerenderTimeout = new WeakMap();
+_DevvitCustomPost_looper = new WeakMap();
 _DevvitCustomPost_rootHeight = new WeakMap();
-_DevvitCustomPost_rpcQueue = new WeakMap();
-_DevvitCustomPost_uiEventHandlerActor = new WeakMap();
-_DevvitCustomPost_handleUserAction = new WeakMap();
-_DevvitCustomPost_makeRenderContext = new WeakMap();
-_DevvitCustomPost_newRenderRequest = new WeakMap();
+_DevvitCustomPost_newRenderContext = new WeakMap();
+_DevvitCustomPost_onError = new WeakMap();
 _DevvitCustomPost_onPluginCall = new WeakMap();
-_DevvitCustomPost_queueEvent = new WeakMap();
+_DevvitCustomPost_onRenderPost = new WeakMap();
+_DevvitCustomPost_onUserActionEffect = new WeakMap();
+_DevvitCustomPost_onUserActionEvent = new WeakMap();
 _DevvitCustomPost_instances = new WeakSet();
 _DevvitCustomPost_bubble = function _DevvitCustomPost_bubble(type, detail) {
     this.dispatchEvent(customEvent(type, detail));
 };
-_DevvitCustomPost_effectEventRender = async function _DevvitCustomPost_effectEventRender(effectType, effectData) {
-    await __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_queueRenderPost).call(this, __classPrivateFieldGet(this, _DevvitCustomPost_newRenderRequest, "f").call(this, BlockRenderEventType.RENDER_EFFECT_EVENT, effectType, effectData), undefined);
-};
-_DevvitCustomPost_handleEffects = async function _DevvitCustomPost_handleEffects(renderType, effects) {
-    effects.forEach((effect) => {
-        if (effect.type === EffectType.EFFECT_SEND_EVENT) {
-            if (effect.sendEvent?.event) {
-                __classPrivateFieldGet(this, _DevvitCustomPost_queueEvent, "f").call(this, effect.sendEvent.event);
-            }
-        }
-        else if (effect.type === EffectType.EFFECT_RERENDER_UI) {
-            if (__classPrivateFieldGet(this, _DevvitCustomPost_rerenderTimeout, "f") != null)
-                clearTimeout(__classPrivateFieldGet(this, _DevvitCustomPost_rerenderTimeout, "f"));
-            __classPrivateFieldSet(this, _DevvitCustomPost_rerenderTimeout, setTimeout(() => {
-                void __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_effectEventRender).call(this, 'rerender-effect', {});
-            }, (effect.rerenderUi?.delaySeconds ?? 0) * 1000), "f");
-        }
-        else {
-            if (renderType !== BlockRenderEventType.RENDER_USER_ACTION ||
-                USER_ACTION_EFFECTS.includes(effect.type)) {
-                __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-effect', {
-                    effect,
-                    onEvent: (ev) => __classPrivateFieldGet(this, _DevvitCustomPost_queueEvent, "f").call(this, ev),
-                });
-            }
-        }
-    });
-};
-_DevvitCustomPost_initialRender = function _DevvitCustomPost_initialRender() {
-    if (this._isSuspended) {
-        this._isSuspended = false;
-    }
-    __classPrivateFieldSet(this, _DevvitCustomPost_rootHeight, undefined, "f");
-    __classPrivateFieldSet(this, _DevvitCustomPost_hasInitialRender, true, "f");
-    __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_queueRenderPost).call(this, __classPrivateFieldGet(this, _DevvitCustomPost_newRenderRequest, "f").call(this, BlockRenderEventType.RENDER_INITIAL), undefined);
-};
-_DevvitCustomPost_processEvent = async function _DevvitCustomPost_processEvent(ev) {
-    const req = {
-        event: ev,
-        state: __classPrivateFieldGet(this, _DevvitCustomPost_instances, "a", _DevvitCustomPost_state_get),
-    };
-    let call;
-    try {
-        call = (await __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.call('HandleUIEvent', req, this.metadata));
-    }
-    catch (err) {
-        if ((!isCircuitBreaker(err) && __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.ready) || !__classPrivateFieldGet(this, _DevvitCustomPost_uiEventHandlerActor, "f")) {
-            console.error(err);
-            __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-error', { err, type: 'Error' });
-        }
-        else {
-            if (devvit?.logCircuitBreaks)
-                console.warn('remote call triggered at', err);
-        }
-        // Call remote runtime.
-        try {
-            call = await __classPrivateFieldGet(this, _DevvitCustomPost_uiEventHandlerActor, "f")?.HandleUIEvent(req, this.metadata);
-        }
-        catch (err) {
-            __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-error', { err, type: 'Error' });
-            throw err;
-        }
-    }
-    if (call) {
-        // Can only change state on the main queue.
-        if (!ev.queue) {
-            __classPrivateFieldSet(this, _DevvitCustomPost_appState, call.state ?? {}, "f");
-        }
-        const renderType = ev.realtimeEvent
-            ? BlockRenderEventType.RENDER_EFFECT_EVENT
-            : BlockRenderEventType.RENDER_USER_ACTION;
-        await __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_handleEffects).call(this, renderType, call.effects);
-    }
-};
-_DevvitCustomPost_queueRenderPost = function _DevvitCustomPost_queueRenderPost(req, circuitBreak) {
-    void __classPrivateFieldGet(this, _DevvitCustomPost_rpcQueue, "f").add(() => __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_renderPost).call(this, req, circuitBreak), 
-    // Cut in line to re-render from server response immediately
-    { priority: circuitBreak ? 100 : 0 });
-};
-_DevvitCustomPost_renderPost = async function _DevvitCustomPost_renderPost(req, circuitBreak) {
-    var _a, _b;
-    let call;
-    req.state = __classPrivateFieldGet(this, _DevvitCustomPost_instances, "a", _DevvitCustomPost_state_get);
-    try {
-        if (circuitBreak)
-            throw circuitBreak;
-        call = (await __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.call('RenderPost', req, this.metadata));
-    }
-    catch (err) {
-        // Local runtime call failed.
-        if (!circuitBreak && isCircuitBreaker(err)) {
-            // Circuit break. Enqueue remote runtime render.
-            if (err.response) {
-                call = err.response;
-            }
-            __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_queueRenderPost).call(this, req, err);
-        }
-        else {
-            // Render now.
-            if ((!circuitBreak || !__classPrivateFieldGet(this, _DevvitCustomPost_customPostActor, "f")) && __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.ready) {
-                __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-error', { err, type: 'Error' });
-                console.error(err);
-            }
-            else {
-                if (devvit?.logCircuitBreaks)
-                    console.warn('remote call triggered at', err);
-            }
-            // Call remote runtime.
-            try {
-                call = await __classPrivateFieldGet(this, _DevvitCustomPost_customPostActor, "f")?.RenderPost(req, this.metadata);
-            }
-            catch (err) {
-                __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_bubble).call(this, 'devvit-ui-error', { err, type: 'Error' });
-                throw err;
-            }
-        }
-    }
-    if (call) {
-        this.renderResponse = call;
-        if (this.renderResponse.state) {
-            __classPrivateFieldSet(this, _DevvitCustomPost_appState, this.renderResponse.state, "f");
-        }
-        if (this.renderResponse?.blocks?.ui) {
-            __classPrivateFieldSet(this, _DevvitCustomPost_lastRequest, req.blocks, "f");
-            this._rootBlock = this.renderResponse.blocks.ui;
-            if (!__classPrivateFieldGet(this, _DevvitCustomPost_rootHeight, "f")) {
-                // Lock in the initial height
-                __classPrivateFieldSet(this, _DevvitCustomPost_rootHeight, this._rootBlock.config?.rootConfig?.height || DEFAULT_ROOT_HEIGHT, "f");
-            }
-            else {
-                (_a = this._rootBlock).config ?? (_a.config = {});
-                (_b = this._rootBlock.config).rootConfig ?? (_b.rootConfig = BlockConfig_Root.fromPartial({}));
-                this._rootBlock.config.rootConfig.height = __classPrivateFieldGet(this, _DevvitCustomPost_rootHeight, "f");
-            }
-            await this.updateComplete;
-        }
-        await __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_handleEffects).call(this, req.blocks.type, this.renderResponse.effects);
-    }
-};
-_DevvitCustomPost_state_get = function _DevvitCustomPost_state_get() {
-    const data = { __postData: { thingId: this.postId, config: this.postConfig } };
-    return Object.assign({}, __classPrivateFieldGet(this, _DevvitCustomPost_appState, "f"), data);
-};
-_DevvitCustomPost_suspendPost = function _DevvitCustomPost_suspendPost() {
-    this._isSuspended = true;
-    if (__classPrivateFieldGet(this, _DevvitCustomPost_rerenderTimeout, "f") != null)
-        clearTimeout(__classPrivateFieldGet(this, _DevvitCustomPost_rerenderTimeout, "f"));
-    __classPrivateFieldGet(this, _DevvitCustomPost_localClient, "f")?.quit();
-};
-_DevvitCustomPost_userActionRender = async function _DevvitCustomPost_userActionRender(actionId, data = {}) {
-    await __classPrivateFieldGet(this, _DevvitCustomPost_instances, "m", _DevvitCustomPost_queueRenderPost).call(this, __classPrivateFieldGet(this, _DevvitCustomPost_newRenderRequest, "f").call(this, BlockRenderEventType.RENDER_USER_ACTION, actionId, data), undefined);
-};
 __decorate([
     property({ attribute: false }),
     __metadata("design:type", Object)

package/client/ui-app.d.ts

@@ -0,0 +1,18 @@
+import { CustomPost, HandleUIEventRequest, HandleUIEventResponse, Metadata, RenderPostRequest, RenderPostResponse, UIEventHandler, UIRequest, UIResponse } from '@devvit/protos';
+import { ActorRef } from '@devvit/runtimes/common/runtime/ActorRef.js';
+/** An app that can render a custom post and respond to events. */
+export type UIApp = CustomPost & UIEventHandler;
+/**
+ * Adapts an ActorRef (usually provided by the deprecated BrowserRuntime) to the
+ * APIs implemented by a UIApp.
+ * @deprecated
+ */
+export declare class RemoteApp implements UIApp {
+    #private;
+    constructor(ref: ActorRef);
+    HandleUIEvent(req: HandleUIEventRequest, meta: Metadata | undefined): Promise<HandleUIEventResponse>;
+    RenderPost(req: RenderPostRequest, meta: Metadata | undefined): Promise<RenderPostResponse>;
+    RenderPostContent(req: UIRequest, meta: Metadata | undefined): Promise<UIResponse>;
+    RenderPostComposer(req: UIRequest, meta: Metadata | undefined): Promise<UIResponse>;
+}
+//# sourceMappingURL=ui-app.d.ts.map

package/client/ui-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-app.d.ts","sourceRoot":"","sources":["../../library/src/client/ui-app.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,oBAAoB,EACpB,qBAAqB,EACrB,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EAEd,SAAS,EACT,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAEvE,kEAAkE;AAClE,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,cAAc,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,SAAU,YAAW,KAAK;;gBAIzB,GAAG,EAAE,QAAQ;IAKzB,aAAa,CACX,GAAG,EAAE,oBAAoB,EACzB,IAAI,EAAE,QAAQ,GAAG,SAAS,GACzB,OAAO,CAAC,qBAAqB,CAAC;IAIjC,UAAU,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI3F,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlF,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;CAGpF"}

package/client/ui-app.js

@@ -0,0 +1,39 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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 _RemoteApp_customPost, _RemoteApp_uiEventHandler;
+import { CustomPostDefinition, UIEventHandlerDefinition, } from '@devvit/protos';
+/**
+ * Adapts an ActorRef (usually provided by the deprecated BrowserRuntime) to the
+ * APIs implemented by a UIApp.
+ * @deprecated
+ */
+export class RemoteApp {
+    constructor(ref) {
+        _RemoteApp_customPost.set(this, void 0);
+        _RemoteApp_uiEventHandler.set(this, void 0);
+        __classPrivateFieldSet(this, _RemoteApp_customPost, ref.As(CustomPostDefinition), "f");
+        __classPrivateFieldSet(this, _RemoteApp_uiEventHandler, ref.As(UIEventHandlerDefinition), "f");
+    }
+    HandleUIEvent(req, meta) {
+        return __classPrivateFieldGet(this, _RemoteApp_uiEventHandler, "f").HandleUIEvent(req, meta);
+    }
+    RenderPost(req, meta) {
+        return __classPrivateFieldGet(this, _RemoteApp_customPost, "f").RenderPost(req, meta);
+    }
+    RenderPostContent(req, meta) {
+        return __classPrivateFieldGet(this, _RemoteApp_customPost, "f").RenderPostContent(req, meta);
+    }
+    RenderPostComposer(req, meta) {
+        return __classPrivateFieldGet(this, _RemoteApp_customPost, "f").RenderPostComposer(req, meta);
+    }
+}
+_RemoteApp_customPost = new WeakMap(), _RemoteApp_uiEventHandler = new WeakMap();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devvit/ui-renderer",
-  "version": "0.10.17-next-2024-02-23-065bf7067.0",
+  "version": "0.10.17-next-2024-02-26-9e49b4eeb.0",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
@@ -54,13 +54,13 @@
   },
   "types": "./index.d.ts",
   "dependencies": {
-    "@devvit/protos": "0.10.17-next-2024-02-23-065bf7067.0",
-    "@devvit/runtime-lite": "0.10.17-next-2024-02-23-065bf7067.0",
-    "@devvit/runtimes": "0.10.17-next-2024-02-23-065bf7067.0",
-    "@devvit/shared-types": "0.10.17-next-2024-02-23-065bf7067.0",
+    "@devvit/protos": "0.10.17-next-2024-02-26-9e49b4eeb.0",
+    "@devvit/runtime-lite": "0.10.17-next-2024-02-26-9e49b4eeb.0",
+    "@devvit/runtimes": "0.10.17-next-2024-02-26-9e49b4eeb.0",
+    "@devvit/shared-types": "0.10.17-next-2024-02-26-9e49b4eeb.0",
     "@dotlottie/player-component": "2.7.2",
     "p-queue": "7.3.4",
-    "rxjs": "7.5.7"
+    "rxjs": "7.8.1"
   },
   "peerDependencies": {
     "@reddit/baseplate": "1.1.3",
@@ -84,7 +84,7 @@
   "devDependencies": {
     "@devvit/eslint-config": "0.10.16",
     "@devvit/repo-tools": "0.10.16",
-    "@devvit/tsconfig": "0.10.17-next-2024-02-23-065bf7067.0",
+    "@devvit/tsconfig": "0.10.17-next-2024-02-26-9e49b4eeb.0",
     "@lit-labs/ssr": "^2.2.3",
     "@lit/localize": "0.11.4",
     "@open-wc/testing-helpers": "2.3.0",
@@ -117,5 +117,5 @@
     "directory": "dist"
   },
   "source": "./src/index.ts",
-  "gitHead": "1fe2fdda9abdcf145da758b4e0ad74c9e70db92b"
+  "gitHead": "145863b65a5fbd4d78287d528917021d67b9079a"
 }

package/types/devvit-global.d.ts

@@ -2,24 +2,22 @@ declare global {
     var devvit: DevvitGlobal | undefined;
 }
 export type DevvitGlobal = {
-    /** Report circuit break errors in devvit-custom-post. */
-    logCircuitBreaks?: boolean | undefined;
+    /** Report circuit break and local errors in devvit-custom-post. */
+    logLocalErrors?: boolean | undefined;
 };
 /**
  * The bookmarklet to enable full debugging is:
  *
  * ```
- * (() => {
+ * javascript:(() => {
  *   globalThis.devvit = {};
- *   globalThis.devvit.logCircuitBreaks = true;
+ *   globalThis.devvit.logLocalErrors = true;
  *   const url = new URL(location.href);
- *   url.searchParams.set('devvitLogCircuitBreaks', '');
+ *   url.searchParams.set('devvitLogLocalErrors', '');
  *   history.replaceState(undefined, '', url);
  *   console.log(`devvit debug enabled`, globalThis.devvit);
  * })()
  * ```
- *
- * Just add a `javascript:` protocol and remove newlines.
  */
 export declare function initDevvitGlobal(): void;
 //# sourceMappingURL=devvit-global.d.ts.map

package/types/devvit-global.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devvit-global.d.ts","sourceRoot":"","sources":["../../library/src/types/devvit-global.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC"}
+{"version":3,"file":"devvit-global.d.ts","sourceRoot":"","sources":["../../library/src/types/devvit-global.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC"}

package/types/devvit-global.js

@@ -2,23 +2,21 @@
  * The bookmarklet to enable full debugging is:
  *
  * ```
- * (() => {
+ * javascript:(() => {
  *   globalThis.devvit = {};
- *   globalThis.devvit.logCircuitBreaks = true;
+ *   globalThis.devvit.logLocalErrors = true;
  *   const url = new URL(location.href);
- *   url.searchParams.set('devvitLogCircuitBreaks', '');
+ *   url.searchParams.set('devvitLogLocalErrors', '');
  *   history.replaceState(undefined, '', url);
  *   console.log(`devvit debug enabled`, globalThis.devvit);
  * })()
  * ```
- *
- * Just add a `javascript:` protocol and remove newlines.
  */
 export function initDevvitGlobal() {
     var _a;
     // Initialize defensively to honor any initializations that might occur in a
-    // temporary hack elsewhere.
-    const url = new URL(location.href);
+    // temporary hack elsewhere. `globalThis.location` check allows Node.js usage.
+    const url = new URL(globalThis.location ? location.href : 'file://');
     globalThis.devvit ?? (globalThis.devvit = {});
-    (_a = globalThis.devvit).logCircuitBreaks ?? (_a.logCircuitBreaks = url.searchParams.has('devvitLogCircuitBreaks'));
+    (_a = globalThis.devvit).logLocalErrors ?? (_a.logLocalErrors = url.searchParams.has('devvitLogLocalErrors'));
 }