ncblock 0.0.6 → 0.0.7

package/dist/bridge/SandboxBridge.d.ts

@@ -10,9 +10,20 @@ import type { InitMessage } from "./messages/init";
  * protocol. Increment this number any time a breaking change is made to the bridge protocol.
  */
 export declare const CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION = 1;
+/**
+ * A single entry in the bridge message log. Kept intentionally plain so the log
+ * is copy-pasteable to a local coding agent without needing extra context.
+ */
+export type MessageLogEntry = {
+    timestamp: string;
+    direction: "sent" | "received";
+    data: unknown;
+};
 export declare class SandboxBridge {
     private hostState;
     private listeners;
+    private messageLog;
+    private messageLogListeners;
     private nextRequestId;
     private readonly pendingCreatePage;
     private readonly pendingGetPage;
@@ -23,8 +34,13 @@ export declare class SandboxBridge {
     private readonly initMessage;
     private manifest;
     constructor();
+    private static MAX_LOG_ENTRIES;
+    private logMessage;
+    getMessageLog(): readonly MessageLogEntry[];
+    subscribeToMessageLog(listener: () => void): () => boolean;
     awaitInit(signal?: AbortSignal): Promise<InitMessage>;
     sendReady(manifest: CustomBlockManifest | null): void;
+    private postToHost;
     private notify;
     private handleMessage;
     subscribe(listener: () => void): () => boolean;

package/dist/bridge/SandboxBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxBridge.d.ts","sourceRoot":"","sources":["../../src/bridge/SandboxBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,MAAM,UAAU,CAAA;AAGjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EACX,+BAA+B,EAC/B,gCAAgC,EAChC,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EACN,KAAK,oBAAoB,EAGzB,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAOrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAUlD;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,IAAI,CAAA;AAErD,qBAAa,aAAa;IACzB,OAAO,CAAC,SAAS,CAGhB;IACD,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEjC;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE9B;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE9B;IACD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAEhC;IACD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEjC;IACD,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IACF,OAAO,CAAC,QAAQ,CAAmC;;IAWnD,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBrD,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAc9C,OAAO,CAAC,MAAM,CAIb;IAED,OAAO,CAAC,aAAa,CAwMpB;IAED,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI;IAK9B,YAAY,IAAI,oBAAoB;IAIpC;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,WAAW;IAIjC,OAAO,CAAC,SAAS;IAsBjB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAuC1C,UAAU,CAAC,MAAM,EAAE,MAAM;IAczB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqC7D,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAarD,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAarD,SAAS,CAAC,KAAK,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAc/D,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwC7D;;;;OAIG;IACH,oBAAoB,CAAC,IAAI,EAAE;QAC1B,UAAU,EAAE,gBAAgB,CAAA;QAC5B,MAAM,EAAE,YAAY,CAAA;QACpB,KAAK,EAAE,+BAA+B,CAAA;KACtC,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAuB7C;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;CAsD/B"}
+{"version":3,"file":"SandboxBridge.d.ts","sourceRoot":"","sources":["../../src/bridge/SandboxBridge.ts"],"names":[],"mappings":"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"}

package/dist/bridge/SandboxBridge.js

@@ -19,6 +19,8 @@ export class SandboxBridge {
             theme: "light",
         };
         this.listeners = new Set();
+        this.messageLog = [];
+        this.messageLogListeners = new Set();
         this.nextRequestId = 1;
         this.pendingCreatePage = new PendingRequests("custom-block-create-page");
         this.pendingGetPage = new PendingRequests("custom-block-get-page");
@@ -42,6 +44,7 @@ export class SandboxBridge {
             if (event.source !== window.parent) {
                 return;
             }
+            this.logMessage("received", event.data);
             const parsed = v.safeParse(hostToSandboxMessageSchema, event.data);
             if (!parsed.success) {
                 console.warn("[notion-custom-sdk] ignoring malformed host message", parsed.issues);
@@ -56,8 +59,7 @@ export class SandboxBridge {
                         type: "invalidHostMessage",
                         reason: formatInvalidHostReason(incomingType, parsed.issues),
                     };
-                    console.debug("[notion-custom-sdk] outbound postMessage", nack);
-                    window.parent.postMessage(nack, "*");
+                    this.postToHost(nack);
                 }
                 return;
             }
@@ -202,6 +204,26 @@ export class SandboxBridge {
             window.addEventListener("message", this.handleMessage);
         }
     }
+    logMessage(direction, data) {
+        if (this.messageLog.length >= SandboxBridge.MAX_LOG_ENTRIES) {
+            this.messageLog.shift();
+        }
+        this.messageLog.push({
+            timestamp: new Date().toISOString(),
+            direction,
+            data,
+        });
+        for (const listener of this.messageLogListeners) {
+            listener();
+        }
+    }
+    getMessageLog() {
+        return this.messageLog;
+    }
+    subscribeToMessageLog(listener) {
+        this.messageLogListeners.add(listener);
+        return () => this.messageLogListeners.delete(listener);
+    }
     awaitInit(signal) {
         if (!signal) {
             return this.initMessage;
@@ -232,8 +254,12 @@ export class SandboxBridge {
             bridgeProtocolVersion: CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
             manifest,
         };
-        console.debug("[notion-custom-sdk] outbound postMessage", readyMessage);
-        window.parent.postMessage(readyMessage, "*");
+        this.postToHost(readyMessage);
+    }
+    postToHost(message) {
+        console.debug("[notion-custom-sdk] outbound postMessage", message);
+        this.logMessage("sent", message);
+        window.parent.postMessage(message, "*");
     }
     subscribe(listener) {
         this.listeners.add(listener);
@@ -301,8 +327,7 @@ export class SandboxBridge {
             key,
             limit,
         };
-        console.debug("[notion-custom-sdk] outbound postMessage", outbound);
-        window.parent.postMessage(outbound, "*");
+        this.postToHost(outbound);
     }
     postResize(height) {
         if (typeof window === "undefined") {
@@ -313,8 +338,7 @@ export class SandboxBridge {
             type: "resize",
             height: safeHeight,
         };
-        console.debug("[notion-custom-sdk] outbound postMessage", outbound);
-        window.parent.postMessage(outbound, "*");
+        this.postToHost(outbound);
     }
     createPage(input) {
         return new Promise(resolve => {
@@ -348,8 +372,7 @@ export class SandboxBridge {
             if (input.position !== undefined) {
                 outbound.position = input.position;
             }
-            console.debug("[notion-custom-sdk] outbound postMessage", outbound);
-            window.parent.postMessage(outbound, "*");
+            this.postToHost(outbound);
         });
     }
     getPage(pageId) {
@@ -360,8 +383,7 @@ export class SandboxBridge {
                 requestId,
                 pageId,
             };
-            console.debug("[notion-custom-sdk] outbound postMessage", outbound);
-            window.parent.postMessage(outbound, "*");
+            this.postToHost(outbound);
         });
     }
     getUser(userId) {
@@ -372,8 +394,7 @@ export class SandboxBridge {
                 requestId,
                 userId,
             };
-            console.debug("[notion-custom-sdk] outbound postMessage", outbound);
-            window.parent.postMessage(outbound, "*");
+            this.postToHost(outbound);
         });
     }
     listUsers(input = {}) {
@@ -385,8 +406,7 @@ export class SandboxBridge {
                 startCursor: input.startCursor,
                 pageSize: input.pageSize,
             };
-            console.debug("[notion-custom-sdk] outbound postMessage", outbound);
-            window.parent.postMessage(outbound, "*");
+            this.postToHost(outbound);
         });
     }
     updatePage(input) {
@@ -420,8 +440,7 @@ export class SandboxBridge {
             if (input.archived !== undefined) {
                 outbound.archived = input.archived;
             }
-            console.debug("[notion-custom-sdk] outbound postMessage", outbound);
-            window.parent.postMessage(outbound, "*");
+            this.postToHost(outbound);
         });
     }
     /**
@@ -498,6 +517,7 @@ export class SandboxBridge {
         }
     }
 }
+SandboxBridge.MAX_LOG_ENTRIES = 100;
 function formatInvalidHostReason(incomingType, issues) {
     const labelled = incomingType
         ? `host message of type "${incomingType}"`

package/dist/bridge/sandboxClient.d.ts

@@ -2,6 +2,8 @@ import type { CreatePageInput, CreatePageResult, GetPageResult, GetUserResult, L
 import { type CustomBlockHostState, type DataSourceQueryView } from "./hostState";
 import type { CustomBlockManifest } from "./manifest";
 import type { InitMessage } from "./messages/init";
+import { type MessageLogEntry } from "./SandboxBridge";
+export type { MessageLogEntry };
 export declare function sendCustomBlockReady(manifest: CustomBlockManifest | null): void;
 export declare function awaitCustomBlockInit(signal?: AbortSignal): Promise<InitMessage>;
 export declare function subscribeToCustomBlockHost(listener: () => void): () => boolean;
@@ -15,6 +17,8 @@ export declare function queryCustomBlockDataSource(key: string, limit: number):
  */
 export declare function setMockCustomBlockState(message: InitMessage): void;
 export declare function postCustomBlockResize(height: number): void;
