@purchasely/cordova-plugin-purchasely 6.0.0-rc.3 → 6.0.1

package/Package.swift

@@ -0,0 +1,77 @@
+// swift-tools-version:5.9
+//
+// Swift Package Manager manifest for the iOS plugin.
+//
+// `plugin.xml` marks the ios platform with package="swift", which makes two hosts read
+// this file instead of building the plugin through CocoaPods:
+//
+//   * Cordova iOS 8 and later (Apache's own mechanism)
+//   * Capacitor in SPM mode, which is the Capacitor 8 default
+//
+// Capacitor is the reason this exists. Its SPM path never reads <podspec>, so before this
+// manifest a Capacitor 8 app scaffolded with the default package manager linked the plugin
+// with no Purchasely SDK behind it at all, silently.
+//
+// The <podspec> block stays in plugin.xml for CocoaPods consumers: Cordova iOS 7 and
+// earlier, and Capacitor in CocoaPods mode. Its pod carries nospm="true" so Cordova iOS 8
+// does not install the pod AND this package and link Purchasely twice.
+//
+// KEEP THE FIRST DEPENDENCY EXACTLY AS WRITTEN, AND ADD NO PROSE ABOVE IT.
+// The Capacitor CLI rewrites this file in place on every sync
+// (@capacitor/cli, dist/ios/update.js:83-89). It rewrites the first occurrence of the
+// Apache org slug, every occurrence of the upstream repository slug, and then pins the
+// version by replacing everything between the rewritten URL and the next ")". Both slugs
+// are lowercase and hyphenated, and both first appear in the Cordova dependency below.
+// Writing either one in a comment above that line silently retargets the URL to a
+// repository that does not exist, and the plugin then builds with no SDK. The rewrite is
+// idempotent, and this comment is deliberately written without those two literals.
+//
+// Note for local development: npm installs a `file:` dependency as a symlink, so a
+// `npx cap sync` in a sample app that consumes this plugin by path rewrites THIS file in
+// the repository, not a copy. Check `git status` after syncing a local sample.
+//
+// The package and product names must equal the npm package id: the Capacitor CLI hardcodes
+// `plugin.id` on both sides of the generated dependency (dist/util/spm.js:110-112, :164).
+
+import PackageDescription
+
+let package = Package(
+    name: "@purchasely/cordova-plugin-purchasely",
+    // 13.0, not higher: Cordova iOS 8 builds its aggregate CordovaPlugins target at 13.0,
+    // and a package declaring more fails the build outright ("requires minimum platform
+    // version 15.0 ... but this target supports 13.0"). The Purchasely xcframework itself
+    // is built for iOS 13.4, so that floor still applies at link time, exactly as it does
+    // through the podspec.
+    platforms: [.iOS(.v13)],
+    products: [
+        .library(
+            name: "@purchasely/cordova-plugin-purchasely",
+            targets: ["PurchaselyCordovaPlugin"]
+        )
+    ],
+    dependencies: [
+        .package(url: "https://github.com/apache/cordova-ios.git", from: "8.0.0"),
+        // exact, not `from:`. A range permits any 6.x, so a fresh resolve picks up
+        // whatever is newest while the podspec pins one version and VERSIONS.md
+        // documents another. That makes the linked SDK depend on install time and lets
+        // the two integration paths drift apart. Bump this with the podspec, in the
+        // same commit, and VERSIONS.md with it.
+        .package(url: "https://github.com/Purchasely/Purchasely-iOS.git", exact: "6.0.1")
+    ],
+    targets: [
+        .target(
+            name: "PurchaselyCordovaPlugin",
+            dependencies: [
+                .product(name: "Cordova", package: "cordova-ios"),
+                .product(name: "Purchasely", package: "Purchasely-iOS")
+            ],
+            path: "src/ios",
+            publicHeadersPath: ".",
+            cSettings: [
+                // The Hybrid/ type-marshalling headers are imported unqualified from the
+                // sources next to them, so their directory has to be on the search path.
+                .headerSearchPath("Hybrid")
+            ]
+        )
+    ]
+)

package/README.md

@@ -29,24 +29,32 @@ Purchasely.start(
     }
 );
 
