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 = {} 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', }, }, }