@timbenniks/contentstack-platform-app-scaffold 0.1.0

package/dist/utils/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAY/C,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAGvF;AA4CD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,IAAI,CAgCN"}

package/dist/utils/template-engine.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTemplate = renderTemplate;
+exports.renderDirectory = renderDirectory;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const handlebars_1 = __importDefault(require("handlebars"));
+/** Render a single Handlebars template string with the given context */
+function renderTemplate(templateString, context) {
+    const template = handlebars_1.default.compile(templateString, { noEscape: true });
+    return template(context);
+}
+/** Walk a directory recursively and return all file paths relative to root */
+function walkDirectory(dir, root = dir) {
+    const results = [];
+    for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
+        const fullPath = (0, node_path_1.join)(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...walkDirectory(fullPath, root));
+        }
+        else {
+            results.push((0, node_path_1.relative)(root, fullPath));
+        }
+    }
+    return results;
+}
+/** Check whether a file should be included based on feature flags and manifest */
+function shouldIncludeFile(relPath, manifest, context) {
+    if (!manifest)
+        return true;
+    const entry = manifest.find((m) => m.path === relPath);
+    if (!entry)
+        return true;
+    if (entry.requiredFeatures && entry.requiredFeatures.length > 0) {
+        const hasAllRequired = entry.requiredFeatures.every((feature) => context.features[feature] === true);
+        if (!hasAllRequired)
+            return false;
+    }
+    if (entry.anyFeatures && entry.anyFeatures.length > 0) {
+        const hasAnyRequired = entry.anyFeatures.some((feature) => context.features[feature] === true);
+        if (!hasAnyRequired)
+            return false;
+    }
+    return true;
+}
+/**
+ * Render an entire template directory into an output directory.
+ *
+ * - Files ending in `.hbs` are rendered through Handlebars and the `.hbs` extension is stripped.
+ * - All other files are copied as-is.
+ * - Files listed in `manifest.json` with `requiredFeatures` are skipped if the features are not selected.
+ * - `manifest.json` itself is never copied to the output.
+ */
+function renderDirectory(templateDir, outputDir, context) {
+    let manifest;
+    try {
+        const manifestContent = (0, node_fs_1.readFileSync)((0, node_path_1.join)(templateDir, "manifest.json"), "utf-8");
+        manifest = JSON.parse(manifestContent);
+    }
+    catch {
+        manifest = undefined;
+    }
+    const files = walkDirectory(templateDir);
+    for (const relPath of files) {
+        if (relPath === "manifest.json")
+            continue;
+        const outputRelPath = relPath.endsWith(".hbs") ? relPath.slice(0, -4) : relPath;
+        if (!shouldIncludeFile(outputRelPath, manifest, context))
+            continue;
+        const inputPath = (0, node_path_1.join)(templateDir, relPath);
+        const outputPath = (0, node_path_1.join)(outputDir, outputRelPath);
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(outputPath), { recursive: true });
+        if (relPath.endsWith(".hbs")) {
+            const templateContent = (0, node_fs_1.readFileSync)(inputPath, "utf-8");
+            const rendered = renderTemplate(templateContent, context);
+            (0, node_fs_1.writeFileSync)(outputPath, rendered, "utf-8");
+        }
+        else {
+            const content = (0, node_fs_1.readFileSync)(inputPath);
+            (0, node_fs_1.writeFileSync)(outputPath, content);
+        }
+    }
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/utils/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"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"}

package/oclif.manifest.json