-Purchasely.presentPresentationWithIdentifier(
-    'my_presentation_id', // may be null
-    'my_content_id', // may be null
-    Purchasely.TransitionType.fullScreen, // display mode
-    (callback) => {
-        console.log(callback);
-        if(callback.result == Purchasely.PurchaseResult.CANCELLED) {
-            console.log("User cancelled purchased");
+Purchasely.presentation
+    .placement('my_placement_id') // or .screen('my_presentation_id'), .defaultSource()
+    .contentId('my_content_id') // may be omitted
+    .build()
+    .display(Purchasely.TransitionType.fullScreen) // display mode
+    .then((outcome) => {
+        console.log(outcome);
+        if (outcome.purchaseResult === 'purchased') {
+            console.log("User purchased " + outcome.plan.name);
+        } else if (outcome.purchaseResult === 'cancelled') {
+            console.log("User cancelled purchase");
         } else {
-            console.log("User purchased " + callback.plan.name);
+            console.log("Dismissed", outcome.closeReason);
         }
-    },
-    (error) => {
-        console.log("Error with purchase : " + error);
-    }
-);
+    });
 ```
 
+## Limitations
+
+- **No inline/embedded paywall view.** iOS, Android, Flutter and React Native all support
+  embedding a paywall directly inside a screen (`PLYPresentationView` / `buildView` /
+  `getFragment`). This is not available on Cordova: the plugin only supports
+  modal/fullscreen/push presentation via the presentation builder
+  (`Purchasely.presentation.…build().display()`). Embedding a native view inside the WebView
+  isn't supported by this bridge architecture; this is an accepted platform limitation, not a bug.
+
 ## 🏁 Documentation
 
 A complete documentation is available on our website [https://docs.purchasely.com](https://docs.purchasely.com/quick-start/sdk-installation/cordova)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purchasely/cordova-plugin-purchasely",
-  "version": "6.0.0-rc.3",
+  "version": "6.0.1",
   "description": "Purchasely is a solution to ease the integration and boost your In-App Purchases & Subscriptions on the App Store, Google Play Store, Amazon Appstore and Huawei App Gallery.",
   "cordova": {
     "id": "@purchasely/cordova-plugin-purchasely",
@@ -41,6 +41,12 @@
   "author": "Purchasely",
   "license": "ISC",
   "main": "index.js",
+  "files": [
+    "src",
+    "www",
+    "plugin.xml",
+    "Package.swift"
+  ],
   "directories": {
     "example": "example"
   },
@@ -57,5 +63,8 @@
   "bugs": {
     "url": "https://github.com/Purchasely/Purchasely-Cordova/issues"
   },
-  "homepage": "https://github.com/Purchasely/Purchasely-Cordova#readme"
+  "homepage": "https://github.com/Purchasely/Purchasely-Cordova#readme",
+  "overrides": {
+    "js-yaml@3": "^3.15.1"
+  }
 }

package/plugin.xml

@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='utf-8'?>
-<plugin id="@purchasely/cordova-plugin-purchasely" version="6.0.0-rc.3" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
+<plugin id="@purchasely/cordova-plugin-purchasely" version="6.0.1" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
     <name>Purchasely</name>
     <js-module name="Purchasely" src="www/Purchasely.js">
         <clobbers target="Purchasely" />
@@ -8,7 +8,7 @@
         <engine name="cordova" version=">=11.0.0"/>
         <engine name="cordova-android" version=">=12.0.0"/>
    </engines>
-    <platform name="ios">
+    <platform name="ios" package="swift">
         <config-file parent="/*" target="config.xml">
             <feature name="Purchasely">
               <param name="ios-package" value="CDVPurchasely" />
@@ -38,7 +38,7 @@
                 <source url="https://github.com/CocoaPods/Specs.git"/>
             </config>
             <pods use-frameworks="true">
-                <pod name="Purchasely" spec="6.0.0-rc.3"/>
+                <pod name="Purchasely" spec="6.0.1" nospm="true"/>
             </pods>
         </podspec>
     </platform>
@@ -53,7 +53,7 @@
             <preference name="GradlePluginKotlinCodeStyle" value="official" />
         </config-file>
         <framework src="src/android/build-extras.gradle" custom="true" type="gradleReference" />
-        <framework src="io.purchasely:core:6.0.0-rc.3" />
+        <framework src="io.purchasely:core:6.0.2" />
         <source-file src="src/android/PurchaselyPlugin.kt" target-dir="java/cordova/plugin/purchasely" />
     </platform>
 </plugin>