@notionhq/custom-blocks-host 0.4.2 → 0.5.0

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAA;AAC3F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACtG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAA;AAE5F,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAC1C,cAAc,EACd;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CACrB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB;AAChC,qEAAqE;AACnE;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE;AACjC;;;GAGG;GACD;IACA,MAAM,EAAE,eAAe,CAAA;IACvB,aAAa,EAAE,yBAAyB,GAAG,SAAS,CAAA;IACpD,qBAAqB,EAAE,MAAM,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;CACjB;AACH,8EAA8E;GAC5E;IAAE,MAAM,EAAE,sBAAsB,CAAA;CAAE;AACpC;;;;GAIG;GACD;IACA,MAAM,EAAE,aAAa,CAAA;IACrB,gBAAgB,EAAE,yBAAyB,CAAA;IAC3C,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AACH;;;GAGG;GACD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE;AACrD,wFAAwF;GACtF;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAA;AAExB,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;AAExD,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC3D,8DAA8D;IAC9D,KAAK,EACF,SAAS;IACX,mFAAmF;OACjF,MAAM;IACR,4FAA4F;OAC1F,YAAY;IACd,4GAA4G;OAC1G,SAAS,CAAA;IACZ,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B,CAAA"}

package/dist/lifecycle/types.js

@@ -1,41 +1 @@
-import { notionContrastModeSchema } from "../protocol/contrast.js";
-import { notionDataSourceBindingsSchema } from "../protocol/dataSources/dataSource.js";
-import { notionBlockIdSchema } from "../protocol/ids.js";
-import { manifestSchema, } from "../protocol/manifest.js";
-import { customBlockInitErrorInfoSchema, } from "../protocol/messages/init.js";
-import { customBlockPageSchema } from "../protocol/pages/page.js";
-import { notionParentSchema } from "../protocol/parent.js";
-import { notionThemeSchema } from "../protocol/theme.js";
-import { notionUserSchema } from "../protocol/users/user.js";
-import * as v from "valibot";
-export const customBlockHostManifestResultSchema = v.variant("status", [
-    v.object({ status: v.literal("success"), manifest: manifestSchema }),
-    v.object({
-        status: v.literal("error"),
-        error: customBlockInitErrorInfoSchema,
-    }),
-]);
-export const customBlockHostInitialStateSchema = v.object({
-    theme: notionThemeSchema,
-    /**
-     * Defaults to standard for existing host integrations.
-     * TODO(custom-blocks): Make this required when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION increases to 4.
-     */
-    contrastMode: v.optional(notionContrastModeSchema),
-    blockId: notionBlockIdSchema,
-    parent: notionParentSchema,
-    page: customBlockPageSchema,
-    manifest: manifestSchema,
-    dataSources: v.object({ bindings: notionDataSourceBindingsSchema }),
-    currentUser: notionUserSchema,
-});
-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,
-    }),
-]);
+export {};

package/dist/{lifecycle → manifest}/resolveManifest.d.ts

