@notionhq/custom-blocks-host 0.3.11 → 0.4.0

package/src/lifecycle/types.ts

@@ -6,32 +6,89 @@ import {
 	manifestSchema,
 } from "@notionhq/custom-blocks-protocol/manifest.js"
 import type { ConnectMessage } from "@notionhq/custom-blocks-protocol/messages/connect.js"
-import type { CustomBlockInitErrorInfo } from "@notionhq/custom-blocks-protocol/messages/init.js"
+import {
+	type CustomBlockInitErrorInfo,
+	customBlockInitErrorInfoSchema,
+} from "@notionhq/custom-blocks-protocol/messages/init.js"
 import { customBlockPageSchema } from "@notionhq/custom-blocks-protocol/pages/page.js"
 import { notionParentSchema } from "@notionhq/custom-blocks-protocol/parent.js"
 import { notionThemeSchema } from "@notionhq/custom-blocks-protocol/theme.js"
 import { notionUserSchema } from "@notionhq/custom-blocks-protocol/users/user.js"
 import * as v from "valibot"
+import type { CustomBlockHostFailure } from "../messages/types.js"
+
+/** Selects the manifest used to initialize a custom block. Both sources load independently. */
+export type CustomBlockManifestSource =
+	/** Uses the persisted manifest returned by the host adapter's getPersistedManifest callback. */
+	| "host"
+	/** Uses the manifest sent in connect by a sandbox on a separate HTTP(S) loopback origin. */
+	| "sandbox"
+
+export const customBlockHostManifestResultSchema = v.variant("status", [
+	v.object({ status: v.literal("success"), manifest: manifestSchema }),
+	v.object({
+		status: v.literal("error"),
+		error: customBlockInitErrorInfoSchema,
+	}),
+])
+
+/** A persisted manifest or an explicit loading error. The host validates and normalizes it. */
+export type CustomBlockHostManifestResult =
+	| { status: "success"; manifest: v.InferInput<typeof manifestSchema> }
+	| { status: "error"; error: CustomBlockInitErrorInfo }
+
+export type CustomBlockHostNormalizedManifestResult = v.InferOutput<
+	typeof customBlockHostManifestResultSchema
+>
 
 export type ConnectSuccessMessage = Extract<
 	ConnectMessage,
 	{ status: "success" }
 >
 
-/** Tracks initialization and lifetime for one host instance. */
-export type InitStatus =
-	/** The host is waiting for the sandbox's first `connect` message. */
-	| "waitingForConnect"
-	/** The host is waiting for host state preparation to complete `init`. */
-	| "preparingInit"
-	/** The host is waiting for a matching `initResult` after it sends `init`. */
-	| "waitingForInitResult"
-	/** The host is initialized and can send live updates. */
-	| "initialized"
-	/** The host is in an error state after an initialization failure or timeout. */
-	| "error"
-	/** The host is stopped and no longer sends or accepts sandbox messages. */
-	| "stopped"
+/**
+ * Accepted lifecycle transitions for one host and iframe. The host reports
+ * waitingForConnect during creation. Handshake failures can skip intermediate
+ * statuses, and runtime failures can occur after initialization.
+ *
+ * failed and stopped are terminal. Stopping a failed host releases resources
+ * without replacing its failure status. Create a new host and iframe to retry.
+ */
+export type CustomBlockHostStatus =
+	/** The host is listening for the sandbox's first connect message. */
+	| { status: "waitingForConnect" }
+	/**
+	 * The host accepted connect. The local manifest comes from a permitted
+	 * local sandbox. It does not replace a selected persisted manifest.
+	 */
+	| {
+			status: "preparingInit"
+			localManifest: CustomBlockManifest | undefined
+			bridgeProtocolVersion: number
+			sdkVersion: string
+	  }
+	/** Successful init has been sent. The host awaits its matching initResult. */
+	| { status: "waitingForInitResult" }
+	/**
+	 * The sandbox acknowledged setup. resolvedManifest is the declaration selected by
+	 * the host, and initialHeight is the sandbox's initial content height in CSS
+	 * pixels. The height is optional.
+	 */
+	| {
+			status: "initialized"
+			resolvedManifest: CustomBlockManifest
+			initialHeight: number | undefined
+	  }
+	/**
+	 * Initialization or runtime failed. error identifies the phase, reporting
+	 * source, code, and whether a fresh host and iframe could plausibly succeed.
+	 */
+	| { status: "failed"; error: CustomBlockHostFailure }
+	/** The embedding application explicitly stopped the host and released its resources. */
+	| { status: "stopped" }
+
+/** Internal lifecycle discriminant, shared with the public status contract. */
+export type InitStatus = CustomBlockHostStatus["status"]
 
 export type CustomBlockHostDataSourcesPayload = {
 	bindings: v.InferInput<typeof notionDataSourceBindingsSchema>
@@ -70,7 +127,18 @@ export type CustomBlockHostInitialStateResult =
 			error: CustomBlockInitErrorInfo
 	  }
 
