minutework 0.1.32 → 0.1.33

package/assets/templates/next-tenant-app/src/lib/content/contracts.ts

@@ -1,399 +0,0 @@
-import { z } from "zod";
-
-export const marketingPageKeys = ["home", "pricing"] as const;
-export const publicContentKinds = ["docs", "blog"] as const;
-export const requiredMarketingPagePaths = {
-  home: "/",
-  pricing: "/pricing",
-} as const;
-
-export type MarketingPageKey = (typeof marketingPageKeys)[number];
-export type PublicContentKind = (typeof publicContentKinds)[number];
-
-export type PublicLink = {
-  label: string;
-  href: string;
-};
-
-export type ContentCollectionConfig = {
-  eyebrow: string;
-  title: string;
-  description: string;
-};
-
-export type SiteConfig = {
-  siteName: string;
-  siteDescription: string;
-  organizationName: string;
-  footerBlurb: string;
-  primaryCta: PublicLink;
-  secondaryCta: PublicLink;
-  primaryNavigation: PublicLink[];
-  collections: Record<PublicContentKind, ContentCollectionConfig>;
-};
-
-export type SeoMetadata = {
-  title: string;
-  description: string;
-};
-
-export type MarketingSection = {
-  eyebrow?: string;
-  title: string;
-  body: string;
-  points?: string[];
-};
-
-export type MarketingPage = {
-  pageKey: MarketingPageKey;
-  path: string;
-  heroEyebrow: string;
-  heroTitle: string;
-  heroBody: string;
-  primaryCta: PublicLink;
-  secondaryCta?: PublicLink | null;
-  sections: MarketingSection[];
-  seo: SeoMetadata;
-};
-
-type PublicEntrySummaryBase = {
-  title: string;
-  description: string;
-  eyebrow?: string;
-  publishedAt?: string | null;
-  readingTime?: string | null;
-};
-
-export type DocsEntrySummary = PublicEntrySummaryBase & {
-  kind: "docs";
-  slug: string[];
-};
-
-export type BlogEntrySummary = PublicEntrySummaryBase & {
-  kind: "blog";
-  slug: [string];
-};
-
-export type PublicEntrySummary = DocsEntrySummary | BlogEntrySummary;
-
-export type PublicEntrySection = {
-  heading: string;
-  paragraphs: string[];
-};
-
-type PublicEntryBody = {
-  body: {
-    intro: string;
-    sections: PublicEntrySection[];
-  };
-  seo: SeoMetadata;
-};
-
-export type DocsEntry = DocsEntrySummary & PublicEntryBody;
-export type BlogEntry = BlogEntrySummary & PublicEntryBody;
-export type PublicEntry = DocsEntry | BlogEntry;
-
-/**
- * A single section/block within a CMS page's content_structure.
- *
- * Section types are extensible strings — not a closed enum.  This allows
- * tenant-specific or extension-pack sections without modifying the baseline.
- */
-export type ContentSection = {
-  section_key: string;
-  section_type: string;
-  sort_order?: number;
-  data: Record<string, unknown>;
-};
-
-/**
- * A CMS page backed by the mw.core.site runtime baseline.
- *
- * content_structure is an open, ordered section/block graph — not a fixed
- * template.  The section renderer maps section_type to React components.
- */
-export type ContentStructurePage = {
-  page_key: string;
-  path: string;
-  title: string;
-  status: string;
-  sort_order?: number;
-  content_structure: {
-    sections: ContentSection[];
-  };
-  seo_metadata?: SeoMetadata;
-  og_metadata?: Record<string, string>;
-  visibility?: string;
-};
-
-export interface PublicContentAdapter {
-  getSiteConfig(): Promise<SiteConfig>;
-  getMarketingPage(pageKey: MarketingPageKey): Promise<MarketingPage | null>;
-  listEntries(kind: PublicContentKind): Promise<PublicEntrySummary[]>;
-  getEntry(kind: PublicContentKind, slugParts: string[]): Promise<PublicEntry | null>;
-  /** Retrieve a CMS page by its URL path. Returns null if not found. */
-  getPageByPath?(path: string): Promise<ContentStructurePage | null>;
-  /** List all CMS pages, optionally filtered by status. */
-  listPages?(status?: string): Promise<ContentStructurePage[]>;
-}
-
-export const publicLinkSchema = z.object({
-  label: z.string().trim().min(1),
-  href: z.string().trim().min(1),
-});
-
-export const seoMetadataSchema = z.object({
-  title: z.string().trim().min(1),
-  description: z.string().trim().min(1),
-});
-
-export const contentCollectionConfigSchema = z.object({
-  eyebrow: z.string().trim().min(1),
-  title: z.string().trim().min(1),
-  description: z.string().trim().min(1),
-});
-
-export const siteConfigSchema = z.object({
-  siteName: z.string().trim().min(1),
-  siteDescription: z.string().trim().min(1),
-  organizationName: z.string().trim().min(1),
-  footerBlurb: z.string().trim().min(1),
-  primaryCta: publicLinkSchema,
-  secondaryCta: publicLinkSchema,
-  primaryNavigation: z.array(publicLinkSchema).min(1),
-  collections: z.object({
-    docs: contentCollectionConfigSchema,
-    blog: contentCollectionConfigSchema,
-  }),
-});
-
-export const marketingSectionSchema = z.object({
-  eyebrow: z.string().trim().min(1).optional(),
-  title: z.string().trim().min(1),
-  body: z.string().trim().min(1),
-  points: z.array(z.string().trim().min(1)).optional(),
-});
-
-export const marketingPageSchema = z
-  .object({
-    pageKey: z.enum(marketingPageKeys),
-    path: z.string().trim().min(1),
-    heroEyebrow: z.string().trim().min(1),
-    heroTitle: z.string().trim().min(1),
-    heroBody: z.string().trim().min(1),
-    primaryCta: publicLinkSchema,
-    secondaryCta: publicLinkSchema.nullish(),
-    sections: z.array(marketingSectionSchema).min(1),
-    seo: seoMetadataSchema,
-  })
-  .superRefine((page, context) => {
-    const requiredPath = requiredMarketingPagePaths[page.pageKey];
-
-    if (page.path !== requiredPath) {
-      context.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["path"],
-        message: `"${page.pageKey}" marketing page must use the "${requiredPath}" route.`,
-      });
-    }
-  });
-
-const marketingPagesSchema = z
-  .array(marketingPageSchema)
-  .superRefine((pages, context) => {
-    const counts = new Map<MarketingPageKey, number>();
-
-    for (const [index, page] of pages.entries()) {
-      const nextCount = (counts.get(page.pageKey) ?? 0) + 1;
-      counts.set(page.pageKey, nextCount);
-
-      if (nextCount > 1) {
-        context.addIssue({
-          code: z.ZodIssueCode.custom,
-          path: [index, "pageKey"],
-          message: `Duplicate marketing page for "${page.pageKey}".`,
-        });
-      }
-    }
-  });
-
-const slugSegmentSchema = z.string().trim().min(1);
-
-const publicEntrySummaryBaseSchema = z.object({
-  title: z.string().trim().min(1),
-  description: z.string().trim().min(1),
-  eyebrow: z.string().trim().min(1).optional(),
-  publishedAt: z.string().trim().min(1).nullable().optional(),
-  readingTime: z.string().trim().min(1).nullable().optional(),
-});
-
-export const docsEntrySummarySchema = publicEntrySummaryBaseSchema.extend({
-  kind: z.literal("docs"),
-  slug: z.array(slugSegmentSchema).min(1),
-});
-
-export const blogEntrySummarySchema = publicEntrySummaryBaseSchema.extend({
-  kind: z.literal("blog"),
-  slug: z.tuple([slugSegmentSchema]),
-});
-
-export const publicEntrySummarySchema = z.union([
-  docsEntrySummarySchema,
-  blogEntrySummarySchema,
-]);
-
-function normalizeSlugParts(slugParts: readonly string[]) {
-  return slugParts.map((part) => part.trim().toLowerCase()).filter(Boolean).join("/");
-}
-
-const publicEntryBodySchema = z.object({
-  body: z.object({
-    intro: z.string().trim().min(1),
-    sections: z
-      .array(
-        z.object({
-          heading: z.string().trim().min(1),
-          paragraphs: z.array(z.string().trim().min(1)).min(1),
-        }),
-      )
-      .min(1),
-  }),
-  seo: seoMetadataSchema,
-});
-
-export const docsEntrySchema = docsEntrySummarySchema.extend(
-  publicEntryBodySchema.shape,
-);
-
-export const blogEntrySchema = blogEntrySummarySchema.extend(
-  publicEntryBodySchema.shape,
-);
-
-export const publicEntrySchema = z.union([docsEntrySchema, blogEntrySchema]);
-
-export const contentSectionSchema = z.object({
-  section_key: z.string().min(1),
-  section_type: z.string().min(1),
-  sort_order: z.number().optional(),
-  data: z.record(z.unknown()),
-});
-
-export const contentStructurePageSchema = z.object({
-  page_key: z.string().min(1),
-  path: z.string().min(1),
-  title: z.string().min(1),
-  status: z.string().min(1),
-  sort_order: z.number().optional(),
-  content_structure: z.object({
-    sections: z.array(contentSectionSchema),
-  }),
-  seo_metadata: seoMetadataSchema.optional(),
-  og_metadata: z.record(z.string()).optional(),
-  visibility: z.string().optional(),
-});
-
-export const publicContentSnapshotSchema = z.object({
-  site: siteConfigSchema,
-  marketingPages: marketingPagesSchema,
-  docs: z.array(docsEntrySchema),
-  blog: z.array(blogEntrySchema),
-  pages: z.array(contentStructurePageSchema).optional(),
-});
-
-export const publicSiteSnapshotEnvironmentSchema = z.enum(["preview", "live"]);
-export const publicSiteSnapshotSourceBoundarySchema = z.enum([
-  "runtime_preview",
-  "runtime_live",
-  "published_live",
-]);
-
-export const publicSiteSnapshotEnvelopeSchema = z
-  .object({
-    environment: publicSiteSnapshotEnvironmentSchema,
-    source_boundary: publicSiteSnapshotSourceBoundarySchema,
-    snapshot: publicContentSnapshotSchema,
-  })
-  .superRefine((value, context) => {
-    if (
-      value.environment === "preview" &&
-      value.source_boundary !== "runtime_preview"
-    ) {
-      context.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["source_boundary"],
-        message:
-          'Preview public-site snapshots must declare the "runtime_preview" source boundary.',
-      });
-    }
-
-    if (
-      value.environment === "live" &&
-      !["published_live", "runtime_live"].includes(value.source_boundary)
-    ) {
-      context.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["source_boundary"],
-        message:
-          'Live public-site snapshots must declare the "published_live" or "runtime_live" source boundary.',
-      });
-    }
-  });
-
-export function marketingPageResultSchema(
-  pageKey: MarketingPageKey,
-): z.ZodType<MarketingPage | null> {
-  return marketingPageSchema.nullable().superRefine((page, context) => {
-    if (!page) {
-      return;
-    }
-
-    if (page.pageKey !== pageKey) {
-      context.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["pageKey"],
-        message: `Expected "${pageKey}" marketing page.`,
-      });
-    }
-  });
-}
-
-export function publicEntrySummaryListSchema(
-  kind: PublicContentKind,
-): z.ZodType<PublicEntrySummary[]> {
-  return z.array(kind === "docs" ? docsEntrySummarySchema : blogEntrySummarySchema);
-}
-
-export function publicEntryResultSchema(
-  kind: PublicContentKind,
-  slugParts: readonly string[],
-): z.ZodType<PublicEntry | null> {
-  const refineEntryResult = <
-    TEntry extends DocsEntry | BlogEntry | null,
-  >(
-    entry: TEntry,
-    context: z.RefinementCtx,
-  ) => {
-    if (!entry) {
-      return;
-    }
-
-    if (normalizeSlugParts(entry.slug) !== normalizeSlugParts(slugParts)) {
-      context.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["slug"],
-        message: `Expected "${kind}" entry slug to match "${slugParts.join("/")}".`,
-      });
-    }
-  };
-
-  if (kind === "docs") {
-    return docsEntrySchema.nullable().superRefine(refineEntryResult);
-  }
-
-  return blogEntrySchema.nullable().superRefine(refineEntryResult);
-}
-
-export type PublicContentSnapshot = z.infer<typeof publicContentSnapshotSchema>;
-export type PublicSiteSnapshotEnvelope = z.infer<
-  typeof publicSiteSnapshotEnvelopeSchema
->;