@@ -1,4 +1,4 @@
-import type { CustomBlockManifest } from "../protocol/manifest.js";
+import type { BridgeCustomBlockManifest } from "../protocol/manifest/manifest.js";
 import type { CustomBlockHostNormalizedManifestResult, CustomBlockManifestSource } from "./types.js";
 /**
  * Select the host's manifest result or the sandbox's connect declaration. Both
@@ -8,6 +8,6 @@ import type { CustomBlockHostNormalizedManifestResult, CustomBlockManifestSource
 export declare function resolveManifest(args: {
     manifestSource: CustomBlockManifestSource;
     hostManifest: Promise<CustomBlockHostNormalizedManifestResult>;
-    connectManifest: CustomBlockManifest | undefined;
+    connectManifest: BridgeCustomBlockManifest | undefined;
 }): Promise<CustomBlockHostNormalizedManifestResult>;
 //# sourceMappingURL=resolveManifest.d.ts.map

package/dist/manifest/resolveManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveManifest.d.ts","sourceRoot":"","sources":["../../src/manifest/resolveManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACtG,OAAO,KAAK,EACX,uCAAuC,EACvC,yBAAyB,EACzB,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC3C,cAAc,EAAE,yBAAyB,CAAA;IACzC,YAAY,EAAE,OAAO,CAAC,uCAAuC,CAAC,CAAA;IAC9D,eAAe,EAAE,yBAAyB,GAAG,SAAS,CAAA;CACtD,GAAG,OAAO,CAAC,uCAAuC,CAAC,CAenD"}

package/dist/manifest/types.d.ts

@@ -0,0 +1,55 @@
+import { manifestSchema } from "../protocol/manifest/manifest.js";
+import * as v from "valibot";
+import type { CustomBlockHostResult } from "../messages/result.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 declare const customBlockHostManifestResultSchema: v.VariantSchema<"status", [v.ObjectSchema<{
+    readonly status: v.LiteralSchema<"success", undefined>;
+    readonly manifest: v.ObjectSchema<{
+        readonly version: v.LiteralSchema<1, undefined>;
+        readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly slashCommand: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly icon: v.OptionalSchema<v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"emoji", undefined>;
+            readonly emoji: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly dataSources: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"emoji", undefined>;
+                readonly emoji: v.StringSchema<undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"external", undefined>;
+                readonly url: v.StringSchema<undefined>;
+            }, undefined>], undefined>, undefined>;
+            readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
+            }, undefined>, undefined>, {}>;
+        }, undefined>, undefined>, {}>;
+        readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly capability: v.StringSchema<undefined>;
+            readonly resource: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+    }, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly status: v.LiteralSchema<"error", undefined>;
+    readonly error: v.ObjectSchema<{
+        readonly code: v.StringSchema<undefined>;
+        readonly message: v.StringSchema<undefined>;
+        readonly isRetryable: v.BooleanSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+/** A persisted manifest or an explicit loading error. The host validates and normalizes it. */
+export type CustomBlockHostManifestResult = CustomBlockHostResult<{
+    manifest: v.InferInput<typeof manifestSchema>;
+}>;
+export type CustomBlockHostNormalizedManifestResult = v.InferOutput<typeof customBlockHostManifestResultSchema>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAA;AACtF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,+FAA+F;AAC/F,MAAM,MAAM,yBAAyB;AACpC,gGAAgG;AAC9F,MAAM;AACR,4FAA4F;GAC1F,SAAS,CAAA;AAEZ,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAM9C,CAAA;AAEF,+FAA+F;AAC/F,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;IACjE,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;CAC7C,CAAC,CAAA;AAEF,MAAM,MAAM,uCAAuC,GAAG,CAAC,CAAC,WAAW,CAClE,OAAO,mCAAmC,CAC1C,CAAA"}

package/dist/manifest/types.js

@@ -0,0 +1,10 @@
+import { customBlockInitErrorInfoSchema } from "../protocol/handshake/init.js";
+import { manifestSchema } from "../protocol/manifest/manifest.js";
+import * as v from "valibot";
+export const customBlockHostManifestResultSchema = v.variant("status", [
+    v.object({ status: v.literal("success"), manifest: manifestSchema }),
+    v.object({
+        status: v.literal("error"),
+        error: customBlockInitErrorInfoSchema,
+    }),
+]);

package/dist/messages/{sandboxMessageRouter.d.ts → createSandboxMessageRouter.d.ts}

