@notionhq/custom-blocks 0.1.32 → 0.1.34

package/dist/bridge/dataSources/query.js

@@ -0,0 +1,377 @@
+import { customBlockCheckboxFilterOperatorSchema, customBlockContainsFilterOperatorSchema, customBlockDateFilterOperatorSchema, customBlockNumberFilterOperatorSchema, customBlockOptionFilterOperatorSchema, customBlockTextFilterOperatorSchema, } from "../../protocol/messages/queryDataSource.js";
+import * as v from "valibot";
+const DEFAULT_DATA_SOURCE_QUERY_LIMIT = 20;
+const MAX_DATA_SOURCE_QUERY_LIMIT = 999;
+const MAX_DATA_SOURCE_QUERY_FILTER_CHILDREN = 25;
+export function resolveDataSourceQuery(args) {
+    const { dataSources, key, options, warn } = args;
+    if (options !== undefined && !isPlainRecord(options)) {
+        return {
+            status: "error",
+            error: "Data source query options must be an object.",
+        };
+    }
+    if (options !== undefined &&
+        Object.keys(options).some(key => !["limit", "filter"].includes(key))) {
+        return {
+            status: "error",
+            error: "Data source query options contain unsupported fields.",
+        };
+    }
+    const dataSource = dataSources.find(entry => entry.key === key);
+    if (dataSource === undefined) {
+        return {
+            status: "error",
+            error: `Unknown data source key "${key}". Known keys: [${dataSources.map(entry => entry.key).join(", ")}].`,
+        };
+    }
+    if (dataSource.collectionPointer === undefined) {
+        return {
+            status: "error",
+            error: `Data source "${key}" has not been mapped to a database yet.`,
+        };
+    }
+    const limit = resolveDataSourceQueryLimit(options?.limit, warn);
+    if (limit.status === "error") {
+        return limit;
+    }
+    const filter = resolveFilter(options?.filter, dataSource);
+    if (filter.status === "error") {
+        return filter;
+    }
+    const identity = stableJsonStringify({
+        dataSourceId: dataSource.collectionPointer.id,
+        limit: limit.limit,
+        filter: filter.filter ?? null,
+    });
+    return {
+        status: "ok",
+        dataSource,
+        query: {
+            dataSourceId: dataSource.collectionPointer.id,
+            limit: limit.limit,
+            filter: filter.filter,
+            identity,
+        },
+    };
+}
+function resolveDataSourceQueryLimit(limit, warn = console.warn) {
+    if (limit === undefined) {
+        return { status: "ok", limit: DEFAULT_DATA_SOURCE_QUERY_LIMIT };
+    }
+    if (typeof limit !== "number" ||
+        !Number.isFinite(limit) ||
+        !Number.isInteger(limit) ||
+        limit < 1) {
+        return {
+            status: "error",
+            error: `Data source query limit must be a positive integer between 1 and ${MAX_DATA_SOURCE_QUERY_LIMIT}.`,
+        };
+    }
+    if (limit > MAX_DATA_SOURCE_QUERY_LIMIT) {
+        warn?.(`Data source query limit ${limit} exceeds the maximum of ${MAX_DATA_SOURCE_QUERY_LIMIT}; clamping to ${MAX_DATA_SOURCE_QUERY_LIMIT}.`);
+        return { status: "ok", limit: MAX_DATA_SOURCE_QUERY_LIMIT };
+    }
+    return { status: "ok", limit };
+}
+export function getDataSourceQueryOptionsIdentity(options) {
+    try {
+        return stableJsonStringify(options ?? {});
+    }
+    catch {
+        return "invalid-data-source-query-options";
+    }
+}
+function stableJsonStringify(value) {
+    return JSON.stringify(normalizeJsonValue(value));
+}
+function resolveFilter(filter, dataSource) {
+    if (filter === undefined) {
+        return { status: "ok" };
+    }
+    if (!isPlainRecord(filter)) {
+        return {
+            status: "error",
+            error: "Data source query filter must be an object.",
+        };
+    }
+    if ("and" in filter) {
+        if (Object.keys(filter).length !== 1 || !Array.isArray(filter.and)) {
+            return {
+                status: "error",
+                error: 'Data source query filter "and" must be an array.',
+            };
+        }
+        if (filter.and.length > MAX_DATA_SOURCE_QUERY_FILTER_CHILDREN) {
+            return {
+                status: "error",
+                error: `Data source query filter "and" may contain at most ${MAX_DATA_SOURCE_QUERY_FILTER_CHILDREN} children.`,
+            };
+        }
+        const and = [];
+        for (const child of filter.and) {
+            const resolved = resolvePropertyFilter(child, dataSource);
+            if (resolved.status === "error") {
+                return resolved;
+            }
+            and.push(resolved.filter);
+        }
+        return { status: "ok", filter: { and } };
+    }
+    return resolvePropertyFilter(filter, dataSource);
+}
+function resolvePropertyFilter(filter, dataSource) {
+    if (!isPlainRecord(filter)) {
+        return {
+            status: "error",
+            error: "Data source query property filter must be an object.",
+        };
+    }
+    const property = resolvePropertyAddress(filter, dataSource);
+    if (property.status === "error") {
+        return property;
+    }
+    const branchKeys = Object.keys(filter).filter(key => key !== "key" && key !== "propertyId");
+    if (branchKeys.length !== 1) {
+        return {
+            status: "error",
+            error: "Data source query property filter must contain exactly one property branch.",
+        };
+    }
+    const branch = branchKeys[0];
+    const value = filter[branch];
+    if (!isPlainRecord(value) || Object.keys(value).length !== 1) {
+        return invalidOperator(branch);
+    }
+    if (property.propertyType !== branch) {
+        return {
+            status: "error",
+            error: `Data source query filter branch "${branch}" does not match property type "${property.propertyType}".`,
+        };
+    }
+    switch (branch) {
+        case "title": {
+            const parsed = v.safeParse(customBlockTextFilterOperatorSchema, value);
+            return parsed.success
+                ? {
+                    status: "ok",
+                    filter: { propertyId: property.propertyId, title: parsed.output },
+                }
+                : invalidOperator(branch);
+        }
+        case "rich_text": {
+            const parsed = v.safeParse(customBlockTextFilterOperatorSchema, value);
+            return parsed.success
+                ? {
+                    status: "ok",
+                    filter: {
+                        propertyId: property.propertyId,
+                        rich_text: parsed.output,
+                    },
+                }
+                : invalidOperator(branch);
+        }
+        case "url":
+        case "email":
+        case "phone_number": {
+            const parsed = v.safeParse(customBlockTextFilterOperatorSchema, value);
+            if (!parsed.success) {
+                return invalidOperator(branch);
+            }
+            if (branch === "url") {
+                return {
+                    status: "ok",
+                    filter: { propertyId: property.propertyId, url: parsed.output },
+                };
+            }
+            if (branch === "email") {
+                return {
+                    status: "ok",
+                    filter: { propertyId: property.propertyId, email: parsed.output },
+                };
+            }
+            return {
+                status: "ok",
+                filter: {
+                    propertyId: property.propertyId,
+                    phone_number: parsed.output,
+                },
+            };
+        }
+        case "number": {
+            const parsed = v.safeParse(customBlockNumberFilterOperatorSchema, value);
+            if (parsed.success &&
+                Object.values(parsed.output).every(entry => typeof entry !== "number" || Number.isFinite(entry))) {
+                return {
+                    status: "ok",
+                    filter: { propertyId: property.propertyId, number: parsed.output },
+                };
+            }
+            return invalidOperator(branch);
+        }
+        case "checkbox": {
+            const parsed = v.safeParse(customBlockCheckboxFilterOperatorSchema, value);
+            return parsed.success
+                ? {
+                    status: "ok",
+                    filter: {
+                        propertyId: property.propertyId,
+                        checkbox: parsed.output,
+                    },
+                }
+                : invalidOperator(branch);
+        }
+        case "select": {
+            const parsed = v.safeParse(customBlockOptionFilterOperatorSchema, value);
+            return parsed.success
+                ? {
+                    status: "ok",
+                    filter: { propertyId: property.propertyId, select: parsed.output },
+                }
+                : invalidOperator(branch);
+        }
+        case "multi_select": {
+            const parsed = v.safeParse(customBlockContainsFilterOperatorSchema, value);
+            return parsed.success
+                ? {
+                    status: "ok",
+                    filter: {
+                        propertyId: property.propertyId,
+                        multi_select: parsed.output,
+                    },
+                }
+                : invalidOperator(branch);
+        }
+        case "status": {
+            const parsed = v.safeParse(customBlockOptionFilterOperatorSchema, value);
+            return parsed.success
+                ? {
+                    status: "ok",
+                    filter: { propertyId: property.propertyId, status: parsed.output },
+                }
+                : invalidOperator(branch);
+        }
+        case "date": {
+            const parsed = v.safeParse(customBlockDateFilterOperatorSchema, value);
+            if (parsed.success &&
+                Object.values(parsed.output).every(entry => entry === true || isValidIsoDate(entry))) {
+                return {
+                    status: "ok",
+                    filter: { propertyId: property.propertyId, date: parsed.output },
+                };
+            }
+            return invalidOperator(branch);
+        }
+        default:
+            return {
+                status: "error",
+                error: `Data source query filter branch "${branch}" is not supported.`,
+            };
+    }
+}
+function resolvePropertyAddress(value, dataSource) {
+    const hasKey = "key" in value;
+    const hasPropertyId = "propertyId" in value;
+    if (hasKey === hasPropertyId) {
+        return {
+            status: "error",
+            error: "Data source query filters must use exactly one of key or propertyId.",
+        };
+    }
+    let propertyId;
+    if (hasKey) {
+        if (typeof value.key !== "string") {
+            return {
+                status: "error",
+                error: "Data source query property key must be a string.",
+            };
+        }
+        if (!(value.key in dataSource.propertyIdsByKey)) {
+            return {
+                status: "error",
+                error: `Unknown property key "${value.key}" for data source "${dataSource.key}".`,
+            };
+        }
+        const resolvedPropertyId = dataSource.propertyIdsByKey[value.key];
+        if (resolvedPropertyId === undefined) {
+            return {
+                status: "error",
+                error: `Property key "${value.key}" for data source "${dataSource.key}" is not bound.`,
+            };
+        }
+        propertyId = resolvedPropertyId;
+    }
+    else {
+        if (typeof value.propertyId !== "string") {
+            return {
+                status: "error",
+                error: "Data source query propertyId must be a string.",
+            };
+        }
+        propertyId = value.propertyId;
+    }
+    const propertySchema = dataSource.propertySchemasById[propertyId];
+    if (propertySchema === undefined) {
+        return {
+            status: "error",
+            error: `Unknown property ID "${propertyId}" for data source "${dataSource.key}".`,
+        };
+    }
+    return {
+        status: "ok",
+        propertyId,
+        propertyType: propertySchema.type,
+    };
+}
+function invalidOperator(branch) {
+    return {
+        status: "error",
+        error: `Data source query filter branch "${branch}" has an invalid operator or value.`,
+    };
+}
+function normalizeJsonValue(value) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error("Data source query values must be finite JSON numbers.");
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(entry => normalizeJsonValue(entry));
+    }
+    if (isPlainRecord(value)) {
+        const normalized = {};
+        for (const key of Object.keys(value).sort()) {
+            const child = value[key];
+            if (child !== undefined) {
+                normalized[key] = normalizeJsonValue(child);
+            }
+        }
+        return normalized;
+    }
+    throw new Error("Data source query values must be JSON-compatible.");
+}
+function isPlainRecord(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        (Object.getPrototypeOf(value) === Object.prototype ||
+            Object.getPrototypeOf(value) === null));
+}
+function isValidIsoDate(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    if (dateOnly !== null) {
+        const [, year, month, day] = dateOnly;
+        const date = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day)));
+        return date.toISOString().slice(0, 10) === value;
+    }
+    return (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:\d{2})$/.test(value) && Number.isFinite(Date.parse(value)));
+}

