blodemd 0.0.13 → 0.0.15

package/packages/@repo/contracts/src/analytics.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+
+const GA4_MEASUREMENT_ID_REGEX = /^G-[A-Z0-9]{4,20}$/;
+const POSTHOG_PROJECT_KEY_REGEX = /^phc_[A-Za-z0-9]{20,}$/;
+
+export const ProjectAnalyticsGa4Schema = z.object({
+  measurementId: z
+    .string()
+    .regex(
+      GA4_MEASUREMENT_ID_REGEX,
+      "GA4 measurement IDs look like G-XXXXXXXXXX."
+    ),
+});
+export type ProjectAnalyticsGa4 = z.infer<typeof ProjectAnalyticsGa4Schema>;
+
+export const ProjectAnalyticsPosthogSchema = z.object({
+  host: z.string().url().optional(),
+  projectKey: z
+    .string()
+    .regex(
+      POSTHOG_PROJECT_KEY_REGEX,
+      "PostHog project keys start with phc_. Personal API keys (phx_) are not supported."
+    ),
+});
+export type ProjectAnalyticsPosthog = z.infer<
+  typeof ProjectAnalyticsPosthogSchema
+>;
+
+export const ProjectAnalyticsSchema = z.object({
+  ga4: ProjectAnalyticsGa4Schema.optional(),
+  posthog: ProjectAnalyticsPosthogSchema.optional(),
+});
+export type ProjectAnalytics = z.infer<typeof ProjectAnalyticsSchema>;

package/packages/@repo/contracts/src/deployment.ts

@@ -42,7 +42,7 @@ export type PublishDeploymentCreateInput = z.infer<
 >;
 
 export const PublishDeploymentFileSchema = z.object({
-  contentBase64: z.string().min(1),
+  contentBase64: z.string().base64(),
   contentType: z.string().min(1).optional(),
   path: z.string().min(1),
 });

package/packages/@repo/contracts/src/git.ts

