@notionhq/custom-blocks-host 0.3.3 → 0.3.5

package/dist/lifecycle/legacyPage.js

@@ -0,0 +1,159 @@
+import { unreachable } from "../utils.js";
+export function toLegacyQueryPage(page) {
+    const propertiesById = {};
+    for (const property of Object.values(page.properties)) {
+        if (property) {
+            propertiesById[property.id] = toLegacyProperty(property);
+        }
+    }
+    return {
+        id: page.id,
+        is_archived: page.is_archived,
+        in_trash: page.in_trash,
+        propertiesById,
+    };
+}
+function plainText(items) {
+    return items
+        .map(item => {
+        if (typeof item.plain_text === "string") {
+            return item.plain_text;
+        }
+        const text = item.text;
+        return text &&
+            typeof text === "object" &&
+            "content" in text &&
+            typeof text.content === "string"
+            ? text.content
+            : "";
+    })
+        .join("");
+}
+function timestamp(value) {
+    if (value === undefined || value === null || value === "") {
+        return undefined;
+    }
+    const date = new Date(value);
+    if (!Number.isFinite(date.getTime())) {
+        return undefined;
+    }
+    return {
+        type: "datetime",
+        start_date: date.toISOString().slice(0, 10),
+        start_time: date.toISOString().slice(11, 16),
+        time_zone: "UTC",
+    };
+}
+function legacyDate(value) {
+    const timed = value.start.includes("T") || value.time_zone != null;
+    const offset = value.start.match(/([+-])(\d{2}):(\d{2})$/);
+    const offsetMinutes = offset
+        ? (Number(offset[2]) * 60 + Number(offset[3])) *
+            (offset[1] === "-" ? -1 : 1)
+        : 0;
+    const parts = (input) => {
+        if (!input.includes("T")) {
+            return { date: input, time: "00:00" };
+        }
+        const wallClock = input.match(/^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})(?::\d{2}(?:\.\d+)?)?$/);
+        if (wallClock) {
+            return { date: wallClock[1], time: wallClock[2] };
+        }
+        if (!value.time_zone) {
+            const local = new Date(new Date(input).getTime() + offsetMinutes * 60_000).toISOString();
+            return { date: local.slice(0, 10), time: local.slice(11, 16) };
+        }
+        const entries = new Intl.DateTimeFormat("en-CA", {
+            timeZone: value.time_zone,
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            hourCycle: "h23",
+        }).formatToParts(new Date(input));
+        const get = (type) => entries.find(part => part.type === type)?.value;
+        return {
+            date: `${get("year")}-${get("month")}-${get("day")}`,
+            time: `${get("hour")}:${get("minute")}`,
+        };
+    };
+    const start = parts(value.start);
+    const end = value.end ? parts(value.end) : undefined;
+    if (!timed) {
+        return end
+            ? { type: "daterange", start_date: start.date, end_date: end.date }
+            : { type: "date", start_date: start.date };
+    }
+    const zone = value.time_zone ??
+        (offsetMinutes === 0
+            ? "UTC"
+            : `UTC${offsetMinutes < 0 ? "-" : "+"}${Math.floor(Math.abs(offsetMinutes) / 60)}${Math.abs(offsetMinutes) % 60 === 0 ? "" : `:${String(Math.abs(offsetMinutes) % 60).padStart(2, "0")}`}`);
+    return end
+        ? {
+            type: "datetimerange",
+            start_date: start.date,
+            start_time: start.time,
+            end_date: end.date,
+            end_time: end.time,
+            time_zone: zone,
+        }
+        : {
+            type: "datetime",
+            start_date: start.date,
+            start_time: start.time,
+            time_zone: zone,
+        };
+}
+function toLegacyProperty(property) {
+    switch (property.type) {
+        case "title":
+            return plainText(property.title);
+        case "rich_text":
+            return plainText(property.rich_text);
+        case "number":
+            return property.number ?? undefined;
+        case "checkbox":
+            return property.checkbox;
+        case "url":
+            return property.url ?? "";
+        case "email":
+            return property.email ?? "";
+        case "phone_number":
+            return property.phone_number ?? "";
+        case "select":
+            return property.select?.name;
+        case "status":
+            return property.status?.name;
+        case "multi_select":
+            return property.multi_select.flatMap(option => option.name ?? []);
+        case "date":
+            return property.date ? legacyDate(property.date) : undefined;
+        case "people":
+            return property.people.map(person => person.object === "group"
+                ? {
+                    id: person.id,
+                    table: "space_permission_group",
+                    spaceId: person.id.split("|")[1],
+                }
+                : { id: person.id, table: "notion_user" });
+        case "relation":
+            return property.relation.map(page => ({ id: page.id, table: "block" }));
+        case "files":
+            return property.files.map(file => file.name).join(",");
+        case "place":
+            return "";
+        case "created_time":
+            return timestamp(property.created_time);
+        case "last_edited_time":
+            return timestamp(property.last_edited_time);
+        case "last_visited_time":
+            return timestamp(property.last_visited_time);
+        case "created_by":
+            return property.created_by ? [property.created_by] : undefined;
+        case "last_edited_by":
+            return property.last_edited_by ? [property.last_edited_by] : undefined;
+        default:
+            return unreachable(property);
+    }
+}

