npm - minutework - Versions diffs - 0.1.39 → 0.1.41 - Mend

minutework 0.1.39 → 0.1.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (166) hide show

package/assets/templates/vuilder-public-site/src/app/blog/[slug]/page.tsx ADDED Viewed

@@ -0,0 +1,25 @@
+import { notFound } from "next/navigation";
+import { getSiteManifest } from "@/lib/public-dj.server";
+export default async function BlogPostPage({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug } = await params;
+  const manifest = await getSiteManifest();
+  const index = Number(slug.replace(/^post-/, "")) - 1;
+  const post = manifest.payload.blog_posts[index];
+  if (!post) notFound();
+  return (
+    <main className="site-main">
+      <p className="eyebrow">Blog</p>
+      <h1>{post.content_ref}</h1>
+      <div className="panel">
+        <p>Digest: {post.digest}</p>
+      </div>
+    </main>
+  );
+}

package/assets/templates/vuilder-public-site/src/app/blog/page.tsx ADDED Viewed

@@ -0,0 +1,26 @@
+import Link from "next/link";
+import { getSiteManifest } from "@/lib/public-dj.server";
+import { appRoutes } from "@/lib/routes";
+export default async function BlogIndexPage() {
+  const manifest = await getSiteManifest();
+  return (
+    <main className="site-main">
+      <p className="eyebrow">Blog</p>
+      <h1>Updates</h1>
+      <div className="panel">
+        {manifest.payload.blog_posts.length === 0 ? (
+          <p>No published posts are pinned to this release yet.</p>
+        ) : (
+          manifest.payload.blog_posts.map((post, index) => (
+            <p key={`${post.content_ref}:${post.digest}`}>
+              <Link href={appRoutes.blogPost(`post-${index + 1}`)}>{post.content_ref}</Link>
+            </p>
+          ))
+        )}
+      </div>
+    </main>
+  );
+}

package/assets/templates/vuilder-public-site/src/app/globals.css ADDED Viewed

