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.
Python artificial-intelligencedagdata-sciencedata-visualizationdataflowdeveloper-toolsmachine-learningnotebookspipelinepythonreactivesqlweb-app
/* Copyright 2026 Marimo. All rights reserved. */
import type { components } from "@marimo-team/marimo-api";
import type { NotificationMessageData } from "@/core/kernel/messages";
import type { TypedString } from "../typed";
/**
* A JSON string of a given type.
*/
export type JsonString<T = unknown> = TypedString<"Json"> & {
_of_: T;
};
/**
* A base64-encoded string — derived from the generated OpenAPI schema.
*/
export type Base64String = components["schemas"]["Base64String"];
/**
* A data URL string.
*/
export type DataURLString = `data:${string};base64,${Base64String}`;
/**
* Typed JSON deserialization.
*/
export function deserializeJson<T>(jsonString: JsonString<T>): T {
return JSON.parse(jsonString) as T;
}
/**
* Convert a base64 string to a data URL string.
*/
export function base64ToDataURL(
base64: Base64String,
mimeType: string,
): DataURLString {
return `data:${mimeType};base64,${base64}`;
}
/**
* Check if a string is a data URL string.
*/
export function isDataURLString(str: string): str is DataURLString {
return str.startsWith("data:") && str.includes(";base64,");
}
/**
* Extract the base64 string from a data URL string.
*/
export function extractBase64FromDataURL(str: DataURLString): Base64String {
return str.split(",")[1] as Base64String;
}
/**
* Convert a base64 string to a Uint8Array (fallback implementation).
* See benchmarks/base64-conversion.bench.ts for why we use a manual loop.
*/
function base64ToUint8ArrayFallback(bytes: string): Uint8Array {
const binary = globalThis.atob(bytes);
const len = binary.length;
const uint8Array = new Uint8Array(len);
for (let i = 0; i < len; i++) {
uint8Array[i] = binary.charCodeAt(i);
}
return uint8Array;
}
/**
* Convert a base64 string to a Uint8Array.
* Uses native Uint8Array.fromBase64 if available, otherwise falls back to manual implementation.
*/
export const base64ToUint8Array: (bytes: Base64String) => Uint8Array =
Uint8Array.fromBase64 ?? base64ToUint8ArrayFallback;
/**
* Convert a base64 string to a DataView.
*/
export function base64ToDataView(bytes: Base64String): DataView {
const uint8Array = base64ToUint8Array(bytes);
return new DataView(uint8Array.buffer);
}
/**
* Convert a Uint8Array to a base64 string (fallback implementation).
* See benchmarks/uint8array-to-base64.bench.ts for why we use a manual loop.
*/
function uint8ArrayToBase64Fallback(binary: Uint8Array): Base64String {
let binaryString = "";
const len = binary.length;
for (let i = 0; i < len; i++) {
binaryString += String.fromCharCode(binary[i]);
}
return globalThis.btoa(binaryString) as Base64String;
}
/**
* Convert a Uint8Array to a base64 string.
* Uses native Uint8Array.prototype.toBase64 if available, otherwise falls back to manual implementation.
*/
export const uint8ArrayToBase64: (binary: Uint8Array) => Base64String =
"toBase64" in Uint8Array.prototype
? (binary) => binary.toBase64() as Base64String
: uint8ArrayToBase64Fallback;
/**
* Convert a DataView to a base64 string.
*/
export function dataViewToBase64(dataView: DataView): Base64String {
const uint8Array = new Uint8Array(
dataView.buffer,
dataView.byteOffset,
dataView.byteLength,
);
return uint8ArrayToBase64(uint8Array);
}
export function safeExtractSetUIElementMessageBuffers(
notification: NotificationMessageData<"send-ui-element-message">,
): readonly DataView[] {
const strs: Base64String[] = notification.buffers ?? [];
return strs.map(base64ToDataView);
}