@notionhq/custom-blocks-host 0.0.1

package/dist/protocol/dataSources/dataSource.js

@@ -0,0 +1,37 @@
+import * as v from "valibot";
+import { notionDataSourceIdSchema, notionSpaceIdSchema } from "../ids.js";
+import { notionPropertySchemaSchema } from "./propertySchema.js";
+const collectionPointerValidator = v.object({
+    id: notionDataSourceIdSchema,
+    table: v.string(),
+    spaceId: v.optional(notionSpaceIdSchema),
+});
+export const notionCollectionSchemaValidator = v.object({
+    id: v.optional(notionDataSourceIdSchema),
+    propertiesById: v.record(v.string(), notionPropertySchemaSchema),
+});
+/**
+ * Bridge shape for a single data source: a semantic key bound (optionally) to a collection,
+ * its property name → ID mapping, and its column schemas.
+ */
+export const notionDataSourceSchema = v.object({
+    key: v.string(),
+    collectionPointer: v.optional(collectionPointerValidator),
+    collectionSchema: v.optional(notionCollectionSchemaValidator),
+    /**
+     * Keyed mapping of user-defined keys to a raw property ID. A key mapped to `undefined`
+     * is a declared-but-unbound slot.
+     */
+    propertyIdsByKey: v.record(v.string(), v.optional(v.string())),
+    /**
+     * Keyed mapping of raw property IDs to their schema. Always includes the four built-ins
+     * (`created_time`, `last_edited_time`, `created_by`, `last_edited_by`).
+     */
+    propertySchemasById: v.record(v.string(), notionPropertySchemaSchema),
+});
+export const notionDataSourceBindingSchema = v.object({
+    collectionPointer: v.optional(collectionPointerValidator),
+    collectionSchema: v.optional(notionCollectionSchemaValidator),
+    propertyIdsByKey: v.optional(v.record(v.string(), v.optional(v.string()))),
+});
+export const notionDataSourceBindingsSchema = v.record(v.string(), notionDataSourceBindingSchema);

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

@@ -0,0 +1,72 @@
+import * as v from "valibot";
+/**
+ * Bridge shape for a data source page, as parsed from inbound host messages. The host keys
+ * properties by raw property ID. The four built-ins (`created_time`, `last_edited_time`,
+ * `created_by`, `last_edited_by`) are normally present, possibly with `undefined` values.
+ */
+export declare const notionDataSourcePageBridgeSchema: v.ObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
+    readonly propertiesById: v.RecordSchema<v.StringSchema<undefined>, v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>, v.BooleanSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"date", undefined>;
+        readonly start_date: v.StringSchema<undefined>;
+        readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+            readonly value: v.NumberSchema<undefined>;
+            readonly time: v.StringSchema<undefined>;
+            readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly unit: v.LiteralSchema<"none", undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"daterange", undefined>;
+        readonly start_date: v.StringSchema<undefined>;
+        readonly end_date: v.StringSchema<undefined>;
+        readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+            readonly value: v.NumberSchema<undefined>;
+            readonly time: v.StringSchema<undefined>;
+            readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly unit: v.LiteralSchema<"none", undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"datetime", undefined>;
+        readonly start_date: v.StringSchema<undefined>;
+        readonly start_time: v.StringSchema<undefined>;
+        readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+            readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+            readonly value: v.NumberSchema<undefined>;
+            readonly time: v.StringSchema<undefined>;
+            readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+            readonly value: v.NumberSchema<undefined>;
+        }, undefined>], undefined>, v.ObjectSchema<{
+            readonly unit: v.LiteralSchema<"none", undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"datetimerange", undefined>;
+        readonly start_date: v.StringSchema<undefined>;
+        readonly start_time: v.StringSchema<undefined>;
+        readonly end_date: v.StringSchema<undefined>;
+        readonly end_time: v.StringSchema<undefined>;
+        readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+            readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+            readonly value: v.NumberSchema<undefined>;
+            readonly time: v.StringSchema<undefined>;
+            readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+            readonly value: v.NumberSchema<undefined>;
+        }, undefined>], undefined>, v.ObjectSchema<{
+            readonly unit: v.LiteralSchema<"none", undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>], undefined>, v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly table: v.StringSchema<undefined>;
+    }, undefined>, undefined>], undefined>, undefined>, undefined>;
+}, undefined>;
+/** Internal SDK type for a parsed bridge page. */
+export type NotionDataSourcePageBridge = v.InferOutput<typeof notionDataSourcePageBridgeSchema>;