+export declare function getMessageLog(): readonly MessageLogEntry[];
+export declare function subscribeToMessageLog(listener: () => void): () => boolean;
 export declare function getUser(userId: NotionUserId): Promise<GetUserResult>;
 export declare function listUsers(input?: ListUsersInput): Promise<ListUsersResult>;
 /**

package/dist/bridge/sandboxClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,MAAM,UAAU,CAAA;AACjB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAKlD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,QAExE;AAED,wBAAgB,oBAAoB,CACnC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,IAAI,iBAE9D;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAEpE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,QAE3D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,QAEnD;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAEpE;AAED,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAE1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,oBAAoB,EAC/B,GAAG,EAAE,MAAM,GACT,mBAAmB,CAIrB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;kBACW,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIzD;;OAEG;gBACS,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD;;OAEG;kBACW,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIzD;;OAEG;mBACY,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGvD,CAAA"}
+{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,MAAM,UAAU,CAAA;AACjB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,iBAAiB,CAAA;AAErE,YAAY,EAAE,eAAe,EAAE,CAAA;AAI/B,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,QAExE;AAED,wBAAgB,oBAAoB,CACnC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,IAAI,iBAE9D;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAEpE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,QAE3D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,QAEnD;AAED,wBAAgB,aAAa,IAAI,SAAS,eAAe,EAAE,CAE1D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,iBAEzD;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAEpE;AAED,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAE1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,oBAAoB,EAC/B,GAAG,EAAE,MAAM,GACT,mBAAmB,CAIrB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;kBACW,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIzD;;OAEG;gBACS,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD;;OAEG;kBACW,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIzD;;OAEG;mBACY,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGvD,CAAA"}

package/dist/bridge/sandboxClient.js

@@ -28,6 +28,12 @@ export function setMockCustomBlockState(message) {
 export function postCustomBlockResize(height) {
     bridge.postResize(height);
 }
+export function getMessageLog() {
+    return bridge.getMessageLog();
+}
+export function subscribeToMessageLog(listener) {
+    return bridge.subscribeToMessageLog(listener);
+}
 export function getUser(userId) {
     return bridge.getUser(userId);
 }

package/dist/index.d.ts

@@ -19,7 +19,8 @@ export type { NotionDataSourceId, NotionSpaceId } from "./bridge/ids";
 export type { CustomBlockManifest, ManifestDataSource, ManifestIcon, ManifestProperty, } from "./bridge/manifest";
 export type { NotionCreatePagePosition } from "./bridge/messages/createPage";
 export type { NotionPage, NotionPageCover, NotionPageIcon, NotionPageId, NotionPageParent, NotionPagePropertyInputMap, NotionPagePropertyInputValue, NotionPagePropertyValue, NotionPagePropertyWriteMap, } from "./bridge/pages/page";
-export { pages } from "./bridge/sandboxClient";
+export type { MessageLogEntry } from "./bridge/sandboxClient";
+export { getMessageLog, pages, subscribeToMessageLog, } from "./bridge/sandboxClient";
 export type { NotionTheme } from "./bridge/theme";
 export { type CustomBlockInitial, type InitCustomBlockOptions, initCustomBlock, NotInIframeError, } from "./init";
 export { NotionCustomBlock, type NotionCustomBlockProps, type UseCustomBlockInitResult, useCustomBlockAutoResize, useCustomBlockContext, useCustomBlockInit, useDataSource, useDataSourceDefinitions, useTheme, } from "./react";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAChE,YAAY,EACX,sBAAsB,EACtB,gBAAgB,GAChB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACX,oBAAoB,EACpB,+BAA+B,EAC/B,gCAAgC,GAChC,MAAM,qCAAqC,CAAA;AAC5C,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AACjF,YAAY,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,gCAAgC,CAAA;AACvC,YAAY,EACX,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACN,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,qCAAqC,CAAA;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AAC7E,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACrE,YAAY,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GAChB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAC5E,YAAY,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,eAAe,EACf,gBAAgB,GAChB,MAAM,QAAQ,CAAA;AACf,OAAO,EACN,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,QAAQ,GACR,MAAM,SAAS,CAAA;AAChB,cAAc,SAAS,CAAA;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAChE,YAAY,EACX,sBAAsB,EACtB,gBAAgB,GAChB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACX,oBAAoB,EACpB,+BAA+B,EAC/B,gCAAgC,GAChC,MAAM,qCAAqC,CAAA;AAC5C,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AACjF,YAAY,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,gCAAgC,CAAA;AACvC,YAAY,EACX,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACN,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,qCAAqC,CAAA;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AAC7E,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACrE,YAAY,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GAChB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAC5E,YAAY,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EACN,aAAa,EACb,KAAK,EACL,qBAAqB,GACrB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,eAAe,EACf,gBAAgB,GAChB,MAAM,QAAQ,CAAA;AACf,OAAO,EACN,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,QAAQ,GACR,MAAM,SAAS,CAAA;AAChB,cAAc,SAAS,CAAA;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -8,7 +8,7 @@
  * downstream code.
  */
 export { NOTION_BUILTIN_PROPERTY_IDS, NOTION_PROPERTY_TYPES, } from "./bridge/dataSources/propertySchema";
