@puredesktop/create-app 2.1.8 → 2.1.9

package/bin/create-puredesktop-app.mjs

@@ -18,13 +18,13 @@ Options:
   --name <title>     Display name (default: derived from dir)
   --slug <slug>      App slug for settings/bridge (default: dir name)
   --port <number>    Dev server port in plugin.json (default: 5300)
-  --manifest-json-base64 <base64>
-                     Structured plugin.json manifest draft for app-builder use
-  --agents-md-base64 <base64>
-                     Structured agents.md content for app-builder use
-
-Examples:
-  npm create @puredesktop/app@latest my-tool
+  --manifest-json-file <path>
+                     Read structured plugin.json manifest draft from a file
+  --agents-md-file <path>
+                     Read structured agents.md content from a file
+
+Examples:
+  npm create @puredesktop/app@latest my-tool
   npm create @puredesktop/app@latest my-tool -- --name "My Tool" --slug mytool --port 5310
 `)
 }
@@ -32,12 +32,12 @@ Examples:
 function parseArgs(argv) {
   const positional = []
   const options = {
-    name: '',
-    slug: '',
-    port: 5300,
-    manifestJsonBase64: '',
-    agentsMdBase64: '',
-  }
+    name: '',
+    slug: '',
+    port: 5300,
+    manifestJsonFile: '',
+    agentsMdFile: '',
+  }
 
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i]
@@ -57,14 +57,14 @@ function parseArgs(argv) {
       options.port = Number(argv[++i])
       continue
     }
-    if (arg === '--manifest-json-base64') {
-      options.manifestJsonBase64 = argv[++i] ?? ''
-      continue
-    }
-    if (arg === '--agents-md-base64') {
-      options.agentsMdBase64 = argv[++i] ?? ''
-      continue
-    }
+    if (arg === '--manifest-json-file') {
+      options.manifestJsonFile = argv[++i] ?? ''
+      continue
+    }
+    if (arg === '--agents-md-file') {
+      options.agentsMdFile = argv[++i] ?? ''
+      continue
+    }
     if (arg.startsWith('-')) {
       console.error(`Unknown option: ${arg}`)
       usage()
@@ -97,36 +97,27 @@ function titleCaseFromSlug(slug) {
     .join(' ')
 }
 
-function decodeBase64Utf8(value, label) {
-  if (!isBase64(value)) {
-    console.error(`${label} must be valid base64`)
-    process.exit(1)
-  }
-  try {
-    return Buffer.from(value, 'base64').toString('utf8')
-  } catch (error) {
-    console.error(`${label} must be valid base64: ${errorMessage(error)}`)
-    process.exit(1)
-  }
-}
-
-function readStructuredManifest(value, port) {
-  const text = decodeBase64Utf8(value, '--manifest-json-base64')
-  let manifest
-  try {
-    manifest = JSON.parse(text)
-  } catch (error) {
-    console.error(`--manifest-json-base64 must decode to JSON: ${errorMessage(error)}`)
-    process.exit(1)
-  }
-  return normalizeStructuredManifest(manifest, port)
-}
-
-function normalizeStructuredManifest(manifest, port) {
-  if (!isPlainObject(manifest)) {
-    console.error('--manifest-json-base64 must decode to a manifest object')
-    process.exit(1)
-  }
+function readStructuredManifestFile(path, port) {
+  const text = readUtf8File(path, '--manifest-json-file')
+  return readStructuredManifestText(text, port, '--manifest-json-file')
+}
+
+function readStructuredManifestText(text, port, label) {
+  let manifest
+  try {
+    manifest = JSON.parse(text)
+  } catch (error) {
+    console.error(`${label} must contain JSON: ${errorMessage(error)}`)
+    process.exit(1)
+  }
+  return normalizeStructuredManifest(manifest, port, label)
+}
+
+function normalizeStructuredManifest(manifest, port, label) {
+  if (!isPlainObject(manifest)) {
+    console.error(`${label} must contain a manifest object`)
+    process.exit(1)
+  }
   if (manifest.schemaVersion !== 1) {
     console.error('manifest.schemaVersion must be 1')
     process.exit(1)
@@ -161,14 +152,31 @@ function normalizeStructuredManifest(manifest, port) {
   })
 }
 
-function readStructuredAgentsMd(value) {
-  const text = decodeBase64Utf8(value, '--agents-md-base64')
-  if (!text.trim()) {
-    console.error('--agents-md-base64 must decode to non-empty agents.md content')
-    process.exit(1)
-  }
-  return text.endsWith('\n') ? text : `${text}\n`
-}
+function readStructuredAgentsMdFile(path) {
+  const text = readUtf8File(path, '--agents-md-file')
+  return readStructuredAgentsMdText(text, '--agents-md-file')
+}
+
+function readStructuredAgentsMdText(text, label) {
+  if (!text.trim()) {
+    console.error(`${label} must contain non-empty agents.md content`)
+    process.exit(1)
+  }
+  return text.endsWith('\n') ? text : `${text}\n`
+}
+
+function readUtf8File(path, label) {
+  if (typeof path !== 'string' || !path.trim()) {
+    console.error(`${label} requires a file path`)
+    process.exit(1)
+  }
+  try {
+    return readFileSync(resolve(path), 'utf8')
+  } catch (error) {
+    console.error(`${label} could not be read: ${errorMessage(error)}`)
+    process.exit(1)
+  }
+}
 
 function requiredString(value, label) {
   const text = typeof value === 'string' ? value.trim() : ''
@@ -183,15 +191,7 @@ function isPlainObject(value) {
   return Boolean(value) && typeof value === 'object' && !Array.isArray(value)
 }
 
-function isBase64(value) {
-  if (typeof value !== 'string' || !value.trim()) return false
-  const normalized = value.trim()
-  if (!/^[A-Za-z0-9+/]+={0,2}$/u.test(normalized)) return false
-  if (normalized.length % 4 !== 0) return false
-  return Buffer.from(normalized, 'base64').toString('base64') === normalized
-}
-
-function stripUndefinedProperties(value) {
+function stripUndefinedProperties(value) {
   return Object.fromEntries(
     Object.entries(value).filter(([, entry]) => entry !== undefined),
   )
@@ -321,24 +321,24 @@ function copyTemplate(srcDir, destDir, vars) {
   }
 }
 
-const { targetDir, options } = parseArgs(process.argv.slice(2))
-const structuredManifest = options.manifestJsonBase64
-  ? readStructuredManifest(options.manifestJsonBase64, options.port)
-  : null
-const structuredAgentsMd = options.agentsMdBase64
-  ? readStructuredAgentsMd(options.agentsMdBase64)
-  : null
+const { targetDir, options } = parseArgs(process.argv.slice(2))
+const structuredManifest = options.manifestJsonFile
+  ? readStructuredManifestFile(options.manifestJsonFile, options.port)
+  : null
+const structuredAgentsMd = options.agentsMdFile
+  ? readStructuredAgentsMdFile(options.agentsMdFile)
+  : null
 const dirName = targetDir
-const structuredSlug = structuredManifest?.app.slug ?? ''
-const structuredTitle = structuredManifest?.app.name ?? ''
-if (structuredManifest && options.slug && options.slug !== structuredSlug) {
-  console.error('--slug must match manifest.app.slug when --manifest-json-base64 is used')
-  process.exit(1)
-}
-if (structuredManifest && options.name && options.name !== structuredTitle) {
-  console.error('--name must match manifest.app.name when --manifest-json-base64 is used')
-  process.exit(1)
-}
+const structuredSlug = structuredManifest?.app.slug ?? ''
+const structuredTitle = structuredManifest?.app.name ?? ''
+if (structuredManifest && options.slug && options.slug !== structuredSlug) {
+  console.error('--slug must match manifest.app.slug when a structured manifest is used')
+  process.exit(1)
+}
+if (structuredManifest && options.name && options.name !== structuredTitle) {
+  console.error('--name must match manifest.app.name when a structured manifest is used')
+  process.exit(1)
+}
 const slug = structuredSlug || options.slug || slugify(dirName) || 'my-app'
 const title = structuredTitle || options.name || titleCaseFromSlug(slug) || 'My App'
 const pluginId = structuredManifest?.id ?? slug

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puredesktop/create-app",
-  "version": "2.1.8",
+  "version": "2.1.9",
   "description": "Scaffold a PureDesktop plugin app (Vite + bridge SDK)",
   "type": "module",
   "bin": {