package/dist/protocol/dataSources/dataSourcePage.js

@@ -0,0 +1,12 @@
+import * as v from "valibot";
+import { notionPageIdSchema } from "../ids.js";
+import { notionDataSourceValueSchema } from "./dataSourceValue.js";
+/**
+ * Bridge shape for a data source page, as parsed from inbound host messages. The host keys
+ * properties by raw property ID. The four built-ins (`created_time`, `last_edited_time`,
+ * `created_by`, `last_edited_by`) are normally present, possibly with `undefined` values.
+ */
+export const notionDataSourcePageBridgeSchema = v.object({
+    id: notionPageIdSchema,
+    propertiesById: v.record(v.string(), v.optional(notionDataSourceValueSchema)),
+});

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

@@ -0,0 +1,66 @@
+import * as v from "valibot";
+/**
+ * Possible types for a data source value.
+ */
+export declare const notionDataSourceValueSchema: v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>, v.BooleanSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"date", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"daterange", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly end_date: v.StringSchema<undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"datetime", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly start_time: v.StringSchema<undefined>;
+    readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+    }, undefined>], undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"datetimerange", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly start_time: v.StringSchema<undefined>;
+    readonly end_date: v.StringSchema<undefined>;
+    readonly end_time: v.StringSchema<undefined>;
+    readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+    }, undefined>], undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>], undefined>, v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ArraySchema<v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly table: v.StringSchema<undefined>;
+}, undefined>, undefined>], undefined>;
+export type NotionDataSourceValue = v.InferOutput<typeof notionDataSourceValueSchema>;

package/dist/protocol/dataSources/dataSourceValue.js

@@ -0,0 +1,14 @@
+import * as v from "valibot";
+import { notionDateValueSchema } from "./dateValue.js";
+import { notionRecordPointerSchema } from "./recordPointer.js";
+/**
+ * Possible types for a data source value.
+ */
+export const notionDataSourceValueSchema = v.union([
+    v.string(),
+    v.number(),
+    v.boolean(),
+    notionDateValueSchema,
+    v.array(v.string()),
+    v.array(notionRecordPointerSchema),
+]);

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

@@ -0,0 +1,157 @@
+import * as v from "valibot";
+export declare const notionDateReminderSchema: v.ObjectSchema<{
+    readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+    readonly value: v.NumberSchema<undefined>;
+    readonly time: v.StringSchema<undefined>;
+    readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type NotionDateReminder = v.InferOutput<typeof notionDateReminderSchema>;
+export declare const notionTimeReminderSchema: v.ObjectSchema<{
+    readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+    readonly value: v.NumberSchema<undefined>;
+}, undefined>;
+export type NotionTimeReminder = v.InferOutput<typeof notionTimeReminderSchema>;
+export declare const notionNoReminderSchema: v.ObjectSchema<{
+    readonly unit: v.LiteralSchema<"none", undefined>;
+}, undefined>;
+export type NotionNoReminder = v.InferOutput<typeof notionNoReminderSchema>;
+/**
+ * Possible types for a Notion `datetime` reminder.
+ */
+export declare const notionDateTimeReminderSchema: v.UnionSchema<[v.ObjectSchema<{
+    readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+    readonly value: v.NumberSchema<undefined>;
+    readonly time: v.StringSchema<undefined>;
+    readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+    readonly value: v.NumberSchema<undefined>;
+}, undefined>], undefined>;
+export type NotionDateTimeReminder = v.InferOutput<typeof notionDateTimeReminderSchema>;
+export declare const notionDateSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"date", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>;
+export type NotionDate = v.InferOutput<typeof notionDateSchema>;
+export declare const notionDateRangeSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"daterange", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly end_date: v.StringSchema<undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>;
+export type NotionDateRange = v.InferOutput<typeof notionDateRangeSchema>;
+export declare const notionDateTimeSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"datetime", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly start_time: v.StringSchema<undefined>;
+    readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+    }, undefined>], undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>;
+export type NotionDateTime = v.InferOutput<typeof notionDateTimeSchema>;
+export declare const notionDateTimeRangeSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"datetimerange", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly start_time: v.StringSchema<undefined>;
+    readonly end_date: v.StringSchema<undefined>;
+    readonly end_time: v.StringSchema<undefined>;
+    readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+    }, undefined>], undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>;
+export type NotionDateTimeRange = v.InferOutput<typeof notionDateTimeRangeSchema>;
+/**
+ * Possible types for a Notion `date` value.
+ */
+export declare const notionDateValueSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"date", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"daterange", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly end_date: v.StringSchema<undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"datetime", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly start_time: v.StringSchema<undefined>;
+    readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+    }, undefined>], undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"datetimerange", undefined>;
+    readonly start_date: v.StringSchema<undefined>;
+    readonly start_time: v.StringSchema<undefined>;
+    readonly end_date: v.StringSchema<undefined>;
+    readonly end_time: v.StringSchema<undefined>;
+    readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+        readonly time: v.StringSchema<undefined>;
+        readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+        readonly value: v.NumberSchema<undefined>;
+    }, undefined>], undefined>, v.ObjectSchema<{
+        readonly unit: v.LiteralSchema<"none", undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>], undefined>;
+export type NotionDateValue = Readonly<v.InferOutput<typeof notionDateValueSchema>>;

