@bates-solutions/squareup 0.1.0

package/dist/angular/square.module.js

@@ -0,0 +1,75 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var SquareModule_1;
+import { NgModule, InjectionToken, Optional, SkipSelf, } from '@angular/core';
+/**
+ * Injection token for Square configuration
+ */
+export const SQUARE_CONFIG = new InjectionToken('SQUARE_CONFIG');
+/**
+ * Square Angular module
+ *
+ * @example
+ * ```typescript
+ * import { SquareModule } from '@bates-solutions/squareup/angular';
+ *
+ * @NgModule({
+ *   imports: [
+ *     SquareModule.forRoot({
+ *       applicationId: 'sq0idp-xxx',
+ *       locationId: 'LXXX',
+ *       environment: 'sandbox',
+ *     })
+ *   ]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let SquareModule = SquareModule_1 = class SquareModule {
+    constructor(parentModule) {
+        if (parentModule) {
+            throw new Error('SquareModule is already loaded. Import it in the AppModule only using forRoot().');
+        }
+    }
+    /**
+     * Configure the Square module with application settings
+     *
+     * @param config - Square configuration options
+     * @returns Module with providers
+     */
+    static forRoot(config) {
+        return {
+            ngModule: SquareModule_1,
+            providers: [
+                {
+                    provide: SQUARE_CONFIG,
+                    useValue: {
+                        environment: 'sandbox',
+                        currency: 'USD',
+                        ...config,
+                    },
+                },
+            ],
+        };
+    }
+};
+SquareModule = SquareModule_1 = __decorate([
+    NgModule({})
+    // eslint-disable-next-line @typescript-eslint/no-extraneous-class
+    ,
+    __param(0, Optional()),
+    __param(0, SkipSelf()),
+    __metadata("design:paramtypes", [SquareModule])
+], SquareModule);
+export { SquareModule };
+//# sourceMappingURL=square.module.js.map

package/dist/angular/square.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"square.module.js","sourceRoot":"","sources":["../../src/angular/square.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,OAAO,EACL,QAAQ,EAER,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,eAAe,CAAC;AAGvB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,cAAc,CAAe,eAAe,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AAGI,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB,YAAoC,YAA2B;QAC7D,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAoB;QACjC,OAAO;YACL,QAAQ,EAAE,cAAY;YACtB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,aAAa;oBACtB,QAAQ,EAAE;wBACR,WAAW,EAAE,SAAS;wBACtB,QAAQ,EAAE,KAAK;wBACf,GAAG,MAAM;qBACV;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA9BY,YAAY;IAFxB,QAAQ,CAAC,EAAE,CAAC;IACb,kEAAkE;;IAEnD,WAAA,QAAQ,EAAE,CAAA;IAAE,WAAA,QAAQ,EAAE,CAAA;qCAAgB,YAAY;GADpD,YAAY,CA8BxB"}

