@notionhq/custom-blocks 0.0.58

package/dist/bridge/hostState.d.ts

@@ -0,0 +1,65 @@
+import type { NotionDataSource } from "./dataSources/dataSource.js";
+import type { NotionDataSourcePage, NotionDataSourcePageBridge, NotionDataSourcePageUpdateInput, NotionDataSourcePageUpdateResult } from "./dataSources/dataSourcePage.js";
+import type { NotionPropertySchema } from "./dataSources/propertySchema.js";
+import type { NotionBlockId } from "./ids.js";
+import type { CustomBlockQueryDataSourceErrorInfo } from "./messages/queryDataSourceResult.js";
+import type { CustomBlockPage, NotionPageId } from "./pages/page.js";
+import type { NotionParent } from "./parent.js";
+import type { NotionTheme } from "./theme.js";
+import type { NotionUser } from "./users/user.js";
+export type CustomBlockHostState = UninitializedHostState | InitializedHostState;
+export type UninitializedHostState = {
+    status: "uninitialized";
+    theme: NotionTheme;
+};
+export type InitializedHostState = {
+    status: "initialized";
+    theme: NotionTheme;
+    blockId: NotionBlockId;
+    parent: NotionParent;
+    page: CustomBlockPage;
+    currentUser: NotionUser;
+    dataSources: NotionDataSource[];
+    dataSourceState: Record<string, DataSourceQueryState>;
+};
+export type DataSourceQueryState = {
+    /** Latest pages from the host as parsed from the bridge. `propertiesByKey` is derived lazily. */
+    items: NotionDataSourcePageBridge[];
+    isLoading: boolean;
+    hasMore: boolean;
+    error?: CustomBlockQueryDataSourceErrorInfo;
+    latestRequestId?: string;
+    latestSnapshotId?: string;
+    latestLimit?: number;
+};
+export declare function createEmptyDataSourceQueryState(): DataSourceQueryState;
+/**
+ * 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?: CustomBlockQueryDataSourceErrorInfo;
+};
+/**
+ * Per-row callback that resolves property keys against the data source and forwards the
+ * resulting write to the bridge. Injected by callers (typically the SDK singleton in `init.ts`)
+ * so this module stays free of bridge-instance dependencies.
+ */
+export type UpdateDataSourcePageFn = (args: {
+    dataSource: NotionDataSource;
+    pageId: NotionPageId;
+    input: NotionDataSourcePageUpdateInput;
+}) => Promise<NotionDataSourcePageUpdateResult>;
+export declare function getDataSourceQueryView(hostState: CustomBlockHostState, key: string, updateDataSourcePage: UpdateDataSourcePageFn): DataSourceQueryView;
+//# sourceMappingURL=hostState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostState.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/bridge/hostState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,EAChC,MAAM,iCAAiC,CAAA;AAExC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,qCAAqC,CAAA;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,oBAAoB,CAAA;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,WAAW,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,WAAW,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;CACrD,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,iGAAiG;IACjG,KAAK,EAAE,0BAA0B,EAAE,CAAA;IACnC,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,mCAAmC,CAAA;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAgB,+BAA+B,IAAI,oBAAoB,CAMtE;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,oBAAoB,EAAE,CAAA;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAA;IACvD,mBAAmB,EAAE;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAAA;KAAE,CAAA;IACnE,oBAAoB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAAA;KAAE,CAAA;IACzE,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,mCAAmC,CAAA;CAC3C,CAAA;AAUD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,+BAA+B,CAAA;CACtC,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAA;AAE/C,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,oBAAoB,EAC/B,GAAG,EAAE,MAAM,EACX,oBAAoB,EAAE,sBAAsB,GAC1C,mBAAmB,CA8DrB"}

package/dist/bridge/hostState.js

