notro-loader 0.0.1 → 0.0.2

package/src/utils/notion-url.ts

@@ -1,49 +1,49 @@
-/**
- * Utilities for handling Notion pre-signed S3 URLs.
- *
- * Notion images use time-limited pre-signed S3 URLs with expiring query
- * parameters (X-Amz-*). These utilities centralise detection and
- * normalisation of such URLs so the knowledge is not duplicated between
- * the loader and the app's image service.
- */
-
-const AMZN_PRESIGNED_PARAM = 'X-Amz-Algorithm';
-
-/**
- * Returns true if the text contains Notion pre-signed S3 URLs.
- *
- * Detection strategy:
- * - X-Amz-Algorithm: must appear as a URL query parameter
- *   (i.e. preceded by "?" or "&" within an https:// URL context) to avoid
- *   false positives when the literal string appears in body text or code blocks.
- * - prod-files-secure.s3: matched as a hostname within an https:// URL, which
- *   is an unambiguous indicator of a Notion S3 URL regardless of query params.
- */
-export function markdownHasPresignedUrls(text: string): boolean {
-	// Match X-Amz-Algorithm only when it appears as a URL query parameter
-	if (/https?:\/\/[^\s)"']*[?&]X-Amz-Algorithm=/.test(text)) {
-		return true;
-	}
-	// Match Notion's secure S3 hostname as a URL
-	if (/https?:\/\/prod-files-secure\.s3/.test(text)) {
-		return true;
-	}
-	return false;
-}
-
-/**
- * Strips expiring query parameters from a Notion pre-signed S3 URL,
- * yielding a stable cache key for Astro's image service.
- * Non-Notion URLs and invalid URLs are returned unchanged.
- */
-export function normalizeNotionPresignedUrl(src: string): string {
-	try {
-		const url = new URL(src);
-		if (url.searchParams.has(AMZN_PRESIGNED_PARAM)) {
-			return `${url.protocol}//${url.hostname}${url.pathname}`;
-		}
-	} catch {
-		// Not a valid URL, return as-is
-	}
-	return src;
-}
+/**
+ * Utilities for handling Notion pre-signed S3 URLs.
+ *
+ * Notion images use time-limited pre-signed S3 URLs with expiring query
+ * parameters (X-Amz-*). These utilities centralise detection and
+ * normalisation of such URLs so the knowledge is not duplicated between
+ * the loader and the app's image service.
+ */
+
+const AMZN_PRESIGNED_PARAM = 'X-Amz-Algorithm';
+
+/**
+ * Returns true if the text contains Notion pre-signed S3 URLs.
+ *
+ * Detection strategy:
+ * - X-Amz-Algorithm: must appear as a URL query parameter
+ *   (i.e. preceded by "?" or "&" within an https:// URL context) to avoid
+ *   false positives when the literal string appears in body text or code blocks.
+ * - prod-files-secure.s3: matched as a hostname within an https:// URL, which
+ *   is an unambiguous indicator of a Notion S3 URL regardless of query params.
+ */
+export function markdownHasPresignedUrls(text: string): boolean {
+	// Match X-Amz-Algorithm only when it appears as a URL query parameter
+	if (/https?:\/\/[^\s)"']*[?&]X-Amz-Algorithm=/.test(text)) {
+		return true;
+	}
+	// Match Notion's secure S3 hostname as a URL
+	if (/https?:\/\/prod-files-secure\.s3/.test(text)) {
+		return true;
+	}
+	return false;
+}
+
+/**
+ * Strips expiring query parameters from a Notion pre-signed S3 URL,
+ * yielding a stable cache key for Astro's image service.
+ * Non-Notion URLs and invalid URLs are returned unchanged.
+ */
+export function normalizeNotionPresignedUrl(src: string): string {
+	try {
+		const url = new URL(src);
+		if (url.searchParams.has(AMZN_PRESIGNED_PARAM)) {
+			return `${url.protocol}//${url.hostname}${url.pathname}`;
+		}
+	} catch {
+		// Not a valid URL, return as-is
+	}
+	return src;
+}

package/src/utils/notion.ts

