@cap-kit/ssl-pinning 8.0.0-next.0

package/dist/esm/definitions.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Extension of the Capacitor CLI configuration to include specific settings for People.
+ * This allows users to configure the plugin via capacitor.config.ts or capacitor.config.json.
+ */
+declare module '@capacitor/cli' {
+    interface PluginsConfig {
+        /**
+         * Configuration options for the SSLPinning plugin.
+         */
+        SSLPinning?: SSLPinningConfig;
+    }
+}
+/**
+ * Standardized error codes for programmatic handling of ssl pinning failures.
+ * @since 0.0.15
+ */
+export declare enum SSLPinningErrorCode {
+    /** The device does not have the requested hardware. */
+    UNAVAILABLE = "UNAVAILABLE",
+    /** The user denied the permission or the feature is disabled in settings. */
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    /** The ssl pinning failed to initialize (e.g., runtime error or Looper failure). */
+    INIT_FAILED = "INIT_FAILED",
+    /** The requested ssl pinning type is not valid or not supported by the plugin. */
+    UNKNOWN_TYPE = "UNKNOWN_TYPE"
+}
+/**
+ * Configuration options for initializing the People plugin.
+ * These values can be set in capacitor.config.ts.
+ */
+export interface SSLPinningConfig {
+    /**
+     * Enables detailed logging in the native console (Logcat/Xcode).
+     * Useful for debugging sensor data flow and lifecycle events.
+     * @example true
+     * @default false
+     *
+     * @since 0.0.15
+     */
+    verboseLogging?: boolean;
+    /**
+     * Default fingerprint used by checkCertificate()
+     * if no arguments are provided.
+     * @example "50:4B:A1:B5:48:96:71:F3:9F:87:7E:0A:09:FD:3E:1B:C0:4F:AA:9F:FC:83:3E:A9:3A:00:78:88:F8:BA:60:26"
+     * @default undefined
+     *
+     * @since 0.0.14
+     */
+    fingerprint?: string;
+    /**
+     * Default fingerprints used by checkCertificates()
+     * if no arguments are provided.
+     * @example ["50:4B:A1:B5:48:96:71:F3:9F:87:7E:0A:09:FD:3E:1B:C0:4F:AA:9F:FC:83:3E:A9:3A:00:78:88:F8:BA:60:26"]
+     * @default undefined
+     *
+     * @since 0.0.15
+     */
+    fingerprints?: string[];
+}
+/**
+ * Options for checking a single SSL certificate.
+ */
+export interface SSLPinningOptions {
+    /**
+     * The URL of the server whose SSL certificate needs to be checked.
+     * @example "https://example.com"
+     */
+    url: string;
+    /**
+     * The expected fingerprint of the SSL certificate to validate against.
+     * This is typically a hash string such as SHA-256.
+     */
+    fingerprint: string;
+}
+/**
+ * Options for checking multiple SSL certificates.
+ */
+export interface SSLPinningMultiOptions {
+    /**
+     * The URL of the server whose SSL certificate needs to be checked.
+     * @example "https://example.com"
+     */
+    url: string;
+    /**
+     * The expected fingerprints of the SSL certificate to validate against.
+     * This is typically an array of hash strings such as SHA-256.
+     */
+    fingerprints: string[];
+}
+/**
+ * Result returned by the SSL certificate check.
+ *
+ * NOTE:
+ * On iOS (Swift Package Manager), errors are returned
+ * as part of the resolved result object rather than
+ * Promise rejections.
+ */
+export interface SSLPinningResult {
+    /**
+     * The subject of the certificate, representing the entity the certificate is issued to.
+     * @platform Android
+     * @example "CN=example.com, O=Example Corp, C=US"
+     */
+    subject?: string;
+    /**
+     * The issuer of the certificate, indicating the certificate authority that issued it.
+     * Results may vary slightly between iOS and Android platforms.
+     * @example "CN=Example CA, O=Example Corp, C=US"
+     */
+    issuer?: string;
+    /**
+     * The start date from which the certificate is valid.
+     * Format: ISO 8601 string or platform-specific date representation.
+     * @platform Android
+     * @example "2023-01-01T00:00:00Z"
+     */
+    validFrom?: string;
+    /**
+     * The end date until which the certificate is valid.
+     * Format: ISO 8601 string or platform-specific date representation.
+     * @platform Android
+     * @example "2024-01-01T00:00:00Z"
+     */
+    validTo?: string;
+    /**
+     * The fingerprint that is expected to match the certificate's actual fingerprint.
+     * This is typically provided in the SSLPinningOptions.
+     */
+    expectedFingerprint?: string;
+    /**
+     * The actual fingerprint of the SSL certificate retrieved from the server.
+     * @example "50:4B:A1:B5:48:96:71:F3:9F:87:7E:0A:09:FD:3E:1B:C0:4F:AA:9F:FC:83:3E:A9:3A:00:78:88:F8:BA:60:26"
+     */
+    actualFingerprint?: string;
+    /**
+     * Indicates whether the actual fingerprint matches the expected fingerprint.
+     * `true` if they match, `false` otherwise.
+     */
+    fingerprintMatched?: boolean;
+    /**
+     * A descriptive error message if an issue occurred during the SSL certificate check.
+     * @example "Unable to retrieve certificate from the server."
+     */
+    error?: string;
+}
+/**
+ * Result returned by the getPluginVersion method.
+ */
+export interface PluginVersionResult {
+    /** The native version string of the plugin. */
+    version: string;
+}
+/**
+ * Error object returned by ssl pinning operations.
+ * Includes the ssl pinning type and a descriptive message.
+ */
+export interface SSLPinningError {
+    /** A descriptive error message */
+    message: string;
+    /** Standardized error code */
+    code: SSLPinningErrorCode;
+}
+/**
+ * Result returned by the getPluginVersion method.
+ */
+export interface PluginVersionResult {
+    /** The native version string of the plugin. */
+    version: string;
+}
+/**
+ * Interface defining the structure of an SSL Certificate Checker Plugin.
+ *
+ * Implementations of this interface should provide the logic for checking
+ * the status and details of an SSL certificate based on the provided options.
+ */
+export interface SSLPinningPlugin {
+    /**
+     * Check the SSL certificate of a server.
+     *
+     * @param options - Options for checking the SSL certificate.
+     * @returns A promise resolving to the result of the SSL certificate check.
+     * @throws SSLPinningError if the check fails.
+     *
+     * @example
+     * ```typescript
+     * import { SSLPinning } from '@cap-kit/ssl-pinning';
+     *
+     * const result = await SSLPinning.checkCertificate({
+     *   url: 'https://example.com',
+     *   fingerprint: '50:4B:A1:B5:48:96:71:F3:9F:87:7E:0A:09:FD:3E:1B:C0:4F:AA:9F:FC:83:3E:A9:3A:00:78:88:F8:BA:60:26'
+     * });
+     *
+     * console.log('SSL Pinning Result:', result);
+     * ```
+     *
+     * @since 0.0.14
+     */
+    checkCertificate(): Promise<SSLPinningResult>;
+    /**
+     * Check the SSL certificate of a server.
+     * @param options - Options for checking the SSL certificate.
+     * @returns A promise resolving to the result of the SSL certificate check.
+     * @throws SSLPinningError if the check fails.
+     *
+     * @example
+     * ```typescript
+     * import { SSLPinning } from '@cap-kit/ssl-pinning';
+     *
+     * const result = await SSLPinning.checkCertificate({
+     *   url: 'https://example.com',
+     *   fingerprint: '50:4B:A1:B5:48:96:71:F3:9F:87:7E:0A:09:FD:3E:1B:C0:4F:AA:9F:FC:83:3E:A9:3A:00:78:88:F8:BA:60:26'
+     * });
+     *
+     * console.log('SSL Pinning Result:', result);
+     * ```
+     *
+     * @since 0.0.14
+     */
+    checkCertificate(options: SSLPinningOptions): Promise<SSLPinningResult>;
+    /**
+     * Check the SSL certificates of multiple servers.
+     *
+     * @returns A promise resolving to an array of results for each SSL certificate check.
+     * @throws SSLPinningError if any of the checks fail.
+     *
+     * @example
+     * ```typescript
+     * import { SSLPinning } from '@cap-kit/ssl-pinning';
+     *
+     * const results = await SSLPinning.checkCertificates();
+     *
+     * results.forEach(result => {
+     *   console.log('SSL Pinning Result:', result);
+     * });
+     * ```
+     *
+     * @since 0.0.15
+     */
+    checkCertificates(): Promise<SSLPinningResult[]>;
+    /**
+     * Check the SSL certificates of multiple servers.
+     * @returns A promise resolving to an array of results for each SSL certificate check.
+     * @throws SSLPinningError if any of the checks fail.
+     * @param options - Options for checking the SSL certificates.
+     *
+     * @example
+     * ```typescript
+     * import { SSLPinning } from '@cap-kit/ssl-pinning';
+     *
+     * const results = await SSLPinning.checkCertificates([
+     *   {
+     *     url: 'https://example.com',
+     *     fingerprints: ['50:4B:A1:B5:48:96:71:F3:9F:87:7E:0A:09:FD:3E:1B:C0:4F:AA:9F:FC:83:3E:A9:3A:00:78:88:F8:BA:60:26']
+     *   },
+     *   {
+     *     url: 'https://another-example.com',
+     *     fingerprints: ['AB:CD:EF:12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:12:34:56:78:90']
+     *   }
+     * ]);
+     *
+     * results.forEach(result => {
+     *   console.log('SSL Pinning Result:', result);
+     * });
+     * ```
+     *
+     * @since 0.0.15
+     */
+    checkCertificates(options: SSLPinningMultiOptions[]): Promise<SSLPinningResult[]>;
+    /**
+     * Returns the native plugin version.
+     *
+     * The returned version corresponds to the native implementation
+     * bundled with the application.
+     *
+     * @returns A promise resolving to the plugin version.
+     *
+     * @example
+     * ```ts
+     * const { version } = await SSLPinning.getPluginVersion();
+     * ```
+     *
+     * @since 0.0.15
+     */
+    getPluginVersion(): Promise<PluginVersionResult>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,18 @@
+/// <reference types="@capacitor/cli" />
+// -- Enums --
+/**
+ * Standardized error codes for programmatic handling of ssl pinning failures.
+ * @since 0.0.15
+ */
+export var SSLPinningErrorCode;
+(function (SSLPinningErrorCode) {
+    /** The device does not have the requested hardware. */
+    SSLPinningErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+    /** The user denied the permission or the feature is disabled in settings. */
+    SSLPinningErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** The ssl pinning failed to initialize (e.g., runtime error or Looper failure). */
+    SSLPinningErrorCode["INIT_FAILED"] = "INIT_FAILED";
+    /** The requested ssl pinning type is not valid or not supported by the plugin. */
+    SSLPinningErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+})(SSLPinningErrorCode || (SSLPinningErrorCode = {}));
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAexC,cAAc;AAEd;;;GAGG;AACH,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,uDAAuD;IACvD,kDAA2B,CAAA;IAC3B,6EAA6E;IAC7E,8DAAuC,CAAA;IACvC,oFAAoF;IACpF,kDAA2B,CAAA;IAC3B,kFAAkF;IAClF,oDAA6B,CAAA;AAC/B,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B"}

package/dist/esm/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file index.ts
+ * Main entry point for the SSLPinning Capacitor Plugin.
+ * This file handles the registration of the plugin with the Capacitor core runtime
+ * and exports all necessary types for consumers.
+ */
+import { SSLPinningPlugin } from './definitions';
+/**
+ * The SSLPinning plugin instance.
+ * It automatically lazy-loads the web implementation if running in a browser environment.
+ * Use this instance to access all ssl pinning functionality.
+ */
+declare const SSLPinning: SSLPinningPlugin;
+export * from './definitions';
+export { SSLPinning };

package/dist/esm/index.js

@@ -0,0 +1,16 @@
+/**
+ * Import the `registerPlugin` method from the Capacitor core library.
+ * This method is used to register a custom plugin.
+ */
+import { registerPlugin } from '@capacitor/core';
+/**
+ * The SSLPinning plugin instance.
+ * It automatically lazy-loads the web implementation if running in a browser environment.
+ * Use this instance to access all ssl pinning functionality.
+ */
+const SSLPinning = registerPlugin('SSLPinning', {
+    web: () => import('./web').then((m) => new m.SSLPinningWeb()),
+});
+export * from './definitions';
+export { SSLPinning };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWjD;;;;GAIG;AACH,MAAM,UAAU,GAAG,cAAc,CAAmB,YAAY,EAAE;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;CAC9D,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/esm/web.d.ts

@@ -0,0 +1,58 @@
+/**
+ * This module provides a web implementation of the SSLPinningPlugin.
+ * The functionality is limited in a web context due to the lack of SSL certificate inspection capabilities in browsers.
+ *
+ * The implementation adheres to the SSLPinningPlugin interface but provides fallback behavior
+ * because browsers do not allow direct inspection of SSL certificate details.
+ */
+import { WebPlugin } from '@capacitor/core';
+import { PluginVersionResult, SSLPinningMultiOptions, SSLPinningOptions, SSLPinningPlugin, SSLPinningResult } from './definitions';
+/**
+ * Web implementation of the SSLPinningPlugin interface.
+ *
+ * This class is intended to be used in a browser environment and handles scenarios where SSL certificate
+ * checking is unsupported. It implements the methods defined by the SSLPinningPlugin
+ * interface but returns standardized error responses to indicate the lack of functionality in web contexts.
+ */
+export declare class SSLPinningWeb extends WebPlugin implements SSLPinningPlugin {
+    /**
+     * Checks a single SSL certificate against the expected fingerprint.
+     * @param options - The options for checking the certificate.
+     * @returns A promise that resolves to the result of the certificate check.
+     */
+    checkCertificate(): Promise<SSLPinningResult>;
+    /**
+     * Checks a single SSL certificate against the expected fingerprint.
+     * @param options - The options for checking the certificate.
+     * @returns A promise that resolves to the result of the certificate check.
+     */
+    checkCertificate(_: SSLPinningOptions): Promise<SSLPinningResult>;
+    /**
+     * Checks multiple SSL certificates against their expected fingerprints.
+     * @return A promise that resolves to an array of results for each certificate check.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    checkCertificates(): Promise<SSLPinningResult[]>;
+    /**
+     * Checks multiple SSL certificates against their expected fingerprints.
+     * @param options - The options for checking multiple certificates.
+     * @return A promise that resolves to an array of results for each certificate check.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    checkCertificates(_: SSLPinningMultiOptions[]): Promise<SSLPinningResult[]>;
+    /**
+     * Returns the plugin version.
+     *
+     * @returns The current plugin version.
+     */
+    getPluginVersion(): Promise<PluginVersionResult>;
+    /**
+     * Creates a standardized exception for unimplemented methods.
+     *
+     * This utility method centralizes the creation of exceptions for functionality that is not supported
+     * on the current platform, ensuring consistency in error reporting.
+     *
+     * @returns {CapacitorException} An exception with the code `Unimplemented` and a descriptive message.
+     */
+    private createUnimplementedError;
+}

package/dist/esm/web.js

@@ -0,0 +1,54 @@
+/**
+ * This module provides a web implementation of the SSLPinningPlugin.
+ * The functionality is limited in a web context due to the lack of SSL certificate inspection capabilities in browsers.
+ *
+ * The implementation adheres to the SSLPinningPlugin interface but provides fallback behavior
+ * because browsers do not allow direct inspection of SSL certificate details.
+ */
+import { CapacitorException, ExceptionCode, WebPlugin } from '@capacitor/core';
+/**
+ * Web implementation of the SSLPinningPlugin interface.
+ *
+ * This class is intended to be used in a browser environment and handles scenarios where SSL certificate
+ * checking is unsupported. It implements the methods defined by the SSLPinningPlugin
+ * interface but returns standardized error responses to indicate the lack of functionality in web contexts.
+ */
+export class SSLPinningWeb extends WebPlugin {
+    /**
+     * Checks a single SSL certificate against the expected fingerprint.
+     * @return A promise that resolves to the result of the certificate check.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificate() {
+        throw this.createUnimplementedError();
+    }
+    /**
+     * Checks multiple SSL certificates against their expected fingerprints.
+     * @return A promise that resolves to an array of results for each certificate check.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificates() {
+        throw this.createUnimplementedError();
+    }
+    // --- Plugin Info ---
+    /**
+     * Returns the plugin version.
+     *
+     * @returns The current plugin version.
+     */
+    async getPluginVersion() {
+        return { version: 'web' };
+    }
+    /**
+     * Creates a standardized exception for unimplemented methods.
+     *
+     * This utility method centralizes the creation of exceptions for functionality that is not supported
+     * on the current platform, ensuring consistency in error reporting.
+     *
+     * @returns {CapacitorException} An exception with the code `Unimplemented` and a descriptive message.
+     */
+    createUnimplementedError() {
+        return new CapacitorException('This plugin method is not implemented on this platform.', ExceptionCode.Unimplemented);
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU/E;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAe1C;;;;OAIG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAiBD;;;;OAIG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED,sBAAsB;IAEtB;;;;OAIG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACK,wBAAwB;QAC9B,OAAO,IAAI,kBAAkB,CAC3B,yDAAyD,EACzD,aAAa,CAAC,aAAa,CAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/plugin.cjs.js

@@ -0,0 +1,95 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+/// <reference types="@capacitor/cli" />
+// -- Enums --
+/**
+ * Standardized error codes for programmatic handling of ssl pinning failures.
+ * @since 0.0.15
+ */
+exports.SSLPinningErrorCode = void 0;
+(function (SSLPinningErrorCode) {
+    /** The device does not have the requested hardware. */
+    SSLPinningErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+    /** The user denied the permission or the feature is disabled in settings. */
+    SSLPinningErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** The ssl pinning failed to initialize (e.g., runtime error or Looper failure). */
+    SSLPinningErrorCode["INIT_FAILED"] = "INIT_FAILED";
+    /** The requested ssl pinning type is not valid or not supported by the plugin. */
+    SSLPinningErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+})(exports.SSLPinningErrorCode || (exports.SSLPinningErrorCode = {}));
+
+/**
+ * Import the `registerPlugin` method from the Capacitor core library.
+ * This method is used to register a custom plugin.
+ */
+/**
+ * The SSLPinning plugin instance.
+ * It automatically lazy-loads the web implementation if running in a browser environment.
+ * Use this instance to access all ssl pinning functionality.
+ */
+const SSLPinning = core.registerPlugin('SSLPinning', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.SSLPinningWeb()),
+});
+
+/**
+ * This module provides a web implementation of the SSLPinningPlugin.
+ * The functionality is limited in a web context due to the lack of SSL certificate inspection capabilities in browsers.
+ *
+ * The implementation adheres to the SSLPinningPlugin interface but provides fallback behavior
+ * because browsers do not allow direct inspection of SSL certificate details.
+ */
+/**
+ * Web implementation of the SSLPinningPlugin interface.
+ *
+ * This class is intended to be used in a browser environment and handles scenarios where SSL certificate
+ * checking is unsupported. It implements the methods defined by the SSLPinningPlugin
+ * interface but returns standardized error responses to indicate the lack of functionality in web contexts.
+ */
+class SSLPinningWeb extends core.WebPlugin {
+    /**
+     * Checks a single SSL certificate against the expected fingerprint.
+     * @return A promise that resolves to the result of the certificate check.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificate() {
+        throw this.createUnimplementedError();
+    }
+    /**
+     * Checks multiple SSL certificates against their expected fingerprints.
+     * @return A promise that resolves to an array of results for each certificate check.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificates() {
+        throw this.createUnimplementedError();
+    }
+    // --- Plugin Info ---
+    /**
+     * Returns the plugin version.
+     *
+     * @returns The current plugin version.
+     */
+    async getPluginVersion() {
+        return { version: 'web' };
+    }
+    /**
+     * Creates a standardized exception for unimplemented methods.
+     *
+     * This utility method centralizes the creation of exceptions for functionality that is not supported
+     * on the current platform, ensuring consistency in error reporting.
+     *
+     * @returns {CapacitorException} An exception with the code `Unimplemented` and a descriptive message.
+     */
+    createUnimplementedError() {
+        return new core.CapacitorException('This plugin method is not implemented on this platform.', core.ExceptionCode.Unimplemented);
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    SSLPinningWeb: SSLPinningWeb
+});
+
+exports.SSLPinning = SSLPinning;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n// -- Enums --\n/**\n * Standardized error codes for programmatic handling of ssl pinning failures.\n * @since 0.0.15\n */\nexport var SSLPinningErrorCode;\n(function (SSLPinningErrorCode) {\n    /** The device does not have the requested hardware. */\n    SSLPinningErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user denied the permission or the feature is disabled in settings. */\n    SSLPinningErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The ssl pinning failed to initialize (e.g., runtime error or Looper failure). */\n    SSLPinningErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The requested ssl pinning type is not valid or not supported by the plugin. */\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 SSLPinningPlugin interface.\n *\n * This class is intended to be used in a browser environment and handles scenarios where SSL certificate\n * checking is unsupported. It implements the methods defined by the SSLPinningPlugin\n * interface but returns standardized error responses to indicate the lack of functionality in web contexts.\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     * @returns The current plugin version.\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;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;;AChBrD;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;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,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/dist/plugin.js

@@ -0,0 +1,98 @@
+var capacitorSSLPinning = (function (exports, core) {
+    'use strict';
+
+    /// <reference types="@capacitor/cli" />
+    // -- Enums --
+    /**
+     * Standardized error codes for programmatic handling of ssl pinning failures.
+     * @since 0.0.15
+     */
+    exports.SSLPinningErrorCode = void 0;
+    (function (SSLPinningErrorCode) {
+        /** The device does not have the requested hardware. */
+        SSLPinningErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+        /** The user denied the permission or the feature is disabled in settings. */
+        SSLPinningErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+        /** The ssl pinning failed to initialize (e.g., runtime error or Looper failure). */
+        SSLPinningErrorCode["INIT_FAILED"] = "INIT_FAILED";
+        /** The requested ssl pinning type is not valid or not supported by the plugin. */
+        SSLPinningErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+    })(exports.SSLPinningErrorCode || (exports.SSLPinningErrorCode = {}));
+
+    /**
+     * Import the `registerPlugin` method from the Capacitor core library.
+     * This method is used to register a custom plugin.
+     */
+    /**
+     * The SSLPinning plugin instance.
+     * It automatically lazy-loads the web implementation if running in a browser environment.
+     * Use this instance to access all ssl pinning functionality.
+     */
+    const SSLPinning = core.registerPlugin('SSLPinning', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.SSLPinningWeb()),
+    });
+
+    /**
+     * This module provides a web implementation of the SSLPinningPlugin.
+     * The functionality is limited in a web context due to the lack of SSL certificate inspection capabilities in browsers.
+     *
+     * The implementation adheres to the SSLPinningPlugin interface but provides fallback behavior
+     * because browsers do not allow direct inspection of SSL certificate details.
+     */
+    /**
+     * Web implementation of the SSLPinningPlugin interface.
+     *
+     * This class is intended to be used in a browser environment and handles scenarios where SSL certificate
+     * checking is unsupported. It implements the methods defined by the SSLPinningPlugin
+     * interface but returns standardized error responses to indicate the lack of functionality in web contexts.
+     */
+    class SSLPinningWeb extends core.WebPlugin {
+        /**
+         * Checks a single SSL certificate against the expected fingerprint.
+         * @return A promise that resolves to the result of the certificate check.
+         * @throws CapacitorException indicating unimplemented functionality.
+         */
+        async checkCertificate() {
+            throw this.createUnimplementedError();
+        }
+        /**
+         * Checks multiple SSL certificates against their expected fingerprints.
+         * @return A promise that resolves to an array of results for each certificate check.
+         * @throws CapacitorException indicating unimplemented functionality.
+         */
+        async checkCertificates() {
+            throw this.createUnimplementedError();
+        }
+        // --- Plugin Info ---
+        /**
+         * Returns the plugin version.
+         *
+         * @returns The current plugin version.
+         */
+        async getPluginVersion() {
+            return { version: 'web' };
+        }
+        /**
+         * Creates a standardized exception for unimplemented methods.
+         *
+         * This utility method centralizes the creation of exceptions for functionality that is not supported
+         * on the current platform, ensuring consistency in error reporting.
+         *
+         * @returns {CapacitorException} An exception with the code `Unimplemented` and a descriptive message.
+         */
+        createUnimplementedError() {
+            return new core.CapacitorException('This plugin method is not implemented on this platform.', core.ExceptionCode.Unimplemented);
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        SSLPinningWeb: SSLPinningWeb
+    });
+
+    exports.SSLPinning = SSLPinning;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map