umpordez 1.5.0 → 1.5.1

package/.claude/settings.local.json

@@ -57,7 +57,13 @@
       "Bash(git *)",
       "Bash(npm init *)",
       "Bash(awk 'NR>=383 && NR<=386 {print NR\": \"substr\\($0,1,120\\)}' '/Users/ligeiro/dev/umpordez-cli/template/mobile/{{PROJECT_SLUG}}/src/pages/auth/AuthLanding.tsx')",
-      "Bash(awk 'NR>=394 && NR<=410 {print NR\": \"substr\\($0,1,100\\)}' '/Users/ligeiro/dev/umpordez-cli/template/mobile/{{PROJECT_SLUG}}/src/pages/auth/AuthLanding.tsx')"
+      "Bash(awk 'NR>=394 && NR<=410 {print NR\": \"substr\\($0,1,100\\)}' '/Users/ligeiro/dev/umpordez-cli/template/mobile/{{PROJECT_SLUG}}/src/pages/auth/AuthLanding.tsx')",
+      "Bash(diskutil info *)",
+      "Bash(mount)",
+      "Bash(bash -n template/scripts/clean-appledouble.sh)",
+      "Bash(bash -n template/scripts/prebuild.sh)",
+      "Bash(bash -n template/scripts/run-ios.sh)",
+      "Bash(bash -n template/install.sh)"
     ]
   }
 }

package/create.mjs

@@ -394,6 +394,104 @@ function validatePort(v) {
         : 'Must be a valid port number';
 }
 