package/dist/protocol/dataSources/dateValue.js

@@ -0,0 +1,59 @@
+import * as v from "valibot";
+export const notionDateReminderSchema = v.object({
+    unit: v.picklist(["year", "month", "week", "day"]),
+    value: v.number(),
+    time: v.string(),
+    defaultTimeZone: v.optional(v.string()),
+});
+export const notionTimeReminderSchema = v.object({
+    unit: v.picklist(["hour", "minute"]),
+    value: v.number(),
+});
+export const notionNoReminderSchema = v.object({
+    unit: v.literal("none"),
+});
+/**
+ * Possible types for a Notion `datetime` reminder.
+ */
+export const notionDateTimeReminderSchema = v.union([
+    notionDateReminderSchema,
+    notionTimeReminderSchema,
+]);
+const dateOrNoReminder = v.optional(v.union([notionDateReminderSchema, notionNoReminderSchema]));
+const dateTimeOrNoReminder = v.optional(v.union([notionDateTimeReminderSchema, notionNoReminderSchema]));
+export const notionDateSchema = v.object({
+    type: v.literal("date"),
+    start_date: v.string(),
+    reminder: dateOrNoReminder,
+});
+export const notionDateRangeSchema = v.object({
+    type: v.literal("daterange"),
+    start_date: v.string(),
+    end_date: v.string(),
+    reminder: dateOrNoReminder,
+});
+export const notionDateTimeSchema = v.object({
+    type: v.literal("datetime"),
+    start_date: v.string(),
+    start_time: v.string(),
+    time_zone: v.optional(v.string()),
+    reminder: dateTimeOrNoReminder,
+});
+export const notionDateTimeRangeSchema = v.object({
+    type: v.literal("datetimerange"),
+    start_date: v.string(),
+    start_time: v.string(),
+    end_date: v.string(),
+    end_time: v.string(),
+    time_zone: v.optional(v.string()),
+    reminder: dateTimeOrNoReminder,
+});
+/**
+ * Possible types for a Notion `date` value.
+ */
+export const notionDateValueSchema = v.variant("type", [
+    notionDateSchema,
+    notionDateRangeSchema,
+    notionDateTimeSchema,
+    notionDateTimeRangeSchema,
+]);

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

@@ -0,0 +1,8 @@
+import * as v from "valibot";
+import type { CustomBlockErrorInfo } from "../errors.js";
+export declare const customBlockDataSourceResolutionErrorCodeSchema: v.StringSchema<undefined>;
+export type CustomBlockDataSourceResolutionErrorCode = "unknown_data_source_key" | "unmapped_data_source" | (string & {});
+export type CustomBlockDataSourceResolutionErrorInfo = CustomBlockErrorInfo<CustomBlockDataSourceResolutionErrorCode>;
+export declare const customBlockPropertyErrorCodeSchema: v.StringSchema<undefined>;
+export type CustomBlockPropertyErrorCode = "unmapped_property" | "property_id_mismatch" | "duplicate_property" | "invalid_property_value" | (string & {});
+export type CustomBlockPropertyErrorInfo = CustomBlockErrorInfo<CustomBlockPropertyErrorCode>;

package/dist/protocol/dataSources/errors.js

