blocks-dusted 0.1.0

package/src/utils/project.js

@@ -0,0 +1,122 @@
+import { access, readFile } from 'node:fs/promises'
+import { constants } from 'node:fs'
+import { join, resolve } from 'node:path'
+import { detectPackageManager } from './packageManager.js'
+import { packageRoot } from './paths.js'
+
+export const PAYLOAD_CONFIG_FILES = [
+  'src/payload.config.ts',
+  'payload.config.ts',
+  'src/payload.config.js',
+  'payload.config.js',
+  'src/payload.config.mjs',
+  'payload.config.mjs',
+]
+
+const PAYLOAD_SOURCE_MARKERS = [
+  ['src', 'blocks'],
+  ['src', 'collections'],
+  ['src', 'app'],
+]
+
+export async function inspectProject(targetDirectory) {
+  const resolvedTarget = resolve(targetDirectory)
+  const hasPackageJson = await fileExists(join(resolvedTarget, 'package.json'))
+  const packageJson = hasPackageJson ? await readJson(join(resolvedTarget, 'package.json')) : {}
+  const hasPayloadDependency = Boolean(
+    packageJson.dependencies?.payload ||
+      packageJson.devDependencies?.payload ||
+      packageJson.peerDependencies?.payload,
+  )
+  const hasBlocksDirectory = await fileExists(join(resolvedTarget, 'src', 'blocks'))
+  const hasSupportedSourceStructure = await hasAnyMarker(resolvedTarget, PAYLOAD_SOURCE_MARKERS)
+  let payloadConfigPath = null
+
+  for (const candidate of PAYLOAD_CONFIG_FILES) {
+    if (await fileExists(join(resolvedTarget, candidate))) {
+      payloadConfigPath = candidate
+      break
+    }
+  }
+
+  const isWritable = await canWrite(resolvedTarget)
+  const isCliRepository = resolve(resolvedTarget) === resolve(packageRoot)
+
+  return {
+    targetDirectory: resolvedTarget,
+    hasPackageJson,
+    hasPayloadDependency,
+    hasBlocksDirectory,
+    hasSupportedSourceStructure,
+    payloadConfigPath,
+    packageManager: await detectPackageManager(resolvedTarget),
+    isWritable,
+    isCliRepository,
+    isPayloadProject:
+      hasPackageJson && hasPayloadDependency && hasSupportedSourceStructure && payloadConfigPath !== null,
+  }
+}
+
+export async function validateTargetProject(targetDirectory) {
+  const project = await inspectProject(targetDirectory)
+  const failures = []
+
+  if (!(await directoryExists(project.targetDirectory))) failures.push('Target directory does not exist.')
+  if (!project.hasPackageJson) failures.push('package.json was not found.')
+  if (!project.hasPayloadDependency) failures.push('package.json must declare payload in dependencies, devDependencies, or peerDependencies.')
+  if (!project.hasSupportedSourceStructure) failures.push('No supported Payload source structure was found under src/.')
+  if (!project.payloadConfigPath) failures.push('No supported Payload config file was found.')
+  if (!project.isWritable) failures.push('Target directory is not writable.')
+  if (project.isCliRepository) failures.push('Refusing to install into the blocks-dusted source repository.')
+
+  if (failures.length > 0) {
+    const message = [`Invalid Payload target: ${project.targetDirectory}`, ...failures.map((failure) => `- ${failure}`)].join('\n')
+    const error = new Error(message)
+    error.project = project
+    throw error
+  }
+
+  return project
+}
+
+export async function fileExists(filePath) {
+  try {
+    await access(filePath)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function directoryExists(directory) {
+  try {
+    await access(directory, constants.R_OK | constants.X_OK)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function canWrite(directory) {
+  try {
+    await access(directory, constants.W_OK)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function hasAnyMarker(targetDirectory, markers) {
+  for (const marker of markers) {
+    if (await fileExists(join(targetDirectory, ...marker))) return true
+  }
+  return false
+}
+
+async function readJson(path) {
+  try {
+    return JSON.parse(await readFile(path, 'utf8'))
+  } catch {
+    return {}
+  }
+}

package/src/utils/strings.js

@@ -0,0 +1,7 @@
+export function isSafeTemplateName(value) {
+  return typeof value === 'string' && /^[A-Za-z0-9_-]+$/.test(value)
+}
+
+export function quote(value) {
+  return JSON.stringify(String(value))
+}