minutework 0.1.26 → 0.1.28

package/assets/templates/next-tenant-app/src/lib/platform/env.server.ts

@@ -3,6 +3,7 @@ import "server-only";
 import { z } from "zod";
 
 const DEFAULT_LOCAL_PLATFORM_BASE_URL = "http://127.0.0.1:8000";
+const DEFAULT_STATIC_PUBLIC_CONTENT_PATH = "content/public-site.json";
 
 const exampleFlagSchema = z.preprocess(
   (value) => value ?? "false",
@@ -18,35 +19,96 @@ const requiredStringEnvSchema = z.preprocess((value) => {
   return normalized.length > 0 ? normalized : undefined;
 }, z.string().min(1));
 
-const requiredUrlEnvSchema = z.preprocess((value) => {
+const optionalStringEnvSchema = z.preprocess((value) => {
   if (typeof value !== "string") {
     return value;
   }
 
   const normalized = value.trim();
   return normalized.length > 0 ? normalized : undefined;
-}, z.string().url());
+}, z.string().min(1).optional());
 
+const optionalUrlEnvSchema = z.preprocess((value) => {
+  if (typeof value !== "string") {
+    return value;
+  }
+
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : undefined;
+}, z.string().url().optional());
+
+const publicContentSourceSchema = z.enum([
+  "minutework_cms",
+  "custom",
+  "static_json",
+  "none",
+]);
 const publicSiteEnvironmentSchema = z.enum(["preview", "live"]);
 
-const envSchema = z.object({
-  MW_PLATFORM_BASE_URL: z.string().url(),
-  MW_CONTENT_API_TOKEN: requiredStringEnvSchema,
-  MW_TEMPLATE_APP_NAME: z.preprocess(
-    (value) => value ?? "MinuteWork Combined Starter",
-    z.string().trim().min(1),
-  ),
-  MW_PUBLIC_BASE_URL: requiredUrlEnvSchema,
-  MW_PUBLIC_SITE_PROPERTY_KEY: requiredStringEnvSchema,
-  MW_PUBLIC_SITE_ENV: z.preprocess(
-    (value) => value ?? "preview",
-    publicSiteEnvironmentSchema,
-  ),
-  MW_ENABLE_RUNTIME_COMMAND_EXAMPLE: exampleFlagSchema,
-  NODE_ENV: z
-    .enum(["development", "test", "production"])
-    .default("development"),
-});
+const envSchema = z
+  .object({
+    MW_PLATFORM_BASE_URL: z.string().url(),
+    MW_PUBLIC_CONTENT_SOURCE: z.preprocess(
+      (value) => value ?? "none",
+      publicContentSourceSchema,
+    ),
+    MW_CONTENT_API_TOKEN: optionalStringEnvSchema,
+    MW_TEMPLATE_APP_NAME: z.preprocess(
+      (value) => value ?? "MinuteWork Combined Starter",
+      z.string().trim().min(1),
+    ),
+    MW_PUBLIC_BASE_URL: optionalUrlEnvSchema,
+    MW_PUBLIC_SITE_PROPERTY_KEY: optionalStringEnvSchema,
+    MW_PUBLIC_SITE_ENV: z.preprocess(
+      (value) => value ?? "preview",
+      publicSiteEnvironmentSchema,
+    ),
+    MW_STATIC_PUBLIC_CONTENT_PATH: z.preprocess(
+      (value) => value ?? DEFAULT_STATIC_PUBLIC_CONTENT_PATH,
+      requiredStringEnvSchema,
+    ),
+    MW_ENABLE_RUNTIME_COMMAND_EXAMPLE: exampleFlagSchema,
+    NODE_ENV: z
+      .enum(["development", "test", "production"])
+      .default("development"),
+  })
+  .superRefine((value, context) => {
+    if (value.MW_PUBLIC_CONTENT_SOURCE === "minutework_cms") {
+      if (!value.MW_CONTENT_API_TOKEN) {
+        context.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: ["MW_CONTENT_API_TOKEN"],
+          message: "Required when MW_PUBLIC_CONTENT_SOURCE=minutework_cms",
+        });
+      }
+      if (!value.MW_PUBLIC_BASE_URL) {
+        context.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: ["MW_PUBLIC_BASE_URL"],
+          message: "Required when MW_PUBLIC_CONTENT_SOURCE=minutework_cms",
+        });
+      }
+      if (!value.MW_PUBLIC_SITE_PROPERTY_KEY) {
+        context.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: ["MW_PUBLIC_SITE_PROPERTY_KEY"],
+          message: "Required when MW_PUBLIC_CONTENT_SOURCE=minutework_cms",
+        });
+      }
+    }
+
+    if (
+      (value.MW_PUBLIC_CONTENT_SOURCE === "custom" ||
+        value.MW_PUBLIC_CONTENT_SOURCE === "static_json") &&
+      !value.MW_PUBLIC_BASE_URL
+    ) {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["MW_PUBLIC_BASE_URL"],
+        message: `Required when MW_PUBLIC_CONTENT_SOURCE=${value.MW_PUBLIC_CONTENT_SOURCE}`,
+      });
+    }
+  });
 
 const defaultPlatformBaseUrl =
   process.env.MW_PLATFORM_BASE_URL ??
