Add support for SPM (Swift Package Manager)

[ptmkenny]

Thank you for this great plugin. I tried to test it in the iOS Simulator. I have subscriptions configured in the App Store, so I wrote a hook like this to fetch them:

/**
 * Copyright 2025 Edo Sensei LLC. All rights reserved.
 */
import { ProductId } from '@enums/ProductId';
import { useQuery } from '@tanstack/react-query';
import {
  Subscriptions,
  type ProductDetailsResponse,
} from '@squareetlabs/capacitor-subscriptions';

type SubscriptionProductDetails = {
  monthly: ProductDetailsResponse;
  annual: ProductDetailsResponse;
};

export function useSubscriptionProductDetails() {
  return useQuery<SubscriptionProductDetails | string>({
    queryKey: ['subscriptionProductDetails'],
    queryFn: async (): Promise<SubscriptionProductDetails | string> => {
      try {
        const [monthlyResult, annualResult] = await Promise.allSettled([
          Subscriptions.getProductDetails({
            productIdentifier: ProductId.SubMonthly,
          }),
          Subscriptions.getProductDetails({
            productIdentifier: ProductId.SubAnnual,
          }),
        ]);

        const monthly =
          monthlyResult.status === 'fulfilled' ? monthlyResult.value : null;
        const annual =
          annualResult.status === 'fulfilled' ? annualResult.value : null;

        console.log('monthly', monthlyResult);
        console.log('annual', annualResult);
        // Check for errors in the responses
        if (monthly?.responseCode !== 0 || annual?.responseCode !== 0) {
          const errors = [];
          if (monthly?.responseCode !== 0) {
            errors.push(
              `Monthly: ${monthly?.responseMessage ?? 'Unknown error'}`,
            );
          }
          if (annual?.responseCode !== 0) {
            errors.push(
              `Annual: ${annual?.responseMessage ?? 'Unknown error'}`,
            );
          }
          const noTranslateErrorMessage = `Failed to fetch products. ${errors.join(' ')}`;
          return noTranslateErrorMessage;
        }

        return {
          monthly,
          annual,
        };
      } catch (error) {
        const noTranslateErrorMessage = `Error fetching subscription products: ${error instanceof Error ? error.message : String(error)}`;
        return noTranslateErrorMessage;
      }
    },
  });
}

I then built my app and tested it in iOS Simulator (iOS 26, iPhone Pro).

console.log() debug says iOS is not supported:

reason: Error: "Subscriptions" plugin is not implemented on ios

code: "UNIMPLEMENTED"

column: 195

data: undefined

line: 1

message: "\"Subscriptions\" plugin is not implemented on ios"

sourceURL: "capacitor://localhost/cap.DpLzyGxs.js"

stack: "C@capacitor://localhost/cap.DpLzyGxs.js:1:195↵X@capacitor://localhost/cap.DpLzyGxs.js:1:1349↵@capacitor://localhost/cap.DpLzyGxs.js:1:1471"

C Prototype

status: "rejected"

Does this mean the simulator is not supported, or am I doing something wrong?

[jcancig]

It appears that the installation, synchronization, or compilation was not successful.
Please check the following:

A) App Store Connect (once per product)

1. Create a Subscription Group and add your auto-renewable subscriptions (monthly, yearly, etc.). Assign levels and prices. Copy the product identifiers (e.g., com.yourapp.premium.monthly).

B) Xcode (capability + StoreKit Testing)

1. In your target → Signing & Capabilities → add In-App Purchase.
2. (Optional for local testing) Create a StoreKit Configuration File: File → New → File… → StoreKit Configuration File.
   Add your products or sync with App Store Connect (“Sync this file with an app in App Store Connect”).
3. Select that .storekit in Scheme → Edit Scheme… → Run → Options → StoreKit Configuration and run in Simulator. This allows simulated purchases/renewals without touching Apple servers.

Note: For end-to-end testing (real receipts, server notifications), use Sandbox on a physical device; auto-renewals are accelerated for testing.

[ptmkenny]

Thank you for the very quick response. I didn't know about the StoreKit Configuration File, so that's very helpful.

More debugging (I had the same issue with the StoreKit Configuration File and when testing on an actual device) led me to the actual issue: my capacitor app uses SPM (https://capacitorjs.com/docs/ios/spm), but this plugin seems to only support CocoaPods. SPM is Apple's "official" package manager so it would be great to add support for this. https://capacitorjs.com/docs/ios/spm#converting-existing-plugins-to-spm