@capgo/capacitor-persistent-uuid 8.1.0

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst PersistentUuid = registerPlugin('PersistentUuid', {\n    web: () => import('./web').then((m) => new m.PersistentUuidWeb()),\n});\nexport * from './definitions';\nexport { PersistentUuid };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nconst STORAGE_PREFIX = 'capgo:persistent-uuid:';\nconst DEFAULT_SCOPE = 'web';\nconst memoryStore = new Map();\nconst normalizeScope = (options) => {\n    var _a;\n    const scope = (_a = options === null || options === void 0 ? void 0 : options.scope) === null || _a === void 0 ? void 0 : _a.trim();\n    return scope && scope.length > 0 ? scope : DEFAULT_SCOPE;\n};\nconst createUuid = () => {\n    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n        return crypto.randomUUID();\n    }\n    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (char) => {\n        const random = Math.floor(Math.random() * 16);\n        const value = char === 'x' ? random : (random & 0x3) | 0x8;\n        return value.toString(16);\n    });\n};\nconst readValue = (key) => {\n    var _a, _b, _c, _d;\n    try {\n        return (_c = (_b = (_a = globalThis.localStorage) === null || _a === void 0 ? void 0 : _a.getItem(key)) !== null && _b !== void 0 ? _b : memoryStore.get(key)) !== null && _c !== void 0 ? _c : null;\n    }\n    catch (_e) {\n        return (_d = memoryStore.get(key)) !== null && _d !== void 0 ? _d : null;\n    }\n};\nconst writeValue = (key, value) => {\n    var _a;\n    memoryStore.set(key, value);\n    try {\n        (_a = globalThis.localStorage) === null || _a === void 0 ? void 0 : _a.setItem(key, value);\n    }\n    catch (_b) {\n        // In-memory fallback already updated.\n    }\n};\nexport class PersistentUuidWeb extends WebPlugin {\n    async getId(options) {\n        const scope = normalizeScope(options);\n        const key = STORAGE_PREFIX + scope;\n        const existing = readValue(key);\n        if (existing) {\n            return {\n                id: existing,\n                scope,\n                created: false,\n            };\n        }\n        const id = createUuid();\n        writeValue(key, id);\n        return {\n            id,\n            scope,\n            created: true,\n        };\n    }\n    async resetId(options) {\n        const scope = normalizeScope(options);\n        const id = createUuid();\n        writeValue(STORAGE_PREFIX + scope, id);\n        return {\n            id,\n            scope,\n            created: true,\n        };\n    }\n    async getPluginVersion() {\n        return {\n            version: 'web',\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/dist/plugin.js

@@ -0,0 +1,92 @@
+var capacitorPersistentUuid = (function (exports, core) {
+    'use strict';
+
+    const PersistentUuid = core.registerPlugin('PersistentUuid', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.PersistentUuidWeb()),
+    });
+
+    const STORAGE_PREFIX = 'capgo:persistent-uuid:';
+    const DEFAULT_SCOPE = 'web';
+    const memoryStore = new Map();
+    const normalizeScope = (options) => {
+        var _a;
+        const scope = (_a = options === null || options === void 0 ? void 0 : options.scope) === null || _a === void 0 ? void 0 : _a.trim();
+        return scope && scope.length > 0 ? scope : DEFAULT_SCOPE;
+    };
+    const createUuid = () => {
+        if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+            return crypto.randomUUID();
+        }
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (char) => {
+            const random = Math.floor(Math.random() * 16);
+            const value = char === 'x' ? random : (random & 0x3) | 0x8;
+            return value.toString(16);
+        });
+    };
+    const readValue = (key) => {
+        var _a, _b, _c, _d;
+        try {
+            return (_c = (_b = (_a = globalThis.localStorage) === null || _a === void 0 ? void 0 : _a.getItem(key)) !== null && _b !== void 0 ? _b : memoryStore.get(key)) !== null && _c !== void 0 ? _c : null;
+        }
+        catch (_e) {
+            return (_d = memoryStore.get(key)) !== null && _d !== void 0 ? _d : null;
+        }
+    };
+    const writeValue = (key, value) => {
+        var _a;
+        memoryStore.set(key, value);
+        try {
+            (_a = globalThis.localStorage) === null || _a === void 0 ? void 0 : _a.setItem(key, value);
+        }
+        catch (_b) {
+            // In-memory fallback already updated.
+        }
+    };
+    class PersistentUuidWeb extends core.WebPlugin {
+        async getId(options) {
+            const scope = normalizeScope(options);
+            const key = STORAGE_PREFIX + scope;
+            const existing = readValue(key);
+            if (existing) {
+                return {
+                    id: existing,
+                    scope,
+                    created: false,
+                };
+            }
+            const id = createUuid();
+            writeValue(key, id);
+            return {
+                id,
+                scope,
+                created: true,
+            };
+        }
+        async resetId(options) {
+            const scope = normalizeScope(options);
+            const id = createUuid();
+            writeValue(STORAGE_PREFIX + scope, id);
+            return {
+                id,
+                scope,
+                created: true,
+            };
+        }
+        async getPluginVersion() {
+            return {
+                version: 'web',
+            };
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        PersistentUuidWeb: PersistentUuidWeb
+    });
+
+    exports.PersistentUuid = PersistentUuid;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst PersistentUuid = registerPlugin('PersistentUuid', {\n    web: () => import('./web').then((m) => new m.PersistentUuidWeb()),\n});\nexport * from './definitions';\nexport { PersistentUuid };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nconst STORAGE_PREFIX = 'capgo:persistent-uuid:';\nconst DEFAULT_SCOPE = 'web';\nconst memoryStore = new Map();\nconst normalizeScope = (options) => {\n    var _a;\n    const scope = (_a = options === null || options === void 0 ? void 0 : options.scope) === null || _a === void 0 ? void 0 : _a.trim();\n    return scope && scope.length > 0 ? scope : DEFAULT_SCOPE;\n};\nconst createUuid = () => {\n    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n        return crypto.randomUUID();\n    }\n    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (char) => {\n        const random = Math.floor(Math.random() * 16);\n        const value = char === 'x' ? random : (random & 0x3) | 0x8;\n        return value.toString(16);\n    });\n};\nconst readValue = (key) => {\n    var _a, _b, _c, _d;\n    try {\n        return (_c = (_b = (_a = globalThis.localStorage) === null || _a === void 0 ? void 0 : _a.getItem(key)) !== null && _b !== void 0 ? _b : memoryStore.get(key)) !== null && _c !== void 0 ? _c : null;\n    }\n    catch (_e) {\n        return (_d = memoryStore.get(key)) !== null && _d !== void 0 ? _d : null;\n    }\n};\nconst writeValue = (key, value) => {\n    var _a;\n    memoryStore.set(key, value);\n    try {\n        (_a = globalThis.localStorage) === null || _a === void 0 ? void 0 : _a.setItem(key, value);\n    }\n    catch (_b) {\n        // In-memory fallback already updated.\n    }\n};\nexport class PersistentUuidWeb extends WebPlugin {\n    async getId(options) {\n        const scope = normalizeScope(options);\n        const key = STORAGE_PREFIX + scope;\n        const existing = readValue(key);\n        if (existing) {\n            return {\n                id: existing,\n                scope,\n                created: false,\n            };\n        }\n        const id = createUuid();\n        writeValue(key, id);\n        return {\n            id,\n            scope,\n            created: true,\n        };\n    }\n    async resetId(options) {\n        const scope = normalizeScope(options);\n        const id = createUuid();\n        writeValue(STORAGE_PREFIX + scope, id);\n        return {\n            id,\n            scope,\n            created: true,\n        };\n    }\n    async getPluginVersion() {\n        return {\n            version: 'web',\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/ios/Sources/PersistentUuidPlugin/PersistentUuid.swift

@@ -0,0 +1,127 @@
+import Foundation
+import Security
+
+@objc public class PersistentUuid: NSObject {
+    private let service = "app.capgo.persistent_uuid"
+    private let accountPrefix = "PersistentUuid:"
+    private let fallbackScope = "default"
+
+    @objc public func getId(_ scope: String?) throws -> [String: Any] {
+        let normalizedScope = normalizeScope(scope)
+        if let existing = try readUuid(scope: normalizedScope) {
+            return [
+                "id": existing,
+                "scope": normalizedScope,
+                "created": false
+            ]
+        }
+
+        let id = createUuid()
+        try saveUuid(id, scope: normalizedScope)
+        return [
+            "id": id,
+            "scope": normalizedScope,
+            "created": true
+        ]
+    }
+
+    @objc public func resetId(_ scope: String?) throws -> [String: Any] {
+        let normalizedScope = normalizeScope(scope)
+        let id = createUuid()
+        try saveUuid(id, scope: normalizedScope)
+        return [
+            "id": id,
+            "scope": normalizedScope,
+            "created": true
+        ]
+    }
+
+    @objc public func getPluginVersion() -> String {
+        return "8.0.0"
+    }
+
+    private func normalizeScope(_ scope: String?) -> String {
+        if let trimmed = scope?.trimmingCharacters(in: .whitespacesAndNewlines), !trimmed.isEmpty {
+            return trimmed
+        }
+
+        return Bundle.main.bundleIdentifier ?? fallbackScope
+    }
+
+    private func accountName(scope: String) -> String {
+        return "\(accountPrefix)\(scope)"
+    }
+
+    private func createUuid() -> String {
+        return UUID().uuidString.lowercased()
+    }
+
+    private func baseQuery(scope: String) -> [String: Any] {
+        return [
+            kSecClass as String: kSecClassGenericPassword,
+            kSecAttrService as String: service,
+            kSecAttrAccount as String: accountName(scope: scope)
+        ]
+    }
+
+    private func readUuid(scope: String) throws -> String? {
+        var query = baseQuery(scope: scope)
+        query[kSecReturnData as String] = true
+        query[kSecMatchLimit as String] = kSecMatchLimitOne
+
+        var item: CFTypeRef?
+        let status = SecItemCopyMatching(query as CFDictionary, &item)
+        if status == errSecItemNotFound {
+            return nil
+        }
+
+        guard status == errSecSuccess else {
+            throw NSError(
+                domain: NSOSStatusErrorDomain,
+                code: Int(status),
+                userInfo: [NSLocalizedDescriptionKey: "Keychain read failed: \(status)"]
+            )
+        }
+
+        guard let data = item as? Data else {
+            return nil
+        }
+
+        return String(data: data, encoding: .utf8)
+    }
+
+    private func saveUuid(_ id: String, scope: String) throws {
+        let data = Data(id.utf8)
+        let query = baseQuery(scope: scope)
+        let update: [String: Any] = [
+            kSecValueData as String: data,
+            kSecAttrAccessible as String: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly
+        ]
+
+        let updateStatus = SecItemUpdate(query as CFDictionary, update as CFDictionary)
+        if updateStatus == errSecSuccess {
+            return
+        }
+
+        guard updateStatus == errSecItemNotFound else {
+            throw NSError(
+                domain: NSOSStatusErrorDomain,
+                code: Int(updateStatus),
+                userInfo: [NSLocalizedDescriptionKey: "Keychain update failed: \(updateStatus)"]
+            )
+        }
+
+        var attributes = query
+        attributes[kSecValueData as String] = data
+        attributes[kSecAttrAccessible as String] = kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly
+
+        let addStatus = SecItemAdd(attributes as CFDictionary, nil)
+        guard addStatus == errSecSuccess else {
+            throw NSError(
+                domain: NSOSStatusErrorDomain,
+                code: Int(addStatus),
+                userInfo: [NSLocalizedDescriptionKey: "Keychain save failed: \(addStatus)"]
+            )
+        }
+    }
+}

package/ios/Sources/PersistentUuidPlugin/PersistentUuidPlugin.swift

@@ -0,0 +1,37 @@
+import Foundation
+import Capacitor
+
+@objc(PersistentUuidPlugin)
+public class PersistentUuidPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "PersistentUuidPlugin"
+    public let jsName = "PersistentUuid"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "getId", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "resetId", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise)
+    ]
+
+    private let implementation = PersistentUuid()
+
+    @objc func getId(_ call: CAPPluginCall) {
+        do {
+            call.resolve(try implementation.getId(call.getString("scope")))
+        } catch {
+            call.reject("Failed to get persistent UUID: \(error.localizedDescription)")
+        }
+    }
+
+    @objc func resetId(_ call: CAPPluginCall) {
+        do {
+            call.resolve(try implementation.resetId(call.getString("scope")))
+        } catch {
+            call.reject("Failed to reset persistent UUID: \(error.localizedDescription)")
+        }
+    }
+
+    @objc func getPluginVersion(_ call: CAPPluginCall) {
+        call.resolve([
+            "version": implementation.getPluginVersion()
+        ])
+    }
+}

