blodemd 0.0.13 → 0.0.14

package/docs/lib/tenant-static.ts

@@ -3,16 +3,24 @@ import type { TenantResolution } from "@repo/contracts";
 import type { Tenant } from "@repo/models";
 import type { UtilityIndex } from "@repo/previewing";
 import {
+  absolutiseInternalLinks,
   buildContentIndex,
   buildPageMetadataMap,
+  formatMarkdownPage,
+  formatMarkdownPageSection,
+  formatOpenApiPageContent,
   getPrebuiltUtilityLlmPagePath,
-  loadContentSource,
   loadPrebuiltContentIndex,
   loadPrebuiltUtilityIndex,
   loadSiteConfig,
   PREBUILT_UTILITY_LLMS_FULL_PATH,
   PREBUILT_UTILITY_LLMS_PATH,
+  PREBUILT_UTILITY_LLMS_SEGMENT_PREFIX,
   PREBUILT_UTILITY_SITEMAP_PATH,
+  prepareLlmsFullContent,
+  sanitizePlaceholderUrls,
+  stripFrontmatter,
+  toAgentMarkdown,
   UTILITY_DOCS_ROOT_TOKEN,
 } from "@repo/previewing";
 
@@ -25,6 +33,7 @@ import {
   getDocsCollectionWithNavigation,
   getDocsNavigation,
 } from "@/lib/docs-collection";
+import { capLlmsFullContent } from "@/lib/llms-full";
 import {
   buildNavigation,
   enrichNavWithMetadata,
@@ -39,6 +48,10 @@ import { createTimedPromiseCache } from "@/lib/server-cache";
 import { getRequestProtocol } from "@/lib/tenancy";
 import type { TenantRequestContext } from "@/lib/tenant-utility-context";
 
+// Re-exported so tenant-static.unit.test.ts continues to guard the shared
+// implementation now living in @repo/previewing.
+export { absolutiseInternalLinks, sanitizePlaceholderUrls };
+
 const TENANT_STATIC_CACHE_TTL_MS = 30 * 60 * 1000;
 
 const getTenantStaticCacheKey = (tenant: Tenant) =>
@@ -218,37 +231,6 @@ const loadTenantUrlData = async (tenant: Tenant) =>
     async () => await buildTenantUrlData(tenant)
   );
 
-const formatOpenApiPageText = (entry: OpenApiEntry): string => {
-  const parts = [
-    `Method: ${entry.operation.method}`,
-    `Path: ${entry.operation.path}`,
-  ];
-
-  if (entry.operation.description) {
-    parts.push(entry.operation.description);
-  }
-  if (entry.operation.tags.length) {
-    parts.push(`Tags: ${entry.operation.tags.join(", ")}`);
-  }
-  if (entry.operation.parameters.length) {
-    parts.push(
-      `Parameters:\n${JSON.stringify(entry.operation.parameters, null, 2)}`
-    );
-  }
-  if (entry.operation.requestBody) {
-    parts.push(
-      `Request Body:\n${JSON.stringify(entry.operation.requestBody, null, 2)}`
-    );
-  }
-  if (entry.operation.responses) {
-    parts.push(
-      `Responses:\n${JSON.stringify(entry.operation.responses, null, 2)}`
-    );
-  }
-
-  return parts.join("\n\n");
-};
-
 const resolveLlmPages = (
   data: Awaited<ReturnType<typeof loadTenantUrlData>>
 ): (
@@ -300,49 +282,6 @@ const resolveLlmPages = (
     })
     .filter((page) => page !== null);
 
