ncblock 0.0.1

package/dist/bridge/pages/page.js

@@ -0,0 +1,229 @@
+/**
+ * Notion page shapes exchanged over the custom block bridge.
+ *
+ * These mirror a narrow subset of Notion's public `POST /v1/pages` API, since that's the bridge
+ * shape the host delivers for messages like `createPageResult`.
+ */
+import * as v from "valibot";
+/**
+ * Parent reference accepted by `pages.create` / `pages.update` inputs.
+ *
+ * Mirrors the parent shape Notion's public `POST /v1/pages` API accepts: `page_id` for a
+ * page-parented child, `data_source_id` for a database row. `data_source_id` is the internal
+ * collection ID.
+ */
+export const notionPageParentInputSchema = v.variant("type", [
+    v.object({ type: v.literal("page_id"), page_id: v.string() }),
+    v.object({
+        type: v.literal("data_source_id"),
+        data_source_id: v.string(),
+    }),
+]);
+/**
+ * Parent reference returned on a `Page` object from the host.
+ *
+ * Wider than the input shape: in addition to `page_id` / `data_source_id`, this includes
+ * `workspace` (for top-level/team-rooted pages) and `block_id` (for pages nested under a
+ * non-page block, e.g. a column or toggle). This mirrors the parent variants the public API
+ * surfaces on `Page` responses.
+ */
+export const notionPageParentSchema = v.variant("type", [
+    v.object({ type: v.literal("page_id"), page_id: v.string() }),
+    v.object({
+        type: v.literal("data_source_id"),
+        data_source_id: v.string(),
+    }),
+    v.object({ type: v.literal("workspace"), workspace: v.literal(true) }),
+    v.object({ type: v.literal("block_id"), block_id: v.string() }),
+]);
+export const notionEmojiIconSchema = v.object({
+    type: v.literal("emoji"),
+    emoji: v.string(),
+});
+export const notionCustomEmojiIconSchema = v.object({
+    type: v.literal("custom_emoji"),
+    custom_emoji: v.object({
+        id: v.string(),
+        name: v.optional(v.string()),
+        url: v.optional(v.string()),
+    }),
+});
+export const notionExternalFileSchema = v.object({
+    type: v.literal("external"),
+    external: v.object({ url: v.string() }),
+});
+export const notionHostedFileSchema = v.object({
+    type: v.literal("file"),
+    file: v.object({
+        url: v.string(),
+        expiry_time: v.optional(v.string()),
+    }),
+});
+// TODO: Add file upload support.
+export const notionPageIconSchema = v.variant("type", [
+    notionEmojiIconSchema,
+    notionCustomEmojiIconSchema,
+    notionExternalFileSchema,
+    notionHostedFileSchema,
+]);
+export const notionPageCoverSchema = v.variant("type", [
+    notionExternalFileSchema,
+    notionHostedFileSchema,
+]);
+const nullableStringSchema = v.nullable(v.string());
+const notionRichTextItemSchema = v.record(v.string(), v.unknown());
+const notionSelectOptionInputSchema = v.union([
+    v.object({
+        id: v.string(),
+        name: v.optional(v.string()),
+        color: v.optional(v.string()),
+        description: v.optional(nullableStringSchema),
+    }),
+    v.object({
+        name: v.string(),
+        id: v.optional(v.string()),
+        color: v.optional(v.string()),
+        description: v.optional(nullableStringSchema),
+    }),
+]);
+const notionDateInputSchema = v.object({
+    start: v.string(),
+    end: v.optional(nullableStringSchema),
+    time_zone: v.optional(nullableStringSchema),
+});
+const notionUserInputSchema = v.union([
+    v.object({
+        object: v.optional(v.literal("user")),
+        id: v.string(),
+    }),
+    v.object({
+        object: v.literal("group"),
+        id: v.string(),
+        name: v.optional(nullableStringSchema),
+    }),
+]);
+const notionRelationInputSchema = v.object({ id: v.string() });
+const notionFileInputSchema = v.union([
+    v.object({
+        type: v.literal("external"),
+        name: v.string(),
+        external: v.object({ url: v.string() }),
+    }),
+    v.object({
+        type: v.literal("file"),
+        name: v.string(),
+        file: v.object({
+            url: v.string(),
+            expiry_time: v.optional(v.string()),
+        }),
+    }),
+]);
+const notionPlaceInputSchema = v.object({
+    lat: v.number(),
+    lon: v.number(),
+    name: v.optional(nullableStringSchema),
+    address: v.optional(nullableStringSchema),
+    aws_place_id: v.optional(nullableStringSchema),
+    google_place_id: v.optional(nullableStringSchema),
+});
+const pagePropertyBaseSchema = {
+    id: v.string(),
+};
+/**
+ * A page property value.
+ */
+export const notionPagePropertyValueSchema = v.variant("type", [
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("title"),
+        title: v.array(notionRichTextItemSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("rich_text"),
+        rich_text: v.array(notionRichTextItemSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("number"),
+        number: v.nullable(v.number()),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("url"),
+        url: nullableStringSchema,
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("email"),
+        email: nullableStringSchema,
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("phone_number"),
+        phone_number: nullableStringSchema,
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("checkbox"),
+        checkbox: v.boolean(),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("select"),
+        select: v.nullable(notionSelectOptionInputSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("status"),
+        status: v.nullable(notionSelectOptionInputSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("multi_select"),
+        multi_select: v.array(notionSelectOptionInputSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("date"),
+        date: v.nullable(notionDateInputSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("people"),
+        people: v.array(notionUserInputSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("relation"),
+        has_more: v.optional(v.boolean()),
+        relation: v.array(notionRelationInputSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("files"),
+        files: v.array(notionFileInputSchema),
+    }),
+    v.object({
+        ...pagePropertyBaseSchema,
+        type: v.literal("place"),
+        place: v.nullable(notionPlaceInputSchema),
+    }),
+]);
+export const notionPagePropertyWriteMapSchema = v.record(v.string(), notionPagePropertyValueSchema);
+/**
+ * The `Page` object returned in `createPageResult` messages.
+ */
+export const notionPageSchema = v.object({
+    object: v.literal("page"),
+    id: v.string(),
+    parent: notionPageParentSchema,
+    properties: notionPagePropertyWriteMapSchema,
+    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()),
+    in_trash: v.optional(v.boolean()),
+});

package/dist/bridge/pendingRequests.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tracks one-shot request/response pairs over the `postMessage` bridge. Each `allocate` reserves a
+ * unique `requestId` and stores its resolver. `resolve` finds the pending resolver by `requestId`
+ * and calls it, then removes the entry so the same `requestId` cannot be resolved twice.
+ */
+export declare class PendingRequests<T> {
+    private readonly prefix;
+    private nextId;
+    private readonly entries;
+    constructor(prefix: string);
+    allocate(resolver: (value: T) => void): string;
+    resolve(requestId: string, value: T): boolean;
+}
+//# sourceMappingURL=pendingRequests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pendingRequests.d.ts","sourceRoot":"","sources":["../../bridge/pendingRequests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,eAAe,CAAC,CAAC;IAIjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;gBAEnC,MAAM,EAAE,MAAM;IAE3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM;IAO9C,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO;CAS7C"}

package/dist/bridge/pendingRequests.js

@@ -0,0 +1,27 @@
+/**
+ * Tracks one-shot request/response pairs over the `postMessage` bridge. Each `allocate` reserves a
+ * unique `requestId` and stores its resolver. `resolve` finds the pending resolver by `requestId`
+ * and calls it, then removes the entry so the same `requestId` cannot be resolved twice.
+ */
+export class PendingRequests {
+    constructor(prefix) {
+        this.prefix = prefix;
+        this.nextId = 1;
+        this.entries = new Map();
+    }
+    allocate(resolver) {
+        const requestId = `${this.prefix}-${this.nextId}`;
+        this.nextId += 1;
+        this.entries.set(requestId, resolver);
+        return requestId;
+    }
+    resolve(requestId, value) {
+        const resolver = this.entries.get(requestId);
+        if (resolver === undefined) {
+            return false;
+        }
+        this.entries.delete(requestId);
+        resolver(value);
+        return true;
+    }
+}

package/dist/bridge/theme.d.ts

@@ -0,0 +1,4 @@
+import * as v from "valibot";
+export declare const notionThemeSchema: v.PicklistSchema<["light", "dark"], undefined>;
+export type NotionTheme = v.InferOutput<typeof notionThemeSchema>;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../bridge/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,iBAAiB,gDAAgC,CAAA;AAE9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA"}

package/dist/bridge/theme.js

@@ -0,0 +1,2 @@
+import * as v from "valibot";
+export const notionThemeSchema = v.picklist(["light", "dark"]);

package/dist/host.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Host-side entrypoint for `ncblock/host`.
+ *
+ * Re-exports the bridge valibot schemas, data-source binding types, and the
+ * context parser so anything implementing the host side of the bridge — the
+ * dev shell today, anything else later — can validate inbound sandbox traffic
+ * and shape outbound traffic without reaching into private `bridge/*` paths.
+ *
+ * Nothing here is intended for use inside a sandboxed custom block; that
+ * surface lives in the default `ncblock` entrypoint.
+ */
+export { notionCustomBlockContextSchema, parseNotionCustomBlockContext, } from "./bridge/context";
+export type { NotionDataSourceBinding, NotionDataSourceBindings, } from "./bridge/dataSources/dataSource";
+export { notionDataSourceBindingSchema, notionDataSourceBindingsSchema, } from "./bridge/dataSources/dataSource";
+export type { NotionDataSourcePageBridge } from "./bridge/dataSources/dataSourcePage";
+export { notionDataSourcePageBridgeSchema } from "./bridge/dataSources/dataSourcePage";
+export { readIncomingType } from "./bridge/incomingType";
+export type { ContextChangedMessage } from "./bridge/messages/contextChanged";
+export { contextChangedMessageSchema } from "./bridge/messages/contextChanged";
+export type { CreatePageMessage } from "./bridge/messages/createPage";
+export { createPageMessageSchema } from "./bridge/messages/createPage";
+export type { CreatePageResultMessage } from "./bridge/messages/createPageResult";
+export { createPageResultMessageSchema } from "./bridge/messages/createPageResult";
+export type { DataSourcesChangedMessage } from "./bridge/messages/dataSourcesChanged";
+export { dataSourcesChangedMessageSchema } from "./bridge/messages/dataSourcesChanged";
+export type { GetPageMessage, GetPageResultMessage, } from "./bridge/messages/getPage";
+export { getPageMessageSchema, getPageResultMessageSchema, } from "./bridge/messages/getPage";
+export type { HostToSandboxMessage } from "./bridge/messages/hostToSandbox";
+export { hostToSandboxMessageSchema } from "./bridge/messages/hostToSandbox";
+export type { InitMessage } from "./bridge/messages/init";
+export { initMessageSchema } from "./bridge/messages/init";
+export type { InvalidHostMessage } from "./bridge/messages/invalidHostMessage";
+export { invalidHostMessageSchema } from "./bridge/messages/invalidHostMessage";
+export type { InvalidSandboxMessage } from "./bridge/messages/invalidSandboxMessage";
+export { invalidSandboxMessageSchema } from "./bridge/messages/invalidSandboxMessage";
+export type { QueryDataSourceMessage } from "./bridge/messages/queryDataSource";
+export { queryDataSourceMessageSchema } from "./bridge/messages/queryDataSource";
+export type { QueryDataSourceResultMessage } from "./bridge/messages/queryDataSourceResult";
+export { queryDataSourceResultMessageSchema } from "./bridge/messages/queryDataSourceResult";
+export type { ReadyMessage } from "./bridge/messages/ready";
+export { readyMessageSchema } from "./bridge/messages/ready";
+export type { ResizeMessage } from "./bridge/messages/resize";
+export { resizeMessageSchema } from "./bridge/messages/resize";
+export type { SandboxToHostMessage } from "./bridge/messages/sandboxToHost";
+export { sandboxToHostMessageSchema } from "./bridge/messages/sandboxToHost";
+export type { ThemeChangedMessage } from "./bridge/messages/themeChanged";
+export { themeChangedMessageSchema } from "./bridge/messages/themeChanged";
+export type { UpdatePageMessage } from "./bridge/messages/updatePage";
+export { updatePageMessageSchema } from "./bridge/messages/updatePage";
+export type { UpdatePageResultMessage } from "./bridge/messages/updatePageResult";
+export { updatePageResultMessageSchema } from "./bridge/messages/updatePageResult";
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACN,8BAA8B,EAC9B,6BAA6B,GAC7B,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACX,uBAAuB,EACvB,wBAAwB,GACxB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACN,6BAA6B,EAC7B,8BAA8B,GAC9B,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAA;AACrF,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAC9E,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AACrF,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AACtF,YAAY,EACX,cAAc,EACd,oBAAoB,GACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACN,oBAAoB,EACpB,0BAA0B,GAC1B,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,YAAY,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAA;AACrF,YAAY,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAA;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AAChF,YAAY,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAA;AAC3F,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAA;AAC5F,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA"}

package/dist/host.js

@@ -0,0 +1,32 @@
+/**
+ * Host-side entrypoint for `ncblock/host`.
+ *
+ * Re-exports the bridge valibot schemas, data-source binding types, and the
+ * context parser so anything implementing the host side of the bridge — the
+ * dev shell today, anything else later — can validate inbound sandbox traffic
+ * and shape outbound traffic without reaching into private `bridge/*` paths.
+ *
+ * Nothing here is intended for use inside a sandboxed custom block; that
+ * surface lives in the default `ncblock` entrypoint.
+ */
+export { notionCustomBlockContextSchema, parseNotionCustomBlockContext, } from "./bridge/context";
+export { notionDataSourceBindingSchema, notionDataSourceBindingsSchema, } from "./bridge/dataSources/dataSource";
+export { notionDataSourcePageBridgeSchema } from "./bridge/dataSources/dataSourcePage";
+export { readIncomingType } from "./bridge/incomingType";
+export { contextChangedMessageSchema } from "./bridge/messages/contextChanged";
+export { createPageMessageSchema } from "./bridge/messages/createPage";
+export { createPageResultMessageSchema } from "./bridge/messages/createPageResult";
+export { dataSourcesChangedMessageSchema } from "./bridge/messages/dataSourcesChanged";
+export { getPageMessageSchema, getPageResultMessageSchema, } from "./bridge/messages/getPage";
+export { hostToSandboxMessageSchema } from "./bridge/messages/hostToSandbox";
+export { initMessageSchema } from "./bridge/messages/init";
+export { invalidHostMessageSchema } from "./bridge/messages/invalidHostMessage";
+export { invalidSandboxMessageSchema } from "./bridge/messages/invalidSandboxMessage";
+export { queryDataSourceMessageSchema } from "./bridge/messages/queryDataSource";
+export { queryDataSourceResultMessageSchema } from "./bridge/messages/queryDataSourceResult";
+export { readyMessageSchema } from "./bridge/messages/ready";
+export { resizeMessageSchema } from "./bridge/messages/resize";
+export { sandboxToHostMessageSchema } from "./bridge/messages/sandboxToHost";
+export { themeChangedMessageSchema } from "./bridge/messages/themeChanged";
+export { updatePageMessageSchema } from "./bridge/messages/updatePage";
+export { updatePageResultMessageSchema } from "./bridge/messages/updatePageResult";

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Public entrypoint for `ncblock`.
+ *
+ * Everything re-exported here is part of the SDK's public API. Anything not
+ * re-exported is internal and may change without notice. Consumers should
+ * import exclusively from `ncblock`, never from deeper paths,
+ * so internal files (e.g. `./bridge/*`) can be refactored without breaking
+ * downstream code.
+ */
+export type { NotionCustomBlockContext } from "./bridge/context";
+export type { NotionCollectionSchema, NotionDataSource, } from "./bridge/dataSources/dataSource";
+export type { NotionDataSourcePage, NotionDataSourcePageUpdateInput, NotionDataSourcePageUpdateResult, } from "./bridge/dataSources/dataSourcePage";
+export type { NotionDataSourceValue } from "./bridge/dataSources/dataSourceValue";
+export type { NotionDate, NotionDateRange, NotionDateReminder, NotionDateTime, NotionDateTimeRange, NotionDateTimeReminder, NotionDateValue, NotionNoReminder, NotionTimeReminder, } from "./bridge/dataSources/dateValue";
+export type { NotionBuiltinPropertyId, NotionDualProperty, NotionPropertyColor, NotionPropertyOption, NotionPropertySchema, NotionPropertyType, NotionStatusGroup, } from "./bridge/dataSources/propertySchema";
+export { NOTION_BUILTIN_PROPERTY_IDS, NOTION_PROPERTY_TYPES, } from "./bridge/dataSources/propertySchema";
+export type { NotionRecordPointer } from "./bridge/dataSources/recordPointer";
+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 type { NotionTheme } from "./bridge/theme";
+export { type CustomBlockInitial, type InitCustomBlockOptions, initCustomBlock, NotInIframeError, } from "./notion";
+export { pages } from "./pages";
+export { NotionCustomBlock, type NotionCustomBlockProps, type UseCustomBlockInitResult, useCustomBlockAutoResize, useCustomBlockContext, useCustomBlockInit, useDataSource, useDataSourceDefinitions, useTheme, } from "./react";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../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,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,eAAe,EACf,gBAAgB,GAChB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,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"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * Public entrypoint for `ncblock`.
+ *
+ * Everything re-exported here is part of the SDK's public API. Anything not
+ * re-exported is internal and may change without notice. Consumers should
+ * import exclusively from `ncblock`, never from deeper paths,
+ * so internal files (e.g. `./bridge/*`) can be refactored without breaking
+ * downstream code.
+ */
+export { NOTION_BUILTIN_PROPERTY_IDS, NOTION_PROPERTY_TYPES, } from "./bridge/dataSources/propertySchema";
+export { initCustomBlock, NotInIframeError, } from "./notion";
+export { pages } from "./pages";
+export { NotionCustomBlock, useCustomBlockAutoResize, useCustomBlockContext, useCustomBlockInit, useDataSource, useDataSourceDefinitions, useTheme, } from "./react";
+export * from "./types";

package/dist/notion.d.ts

@@ -0,0 +1,113 @@
+import type { NotionCustomBlockContext } from "./bridge/context";
+import type { NotionDataSource } from "./bridge/dataSources/dataSource";
+import type { NotionDataSourcePage, NotionDataSourcePageBridge } from "./bridge/dataSources/dataSourcePage";
+import type { NotionPropertySchema } from "./bridge/dataSources/propertySchema";
+import type { InitMessage } from "./bridge/messages/init";
+import type { NotionTheme } from "./bridge/theme";
+import type { CreatePageInput, CreatePageResult, GetPageResult, NotionPageId, UpdatePageInput, UpdatePageResult } from "./types";
+type DataSourceQueryState = {
+    /** Latest pages from the host as parsed from the bridge. `propertiesByKey` is derived lazily. */
+    items: NotionDataSourcePageBridge[];
+    isLoading: boolean;
+    hasMore: boolean;
+    error?: string;
+    latestRequestId?: string;
+};
+export type CustomBlockHostState = UninitializedHostState | InitializedHostState;
+type UninitializedHostState = {
+    status: "uninitialized";
+    theme: NotionTheme;
+};
+type InitializedHostState = {
+    status: "initialized";
+    theme: NotionTheme;
+    context: NotionCustomBlockContext;
+    dataSources: NotionDataSource[];
+    dataSourceState: Record<string, DataSourceQueryState>;
+};
+export declare function subscribeToCustomBlockHost(listener: () => void): () => boolean;
+export declare function getCustomBlockHostState(): CustomBlockHostState;
+export declare function queryCustomBlockDataSource(key: string, limit: number): void;
+/**
+ * Apply an `init` payload to the bridge directly, bypassing the postMessage
+ * handshake. Used by the React provider when it needs to seed placeholder
+ * state (e.g. the standalone preview fallback when not embedded in Notion).
+ * The bridge applies the payload through the same code path as a real host.
+ */
+export declare function setMockCustomBlockState(message: InitMessage): void;
+/**
+ * Resolved value of {@link initCustomBlock} — the host's first `init` payload.
+ * `theme`, `context`, and `dataSources` are live values at the moment of init;
+ * subscribe via the React hooks (or `subscribeToCustomBlockHost`) to stay
+ * updated as the host pushes `themeChanged` / `contextChanged` /
+ * `dataSourcesChanged` messages.
+ */
+export type CustomBlockInitial = {
+    theme: NotionTheme;
+    context: NotionCustomBlockContext;
+    dataSources: NotionDataSource[];
+};
+/**
+ * Thrown by {@link initCustomBlock} when the SDK is loaded in a top-level
+ * window (no parent frame) — `postMessage` would just hit the same window and
+ * the handshake can never complete. `<NotionCustomBlock>` catches this
+ * specifically and falls back to a standalone preview with a warning banner;
+ * direct callers can `instanceof` it to apply their own policy.
+ */
+export declare class NotInIframeError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Options for {@link initCustomBlock}.
+ */
+export type InitCustomBlockOptions = {
+    /**
+     * How long to wait for the host's `init` response before rejecting with a
+     * `TimeoutError` DOMException. Defaults to 2000 ms — short enough that a
+     * misconfigured embed surfaces quickly, long enough to absorb a real host's
+     * worst-case init latency.
+     */
+    timeoutMs?: number;
+};
+/**
+ * Performs the SDK ↔ host handshake: loads `custom_blocks.json`, posts
+ * `ready`, then awaits the host's first `init` message. Resolves with that
+ * payload; rejects with a
+ * `TimeoutError` if the host doesn't respond inside `timeoutMs`.
+ *
+ * Idempotent: subsequent calls return the same promise as the first and
+ * ignore any new options. Mount your React tree (or call any SDK hook /
+ * `subscribeToCustomBlockHost`) only after the returned promise resolves.
+ *
+ * @example
+ * // src/index.tsx
+ * const initial = await initCustomBlock()
+ * console.log(initial.theme, initial.context.customBlockId)
+ * ReactDOM.createRoot(root).render(<App />)
+ */
+export declare function initCustomBlock(opts?: InitCustomBlockOptions): Promise<CustomBlockInitial>;
+/**
+ * Resolved page + schema views for a single data source, keyed by raw property
+ * ID and by user-defined key. Re-derived from `propertyIdsByKey` on every read so
+ * renames don't require a re-query.
+ */
+export type DataSourceQueryView = {
+    items: NotionDataSourcePage[];
+    collectionSchema?: NotionDataSource["collectionSchema"];
+    propertySchemasById: {
+        [propertyId: string]: NotionPropertySchema;
+    };
+    propertySchemasByKey: {
+        [key: string]: NotionPropertySchema | undefined;
+    };
+    isLoading: boolean;
+    hasMore: boolean;
+    error?: string;
+};
+export declare function getDataSourceQueryView(hostState: CustomBlockHostState, key: string): DataSourceQueryView;
+export declare function createPage(input: CreatePageInput): Promise<CreatePageResult>;
+export declare function getPage(pageId: NotionPageId): Promise<GetPageResult>;
+export declare function updatePage(input: UpdatePageInput): Promise<UpdatePageResult>;
+export declare function postCustomBlockResize(height: number): void;
+export {};
+//# sourceMappingURL=notion.d.ts.map

package/dist/notion.d.ts.map

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