-/** Adapter-owned state; the runtime adds its selected manifest to init. */
+export const customBlockHostPreparedStateResultSchema = v.variant("status", [
+	v.object({
+		status: v.literal("success"),
+		initialState: v.omit(customBlockHostInitialStateSchema, ["manifest"]),
+	}),
+	v.object({
+		status: v.literal("error"),
+		error: customBlockInitErrorInfoSchema,
+	}),
+])
+
+/** Adapter-owned state or an explicit preparation error. The host adds the manifest to init. */
 export type CustomBlockHostPreparedStateResult =
 	| {
 			status: "success"

package/src/messages/sandboxMessageRouter.ts

@@ -10,10 +10,10 @@ import type { OpenExternalUrlMessage } from "@notionhq/custom-blocks-protocol/me
 import type { OpenPageMessage } from "@notionhq/custom-blocks-protocol/messages/openPage.js"
 import type { QueryDataSourceMessage } from "@notionhq/custom-blocks-protocol/messages/queryDataSource.js"
 import type { ResizeMessage } from "@notionhq/custom-blocks-protocol/messages/resize.js"
-import { sandboxToHostMessageSchema } from "@notionhq/custom-blocks-protocol/messages/sandboxToHost.js"
 import type { UnsubscribeDataSourceQueryMessage } from "@notionhq/custom-blocks-protocol/messages/unsubscribeDataSourceQuery.js"
 import type { UpdatePageMessage } from "@notionhq/custom-blocks-protocol/messages/updatePage.js"
 import * as v from "valibot"
+import { normalizeSandboxToHostMessage } from "../compatibility/normalizeSandboxToHostMessage.js"
 import {
 	invalidConnectPayloadError,
 	invalidInitResultPayloadError,
@@ -138,7 +138,7 @@ export function createSandboxMessageRouter(
 		}
 
 		// Parse and validate the message from the sandbox.
-		const parsed = v.safeParse(sandboxToHostMessageSchema, event.data)
+		const parsed = normalizeSandboxToHostMessage(event.data)
 		if (!parsed.success) {
 			onInvalidSandboxMessage(event.data, parsed.issues)
 			return

package/src/protocol.ts

@@ -0,0 +1,8 @@
+/**
+ * The protocol package is private and is bundled into the published host package.
+ * This public /protocol entrypoint lets consumers use the schemas, types, and
+ * constants that ship with their host version without a separate protocol package.
+ *
+ * Keep wire definitions here so the package root stays focused on host APIs.
+ */
+export * from "@notionhq/custom-blocks-protocol"

package/dist/lifecycle/legacyPage.d.ts

@@ -1,70 +0,0 @@
-import type { LegacyNotionPage, notionPageDataSchema } from "../protocol/pages/page.js";
-import type { InferOutput } from "valibot";
-export declare function toLegacyPage(page: InferOutput<typeof notionPageDataSchema>): LegacyNotionPage;
-export declare function toLegacyQueryPage(page: InferOutput<typeof notionPageDataSchema>): {
-    id: string & import("valibot").Brand<"NotionPageId">;
-    is_archived: boolean;
-    in_trash: boolean;
-    propertiesById: Record<string, string | number | boolean | string[] | {
-        id: string;
-        table: string;
-    }[] | {
-        type: "date";
-        start_date: string;
-        reminder?: {
-            unit: "day" | "month" | "week" | "year";
-            value: number;
-            time: string;
-            defaultTimeZone?: string | undefined;
-        } | {
-            unit: "none";
-        } | undefined;
-    } | {
-        type: "daterange";
-        start_date: string;
-        end_date: string;
-        reminder?: {
-            unit: "day" | "month" | "week" | "year";
-            value: number;
-            time: string;
-            defaultTimeZone?: string | undefined;
-        } | {
-            unit: "none";
-        } | undefined;
-    } | {
-        type: "datetime";
-        start_date: string;
-        start_time: string;
-        time_zone?: string | undefined;
-        reminder?: {
-            unit: "day" | "month" | "week" | "year";
-            value: number;
-            time: string;
-            defaultTimeZone?: string | undefined;
-        } | {
-            unit: "hour" | "minute";
-            value: number;
-        } | {
-            unit: "none";
-        } | undefined;
-    } | {
-        type: "datetimerange";
-        start_date: string;
-        start_time: string;
-        end_date: string;
-        end_time: string;
-        time_zone?: string | undefined;
-        reminder?: {
-            unit: "day" | "month" | "week" | "year";
-            value: number;
-            time: string;
-            defaultTimeZone?: string | undefined;
-        } | {
-            unit: "hour" | "minute";
-            value: number;
-        } | {
-            unit: "none";
-        } | undefined;
-    } | undefined>;
-};
-//# sourceMappingURL=legacyPage.d.ts.map

package/dist/lifecycle/legacyPage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"legacyPage.d.ts","sourceRoot":"","sources":["../../src/lifecycle/legacyPage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,gBAAgB,EAEhB,oBAAoB,EACpB,MAAM,gDAAgD,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAI1C,wBAAgB,YAAY,CAC3B,IAAI,EAAE,WAAW,CAAC,OAAO,oBAAoB,CAAC,GAC5C,gBAAgB,CAelB;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,WAAW,CAAC,OAAO,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc9C"}

package/dist/lifecycle/loadCustomBlockManifest.d.ts

@@ -1,16 +0,0 @@
-import { type CustomBlockManifest } from "../protocol/manifest.js";
-import type { CustomBlockInitErrorInfo } from "../protocol/messages/init.js";
-import type { CustomBlockHostManifestOptions } from "./manifestOptions.js";
-/** Internal to the host: preview requests never carry credentials or follow redirects. */
-export declare function loadCustomBlockManifest(args: CustomBlockHostManifestOptions & {
-    sandboxOrigin: string;
-    signal: AbortSignal;
-    onError: (error: unknown) => void;
-}): Promise<{
-    status: "success";
-    manifest: CustomBlockManifest;
-} | {
-    status: "error";
-    error: CustomBlockInitErrorInfo;
-}>;
-//# sourceMappingURL=loadCustomBlockManifest.d.ts.map

package/dist/lifecycle/loadCustomBlockManifest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loadCustomBlockManifest.d.ts","sourceRoot":"","sources":["../../src/lifecycle/loadCustomBlockManifest.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,mBAAmB,EAExB,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAA;AAGjG,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAE1E,0FAA0F;AAC1F,wBAAsB,uBAAuB,CAC5C,IAAI,EAAE,8BAA8B,GAAG;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACjC,GACC,OAAO,CACP;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,CACtD,CAiDA"}

package/dist/lifecycle/loadCustomBlockManifest.js

@@ -1,65 +0,0 @@
-import { manifestSchema, } from "../protocol/manifest.js";
-import * as v from "valibot";
-import { isLocalCustomBlockUrl } from "../localBlockUrl.js";
-/** Internal to the host: preview requests never carry credentials or follow redirects. */
-export async function loadCustomBlockManifest(args) {
-    const controller = new AbortController();
-    const abort = () => controller.abort();
-    args.signal.addEventListener("abort", abort, { once: true });
-    const cancelled = new Promise((_resolve, reject) => {
-        controller.signal.addEventListener("abort", () => reject(controller.signal.reason), { once: true });
-    });
-    if (args.signal.aborted) {
-        controller.abort();
-    }
-    const timeout = args.manifestSource === "local"
-        ? window.setTimeout(() => {
-            controller.abort(new Error("Manifest loading timed out after 5000 ms."));
-        }, 5_000)
-        : undefined;
-    try {
-        const input = await Promise.race([
-            args.manifestSource === "local"
-                ? fetchLocalCustomBlockManifest(args.sandboxOrigin, controller.signal)
-                : args.getPersistedManifest({ signal: controller.signal }),
-            cancelled,
-        ]);
-        if (controller.signal.aborted) {
-            throw new Error("Manifest loading was cancelled.");
-        }
-        return { status: "success", manifest: v.parse(manifestSchema, input) };
-    }
-    catch (error) {
-        if (!args.signal.aborted) {
-            args.onError(error);
-        }
-        return {
-            status: "error",
-            error: {
-                code: "manifest_unavailable",
-                message: "The custom block manifest is unavailable.",
-                isRetryable: true,
-            },
-        };
-    }
-    finally {
-        window.clearTimeout(timeout);
-        args.signal.removeEventListener("abort", abort);
-    }
-}
-async function fetchLocalCustomBlockManifest(origin, signal) {
-    const url = new URL(origin);
-    if (!isLocalCustomBlockUrl({ url, hostOrigin: window.location.origin })) {
-        throw new Error("Preview requires a separate loopback origin.");
-    }
-    const response = await fetch(new URL("/manifest", url), {
-        credentials: "omit",
-        redirect: "error",
-        cache: "no-store",
-        signal,
-    });
-    if (!response.ok) {
-        throw new Error(`Manifest request failed: HTTP ${response.status}.`);
-    }
-    return response.json();
-}

package/dist/lifecycle/manifestOptions.d.ts

@@ -1,17 +0,0 @@
-import type { manifestSchema } from "../protocol/manifest.js";
-import type { InferInput } from "valibot";
-/** Selects the manifest source used during host initialization. */
-export type CustomBlockHostManifestOptions = {
-    /** Calls getPersistedManifest for a saved definition or worker registry manifest. */
-    manifestSource: "persisted";
-    getPersistedManifest: (args: {
-        signal: AbortSignal;
-    }) => Promise<InferInput<typeof manifestSchema> | undefined>;
-} | {
-    /**
-     * Fetches /manifest from the loopback sandboxOrigin. No persisted fallback.
-     * Local refers to the manifest server, not the host's environment.
-     */
-    manifestSource: "local";
-};
-//# sourceMappingURL=manifestOptions.d.ts.map

package/dist/lifecycle/manifestOptions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifestOptions.d.ts","sourceRoot":"","sources":["../../src/lifecycle/manifestOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAA;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,mEAAmE;AACnE,MAAM,MAAM,8BAA8B,GACvC;IACA,qFAAqF;IACrF,cAAc,EAAE,WAAW,CAAA;IAC3B,oBAAoB,EAAE,CAAC,IAAI,EAAE;QAC5B,MAAM,EAAE,WAAW,CAAA;KACnB,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,GAAG,SAAS,CAAC,CAAA;CAC3D,GACD;IACA;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAA;CACtB,CAAA"}

package/dist/lifecycle/normalizeHostToSandboxMessage.d.ts

@@ -1,6 +0,0 @@
-import type { HostToSandboxMessage, HostToSandboxMessageLegacy } from "../protocol/messages/hostToSandbox.js";
-/**
- * Normalizes outgoing page shapes for the sandbox's bridge protocol version.
- */
-export declare function normalizeHostToSandboxMessage(message: HostToSandboxMessage, bridgeProtocolVersion: number): HostToSandboxMessageLegacy;
-//# sourceMappingURL=normalizeHostToSandboxMessage.d.ts.map

package/dist/lifecycle/normalizeHostToSandboxMessage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizeHostToSandboxMessage.d.ts","sourceRoot":"","sources":["../../src/lifecycle/normalizeHostToSandboxMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,MAAM,4DAA4D,CAAA;AAGnE;;GAEG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,oBAAoB,EAC7B,qBAAqB,EAAE,MAAM,GAC3B,0BAA0B,CAc5B"}

package/dist/lifecycle/normalizeHostToSandboxMessage.js

@@ -1,14 +0,0 @@
-import { normalizeToLegacyPage } from "./normalizePage.js";
-/**
- * Normalizes outgoing page shapes for the sandbox's bridge protocol version.
- */
-export function normalizeHostToSandboxMessage(message, bridgeProtocolVersion) {
-    if (message.type !== "queryDataSourceResult" &&
-        message.type !== "getPageResult" &&
-        message.type !== "createPageResult" &&
-        message.type !== "updatePageResult") {
-        return message;
-    }
-    const normalizedMessage = normalizeToLegacyPage(message, bridgeProtocolVersion);
-    return normalizedMessage;
-}

package/dist/lifecycle/normalizePage.d.ts

@@ -1,7 +0,0 @@
-import type { CreatePageResultMessage } from "../protocol/messages/createPageResult.js";
-import type { GetPageResultMessage } from "../protocol/messages/getPage.js";
-import type { HostToSandboxMessageLegacy } from "../protocol/messages/hostToSandbox.js";
-import type { QueryDataSourceResultMessage } from "../protocol/messages/queryDataSourceResult.js";
-import type { UpdatePageResultMessage } from "../protocol/messages/updatePageResult.js";
-export declare function normalizeToLegacyPage(message: CreatePageResultMessage | GetPageResultMessage | UpdatePageResultMessage | QueryDataSourceResultMessage, bridgeProtocolVersion: number): HostToSandboxMessageLegacy;
-//# sourceMappingURL=normalizePage.d.ts.map

package/dist/lifecycle/normalizePage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizePage.d.ts","sourceRoot":"","sources":["../../src/lifecycle/normalizePage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAC5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAA;AAChG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAA;AAC5G,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oEAAoE,CAAA;AACtH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAU5G,wBAAgB,qBAAqB,CACpC,OAAO,EACJ,uBAAuB,GACvB,oBAAoB,GACpB,uBAAuB,GACvB,4BAA4B,EAC/B,qBAAqB,EAAE,MAAM,GAC3B,0BAA0B,CA0B5B"}

package/dist/lifecycle/normalizePage.js

@@ -1,47 +0,0 @@
-import { LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION, TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION, } from "../protocol/protocolVersion.js";
-import { unreachable } from "../utils.js";
-import { toLegacyPage, toLegacyQueryPage } from "./legacyPage.js";
-export function normalizeToLegacyPage(message, bridgeProtocolVersion) {
-    if (bridgeProtocolVersion >= TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION) {
-        return message;
-    }
-    if (message.status === "error") {
-        return message;
-    }
-    switch (message.type) {
-        case "queryDataSourceResult":
-            if (bridgeProtocolVersion >= LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION) {
-                return { ...message, items: message.items.map(toPreFallbackPage) };
-            }
-            return { ...message, items: message.items.map(toLegacyQueryPage) };
-        case "getPageResult":
-        case "createPageResult":
-        case "updatePageResult":
-            return {
-                ...message,
-                page: bridgeProtocolVersion >= LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION
-                    ? toPreFallbackPage(message.page)
-                    : toLegacyPage(toPreFallbackPage(message.page)),
-            };
-        default:
-            return unreachable(message);
-    }
-}
-function toPreFallbackPage(page) {
-    return {
-        ...page,
-        properties: Object.fromEntries(Object.entries(page.properties).map(([name, property]) => {
-            switch (property?.type) {
-                case "unique_id":
-                case "button":
-                case "formula":
-                case "location":
-                case "rollup":
-                case "verification":
-                    return [name, null];
-                default:
-                    return [name, property];
-            }
-        })),
-    };
-}

package/dist/localBlockUrl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"localBlockUrl.d.ts","sourceRoot":"","sources":["../src/localBlockUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EACrC,GAAG,EACH,UAAU,GACV,EAAE;IACF,GAAG,EAAE,GAAG,CAAA;IACR,UAAU,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAYV"}

package/src/lifecycle/loadCustomBlockManifest.ts

@@ -1,89 +0,0 @@
-import {
-	type CustomBlockManifest,
-	manifestSchema,
-} from "@notionhq/custom-blocks-protocol/manifest.js"
-import type { CustomBlockInitErrorInfo } from "@notionhq/custom-blocks-protocol/messages/init.js"
-import * as v from "valibot"
-import { isLocalCustomBlockUrl } from "../localBlockUrl.js"
-import type { CustomBlockHostManifestOptions } from "./manifestOptions.js"
-
-/** Internal to the host: preview requests never carry credentials or follow redirects. */
-export async function loadCustomBlockManifest(
-	args: CustomBlockHostManifestOptions & {
-		sandboxOrigin: string
-		signal: AbortSignal
-		onError: (error: unknown) => void
-	},
-): Promise<
-	| { status: "success"; manifest: CustomBlockManifest }
-	| { status: "error"; error: CustomBlockInitErrorInfo }
-> {
-	const controller = new AbortController()
-	const abort = () => controller.abort()
-	args.signal.addEventListener("abort", abort, { once: true })
-	const cancelled = new Promise<never>((_resolve, reject) => {
-		controller.signal.addEventListener(
-			"abort",
-			() => reject(controller.signal.reason),
-			{ once: true },
-		)
-	})
-	if (args.signal.aborted) {
-		controller.abort()
-	}
-	const timeout =
-		args.manifestSource === "local"
-			? window.setTimeout(() => {
-					controller.abort(
-						new Error("Manifest loading timed out after 5000 ms."),
-					)
-				}, 5_000)
-			: undefined
-	try {
-		const input = await Promise.race([
-			args.manifestSource === "local"
-				? fetchLocalCustomBlockManifest(args.sandboxOrigin, controller.signal)
-				: args.getPersistedManifest({ signal: controller.signal }),
-			cancelled,
-		])
-		if (controller.signal.aborted) {
-			throw new Error("Manifest loading was cancelled.")
-		}
-		return { status: "success", manifest: v.parse(manifestSchema, input) }
-	} catch (error) {
-		if (!args.signal.aborted) {
-			args.onError(error)
-		}
-		return {
-			status: "error",
-			error: {
-				code: "manifest_unavailable",
-				message: "The custom block manifest is unavailable.",
-				isRetryable: true,
-			},
-		}
-	} finally {
-		window.clearTimeout(timeout)
-		args.signal.removeEventListener("abort", abort)
-	}
-}
-
-async function fetchLocalCustomBlockManifest(
-	origin: string,
-	signal: AbortSignal,
-): Promise<unknown> {
-	const url = new URL(origin)
-	if (!isLocalCustomBlockUrl({ url, hostOrigin: window.location.origin })) {
-		throw new Error("Preview requires a separate loopback origin.")
-	}
-	const response = await fetch(new URL("/manifest", url), {
-		credentials: "omit",
-		redirect: "error",
-		cache: "no-store",
-		signal,
-	})
-	if (!response.ok) {
-		throw new Error(`Manifest request failed: HTTP ${response.status}.`)
-	}
-	return response.json()
-}

package/src/lifecycle/manifestOptions.ts

@@ -1,19 +0,0 @@
-import type { manifestSchema } from "@notionhq/custom-blocks-protocol/manifest.js"
-import type { InferInput } from "valibot"
-
-/** Selects the manifest source used during host initialization. */
-export type CustomBlockHostManifestOptions =
-	| {
-			/** Calls getPersistedManifest for a saved definition or worker registry manifest. */
-			manifestSource: "persisted"
-			getPersistedManifest: (args: {
-				signal: AbortSignal
-			}) => Promise<InferInput<typeof manifestSchema> | undefined>
-	  }
-	| {
-			/**
-			 * Fetches /manifest from the loopback sandboxOrigin. No persisted fallback.
-			 * Local refers to the manifest server, not the host's environment.
-			 */
-			manifestSource: "local"
-	  }

package/src/lifecycle/normalizeHostToSandboxMessage.ts

@@ -1,27 +0,0 @@
-import type {
-	HostToSandboxMessage,
-	HostToSandboxMessageLegacy,
-} from "@notionhq/custom-blocks-protocol/messages/hostToSandbox.js"
-import { normalizeToLegacyPage } from "./normalizePage.js"
-
-/**
- * Normalizes outgoing page shapes for the sandbox's bridge protocol version.
- */
-export function normalizeHostToSandboxMessage(
-	message: HostToSandboxMessage,
-	bridgeProtocolVersion: number,
-): HostToSandboxMessageLegacy {
-	if (
-		message.type !== "queryDataSourceResult" &&
-		message.type !== "getPageResult" &&
-		message.type !== "createPageResult" &&
-		message.type !== "updatePageResult"
-	) {
-		return message
-	}
-	const normalizedMessage = normalizeToLegacyPage(
-		message,
-		bridgeProtocolVersion,
-	)
-	return normalizedMessage
-}

package/src/lifecycle/normalizePage.ts

@@ -1,71 +0,0 @@
-import type { CreatePageResultMessage } from "@notionhq/custom-blocks-protocol/messages/createPageResult.js"
-import type { GetPageResultMessage } from "@notionhq/custom-blocks-protocol/messages/getPage.js"
-import type { HostToSandboxMessageLegacy } from "@notionhq/custom-blocks-protocol/messages/hostToSandbox.js"
-import type { QueryDataSourceResultMessage } from "@notionhq/custom-blocks-protocol/messages/queryDataSourceResult.js"
-import type { UpdatePageResultMessage } from "@notionhq/custom-blocks-protocol/messages/updatePageResult.js"
-import type { notionPageDataSchema } from "@notionhq/custom-blocks-protocol/pages/page.js"
-import {
-	LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION,
-	TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION,
-} from "@notionhq/custom-blocks-protocol/protocolVersion.js"
-import type { InferOutput } from "valibot"
-import { unreachable } from "../utils.js"
-import { toLegacyPage, toLegacyQueryPage } from "./legacyPage.js"
-
-export function normalizeToLegacyPage(
-	message:
-		| CreatePageResultMessage
-		| GetPageResultMessage
-		| UpdatePageResultMessage
-		| QueryDataSourceResultMessage,
-	bridgeProtocolVersion: number,
-): HostToSandboxMessageLegacy {
-	if (bridgeProtocolVersion >= TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION) {
-		return message
-	}
-	if (message.status === "error") {
-		return message
-	}
-	switch (message.type) {
-		case "queryDataSourceResult":
-			if (bridgeProtocolVersion >= LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION) {
-				return { ...message, items: message.items.map(toPreFallbackPage) }
-			}
-			return { ...message, items: message.items.map(toLegacyQueryPage) }
-		case "getPageResult":
-		case "createPageResult":
-		case "updatePageResult":
-			return {
-				...message,
-				page:
-					bridgeProtocolVersion >= LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION
-						? toPreFallbackPage(message.page)
-						: toLegacyPage(toPreFallbackPage(message.page)),
-			}
-		default:
-			return unreachable(message)
-	}
-}
-
-function toPreFallbackPage(
-	page: InferOutput<typeof notionPageDataSchema>,
-): InferOutput<typeof notionPageDataSchema> {
-	return {
-		...page,
-		properties: Object.fromEntries(
-			Object.entries(page.properties).map(([name, property]) => {
-				switch (property?.type) {
-					case "unique_id":
-					case "button":
-					case "formula":
-					case "location":
-					case "rollup":
-					case "verification":
-						return [name, null]
-					default:
-						return [name, property]
-				}
-			}),
-		),
-	}
-}