@@ -0,0 +1,103 @@
+:root {
+  color-scheme: light;
+  --background: #f8f5ef;
+  --foreground: #25231f;
+  --muted: #6d675f;
+  --line: #ded6ca;
+  --accent: #335c67;
+  --accent-strong: #1f3f46;
+  --surface: #fffdf8;
+}
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+}
+a {
+  color: inherit;
+}
+.site-shell {
+  min-height: 100vh;
+}
+.site-header,
+.site-main,
+.site-footer {
+  width: min(1120px, calc(100vw - 40px));
+  margin: 0 auto;
+}
+.site-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 24px 0;
+  border-bottom: 1px solid var(--line);
+}
+.site-main {
+  padding: 72px 0;
+}
+.hero {
+  display: grid;
+  gap: 24px;
+  max-width: 760px;
+}
+.eyebrow {
+  margin: 0;
+  color: var(--accent);
+  font-size: 0.82rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+h1 {
+  margin: 0;
+  font-family: Georgia, "Times New Roman", serif;
+  font-size: clamp(3rem, 8vw, 6.75rem);
+  font-weight: 500;
+  line-height: 0.95;
+}
+p {
+  color: var(--muted);
+  font-size: 1.08rem;
+  line-height: 1.7;
+}
+.button {
+  display: inline-flex;
+  min-height: 44px;
+  width: fit-content;
+  align-items: center;
+  justify-content: center;
+  border: 1px solid var(--accent-strong);
+  background: var(--accent-strong);
+  color: white;
+  padding: 0 18px;
+  text-decoration: none;
+}
+.panel {
+  margin-top: 40px;
+  border: 1px solid var(--line);
+  background: var(--surface);
+  padding: 24px;
+}
+.site-footer {
+  padding: 32px 0;
+  border-top: 1px solid var(--line);
+  color: var(--muted);
+}

package/assets/templates/vuilder-public-site/src/app/layout.tsx ADDED Viewed

@@ -0,0 +1,18 @@
+import type { Metadata } from "next";
+import "@/app/globals.css";
+import { env } from "@/lib/env.server";
+export const metadata: Metadata = {
+  metadataBase: new URL(env.MW_PUBLIC_BASE_URL),
+  title: "Vuilder Public Site",
+  description: "A Vuilder public website backed by public-dj content revisions.",
+};
+export default function RootLayout({ children }: Readonly<{ children: React.ReactNode }>) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/assets/templates/vuilder-public-site/src/app/onboarding/[[...step]]/page.tsx ADDED Viewed

@@ -0,0 +1,39 @@
+import { getSiteManifest } from "@/lib/public-dj.server";
+export default async function OnboardingPage({
+  params,
+}: {
+  params: Promise<{ step?: string[] }>;
+}) {
+  const { step = [] } = await params;
+  const manifest = await getSiteManifest();
+  return (
+    <main className="site-main">
+      <p className="eyebrow">Onboarding</p>
+      <h1>Start with {manifest.display_name}</h1>
+      <div className="panel">
+        <p>Current step: {step.join("/") || "intake"}</p>
+        <form action="/api/onboarding/start" method="post">
+          <p>
+            <label>
+              Email
+              <br />
+              <input name="email" type="email" required />
+            </label>
+          </p>
+          <p>
+            <label>
+              Name
+              <br />
+              <input name="name" type="text" />
+            </label>
+          </p>
+          <button className="button" type="submit">
+            Continue
+          </button>
+        </form>
+      </div>
+    </main>
+  );
+}

package/assets/templates/vuilder-public-site/src/app/page.tsx ADDED Viewed

@@ -0,0 +1,43 @@
+import Link from "next/link";
+import { appRoutes } from "@/lib/routes";
+import { getHomePageRef, getSiteManifest } from "@/lib/public-dj.server";
+export default async function HomePage() {
+  const [manifest, homePage] = await Promise.all([getSiteManifest(), getHomePageRef()]);
+  const headline = String(manifest.payload.metadata.headline ?? manifest.display_name);
+  const summary = String(
+    manifest.payload.metadata.summary ??
+      "A custom Vuilder public site rendered from pinned public-dj content.",
+  );
+  return (
+    <div className="site-shell">
+      <header className="site-header">
+        <strong>{manifest.display_name}</strong>
+        <nav>
+          <Link href={appRoutes.blog}>Blog</Link>
+          {" / "}
+          <Link href={appRoutes.onboarding()}>Start</Link>
+        </nav>
+      </header>
+      <main className="site-main">
+        <section className="hero">
+          <p className="eyebrow">{manifest.vertical_slug}</p>
+          <h1>{headline}</h1>
+          <p>{summary}</p>
+          <Link className="button" href={appRoutes.onboarding()}>
+            Start onboarding
+          </Link>
+        </section>
+        <section className="panel">
+          <p>
+            Release manifest: {manifest.content_ref} / {manifest.digest}
+          </p>
+          <p>Home page ref: {homePage?.content_ref ?? "not configured"}</p>
+        </section>
+      </main>
+      <footer className="site-footer">Powered by MinuteWork public-dj CMS.</footer>
+    </div>
+  );
+}

package/assets/templates/vuilder-public-site/src/lib/env.server.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import "server-only";
+import { z } from "zod";
+const envSchema = z.object({
+  MW_PUBLIC_DJ_BASE_URL: z.string().url(),
+  MW_AUTH_BASE_URL: z.string().url(),
+  MW_PLATFORM_BASE_URL: z.string().url(),
+  MW_PUBLIC_BASE_URL: z.string().url(),
+  MW_PUBLIC_SITE_PROPERTY_KEY: z.string().min(1),
+  MW_PUBLIC_SITE_ENV: z.enum(["preview", "live"]).default("preview"),
+  MW_PUBLIC_RELEASE_CLASS: z.enum(["static_export", "ssr_container"]).default("ssr_container"),
+  MW_PUBLIC_CONTENT_REF: z.string().min(1),
+  MW_PUBLIC_CONTENT_DIGEST: z.string().min(1),
+  MW_PUBLIC_DJ_READ_TOKEN: z.string().min(1),
+  MW_VUILDER_ONBOARDING_INTENT_TOKEN: z.string().min(1),
+});
+export const env = envSchema.parse({
+  MW_PUBLIC_DJ_BASE_URL: process.env.MW_PUBLIC_DJ_BASE_URL,
+  MW_AUTH_BASE_URL: process.env.MW_AUTH_BASE_URL,
+  MW_PLATFORM_BASE_URL: process.env.MW_PLATFORM_BASE_URL,
+  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_PUBLIC_RELEASE_CLASS: process.env.MW_PUBLIC_RELEASE_CLASS,
+  MW_PUBLIC_CONTENT_REF: process.env.MW_PUBLIC_CONTENT_REF,
+  MW_PUBLIC_CONTENT_DIGEST: process.env.MW_PUBLIC_CONTENT_DIGEST,
+  MW_PUBLIC_DJ_READ_TOKEN: process.env.MW_PUBLIC_DJ_READ_TOKEN,
+  MW_VUILDER_ONBOARDING_INTENT_TOKEN: process.env.MW_VUILDER_ONBOARDING_INTENT_TOKEN,
+});

package/assets/templates/vuilder-public-site/src/lib/platform.server.ts ADDED Viewed

@@ -0,0 +1,47 @@
+import "server-only";
+import { env } from "@/lib/env.server";
+import { getSiteManifest } from "@/lib/public-dj.server";
+export async function createCustomerVerticalSignupIntent(input: {
+  email?: string;
+  name?: string;
+  answers?: Record<string, unknown>;
+}) {
+  const manifest = await getSiteManifest();
+  const url = new URL("/api/v1/vuilder/onboarding-intents/", env.MW_PLATFORM_BASE_URL);
+  const response = await fetch(url.toString(), {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      authorization: `Bearer ${env.MW_VUILDER_ONBOARDING_INTENT_TOKEN}`,
+      "content-type": "application/json",
+    },
+    body: JSON.stringify({
+      kind: "customer_vertical_signup",
+      source: "vuilder_public_site",
+      vuilder_workspace_external_key: String(
+        manifest.payload.metadata.vuilder_workspace_external_key ?? "",
+      ),
+      property_key: env.MW_PUBLIC_SITE_PROPERTY_KEY,
+      site_release_key: String(manifest.payload.metadata.site_release_key ?? ""),
+      public_site_manifest_ref: manifest.content_ref,
+      public_site_manifest_digest: manifest.digest,
+      vertical_package_ref: manifest.payload.vertical_package?.content_ref ?? "",
+      vertical_package_digest: manifest.payload.vertical_package?.digest ?? "",
+      onboarding_flow_ref: manifest.payload.onboarding_flow?.content_ref ?? "",
+      onboarding_flow_digest: manifest.payload.onboarding_flow?.digest ?? "",
+      intake_payload: {
+        email: input.email ?? "",
+        name: input.name ?? "",
+        answers: input.answers ?? {},
+      },
+    }),
+  });
+  if (!response.ok) {
+    throw new Error(`Unable to create onboarding intent (${response.status}).`);
+  }
+  return response.json();
+}