-export { pages } from "./bridge/sandboxClient";
+export { getMessageLog, pages, subscribeToMessageLog, } from "./bridge/sandboxClient";
 export { initCustomBlock, NotInIframeError, } from "./init";
 export { NotionCustomBlock, useCustomBlockAutoResize, useCustomBlockContext, useCustomBlockInit, useDataSource, useDataSourceDefinitions, useTheme, } from "./react";
 export * from "./types";

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EAKd,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAUvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAG3B,MAAM,QAAQ,CAAA;AACf,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAsBlD;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GACjC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACjC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,CAAC,EAAE,sBAAsB,GAC3B,wBAAwB,CA8B1B;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,GAAG;IAC7D,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAA;IACzD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,EACjC,QAAQ,EACR,SAAS,EACT,QAAe,EACf,aAAa,EACb,UAAiB,GACjB,EAAE,sBAAsB,2CAyDxB;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,wBAAwB,CAIhE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,WAAW,CAItC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CAI7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,MAAwC,GACpD,mBAAmB,CAiDrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,GAAE;IACL;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACZ,GACJ,IAAI,CAmCN"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EAKd,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAYvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAG3B,MAAM,QAAQ,CAAA;AACf,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAsBlD;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GACjC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACjC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,CAAC,EAAE,sBAAsB,GAC3B,wBAAwB,CA8B1B;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,GAAG;IAC7D,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAA;IACzD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,EACjC,QAAQ,EACR,SAAS,EACT,QAAe,EACf,aAAa,EACb,UAAiB,GACjB,EAAE,sBAAsB,2CAoExB;AAwCD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,wBAAwB,CAIhE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,WAAW,CAItC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CAI7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,MAAwC,GACpD,mBAAmB,CAiDrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,GAAE;IACL;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACZ,GACJ,IAAI,CAmCN"}