+// Filesystems that can't store extended attributes or symlinks. On
+// macOS these make the OS scatter AppleDouble `._*` sidecar files next
+// to everything npm installs — CocoaPods then fails parsing a
+// `._Foo.podspec` during `expo prebuild`, and node_modules symlinks
+// break. Generating an Expo project on one of these is a trap, so we
+// warn before doing it.
+const NON_NATIVE_FS = new Set([
+    'exfat', 'msdos', 'fat32', 'vfat',
+    'ntfs', 'ntfs-3g', 'fuseblk',
+    'smbfs', 'cifs', 'nfs', 'afpfs', 'webdav',
+]);
+
+// Resolve the filesystem type backing `targetPath`. The output dir
+// usually doesn't exist yet, so we walk up to the nearest existing
+// ancestor, then match it against the longest mount point in `mount`.
+// Returns { mountPoint, fsType } or null (non-darwin, or undetectable).
+function volumeInfo(targetPath) {
+    if (process.platform !== 'darwin') {
+        return null;
+    }
+
+    let dir = path.resolve(targetPath);
+    while (dir !== path.dirname(dir) && !fs.existsSync(dir)) {
+        dir = path.dirname(dir);
+    }
+
+    let mounts;
+    try {
+        mounts = execSync('mount', { encoding: 'utf-8' });
+    } catch {
+        return null;
+    }
+
+    // Lines look like: `/dev/disk10s1 on /Volumes/big (exfat, local, …)`
+    let best = null;
+    for (const line of mounts.split('\n')) {
+        const m = line.match(/ on (.+?) \(([^,)]+)/);
+        if (!m) {
+            continue;
+        }
+        const mountPoint = m[1];
+        const fsType = m[2].trim().toLowerCase();
+        const prefix = mountPoint.endsWith('/') ? mountPoint : mountPoint + '/';
+        if (dir === mountPoint || dir.startsWith(prefix)) {
+            if (!best || mountPoint.length > best.mountPoint.length) {
+                best = { mountPoint, fsType };
+            }
+        }
+    }
+    return best;
+}
+
+// Warn (and confirm) before generating a mobile project onto a
+// filesystem macOS can't build native code on. Returns true to
+// proceed, false to abort. Only meaningful when a mobile app is part
+// of the project — the acute failure is CocoaPods + `expo prebuild`.
+async function confirmFilesystem(outputDir, components) {
+    if (!components.mobile) {
+        return true;
+    }
+    const vol = volumeInfo(outputDir);
+    if (!vol || !NON_NATIVE_FS.has(vol.fsType)) {
+        return true;
+    }
+
+    console.log('');
+    console.log(red.bold(
+        `  ⚠  ${vol.mountPoint} is a ${vol.fsType} volume.`
+    ));
+    console.log(dim(
+        '     macOS can\'t store extended attributes or symlinks there,'
+    ));
+    console.log(dim(
+        '     so it scatters AppleDouble `._*` files next to everything'
+    ));
+    console.log(dim(
+        '     npm installs. `expo prebuild` then fails when CocoaPods'
+    ));
+    console.log(dim(
+        '     tries to parse a `._Foo.podspec`, and node_modules'
+    ));
+    console.log(dim('     symlinks break.'));
+    console.log('');
+    console.log(dim(
+        '     Recommended: generate on your internal drive (e.g. ~/dev),'
+    ));
+    console.log(dim('     an APFS / Mac OS Extended volume.'));
+    console.log('');
+
+    const { proceed } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'proceed',
+        message: `Generate on the ${vol.fsType} volume anyway?`,
+        default: false,
+    }]);
+    return proceed;
+}
+
 function componentsLabel(c) {
     const parts = [];
     if (c.server)  parts.push('server API');
@@ -604,6 +702,11 @@ export async function createProject() {
 
     const outputDir = path.resolve(details.outputDir);
 
+    if (!await confirmFilesystem(outputDir, details.components)) {
+        console.log(chalk.yellow('Aborted. No files were created.'));
+        return;
+    }
+
     if (fs.existsSync(outputDir)) {
         const { overwrite } = await inquirer.prompt([{
             type: 'confirm',
@@ -710,6 +813,7 @@ export async function createProject() {
     if (details.components.mobile) {
         scripts.push(
             'scripts/bump-version.sh',
+            'scripts/clean-appledouble.sh',
             'scripts/prebuild.sh',
             'scripts/run-ios.sh',
             'scripts/release-android.sh',

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "umpordez",
     "type": "module",
-    "version": "1.5.0",
+    "version": "1.5.1",
     "description": "SaaS starter kit generator — server, admin SPA, public site (i18n), mobile app (offline-first, IAP, native push)",
     "main": "cli.mjs",
     "scripts": {

package/template/gitignore

@@ -5,6 +5,8 @@ build/
 dist/
 *.log
 .DS_Store
+._*
+.AppleDouble
 *.swp
 *.swo
 *~

package/template/install.sh

@@ -55,6 +55,10 @@ if [ -d "mobile/{{PROJECT_SLUG}}" ]; then
 
         if [[ "$(uname)" == "Darwin" ]]; then
             if [ -d "mobile/{{PROJECT_SLUG}}/ios" ]; then
+                # Strip AppleDouble `._*` files (exFAT/NTFS/network
+                # volumes) so pod install doesn't choke on a
+                # `._Foo.podspec`. No-op on APFS.
+                ./scripts/clean-appledouble.sh "mobile/{{PROJECT_SLUG}}"
                 echo "Installing iOS pods..."
                 (cd "mobile/{{PROJECT_SLUG}}/ios" && pod install)
             fi

package/template/scripts/clean-appledouble.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+#
+# clean-appledouble — remove macOS AppleDouble `._*` sidecar files.
+#
+# macOS drops a `._<name>` metadata file next to every file that carries
+# extended attributes when it lives on a filesystem that can't store
+# xattrs natively (exFAT, MS-DOS/FAT, NTFS, SMB/NFS network mounts).
+# CocoaPods then scans for `*.podspec`, finds `._Foo.podspec`, tries to
+# parse the binary metadata as Ruby, and `pod install` — and therefore
+# `expo prebuild` / `expo run:ios` — dies with:
+#
+#   Invalid `Podfile` file: Invalid podspec file at path
+#   .../node_modules/.../ios/._Foo.podspec
+#
+# On APFS / Mac OS Extended there are none, so this is a fast no-op. Run
+# it before any pod install / prebuild / native build.
+#
+# The real fix is to keep the project on an APFS / Mac OS Extended disk
+# (e.g. ~/dev) — exFAT/NTFS regenerate these files on every npm install.
+#
+# Usage: ./scripts/clean-appledouble.sh [dir]   (default: repo root)
+
+set -euo pipefail
+
+# AppleDouble files are a macOS-only artifact.
+[[ "$(uname)" == "Darwin" ]] || exit 0
+
+TARGET="${1:-$(cd "$(dirname "$0")/.." && pwd)}"
+[[ -d "$TARGET" ]] || exit 0
+
+n=$(
+    find "$TARGET" -name '._*' -type f -print -delete 2>/dev/null \
+        | wc -l | tr -d ' '
+)
+
+if [[ "${n:-0}" -gt 0 ]]; then
+    echo "==> Removed $n AppleDouble ._* file(s) under $TARGET"
+    echo "    This disk can't store macOS extended attributes (likely"
+    echo "    exFAT/NTFS/network), so they'll return on the next npm"
+    echo "    install. For clean native builds, move the project to an"
+    echo "    APFS / Mac OS Extended disk (e.g. ~/dev)."
+fi

package/template/scripts/prebuild.sh

@@ -24,5 +24,12 @@ for arg in "$@"; do
     esac
 done
 
-cd "$(dirname "$0")/../mobile/{{PROJECT_SLUG}}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR/../mobile/{{PROJECT_SLUG}}"
+
+# Strip macOS AppleDouble `._*` files before prebuild — CocoaPods
+# chokes on `._Foo.podspec` when the project lives on exFAT/NTFS/network
+# volumes. No-op on APFS. See scripts/clean-appledouble.sh.
+"$SCRIPT_DIR/clean-appledouble.sh" "$PWD"
+
 exec npx expo prebuild "$@"

package/template/scripts/run-ios.sh

@@ -53,6 +53,11 @@ done
 
 cd "$APP_DIR"
 
+# Strip macOS AppleDouble `._*` files so the pod install triggered by
+# `expo run:ios` doesn't choke on `._Foo.podspec` (exFAT/NTFS/network
+# volumes). No-op on APFS. See scripts/clean-appledouble.sh.
+"$SCRIPT_DIR/clean-appledouble.sh" "$APP_DIR"
+
 if [[ $CLEAN -eq 1 ]]; then
     echo "==> Cleaning iOS build artifacts..."
     rm -rf ios/build