@@ -0,0 +1,7 @@
+import * as v from "valibot";
+// The schema accepts any string code. The type lists known codes for
+// autocomplete, with an open string fallback for newer senders.
+export const customBlockDataSourceResolutionErrorCodeSchema = v.string();
+// The schema accepts any string code. The type lists known codes for
+// autocomplete, with an open string fallback for newer senders.
+export const customBlockPropertyErrorCodeSchema = v.string();

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

@@ -0,0 +1,197 @@
+import * as v from "valibot";
+/**
+ * Hex-token identifiers for Notion's named colors. Mirrors the public API's
+ * `select.options[].color` enum
+ * (https://developers.notion.com/reference/property-object#select).
+ */
+export declare const notionPropertyColorSchema: v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>;
+export type NotionPropertyColor = v.InferOutput<typeof notionPropertyColorSchema>;
+export declare const notionPropertyOptionSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type NotionPropertyOption = v.InferOutput<typeof notionPropertyOptionSchema>;
+export declare const notionStatusGroupSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+    readonly option_ids: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type NotionStatusGroup = v.InferOutput<typeof notionStatusGroupSchema>;
+export declare const notionDualPropertySchema: v.ObjectSchema<{
+    readonly synced_property_id: v.StringSchema<undefined>;
+    readonly synced_property_name: v.StringSchema<undefined>;
+}, undefined>;
+export type NotionDualProperty = v.InferOutput<typeof notionDualPropertySchema>;
+/**
+ * Every Notion property type the bridge speaks, in a single readable list.
+ * Mirrors the Notion public API
+ * [property object](https://developers.notion.com/reference/property-object)
+ * type field. Internal-only types (`button`, `verification`,
+ * `last_visited_time`, `location`) and the four built-ins (`created_time`,
+ * `last_edited_time`, `created_by`, `last_edited_by`) are included under their
+ * bridge-native names.
+ */
+export declare const NOTION_PROPERTY_TYPES: 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"];
+export declare const notionPropertyTypeSchema: 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>;
+/**
+ * String literal union of every supported Notion property type. Same set as
+ * the discriminator in `NotionPropertySchema` — split out so the manifest
+ * can declare expected property types without dragging in the per-type
+ * payload shapes.
+ */
+export type NotionPropertyType = v.InferOutput<typeof notionPropertyTypeSchema>;
+/**
+ * Property types currently supported by the custom-block data source sort API.
+ * Keep this list narrower than {@link NOTION_PROPERTY_TYPES} when a property
+ * type is exposed but its sort value is not yet represented by every host.
+ */
+export declare const CUSTOM_BLOCK_DATA_SOURCE_SORTABLE_PROPERTY_TYPES: readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "date", "created_time", "last_edited_time"];
+export type CustomBlockDataSourceSortablePropertyType = (typeof CUSTOM_BLOCK_DATA_SOURCE_SORTABLE_PROPERTY_TYPES)[number];
+/**
+ * Per-property schema as exposed by the host over the custom-block bridge.
+ * The `type` discriminator must be one of {@link NOTION_PROPERTY_TYPES}.
+ */
+export declare const notionPropertySchemaSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"title", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"rich_text", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"number", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"checkbox", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"url", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"email", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"phone_number", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"select", undefined>;
+    readonly options: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"multi_select", undefined>;
+    readonly options: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"status", undefined>;
+    readonly options: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly groups: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+        readonly option_ids: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"date", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"people", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"files", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"unique_id", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"relation", undefined>;
+    readonly data_source_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly dual_property: v.OptionalSchema<v.ObjectSchema<{
+        readonly synced_property_id: v.StringSchema<undefined>;
+        readonly synced_property_name: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"place", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"formula", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"rollup", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"button", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"verification", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"last_visited_time", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"location", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"created_time", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"last_edited_time", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"created_by", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"last_edited_by", undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>], undefined>;
+export type NotionPropertySchema = v.InferOutput<typeof notionPropertySchemaSchema>;
+/**
+ * The four synthetic built-in property IDs the host always includes in every
+ * data source's `propertySchemasById` and every row's `propertiesById`.
+ */
+export declare const NOTION_BUILTIN_PROPERTY_IDS: readonly ["created_time", "last_edited_time", "created_by", "last_edited_by"];
+export type NotionBuiltinPropertyId = (typeof NOTION_BUILTIN_PROPERTY_IDS)[number];