@@ -1,127 +1,127 @@
-import type { PropertyPageObjectResponseType } from "../loader/schema.ts";
-import type { LinkToPages } from "../types.ts";
-
-export const getPlainText = (
-  property: PropertyPageObjectResponseType,
-): string | undefined => {
-  if (property?.type === "rich_text" && property.rich_text.length > 0) {
-    // rich_text arrays represent adjacent text spans; direct concatenation (no separator) is correct per Notion spec.
-    return property.rich_text.map((t) => t.plain_text).join("");
-  }
-  if (property?.type === "title" && property.title.length > 0) {
-    // title arrays also represent adjacent text spans; direct concatenation is correct.
-    return property.title.map((t) => t.plain_text).join("");
-  }
-  if (property?.type === "select" && property.select?.name !== undefined) {
-    return property.select.name;
-  }
-  if (
-    property?.type === "multi_select" &&
-    property.multi_select !== undefined
-  ) {
-    // Use ", " separator so that multi-select values are human-readable (e.g. "A, B, C").
-    return property.multi_select.map((option) => option.name).join(", ");
-  }
-  if (property?.type === "number" && property.number !== null) {
-    return String(property.number);
-  }
-  if (property?.type === "url") {
-    return property.url ?? undefined;
-  }
-  if (property?.type === "email") {
-    return property.email ?? undefined;
-  }
-  if (property?.type === "phone_number") {
-    return property.phone_number ?? undefined;
-  }
-  if (property?.type === "date" && property.date !== null) {
-    return property.date.start;
-  }
-  if (property?.type === "unique_id" && property.unique_id.number !== null) {
-    return property.unique_id.prefix
-      ? `${property.unique_id.prefix}-${property.unique_id.number}`
-      : String(property.unique_id.number);
-  }
-  return undefined;
-};
-
-/**
- * Returns the multi-select options array from a multi_select property,
- * or an empty array if the property is not a multi_select or is undefined.
- *
- * @example
- * ```ts
- * const tags = getMultiSelect(entry.data.properties.Tags);
- * // Array<{ id: string; name: string; color: string }>
- * tags.forEach(t => console.log(t.name));
- * ```
- */
-export const getMultiSelect = (
-  property: PropertyPageObjectResponseType | undefined,
-): { id: string; name: string; color: string }[] => {
-  if (property?.type === "multi_select") {
-    return property.multi_select;
-  }
-  return [];
-};
-
-/**
- * Returns true if a multi_select property contains a tag with the given name.
- * Returns false if the property is not a multi_select or is undefined.
- *
- * @example
- * ```ts
- * if (hasTag(entry.data.properties.Tags, "pinned")) {
- *   // show pinned badge
- * }
- * ```
- */
-export const hasTag = (
-  property: PropertyPageObjectResponseType | undefined,
-  tagName: string,
-): boolean => {
-  if (property?.type !== "multi_select") return false;
-  return property.multi_select.some((t) => t.name === tagName);
-};
-
-/**
- * Builds a `linkToPages` map from a collection of entries so that
- * `NotionMarkdownRenderer` can resolve inter-page Notion links.
- *
- * @param entries - Array of content collection entries (from `getCollection`)
- * @param options - Accessor functions that return the URL and title for each entry
- *
- * @example
- * ```ts
- * import { getCollection } from "astro:content";
- * import { buildLinkToPages, getPlainText } from "notro";
- *
- * const posts = await getCollection("posts");
- * const linkToPages = buildLinkToPages(posts, {
- *   url: (e) => `blog/${getPlainText(e.data.properties.Slug) || e.id}/`,
- *   title: (e) => getPlainText(e.data.properties.Name) ?? e.id,
- * });
- * ```
- */
-export function buildLinkToPages<T extends { id: string; data: Record<string, unknown> }>(
-  entries: T[],
-  options: {
-    url: (entry: T) => string;
-    title: (entry: T) => string;
-  },
-): LinkToPages {
-  const result: LinkToPages = {};
-  for (const entry of entries) {
-    if (entry.id in result) {
-      // Warn when two entries share the same Notion page ID; the later entry wins.
-      console.warn(
-        `[notro] buildLinkToPages: duplicate entry id "${entry.id}" — the later entry will overwrite the earlier one.`,
-      );
-    }
-    result[entry.id] = {
-      url: options.url(entry),
-      title: options.title(entry),
-    };
-  }
-  return result;
-}
+import type { PropertyPageObjectResponseType } from "../loader/schema.ts";
+import type { LinkToPages } from "../types.ts";
+
+export const getPlainText = (
+  property: PropertyPageObjectResponseType,
+): string | undefined => {
+  if (property?.type === "rich_text" && property.rich_text.length > 0) {
+    // rich_text arrays represent adjacent text spans; direct concatenation (no separator) is correct per Notion spec.
+    return property.rich_text.map((t) => t.plain_text).join("");
+  }
+  if (property?.type === "title" && property.title.length > 0) {
+    // title arrays also represent adjacent text spans; direct concatenation is correct.
+    return property.title.map((t) => t.plain_text).join("");
+  }
+  if (property?.type === "select" && property.select?.name !== undefined) {
+    return property.select.name;
+  }
+  if (
+    property?.type === "multi_select" &&
+    property.multi_select !== undefined
+  ) {
+    // Use ", " separator so that multi-select values are human-readable (e.g. "A, B, C").
+    return property.multi_select.map((option) => option.name).join(", ");
+  }
+  if (property?.type === "number" && property.number !== null) {
+    return String(property.number);
+  }
+  if (property?.type === "url") {
+    return property.url ?? undefined;
+  }
+  if (property?.type === "email") {
+    return property.email ?? undefined;
+  }
+  if (property?.type === "phone_number") {
+    return property.phone_number ?? undefined;
+  }
+  if (property?.type === "date" && property.date !== null) {
+    return property.date.start;
+  }
+  if (property?.type === "unique_id" && property.unique_id.number !== null) {
+    return property.unique_id.prefix
+      ? `${property.unique_id.prefix}-${property.unique_id.number}`
+      : String(property.unique_id.number);
+  }
+  return undefined;
+};
+
+/**
+ * Returns the multi-select options array from a multi_select property,
+ * or an empty array if the property is not a multi_select or is undefined.
+ *
+ * @example
+ * ```ts
+ * const tags = getMultiSelect(entry.data.properties.Tags);
+ * // Array<{ id: string; name: string; color: string }>
+ * tags.forEach(t => console.log(t.name));
+ * ```
+ */
+export const getMultiSelect = (
+  property: PropertyPageObjectResponseType | undefined,
+): { id: string; name: string; color: string }[] => {
+  if (property?.type === "multi_select") {
+    return property.multi_select;
+  }
+  return [];
+};
+
+/**
+ * Returns true if a multi_select property contains a tag with the given name.
+ * Returns false if the property is not a multi_select or is undefined.
+ *
+ * @example
+ * ```ts
+ * if (hasTag(entry.data.properties.Tags, "pinned")) {
+ *   // show pinned badge
+ * }
+ * ```
+ */
+export const hasTag = (
+  property: PropertyPageObjectResponseType | undefined,
+  tagName: string,
+): boolean => {
+  if (property?.type !== "multi_select") return false;
+  return property.multi_select.some((t) => t.name === tagName);
+};
+
+/**
+ * Builds a `linkToPages` map from a collection of entries so that
+ * `NotionMarkdownRenderer` can resolve inter-page Notion links.
+ *
+ * @param entries - Array of content collection entries (from `getCollection`)
+ * @param options - Accessor functions that return the URL and title for each entry
+ *
+ * @example
+ * ```ts
+ * import { getCollection } from "astro:content";
+ * import { buildLinkToPages, getPlainText } from "notro";
+ *
+ * const posts = await getCollection("posts");
+ * const linkToPages = buildLinkToPages(posts, {
+ *   url: (e) => `blog/${getPlainText(e.data.properties.Slug) || e.id}/`,
+ *   title: (e) => getPlainText(e.data.properties.Name) ?? e.id,
+ * });
+ * ```
+ */
+export function buildLinkToPages<T extends { id: string; data: Record<string, unknown> }>(
+  entries: T[],
+  options: {
+    url: (entry: T) => string;
+    title: (entry: T) => string;
+  },
+): LinkToPages {
+  const result: LinkToPages = {};
+  for (const entry of entries) {
+    if (entry.id in result) {
+      // Warn when two entries share the same Notion page ID; the later entry wins.
+      console.warn(
+        `[notro] buildLinkToPages: duplicate entry id "${entry.id}" — the later entry will overwrite the earlier one.`,
+      );
+    }
+    result[entry.id] = {
+      url: options.url(entry),
+      title: options.title(entry),
+    };
+  }
+  return result;
+}