@@ -12,7 +12,7 @@ export const GitConnectionSchema = z.object({
   createdAt: IsoDateSchema,
   docsPath: z.string().min(1),
   id: IdSchema,
-  installationId: z.number().int().positive(),
+  installationId: z.number().int().positive().safe(),
   projectId: IdSchema,
   provider: GitProviderSchema,
   repository: z.string().min(1),
@@ -23,7 +23,7 @@ export type GitConnection = z.infer<typeof GitConnectionSchema>;
 export const GitConnectionBindSchema = z.object({
   branch: z.string().min(1).default("main"),
   docsPath: z.string().min(1).default("docs"),
-  installationId: z.number().int().positive(),
+  installationId: z.number().int().positive().safe(),
   repository: z.string().regex(/^[\w.-]+\/[\w.-]+$/, {
     message: "Repository must be in the format owner/repo.",
   }),

package/packages/@repo/contracts/src/ids.ts

@@ -6,7 +6,8 @@ export type Id = z.infer<typeof IdSchema>;
 export const SlugSchema = z
   .string()
   .min(1)
-  .regex(/^[a-z0-9-]+$/);
+  .max(63)
+  .regex(/^(?!-)[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/);
 export type Slug = z.infer<typeof SlugSchema>;
 
 export const EmailSchema = z.string().email();

package/packages/@repo/contracts/src/index.ts

@@ -1,5 +1,6 @@
 // biome-ignore lint/performance/noBarrelFile: This is the main entry point for the package
 // eslint-disable-next-line no-barrel-file
+export * from "./analytics.js";
 export * from "./dates.js";
 export * from "./deployment.js";
 export * from "./domain.js";

package/packages/@repo/contracts/src/project.ts

@@ -1,9 +1,11 @@
 import { z } from "zod";
 
+import { ProjectAnalyticsSchema } from "./analytics.js";
 import { IsoDateSchema } from "./dates.js";
 import { IdSchema, SlugSchema } from "./ids.js";
 
 export const ProjectSchema = z.object({
+  analytics: ProjectAnalyticsSchema.nullable().optional(),
   createdAt: IsoDateSchema,
   deploymentName: z.string().min(1),
   description: z.string().optional(),
@@ -15,7 +17,6 @@ export const ProjectSchema = z.object({
 export type Project = z.infer<typeof ProjectSchema>;
 
 export const ProjectCreateSchema = z.object({
-  deploymentName: z.string().min(1),
   description: z.string().optional(),
   name: z.string().min(1),
   slug: SlugSchema,
@@ -23,6 +24,7 @@ export const ProjectCreateSchema = z.object({
 export type ProjectCreateInput = z.infer<typeof ProjectCreateSchema>;
 
 export const ProjectUpdateSchema = z.object({
+  analytics: ProjectAnalyticsSchema.nullable().optional(),
   deploymentName: z.string().min(1).optional(),
   description: z.string().nullable().optional(),
   name: z.string().min(1).optional(),

package/packages/@repo/contracts/src/tenant.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 
+import { ProjectAnalyticsSchema } from "./analytics.js";
 import {
   HostnameSchema,
   IdSchema,
@@ -14,6 +15,7 @@ export type TenantStatus = z.infer<typeof TenantStatusSchema>;
 export const TenantSchema = z.object({
   activeDeploymentId: IdSchema.optional(),
   activeDeploymentManifestUrl: UrlSchema.optional(),
+  analytics: ProjectAnalyticsSchema.optional(),
   customDomains: z.array(HostnameSchema),
   description: z.string().optional(),
   id: IdSchema,

package/packages/@repo/models/dist/docs-config.d.ts

@@ -450,204 +450,6 @@ export declare const DocsConfigSchema: z.ZodObject<{
     slug: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type DocsConfig = z.infer<typeof DocsConfigSchema>;
-export declare const MintlifyDocsConfigSchema: z.ZodObject<{
-    $schema: z.ZodOptional<z.ZodString>;
-    api: z.ZodOptional<z.ZodObject<{
-        asyncapi: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
-            basePath: z.ZodOptional<z.ZodString>;
-            directory: z.ZodOptional<z.ZodString>;
-            include: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source: z.ZodString;
-        }, z.core.$strict>]>>;
-        examples: z.ZodOptional<z.ZodObject<{
-            autogenerate: z.ZodOptional<z.ZodBoolean>;
-            defaults: z.ZodOptional<z.ZodEnum<{
-                all: "all";
-                required: "required";
-            }>>;
-            languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            prefill: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        mdx: z.ZodOptional<z.ZodObject<{
-            auth: z.ZodOptional<z.ZodObject<{
-                method: z.ZodOptional<z.ZodEnum<{
-                    basic: "basic";
-                    bearer: "bearer";
-                    cobo: "cobo";
-                    key: "key";
-                }>>;
-                name: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>;
-            server: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strict>>;
-        openapi: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
-            basePath: z.ZodOptional<z.ZodString>;
-            directory: z.ZodOptional<z.ZodString>;
-            include: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source: z.ZodString;
-        }, z.core.$strict>]>>;
-        params: z.ZodOptional<z.ZodObject<{
-            expanded: z.ZodOptional<z.ZodEnum<{
-                all: "all";
-                closed: "closed";
-            }>>;
-        }, z.core.$strict>>;
-        playground: z.ZodOptional<z.ZodObject<{
-            credentials: z.ZodOptional<z.ZodBoolean>;
-            display: z.ZodOptional<z.ZodEnum<{
-                auth: "auth";
-                interactive: "interactive";
-                none: "none";
-                simple: "simple";
-            }>>;
-            proxy: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        url: z.ZodOptional<z.ZodLiteral<"full">>;
-    }, z.core.$strict>>;
-    appearance: z.ZodOptional<z.ZodObject<{
-        default: z.ZodOptional<z.ZodEnum<{
-            dark: "dark";
-            light: "light";
-            system: "system";
-        }>>;
-        strict: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>>;
-    contextual: z.ZodOptional<z.ZodObject<{
-        display: z.ZodOptional<z.ZodEnum<{
-            toc: "toc";
-            header: "header";
-        }>>;
-        options: z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
-            "add-mcp": "add-mcp";
-            aistudio: "aistudio";
-            assistant: "assistant";
-            chatgpt: "chatgpt";
-            claude: "claude";
-            copy: "copy";
-            cursor: "cursor";
-            devin: "devin";
-            "devin-mcp": "devin-mcp";
-            gemini: "gemini";
-            grok: "grok";
-            mcp: "mcp";
-            perplexity: "perplexity";
-            view: "view";
-            vscode: "vscode";
-            windsurf: "windsurf";
-        }>, z.ZodObject<{
-            description: z.ZodString;
-            href: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                base: z.ZodString;
-                query: z.ZodArray<z.ZodObject<{
-                    key: z.ZodString;
-                    value: z.ZodString;
-                }, z.core.$strict>>;
-            }, z.core.$strict>]>;
-            icon: z.ZodString;
-            iconType: z.ZodOptional<z.ZodString>;
-            title: z.ZodString;
-        }, z.core.$strict>]>>;
-    }, z.core.$strict>>;
-    description: z.ZodOptional<z.ZodString>;
-    favicon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        dark: z.ZodString;
-        light: z.ZodString;
-    }, z.core.$strict>]>>;
-    logo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        dark: z.ZodString;
-        href: z.ZodOptional<z.ZodString>;
-        light: z.ZodString;
-    }, z.core.$strict>]>>;
-    metadata: z.ZodOptional<z.ZodObject<{
-        timestamp: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>>;
-    name: z.ZodString;
-    navbar: z.ZodOptional<z.ZodObject<{
-        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            href: z.ZodString;
-            icon: z.ZodOptional<z.ZodString>;
-            iconType: z.ZodOptional<z.ZodString>;
-            label: z.ZodOptional<z.ZodString>;
-            type: z.ZodOptional<z.ZodEnum<{
-                discord: "discord";
-                github: "github";
-            }>>;
-        }, z.core.$strict>>>;
-        primary: z.ZodOptional<z.ZodObject<{
-            href: z.ZodString;
-            label: z.ZodOptional<z.ZodString>;
-            type: z.ZodEnum<{
-                discord: "discord";
-                github: "github";
-                button: "button";
-            }>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    navigation: z.ZodObject<{
-        global: z.ZodOptional<z.ZodObject<{
-            anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                anchor: z.ZodString;
-                color: z.ZodOptional<z.ZodObject<{
-                    dark: z.ZodOptional<z.ZodString>;
-                    light: z.ZodOptional<z.ZodString>;
-                }, z.core.$strict>>;
-                hidden: z.ZodOptional<z.ZodBoolean>;
-                href: z.ZodString;
-                icon: z.ZodOptional<z.ZodString>;
-                iconType: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>>;
-        }, z.core.$strict>>;
-        groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            expanded: z.ZodOptional<z.ZodBoolean>;
-            group: z.ZodString;
-            hidden: z.ZodOptional<z.ZodBoolean>;
-            icon: z.ZodOptional<z.ZodString>;
-            pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            root: z.ZodOptional<z.ZodString>;
-            tag: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>>;
-        languages: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            default: z.ZodOptional<z.ZodBoolean>;
-            hidden: z.ZodOptional<z.ZodBoolean>;
-            href: z.ZodString;
-            language: z.ZodString;
-        }, z.core.$strict>>>;
-        pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                expanded: z.ZodOptional<z.ZodBoolean>;
-                group: z.ZodString;
-                hidden: z.ZodOptional<z.ZodBoolean>;
-                icon: z.ZodOptional<z.ZodString>;
-                pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                root: z.ZodOptional<z.ZodString>;
-                tag: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>>;
-            hidden: z.ZodOptional<z.ZodBoolean>;
-            href: z.ZodOptional<z.ZodString>;
-            icon: z.ZodOptional<z.ZodString>;
-            pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            tab: z.ZodString;
-        }, z.core.$strict>>>;
-        versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            default: z.ZodOptional<z.ZodBoolean>;
-            hidden: z.ZodOptional<z.ZodBoolean>;
-            href: z.ZodString;
-            version: z.ZodString;
-        }, z.core.$strict>>>;
-    }, z.core.$strict>;
-    search: z.ZodOptional<z.ZodObject<{
-        prompt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    seo: z.ZodOptional<z.ZodObject<{
-        indexing: z.ZodOptional<z.ZodEnum<{
-            default: "default";
-            all: "all";
-        }>>;
-    }, z.core.$strict>>;
-    slug: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type MintlifyDocsConfig = DocsConfig;
 export declare const ContentTypeSchema: z.ZodEnum<{
     site: "site";
     blog: "blog";

package/packages/@repo/models/dist/docs-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-config.d.ts","sourceRoot":"","sources":["../src/docs-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs-config.d.ts","sourceRoot":"","sources":["../src/docs-config.ts"],"names":[],"mappings":"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"}

package/packages/@repo/models/dist/docs-config.js

@@ -3,7 +3,9 @@ const UrlOrPathSchema = z.string().min(1);
 const SlugSchema = z
     .string()
     .min(1)
-    .regex(/^[a-z0-9-]+$/);
+    // Lowercase alphanumeric segments joined by single hyphens: no leading,
+    // trailing, or consecutive hyphens, and never a bare "-".
+    .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
 export const DocsColorsSchema = z
     .object({
     background: z.string().optional(),
@@ -378,7 +380,6 @@ export const DocsConfigSchema = z
     slug: SlugSchema.optional(),
 })
     .strict();
-export const MintlifyDocsConfigSchema = DocsConfigSchema;
 export const ContentTypeSchema = z.enum([
     "site",
     "blog",

package/packages/@repo/models/dist/tenant.d.ts

@@ -1,3 +1,14 @@
+export interface TenantAnalyticsGa4 {
+    measurementId: string;
+}
+export interface TenantAnalyticsPosthog {
+    projectKey: string;
+    host?: string;
+}
+export interface TenantAnalytics {
+    ga4?: TenantAnalyticsGa4;
+    posthog?: TenantAnalyticsPosthog;
+}
 export interface Tenant {
     id: string;
     slug: string;
@@ -5,6 +16,7 @@ export interface Tenant {
     description?: string;
     activeDeploymentId?: string;
     activeDeploymentManifestUrl?: string;
+    analytics?: TenantAnalytics;
     primaryDomain: string;
     subdomain: string;
     customDomains: string[];

package/packages/@repo/models/dist/tenant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../src/tenant.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EACF,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,CAAC;IAC5B,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../src/tenant.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EACF,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,CAAC;IAC5B,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B"}

package/packages/@repo/models/package.json

@@ -28,7 +28,7 @@
   },
   "devDependencies": {
     "@repo/typescript-config": "*",
-    "@types/node": "^22.19.15",
+    "@types/node": "^24.12.2",
     "oxfmt": "^0.42.0",
     "oxlint": "^1.57.0",
     "typescript": "6.0.2",

package/packages/@repo/models/src/docs-config.ts

@@ -4,7 +4,9 @@ const UrlOrPathSchema = z.string().min(1);
 const SlugSchema = z
   .string()
   .min(1)
-  .regex(/^[a-z0-9-]+$/);
+  // Lowercase alphanumeric segments joined by single hyphens: no leading,
+  // trailing, or consecutive hyphens, and never a bare "-".
+  .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
 
 export const DocsColorsSchema = z
   .object({
@@ -442,8 +444,6 @@ export const DocsConfigSchema = z
   .strict();
 
 export type DocsConfig = z.infer<typeof DocsConfigSchema>;
-export const MintlifyDocsConfigSchema = DocsConfigSchema;
-export type MintlifyDocsConfig = DocsConfig;
 
 export const ContentTypeSchema = z.enum([
   "site",

package/packages/@repo/models/src/tenant.ts

@@ -1,3 +1,17 @@
+export interface TenantAnalyticsGa4 {
+  measurementId: string;
+}
+
+export interface TenantAnalyticsPosthog {
+  projectKey: string;
+  host?: string;
+}
+
+export interface TenantAnalytics {
+  ga4?: TenantAnalyticsGa4;
+  posthog?: TenantAnalyticsPosthog;
+}
+
 export interface Tenant {
   id: string;
   slug: string;
@@ -5,6 +19,7 @@ export interface Tenant {
   description?: string;
   activeDeploymentId?: string;
   activeDeploymentManifestUrl?: string;
+  analytics?: TenantAnalytics;
   primaryDomain: string;
   subdomain: string;
   customDomains: string[];

package/packages/@repo/prebuild/dist/openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,mBAAe,KAAG,WAgB/D,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,KACnB,OAAO,CAAC,WAAW,CACmD,CAAC;AAE1E,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,WAC3B,CAAC;AAEzC,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,kBAAiB,WAUlB,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,MAAM,WAAW,EACjB,YAAY,MAAM;;;CA+BnB,CAAC"}
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAmBD,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,mBAAe,KAAG,WAgB/D,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,KACnB,OAAO,CAAC,WAAW,CACmD,CAAC;AAE1E,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,WAC3B,CAAC;AAEzC,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,kBAAiB,WAUlB,CAAC;AAgBF,eAAO,MAAM,wBAAwB,GACnC,MAAM,WAAW,EACjB,YAAY,MAAM;;;CAsCnB,CAAC"}

package/packages/@repo/prebuild/dist/openapi.js

@@ -2,19 +2,33 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { normalizePath, slugify } from "@repo/common";
 import YAML from "yaml";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+// A YAML/JSON document can parse to a scalar, null, or array — none of which
+// are usable as an OpenAPI spec. Validate the shape before the cast so callers
+// fail with a clear message instead of crashing while iterating `paths`.
+const asOpenApiSpec = (value, sourcePath) => {
+    const label = sourcePath ? ` (${sourcePath})` : "";
+    if (!isRecord(value)) {
+        throw new Error(`OpenAPI spec${label} must be an object.`);
+    }
+    if (value.paths !== undefined && !isRecord(value.paths)) {
+        throw new Error(`OpenAPI spec${label} has an invalid "paths" section.`);
+    }
+    return value;
+};
 export const parseOpenApiSpec = (raw, sourcePath = "") => {
     const ext = path.extname(sourcePath).toLowerCase();
     if (ext === ".json") {
-        return JSON.parse(raw);
+        return asOpenApiSpec(JSON.parse(raw), sourcePath);
     }
     if (ext === ".yaml" || ext === ".yml") {
-        return YAML.parse(raw);
+        return asOpenApiSpec(YAML.parse(raw), sourcePath);
     }
     try {
-        return JSON.parse(raw);
+        return asOpenApiSpec(JSON.parse(raw), sourcePath);
     }
     catch {
-        return YAML.parse(raw);
+        return asOpenApiSpec(YAML.parse(raw), sourcePath);
     }
 };
 export const loadOpenApiSpec = async (absolutePath) => parseOpenApiSpec(await fs.readFile(absolutePath, "utf8"), absolutePath);
@@ -29,11 +43,25 @@ export const openApiSlug = (method, routePath, directory = "api") => {
     const slug = slugify(`${method.toLowerCase()}-${base}`);
     return normalizePath(path.join(directory, slug));
 };
+const HTTP_METHODS = new Set([
+    "delete",
+    "get",
+    "head",
+    "options",
+    "patch",
+    "post",
+    "put",
+    "trace",
+]);
+const isOperationObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 export const extractOpenApiOperations = (spec, directory) => {
     const ops = [];
     const paths = spec.paths ?? {};
     for (const [routePath, methods] of Object.entries(paths)) {
         for (const [method, operation] of Object.entries(methods)) {
+            if (!(HTTP_METHODS.has(method.toLowerCase()) && isOperationObject(operation))) {
+                continue;
+            }
             const upper = method.toUpperCase();
             const id = operation.operationId ?? openApiIdentifier(upper, routePath);
             ops.push({

package/packages/@repo/prebuild/package.json

@@ -30,7 +30,7 @@
   },
   "devDependencies": {
     "@repo/typescript-config": "*",
-    "@types/node": "^22.19.15",
+    "@types/node": "^24.12.2",
     "oxfmt": "^0.42.0",
     "oxlint": "^1.57.0",
     "typescript": "6.0.2",

package/packages/@repo/prebuild/src/openapi.ts

@@ -39,21 +39,38 @@ export interface OpenApiOperation {
   responses?: Record<string, unknown>;
 }
 
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null && !Array.isArray(value);
+
+// A YAML/JSON document can parse to a scalar, null, or array — none of which
+// are usable as an OpenAPI spec. Validate the shape before the cast so callers
+// fail with a clear message instead of crashing while iterating `paths`.
+const asOpenApiSpec = (value: unknown, sourcePath: string): OpenApiSpec => {
+  const label = sourcePath ? ` (${sourcePath})` : "";
+  if (!isRecord(value)) {
+    throw new Error(`OpenAPI spec${label} must be an object.`);
+  }
+  if (value.paths !== undefined && !isRecord(value.paths)) {
+    throw new Error(`OpenAPI spec${label} has an invalid "paths" section.`);
+  }
+  return value as OpenApiSpec;
+};
+
 export const parseOpenApiSpec = (raw: string, sourcePath = ""): OpenApiSpec => {
   const ext = path.extname(sourcePath).toLowerCase();
 
   if (ext === ".json") {
-    return JSON.parse(raw) as OpenApiSpec;
+    return asOpenApiSpec(JSON.parse(raw), sourcePath);
   }
 
   if (ext === ".yaml" || ext === ".yml") {
-    return YAML.parse(raw) as OpenApiSpec;
+    return asOpenApiSpec(YAML.parse(raw), sourcePath);
   }
 
   try {
-    return JSON.parse(raw) as OpenApiSpec;
+    return asOpenApiSpec(JSON.parse(raw), sourcePath);
   } catch {
-    return YAML.parse(raw) as OpenApiSpec;
+    return asOpenApiSpec(YAML.parse(raw), sourcePath);
   }
 };
 
@@ -80,6 +97,20 @@ export const openApiSlug = (
   return normalizePath(path.join(directory, slug));
 };
 
+const HTTP_METHODS = new Set([
+  "delete",
+  "get",
+  "head",
+  "options",
+  "patch",
+  "post",
+  "put",
+  "trace",
+]);
+
+const isOperationObject = (value: unknown): value is OpenApiOperationSpec =>
+  typeof value === "object" && value !== null && !Array.isArray(value);
+
 export const extractOpenApiOperations = (
   spec: OpenApiSpec,
   directory?: string
@@ -89,6 +120,13 @@ export const extractOpenApiOperations = (
 
   for (const [routePath, methods] of Object.entries(paths)) {
     for (const [method, operation] of Object.entries(methods)) {
+      if (
+        !(
+          HTTP_METHODS.has(method.toLowerCase()) && isOperationObject(operation)
+        )
+      ) {
+        continue;
+      }
       const upper = method.toUpperCase();
       const id = operation.operationId ?? openApiIdentifier(upper, routePath);
 

package/packages/@repo/previewing/dist/blob-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob-source.d.ts","sourceRoot":"","sources":["../src/blob-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA8C5E,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,eAAe,CAAC,CAA+B;gBAE3C,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAKlD,OAAO,CAAC,eAAe;YAaT,YAAY;IA2BpB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc/C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe/C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9C,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKxD,eAAe,CACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAuBrC;AAED,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,EACnB,WAAW,MAAM,KAChB,aAA6D,CAAC"}
+{"version":3,"file":"blob-source.d.ts","sourceRoot":"","sources":["../src/blob-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA8C5E,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,eAAe,CAAC,CAA+B;gBAE3C,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAKlD,OAAO,CAAC,eAAe;YAaT,YAAY;IA2BpB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc/C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA8B/C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9C,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKxD,eAAe,CACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAuBrC;AAED,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,EACnB,WAAW,MAAM,KAChB,aAA6D,CAAC"}

package/packages/@repo/previewing/dist/blob-source.js

@@ -72,12 +72,25 @@ export class BlobContentSource {
     async listFiles(directory) {
         const manifest = await this.loadManifest();
         const prefix = normalizeDirectory(directory);
-        const files = [...manifest.keys()].filter((file) => {
-            if (shouldIgnoreRootDocsFile(file)) {
-                return false;
+        const files = [];
+        for (const file of manifest.keys()) {
+            if (prefix && !file.startsWith(prefix)) {
+                continue;
             }
-            return prefix ? file.startsWith(prefix) : true;
-        });
+            // Return paths relative to the listed directory, matching
+            // FsContentSource so callers can join them onto the collection root.
+            const relativePath = prefix ? file.slice(prefix.length) : file;
+            if (!relativePath) {
+                continue;
+            }
+            // Only top-level entries of the listed directory are subject to the
+            // root-docs-file ignore list, again matching FsContentSource.
+            if (!relativePath.includes("/") &&
+                shouldIgnoreRootDocsFile(relativePath)) {
+                continue;
+            }
+            files.push(relativePath);
+        }
         // oxlint-disable-next-line eslint-plugin-unicorn/no-array-sort
         files.sort();
         return files;