@visus-io/notion-sdk-ts 2.0.1 → 2.1.0

package/dist/schemas/richText.schema.js

@@ -1,8 +1,42 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.richTextSchema = void 0;
-const zod_1 = require("zod");
+const z = __importStar(require("zod"));
 const colors_1 = require("./colors");
+const shared_schema_1 = require("./shared.schema");
 const user_schema_1 = require("./user.schema");
 /**
  * Notion rich text object schema.
@@ -15,66 +49,67 @@ const user_schema_1 = require("./user.schema");
  * https://developers.notion.com/reference/rich-text
  */
 /** Annotations for rich text. */
-const annotationsSchema = zod_1.z.object({
-    bold: zod_1.z.boolean(),
-    italic: zod_1.z.boolean(),
-    strikethrough: zod_1.z.boolean(),
-    underline: zod_1.z.boolean(),
-    code: zod_1.z.boolean(),
-    color: zod_1.z.enum(colors_1.NOTION_COLORS),
+const annotationsSchema = z.object({
+    bold: z.boolean(),
+    italic: z.boolean(),
+    strikethrough: z.boolean(),
+    underline: z.boolean(),
+    code: z.boolean(),
+    color: z.enum(colors_1.NOTION_COLORS),
 });
 /** Text content with optional link. */
-const textContentSchema = zod_1.z.object({
-    content: zod_1.z.string(),
-    link: zod_1.z.object({ url: zod_1.z.url() }).nullable(),
+const textContentSchema = z.object({
+    // eslint-disable-next-line zod/prefer-string-schema-with-trim -- content must preserve whitespace from Notion API
+    content: z.string(),
+    link: z.object({ url: z.url() }).nullable(),
 });
 /** Mention types. */
-const databaseMentionSchema = zod_1.z.object({
-    type: zod_1.z.literal('database'),
-    database: zod_1.z.object({
-        id: zod_1.z.uuid(),
+const databaseMentionSchema = z.object({
+    type: z.literal('database'),
+    database: z.object({
+        id: z.uuid(),
     }),
 });
-const dateMentionSchema = zod_1.z.object({
-    type: zod_1.z.literal('date'),
-    date: zod_1.z.object({
-        start: zod_1.z.string(),
-        end: zod_1.z.string().nullable(),
-        time_zone: zod_1.z.string().nullable().optional(),
+const dateMentionSchema = z.object({
+    type: z.literal('date'),
+    date: z.object({
+        start: shared_schema_1.notionDateStringSchema,
+        end: shared_schema_1.notionDateStringSchema.nullable(),
+        time_zone: z.string().trim().nullable().optional(),
     }),
 });
-const linkPreviewMentionSchema = zod_1.z.object({
-    type: zod_1.z.literal('link_preview'),
-    link_preview: zod_1.z.object({
-        url: zod_1.z.url(),
+const linkPreviewMentionSchema = z.object({
+    type: z.literal('link_preview'),
+    link_preview: z.object({
+        url: z.url(),
     }),
 });
-const pageMentionSchema = zod_1.z.object({
-    type: zod_1.z.literal('page'),
-    page: zod_1.z.object({
-        id: zod_1.z.uuid(),
+const pageMentionSchema = z.object({
+    type: z.literal('page'),
+    page: z.object({
+        id: z.uuid(),
     }),
 });
-const templateMentionDateSchema = zod_1.z.object({
-    type: zod_1.z.literal('template_mention_date'),
-    template_mention_date: zod_1.z.enum(['today', 'now']),
+const templateMentionDateSchema = z.object({
+    type: z.literal('template_mention_date'),
+    template_mention_date: z.enum(['today', 'now']),
 });
-const templateMentionUserSchema = zod_1.z.object({
-    type: zod_1.z.literal('template_mention_user'),
-    template_mention_user: zod_1.z.literal('me'),
+const templateMentionUserSchema = z.object({
+    type: z.literal('template_mention_user'),
+    template_mention_user: z.literal('me'),
 });
-const templateMentionSchema = zod_1.z.object({
-    type: zod_1.z.literal('template_mention'),
-    template_mention: zod_1.z.discriminatedUnion('type', [
+const templateMentionSchema = z.object({
+    type: z.literal('template_mention'),
+    template_mention: z.discriminatedUnion('type', [
         templateMentionDateSchema,
         templateMentionUserSchema,
     ]),
 });
-const userMentionSchema = zod_1.z.object({
-    type: zod_1.z.literal('user'),
+const userMentionSchema = z.object({
+    type: z.literal('user'),
     user: user_schema_1.userSchema,
 });
-const mentionSchema = zod_1.z.discriminatedUnion('type', [
+const mentionSchema = z.discriminatedUnion('type', [
     databaseMentionSchema,
     dateMentionSchema,
     linkPreviewMentionSchema,
@@ -83,29 +118,33 @@ const mentionSchema = zod_1.z.discriminatedUnion('type', [
     userMentionSchema,
 ]);
 /** Text rich text type. */
-const textRichTextSchema = zod_1.z.object({
-    type: zod_1.z.literal('text'),
+const textRichTextSchema = z.object({
+    type: z.literal('text'),
     text: textContentSchema,
     annotations: annotationsSchema,
-    plain_text: zod_1.z.string(),
-    href: zod_1.z.url().nullable(),
+    // eslint-disable-next-line zod/prefer-string-schema-with-trim -- plain_text must preserve whitespace from Notion API
+    plain_text: z.string(),
+    href: z.url().nullable(),
 });
 /** Mention rich text type. */
-const mentionRichTextSchema = zod_1.z.object({
-    type: zod_1.z.literal('mention'),
+const mentionRichTextSchema = z.object({
+    type: z.literal('mention'),
     mention: mentionSchema,
     annotations: annotationsSchema,
-    plain_text: zod_1.z.string(),
-    href: zod_1.z.url().nullable(),
+    // eslint-disable-next-line zod/prefer-string-schema-with-trim -- plain_text must preserve whitespace from Notion API
+    plain_text: z.string(),
+    href: z.url().nullable(),
 });
 /** Equation rich text type. */
-const equationRichTextSchema = zod_1.z.object({
-    type: zod_1.z.literal('equation'),
-    equation: zod_1.z.object({
-        expression: zod_1.z.string(),
+const equationRichTextSchema = z.object({
+    type: z.literal('equation'),
+    equation: z.object({
+        // eslint-disable-next-line zod/prefer-string-schema-with-trim -- LaTeX expression must preserve whitespace from Notion API
+        expression: z.string(),
     }),
     annotations: annotationsSchema,
-    plain_text: zod_1.z.string(),
-    href: zod_1.z.url().nullable(),
+    // eslint-disable-next-line zod/prefer-string-schema-with-trim -- plain_text must preserve whitespace from Notion API
+    plain_text: z.string(),
+    href: z.url().nullable(),
 });
-exports.richTextSchema = zod_1.z.array(zod_1.z.discriminatedUnion('type', [textRichTextSchema, mentionRichTextSchema, equationRichTextSchema]));
+exports.richTextSchema = z.array(z.discriminatedUnion('type', [textRichTextSchema, mentionRichTextSchema, equationRichTextSchema]));

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

@@ -0,0 +1,15 @@
+import * as z from 'zod';
+/**
+ * Shared schema definitions used across multiple schema files.
+ *
+ * This file contains common schemas to avoid circular dependencies.
+ */
+/**
+ * Notion date string schema.
+ *
+ * Validates ISO 8601 date strings as returned by the Notion API.
+ * Accepts both date-only format ("2023-02-23") and full datetime format ("2023-02-23T00:00:00.000Z").
+ *
+ * According to Notion API docs, date fields contain "A date, with an optional time".
+ */
+export declare const notionDateStringSchema: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>;

package/dist/schemas/shared.schema.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notionDateStringSchema = void 0;
+const z = __importStar(require("zod"));
+/**
+ * Shared schema definitions used across multiple schema files.
+ *
+ * This file contains common schemas to avoid circular dependencies.
+ */
+/**
+ * Notion date string schema.
+ *
+ * Validates ISO 8601 date strings as returned by the Notion API.
+ * Accepts both date-only format ("2023-02-23") and full datetime format ("2023-02-23T00:00:00.000Z").
+ *
+ * According to Notion API docs, date fields contain "A date, with an optional time".
+ */
+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"
+]);

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

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 /** Person user with email. */
 declare const personUserSchema: z.ZodObject<{
     object: z.ZodLiteral<"user">;
@@ -27,7 +27,7 @@ declare const botUserSchema: z.ZodObject<{
         workspace_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         workspace_id: z.ZodOptional<z.ZodString>;
         workspace_limits: z.ZodOptional<z.ZodObject<{
-            max_file_upload_size_in_bytes: z.ZodNumber;
+            max_file_upload_size_in_bytes: z.ZodInt;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -61,7 +61,7 @@ export declare const userSchema: z.ZodUnion<readonly [z.ZodObject<{
         workspace_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         workspace_id: z.ZodOptional<z.ZodString>;
         workspace_limits: z.ZodOptional<z.ZodObject<{
-            max_file_upload_size_in_bytes: z.ZodNumber;
+            max_file_upload_size_in_bytes: z.ZodInt;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{

package/dist/schemas/user.schema.js

@@ -1,7 +1,40 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.userSchema = void 0;
-const zod_1 = require("zod");
+const z = __importStar(require("zod"));
 /**
  * Notion user object schemas.
  *
@@ -12,47 +45,47 @@ const zod_1 = require("zod");
  * https://developers.notion.com/reference/user
  */
 /** Bot owner information. */
-const botOwnerSchema = zod_1.z.discriminatedUnion('type', [
-    zod_1.z.object({
-        type: zod_1.z.literal('workspace'),
-        workspace: zod_1.z.literal(true),
+const botOwnerSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('workspace'),
+        workspace: z.literal(true),
     }),
-    zod_1.z.object({
-        type: zod_1.z.literal('user'),
+    z.object({
+        type: z.literal('user'),
     }),
 ]);
 /** Person user with email. */
-const personUserSchema = zod_1.z.object({
-    object: zod_1.z.literal('user'),
-    id: zod_1.z.uuid(),
-    type: zod_1.z.literal('person'),
-    name: zod_1.z.string().optional(),
-    avatar_url: zod_1.z.union([zod_1.z.url(), zod_1.z.null()]).optional(),
-    person: zod_1.z.object({
-        email: zod_1.z.email(),
+const personUserSchema = z.object({
+    object: z.literal('user'),
+    id: z.uuid(),
+    type: z.literal('person'),
+    name: z.string().trim().optional(),
+    avatar_url: z.union([z.url(), z.null()]).optional(),
+    person: z.object({
+        email: z.email(),
     }),
 });
 /** Bot user with owner and workspace information. */
-const botUserSchema = zod_1.z.object({
-    object: zod_1.z.literal('user'),
-    id: zod_1.z.uuid(),
-    type: zod_1.z.literal('bot'),
-    name: zod_1.z.string().optional(),
-    avatar_url: zod_1.z.union([zod_1.z.url(), zod_1.z.null()]).optional(),
-    bot: zod_1.z.object({
+const botUserSchema = z.object({
+    object: z.literal('user'),
+    id: z.uuid(),
+    type: z.literal('bot'),
+    name: z.string().trim().optional(),
+    avatar_url: z.union([z.url(), z.null()]).optional(),
+    bot: z.object({
         owner: botOwnerSchema,
-        workspace_name: zod_1.z.string().nullable().optional(),
-        workspace_id: zod_1.z.string().optional(),
-        workspace_limits: zod_1.z
+        workspace_name: z.string().trim().nullable().optional(),
+        workspace_id: z.string().trim().optional(),
+        workspace_limits: z
             .object({
-            max_file_upload_size_in_bytes: zod_1.z.number().int(),
+            max_file_upload_size_in_bytes: z.int(),
         })
             .optional(),
     }),
 });
 /** Partial user (only object and id, used in created_by/last_edited_by). */
-const partialUserSchema = zod_1.z.object({
-    object: zod_1.z.literal('user'),
-    id: zod_1.z.uuid(),
+const partialUserSchema = z.object({
+    object: z.literal('user'),
+    id: z.uuid(),
 });
-exports.userSchema = zod_1.z.union([personUserSchema, botUserSchema, partialUserSchema]);
+exports.userSchema = z.union([personUserSchema, botUserSchema, partialUserSchema]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visus-io/notion-sdk-ts",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "private": false,
   "description": "TypeScript SDK for the Notion API",
   "keywords": [
@@ -68,6 +68,7 @@
     "@types/node": "^25.2.1",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
+    "eslint-plugin-zod": "3.4.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "prettier": "^3.8.1",
@@ -77,6 +78,7 @@
     "vitest": "^4.0.18"
   },
   "engines": {
+    "bun": ">=1.3.10",
     "node": ">=18.0.0"
   }
 }