@@ -1,19 +1,19 @@
-import type { ConnectMessage } from "../protocol/messages/connect.js";
-import type { CreatePageMessage } from "../protocol/messages/createPage.js";
-import type { GetPageMessage } from "../protocol/messages/getPage.js";
-import type { GetUserMessage } from "../protocol/messages/getUser.js";
-import type { InitResultMessage } from "../protocol/messages/initResult.js";
+import type { ResizeMessage } from "../protocol/context/messages/resize.js";
+import type { QueryDataSourceMessage } from "../protocol/dataSources/messages/queryDataSource.js";
+import type { UnsubscribeDataSourceQueryMessage } from "../protocol/dataSources/messages/unsubscribeDataSourceQuery.js";
+import type { ConnectMessage } from "../protocol/handshake/connect.js";
+import type { InitResultMessage } from "../protocol/handshake/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";
-import type { UnsubscribeDataSourceQueryMessage } from "../protocol/messages/unsubscribeDataSourceQuery.js";
-import type { UpdatePageMessage } from "../protocol/messages/updatePage.js";
-import type { InitializationController } from "../lifecycle/initializationController.js";
+import type { OpenExternalUrlMessage } from "../protocol/navigation/openExternalUrl.js";
+import type { CreatePageMessage } from "../protocol/pages/messages/createPage.js";
+import type { GetPageMessage } from "../protocol/pages/messages/getPage.js";
+import type { OpenPageMessage } from "../protocol/pages/messages/openPage.js";
+import type { UpdatePageMessage } from "../protocol/pages/messages/updatePage.js";
+import type { GetUserMessage } from "../protocol/users/messages/getUser.js";
+import type { ListUsersMessage } from "../protocol/users/messages/listUsers.js";
+import type { InitializationController } from "../lifecycle/createInitializationController.js";
 import type { InitStatus } from "../lifecycle/types.js";
