Merge pull request #97 from square/release/20.0.0

Generated PR for Release: 20.0.0

Author: Wolfgang Schuster

doc/api/catalog.md

@@ -185,10 +185,10 @@ bodybatches0objects0ItemDataVariations[0] = bodybatches0objects0ItemDatavariatio
 
 const bodybatches0objects0ItemData: CatalogItem = {};
 bodybatches0objects0ItemData.name = 'Tea';
-bodybatches0objects0ItemData.description = 'Hot Leaf Juice';
 bodybatches0objects0ItemData.categoryId = '#Beverages';
 bodybatches0objects0ItemData.taxIds = bodybatches0objects0ItemDataTaxIds;
 bodybatches0objects0ItemData.variations = bodybatches0objects0ItemDataVariations;
+bodybatches0objects0ItemData.descriptionHtml = '<p><strong>Hot</strong> Leaf Juice</p>';
 
 const bodybatches0objects0: CatalogObject = {
   type: 'ITEM',
@@ -232,10 +232,10 @@ bodybatches0objects1ItemDataVariations[1] = bodybatches0objects1ItemDatavariatio
 
 const bodybatches0objects1ItemData: CatalogItem = {};
 bodybatches0objects1ItemData.name = 'Coffee';
-bodybatches0objects1ItemData.description = 'Hot Bean Juice';
 bodybatches0objects1ItemData.categoryId = '#Beverages';
 bodybatches0objects1ItemData.taxIds = bodybatches0objects1ItemDataTaxIds;
 bodybatches0objects1ItemData.variations = bodybatches0objects1ItemDataVariations;
+bodybatches0objects1ItemData.descriptionHtml = '<p>Hot <em>Bean Juice</em></p>';
 
 const bodybatches0objects1: CatalogObject = {
   type: 'ITEM',
@@ -320,7 +320,7 @@ async createCatalogImage(
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `request` | [`CreateCatalogImageRequest \| undefined`](../../doc/models/create-catalog-image-request.md) | Form, Optional | - |
+| `request` | [`CreateCatalogImageRequest \| undefined`](../../doc/models/create-catalog-image-request.md) | Form (JSON-Encoded), Optional | - |
 | `imageFile` | `FileWrapper \| undefined` | Form, Optional | - |
 | `requestOptions` | `RequestOptions \| undefined` | Optional | Pass additional request options. |
 
@@ -380,7 +380,7 @@ async updateCatalogImage(
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `imageId` | `string` | Template, Required | The ID of the `CatalogImage` object to update the encapsulated image file. |
-| `request` | [`UpdateCatalogImageRequest \| undefined`](../../doc/models/update-catalog-image-request.md) | Form, Optional | - |
+| `request` | [`UpdateCatalogImageRequest \| undefined`](../../doc/models/update-catalog-image-request.md) | Form (JSON-Encoded), Optional | - |
 | `imageFile` | `FileWrapper \| undefined` | Form, Optional | - |
 | `requestOptions` | `RequestOptions \| undefined` | Optional | Pass additional request options. |
 
@@ -556,9 +556,9 @@ bodyObjectItemDataVariations[1] = bodyObjectItemDatavariations1;
 
 const bodyObjectItemData: CatalogItem = {};
 bodyObjectItemData.name = 'Cocoa';
-bodyObjectItemData.description = 'Hot Chocolate';
 bodyObjectItemData.abbreviation = 'Ch';
 bodyObjectItemData.variations = bodyObjectItemDataVariations;
+bodyObjectItemData.descriptionHtml = '<p><strong>Hot</strong> Chocolate</p>';
 
 const bodyObject: CatalogObject = {
   type: 'ITEM',

doc/api/customers.md

@@ -175,8 +175,8 @@ bodyQueryFilterCreationSource.values = bodyQueryFilterCreationSourceValues;
 bodyQueryFilterCreationSource.rule = 'INCLUDE';
 
 const bodyQueryFilterCreatedAt: TimeRange = {};
-bodyQueryFilterCreatedAt.startAt = '2018-01-01T00:00:00-00:00';
-bodyQueryFilterCreatedAt.endAt = '2018-02-01T00:00:00-00:00';
+bodyQueryFilterCreatedAt.startAt = '2018-01-01T00:00:00+00:00';
+bodyQueryFilterCreatedAt.endAt = '2018-02-01T00:00:00+00:00';
 
 const bodyQueryFilterEmailAddress: CustomerTextFilter = {};
 bodyQueryFilterEmailAddress.fuzzy = 'example.com';

doc/api/disputes.md

@@ -205,7 +205,7 @@ async createDisputeEvidenceFile(
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `disputeId` | `string` | Template, Required | The ID of the dispute you want to upload evidence for. |
-| `request` | [`CreateDisputeEvidenceFileRequest \| undefined`](../../doc/models/create-dispute-evidence-file-request.md) | Form, Optional | Defines the parameters for a `CreateDisputeEvidenceFile` request. |
+| `request` | [`CreateDisputeEvidenceFileRequest \| undefined`](../../doc/models/create-dispute-evidence-file-request.md) | Form (JSON-Encoded), Optional | Defines the parameters for a `CreateDisputeEvidenceFile` request. |
 | `imageFile` | `FileWrapper \| undefined` | Form, Optional | - |
 | `requestOptions` | `RequestOptions \| undefined` | Optional | Pass additional request options. |
 

doc/api/inventory.md

@@ -210,8 +210,8 @@ body.catalogObjectIds = bodyCatalogObjectIds;
 body.locationIds = bodyLocationIds;
 body.types = bodyTypes;
 body.states = bodyStates;
-body.updatedAfter = '2016-11-01T00:00:00.000Z';
-body.updatedBefore = '2016-12-01T00:00:00.000Z';
+body.updatedAfter = '2016-11-01T00:00:00Z';
+body.updatedBefore = '2016-12-01T00:00:00Z';
 
 try {
   const { result, ...httpResponse } = await inventoryApi.deprecatedBatchRetrieveInventoryChanges(body);
@@ -260,7 +260,7 @@ const bodyLocationIds: string[] = ['59TNP9SA8VGDA'];
 const body: BatchRetrieveInventoryCountsRequest = {};
 body.catalogObjectIds = bodyCatalogObjectIds;
 body.locationIds = bodyLocationIds;
-body.updatedAfter = '2016-11-16T00:00:00.000Z';
+body.updatedAfter = '2016-11-16T00:00:00Z';
 
 try {
   const { result, ...httpResponse } = await inventoryApi.deprecatedBatchRetrieveInventoryCounts(body);
@@ -383,8 +383,8 @@ body.catalogObjectIds = bodyCatalogObjectIds;
 body.locationIds = bodyLocationIds;
 body.types = bodyTypes;
 body.states = bodyStates;
-body.updatedAfter = '2016-11-01T00:00:00.000Z';
-body.updatedBefore = '2016-12-01T00:00:00.000Z';
+body.updatedAfter = '2016-11-01T00:00:00Z';
+body.updatedBefore = '2016-12-01T00:00:00Z';
 
 try {
   const { result, ...httpResponse } = await inventoryApi.batchRetrieveInventoryChanges(body);
@@ -440,7 +440,7 @@ const bodyLocationIds: string[] = ['59TNP9SA8VGDA'];
 const body: BatchRetrieveInventoryCountsRequest = {};
 body.catalogObjectIds = bodyCatalogObjectIds;
 body.locationIds = bodyLocationIds;
-body.updatedAfter = '2016-11-16T00:00:00.000Z';
+body.updatedAfter = '2016-11-16T00:00:00Z';
 
 try {
   const { result, ...httpResponse } = await inventoryApi.batchRetrieveInventoryCounts(body);

doc/api/labor.md

@@ -408,21 +408,21 @@ bodyShiftWage.hourlyRate = bodyShiftWageHourlyRate;
 const bodyShiftBreaks: Break[] = [];
 
 const bodyShiftbreaks0: Break = {
-  startAt: '2019-01-25T06:11:00-05:00',
+  startAt: '2019-01-25T11:11:00+00:00',
   breakTypeId: 'REGS1EQR1TPZ5',
   name: 'Tea Break',
   expectedDuration: 'PT5M',
   isPaid: true,
 };
-bodyShiftbreaks0.endAt = '2019-01-25T06:16:00-05:00';
+bodyShiftbreaks0.endAt = '2019-01-25T11:16:00+00:00';
 
 bodyShiftBreaks[0] = bodyShiftbreaks0;
 
 const bodyShift: Shift = {
-  startAt: '2019-01-25T03:11:00-05:00',
+  startAt: '2019-01-25T08:11:00+00:00',
 };
 bodyShift.locationId = 'PAA1RJZZKXBFG';
-bodyShift.endAt = '2019-01-25T13:11:00-05:00';
+bodyShift.endAt = '2019-01-25T18:11:00+00:00';
 bodyShift.wage = bodyShiftWage;
 bodyShift.breaks = bodyShiftBreaks;
 bodyShift.teamMemberId = 'ormj0jJJZ5OZIzxrZYJI';
@@ -486,7 +486,24 @@ async searchShifts(
 
 ```ts
 const contentType = null;
+const bodyQueryFilterWorkdayDateRange: DateRange = {};
+bodyQueryFilterWorkdayDateRange.startDate = '2019-01-20';
+bodyQueryFilterWorkdayDateRange.endDate = '2019-02-03';
+
+const bodyQueryFilterWorkday: ShiftWorkday = {};
+bodyQueryFilterWorkday.dateRange = bodyQueryFilterWorkdayDateRange;
+bodyQueryFilterWorkday.matchShiftsBy = 'START_AT';
+bodyQueryFilterWorkday.defaultTimezone = 'America/Los_Angeles';
+
+const bodyQueryFilter: ShiftFilter = {};
+bodyQueryFilter.workday = bodyQueryFilterWorkday;
+
+const bodyQuery: ShiftQuery = {};
+bodyQuery.filter = bodyQueryFilter;
+
 const body: SearchShiftsRequest = {};
+body.query = bodyQuery;
+body.limit = 100;
 
 try {
   const { result, ...httpResponse } = await laborApi.searchShifts(body);
@@ -625,22 +642,22 @@ bodyShiftWage.hourlyRate = bodyShiftWageHourlyRate;
 const bodyShiftBreaks: Break[] = [];
 
 const bodyShiftbreaks0: Break = {
-  startAt: '2019-01-25T06:11:00-05:00',
+  startAt: '2019-01-25T11:11:00+00:00',
   breakTypeId: 'REGS1EQR1TPZ5',
   name: 'Tea Break',
   expectedDuration: 'PT5M',
   isPaid: true,
 };
 bodyShiftbreaks0.id = 'X7GAQYVVRRG6P';
-bodyShiftbreaks0.endAt = '2019-01-25T06:16:00-05:00';
+bodyShiftbreaks0.endAt = '2019-01-25T11:16:00+00:00';
 
 bodyShiftBreaks[0] = bodyShiftbreaks0;
 
 const bodyShift: Shift = {
-  startAt: '2019-01-25T03:11:00-05:00',
+  startAt: '2019-01-25T08:11:00+00:00',
 };
 bodyShift.locationId = 'PAA1RJZZKXBFG';
-bodyShift.endAt = '2019-01-25T13:11:00-05:00';
+bodyShift.endAt = '2019-01-25T18:11:00+00:00';
 bodyShift.wage = bodyShiftWage;
 bodyShift.breaks = bodyShiftBreaks;
 bodyShift.version = 1;

doc/api/orders.md

@@ -466,7 +466,7 @@ An `UpdateOrder` request requires the following:
 
 - The `order_id` in the endpoint path, identifying the order to update.
 - The latest `version` of the order to update.
-- The [sparse order](https://developer.squareup.com/docs/orders-api/manage-orders#sparse-order-objects)
+- The [sparse order](https://developer.squareup.com/docs/orders-api/manage-orders/update-orders#sparse-order-objects)
   containing only the fields to update and the version to which the update is
   being applied.
 - If deleting fields, the [dot notation paths](https://developer.squareup.com/docs/orders-api/manage-orders#on-dot-notation)

doc/api/subscriptions.md

@@ -226,17 +226,7 @@ async updateSubscription(
 ```ts
 const subscriptionId = 'subscription_id0';
 const contentType = null;
-const bodySubscriptionPriceOverrideMoney: Money = {};
-bodySubscriptionPriceOverrideMoney.amount = 2000;
-bodySubscriptionPriceOverrideMoney.currency = 'USD';
-
-const bodySubscription: Subscription = {};
-bodySubscription.taxPercentage = 'null';
-bodySubscription.priceOverrideMoney = bodySubscriptionPriceOverrideMoney;
-bodySubscription.version = 1594155459464;
-
 const body: UpdateSubscriptionRequest = {};
-body.subscription = bodySubscription;
 
 try {
   const { result, ...httpResponse } = await subscriptionsApi.updateSubscription(subscriptionId, body);

doc/api/terminal.md

@@ -106,7 +106,7 @@ async searchTerminalActions(
 ```ts
 const contentType = null;
 const bodyQueryFilterCreatedAt: TimeRange = {};
-bodyQueryFilterCreatedAt.startAt = '2022-04-01T00:00:00.000Z';
+bodyQueryFilterCreatedAt.startAt = '2022-04-01T00:00:00Z';
 
 const bodyQueryFilter: TerminalActionQueryFilter = {};
 bodyQueryFilter.createdAt = bodyQueryFilterCreatedAt;

doc/client.md

@@ -5,7 +5,7 @@ The following parameters are configurable for the API Client:
 
 | Parameter | Type | Description |
 |  --- | --- | --- |
-| `squareVersion` | `string` | Square Connect API versions<br>*Default*: `'2022-06-16'` |
+| `squareVersion` | `string` | Square Connect API versions<br>*Default*: `'2022-07-20'` |
 | `customUrl` | `string` | Sets the base URL requests are made to. Defaults to `https://connect.squareup.com`<br>*Default*: `'https://connect.squareup.com'` |
 | `environment` | `string` | The API environment. <br> **Default: `production`** |
 | `additionalHeaders` | `Readonly<Record<string, string>>` | Additional headers to add to each API call<br>*Default*: `{}` |
@@ -40,7 +40,7 @@ The API client can be initialized as follows:
 
 ```ts
 const client = new Client({
-  squareVersion: '2022-06-16',
+  squareVersion: '2022-07-20',
   timeout: 60000,
   additionalHeaders: {},
   userAgentDetail: '',
@@ -56,7 +56,7 @@ import fs from 'fs';
 import { ApiError, Client, FileWrapper, LocationsApi } from 'square';
 
 const client = new Client({
-  squareVersion: '2022-06-16',
+  squareVersion: '2022-07-20',
   timeout: 60000,
   additionalHeaders: {},
   userAgentDetail: '',

doc/models/batch-retrieve-inventory-changes-request.md

@@ -16,7 +16,7 @@
 | `updatedAfter` | `string \| undefined` | Optional | The filter to return results with their `calculated_at` value<br>after the given time as specified in an RFC 3339 timestamp.<br>The default value is the UNIX epoch of (`1970-01-01T00:00:00Z`). |
 | `updatedBefore` | `string \| undefined` | Optional | The filter to return results with their `created_at` or `calculated_at` value<br>strictly before the given time as specified in an RFC 3339 timestamp.<br>The default value is the UNIX epoch of (`1970-01-01T00:00:00Z`). |
 | `cursor` | `string \| undefined` | Optional | A pagination cursor returned by a previous call to this endpoint.<br>Provide this to retrieve the next set of results for the original query.<br><br>See the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information. |
-| `limit` | `number \| undefined` | Optional | **Constraints**: `>= 1`, `<= 1000` |
+| `limit` | `number \| undefined` | Optional | The number of [records](../../doc/models/inventory-change.md) to return.<br>**Constraints**: `>= 1`, `<= 1000` |
 
 ## Example (as JSON)