package/assets/templates/next-tenant-app/src/lib/content/custom-adapter.ts

@@ -1,5 +0,0 @@
-import type { PublicContentAdapter } from "@/lib/content/contracts";
-
-export function resolveCustomPublicContentAdapter(): PublicContentAdapter | null {
-  return null;
-}

package/assets/templates/next-tenant-app/src/lib/content/empty-state.ts

@@ -1,96 +0,0 @@
-import type {
-  MarketingPage,
-  MarketingPageKey,
-  SiteConfig,
-} from "@/lib/content/contracts";
-
-const emptyMarketingPageConfig: Record<
-  MarketingPageKey,
-  Pick<
-    MarketingPage,
-    | "heroEyebrow"
-    | "heroTitle"
-    | "heroBody"
-    | "path"
-    | "sections"
-  >
-> = {
-  home: {
-    heroEyebrow: "Public site",
-    heroTitle: "Your public site is ready for published content.",
-    heroBody:
-      "Connect this starter to MinuteWork public-site content and publish your first marketing page, docs entry, or blog post.",
-    path: "/",
-    sections: [
-      {
-        eyebrow: "First run",
-        title: "No published home page yet",
-        body:
-          "This starter now reads public-site content from the MinuteWork gateway during development and build.",
-      },
-      {
-        eyebrow: "Preview",
-        title: "Use preview for local authoring",
-        body:
-          "Set MW_PUBLIC_SITE_ENV=preview to render draft-safe preview content through the same API contract.",
-      },
-      {
-        eyebrow: "Publish",
-        title: "Live stays publication-safe",
-        body:
-          "Switch builds and deploys to MW_PUBLIC_SITE_ENV=live once the property has published content available.",
-      },
-    ],
-  },
-  pricing: {
-    heroEyebrow: "Pricing",
-    heroTitle: "Add your first published pricing page.",
-    heroBody:
-      "The pricing route is live, but the property has not published pricing content yet. Publish a pricing page to replace this empty-state shell.",
-    path: "/pricing",
-    sections: [
-      {
-        eyebrow: "Authoring source",
-        title: "Published pages stay externalized",
-        body:
-          "Marketing content now comes from the MinuteWork public-site snapshot API instead of seeded in-repo copy.",
-      },
-      {
-        eyebrow: "Build behavior",
-        title: "Static-first output still works",
-        body:
-          "Builds succeed with valid empty snapshots, so fresh properties can ship before authored content exists.",
-      },
-      {
-        eyebrow: "Next step",
-        title: "Publish pricing content when ready",
-        body:
-          "As soon as the property publishes a pricing page, this shell is replaced automatically by the fetched snapshot.",
-      },
-    ],
-  },
-};
-
-export function buildEmptyMarketingPage(
-  pageKey: MarketingPageKey,
-  siteConfig: SiteConfig,
-): MarketingPage {
-  const config = emptyMarketingPageConfig[pageKey];
-  const titlePrefix =
-    pageKey === "home" ? siteConfig.siteName : `${siteConfig.siteName} Pricing`;
-
-  return {
-    pageKey,
-    path: config.path,
-    heroEyebrow: config.heroEyebrow,
-    heroTitle: config.heroTitle,
-    heroBody: config.heroBody,
-    primaryCta: siteConfig.primaryCta,
-    secondaryCta: siteConfig.secondaryCta,
-    sections: config.sections,
-    seo: {
-      title: titlePrefix,
-      description: siteConfig.siteDescription,
-    },
-  };
-}