-import type { CustomBlockHostLogDirection } from "./types.js";
+import type { CustomBlockHostLogDirection } from "./logging.js";
 export type SandboxMessageRouterOptions = {
     iframe: HTMLIFrameElement;
     sandboxOrigin: string;
@@ -36,4 +36,4 @@ export type SandboxMessageRouterOptions = {
     onResize: (message: ResizeMessage) => void;
 };
 export declare function createSandboxMessageRouter(options: SandboxMessageRouterOptions): (event: MessageEvent) => void;
-//# sourceMappingURL=sandboxMessageRouter.d.ts.map
+//# sourceMappingURL=createSandboxMessageRouter.d.ts.map

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

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

package/dist/messages/{sandboxMessageRouter.js → createSandboxMessageRouter.js}

@@ -1,9 +1,10 @@
-import { isInitHandshakeMessage } from "../protocol/messages/isInitHandshakeMessage.js";
+import { isInitHandshakeMessage } from "../protocol/handshake/isInitHandshakeMessage.js";
 import * as v from "valibot";
 import { normalizeSandboxToHostMessage } from "../compatibility/normalizeSandboxToHostMessage.js";
-import { invalidConnectPayloadError, invalidInitResultPayloadError, } from "../lifecycle/initErrors.js";
-import { unreachable } from "../utils.js";
-import { getInvalidSandboxMessageResponse } from "./invalidSandboxMessage.js";
+import { invalidConnectPayloadError } from "../lifecycle/errors/invalidConnectPayloadError.js";
+import { invalidInitResultPayloadError } from "../lifecycle/errors/invalidInitResultPayloadError.js";
+import { unreachable } from "../utils/unreachable.js";
+import { getInvalidSandboxMessageResponse } from "./getInvalidSandboxMessageResponse.js";
 const initializationIdentitySchema = v.object({
     initializationId: v.string(),
 });

package/dist/messages/{invalidSandboxMessage.d.ts → getInvalidSandboxMessageResponse.d.ts}

@@ -4,4 +4,4 @@ export type InvalidSandboxMessageResponse = {
     nack?: InvalidSandboxMessage;
 };
 export declare function getInvalidSandboxMessageResponse(data: unknown): InvalidSandboxMessageResponse;
-//# sourceMappingURL=invalidSandboxMessage.d.ts.map
+//# sourceMappingURL=getInvalidSandboxMessageResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getInvalidSandboxMessageResponse.d.ts","sourceRoot":"","sources":["../../src/messages/getInvalidSandboxMessageResponse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAA;AAE/G,MAAM,MAAM,6BAA6B,GAAG;IAC3C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,IAAI,CAAC,EAAE,qBAAqB,CAAA;CAC5B,CAAA;AAED,wBAAgB,gCAAgC,CAC/C,IAAI,EAAE,OAAO,GACX,6BAA6B,CAe/B"}

package/dist/messages/handlers.d.ts

@@ -0,0 +1,27 @@
+import type { ResizeMessage } from "../protocol/context/messages/resize.js";
+import type { QueryDataSourceMessage } from "../protocol/dataSources/messages/queryDataSource.js";
+import type { OpenExternalUrlMessage } from "../protocol/navigation/openExternalUrl.js";
+import type { CreatePageMessage } from "../protocol/pages/messages/createPage.js";
+import type { GetPageMessage } from "../protocol/pages/messages/getPage.js";
+import type { OpenPageMessage } from "../protocol/pages/messages/openPage.js";
+import type { UpdatePageMessage } from "../protocol/pages/messages/updatePage.js";
+import type { GetUserMessage } from "../protocol/users/messages/getUser.js";
+import type { ListUsersMessage } from "../protocol/users/messages/listUsers.js";
+import type { CustomBlockHostQueryDataSourceResult } from "../dataSources/types.js";
+import type { CustomBlockHostNavigationContext } from "../navigation/types.js";
+import type { CustomBlockHostOpenPageResult, CustomBlockHostPageResult } from "../pages/types.js";
+import type { CustomBlockHostUserListResult, CustomBlockHostUserResult } from "../users/types.js";
+import type { MaybePromise } from "../utils/maybePromise.js";
+import type { CustomBlockHostResult } from "./result.js";
+export type CustomBlockHostHandlers = {
+    queryDataSource: (message: QueryDataSourceMessage) => MaybePromise<CustomBlockHostQueryDataSourceResult>;
+    createPage?: (message: CreatePageMessage) => MaybePromise<CustomBlockHostPageResult>;
+    getPage?: (message: GetPageMessage) => MaybePromise<CustomBlockHostPageResult>;
+    getUser?: (message: GetUserMessage) => MaybePromise<CustomBlockHostUserResult>;
+    listUsers?: (message: ListUsersMessage) => MaybePromise<CustomBlockHostUserListResult>;
+    openPage?: (message: OpenPageMessage) => MaybePromise<CustomBlockHostOpenPageResult>;
+    openExternalUrl?: (message: OpenExternalUrlMessage, context: CustomBlockHostNavigationContext) => MaybePromise<CustomBlockHostResult>;
+    updatePage?: (message: UpdatePageMessage) => MaybePromise<CustomBlockHostPageResult>;
+    resize?: (message: ResizeMessage) => void;
+};
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/messages/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6DAA6D,CAAA;AAChG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0EAA0E,CAAA;AACtH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAA;AAC5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAA;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAA;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6DAA6D,CAAA;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAA;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAA;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAA;AACpG,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AACnF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAA;AAC9E,OAAO,KAAK,EACX,6BAA6B,EAC7B,yBAAyB,EACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACX,6BAA6B,EAC7B,yBAAyB,EACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAExD,MAAM,MAAM,uBAAuB,GAAG;IACrC,eAAe,EAAE,CAChB,OAAO,EAAE,sBAAsB,KAC3B,YAAY,CAAC,oCAAoC,CAAC,CAAA;IACvD,UAAU,CAAC,EAAE,CACZ,OAAO,EAAE,iBAAiB,KACtB,YAAY,CAAC,yBAAyB,CAAC,CAAA;IAC5C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,YAAY,CAAC,yBAAyB,CAAC,CAAA;IAC9E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,YAAY,CAAC,yBAAyB,CAAC,CAAA;IAC9E,SAAS,CAAC,EAAE,CACX,OAAO,EAAE,gBAAgB,KACrB,YAAY,CAAC,6BAA6B,CAAC,CAAA;IAChD,QAAQ,CAAC,EAAE,CACV,OAAO,EAAE,eAAe,KACpB,YAAY,CAAC,6BAA6B,CAAC,CAAA;IAChD,eAAe,CAAC,EAAE,CACjB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,gCAAgC,KACrC,YAAY,CAAC,qBAAqB,CAAC,CAAA;IACxC,UAAU,CAAC,EAAE,CACZ,OAAO,EAAE,iBAAiB,KACtB,YAAY,CAAC,yBAAyB,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;CACzC,CAAA"}

package/dist/messages/handlers.js

@@ -0,0 +1 @@
+export {};

package/dist/messages/logging.d.ts

@@ -0,0 +1,2 @@
+export type CustomBlockHostLogDirection = "in" | "out" | "warn";
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/messages/logging.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAA"}

package/dist/messages/logging.js

@@ -0,0 +1 @@
+export {};

package/dist/messages/result.d.ts

@@ -0,0 +1,12 @@
+import type { CustomBlockErrorInfo } from "../protocol/utils/errors.js";
+/**
+ * The outcome of a handler operation: success with its data, or failure with an error.
+ * The host turns the result into a response message.
+ */
+export type CustomBlockHostResult<Payload extends object = Record<never, never>> = ({
+    status: "success";
+} & Payload) | {
+    status: "error";
+    error: CustomBlockErrorInfo;
+};
+//# sourceMappingURL=result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/messages/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAA;AAE5F;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAChC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAE3C,CAAC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,OAAO,CAAC,GACjC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAA"}

package/dist/messages/result.js

@@ -0,0 +1 @@
+export {};

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

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

package/dist/navigation/types.d.ts

@@ -0,0 +1,7 @@
+import type { openExternalUrlMessageSchema } from "../protocol/navigation/openExternalUrl.js";
+import type { InferInput } from "valibot";
+export type CustomBlockHostNavigationContext = {
+    signal: AbortSignal;
+};
+export type OpenExternalUrlMessageInput = InferInput<typeof openExternalUrlMessageSchema>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/navigation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gEAAgE,CAAA;AAClH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,MAAM,MAAM,gCAAgC,GAAG;IAC9C,MAAM,EAAE,WAAW,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,UAAU,CACnD,OAAO,4BAA4B,CACnC,CAAA"}

package/dist/navigation/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pages/types.d.ts

@@ -0,0 +1,18 @@
+import type { BridgePage } from "../protocol/pages/bridgePage.js";
+import type { createPageMessageSchema } from "../protocol/pages/messages/createPage.js";
+import type { getPageMessageSchema } from "../protocol/pages/messages/getPage.js";
+import type { openPageMessageSchema } from "../protocol/pages/messages/openPage.js";
+import type { updatePageMessageSchema } from "../protocol/pages/messages/updatePage.js";
+import type { InferInput } from "valibot";
+import type { CustomBlockHostResult } from "../messages/result.js";
+export type CreatePageMessageInput = InferInput<typeof createPageMessageSchema>;
+export type GetPageMessageInput = InferInput<typeof getPageMessageSchema>;
+export type OpenPageMessageInput = InferInput<typeof openPageMessageSchema>;
+export type UpdatePageMessageInput = InferInput<typeof updatePageMessageSchema>;
+export type CustomBlockHostPageResult = CustomBlockHostResult<{
+    page: BridgePage;
+}>;
+export type CustomBlockHostOpenPageResult = CustomBlockHostResult<{
+    pageId: string;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pages/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sDAAsD,CAAA;AACtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAC5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAA;AACtG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAA;AACxG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAC5G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE/E,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEzE,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE3E,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE/E,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;IAC7D,IAAI,EAAE,UAAU,CAAA;CAChB,CAAC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;IACjE,MAAM,EAAE,MAAM,CAAA;CACd,CAAC,CAAA"}

package/dist/pages/types.js

@@ -0,0 +1 @@
+export {};

package/dist/protocol/{messages/updatePage.d.ts → compatibility/protocol3To5/bridgePage.d.ts}

@@ -1,20 +1,26 @@
 import * as v from "valibot";
-/**
- * The sandbox sends this message to patch a page.
- */
-export declare const updatePageMessageSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"updatePage", undefined>;
-    readonly requestId: v.StringSchema<undefined>;
-    readonly pageId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
-    readonly dataSourceId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>, undefined>;
-    /**
-     * Property values, keyed by raw property IDs from Notion.
-     *
-     * Each value must carry the same raw property ID in its `id` field.
-     * To update a page with manifest-defined property keys, call `row.update()` on a row returned
-     * by `useDataSource()`. The SDK resolves those keys before it sends this message.
-     */
-    readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+export declare const bridgePageForProtocol3To5Schema: v.ObjectSchema<{
+    readonly object: v.LiteralSchema<"page", undefined>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
+    readonly parent: v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"page_id", undefined>;
+        readonly page_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"data_source_id", undefined>;
+        readonly data_source_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"workspace", undefined>;
+        readonly workspace: v.LiteralSchema<true, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"block_id", undefined>;
+        readonly block_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"agent_id", undefined>;
+        readonly agent_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionAgentId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"unavailable", undefined>;
+    }, undefined>], undefined>;
+    readonly properties: v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
         readonly id: v.StringSchema<undefined>;
         readonly type: v.LiteralSchema<"title", undefined>;
         readonly title: v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
@@ -228,7 +234,9 @@ export declare const updatePageMessageSchema: v.ObjectSchema<{
         readonly id: v.StringSchema<undefined>;
         readonly type: v.LiteralSchema<"verification", undefined>;
         readonly verification: v.StringSchema<undefined>;
-    }, undefined>], undefined>, undefined>, undefined>;
+    }, undefined>], undefined>, undefined>;
+    readonly created_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly last_edited_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"emoji", undefined>;
         readonly emoji: v.StringSchema<undefined>;