package/assets/templates/vuilder-public-site/src/lib/public-dj.server.ts ADDED Viewed

@@ -0,0 +1,86 @@
+import "server-only";
+import { cache } from "react";
+import { z } from "zod";
+import { env } from "@/lib/env.server";
+const refDigestSchema = z.object({
+  content_ref: z.string().min(1),
+  digest: z.string().min(1),
+});
+const marketplacePackageRefSchema = z
+  .string()
+  .min(1)
+  .regex(/^core:app_pack_catalog:[^:]+:[^:]+:[^:]+$/);
+const verticalPackageRefDigestSchema = refDigestSchema.extend({
+  content_ref: marketplacePackageRefSchema,
+});
+const siteManifestSchema = z.object({
+  content_ref: z.string(),
+  digest: z.string(),
+  content_kind: z.literal("public_site_manifest"),
+  vertical_key: z.string(),
+  vertical_slug: z.string(),
+  property_key: z.string(),
+  display_name: z.string(),
+  payload: z.object({
+    pages: z.array(
+      refDigestSchema.extend({
+        page_key: z.string(),
+        path: z.string(),
+      }),
+    ),
+    blog_posts: z.array(refDigestSchema).default([]),
+    onboarding_flow: refDigestSchema.nullable().optional(),
+    vertical_package: verticalPackageRefDigestSchema.nullable().optional(),
+    navigation: z.array(z.unknown()).default([]),
+    media: z.array(z.unknown()).default([]),
+    theme_tokens: z.record(z.unknown()).default({}),
+    metadata: z.record(z.unknown()).default({}),
+  }),
+});
+export type PublicSiteManifest = z.infer<typeof siteManifestSchema>;
+async function resolvePublicContent(contentRef: string, digest: string) {
+  const url = new URL("/api/v1/content/resolve/", env.MW_PUBLIC_DJ_BASE_URL);
+  url.searchParams.set("content_ref", contentRef);
+  url.searchParams.set("digest", digest);
+  const response = await fetch(url.toString(), {
+    headers: {
+      accept: "application/json",
+      authorization: `Bearer ${env.MW_PUBLIC_DJ_READ_TOKEN}`,
+    },
+    next: {
+      revalidate: env.MW_PUBLIC_SITE_ENV === "live" ? 300 : 0,
+      tags: ["vuilder-public-site", env.MW_PUBLIC_SITE_PROPERTY_KEY],
+    },
+  });
+  if (!response.ok) {
+    throw new Error(`Unable to resolve public-dj content (${response.status}).`);
+  }
+  return response.json();
+}
+export const getSiteManifest = cache(async (): Promise<PublicSiteManifest> => {
+  const payload = await resolvePublicContent(
+    env.MW_PUBLIC_CONTENT_REF,
+    env.MW_PUBLIC_CONTENT_DIGEST,
+  );
+  return siteManifestSchema.parse(payload);
+});
+export async function getHomePageRef() {
+  const manifest = await getSiteManifest();
+  return (
+    manifest.payload.pages.find((page) => page.path === "/") ??
+    manifest.payload.pages[0] ??
+    null
+  );
+}