@@ -0,0 +1,65 @@
+export function createEmptyDataSourceQueryState() {
+    return {
+        items: [],
+        isLoading: false,
+        hasMore: false,
+    };
+}
+const EMPTY_QUERY_VIEW = {
+    items: [],
+    propertySchemasById: {},
+    propertySchemasByKey: {},
+    isLoading: false,
+    hasMore: false,
+};
+export function getDataSourceQueryView(hostState, key, updateDataSourcePage) {
+    if (hostState.status !== "initialized") {
+        return EMPTY_QUERY_VIEW;
+    }
+    const dataSource = hostState.dataSources.find(entry => entry.key === key);
+    const queryState = hostState.dataSourceState[key] ?? createEmptyDataSourceQueryState();
+    if (dataSource === undefined) {
+        return {
+            items: [],
+            collectionSchema: undefined,
+            propertySchemasById: {},
+            propertySchemasByKey: {},
+            isLoading: queryState.isLoading,
+            hasMore: queryState.hasMore,
+            error: queryState.error,
+        };
+    }
+    const propertyIdsByKey = dataSource.propertyIdsByKey;
+    const propertySchemasById = dataSource.propertySchemasById;
+    const resolvedItems = queryState.items.map(entry => {
+        const propertiesByKey = {};
+        for (const [key, propertyId] of Object.entries(propertyIdsByKey)) {
+            propertiesByKey[key] =
+                propertyId === undefined ? undefined : entry.propertiesById[propertyId];
+        }
+        return {
+            id: entry.id,
+            propertiesById: entry.propertiesById,
+            propertiesByKey,
+            update: input => updateDataSourcePage({
+                dataSource,
+                pageId: entry.id,
+                input,
+            }),
+        };
+    });
+    const propertySchemasByKey = {};
+    for (const [key, propertyId] of Object.entries(propertyIdsByKey)) {
+        propertySchemasByKey[key] =
+            propertyId === undefined ? undefined : propertySchemasById[propertyId];
+    }
+    return {
+        items: resolvedItems,
+        collectionSchema: dataSource.collectionSchema,
+        propertySchemasById,
+        propertySchemasByKey,
+        isLoading: queryState.isLoading,
+        hasMore: queryState.hasMore,
+        error: queryState.error,
+    };
+}

package/dist/bridge/ids.d.ts

@@ -0,0 +1,39 @@
+import * as v from "valibot";
+declare const notionDataSourceIdBrand: unique symbol;
+declare const notionBlockIdBrand: unique symbol;
+declare const notionPageIdBrand: unique symbol;
+declare const notionSpaceIdBrand: unique symbol;
+/**
+ * Branded Notion block ID. Host payloads and SDK APIs use plain strings at runtime,
+ * but the brand keeps block IDs from being accidentally mixed with other IDs in TypeScript.
+ */
+export type NotionBlockId = string & {
+    readonly [notionBlockIdBrand]: "NotionBlockId";
+};
+export declare const notionBlockIdSchema: v.CustomSchema<NotionBlockId, v.ErrorMessage<v.CustomIssue> | undefined>;
+/**
+ * Branded Notion data source ID. Host payloads and SDK APIs use plain strings at runtime,
+ * but the brand keeps data source IDs from being accidentally mixed with other IDs in TypeScript.
+ */
+export type NotionDataSourceId = string & {
+    readonly [notionDataSourceIdBrand]: "NotionDataSourceId";
+};
+export declare const notionDataSourceIdSchema: v.CustomSchema<NotionDataSourceId, v.ErrorMessage<v.CustomIssue> | undefined>;
+/**
+ * Branded Notion page ID. Host payloads and SDK APIs use plain strings at runtime,
+ * but the brand keeps page IDs from being accidentally mixed with other IDs in TypeScript.
+ */
+export type NotionPageId = string & {
+    readonly [notionPageIdBrand]: "NotionPageId";
+};
+export declare const notionPageIdSchema: v.CustomSchema<NotionPageId, v.ErrorMessage<v.CustomIssue> | undefined>;
+/**
+ * Branded Notion workspace/space ID. Host payloads and SDK APIs use plain strings at runtime,
+ * but the brand keeps space IDs from being accidentally mixed with other IDs in TypeScript.
+ */
+export type NotionSpaceId = string & {
+    readonly [notionSpaceIdBrand]: "NotionSpaceId";
+};
+export declare const notionSpaceIdSchema: v.CustomSchema<NotionSpaceId, v.ErrorMessage<v.CustomIssue> | undefined>;
+export {};
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/bridge/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,CAAC,MAAM,uBAAuB,EAAE,OAAO,MAAM,CAAA;AACpD,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAA;AAC/C,OAAO,CAAC,MAAM,iBAAiB,EAAE,OAAO,MAAM,CAAA;AAC9C,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IACpC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,eAAe,CAAA;CAC9C,CAAA;AAED,eAAO,MAAM,mBAAmB,0EAG/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IACzC,QAAQ,CAAC,CAAC,uBAAuB,CAAC,EAAE,oBAAoB,CAAA;CACxD,CAAA;AAED,eAAO,MAAM,wBAAwB,+EAGpC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,cAAc,CAAA;CAC5C,CAAA;AAED,eAAO,MAAM,kBAAkB,yEAG9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IACpC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,eAAe,CAAA;CAC9C,CAAA;AAED,eAAO,MAAM,mBAAmB,0EAG/B,CAAA"}

package/dist/bridge/ids.js

@@ -0,0 +1,5 @@
+import * as v from "valibot";
+export const notionBlockIdSchema = v.custom(value => typeof value === "string", "Expected a Notion block ID");
+export const notionDataSourceIdSchema = v.custom(value => typeof value === "string", "Expected a Notion data source ID");
+export const notionPageIdSchema = v.custom(value => typeof value === "string", "Expected a Notion page ID");
+export const notionSpaceIdSchema = v.custom(value => typeof value === "string", "Expected a Notion space ID");