package/dist/lifecycle/normalizeHostToSandboxMessage.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"normalizeHostToSandboxMessage.d.ts","sourceRoot":"","sources":["../../src/lifecycle/normalizeHostToSandboxMessage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAA;AAEtG;;GAEG;AAGH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,oBAAoB,EAC7B,qBAAqB,EAAE,MAAM,GAC3B,oBAAoB,CAkCtB"}
+{"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;AAGH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,oBAAoB,EAC7B,qBAAqB,EAAE,MAAM,GAC3B,0BAA0B,CAG5B"}

package/dist/lifecycle/normalizeHostToSandboxMessage.js

@@ -1,38 +1,10 @@
-import { NOTION_BUILTIN_PROPERTY_SCHEMAS } from "../protocol/dataSources/propertySchema.js";
+import { normalizeQueryPage } from "./normalizeQueryPage.js";
 /**
  * Normalizes an outgoing message for the bridge protocol version requested by the sandbox.
  */
 // TODO(custom-blocks): Remove this function when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION
-// reaches 5.
+// reaches 6.
 export function normalizeHostToSandboxMessage(message, bridgeProtocolVersion) {
-    // The latest SDK version does not need any normalization.
-    if (bridgeProtocolVersion >= 5) {
-        return message;
-    }
-    const containsDataSources = (message.type === "init" && message.status === "success") ||
-        message.type === "dataSourcesChanged";
-    if (!containsDataSources) {
-        return message;
-    }
-    // Protocol 5 excludes synthetic IDs such as created_time from collectionSchema.propertiesById.
-    // Older SDKs derive read schemas from that map. Restore those entries in outgoing copies so
-    // host query validation still uses the actual database schema.
-    return {
-        ...message,
-        dataSources: {
-            bindings: Object.fromEntries(Object.entries(message.dataSources.bindings).map(([key, binding]) => [
-                key,
-                {
-                    ...binding,
-                    collectionSchema: {
-                        ...binding.collectionSchema,
-                        propertiesById: {
-                            ...binding.collectionSchema?.propertiesById,
-                            ...NOTION_BUILTIN_PROPERTY_SCHEMAS,
-                        },
-                    },
-                },
-            ])),
-        },
-    };
+    const normalizedMessage = normalizeQueryPage(message, bridgeProtocolVersion);
+    return normalizedMessage;
 }

package/dist/lifecycle/normalizeQueryPage.d.ts

@@ -0,0 +1,3 @@
+import type { HostToSandboxMessage, HostToSandboxMessageLegacy } from "../protocol/messages/hostToSandbox.js";
+export declare function normalizeQueryPage(message: HostToSandboxMessageLegacy | HostToSandboxMessage, bridgeProtocolVersion: number): HostToSandboxMessageLegacy;
+//# sourceMappingURL=normalizeQueryPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeQueryPage.d.ts","sourceRoot":"","sources":["../../src/lifecycle/normalizeQueryPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,MAAM,4DAA4D,CAAA;AAInE,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,0BAA0B,GAAG,oBAAoB,EAC1D,qBAAqB,EAAE,MAAM,GAC3B,0BAA0B,CAc5B"}

package/dist/lifecycle/normalizeQueryPage.js

