@visus-io/notion-sdk-ts 3.2.0 → 3.2.1

package/dist/schemas/page.schema.d.ts

@@ -357,6 +357,16 @@ export declare const pageSchema: z.ZodObject<{
         id: z.ZodString;
         type: z.ZodLiteral<"phone_number">;
         phone_number: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"place">;
+        place: z.ZodNullable<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            address: z.ZodOptional<z.ZodString>;
+            latitude: z.ZodOptional<z.ZodNumber>;
+            longitude: z.ZodOptional<z.ZodNumber>;
+            google_place_id: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         type: z.ZodLiteral<"relation">;
@@ -408,10 +418,23 @@ export declare const pageSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"mention">;
             mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"custom_emoji">;
+                custom_emoji: z.ZodObject<{
+                    id: z.ZodUUID;
+                    name: z.ZodString;
+                    url: z.ZodURL;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"database">;
                 database: z.ZodObject<{
                     id: z.ZodUUID;
                 }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"data_source">;
+                data_source: z.ZodObject<{
+                    id: z.ZodUUID;
+                    database_id: z.ZodOptional<z.ZodUUID>;
+                }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"date">;
                 date: z.ZodObject<{
@@ -419,6 +442,11 @@ export declare const pageSchema: z.ZodObject<{
                     end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                     time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"link_mention">;
+                link_mention: z.ZodObject<{
+                    href: z.ZodString;
+                }, z.core.$loose>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"link_preview">;
                 link_preview: z.ZodObject<{
@@ -688,10 +716,23 @@ export declare const pageSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"mention">;
             mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"custom_emoji">;
+                custom_emoji: z.ZodObject<{
+                    id: z.ZodUUID;
+                    name: z.ZodString;
+                    url: z.ZodURL;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"database">;
                 database: z.ZodObject<{
                     id: z.ZodUUID;
                 }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"data_source">;
+                data_source: z.ZodObject<{
+                    id: z.ZodUUID;
+                    database_id: z.ZodOptional<z.ZodUUID>;
+                }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"date">;
                 date: z.ZodObject<{
@@ -699,6 +740,11 @@ export declare const pageSchema: z.ZodObject<{
                     end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                     time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"link_mention">;
+                link_mention: z.ZodObject<{
+                    href: z.ZodString;
+                }, z.core.$loose>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"link_preview">;
                 link_preview: z.ZodObject<{

package/dist/schemas/page.schema.js

@@ -64,7 +64,8 @@ exports.pageSchema = z.object({
     is_locked: z.boolean().optional(),
     icon: z.nullable(icon_schema_1.iconSchema),
     cover: z.nullable(file_schema_1.fileSchema),
-    properties: z.record(z.string().trim(), pageProperties_schema_1.pagePropertiesSchema),
+    // Do not trim: property names can carry significant leading/trailing spaces.
+    properties: z.record(z.string(), pageProperties_schema_1.pagePropertiesSchema),
     parent: parent_schema_1.parentSchema,
     url: z.url(),
     public_url: z.url().nullable(),

package/dist/schemas/pageMarkdown.schema.js

@@ -53,7 +53,7 @@ exports.pageMarkdownSchema = z.object({
     // eslint-disable-next-line zod/prefer-string-schema-with-trim -- markdown content must preserve leading/trailing whitespace and newlines
     markdown: z.string(),
     truncated: z.boolean(),
-    unknown_block_ids: z.array(z.uuid()).max(100),
+    unknown_block_ids: z.array(z.uuid()),
 });
 /**
  * `PATCH /v1/pages/{page_id}/markdown` returns `pageMarkdownSchema` synchronously. If

package/dist/schemas/pageProperties.schema.d.ts

@@ -4,7 +4,7 @@ import * as z from 'zod';
  *
  * These schemas define the data values in page properties (database columns).
  * Property objects define the schema and configuration instead.
- * This file supports 22 property types, including title, rich text, number, and select.
+ * This file supports 23 property types, including title, rich text, number, and select.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/page-property-values
@@ -247,6 +247,18 @@ declare const phoneNumberPropertySchema: z.ZodObject<{
     type: z.ZodLiteral<"phone_number">;
     phone_number: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/** Place property. Unknown keys on the location value pass through. */
+declare const placePropertySchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"place">;
+    place: z.ZodNullable<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+        google_place_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
 /** Relation property. */
 declare const relationPropertySchema: z.ZodObject<{
     id: z.ZodString;
@@ -301,10 +313,23 @@ declare const richTextPropertySchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"mention">;
         mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"custom_emoji">;
+            custom_emoji: z.ZodObject<{
+                id: z.ZodUUID;
+                name: z.ZodString;
+                url: z.ZodURL;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"database">;
             database: z.ZodObject<{
                 id: z.ZodUUID;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"data_source">;
+            data_source: z.ZodObject<{
+                id: z.ZodUUID;
+                database_id: z.ZodOptional<z.ZodUUID>;
+            }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"date">;
             date: z.ZodObject<{
@@ -312,6 +337,11 @@ declare const richTextPropertySchema: z.ZodObject<{
                 end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                 time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"link_mention">;
+            link_mention: z.ZodObject<{
+                href: z.ZodString;
+            }, z.core.$loose>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"link_preview">;
             link_preview: z.ZodObject<{
@@ -589,10 +619,23 @@ declare const titlePropertySchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"mention">;
         mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"custom_emoji">;
+            custom_emoji: z.ZodObject<{
+                id: z.ZodUUID;
+                name: z.ZodString;
+                url: z.ZodURL;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"database">;
             database: z.ZodObject<{
                 id: z.ZodUUID;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"data_source">;
+            data_source: z.ZodObject<{
+                id: z.ZodUUID;
+                database_id: z.ZodOptional<z.ZodUUID>;
+            }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"date">;
             date: z.ZodObject<{
@@ -600,6 +643,11 @@ declare const titlePropertySchema: z.ZodObject<{
                 end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                 time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"link_mention">;
+            link_mention: z.ZodObject<{
+                href: z.ZodString;
+            }, z.core.$loose>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"link_preview">;
             link_preview: z.ZodObject<{
@@ -1004,6 +1052,16 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     id: z.ZodString;
     type: z.ZodLiteral<"phone_number">;
     phone_number: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"place">;
+    place: z.ZodNullable<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+        google_place_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     type: z.ZodLiteral<"relation">;
@@ -1055,10 +1113,23 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"mention">;
         mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"custom_emoji">;
+            custom_emoji: z.ZodObject<{
+                id: z.ZodUUID;
+                name: z.ZodString;
+                url: z.ZodURL;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"database">;
             database: z.ZodObject<{
                 id: z.ZodUUID;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"data_source">;
+            data_source: z.ZodObject<{
+                id: z.ZodUUID;
+                database_id: z.ZodOptional<z.ZodUUID>;
+            }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"date">;
             date: z.ZodObject<{
@@ -1066,6 +1137,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                 time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"link_mention">;
+            link_mention: z.ZodObject<{
+                href: z.ZodString;
+            }, z.core.$loose>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"link_preview">;
             link_preview: z.ZodObject<{
@@ -1335,10 +1411,23 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"mention">;
         mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"custom_emoji">;
+            custom_emoji: z.ZodObject<{
+                id: z.ZodUUID;
+                name: z.ZodString;
+                url: z.ZodURL;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"database">;
             database: z.ZodObject<{
                 id: z.ZodUUID;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"data_source">;
+            data_source: z.ZodObject<{
+                id: z.ZodUUID;
+                database_id: z.ZodOptional<z.ZodUUID>;
+            }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"date">;
             date: z.ZodObject<{
@@ -1346,6 +1435,11 @@ export declare const pagePropertiesSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                 time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"link_mention">;
+            link_mention: z.ZodObject<{
+                href: z.ZodString;
+            }, z.core.$loose>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"link_preview">;
             link_preview: z.ZodObject<{
@@ -1585,6 +1679,10 @@ export type PeopleProperty = z.infer<typeof peoplePropertySchema>;
  * @category Page Properties
  */
 export type PhoneNumberProperty = z.infer<typeof phoneNumberPropertySchema>;
+/**
+ * @category Page Properties
+ */
+export type PlaceProperty = z.infer<typeof placePropertySchema>;
 /**
  * @category Page Properties
  */

package/dist/schemas/pageProperties.schema.js

@@ -44,7 +44,7 @@ const user_schema_1 = require("./user.schema");
  *
  * These schemas define the data values in page properties (database columns).
  * Property objects define the schema and configuration instead.
- * This file supports 22 property types, including title, rich text, number, and select.
+ * This file supports 23 property types, including title, rich text, number, and select.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/page-property-values
@@ -156,6 +156,20 @@ const phoneNumberPropertySchema = z.object({
     type: z.literal('phone_number'),
     phone_number: z.string().trim().nullable(),
 });
+/** Place property. Unknown keys on the location value pass through. */
+const placePropertySchema = z.object({
+    id: z.string().trim(),
+    type: z.literal('place'),
+    place: z
+        .looseObject({
+        name: z.string().trim().optional(),
+        address: z.string().trim().optional(),
+        latitude: z.number().optional(),
+        longitude: z.number().optional(),
+        google_place_id: z.string().trim().optional(),
+    })
+        .nullable(),
+});
 /** Relation property. */
 const relationPropertySchema = z.object({
     id: z.string().trim(),
@@ -292,6 +306,7 @@ exports.pagePropertiesSchema = z.discriminatedUnion('type', [
     numberPropertySchema,
     peoplePropertySchema,
     phoneNumberPropertySchema,
+    placePropertySchema,
     relationPropertySchema,
     richTextPropertySchema,
     rollupPropertySchema,

package/dist/schemas/pagination.schema.d.ts

@@ -60,10 +60,10 @@ export declare const paginatedListSchema: <T extends z.ZodTypeAny>(resultSchema:
         custom_emoji: "custom_emoji";
         user: "user";
         database: "database";
+        data_source: "data_source";
         page: "page";
         block: "block";
         comment: "comment";
-        data_source: "data_source";
         page_or_database: "page_or_database";
         page_or_data_source: "page_or_data_source";
         property_item: "property_item";

package/dist/schemas/propertyObjects.schema.js

@@ -379,4 +379,5 @@ exports.propertyObjectSchema = z.discriminatedUnion('type', [
  *
  * @category Page Properties
  */
-exports.propertiesObjectSchema = z.record(z.string().trim(), exports.propertyObjectSchema);
+// Do not trim: property names can carry significant leading/trailing spaces.
+exports.propertiesObjectSchema = z.record(z.string(), exports.propertyObjectSchema);

package/dist/schemas/richText.schema.d.ts

@@ -43,10 +43,23 @@ declare const textRichTextSchema: z.ZodObject<{
 declare const mentionRichTextSchema: z.ZodObject<{
     type: z.ZodLiteral<"mention">;
     mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"custom_emoji">;
+        custom_emoji: z.ZodObject<{
+            id: z.ZodUUID;
+            name: z.ZodString;
+            url: z.ZodURL;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"database">;
         database: z.ZodObject<{
             id: z.ZodUUID;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"data_source">;
+        data_source: z.ZodObject<{
+            id: z.ZodUUID;
+            database_id: z.ZodOptional<z.ZodUUID>;
+        }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"date">;
         date: z.ZodObject<{
@@ -54,6 +67,11 @@ declare const mentionRichTextSchema: z.ZodObject<{
             end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
             time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"link_mention">;
+        link_mention: z.ZodObject<{
+            href: z.ZodString;
+        }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"link_preview">;
         link_preview: z.ZodObject<{
@@ -224,10 +242,23 @@ export declare const richTextSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodOb
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"mention">;
     mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"custom_emoji">;
+        custom_emoji: z.ZodObject<{
+            id: z.ZodUUID;
+            name: z.ZodString;
+            url: z.ZodURL;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"database">;
         database: z.ZodObject<{
             id: z.ZodUUID;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"data_source">;
+        data_source: z.ZodObject<{
+            id: z.ZodUUID;
+            database_id: z.ZodOptional<z.ZodUUID>;
+        }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"date">;
         date: z.ZodObject<{
@@ -235,6 +266,11 @@ export declare const richTextSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodOb
             end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
             time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"link_mention">;
+        link_mention: z.ZodObject<{
+            href: z.ZodString;
+        }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"link_preview">;
         link_preview: z.ZodObject<{

package/dist/schemas/richText.schema.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.richTextSchema = void 0;
 const z = __importStar(require("zod"));
 const colors_1 = require("./colors");
+const customEmoji_schema_1 = require("./customEmoji.schema");
 const shared_schema_1 = require("./shared.schema");
 const user_schema_1 = require("./user.schema");
 /**
@@ -70,6 +71,23 @@ const databaseMentionSchema = z.object({
         id: z.uuid(),
     }),
 });
+const dataSourceMentionSchema = z.object({
+    type: z.literal('data_source'),
+    data_source: z.object({
+        id: z.uuid(),
+        database_id: z.uuid().optional(),
+    }),
+});
+const customEmojiMentionSchema = z.object({
+    type: z.literal('custom_emoji'),
+    custom_emoji: customEmoji_schema_1.customEmojiSchema,
+});
+const linkMentionSchema = z.object({
+    type: z.literal('link_mention'),
+    link_mention: z.looseObject({
+        href: z.string().trim(),
+    }),
+});
 const dateMentionSchema = z.object({
     type: z.literal('date'),
     date: z.object({
@@ -110,8 +128,11 @@ const userMentionSchema = z.object({
     user: user_schema_1.userSchema,
 });
 const mentionSchema = z.discriminatedUnion('type', [
+    customEmojiMentionSchema,
     databaseMentionSchema,
+    dataSourceMentionSchema,
     dateMentionSchema,
+    linkMentionSchema,
     linkPreviewMentionSchema,
     pageMentionSchema,
     templateMentionSchema,

package/dist/schemas/shared.schema.d.ts

@@ -5,13 +5,9 @@ import * as z from 'zod';
  * This file contains common schemas to avoid circular dependencies.
  */
 /**
- * Notion date string schema.
- *
- * This schema validates ISO 8601 date strings from the Notion API.
- * It accepts a date-only format ("2023-02-23") and a full date-time format
- * ("2023-02-23T00:00:00.000Z").
- *
- * The Notion API docs describe date fields as "A date, with an optional time".
+ * Notion date string schema. Accepts a date ("2023-02-23"), a UTC date-time
+ * ("2023-02-23T00:00:00.000Z"), and a date-time with a UTC offset or no zone
+ * ("2021-10-15T12:00:00.000-04:00", "2021-10-15T12:00:00.000").
  *
  * @category Shared Types
  */

package/dist/schemas/shared.schema.js

@@ -41,17 +41,13 @@ const z = __importStar(require("zod"));
  * This file contains common schemas to avoid circular dependencies.
  */
 /**
- * Notion date string schema.
- *
- * This schema validates ISO 8601 date strings from the Notion API.
- * It accepts a date-only format ("2023-02-23") and a full date-time format
- * ("2023-02-23T00:00:00.000Z").
- *
- * The Notion API docs describe date fields as "A date, with an optional time".
+ * Notion date string schema. Accepts a date ("2023-02-23"), a UTC date-time
+ * ("2023-02-23T00:00:00.000Z"), and a date-time with a UTC offset or no zone
+ * ("2021-10-15T12:00:00.000-04:00", "2021-10-15T12:00:00.000").
  *
  * @category Shared Types
  */
 exports.notionDateStringSchema = z.union([
-    z.iso.datetime(), // Full ISO 8601 datetime: "2023-02-23T00:00:00.000Z"
-    z.iso.date(), // Date only: "2023-02-23"
+    z.iso.datetime({ offset: true, local: true }),
+    z.iso.date(),
 ]);

package/dist/schemas/view.schema.d.ts

@@ -551,6 +551,16 @@ export declare const viewQueryResponseSchema: z.ZodObject<{
             id: z.ZodString;
             type: z.ZodLiteral<"phone_number">;
             phone_number: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"place">;
+            place: z.ZodNullable<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                address: z.ZodOptional<z.ZodString>;
+                latitude: z.ZodOptional<z.ZodNumber>;
+                longitude: z.ZodOptional<z.ZodNumber>;
+                google_place_id: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             type: z.ZodLiteral<"relation">;
@@ -602,10 +612,23 @@ export declare const viewQueryResponseSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"mention">;
                 mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"custom_emoji">;
+                    custom_emoji: z.ZodObject<{
+                        id: z.ZodUUID;
+                        name: z.ZodString;
+                        url: z.ZodURL;
+                    }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"database">;
                     database: z.ZodObject<{
                         id: z.ZodUUID;
                     }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"data_source">;
+                    data_source: z.ZodObject<{
+                        id: z.ZodUUID;
+                        database_id: z.ZodOptional<z.ZodUUID>;
+                    }, z.core.$strip>;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"date">;
                     date: z.ZodObject<{
@@ -613,6 +636,11 @@ export declare const viewQueryResponseSchema: z.ZodObject<{
                         end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                         time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"link_mention">;
+                    link_mention: z.ZodObject<{
+                        href: z.ZodString;
+                    }, z.core.$loose>;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"link_preview">;
                     link_preview: z.ZodObject<{
@@ -882,10 +910,23 @@ export declare const viewQueryResponseSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"mention">;
                 mention: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"custom_emoji">;
+                    custom_emoji: z.ZodObject<{
+                        id: z.ZodUUID;
+                        name: z.ZodString;
+                        url: z.ZodURL;
+                    }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"database">;
                     database: z.ZodObject<{
                         id: z.ZodUUID;
                     }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"data_source">;
+                    data_source: z.ZodObject<{
+                        id: z.ZodUUID;
+                        database_id: z.ZodOptional<z.ZodUUID>;
+                    }, z.core.$strip>;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"date">;
                     date: z.ZodObject<{
@@ -893,6 +934,11 @@ export declare const viewQueryResponseSchema: z.ZodObject<{
                         end: z.ZodNullable<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>>;
                         time_zone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"link_mention">;
+                    link_mention: z.ZodObject<{
+                        href: z.ZodString;
+                    }, z.core.$loose>;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"link_preview">;
                     link_preview: z.ZodObject<{

package/dist/validation.d.ts

@@ -60,3 +60,11 @@ export declare function validateStringLength(value: string, maxLength: number, l
  * @category Client & Core
  */
 export declare function validateArrayLength(array: unknown[], maxLength: number, label: string): void;
+/**
+ * Assert that a number is within the inclusive range `[min, max]`.
+ *
+ * @throws {NotionValidationError}
+ *
+ * @category Client & Core
+ */
+export declare function validateNumberRange(value: number, min: number, max: number, label: string): void;

package/dist/validation.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotionValidationError = exports.LIMITS = void 0;
 exports.validateStringLength = validateStringLength;
 exports.validateArrayLength = validateArrayLength;
+exports.validateNumberRange = validateNumberRange;
 /**
  * Maximum sizes the Notion API allows in a request.
  *
@@ -86,3 +87,18 @@ function validateArrayLength(array, maxLength, label) {
         throw new NotionValidationError(`${label} exceeds the ${maxLength}-element limit (got ${array.length})`);
     }
 }
+// ---------------------------------------------------------------------------
+// Numeric range validators
+// ---------------------------------------------------------------------------
+/**
+ * Assert that a number is within the inclusive range `[min, max]`.
+ *
+ * @throws {NotionValidationError}
+ *
+ * @category Client & Core
+ */
+function validateNumberRange(value, min, max, label) {
+    if (!Number.isFinite(value) || value < min || value > max) {
+        throw new NotionValidationError(`${label} must be between ${min} and ${max} (got ${value})`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visus-io/notion-sdk-ts",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "private": false,
   "description": "TypeScript SDK for the Notion API",
   "keywords": [