package/dist/angular/types.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Angular-specific types for Square integration
+ */
+/**
+ * Square module configuration
+ */
+export interface SquareConfig {
+    /** Square application ID */
+    applicationId: string;
+    /** Square location ID */
+    locationId: string;
+    /** Environment (sandbox or production) */
+    environment?: 'sandbox' | 'production';
+    /** Access token for server-side operations */
+    accessToken?: string;
+    /** Default currency code */
+    currency?: string;
+}
+/**
+ * Square Web Payments SDK types
+ */
+export interface Payments {
+    card(options?: CardOptions): Promise<Card>;
+    googlePay(options: GooglePayOptions): Promise<GooglePay>;
+    applePay(options: ApplePayOptions): Promise<ApplePay>;
+}
+export interface Card {
+    attach(element: HTMLElement): Promise<void>;
+    destroy(): Promise<void>;
+    tokenize(): Promise<TokenResult>;
+}
+export interface GooglePay {
+    attach(element: HTMLElement, options?: DigitalWalletOptions): Promise<void>;
+    destroy(): Promise<void>;
+    tokenize(): Promise<TokenResult>;
+}
+export interface ApplePay {
+    attach(element: HTMLElement, options?: DigitalWalletOptions): Promise<void>;
+    destroy(): Promise<void>;
+    tokenize(): Promise<TokenResult>;
+}
+export interface CardOptions {
+    style?: CardStyle;
+}
+export interface CardStyle {
+    '.input-container'?: Record<string, string>;
+    '.input-container.is-focus'?: Record<string, string>;
+    '.input-container.is-error'?: Record<string, string>;
+    '.message-text'?: Record<string, string>;
+    '.message-icon'?: Record<string, string>;
+    '.message-text.is-error'?: Record<string, string>;
+    input?: Record<string, string>;
+    'input.is-focus'?: Record<string, string>;
+    'input::placeholder'?: Record<string, string>;
+}
+export interface GooglePayOptions {
+    redirectURL?: string;
+}
+export interface ApplePayOptions {
+    redirectURL?: string;
+}
+export interface DigitalWalletOptions {
+    buttonColor?: 'default' | 'black' | 'white';
+    buttonSizeMode?: 'fill' | 'static';
+    buttonType?: 'long' | 'short';
+}
+export interface TokenResult {
+    status: 'OK' | 'Cancel' | 'Error';
+    token?: string;
+    errors?: TokenError[];
+}
+export interface TokenError {
+    type: string;
+    message: string;
+    field?: string;
+}
+/**
+ * Injection token for Square configuration
+ */
+export declare const SQUARE_CONFIG = "SQUARE_CONFIG";
+/**
+ * Payment request types
+ */
+export interface CreatePaymentRequest {
+    sourceId: string;
+    amount: number;
+    currency?: string;
+    idempotencyKey?: string;
+    customerId?: string;
+    orderId?: string;
+    note?: string;
+    referenceId?: string;
+}
+/**
+ * Order types
+ */
+export interface CreateOrderRequest {
+    lineItems?: OrderLineItem[];
+    discounts?: OrderDiscount[];
+    taxes?: OrderTax[];
+    serviceCharges?: OrderServiceCharge[];
+    fulfillments?: OrderFulfillment[];
+    customerId?: string;
+    referenceId?: string;
+    note?: string;
+}
+export interface OrderLineItem {
+    name?: string;
+    quantity: string;
+    catalogObjectId?: string;
+    variationName?: string;
+    basePriceMoney?: Money;
+    note?: string;
+}
+export interface OrderDiscount {
+    name?: string;
+    percentage?: string;
+    amountMoney?: Money;
+    scope?: 'LINE_ITEM' | 'ORDER';
+}
+export interface OrderTax {
+    name?: string;
+    percentage?: string;
+    scope?: 'LINE_ITEM' | 'ORDER';
+}
+export interface OrderServiceCharge {
+    name?: string;
+    percentage?: string;
+    amountMoney?: Money;
+}
+export interface OrderFulfillment {
+    type: 'PICKUP' | 'SHIPMENT' | 'DELIVERY';
+    state?: string;
+    pickupDetails?: PickupDetails;
+    shipmentDetails?: ShipmentDetails;
+}
+export interface PickupDetails {
+    recipient?: Recipient;
+    scheduleType?: 'SCHEDULED' | 'ASAP';
+    pickupAt?: string;
+    note?: string;
+}
+export interface ShipmentDetails {
+    recipient?: Recipient;
+    carrier?: string;
+    trackingNumber?: string;
+}
+export interface Recipient {
+    displayName?: string;
+    emailAddress?: string;
+    phoneNumber?: string;
+}
+export interface Money {
+    amount: number;
+    currency?: string;
+}
+/**
+ * Customer types
+ */
+export interface CreateCustomerRequest {
+    givenName?: string;
+    familyName?: string;
+    companyName?: string;
+    emailAddress?: string;
+    phoneNumber?: string;
+    address?: Address;
+    note?: string;
+    referenceId?: string;
+}
+export interface Address {
+    addressLine1?: string;
+    addressLine2?: string;
+    locality?: string;
+    administrativeDistrictLevel1?: string;
+    postalCode?: string;
+    country?: string;
+}
+/**
+ * Catalog types
+ */
+export interface CatalogSearchRequest {
+    textFilter?: string;
+    categoryIds?: string[];
+    stockLevels?: string[];
+    enabledLocationIds?: string[];
+    limit?: number;
+    cursor?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/angular/types.js

@@ -0,0 +1,8 @@
+/**
+ * Angular-specific types for Square integration
+ */
+/**
+ * Injection token for Square configuration
+ */
+export const SQUARE_CONFIG = 'SQUARE_CONFIG';
+//# sourceMappingURL=types.js.map

package/dist/angular/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/angular/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuFH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC"}

package/dist/core/builders/order.builder.d.ts

@@ -0,0 +1,140 @@
+import type { SquareClient } from 'square';
+import type { CurrencyCode, LineItemInput } from '../types/index.js';
+/**
+ * Order line item type for internal use
+ */
+interface OrderLineItem {
+    quantity: string;
+    catalogObjectId?: string;
+    name?: string;
+    basePriceMoney?: {
+        amount: bigint;
+        currency: CurrencyCode;
+    };
+    note?: string;
+}
+/**
+ * Order type from Square API
+ */
+export interface Order {
+    id?: string;
+    locationId?: string;
+    referenceId?: string;
+    customerId?: string;
+    lineItems?: OrderLineItem[];
+    totalMoney?: {
+        amount?: bigint;
+        currency?: string;
+    };
+    state?: string;
+    version?: number;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * Fluent builder for creating Square orders
+ *
+ * @example
+ * ```typescript
+ * const order = await square.orders
+ *   .builder()
+ *   .addItem({ name: 'Latte', amount: 450 })
+ *   .addItem({ catalogObjectId: 'ITEM_123', quantity: 2 })
+ *   .withTip(100)
+ *   .withCustomer('CUST_123')
+ *   .build();
+ * ```
+ */
+export declare class OrderBuilder {
+    private readonly client;
+    private readonly locationId;
+    private lineItems;
+    private customerId?;
+    private referenceId?;
+    private tipAmount?;
+    private currency;
+    constructor(client: SquareClient, locationId: string);
+    /**
+     * Set the currency for the order
+     *
+     * @param currency - Currency code
+     * @returns Builder instance for chaining
+     */
+    withCurrency(currency: CurrencyCode): this;
+    /**
+     * Add a line item to the order
+     *
+     * @param item - Line item details
+     * @returns Builder instance for chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .addItem({ name: 'Coffee', amount: 350 })
+     *   .addItem({ catalogObjectId: 'ITEM_123', quantity: 2 })
+     * ```
+     */
+    addItem(item: LineItemInput): this;
+    /**
+     * Add multiple line items at once
+     *
+     * @param items - Array of line items
+     * @returns Builder instance for chaining
+     */
+    addItems(items: LineItemInput[]): this;
+    /**
+     * Add a tip to the order
+     *
+     * @param amount - Tip amount in cents
+     * @returns Builder instance for chaining
+     */
+    withTip(amount: number): this;
+    /**
+     * Associate a customer with the order
+     *
+     * @param customerId - Square customer ID
+     * @returns Builder instance for chaining
+     */
+    withCustomer(customerId: string): this;
+    /**
+     * Add a reference ID for external tracking
+     *
+     * @param referenceId - External reference ID
+     * @returns Builder instance for chaining
+     */
+    withReference(referenceId: string): this;
+    /**
+     * Add a note to the order
+     *
+     * @param note - Order note
+     * @returns Builder instance for chaining
+     */
+    withNote(_note: string): this;
+    /**
+     * Build and create the order
+     *
+     * @returns Created order
+     *
+     * @throws {SquareValidationError} When validation fails
+     * @throws {SquareApiError} When API call fails
+     */
+    build(): Promise<Order>;
+    /**
+     * Preview the order without creating it
+     * Returns the order configuration that would be sent
+     */
+    preview(): {
+        locationId: string;
+        lineItems: OrderLineItem[];
+        customerId?: string;
+        referenceId?: string;
+        tipAmount?: bigint;
+        currency: CurrencyCode;
+    };
+    /**
+     * Reset the builder to start fresh
+     */
+    reset(): this;
+}
+export {};
+//# sourceMappingURL=order.builder.d.ts.map

package/dist/core/builders/order.builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.builder.d.ts","sourceRoot":"","sources":["../../../src/core/builders/order.builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIrE;;GAEG;AACH,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,YAAY,CAAC;KACxB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IAQrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAuB;gBAGpB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM;IAGrC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAK1C;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IA6BlC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAOtC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK7B;;;;;OAKG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKtC;;;;;OAKG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IA0B7B;;;OAGG;IACH,OAAO,IAAI;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,aAAa,EAAE,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,YAAY,CAAC;KACxB;IAWD;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd"}

package/dist/core/builders/order.builder.js

@@ -0,0 +1,185 @@
+import { parseSquareError, SquareValidationError } from '../errors.js';
+import { createIdempotencyKey } from '../utils.js';
+/**
+ * Fluent builder for creating Square orders
+ *
+ * @example
+ * ```typescript
+ * const order = await square.orders
+ *   .builder()
+ *   .addItem({ name: 'Latte', amount: 450 })
+ *   .addItem({ catalogObjectId: 'ITEM_123', quantity: 2 })
+ *   .withTip(100)
+ *   .withCustomer('CUST_123')
+ *   .build();
+ * ```
+ */
+export class OrderBuilder {
+    client;
+    locationId;
+    lineItems = [];
+    customerId;
+    referenceId;
+    tipAmount;
+    currency = 'USD';
+    constructor(client, locationId) {
+        this.client = client;
+        this.locationId = locationId;
+    }
+    /**
+     * Set the currency for the order
+     *
+     * @param currency - Currency code
+     * @returns Builder instance for chaining
+     */
+    withCurrency(currency) {
+        this.currency = currency;
+        return this;
+    }
+    /**
+     * Add a line item to the order
+     *
+     * @param item - Line item details
+     * @returns Builder instance for chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .addItem({ name: 'Coffee', amount: 350 })
+     *   .addItem({ catalogObjectId: 'ITEM_123', quantity: 2 })
+     * ```
+     */
+    addItem(item) {
+        const quantity = String(item.quantity ?? 1);
+        const lineItem = {
+            quantity,
+        };
+        if (item.catalogObjectId) {
+            lineItem.catalogObjectId = item.catalogObjectId;
+        }
+        else if (item.name && item.amount !== undefined) {
+            lineItem.name = item.name;
+            lineItem.basePriceMoney = {
+                amount: BigInt(item.amount),
+                currency: this.currency,
+            };
+        }
+        else {
+            throw new SquareValidationError('Line item must have either catalogObjectId or both name and amount');
+        }
+        if (item.note) {
+            lineItem.note = item.note;
+        }
+        this.lineItems.push(lineItem);
+        return this;
+    }
+    /**
+     * Add multiple line items at once
+     *
+     * @param items - Array of line items
+     * @returns Builder instance for chaining
+     */
+    addItems(items) {
+        for (const item of items) {
+            this.addItem(item);
+        }
+        return this;
+    }
+    /**
+     * Add a tip to the order
+     *
+     * @param amount - Tip amount in cents
+     * @returns Builder instance for chaining
+     */
+    withTip(amount) {
+        this.tipAmount = BigInt(amount);
+        return this;
+    }
+    /**
+     * Associate a customer with the order
+     *
+     * @param customerId - Square customer ID
+     * @returns Builder instance for chaining
+     */
+    withCustomer(customerId) {
+        this.customerId = customerId;
+        return this;
+    }
+    /**
+     * Add a reference ID for external tracking
+     *
+     * @param referenceId - External reference ID
+     * @returns Builder instance for chaining
+     */
+    withReference(referenceId) {
+        this.referenceId = referenceId;
+        return this;
+    }
+    /**
+     * Add a note to the order
+     *
+     * @param note - Order note
+     * @returns Builder instance for chaining
+     */
+    withNote(_note) {
+        // Note: Order-level notes are typically handled differently in Square
+        // This is preserved for API compatibility
+        return this;
+    }
+    /**
+     * Build and create the order
+     *
+     * @returns Created order
+     *
+     * @throws {SquareValidationError} When validation fails
+     * @throws {SquareApiError} When API call fails
+     */
+    async build() {
+        if (this.lineItems.length === 0) {
+            throw new SquareValidationError('Order must have at least one line item');
+        }
+        try {
+            const response = await this.client.orders.create({
+                order: {
+                    locationId: this.locationId,
+                    lineItems: this.lineItems,
+                    customerId: this.customerId,
+                    referenceId: this.referenceId,
+                },
+                idempotencyKey: createIdempotencyKey(),
+            });
+            if (!response.order) {
+                throw new Error('Order was not created');
+            }
+            return response.order;
+        }
+        catch (error) {
+            throw parseSquareError(error);
+        }
+    }
+    /**
+     * Preview the order without creating it
+     * Returns the order configuration that would be sent
+     */
+    preview() {
+        return {
+            locationId: this.locationId,
+            lineItems: [...this.lineItems],
+            customerId: this.customerId,
+            referenceId: this.referenceId,
+            tipAmount: this.tipAmount,
+            currency: this.currency,
+        };
+    }
+    /**
+     * Reset the builder to start fresh
+     */
+    reset() {
+        this.lineItems = [];
+        this.customerId = undefined;
+        this.referenceId = undefined;
+        this.tipAmount = undefined;
+        return this;
+    }
+}
+//# sourceMappingURL=order.builder.js.map

package/dist/core/builders/order.builder.js.map

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