Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

2.2 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */
/* oxlint-disable typescript/no-redeclare */
import type { components } from "@marimo-team/marimo-api";
import { Deferred } from "@/utils/Deferred";
import { generateUUID } from "@/utils/uuid";

export type RequestId = components["schemas"]["RequestId"];
export const RequestId = {
  create(): RequestId {
    return generateUUID() as RequestId;
  },
};

/**
 * Helper class to manage deferred requests.
 * We send a request via HTTP and then wait for the response from the kernel
 * via a websocket.
 */
export class DeferredRequestRegistry<REQ, RES> {
  public requests = new Map<RequestId, Deferred<RES>>();
  public operation: string;
  private makeRequest: (id: RequestId, req: REQ) => Promise<void>;
  private opts: {
    /**
     * Resolve existing requests with an empty response.
     */
    resolveExistingRequests?: () => RES;
  };

  public constructor(
    operation: string,
    makeRequest: (id: RequestId, req: REQ) => Promise<void>,
    opts: {
      /**
       * Resolve existing requests with an empty response.
       */
      resolveExistingRequests?: () => RES;
    } = {},
  ) {
    this.operation = operation;
    this.makeRequest = makeRequest;
    this.opts = opts;
  }

  public async request(opts: REQ): Promise<RES> {
    if (this.opts.resolveExistingRequests) {
      const result = this.opts.resolveExistingRequests();
      for (const deferred of this.requests.values()) {
        deferred.resolve(result);
      }
      this.requests.clear();
    }

    const requestId = RequestId.create();
    const deferred = new Deferred<RES>();

    this.requests.set(requestId, deferred);

    await this.makeRequest(requestId, opts).catch((error) => {
      deferred.reject(error);
      this.requests.delete(requestId);
    });
    return deferred.promise;
  }

  public resolve(requestId: RequestId, response: RES) {
    const entry = this.requests.get(requestId);
    if (entry === undefined) {
      return;
    }

    entry.resolve(response);
    this.requests.delete(requestId);
  }

  public reject(requestId: RequestId, error: Error) {
    const entry = this.requests.get(requestId);
    if (entry === undefined) {
      return;
    }

    entry.reject(error);
    this.requests.delete(requestId);
  }
}