package/src/utils/notro-config.ts

@@ -1,35 +1,35 @@
-/**
- * Module-level configuration store for notro's MDX plugin pipeline.
- *
- * The notro() Astro integration stores the user-provided remark/rehype plugins
- * here during astro:config:setup. buildMdxPlugins() reads them at render time
- * so that both the runtime Notion path (compileMdxCached) and the static .mdx
- * path (@astrojs/mdx) use the same plugin configuration.
- *
- * NOTE: We use globalThis instead of module-level variables so the state
- * persists across Vite module instances. Astro's integration hooks run in a
- * plain Node.js module context; at build/prerender time, Vite creates new
- * module instances for the same files. globalThis is the same object in both
- * contexts within the same Node.js process, so storing plugins there bridges
- * the two contexts without requiring a virtual module or serialisation.
- */
-import type { PluggableList } from 'unified';
-
-declare global {
-	// eslint-disable-next-line no-var
-	var __notro_remarkPlugins: PluggableList | undefined;
-	// eslint-disable-next-line no-var
-	var __notro_rehypePlugins: PluggableList | undefined;
-}
-
-export function setNotroPlugins(remarkPlugins: PluggableList, rehypePlugins: PluggableList): void {
-	globalThis.__notro_remarkPlugins = remarkPlugins;
-	globalThis.__notro_rehypePlugins = rehypePlugins;
-}
-
-export function getNotroPlugins(): { remarkPlugins: PluggableList; rehypePlugins: PluggableList } {
-	return {
-		remarkPlugins: globalThis.__notro_remarkPlugins ?? [],
-		rehypePlugins: globalThis.__notro_rehypePlugins ?? [],
-	};
-}
+/**
+ * Module-level configuration store for notro's MDX plugin pipeline.
+ *
+ * The notro() Astro integration stores the user-provided remark/rehype plugins
+ * here during astro:config:setup. buildMdxPlugins() reads them at render time
+ * so that both the runtime Notion path (compileMdxCached) and the static .mdx
+ * path (@astrojs/mdx) use the same plugin configuration.
+ *
+ * NOTE: We use globalThis instead of module-level variables so the state
+ * persists across Vite module instances. Astro's integration hooks run in a
+ * plain Node.js module context; at build/prerender time, Vite creates new
+ * module instances for the same files. globalThis is the same object in both
+ * contexts within the same Node.js process, so storing plugins there bridges
+ * the two contexts without requiring a virtual module or serialisation.
+ */
+import type { PluggableList } from 'unified';
+
+declare global {
+	// eslint-disable-next-line no-var
+	var __notro_remarkPlugins: PluggableList | undefined;
+	// eslint-disable-next-line no-var
+	var __notro_rehypePlugins: PluggableList | undefined;
+}
+
+export function setNotroPlugins(remarkPlugins: PluggableList, rehypePlugins: PluggableList): void {
+	globalThis.__notro_remarkPlugins = remarkPlugins;
+	globalThis.__notro_rehypePlugins = rehypePlugins;
+}
+
+export function getNotroPlugins(): { remarkPlugins: PluggableList; rehypePlugins: PluggableList } {
+	return {
+		remarkPlugins: globalThis.__notro_remarkPlugins ?? [],
+		rehypePlugins: globalThis.__notro_rehypePlugins ?? [],
+	};
+}