@@ -0,0 +1,13 @@
+import { LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION } from "../protocol/protocolVersion.js";
+import { toLegacyQueryPage } from "./legacyPage.js";
+export function normalizeQueryPage(message, bridgeProtocolVersion) {
+    if (bridgeProtocolVersion < LEGACY_PROPERTY_SHAPE_PROTOCOL_VERSION &&
+        message.type === "queryDataSourceResult" &&
+        message.status === "success") {
+        return {
+            ...message,
+            items: message.items.map(page => "properties" in page ? toLegacyQueryPage(page) : page),
+        };
+    }
+    return message;
+}

package/dist/messages/parseExternalUrl.d.ts

@@ -0,0 +1,3 @@
+/** Returns a normalized, credential-free HTTP or HTTPS URL. */
+export declare function parseExternalUrl(input: string): string | undefined;
+//# sourceMappingURL=parseExternalUrl.d.ts.map

package/dist/messages/parseExternalUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseExternalUrl.d.ts","sourceRoot":"","sources":["../../src/messages/parseExternalUrl.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAclE"}

package/dist/messages/parseExternalUrl.js

@@ -0,0 +1,15 @@
+const MAX_EXTERNAL_URL_LENGTH = 2048;
+/** Returns a normalized, credential-free HTTP or HTTPS URL. */
+export function parseExternalUrl(input) {
+    if (input.length > MAX_EXTERNAL_URL_LENGTH || !URL.canParse(input)) {
+        return undefined;
+    }
+    const parsed = new URL(input);
+    if ((parsed.protocol !== "http:" && parsed.protocol !== "https:") ||
+        parsed.username !== "" ||
+        parsed.password !== "" ||
+        parsed.href.length > MAX_EXTERNAL_URL_LENGTH) {
+        return undefined;
+    }
+    return parsed.href;
+}

package/dist/messages/sandboxMessageRouter.d.ts

@@ -5,6 +5,7 @@ import type { GetUserMessage } from "../protocol/messages/getUser.js";
 import type { InitResultMessage } from "../protocol/messages/initResult.js";
 import type { InvalidSandboxMessage } from "../protocol/messages/invalidSandboxMessage.js";
 import type { ListUsersMessage } from "../protocol/messages/listUsers.js";
+import type { OpenExternalUrlMessage } from "../protocol/messages/openExternalUrl.js";
 import type { OpenPageMessage } from "../protocol/messages/openPage.js";
 import type { QueryDataSourceMessage } from "../protocol/messages/queryDataSource.js";
 import type { ResizeMessage } from "../protocol/messages/resize.js";
