@cap-kit/rank 8.0.0

package/dist/plugin.cjs.js

@@ -0,0 +1,204 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+/// <reference types="@capacitor/cli" />
+/**
+ * Standardized error codes used by the Rank plugin.
+ *
+ * These codes are returned as part of structured error objects
+ * and allow consumers to implement programmatic error handling.
+ *
+ * @since 8.0.0
+ */
+exports.RankErrorCode = void 0;
+(function (RankErrorCode) {
+    /** The device does not have the requested hardware or the API is unavailable. */
+    RankErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+    /** The user denied a required permission or the feature is disabled. */
+    RankErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** The Rank plugin failed to initialize (e.g., native SDK error). */
+    RankErrorCode["INIT_FAILED"] = "INIT_FAILED";
+    /** The requested operation or type is not valid or supported. */
+    RankErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+})(exports.RankErrorCode || (exports.RankErrorCode = {}));
+
+/**
+ * @file index.ts
+ * This file exports the Rank and registers it with Capacitor.
+ * It acts as the main entry point for accessing the plugin's functionality
+ * across different platforms, including web.
+ */
+/**
+ * Main entry point for the Rank Capacitor plugin.
+ *
+ * This file registers the plugin with Capacitor and exports
+ * both the runtime instance and the public TypeScript types.
+ */
+const Rank = core.registerPlugin('Rank', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.RankWeb()),
+});
+
+/**
+ * Web implementation of the Rank plugin.
+ *
+ * This implementation exists primarily to satisfy Capacitor's
+ * multi-platform contract and to allow usage in browser-based
+ * environments.
+ *
+ * Native-only features like the In-App Review prompt are unavailable on Web.
+ */
+class RankWeb extends core.WebPlugin {
+    constructor() {
+        super();
+    }
+    // --- Availability ---
+    /**
+     * On Web, native In-App Review is never available.
+     */
+    async isAvailable() {
+        return { value: false };
+    }
+    /**
+     * On Web, the review environment is not available, so this method returns a default result.
+     */
+    async checkReviewEnvironment() {
+        return {
+            canRequestReview: false,
+        };
+    }
+    // --- In-App Review ---
+    /**
+     * Requests the display of the native review popup.
+     *
+     * On Web, this feature is not available.
+     */
+    async requestReview() {
+        throw this.unimplemented('In-App Review is not available on Web.');
+    }
+    // --- Product Page Navigation ---
+    /**
+     * On Web, redirects to the store URL as an internal overlay is not possible.
+     */
+    async presentProductPage(options) {
+        return this.openStore(options);
+    }
+    // --- Store Navigation ---
+    /**
+     * Opens the app's page in the App Store or Play Store via URL redirect.
+     * @description Detects the user's platform to provide the correct store link.
+     * @param options Store identification overrides including appId for iOS or packageName for Android.
+     */
+    async openStore(options) {
+        if (!(options === null || options === void 0 ? void 0 : options.appId) && !(options === null || options === void 0 ? void 0 : options.packageName)) {
+            console.warn('Rank: No App ID or Package Name provided. Store redirect skipped.');
+            return;
+        }
+        const url = this.getStoreUrl(options);
+        if (!url) {
+            // URL construction failed due to missing or invalid identifiers
+            return;
+        }
+        window.open(url, '_blank');
+    }
+    /**
+     * Opens the App Store listing page for a specific app via URL redirect.
+     * @param options Store identification options.
+     */
+    async openStoreListing(options) {
+        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+        if (isIOS && (options === null || options === void 0 ? void 0 : options.appId)) {
+            window.open(RankStoreUtils.appStoreUrl(options.appId), '_blank');
+        }
+        else {
+            console.warn('Rank: openStoreListing is primarily intended for iOS identifiers on Web.');
+        }
+    }
+    /**
+     * Redirects to the developer's page in the store.
+     * @param options.devId The developer ID to navigate to.
+     */
+    async openDevPage(options) {
+        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+        const url = isIOS
+            ? RankStoreUtils.appStoreSearchUrl(options.devId) // iOS uses search for dev pages often
+            : RankStoreUtils.playStoreDevUrl(options.devId);
+        window.open(url, '_blank');
+    }
+    /**
+     * On Web, collection navigation is not supported, so this method logs a warning.
+     * @param options Collection identification (not used on Web).
+     * @description This method is a no-op on Web and serves as a placeholder for potential future functionality.
+     */
+    async openCollection() {
+        console.warn('Rank: openCollection is not available on Web.');
+    }
+    /**
+     * On Web, search navigation is not supported, so this method logs a warning and opens a generic search URL.
+     * @param options Search terms for finding the app in the store (not used on Web).
+     * @description Redirects to a generic search page on the respective store as a fallback.
+     */
+    async search(options) {
+        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+        const url = isIOS
+            ? RankStoreUtils.appStoreSearchUrl(options.terms)
+            : RankStoreUtils.playStoreSearchUrl(options.terms);
+        window.open(url, '_blank');
+    }
+    // --- Internal Helpers ---
+    /**
+     * Generates the appropriate store URL based on user agent and provided options.
+     * * @param options Store options containing identifiers.
+     * @returns A string representing the full store URL.
+     */
+    getStoreUrl(options) {
+        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+        if (isIOS && options.appId) {
+            return RankStoreUtils.appStoreUrl(options.appId);
+        }
+        return RankStoreUtils.playStoreUrl(options.packageName);
+    }
+    // --- 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: 'web' };
+    }
+}
+/**
+ * Internal utility helpers for Store URL construction.
+ * Not part of the public API.
+ */
+class RankStoreUtils {
+    static appStoreUrl(appId) {
+        return `https://apps.apple.com/app/id${appId}`;
+    }
+    static appStoreSearchUrl(terms) {
+        return `https://apps.apple.com/search?term=${encodeURIComponent(terms)}`;
+    }
+    static playStoreUrl(packageName) {
+        if (!packageName || packageName.trim().length === 0) {
+            console.warn('Rank: Missing Android packageName. Cannot construct Play Store URL.');
+            return '';
+        }
+        return `https://play.google.com/store/apps/details?id=${packageName}`;
+    }
+    static playStoreDevUrl(devId) {
+        return `https://play.google.com/store/apps/dev?id=${devId}`;
+    }
+    static playStoreSearchUrl(terms) {
+        return `https://play.google.com/store/search?q=${encodeURIComponent(terms)}&c=apps`;
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    RankWeb: RankWeb
+});
+
+exports.Rank = Rank;
+//# 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/**\n * Standardized error codes used by the Rank plugin.\n *\n * These codes are returned as part of structured error objects\n * and allow consumers to implement programmatic error handling.\n *\n * @since 8.0.0\n */\nexport var RankErrorCode;\n(function (RankErrorCode) {\n    /** The device does not have the requested hardware or the API is unavailable. */\n    RankErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user denied a required permission or the feature is disabled. */\n    RankErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The Rank plugin failed to initialize (e.g., native SDK error). */\n    RankErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The requested operation or type is not valid or supported. */\n    RankErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n})(RankErrorCode || (RankErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","/**\n * @file index.ts\n * This file exports the Rank and registers it with Capacitor.\n * It acts as the main entry point for accessing the plugin's functionality\n * across different platforms, including web.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * Main entry point for the Rank Capacitor plugin.\n *\n * This file registers the plugin with Capacitor and exports\n * both the runtime instance and the public TypeScript types.\n */\nconst Rank = registerPlugin('Rank', {\n    web: () => import('./web').then((m) => new m.RankWeb()),\n});\nexport * from './definitions';\nexport { Rank };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the Rank plugin.\n *\n * This implementation exists primarily to satisfy Capacitor's\n * multi-platform contract and to allow usage in browser-based\n * environments.\n *\n * Native-only features like the In-App Review prompt are unavailable on Web.\n */\nexport class RankWeb extends WebPlugin {\n    constructor() {\n        super();\n    }\n    // --- Availability ---\n    /**\n     * On Web, native In-App Review is never available.\n     */\n    async isAvailable() {\n        return { value: false };\n    }\n    /**\n     * On Web, the review environment is not available, so this method returns a default result.\n     */\n    async checkReviewEnvironment() {\n        return {\n            canRequestReview: false,\n        };\n    }\n    // --- In-App Review ---\n    /**\n     * Requests the display of the native review popup.\n     *\n     * On Web, this feature is not available.\n     */\n    async requestReview() {\n        throw this.unimplemented('In-App Review is not available on Web.');\n    }\n    // --- Product Page Navigation ---\n    /**\n     * On Web, redirects to the store URL as an internal overlay is not possible.\n     */\n    async presentProductPage(options) {\n        return this.openStore(options);\n    }\n    // --- Store Navigation ---\n    /**\n     * Opens the app's page in the App Store or Play Store via URL redirect.\n     * @description Detects the user's platform to provide the correct store link.\n     * @param options Store identification overrides including appId for iOS or packageName for Android.\n     */\n    async openStore(options) {\n        if (!(options === null || options === void 0 ? void 0 : options.appId) && !(options === null || options === void 0 ? void 0 : options.packageName)) {\n            console.warn('Rank: No App ID or Package Name provided. Store redirect skipped.');\n            return;\n        }\n        const url = this.getStoreUrl(options);\n        if (!url) {\n            // URL construction failed due to missing or invalid identifiers\n            return;\n        }\n        window.open(url, '_blank');\n    }\n    /**\n     * Opens the App Store listing page for a specific app via URL redirect.\n     * @param options Store identification options.\n     */\n    async openStoreListing(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        if (isIOS && (options === null || options === void 0 ? void 0 : options.appId)) {\n            window.open(RankStoreUtils.appStoreUrl(options.appId), '_blank');\n        }\n        else {\n            console.warn('Rank: openStoreListing is primarily intended for iOS identifiers on Web.');\n        }\n    }\n    /**\n     * Redirects to the developer's page in the store.\n     * @param options.devId The developer ID to navigate to.\n     */\n    async openDevPage(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        const url = isIOS\n            ? RankStoreUtils.appStoreSearchUrl(options.devId) // iOS uses search for dev pages often\n            : RankStoreUtils.playStoreDevUrl(options.devId);\n        window.open(url, '_blank');\n    }\n    /**\n     * On Web, collection navigation is not supported, so this method logs a warning.\n     * @param options Collection identification (not used on Web).\n     * @description This method is a no-op on Web and serves as a placeholder for potential future functionality.\n     */\n    async openCollection() {\n        console.warn('Rank: openCollection is not available on Web.');\n    }\n    /**\n     * On Web, search navigation is not supported, so this method logs a warning and opens a generic search URL.\n     * @param options Search terms for finding the app in the store (not used on Web).\n     * @description Redirects to a generic search page on the respective store as a fallback.\n     */\n    async search(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        const url = isIOS\n            ? RankStoreUtils.appStoreSearchUrl(options.terms)\n            : RankStoreUtils.playStoreSearchUrl(options.terms);\n        window.open(url, '_blank');\n    }\n    // --- Internal Helpers ---\n    /**\n     * Generates the appropriate store URL based on user agent and provided options.\n     * * @param options Store options containing identifiers.\n     * @returns A string representing the full store URL.\n     */\n    getStoreUrl(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        if (isIOS && options.appId) {\n            return RankStoreUtils.appStoreUrl(options.appId);\n        }\n        return RankStoreUtils.playStoreUrl(options.packageName);\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/**\n * Internal utility helpers for Store URL construction.\n * Not part of the public API.\n */\nclass RankStoreUtils {\n    static appStoreUrl(appId) {\n        return `https://apps.apple.com/app/id${appId}`;\n    }\n    static appStoreSearchUrl(terms) {\n        return `https://apps.apple.com/search?term=${encodeURIComponent(terms)}`;\n    }\n    static playStoreUrl(packageName) {\n        if (!packageName || packageName.trim().length === 0) {\n            console.warn('Rank: Missing Android packageName. Cannot construct Play Store URL.');\n            return '';\n        }\n        return `https://play.google.com/store/apps/details?id=${packageName}`;\n    }\n    static playStoreDevUrl(devId) {\n        return `https://play.google.com/store/apps/dev?id=${devId}`;\n    }\n    static playStoreSearchUrl(terms) {\n        return `https://play.google.com/store/search?q=${encodeURIComponent(terms)}&c=apps`;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["RankErrorCode","registerPlugin","WebPlugin"],"mappings":"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"}