package/assets/templates/vuilder-public-site/src/lib/public-dj.test.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { describe, expect, it } from "vitest";
+describe("public-dj template contract", () => {
+  it("uses public site manifest refs instead of storing component code in env", () => {
+    expect("MW_PUBLIC_CONTENT_REF").toContain("CONTENT_REF");
+    expect("MW_PUBLIC_CONTENT_DIGEST").toContain("DIGEST");
+  });
+});

package/assets/templates/vuilder-public-site/src/lib/routes.test.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { describe, expect, it } from "vitest";
+import { appRoutes } from "@/lib/routes";
+describe("vuilder public site routes", () => {
+  it("declares public website and onboarding routes only", () => {
+    expect(appRoutes.home).toBe("/");
+    expect(appRoutes.blog).toBe("/blog");
+    expect(appRoutes.onboarding()).toBe("/onboarding");
+    expect(Object.values(appRoutes).join(" ")).not.toContain("/w/");
+    expect(Object.values(appRoutes).join(" ")).not.toContain("/app");
+  });
+});

package/assets/templates/vuilder-public-site/src/lib/routes.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type { Route } from "next";
+export const appRoutes = {
+  home: "/" as Route,
+  blog: "/blog" as Route,
+  blogPost(slug: string) {
+    return `/blog/${encodeURIComponent(slug)}` as Route;
+  },
+  onboarding(step = "") {
+    return step ? (`/onboarding/${encodeURIComponent(step)}` as Route) : ("/onboarding" as Route);
+  },
+};

package/assets/templates/vuilder-public-site/template.json ADDED Viewed

@@ -0,0 +1,21 @@
+{
+  "template_id": "vuilder-public-site",
+  "template_kind": "public_site",
+  "template_profile": "public_dj_cms",
+  "template_bundle_ref": "runtime/builder/templates/vuilder-public-site",
+  "template_version": "0.1.0",
+  "materialize": {
+    "destination": "app"
+  },
+  "builder_edit_mode": "workspace_copy_only",
+  "seed_source": "runtime/builder/templates/vuilder-public-site",
+  "required_bootstrap_steps": [
+    "next_typegen"
+  ],
+  "runtime_contract_refs": [
+    "reference/mwv3-dj6-docs/published_web_property_contract.md",
+    "reference/mwv3-dj6-docs/runtime_app_deployment_and_provisioning_contract.md",
+    "reference/mwv3-dj6-docs/auth_and_credential_contract.md"
+  ],
+  "example_features": {}
+}