package/assets/templates/next-tenant-app/src/lib/content/release-manifest.test.ts

@@ -1,93 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import { buildReleaseManifest, releaseManifestSchema } from "./release-manifest";
-
-describe("release-manifest", () => {
-  it("builds a valid manifest from composition input", () => {
-    const manifest = buildReleaseManifest({
-      appPackId: "mw.core.site",
-      snapshotSchemaVersion: 1,
-      releaseClass: "static_export",
-      config: { site_title: "Test Site" },
-      pages: [
-        {
-          page_key: "home",
-          path: "/",
-          title: "Home",
-          sections: [{ section_key: "hero", section_type: "hero", data: {} }],
-        },
-        {
-          page_key: "about",
-          path: "/about",
-          title: "About",
-          sections: [],
-        },
-      ],
-      navigation: [
-        { nav_key: "header", slot: "header", items: [{ label: "Home" }] },
-      ],
-      forms: [
-        { form_key: "contact", schema: { fields: [{ name: "email" }] } },
-      ],
-      contentDigest: "sha256-abc123",
-    });
-
-    const parsed = releaseManifestSchema.safeParse(manifest);
-    expect(parsed.success).toBe(true);
-    expect(manifest.manifest_version).toBe(1);
-    expect(manifest.composition.config_updated).toBe(true);
-    expect(manifest.composition.pages).toHaveLength(2);
-    expect(manifest.composition.pages[0]!.section_count).toBe(1);
-    expect(manifest.composition.pages[1]!.section_count).toBe(0);
-    expect(manifest.composition.navigation[0]!.item_count).toBe(1);
-    expect(manifest.composition.forms[0]!.field_count).toBe(1);
-  });
-
-  it("handles null config", () => {
-    const manifest = buildReleaseManifest({
-      appPackId: "mw.core.site",
-      snapshotSchemaVersion: 1,
-      releaseClass: "ssr_container",
-      config: null,
-      pages: [],
-      navigation: [],
-      forms: [],
-      contentDigest: "sha256-empty",
-    });
-
-    expect(manifest.composition.config_updated).toBe(false);
-  });
-
-  it("supports attached external site metadata without adding a new release class", () => {
-    const manifest = buildReleaseManifest({
-      appPackId: "mw.core.site",
-      snapshotSchemaVersion: 1,
-      releaseClass: "runtime_local_sidecar",
-      config: null,
-      pages: [],
-      navigation: [],
-      forms: [],
-      attachedSite: {
-        mode: "attached_app",
-        adapter_module: "src/lib/content/custom-adapter.ts",
-        renderer: "external_next",
-        publish_target: "repo-sync",
-      },
-      contentDigest: "sha256-attached",
-    });
-
-    const parsed = releaseManifestSchema.safeParse(manifest);
-    expect(parsed.success).toBe(true);
-    expect(manifest.attached_site?.mode).toBe("attached_app");
-  });
-
-  it("validates against the schema", () => {
-    const invalid = {
-      manifest_version: 2, // wrong version
-      app_pack_id: "",
-    };
-
-    const parsed = releaseManifestSchema.safeParse(invalid);
-    expect(parsed.success).toBe(false);
-  });
-});