@nakanoaas/notion-valibot-schema 0.0.3 → 0.0.5

package/dist/place.cjs

@@ -3,13 +3,141 @@ let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot);
 
 //#region src/place.ts
+/**
+* Schema for a Notion place object structure.
+*
+* **Input:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceObjectSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: v.object({
+*       place: PlaceObjectSchema,
+*     }),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*
+* @internal
+*/
 const PlaceObjectSchema = valibot.object({
 	lat: valibot.number(),
 	lon: valibot.number(),
 	name: valibot.nullish(valibot.string()),
 	address: valibot.nullish(valibot.string())
 });
+/**
+* Schema to extract the `place` property from a Notion page property.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   };
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: PlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*/
 const PlaceSchema = valibot.pipe(valibot.object({ place: PlaceObjectSchema }), valibot.transform((v) => v.place));
+/**
+* Schema to extract the `place` property from a Notion page property or `null`.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   } | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* } | null
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: NullablePlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+* ```
+*/
 const NullablePlaceSchema = valibot.pipe(valibot.object({ place: valibot.nullable(PlaceObjectSchema) }), valibot.transform((v) => v.place));
 
 //#endregion

package/dist/place.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"place.cjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;;;AAEA,MAAM,oBAAoBA,QAAE,OAAO;CAClC,KAAKA,QAAE,QAAQ;CACf,KAAKA,QAAE,QAAQ;CACf,MAAMA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC3B,SAASA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC9B,CAAC;AAEF,MAAa,cAAcA,QAAE,KAC5BA,QAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B;AAED,MAAa,sBAAsBA,QAAE,KACpCA,QAAE,OAAO,EACR,OAAOA,QAAE,SAAS,kBAAkB,EACpC,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B"}
+{"version":3,"file":"place.cjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema for a Notion place object structure.\n *\n * **Input:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceObjectSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: v.object({\n *       place: PlaceObjectSchema,\n *     }),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n *\n * @internal\n */\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\n/**\n * Schema to extract the `place` property from a Notion page property.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   };\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: PlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n */\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\n/**\n * Schema to extract the `place` property from a Notion page property or `null`.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   } | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * } | null\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { NullablePlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: NullablePlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null\n * ```\n */\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,MAAM,oBAAoBA,QAAE,OAAO;CAClC,KAAKA,QAAE,QAAQ;CACf,KAAKA,QAAE,QAAQ;CACf,MAAMA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC3B,SAASA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC9B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CF,MAAa,cAAcA,QAAE,KAC5BA,QAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CD,MAAa,sBAAsBA,QAAE,KACpCA,QAAE,OAAO,EACR,OAAOA,QAAE,SAAS,kBAAkB,EACpC,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B"}

package/dist/place.d.cts

@@ -1,6 +1,49 @@
 import * as v from "valibot";
 
 //#region src/place.d.ts
+
+/**
+ * Schema to extract the `place` property from a Notion page property.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   };
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: PlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+ * ```
+ */
 declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;
@@ -21,6 +64,48 @@ declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   name?: string | null | undefined;
   address?: string | null | undefined;
 }>]>;
+/**
+ * Schema to extract the `place` property from a Notion page property or `null`.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   } | null;
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * } | null
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: NullablePlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+ * ```
+ */
 declare const NullablePlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.NullableSchema<v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;

package/dist/place.d.mts

@@ -1,6 +1,49 @@
 import * as v from "valibot";
 
 //#region src/place.d.ts
+
+/**
+ * Schema to extract the `place` property from a Notion page property.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   };
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: PlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+ * ```
+ */
 declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;
@@ -21,6 +64,48 @@ declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   name?: string | null | undefined;
   address?: string | null | undefined;
 }>]>;
+/**
+ * Schema to extract the `place` property from a Notion page property or `null`.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   } | null;
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * } | null
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: NullablePlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+ * ```
+ */
 declare const NullablePlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.NullableSchema<v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;

package/dist/place.mjs

@@ -1,13 +1,141 @@
 import * as v from "valibot";
 
 //#region src/place.ts
+/**
+* Schema for a Notion place object structure.
+*
+* **Input:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceObjectSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: v.object({
+*       place: PlaceObjectSchema,
+*     }),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*
+* @internal
+*/
 const PlaceObjectSchema = v.object({
 	lat: v.number(),
 	lon: v.number(),
 	name: v.nullish(v.string()),
 	address: v.nullish(v.string())
 });
