npm - minutework - Versions diffs - 0.1.40 → 0.1.42 - Mend

minutework 0.1.40 → 0.1.42

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 (180) hide show

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.test.ts ADDED Viewed

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { parseVuilderPublicSiteEnv } from "./env.server";
+const validEnv = {
+  MW_AUTH_BASE_URL: "https://auth.minutework.ai",
+  MW_PLATFORM_BASE_URL: "https://platform.minutework.ai",
+  MW_PUBLIC_BASE_URL: "http://127.0.0.1:3300",
+  MW_PUBLIC_CONTENT_DIGEST: "public-content-digest",
+  MW_PUBLIC_CONTENT_REF: "runtime:test-public:content",
+  MW_PUBLIC_DJ_BASE_URL: "https://public-dj.minutework.ai",
+  MW_PUBLIC_DJ_READ_TOKEN: "public-dj-read-token",
+  MW_PUBLIC_RELEASE_CLASS: "ssr_container",
+  MW_PUBLIC_SITE_ENV: "preview",
+  MW_PUBLIC_SITE_PROPERTY_KEY: "vuilder-app",
+  MW_VUILDER_ONBOARDING_INTENT_TOKEN: "onboarding-intent-token",
+};
+describe("parseVuilderPublicSiteEnv", () => {
+  it("parses complete vuilder public-site env", () => {
+    expect(parseVuilderPublicSiteEnv(validEnv)).toMatchObject({
+      MW_AUTH_BASE_URL: "https://auth.minutework.ai",
+      MW_PLATFORM_BASE_URL: "https://platform.minutework.ai",
+      MW_PUBLIC_DJ_BASE_URL: "https://public-dj.minutework.ai",
+      MW_PUBLIC_SITE_PROPERTY_KEY: "vuilder-app",
+    });
+  });
+  it("throws a plain formatted Error for missing and invalid fields", () => {
+    expect(() =>
+      parseVuilderPublicSiteEnv({
+        ...validEnv,
+        MW_AUTH_BASE_URL: "not-a-url",
+        MW_PUBLIC_CONTENT_DIGEST: "",
+        MW_PUBLIC_CONTENT_REF: undefined,
+        MW_PUBLIC_DJ_READ_TOKEN: "",
+      }),
+    ).toThrowError(
+      [
+        "vuilder-app local dev is missing required sandbox environment.",
+        "Missing or empty: MW_PUBLIC_CONTENT_DIGEST, MW_PUBLIC_CONTENT_REF, MW_PUBLIC_DJ_READ_TOKEN",
+        "Invalid: MW_AUTH_BASE_URL (Invalid url)",
+        "Run `minutework sandbox create` or `minutework sandbox connect`",
+      ].join("\n"),
+    );
+  });
+});

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

@@ -0,0 +1,92 @@
+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 type VuilderPublicSiteEnv = z.infer<typeof envSchema>;
+export function parseVuilderPublicSiteEnv(
+  input: Record<string, string | undefined>,
+): VuilderPublicSiteEnv {
+  try {
+    return envSchema.parse({
+      MW_PUBLIC_DJ_BASE_URL: input.MW_PUBLIC_DJ_BASE_URL,
+      MW_AUTH_BASE_URL: input.MW_AUTH_BASE_URL,
+      MW_PLATFORM_BASE_URL: input.MW_PLATFORM_BASE_URL,
+      MW_PUBLIC_BASE_URL: input.MW_PUBLIC_BASE_URL,
+      MW_PUBLIC_SITE_PROPERTY_KEY: input.MW_PUBLIC_SITE_PROPERTY_KEY,
+      MW_PUBLIC_SITE_ENV: input.MW_PUBLIC_SITE_ENV,
+      MW_PUBLIC_RELEASE_CLASS: input.MW_PUBLIC_RELEASE_CLASS,
+      MW_PUBLIC_CONTENT_REF: input.MW_PUBLIC_CONTENT_REF,
+      MW_PUBLIC_CONTENT_DIGEST: input.MW_PUBLIC_CONTENT_DIGEST,
+      MW_PUBLIC_DJ_READ_TOKEN: input.MW_PUBLIC_DJ_READ_TOKEN,
+      MW_VUILDER_ONBOARDING_INTENT_TOKEN: input.MW_VUILDER_ONBOARDING_INTENT_TOKEN,
+    });
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      throw formatVuilderPublicSiteEnvError(error);
+    }
+    throw error;
+  }
+}
+function formatVuilderPublicSiteEnvError(error: z.ZodError): Error {
+  const missing = new Set<string>();
+  const invalid: string[] = [];
+  for (const issue of error.issues) {
+    const name = issue.path.join(".") || "(root)";
+    if (issue.code === "invalid_type" && issue.received === "undefined") {
+      missing.add(name);
+      continue;
+    }
+    if (issue.code === "too_small" && issue.type === "string") {
+      missing.add(name);
+      continue;
+    }
+    invalid.push(`${name} (${issue.message})`);
+  }
+  const lines = ["vuilder-app local dev is missing required sandbox environment."];
+  if (missing.size > 0) {
+    lines.push(`Missing or empty: ${Array.from(missing).sort().join(", ")}`);
+  }
+  if (invalid.length > 0) {
+    lines.push(`Invalid: ${invalid.sort().join(", ")}`);
+  }
+  lines.push(
+    "Run `minutework sandbox create` or `minutework sandbox connect` from the workspace root before `pnpm --dir vuilder-app dev`.",
+  );
+  return new Error(lines.join("\n"));
+}
+let cachedEnv: VuilderPublicSiteEnv | null = null;
+export function getEnv(): VuilderPublicSiteEnv {
+  if (!cachedEnv) {
+    cachedEnv = parseVuilderPublicSiteEnv(process.env);
+  }
+  return cachedEnv;
+}
+export const env = new Proxy({} as VuilderPublicSiteEnv, {
+  get(_target, property: string | symbol) {
+    if (typeof property === "symbol") {
+      return undefined;
+    }
+    return getEnv()[property as keyof VuilderPublicSiteEnv];
+  },
+});

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/test/server-only-stub.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/assets/templates/vuilder-public-site/tools/env/check-dev-env.mjs ADDED Viewed

