@capgo/capacitor-file-sharer 8.1.0

package/dist/plugin.js

@@ -0,0 +1,110 @@
+var capacitorFileSharer = (function (exports, core) {
+    'use strict';
+
+    const FileSharer = core.registerPlugin('FileSharer', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.FileSharerWeb()),
+    });
+
+    const DEFAULT_CONTENT_TYPE = 'application/octet-stream';
+    const ERR_PARAM_NO_FILENAME = 'ERR_PARAM_NO_FILENAME';
+    const ERR_PARAM_NO_DATA = 'ERR_PARAM_NO_DATA';
+    const ERR_PARAM_DATA_INVALID = 'ERR_PARAM_DATA_INVALID';
+    const ERR_LOCAL_FILE_NOT_FOUND = 'ERR_LOCAL_FILE_NOT_FOUND';
+    const BASE64_CHUNK_LENGTH = 256 * 1024;
+    class FileSharerWeb extends core.WebPlugin {
+        async share(options) {
+            await this.download(options);
+        }
+        async save(options) {
+            await this.download(options);
+            return {};
+        }
+        async getPluginVersion() {
+            return {
+                version: '8.0.0',
+            };
+        }
+        async download(options) {
+            this.validateOptions(options);
+            const blob = await this.createBlob(options);
+            const objectUrl = URL.createObjectURL(blob);
+            const anchor = document.createElement('a');
+            anchor.href = objectUrl;
+            anchor.download = options.filename;
+            anchor.rel = 'noopener';
+            anchor.style.display = 'none';
+            document.body.appendChild(anchor);
+            anchor.click();
+            anchor.remove();
+            window.setTimeout(() => URL.revokeObjectURL(objectUrl), 0);
+        }
+        validateOptions(options) {
+            var _a, _b, _c;
+            if (!((_a = options.filename) === null || _a === void 0 ? void 0 : _a.trim())) {
+                throw new Error(ERR_PARAM_NO_FILENAME);
+            }
+            if (!((_b = options.base64Data) === null || _b === void 0 ? void 0 : _b.trim()) && !((_c = options.path) === null || _c === void 0 ? void 0 : _c.trim())) {
+                throw new Error(ERR_PARAM_NO_DATA);
+            }
+        }
+        async createBlob(options) {
+            var _a;
+            const contentType = options.contentType || DEFAULT_CONTENT_TYPE;
+            if ((_a = options.base64Data) === null || _a === void 0 ? void 0 : _a.trim()) {
+                return new Blob(decodeBase64ToBlobParts(options.base64Data), {
+                    type: contentType,
+                });
+            }
+            try {
+                const response = await fetch(options.path);
+                if (!response.ok) {
+                    throw new Error(ERR_LOCAL_FILE_NOT_FOUND);
+                }
+                const blob = await response.blob();
+                return blob.type === contentType ? blob : new Blob([blob], { type: contentType });
+            }
+            catch (_b) {
+                throw new Error(ERR_LOCAL_FILE_NOT_FOUND);
+            }
+        }
+    }
+    function decodeBase64ToBlobParts(base64Data) {
+        const payload = getBase64Payload(base64Data);
+        const chunkLength = Math.max(4, Math.floor(BASE64_CHUNK_LENGTH / 4) * 4);
+        const parts = [];
+        try {
+            for (let offset = 0; offset < payload.length; offset += chunkLength) {
+                const byteCharacters = atob(payload.slice(offset, offset + chunkLength));
+                const buffer = new ArrayBuffer(byteCharacters.length);
+                const bytes = new Uint8Array(buffer);
+                for (let index = 0; index < byteCharacters.length; index++) {
+                    bytes[index] = byteCharacters.charCodeAt(index);
+                }
+                parts.push(buffer);
+            }
+        }
+        catch (_a) {
+            throw new Error(ERR_PARAM_DATA_INVALID);
+        }
+        return parts;
+    }
+    function getBase64Payload(base64Data) {
+        const trimmed = base64Data.trim();
+        const commaIndex = trimmed.indexOf(',');
+        if (commaIndex > -1 && trimmed.slice(0, commaIndex).toLowerCase().includes('base64')) {
+            return trimmed.slice(commaIndex + 1).replace(/\s/g, '');
+        }
+        return trimmed.replace(/\s/g, '');
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        FileSharerWeb: FileSharerWeb
+    });
+
+    exports.FileSharer = FileSharer;
+
+    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 FileSharer = registerPlugin('FileSharer', {\n    web: () => import('./web').then((m) => new m.FileSharerWeb()),\n});\nexport * from './definitions';\nexport { FileSharer };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nconst DEFAULT_CONTENT_TYPE = 'application/octet-stream';\nconst ERR_PARAM_NO_FILENAME = 'ERR_PARAM_NO_FILENAME';\nconst ERR_PARAM_NO_DATA = 'ERR_PARAM_NO_DATA';\nconst ERR_PARAM_DATA_INVALID = 'ERR_PARAM_DATA_INVALID';\nconst ERR_LOCAL_FILE_NOT_FOUND = 'ERR_LOCAL_FILE_NOT_FOUND';\nconst BASE64_CHUNK_LENGTH = 256 * 1024;\nexport class FileSharerWeb extends WebPlugin {\n    async share(options) {\n        await this.download(options);\n    }\n    async save(options) {\n        await this.download(options);\n        return {};\n    }\n    async getPluginVersion() {\n        return {\n            version: '8.0.0',\n        };\n    }\n    async download(options) {\n        this.validateOptions(options);\n        const blob = await this.createBlob(options);\n        const objectUrl = URL.createObjectURL(blob);\n        const anchor = document.createElement('a');\n        anchor.href = objectUrl;\n        anchor.download = options.filename;\n        anchor.rel = 'noopener';\n        anchor.style.display = 'none';\n        document.body.appendChild(anchor);\n        anchor.click();\n        anchor.remove();\n        window.setTimeout(() => URL.revokeObjectURL(objectUrl), 0);\n    }\n    validateOptions(options) {\n        var _a, _b, _c;\n        if (!((_a = options.filename) === null || _a === void 0 ? void 0 : _a.trim())) {\n            throw new Error(ERR_PARAM_NO_FILENAME);\n        }\n        if (!((_b = options.base64Data) === null || _b === void 0 ? void 0 : _b.trim()) && !((_c = options.path) === null || _c === void 0 ? void 0 : _c.trim())) {\n            throw new Error(ERR_PARAM_NO_DATA);\n        }\n    }\n    async createBlob(options) {\n        var _a;\n        const contentType = options.contentType || DEFAULT_CONTENT_TYPE;\n        if ((_a = options.base64Data) === null || _a === void 0 ? void 0 : _a.trim()) {\n            return new Blob(decodeBase64ToBlobParts(options.base64Data), {\n                type: contentType,\n            });\n        }\n        try {\n            const response = await fetch(options.path);\n            if (!response.ok) {\n                throw new Error(ERR_LOCAL_FILE_NOT_FOUND);\n            }\n            const blob = await response.blob();\n            return blob.type === contentType ? blob : new Blob([blob], { type: contentType });\n        }\n        catch (_b) {\n            throw new Error(ERR_LOCAL_FILE_NOT_FOUND);\n        }\n    }\n}\nfunction decodeBase64ToBlobParts(base64Data) {\n    const payload = getBase64Payload(base64Data);\n    const chunkLength = Math.max(4, Math.floor(BASE64_CHUNK_LENGTH / 4) * 4);\n    const parts = [];\n    try {\n        for (let offset = 0; offset < payload.length; offset += chunkLength) {\n            const byteCharacters = atob(payload.slice(offset, offset + chunkLength));\n            const buffer = new ArrayBuffer(byteCharacters.length);\n            const bytes = new Uint8Array(buffer);\n            for (let index = 0; index < byteCharacters.length; index++) {\n                bytes[index] = byteCharacters.charCodeAt(index);\n            }\n            parts.push(buffer);\n        }\n    }\n    catch (_a) {\n        throw new Error(ERR_PARAM_DATA_INVALID);\n    }\n    return parts;\n}\nfunction getBase64Payload(base64Data) {\n    const trimmed = base64Data.trim();\n    const commaIndex = trimmed.indexOf(',');\n    if (commaIndex > -1 && trimmed.slice(0, commaIndex).toLowerCase().includes('base64')) {\n        return trimmed.slice(commaIndex + 1).replace(/\\s/g, '');\n    }\n    return trimmed.replace(/\\s/g, '');\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/ios/Sources/FileSharerPlugin/FileSharer.swift

@@ -0,0 +1,51 @@
+import Foundation
+
+@objc public class FileSharer: NSObject {
+    @objc public func getPluginVersion() -> String {
+        return "8.0.0"
+    }
+
+    public func safeFilename(_ filename: String) -> String? {
+        let trimmed = filename.trimmingCharacters(in: .whitespacesAndNewlines)
+        let lastPathComponent = URL(fileURLWithPath: trimmed).lastPathComponent
+        return lastPathComponent.isEmpty ? nil : lastPathComponent
+    }
+
+    public func temporaryFileUrl(filename: String) -> URL {
+        return FileManager.default.temporaryDirectory.appendingPathComponent(filename)
+    }
+
+    public func decodedBase64Data(from base64Data: String) -> Data? {
+        let trimmed = base64Data.trimmingCharacters(in: .whitespacesAndNewlines)
+        let payload: String
+
+        if let commaIndex = trimmed.firstIndex(of: ","),
+           trimmed[..<commaIndex].lowercased().contains("base64") {
+            payload = String(trimmed[trimmed.index(after: commaIndex)...])
+        } else {
+            payload = trimmed
+        }
+
+        return Data(base64Encoded: payload, options: .ignoreUnknownCharacters)
+    }
+
+    public func fileUrl(from path: String) -> URL? {
+        let trimmed = path.trimmingCharacters(in: .whitespacesAndNewlines)
+
+        if let capacitorRange = trimmed.range(of: "_capacitor_file_") {
+            let rawPath = String(trimmed[capacitorRange.upperBound...])
+            let decodedPath = rawPath.removingPercentEncoding ?? rawPath
+            return URL(fileURLWithPath: decodedPath)
+        }
+
+        if let url = URL(string: trimmed), url.isFileURL {
+            return url
+        }
+
+        if trimmed.hasPrefix("/") {
+            return URL(fileURLWithPath: trimmed)
+        }
+
+        return nil
+    }
+}

package/ios/Sources/FileSharerPlugin/FileSharerPlugin.swift

@@ -0,0 +1,140 @@
+import Foundation
+import Capacitor
+import UIKit
+
+@objc(FileSharerPlugin)
+public class FileSharerPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "FileSharerPlugin"
+    public let jsName = "FileSharer"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "share", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "save", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise)
+    ]
+
+    private let implementation = FileSharer()
+
+    @objc func share(_ call: CAPPluginCall) {
+        presentShareSheet(call, resolveWithUri: false)
+    }
+
+    @objc func save(_ call: CAPPluginCall) {
+        presentShareSheet(call, resolveWithUri: true)
+    }
+
+    @objc func getPluginVersion(_ call: CAPPluginCall) {
+        call.resolve([
+            "version": implementation.getPluginVersion()
+        ])
+    }
+
+    private func presentShareSheet(_ call: CAPPluginCall, resolveWithUri: Bool) {
+        let fileUrl: URL
+
+        do {
+            fileUrl = try prepareFile(call)
+        } catch let error as FileSharerError {
+            call.reject(error.rawValue)
+            return
+        } catch {
+            call.reject(FileSharerError.fileCachingFailed.rawValue, error.localizedDescription)
+            return
+        }
+
+        DispatchQueue.main.async {
+            guard let viewController = self.bridge?.viewController else {
+                call.reject(FileSharerError.noViewController.rawValue)
+                return
+            }
+
+            var activityItems: [Any] = [fileUrl]
+            if let text = call.getString("text"), !text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+                activityItems.append(text)
+            }
+
+            let activityViewController = UIActivityViewController(activityItems: activityItems, applicationActivities: nil)
+            if let subject = call.getString("subject") ?? call.getString("title") {
+                activityViewController.setValue(subject, forKey: "subject")
+            }
+
+            if let sourceView = viewController.view {
+                activityViewController.popoverPresentationController?.sourceView = sourceView
+                activityViewController.popoverPresentationController?.sourceRect = CGRect(
+                    x: sourceView.bounds.midX,
+                    y: sourceView.bounds.maxY,
+                    width: 0,
+                    height: 0
+                )
+            }
+
+            activityViewController.completionWithItemsHandler = { _, completed, _, error in
+                if let error = error {
+                    call.reject(FileSharerError.shareFailed.rawValue, error.localizedDescription)
+                    return
+                }
+
+                if completed {
+                    if resolveWithUri {
+                        call.resolve(["uri": fileUrl.absoluteString])
+                    } else {
+                        call.resolve()
+                    }
+                } else {
+                    call.reject(FileSharerError.userCancelled.rawValue)
+                }
+            }
+
+            viewController.present(activityViewController, animated: true)
+        }
+    }
+
+    private func prepareFile(_ call: CAPPluginCall) throws -> URL {
+        guard let requestedFilename = call.getString("filename"),
+              let filename = implementation.safeFilename(requestedFilename) else {
+            throw FileSharerError.noFilename
+        }
+
+        let temporaryUrl = implementation.temporaryFileUrl(filename: filename)
+        try? FileManager.default.removeItem(at: temporaryUrl)
+
+        if let base64Data = call.getString("base64Data"), !base64Data.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+            guard let data = implementation.decodedBase64Data(from: base64Data) else {
+                throw FileSharerError.invalidData
+            }
+
+            try data.write(to: temporaryUrl, options: .atomic)
+            return temporaryUrl
+        }
+
+        if let path = call.getString("path"), !path.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+            guard let sourceUrl = implementation.fileUrl(from: path) else {
+                throw FileSharerError.fileNotFound
+            }
+
+            let standardizedSourceUrl = sourceUrl.standardizedFileURL
+            if standardizedSourceUrl == temporaryUrl.standardizedFileURL {
+                return standardizedSourceUrl
+            }
+
+            guard FileManager.default.fileExists(atPath: standardizedSourceUrl.path) else {
+                throw FileSharerError.fileNotFound
+            }
+
+            try FileManager.default.copyItem(at: standardizedSourceUrl, to: temporaryUrl)
+            return temporaryUrl
+        }
+
+        throw FileSharerError.noData
+    }
+}
+
+private enum FileSharerError: String, Error {
+    case noFilename = "ERR_PARAM_NO_FILENAME"
+    case noData = "ERR_PARAM_NO_DATA"
+    case invalidData = "ERR_PARAM_DATA_INVALID"
+    case fileCachingFailed = "ERR_FILE_CACHING_FAILED"
+    case fileNotFound = "ERR_LOCAL_FILE_NOT_FOUND"
+    case noViewController = "ERR_NO_VIEW_CONTROLLER"
+    case shareFailed = "ERR_SHARE_FAILED"
+    case userCancelled = "USER_CANCELLED"
+}

