reset-framework-cli 1.0.2 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reset-framework-cli",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "type": "module",
   "description": "Command-line tooling for Reset Framework.",
   "license": "MIT",
@@ -11,9 +11,9 @@
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@reset-framework/native": "1.0.2",
-    "@reset-framework/schema": "1.0.2",
-    "@reset-framework/sdk": "1.0.2"
+    "@reset-framework/native": "1.1.0",
+    "@reset-framework/schema": "1.1.0",
+    "@reset-framework/sdk": "1.1.0"
   },
   "bin": {
     "reset-framework-cli": "src/index.js"

package/src/lib/output.js

@@ -1,9 +1,99 @@
-import { cp, mkdir, rm } from "node:fs/promises"
+import path from "node:path"
+import { cp, mkdir, rm, writeFile } from "node:fs/promises"
 import { existsSync } from "node:fs"
 
 import { logger } from "./logger.js"
 import { runCommand } from "./process.js"
 
+function escapePlistString(value) {
+  return value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+}
+
+function serializePlistValue(value, indentLevel = 1) {
+  const indent = "  ".repeat(indentLevel)
+
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return `${indent}<array/>\n`
+    }
+
+    return (
+      `${indent}<array>\n` +
+      value.map((entry) => serializePlistValue(entry, indentLevel + 1)).join("") +
+      `${indent}</array>\n`
+    )
+  }
+
+  if (typeof value === "object" && value !== null) {
+    const entries = Object.entries(value)
+    if (entries.length === 0) {
+      return `${indent}<dict/>\n`
+    }
+
+    return (
+      `${indent}<dict>\n` +
+      entries
+        .map(
+          ([key, entryValue]) =>
+            `${"  ".repeat(indentLevel + 1)}<key>${escapePlistString(key)}</key>\n${serializePlistValue(entryValue, indentLevel + 1)}`
+        )
+        .join("") +
+      `${indent}</dict>\n`
+    )
+  }
+
+  if (typeof value === "boolean") {
+    return `${indent}<${value ? "true" : "false"}/>\n`
+  }
+
+  if (typeof value === "number") {
+    return `${indent}<integer>${value}</integer>\n`
+  }
+
+  return `${indent}<string>${escapePlistString(String(value))}</string>\n`
+}
+
+function buildMacOSInfoPlist(config) {
+  const urlTypes = Array.isArray(config.protocols?.schemes)
+    ? config.protocols.schemes.map((schemeConfig) => ({
+        CFBundleTypeRole: schemeConfig.role ?? "Viewer",
+        CFBundleURLName:
+          typeof schemeConfig.name === "string" && schemeConfig.name.trim() !== ""
+            ? schemeConfig.name
+            : `${config.appId}.${schemeConfig.scheme}`,
+        CFBundleURLSchemes: [schemeConfig.scheme]
+      }))
+    : []
+
+  const plist = {
+    CFBundleDevelopmentRegion: "English",
+    CFBundleDisplayName: config.productName,
+    CFBundleExecutable: "reset-framework",
+    CFBundleIdentifier: config.appId,
+    CFBundleInfoDictionaryVersion: "6.0",
+    CFBundleName: config.productName,
+    CFBundlePackageType: "APPL",
+    CFBundleShortVersionString: config.version,
+    CFBundleVersion: config.version,
+    CSResourcesFileMapped: true
+  }
+
+  if (urlTypes.length > 0) {
+    plist.CFBundleURLTypes = urlTypes
+  }
+
+  return (
+    `<?xml version="1.0" encoding="UTF-8"?>\n` +
+    `<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n` +
+    `<plist version="1.0">\n` +
+    serializePlistValue(plist, 0) +
+    `</plist>\n`
+  )
+}
+
 export async function stageMacOSAppBundle(frameworkBuildPaths, appPaths, config, options = {}) {
   const { dryRun = false, outputPaths, configPath } = options
 
@@ -40,6 +130,11 @@ export async function stageMacOSAppBundle(frameworkBuildPaths, appPaths, config,
   await cp(configPath, outputPaths.bundledConfigPath, { force: true })
   await rm(outputPaths.bundledFrontendDir, { recursive: true, force: true })
   await cp(outputPaths.frontendDistDir, outputPaths.bundledFrontendDir, { recursive: true })
+  await writeFile(
+    path.join(outputPaths.appBundlePath, "Contents", "Info.plist"),
+    buildMacOSInfoPlist(config),
+    "utf8"
+  )
 
   return outputPaths
 }

package/src/lib/project.js

@@ -76,6 +76,29 @@ function normalizeStyling(value) {
   throw new Error("project.styling must be either 'css' or 'tailwindcss'")
 }
 
+function normalizeProtocolScheme(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error("protocols.schemes[].scheme must be a non-empty string")
+  }
+
+  const normalized = value.trim().toLowerCase()
+  if (!/^[a-z][a-z0-9+.-]*$/.test(normalized)) {
+    throw new Error(
+      "protocols.schemes[].scheme must start with a letter and only contain letters, numbers, '+', '-', and '.'"
+    )
+  }
+
+  return normalized
+}
+
+function normalizeProtocolRole(value) {
+  if (value === "Editor" || value === "Viewer" || value === "Shell" || value === "None") {
+    return value
+  }
+
+  throw new Error("protocols.schemes[].role must be one of Editor, Viewer, Shell, None")
+}
+
 function toTitleCase(value) {
   return value
     .split(/[^a-zA-Z0-9]+/)
@@ -290,7 +313,10 @@ export function validateResetConfig(rawConfig) {
   const build = optionalObject(rawConfig, "build")
   const project = optionalObject(rawConfig, "project")
   const security = optionalObject(rawConfig, "security")
+  const protocols = optionalObject(rawConfig, "protocols")
   const windowConfig = optionalObject(rawConfig, "window")
+  const rawProtocolSchemes = Array.isArray(protocols.schemes) ? protocols.schemes : []
+  const seenProtocolSchemes = new Set()
 
   return {
     ...rawConfig,
@@ -323,6 +349,32 @@ export function validateResetConfig(rawConfig) {
             return value
           })
         : []
+    },
+    protocols: {
+      schemes: rawProtocolSchemes.map((entry) => {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+          throw new Error("protocols.schemes entries must be objects")
+        }
+
+        const scheme = normalizeProtocolScheme(entry.scheme)
+        if (seenProtocolSchemes.has(scheme)) {
+          throw new Error(`Duplicate protocol scheme '${scheme}'`)
+        }
+
+        seenProtocolSchemes.add(scheme)
+
+        return {
+          scheme,
+          name:
+            typeof entry.name === "string" && entry.name.trim() !== ""
+              ? entry.name
+              : scheme,
+          role:
+            entry.role === undefined
+              ? "Viewer"
+              : normalizeProtocolRole(entry.role)
+        }
+      })
     }
   }
 }

package/templates/basic/reset.config.json

@@ -51,5 +51,8 @@
       "updater.*",
       "net.*"
     ]
+  },
+  "protocols": {
+    "schemes": []
   }
 }