+/**
+* Schema to extract the `place` property from a Notion page property.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   };
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: PlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*/
 const PlaceSchema = v.pipe(v.object({ place: PlaceObjectSchema }), v.transform((v$1) => v$1.place));
+/**
+* Schema to extract the `place` property from a Notion page property or `null`.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   } | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* } | null
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: NullablePlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+* ```
+*/
 const NullablePlaceSchema = v.pipe(v.object({ place: v.nullable(PlaceObjectSchema) }), v.transform((v$1) => v$1.place));
 
 //#endregion

package/dist/place.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"place.mjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;AAEA,MAAM,oBAAoB,EAAE,OAAO;CAClC,KAAK,EAAE,QAAQ;CACf,KAAK,EAAE,QAAQ;CACf,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC3B,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEF,MAAa,cAAc,EAAE,KAC5B,EAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B;AAED,MAAa,sBAAsB,EAAE,KACpC,EAAE,OAAO,EACR,OAAO,EAAE,SAAS,kBAAkB,EACpC,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B"}
+{"version":3,"file":"place.mjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema for a Notion place object structure.\n *\n * **Input:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceObjectSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: v.object({\n *       place: PlaceObjectSchema,\n *     }),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n *\n * @internal\n */\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\n/**\n * Schema to extract the `place` property from a Notion page property.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   };\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: PlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n */\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\n/**\n * Schema to extract the `place` property from a Notion page property or `null`.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   } | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * } | null\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { NullablePlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: NullablePlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null\n * ```\n */\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,MAAM,oBAAoB,EAAE,OAAO;CAClC,KAAK,EAAE,QAAQ;CACf,KAAK,EAAE,QAAQ;CACf,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC3B,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC9B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CF,MAAa,cAAc,EAAE,KAC5B,EAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CD,MAAa,sBAAsB,EAAE,KACpC,EAAE,OAAO,EACR,OAAO,EAAE,SAAS,kBAAkB,EACpC,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B"}

package/dist/relation.cjs

@@ -3,8 +3,144 @@ let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot);
 
 //#region src/relation.ts
-const RelationSchema = valibot.pipe(valibot.object({ relation: valibot.array(valibot.object({ id: valibot.string() })) }), valibot.transform((v) => v.relation.map((r) => r.id)));
+/**
+* Schema for a Notion relation object structure.
+*
+* **Input:**
+* ```
+* {
+*   id: string;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   id: string;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { InnerRelationSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Relation: v.object({
+*       relation: v.array(InnerRelationSchema),
+*     }),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Relation.relation: Array<{ id: string }>
+* ```
+*
+* @internal
+*/
+const InnerRelationSchema = valibot.object({ id: valibot.string() });
+/**
+* Schema to extract the `relation` property from a Notion page property and transform it to an array of page IDs.
+*
+* **Input:**
+* ```
+* {
+*   relation: Array<{
+*     id: string;
+*   }>;
+* }
+* ```
+*
+* **Output:** `string[]`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { RelationSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     RelatedPages: RelationSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.RelatedPages: string[]
+* ```
+*/
+const RelationSchema = valibot.pipe(valibot.object({ relation: valibot.array(InnerRelationSchema) }), valibot.transform((v) => v.relation.map((r) => r.id)));
+/**
+* Schema to extract the `relation` property from a Notion page property and transform it to a single page ID.
+*
+* **Input:**
+* ```
+* {
+*   relation: [{
+*     id: string;
+*   }];
+* }
+* ```
+*
+* **Output:** `string`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { SingleRelationSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     ParentPage: SingleRelationSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.ParentPage: string
+* ```
+*/
+const SingleRelationSchema = valibot.pipe(valibot.object({ relation: valibot.tuple([InnerRelationSchema]) }), valibot.transform((v) => v.relation[0].id));
+/**
+* Schema to extract the `relation` property from a Notion page property and transform it to a single page ID or `null`.
+*
+* **Input:**
+* ```
+* {
+*   relation: Array<{
+*     id: string;
+*   }>;
+* }
+* ```
+*
+* **Output:** `string | null`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { NullableSingleRelationSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     ParentPage: NullableSingleRelationSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.ParentPage: string | null
+* ```
+*/
+const NullableSingleRelationSchema = valibot.pipe(valibot.object({ relation: valibot.array(InnerRelationSchema) }), valibot.transform((v) => v.relation[0]?.id ?? null));
 
 //#endregion