package/ios/Tests/FileSharerPluginTests/FileSharerTests.swift

@@ -0,0 +1,24 @@
+import XCTest
+@testable import FileSharerPlugin
+
+class FileSharerTests: XCTestCase {
+    func testSafeFilenameUsesLastPathComponent() {
+        let implementation = FileSharer()
+
+        XCTAssertEqual("report.pdf", implementation.safeFilename("../exports/report.pdf"))
+    }
+
+    func testDecodesDataUrlBase64() {
+        let implementation = FileSharer()
+        let data = implementation.decodedBase64Data(from: "data:text/plain;base64,SGVsbG8=")
+
+        XCTAssertEqual(String(data: data ?? Data(), encoding: .utf8), "Hello")
+    }
+
+    func testGetPluginVersion() {
+        let implementation = FileSharer()
+        let result = implementation.getPluginVersion()
+
+        XCTAssertEqual("8.0.0", result)
+    }
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@capgo/capacitor-file-sharer",
+  "version": "8.1.0",
+  "description": "Capacitor plugin for sharing and saving files on Android, iOS, and 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/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapgoCapacitorFileSharer.podspec"
+  ],
+  "author": "Cap-go <contact@capgo.app>",
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cap-go/capacitor-file-sharer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Cap-go/capacitor-file-sharer/issues"
+  },
+  "homepage": "https://capgo.app/docs/plugins/file-sharer/",
+  "keywords": [
+    "capacitor",
+    "capacitor-plugin",
+    "file-sharing",
+    "share",
+    "files"
+  ],
+  "scripts": {
+    "verify": "bun run verify:ios && bun run verify:android && bun run verify:web",
+    "verify:ios": "xcodebuild -scheme CapgoCapacitorFileSharer -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 . --ext .ts",
+    "prettier": "prettier-pretty-check \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api FileSharerPlugin --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.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-pretty-check": "^0.2.0",
+    "prettier-plugin-java": "^2.7.7",
+    "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"
+    }
+  }
+}