package/utils.ts

@@ -1,11 +1,11 @@
-/**
- * Pure TypeScript utilities — safe to import anywhere, including astro.config.mjs.
- *
- * Use this entry point (`notro/utils`) when you need notro helpers in contexts
- * where Astro components cannot be loaded (config files, Node scripts, etc.).
- *
- * For Astro components and the Content Loader, use the main `notro` entry instead.
- */
-export { normalizeNotionPresignedUrl, markdownHasPresignedUrls } from './src/utils/notion-url.ts';
-export { getPlainText, getMultiSelect, hasTag, buildLinkToPages } from './src/utils/notion.ts';
-export type { LinkToPages } from './src/types.ts';
+/**
+ * Pure TypeScript utilities — safe to import anywhere, including astro.config.mjs.
+ *
+ * Use this entry point (`notro/utils`) when you need notro helpers in contexts
+ * where Astro components cannot be loaded (config files, Node scripts, etc.).
+ *
+ * For Astro components and the Content Loader, use the main `notro` entry instead.
+ */
+export { normalizeNotionPresignedUrl, markdownHasPresignedUrls } from './src/utils/notion-url.ts';
+export { getPlainText, getMultiSelect, hasTag, buildLinkToPages } from './src/utils/notion.ts';
+export type { LinkToPages } from './src/types.ts';