@@ -263,9 +271,11 @@ export declare const updatePageMessageSchema: v.ObjectSchema<{
             readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>;
     }, undefined>], undefined>, undefined>;
-    readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly public_url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Whether the page or an ancestor is archived. */
+    readonly is_archived: v.BooleanSchema<undefined>;
+    /** Whether the page or an ancestor is in Trash. */
+    readonly in_trash: v.BooleanSchema<undefined>;
 }, undefined>;
-/**
- * The sandbox sends this message to update a page.
- */
-export type UpdatePageMessage = v.InferOutput<typeof updatePageMessageSchema>;
+export type BridgePageForProtocol3To5 = v.InferOutput<typeof bridgePageForProtocol3To5Schema>;

package/dist/protocol/compatibility/protocol3To5/bridgePage.js

@@ -0,0 +1,21 @@
+import * as v from "valibot";
+import { notionParentSchema } from "../../context/parent.js";
+import { notionPageCoverSchema, notionPageIconSchema, } from "../../pages/pageAppearance.js";
+import { bridgePagePropertyWriteMapSchema } from "../../pages/properties/bridgePagePropertyMaps.js";
+import { notionPageIdSchema } from "../../utils/ids.js";
+export const bridgePageForProtocol3To5Schema = v.object({
+    object: v.literal("page"),
+    id: notionPageIdSchema,
+    parent: notionParentSchema,
+    properties: bridgePagePropertyWriteMapSchema,
+    created_time: v.optional(v.string()),
+    last_edited_time: v.optional(v.string()),
+    icon: v.optional(notionPageIconSchema),
+    cover: v.optional(notionPageCoverSchema),
+    url: v.optional(v.string()),
+    public_url: v.optional(v.string()),
+    /** Whether the page or an ancestor is archived. */
+    is_archived: v.boolean(),
+    /** Whether the page or an ancestor is in Trash. */
+    in_trash: v.boolean(),
+});

