@cap-kit/tls-fingerprint 8.0.0

package/dist/esm/definitions.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Capacitor configuration extension for the TLSFingerprint plugin.
+ *
+ * Configuration values defined here can be provided under the
+ * `plugins.TLSFingerprint` key inside `capacitor.config.ts`.
+ *
+ * These values are:
+ * - read natively at build/runtime
+ * - NOT accessible from JavaScript at runtime
+ * - treated as read-only static configuration
+ *
+ * @see https://capacitorjs.com/docs/plugins/configuration-values
+ */
+declare module '@capacitor/cli' {
+    interface PluginsConfig {
+        /**
+         * Configuration options for the TLSFingerprint plugin.
+         */
+        TLSFingerprint?: TLSFingerprintConfig;
+    }
+}
+/**
+ * Standardized error codes for programmatic handling of TLS fingerprint failures.
+ *
+ * Errors are delivered via Promise rejection as `CapacitorException`
+ * with one of the following codes.
+ *
+ * @since 8.0.0
+ */
+export declare enum TLSFingerprintErrorCode {
+    /** Required data is missing or the feature is not available. */
+    UNAVAILABLE = "UNAVAILABLE",
+    /** The user cancelled an interactive flow. */
+    CANCELLED = "CANCELLED",
+    /** The user denied a required permission or the feature is disabled. */
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    /** The TLS fingerprint operation failed due to a runtime or initialization error. */
+    INIT_FAILED = "INIT_FAILED",
+    /** The input provided to the plugin method is invalid, missing, or malformed. */
+    INVALID_INPUT = "INVALID_INPUT",
+    /** Invalid or unsupported input was provided. */
+    UNKNOWN_TYPE = "UNKNOWN_TYPE",
+    /** The requested resource does not exist. */
+    NOT_FOUND = "NOT_FOUND",
+    /** The operation conflicts with the current state. */
+    CONFLICT = "CONFLICT",
+    /** The operation did not complete within the expected time. */
+    TIMEOUT = "TIMEOUT",
+    /** The server certificate fingerprint did not match any expected fingerprint. */
+    PINNING_FAILED = "PINNING_FAILED",
+    /** The request host matched an excluded domain. */
+    EXCLUDED_DOMAIN = "EXCLUDED_DOMAIN",
+    /** Network connectivity or TLS handshake error. */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /** SSL/TLS specific error (certificate expired, handshake failure, etc.). */
+    SSL_ERROR = "SSL_ERROR"
+}
+/**
+ * Static configuration options for the TLSFingerprint plugin.
+ *
+ * These values can be defined in `capacitor.config.ts` and are used
+ * natively as fallback values when runtime options are not provided.
+ */
+export interface TLSFingerprintConfig {
+    /**
+     * Enables verbose native logging.
+     *
+     * When enabled, additional debug information is printed
+     * to the native console (Logcat on Android, Xcode on iOS).
+     *
+     * This option affects native logging behavior only and
+     * has no impact on the JavaScript API.
+     *
+     * @default false
+     * @example true
+     * @since 8.0.0
+     */
+    verboseLogging?: boolean;
+    /**
+     * Default fingerprint used by `checkCertificate()` when
+     * `options.fingerprint` is not provided at runtime.
+     *
+     * @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"
+     * @since 8.0.0
+     */
+    fingerprint?: string;
+    /**
+     * Default fingerprints used by `checkCertificates()` when
+     * `options.fingerprints` is not provided at runtime.
+     *
+     * @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"]
+     * @since 8.0.0
+     */
+    fingerprints?: string[];
+    /**
+     * Domains to bypass. Matches exact domain or subdomains.
+     * Do not include schemes or paths.
+     *
+     * @since 8.0.0
+     */
+    excludedDomains?: string[];
+}
+/**
+ * Options for checking a single SSL certificate.
+ */
+export interface TLSFingerprintOptions {
+    /**
+     * HTTPS URL of the server whose SSL certificate must be checked.
+     *
+     * This value is REQUIRED and cannot be provided via configuration.
+     *
+     * @example "https://example.com"
+     */
+    url: string;
+    /**
+     * Expected SHA-256 fingerprint of the certificate.
+     *
+     * Resolution order:
+     * 1. `options.fingerprint` (runtime)
+     * 2. `plugins.TLSFingerprint.fingerprint` (config)
+     *
+     * If neither is provided, the Promise is rejected with
+     * `TLSFingerprintErrorCode.UNAVAILABLE`.
+     */
+    fingerprint?: string;
+}
+/**
+ * Options for checking an SSL certificate using multiple allowed fingerprints.
+ */
+export interface TLSFingerprintMultiOptions {
+    /**
+     * HTTPS URL of the server whose SSL certificate must be checked.
+     *
+     * This value is REQUIRED and cannot be provided via configuration.
+     *
+     * @example "https://example.com"
+     */
+    url: string;
+    /**
+     * Expected SHA-256 fingerprints of the certificate.
+     *
+     * Resolution order:
+     * 1. `options.fingerprints` (runtime)
+     * 2. `plugins.TLSFingerprint.fingerprints` (config)
+     *
+     * If neither is provided, the Promise is rejected with
+     * `TLSFingerprintErrorCode.UNAVAILABLE`.
+     */
+    fingerprints?: string[];
+}
+/**
+ * Result returned by an TLS fingerprint operation.
+ *
+ * This object is returned for ALL outcomes:
+ * - Success: `fingerprintMatched: true`
+ * - Mismatch: `fingerprintMatched: false` with error info (RESOLVED, not rejected)
+ *
+ * Only operation failures (invalid input, config missing, network errors,
+ * timeout, internal errors) reject the Promise.
+ */
+export interface TLSFingerprintResult {
+    /**
+     * The actual SHA-256 fingerprint of the server certificate.
+     *
+     * Present in fingerprint and excluded modes.
+     */
+    actualFingerprint?: string;
+    /**
+     * Indicates whether the certificate validation succeeded.
+     *
+     * - true  → Pinning passed
+     * - false → Pinning failed
+     */
+    fingerprintMatched: boolean;
+    /**
+     * The fingerprint that successfully matched, if any.
+     */
+    matchedFingerprint?: string;
+    /**
+     * Indicates that TLS fingerprint was skipped because
+     * the request host matched an excluded domain.
+     */
+    excludedDomain?: boolean;
+    /**
+     * Indicates which pinning mode was used.
+     *
+     * - "fingerprint"
+     * - "excluded"
+     */
+    mode?: 'fingerprint' | 'excluded';
+    /**
+     * Human-readable error message when pinning fails.
+     * Present when `fingerprintMatched: false`.
+     */
+    error?: string;
+    /**
+     * Standardized error code aligned with TLSFingerprintErrorCode.
+     */
+    errorCode?: TLSFingerprintErrorCode;
+}
+/**
+ * Result returned by the getPluginVersion method.
+ */
+export interface PluginVersionResult {
+    /** The native version string of the plugin. */
+    version: string;
+}
+/**
+ * TLS Fingerprint Capacitor Plugin interface.
+ */
+export interface TLSFingerprintPlugin {
+    /**
+     * Checks the SSL certificate of a server using a single fingerprint.
+     *
+     * @throws CapacitorException with code `TLSFingerprintErrorCode`
+     *
+     * @since 8.0.0
+     */
+    checkCertificate(options: TLSFingerprintOptions): Promise<TLSFingerprintResult>;
+    /**
+     * Checks the SSL certificate of a server using multiple allowed fingerprints.
+     *
+     * @throws CapacitorException with code `TLSFingerprintErrorCode`
+     *
+     * @since 8.0.0
+     */
+    checkCertificates(options: TLSFingerprintMultiOptions): Promise<TLSFingerprintResult>;
+    /**
+     * 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 TLSFingerprint.getPluginVersion();
+     * ```
+     *
+     * @since 8.0.0
+     */
+    getPluginVersion(): Promise<PluginVersionResult>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,42 @@
+/// <reference types="@capacitor/cli" />
+// -----------------------------------------------------------------------------
+// Enums
+// -----------------------------------------------------------------------------
+/**
+ * Standardized error codes for programmatic handling of TLS fingerprint failures.
+ *
+ * Errors are delivered via Promise rejection as `CapacitorException`
+ * with one of the following codes.
+ *
+ * @since 8.0.0
+ */
+export var TLSFingerprintErrorCode;
+(function (TLSFingerprintErrorCode) {
+    /** Required data is missing or the feature is not available. */
+    TLSFingerprintErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+    /** The user cancelled an interactive flow. */
+    TLSFingerprintErrorCode["CANCELLED"] = "CANCELLED";
+    /** The user denied a required permission or the feature is disabled. */
+    TLSFingerprintErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** The TLS fingerprint operation failed due to a runtime or initialization error. */
+    TLSFingerprintErrorCode["INIT_FAILED"] = "INIT_FAILED";
+    /** The input provided to the plugin method is invalid, missing, or malformed. */
+    TLSFingerprintErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    /** Invalid or unsupported input was provided. */
+    TLSFingerprintErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+    /** The requested resource does not exist. */
+    TLSFingerprintErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    /** The operation conflicts with the current state. */
+    TLSFingerprintErrorCode["CONFLICT"] = "CONFLICT";
+    /** The operation did not complete within the expected time. */
+    TLSFingerprintErrorCode["TIMEOUT"] = "TIMEOUT";
+    /** The server certificate fingerprint did not match any expected fingerprint. */
+    TLSFingerprintErrorCode["PINNING_FAILED"] = "PINNING_FAILED";
+    /** The request host matched an excluded domain. */
+    TLSFingerprintErrorCode["EXCLUDED_DOMAIN"] = "EXCLUDED_DOMAIN";
+    /** Network connectivity or TLS handshake error. */
+    TLSFingerprintErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    /** SSL/TLS specific error (certificate expired, handshake failure, etc.). */
+    TLSFingerprintErrorCode["SSL_ERROR"] = "SSL_ERROR";
+})(TLSFingerprintErrorCode || (TLSFingerprintErrorCode = {}));
+//# 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;AAwBxC,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,uBA2BX;AA3BD,WAAY,uBAAuB;IACjC,gEAAgE;IAChE,sDAA2B,CAAA;IAC3B,8CAA8C;IAC9C,kDAAuB,CAAA;IACvB,wEAAwE;IACxE,kEAAuC,CAAA;IACvC,qFAAqF;IACrF,sDAA2B,CAAA;IAC3B,iFAAiF;IACjF,0DAA+B,CAAA;IAC/B,iDAAiD;IACjD,wDAA6B,CAAA;IAC7B,6CAA6C;IAC7C,kDAAuB,CAAA;IACvB,sDAAsD;IACtD,gDAAqB,CAAA;IACrB,+DAA+D;IAC/D,8CAAmB,CAAA;IACnB,iFAAiF;IACjF,4DAAiC,CAAA;IACjC,mDAAmD;IACnD,8DAAmC,CAAA;IACnC,mDAAmD;IACnD,0DAA+B,CAAA;IAC/B,6EAA6E;IAC7E,kDAAuB,CAAA;AACzB,CAAC,EA3BW,uBAAuB,KAAvB,uBAAuB,QA2BlC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file index.ts
+ * Entry point for the TLSFingerprint Capacitor plugin.
+ * Registers the plugin and re-exports public API types.
+ */
+import { TLSFingerprintPlugin } from './definitions';
+/**
+ * The TLSFingerprint plugin instance.
+ * It lazily loads the Web implementation when running in a browser.
+ */
+declare const TLSFingerprint: TLSFingerprintPlugin;
+export * from './definitions';
+export { TLSFingerprint };

package/dist/esm/index.js

@@ -0,0 +1,11 @@
+import { registerPlugin } from '@capacitor/core';
+/**
+ * The TLSFingerprint plugin instance.
+ * It lazily loads the Web implementation when running in a browser.
+ */
+const TLSFingerprint = registerPlugin('TLSFingerprint', {
+    web: () => import('./web').then((m) => new m.TLSFingerprintWeb()),
+});
+export * from './definitions';
+export { TLSFingerprint };
+//# 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,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUjD;;;GAGG;AACH,MAAM,cAAc,GAAG,cAAc,CAAuB,gBAAgB,EAAE;IAC5E,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;CAClE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/esm/version.d.ts

@@ -0,0 +1 @@
+export declare const PLUGIN_VERSION = "8.0.0";

package/dist/esm/version.js

@@ -0,0 +1,3 @@
+// This file is automatically generated. Do not modify manually.
+export const PLUGIN_VERSION = '8.0.0';
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/dist/esm/web.d.ts

@@ -0,0 +1,33 @@
+import { WebPlugin } from '@capacitor/core';
+import { TLSFingerprintPlugin, PluginVersionResult, TLSFingerprintOptions, TLSFingerprintMultiOptions, TLSFingerprintResult } from './definitions';
+/**
+ * Web implementation of the TLSFingerprint plugin.
+ *
+ * This implementation exists to satisfy Capacitor's multi-platform contract.
+ * TLS fingerprinting is not supported in web browsers.
+ *
+ * All methods follow the standard Promise rejection model:
+ * - unsupported features reject with UNAVAILABLE
+ */
+export declare class TLSFingerprintWeb extends WebPlugin implements TLSFingerprintPlugin {
+    constructor();
+    /**
+     * Checks a single SSL certificate against the expected fingerprint.
+     * @param options - Unused on web platform.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    checkCertificate(options: TLSFingerprintOptions): Promise<TLSFingerprintResult>;
+    /**
+     * Checks multiple SSL certificates against their expected fingerprints.
+     * @param options - Unused on web platform.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    checkCertificates(options: TLSFingerprintMultiOptions): Promise<TLSFingerprintResult>;
+    /**
+     * Returns the plugin version.
+     *
+     * On the Web, this value represents the JavaScript package version
+     * rather than a native implementation.
+     */
+    getPluginVersion(): Promise<PluginVersionResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,47 @@
+import { WebPlugin } from '@capacitor/core';
+import { PLUGIN_VERSION } from './version';
+/**
+ * Web implementation of the TLSFingerprint plugin.
+ *
+ * This implementation exists to satisfy Capacitor's multi-platform contract.
+ * TLS fingerprinting is not supported in web browsers.
+ *
+ * All methods follow the standard Promise rejection model:
+ * - unsupported features reject with UNAVAILABLE
+ */
+export class TLSFingerprintWeb extends WebPlugin {
+    constructor() {
+        super();
+    }
+    /**
+     * Checks a single SSL certificate against the expected fingerprint.
+     * @param options - Unused on web platform.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificate(options) {
+        void options;
+        throw this.unimplemented();
+    }
+    /**
+     * Checks multiple SSL certificates against their expected fingerprints.
+     * @param options - Unused on web platform.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificates(options) {
+        void options;
+        throw this.unimplemented();
+    }
+    // -----------------------------------------------------------------------------
+    // Plugin Info
+    // -----------------------------------------------------------------------------
+    /**
+     * Returns the plugin version.
+     *
+     * On the Web, this value represents the JavaScript package version
+     * rather than a native implementation.
+     */
+    async getPluginVersion() {
+        return { version: PLUGIN_VERSION };
+    }
+}
+//# 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,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAA8B;QACnD,KAAK,OAAO,CAAC;QACb,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAmC;QACzD,KAAK,OAAO,CAAC;QACb,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,gFAAgF;IAChF,cAAc;IACd,gFAAgF;IAEhF;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACrC,CAAC;CACF"}

package/dist/plugin.cjs

@@ -0,0 +1,107 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+/// <reference types="@capacitor/cli" />
+// -----------------------------------------------------------------------------
+// Enums
+// -----------------------------------------------------------------------------
+/**
+ * Standardized error codes for programmatic handling of TLS fingerprint failures.
+ *
+ * Errors are delivered via Promise rejection as `CapacitorException`
+ * with one of the following codes.
+ *
+ * @since 8.0.0
+ */
+exports.TLSFingerprintErrorCode = void 0;
+(function (TLSFingerprintErrorCode) {
+    /** Required data is missing or the feature is not available. */
+    TLSFingerprintErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+    /** The user cancelled an interactive flow. */
+    TLSFingerprintErrorCode["CANCELLED"] = "CANCELLED";
+    /** The user denied a required permission or the feature is disabled. */
+    TLSFingerprintErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** The TLS fingerprint operation failed due to a runtime or initialization error. */
+    TLSFingerprintErrorCode["INIT_FAILED"] = "INIT_FAILED";
+    /** The input provided to the plugin method is invalid, missing, or malformed. */
+    TLSFingerprintErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    /** Invalid or unsupported input was provided. */
+    TLSFingerprintErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+    /** The requested resource does not exist. */
+    TLSFingerprintErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    /** The operation conflicts with the current state. */
+    TLSFingerprintErrorCode["CONFLICT"] = "CONFLICT";
+    /** The operation did not complete within the expected time. */
+    TLSFingerprintErrorCode["TIMEOUT"] = "TIMEOUT";
+    /** The server certificate fingerprint did not match any expected fingerprint. */
+    TLSFingerprintErrorCode["PINNING_FAILED"] = "PINNING_FAILED";
+    /** The request host matched an excluded domain. */
+    TLSFingerprintErrorCode["EXCLUDED_DOMAIN"] = "EXCLUDED_DOMAIN";
+    /** Network connectivity or TLS handshake error. */
+    TLSFingerprintErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    /** SSL/TLS specific error (certificate expired, handshake failure, etc.). */
+    TLSFingerprintErrorCode["SSL_ERROR"] = "SSL_ERROR";
+})(exports.TLSFingerprintErrorCode || (exports.TLSFingerprintErrorCode = {}));
+
+/**
+ * The TLSFingerprint plugin instance.
+ * It lazily loads the Web implementation when running in a browser.
+ */
+const TLSFingerprint = core.registerPlugin('TLSFingerprint', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.TLSFingerprintWeb()),
+});
+
+// This file is automatically generated. Do not modify manually.
+const PLUGIN_VERSION = '8.0.0';
+
+/**
+ * Web implementation of the TLSFingerprint plugin.
+ *
+ * This implementation exists to satisfy Capacitor's multi-platform contract.
+ * TLS fingerprinting is not supported in web browsers.
+ *
+ * All methods follow the standard Promise rejection model:
+ * - unsupported features reject with UNAVAILABLE
+ */
+class TLSFingerprintWeb extends core.WebPlugin {
+    constructor() {
+        super();
+    }
+    /**
+     * Checks a single SSL certificate against the expected fingerprint.
+     * @param options - Unused on web platform.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificate(options) {
+        throw this.unimplemented();
+    }
+    /**
+     * Checks multiple SSL certificates against their expected fingerprints.
+     * @param options - Unused on web platform.
+     * @throws CapacitorException indicating unimplemented functionality.
+     */
+    async checkCertificates(options) {
+        throw this.unimplemented();
+    }
+    // -----------------------------------------------------------------------------
+    // Plugin Info
+    // -----------------------------------------------------------------------------
+    /**
+     * Returns the plugin version.
+     *
+     * On the Web, this value represents the JavaScript package version
+     * rather than a native implementation.
+     */
+    async getPluginVersion() {
+        return { version: PLUGIN_VERSION };
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    TLSFingerprintWeb: TLSFingerprintWeb
+});
+
+exports.TLSFingerprint = TLSFingerprint;
+//# 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/version.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n// -----------------------------------------------------------------------------\n// Enums\n// -----------------------------------------------------------------------------\n/**\n * Standardized error codes for programmatic handling of TLS fingerprint failures.\n *\n * Errors are delivered via Promise rejection as `CapacitorException`\n * with one of the following codes.\n *\n * @since 8.0.0\n */\nexport var TLSFingerprintErrorCode;\n(function (TLSFingerprintErrorCode) {\n    /** Required data is missing or the feature is not available. */\n    TLSFingerprintErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user cancelled an interactive flow. */\n    TLSFingerprintErrorCode[\"CANCELLED\"] = \"CANCELLED\";\n    /** The user denied a required permission or the feature is disabled. */\n    TLSFingerprintErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The TLS fingerprint operation failed due to a runtime or initialization error. */\n    TLSFingerprintErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The input provided to the plugin method is invalid, missing, or malformed. */\n    TLSFingerprintErrorCode[\"INVALID_INPUT\"] = \"INVALID_INPUT\";\n    /** Invalid or unsupported input was provided. */\n    TLSFingerprintErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n    /** The requested resource does not exist. */\n    TLSFingerprintErrorCode[\"NOT_FOUND\"] = \"NOT_FOUND\";\n    /** The operation conflicts with the current state. */\n    TLSFingerprintErrorCode[\"CONFLICT\"] = \"CONFLICT\";\n    /** The operation did not complete within the expected time. */\n    TLSFingerprintErrorCode[\"TIMEOUT\"] = \"TIMEOUT\";\n    /** The server certificate fingerprint did not match any expected fingerprint. */\n    TLSFingerprintErrorCode[\"PINNING_FAILED\"] = \"PINNING_FAILED\";\n    /** The request host matched an excluded domain. */\n    TLSFingerprintErrorCode[\"EXCLUDED_DOMAIN\"] = \"EXCLUDED_DOMAIN\";\n    /** Network connectivity or TLS handshake error. */\n    TLSFingerprintErrorCode[\"NETWORK_ERROR\"] = \"NETWORK_ERROR\";\n    /** SSL/TLS specific error (certificate expired, handshake failure, etc.). */\n    TLSFingerprintErrorCode[\"SSL_ERROR\"] = \"SSL_ERROR\";\n})(TLSFingerprintErrorCode || (TLSFingerprintErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\n/**\n * The TLSFingerprint plugin instance.\n * It lazily loads the Web implementation when running in a browser.\n */\nconst TLSFingerprint = registerPlugin('TLSFingerprint', {\n    web: () => import('./web').then((m) => new m.TLSFingerprintWeb()),\n});\nexport * from './definitions';\nexport { TLSFingerprint };\n//# sourceMappingURL=index.js.map","// This file is automatically generated. Do not modify manually.\nexport const PLUGIN_VERSION = '8.0.0';\n//# sourceMappingURL=version.js.map","import { WebPlugin } from '@capacitor/core';\nimport { PLUGIN_VERSION } from './version';\n/**\n * Web implementation of the TLSFingerprint plugin.\n *\n * This implementation exists to satisfy Capacitor's multi-platform contract.\n * TLS fingerprinting is not supported in web browsers.\n *\n * All methods follow the standard Promise rejection model:\n * - unsupported features reject with UNAVAILABLE\n */\nexport class TLSFingerprintWeb extends WebPlugin {\n    constructor() {\n        super();\n    }\n    /**\n     * Checks a single SSL certificate against the expected fingerprint.\n     * @param options - Unused on web platform.\n     * @throws CapacitorException indicating unimplemented functionality.\n     */\n    async checkCertificate(options) {\n        void options;\n        throw this.unimplemented();\n    }\n    /**\n     * Checks multiple SSL certificates against their expected fingerprints.\n     * @param options - Unused on web platform.\n     * @throws CapacitorException indicating unimplemented functionality.\n     */\n    async checkCertificates(options) {\n        void options;\n        throw this.unimplemented();\n    }\n    // -----------------------------------------------------------------------------\n    // Plugin Info\n    // -----------------------------------------------------------------------------\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: PLUGIN_VERSION };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["TLSFingerprintErrorCode","registerPlugin","WebPlugin"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACWA;AACX,CAAC,UAAU,uBAAuB,EAAE;AACpC;AACA,IAAI,uBAAuB,CAAC,aAAa,CAAC,GAAG,aAAa;AAC1D;AACA,IAAI,uBAAuB,CAAC,WAAW,CAAC,GAAG,WAAW;AACtD;AACA,IAAI,uBAAuB,CAAC,mBAAmB,CAAC,GAAG,mBAAmB;AACtE;AACA,IAAI,uBAAuB,CAAC,aAAa,CAAC,GAAG,aAAa;AAC1D;AACA,IAAI,uBAAuB,CAAC,eAAe,CAAC,GAAG,eAAe;AAC9D;AACA,IAAI,uBAAuB,CAAC,cAAc,CAAC,GAAG,cAAc;AAC5D;AACA,IAAI,uBAAuB,CAAC,WAAW,CAAC,GAAG,WAAW;AACtD;AACA,IAAI,uBAAuB,CAAC,UAAU,CAAC,GAAG,UAAU;AACpD;AACA,IAAI,uBAAuB,CAAC,SAAS,CAAC,GAAG,SAAS;AAClD;AACA,IAAI,uBAAuB,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;AAChE;AACA,IAAI,uBAAuB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB;AAClE;AACA,IAAI,uBAAuB,CAAC,eAAe,CAAC,GAAG,eAAe;AAC9D;AACA,IAAI,uBAAuB,CAAC,WAAW,CAAC,GAAG,WAAW;AACtD,CAAC,EAAEA,+BAAuB,KAAKA,+BAAuB,GAAG,EAAE,CAAC,CAAC;;ACvC7D;AACA;AACA;AACA;AACK,MAAC,cAAc,GAAGC,mBAAc,CAAC,gBAAgB,EAAE;AACxD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;AACrE,CAAC;;ACPD;AACO,MAAM,cAAc,GAAG,OAAO;;ACCrC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,iBAAiB,SAASC,cAAS,CAAC;AACjD,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,EAAE;AACf,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,CAAC,OAAO,EAAE;AAEpC,QAAQ,MAAM,IAAI,CAAC,aAAa,EAAE;AAClC,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,iBAAiB,CAAC,OAAO,EAAE;AAErC,QAAQ,MAAM,IAAI,CAAC,aAAa,EAAE;AAClC,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;AAC1C,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,110 @@
+var capacitorTLSFingerprint = (function (exports, core) {
+    'use strict';
+
+    /// <reference types="@capacitor/cli" />
+    // -----------------------------------------------------------------------------
+    // Enums
+    // -----------------------------------------------------------------------------
+    /**
+     * Standardized error codes for programmatic handling of TLS fingerprint failures.
+     *
+     * Errors are delivered via Promise rejection as `CapacitorException`
+     * with one of the following codes.
+     *
+     * @since 8.0.0
+     */
+    exports.TLSFingerprintErrorCode = void 0;
+    (function (TLSFingerprintErrorCode) {
+        /** Required data is missing or the feature is not available. */
+        TLSFingerprintErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+        /** The user cancelled an interactive flow. */
+        TLSFingerprintErrorCode["CANCELLED"] = "CANCELLED";
+        /** The user denied a required permission or the feature is disabled. */
+        TLSFingerprintErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+        /** The TLS fingerprint operation failed due to a runtime or initialization error. */
+        TLSFingerprintErrorCode["INIT_FAILED"] = "INIT_FAILED";
+        /** The input provided to the plugin method is invalid, missing, or malformed. */
+        TLSFingerprintErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+        /** Invalid or unsupported input was provided. */
+        TLSFingerprintErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+        /** The requested resource does not exist. */
+        TLSFingerprintErrorCode["NOT_FOUND"] = "NOT_FOUND";
+        /** The operation conflicts with the current state. */
+        TLSFingerprintErrorCode["CONFLICT"] = "CONFLICT";
+        /** The operation did not complete within the expected time. */
+        TLSFingerprintErrorCode["TIMEOUT"] = "TIMEOUT";
+        /** The server certificate fingerprint did not match any expected fingerprint. */
+        TLSFingerprintErrorCode["PINNING_FAILED"] = "PINNING_FAILED";
+        /** The request host matched an excluded domain. */
+        TLSFingerprintErrorCode["EXCLUDED_DOMAIN"] = "EXCLUDED_DOMAIN";
+        /** Network connectivity or TLS handshake error. */
+        TLSFingerprintErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+        /** SSL/TLS specific error (certificate expired, handshake failure, etc.). */
+        TLSFingerprintErrorCode["SSL_ERROR"] = "SSL_ERROR";
+    })(exports.TLSFingerprintErrorCode || (exports.TLSFingerprintErrorCode = {}));
+
+    /**
+     * The TLSFingerprint plugin instance.
+     * It lazily loads the Web implementation when running in a browser.
+     */
+    const TLSFingerprint = core.registerPlugin('TLSFingerprint', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.TLSFingerprintWeb()),
+    });
+
+    // This file is automatically generated. Do not modify manually.
+    const PLUGIN_VERSION = '8.0.0';
+
+    /**
+     * Web implementation of the TLSFingerprint plugin.
+     *
+     * This implementation exists to satisfy Capacitor's multi-platform contract.
+     * TLS fingerprinting is not supported in web browsers.
+     *
+     * All methods follow the standard Promise rejection model:
+     * - unsupported features reject with UNAVAILABLE
+     */
+    class TLSFingerprintWeb extends core.WebPlugin {
+        constructor() {
+            super();
+        }
+        /**
+         * Checks a single SSL certificate against the expected fingerprint.
+         * @param options - Unused on web platform.
+         * @throws CapacitorException indicating unimplemented functionality.
+         */
+        async checkCertificate(options) {
+            throw this.unimplemented();
+        }
+        /**
+         * Checks multiple SSL certificates against their expected fingerprints.
+         * @param options - Unused on web platform.
+         * @throws CapacitorException indicating unimplemented functionality.
+         */
+        async checkCertificates(options) {
+            throw this.unimplemented();
+        }
+        // -----------------------------------------------------------------------------
+        // Plugin Info
+        // -----------------------------------------------------------------------------
+        /**
+         * Returns the plugin version.
+         *
+         * On the Web, this value represents the JavaScript package version
+         * rather than a native implementation.
+         */
+        async getPluginVersion() {
+            return { version: PLUGIN_VERSION };
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        TLSFingerprintWeb: TLSFingerprintWeb
+    });
+
+    exports.TLSFingerprint = TLSFingerprint;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map