-const FRONTMATTER_REGEX = /^---\s*\n[\s\S]*?\n---\s*\n?/;
-const LEADING_H1_REGEX = /^#\s+([^\r\n]+)(?:\r?\n(?:\r?\n)?)?/;
-
-const stripFrontmatter = (source: string) =>
-  source.replace(FRONTMATTER_REGEX, "").trim();
-
-const stripMatchingLeadingH1 = (source: string, title: string) => {
-  const trimmed = source.trimStart();
-  const match = LEADING_H1_REGEX.exec(trimmed);
-  if (!match) {
-    return trimmed.trim();
-  }
-
-  const [headingLine = "", headingTitle = ""] = match;
-  if (slugify(headingTitle) !== slugify(title)) {
-    return trimmed.trim();
-  }
-
-  return trimmed.slice(headingLine.length).trim();
-};
-
-const formatMarkdownPage = (title: string, source: string) => {
-  const content = stripMatchingLeadingH1(source, title);
-  if (!content) {
-    return `# ${title}`;
-  }
-
-  return `# ${title}\n\n${content}`;
-};
-
-const formatMarkdownPageSection = (
-  title: string,
-  url: string,
-  source: string
-) => {
-  const content = stripMatchingLeadingH1(source, title);
-  if (!content) {
-    return `# ${title} (${url})`;
-  }
-
-  return `# ${title} (${url})\n\n${content}`;
-};
-
 const buildRuntimeUtilityIndex = async (
   tenant: Tenant
 ): Promise<UtilityIndex> => {
@@ -351,19 +290,16 @@ const buildRuntimeUtilityIndex = async (
     resolveLlmPages(data).map(async (page) => {
       if (page.kind === "openapi") {
         return {
-          content: formatOpenApiPageText(page.entry),
+          content: formatOpenApiPageContent(page.entry.operation),
           description: page.description,
           slug: page.slug,
           title: page.title,
         };
       }
 
-      const raw = await loadContentSource(
-        data.contentSource,
-        page.relativePath
-      );
+      const raw = await data.contentSource.readFile(page.relativePath);
       return {
-        content: stripFrontmatter(raw),
+        content: toAgentMarkdown(stripFrontmatter(raw)),
         description: page.description,
         slug: page.slug,
         title: page.title,
@@ -378,7 +314,7 @@ const buildRuntimeUtilityIndex = async (
   };
 };
 
-const loadTenantUtilityIndex = async (tenant: Tenant) =>
+export const loadTenantUtilityIndex = async (tenant: Tenant) =>
   await tenantUtilityIndexCache.getOrCreate(
     getTenantStaticCacheKey(tenant),
     async () => {
@@ -449,15 +385,17 @@ export const buildTenantRobotsTxt = (
   const basePath = getCanonicalDocBasePath(tenant, context);
   return `User-agent: *
 Allow: /
-Sitemap: ${origin}${toDocHref("sitemap.xml", basePath)}
+Content-Signal: ai-train=no, search=yes, ai-input=yes
 
 # LLM-friendly content
-# ${origin}${toDocHref("llms.txt", basePath)} - Index of all documentation pages
-# ${origin}${toDocHref("llms-full.txt", basePath)} - Full documentation content
 # Append .md to any page URL for raw markdown
+# ${origin}${toDocHref("llms-full.txt", basePath)} - Full documentation content
+# ${origin}${toDocHref("llms.txt", basePath)} - Index of all documentation pages
+
+Sitemap: ${origin}${toDocHref("sitemap.xml", basePath)}
 
 # Agent Skills
-# ${origin}/.well-known/skills/index.json - Discover installable agent skills`;
+# ${origin}${toDocHref(".well-known/skills/index.json", basePath)} - Discover installable agent skills`;
 };
 
 const getNavGroupSegments = (
@@ -514,7 +452,7 @@ export const buildTenantLlmsTxt = async (
     "",
     `Sitemap: ${origin}${toDocHref("sitemap.xml", basePath)}`,
     `Full content: ${origin}${toDocHref("llms-full.txt", basePath)}`,
-    `Skills: ${origin}/.well-known/skills/index.json`,
+    `Skills: ${origin}${toDocHref(".well-known/skills/index.json", basePath)}`,
     ...segmentLines,
     "",
     "## Docs",
@@ -532,26 +470,42 @@ export const buildTenantLlmsFullTxt = async (
   tenant: Tenant,
   context: TenantRequestContext = {}
 ) => {
+  const origin = getCanonicalOrigin(tenant, context);
+  const basePath = getCanonicalDocBasePath(tenant, context);
+  const indexUrl = `${origin}${toDocHref("llms.txt", basePath)}`;
+
   const prebuilt = await loadTenantUtilityTemplate(
     tenant,
     PREBUILT_UTILITY_LLMS_FULL_PATH
   );
   if (prebuilt) {
-    return renderUtilityTemplate(prebuilt, tenant, context);
+    const rendered = renderUtilityTemplate(prebuilt, tenant, context);
+    return capLlmsFullContent(
+      prepareLlmsFullContent(rendered, origin, basePath),
+      indexUrl
+    );
   }
 
   const data = await loadTenantUtilityIndex(tenant);
-  const origin = getCanonicalOrigin(tenant, context);
-  const basePath = getCanonicalDocBasePath(tenant, context);
   const parts = data.pages.map((page) => {
     const url = `${origin}${toDocHref(page.slug, basePath)}`;
-    return formatMarkdownPageSection(page.title, url, page.content);
+    const content = prepareLlmsFullContent(page.content, origin, basePath);
+    return formatMarkdownPageSection(
+      page.title,
+      url,
+      content,
+      page.description
+    );
   });
 
-  return parts.join("\n\n");
+  return capLlmsFullContent(parts.join("\n\n"), indexUrl);
 };
 
-export const getLlmPageText = async (tenant: Tenant, slug: string) => {
+export const getLlmPageText = async (
+  tenant: Tenant,
+  slug: string,
+  _context: TenantRequestContext = {}
+) => {
   const prebuilt = await loadTenantUtilityTemplate(
     tenant,
     getPrebuiltUtilityLlmPagePath(slug)
@@ -567,7 +521,11 @@ export const getLlmPageText = async (tenant: Tenant, slug: string) => {
   if (!page) {
     return null;
   }
-  return formatMarkdownPage(page.title, page.content);
+  return formatMarkdownPage(
+    page.title,
+    toAgentMarkdown(page.content),
+    page.description
+  );
 };
 
 export const buildTenantSkillsIndex = async (
@@ -639,6 +597,14 @@ export const buildTenantLlmsSegment = async (
   segmentName: string,
   context: TenantRequestContext = {}
 ): Promise<string | null> => {
+  const prebuilt = await loadTenantUtilityTemplate(
+    tenant,
+    `${PREBUILT_UTILITY_LLMS_SEGMENT_PREFIX}${segmentName}.txt`
+  );
+  if (prebuilt) {
+    return renderUtilityTemplate(prebuilt, tenant, context);
+  }
+
   const data = await loadTenantUrlData(tenant);
   const segments = getNavGroupSegments(data);
   const segmentSlugs = segments.get(segmentName);
@@ -665,7 +631,13 @@ export const buildTenantLlmsSegment = async (
 
   const parts = segmentPages.map((page) => {
     const url = `${origin}${toDocHref(page.slug, basePath)}`;
-    return formatMarkdownPageSection(page.title, url, page.content);
+    const content = prepareLlmsFullContent(page.content, origin, basePath);
+    return formatMarkdownPageSection(
+      page.title,
+      url,
+      content,
+      page.description
+    );
   });
 
   return [
@@ -685,7 +657,8 @@ export const listTenantLlmsSegments = async (
 
 export const getPageJson = async (
   tenant: Tenant,
-  slug: string
+  slug: string,
+  context: TenantRequestContext = {}
 ): Promise<Record<string, unknown> | null> => {
   const data = await loadTenantUrlData(tenant);
   const contentEntry = data.contentIndex.bySlug.get(slug);
@@ -693,9 +666,10 @@ export const getPageJson = async (
     return null;
   }
 
-  const basePath = tenant.pathPrefix ? `/${tenant.pathPrefix}` : "";
-  const url = `https://${tenant.primaryDomain}${toDocHref(slug, basePath)}`;
-  const markdownUrl = `https://${tenant.primaryDomain}${toMarkdownDocHref(slug, basePath)}`;
+  const origin = getCanonicalOrigin(tenant, context);
+  const basePath = getCanonicalDocBasePath(tenant, context);
+  const url = `${origin}${toDocHref(slug, basePath)}`;
+  const markdownUrl = `${origin}${toMarkdownDocHref(slug, basePath)}`;
 
   const result: Record<string, unknown> = {
     "@context": "https://schema.org",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blodemd",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "Blode.md CLI",
   "repository": {
     "type": "git",
@@ -14,7 +14,8 @@
     "dev-server",
     "docs",
     "packages",
-    "scripts/prepare-package.mjs"
+    "scripts/prepare-package.mjs",
+    "scripts/repo-packages.mjs"
   ],
   "type": "module",
   "main": "./dist/index.mjs",
@@ -34,7 +35,7 @@
     "lint:fix": "oxlint --fix .",
     "format": "oxfmt --write .",
     "format:check": "oxfmt .",
-    "test:unit": "vitest run --root ../.. --config vitest.unit.config.ts apps/cli/src"
+    "test:unit": "sh -c 'cd ../.. && vitest run --config vitest.config.ts --project unit apps/cli/src'"
   },
   "dependencies": {
     "@base-ui/react": "^1.3.0",
@@ -42,7 +43,7 @@
     "@mdx-js/mdx": "^3.1.1",
     "@shikijs/rehype": "^4.0.2",
     "@tailwindcss/postcss": "^4.2.2",
-    "@types/node": "^22.19.15",
+    "@types/node": "^24.12.2",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "blode-icons-react": "^0.3.10",
@@ -76,6 +77,8 @@
   },
   "devDependencies": {
     "@repo/common": "*",
+    "@repo/contracts": "*",
+    "@repo/models": "*",
     "@repo/previewing": "*",
     "@repo/typescript-config": "*",
     "oxfmt": "^0.42.0",
@@ -84,6 +87,6 @@
     "ultracite": "^7.3.2"
   },
   "engines": {
-    "node": ">=20.17.0"
+    "node": "24.x"
   }
 }

package/packages/@repo/common/package.json

@@ -25,7 +25,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/contracts/dist/analytics.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const ProjectAnalyticsGa4Schema: z.ZodObject<{
+    measurementId: z.ZodString;
+}, z.core.$strip>;
+export type ProjectAnalyticsGa4 = z.infer<typeof ProjectAnalyticsGa4Schema>;
+export declare const ProjectAnalyticsPosthogSchema: z.ZodObject<{
+    host: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodString;
+}, z.core.$strip>;
+export type ProjectAnalyticsPosthog = z.infer<typeof ProjectAnalyticsPosthogSchema>;
+export declare const ProjectAnalyticsSchema: z.ZodObject<{
+    ga4: z.ZodOptional<z.ZodObject<{
+        measurementId: z.ZodString;
+    }, z.core.$strip>>;
+    posthog: z.ZodOptional<z.ZodObject<{
+        host: z.ZodOptional<z.ZodString>;
+        projectKey: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectAnalytics = z.infer<typeof ProjectAnalyticsSchema>;
+//# sourceMappingURL=analytics.d.ts.map

package/packages/@repo/contracts/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,yBAAyB;;iBAOpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,6BAA6B;;;iBAQxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/packages/@repo/contracts/dist/analytics.js

@@ -0,0 +1,18 @@
+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 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 const ProjectAnalyticsSchema = z.object({
+    ga4: ProjectAnalyticsGa4Schema.optional(),
+    posthog: ProjectAnalyticsPosthogSchema.optional(),
+});

package/packages/@repo/contracts/dist/deployment.js

@@ -30,7 +30,7 @@ export const PublishDeploymentCreateSchema = z.object({
     environment: DeploymentEnvironmentSchema.optional(),
 });
 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/dist/git.js

@@ -8,7 +8,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),
@@ -17,7 +17,7 @@ export const GitConnectionSchema = z.object({
 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/dist/ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,QAAQ,aAAoB,CAAC;AAC1C,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,aAGC,CAAC;AACzB,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,WAAW,aAAqB,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,SAAS,aAAmB,CAAC;AAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C,eAAO,MAAM,cAAc,aAAoB,CAAC;AAChD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,UAAU,aAAoB,CAAC;AAC5C,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,QAAQ,aAAoB,CAAC;AAC1C,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,aAI2B,CAAC;AACnD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,WAAW,aAAqB,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,SAAS,aAAmB,CAAC;AAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C,eAAO,MAAM,cAAc,aAAoB,CAAC;AAChD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,UAAU,aAAoB,CAAC;AAC5C,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/packages/@repo/contracts/dist/ids.js

@@ -3,7 +3,8 @@ export const IdSchema = z.string().uuid();
 export const SlugSchema = z
     .string()
     .min(1)
-    .regex(/^[a-z0-9-]+$/);
+    .max(63)
+    .regex(/^(?!-)[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/);
 export const EmailSchema = z.string().email();
 export const UrlSchema = z.string().url();
 export const HostnameSchema = z.string().min(1);

package/packages/@repo/contracts/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./analytics.js";
 export * from "./dates.js";
 export * from "./deployment.js";
 export * from "./domain.js";

package/packages/@repo/contracts/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/packages/@repo/contracts/dist/index.js

@@ -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/dist/project.d.ts

@@ -1,5 +1,14 @@
 import { z } from "zod";
 export declare const ProjectSchema: z.ZodObject<{
+    analytics: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        ga4: z.ZodOptional<z.ZodObject<{
+            measurementId: z.ZodString;
+        }, z.core.$strip>>;
+        posthog: z.ZodOptional<z.ZodObject<{
+            host: z.ZodOptional<z.ZodString>;
+            projectKey: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     createdAt: z.ZodString;
     deploymentName: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -10,13 +19,21 @@ export declare const ProjectSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type Project = z.infer<typeof ProjectSchema>;
 export declare const ProjectCreateSchema: z.ZodObject<{
-    deploymentName: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
     slug: z.ZodString;
 }, z.core.$strip>;
 export type ProjectCreateInput = z.infer<typeof ProjectCreateSchema>;
 export declare const ProjectUpdateSchema: z.ZodObject<{
+    analytics: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        ga4: z.ZodOptional<z.ZodObject<{
+            measurementId: z.ZodString;
+        }, z.core.$strip>>;
+        posthog: z.ZodOptional<z.ZodObject<{
+            host: z.ZodOptional<z.ZodString>;
+            projectKey: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     deploymentName: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodString>;

package/packages/@repo/contracts/dist/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa;;;;;;;;iBAQxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;iBASxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/packages/@repo/contracts/dist/project.js

@@ -1,7 +1,9 @@
 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(),
@@ -11,12 +13,12 @@ export const ProjectSchema = z.object({
     updatedAt: IsoDateSchema,
 });
 export const ProjectCreateSchema = z.object({
-    deploymentName: z.string().min(1),
     description: z.string().optional(),
     name: z.string().min(1),
     slug: SlugSchema,
 });
 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/dist/tenant.d.ts

@@ -7,6 +7,15 @@ export type TenantStatus = z.infer<typeof TenantStatusSchema>;
 export declare const TenantSchema: z.ZodObject<{
     activeDeploymentId: z.ZodOptional<z.ZodString>;
     activeDeploymentManifestUrl: z.ZodOptional<z.ZodString>;
+    analytics: z.ZodOptional<z.ZodObject<{
+        ga4: z.ZodOptional<z.ZodObject<{
+            measurementId: z.ZodString;
+        }, z.core.$strip>>;
+        posthog: z.ZodOptional<z.ZodObject<{
+            host: z.ZodOptional<z.ZodString>;
+            projectKey: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     customDomains: z.ZodArray<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
@@ -34,6 +43,15 @@ export declare const TenantResolutionSchema: z.ZodObject<{
     tenant: z.ZodObject<{
         activeDeploymentId: z.ZodOptional<z.ZodString>;
         activeDeploymentManifestUrl: z.ZodOptional<z.ZodString>;
+        analytics: z.ZodOptional<z.ZodObject<{
+            ga4: z.ZodOptional<z.ZodObject<{
+                measurementId: z.ZodString;
+            }, z.core.$strip>>;
+            posthog: z.ZodOptional<z.ZodObject<{
+                host: z.ZodOptional<z.ZodString>;
+                projectKey: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         customDomains: z.ZodArray<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
@@ -59,6 +77,15 @@ export declare const TenantEdgeHostRecordSchema: z.ZodObject<{
     tenant: z.ZodObject<{
         activeDeploymentId: z.ZodOptional<z.ZodString>;
         activeDeploymentManifestUrl: z.ZodOptional<z.ZodString>;
+        analytics: z.ZodOptional<z.ZodObject<{
+            ga4: z.ZodOptional<z.ZodObject<{
+                measurementId: z.ZodString;
+            }, z.core.$strip>>;
+            posthog: z.ZodOptional<z.ZodObject<{
+                host: z.ZodOptional<z.ZodString>;
+                projectKey: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         customDomains: z.ZodArray<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
@@ -80,6 +107,15 @@ export declare const TenantEdgeSlugRecordSchema: z.ZodObject<{
     tenant: z.ZodObject<{
         activeDeploymentId: z.ZodOptional<z.ZodString>;
         activeDeploymentManifestUrl: z.ZodOptional<z.ZodString>;
+        analytics: z.ZodOptional<z.ZodObject<{
+            ga4: z.ZodOptional<z.ZodObject<{
+                measurementId: z.ZodString;
+            }, z.core.$strip>>;
+            posthog: z.ZodOptional<z.ZodObject<{
+                host: z.ZodOptional<z.ZodString>;
+                projectKey: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         customDomains: z.ZodArray<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         id: z.ZodString;

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

@@ -1 +1 @@
-{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../src/tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,kBAAkB;;;EAAiC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;iBAYvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;iBAMrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;iBAIrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AACjD,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AACjD,eAAO,MAAM,kCAAkC,iBAAiB,CAAC;AACjE,eAAO,MAAM,kCAAkC,iBAAiB,CAAC;AAEjE,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,WACJ,CAAC;AAEjD,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,WACzB,CAAC;AAO5B,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,WACc,CAAC;AAEhE,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,WACc,CAAC;AAEhE,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,WACkB,CAAC;AAE1E,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,WACkB,CAAC;AAE1E,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,aAGjD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,aAGjD,CAAC"}
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../src/tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,kBAAkB;;;EAAiC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;iBAavB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AACjD,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AACjD,eAAO,MAAM,kCAAkC,iBAAiB,CAAC;AACjE,eAAO,MAAM,kCAAkC,iBAAiB,CAAC;AAEjE,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,WACJ,CAAC;AAEjD,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,WACzB,CAAC;AAO5B,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,WACc,CAAC;AAEhE,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,WACc,CAAC;AAEhE,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,WACkB,CAAC;AAE1E,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,WACkB,CAAC;AAE1E,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,aAGjD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,aAGjD,CAAC"}

package/packages/@repo/contracts/dist/tenant.js

@@ -1,9 +1,11 @@
 import { z } from "zod";
+import { ProjectAnalyticsSchema } from "./analytics.js";
 import { HostnameSchema, IdSchema, PathSchema, SlugSchema, UrlSchema, } from "./ids.js";
 export const TenantStatusSchema = z.enum(["active", "disabled"]);
 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/contracts/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",