@capgo/capacitor-pretty-toast 8.1.0

package/ios/Tests/PrettyToastPluginTests/PrettyToastPluginTests.swift

@@ -0,0 +1,21 @@
+import XCTest
+@testable import PrettyToastPlugin
+
+final class PrettyToastPluginTests: XCTestCase {
+    func testPluginMetadata() {
+        let plugin = PrettyToastPlugin()
+        XCTAssertEqual(plugin.identifier, "PrettyToastPlugin")
+        XCTAssertEqual(plugin.jsName, "PrettyToast")
+    }
+
+    func testPluginMethods() {
+        let plugin = PrettyToastPlugin()
+        let methodNames = plugin.pluginMethods.map(\.name)
+        XCTAssertEqual(methodNames, ["showCurrentToast", "updateCurrentToast", "dismissCurrentToast"])
+    }
+
+    func testHexColorParsing() {
+        let color = PrettyToastColorParser.parse("#FF0000")
+        XCTAssertNotNil(color)
+    }
+}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@capgo/capacitor-pretty-toast",
+  "version": "8.1.0",
+  "description": "Native-first pretty toast notifications for Capacitor and the web",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/src/test/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "scripts/",
+    "Package.swift",
+    "CapgoCapacitorPrettyToast.podspec"
+  ],
+  "author": "Martin Donadieu <martin@capgo.app>",
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cap-go/capacitor-pretty-toast.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Cap-go/capacitor-pretty-toast/issues"
+  },
+  "homepage": "https://capgo.app/docs/plugins/pretty-toast/",
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "toast",
+    "notifications",
+    "dynamic-island",
+    "web"
+  ],
+  "scripts": {
+    "verify": "bun run verify:web && bun run verify:ios && bun run verify:android",
+    "verify:ios": "xcodebuild -scheme CapgoCapacitorPrettyToast -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "bun run build && bun test",
+    "test": "bun test && bun run test:ios && bun run test:android",
+    "test:ios": "./scripts/test-ios.sh",
+    "test:android": "cd android && ./gradlew test && cd ..",
+    "lint": "bun run eslint && bun run prettier -- --check && bun run swiftlint -- lint",
+    "fmt": "bun run eslint -- --fix && bun run prettier -- --write && bun run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier-pretty-check \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api PrettyToastPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "bun run clean && bun run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "bun run build",
+    "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs",
+    "example:install": "cd example-app && bun install --frozen-lockfile",
+    "example:build": "bun run build && cd example-app && bun install --frozen-lockfile && bun run build",
+    "example:capgo:deploy": "bun run example:build && bun scripts/deploy-example-capgo.mjs"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/cli": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.1",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "@types/node": "^24.10.1",
+    "eslint": "^8.57.1",
+    "eslint-plugin-import": "^2.31.0",
+    "husky": "^9.1.7",
+    "prettier": "^3.6.2",
+    "prettier-plugin-java": "^2.7.7",
+    "prettier-pretty-check": "^0.2.0",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.53.2",
+    "swiftlint": "^2.0.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}

package/scripts/check-capacitor-plugin-wiring.mjs

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+/**
+ * Capacitor plugin wiring/name checker.
+ *
+ * Enforces that runtime plugin name matches across:
+ * - JS: registerPlugin('Name')
+ * - Android: @CapacitorPlugin(name = "Name")
+ * - iOS: CAPBridgedPlugin jsName = "Name"
+ *
+ * And (when iOS is declared in package.json capacitor config):
+ * - CocoaPods podspec s.name matches SwiftPM Package(name: ...) and .library(name: ...)
+ *
+ * Usage:
+ *   node tools/check-capacitor-plugin-wiring.mjs            # checks current working dir
+ *   node tools/check-capacitor-plugin-wiring.mjs --dir path # checks given plugin dir
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+
+const SKIP_DIRS = new Set([
+  "node_modules",
+  "dist",
+  "build",
+  ".build",
+  ".gradle",
+  "Pods",
+  "DerivedData",
+  ".swiftpm",
+  ".git",
+]);
+
+function readText(p) {
+  try {
+    return fs.readFileSync(p, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+function exists(p) {
+  try {
+    fs.accessSync(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function walkFiles(rootDir, exts) {
+  const out = [];
+  const stack = [rootDir];
+  while (stack.length) {
+    const dir = stack.pop();
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const e of entries) {
+      if (e.isDirectory()) {
+        if (SKIP_DIRS.has(e.name)) continue;
+        stack.push(path.join(dir, e.name));
+        continue;
+      }
+      if (!e.isFile()) continue;
+      for (const ext of exts) {
+        if (e.name.endsWith(ext)) {
+          out.push(path.join(dir, e.name));
+          break;
+        }
+      }
+    }
+  }
+  out.sort();
+  return out;
+}
+
+function uniq(arr) {
+  const out = [];
+  for (const x of arr) {
+    if (!x) continue;
+    if (!out.includes(x)) out.push(x);
+  }
+  return out;
+}
+
+function parseArgs(argv) {
+  const out = { dir: process.cwd() };
+  for (let i = 2; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--dir" || a === "--pluginDir") {
+      out.dir = path.resolve(argv[++i] || ".");
+      continue;
+    }
+  }
+  return out;
+}
+
+const args = parseArgs(process.argv);
+const pluginDir = args.dir;
+const pkgPath = path.join(pluginDir, "package.json");
+
+if (!exists(pkgPath)) {
+  console.error(`[wiring] ERROR: missing package.json in ${pluginDir}`);
+  process.exit(2);
+}
+
+let pkg;
+try {
+  pkg = JSON.parse(readText(pkgPath));
+} catch (e) {
+  console.error(`[wiring] ERROR: invalid package.json (${pkgPath}): ${e?.message || e}`);
+  process.exit(2);
+}
+
+const cap = typeof pkg.capacitor === "object" && pkg.capacitor ? pkg.capacitor : {};
+const supportsAndroid = typeof cap.android === "object" && cap.android;
+const supportsIos = typeof cap.ios === "object" && cap.ios;
+
+// Not a Capacitor plugin package (e.g. meta/workspace package).
+// We only enforce wiring rules for actual plugin packages declaring a `capacitor` config.
+if (!supportsAndroid && !supportsIos) {
+  process.exit(0);
+}
+
+// ---------------- JS (registerPlugin) ----------------
+const jsSrcDir = path.join(pluginDir, "src");
+let jsName = "";
+if (exists(jsSrcDir)) {
+  const jsFiles = walkFiles(jsSrcDir, [".ts", ".js"]);
+  const reRegister = /registerPlugin(?:<[^>]*>)?\(\s*['"]([^'"]+)['"]/;
+  for (const f of jsFiles) {
+    const m = reRegister.exec(readText(f));
+    if (m) {
+      jsName = m[1];
+      break;
+    }
+  }
+}
+
+// ---------------- Android (@CapacitorPlugin) ----------------
+let androidNames = [];
+if (supportsAndroid) {
+  const androidMain = path.join(pluginDir, "android", "src", "main");
+  const files = walkFiles(androidMain, [".java", ".kt"]);
+  const foundAnnotations = [];
+  for (const f of files) {
+    const txt = readText(f);
+    if (!txt.includes("@CapacitorPlugin")) continue;
+    foundAnnotations.push(f);
+    const m =
+      /@CapacitorPlugin\(\s*name\s*=\s*"([^"]+)"/.exec(txt) ||
+      /@CapacitorPlugin\(\s*name\s*=\s*([A-Za-z0-9_]+)\b/.exec(txt);
+    if (m) androidNames.push(m[1]);
+  }
+  androidNames = uniq(androidNames);
+
+  // Enforce explicit name attribute to prevent silent class-name drift.
+  if (foundAnnotations.length && !androidNames.length) {
+    console.error(
+      `[wiring] ERROR: Android has @CapacitorPlugin but none specify name = \"...\". Add an explicit name to the plugin class.`
+    );
+    process.exit(1);
+  }
+}
+
+// ---------------- iOS (jsName) ----------------
+let iosJsNames = [];
+if (supportsIos) {
+  const iosDir = path.join(pluginDir, "ios");
+  const scanRoot = exists(path.join(iosDir, "Sources")) ? path.join(iosDir, "Sources") : iosDir;
+  const swiftFiles = walkFiles(scanRoot, [".swift"]);
+  const reJsName = /\bjsName\s*=\s*"([^"]+)"/g;
+  for (const f of swiftFiles) {
+    const txt = readText(f);
+    if (!txt.includes("jsName")) continue;
+    let m;
+    while ((m = reJsName.exec(txt))) iosJsNames.push(m[1]);
+  }
+  iosJsNames = uniq(iosJsNames);
+}
+
+// ---------------- Podspec/SPM ----------------
+function parsePodspecName(podspecPath) {
+  const txt = readText(podspecPath);
+  const m = /\bs\.name\s*=\s*'([^']+)'/.exec(txt);
+  return m ? m[1] : "";
+}
+
+function parseSpmNames(packageSwiftPath) {
+  const txt = readText(packageSwiftPath);
+  const pkg = /Package\(\s*name\s*:\s*"([^"]+)"/.exec(txt)?.[1] || "";
+  const libs = [];
+  const reLib = /\.library\(\s*name\s*:\s*"([^"]+)"/g;
+  let m;
+  while ((m = reLib.exec(txt))) libs.push(m[1]);
+  return { pkgName: pkg, libNames: uniq(libs) };
+}
+
+// ---------------- Validate ----------------
+const errors = [];
+
+if (!jsName) {
+  errors.push("JS: no registerPlugin('...') found under src/");
+}
+
+if (supportsAndroid) {
+  if (!androidNames.length) errors.push("Android: missing @CapacitorPlugin(name = \"...\")");
+  if (jsName && androidNames.length && androidNames.some((n) => n !== jsName)) {
+    errors.push(`Android: @CapacitorPlugin(name)=${JSON.stringify(androidNames)} != JS registerPlugin=${jsName}`);
+  }
+}
+
+if (supportsIos) {
+  if (!iosJsNames.length) errors.push('iOS: missing jsName = "..." in Swift sources');
+  if (jsName && iosJsNames.length && iosJsNames.some((n) => n !== jsName)) {
+    errors.push(`iOS: jsName=${JSON.stringify(iosJsNames)} != JS registerPlugin=${jsName}`);
+  }
+
+  const podspecs = fs
+    .readdirSync(pluginDir, { withFileTypes: true })
+    .filter((e) => e.isFile() && e.name.endsWith(".podspec"))
+    .map((e) => path.join(pluginDir, e.name))
+    .sort();
+  if (!podspecs.length) errors.push("iOS: missing *.podspec at plugin root");
+  if (podspecs.length > 1) errors.push(`iOS: multiple podspecs at plugin root: ${podspecs.map((p) => path.basename(p))}`);
+
+  const pkgSwift = path.join(pluginDir, "Package.swift");
+  if (!exists(pkgSwift)) {
+    errors.push("iOS: missing Package.swift at plugin root");
+  } else if (podspecs.length) {
+    const podName = parsePodspecName(podspecs[0]);
+    const { pkgName, libNames } = parseSpmNames(pkgSwift);
+    if (!podName) errors.push("Podspec: missing s.name = '...'");
+    if (!pkgName) errors.push('SPM: missing Package(name: "...")');
+    if (podName && pkgName && podName !== pkgName) {
+      errors.push(`Podspec: s.name=${podName} != Package(name)=${pkgName}`);
+    }
+    if (pkgName && libNames.length && !libNames.includes(pkgName)) {
+      errors.push(`SPM: Package(name)=${pkgName} not present in .library(name) list ${JSON.stringify(libNames)}`);
+    }
+  }
+}
+
+if (errors.length) {
+  const relDir = path.relative(process.cwd(), pluginDir) || ".";
+  console.error(`[wiring] FAIL in ${relDir}`);
+  for (const e of errors) console.error(`- ${e}`);
+  process.exit(1);
+}
+
+process.exit(0);

package/scripts/deploy-example-capgo.mjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env bun
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(scriptDir, '..');
+const appDir = resolve(repoRoot, 'example-app');
+const distDir = resolve(appDir, 'dist');
+const packageJsonPath = resolve(repoRoot, 'package.json');
+const capacitorConfigPath = resolve(appDir, 'capacitor.config.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+const capacitorConfig = JSON.parse(readFileSync(capacitorConfigPath, 'utf8'));
+const packageVersion = packageJson.version;
+
+const appId = process.env.CAPGO_APP_ID || 'app.capgo.pretty.toast';
+const channel = process.env.CAPGO_CHANNEL || process.argv[2] || 'production';
+const bundle = packageVersion;
+const comment =
+  process.env.CAPGO_COMMENT ||
+  (process.env.GITHUB_RUN_NUMBER
+    ? `Pretty Toast example ${packageVersion} from run ${process.env.GITHUB_RUN_NUMBER}`
+    : `Pretty Toast example ${packageVersion}`);
+
+if (!packageVersion) {
+  console.error('Missing package.json version.');
+  process.exit(1);
+}
+
+capacitorConfig.plugins ??= {};
+capacitorConfig.plugins.CapacitorUpdater ??= {};
+capacitorConfig.plugins.CapacitorUpdater.version = packageVersion;
+writeFileSync(capacitorConfigPath, `${JSON.stringify(capacitorConfig, null, 2)}\n`);
+
+const configVersion = capacitorConfig.plugins.CapacitorUpdater.version;
+
+if (configVersion !== packageVersion) {
+  console.error(
+    `CapacitorUpdater.version (${configVersion ?? 'missing'}) must match package.json version (${packageVersion}).`,
+  );
+  process.exit(1);
+}
+
+if (!existsSync(distDir)) {
+  console.error('Missing example-app/dist. Run bun run --cwd example-app build first.');
+  process.exit(1);
+}
+
+if (!process.env.CAPGO_TOKEN) {
+  console.error('Missing CAPGO_TOKEN.');
+  process.exit(1);
+}
+
+const args = [
+  '@capgo/cli@7.108.3',
+  'bundle',
+  'upload',
+  appId,
+  '--path',
+  'dist',
+  '--channel',
+  channel,
+  '--bundle',
+  bundle,
+  '--package-json',
+  '../package.json,package.json',
+  '--node-modules',
+  '../node_modules,node_modules',
+  '--delta',
+  '--no-key',
+  '--ignore-checksum-check',
+  '--version-exists-ok',
+  '--comment',
+  comment,
+];
+
+console.log(`Deploying ${appId}@${bundle} to Capgo channel "${channel}"`);
+
+const result = spawnSync('bunx', args, {
+  cwd: appDir,
+  stdio: 'inherit',
+  env: process.env,
+});
+
+process.exit(result.status ?? 1);

package/scripts/test-ios.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+SIMULATOR_ID=$(xcrun simctl list devices available | awk -F '[()]' '/iPhone/{print $2; exit}')
+
+if [[ -z "${SIMULATOR_ID:-}" ]]; then
+  echo "No available iPhone simulator found. Please install one via Xcode." >&2
+  exit 1
+fi
+
+xcodebuild test -scheme CapgoCapacitorPrettyToast -destination "id=${SIMULATOR_ID}" "$@"