+exports.NullableSingleRelationSchema = NullableSingleRelationSchema;
 exports.RelationSchema = RelationSchema;
+exports.SingleRelationSchema = SingleRelationSchema;
 //# sourceMappingURL=relation.cjs.map

package/dist/relation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"relation.cjs","names":["v"],"sources":["../src/relation.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nexport const RelationSchema = v.pipe(\n\tv.object({\n\t\trelation: v.array(v.object({ id: v.string() })),\n\t}),\n\tv.transform((v) => v.relation.map((r) => r.id)),\n);\n"],"mappings":";;;;;AAEA,MAAa,iBAAiBA,QAAE,KAC/BA,QAAE,OAAO,EACR,UAAUA,QAAE,MAAMA,QAAE,OAAO,EAAE,IAAIA,QAAE,QAAQ,EAAE,CAAC,CAAC,EAC/C,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,GAAG,CAAC,CAC/C"}
+{"version":3,"file":"relation.cjs","names":["v"],"sources":["../src/relation.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema for a Notion relation object structure.\n *\n * **Input:**\n * ```\n * {\n *   id: string;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   id: string;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { InnerRelationSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Relation: v.object({\n *       relation: v.array(InnerRelationSchema),\n *     }),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Relation.relation: Array<{ id: string }>\n * ```\n *\n * @internal\n */\nconst InnerRelationSchema = v.object({ id: v.string() });\n\n/**\n * Schema to extract the `relation` property from a Notion page property and transform it to an array of page IDs.\n *\n * **Input:**\n * ```\n * {\n *   relation: Array<{\n *     id: string;\n *   }>;\n * }\n * ```\n *\n * **Output:** `string[]`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { RelationSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     RelatedPages: RelationSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.RelatedPages: string[]\n * ```\n */\nexport const RelationSchema = v.pipe(\n\tv.object({\n\t\trelation: v.array(InnerRelationSchema),\n\t}),\n\tv.transform((v) => v.relation.map((r) => r.id)),\n);\n\n/**\n * Schema to extract the `relation` property from a Notion page property and transform it to a single page ID.\n *\n * **Input:**\n * ```\n * {\n *   relation: [{\n *     id: string;\n *   }];\n * }\n * ```\n *\n * **Output:** `string`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { SingleRelationSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     ParentPage: SingleRelationSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.ParentPage: string\n * ```\n */\nexport const SingleRelationSchema = v.pipe(\n\tv.object({\n\t\trelation: v.tuple([InnerRelationSchema]),\n\t}),\n\tv.transform((v) => v.relation[0].id),\n);\n\n/**\n * Schema to extract the `relation` property from a Notion page property and transform it to a single page ID or `null`.\n *\n * **Input:**\n * ```\n * {\n *   relation: Array<{\n *     id: string;\n *   }>;\n * }\n * ```\n *\n * **Output:** `string | null`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { NullableSingleRelationSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     ParentPage: NullableSingleRelationSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.ParentPage: string | null\n * ```\n */\nexport const NullableSingleRelationSchema = v.pipe(\n\tv.object({\n\t\trelation: v.array(InnerRelationSchema),\n\t}),\n\tv.transform((v) => v.relation[0]?.id ?? null),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAM,sBAAsBA,QAAE,OAAO,EAAE,IAAIA,QAAE,QAAQ,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCxD,MAAa,iBAAiBA,QAAE,KAC/BA,QAAE,OAAO,EACR,UAAUA,QAAE,MAAM,oBAAoB,EACtC,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,GAAG,CAAC,CAC/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCD,MAAa,uBAAuBA,QAAE,KACrCA,QAAE,OAAO,EACR,UAAUA,QAAE,MAAM,CAAC,oBAAoB,CAAC,EACxC,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,SAAS,GAAG,GAAG,CACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCD,MAAa,+BAA+BA,QAAE,KAC7CA,QAAE,OAAO,EACR,UAAUA,QAAE,MAAM,oBAAoB,EACtC,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,SAAS,IAAI,MAAM,KAAK,CAC7C"}