@bates-solutions/squareup 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (220) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +154 -0
  3. package/README.md.backup +292 -0
  4. package/dist/angular/__tests__/setup.d.ts +1 -0
  5. package/dist/angular/__tests__/setup.d.ts.map +1 -0
  6. package/dist/angular/__tests__/setup.js +5 -0
  7. package/dist/angular/__tests__/setup.js.map +1 -0
  8. package/dist/angular/components/index.d.ts +2 -0
  9. package/dist/angular/components/index.d.ts.map +1 -0
  10. package/dist/angular/components/index.js +2 -0
  11. package/dist/angular/components/index.js.map +1 -0
  12. package/dist/angular/components/payment-button.component.d.ts +49 -0
  13. package/dist/angular/components/payment-button.component.d.ts.map +1 -0
  14. package/dist/angular/components/payment-button.component.js +176 -0
  15. package/dist/angular/components/payment-button.component.js.map +1 -0
  16. package/dist/angular/directives/index.d.ts +2 -0
  17. package/dist/angular/directives/index.d.ts.map +1 -0
  18. package/dist/angular/directives/index.js +2 -0
  19. package/dist/angular/directives/index.js.map +1 -0
  20. package/dist/angular/directives/square-card.directive.d.ts +52 -0
  21. package/dist/angular/directives/square-card.directive.d.ts.map +1 -0
  22. package/dist/angular/directives/square-card.directive.js +98 -0
  23. package/dist/angular/directives/square-card.directive.js.map +1 -0
  24. package/dist/angular/index.d.ts +42 -0
  25. package/dist/angular/index.d.ts.map +1 -0
  26. package/dist/angular/index.js +45 -0
  27. package/dist/angular/index.js.map +1 -0
  28. package/dist/angular/services/index.d.ts +6 -0
  29. package/dist/angular/services/index.d.ts.map +1 -0
  30. package/dist/angular/services/index.js +6 -0
  31. package/dist/angular/services/index.js.map +1 -0
  32. package/dist/angular/services/square-catalog.service.d.ts +60 -0
  33. package/dist/angular/services/square-catalog.service.d.ts.map +1 -0
  34. package/dist/angular/services/square-catalog.service.js +152 -0
  35. package/dist/angular/services/square-catalog.service.js.map +1 -0
  36. package/dist/angular/services/square-customers.service.d.ts +77 -0
  37. package/dist/angular/services/square-customers.service.d.ts.map +1 -0
  38. package/dist/angular/services/square-customers.service.js +187 -0
  39. package/dist/angular/services/square-customers.service.js.map +1 -0
  40. package/dist/angular/services/square-orders.service.d.ts +66 -0
  41. package/dist/angular/services/square-orders.service.d.ts.map +1 -0
  42. package/dist/angular/services/square-orders.service.js +170 -0
  43. package/dist/angular/services/square-orders.service.js.map +1 -0
  44. package/dist/angular/services/square-payments.service.d.ts +73 -0
  45. package/dist/angular/services/square-payments.service.d.ts.map +1 -0
  46. package/dist/angular/services/square-payments.service.js +167 -0
  47. package/dist/angular/services/square-payments.service.js.map +1 -0
  48. package/dist/angular/services/square-sdk.service.d.ts +45 -0
  49. package/dist/angular/services/square-sdk.service.d.ts.map +1 -0
  50. package/dist/angular/services/square-sdk.service.js +133 -0
  51. package/dist/angular/services/square-sdk.service.js.map +1 -0
  52. package/dist/angular/square.module.d.ts +36 -0
  53. package/dist/angular/square.module.d.ts.map +1 -0
  54. package/dist/angular/square.module.js +75 -0
  55. package/dist/angular/square.module.js.map +1 -0
  56. package/dist/angular/types.d.ts +189 -0
  57. package/dist/angular/types.d.ts.map +1 -0
  58. package/dist/angular/types.js +8 -0
  59. package/dist/angular/types.js.map +1 -0
  60. package/dist/core/builders/order.builder.d.ts +140 -0
  61. package/dist/core/builders/order.builder.d.ts.map +1 -0
  62. package/dist/core/builders/order.builder.js +185 -0
  63. package/dist/core/builders/order.builder.js.map +1 -0
  64. package/dist/core/client.d.ts +93 -0
  65. package/dist/core/client.d.ts.map +1 -0
  66. package/dist/core/client.js +99 -0
  67. package/dist/core/client.js.map +1 -0
  68. package/dist/core/errors.d.ts +55 -0
  69. package/dist/core/errors.d.ts.map +1 -0
  70. package/dist/core/errors.js +118 -0
  71. package/dist/core/errors.js.map +1 -0
  72. package/dist/core/index.d.ts +17 -0
  73. package/dist/core/index.d.ts.map +1 -0
  74. package/dist/core/index.js +18 -0
  75. package/dist/core/index.js.map +1 -0
  76. package/dist/core/services/catalog.service.d.ts +218 -0
  77. package/dist/core/services/catalog.service.d.ts.map +1 -0
  78. package/dist/core/services/catalog.service.js +274 -0
  79. package/dist/core/services/catalog.service.js.map +1 -0
  80. package/dist/core/services/customers.service.d.ts +197 -0
  81. package/dist/core/services/customers.service.d.ts.map +1 -0
  82. package/dist/core/services/customers.service.js +246 -0
  83. package/dist/core/services/customers.service.js.map +1 -0
  84. package/dist/core/services/inventory.service.d.ts +196 -0
  85. package/dist/core/services/inventory.service.d.ts.map +1 -0
  86. package/dist/core/services/inventory.service.js +266 -0
  87. package/dist/core/services/inventory.service.js.map +1 -0
  88. package/dist/core/services/invoices.service.d.ts +211 -0
  89. package/dist/core/services/invoices.service.d.ts.map +1 -0
  90. package/dist/core/services/invoices.service.js +297 -0
  91. package/dist/core/services/invoices.service.js.map +1 -0
  92. package/dist/core/services/loyalty.service.d.ts +282 -0
  93. package/dist/core/services/loyalty.service.d.ts.map +1 -0
  94. package/dist/core/services/loyalty.service.js +340 -0
  95. package/dist/core/services/loyalty.service.js.map +1 -0
  96. package/dist/core/services/orders.service.d.ts +121 -0
  97. package/dist/core/services/orders.service.d.ts.map +1 -0
  98. package/dist/core/services/orders.service.js +208 -0
  99. package/dist/core/services/orders.service.js.map +1 -0
  100. package/dist/core/services/payments.service.d.ts +121 -0
  101. package/dist/core/services/payments.service.d.ts.map +1 -0
  102. package/dist/core/services/payments.service.js +189 -0
  103. package/dist/core/services/payments.service.js.map +1 -0
  104. package/dist/core/services/subscriptions.service.d.ts +205 -0
  105. package/dist/core/services/subscriptions.service.d.ts.map +1 -0
  106. package/dist/core/services/subscriptions.service.js +265 -0
  107. package/dist/core/services/subscriptions.service.js.map +1 -0
  108. package/dist/core/types/index.d.ts +68 -0
  109. package/dist/core/types/index.d.ts.map +1 -0
  110. package/dist/core/types/index.js +2 -0
  111. package/dist/core/types/index.js.map +1 -0
  112. package/dist/core/utils.d.ts +74 -0
  113. package/dist/core/utils.d.ts.map +1 -0
  114. package/dist/core/utils.js +96 -0
  115. package/dist/core/utils.js.map +1 -0
  116. package/dist/react/SquareProvider.d.ts +50 -0
  117. package/dist/react/SquareProvider.d.ts.map +1 -0
  118. package/dist/react/SquareProvider.js +134 -0
  119. package/dist/react/SquareProvider.js.map +1 -0
  120. package/dist/react/__tests__/CardInput.test.d.ts +2 -0
  121. package/dist/react/__tests__/CardInput.test.d.ts.map +1 -0
  122. package/dist/react/__tests__/CardInput.test.js +218 -0
  123. package/dist/react/__tests__/CardInput.test.js.map +1 -0
  124. package/dist/react/__tests__/PaymentButton.test.d.ts +2 -0
  125. package/dist/react/__tests__/PaymentButton.test.d.ts.map +1 -0
  126. package/dist/react/__tests__/PaymentButton.test.js +400 -0
  127. package/dist/react/__tests__/PaymentButton.test.js.map +1 -0
  128. package/dist/react/__tests__/SquareProvider.test.d.ts +2 -0
  129. package/dist/react/__tests__/SquareProvider.test.d.ts.map +1 -0
  130. package/dist/react/__tests__/SquareProvider.test.js +126 -0
  131. package/dist/react/__tests__/SquareProvider.test.js.map +1 -0
  132. package/dist/react/__tests__/setup.d.ts +2 -0
  133. package/dist/react/__tests__/setup.d.ts.map +1 -0
  134. package/dist/react/__tests__/setup.js +3 -0
  135. package/dist/react/__tests__/setup.js.map +1 -0
  136. package/dist/react/__tests__/useCatalog.test.d.ts +2 -0
  137. package/dist/react/__tests__/useCatalog.test.d.ts.map +1 -0
  138. package/dist/react/__tests__/useCatalog.test.js +277 -0
  139. package/dist/react/__tests__/useCatalog.test.js.map +1 -0
  140. package/dist/react/__tests__/useCustomers.test.d.ts +2 -0
  141. package/dist/react/__tests__/useCustomers.test.d.ts.map +1 -0
  142. package/dist/react/__tests__/useCustomers.test.js +312 -0
  143. package/dist/react/__tests__/useCustomers.test.js.map +1 -0
  144. package/dist/react/__tests__/useOrders.test.d.ts +2 -0
  145. package/dist/react/__tests__/useOrders.test.d.ts.map +1 -0
  146. package/dist/react/__tests__/useOrders.test.js +216 -0
  147. package/dist/react/__tests__/useOrders.test.js.map +1 -0
  148. package/dist/react/__tests__/usePayments.test.d.ts +2 -0
  149. package/dist/react/__tests__/usePayments.test.d.ts.map +1 -0
  150. package/dist/react/__tests__/usePayments.test.js +235 -0
  151. package/dist/react/__tests__/usePayments.test.js.map +1 -0
  152. package/dist/react/__tests__/useSquarePayment.test.d.ts +2 -0
  153. package/dist/react/__tests__/useSquarePayment.test.d.ts.map +1 -0
  154. package/dist/react/__tests__/useSquarePayment.test.js +447 -0
  155. package/dist/react/__tests__/useSquarePayment.test.js.map +1 -0
  156. package/dist/react/components/CardInput.d.ts +69 -0
  157. package/dist/react/components/CardInput.d.ts.map +1 -0
  158. package/dist/react/components/CardInput.js +58 -0
  159. package/dist/react/components/CardInput.js.map +1 -0
  160. package/dist/react/components/PaymentButton.d.ts +71 -0
  161. package/dist/react/components/PaymentButton.d.ts.map +1 -0
  162. package/dist/react/components/PaymentButton.js +140 -0
  163. package/dist/react/components/PaymentButton.js.map +1 -0
  164. package/dist/react/components/index.d.ts +5 -0
  165. package/dist/react/components/index.d.ts.map +1 -0
  166. package/dist/react/components/index.js +3 -0
  167. package/dist/react/components/index.js.map +1 -0
  168. package/dist/react/hooks/index.d.ts +11 -0
  169. package/dist/react/hooks/index.d.ts.map +1 -0
  170. package/dist/react/hooks/index.js +6 -0
  171. package/dist/react/hooks/index.js.map +1 -0
  172. package/dist/react/hooks/useCatalog.d.ts +98 -0
  173. package/dist/react/hooks/useCatalog.d.ts.map +1 -0
  174. package/dist/react/hooks/useCatalog.js +134 -0
  175. package/dist/react/hooks/useCatalog.js.map +1 -0
  176. package/dist/react/hooks/useCustomers.d.ts +105 -0
  177. package/dist/react/hooks/useCustomers.d.ts.map +1 -0
  178. package/dist/react/hooks/useCustomers.js +174 -0
  179. package/dist/react/hooks/useCustomers.js.map +1 -0
  180. package/dist/react/hooks/useOrders.d.ts +112 -0
  181. package/dist/react/hooks/useOrders.d.ts.map +1 -0
  182. package/dist/react/hooks/useOrders.js +115 -0
  183. package/dist/react/hooks/useOrders.js.map +1 -0
  184. package/dist/react/hooks/usePayments.d.ts +98 -0
  185. package/dist/react/hooks/usePayments.d.ts.map +1 -0
  186. package/dist/react/hooks/usePayments.js +89 -0
  187. package/dist/react/hooks/usePayments.js.map +1 -0
  188. package/dist/react/hooks/useSquarePayment.d.ts +52 -0
  189. package/dist/react/hooks/useSquarePayment.d.ts.map +1 -0
  190. package/dist/react/hooks/useSquarePayment.js +146 -0
  191. package/dist/react/hooks/useSquarePayment.js.map +1 -0
  192. package/dist/react/index.d.ts +8 -0
  193. package/dist/react/index.d.ts.map +1 -0
  194. package/dist/react/index.js +7 -0
  195. package/dist/react/index.js.map +1 -0
  196. package/dist/react/types.d.ts +183 -0
  197. package/dist/react/types.d.ts.map +1 -0
  198. package/dist/react/types.js +2 -0
  199. package/dist/react/types.js.map +1 -0
  200. package/dist/server/index.d.ts +43 -0
  201. package/dist/server/index.d.ts.map +1 -0
  202. package/dist/server/index.js +45 -0
  203. package/dist/server/index.js.map +1 -0
  204. package/dist/server/middleware/express.d.ts +77 -0
  205. package/dist/server/middleware/express.d.ts.map +1 -0
  206. package/dist/server/middleware/express.js +123 -0
  207. package/dist/server/middleware/express.js.map +1 -0
  208. package/dist/server/middleware/nextjs.d.ts +118 -0
  209. package/dist/server/middleware/nextjs.d.ts.map +1 -0
  210. package/dist/server/middleware/nextjs.js +172 -0
  211. package/dist/server/middleware/nextjs.js.map +1 -0
  212. package/dist/server/types.d.ts +89 -0
  213. package/dist/server/types.d.ts.map +1 -0
  214. package/dist/server/types.js +7 -0
  215. package/dist/server/types.js.map +1 -0
  216. package/dist/server/webhook.d.ts +114 -0
  217. package/dist/server/webhook.d.ts.map +1 -0
  218. package/dist/server/webhook.js +190 -0
  219. package/dist/server/webhook.js.map +1 -0
  220. package/package.json +118 -0