@@ -0,0 +1,109 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const templateRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const requiredKeys = [
+  "MW_PUBLIC_DJ_BASE_URL",
+  "MW_AUTH_BASE_URL",
+  "MW_PLATFORM_BASE_URL",
+  "MW_PUBLIC_BASE_URL",
+  "MW_PUBLIC_SITE_PROPERTY_KEY",
+  "MW_PUBLIC_SITE_ENV",
+  "MW_PUBLIC_RELEASE_CLASS",
+  "MW_PUBLIC_CONTENT_REF",
+  "MW_PUBLIC_CONTENT_DIGEST",
+  "MW_PUBLIC_DJ_READ_TOKEN",
+  "MW_VUILDER_ONBOARDING_INTENT_TOKEN",
+];
+const urlKeys = new Set([
+  "MW_PUBLIC_DJ_BASE_URL",
+  "MW_AUTH_BASE_URL",
+  "MW_PLATFORM_BASE_URL",
+  "MW_PUBLIC_BASE_URL",
+]);
+const enumValues = {
+  MW_PUBLIC_RELEASE_CLASS: new Set(["static_export", "ssr_container"]),
+  MW_PUBLIC_SITE_ENV: new Set(["preview", "live"]),
+};
+const env = {
+  ...loadEnvFile(".env"),
+  ...loadEnvFile(".env.development"),
+  ...loadEnvFile(".env.local"),
+  ...loadEnvFile(".env.development.local"),
+  ...process.env,
+};
+const missing = requiredKeys.filter((key) => !String(env[key] ?? "").trim());
+const invalid = [];
+for (const key of requiredKeys) {
+  const value = String(env[key] ?? "").trim();
+  if (!value) {
+    continue;
+  }
+  if (urlKeys.has(key) && !isValidUrl(value)) {
+    invalid.push(`${key} must be a URL`);
+  }
+  const allowedValues = enumValues[key];
+  if (allowedValues && !allowedValues.has(value)) {
+    invalid.push(`${key} must be one of ${Array.from(allowedValues).join(", ")}`);
+  }
+}
+if (missing.length > 0 || invalid.length > 0) {
+  const lines = ["vuilder-app local dev is missing managed sandbox env."];
+  if (missing.length > 0) {
+    lines.push(`Missing or empty: ${missing.sort().join(", ")}`);
+  }
+  if (invalid.length > 0) {
+    lines.push(`Invalid: ${invalid.sort().join(", ")}`);
+  }
+  lines.push(
+    "Run `minutework sandbox create` or `minutework sandbox connect` from the workspace root before `pnpm --dir vuilder-app dev`.",
+  );
+  console.error(lines.join("\n"));
+  process.exit(1);
+}
+function loadEnvFile(relativePath) {
+  const envPath = path.join(templateRoot, relativePath);
+  if (!existsSync(envPath)) {
+    return {};
+  }
+  const values = {};
+  for (const line of readFileSync(envPath, "utf8").split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) {
+      continue;
+    }
+    const match = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/.exec(trimmed);
+    if (!match) {
+      continue;
+    }
+    values[match[1]] = unquote(match[2].trim());
+  }
+  return values;
+}
+function unquote(value) {
+  if (
+    (value.startsWith('"') && value.endsWith('"')) ||
+    (value.startsWith("'") && value.endsWith("'"))
+  ) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+function isValidUrl(value) {
+  try {
+    const url = new URL(value);
+    return Boolean(url.protocol && url.host);
+  } catch {
+    return false;
+  }
+}