sitepong 0.2.2 → 0.2.4

package/app.plugin.js

@@ -0,0 +1,426 @@
+/**
+ * SitePong SDK — Expo config plugin (the ONE plugin).
+ *
+ * `sitepong` is a single package that ships all native capabilities. Its config
+ * plugin therefore does what the old per-feature plugins used to do:
+ *
+ *   1. Screen recording / Watchtower tap capture — NO native config needed.
+ *      (View-hierarchy capture; no screen-record entitlement, no purpose string.)
+ *      The Watchtower engine is compiled into the Sitepong pod, so there is no
+ *      Podfile patch anymore — that whole fragility is gone.
+ *   2. Device ID — writes PrivacyInfo.xcprivacy declaring Keychain-backed device
+ *      id usage for analytics (Apple requirement since May 2024). Always applied.
+ *   3. Live Activities — a WidgetKit app-extension target. This is the ONLY piece
+ *      that alters the Xcode project, so it is OPT-IN: enable with
+ *        ["sitepong", { "liveActivities": true }]
+ *      (optionally { "appGroupId": "group.com.myapp" }). A plain ["sitepong"]
+ *      links capture + device id and leaves the Xcode project otherwise untouched.
+ *
+ * Usage:
+ *   ["sitepong"]                                        // capture + device id
+ *   ["sitepong", { "liveActivities": true }]            // + Live Activities
+ *   ["sitepong", { "liveActivities": true, "appGroupId": "group.com.myapp" }]
+ */
+const fs = require('fs');
+const path = require('path');
+
+// Resolve Expo's config-plugins from the CONSUMING app (this package is often
+// symlinked and has no expo of its own). expo prebuild runs in the app context.
+function resolveConfigPlugins() {
+  const candidates = ['@expo/config-plugins', 'expo/config-plugins'];
+  const searchPaths = [
+    process.cwd(),
+    path.join(process.cwd(), 'node_modules'),
+    __dirname,
+  ];
+  for (const name of candidates) {
+    try {
+      return require(require.resolve(name, { paths: searchPaths }));
+    } catch (_) {
+      /* try next */
+    }
+  }
+  return require('@expo/config-plugins');
+}
+
+const {
+  withXcodeProject,
+  withInfoPlist,
+  withEntitlementsPlist,
+} = resolveConfigPlugins();
+
+// ─── Device ID: PrivacyInfo.xcprivacy ────────────────────────────────────────
+
+const PRIVACY_INFO = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>NSPrivacyTracking</key>
+  <false/>
+  <key>NSPrivacyCollectedDataTypes</key>
+  <array>
+    <dict>
+      <key>NSPrivacyCollectedDataType</key>
+      <string>NSPrivacyCollectedDataTypeDeviceID</string>
+      <key>NSPrivacyCollectedDataTypeLinked</key>
+      <false/>
+      <key>NSPrivacyCollectedDataTypeTracking</key>
+      <false/>
+      <key>NSPrivacyCollectedDataTypePurposes</key>
+      <array>
+        <string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+      </array>
+    </dict>
+  </array>
+  <key>NSPrivacyAccessedAPITypes</key>
+  <array>
+    <dict>
+      <key>NSPrivacyAccessedAPIType</key>
+      <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+      <key>NSPrivacyAccessedAPITypeReasons</key>
+      <array>
+        <string>CA92.1</string>
+      </array>
+    </dict>
+  </array>
+</dict>
+</plist>`;
+
+function withDeviceIdPrivacy(config) {
+  return withXcodeProject(config, async (cfg) => {
+    const projectRoot = cfg.modRequest.projectRoot;
+    const iosDir = path.join(
+      projectRoot,
+      'ios',
+      cfg.modRequest.projectName || '',
+    );
+    const privacyPath = path.join(iosDir, 'PrivacyInfo.xcprivacy');
+    if (!fs.existsSync(privacyPath)) {
+      fs.mkdirSync(path.dirname(privacyPath), { recursive: true });
+      fs.writeFileSync(privacyPath, PRIVACY_INFO);
+    }
+    return cfg;
+  });
+}
+
+// ─── Live Activities: WidgetKit app-extension target (opt-in) ────────────────
+
+const EXTENSION_NAME = 'SitePongLiveActivityWidget';
+
+// All Swift compiled into the Widget Extension target. These live under
+// ios/LiveActivity/ in the sitepong package (they are excluded from the main
+// pod by Sitepong.podspec). SitePongActivityAttributes is shared with the main
+// app module and is also compiled into the pod — the extension needs its own
+// copy because app extensions don't link the app's pods.
+const WIDGET_SOURCE_FILES = [
+  { src: 'ios/LiveActivity/SitePongActivityAttributes.swift', name: 'SitePongActivityAttributes.swift' },
+  { src: 'ios/LiveActivity/widget/SitePongWidgetBundle.swift', name: 'SitePongWidgetBundle.swift' },
+  { src: 'ios/LiveActivity/widget/SitePongLiveActivityWidget.swift', name: 'SitePongLiveActivityWidget.swift' },
+  { src: 'ios/LiveActivity/widget/DSLRenderer.swift', name: 'DSLRenderer.swift' },
+  // DSLNode + ConfigStore are shared with the main app module (compiled into the
+  // Sitepong pod), so they live at ios/LiveActivity/ root, not under widget/.
+  { src: 'ios/LiveActivity/DSLNode.swift', name: 'DSLNode.swift' },
+  { src: 'ios/LiveActivity/widget/DSLAnimations.swift', name: 'DSLAnimations.swift' },
+  { src: 'ios/LiveActivity/ConfigStore.swift', name: 'ConfigStore.swift' },
+  { src: 'ios/LiveActivity/widget/ColorHex.swift', name: 'ColorHex.swift' },
+];
+
+const WIDGET_INFO_PLIST = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>NSExtension</key>
+  <dict>
+    <key>NSExtensionPointIdentifier</key>
+    <string>com.apple.widgetkit-extension</string>
+  </dict>
+  <key>CFBundleExecutable</key>
+  <string>$(EXECUTABLE_NAME)</string>
+  <key>CFBundleIdentifier</key>
+  <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+  <key>CFBundleName</key>
+  <string>$(PRODUCT_NAME)</string>
+  <key>CFBundleDisplayName</key>
+  <string>${EXTENSION_NAME}</string>
+  <key>CFBundlePackageType</key>
+  <string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+  <key>CFBundleShortVersionString</key>
+  <string>$(MARKETING_VERSION)</string>
+  <key>CFBundleVersion</key>
+  <string>$(CURRENT_PROJECT_VERSION)</string>
+</dict>
+</plist>`;
+
+function generateEntitlementsPlist(entitlements) {
+  let entries = '';
+  for (const [key, value] of Object.entries(entitlements)) {
+    if (Array.isArray(value)) {
+      entries += `  <key>${key}</key>\n  <array>\n`;
+      for (const item of value) entries += `    <string>${item}</string>\n`;
+      entries += `  </array>\n`;
+    } else if (typeof value === 'string') {
+      entries += `  <key>${key}</key>\n  <string>${value}</string>\n`;
+    } else if (typeof value === 'boolean') {
+      entries += `  <key>${key}</key>\n  <${value}/>\n`;
+    }
+  }
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+${entries}</dict>
+</plist>`;
+}
+
+function withLiveActivities(config, props) {
+  // 1. aps-environment entitlement on the main app (push tokens for updates).
+  config = withEntitlementsPlist(config, (cfg) => {
+    cfg.modResults['aps-environment'] =
+      cfg.modResults['aps-environment'] || 'development';
+    return cfg;
+  });
+
+  // 2. Live Activities support in the main Info.plist.
+  config = withInfoPlist(config, (cfg) => {
+    cfg.modResults.NSSupportsLiveActivities = true;
+    cfg.modResults.NSSupportsLiveActivitiesFrequentUpdates = true;
+    return cfg;
+  });
+
+  // 3. Add the Widget Extension target to the Xcode project.
+  config = withXcodeProject(config, async (cfg) => {
+    const xcodeProject = cfg.modResults;
+    const projectRoot = cfg.modRequest.projectRoot;
+    const bundleId = cfg.ios?.bundleIdentifier || 'com.app';
+    const extensionBundleId = `${bundleId}.${EXTENSION_NAME}`;
+
+    const extensionDir = path.join(projectRoot, 'ios', EXTENSION_NAME);
+    const packageRoot = __dirname;
+
+    if (!fs.existsSync(extensionDir)) {
+      fs.mkdirSync(extensionDir, { recursive: true });
+    }
+
+    for (const file of WIDGET_SOURCE_FILES) {
+      const srcPath = path.join(packageRoot, file.src);
+      const dstPath = path.join(extensionDir, file.name);
+      if (!fs.existsSync(srcPath)) {
+        console.warn(`[sitepong] Missing Live Activity source: ${srcPath}`);
+        continue;
+      }
+      fs.copyFileSync(srcPath, dstPath);
+    }
+
+    fs.writeFileSync(path.join(extensionDir, 'Info.plist'), WIDGET_INFO_PLIST);
+
+    const entitlements = {};
+    if (props.appGroupId) {
+      entitlements['com.apple.security.application-groups'] = [props.appGroupId];
+    }
+    fs.writeFileSync(
+      path.join(extensionDir, `${EXTENSION_NAME}.entitlements`),
+      generateEntitlementsPlist(entitlements),
+    );
+
+    if (xcodeProject.pbxTargetByName(EXTENSION_NAME)) {
+      return cfg; // idempotent
+    }
+
+    const target = xcodeProject.addTarget(
+      EXTENSION_NAME,
+      'app_extension',
+      EXTENSION_NAME,
+      extensionBundleId,
+    );
+    if (!target) {
+      console.warn('[sitepong] Failed to add Live Activity extension target');
+      return cfg;
+    }
+
+    const pbxFileRef = xcodeProject.hash.project.objects['PBXFileReference'];
+    const sourceFileRefs = [];
+    for (const file of WIDGET_SOURCE_FILES) {
+      const ref = xcodeProject.generateUuid();
+      pbxFileRef[ref] = {
+        isa: 'PBXFileReference',
+        lastKnownFileType: 'sourcecode.swift',
+        name: file.name,
+        path: file.name,
+        sourceTree: '"<group>"',
+      };
+      pbxFileRef[ref + '_comment'] = file.name;
+      sourceFileRefs.push({ ref, name: file.name });
+    }
+
+    const plistRef = xcodeProject.generateUuid();
+    pbxFileRef[plistRef] = {
+      isa: 'PBXFileReference',
+      lastKnownFileType: 'text.plist.xml',
+      name: 'Info.plist',
+      path: 'Info.plist',
+      sourceTree: '"<group>"',
+    };
+    pbxFileRef[plistRef + '_comment'] = 'Info.plist';
+
+    const entRef = xcodeProject.generateUuid();
+    pbxFileRef[entRef] = {
+      isa: 'PBXFileReference',
+      lastKnownFileType: 'text.plist.entitlements',
+      name: `${EXTENSION_NAME}.entitlements`,
+      path: `${EXTENSION_NAME}.entitlements`,
+      sourceTree: '"<group>"',
+    };
+    pbxFileRef[entRef + '_comment'] = `${EXTENSION_NAME}.entitlements`;
+
+    const groupUuid = xcodeProject.generateUuid();
+    const pbxGroup = xcodeProject.hash.project.objects['PBXGroup'];
+    pbxGroup[groupUuid] = {
+      isa: 'PBXGroup',
+      children: [
+        ...sourceFileRefs.map((f) => ({ value: f.ref, comment: f.name })),
+        { value: plistRef, comment: 'Info.plist' },
+        { value: entRef, comment: `${EXTENSION_NAME}.entitlements` },
+      ],
+      name: EXTENSION_NAME,
+      path: EXTENSION_NAME,
+      sourceTree: '"<group>"',
+    };
+    pbxGroup[groupUuid + '_comment'] = EXTENSION_NAME;
+
+    const mainGroup = xcodeProject.getFirstProject().firstProject.mainGroup;
+    const mainGroupObj = pbxGroup[mainGroup];
+    if (mainGroupObj && mainGroupObj.children) {
+      mainGroupObj.children.push({ value: groupUuid, comment: EXTENSION_NAME });
+    }
+
+    const pbxBuildFile = xcodeProject.hash.project.objects['PBXBuildFile'];
+    const buildFileEntries = sourceFileRefs.map((f) => {
+      const buildUuid = xcodeProject.generateUuid();
+      pbxBuildFile[buildUuid] = {
+        isa: 'PBXBuildFile',
+        fileRef: f.ref,
+        fileRef_comment: f.name,
+      };
+      pbxBuildFile[buildUuid + '_comment'] = `${f.name} in Sources`;
+      return { value: buildUuid, comment: `${f.name} in Sources` };
+    });
+
+    if (!xcodeProject.hash.project.objects['PBXSourcesBuildPhase']) {
+      xcodeProject.hash.project.objects['PBXSourcesBuildPhase'] = {};
+    }
+    const sourcesPhaseUuid = xcodeProject.generateUuid();
+    xcodeProject.hash.project.objects['PBXSourcesBuildPhase'][sourcesPhaseUuid] = {
+      isa: 'PBXSourcesBuildPhase',
+      buildActionMask: 2147483647,
+      files: buildFileEntries,
+      runOnlyForDeploymentPostprocessing: 0,
+    };
+    xcodeProject.hash.project.objects['PBXSourcesBuildPhase'][sourcesPhaseUuid + '_comment'] = 'Sources';
+
+    if (!xcodeProject.hash.project.objects['PBXFrameworksBuildPhase']) {
+      xcodeProject.hash.project.objects['PBXFrameworksBuildPhase'] = {};
+    }
+    const frameworksPhaseUuid = xcodeProject.generateUuid();
+    xcodeProject.hash.project.objects['PBXFrameworksBuildPhase'][frameworksPhaseUuid] = {
+      isa: 'PBXFrameworksBuildPhase',
+      buildActionMask: 2147483647,
+      files: [],
+      runOnlyForDeploymentPostprocessing: 0,
+    };
+    xcodeProject.hash.project.objects['PBXFrameworksBuildPhase'][frameworksPhaseUuid + '_comment'] = 'Frameworks';
+
+    if (!xcodeProject.hash.project.objects['PBXResourcesBuildPhase']) {
+      xcodeProject.hash.project.objects['PBXResourcesBuildPhase'] = {};
+    }
+    const resourcesPhaseUuid = xcodeProject.generateUuid();
+    xcodeProject.hash.project.objects['PBXResourcesBuildPhase'][resourcesPhaseUuid] = {
+      isa: 'PBXResourcesBuildPhase',
+      buildActionMask: 2147483647,
+      files: [],
+      runOnlyForDeploymentPostprocessing: 0,
+    };
+    xcodeProject.hash.project.objects['PBXResourcesBuildPhase'][resourcesPhaseUuid + '_comment'] = 'Resources';
+
+    const targetUuid = target.uuid;
+    const nativeTargets = xcodeProject.hash.project.objects['PBXNativeTarget'];
+    if (nativeTargets[targetUuid]) {
+      nativeTargets[targetUuid].buildPhases = [
+        { value: sourcesPhaseUuid, comment: 'Sources' },
+        { value: frameworksPhaseUuid, comment: 'Frameworks' },
+        { value: resourcesPhaseUuid, comment: 'Resources' },
+      ];
+    }
+
+    const configurations = xcodeProject.pbxXCBuildConfigurationSection();
+    for (const key in configurations) {
+      const c = configurations[key];
+      if (c && typeof c === 'object' && c.name && c.buildSettings) {
+        if (
+          c.buildSettings.PRODUCT_NAME === `"${EXTENSION_NAME}"` ||
+          c.buildSettings.PRODUCT_NAME === EXTENSION_NAME
+        ) {
+          c.buildSettings.IPHONEOS_DEPLOYMENT_TARGET = '16.2';
+          c.buildSettings.SWIFT_VERSION = '5.0';
+          c.buildSettings.CODE_SIGN_ENTITLEMENTS = `${EXTENSION_NAME}/${EXTENSION_NAME}.entitlements`;
+          c.buildSettings.INFOPLIST_FILE = `${EXTENSION_NAME}/Info.plist`;
+          c.buildSettings.PRODUCT_BUNDLE_IDENTIFIER = extensionBundleId;
+          c.buildSettings.GENERATE_INFOPLIST_FILE = 'NO';
+          c.buildSettings.CURRENT_PROJECT_VERSION = '1';
+          c.buildSettings.MARKETING_VERSION = '1.0';
+          c.buildSettings.CODE_SIGN_STYLE = 'Manual';
+          c.buildSettings.CODE_SIGN_IDENTITY = '"iPhone Distribution"';
+          c.buildSettings.SKIP_INSTALL = 'YES';
+          c.buildSettings.LD_RUNPATH_SEARCH_PATHS =
+            '"$(inherited) @executable_path/Frameworks @executable_path/../../Frameworks"';
+
+          for (const mk in configurations) {
+            const mc = configurations[mk];
+            if (
+              mc?.buildSettings?.DEVELOPMENT_TEAM &&
+              mc.name === c.name &&
+              mc.buildSettings.PRODUCT_BUNDLE_IDENTIFIER !== extensionBundleId
+            ) {
+              c.buildSettings.DEVELOPMENT_TEAM = mc.buildSettings.DEVELOPMENT_TEAM;
+              break;
+            }
+          }
+        }
+      }
+    }
+
+    const mainTarget = xcodeProject.getFirstTarget();
+    if (mainTarget && mainTarget.firstTarget) {
+      xcodeProject.addTargetDependency(mainTarget.firstTarget.uuid, [target.uuid]);
+      const copyPhase = xcodeProject.addBuildPhase(
+        [],
+        'PBXCopyFilesBuildPhase',
+        'Embed App Extensions',
+        mainTarget.firstTarget.uuid,
+        'app_extension',
+      );
+      if (copyPhase) {
+        copyPhase.buildPhase.dstSubfolderSpec = 13;
+      }
+    }
+
+    return cfg;
+  });
+
+  return config;
+}
+
+// ─── Entry ───────────────────────────────────────────────────────────────────
+
+function withSitePong(config, props = {}) {
+  // Device id privacy manifest is always safe to apply.
+  config = withDeviceIdPrivacy(config);
+
+  // Live Activities alter the Xcode project — opt in explicitly.
+  if (props && (props.liveActivities === true || props.appGroupId)) {
+    config = withLiveActivities(config, props);
+  }
+
+  return config;
+}
+
+module.exports = withSitePong;