@nakanoaas/notion-valibot-schema 0.0.4 → 0.0.5

package/dist/files.mjs

@@ -1,6 +1,45 @@
 import * as v from "valibot";
 
 //#region src/files.ts
+/**
+* Schema to extract the `files` property from a Notion page property and transform it to an array of URLs.
+*
+* **Input:**
+* ```
+* {
+*   files: Array<{
+*     type: "file";
+*     file: {
+*       url: string;
+*     };
+*   } | {
+*     type: "external";
+*     external: {
+*       url: string;
+*     };
+*   }>;
+* }
+* ```
+*
+* **Output:** `string[]`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { FilesSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Files: FilesSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Files: string[]
+* ```
+*/
 const FilesSchema = v.pipe(v.object({ files: v.array(v.variant("type", [v.object({
 	type: v.literal("file"),
 	file: v.object({ url: v.string() })

package/dist/files.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"files.mjs","names":["v"],"sources":["../src/files.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nexport const FilesSchema = v.pipe(\n\tv.object({\n\t\tfiles: v.array(\n\t\t\tv.variant(\"type\", [\n\t\t\t\tv.object({\n\t\t\t\t\ttype: v.literal(\"file\"),\n\t\t\t\t\tfile: v.object({\n\t\t\t\t\t\turl: v.string(),\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t\tv.object({\n\t\t\t\t\ttype: v.literal(\"external\"),\n\t\t\t\t\texternal: v.object({\n\t\t\t\t\t\turl: v.string(),\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t]),\n\t\t),\n\t}),\n\tv.transform((v) =>\n\t\tv.files.map((v) => (v.type === \"file\" ? v.file.url : v.external.url)),\n\t),\n);\n"],"mappings":";;;AAEA,MAAa,cAAc,EAAE,KAC5B,EAAE,OAAO,EACR,OAAO,EAAE,MACR,EAAE,QAAQ,QAAQ,CACjB,EAAE,OAAO;CACR,MAAM,EAAE,QAAQ,OAAO;CACvB,MAAM,EAAE,OAAO,EACd,KAAK,EAAE,QAAQ,EACf,CAAC;CACF,CAAC,EACF,EAAE,OAAO;CACR,MAAM,EAAE,QAAQ,WAAW;CAC3B,UAAU,EAAE,OAAO,EAClB,KAAK,EAAE,QAAQ,EACf,CAAC;CACF,CAAC,CACF,CAAC,CACF,EACD,CAAC,EACF,EAAE,WAAW,QACZA,IAAE,MAAM,KAAK,QAAOA,IAAE,SAAS,SAASA,IAAE,KAAK,MAAMA,IAAE,SAAS,IAAK,CACrE,CACD"}
+{"version":3,"file":"files.mjs","names":["v"],"sources":["../src/files.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema to extract the `files` property from a Notion page property and transform it to an array of URLs.\n *\n * **Input:**\n * ```\n * {\n *   files: Array<{\n *     type: \"file\";\n *     file: {\n *       url: string;\n *     };\n *   } | {\n *     type: \"external\";\n *     external: {\n *       url: string;\n *     };\n *   }>;\n * }\n * ```\n *\n * **Output:** `string[]`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { FilesSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Files: FilesSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Files: string[]\n * ```\n */\nexport const FilesSchema = v.pipe(\n\tv.object({\n\t\tfiles: v.array(\n\t\t\tv.variant(\"type\", [\n\t\t\t\tv.object({\n\t\t\t\t\ttype: v.literal(\"file\"),\n\t\t\t\t\tfile: v.object({\n\t\t\t\t\t\turl: v.string(),\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t\tv.object({\n\t\t\t\t\ttype: v.literal(\"external\"),\n\t\t\t\t\texternal: v.object({\n\t\t\t\t\t\turl: v.string(),\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t]),\n\t\t),\n\t}),\n\tv.transform((v) =>\n\t\tv.files.map((v) => (v.type === \"file\" ? v.file.url : v.external.url)),\n\t),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,MAAa,cAAc,EAAE,KAC5B,EAAE,OAAO,EACR,OAAO,EAAE,MACR,EAAE,QAAQ,QAAQ,CACjB,EAAE,OAAO;CACR,MAAM,EAAE,QAAQ,OAAO;CACvB,MAAM,EAAE,OAAO,EACd,KAAK,EAAE,QAAQ,EACf,CAAC;CACF,CAAC,EACF,EAAE,OAAO;CACR,MAAM,EAAE,QAAQ,WAAW;CAC3B,UAAU,EAAE,OAAO,EAClB,KAAK,EAAE,QAAQ,EACf,CAAC;CACF,CAAC,CACF,CAAC,CACF,EACD,CAAC,EACF,EAAE,WAAW,QACZA,IAAE,MAAM,KAAK,QAAOA,IAAE,SAAS,SAASA,IAAE,KAAK,MAAMA,IAAE,SAAS,IAAK,CACrE,CACD"}

package/dist/formula.cjs

@@ -3,6 +3,78 @@ let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot);
 
 //#region src/formula.ts
+/**
+* Schema factory to extract the `formula` property result from a Notion page property.
+*
+* This is a generic schema factory that accepts another schema as a parameter,
+* allowing you to combine it with other schemas in this library to extract
+* typed formula results. The formula property in Notion can return different
+* types of values (string, number, boolean, or date) depending on the formula
+* configuration.
+*
+* **Input:**
+* ```
+* {
+*   formula: {
+*     type: "string" | "number" | "boolean" | "date";
+*     string?: string | null;
+*     number?: number | null;
+*     boolean?: boolean | null;
+*     date?: {
+*       start: string;
+*       end: string | null;
+*       time_zone: string | null;
+*     } | null;
+*   }
+* }
+* ```
+*
+* **Output:** The output type depends on the schema passed as a parameter.
+* For example, if `RichTextSchema` is passed, the output will be `string`.
+*
+* @param schema - A schema that validates the formula result type.
+*                  Must accept one of: string, number, boolean, or date formula results.
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { FormulaSchema, RichTextSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     FormulaText: FormulaSchema(RichTextSchema),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.FormulaText: string
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { FormulaSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* // Custom schema for number formula
+* const NumberFormulaSchema = v.object({
+*   type: v.literal("number"),
+*   number: v.nullable(v.number()),
+* });
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     FormulaNumber: FormulaSchema(NumberFormulaSchema),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.FormulaNumber: { type: "number"; number: number | null }
+* ```
+*/
 function FormulaSchema(schema) {
 	return valibot.pipe(valibot.object({ formula: schema }), valibot.transform((v) => v.formula));
 }

package/dist/formula.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"formula.cjs","names":["v"],"sources":["../src/formula.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nexport function FormulaSchema<\n\tS extends v.GenericSchema<\n\t\t| { type: \"string\"; string: string | null }\n\t\t| { type: \"number\"; number: number | null }\n\t\t| { type: \"boolean\"; boolean: boolean | null }\n\t\t| {\n\t\t\t\ttype: \"date\";\n\t\t\t\tdate: {\n\t\t\t\t\tstart: string;\n\t\t\t\t\tend: string | null;\n\t\t\t\t\ttime_zone: string | null;\n\t\t\t\t} | null;\n\t\t  },\n\t\tunknown\n\t>,\n>(schema: S) {\n\treturn v.pipe(\n\t\tv.object({\n\t\t\tformula: schema,\n\t\t}),\n\t\t// biome-ignore lint/style/noNonNullAssertion: valibot inference is not working correctly\n\t\tv.transform((v) => v.formula!),\n\t);\n}\n"],"mappings":";;;;;AAEA,SAAgB,cAed,QAAW;AACZ,QAAOA,QAAE,KACRA,QAAE,OAAO,EACR,SAAS,QACT,CAAC,EAEFA,QAAE,WAAW,MAAM,EAAE,QAAS,CAC9B"}
+{"version":3,"file":"formula.cjs","names":["v"],"sources":["../src/formula.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema factory to extract the `formula` property result from a Notion page property.\n *\n * This is a generic schema factory that accepts another schema as a parameter,\n * allowing you to combine it with other schemas in this library to extract\n * typed formula results. The formula property in Notion can return different\n * types of values (string, number, boolean, or date) depending on the formula\n * configuration.\n *\n * **Input:**\n * ```\n * {\n *   formula: {\n *     type: \"string\" | \"number\" | \"boolean\" | \"date\";\n *     string?: string | null;\n *     number?: number | null;\n *     boolean?: boolean | null;\n *     date?: {\n *       start: string;\n *       end: string | null;\n *       time_zone: string | null;\n *     } | null;\n *   }\n * }\n * ```\n *\n * **Output:** The output type depends on the schema passed as a parameter.\n * For example, if `RichTextSchema` is passed, the output will be `string`.\n *\n * @param schema - A schema that validates the formula result type.\n *                  Must accept one of: string, number, boolean, or date formula results.\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { FormulaSchema, RichTextSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     FormulaText: FormulaSchema(RichTextSchema),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.FormulaText: string\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { FormulaSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * // Custom schema for number formula\n * const NumberFormulaSchema = v.object({\n *   type: v.literal(\"number\"),\n *   number: v.nullable(v.number()),\n * });\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     FormulaNumber: FormulaSchema(NumberFormulaSchema),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.FormulaNumber: { type: \"number\"; number: number | null }\n * ```\n */\nexport function FormulaSchema<\n\tS extends v.GenericSchema<\n\t\t| { type: \"string\"; string: string | null }\n\t\t| { type: \"number\"; number: number | null }\n\t\t| { type: \"boolean\"; boolean: boolean | null }\n\t\t| {\n\t\t\t\ttype: \"date\";\n\t\t\t\tdate: {\n\t\t\t\t\tstart: string;\n\t\t\t\t\tend: string | null;\n\t\t\t\t\ttime_zone: string | null;\n\t\t\t\t} | null;\n\t\t  },\n\t\tunknown\n\t>,\n>(schema: S) {\n\treturn v.pipe(\n\t\tv.object({\n\t\t\tformula: schema,\n\t\t}),\n\t\t// biome-ignore lint/style/noNonNullAssertion: valibot inference is not working correctly\n\t\tv.transform((v) => v.formula!),\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,cAed,QAAW;AACZ,QAAOA,QAAE,KACRA,QAAE,OAAO,EACR,SAAS,QACT,CAAC,EAEFA,QAAE,WAAW,MAAM,EAAE,QAAS,CAC9B"}

package/dist/formula.d.cts

@@ -1,6 +1,79 @@
 import * as v from "valibot";
 
 //#region src/formula.d.ts
+
+/**
+ * Schema factory to extract the `formula` property result from a Notion page property.
+ *
+ * This is a generic schema factory that accepts another schema as a parameter,
+ * allowing you to combine it with other schemas in this library to extract
+ * typed formula results. The formula property in Notion can return different
+ * types of values (string, number, boolean, or date) depending on the formula
+ * configuration.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   formula: {
+ *     type: "string" | "number" | "boolean" | "date";
+ *     string?: string | null;
+ *     number?: number | null;
+ *     boolean?: boolean | null;
+ *     date?: {
+ *       start: string;
+ *       end: string | null;
+ *       time_zone: string | null;
+ *     } | null;
+ *   }
+ * }
+ * ```
+ *
+ * **Output:** The output type depends on the schema passed as a parameter.
+ * For example, if `RichTextSchema` is passed, the output will be `string`.
+ *
+ * @param schema - A schema that validates the formula result type.
+ *                  Must accept one of: string, number, boolean, or date formula results.
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { FormulaSchema, RichTextSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     FormulaText: FormulaSchema(RichTextSchema),
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.FormulaText: string
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { FormulaSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * // Custom schema for number formula
+ * const NumberFormulaSchema = v.object({
+ *   type: v.literal("number"),
+ *   number: v.nullable(v.number()),
+ * });
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     FormulaNumber: FormulaSchema(NumberFormulaSchema),
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.FormulaNumber: { type: "number"; number: number | null }
+ * ```
+ */
 declare function FormulaSchema<S extends v.GenericSchema<{
   type: "string";
   string: string | null;

package/dist/formula.d.mts

@@ -1,6 +1,79 @@
 import * as v from "valibot";
 
 //#region src/formula.d.ts
+
+/**
+ * Schema factory to extract the `formula` property result from a Notion page property.
+ *
+ * This is a generic schema factory that accepts another schema as a parameter,
+ * allowing you to combine it with other schemas in this library to extract
+ * typed formula results. The formula property in Notion can return different
+ * types of values (string, number, boolean, or date) depending on the formula
+ * configuration.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   formula: {
+ *     type: "string" | "number" | "boolean" | "date";
+ *     string?: string | null;
+ *     number?: number | null;
+ *     boolean?: boolean | null;
+ *     date?: {
+ *       start: string;
+ *       end: string | null;
+ *       time_zone: string | null;
+ *     } | null;
+ *   }
+ * }
+ * ```
+ *
+ * **Output:** The output type depends on the schema passed as a parameter.
+ * For example, if `RichTextSchema` is passed, the output will be `string`.
+ *
+ * @param schema - A schema that validates the formula result type.
+ *                  Must accept one of: string, number, boolean, or date formula results.
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { FormulaSchema, RichTextSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     FormulaText: FormulaSchema(RichTextSchema),
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.FormulaText: string
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { FormulaSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * // Custom schema for number formula
+ * const NumberFormulaSchema = v.object({
+ *   type: v.literal("number"),
+ *   number: v.nullable(v.number()),
+ * });
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     FormulaNumber: FormulaSchema(NumberFormulaSchema),
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.FormulaNumber: { type: "number"; number: number | null }
+ * ```
+ */
 declare function FormulaSchema<S extends v.GenericSchema<{
   type: "string";
   string: string | null;

package/dist/formula.mjs

@@ -1,6 +1,78 @@
 import * as v from "valibot";
 
 //#region src/formula.ts
+/**
+* Schema factory to extract the `formula` property result from a Notion page property.
+*
+* This is a generic schema factory that accepts another schema as a parameter,
+* allowing you to combine it with other schemas in this library to extract
+* typed formula results. The formula property in Notion can return different
+* types of values (string, number, boolean, or date) depending on the formula
+* configuration.
+*
+* **Input:**
+* ```
+* {
+*   formula: {
+*     type: "string" | "number" | "boolean" | "date";
+*     string?: string | null;
+*     number?: number | null;
+*     boolean?: boolean | null;
+*     date?: {
+*       start: string;
+*       end: string | null;
+*       time_zone: string | null;
+*     } | null;
+*   }
+* }
+* ```
+*
+* **Output:** The output type depends on the schema passed as a parameter.
+* For example, if `RichTextSchema` is passed, the output will be `string`.
+*
+* @param schema - A schema that validates the formula result type.
+*                  Must accept one of: string, number, boolean, or date formula results.
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { FormulaSchema, RichTextSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     FormulaText: FormulaSchema(RichTextSchema),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.FormulaText: string
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { FormulaSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* // Custom schema for number formula
+* const NumberFormulaSchema = v.object({
+*   type: v.literal("number"),
+*   number: v.nullable(v.number()),
+* });
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     FormulaNumber: FormulaSchema(NumberFormulaSchema),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.FormulaNumber: { type: "number"; number: number | null }
+* ```
+*/
 function FormulaSchema(schema) {
 	return v.pipe(v.object({ formula: schema }), v.transform((v$1) => v$1.formula));
 }

package/dist/formula.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"formula.mjs","names":["v"],"sources":["../src/formula.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nexport function FormulaSchema<\n\tS extends v.GenericSchema<\n\t\t| { type: \"string\"; string: string | null }\n\t\t| { type: \"number\"; number: number | null }\n\t\t| { type: \"boolean\"; boolean: boolean | null }\n\t\t| {\n\t\t\t\ttype: \"date\";\n\t\t\t\tdate: {\n\t\t\t\t\tstart: string;\n\t\t\t\t\tend: string | null;\n\t\t\t\t\ttime_zone: string | null;\n\t\t\t\t} | null;\n\t\t  },\n\t\tunknown\n\t>,\n>(schema: S) {\n\treturn v.pipe(\n\t\tv.object({\n\t\t\tformula: schema,\n\t\t}),\n\t\t// biome-ignore lint/style/noNonNullAssertion: valibot inference is not working correctly\n\t\tv.transform((v) => v.formula!),\n\t);\n}\n"],"mappings":";;;AAEA,SAAgB,cAed,QAAW;AACZ,QAAO,EAAE,KACR,EAAE,OAAO,EACR,SAAS,QACT,CAAC,EAEF,EAAE,WAAW,QAAMA,IAAE,QAAS,CAC9B"}
+{"version":3,"file":"formula.mjs","names":["v"],"sources":["../src/formula.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema factory to extract the `formula` property result from a Notion page property.\n *\n * This is a generic schema factory that accepts another schema as a parameter,\n * allowing you to combine it with other schemas in this library to extract\n * typed formula results. The formula property in Notion can return different\n * types of values (string, number, boolean, or date) depending on the formula\n * configuration.\n *\n * **Input:**\n * ```\n * {\n *   formula: {\n *     type: \"string\" | \"number\" | \"boolean\" | \"date\";\n *     string?: string | null;\n *     number?: number | null;\n *     boolean?: boolean | null;\n *     date?: {\n *       start: string;\n *       end: string | null;\n *       time_zone: string | null;\n *     } | null;\n *   }\n * }\n * ```\n *\n * **Output:** The output type depends on the schema passed as a parameter.\n * For example, if `RichTextSchema` is passed, the output will be `string`.\n *\n * @param schema - A schema that validates the formula result type.\n *                  Must accept one of: string, number, boolean, or date formula results.\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { FormulaSchema, RichTextSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     FormulaText: FormulaSchema(RichTextSchema),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.FormulaText: string\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { FormulaSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * // Custom schema for number formula\n * const NumberFormulaSchema = v.object({\n *   type: v.literal(\"number\"),\n *   number: v.nullable(v.number()),\n * });\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     FormulaNumber: FormulaSchema(NumberFormulaSchema),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.FormulaNumber: { type: \"number\"; number: number | null }\n * ```\n */\nexport function FormulaSchema<\n\tS extends v.GenericSchema<\n\t\t| { type: \"string\"; string: string | null }\n\t\t| { type: \"number\"; number: number | null }\n\t\t| { type: \"boolean\"; boolean: boolean | null }\n\t\t| {\n\t\t\t\ttype: \"date\";\n\t\t\t\tdate: {\n\t\t\t\t\tstart: string;\n\t\t\t\t\tend: string | null;\n\t\t\t\t\ttime_zone: string | null;\n\t\t\t\t} | null;\n\t\t  },\n\t\tunknown\n\t>,\n>(schema: S) {\n\treturn v.pipe(\n\t\tv.object({\n\t\t\tformula: schema,\n\t\t}),\n\t\t// biome-ignore lint/style/noNonNullAssertion: valibot inference is not working correctly\n\t\tv.transform((v) => v.formula!),\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,cAed,QAAW;AACZ,QAAO,EAAE,KACR,EAAE,OAAO,EACR,SAAS,QACT,CAAC,EAEF,EAAE,WAAW,QAAMA,IAAE,QAAS,CAC9B"}

package/dist/last-edited-by.cjs

@@ -4,7 +4,75 @@ let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot);
 
 //#region src/last-edited-by.ts
+/**
+* Schema to extract the `last_edited_by` person name from a Notion page.
+*
+* **Input:**
+* ```
+* {
+*   last_edited_by: {
+*     id: string;
+*     object: "user" | "bot" | "group";
+*     name: string | null;
+*     ...
+*   }
+* }
+* ```
+*
+* **Output:** `string | null`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { NullableLastEditedByNameSchema } from "@nakanoaas/notion-valibot-schema";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     LastEditedByName: NullableLastEditedByNameSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.LastEditedByName: string | null
+* ```
+*/
 const NullableLastEditedByNameSchema = valibot.pipe(valibot.object({ last_edited_by: require_people.PersonSchema }), valibot.transform((v) => v.last_edited_by.name));
+/**
+* Schema to extract the `last_edited_by` person ID from a Notion page.
+*
+* **Input:**
+* ```
+* {
+*   last_edited_by: {
+*     id: string;
+*     object: "user" | "bot" | "group";
+*     name: string | null;
+*     ...
+*   }
+* }
+* ```
+*
+* **Output:** `string`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { LastEditedByIdSchema } from "@nakanoaas/notion-valibot-schema";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     LastEditedById: LastEditedByIdSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.LastEditedById: string
+* ```
+*/
 const LastEditedByIdSchema = valibot.pipe(valibot.object({ last_edited_by: require_people.PersonSchema }), valibot.transform((v) => v.last_edited_by.id));
 
 //#endregion

package/dist/last-edited-by.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"last-edited-by.cjs","names":["v","PersonSchema"],"sources":["../src/last-edited-by.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nimport { PersonSchema } from \"./people\";\n\nexport const NullableLastEditedByNameSchema = v.pipe(\n\tv.object({\n\t\tlast_edited_by: PersonSchema,\n\t}),\n\tv.transform((v) => v.last_edited_by.name),\n);\n\nexport const LastEditedByIdSchema = v.pipe(\n\tv.object({\n\t\tlast_edited_by: PersonSchema,\n\t}),\n\tv.transform((v) => v.last_edited_by.id),\n);\n"],"mappings":";;;;;;AAIA,MAAa,iCAAiCA,QAAE,KAC/CA,QAAE,OAAO,EACR,gBAAgBC,6BAChB,CAAC,EACFD,QAAE,WAAW,MAAM,EAAE,eAAe,KAAK,CACzC;AAED,MAAa,uBAAuBA,QAAE,KACrCA,QAAE,OAAO,EACR,gBAAgBC,6BAChB,CAAC,EACFD,QAAE,WAAW,MAAM,EAAE,eAAe,GAAG,CACvC"}
+{"version":3,"file":"last-edited-by.cjs","names":["v","PersonSchema"],"sources":["../src/last-edited-by.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nimport { PersonSchema } from \"./people\";\n\n/**\n * Schema to extract the `last_edited_by` person name from a Notion page.\n *\n * **Input:**\n * ```\n * {\n *   last_edited_by: {\n *     id: string;\n *     object: \"user\" | \"bot\" | \"group\";\n *     name: string | null;\n *     ...\n *   }\n * }\n * ```\n *\n * **Output:** `string | null`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { NullableLastEditedByNameSchema } from \"@nakanoaas/notion-valibot-schema\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     LastEditedByName: NullableLastEditedByNameSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.LastEditedByName: string | null\n * ```\n */\nexport const NullableLastEditedByNameSchema = v.pipe(\n\tv.object({\n\t\tlast_edited_by: PersonSchema,\n\t}),\n\tv.transform((v) => v.last_edited_by.name),\n);\n\n/**\n * Schema to extract the `last_edited_by` person ID from a Notion page.\n *\n * **Input:**\n * ```\n * {\n *   last_edited_by: {\n *     id: string;\n *     object: \"user\" | \"bot\" | \"group\";\n *     name: string | null;\n *     ...\n *   }\n * }\n * ```\n *\n * **Output:** `string`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { LastEditedByIdSchema } from \"@nakanoaas/notion-valibot-schema\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     LastEditedById: LastEditedByIdSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.LastEditedById: string\n * ```\n */\nexport const LastEditedByIdSchema = v.pipe(\n\tv.object({\n\t\tlast_edited_by: PersonSchema,\n\t}),\n\tv.transform((v) => v.last_edited_by.id),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAa,iCAAiCA,QAAE,KAC/CA,QAAE,OAAO,EACR,gBAAgBC,6BAChB,CAAC,EACFD,QAAE,WAAW,MAAM,EAAE,eAAe,KAAK,CACzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCD,MAAa,uBAAuBA,QAAE,KACrCA,QAAE,OAAO,EACR,gBAAgBC,6BAChB,CAAC,EACFD,QAAE,WAAW,MAAM,EAAE,eAAe,GAAG,CACvC"}

package/dist/last-edited-by.d.cts

@@ -1,6 +1,41 @@
 import * as v from "valibot";
 
 //#region src/last-edited-by.d.ts
+
+/**
+ * Schema to extract the `last_edited_by` person name from a Notion page.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   last_edited_by: {
+ *     id: string;
+ *     object: "user" | "bot" | "group";
+ *     name: string | null;
+ *     ...
+ *   }
+ * }
+ * ```
+ *
+ * **Output:** `string | null`
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { NullableLastEditedByNameSchema } from "@nakanoaas/notion-valibot-schema";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     LastEditedByName: NullableLastEditedByNameSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.LastEditedByName: string | null
+ * ```
+ */
 declare const NullableLastEditedByNameSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly last_edited_by: v.ObjectSchema<{
     readonly id: v.StringSchema<undefined>;
@@ -14,6 +49,40 @@ declare const NullableLastEditedByNameSchema: v.SchemaWithPipe<readonly [v.Objec
     name: string | null;
   };
 }, string | null>]>;
+/**
+ * Schema to extract the `last_edited_by` person ID from a Notion page.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   last_edited_by: {
+ *     id: string;
+ *     object: "user" | "bot" | "group";
+ *     name: string | null;
+ *     ...
+ *   }
+ * }
+ * ```
+ *
+ * **Output:** `string`
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { LastEditedByIdSchema } from "@nakanoaas/notion-valibot-schema";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     LastEditedById: LastEditedByIdSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.LastEditedById: string
+ * ```
+ */
 declare const LastEditedByIdSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly last_edited_by: v.ObjectSchema<{
     readonly id: v.StringSchema<undefined>;

package/dist/last-edited-by.d.mts

@@ -1,6 +1,41 @@
 import * as v from "valibot";
 
 //#region src/last-edited-by.d.ts
+
+/**
+ * Schema to extract the `last_edited_by` person name from a Notion page.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   last_edited_by: {
+ *     id: string;
+ *     object: "user" | "bot" | "group";
+ *     name: string | null;
+ *     ...
+ *   }
+ * }
+ * ```
+ *
+ * **Output:** `string | null`
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { NullableLastEditedByNameSchema } from "@nakanoaas/notion-valibot-schema";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     LastEditedByName: NullableLastEditedByNameSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.LastEditedByName: string | null
+ * ```
+ */
 declare const NullableLastEditedByNameSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly last_edited_by: v.ObjectSchema<{
     readonly id: v.StringSchema<undefined>;
@@ -14,6 +49,40 @@ declare const NullableLastEditedByNameSchema: v.SchemaWithPipe<readonly [v.Objec
     name: string | null;
   };
 }, string | null>]>;
+/**
+ * Schema to extract the `last_edited_by` person ID from a Notion page.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   last_edited_by: {
+ *     id: string;
+ *     object: "user" | "bot" | "group";
+ *     name: string | null;
+ *     ...
+ *   }
+ * }
+ * ```
+ *
+ * **Output:** `string`
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { LastEditedByIdSchema } from "@nakanoaas/notion-valibot-schema";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     LastEditedById: LastEditedByIdSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.LastEditedById: string
+ * ```
+ */
 declare const LastEditedByIdSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly last_edited_by: v.ObjectSchema<{
     readonly id: v.StringSchema<undefined>;