@cap-kit/ssl-pinning 8.0.1 → 8.0.3

package/android/build.gradle

@@ -5,7 +5,7 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.13.0'
+        classpath 'com.android.tools.build:gradle:8.13.2'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
@@ -81,9 +81,6 @@ android {
         sourceCompatibility = JavaVersion.VERSION_21
         targetCompatibility = JavaVersion.VERSION_21
     }
-    kotlinOptions {
-        jvmTarget = JavaVersion.VERSION_21
-    }
 }
 
 repositories {

package/android/src/main/java/io/capkit/sslpinning/SSLPinningConfig.kt

@@ -15,7 +15,9 @@ import com.getcapacitor.Plugin
  * - Treated as immutable runtime input
  * - Accessible only from native code
  */
-class SSLPinningConfig(plugin: Plugin) {
+class SSLPinningConfig(
+  plugin: Plugin,
+) {
   /**
    * Android application context.
    * Exposed for native components that may require it.
@@ -58,7 +60,8 @@ class SSLPinningConfig(plugin: Plugin) {
 
     // Multiple fingerprints (optional)
     fingerprints =
-      config.getArray("fingerprints")
+      config
+        .getArray("fingerprints")
         ?.toList()
         ?.mapNotNull { it as? String }
         ?.filter { it.isNotBlank() }

package/android/src/main/java/io/capkit/sslpinning/SSLPinningError.kt

@@ -16,25 +16,29 @@ sealed class SSLPinningError(
    * Feature or capability is not available
    * due to device or configuration limitations.
    */
-  class Unavailable(message: String) :
-    SSLPinningError(message)
+  class Unavailable(
+    message: String,
+  ) : SSLPinningError(message)
 
   /**
    * Required permission was denied or not granted.
    */
-  class PermissionDenied(message: String) :
-    SSLPinningError(message)
+  class PermissionDenied(
+    message: String,
+  ) : SSLPinningError(message)
 
   /**
    * Plugin failed to initialize or perform
    * a required operation.
    */
-  class InitFailed(message: String) :
-    SSLPinningError(message)
+  class InitFailed(
+    message: String,
+  ) : SSLPinningError(message)
 
   /**
    * Invalid or unsupported input was provided.
    */
-  class UnknownType(message: String) :
-    SSLPinningError(message)
+  class UnknownType(
+    message: String,
+  ) : SSLPinningError(message)
 }

package/android/src/main/java/io/capkit/sslpinning/utils/SSLPinningUtils.kt

@@ -19,14 +19,13 @@ object SSLPinningUtils {
    * Non-HTTPS URLs are explicitly rejected
    * to prevent insecure usage.
    */
-  fun httpsUrl(value: String): URL? {
-    return try {
+  fun httpsUrl(value: String): URL? =
+    try {
       val url = URL(value)
       if (url.protocol == "https") url else null
     } catch (_: Exception) {
       null
     }
-  }
 
   /**
    * Normalizes a fingerprint string by:
@@ -36,11 +35,10 @@ object SSLPinningUtils {
    * Example:
    * "AA:BB:CC" → "aabbcc"
    */
-  fun normalizeFingerprint(value: String): String {
-    return value
+  fun normalizeFingerprint(value: String): String =
+    value
       .replace(":", "")
       .lowercase()
-  }
 
   /**
    * Computes the SHA-256 fingerprint of an X.509 certificate.
@@ -50,7 +48,8 @@ object SSLPinningUtils {
    */
   fun sha256Fingerprint(cert: Certificate): String {
     val digest =
-      MessageDigest.getInstance("SHA-256")
+      MessageDigest
+        .getInstance("SHA-256")
         .digest(cert.encoded)
 
     return digest.joinToString(separator = ":") {

package/dist/{plugin.cjs.js → plugin.cjs}

@@ -98,4 +98,4 @@ var web = /*#__PURE__*/Object.freeze({
 });
 
 exports.SSLPinning = SSLPinning;
-//# sourceMappingURL=plugin.cjs.js.map
+//# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n// -----------------------------------------------------------------------------\n// Enums\n// -----------------------------------------------------------------------------\n/**\n * Standardized error codes for programmatic handling of SSL pinning failures.\n *\n * Errors are delivered via Promise rejection as `CapacitorException`\n * with one of the following codes.\n *\n * @since 0.0.15\n */\nexport var SSLPinningErrorCode;\n(function (SSLPinningErrorCode) {\n    /** Required data is missing or the feature is not available. */\n    SSLPinningErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user denied a required permission or the feature is disabled. */\n    SSLPinningErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The SSL pinning operation failed due to a runtime or initialization error. */\n    SSLPinningErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** Invalid or unsupported input was provided. */\n    SSLPinningErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n})(SSLPinningErrorCode || (SSLPinningErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","/**\n * Import the `registerPlugin` method from the Capacitor core library.\n * This method is used to register a custom plugin.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * The SSLPinning plugin instance.\n * It automatically lazy-loads the web implementation if running in a browser environment.\n * Use this instance to access all ssl pinning functionality.\n */\nconst SSLPinning = registerPlugin('SSLPinning', {\n    web: () => import('./web').then((m) => new m.SSLPinningWeb()),\n});\nexport * from './definitions';\nexport { SSLPinning };\n//# sourceMappingURL=index.js.map","/**\n * This module provides a web implementation of the SSLPinningPlugin.\n * The functionality is limited in a web context due to the lack of SSL certificate inspection capabilities in browsers.\n *\n * The implementation adheres to the SSLPinningPlugin interface but provides fallback behavior\n * because browsers do not allow direct inspection of SSL certificate details.\n */\nimport { CapacitorException, ExceptionCode, WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the SSLPinning plugin.\n *\n * SSL certificate inspection is not supported in browsers,\n * therefore all SSL pinning methods are unimplemented.\n */\nexport class SSLPinningWeb extends WebPlugin {\n    /**\n     * Checks a single SSL certificate against the expected fingerprint.\n     * @return A promise that resolves to the result of the certificate check.\n     * @throws CapacitorException indicating unimplemented functionality.\n     */\n    async checkCertificate() {\n        throw this.createUnimplementedError();\n    }\n    /**\n     * Checks multiple SSL certificates against their expected fingerprints.\n     * @return A promise that resolves to an array of results for each certificate check.\n     * @throws CapacitorException indicating unimplemented functionality.\n     */\n    async checkCertificates() {\n        throw this.createUnimplementedError();\n    }\n    // --- Plugin Info ---\n    /**\n     * Returns the plugin version.\n     *\n     * On the Web, this value represents the JavaScript package version\n     * rather than a native implementation.\n     */\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n    /**\n     * Creates a standardized exception for unimplemented methods.\n     *\n     * This utility method centralizes the creation of exceptions for functionality that is not supported\n     * on the current platform, ensuring consistency in error reporting.\n     *\n     * @returns {CapacitorException} An exception with the code `Unimplemented` and a descriptive message.\n     */\n    createUnimplementedError() {\n        return new CapacitorException('This plugin method is not implemented on this platform.', ExceptionCode.Unimplemented);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["SSLPinningErrorCode","registerPlugin","WebPlugin","CapacitorException","ExceptionCode"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACWA;AACX,CAAC,UAAU,mBAAmB,EAAE;AAChC;AACA,IAAI,mBAAmB,CAAC,aAAa,CAAC,GAAG,aAAa;AACtD;AACA,IAAI,mBAAmB,CAAC,mBAAmB,CAAC,GAAG,mBAAmB;AAClE;AACA,IAAI,mBAAmB,CAAC,aAAa,CAAC,GAAG,aAAa;AACtD;AACA,IAAI,mBAAmB,CAAC,cAAc,CAAC,GAAG,cAAc;AACxD,CAAC,EAAEA,2BAAmB,KAAKA,2BAAmB,GAAG,EAAE,CAAC,CAAC;;ACtBrD;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACK,MAAC,UAAU,GAAGC,mBAAc,CAAC,YAAY,EAAE;AAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AACjE,CAAC;;ACZD;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,aAAa,SAASC,cAAS,CAAC;AAC7C;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,MAAM,IAAI,CAAC,wBAAwB,EAAE;AAC7C,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,iBAAiB,GAAG;AAC9B,QAAQ,MAAM,IAAI,CAAC,wBAAwB,EAAE;AAC7C,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,wBAAwB,GAAG;AAC/B,QAAQ,OAAO,IAAIC,uBAAkB,CAAC,yDAAyD,EAAEC,kBAAa,CAAC,aAAa,CAAC;AAC7H,IAAI;AACJ;;;;;;;;;"}

package/ios/Sources/SSLPinningPlugin/Version.swift

@@ -10,7 +10,7 @@ import Foundation
 public enum PluginVersion {
     /**
       The semantic version string of the plugin.
-      Value synchronized from package.json: "8.0.1"
+      Value synchronized from package.json: "8.0.3"
      */
-    public static let number = "8.0.1"
+    public static let number = "8.0.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cap-kit/ssl-pinning",
-  "version": "8.0.1",
+  "version": "8.0.3",
   "description": "Capacitor plugin for runtime SSL certificate fingerprint pinning on iOS and Android",
   "type": "module",
   "private": false,
@@ -9,10 +9,18 @@
     "node": ">=24.0.0",
     "pnpm": ">=10.0.0"
   },
-  "main": "dist/plugin.cjs.js",
+  "main": "dist/plugin.cjs",
   "module": "dist/esm/index.js",
   "types": "dist/esm/index.d.ts",
   "unpkg": "dist/plugin.js",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/plugin.cjs"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "android/src/main/",
     "android/build.gradle",
@@ -22,16 +30,10 @@
     "Package.swift",
     "CapKitSSLPinning.podspec",
     "LICENSE",
+    "README.md",
     "bin/",
     "scripts/"
   ],
-  "exports": {
-    ".": {
-      "types": "./dist/esm/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/plugin.cjs.js"
-    }
-  },
   "author": "CapKit Team",
   "funding": {
     "type": "github",
@@ -106,7 +108,7 @@
   },
   "scripts": {
     "verify": "pnpm run verify:ios && pnpm run verify:android && pnpm run verify:web",
-    "verify:ios": "node ./scripts/sync-version.js && xcodebuild -scheme CapKitSslPinning -destination generic/platform=iOS",
+    "verify:ios": "node ./scripts/sync-version.mjs && xcodebuild -scheme CapKitSslPinning -destination generic/platform=iOS",
     "verify:android": "cd android && ./gradlew clean build && cd ..",
     "verify:web": "pnpm run build",
     "lint:android": "cd android && ./gradlew ktlintCheck",
@@ -118,7 +120,7 @@
     "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
     "swiftlint": "node-swiftlint lint ios/Sources",
     "docgen": "docgen --api SSLPinningPlugin --output-readme README.md --output-json dist/docs.json",
-    "build": "node ./scripts/sync-version.js && pnpm run clean && pnpm run docgen && tsc && rollup -c rollup.config.mjs && node scripts/chmod.js",
+    "build": "node ./scripts/sync-version.mjs && pnpm run clean && pnpm run docgen && tsc && rollup -c rollup.config.mjs && node scripts/chmod.mjs",
     "clean": "rimraf ./dist",
     "watch": "tsc --watch",
     "test": "pnpm run verify",

package/scripts/{sync-version.js → sync-version.mjs}

@@ -13,6 +13,12 @@ const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
 // 3. Automatically find the iOS source directory
 // Capacitor standard structure: ios/Sources/<PluginName>
 const sourcesDir = path.join(__dirname, '../ios/Sources');
+
+if (!fs.existsSync(sourcesDir)) {
+  console.warn('⚠️  [CapKit] ios/Sources directory not found. Skipping Version.swift generation.');
+  process.exit(0);
+}
+
 const pluginFolderName = fs.readdirSync(sourcesDir).find((f) => fs.statSync(path.join(sourcesDir, f)).isDirectory());
 
 if (!pluginFolderName) {

package/dist/plugin.cjs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n// -----------------------------------------------------------------------------\n// Enums\n// -----------------------------------------------------------------------------\n/**\n * Standardized error codes for programmatic handling of SSL pinning failures.\n *\n * Errors are delivered via Promise rejection as `CapacitorException`\n * with one of the following codes.\n *\n * @since 0.0.15\n */\nexport var SSLPinningErrorCode;\n(function (SSLPinningErrorCode) {\n    /** Required data is missing or the feature is not available. */\n    SSLPinningErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user denied a required permission or the feature is disabled. */\n    SSLPinningErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The SSL pinning operation failed due to a runtime or initialization error. */\n    SSLPinningErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** Invalid or unsupported input was provided. */\n    SSLPinningErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n})(SSLPinningErrorCode || (SSLPinningErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","/**\n * Import the `registerPlugin` method from the Capacitor core library.\n * This method is used to register a custom plugin.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * The SSLPinning plugin instance.\n * It automatically lazy-loads the web implementation if running in a browser environment.\n * Use this instance to access all ssl pinning functionality.\n */\nconst SSLPinning = registerPlugin('SSLPinning', {\n    web: () => import('./web').then((m) => new m.SSLPinningWeb()),\n});\nexport * from './definitions';\nexport { SSLPinning };\n//# sourceMappingURL=index.js.map","/**\n * This module provides a web implementation of the SSLPinningPlugin.\n * The functionality is limited in a web context due to the lack of SSL certificate inspection capabilities in browsers.\n *\n * The implementation adheres to the SSLPinningPlugin interface but provides fallback behavior\n * because browsers do not allow direct inspection of SSL certificate details.\n */\nimport { CapacitorException, ExceptionCode, WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the SSLPinning plugin.\n *\n * SSL certificate inspection is not supported in browsers,\n * therefore all SSL pinning methods are unimplemented.\n */\nexport class SSLPinningWeb extends WebPlugin {\n    /**\n     * Checks a single SSL certificate against the expected fingerprint.\n     * @return A promise that resolves to the result of the certificate check.\n     * @throws CapacitorException indicating unimplemented functionality.\n     */\n    async checkCertificate() {\n        throw this.createUnimplementedError();\n    }\n    /**\n     * Checks multiple SSL certificates against their expected fingerprints.\n     * @return A promise that resolves to an array of results for each certificate check.\n     * @throws CapacitorException indicating unimplemented functionality.\n     */\n    async checkCertificates() {\n        throw this.createUnimplementedError();\n    }\n    // --- Plugin Info ---\n    /**\n     * Returns the plugin version.\n     *\n     * On the Web, this value represents the JavaScript package version\n     * rather than a native implementation.\n     */\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n    /**\n     * Creates a standardized exception for unimplemented methods.\n     *\n     * This utility method centralizes the creation of exceptions for functionality that is not supported\n     * on the current platform, ensuring consistency in error reporting.\n     *\n     * @returns {CapacitorException} An exception with the code `Unimplemented` and a descriptive message.\n     */\n    createUnimplementedError() {\n        return new CapacitorException('This plugin method is not implemented on this platform.', ExceptionCode.Unimplemented);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["SSLPinningErrorCode","registerPlugin","WebPlugin","CapacitorException","ExceptionCode"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACWA;AACX,CAAC,UAAU,mBAAmB,EAAE;AAChC;AACA,IAAI,mBAAmB,CAAC,aAAa,CAAC,GAAG,aAAa;AACtD;AACA,IAAI,mBAAmB,CAAC,mBAAmB,CAAC,GAAG,mBAAmB;AAClE;AACA,IAAI,mBAAmB,CAAC,aAAa,CAAC,GAAG,aAAa;AACtD;AACA,IAAI,mBAAmB,CAAC,cAAc,CAAC,GAAG,cAAc;AACxD,CAAC,EAAEA,2BAAmB,KAAKA,2BAAmB,GAAG,EAAE,CAAC,CAAC;;ACtBrD;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACK,MAAC,UAAU,GAAGC,mBAAc,CAAC,YAAY,EAAE;AAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AACjE,CAAC;;ACZD;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,aAAa,SAASC,cAAS,CAAC;AAC7C;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,MAAM,IAAI,CAAC,wBAAwB,EAAE;AAC7C,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,iBAAiB,GAAG;AAC9B,QAAQ,MAAM,IAAI,CAAC,wBAAwB,EAAE;AAC7C,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,wBAAwB,GAAG;AAC/B,QAAQ,OAAO,IAAIC,uBAAkB,CAAC,yDAAyD,EAAEC,kBAAa,CAAC,aAAa,CAAC;AAC7H,IAAI;AACJ;;;;;;;;;"}