@@ -0,0 +1,101 @@
+{
+  "commands": {
+    "scaffold": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Project directory name",
+          "name": "name",
+          "required": false
+        }
+      },
+      "description": "Scaffold a Contentstack app using the Platform SDK",
+      "examples": [
+        "<%= config.bin %> scaffold my-app",
+        "<%= config.bin %> scaffold my-app --framework nextjs --region eu",
+        "<%= config.bin %> scaffold my-app --features cma,oauth --no-install"
+      ],
+      "flags": {
+        "framework": {
+          "description": "Framework (nextjs)",
+          "name": "framework",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "nextjs"
+          ],
+          "type": "option"
+        },
+        "region": {
+          "description": "Contentstack region (us|eu|au|azure-na|azure-eu|gcp-na|gcp-eu)",
+          "name": "region",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "us",
+            "eu",
+            "au",
+            "azure-na",
+            "azure-eu",
+            "gcp-na",
+            "gcp-eu"
+          ],
+          "type": "option"
+        },
+        "features": {
+          "description": "Comma-separated features: cma,oauth,launch,brandkit",
+          "name": "features",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scopes": {
+          "description": "Comma-separated OAuth scopes",
+          "name": "scopes",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "package-manager": {
+          "description": "Package manager (npm|yarn|pnpm)",
+          "name": "package-manager",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "npm",
+            "yarn",
+            "pnpm"
+          ],
+          "type": "option"
+        },
+        "no-git": {
+          "description": "Skip git initialization",
+          "name": "no-git",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-install": {
+          "description": "Skip dependency installation",
+          "name": "no-install",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "scaffold",
+      "pluginAlias": "@timbenniks/contentstack-platform-app-scaffold",
+      "pluginName": "@timbenniks/contentstack-platform-app-scaffold",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "scaffold.js"
+      ]
+    }
+  },
+  "version": "0.1.0"
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@timbenniks/contentstack-platform-app-scaffold",
+  "version": "0.1.0",
+  "description": "Contentstack CLI plugin to scaffold apps using the Platform SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "oclif": {
+    "commands": {
+      "strategy": "pattern",
+      "target": "./dist/commands"
+    },
+    "bin": "csdx"
+  },
+  "files": ["dist", "templates", "oclif.manifest.json"],
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "oclif manifest",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome check src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@oclif/core": "^4.8.0",
+    "@clack/prompts": "^0.9.0",
+    "picocolors": "^1.1.0",
+    "handlebars": "^4.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "oclif": "^4.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/templates/nextjs/.env.example.hbs