@@ -56,11 +118,13 @@ const defaultPlatformBaseUrl =
 
 const parsedEnv = envSchema.safeParse({
   MW_PLATFORM_BASE_URL: defaultPlatformBaseUrl,
+  MW_PUBLIC_CONTENT_SOURCE: process.env.MW_PUBLIC_CONTENT_SOURCE,
   MW_CONTENT_API_TOKEN: process.env.MW_CONTENT_API_TOKEN,
   MW_TEMPLATE_APP_NAME: process.env.MW_TEMPLATE_APP_NAME,
   MW_PUBLIC_BASE_URL: process.env.MW_PUBLIC_BASE_URL,
   MW_PUBLIC_SITE_PROPERTY_KEY: process.env.MW_PUBLIC_SITE_PROPERTY_KEY,
   MW_PUBLIC_SITE_ENV: process.env.MW_PUBLIC_SITE_ENV,
+  MW_STATIC_PUBLIC_CONTENT_PATH: process.env.MW_STATIC_PUBLIC_CONTENT_PATH,
   MW_ENABLE_RUNTIME_COMMAND_EXAMPLE:
     process.env.MW_ENABLE_RUNTIME_COMMAND_EXAMPLE,
   NODE_ENV: process.env.NODE_ENV,

package/assets/templates/next-tenant-app/src/lib/public-site.test.ts

@@ -13,7 +13,7 @@ describe("public-site helpers", () => {
       siteName: "MinuteWork Combined Starter",
     });
 
-    expect(resolvePublicSiteUrl("/docs").toString()).toBe("http://127.0.0.1:3000/docs");
+    expect(resolvePublicSiteUrl("/docs")?.toString()).toBe("http://127.0.0.1:3000/docs");
     expect(metadata.alternates?.canonical).toBe("http://127.0.0.1:3000/docs");
     expect(metadata.openGraph?.url).toBe("http://127.0.0.1:3000/docs");
   });

package/assets/templates/next-tenant-app/src/lib/public-site.ts

@@ -4,7 +4,24 @@ import type { Metadata } from "next";
 
 import { env } from "@/lib/platform/env.server";
 
+export function isPublicContentDisabled() {
+  return env.MW_PUBLIC_CONTENT_SOURCE === "none";
+}
+
+export function buildDisabledPublicMetadata(): Metadata {
+  return {
+    robots: {
+      index: false,
+      follow: false,
+    },
+  };
+}
+
 export function resolvePublicMetadataBase() {
+  if (!env.MW_PUBLIC_BASE_URL) {
+    return null;
+  }
+
   return new URL(
     env.MW_PUBLIC_BASE_URL.endsWith("/")
       ? env.MW_PUBLIC_BASE_URL
@@ -13,7 +30,10 @@ export function resolvePublicMetadataBase() {
 }
 
 export function resolvePublicSiteUrl(pathname = "/") {
-  return new URL(pathname.replace(/^\/*/, "/"), resolvePublicMetadataBase());
+  const metadataBase = resolvePublicMetadataBase();
+  return metadataBase
+    ? new URL(pathname.replace(/^\/*/, "/"), metadataBase)
+    : null;
 }
 
 export function buildPublicMetadata(input: {
@@ -24,20 +44,24 @@ export function buildPublicMetadata(input: {
   type?: "website" | "article";
   publishedTime?: string | null;
 }): Metadata {
-  const canonicalUrl = resolvePublicSiteUrl(input.path).toString();
+  const canonicalUrl = resolvePublicSiteUrl(input.path)?.toString();
 
   return {
     title: input.title,
     description: input.description,
-    alternates: {
-      canonical: canonicalUrl,
-    },
+    ...(canonicalUrl
+      ? {
+          alternates: {
+            canonical: canonicalUrl,
+          },
+        }
+      : {}),
     openGraph: {
       title: input.title,
       description: input.description,
-      url: canonicalUrl,
       siteName: input.siteName ?? env.MW_TEMPLATE_APP_NAME,
       type: input.type ?? "website",
+      ...(canonicalUrl ? { url: canonicalUrl } : {}),
       ...(input.publishedTime ? { publishedTime: input.publishedTime } : {}),
     },
     twitter: {

package/assets/templates/next-tenant-app/tools/template/with-public-site-fixture.mjs

@@ -89,6 +89,7 @@ try {
       ...process.env,
       MW_CONTENT_API_TOKEN: "validate-content-token",
       MW_PLATFORM_BASE_URL: baseUrl,
+      MW_PUBLIC_CONTENT_SOURCE: "minutework_cms",
       MW_PUBLIC_BASE_URL: "https://public.example.com",
       MW_PUBLIC_SITE_ENV: "preview",
       MW_PUBLIC_SITE_PROPERTY_KEY: "main-site",

package/assets/templates/next-tenant-app/vitest.config.ts

@@ -12,10 +12,12 @@ export default defineConfig({
   test: {
     env: {
       MW_PLATFORM_BASE_URL: "http://127.0.0.1:8000",
+      MW_PUBLIC_CONTENT_SOURCE: "minutework_cms",
       MW_CONTENT_API_TOKEN: "test-content-token",
       MW_PUBLIC_BASE_URL: "http://127.0.0.1:3000",
       MW_PUBLIC_SITE_PROPERTY_KEY: "main-site",
       MW_PUBLIC_SITE_ENV: "preview",
+      MW_STATIC_PUBLIC_CONTENT_PATH: "content/public-site.json",
     },
     environment: "node",
     globals: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutework",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "MinuteWork CLI for workspace scaffolding, local preview workflows, and hosted preview deploys.",
   "type": "module",
   "bin": {