@bates-solutions/squareup 0.1.0

package/dist/core/services/subscriptions.service.js

@@ -0,0 +1,265 @@
+import { parseSquareError, SquareValidationError } from '../errors.js';
+import { createIdempotencyKey } from '../utils.js';
+/**
+ * Subscriptions service for managing Square subscriptions
+ *
+ * @example
+ * ```typescript
+ * // Create a subscription
+ * const subscription = await square.subscriptions.create({
+ *   customerId: 'CUST_123',
+ *   planVariationId: 'PLAN_VAR_123',
+ * });
+ *
+ * // Cancel a subscription
+ * await square.subscriptions.cancel('SUB_123');
+ * ```
+ */
+export class SubscriptionsService {
+    client;
+    defaultLocationId;
+    constructor(client, defaultLocationId) {
+        this.client = client;
+        this.defaultLocationId = defaultLocationId;
+    }
+    /**
+     * Create a new subscription
+     *
+     * @param options - Subscription creation options
+     * @returns Created subscription
+     *
+     * @example
+     * ```typescript
+     * const subscription = await square.subscriptions.create({
+     *   customerId: 'CUST_123',
+     *   planVariationId: 'PLAN_VAR_123',
+     *   startDate: '2024-02-01',
+     * });
+     * ```
+     */
+    async create(options) {
+        const locationId = options.locationId ?? this.defaultLocationId;
+        if (!locationId) {
+            throw new SquareValidationError('locationId is required. Set it in client config or provide it explicitly.', 'locationId');
+        }
+        if (!options.customerId) {
+            throw new SquareValidationError('customerId is required', 'customerId');
+        }
+        if (!options.planVariationId) {
+            throw new SquareValidationError('planVariationId is required', 'planVariationId');
+        }
+        try {
+            const response = await this.client.subscriptions.create({
+                idempotencyKey: options.idempotencyKey ?? createIdempotencyKey(),
+                locationId,
+                customerId: options.customerId,
+                planVariationId: options.planVariationId,
+                startDate: options.startDate,
+                cardId: options.cardId,
+                timezone: options.timezone,
+                priceOverrideMoney: options.priceOverride
+                    ? {
+                        amount: BigInt(options.priceOverride),
+                        currency: 'USD',
+                    }
+                    : undefined,
+                taxPercentage: options.taxPercentage,
+            });
+            if (!response.subscription) {
+                throw new Error('Subscription was not created');
+            }
+            return response.subscription;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Get a subscription by ID
+     *
+     * @param subscriptionId - Subscription ID
+     * @returns Subscription details
+     *
+     * @example
+     * ```typescript
+     * const subscription = await square.subscriptions.get('SUB_123');
+     * ```
+     */
+    async get(subscriptionId) {
+        try {
+            const response = await this.client.subscriptions.get({ subscriptionId });
+            if (!response.subscription) {
+                throw new Error('Subscription not found');
+            }
+            return response.subscription;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Update a subscription
+     *
+     * @param subscriptionId - Subscription ID
+     * @param options - Update options
+     * @returns Updated subscription
+     *
+     * @example
+     * ```typescript
+     * const subscription = await square.subscriptions.update('SUB_123', {
+     *   priceOverride: 1500,
+     * });
+     * ```
+     */
+    async update(subscriptionId, options) {
+        try {
+            const response = await this.client.subscriptions.update({
+                subscriptionId,
+                subscription: {
+                    priceOverrideMoney: options.priceOverride
+                        ? {
+                            amount: BigInt(options.priceOverride),
+                            currency: 'USD',
+                        }
+                        : undefined,
+                    cardId: options.cardId,
+                    taxPercentage: options.taxPercentage,
+                },
+            });
+            if (!response.subscription) {
+                throw new Error('Subscription update failed');
+            }
+            return response.subscription;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Cancel a subscription
+     *
+     * @param subscriptionId - Subscription ID to cancel
+     * @returns Cancelled subscription
+     *
+     * @example
+     * ```typescript
+     * const subscription = await square.subscriptions.cancel('SUB_123');
+     * ```
+     */
+    async cancel(subscriptionId) {
+        try {
+            const response = await this.client.subscriptions.cancel({ subscriptionId });
+            if (!response.subscription) {
+                throw new Error('Subscription cancellation failed');
+            }
+            return response.subscription;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Pause a subscription
+     *
+     * @param subscriptionId - Subscription ID to pause
+     * @param options - Pause options
+     * @returns Paused subscription
+     *
+     * @example
+     * ```typescript
+     * const subscription = await square.subscriptions.pause('SUB_123', {
+     *   pauseEffectiveDate: '2024-03-01',
+     * });
+     * ```
+     */
+    async pause(subscriptionId, options) {
+        try {
+            const response = await this.client.subscriptions.pause({
+                subscriptionId,
+                pauseEffectiveDate: options?.pauseEffectiveDate,
+                pauseCycleDuration: options?.pauseCycleDuration
+                    ? BigInt(options.pauseCycleDuration)
+                    : undefined,
+            });
+            if (!response.subscription) {
+                throw new Error('Subscription pause failed');
+            }
+            return response.subscription;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Resume a paused subscription
+     *
+     * @param subscriptionId - Subscription ID to resume
+     * @param resumeEffectiveDate - Optional date to resume
+     * @returns Resumed subscription
+     *
+     * @example
+     * ```typescript
+     * const subscription = await square.subscriptions.resume('SUB_123');
+     * ```
+     */
+    async resume(subscriptionId, resumeEffectiveDate) {
+        try {
+            const response = await this.client.subscriptions.resume({
+                subscriptionId,
+                resumeEffectiveDate,
+            });
+            if (!response.subscription) {
+                throw new Error('Subscription resume failed');
+            }
+            return response.subscription;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Search for subscriptions
+     *
+     * @param options - Search options
+     * @returns Matching subscriptions with pagination
+     *
+     * @example
+     * ```typescript
+     * const results = await square.subscriptions.search({
+     *   customerId: 'CUST_123',
+     * });
+     * ```
+     */
+    async search(options) {
+        try {
+            const filters = [];
+            if (options?.customerId) {
+                filters.push({
+                    customerIds: [options.customerId],
+                });
+            }
+            if (options?.locationIds) {
+                filters.push({
+                    locationIds: options.locationIds,
+                });
+            }
+            const response = await this.client.subscriptions.search({
+                cursor: options?.cursor,
+                limit: options?.limit,
+                query: filters.length > 0
+                    ? {
+                        filter: filters.reduce((acc, f) => ({ ...acc, ...f }), {}),
+                    }
+                    : undefined,
+            });
+            return {
+                data: (response.subscriptions ?? []),
+                cursor: response.cursor,
+            };
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+}
+//# sourceMappingURL=subscriptions.service.js.map

package/dist/core/services/subscriptions.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.service.js","sourceRoot":"","sources":["../../../src/core/services/subscriptions.service.ts"],"names":[],"mappings":"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"}

package/dist/core/types/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Square environment configuration
+ */
+export type SquareEnvironment = 'sandbox' | 'production';
+/**
+ * Currency codes supported by Square
+ */
+export type CurrencyCode = 'USD' | 'CAD' | 'GBP' | 'EUR' | 'AUD' | 'JPY';
+/**
+ * Payment source identifier
+ * Can be a card nonce, card ID, or digital wallet token
+ */
+export type PaymentSource = string;
+/**
+ * Common pagination options
+ */
+export interface PaginationOptions {
+    cursor?: string;
+    limit?: number;
+}
+/**
+ * Common response with pagination
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    cursor?: string;
+}
+/**
+ * Simple money representation for API inputs
+ */
+export interface MoneyInput {
+    amount: number;
+    currency?: CurrencyCode;
+}
+/**
+ * Line item for orders
+ */
+export interface LineItemInput {
+    name?: string;
+    catalogObjectId?: string;
+    quantity?: number;
+    amount?: number;
+    note?: string;
+}
+/**
+ * Create payment options
+ */
+export interface CreatePaymentOptions {
+    sourceId: PaymentSource;
+    amount: number;
+    currency?: CurrencyCode;
+    customerId?: string;
+    orderId?: string;
+    referenceId?: string;
+    note?: string;
+    autocomplete?: boolean;
+    idempotencyKey?: string;
+}
+/**
+ * Create order options
+ */
+export interface CreateOrderOptions {
+    lineItems: LineItemInput[];
+    customerId?: string;
+    referenceId?: string;
+    idempotencyKey?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/core/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":""}

package/dist/core/utils.d.ts

@@ -0,0 +1,74 @@
+import type { CurrencyCode } from './types/index.js';
+/**
+ * Money representation
+ */
+export interface Money {
+    amount: bigint;
+    currency: CurrencyCode;
+}
+/**
+ * Convert a dollar amount to cents (smallest currency unit)
+ *
+ * @param amount - Dollar amount (e.g., 10.50)
+ * @param currency - Currency code (default: USD)
+ * @returns Amount in smallest currency unit (e.g., 1050 for $10.50 USD)
+ *
+ * @example
+ * ```typescript
+ * toCents(10.50) // 1050
+ * toCents(10.50, 'USD') // 1050
+ * toCents(1000, 'JPY') // 1000 (JPY has no decimal places)
+ * ```
+ */
+export declare function toCents(amount: number, currency?: CurrencyCode): bigint;
+/**
+ * Convert cents (smallest currency unit) to dollar amount
+ *
+ * @param cents - Amount in smallest currency unit
+ * @param currency - Currency code (default: USD)
+ * @returns Dollar amount
+ *
+ * @example
+ * ```typescript
+ * fromCents(1050n) // 10.50
+ * fromCents(1050n, 'USD') // 10.50
+ * fromCents(1000n, 'JPY') // 1000
+ * ```
+ */
+export declare function fromCents(cents: bigint | number, currency?: CurrencyCode): number;
+/**
+ * Format money for display
+ *
+ * @param cents - Amount in smallest currency unit
+ * @param currency - Currency code (default: USD)
+ * @param locale - Locale for formatting (default: en-US)
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```typescript
+ * formatMoney(1050n) // "$10.50"
+ * formatMoney(1050n, 'USD', 'en-US') // "$10.50"
+ * formatMoney(1000n, 'JPY', 'ja-JP') // "¥1,000"
+ * ```
+ */
+export declare function formatMoney(cents: bigint | number, currency?: CurrencyCode, locale?: string): string;
+/**
+ * Create a unique idempotency key for Square API requests
+ *
+ * @returns UUID string
+ *
+ * @example
+ * ```typescript
+ * const key = createIdempotencyKey();
+ * // "550e8400-e29b-41d4-a716-446655440000"
+ * ```
+ */
+export declare function createIdempotencyKey(): string;
+/**
+ * Convert Money object to Square API format
+ */
+export declare function toSquareMoney(amount: number | bigint, currency?: CurrencyCode): {
+    amount: bigint;
+    currency: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;CACxB;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAoB,GAAG,MAAM,CAI9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,YAAoB,GAAG,MAAM,CAIxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,YAAoB,EAC9B,MAAM,GAAE,MAAgB,GACvB,MAAM,CAMR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,GAAE,YAAoB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMtC"}

package/dist/core/utils.js

@@ -0,0 +1,96 @@
+import { randomUUID } from 'crypto';
+/**
+ * Zero-decimal currencies that don't use fractional units
+ */
+const ZERO_DECIMAL_CURRENCIES = ['JPY'];
+/**
+ * Get the multiplier for a currency
+ */
+function getCurrencyMultiplier(currency) {
+    return ZERO_DECIMAL_CURRENCIES.includes(currency) ? 1 : 100;
+}
+/**
+ * Convert a dollar amount to cents (smallest currency unit)
+ *
+ * @param amount - Dollar amount (e.g., 10.50)
+ * @param currency - Currency code (default: USD)
+ * @returns Amount in smallest currency unit (e.g., 1050 for $10.50 USD)
+ *
+ * @example
+ * ```typescript
+ * toCents(10.50) // 1050
+ * toCents(10.50, 'USD') // 1050
+ * toCents(1000, 'JPY') // 1000 (JPY has no decimal places)
+ * ```
+ */
+export function toCents(amount, currency = 'USD') {
+    const multiplier = getCurrencyMultiplier(currency);
+    // Use Math.round to handle floating point precision issues
+    return BigInt(Math.round(amount * multiplier));
+}
+/**
+ * Convert cents (smallest currency unit) to dollar amount
+ *
+ * @param cents - Amount in smallest currency unit
+ * @param currency - Currency code (default: USD)
+ * @returns Dollar amount
+ *
+ * @example
+ * ```typescript
+ * fromCents(1050n) // 10.50
+ * fromCents(1050n, 'USD') // 10.50
+ * fromCents(1000n, 'JPY') // 1000
+ * ```
+ */
+export function fromCents(cents, currency = 'USD') {
+    const multiplier = getCurrencyMultiplier(currency);
+    const value = typeof cents === 'bigint' ? Number(cents) : cents;
+    return value / multiplier;
+}
+/**
+ * Format money for display
+ *
+ * @param cents - Amount in smallest currency unit
+ * @param currency - Currency code (default: USD)
+ * @param locale - Locale for formatting (default: en-US)
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```typescript
+ * formatMoney(1050n) // "$10.50"
+ * formatMoney(1050n, 'USD', 'en-US') // "$10.50"
+ * formatMoney(1000n, 'JPY', 'ja-JP') // "¥1,000"
+ * ```
+ */
+export function formatMoney(cents, currency = 'USD', locale = 'en-US') {
+    const amount = fromCents(cents, currency);
+    return new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+    }).format(amount);
+}
+/**
+ * Create a unique idempotency key for Square API requests
+ *
+ * @returns UUID string
+ *
+ * @example
+ * ```typescript
+ * const key = createIdempotencyKey();
+ * // "550e8400-e29b-41d4-a716-446655440000"
+ * ```
+ */
+export function createIdempotencyKey() {
+    return randomUUID();
+}
+/**
+ * Convert Money object to Square API format
+ */
+export function toSquareMoney(amount, currency = 'USD') {
+    const cents = typeof amount === 'bigint' ? amount : toCents(amount, currency);
+    return {
+        amount: cents,
+        currency,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAWpC;;GAEG;AACH,MAAM,uBAAuB,GAAmB,CAAC,KAAK,CAAC,CAAC;AAExD;;GAEG;AACH,SAAS,qBAAqB,CAAC,QAAsB;IACnD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,WAAyB,KAAK;IACpE,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACnD,2DAA2D;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB,EAAE,WAAyB,KAAK;IAC9E,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,OAAO,KAAK,GAAG,UAAU,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,KAAsB,EACtB,WAAyB,KAAK,EAC9B,SAAiB,OAAO;IAExB,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QACnC,KAAK,EAAE,UAAU;QACjB,QAAQ;KACT,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAuB,EACvB,WAAyB,KAAK;IAE9B,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9E,OAAO;QACL,MAAM,EAAE,KAAK;QACb,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/react/SquareProvider.d.ts

@@ -0,0 +1,50 @@
+import React from 'react';
+import type { SquareProviderConfig, SquareContextValue } from './types.js';
+declare const SquareContext: React.Context<SquareContextValue | null>;
+/**
+ * Props for SquareProvider
+ */
+export interface SquareProviderProps extends SquareProviderConfig {
+    children: React.ReactNode;
+}
+/**
+ * Square Provider component that initializes the Web Payments SDK
+ *
+ * @example
+ * ```tsx
+ * import { SquareProvider } from '@bates-solutions/squareup/react';
+ *
+ * function App() {
+ *   return (
+ *     <SquareProvider
+ *       applicationId="sq0idp-xxx"
+ *       locationId="LXXX"
+ *       environment="sandbox"
+ *     >
+ *       <Checkout />
+ *     </SquareProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function SquareProvider({ children, applicationId, locationId, environment, accessToken, currency, }: SquareProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access Square context
+ *
+ * @throws Error if used outside of SquareProvider
+ *
+ * @example
+ * ```tsx
+ * function Checkout() {
+ *   const { sdkLoaded, payments, error } = useSquare();
+ *
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!sdkLoaded) return <div>Loading...</div>;
+ *
+ *   return <div>Ready to accept payments!</div>;
+ * }
+ * ```
+ */
+export declare function useSquare(): SquareContextValue;
+export { SquareContext };
+//# sourceMappingURL=SquareProvider.d.ts.map

package/dist/react/SquareProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SquareProvider.d.ts","sourceRoot":"","sources":["../../src/react/SquareProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkE,MAAM,OAAO,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAY,MAAM,YAAY,CAAC;AAErF,QAAA,MAAM,aAAa,0CAAiD,CAAC;AAwCrE;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,aAAa,EACb,UAAU,EACV,WAAuB,EACvB,WAAW,EACX,QAAgB,GACjB,EAAE,mBAAmB,2CAqErB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAQ9C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}