chore: import upstream snapshot with attribution

apps/sim/tools/revenuecat/defer_google_subscription.ts

@@ -0,0 +1,108 @@
+import type {
+  DeferGoogleSubscriptionParams,
+  DeferGoogleSubscriptionResponse,
+} from '@/tools/revenuecat/types'
+import {
+  extractSubscriber,
+  SUBSCRIBER_OUTPUT,
+  shapeSubscriber,
+  throwIfRevenueCatError,
+} from '@/tools/revenuecat/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const revenuecatDeferGoogleSubscriptionTool: ToolConfig<
+  DeferGoogleSubscriptionParams,
+  DeferGoogleSubscriptionResponse
+> = {
+  id: 'revenuecat_defer_google_subscription',
+  name: 'RevenueCat Defer Google Subscription',
+  description:
+    'Defer a Google Play subscription by extending its billing date by a number of days (Google Play only)',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'RevenueCat secret API key (sk_...)',
+    },
+    appUserId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The app user ID of the subscriber',
+    },
+    productId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'The Google Play product identifier of the subscription to defer (use the part before the colon for products set up after Feb 2023)',
+    },
+    extendByDays: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Number of days to extend the subscription by (1-365). Provide either extendByDays or expiryTimeMs.',
+    },
+    expiryTimeMs: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Absolute new expiry time in milliseconds since Unix epoch. Use instead of extendByDays to set an exact expiry.',
+    },
+  },
+
+  request: {
+    url: (params) =>
+      `https://api.revenuecat.com/v1/subscribers/${encodeURIComponent(params.appUserId.trim())}/subscriptions/${encodeURIComponent(params.productId.trim())}/defer`,
+    method: 'POST',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => {
+      const hasExtend = params.extendByDays !== undefined && (params.extendByDays as unknown) !== ''
+      const hasExpiry = params.expiryTimeMs !== undefined && (params.expiryTimeMs as unknown) !== ''
+      if (!hasExtend && !hasExpiry) {
+        throw new Error('Provide either extendByDays or expiryTimeMs to defer a subscription')
+      }
+      if (hasExtend && hasExpiry) {
+        throw new Error(
+          'Provide only one of extendByDays or expiryTimeMs — they cannot be used together'
+        )
+      }
+      const body: Record<string, unknown> = {}
+      if (hasExpiry) body.expiry_time_ms = params.expiryTimeMs
+      else if (hasExtend) {
+        const days = params.extendByDays as number
+        if (!Number.isInteger(days) || days < 1 || days > 365) {
+          throw new Error('extendByDays must be an integer between 1 and 365')
+        }
+        body.extend_by_days = days
+      }
+      return body
+    },
+  },
+
+  transformResponse: async (response) => {
+    await throwIfRevenueCatError(response)
+    const data = await response.json()
+    return {
+      success: true,
+      output: {
+        subscriber: shapeSubscriber(extractSubscriber(data)),
+      },
+    }
+  },
+
+  outputs: {
+    subscriber: {
+      ...SUBSCRIBER_OUTPUT,
+      description: 'The updated subscriber object after deferring the Google subscription',
+    },
+  },
+}