package/dist/bridge/incomingType.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reads the `type` field off an inbound bridge message, if any.
+ *
+ * Used by both sides of the bridge after the canonical message schema rejects a payload. We still
+ * want to know what type the sender claimed to be sending so we can (a) avoid NACK loops on
+ * `invalidHostMessage` / `invalidSandboxMessage` and (b) include the type in the failure reason
+ * for debugging.
+ */
+export declare function readIncomingType(data: unknown): string | undefined;
+//# sourceMappingURL=incomingType.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"incomingType.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/bridge/incomingType.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUlE"}

package/dist/bridge/incomingType.js

@@ -0,0 +1,17 @@
+/**
+ * Reads the `type` field off an inbound bridge message, if any.
+ *
+ * Used by both sides of the bridge after the canonical message schema rejects a payload. We still
+ * want to know what type the sender claimed to be sending so we can (a) avoid NACK loops on
+ * `invalidHostMessage` / `invalidSandboxMessage` and (b) include the type in the failure reason
+ * for debugging.
+ */
+export function readIncomingType(data) {
+    if (typeof data === "object" &&
+        data !== null &&
+        "type" in data &&
+        typeof data.type === "string") {
+        return data.type;
+    }
+    return undefined;
+}

package/dist/bridge/loadManifest.d.ts

@@ -0,0 +1,25 @@
+import * as v from "valibot";
+import { type CustomBlockManifest } from "./manifest.js";
+export declare const customBlockReadyErrorCodeSchema: v.StringSchema<undefined>;
+export type CustomBlockReadyErrorCode = "manifest_unavailable" | "manifest_invalid" | (string & {});
+export declare const customBlockReadyErrorSchema: v.ObjectSchema<{
+    readonly code: v.StringSchema<undefined>;
+    readonly message: v.StringSchema<undefined>;
+}, undefined>;
+export type CustomBlockReadyError = v.InferOutput<typeof customBlockReadyErrorSchema>;
+export type ManifestLoadResult = {
+    manifest: CustomBlockManifest | null;
+    error?: undefined;
+} | {
+    manifest: null;
+    error: CustomBlockReadyError;
+};
+/**
+ * Attempts to load a `custom_blocks.json` manifest co-located with the bundle.
+ * A missing manifest means the block has no declared data requirements.
+ * Other failures return a structured error so the host can reject the manifest.
+ * The SDK validates the manifest locally for author feedback; the host still
+ * validates the ready message as the iframe trust boundary.
+ */
+export declare function loadManifest(): Promise<ManifestLoadResult>;
+//# sourceMappingURL=loadManifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadManifest.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/bridge/loadManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,mBAAmB,EAAkB,MAAM,eAAe,CAAA;AAMxE,eAAO,MAAM,+BAA+B,2BAAa,CAAA;AAEzD,MAAM,MAAM,yBAAyB,GAClC,sBAAsB,GACtB,kBAAkB,GAClB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEhB,eAAO,MAAM,2BAA2B;;;aAGtC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAChD,OAAO,2BAA2B,CAClC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAC3B;IACA,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACpC,KAAK,CAAC,EAAE,SAAS,CAAA;CAChB,GACD;IACA,QAAQ,EAAE,IAAI,CAAA;IACd,KAAK,EAAE,qBAAqB,CAAA;CAC3B,CAAA;AAEJ;;;;;;GAMG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAgDhE"}

package/dist/bridge/loadManifest.js