package/dist/bridge/hostState.d.ts

@@ -29,15 +29,16 @@ export type InitializedHostState = {
     dataSourceState: Record<string, DataSourceQueryState>;
 };
 export type DataSourceQueryState = {
+    dataSourceKey: string;
     /** Latest pages from the host as parsed from the bridge. `propertiesByKey` is derived lazily. */
     items: NotionDataSourcePageBridge[];
     isLoading: boolean;
     hasMore: boolean;
     error?: CustomBlockQueryDataSourceErrorInfo;
-    subscriptionId?: string;
     latestLimit?: number;
+    latestQueryIdentity?: string;
 };
-export declare function createEmptyDataSourceQueryState(): DataSourceQueryState;
+export declare function createEmptyDataSourceQueryState(dataSourceKey: string): 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
@@ -69,5 +70,5 @@ export type UpdateDataSourcePageFn = (args: {
     pageId: NotionPageId;
     pageUpdateArgs: NotionDataSourcePageUpdateArgs;
 }) => Promise<UpdatePageResult>;
-export declare function getDataSourceQueryView(hostState: CustomBlockHostState, key: string, updateDataSourcePage: UpdateDataSourcePageFn): DataSourceQueryView;
+export declare function getDataSourceQueryView(hostState: CustomBlockHostState, key: string, subscriptionId: string, updateDataSourcePage: UpdateDataSourcePageFn): DataSourceQueryView;
 //# sourceMappingURL=hostState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hostState.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/hostState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAA;AAClG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gEAAgE,CAAA;AAEhH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gEAAgE,CAAA;AAC1G,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AACvF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,oEAAoE,CAAA;AAC7H,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAA;AAChF,OAAO,KAAK,EACX,oBAAoB,EACpB,8BAA8B,EAC9B,gBAAgB,EAChB,MAAM,aAAa,CAAA;AAEpB,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,oBAAoB,CAAA;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,WAAW,EAAE,UAAU,CAAA;IACvB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,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,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,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,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACvD,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;AAWD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,cAAc,EAAE,8BAA8B,CAAA;CAC9C,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE/B,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,oBAAoB,EAC/B,GAAG,EAAE,MAAM,EACX,oBAAoB,EAAE,sBAAsB,GAC1C,mBAAmB,CAgErB"}