package/dist/plugin.js

@@ -0,0 +1,207 @@
+var capacitorRank = (function (exports, core) {
+    'use strict';
+
+    /// <reference types="@capacitor/cli" />
+    /**
+     * Standardized error codes used by the Rank plugin.
+     *
+     * These codes are returned as part of structured error objects
+     * and allow consumers to implement programmatic error handling.
+     *
+     * @since 8.0.0
+     */
+    exports.RankErrorCode = void 0;
+    (function (RankErrorCode) {
+        /** The device does not have the requested hardware or the API is unavailable. */
+        RankErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+        /** The user denied a required permission or the feature is disabled. */
+        RankErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+        /** The Rank plugin failed to initialize (e.g., native SDK error). */
+        RankErrorCode["INIT_FAILED"] = "INIT_FAILED";
+        /** The requested operation or type is not valid or supported. */
+        RankErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+    })(exports.RankErrorCode || (exports.RankErrorCode = {}));
+
+    /**
+     * @file index.ts
+     * This file exports the Rank and registers it with Capacitor.
+     * It acts as the main entry point for accessing the plugin's functionality
+     * across different platforms, including web.
+     */
+    /**
+     * Main entry point for the Rank Capacitor plugin.
+     *
+     * This file registers the plugin with Capacitor and exports
+     * both the runtime instance and the public TypeScript types.
+     */
+    const Rank = core.registerPlugin('Rank', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.RankWeb()),
+    });
+
+    /**
+     * Web implementation of the Rank plugin.
+     *
+     * This implementation exists primarily to satisfy Capacitor's
+     * multi-platform contract and to allow usage in browser-based
+     * environments.
+     *
+     * Native-only features like the In-App Review prompt are unavailable on Web.
+     */
+    class RankWeb extends core.WebPlugin {
+        constructor() {
+            super();
+        }
+        // --- Availability ---
+        /**
+         * On Web, native In-App Review is never available.
+         */
+        async isAvailable() {
+            return { value: false };
+        }
+        /**
+         * On Web, the review environment is not available, so this method returns a default result.
+         */
+        async checkReviewEnvironment() {
+            return {
+                canRequestReview: false,
+            };
+        }
+        // --- In-App Review ---
+        /**
+         * Requests the display of the native review popup.
+         *
+         * On Web, this feature is not available.
+         */
+        async requestReview() {
+            throw this.unimplemented('In-App Review is not available on Web.');
+        }
+        // --- Product Page Navigation ---
+        /**
+         * On Web, redirects to the store URL as an internal overlay is not possible.
+         */
+        async presentProductPage(options) {
+            return this.openStore(options);
+        }
+        // --- Store Navigation ---
+        /**
+         * Opens the app's page in the App Store or Play Store via URL redirect.
+         * @description Detects the user's platform to provide the correct store link.
+         * @param options Store identification overrides including appId for iOS or packageName for Android.
+         */
+        async openStore(options) {
+            if (!(options === null || options === void 0 ? void 0 : options.appId) && !(options === null || options === void 0 ? void 0 : options.packageName)) {
+                console.warn('Rank: No App ID or Package Name provided. Store redirect skipped.');
+                return;
+            }
+            const url = this.getStoreUrl(options);
+            if (!url) {
+                // URL construction failed due to missing or invalid identifiers
+                return;
+            }
+            window.open(url, '_blank');
+        }
+        /**
+         * Opens the App Store listing page for a specific app via URL redirect.
+         * @param options Store identification options.
+         */
+        async openStoreListing(options) {
+            const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+            if (isIOS && (options === null || options === void 0 ? void 0 : options.appId)) {
+                window.open(RankStoreUtils.appStoreUrl(options.appId), '_blank');
+            }
+            else {
+                console.warn('Rank: openStoreListing is primarily intended for iOS identifiers on Web.');
+            }
+        }
+        /**
+         * Redirects to the developer's page in the store.
+         * @param options.devId The developer ID to navigate to.
+         */
+        async openDevPage(options) {
+            const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+            const url = isIOS
+                ? RankStoreUtils.appStoreSearchUrl(options.devId) // iOS uses search for dev pages often
+                : RankStoreUtils.playStoreDevUrl(options.devId);
+            window.open(url, '_blank');
+        }
+        /**
+         * On Web, collection navigation is not supported, so this method logs a warning.
+         * @param options Collection identification (not used on Web).
+         * @description This method is a no-op on Web and serves as a placeholder for potential future functionality.
+         */
+        async openCollection() {
+            console.warn('Rank: openCollection is not available on Web.');
+        }
+        /**
+         * On Web, search navigation is not supported, so this method logs a warning and opens a generic search URL.
+         * @param options Search terms for finding the app in the store (not used on Web).
+         * @description Redirects to a generic search page on the respective store as a fallback.
+         */
+        async search(options) {
+            const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+            const url = isIOS
+                ? RankStoreUtils.appStoreSearchUrl(options.terms)
+                : RankStoreUtils.playStoreSearchUrl(options.terms);
+            window.open(url, '_blank');
+        }
+        // --- Internal Helpers ---
+        /**
+         * Generates the appropriate store URL based on user agent and provided options.
+         * * @param options Store options containing identifiers.
+         * @returns A string representing the full store URL.
+         */
+        getStoreUrl(options) {
+            const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
+            if (isIOS && options.appId) {
+                return RankStoreUtils.appStoreUrl(options.appId);
+            }
+            return RankStoreUtils.playStoreUrl(options.packageName);
+        }
+        // --- 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: 'web' };
+        }
+    }
+    /**
+     * Internal utility helpers for Store URL construction.
+     * Not part of the public API.
+     */
+    class RankStoreUtils {
+        static appStoreUrl(appId) {
+            return `https://apps.apple.com/app/id${appId}`;
+        }
+        static appStoreSearchUrl(terms) {
+            return `https://apps.apple.com/search?term=${encodeURIComponent(terms)}`;
+        }
+        static playStoreUrl(packageName) {
+            if (!packageName || packageName.trim().length === 0) {
+                console.warn('Rank: Missing Android packageName. Cannot construct Play Store URL.');
+                return '';
+            }
+            return `https://play.google.com/store/apps/details?id=${packageName}`;
+        }
+        static playStoreDevUrl(devId) {
+            return `https://play.google.com/store/apps/dev?id=${devId}`;
+        }
+        static playStoreSearchUrl(terms) {
+            return `https://play.google.com/store/search?q=${encodeURIComponent(terms)}&c=apps`;
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        RankWeb: RankWeb
+    });
+
+    exports.Rank = Rank;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n/**\n * Standardized error codes used by the Rank plugin.\n *\n * These codes are returned as part of structured error objects\n * and allow consumers to implement programmatic error handling.\n *\n * @since 8.0.0\n */\nexport var RankErrorCode;\n(function (RankErrorCode) {\n    /** The device does not have the requested hardware or the API is unavailable. */\n    RankErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user denied a required permission or the feature is disabled. */\n    RankErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The Rank plugin failed to initialize (e.g., native SDK error). */\n    RankErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The requested operation or type is not valid or supported. */\n    RankErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n})(RankErrorCode || (RankErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","/**\n * @file index.ts\n * This file exports the Rank and registers it with Capacitor.\n * It acts as the main entry point for accessing the plugin's functionality\n * across different platforms, including web.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * Main entry point for the Rank Capacitor plugin.\n *\n * This file registers the plugin with Capacitor and exports\n * both the runtime instance and the public TypeScript types.\n */\nconst Rank = registerPlugin('Rank', {\n    web: () => import('./web').then((m) => new m.RankWeb()),\n});\nexport * from './definitions';\nexport { Rank };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the Rank plugin.\n *\n * This implementation exists primarily to satisfy Capacitor's\n * multi-platform contract and to allow usage in browser-based\n * environments.\n *\n * Native-only features like the In-App Review prompt are unavailable on Web.\n */\nexport class RankWeb extends WebPlugin {\n    constructor() {\n        super();\n    }\n    // --- Availability ---\n    /**\n     * On Web, native In-App Review is never available.\n     */\n    async isAvailable() {\n        return { value: false };\n    }\n    /**\n     * On Web, the review environment is not available, so this method returns a default result.\n     */\n    async checkReviewEnvironment() {\n        return {\n            canRequestReview: false,\n        };\n    }\n    // --- In-App Review ---\n    /**\n     * Requests the display of the native review popup.\n     *\n     * On Web, this feature is not available.\n     */\n    async requestReview() {\n        throw this.unimplemented('In-App Review is not available on Web.');\n    }\n    // --- Product Page Navigation ---\n    /**\n     * On Web, redirects to the store URL as an internal overlay is not possible.\n     */\n    async presentProductPage(options) {\n        return this.openStore(options);\n    }\n    // --- Store Navigation ---\n    /**\n     * Opens the app's page in the App Store or Play Store via URL redirect.\n     * @description Detects the user's platform to provide the correct store link.\n     * @param options Store identification overrides including appId for iOS or packageName for Android.\n     */\n    async openStore(options) {\n        if (!(options === null || options === void 0 ? void 0 : options.appId) && !(options === null || options === void 0 ? void 0 : options.packageName)) {\n            console.warn('Rank: No App ID or Package Name provided. Store redirect skipped.');\n            return;\n        }\n        const url = this.getStoreUrl(options);\n        if (!url) {\n            // URL construction failed due to missing or invalid identifiers\n            return;\n        }\n        window.open(url, '_blank');\n    }\n    /**\n     * Opens the App Store listing page for a specific app via URL redirect.\n     * @param options Store identification options.\n     */\n    async openStoreListing(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        if (isIOS && (options === null || options === void 0 ? void 0 : options.appId)) {\n            window.open(RankStoreUtils.appStoreUrl(options.appId), '_blank');\n        }\n        else {\n            console.warn('Rank: openStoreListing is primarily intended for iOS identifiers on Web.');\n        }\n    }\n    /**\n     * Redirects to the developer's page in the store.\n     * @param options.devId The developer ID to navigate to.\n     */\n    async openDevPage(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        const url = isIOS\n            ? RankStoreUtils.appStoreSearchUrl(options.devId) // iOS uses search for dev pages often\n            : RankStoreUtils.playStoreDevUrl(options.devId);\n        window.open(url, '_blank');\n    }\n    /**\n     * On Web, collection navigation is not supported, so this method logs a warning.\n     * @param options Collection identification (not used on Web).\n     * @description This method is a no-op on Web and serves as a placeholder for potential future functionality.\n     */\n    async openCollection() {\n        console.warn('Rank: openCollection is not available on Web.');\n    }\n    /**\n     * On Web, search navigation is not supported, so this method logs a warning and opens a generic search URL.\n     * @param options Search terms for finding the app in the store (not used on Web).\n     * @description Redirects to a generic search page on the respective store as a fallback.\n     */\n    async search(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        const url = isIOS\n            ? RankStoreUtils.appStoreSearchUrl(options.terms)\n            : RankStoreUtils.playStoreSearchUrl(options.terms);\n        window.open(url, '_blank');\n    }\n    // --- Internal Helpers ---\n    /**\n     * Generates the appropriate store URL based on user agent and provided options.\n     * * @param options Store options containing identifiers.\n     * @returns A string representing the full store URL.\n     */\n    getStoreUrl(options) {\n        const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);\n        if (isIOS && options.appId) {\n            return RankStoreUtils.appStoreUrl(options.appId);\n        }\n        return RankStoreUtils.playStoreUrl(options.packageName);\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/**\n * Internal utility helpers for Store URL construction.\n * Not part of the public API.\n */\nclass RankStoreUtils {\n    static appStoreUrl(appId) {\n        return `https://apps.apple.com/app/id${appId}`;\n    }\n    static appStoreSearchUrl(terms) {\n        return `https://apps.apple.com/search?term=${encodeURIComponent(terms)}`;\n    }\n    static playStoreUrl(packageName) {\n        if (!packageName || packageName.trim().length === 0) {\n            console.warn('Rank: Missing Android packageName. Cannot construct Play Store URL.');\n            return '';\n        }\n        return `https://play.google.com/store/apps/details?id=${packageName}`;\n    }\n    static playStoreDevUrl(devId) {\n        return `https://play.google.com/store/apps/dev?id=${devId}`;\n    }\n    static playStoreSearchUrl(terms) {\n        return `https://play.google.com/store/search?q=${encodeURIComponent(terms)}&c=apps`;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["RankErrorCode","registerPlugin","WebPlugin"],"mappings":"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"}

package/ios/Sources/RankPlugin/RankConfig.swift

@@ -0,0 +1,89 @@
+import Foundation
+import Capacitor
+
+/**
+ * Plugin configuration container for the Rank plugin.
+ *
+ * This struct is responsible for reading and exposing static configuration
+ * values defined under the `Rank` key in `capacitor.config.ts`.
+ *
+ * Architectural rules:
+ * - Read once during plugin initialization (`load()`).
+ * - Treated as immutable runtime input.
+ * - Consumed only by native code (never by JavaScript).
+ */
+public struct RankConfig {
+
+    // MARK: - Configuration Keys
+
+    /**
+     * Internal structure to maintain consistent configuration keys.
+     */
+    private struct Keys {
+        static let verboseLogging = "verboseLogging"
+        static let appleAppId = "appleAppId"
+        static let fireAndForget = "fireAndForget"
+    }
+
+    // MARK: - Public Properties
+
+    /**
+     * Enables verbose native logging via RankLogger.
+     *
+     * When enabled, additional debug information is printed to the Xcode console.
+     * Default: false
+     */
+    public let verboseLogging: Bool
+
+    /**
+     * Optional Apple App ID for App Store redirection.
+     *
+     * If provided, the plugin uses this ID to direct users to the specific review page.
+     * Default: nil
+     */
+    let appleAppId: String?
+
+    /**
+     * Global policy for review request resolution.
+     *
+     * If true, the plugin resolves promises immediately without awaiting OS feedback.
+     * Note: On iOS, this is the default behavior as StoreKit provides no completion callback.
+     * Default: false
+     */
+    let fireAndForget: Bool
+
+    // MARK: - Private Defaults
+
+    private static let defaultVerboseLogging: Bool = false
+    private static let defaultAppleAppId: String? = nil
+    private static let defaultFireAndForget: Bool = false
+
+    // MARK: - Initialization
+
+    /**
+     * Initializes the configuration by reading values from the Capacitor bridge.
+     *
+     * - Parameter plugin: The CAPPlugin instance used to access typed configuration via `getConfig()`.
+     */
+    init(plugin: CAPPlugin) {
+        let config = plugin.getConfig()
+
+        // Extract verboseLogging with fallback to default
+        self.verboseLogging = config.getBoolean(
+            Keys.verboseLogging,
+            Self.defaultVerboseLogging
+        )
+
+        // Extract optional appleAppId string
+        self.appleAppId = config.getString(
+            Keys.appleAppId,
+            Self.defaultAppleAppId
+        )
+
+        // Extract fireAndForget with fallback to default
+        self.fireAndForget = config.getBoolean(
+            Keys.fireAndForget,
+            Self.defaultFireAndForget
+        )
+    }
+}

package/ios/Sources/RankPlugin/RankError.swift

@@ -0,0 +1,49 @@
+import Foundation
+
+/**
+ Native error model for the Rank plugin (iOS).
+
+ This enum represents all error categories that can be
+ produced by the native implementation layer.
+
+ Architectural rules:
+ - Must NOT reference Capacitor
+ - Must NOT reference JavaScript
+ - Must be throwable from the Impl layer
+ - Mapping to JS-facing error codes happens ONLY in the Plugin layer
+ */
+enum RankError: Error {
+
+    /// Feature or capability is not available on this device or configuration
+    case unavailable(String)
+
+    /// Required permission was denied or not granted
+    case permissionDenied(String)
+
+    /// Plugin failed to initialize or perform a required operation
+    case initFailed(String)
+
+    /// Invalid or unsupported input was provided
+    case unknownType(String)
+
+    // MARK: - Human-readable message
+
+    /**
+     Human-readable error message.
+
+     This message is intended to be passed verbatim
+     to JavaScript via `call.reject(message, code)`.
+     */
+    var message: String {
+        switch self {
+        case .unavailable(let message):
+            return message
+        case .permissionDenied(let message):
+            return message
+        case .initFailed(let message):
+            return message
+        case .unknownType(let message):
+            return message
+        }
+    }
+}