package/dist/protocol/{dataSources → compatibility/protocol3To5}/dataSourcePage.js

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import { notionPageIdSchema } from "../ids.js";
+import { notionPageIdSchema } from "../../utils/ids.js";
 import { notionDataSourceValueSchema } from "./dataSourceValue.js";
 /**
  * Query page shape for protocols 3–5, with flat values keyed by raw property ID.

package/dist/protocol/{dataSources → compatibility/protocol3To5}/dataSourceValue.js

@@ -1,6 +1,6 @@
 import * as v from "valibot";
-import { notionDateValueSchema } from "./dateValue.js";
-import { notionRecordPointerSchema } from "./recordPointer.js";
+import { notionDateValueSchema } from "../../dataSources/properties/dateValue.js";
+import { notionRecordPointerSchema } from "../../utils/recordPointer.js";
 /**
  * Possible types for a data source value.
  */

package/dist/protocol/context/containingPage.d.ts

@@ -0,0 +1,31 @@
+import * as v from "valibot";
+export declare const customBlockPageSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"unavailable", undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"page", undefined>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
+    /**
+     * The containing page's own parent. It lets a block distinguish a freestanding page from a
+     * database row without a round trip. Not to be confused with the top-level `parent` runtime
+     * value, which is the custom block's own parent.
+     */
+    readonly parent: v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"page_id", undefined>;
+        readonly page_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"data_source_id", undefined>;
+        readonly data_source_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"workspace", undefined>;
+        readonly workspace: v.LiteralSchema<true, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"block_id", undefined>;
+        readonly block_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"agent_id", undefined>;
+        readonly agent_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionAgentId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"unavailable", undefined>;
+    }, undefined>], undefined>;
+}, undefined>], undefined>;
+export type CustomBlockPage = v.InferOutput<typeof customBlockPageSchema>;

