@visus-io/notion-sdk-ts 3.1.0 → 3.1.1

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

@@ -2,13 +2,16 @@ import * as z from 'zod';
 /**
  * Notion parent object schemas.
  *
- * Parent objects define the location/container of pages and blocks within Notion.
+ * Parent objects identify the container of a page or block within Notion.
  * A parent can be a database, data source, page, workspace, or block.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/parent-object
  */
-/** Database parent. */
+/** Database parent.
+ *
+ * @category Shared Types
+ */
 export declare const databaseParentSchema: z.ZodObject<{
     type: z.ZodLiteral<"database_id">;
     database_id: z.ZodUUID;
@@ -39,6 +42,9 @@ declare const agentParentSchema: z.ZodObject<{
     type: z.ZodLiteral<"agent_id">;
     agent_id: z.ZodUUID;
 }, z.core.$strip>;
+/**
+ * @category Shared Types
+ */
 export declare const parentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"database_id">;
     database_id: z.ZodUUID;
@@ -59,11 +65,32 @@ export declare const parentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"agent_id">;
     agent_id: z.ZodUUID;
 }, z.core.$strip>], "type">;
+/**
+ * @category Shared Types
+ */
 export type NotionParent = z.infer<typeof parentSchema>;
+/**
+ * @category Shared Types
+ */
 export type DatabaseParent = z.infer<typeof databaseParentSchema>;
+/**
+ * @category Shared Types
+ */
 export type DataSourceParent = z.infer<typeof dataSourceParentSchema>;
+/**
+ * @category Shared Types
+ */
 export type PageParent = z.infer<typeof pageParentSchema>;
+/**
+ * @category Shared Types
+ */
 export type WorkspaceParent = z.infer<typeof workspaceParentSchema>;
+/**
+ * @category Shared Types
+ */
 export type BlockParent = z.infer<typeof blockParentSchema>;
+/**
+ * @category Shared Types
+ */
 export type AgentParent = z.infer<typeof agentParentSchema>;
 export {};

package/dist/schemas/parent.schema.js

@@ -38,13 +38,16 @@ const z = __importStar(require("zod"));
 /**
  * Notion parent object schemas.
  *
- * Parent objects define the location/container of pages and blocks within Notion.
+ * Parent objects identify the container of a page or block within Notion.
  * A parent can be a database, data source, page, workspace, or block.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/parent-object
  */