package/dist/react.js

@@ -1,6 +1,6 @@
 import { jsxs as _jsxs, Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { useCallback, useEffect, useState, useSyncExternalStore, } from "react";
-import { getCustomBlockHostState, getDataSourceQueryView, postCustomBlockResize, queryCustomBlockDataSource, setMockCustomBlockState, subscribeToCustomBlockHost, } from "./bridge/sandboxClient";
+import { getCustomBlockHostState, getDataSourceQueryView, getMessageLog, postCustomBlockResize, queryCustomBlockDataSource, setMockCustomBlockState, subscribeToCustomBlockHost, subscribeToMessageLog, } from "./bridge/sandboxClient";
 import { initCustomBlock, NotInIframeError, } from "./init";
 const DEFAULT_DATA_SOURCE_QUERY_LIMIT = 20;
 function useCustomBlockHost() {
@@ -80,6 +80,16 @@ export function NotionCustomBlock({ children, timeoutMs, fallback = null, errorF
     useCustomBlockAutoResize({ enabled: autoResize });
     const isStandalone = init.error instanceof NotInIframeError;
     const host = useCustomBlockHost();
+    const [debugOpen, setDebugOpen] = useState(false);
+    useEffect(() => {
+        const onKeyDown = (e) => {
+            if (e.key === "\\") {
+                setDebugOpen(prev => !prev);
+            }
+        };
+        window.addEventListener("keydown", onKeyDown);
+        return () => window.removeEventListener("keydown", onKeyDown);
+    }, []);
     useEffect(() => {
         if (!isStandalone) {
             return;
@@ -110,13 +120,32 @@ export function NotionCustomBlock({ children, timeoutMs, fallback = null, errorF
         if (host.status !== "initialized") {
             return _jsx(_Fragment, { children: fallback });
         }
-        return (_jsxs(_Fragment, { children: [_jsx("div", { role: "status", style: STANDALONE_BANNER_STYLE, children: "Notion host not detected \u2014 running in standalone preview. SDK hooks return placeholder values until embedded in Notion." }), children] }));
+        return (_jsxs(_Fragment, { children: [_jsx("div", { role: "status", style: STANDALONE_BANNER_STYLE, children: "Notion host not detected \u2014 running in standalone preview. SDK hooks return placeholder values until embedded in Notion." }), debugOpen ? _jsx(DebugMessageLog, {}) : children] }));
     }
     if (!init.isLoaded) {
         return _jsx(_Fragment, { children: fallback });
     }
-    return _jsx(_Fragment, { children: children });
+    return _jsx(_Fragment, { children: debugOpen ? _jsx(DebugMessageLog, {}) : children });
 }
+function DebugMessageLog() {
+    const log = useSyncExternalStore(subscribeToMessageLog, getMessageLog);
+    const text = log
+        .map(entry => `[${entry.timestamp}] ${entry.direction}: ${JSON.stringify(entry.data)}`)
+        .join("\n");
+    return (_jsx("pre", { "data-testid": "debug-message-log", style: DEBUG_PRE_STYLE, children: text || "(no messages yet)" }));
+}
+const DEBUG_PRE_STYLE = {
+    margin: 0,
+    padding: "8px 12px",
+    fontSize: 12,
+    fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+    lineHeight: 1.5,
+    whiteSpace: "pre-wrap",
+    wordBreak: "break-all",
+    userSelect: "text",
+    background: "#1e1e1e",
+    color: "#d4d4d4",
+};
 const STANDALONE_BANNER_STYLE = {
     padding: "8px 12px",
     background: "#fff8e1",

package/docs/lifecycle.md

@@ -90,3 +90,35 @@ function App() {
   return <div>…</div>;
 }
 ```
+
+## Debug console
+
+Press `\` while focused in a custom block to toggle a debug overlay that replaces the block's children with a `<pre>` log of every `postMessage` sent and received over the bridge. Each line is formatted as:
+
+```
+[ISO timestamp] sent/received: {"type":"ready", …}
+```
+
+The log is intentionally plain — no filtering or decoration — so it can be copied and pasted directly to a local coding agent for debugging.
+
+### `getMessageLog()`
+
+```ts
+function getMessageLog(): readonly MessageLogEntry[];
+
+type MessageLogEntry = {
+  timestamp: string;
+  direction: "sent" | "received";
+  data: unknown;
+};
+```
+
+Returns the full in-memory log. Entries accumulate for the lifetime of the page.
+
+### `subscribeToMessageLog(listener)`
+
+```ts
+function subscribeToMessageLog(listener: () => void): () => void;
+```
+
+Subscribe to new log entries. Compatible with `useSyncExternalStore` for custom debug UIs.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ncblock",
-	"version": "0.0.6",
+	"version": "0.0.7",
 	"license": "MIT",
 	"type": "module",
 	"main": "./dist/index.js",

package/src/bridge/SandboxBridge.ts

@@ -50,12 +50,24 @@ import type { NotionUser } from "./users/user"
  */
 export const CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION = 1
 
+/**
+ * A single entry in the bridge message log. Kept intentionally plain so the log
+ * is copy-pasteable to a local coding agent without needing extra context.
+ */
+export type MessageLogEntry = {
+	timestamp: string
+	direction: "sent" | "received"
+	data: unknown
+}
+
 export class SandboxBridge {
 	private hostState: CustomBlockHostState = {
 		status: "uninitialized",
 		theme: "light",
 	}
 	private listeners = new Set<() => void>()
+	private messageLog: MessageLogEntry[] = []
+	private messageLogListeners = new Set<() => void>()
 	private nextRequestId = 1
 	private readonly pendingCreatePage = new PendingRequests<CreatePageResult>(
 		"custom-block-create-page",
@@ -87,6 +99,31 @@ export class SandboxBridge {
 		}
 	}
 
+	private static MAX_LOG_ENTRIES = 100
+
+	private logMessage(direction: "sent" | "received", data: unknown) {
+		if (this.messageLog.length >= SandboxBridge.MAX_LOG_ENTRIES) {
+			this.messageLog.shift()
+		}
+		this.messageLog.push({
+			timestamp: new Date().toISOString(),
+			direction,
+			data,
+		})
+		for (const listener of this.messageLogListeners) {
+			listener()
+		}
+	}
+
+	getMessageLog(): readonly MessageLogEntry[] {
+		return this.messageLog
+	}
+
+	subscribeToMessageLog(listener: () => void) {
+		this.messageLogListeners.add(listener)
+		return () => this.messageLogListeners.delete(listener)
+	}
+
 	awaitInit(signal?: AbortSignal): Promise<InitMessage> {
 		if (!signal) {
 			return this.initMessage
@@ -121,8 +158,13 @@ export class SandboxBridge {
 			bridgeProtocolVersion: CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
 			manifest,
 		}
-		console.debug("[notion-custom-sdk] outbound postMessage", readyMessage)
-		window.parent.postMessage(readyMessage, "*")
+		this.postToHost(readyMessage)
+	}
+
+	private postToHost(message: unknown) {
+		console.debug("[notion-custom-sdk] outbound postMessage", message)
+		this.logMessage("sent", message)
+		window.parent.postMessage(message, "*")
 	}
 
 	private notify = () => {
@@ -139,6 +181,7 @@ export class SandboxBridge {
 		if (event.source !== window.parent) {
 			return
 		}
+		this.logMessage("received", event.data)
 
 		const parsed = v.safeParse(hostToSandboxMessageSchema, event.data)
 		if (!parsed.success) {
@@ -159,8 +202,7 @@ export class SandboxBridge {
 					type: "invalidHostMessage",
 					reason: formatInvalidHostReason(incomingType, parsed.issues),
 				}
-				console.debug("[notion-custom-sdk] outbound postMessage", nack)
-				window.parent.postMessage(nack, "*")
+				this.postToHost(nack)
 			}
 			return
 		}
@@ -409,8 +451,7 @@ export class SandboxBridge {
 			key,
 			limit,
 		}
-		console.debug("[notion-custom-sdk] outbound postMessage", outbound)
-		window.parent.postMessage(outbound, "*")
+		this.postToHost(outbound)
 	}
 
 	postResize(height: number) {
@@ -423,8 +464,7 @@ export class SandboxBridge {
 			type: "resize",
 			height: safeHeight,
 		}
-		console.debug("[notion-custom-sdk] outbound postMessage", outbound)
-		window.parent.postMessage(outbound, "*")
+		this.postToHost(outbound)
 	}
 
 	createPage(input: CreatePageInput): Promise<CreatePageResult> {
@@ -459,8 +499,7 @@ export class SandboxBridge {
 			if (input.position !== undefined) {
 				outbound.position = input.position
 			}
-			console.debug("[notion-custom-sdk] outbound postMessage", outbound)
-			window.parent.postMessage(outbound, "*")
+			this.postToHost(outbound)
 		})
 	}
 
@@ -472,8 +511,7 @@ export class SandboxBridge {
 				requestId,
 				pageId,
 			}
-			console.debug("[notion-custom-sdk] outbound postMessage", outbound)
-			window.parent.postMessage(outbound, "*")
+			this.postToHost(outbound)
 		})
 	}
 
@@ -485,8 +523,7 @@ export class SandboxBridge {
 				requestId,
 				userId,
 			}
-			console.debug("[notion-custom-sdk] outbound postMessage", outbound)
-			window.parent.postMessage(outbound, "*")
+			this.postToHost(outbound)
 		})
 	}
 
@@ -499,8 +536,7 @@ export class SandboxBridge {
 				startCursor: input.startCursor,
 				pageSize: input.pageSize,
 			}
-			console.debug("[notion-custom-sdk] outbound postMessage", outbound)
-			window.parent.postMessage(outbound, "*")
+			this.postToHost(outbound)
 		})
 	}
 
@@ -539,8 +575,7 @@ export class SandboxBridge {
 			if (input.archived !== undefined) {
 				outbound.archived = input.archived
 			}
-			console.debug("[notion-custom-sdk] outbound postMessage", outbound)
-			window.parent.postMessage(outbound, "*")
+			this.postToHost(outbound)
 		})
 	}
 

package/src/bridge/sandboxClient.ts

@@ -17,7 +17,9 @@ import {
 } from "./hostState"
 import type { CustomBlockManifest } from "./manifest"
 import type { InitMessage } from "./messages/init"
-import { SandboxBridge } from "./SandboxBridge"
+import { type MessageLogEntry, SandboxBridge } from "./SandboxBridge"
+
+export type { MessageLogEntry }
 
 const bridge = new SandboxBridge()
 
@@ -57,6 +59,14 @@ export function postCustomBlockResize(height: number) {
 	bridge.postResize(height)
 }
 
+export function getMessageLog(): readonly MessageLogEntry[] {
+	return bridge.getMessageLog()
+}
+
+export function subscribeToMessageLog(listener: () => void) {
+	return bridge.subscribeToMessageLog(listener)
+}
+
 export function getUser(userId: NotionUserId): Promise<GetUserResult> {
 	return bridge.getUser(userId)
 }

package/src/index.ts

@@ -63,7 +63,12 @@ export type {
 	NotionPagePropertyValue,
 	NotionPagePropertyWriteMap,
 } from "./bridge/pages/page"
-export { pages } from "./bridge/sandboxClient"
+export type { MessageLogEntry } from "./bridge/sandboxClient"
+export {
+	getMessageLog,
+	pages,
+	subscribeToMessageLog,
+} from "./bridge/sandboxClient"
 export type { NotionTheme } from "./bridge/theme"
 export {
 	type CustomBlockInitial,

package/src/react.tsx

@@ -11,10 +11,12 @@ import type { CustomBlockHostState } from "./bridge/hostState"
 import {
 	getCustomBlockHostState,
 	getDataSourceQueryView,
+	getMessageLog,
 	postCustomBlockResize,
 	queryCustomBlockDataSource,
 	setMockCustomBlockState,
 	subscribeToCustomBlockHost,
+	subscribeToMessageLog,
 } from "./bridge/sandboxClient"
 import type { NotionTheme } from "./bridge/theme"
 import {
@@ -168,6 +170,17 @@ export function NotionCustomBlock({
 	useCustomBlockAutoResize({ enabled: autoResize })
 	const isStandalone = init.error instanceof NotInIframeError
 	const host = useCustomBlockHost()
+	const [debugOpen, setDebugOpen] = useState(false)
+
+	useEffect(() => {
+		const onKeyDown = (e: KeyboardEvent) => {
+			if (e.key === "\\") {
+				setDebugOpen(prev => !prev)
+			}
+		}
+		window.addEventListener("keydown", onKeyDown)
+		return () => window.removeEventListener("keydown", onKeyDown)
+	}, [])
 
 	useEffect(() => {
 		if (!isStandalone) {
@@ -212,14 +225,42 @@ export function NotionCustomBlock({
 					Notion host not detected — running in standalone preview. SDK hooks
 					return placeholder values until embedded in Notion.
 				</div>
-				{children}
+				{debugOpen ? <DebugMessageLog /> : children}
 			</>
 		)
 	}
 	if (!init.isLoaded) {
 		return <>{fallback}</>
 	}
-	return <>{children}</>
+	return <>{debugOpen ? <DebugMessageLog /> : children}</>
+}
+
+function DebugMessageLog() {
+	const log = useSyncExternalStore(subscribeToMessageLog, getMessageLog)
+	const text = log
+		.map(
+			entry =>
+				`[${entry.timestamp}] ${entry.direction}: ${JSON.stringify(entry.data)}`,
+		)
+		.join("\n")
+	return (
+		<pre data-testid="debug-message-log" style={DEBUG_PRE_STYLE}>
+			{text || "(no messages yet)"}
+		</pre>
+	)
+}
+
+const DEBUG_PRE_STYLE = {
+	margin: 0,
+	padding: "8px 12px",
+	fontSize: 12,
+	fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+	lineHeight: 1.5,
+	whiteSpace: "pre-wrap" as const,
+	wordBreak: "break-all" as const,
+	userSelect: "text" as const,
+	background: "#1e1e1e",
+	color: "#d4d4d4",
 }
 
 const STANDALONE_BANNER_STYLE = {