@@ -0,0 +1,22 @@
+# Contentstack Configuration
+CONTENTSTACK_REGION={{region}}
+CONTENTSTACK_API_KEY=your_api_key
+CONTENTSTACK_ORGANIZATION_UID=your_org_uid
+CONTENTSTACK_AUTHTOKEN=your_authtoken # Optional: for Launch/Brand Kit when OAuth is not enabled
+{{#if features.cma}}
+{{#unless features.oauth}}
+# CMA Access Token
+CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token
+{{/unless}}
+{{/if}}
+{{#if features.oauth}}
+# OAuth Credentials
+CONTENTSTACK_APP_ID=your_app_id
+CONTENTSTACK_CLIENT_ID=your_client_id
+CONTENTSTACK_CLIENT_SECRET=your_client_secret
+AUTH_SECRET=generate_a_random_secret
+{{/if}}
+{{#if features.brandkit}}
+# Brand Kit
+CONTENTSTACK_BRAND_KIT_UID=your_brand_kit_uid
+{{/if}}

package/templates/nextjs/app/api/auth/[...nextauth]/route.ts.hbs

@@ -0,0 +1,3 @@
+import { handlers } from "@/lib/auth"
+
+export const { GET, POST } = handlers

package/templates/nextjs/app/api/brandkit/[...path]/route.ts.hbs

@@ -0,0 +1,35 @@
+import { createBrandKitProxy } from "@timbenniks/contentstack-platform-sdk/server/proxy"
+import type { ContentstackRegion } from "@timbenniks/contentstack-platform-sdk/regions"
+{{#if features.oauth}}
+import { getAccessToken } from "@timbenniks/contentstack-platform-sdk/server/middleware"
+import { auth } from "@/lib/auth"
+{{/if}}
+
+const proxy = createBrandKitProxy({
+  region: (process.env.CONTENTSTACK_REGION ?? "{{region}}") as ContentstackRegion,
+  organizationUid: process.env.CONTENTSTACK_ORGANIZATION_UID!,
+  brandKitUid: process.env.CONTENTSTACK_BRAND_KIT_UID!,
+  getAccessToken: async () => {
+{{#if features.oauth}}
+    return await getAccessToken(auth)
+{{else}}
+    return process.env.CONTENTSTACK_AUTHTOKEN ?? ""
+{{/if}}
+  },
+})
+
+export async function GET(request: Request) {
+  return proxy(request)
+}
+
+export async function POST(request: Request) {
+  return proxy(request)
+}
+
+export async function PUT(request: Request) {
+  return proxy(request)
+}
+
+export async function DELETE(request: Request) {
+  return proxy(request)
+}

package/templates/nextjs/app/api/cma/[...path]/route.ts.hbs

@@ -0,0 +1,35 @@
+import { createCMAProxy } from "@timbenniks/contentstack-platform-sdk/server/proxy"
+import type { ContentstackRegion } from "@timbenniks/contentstack-platform-sdk/regions"
+{{#if features.oauth}}
+import { getAccessToken } from "@timbenniks/contentstack-platform-sdk/server/middleware"
+import { auth } from "@/lib/auth"
+{{/if}}
+
+const proxy = createCMAProxy({
+  region: (process.env.CONTENTSTACK_REGION ?? "{{region}}") as ContentstackRegion,
+  apiKey: process.env.CONTENTSTACK_API_KEY!,
+  getAccessToken: async () => {
+{{#if features.oauth}}
+    return await getAccessToken(auth)
+{{else}}
+    return process.env.CONTENTSTACK_MANAGEMENT_TOKEN ?? ""
+{{/if}}
+  },
+  allowedScopes: ["entries:read", "entries:write", "assets:read", "content-types:read"],
+})
+
+export async function GET(request: Request) {
+  return proxy(request)
+}
+
+export async function POST(request: Request) {
+  return proxy(request)
+}
+
+export async function PUT(request: Request) {
+  return proxy(request)
+}
+
+export async function DELETE(request: Request) {
+  return proxy(request)
+}

package/templates/nextjs/app/api/launch/[...path]/route.ts.hbs

@@ -0,0 +1,34 @@
+import { createLaunchProxy } from "@timbenniks/contentstack-platform-sdk/server/proxy"
+import type { ContentstackRegion } from "@timbenniks/contentstack-platform-sdk/regions"
+{{#if features.oauth}}
+import { getAccessToken } from "@timbenniks/contentstack-platform-sdk/server/middleware"
+import { auth } from "@/lib/auth"
+{{/if}}
+
+const proxy = createLaunchProxy({
+  region: (process.env.CONTENTSTACK_REGION ?? "{{region}}") as ContentstackRegion,
+  organizationUid: process.env.CONTENTSTACK_ORGANIZATION_UID!,
+  getAccessToken: async () => {
+{{#if features.oauth}}
+    return await getAccessToken(auth)
+{{else}}
+    return process.env.CONTENTSTACK_AUTHTOKEN ?? ""
+{{/if}}
+  },
+})
+
+export async function GET(request: Request) {
+  return proxy(request)
+}
+
+export async function POST(request: Request) {
+  return proxy(request)
+}
+
+export async function PUT(request: Request) {
+  return proxy(request)
+}
+
+export async function DELETE(request: Request) {
+  return proxy(request)
+}

package/templates/nextjs/app/assets/page.tsx.hbs

@@ -0,0 +1,25 @@
+"use client"
+
+import { useAssets } from "@timbenniks/contentstack-platform-sdk/react/hooks"
+
+export default function AssetsPage() {
+  const { data: assets, loading, error } = useAssets()
+
+  return (
+    <main style=\{{ padding: "2rem", fontFamily: "system-ui, sans-serif" }}>
+      <h1>Assets</h1>
+
+      {loading && <p>Loading assets...</p>}
+      {error && <p>Error: {error.message}</p>}
+      {assets && (
+        <ul>
+          {assets.map((asset) => (
+            <li key={asset.uid}>{asset.title ?? asset.filename}</li>
+          ))}
+        </ul>
+      )}
+
+      <p><a href="/">Back to home</a></p>
+    </main>
+  )
+}

package/templates/nextjs/app/brandkit/page.tsx.hbs

@@ -0,0 +1,43 @@
+"use client"
+
+import type { BrandKit } from "@timbenniks/contentstack-platform-sdk/brandkit"
+import { useBrandKit } from "@timbenniks/contentstack-platform-sdk/react/hooks"
+import { useEffect, useState } from "react"
+
+export default function BrandKitPage() {
+  const brandKit = useBrandKit()
+  const [brandKits, setBrandKits] = useState<BrandKit[]>([])
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<string | null>(null)
+
+  useEffect(() => {
+    brandKit.brandKits
+      .listAll()
+      .then(setBrandKits)
+      .catch((err: Error) => setError(err.message))
+      .finally(() => setLoading(false))
+  }, [brandKit])
+
+  return (
+    <main style=\{{ padding: "2rem", fontFamily: "system-ui, sans-serif" }}>
+      <h1>Brand Kits</h1>
+
+      {loading && <p>Loading brand kits...</p>}
+      {error && <p>Error: {error}</p>}
+
+      {!loading && !error && (
+        <ul>
+          {brandKits.map((kit) => (
+            <li key={kit.uid}>{kit.name}</li>
+          ))}
+        </ul>
+      )}
+
+      {!loading && !error && brandKits.length === 0 && (
+        <p>No brand kits found for this organization.</p>
+      )}
+
+      <p><a href="/">Back to home</a></p>
+    </main>
+  )
+}

package/templates/nextjs/app/entries/page.tsx.hbs

@@ -0,0 +1,26 @@
+"use client"
+
+import { useEntries } from "@timbenniks/contentstack-platform-sdk/react/hooks"
+
+export default function EntriesPage() {
+  const { data: entries, loading, error } = useEntries("your_content_type")
+
+  return (
+    <main style=\{{ padding: "2rem", fontFamily: "system-ui, sans-serif" }}>
+      <h1>Entries</h1>
+      <p>Update <code>&quot;your_content_type&quot;</code> to a content type UID from your stack.</p>
+
+      {loading && <p>Loading entries...</p>}
+      {error && <p>Error: {error.message}</p>}
+      {entries && (
+        <ul>
+          {entries.map((entry) => (
+            <li key={entry.uid}>{entry.title ?? entry.uid}</li>
+          ))}
+        </ul>
+      )}
+
+      <p><a href="/">Back to home</a></p>
+    </main>
+  )
+}

package/templates/nextjs/app/launch/page.tsx.hbs

@@ -0,0 +1,43 @@
+"use client"
+
+import type { LaunchProject } from "@timbenniks/contentstack-platform-sdk/launch"
+import { useLaunch } from "@timbenniks/contentstack-platform-sdk/react/hooks"
+import { useEffect, useState } from "react"
+
+export default function LaunchPage() {
+  const launch = useLaunch()
+  const [projects, setProjects] = useState<LaunchProject[]>([])
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<string | null>(null)
+
+  useEffect(() => {
+    launch.projects
+      .listAll()
+      .then(setProjects)
+      .catch((err: Error) => setError(err.message))
+      .finally(() => setLoading(false))
+  }, [launch])
+
+  return (
+    <main style=\{{ padding: "2rem", fontFamily: "system-ui, sans-serif" }}>
+      <h1>Launch Projects</h1>
+
+      {loading && <p>Loading projects...</p>}
+      {error && <p>Error: {error}</p>}
+
+      {!loading && !error && (
+        <ul>
+          {projects.map((project) => (
+            <li key={project.uid}>{project.name}</li>
+          ))}
+        </ul>
+      )}
+
+      {!loading && !error && projects.length === 0 && (
+        <p>No projects found in this organization.</p>
+      )}
+
+      <p><a href="/">Back to home</a></p>
+    </main>
+  )
+}

package/templates/nextjs/app/layout.tsx.hbs

@@ -0,0 +1,20 @@
+import type { Metadata } from "next"
+import type { ReactNode } from "react"
+{{#if hasClientFeatures}}
+import { Providers } from "./providers"
+{{/if}}
+
+export const metadata: Metadata = {
+  title: "{{projectName}}",
+  description: "Built with Contentstack Platform SDK",
+}
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {{#if hasClientFeatures}}<Providers>{children}</Providers>{{else}}{children}{{/if}}
+      </body>
+    </html>
+  )
+}

package/templates/nextjs/app/page.tsx.hbs

@@ -0,0 +1,55 @@
+{{#if features.oauth}}
+import { auth } from "@/lib/auth"
+{{/if}}
+
+export default {{#if features.oauth}}async {{/if}}function Home() {
+  {{#if features.oauth}}
+  const session = await auth()
+  {{/if}}
+
+  return (
+    <main style=\{{ padding: "2rem", fontFamily: "system-ui, sans-serif" }}>
+      <h1>{{projectName}}</h1>
+      <p>Region: <code>{{region}}</code></p>
+      <p>Built with <a href="https://github.com/contentstack/platform-sdk">Contentstack Platform SDK</a></p>
+
+      <h2>Getting Started</h2>
+      <ol>
+        <li>Copy <code>.env.example</code> to <code>.env.local</code></li>
+        <li>Fill in your Contentstack credentials</li>
+        <li>Start building!</li>
+      </ol>
+      {{#if features.oauth}}
+
+      <h2>Authentication</h2>
+      {session ? (
+        <p>Signed in. <a href="/api/auth/signout">Sign out</a></p>
+      ) : (
+        <p><a href="/api/auth/signin">Sign in with Contentstack</a></p>
+      )}
+      {{/if}}
+      {{#if features.cma}}
+
+      <h2>Content Management</h2>
+      <ul>
+        <li><a href="/entries">Entries</a></li>
+        <li><a href="/assets">Assets</a></li>
+      </ul>
+      {{/if}}
+      {{#if features.launch}}
+
+      <h2>Launch</h2>
+      <ul>
+        <li><a href="/launch">Projects</a></li>
+      </ul>
+      {{/if}}
+      {{#if features.brandkit}}
+
+      <h2>Brand Kit AI</h2>
+      <ul>
+        <li><a href="/brandkit">Brand Kits</a></li>
+      </ul>
+      {{/if}}
+    </main>
+  )
+}

package/templates/nextjs/app/providers.tsx.hbs

@@ -0,0 +1,11 @@
+"use client"
+
+import { ContentstackProvider } from "@timbenniks/contentstack-platform-sdk/react/provider"
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <ContentstackProvider region="{{region}}">
+      {children}
+    </ContentstackProvider>
+  )
+}

package/templates/nextjs/lib/auth.ts.hbs

@@ -0,0 +1,12 @@
+import { createContentstackAuth } from "@timbenniks/contentstack-platform-sdk/server/middleware"
+import type { ContentstackRegion } from "@timbenniks/contentstack-platform-sdk/regions"
+
+export const { handlers, auth } = await createContentstackAuth({
+  region: (process.env.CONTENTSTACK_REGION ?? "{{region}}") as ContentstackRegion,
+  appId: process.env.CONTENTSTACK_APP_ID!,
+  clientId: process.env.CONTENTSTACK_CLIENT_ID!,
+  clientSecret: process.env.CONTENTSTACK_CLIENT_SECRET!,
+  secret: process.env.AUTH_SECRET!,
+  scopes: [{{#each scopes}}"{{this}}"{{#unless @last}}, {{/unless}}{{/each}}],
+  trustHost: true,
+})

package/templates/nextjs/manifest.json

@@ -0,0 +1,19 @@
+[
+  { "path": "package.json" },
+  { "path": ".env.example" },
+  { "path": ".gitignore" },
+  { "path": "tsconfig.json" },
+  { "path": "next.config.js" },
+  { "path": "lib/auth.ts", "requiredFeatures": ["oauth"] },
+  { "path": "app/layout.tsx" },
+  { "path": "app/page.tsx" },
+  { "path": "app/providers.tsx", "anyFeatures": ["cma", "launch", "brandkit"] },
+  { "path": "app/api/auth/[...nextauth]/route.ts", "requiredFeatures": ["oauth"] },
+  { "path": "app/api/cma/[...path]/route.ts", "requiredFeatures": ["cma"] },
+  { "path": "app/api/launch/[...path]/route.ts", "requiredFeatures": ["launch"] },
+  { "path": "app/api/brandkit/[...path]/route.ts", "requiredFeatures": ["brandkit"] },
+  { "path": "app/entries/page.tsx", "requiredFeatures": ["cma"] },
+  { "path": "app/assets/page.tsx", "requiredFeatures": ["cma"] },
+  { "path": "app/launch/page.tsx", "requiredFeatures": ["launch"] },
+  { "path": "app/brandkit/page.tsx", "requiredFeatures": ["brandkit"] }
+]

package/templates/nextjs/next.config.js

@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {}
+
+module.exports = nextConfig