-/** Database parent. */
+/** Database parent.
+ *
+ * @category Shared Types
+ */
 exports.databaseParentSchema = z.object({
     type: z.literal('database_id'),
     database_id: z.uuid(),
@@ -75,6 +78,9 @@ const agentParentSchema = z.object({
     type: z.literal('agent_id'),
     agent_id: z.uuid(),
 });
+/**
+ * @category Shared Types
+ */
 exports.parentSchema = z.discriminatedUnion('type', [
     exports.databaseParentSchema,
     dataSourceParentSchema,

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

@@ -300,7 +300,7 @@ declare const statusPropertySchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
-/** Title property configuration (empty object) - all data sources require exactly one */
+/** Title property configuration (empty object). Every data source requires exactly one. */
 declare const titlePropertySchema: z.ZodObject<{
     type: z.ZodLiteral<"title">;
     id: z.ZodString;
@@ -328,7 +328,9 @@ declare const uniqueIdPropertySchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Discriminated union of all data source property object types.
- * These define the schema/configuration for a data source (not the values).
+ * Together they define the configuration for a data source, not the values.
+ *
+ * @category Page Properties
  */
 export declare const propertyObjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"checkbox">;
@@ -614,7 +616,11 @@ export declare const propertyObjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         prefix: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>], "type">;
-/** Record of property objects keyed by property name */
+/**
+ * Record of property objects keyed by property name.
+ *
+ * @category Page Properties
+ */
 export declare const propertiesObjectSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"checkbox">;
     id: z.ZodString;
@@ -899,28 +905,100 @@ export declare const propertiesObjectSchema: z.ZodRecord<z.ZodString, z.ZodDiscr
         prefix: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>], "type">>;
+/**
+ * @category Page Properties
+ */
 export type NotionPropertyObject = z.infer<typeof propertyObjectSchema>;
+/**
+ * @category Page Properties
+ */
 export type NotionPropertiesObject = z.infer<typeof propertiesObjectSchema>;
+/**
+ * @category Page Properties
+ */
 export type CheckboxPropertyObject = z.infer<typeof checkboxPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type CreatedByPropertyObject = z.infer<typeof createdByPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type CreatedTimePropertyObject = z.infer<typeof createdTimePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type DatePropertyObject = z.infer<typeof datePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type EmailPropertyObject = z.infer<typeof emailPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type FilesPropertyObject = z.infer<typeof filesPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type FormulaPropertyObject = z.infer<typeof formulaPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type LastEditedByPropertyObject = z.infer<typeof lastEditedByPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type LastEditedTimePropertyObject = z.infer<typeof lastEditedTimePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type MultiSelectPropertyObject = z.infer<typeof multiSelectPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type NumberPropertyObject = z.infer<typeof numberPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type PeoplePropertyObject = z.infer<typeof peoplePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type PhoneNumberPropertyObject = z.infer<typeof phoneNumberPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type PlacePropertyObject = z.infer<typeof placePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type RelationPropertyObject = z.infer<typeof relationPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type RichTextPropertyObject = z.infer<typeof richTextPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type RollupPropertyObject = z.infer<typeof rollupPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type SelectPropertyObject = z.infer<typeof selectPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type StatusPropertyObject = z.infer<typeof statusPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type TitlePropertyObject = z.infer<typeof titlePropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type UrlPropertyObject = z.infer<typeof urlPropertySchema>;
+/**
+ * @category Page Properties
+ */
 export type UniqueIdPropertyObject = z.infer<typeof uniqueIdPropertySchema>;
 export {};

package/dist/schemas/propertyObjects.schema.js

@@ -36,8 +36,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.propertiesObjectSchema = exports.propertyObjectSchema = void 0;
 const z = __importStar(require("zod"));
 /**
- * Data source property objects define the schema/configuration for a data source.
- * These are different from page property values (which contain the actual data).
+ * Data source property objects define the schema and configuration for a data source.
+ * Page property values contain the actual data instead.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/property-object
@@ -318,7 +318,7 @@ const statusPropertySchema = z.object({
         groups: z.array(statusGroupSchema),
     }),
 });
-/** Title property configuration (empty object) - all data sources require exactly one */
+/** Title property configuration (empty object). Every data source requires exactly one. */
 const titlePropertySchema = z.object({
     type: z.literal('title'),
     id: z.string().trim(),
@@ -346,7 +346,9 @@ const uniqueIdPropertySchema = z.object({
 });
 /**
  * Discriminated union of all data source property object types.
- * These define the schema/configuration for a data source (not the values).
+ * Together they define the configuration for a data source, not the values.
+ *
+ * @category Page Properties
  */
 exports.propertyObjectSchema = z.discriminatedUnion('type', [
     checkboxPropertySchema,
@@ -372,5 +374,9 @@ exports.propertyObjectSchema = z.discriminatedUnion('type', [
     urlPropertySchema,
     uniqueIdPropertySchema,
 ]);
-/** Record of property objects keyed by property name */
+/**
+ * Record of property objects keyed by property name.
+ *
+ * @category Page Properties
+ */
 exports.propertiesObjectSchema = z.record(z.string().trim(), exports.propertyObjectSchema);

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

@@ -180,6 +180,9 @@ declare const equationRichTextSchema: z.ZodObject<{
     plain_text: z.ZodString;
     href: z.ZodNullable<z.ZodURL>;
 }, z.core.$strip>;
+/**
+ * @category Rich Text
+ */
 export declare const richTextSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text">;
     text: z.ZodObject<{
@@ -356,8 +359,20 @@ export declare const richTextSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodOb
     plain_text: z.ZodString;
     href: z.ZodNullable<z.ZodURL>;
 }, z.core.$strip>], "type">>;
+/**
+ * @category Rich Text
+ */
 export type NotionRichText = z.infer<typeof richTextSchema>;
+/**
+ * @category Rich Text
+ */
 export type TextRichText = z.infer<typeof textRichTextSchema>;
+/**
+ * @category Rich Text
+ */
 export type MentionRichText = z.infer<typeof mentionRichTextSchema>;
+/**
+ * @category Rich Text
+ */
 export type EquationRichText = z.infer<typeof equationRichTextSchema>;
 export {};

package/dist/schemas/richText.schema.js

@@ -41,9 +41,9 @@ const user_schema_1 = require("./user.schema");
 /**
  * Notion rich text object schema.
  *
- * Rich text is used throughout the API for formatted text content. It supports
- * three types: text (with optional links), mentions (users, pages, dates, etc.),
- * and equations (LaTeX). All types support styling via annotations.
+ * Notion uses rich text throughout the API for formatted text content. It supports
+ * three types: text with optional links, mentions of users, pages, dates, and other
+ * objects, and equations in LaTeX. You can style all types with annotations.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/rich-text
@@ -147,4 +147,7 @@ const equationRichTextSchema = z.object({
     plain_text: z.string(),
     href: z.url().nullable(),
 });
+/**
+ * @category Rich Text
+ */
 exports.richTextSchema = z.array(z.discriminatedUnion('type', [textRichTextSchema, mentionRichTextSchema, equationRichTextSchema]));

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

@@ -7,9 +7,12 @@ import * as z from 'zod';
 /**
  * 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").
+ * 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").
  *
- * According to Notion API docs, date fields contain "A date, with an optional time".
+ * The Notion API docs describe date fields as "A date, with an optional time".
+ *
+ * @category Shared Types
  */
 export declare const notionDateStringSchema: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodISODate]>;

package/dist/schemas/shared.schema.js

@@ -43,10 +43,13 @@ const z = __importStar(require("zod"));
 /**
  * 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").
+ * 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").
  *
- * According to Notion API docs, date fields contain "A date, with an optional time".
+ * The Notion API docs describe date fields as "A date, with an optional time".
+ *
+ * @category Shared Types
  */
 exports.notionDateStringSchema = z.union([
     z.iso.datetime(), // Full ISO 8601 datetime: "2023-02-23T00:00:00.000Z"

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

@@ -37,6 +37,9 @@ declare const partialUserSchema: z.ZodObject<{
     object: z.ZodLiteral<"user">;
     id: z.ZodUUID;
 }, z.core.$strip>;
+/**
+ * @category Users
+ */
 export declare const userSchema: z.ZodUnion<readonly [z.ZodObject<{
     object: z.ZodLiteral<"user">;
     id: z.ZodUUID;
@@ -70,8 +73,20 @@ export declare const userSchema: z.ZodUnion<readonly [z.ZodObject<{
     object: z.ZodLiteral<"user">;
     id: z.ZodUUID;
 }, z.core.$strip>]>;
+/**
+ * @category Users
+ */
 export type NotionUser = z.infer<typeof userSchema>;
+/**
+ * @category Users
+ */
 export type PersonUser = z.infer<typeof personUserSchema>;
+/**
+ * @category Users
+ */
 export type BotUser = z.infer<typeof botUserSchema>;
+/**
+ * @category Users
+ */
 export type PartialUser = z.infer<typeof partialUserSchema>;
 export {};

package/dist/schemas/user.schema.js

@@ -38,8 +38,8 @@ const z = __importStar(require("zod"));
 /**
  * Notion user object schemas.
  *
- * Users can be people, bots, or partial user objects (just id and object type).
- * Used throughout the API for created_by and last_edited_by fields.
+ * Users can be people, bots, or partial user objects (only id and object type).
+ * The created_by and last_edited_by fields use this schema throughout the API.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/user
@@ -89,4 +89,7 @@ const partialUserSchema = z.object({
     object: z.literal('user'),
     id: z.uuid(),
 });
+/**
+ * @category Users
+ */
 exports.userSchema = z.union([personUserSchema, botUserSchema, partialUserSchema]);

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

@@ -2,19 +2,30 @@ import * as z from 'zod';
 /**
  * View object schema.
  *
- * Views control how a database/data source's rows are displayed (table, board,
- * calendar, etc.). As of API version 2025-09-03, views have their own endpoints.
+ * A view controls how a database or data source displays its rows, for example as a
+ * table, board, or calendar. As of API version 2025-09-03, views have their own
+ * endpoints.
  *
  * Notion API reference:
  * https://developers.notion.com/guides/data-apis/working-with-views
+ *
+ * @category Views
  */
 export declare const VIEW_TYPES: readonly ["table", "board", "list", "calendar", "timeline", "gallery", "form", "chart", "map", "dashboard"];
+/**
+ * @category Views
+ */
 export type ViewType = (typeof VIEW_TYPES)[number];
 /**
- * Per-layout view configuration. Exact per-type fields (e.g. table column order, board
- * group-by property) haven't been confirmed against a live response, so this is kept
- * permissive -- tagged on `type`, with all other fields passed through unmodeled -- so
- * unknown fields round-trip instead of being stripped or rejected.
+ * Configuration for a single view layout.
+ *
+ * Notion has not confirmed the exact fields for each view type against a live
+ * response. Examples include the table column order and the board group-by
+ * property. This schema stays permissive. It tags the object by its `type`
+ * field and passes all other fields through without validation. As a result,
+ * unknown fields round-trip unchanged instead of the schema rejecting them.
+ *
+ * @category Views
  */
 export declare const viewConfigurationSchema: z.ZodObject<{
     type: z.ZodEnum<{
@@ -30,7 +41,13 @@ export declare const viewConfigurationSchema: z.ZodObject<{
         dashboard: "dashboard";
     }>;
 }, z.core.$catchall<z.ZodUnknown>>;
+/**
+ * @category Views
+ */
 export type ViewConfiguration = z.infer<typeof viewConfigurationSchema>;
+/**
+ * @category Views
+ */
 export declare const viewSchema: z.ZodObject<{
     object: z.ZodLiteral<"view">;
     id: z.ZodUUID;
@@ -140,8 +157,16 @@ export declare const viewSchema: z.ZodObject<{
     url: z.ZodURL;
     dashboard_view_id: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strip>;
+/**
+ * @category Views
+ */
 export type NotionView = z.infer<typeof viewSchema>;
-/** Delete-a-view returns a partial object: only object/id/parent/type. */
+/**
+ * Notion's delete-view response includes only `object`, `id`, `parent`, and `type`.
+ * It omits the rest of the view shape.
+ *
+ * @category Views
+ */
 export declare const viewDeleteResponseSchema: z.ZodObject<{
     object: z.ZodLiteral<"view">;
     id: z.ZodUUID;
@@ -162,10 +187,16 @@ export declare const viewDeleteResponseSchema: z.ZodObject<{
         dashboard: "dashboard";
     }>;
 }, z.core.$strip>;
+/**
+ * @category Views
+ */
 export type ViewDeleteResult = z.infer<typeof viewDeleteResponseSchema>;
 /**
- * View query response schema. Non-standard pagination shape: `object: "view_query"`,
- * plus `expires_at`/`total_count`; queries expire roughly 15 minutes after creation.
+ * View query response schema. This response has a non-standard pagination shape:
+ * `object: "view_query"`, plus `expires_at` and `total_count`. Queries expire
+ * about 15 minutes after creation.
+ *
+ * @category Views
  */
 export declare const viewQueryResponseSchema: z.ZodObject<{
     object: z.ZodLiteral<"view_query">;
@@ -1074,4 +1105,7 @@ export declare const viewQueryResponseSchema: z.ZodObject<{
         }>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * @category Views
+ */
 export type ViewQueryResponse = z.infer<typeof viewQueryResponseSchema>;

package/dist/schemas/view.schema.js

@@ -43,11 +43,14 @@ const user_schema_1 = require("./user.schema");
 /**
  * View object schema.
  *
- * Views control how a database/data source's rows are displayed (table, board,
- * calendar, etc.). As of API version 2025-09-03, views have their own endpoints.
+ * A view controls how a database or data source displays its rows, for example as a
+ * table, board, or calendar. As of API version 2025-09-03, views have their own
+ * endpoints.
  *
  * Notion API reference:
  * https://developers.notion.com/guides/data-apis/working-with-views
+ *
+ * @category Views
  */
 exports.VIEW_TYPES = [
     'table',
@@ -62,16 +65,24 @@ exports.VIEW_TYPES = [
     'dashboard',
 ];
 /**
- * Per-layout view configuration. Exact per-type fields (e.g. table column order, board
- * group-by property) haven't been confirmed against a live response, so this is kept
- * permissive -- tagged on `type`, with all other fields passed through unmodeled -- so
- * unknown fields round-trip instead of being stripped or rejected.
+ * Configuration for a single view layout.
+ *
+ * Notion has not confirmed the exact fields for each view type against a live
+ * response. Examples include the table column order and the board group-by
+ * property. This schema stays permissive. It tags the object by its `type`
+ * field and passes all other fields through without validation. As a result,
+ * unknown fields round-trip unchanged instead of the schema rejecting them.
+ *
+ * @category Views
  */
 exports.viewConfigurationSchema = z
     .object({
     type: z.enum(exports.VIEW_TYPES),
 })
     .catchall(z.unknown());
+/**
+ * @category Views
+ */
 exports.viewSchema = z.object({
     object: z.literal('view'),
     id: z.uuid(),
@@ -91,7 +102,12 @@ exports.viewSchema = z.object({
     // Widget/dashboard views only.
     dashboard_view_id: z.uuid().optional(),
 });
-/** Delete-a-view returns a partial object: only object/id/parent/type. */
+/**
+ * Notion's delete-view response includes only `object`, `id`, `parent`, and `type`.
+ * It omits the rest of the view shape.
+ *
+ * @category Views
+ */
 exports.viewDeleteResponseSchema = z.object({
     object: z.literal('view'),
     id: z.uuid(),
@@ -99,8 +115,11 @@ exports.viewDeleteResponseSchema = z.object({
     type: z.enum(exports.VIEW_TYPES),
 });
 /**
- * View query response schema. Non-standard pagination shape: `object: "view_query"`,
- * plus `expires_at`/`total_count`; queries expire roughly 15 minutes after creation.
+ * View query response schema. This response has a non-standard pagination shape:
+ * `object: "view_query"`, plus `expires_at` and `total_count`. Queries expire
+ * about 15 minutes after creation.
+ *
+ * @category Views
  */
 exports.viewQueryResponseSchema = z.object({
     object: z.literal('view_query'),

package/dist/validation.d.ts

@@ -1,7 +1,9 @@
 /**
- * Notion API request size limits.
+ * Maximum sizes the Notion API allows in a request.
  *
  * @see https://developers.notion.com/reference/request-limits#size-limits
+ *
+ * @category Client & Core
  */
 export declare const LIMITS: {
     /** Maximum characters in a single rich text `text.content` field. */
@@ -34,9 +36,10 @@ export declare const LIMITS: {
 /**
  * Thrown when a value exceeds a Notion API size limit.
  *
- * This error is raised client-side *before* the request is sent, giving
- * callers an early, actionable error message instead of a generic 400 from
- * the API.
+ * The SDK throws this error before it sends the request. This gives you an
+ * early, actionable message instead of a generic 400 response from the API.
+ *
+ * @category Errors
  */
 export declare class NotionValidationError extends Error {
     constructor(message: string);
@@ -45,11 +48,15 @@ export declare class NotionValidationError extends Error {
  * Assert that a string does not exceed `maxLength` characters.
  *
  * @throws {NotionValidationError}
+ *
+ * @category Client & Core
  */
 export declare function validateStringLength(value: string, maxLength: number, label: string): void;
 /**
  * Assert that an array does not exceed `maxLength` elements.
  *
  * @throws {NotionValidationError}
+ *
+ * @category Client & Core
  */
 export declare function validateArrayLength(array: unknown[], maxLength: number, label: string): void;

package/dist/validation.js

@@ -4,9 +4,11 @@ exports.NotionValidationError = exports.LIMITS = void 0;
 exports.validateStringLength = validateStringLength;
 exports.validateArrayLength = validateArrayLength;
 /**
- * Notion API request size limits.
+ * Maximum sizes the Notion API allows in a request.
  *
  * @see https://developers.notion.com/reference/request-limits#size-limits
+ *
+ * @category Client & Core
  */
 exports.LIMITS = {
     /** Maximum characters in a single rich text `text.content` field. */
@@ -39,9 +41,10 @@ exports.LIMITS = {
 /**
  * Thrown when a value exceeds a Notion API size limit.
  *
- * This error is raised client-side *before* the request is sent, giving
- * callers an early, actionable error message instead of a generic 400 from
- * the API.
+ * The SDK throws this error before it sends the request. This gives you an
+ * early, actionable message instead of a generic 400 response from the API.
+ *
+ * @category Errors
  */
 class NotionValidationError extends Error {
     constructor(message) {
@@ -60,6 +63,8 @@ exports.NotionValidationError = NotionValidationError;
  * Assert that a string does not exceed `maxLength` characters.
  *
  * @throws {NotionValidationError}
+ *
+ * @category Client & Core
  */
 function validateStringLength(value, maxLength, label) {
     if (value.length > maxLength) {
@@ -73,6 +78,8 @@ function validateStringLength(value, maxLength, label) {
  * Assert that an array does not exceed `maxLength` elements.
  *
  * @throws {NotionValidationError}
+ *
+ * @category Client & Core
  */
 function validateArrayLength(array, maxLength, label) {
     if (array.length > maxLength) {