+{"version":3,"file":"hostState.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/hostState.ts"],"names":[],"mappings":"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"}

package/dist/bridge/hostState.js

@@ -1,5 +1,6 @@
-export function createEmptyDataSourceQueryState() {
+export function createEmptyDataSourceQueryState(dataSourceKey) {
     return {
+        dataSourceKey,
         items: [],
         isLoading: false,
         hasMore: false,
@@ -13,12 +14,15 @@ const EMPTY_QUERY_VIEW = {
     isLoading: false,
     hasMore: false,
 };
-export function getDataSourceQueryView(hostState, key, updateDataSourcePage) {
+export function getDataSourceQueryView(hostState, key, subscriptionId, updateDataSourcePage) {
     if (hostState.status !== "initialized") {
         return EMPTY_QUERY_VIEW;
     }
     const dataSource = hostState.dataSources.find(entry => entry.key === key);
-    const queryState = hostState.dataSourceState[key] ?? createEmptyDataSourceQueryState();
+    const subscriptionState = hostState.dataSourceState[subscriptionId];
+    const queryState = subscriptionState?.dataSourceKey === key
+        ? subscriptionState
+        : createEmptyDataSourceQueryState(key);
     if (dataSource === undefined) {
         return {
             items: [],

package/dist/bridge/sandboxClient.d.ts

@@ -19,8 +19,10 @@ export declare const customBlockHost: {
     postResize: (height: number) => void;
 };
 export declare const customBlockDataSources: {
-    query: (key: string, options?: UseDataSourceOptions) => void;
-    getView: (hostState: CustomBlockHostState, key: string) => DataSourceQueryView;
+    createSubscriptionId: () => string;
+    query: (subscriptionId: string, key: string, options?: UseDataSourceOptions) => void;
+    release: (subscriptionId: string) => void;
+    getView: (hostState: CustomBlockHostState, key: string, subscriptionId: string) => DataSourceQueryView;
 };
 export declare const messageLog: {
     getSnapshot: () => readonly MessageLogEntry[];

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

@@ -1 +1 @@
-{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAA;AACpF,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,oBAAoB,CAAA;AAWxE,eAAO,MAAM,eAAe;;kCAKG,kBAAkB;yBAI3B,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC;0BAI1B,MAAM,IAAI;oBAIlB,oBAAoB;IAIlC;;;OAGG;4BACqB,WAAW;;yBAQd,MAAM;CAG3B,CAAA;AAED,eAAO,MAAM,sBAAsB;iBACrB,MAAM,YAAY,oBAAoB;yBAKvC,oBAAoB,OAC1B,MAAM,KACT,mBAAmB;CAKtB,CAAA;AAED,eAAO,MAAM,UAAU;uBACL,SAAS,eAAe,EAAE;0BAIrB,MAAM,IAAI;CAGhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;oBACa,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;IAInD;;OAEG;oBACa,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;qBACc,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;CAGzD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;mBACY,aAAa,KAAG,OAAO,CAAC,eAAe,CAAC;IAIvD;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;CAGnD,CAAA"}
+{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAA;AACpF,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,oBAAoB,CAAA;AAWxE,eAAO,MAAM,eAAe;;kCAKG,kBAAkB;yBAI3B,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC;0BAI1B,MAAM,IAAI;oBAIlB,oBAAoB;IAIlC;;;OAGG;4BACqB,WAAW;;yBAQd,MAAM;CAG3B,CAAA;AAED,eAAO,MAAM,sBAAsB;;4BAMjB,MAAM,OACjB,MAAM,YACD,oBAAoB;8BAKL,MAAM;yBAKpB,oBAAoB,OAC1B,MAAM,kBACK,MAAM,KACpB,mBAAmB;CAQtB,CAAA;AAED,eAAO,MAAM,UAAU;uBACL,SAAS,eAAe,EAAE;0BAIrB,MAAM,IAAI;CAGhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;oBACa,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;IAInD;;OAEG;oBACa,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;qBACc,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;CAGzD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;mBACY,aAAa,KAAG,OAAO,CAAC,eAAe,CAAC;IAIvD;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;CAGnD,CAAA"}

package/dist/bridge/sandboxClient.js

@@ -38,11 +38,17 @@ export const customBlockHost = {
     },
 };
 export const customBlockDataSources = {
-    query: (key, options) => {
-        getBridge().queryDataSource(key, options);
+    createSubscriptionId: () => {
+        return getBridge().createDataSourceSubscriptionId();
     },
-    getView: (hostState, key) => {
-        return getDataSourceQueryViewWithBridge(hostState, key, args => getBridge().updateDataSourcePage(args));
+    query: (subscriptionId, key, options) => {
+        getBridge().queryDataSource(subscriptionId, key, options);
+    },
+    release: (subscriptionId) => {
+        getBridge().releaseDataSourceSubscription(subscriptionId);
+    },
+    getView: (hostState, key, subscriptionId) => {
+        return getDataSourceQueryViewWithBridge(hostState, key, subscriptionId, args => getBridge().updateDataSourcePage(args));
     },
 };
 export const messageLog = {

package/dist/protocol/messages/init.d.ts

@@ -2,7 +2,7 @@ import * as v from "valibot";
 import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
 import type { CustomBlockInitResultErrorCode } from "./initResult.js";
 export declare const customBlockInitErrorCodeSchema: v.StringSchema<undefined>;
-export type CustomBlockInitErrorCode = CustomBlockErrorCode<"manifest_unavailable" | "manifest_invalid" | "invalid_protocol_version" | "unsupported_protocol_version" | "context_unavailable" | "current_user_unavailable" | "missing_data_source_binding" | "data_source_unavailable" | "missing_property_binding" | "invalid_property_binding">;
+export type CustomBlockInitErrorCode = CustomBlockErrorCode<"manifest_unavailable" | "manifest_invalid" | "invalid_connect_payload" | "invalid_protocol_version" | "unsupported_protocol_version" | "context_unavailable" | "current_user_unavailable" | "missing_data_source_binding" | "data_source_unavailable" | "missing_property_binding" | "invalid_property_binding">;
 export type CustomBlockInitErrorInfo = CustomBlockErrorInfo<CustomBlockInitErrorCode>;
 /**
  * Every initialization failure visible to block code. This combines errors

package/dist/protocol/messages/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/protocol/src/messages/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAO9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAA;AAIrE,eAAO,MAAM,8BAA8B,2BAAa,CAAA;AAExD,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,CACxD,sBAAsB,GACtB,kBAAkB,GAClB,0BAA0B,GAC1B,8BAA8B,GAC9B,qBAAqB,GACrB,0BAA0B,GAC1B,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,GAC1B,0BAA0B,CAC5B,CAAA;AAED,MAAM,MAAM,wBAAwB,GACnC,oBAAoB,CAAC,wBAAwB,CAAC,CAAA;AAE/C;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAC3C,wBAAwB,GACxB,8BAA8B,GAC9B,oBAAoB,CAAC,eAAe,GAAG,cAAc,CAAC,CAAA;AAEzD,MAAM,MAAM,kCAAkC,GAC7C,oBAAoB,CAAC,kCAAkC,CAAC,CAAA;AAEzD,eAAO,MAAM,8BAA8B;;;;aAIzC,CAAA;AAEF,qBAAa,8BACZ,SAAQ,KACR,YAAW,oBAAoB;gBAEnB,KAAK,EAAE,kCAAkC;IAOrD,IAAI,EAAE,kCAAkC,CAAA;IACxC,WAAW,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAuB5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/protocol/src/messages/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAO9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAA;AAIrE,eAAO,MAAM,8BAA8B,2BAAa,CAAA;AAExD,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,CACxD,sBAAsB,GACtB,kBAAkB,GAClB,yBAAyB,GACzB,0BAA0B,GAC1B,8BAA8B,GAC9B,qBAAqB,GACrB,0BAA0B,GAC1B,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,GAC1B,0BAA0B,CAC5B,CAAA;AAED,MAAM,MAAM,wBAAwB,GACnC,oBAAoB,CAAC,wBAAwB,CAAC,CAAA;AAE/C;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAC3C,wBAAwB,GACxB,8BAA8B,GAC9B,oBAAoB,CAAC,eAAe,GAAG,cAAc,CAAC,CAAA;AAEzD,MAAM,MAAM,kCAAkC,GAC7C,oBAAoB,CAAC,kCAAkC,CAAC,CAAA;AAEzD,eAAO,MAAM,8BAA8B;;;;aAIzC,CAAA;AAEF,qBAAa,8BACZ,SAAQ,KACR,YAAW,oBAAoB;gBAEnB,KAAK,EAAE,kCAAkC;IAOrD,IAAI,EAAE,kCAAkC,CAAA;IACxC,WAAW,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAuB5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA"}

package/dist/protocol/messages/initResult.d.ts

@@ -1,7 +1,14 @@
 import * as v from "valibot";
 import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
 export declare const customBlockInitResultErrorCodeSchema: v.StringSchema<undefined>;
-export type CustomBlockInitResultErrorCode = CustomBlockErrorCode<"invalid_init_bindings">;
+export type CustomBlockInitResultErrorCode = CustomBlockErrorCode<
+/**
+ * The host-provided bindings defined in `init.dataSources` were rejected by the sandbox because
+ * they did not completely match the expected manifest keys.
+ */
+"invalid_init_bindings"
+/** The host-provided `init` payload failed to parse. */
+ | "invalid_init_payload">;
 export type CustomBlockInitResultErrorInfo = CustomBlockErrorInfo<CustomBlockInitResultErrorCode>;
 export declare const customBlockInitResultErrorInfoSchema: v.ObjectSchema<{
     readonly code: v.StringSchema<undefined>;

package/dist/protocol/messages/initResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initResult.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/protocol/src/messages/initResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAI9E,eAAO,MAAM,oCAAoC,2BAAa,CAAA;AAE9D,MAAM,MAAM,8BAA8B,GACzC,oBAAoB,CAAC,uBAAuB,CAAC,CAAA;AAE9C,MAAM,MAAM,8BAA8B,GACzC,oBAAoB,CAAC,8BAA8B,CAAC,CAAA;AAErD,eAAO,MAAM,oCAAoC;;;;aAI/C,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;IAKlC,0EAA0E;;;;;;;;;;;0BAU1E,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA"}
+{"version":3,"file":"initResult.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/protocol/src/messages/initResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAI9E,eAAO,MAAM,oCAAoC,2BAAa,CAAA;AAE9D,MAAM,MAAM,8BAA8B,GAAG,oBAAoB;AAChE;;;GAGG;AACD,uBAAuB;AACzB,wDAAwD;GACtD,sBAAsB,CACxB,CAAA;AAED,MAAM,MAAM,8BAA8B,GACzC,oBAAoB,CAAC,8BAA8B,CAAC,CAAA;AAErD,eAAO,MAAM,oCAAoC;;;;aAI/C,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;IAKlC,0EAA0E;;;;;;;;;;;0BAU1E,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA"}