@dsptch-work/api-client 0.45.0 → 0.46.0

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to `@dsptch-work/api-client` are documented here. The format
 [Semantic Versioning](https://semver.org) — currently `0.x`, so breaking changes may land in a
 minor bump until `1.0.0`. See [RELEASING.md](./RELEASING.md) for the release and versioning process.
 
+## [0.46.0] - 2026-10-28
+
+### Added
+
+- `AssetsProducts.restockProduct()` and `adjustProductInventory()` accept `user_id` or
+  `container_item_id` in `AssetsRestockParameters` and `AssetsAdjustmentParameters`, and
+  `assets_site_id` is now optional. Supply exactly one holder: the API returns `422` for none or
+  multiple holders. A site or container can include `assets_sub_location_id`; a user cannot. The
+  generated types do not enforce the exactly-one constraint.
+
+### Changed
+
+- **Breaking runtime validation:** `AssetsItems.createItem()` returns `422` when
+  `assets_sub_location_id` is supplied with `user_id` or without a placement. Remove the sublocation
+  from affected requests; the generated type does not enforce this constraint.
+
+See the [October 28 API changelog](https://dsptch.app/support/docs/developers/api-changelog#2026-10-28)
+for the full REST contract details.
+
 ## [0.45.0] - 2026-10-27
 
 ### Added

package/dist/gen/sdk.gen.d.ts

@@ -936,7 +936,7 @@ export declare class AssetsProducts {
      */
     static archiveProduct<ThrowOnError extends boolean = false>(options: Options<ArchiveProductData, ThrowOnError>): RequestResult<ArchiveProductResponses, ArchiveProductErrors, ThrowOnError>;
     /**
-     * Adjust inventory on-hand count
+     * Adjust bulk product count
      *
      * **Required scope:**
      *
@@ -945,7 +945,7 @@ export declare class AssetsProducts {
      */
     static adjustProductInventory<ThrowOnError extends boolean = false>(options: Options<AdjustProductInventoryData, ThrowOnError>): RequestResult<AdjustProductInventoryResponses, AdjustProductInventoryErrors, ThrowOnError>;
     /**
-     * Restock bulk product at site
+     * Restock bulk product
      *
      * **Required scope:**
      *

package/dist/gen/sdk.gen.js

@@ -1597,7 +1597,7 @@ export class AssetsProducts {
         });
     }
     /**
-     * Adjust inventory on-hand count
+     * Adjust bulk product count
      *
      * **Required scope:**
      *
@@ -1616,7 +1616,7 @@ export class AssetsProducts {
         });
     }
     /**
-     * Restock bulk product at site
+     * Restock bulk product
      *
      * **Required scope:**
      *

package/dist/gen/types.gen.d.ts

@@ -2145,7 +2145,7 @@ export type PeopleEmploymentResponseObject = {
      */
     training_annual_minutes: number | null;
     /**
-     * Minutes per workweek the fixed salary is intended to compensate. Not time worked, and separate from worked_annual_minutes.
+     * Minutes per workweek the fixed salary is intended to compensate. This is the salary's fixed-hours basis, not time worked, and is separate from worked_annual_minutes.
      */
     salary_weekly_minutes: number;
     /**
@@ -2157,7 +2157,7 @@ export type PeopleEmploymentResponseObject = {
      */
     training_annual_amount_cents?: string | null;
     /**
-     * Annual fixed-hours salary in cents as a decimal string; present for company keys, company administrators, and the employed person, and null when authorized but unset.
+     * Annual fixed-hours salary in cents as a decimal string; present for company keys, company administrators, and the employed person, and null when authorized but unset. Variable-hours and fluctuating-workweek salaries are not supported.
      */
     salary_annual_amount_cents?: string | null;
     /**
@@ -2266,11 +2266,11 @@ export type PeopleEmploymentCreateParameters = {
      */
     employer_combined_savings_cents?: string | null;
     /**
-     * Annual fixed-hours salary in cents as a decimal string. Omit or send null to leave it unset.
+     * Annual fixed-hours salary in cents as a decimal string. Variable-hours and fluctuating-workweek salaries are not supported. Omit or send null to leave it unset.
      */
     salary_annual_amount_cents?: string | null;
     /**
-     * Minutes per workweek the fixed salary is intended to compensate, as a whole number from 1 to 10080 (one week). Omit to use 2400 (40 hours); null is refused.
+     * Minutes per workweek the fixed salary is intended to compensate, as a whole number from 1 to 10080 (one week). This is the salary's fixed-hours basis, not observed time. Omit to use 2400 (40 hours); null is refused.
      */
     salary_weekly_minutes?: number;
 };
@@ -2327,11 +2327,11 @@ export type PeopleEmploymentScheduledChangeCreateParameters = {
      */
     employer_combined_savings_cents?: string | null;
     /**
-     * Annual fixed-hours salary in cents as a decimal string. Omit to carry forward the preceding version, or send null to clear it.
+     * Annual fixed-hours salary in cents as a decimal string. Variable-hours and fluctuating-workweek salaries are not supported. Omit to carry forward the preceding version, or send null to clear it.
      */
     salary_annual_amount_cents?: string | null;
     /**
-     * Minutes per workweek the fixed salary is intended to compensate, as a whole number from 1 to 10080 (one week). Omit to carry forward the preceding version; null is refused.
+     * Minutes per workweek the fixed salary is intended to compensate, as a whole number from 1 to 10080 (one week). This is the salary's fixed-hours basis, not observed time. Omit to carry forward the preceding version; null is refused.
      */
     salary_weekly_minutes?: number;
     /**
@@ -2388,11 +2388,11 @@ export type PeopleEmploymentScheduledChangeUpdateParameters = {
      */
     employer_combined_savings_cents?: string | null;
     /**
-     * Annual fixed-hours salary in cents as a decimal string. Omit to preserve the value at the targeted boundary, or send null to clear it.
+     * Annual fixed-hours salary in cents as a decimal string. Variable-hours and fluctuating-workweek salaries are not supported. Omit to preserve the value at the targeted boundary, or send null to clear it.
      */
     salary_annual_amount_cents?: string | null;
     /**
-     * Minutes per workweek the fixed salary is intended to compensate, as a whole number from 1 to 10080 (one week). Omit to preserve the value at the targeted boundary; null is refused.
+     * Minutes per workweek the fixed salary is intended to compensate, as a whole number from 1 to 10080 (one week). This is the salary's fixed-hours basis, not observed time. Omit to preserve the value at the targeted boundary; null is refused.
      */
     salary_weekly_minutes?: number;
     /**
@@ -6206,7 +6206,7 @@ export type TimeEntryResponseObject = {
      */
     currency?: string;
     /**
-     * Where the base rate came from: one of user_default, position, prevailing_wage, or custom; null when no rate is set. (The schema types this as a free-form nullable string; the value set is defined by the model enum.) Present for company keys and for administrators of the company whose pay schedule holds the entry; omitted for other user keys.
+     * Where the base rate came from: one of user_default, position, prevailing_wage, or custom; null when no rate is set. A fixed-hours salary is a user_default rate. (The schema types this as a free-form nullable string; the value set is defined by the model enum.) Present for company keys and for administrators of the company whose pay schedule holds the entry; omitted for other user keys.
      */
     hourly_rate_src_type?: string | null;
     /**
@@ -15281,7 +15281,7 @@ export type AssetsItemParameters = {
      */
     container_item_id?: string | null;
     /**
-     * Optional, create only. The storage location within the placement site or container the item lands in; must belong to that holder. Omit for an unbinned placement. Ignored for a user assignment.
+     * Optional, create only. The storage location within the placement site or container the item lands in; must belong to that holder. Omit for an unbinned placement. One named with user_id, or without a placement, answers 422 at its pointer.
      */
     assets_sub_location_id?: string | null;
 };
@@ -16785,15 +16785,23 @@ export type AssetsTransferParameters = {
     }>;
 };
 /**
- * Add stock of a bulk product at a site, recording a receive transaction. Bulk products only.
+ * Add stock of a bulk product to a holder — a site, a user's custody, or a container — recording a receive transaction. Name the holder with exactly one of assets_site_id, user_id, or container_item_id; several answer 422 at each named key, and none answers 422. Bulk products only.
  */
 export type AssetsRestockParameters = {
     /**
      * ID of the site to add the stock to. A site the API key cannot see answers 404.
      */
-    assets_site_id: string;
+    assets_site_id?: string;
+    /**
+     * ID of the user to give the stock to. A user outside the company, or one whose employment has ended, answers 404.
+     */
+    user_id?: string;
+    /**
+     * ID of the container item to place the stock in. A container the API key cannot see answers 404; an item that is not a container answers 422.
+     */
+    container_item_id?: string;
     /**
-     * Optional. The site's storage location the stock lands in; one that is not the site's answers 404. Omit or send null for the site's unbinned stock.
+     * Optional. The site's or container's storage location the stock lands in; one that is not the holder's answers 404, and one named with user_id answers 422 at its pointer. Omit or send null for the holder's unbinned stock.
      */
     assets_sub_location_id?: string | null;
     /**
@@ -16806,19 +16814,27 @@ export type AssetsRestockParameters = {
     performed_by_user_id: string;
 };
 /**
- * Set the on-hand count of a bulk product at a site to a specific number, recording the difference as an adjustment transaction. The site must already stock the product. Bulk products only.
+ * Set the count of a bulk product held by a holder — a site, a user's custody, or a container — to a specific number, recording the difference as an adjustment transaction. Name the holder with exactly one of assets_site_id, user_id, or container_item_id; several answer 422 at each named key, and none answers 422. The holder must already hold the product. Bulk products only.
  */
 export type AssetsAdjustmentParameters = {
     /**
      * ID of the site whose on-hand count is being set. A site the API key cannot see answers 404.
      */
-    assets_site_id: string;
+    assets_site_id?: string;
+    /**
+     * ID of the user whose held count is being set. A user outside the company, or one whose employment has ended, answers 404.
+     */
+    user_id?: string;
+    /**
+     * ID of the container item whose held count is being set. A container the API key cannot see answers 404.
+     */
+    container_item_id?: string;
     /**
-     * Optional. The site's storage location whose count is being set; one that is not the site's answers 404. Omit or send null to set the site's unbinned count.
+     * Optional. The site's or container's storage location whose count is being set; one that is not the holder's answers 404, and one named with user_id answers 422 at its pointer. Omit or send null to set the holder's unbinned count.
      */
     assets_sub_location_id?: string | null;
     /**
-     * The corrected on-hand count for the site, as an integer of 0 or more; any other value answers 422. The difference from the current count is recorded as the adjustment.
+     * The corrected count for the holder, as an integer of 0 or more; any other value answers 422. The difference from the current count is recorded as the adjustment.
      */
     new_quantity: number;
     /**

package/dist/gen/zod.gen.d.ts

@@ -11519,19 +11519,23 @@ export declare const zAssetsTransferParameters: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * Add stock of a bulk product at a site, recording a receive transaction. Bulk products only.
+ * Add stock of a bulk product to a holder — a site, a user's custody, or a container — recording a receive transaction. Name the holder with exactly one of assets_site_id, user_id, or container_item_id; several answer 422 at each named key, and none answers 422. Bulk products only.
  */
 export declare const zAssetsRestockParameters: z.ZodObject<{
-    assets_site_id: z.ZodString;
+    assets_site_id: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodString>;
+    container_item_id: z.ZodOptional<z.ZodString>;
     assets_sub_location_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     quantity: z.ZodInt;
     performed_by_user_id: z.ZodString;
 }, z.core.$strip>;
 /**
- * Set the on-hand count of a bulk product at a site to a specific number, recording the difference as an adjustment transaction. The site must already stock the product. Bulk products only.
+ * Set the count of a bulk product held by a holder — a site, a user's custody, or a container — to a specific number, recording the difference as an adjustment transaction. Name the holder with exactly one of assets_site_id, user_id, or container_item_id; several answer 422 at each named key, and none answers 422. The holder must already hold the product. Bulk products only.
  */
 export declare const zAssetsAdjustmentParameters: z.ZodObject<{
-    assets_site_id: z.ZodString;
+    assets_site_id: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodString>;
+    container_item_id: z.ZodOptional<z.ZodString>;
     assets_sub_location_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     new_quantity: z.ZodInt;
     performed_by_user_id: z.ZodString;
@@ -15307,7 +15311,9 @@ export declare const zArchiveProductResponse: z.ZodObject<{
     updated_at: z.ZodISODateTime;
 }, z.core.$strip>;
 export declare const zAdjustProductInventoryBody: z.ZodObject<{
-    assets_site_id: z.ZodString;
+    assets_site_id: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodString>;
+    container_item_id: z.ZodOptional<z.ZodString>;
     assets_sub_location_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     new_quantity: z.ZodInt;
     performed_by_user_id: z.ZodString;
@@ -15357,7 +15363,9 @@ export declare const zAdjustProductInventoryResponse: z.ZodObject<{
     updated_at: z.ZodISODateTime;
 }, z.core.$strip>;
 export declare const zRestockProductBody: z.ZodObject<{
-    assets_site_id: z.ZodString;
+    assets_site_id: z.ZodOptional<z.ZodString>;
+    user_id: z.ZodOptional<z.ZodString>;
+    container_item_id: z.ZodOptional<z.ZodString>;
     assets_sub_location_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     quantity: z.ZodInt;
     performed_by_user_id: z.ZodString;

package/dist/gen/zod.gen.js

@@ -8732,19 +8732,23 @@ export const zAssetsTransferParameters = z.object({
     })).min(1)
 });
 /**
- * Add stock of a bulk product at a site, recording a receive transaction. Bulk products only.
+ * Add stock of a bulk product to a holder — a site, a user's custody, or a container — recording a receive transaction. Name the holder with exactly one of assets_site_id, user_id, or container_item_id; several answer 422 at each named key, and none answers 422. Bulk products only.
  */
 export const zAssetsRestockParameters = z.object({
-    assets_site_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/),
+    assets_site_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).optional(),
+    user_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).optional(),
+    container_item_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).optional(),
     assets_sub_location_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).nullish(),
     quantity: z.int().gte(1),
     performed_by_user_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/)
 });
 /**
- * Set the on-hand count of a bulk product at a site to a specific number, recording the difference as an adjustment transaction. The site must already stock the product. Bulk products only.
+ * Set the count of a bulk product held by a holder — a site, a user's custody, or a container — to a specific number, recording the difference as an adjustment transaction. Name the holder with exactly one of assets_site_id, user_id, or container_item_id; several answer 422 at each named key, and none answers 422. The holder must already hold the product. Bulk products only.
  */
 export const zAssetsAdjustmentParameters = z.object({
-    assets_site_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/),
+    assets_site_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).optional(),
+    user_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).optional(),
+    container_item_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).optional(),
     assets_sub_location_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/).nullish(),
     new_quantity: z.int().gte(0),
     performed_by_user_id: z.string().regex(/[^\x09-\x0D\x20…   - ‧-‪  　]|[‧‪]/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsptch-work/api-client",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "description": "Generated TypeScript client for the DSPTCH REST API.",
   "keywords": [
     "dsptch",