@bates-solutions/squareup 0.1.0

package/dist/react/hooks/useSquarePayment.js

@@ -0,0 +1,146 @@
+import { useState, useCallback, useRef, useEffect } from 'react';
+import { useSquare } from '../SquareProvider.js';
+/**
+ * Hook for integrating Square Web Payments SDK card input
+ *
+ * @param options - Configuration options
+ * @returns Card input ref, tokenize function, and state
+ *
+ * @example
+ * ```tsx
+ * function Checkout() {
+ *   const { cardRef, tokenize, ready, loading, error } = useSquarePayment({
+ *     onReady: () => console.log('Card input ready'),
+ *     onTokenize: (token) => console.log('Token:', token),
+ *     onError: (err) => console.error('Error:', err),
+ *   });
+ *
+ *   const handlePay = async () => {
+ *     try {
+ *       const token = await tokenize();
+ *       // Send token to your server to complete payment
+ *     } catch (err) {
+ *       console.error('Tokenization failed:', err);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <div ref={cardRef} />
+ *       <button onClick={handlePay} disabled={!ready || loading}>
+ *         Pay
+ *       </button>
+ *       {error && <p>Error: {error.message}</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useSquarePayment(options = {}) {
+    const { cardOptions, onReady, onTokenize, onError } = options;
+    const { payments, sdkLoaded, error: sdkError } = useSquare();
+    const [card, setCard] = useState(null);
+    const [ready, setReady] = useState(false);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(sdkError);
+    const containerRef = useRef(null);
+    const cardRef = useRef(null);
+    // Update error state when SDK error changes
+    useEffect(() => {
+        if (sdkError) {
+            setError(sdkError);
+            onError?.(sdkError);
+        }
+    }, [sdkError, onError]);
+    // Initialize card when SDK is loaded
+    useEffect(() => {
+        if (!sdkLoaded || !payments || !containerRef.current) {
+            return;
+        }
+        let mounted = true;
+        async function initializeCard() {
+            if (!payments)
+                return;
+            try {
+                const cardInstance = await payments.card(cardOptions);
+                if (!mounted || !containerRef.current) {
+                    await cardInstance.destroy();
+                    return;
+                }
+                await cardInstance.attach(containerRef.current);
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                if (!mounted) {
+                    await cardInstance.destroy();
+                    return;
+                }
+                cardRef.current = cardInstance;
+                setCard(cardInstance);
+                setReady(true);
+                setError(null);
+                onReady?.();
+            }
+            catch (err) {
+                if (!mounted)
+                    return;
+                const error = err instanceof Error ? err : new Error('Failed to initialize card');
+                setError(error);
+                onError?.(error);
+            }
+        }
+        void initializeCard();
+        return () => {
+            mounted = false;
+            if (cardRef.current) {
+                void cardRef.current.destroy();
+                cardRef.current = null;
+            }
+        };
+    }, [sdkLoaded, payments, cardOptions, onReady, onError]);
+    /**
+     * Tokenize the card input
+     * @returns Payment token
+     */
+    const tokenize = useCallback(async () => {
+        if (!card) {
+            throw new Error('Card input not initialized');
+        }
+        setLoading(true);
+        setError(null);
+        try {
+            const result = await card.tokenize();
+            if (result.status === 'OK' && result.token) {
+                onTokenize?.(result.token);
+                return result.token;
+            }
+            if (result.status === 'Cancel') {
+                throw new Error('Tokenization was cancelled');
+            }
+            const errorMessage = result.errors?.map((e) => e.message).join(', ') ?? 'Tokenization failed';
+            throw new Error(errorMessage);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Tokenization failed');
+            setError(error);
+            onError?.(error);
+            throw error;
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [card, onTokenize, onError]);
+    /**
+     * Ref callback to attach container element
+     */
+    const cardRefCallback = useCallback((element) => {
+        containerRef.current = element;
+    }, []);
+    return {
+        cardRef: cardRefCallback,
+        tokenize,
+        card,
+        ready,
+        loading,
+        error,
+    };
+}
+//# sourceMappingURL=useSquarePayment.js.map

package/dist/react/hooks/useSquarePayment.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,8 @@
+export { SquareProvider, useSquare, SquareContext } from './SquareProvider.js';
+export type { SquareProviderProps } from './SquareProvider.js';
+export { useSquarePayment, usePayments, useOrders, useCustomers, useCatalog, } from './hooks/index.js';
+export type { UseSquarePaymentOptions, CreatePaymentInput, PaymentResponse, UsePaymentsOptions, UsePaymentsReturn, OrderLineItemInput, CreateOrderInput, OrderResponse, UseOrdersOptions, UseOrdersReturn, CustomerAddressInput, CustomerInput, CustomerResponse, UseCustomersOptions, UseCustomersReturn, CatalogObjectType, CatalogItemResponse, CatalogSearchOptions, UseCatalogOptions, UseCatalogReturn, } from './hooks/index.js';
+export { CardInput, PaymentButton } from './components/index.js';
+export type { CardInputProps, CardInputHandle, PaymentMethodType, PaymentButtonProps, } from './components/index.js';
+export type { SquareProviderConfig, SquareContextValue, UseSquarePaymentState, UseSquarePaymentReturn, MutationState, QueryState, Payments, Card, GooglePay, ApplePay, GiftCard, Ach, CardOptions, CardStyle, DigitalWalletOptions, TokenResult, TokenError, VerificationDetails, VerificationResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,UAAU,EAEV,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,GAAG,EACH,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,7 @@
+// Provider and context
+export { SquareProvider, useSquare, SquareContext } from './SquareProvider.js';
+// Hooks
+export { useSquarePayment, usePayments, useOrders, useCustomers, useCatalog, } from './hooks/index.js';
+// Components
+export { CardInput, PaymentButton } from './components/index.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG/E,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAC;AAwB1B,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/react/types.d.ts

@@ -0,0 +1,183 @@
+import type { SquareEnvironment, CurrencyCode } from '../core/types/index.js';
+/**
+ * Square Provider configuration
+ */
+export interface SquareProviderConfig {
+    /** Square Application ID */
+    applicationId: string;
+    /** Square Location ID */
+    locationId: string;
+    /** Environment (sandbox or production) */
+    environment?: SquareEnvironment;
+    /** Access token for server-side operations (optional, for SSR) */
+    accessToken?: string;
+    /** Default currency */
+    currency?: CurrencyCode;
+}
+/**
+ * Square context value
+ */
+export interface SquareContextValue {
+    /** Configuration */
+    config: SquareProviderConfig;
+    /** Whether the Web Payments SDK is loaded */
+    sdkLoaded: boolean;
+    /** Square Payments instance */
+    payments: Payments | null;
+    /** Error if SDK failed to load */
+    error: Error | null;
+}
+/**
+ * Web Payments SDK types
+ * These are simplified types for the Square Web Payments SDK
+ */
+export interface Payments {
+    card: (options?: CardOptions) => Promise<Card>;
+    googlePay: (options: GooglePayOptions) => Promise<GooglePay>;
+    applePay: (options: ApplePayOptions) => Promise<ApplePay>;
+    giftCard: (options?: GiftCardOptions) => Promise<GiftCard>;
+    ach: (options?: AchOptions) => Promise<Ach>;
+    verifyBuyer: (sourceId: string, verificationDetails: VerificationDetails) => Promise<VerificationResult>;
+}
+export interface Card {
+    attach: (element: HTMLElement | string) => Promise<void>;
+    detach: () => Promise<void>;
+    destroy: () => Promise<void>;
+    tokenize: () => Promise<TokenResult>;
+    configure: (options: CardOptions) => Promise<void>;
+    addEventListener: (event: CardEventType, callback: CardEventCallback) => void;
+    removeEventListener: (event: CardEventType, callback: CardEventCallback) => void;
+}
+export interface GooglePay {
+    attach: (element: HTMLElement | string, options?: DigitalWalletOptions) => Promise<void>;
+    destroy: () => Promise<void>;
+    tokenize: () => Promise<TokenResult>;
+}
+export interface ApplePay {
+    attach: (element: HTMLElement | string, options?: DigitalWalletOptions) => Promise<void>;
+    destroy: () => Promise<void>;
+    tokenize: () => Promise<TokenResult>;
+}
+export interface GiftCard {
+    attach: (element: HTMLElement | string) => Promise<void>;
+    destroy: () => Promise<void>;
+    tokenize: () => Promise<TokenResult>;
+}
+export interface Ach {
+    tokenize: (options: AchTokenizeOptions) => Promise<TokenResult>;
+}
+export interface CardOptions {
+    style?: CardStyle;
+    postalCode?: string;
+}
+export interface CardStyle {
+    '.input-container'?: CSSStyleDeclaration;
+    '.input-container.is-focus'?: CSSStyleDeclaration;
+    '.input-container.is-error'?: CSSStyleDeclaration;
+    '.message-text'?: CSSStyleDeclaration;
+    '.message-icon'?: CSSStyleDeclaration;
+    '.message-text.is-error'?: CSSStyleDeclaration;
+    input?: CSSStyleDeclaration;
+    'input::placeholder'?: CSSStyleDeclaration;
+    'input.is-error'?: CSSStyleDeclaration;
+}
+export interface GooglePayOptions {
+    redirectURL?: string;
+}
+export interface ApplePayOptions {
+    redirectURL?: string;
+}
+export interface GiftCardOptions {
+    style?: CardStyle;
+}
+export interface AchOptions {
+    redirectURL?: string;
+}
+export interface AchTokenizeOptions {
+    accountHolderName: string;
+    intent?: 'CHARGE' | 'STORE';
+}
+export interface DigitalWalletOptions {
+    buttonColor?: 'default' | 'black' | 'white';
+    buttonSizeMode?: 'fill' | 'static';
+    buttonType?: 'buy' | 'donate' | 'plain' | 'order' | 'pay' | 'tip';
+}
+export interface TokenResult {
+    status: 'OK' | 'Cancel' | 'Error';
+    token?: string;
+    errors?: TokenError[];
+    details?: {
+        card?: {
+            brand: string;
+            lastFour: string;
+            expMonth: number;
+            expYear: number;
+        };
+        billing?: {
+            postalCode?: string;
+        };
+        method?: 'Card' | 'GooglePay' | 'ApplePay' | 'GiftCard' | 'Ach';
+    };
+}
+export interface TokenError {
+    type: string;
+    message: string;
+    field?: string;
+}
+export interface VerificationDetails {
+    amount: string;
+    currencyCode: string;
+    intent: 'CHARGE' | 'STORE';
+    billingContact?: {
+        addressLines?: string[];
+        city?: string;
+        countryCode?: string;
+        email?: string;
+        familyName?: string;
+        givenName?: string;
+        phone?: string;
+        postalCode?: string;
+        state?: string;
+    };
+}
+export interface VerificationResult {
+    token: string;
+    userChallenged: boolean;
+}
+export type CardEventType = 'ready' | 'focusClassAdded' | 'focusClassRemoved' | 'errorClassAdded' | 'errorClassRemoved' | 'cardBrandChanged' | 'postalCodeChanged' | 'escape' | 'submit';
+export type CardEventCallback = (event: CardEvent) => void;
+export interface CardEvent {
+    cardBrand?: string;
+    postalCodeValue?: string;
+}
+/**
+ * Hook state types
+ */
+export interface UseSquarePaymentState {
+    ready: boolean;
+    error: Error | null;
+    loading: boolean;
+}
+export interface UseSquarePaymentReturn extends UseSquarePaymentState {
+    cardRef: React.RefCallback<HTMLDivElement>;
+    tokenize: () => Promise<string>;
+    card: Card | null;
+}
+/**
+ * Mutation hook state
+ */
+export interface MutationState<T> {
+    data: T | null;
+    error: Error | null;
+    loading: boolean;
+}
+/**
+ * Query hook state
+ */
+export interface QueryState<T> {
+    data: T | null;
+    error: Error | null;
+    loading: boolean;
+    refetch: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"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"}

package/dist/react/types.js

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

package/dist/react/types.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @bates-solutions/squareup/server
+ *
+ * Server utilities for handling Square webhooks
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router
+ * import { createNextWebhookHandler } from '@bates-solutions/squareup/server';
+ *
+ * export const POST = createNextWebhookHandler({
+ *   signatureKey: process.env.SQUARE_WEBHOOK_KEY!,
+ *   handlers: {
+ *     'payment.created': async (event) => {
+ *       console.log('Payment:', event.data.id);
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * import express from 'express';
+ * import { createExpressWebhookHandler } from '@bates-solutions/squareup/server';
+ *
+ * const app = express();
+ * app.use('/webhook', express.raw({ type: 'application/json' }));
+ * app.post('/webhook', createExpressWebhookHandler({
+ *   signatureKey: process.env.SQUARE_WEBHOOK_KEY!,
+ *   handlers: {
+ *     'payment.created': async (event) => {
+ *       console.log('Payment:', event.data.id);
+ *     },
+ *   },
+ * }));
+ * ```
+ */
+export type { WebhookEventType, PaymentEventType, RefundEventType, OrderEventType, CustomerEventType, SubscriptionEventType, InvoiceEventType, LoyaltyEventType, CatalogEventType, InventoryEventType, TeamEventType, LaborEventType, WebhookEvent, WebhookHandler, WebhookHandlers, WebhookConfig, WebhookVerificationResult, ParsedWebhookRequest, } from './types.js';
+export { SIGNATURE_HEADER, verifySignature, parseWebhookEvent, parseAndVerifyWebhook, processWebhookEvent, createWebhookProcessor, } from './webhook.js';
+export { createExpressWebhookHandler, rawBodyMiddleware, type SquareWebhookRequest, type ExpressWebhookOptions, } from './middleware/express.js';
+export { createNextWebhookHandler, createNextPagesWebhookHandler, parseNextWebhook, type WebhookResponse, } from './middleware/nextjs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,45 @@
+/**
+ * @bates-solutions/squareup/server
+ *
+ * Server utilities for handling Square webhooks
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router
+ * import { createNextWebhookHandler } from '@bates-solutions/squareup/server';
+ *
+ * export const POST = createNextWebhookHandler({
+ *   signatureKey: process.env.SQUARE_WEBHOOK_KEY!,
+ *   handlers: {
+ *     'payment.created': async (event) => {
+ *       console.log('Payment:', event.data.id);
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * import express from 'express';
+ * import { createExpressWebhookHandler } from '@bates-solutions/squareup/server';
+ *
+ * const app = express();
+ * app.use('/webhook', express.raw({ type: 'application/json' }));
+ * app.post('/webhook', createExpressWebhookHandler({
+ *   signatureKey: process.env.SQUARE_WEBHOOK_KEY!,
+ *   handlers: {
+ *     'payment.created': async (event) => {
+ *       console.log('Payment:', event.data.id);
+ *     },
+ *   },
+ * }));
+ * ```
+ */
+// Core webhook utilities
+export { SIGNATURE_HEADER, verifySignature, parseWebhookEvent, parseAndVerifyWebhook, processWebhookEvent, createWebhookProcessor, } from './webhook.js';
+// Express middleware
+export { createExpressWebhookHandler, rawBodyMiddleware, } from './middleware/express.js';
+// Next.js handlers
+export { createNextWebhookHandler, createNextPagesWebhookHandler, parseNextWebhook, } from './middleware/nextjs.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAwBH,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,qBAAqB;AACrB,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,GAGlB,MAAM,yBAAyB,CAAC;AAEjC,mBAAmB;AACnB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC"}

package/dist/server/middleware/express.d.ts

@@ -0,0 +1,77 @@
+import type { Request, RequestHandler } from 'express';
+import type { WebhookConfig, WebhookEvent } from '../types.js';
+/**
+ * Extended Express Request with Square webhook data
+ */
+export interface SquareWebhookRequest extends Request {
+    /** The raw request body as a string */
+    rawBody?: string;
+    /** The parsed Square webhook event */
+    squareEvent?: WebhookEvent;
+}
+/**
+ * Options for the Express webhook middleware
+ */
+export interface ExpressWebhookOptions extends WebhookConfig {
+    /**
+     * Path to mount the webhook handler
+     * @default '/webhook'
+     */
+    path?: string;
+    /**
+     * Whether to send response automatically
+     * @default true
+     */
+    autoRespond?: boolean;
+}
+/**
+ * Create Express middleware for handling Square webhooks
+ *
+ * This middleware:
+ * 1. Captures the raw body for signature verification
+ * 2. Verifies the webhook signature
+ * 3. Parses the event and attaches it to the request
+ * 4. Calls the appropriate handler
+ *
+ * @param config - Webhook configuration
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createExpressWebhookHandler } from '@bates-solutions/squareup/server';
+ *
+ * const app = express();
+ *
+ * // IMPORTANT: Use raw body parser for webhook route
+ * app.use('/webhook', express.raw({ type: 'application/json' }));
+ *
+ * app.post('/webhook', createExpressWebhookHandler({
+ *   signatureKey: process.env.SQUARE_WEBHOOK_KEY!,
+ *   handlers: {
+ *     'payment.created': async (event) => {
+ *       console.log('Payment created:', event.data.id);
+ *     },
+ *   },
+ * }));
+ * ```
+ */
+export declare function createExpressWebhookHandler(config: ExpressWebhookOptions): RequestHandler;
+/**
+ * Raw body parser middleware for Express
+ *
+ * Captures the raw body before JSON parsing for signature verification.
+ * Use this if you need to parse JSON but also need the raw body.
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { rawBodyMiddleware } from '@bates-solutions/squareup/server';
+ *
+ * const app = express();
+ * app.use('/webhook', rawBodyMiddleware);
+ * app.use('/webhook', express.json());
+ * ```
+ */
+export declare const rawBodyMiddleware: RequestHandler;
+//# sourceMappingURL=express.d.ts.map

package/dist/server/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/server/middleware/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA0B,cAAc,EAAE,MAAM,SAAS,CAAC;AAO/E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,OAAO;IACnD,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,qBAAqB,GAC5B,cAAc,CA2EhB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAiB/B,CAAC"}