package/dist/protocol/context/containingPage.js

@@ -0,0 +1,18 @@
+import * as v from "valibot";
+import { notionPageIdSchema } from "../utils/ids.js";
+import { notionParentSchema } from "./parent.js";
+export const customBlockPageSchema = v.variant("type", [
+    /** The viewer cannot access the containing page; its ID and parent are not exposed. */
+    v.object({ type: v.literal("unavailable") }),
+    /** The viewer can access the containing page; includes its ID and parent location. */
+    v.object({
+        type: v.literal("page"),
+        id: notionPageIdSchema,
+        /**
+         * The containing page's own parent. It lets a block distinguish a freestanding page from a
+         * database row without a round trip. Not to be confused with the top-level `parent` runtime
+         * value, which is the custom block's own parent.
+         */
+        parent: notionParentSchema,
+    }),
+]);

package/dist/protocol/{messages → context/messages}/pageChanged.js

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import { customBlockPageSchema } from "../pages/page.js";
+import { customBlockPageSchema } from "../containingPage.js";
 /**
  * Message sent by the host whenever the custom block's nearest page ancestor changes.
  */

package/dist/protocol/{parent.d.ts → context/parent.d.ts}

@@ -1,4 +1,14 @@
 import * as v from "valibot";
+export declare const pageParentSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"page_id", undefined>;
+    readonly page_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
+}, undefined>;
+export type PageParent = v.InferOutput<typeof pageParentSchema>;
+export declare const dataSourceParentSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"data_source_id", undefined>;
+    readonly data_source_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>;
+}, undefined>;
+export type DataSourceParent = v.InferOutput<typeof dataSourceParentSchema>;
 export declare const notionParentSchema: v.VariantSchema<"type", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"page_id", undefined>;
     readonly page_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
@@ -23,7 +33,7 @@ export declare const notionParentSchema: v.VariantSchema<"type", [v.ObjectSchema
  * Uses Notion public API parent names, plus an unavailable state:
  * - `page_id` — parented directly under a page.
  * - `block_id` — parented under a non-page container block (toggle, column, callout, ...).
- * - `data_source_id` — parented under a collection (data source).
+ * - `data_source_id` — parented under a data source.
  * - `workspace` — top-level / team-rooted.
  * - `agent_id` — owned by an agent, such as an agent instruction page or its blocks.
  * - `unavailable` — the viewer cannot access the parent resource. Neither its ID nor its kind

package/dist/protocol/context/parent.js

@@ -0,0 +1,31 @@
+import * as v from "valibot";
+import { notionAgentIdSchema, notionBlockIdSchema, notionDataSourceIdSchema, notionPageIdSchema, } from "../utils/ids.js";
+export const pageParentSchema = v.object({
+    type: v.literal("page_id"),
+    page_id: notionPageIdSchema,
+});
+export const dataSourceParentSchema = v.object({
+    type: v.literal("data_source_id"),
+    data_source_id: notionDataSourceIdSchema,
+});
+const workspaceParentSchema = v.object({
+    type: v.literal("workspace"),
+    workspace: v.literal(true),
+});
+const blockParentSchema = v.object({
+    type: v.literal("block_id"),
+    block_id: notionBlockIdSchema,
+});
+const agentParentSchema = v.object({
+    type: v.literal("agent_id"),
+    agent_id: notionAgentIdSchema,
+});
+const unavailableParentSchema = v.object({ type: v.literal("unavailable") });
+export const notionParentSchema = v.variant("type", [
+    pageParentSchema,
+    dataSourceParentSchema,
+    workspaceParentSchema,
+    blockParentSchema,
+    agentParentSchema,
+    unavailableParentSchema,
+]);