@@ -0,0 +1,93 @@
1
+ import { SquareClient as SdkClient } from 'square';
2
+ import type { SquareEnvironment } from './types/index.js';
3
+ import { PaymentsService } from './services/payments.service.js';
4
+ import { OrdersService } from './services/orders.service.js';
5
+ import { CustomersService } from './services/customers.service.js';
6
+ import { CatalogService } from './services/catalog.service.js';
7
+ import { InventoryService } from './services/inventory.service.js';
8
+ import { SubscriptionsService } from './services/subscriptions.service.js';
9
+ import { InvoicesService } from './services/invoices.service.js';
10
+ import { LoyaltyService } from './services/loyalty.service.js';
11
+ /**
12
+ * Configuration options for the Square client
13
+ */
14
+ export interface SquareClientConfig {
15
+ /**
16
+ * Square API access token
17
+ */
18
+ accessToken: string;
19
+ /**
20
+ * Square environment (sandbox or production)
21
+ * @default 'sandbox'
22
+ */
23
+ environment?: SquareEnvironment;
24
+ /**
25
+ * Default location ID for operations that require it
26
+ */
27
+ locationId?: string;
28
+ /**
29
+ * Default currency code
30
+ * @default 'USD'
31
+ */
32
+ defaultCurrency?: string;
33
+ }
34
+ /**
35
+ * Main Square client wrapper
36
+ *
37
+ * @example
38
+ * ```typescript
39
+ * const square = createSquareClient({
40
+ * accessToken: process.env.SQUARE_ACCESS_TOKEN!,
41
+ * environment: 'sandbox',
42
+ * locationId: 'LXXX',
43
+ * });
44
+ *
45
+ * // Create a payment
46
+ * const payment = await square.payments.create({
47
+ * sourceId: 'cnon:card-nonce-ok',
48
+ * amount: 1000, // $10.00
49
+ * });
50
+ * ```
51
+ */
52
+ export declare class SquareClient {
53
+ private readonly client;
54
+ private readonly config;
55
+ readonly payments: PaymentsService;
56
+ readonly orders: OrdersService;
57
+ readonly customers: CustomersService;
58
+ readonly catalog: CatalogService;
59
+ readonly inventory: InventoryService;
60
+ readonly subscriptions: SubscriptionsService;
61
+ readonly invoices: InvoicesService;
62
+ readonly loyalty: LoyaltyService;
63
+ constructor(config: SquareClientConfig);
64
+ /**
65
+ * Get the underlying Square SDK client
66
+ * Use this for advanced operations not covered by the wrapper
67
+ */
68
+ get sdk(): SdkClient;
69
+ /**
70
+ * Get the current location ID
71
+ */
72
+ get locationId(): string | undefined;
73
+ /**
74
+ * Get the current environment
75
+ */
76
+ get environment(): SquareEnvironment;
77
+ }
78
+ /**
79
+ * Create a new Square client instance
80
+ *
81
+ * @param config - Client configuration
82
+ * @returns Configured Square client
83
+ *
84
+ * @example
85
+ * ```typescript
86
+ * const square = createSquareClient({
87
+ * accessToken: process.env.SQUARE_ACCESS_TOKEN!,
88
+ * environment: 'sandbox',
89
+ * });
90
+ * ```
91
+ */
92
+ export declare function createSquareClient(config: SquareClientConfig): SquareClient;
93
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,SAAS,EAAuC,MAAM,QAAQ,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IAEF,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAC1C,SAAgB,MAAM,EAAE,aAAa,CAAC;IACtC,SAAgB,SAAS,EAAE,gBAAgB,CAAC;IAC5C,SAAgB,OAAO,EAAE,cAAc,CAAC;IACxC,SAAgB,SAAS,EAAE,gBAAgB,CAAC;IAC5C,SAAgB,aAAa,EAAE,oBAAoB,CAAC;IACpD,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAC1C,SAAgB,OAAO,EAAE,cAAc,CAAC;gBAE5B,MAAM,EAAE,kBAAkB;IA2BtC;;;OAGG;IACH,IAAI,GAAG,IAAI,SAAS,CAEnB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,iBAAiB,CAEnC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}
@@ -0,0 +1,99 @@
1
+ import { SquareClient as SdkClient, SquareEnvironment as SdkEnvironment } from 'square';
2
+ import { PaymentsService } from './services/payments.service.js';
3
+ import { OrdersService } from './services/orders.service.js';
4
+ import { CustomersService } from './services/customers.service.js';
5
+ import { CatalogService } from './services/catalog.service.js';
6
+ import { InventoryService } from './services/inventory.service.js';
7
+ import { SubscriptionsService } from './services/subscriptions.service.js';
8
+ import { InvoicesService } from './services/invoices.service.js';
9
+ import { LoyaltyService } from './services/loyalty.service.js';
10
+ /**
11
+ * Main Square client wrapper
12
+ *
13
+ * @example
14
+ * ```typescript
15
+ * const square = createSquareClient({
16
+ * accessToken: process.env.SQUARE_ACCESS_TOKEN!,
17
+ * environment: 'sandbox',
18
+ * locationId: 'LXXX',
19
+ * });
20
+ *
21
+ * // Create a payment
22
+ * const payment = await square.payments.create({
23
+ * sourceId: 'cnon:card-nonce-ok',
24
+ * amount: 1000, // $10.00
25
+ * });
26
+ * ```
27
+ */
28
+ export class SquareClient {
29
+ client;
30
+ config;
31
+ payments;
32
+ orders;
33
+ customers;
34
+ catalog;
35
+ inventory;
36
+ subscriptions;
37
+ invoices;
38
+ loyalty;
39
+ constructor(config) {
40
+ this.config = {
41
+ accessToken: config.accessToken,
42
+ environment: config.environment ?? 'sandbox',
43
+ locationId: config.locationId,
44
+ defaultCurrency: config.defaultCurrency ?? 'USD',
45
+ };
46
+ this.client = new SdkClient({
47
+ token: this.config.accessToken,
48
+ environment: this.config.environment === 'production'
49
+ ? SdkEnvironment.Production
50
+ : SdkEnvironment.Sandbox,
51
+ });
52
+ // Initialize services
53
+ this.payments = new PaymentsService(this.client, this.config.locationId);
54
+ this.orders = new OrdersService(this.client, this.config.locationId);
55
+ this.customers = new CustomersService(this.client);
56
+ this.catalog = new CatalogService(this.client);
57
+ this.inventory = new InventoryService(this.client, this.config.locationId);
58
+ this.subscriptions = new SubscriptionsService(this.client, this.config.locationId);
59
+ this.invoices = new InvoicesService(this.client, this.config.locationId);
60
+ this.loyalty = new LoyaltyService(this.client, this.config.locationId);
61
+ }
62
+ /**
63
+ * Get the underlying Square SDK client
64
+ * Use this for advanced operations not covered by the wrapper
65
+ */
66
+ get sdk() {
67
+ return this.client;
68
+ }
69
+ /**
70
+ * Get the current location ID
71
+ */
72
+ get locationId() {
73
+ return this.config.locationId;
74
+ }
75
+ /**
76
+ * Get the current environment
77
+ */
78
+ get environment() {
79
+ return this.config.environment;
80
+ }
81
+ }
82
+ /**
83
+ * Create a new Square client instance
84
+ *
85
+ * @param config - Client configuration
86
+ * @returns Configured Square client
87
+ *
88
+ * @example
89
+ * ```typescript
90
+ * const square = createSquareClient({
91
+ * accessToken: process.env.SQUARE_ACCESS_TOKEN!,
92
+ * environment: 'sandbox',
93
+ * });
94
+ * ```
95
+ */
96
+ export function createSquareClient(config) {
97
+ return new SquareClient(config);
98
+ }
99
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Square error codes
3
+ */
4
+ export type SquareErrorCode = 'UNAUTHORIZED' | 'ACCESS_TOKEN_EXPIRED' | 'ACCESS_TOKEN_REVOKED' | 'FORBIDDEN' | 'INSUFFICIENT_SCOPES' | 'BAD_REQUEST' | 'INVALID_VALUE' | 'MISSING_REQUIRED_PARAMETER' | 'NOT_FOUND' | 'CONFLICT' | 'RATE_LIMITED' | 'INTERNAL_SERVER_ERROR' | 'SERVICE_UNAVAILABLE' | 'CARD_DECLINED' | 'VERIFY_CVV_FAILURE' | 'VERIFY_AVS_FAILURE' | 'INVALID_EXPIRATION' | 'CARD_EXPIRED' | 'INVALID_CARD' | 'GENERIC_DECLINE' | 'UNKNOWN';
5
+ /**
6
+ * Base Square error class
7
+ */
8
+ export declare class SquareError extends Error {
9
+ readonly code: SquareErrorCode;
10
+ readonly statusCode?: number;
11
+ readonly details?: unknown;
12
+ constructor(message: string, code?: SquareErrorCode, statusCode?: number, details?: unknown);
13
+ }
14
+ /**
15
+ * API-level errors from Square
16
+ */
17
+ export declare class SquareApiError extends SquareError {
18
+ readonly errors: Array<{
19
+ category: string;
20
+ code: string;
21
+ detail?: string;
22
+ field?: string;
23
+ }>;
24
+ constructor(message: string, code: SquareErrorCode, statusCode: number, errors: Array<{
25
+ category: string;
26
+ code: string;
27
+ detail?: string;
28
+ field?: string;
29
+ }>);
30
+ }
31
+ /**
32
+ * Authentication errors
33
+ */
34
+ export declare class SquareAuthError extends SquareError {
35
+ constructor(message: string, code?: SquareErrorCode);
36
+ }
37
+ /**
38
+ * Payment processing errors
39
+ */
40
+ export declare class SquarePaymentError extends SquareError {
41
+ readonly paymentId?: string;
42
+ constructor(message: string, code: SquareErrorCode, paymentId?: string);
43
+ }
44
+ /**
45
+ * Validation errors
46
+ */
47
+ export declare class SquareValidationError extends SquareError {
48
+ readonly field?: string;
49
+ constructor(message: string, field?: string);
50
+ }
51
+ /**
52
+ * Parse Square SDK errors into typed exceptions
53
+ */
54
+ export declare function parseSquareError(error: unknown): SquareError;
55
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,sBAAsB,GACtB,sBAAsB,GACtB,WAAW,GACX,qBAAqB,GACrB,aAAa,GACb,eAAe,GACf,4BAA4B,GAC5B,WAAW,GACX,UAAU,GACV,cAAc,GACd,uBAAuB,GACvB,qBAAqB,GACrB,eAAe,GACf,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,SAAS,CAAC;AAEd;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,eAA2B,EACjC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,OAAO;CAWpB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,SAAgB,MAAM,EAAE,KAAK,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;gBAGD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAMrF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,eAAgC;CAIpE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM;CAKvE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAK5C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAmC5D"}
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Base Square error class
3
+ */
4
+ export class SquareError extends Error {
5
+ code;
6
+ statusCode;
7
+ details;
8
+ constructor(message, code = 'UNKNOWN', statusCode, details) {
9
+ super(message);
10
+ this.name = 'SquareError';
11
+ this.code = code;
12
+ this.statusCode = statusCode;
13
+ this.details = details;
14
+ // Maintains proper stack trace for where error was thrown (V8 engines)
15
+ Error.captureStackTrace(this, this.constructor);
16
+ }
17
+ }
18
+ /**
19
+ * API-level errors from Square
20
+ */
21
+ export class SquareApiError extends SquareError {
22
+ errors;
23
+ constructor(message, code, statusCode, errors) {
24
+ super(message, code, statusCode, errors);
25
+ this.name = 'SquareApiError';
26
+ this.errors = errors;
27
+ }
28
+ }
29
+ /**
30
+ * Authentication errors
31
+ */
32
+ export class SquareAuthError extends SquareError {
33
+ constructor(message, code = 'UNAUTHORIZED') {
34
+ super(message, code, 401);
35
+ this.name = 'SquareAuthError';
36
+ }
37
+ }
38
+ /**
39
+ * Payment processing errors
40
+ */
41
+ export class SquarePaymentError extends SquareError {
42
+ paymentId;
43
+ constructor(message, code, paymentId) {
44
+ super(message, code, 400);
45
+ this.name = 'SquarePaymentError';
46
+ this.paymentId = paymentId;
47
+ }
48
+ }
49
+ /**
50
+ * Validation errors
51
+ */
52
+ export class SquareValidationError extends SquareError {
53
+ field;
54
+ constructor(message, field) {
55
+ super(message, 'INVALID_VALUE', 400);
56
+ this.name = 'SquareValidationError';
57
+ this.field = field;
58
+ }
59
+ }
60
+ /**
61
+ * Parse Square SDK errors into typed exceptions
62
+ */
63
+ export function parseSquareError(error) {
64
+ // Handle Square SDK errors
65
+ if (error && typeof error === 'object' && 'statusCode' in error) {
66
+ const sdkError = error;
67
+ const errors = sdkError.body?.errors ?? [];
68
+ const firstError = errors[0];
69
+ const message = firstError?.detail ?? 'Square API error';
70
+ const code = mapErrorCode(firstError?.code);
71
+ // Auth errors
72
+ if (sdkError.statusCode === 401) {
73
+ return new SquareAuthError(message, code);
74
+ }
75
+ // Payment errors
76
+ if (firstError?.category === 'PAYMENT_METHOD_ERROR') {
77
+ return new SquarePaymentError(message, code);
78
+ }
79
+ // General API errors
80
+ return new SquareApiError(message, code, sdkError.statusCode, errors);
81
+ }
82
+ // Handle standard errors
83
+ if (error instanceof Error) {
84
+ return new SquareError(error.message);
85
+ }
86
+ return new SquareError('Unknown error occurred');
87
+ }
88
+ /**
89
+ * Map Square error codes to typed codes
90
+ */
91
+ function mapErrorCode(code) {
92
+ if (!code)
93
+ return 'UNKNOWN';
94
+ const codeMap = {
95
+ UNAUTHORIZED: 'UNAUTHORIZED',
96
+ ACCESS_TOKEN_EXPIRED: 'ACCESS_TOKEN_EXPIRED',
97
+ ACCESS_TOKEN_REVOKED: 'ACCESS_TOKEN_REVOKED',
98
+ FORBIDDEN: 'FORBIDDEN',
99
+ INSUFFICIENT_SCOPES: 'INSUFFICIENT_SCOPES',
100
+ BAD_REQUEST: 'BAD_REQUEST',
101
+ INVALID_VALUE: 'INVALID_VALUE',
102
+ MISSING_REQUIRED_PARAMETER: 'MISSING_REQUIRED_PARAMETER',
103
+ NOT_FOUND: 'NOT_FOUND',
104
+ CONFLICT: 'CONFLICT',
105
+ RATE_LIMITED: 'RATE_LIMITED',
106
+ INTERNAL_SERVER_ERROR: 'INTERNAL_SERVER_ERROR',
107
+ SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
108
+ CARD_DECLINED: 'CARD_DECLINED',
109
+ VERIFY_CVV_FAILURE: 'VERIFY_CVV_FAILURE',
110
+ VERIFY_AVS_FAILURE: 'VERIFY_AVS_FAILURE',
111
+ INVALID_EXPIRATION: 'INVALID_EXPIRATION',
112
+ CARD_EXPIRED: 'CARD_EXPIRED',
113
+ INVALID_CARD: 'INVALID_CARD',
114
+ GENERIC_DECLINE: 'GENERIC_DECLINE',
115
+ };
116
+ return codeMap[code] ?? 'UNKNOWN';
117
+ }
118
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ export { createSquareClient, SquareClient } from './client.js';
2
+ export type { SquareClientConfig } from './client.js';
3
+ export { PaymentsService } from './services/payments.service.js';
4
+ export { OrdersService } from './services/orders.service.js';
5
+ export { CustomersService } from './services/customers.service.js';
6
+ export { CatalogService } from './services/catalog.service.js';
7
+ export { InventoryService } from './services/inventory.service.js';
8
+ export { SubscriptionsService } from './services/subscriptions.service.js';
9
+ export { InvoicesService } from './services/invoices.service.js';
10
+ export { LoyaltyService } from './services/loyalty.service.js';
11
+ export { OrderBuilder } from './builders/order.builder.js';
12
+ export { SquareError, SquareApiError, SquareAuthError, SquarePaymentError, SquareValidationError, } from './errors.js';
13
+ export type { SquareErrorCode } from './errors.js';
14
+ export { toCents, fromCents, formatMoney, createIdempotencyKey } from './utils.js';
15
+ export type { Money } from './utils.js';
16
+ export type * from './types/index.js';
17
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,mBAAmB,kBAAkB,CAAC"}
@@ -0,0 +1,18 @@
1
+ // Core exports
2
+ export { createSquareClient, SquareClient } from './client.js';
3
+ // Services
4
+ export { PaymentsService } from './services/payments.service.js';
5
+ export { OrdersService } from './services/orders.service.js';
6
+ export { CustomersService } from './services/customers.service.js';
7
+ export { CatalogService } from './services/catalog.service.js';
8
+ export { InventoryService } from './services/inventory.service.js';
9
+ export { SubscriptionsService } from './services/subscriptions.service.js';
10
+ export { InvoicesService } from './services/invoices.service.js';
11
+ export { LoyaltyService } from './services/loyalty.service.js';
12
+ // Builders
13
+ export { OrderBuilder } from './builders/order.builder.js';
14
+ // Errors
15
+ export { SquareError, SquareApiError, SquareAuthError, SquarePaymentError, SquareValidationError, } from './errors.js';
16
+ // Utils
17
+ export { toCents, fromCents, formatMoney, createIdempotencyKey } from './utils.js';
18
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/D,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,SAAS;AACT,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,QAAQ;AACR,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,218 @@
1
+ import type { SquareClient } from 'square';
2
+ import type { CurrencyCode } from '../types/index.js';
3
+ /**
4
+ * Catalog item type
5
+ */
6
+ export type CatalogObjectType = 'ITEM' | 'ITEM_VARIATION' | 'CATEGORY' | 'DISCOUNT' | 'TAX' | 'MODIFIER' | 'MODIFIER_LIST' | 'IMAGE';
7
+ /**
8
+ * Catalog object from Square API
9
+ */
10
+ export interface CatalogObject {
11
+ type: CatalogObjectType;
12
+ id: string;
13
+ updatedAt?: string;
14
+ version?: bigint;
15
+ isDeleted?: boolean;
16
+ presentAtAllLocations?: boolean;
17
+ presentAtLocationIds?: string[];
18
+ itemData?: {
19
+ name?: string;
20
+ description?: string;
21
+ categoryId?: string;
22
+ variations?: CatalogObject[];
23
+ productType?: string;
24
+ };
25
+ itemVariationData?: {
26
+ itemId?: string;
27
+ name?: string;
28
+ sku?: string;
29
+ priceMoney?: {
30
+ amount?: bigint;
31
+ currency?: string;
32
+ };
33
+ pricingType?: 'FIXED_PRICING' | 'VARIABLE_PRICING';
34
+ };
35
+ categoryData?: {
36
+ name?: string;
37
+ };
38
+ discountData?: {
39
+ name?: string;
40
+ discountType?: 'FIXED_PERCENTAGE' | 'FIXED_AMOUNT' | 'VARIABLE_PERCENTAGE' | 'VARIABLE_AMOUNT';
41
+ percentage?: string;
42
+ amountMoney?: {
43
+ amount?: bigint;
44
+ currency?: string;
45
+ };
46
+ };
47
+ taxData?: {
48
+ name?: string;
49
+ percentage?: string;
50
+ inclusionType?: 'ADDITIVE' | 'INCLUSIVE';
51
+ };
52
+ }
53
+ /**
54
+ * Options for creating a catalog item
55
+ */
56
+ export interface CreateCatalogItemOptions {
57
+ name: string;
58
+ description?: string;
59
+ categoryId?: string;
60
+ variations: Array<{
61
+ name: string;
62
+ price: number;
63
+ currency?: CurrencyCode;
64
+ sku?: string;
65
+ }>;
66
+ idempotencyKey?: string;
67
+ }
68
+ /**
69
+ * Options for creating a category
70
+ */
71
+ export interface CreateCategoryOptions {
72
+ name: string;
73
+ idempotencyKey?: string;
74
+ }
75
+ /**
76
+ * Options for searching the catalog
77
+ */
78
+ export interface SearchCatalogOptions {
79
+ objectTypes?: CatalogObjectType[];
80
+ query?: string;
81
+ categoryIds?: string[];
82
+ limit?: number;
83
+ cursor?: string;
84
+ }
85
+ /**
86
+ * Catalog service for managing Square catalog items
87
+ *
88
+ * @example
89
+ * ```typescript
90
+ * // Create an item with variations
91
+ * const item = await square.catalog.createItem({
92
+ * name: 'Coffee',
93
+ * variations: [
94
+ * { name: 'Small', price: 350 },
95
+ * { name: 'Large', price: 450 },
96
+ * ],
97
+ * });
98
+ *
99
+ * // Search items
100
+ * const results = await square.catalog.search({
101
+ * objectTypes: ['ITEM'],
102
+ * query: 'coffee',
103
+ * });
104
+ * ```
105
+ */
106
+ export declare class CatalogService {
107
+ private readonly client;
108
+ constructor(client: SquareClient);
109
+ /**
110
+ * Create a catalog item with variations
111
+ *
112
+ * @param options - Item creation options
113
+ * @returns Created catalog object
114
+ *
115
+ * @example
116
+ * ```typescript
117
+ * const item = await square.catalog.createItem({
118
+ * name: 'Latte',
119
+ * description: 'Espresso with steamed milk',
120
+ * variations: [
121
+ * { name: 'Small', price: 400, sku: 'LATTE-S' },
122
+ * { name: 'Medium', price: 500, sku: 'LATTE-M' },
123
+ * { name: 'Large', price: 600, sku: 'LATTE-L' },
124
+ * ],
125
+ * });
126
+ * ```
127
+ */
128
+ createItem(options: CreateCatalogItemOptions): Promise<CatalogObject>;
129
+ /**
130
+ * Create a category
131
+ *
132
+ * @param options - Category creation options
133
+ * @returns Created category
134
+ *
135
+ * @example
136
+ * ```typescript
137
+ * const category = await square.catalog.createCategory({
138
+ * name: 'Beverages',
139
+ * });
140
+ * ```
141
+ */
142
+ createCategory(options: CreateCategoryOptions): Promise<CatalogObject>;
143
+ /**
144
+ * Get a catalog object by ID
145
+ *
146
+ * @param objectId - Catalog object ID
147
+ * @returns Catalog object
148
+ *
149
+ * @example
150
+ * ```typescript
151
+ * const item = await square.catalog.get('ITEM_123');
152
+ * ```
153
+ */
154
+ get(objectId: string): Promise<CatalogObject>;
155
+ /**
156
+ * Delete a catalog object
157
+ *
158
+ * @param objectId - Catalog object ID to delete
159
+ *
160
+ * @example
161
+ * ```typescript
162
+ * await square.catalog.delete('ITEM_123');
163
+ * ```
164
+ */
165
+ delete(objectId: string): Promise<void>;
166
+ /**
167
+ * Search the catalog
168
+ *
169
+ * @param options - Search options
170
+ * @returns Matching catalog objects with pagination
171
+ *
172
+ * @example
173
+ * ```typescript
174
+ * // Search for items
175
+ * const results = await square.catalog.search({
176
+ * objectTypes: ['ITEM'],
177
+ * query: 'coffee',
178
+ * });
179
+ *
180
+ * // Get all categories
181
+ * const categories = await square.catalog.search({
182
+ * objectTypes: ['CATEGORY'],
183
+ * });
184
+ * ```
185
+ */
186
+ search(options?: SearchCatalogOptions): Promise<{
187
+ data: CatalogObject[];
188
+ cursor?: string;
189
+ }>;
190
+ /**
191
+ * List all catalog objects of a specific type
192
+ *
193
+ * @param objectType - Type of objects to list
194
+ * @param options - List options
195
+ * @returns Array of catalog objects
196
+ *
197
+ * @example
198
+ * ```typescript
199
+ * const items = await square.catalog.list('ITEM', { limit: 50 });
200
+ * ```
201
+ */
202
+ list(objectType: CatalogObjectType, options?: {
203
+ limit?: number;
204
+ }): Promise<CatalogObject[]>;
205
+ /**
206
+ * Batch retrieve multiple catalog objects
207
+ *
208
+ * @param objectIds - Array of object IDs to retrieve
209
+ * @returns Array of catalog objects
210
+ *
211
+ * @example
212
+ * ```typescript
213
+ * const items = await square.catalog.batchGet(['ITEM_1', 'ITEM_2', 'ITEM_3']);
214
+ * ```
215
+ */
216
+ batchGet(objectIds: string[]): Promise<CatalogObject[]>;
217
+ }
218
+ //# sourceMappingURL=catalog.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/catalog.service.ts"],"names":[],"mappings":"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"}