package/ios/Tests/PersistentUuidPluginTests/PersistentUuidTests.swift

@@ -0,0 +1,20 @@
+import XCTest
+@testable import PersistentUuidPlugin
+
+class PersistentUuidTests: XCTestCase {
+    func testGetPluginVersion() {
+        let implementation = PersistentUuid()
+        let result = implementation.getPluginVersion()
+
+        XCTAssertEqual("8.0.0", result)
+    }
+
+    func testResetIdCreatesUuid() throws {
+        let implementation = PersistentUuid()
+        let result = try implementation.resetId("test")
+
+        XCTAssertNotNil(result["id"] as? String)
+        XCTAssertEqual("test", result["scope"] as? String)
+        XCTAssertEqual(true, result["created"] as? Bool)
+    }
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@capgo/capacitor-persistent-uuid",
+  "version": "8.1.0",
+  "description": "Capacitor plugin for a persistent app UUID that survives reinstalls and updates.",
+  "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/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapgoCapacitorPersistentUuid.podspec"
+  ],
+  "author": "Martin Donadieu <martin@capgo.app>",
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cap-go/capacitor-persistent-uuid.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Cap-go/capacitor-persistent-uuid/issues"
+  },
+  "homepage": "https://capgo.app/docs/plugins/persistent-uuid/",
+  "keywords": [
+    "capacitor",
+    "uuid",
+    "persistent",
+    "identifier",
+    "device"
+  ],
+  "scripts": {
+    "verify": "bun run verify:ios && bun run verify:android && bun run verify:web",
+    "verify:ios": "xcodebuild -scheme CapgoCapacitorPersistentUuid -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "bun run build",
+    "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 \"**/*.ts\"",
+    "prettier": "prettier-pretty-check \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api PersistentUuidPlugin --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"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.3.4",
+    "@capacitor/cli": "^8.3.4",
+    "@capacitor/core": "^8.3.4",
+    "@capacitor/docgen": "^0.3.1",
+    "@capacitor/ios": "^8.3.4",
+    "@eslint/js": "^10.0.1",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "@types/node": "^25.9.1",
+    "eslint": "^10.4.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "husky": "^9.1.7",
+    "prettier": "^3.8.3",
+    "prettier-plugin-java": "^2.9.2",
+    "prettier-pretty-check": "^0.2.0",
+    "rimraf": "^6.1.3",
+    "rollup": "^4.60.4",
+    "swiftlint": "^2.0.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.4"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}