package/assets/templates/vuilder-public-site/tools/template/validate-template.mjs ADDED Viewed

@@ -0,0 +1,44 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const templateRoot = path.resolve(__dirname, "..", "..");
+const manifestPath = path.join(templateRoot, "template.json");
+const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+const requiredFields = [
+  "template_id",
+  "template_kind",
+  "template_profile",
+  "template_version",
+  "materialize",
+  "builder_edit_mode",
+  "seed_source",
+  "required_bootstrap_steps",
+  "example_features",
+];
+for (const field of requiredFields) {
+  if (!(field in manifest)) {
+    throw new Error(`template.json is missing required field "${field}"`);
+  }
+}
+if (manifest.template_id !== "vuilder-public-site") {
+  throw new Error("template_id must be vuilder-public-site");
+}
+if (manifest.template_kind !== "public_site") {
+  throw new Error("template_kind must be public_site");
+}
+if (manifest.template_profile !== "public_dj_cms") {
+  throw new Error("template_profile must be public_dj_cms");
+}
+if (manifest.materialize?.destination !== "app") {
+  throw new Error("vuilder-public-site must materialize to app");
+}
+console.log("template.json is valid");

package/assets/templates/vuilder-public-site/tsconfig.json ADDED Viewed

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/assets/templates/vuilder-public-site/vitest.config.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: true,
+  },
+  resolve: {
+    alias: {
+      "@": new URL("./src", import.meta.url).pathname,
+    },
+  },
+});

package/assets/templates/vuilder-shell/.env.example ADDED Viewed

@@ -0,0 +1,8 @@
+NEXT_PUBLIC_MW_APP_ID=vuilder.vertical
+MW_TEMPLATE_APP_NAME=Vuilder Shell
+MW_PUBLIC_BASE_URL=http://127.0.0.1:3301
+MW_AUTH_BASE_URL=http://127.0.0.1:3400
+MW_PUBLIC_SITE_PROPERTY_KEY=vuilder-shell
+MW_PUBLIC_SITE_ENV=preview
+MW_PLATFORM_BASE_URL=http://127.0.0.1:8000
+MW_PLATFORM_FETCH_TIMEOUT_MS=15000

package/assets/templates/vuilder-shell/.storybook/main.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import { defineMain } from "@storybook/nextjs-vite/node";
+export default defineMain({
+  stories: [
+    "../src/design-system/**/*.stories.@(ts|tsx|mdx)",
+    "../src/design-system/docs/**/*.mdx",
+  ],
+  addons: ["@storybook/addon-docs", "@storybook/addon-a11y"],
+  framework: {
+    name: "@storybook/nextjs-vite",
+    options: {
+      nextConfigPath: "../next.config.mjs",
+    },
+  },
+  staticDirs: ["../public"],
+  docs: {
+    defaultName: "Overview",
+  },
+});

package/assets/templates/vuilder-shell/.storybook/preview.tsx ADDED Viewed

@@ -0,0 +1,38 @@
+import { definePreview } from "@storybook/nextjs-vite";
+import "../src/app/globals.css";
+import { ThemeProvider } from "../src/lib/theme";
+export default definePreview({
+  decorators: [
+    (Story) => (
+      <ThemeProvider
+        attribute="class"
+        defaultTheme="light"
+        enableSystem
+        disableTransitionOnChange
+      >
+        <div className="min-h-screen bg-background p-6 text-foreground">
+          <Story />
+        </div>
+      </ThemeProvider>
+    ),
+  ],
+  parameters: {
+    layout: "centered",
+    nextjs: {
+      appDirectory: true,
+    },
+    controls: {
+      matchers: {
+        color: /(background|color)$/i,
+        date: /Date$/i,
+      },
+    },
+    options: {
+      storySort: {
+        order: ["Design System"],
+      },
+    },
+  },
+});