@@ -27,6 +28,7 @@ export type SandboxMessageRouterOptions = {
     onUnsubscribeDataSourceQuery: (message: UnsubscribeDataSourceQueryMessage) => void;
     onCreatePage: (message: CreatePageMessage) => void | Promise<void>;
     onOpenPage: (message: OpenPageMessage) => void | Promise<void>;
+    onOpenExternalUrl: (message: OpenExternalUrlMessage) => void | Promise<void>;
     onGetPage: (message: GetPageMessage) => void | Promise<void>;
     onGetUser: (message: GetUserMessage) => void | Promise<void>;
     onListUsers: (message: ListUsersMessage) => void | Promise<void>;

package/dist/messages/sandboxMessageRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxMessageRouter.d.ts","sourceRoot":"","sources":["../../src/messages/sandboxMessageRouter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAA;AAC1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAA;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAA;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAA;AAC1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAA;AAChG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAA;AAE/G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAA;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8DAA8D,CAAA;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAA;AAExF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,yEAAyE,CAAA;AAChI,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAA;AAMhG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAA;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAY7D,MAAM,MAAM,2BAA2B,GAAG;IACzC,MAAM,EAAE,iBAAiB,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,UAAU,CAAA;IAC/B,IAAI,EAAE,CAAC,SAAS,EAAE,2BAA2B,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACxE,QAAQ,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAA;IAClD,gBAAgB,EAAE,wBAAwB,CAAC,sBAAsB,CAAC,CAAA;IAClE,mBAAmB,EAAE,wBAAwB,CAAC,yBAAyB,CAAC,CAAA;IACxE,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;IAC5C,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAClD,iBAAiB,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5E,4BAA4B,EAAE,CAC7B,OAAO,EAAE,iCAAiC,KACtC,IAAI,CAAA;IACT,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,UAAU,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,WAAW,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;CAC1C,CAAA;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,2BAA2B,GAClC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAsI/B"}
+{"version":3,"file":"sandboxMessageRouter.d.ts","sourceRoot":"","sources":["../../src/messages/sandboxMessageRouter.ts"],"names":[],"mappings":"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"}

package/dist/messages/sandboxMessageRouter.js

@@ -13,11 +13,11 @@ const bridgeProtocolVersionSchema = v.object({
     bridgeProtocolVersion: v.union([v.number(), v.nan()]),
 });
 export function createSandboxMessageRouter(options) {
-    const { iframe, sandboxOrigin, getInitStatus, emit, sendNack, onInvalidConnect, onInvalidInitResult, onConnect, onInitResult, onQueryDataSource, onUnsubscribeDataSourceQuery, onCreatePage, onGetPage, onOpenPage, onGetUser, onListUsers, onUpdatePage, onResize, } = options;
+    const { iframe, sandboxOrigin, getInitStatus, emit, sendNack, onInvalidConnect, onInvalidInitResult, onConnect, onInitResult, onQueryDataSource, onUnsubscribeDataSourceQuery, onCreatePage, onGetPage, onOpenPage, onOpenExternalUrl, onGetUser, onListUsers, onUpdatePage, onResize, } = options;
     function onInvalidSandboxMessage(data, issues) {
         emit("warn", {
             message: "Ignored unsupported sandbox message",
-            payload: data,
+            payload: redactExternalUrl(data),
             issues,
         });
         const response = getInvalidSandboxMessageResponse(data);
@@ -70,11 +70,11 @@ export function createSandboxMessageRouter(options) {
         if (!isInitHandshakeMessage(message) && getInitStatus() !== "initialized") {
             emit("warn", {
                 message: `Ignored ${message.type} before initialization completed`,
-                payload: message,
+                payload: redactExternalUrl(message),
             });
             return;
         }
-        emit("in", message);
+        emit("in", redactExternalUrl(message));
         switch (message.type) {
             case "connect":
                 onConnect(message);
@@ -94,6 +94,9 @@ export function createSandboxMessageRouter(options) {
             case "openPage":
                 void onOpenPage(message);
                 return;
+            case "openExternalUrl":
+                void onOpenExternalUrl(message);
+                return;
             case "getPage":
                 void onGetPage(message);
                 return;
@@ -117,3 +120,15 @@ export function createSandboxMessageRouter(options) {
         }
     };
 }
+function redactExternalUrl(data) {
+    if (typeof data === "object" &&
+        data !== null &&
+        "type" in data &&
+        data.type === "openExternalUrl") {
+        return {
+            type: "openExternalUrl",
+            ...("requestId" in data ? { requestId: data.requestId } : {}),
+        };
+    }
+    return data;
+}

package/dist/messages/types.d.ts

@@ -5,6 +5,7 @@ import type { CustomBlockGetPageErrorInfo, GetPageMessage, getPageMessageSchema,
 import type { CustomBlockGetUserErrorInfo, GetUserMessage, getUserMessageSchema, getUserResultMessageSchema } from "../protocol/messages/getUser.js";
 import type { CustomBlockListUsersErrorInfo, ListUsersMessage, listUsersMessageSchema, listUsersResultMessageSchema } from "../protocol/messages/listUsers.js";
 import type { BridgeMessagePayload } from "../protocol/messages/messagePayload.js";
+import type { CustomBlockOpenExternalUrlErrorInfo, OpenExternalUrlMessage, OpenExternalUrlResultMessage, openExternalUrlMessageSchema } from "../protocol/messages/openExternalUrl.js";
 import type { CustomBlockOpenPageErrorInfo, OpenPageMessage, openPageMessageSchema, openPageResultMessageSchema } from "../protocol/messages/openPage.js";
 import type { QueryDataSourceMessage, queryDataSourceMessageSchema } from "../protocol/messages/queryDataSource.js";
 import type { ResizeMessage, resizeMessageSchema } from "../protocol/messages/resize.js";
@@ -24,6 +25,10 @@ export type CustomBlockHostUpdatePageResult = BridgeMessagePayload<InferInput<ty
 export type CustomBlockHostGetUserResult = BridgeMessagePayload<InferInput<typeof getUserResultMessageSchema>, CustomBlockGetUserErrorInfo>;
 export type CustomBlockHostListUsersResult = BridgeMessagePayload<InferInput<typeof listUsersResultMessageSchema>, CustomBlockListUsersErrorInfo>;
 export type CustomBlockHostOpenPageResult = BridgeMessagePayload<InferInput<typeof openPageResultMessageSchema>, CustomBlockOpenPageErrorInfo>;
+export type CustomBlockHostOpenExternalUrlResult = BridgeMessagePayload<OpenExternalUrlResultMessage, CustomBlockOpenExternalUrlErrorInfo>;
+export type CustomBlockHostNavigationContext = {
+    signal: AbortSignal;
+};
 export type CustomBlockHostHandlers = {
     queryDataSource: (message: QueryDataSourceMessage) => MaybePromise<CustomBlockHostQueryDataSourceResult>;
     createPage?: (message: CreatePageMessage) => MaybePromise<CustomBlockHostCreatePageResult>;
@@ -31,6 +36,7 @@ export type CustomBlockHostHandlers = {
     getUser?: (message: GetUserMessage) => MaybePromise<CustomBlockHostGetUserResult>;
     listUsers?: (message: ListUsersMessage) => MaybePromise<CustomBlockHostListUsersResult>;
     openPage?: (message: OpenPageMessage) => MaybePromise<CustomBlockHostOpenPageResult>;
+    openExternalUrl?: (message: OpenExternalUrlMessage, context: CustomBlockHostNavigationContext) => MaybePromise<CustomBlockHostOpenExternalUrlResult>;
     updatePage?: (message: UpdatePageMessage) => MaybePromise<CustomBlockHostUpdatePageResult>;
     resize?: (message: ResizeMessage) => void;
 };
@@ -52,6 +58,7 @@ export type GetPageMessageInput = InferInput<typeof getPageMessageSchema>;
 export type GetUserMessageInput = InferInput<typeof getUserMessageSchema>;
 export type ListUsersMessageInput = InferInput<typeof listUsersMessageSchema>;
 export type OpenPageMessageInput = InferInput<typeof openPageMessageSchema>;
+export type OpenExternalUrlMessageInput = InferInput<typeof openExternalUrlMessageSchema>;
 export type QueryDataSourceMessageInput = InferInput<typeof queryDataSourceMessageSchema>;
 export type ResizeMessageInput = InferInput<typeof resizeMessageSchema>;
 export type UpdatePageMessageInput = InferInput<typeof updatePageMessageSchema>;

package/dist/messages/types.d.ts.map

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

package/dist/protocol/dataSources/dataSourcePage.d.ts

@@ -1,8 +1,7 @@
 import * as v from "valibot";
 /**
  * Bridge shape for a data source page, as parsed from inbound host messages. The host keys
- * properties by raw property ID. The four built-ins (`created_time`, `last_edited_time`,
- * `created_by`, `last_edited_by`) are normally present, possibly with `undefined` values.
+ * properties by raw property ID. Only actual schema properties are included.
  */
 export declare const legacyNotionDataSourcePageBridgeSchema: v.ObjectSchema<{
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;

package/dist/protocol/dataSources/dataSourcePage.js

@@ -4,8 +4,7 @@ import { notionPagePropertyValueSchema } from "../pages/page.js";
 import { notionDataSourceValueSchema } from "./dataSourceValue.js";
 /**
  * Bridge shape for a data source page, as parsed from inbound host messages. The host keys
- * properties by raw property ID. The four built-ins (`created_time`, `last_edited_time`,
- * `created_by`, `last_edited_by`) are normally present, possibly with `undefined` values.
+ * properties by raw property ID. Only actual schema properties are included.
  */
 export const legacyNotionDataSourcePageBridgeSchema = v.object({
     id: notionPageIdSchema,

package/dist/protocol/index.d.ts

@@ -34,6 +34,7 @@ export * from "./messages/invalidSandboxMessage.js";
 export * from "./messages/isInitHandshakeMessage.js";
 export * from "./messages/listUsers.js";
 export * from "./messages/messagePayload.js";
+export * from "./messages/openExternalUrl.js";
 export * from "./messages/openPage.js";
 export * from "./messages/pageChanged.js";
 export * from "./messages/parentChanged.js";

package/dist/protocol/index.js

@@ -34,6 +34,7 @@ export * from "./messages/invalidSandboxMessage.js";
 export * from "./messages/isInitHandshakeMessage.js";
 export * from "./messages/listUsers.js";
 export * from "./messages/messagePayload.js";
+export * from "./messages/openExternalUrl.js";
 export * from "./messages/openPage.js";
 export * from "./messages/pageChanged.js";
 export * from "./messages/parentChanged.js";