@@ -0,0 +1,68 @@
+import * as v from "valibot";
+import { manifestSchema } from "./manifest.js";
+const MANIFEST_URL = "custom_blocks.json";
+// The schema accepts any string code. The type lists known codes for
+// autocomplete, with an open string fallback for newer senders.
+export const customBlockReadyErrorCodeSchema = v.string();
+export const customBlockReadyErrorSchema = v.object({
+    code: customBlockReadyErrorCodeSchema,
+    message: v.string(),
+});
+/**
+ * Attempts to load a `custom_blocks.json` manifest co-located with the bundle.
+ * A missing manifest means the block has no declared data requirements.
+ * Other failures return a structured error so the host can reject the manifest.
+ * The SDK validates the manifest locally for author feedback; the host still
+ * validates the ready message as the iframe trust boundary.
+ */
+export async function loadManifest() {
+    if (typeof fetch !== "function") {
+        const message = `No fetch API available; cannot load ${MANIFEST_URL}.`;
+        console.warn(`[notion-custom-sdk] ${message}`);
+        return {
+            manifest: null,
+            error: { code: "manifest_unavailable", message },
+        };
+    }
+    let response;
+    try {
+        response = await fetch(MANIFEST_URL, { credentials: "omit" });
+    }
+    catch (error) {
+        const message = `Could not fetch ${MANIFEST_URL}.`;
+        console.warn(`[notion-custom-sdk] ${message}`, error);
+        return {
+            manifest: null,
+            error: { code: "manifest_unavailable", message },
+        };
+    }
+    if (response.status === 404) {
+        const message = `No manifest found at ${MANIFEST_URL} (status ${response.status}).`;
+        console.warn(`[notion-custom-sdk] ${message}`);
+        return { manifest: null };
+    }
+    if (!response.ok) {
+        const message = `Could not fetch ${MANIFEST_URL} (status ${response.status}).`;
+        console.warn(`[notion-custom-sdk] ${message}`);
+        return {
+            manifest: null,
+            error: { code: "manifest_unavailable", message },
+        };
+    }
+    let json;
+    try {
+        json = await response.json();
+    }
+    catch (error) {
+        const message = `Manifest at ${MANIFEST_URL} was not valid JSON.`;
+        console.warn(`[notion-custom-sdk] ${message}`, error);
+        return { manifest: null, error: { code: "manifest_invalid", message } };
+    }
+    const parsed = v.safeParse(manifestSchema, json);
+    if (!parsed.success) {
+        const message = `Manifest at ${MANIFEST_URL} did not match schema.`;
+        console.warn(`[notion-custom-sdk] ${message}`, parsed.issues);
+        return { manifest: null, error: { code: "manifest_invalid", message } };
+    }
+    return { manifest: parsed.output };
+}

package/dist/bridge/manifest.d.ts

@@ -0,0 +1,66 @@
+import * as v from "valibot";
+/**
+ * User-authored manifest declaring the data sources the custom block expects.
+ * Lives at `custom_blocks.json` in the project root and is forwarded to the host with
+ * the bridge `ready` message so the host can pre-bind data sources, surface
+ * configuration UI, etc. The `notionCustomBlock` Vite plugin from
+ * `@notionhq/custom-blocks/vite` wires the JSON file into the dev server and
+ * the build output.
+ */
+/**
+ * Decorative icon attached to a manifest data source. Mirrors the
+ * `emoji` / `external` icon variants the public Notion API uses, so the host
+ * can render a recognizable affordance next to the slot in setup UI.
+ */
+export declare const manifestIconSchema: 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>;
+export type ManifestIcon = v.InferOutput<typeof manifestIconSchema>;
+export declare const manifestPropertySchema: 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>;
+export type ManifestProperty = v.InferOutput<typeof manifestPropertySchema>;
+export declare const manifestDataSourceSchema: 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>;
+export type ManifestDataSource = v.InferOutput<typeof manifestDataSourceSchema>;
+export declare const manifestSchema: v.ObjectSchema<{
+    readonly version: v.LiteralSchema<1, undefined>;
+    readonly dataSources: 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>;
+}, undefined>;
+export type CustomBlockManifest = v.InferOutput<typeof manifestSchema>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/bridge/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B;;;;;;;GAOG;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;0BAS7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,eAAO,MAAM,sBAAsB;;;;aAIjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;aAKnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;aAGzB,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/dist/bridge/manifest.js

@@ -0,0 +1,40 @@
+import * as v from "valibot";
+import { notionPropertyTypeSchema } from "./dataSources/propertySchema.js";
+/**
+ * User-authored manifest declaring the data sources the custom block expects.
+ * Lives at `custom_blocks.json` in the project root and is forwarded to the host with
+ * the bridge `ready` message so the host can pre-bind data sources, surface
+ * configuration UI, etc. The `notionCustomBlock` Vite plugin from
+ * `@notionhq/custom-blocks/vite` wires the JSON file into the dev server and
+ * the build output.
+ */
+/**
+ * Decorative icon attached to a manifest data source. Mirrors the
+ * `emoji` / `external` icon variants the public Notion API uses, so the host
+ * can render a recognizable affordance next to the slot in setup UI.
+ */
+export const manifestIconSchema = v.variant("type", [
+    v.object({
+        type: v.literal("emoji"),
+        emoji: v.string(),
+    }),
+    v.object({
+        type: v.literal("external"),
+        url: v.string(),
+    }),
+]);
+export const manifestPropertySchema = v.object({
+    name: v.string(),
+    description: v.optional(v.string()),
+    type: notionPropertyTypeSchema,
+});
+export const manifestDataSourceSchema = v.object({
+    name: v.string(),
+    description: v.optional(v.string()),
+    icon: v.optional(manifestIconSchema),
+    properties: v.optional(v.record(v.string(), manifestPropertySchema), {}),
+});
+export const manifestSchema = v.object({
+    version: v.literal(1),
+    dataSources: v.record(v.string(), manifestDataSourceSchema),
+});