@bates-solutions/squareup 0.1.0

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

@@ -0,0 +1,297 @@
+import { parseSquareError, SquareValidationError } from '../errors.js';
+import { createIdempotencyKey } from '../utils.js';
+/**
+ * Invoices service for managing Square invoices
+ *
+ * @example
+ * ```typescript
+ * // Create an invoice
+ * const invoice = await square.invoices.create({
+ *   customerId: 'CUST_123',
+ *   lineItems: [
+ *     { name: 'Consulting', quantity: 2, amount: 15000 },
+ *   ],
+ *   dueDate: '2024-02-15',
+ * });
+ *
+ * // Publish (send) the invoice
+ * await square.invoices.publish(invoice.id, invoice.version);
+ * ```
+ */
+export class InvoicesService {
+    client;
+    defaultLocationId;
+    constructor(client, defaultLocationId) {
+        this.client = client;
+        this.defaultLocationId = defaultLocationId;
+    }
+    /**
+     * Create a draft invoice
+     *
+     * @param options - Invoice creation options
+     * @returns Created invoice (in DRAFT status)
+     *
+     * @example
+     * ```typescript
+     * const invoice = await square.invoices.create({
+     *   customerId: 'CUST_123',
+     *   lineItems: [
+     *     { name: 'Web Development', quantity: 10, amount: 10000 },
+     *     { name: 'Design Services', quantity: 5, amount: 7500 },
+     *   ],
+     *   title: 'January Services',
+     *   dueDate: '2024-02-01',
+     *   deliveryMethod: 'EMAIL',
+     * });
+     * ```
+     */
+    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.lineItems.length === 0) {
+            throw new SquareValidationError('At least one line item is required', 'lineItems');
+        }
+        try {
+            // First create an order for the invoice
+            const orderResponse = await this.client.orders.create({
+                order: {
+                    locationId,
+                    customerId: options.customerId,
+                    lineItems: options.lineItems.map((item) => ({
+                        name: item.name,
+                        quantity: String(item.quantity),
+                        basePriceMoney: {
+                            amount: BigInt(item.amount),
+                            currency: item.currency ?? 'USD',
+                        },
+                        note: item.description,
+                    })),
+                },
+                idempotencyKey: createIdempotencyKey(),
+            });
+            if (!orderResponse.order?.id) {
+                throw new Error('Failed to create order for invoice');
+            }
+            // Create the invoice
+            const response = await this.client.invoices.create({
+                invoice: {
+                    locationId,
+                    orderId: orderResponse.order.id,
+                    primaryRecipient: {
+                        customerId: options.customerId,
+                    },
+                    title: options.title,
+                    description: options.description,
+                    invoiceNumber: options.invoiceNumber,
+                    deliveryMethod: options.deliveryMethod ?? 'EMAIL',
+                    paymentRequests: [
+                        {
+                            requestType: 'BALANCE',
+                            dueDate: options.dueDate,
+                            tippingEnabled: options.tippingEnabled ?? false,
+                        },
+                    ],
+                },
+                idempotencyKey: options.idempotencyKey ?? createIdempotencyKey(),
+            });
+            if (!response.invoice) {
+                throw new Error('Invoice was not created');
+            }
+            return response.invoice;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Get an invoice by ID
+     *
+     * @param invoiceId - Invoice ID
+     * @returns Invoice details
+     *
+     * @example
+     * ```typescript
+     * const invoice = await square.invoices.get('INV_123');
+     * ```
+     */
+    async get(invoiceId) {
+        try {
+            const response = await this.client.invoices.get({ invoiceId });
+            if (!response.invoice) {
+                throw new Error('Invoice not found');
+            }
+            return response.invoice;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Publish (send) an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @param version - Invoice version (for optimistic concurrency)
+     * @returns Published invoice
+     *
+     * @example
+     * ```typescript
+     * const invoice = await square.invoices.publish('INV_123', 0);
+     * console.log(`Invoice sent: ${invoice.publicUrl}`);
+     * ```
+     */
+    async publish(invoiceId, version) {
+        try {
+            const response = await this.client.invoices.publish({
+                invoiceId,
+                version,
+                idempotencyKey: createIdempotencyKey(),
+            });
+            if (!response.invoice) {
+                throw new Error('Invoice publish failed');
+            }
+            return response.invoice;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Cancel an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @param version - Invoice version (for optimistic concurrency)
+     * @returns Cancelled invoice
+     *
+     * @example
+     * ```typescript
+     * const invoice = await square.invoices.cancel('INV_123', 1);
+     * ```
+     */
+    async cancel(invoiceId, version) {
+        try {
+            const response = await this.client.invoices.cancel({
+                invoiceId,
+                version,
+            });
+            if (!response.invoice) {
+                throw new Error('Invoice cancellation failed');
+            }
+            return response.invoice;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Update an invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @param version - Invoice version (for optimistic concurrency)
+     * @param options - Update options
+     * @returns Updated invoice
+     *
+     * @example
+     * ```typescript
+     * const invoice = await square.invoices.update('INV_123', 0, {
+     *   title: 'Updated Title',
+     * });
+     * ```
+     */
+    async update(invoiceId, version, options) {
+        try {
+            const fieldsToClear = [];
+            if (options.title === '')
+                fieldsToClear.push('title');
+            if (options.description === '')
+                fieldsToClear.push('description');
+            const response = await this.client.invoices.update({
+                invoiceId,
+                invoice: {
+                    version,
+                    title: options.title ?? undefined,
+                    description: options.description ?? undefined,
+                    paymentRequests: options.dueDate
+                        ? [
+                            {
+                                requestType: 'BALANCE',
+                                dueDate: options.dueDate,
+                            },
+                        ]
+                        : undefined,
+                },
+                idempotencyKey: createIdempotencyKey(),
+                fieldsToClear: fieldsToClear.length > 0 ? fieldsToClear : undefined,
+            });
+            if (!response.invoice) {
+                throw new Error('Invoice update failed');
+            }
+            return response.invoice;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Delete a draft invoice
+     *
+     * @param invoiceId - Invoice ID
+     * @param version - Invoice version
+     *
+     * @example
+     * ```typescript
+     * await square.invoices.delete('INV_123', 0);
+     * ```
+     */
+    async delete(invoiceId, version) {
+        try {
+            await this.client.invoices.delete({ invoiceId, version });
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Search for invoices
+     *
+     * @param options - Search options
+     * @returns Matching invoices with pagination
+     *
+     * @example
+     * ```typescript
+     * const results = await square.invoices.search({
+     *   customerId: 'CUST_123',
+     * });
+     * ```
+     */
+    async search(options) {
+        const locationIds = options?.locationIds ?? (this.defaultLocationId ? [this.defaultLocationId] : []);
+        if (locationIds.length === 0) {
+            throw new SquareValidationError('At least one locationId is required for search');
+        }
+        try {
+            const response = await this.client.invoices.search({
+                query: {
+                    filter: {
+                        locationIds,
+                        customerIds: options?.customerId ? [options.customerId] : undefined,
+                    },
+                },
+                cursor: options?.cursor,
+                limit: options?.limit,
+            });
+            return {
+                data: (response.invoices ?? []),
+                cursor: response.cursor,
+            };
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+}
+//# sourceMappingURL=invoices.service.js.map

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

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

package/dist/core/services/loyalty.service.d.ts

@@ -0,0 +1,282 @@
+import type { SquareClient } from 'square';
+/**
+ * Loyalty account from Square API
+ */
+export interface LoyaltyAccount {
+    id?: string;
+    programId?: string;
+    balance?: number;
+    lifetimePoints?: number;
+    customerId?: string;
+    enrolledAt?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    mapping?: {
+        id?: string;
+        phoneNumber?: string;
+    };
+    expiringPointDeadlines?: Array<{
+        points?: number;
+        expiresAt?: string;
+    }>;
+}
+/**
+ * Loyalty program from Square API
+ */
+export interface LoyaltyProgram {
+    id?: string;
+    status?: 'INACTIVE' | 'ACTIVE';
+    rewardTiers?: Array<{
+        id?: string;
+        points?: number;
+        name?: string;
+        definition?: {
+            scope?: string;
+            discountType?: string;
+            percentageDiscount?: string;
+            catalogObjectIds?: string[];
+        };
+        createdAt?: string;
+        pricingRuleReference?: {
+            objectId?: string;
+            catalogVersion?: bigint;
+        };
+    }>;
+    terminology?: {
+        one?: string;
+        other?: string;
+    };
+    locationIds?: string[];
+    createdAt?: string;
+    updatedAt?: string;
+    accrualRules?: Array<{
+        accrualType?: string;
+        points?: number;
+        visitData?: {
+            minimumAmountMoney?: {
+                amount?: bigint;
+                currency?: string;
+            };
+            taxMode?: string;
+        };
+        spendData?: {
+            amountMoney?: {
+                amount?: bigint;
+                currency?: string;
+            };
+            excludedCategoryIds?: string[];
+            excludedItemVariationIds?: string[];
+            taxMode?: string;
+        };
+    }>;
+    expirationPolicy?: {
+        expirationDuration?: string;
+    };
+}
+/**
+ * Loyalty event from Square API
+ */
+export interface LoyaltyEvent {
+    id?: string;
+    type?: string;
+    createdAt?: string;
+    loyaltyAccountId?: string;
+    source?: string;
+    accumulatePoints?: {
+        loyaltyProgramId?: string;
+        points?: number;
+        orderId?: string;
+    };
+    redeemReward?: {
+        loyaltyProgramId?: string;
+        rewardId?: string;
+        orderId?: string;
+    };
+    adjustPoints?: {
+        loyaltyProgramId?: string;
+        points?: number;
+        reason?: string;
+    };
+}
+/**
+ * Options for creating a loyalty account
+ */
+export interface CreateLoyaltyAccountOptions {
+    programId: string;
+    phoneNumber?: string;
+    customerId?: string;
+    idempotencyKey?: string;
+}
+/**
+ * Loyalty service for managing Square loyalty programs
+ *
+ * @example
+ * ```typescript
+ * // Create a loyalty account
+ * const account = await square.loyalty.createAccount({
+ *   programId: 'PROG_123',
+ *   phoneNumber: '+15551234567',
+ * });
+ *
+ * // Add points
+ * await square.loyalty.accumulatePoints(account.id, {
+ *   points: 100,
+ * });
+ *
+ * // Redeem a reward
+ * await square.loyalty.redeemReward(account.id, 'REWARD_123');
+ * ```
+ */
+export declare class LoyaltyService {
+    private readonly client;
+    private readonly defaultLocationId?;
+    constructor(client: SquareClient, defaultLocationId?: string | undefined);
+    /**
+     * Get the loyalty program for the current location
+     *
+     * @param programId - Optional program ID (uses main program if not provided)
+     * @returns Loyalty program details
+     *
+     * @example
+     * ```typescript
+     * const program = await square.loyalty.getProgram();
+     * console.log(`Points name: ${program.terminology?.other}`);
+     * ```
+     */
+    getProgram(programId?: string): Promise<LoyaltyProgram>;
+    /**
+     * Create a new loyalty account
+     *
+     * @param options - Account creation options
+     * @returns Created loyalty account
+     *
+     * @example
+     * ```typescript
+     * const account = await square.loyalty.createAccount({
+     *   programId: 'PROG_123',
+     *   phoneNumber: '+15551234567',
+     * });
+     * ```
+     */
+    createAccount(options: CreateLoyaltyAccountOptions): Promise<LoyaltyAccount>;
+    /**
+     * Get a loyalty account by ID
+     *
+     * @param accountId - Loyalty account ID
+     * @returns Loyalty account details
+     *
+     * @example
+     * ```typescript
+     * const account = await square.loyalty.getAccount('ACCT_123');
+     * console.log(`Balance: ${account.balance} points`);
+     * ```
+     */
+    getAccount(accountId: string): Promise<LoyaltyAccount>;
+    /**
+     * Search for loyalty accounts
+     *
+     * @param options - Search options
+     * @returns Matching loyalty accounts
+     *
+     * @example
+     * ```typescript
+     * // Find by phone number
+     * const accounts = await square.loyalty.searchAccounts({
+     *   phoneNumber: '+15551234567',
+     * });
+     *
+     * // Find by customer ID
+     * const accounts = await square.loyalty.searchAccounts({
+     *   customerId: 'CUST_123',
+     * });
+     * ```
+     */
+    searchAccounts(options?: {
+        phoneNumber?: string;
+        customerId?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        data: LoyaltyAccount[];
+        cursor?: string;
+    }>;
+    /**
+     * Accumulate (add) points to a loyalty account
+     *
+     * @param accountId - Loyalty account ID
+     * @param options - Accumulation options
+     * @returns Loyalty event
+     *
+     * @example
+     * ```typescript
+     * // Add points from an order
+     * await square.loyalty.accumulatePoints('ACCT_123', {
+     *   orderId: 'ORDER_456',
+     * });
+     *
+     * // Add points manually
+     * await square.loyalty.accumulatePoints('ACCT_123', {
+     *   points: 50,
+     * });
+     * ```
+     */
+    accumulatePoints(accountId: string, options: {
+        orderId?: string;
+        points?: number;
+        idempotencyKey?: string;
+    }): Promise<LoyaltyEvent>;
+    /**
+     * Adjust points on a loyalty account (add or subtract)
+     *
+     * @param accountId - Loyalty account ID
+     * @param points - Points to add (positive) or subtract (negative)
+     * @param reason - Reason for adjustment
+     * @returns Loyalty event
+     *
+     * @example
+     * ```typescript
+     * // Add bonus points
+     * await square.loyalty.adjustPoints('ACCT_123', 100, 'Birthday bonus');
+     *
+     * // Remove points
+     * await square.loyalty.adjustPoints('ACCT_123', -50, 'Points correction');
+     * ```
+     */
+    adjustPoints(accountId: string, points: number, reason?: string, idempotencyKey?: string): Promise<LoyaltyEvent>;
+    /**
+     * Redeem a reward
+     *
+     * @param accountId - Loyalty account ID
+     * @param rewardTierId - Reward tier ID to redeem
+     * @param orderId - Optional order ID to apply reward to
+     * @returns Created reward
+     *
+     * @example
+     * ```typescript
+     * const reward = await square.loyalty.redeemReward(
+     *   'ACCT_123',
+     *   'TIER_123',
+     *   'ORDER_456'
+     * );
+     * ```
+     */
+    redeemReward(accountId: string, rewardTierId: string, orderId?: string, idempotencyKey?: string): Promise<{
+        id: string;
+        status: string;
+    }>;
+    /**
+     * Calculate points that would be earned for an order
+     *
+     * @param programId - Loyalty program ID
+     * @param orderId - Order ID to calculate points for
+     * @returns Points that would be earned
+     *
+     * @example
+     * ```typescript
+     * const points = await square.loyalty.calculatePoints('PROG_123', 'ORDER_123');
+     * console.log(`This order earns ${points} points`);
+     * ```
+     */
+    calculatePoints(programId: string, orderId: string): Promise<number>;
+}
+//# sourceMappingURL=loyalty.service.d.ts.map

package/dist/core/services/loyalty.service.d.ts.map

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