@dsptch-work/api-client 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,44 @@ minor bump until `1.0.0`. See [RELEASING.md](./RELEASING.md) for the release and
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-08-12
+
+### Added
+
+- `ProblemTypeCatalog` and `zProblemTypeCatalog` add `precondition_required` and
+  `precondition_failed`, the identifiers for the `428` and `412` returned by the operations that now
+  require `If-Match`.
+- `JobResponseObject` adds required `clock_in_requirement` (`'none' | 'warning' | 'required'`), and
+  `JobParameters` accepts it as an optional field on create and update. Sending `required` needs the
+  company to be enabled for it; otherwise the request returns `422`.
+
+### Changed
+
+- **Breaking:** `Timecodes.updateTimecode`, `Timecodes.scheduleTimecodeChange`,
+  `Timecodes.cancelTimecodeScheduledChanges`, `Timecodes.cancelTimecodeScheduledTermination`, and
+  `JobWageDeterminations.deleteWageDetermination` now take a **required** `headers` option carrying
+  `If-Match`, and their error types add `412` and `428`. TypeScript rejects a call that omits the
+  header, so upgrading surfaces every affected call site at compile time rather than as a runtime
+  `428`. Pass the `ETag` from a read of the resource, or `'*'` to write
+  against whatever exists, and take the next validator from the write's own response. Creating a new
+  record, the pay-schedule child writes, and the employment writes are unchanged.
+- `JobResponseObject.require_clock_in` is now `boolean` rather than `boolean | null`, and reads as a
+  compatibility alias over `clock_in_requirement` — `true` when the level is `warning` or `required`.
+  On write, `true` ensures at least `warning` without downgrading a job already set to `required`,
+  and `false` or `null` clears it to `none`. Prefer `clock_in_requirement`.
+
+### Fixed
+
+- `cancelUserCompanyScheduledTermination` documents a `422` for an employment with no scheduled
+  termination boundary to cancel, where the failure was previously untyped.
+- The generated docstrings for `sex`, `veteran_status`, and `hispanic_origin` name the lowercase
+  values the API has always emitted (`female`, `protected_veteran`, `not_specified`) instead of the
+  uppercase form previously published. No emitted value changed, and the sibling `race` field
+  genuinely emits uppercase codes.
+
+See the [API changelog](https://dsptch.app/support/docs/developers/api-changelog) for the complete
+REST contract details.
+
 ## [0.5.0] - 2026-08-11
 
 ### Added

package/README.md

@@ -7,7 +7,7 @@ that wires up the base URL and `X-Api-Key` auth for you.
 
 > **Status:** pre-1.0, published to the public npm registry. The API is still catching up
 > to the DSPTCH web app, so releases stay in the `0.x` range and may ship breaking changes
-> between minor versions (`0.4.x` → `0.5.0`) — pin a version you have tested.
+> between minor versions (`0.5.x` → `0.6.0`) — pin a version you have tested.
 
 ## Installing
 

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

@@ -2599,6 +2599,8 @@ export declare class Timecodes {
      * re-sync. An `effective_date` in the body is not read here — the correction
      * takes effect at the record's existing `valid_from`.
      *
+     * Conditional: send the timecode's `ETag` as `If-Match`.
+     *
      *
      * **Required scope:**
      *

package/dist/gen/sdk.gen.js

@@ -4522,6 +4522,8 @@ export class Timecodes {
      * re-sync. An `effective_date` in the body is not read here — the correction
      * takes effect at the record's existing `valid_from`.
      *
+     * Conditional: send the timecode's `ETag` as `If-Match`.
+     *
      *
      * **Required scope:**
      *

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

@@ -170,6 +170,14 @@ export type Problem = {
  *
  * The write conflicts with what is already recorded for the resource — another version occupies the same span, or the write contradicts the resource's recorded identity. Re-read the current state and retry on top of it.
  *
+ * ## 412
+ *
+ * ### precondition_failed
+ *
+ * **Precondition Failed**
+ *
+ * The `If-Match` validator names a version of this resource that is no longer current — the version family changed after you read it. Re-read the resource, take its fresh `ETag`, and reapply your change on top of the current state. A malformed or unrecognizable validator refuses the same way, since neither matches.
+ *
  * ## 422
  *
  * ### attachment_not_image
@@ -274,6 +282,14 @@ export type Problem = {
  *
  * The apprentice's wage schedule does not belong to the program in the URL. Use a schedule from that program.
  *
+ * ## 428
+ *
+ * ### precondition_required
+ *
+ * **Precondition Required**
+ *
+ * The write must state which version of the resource it was composed against, and no `If-Match` was sent. Read the resource, send its `ETag` back as `If-Match`, or send `If-Match: *` to write unconditionally against whatever exists.
+ *
  * ## 429
  *
  * ### too_many_requests
@@ -291,7 +307,7 @@ export type Problem = {
  * Something failed on the server; nothing in the request needs fixing. Retry later, or report the problem if it persists.
  *
  */
-export type ProblemTypeCatalog = 'blank_axis' | 'invalid_cursor' | 'invalid_filter_key' | 'invalid_limit' | 'invalid_signature' | 'non_range_filter_value' | 'non_scalar_axis' | 'non_scalar_filter_value' | 'parameter_missing' | 'parameter_not_object' | 'unknown_axis' | 'unknown_key' | 'unsupported_axis' | 'valid_axis_on_timeline' | 'unauthorized' | 'company_scoped_key_required' | 'forbidden' | 'insufficient_api_key_scope' | 'not_found' | 'recorded_since_termination' | 'version_overlap' | 'attachment_not_image' | 'company_not_employer' | 'confirm_apprenticeship_conflict' | 'destroy_restricted' | 'invalid_date' | 'invalid_filter_value' | 'invalid_iso8601_duration' | 'invalid_placement_move' | 'invalid_signed_id' | 'non_numeric_cents' | 'nothing_to_cancel' | 'pagination_failed' | 'subtype_foreign_keys' | 'synced_determination' | 'user_not_company_member' | 'validation_failed' | 'wage_schedule_outside_program' | 'too_many_requests' | 'internal_error';
+export type ProblemTypeCatalog = 'blank_axis' | 'invalid_cursor' | 'invalid_filter_key' | 'invalid_limit' | 'invalid_signature' | 'non_range_filter_value' | 'non_scalar_axis' | 'non_scalar_filter_value' | 'parameter_missing' | 'parameter_not_object' | 'unknown_axis' | 'unknown_key' | 'unsupported_axis' | 'valid_axis_on_timeline' | 'unauthorized' | 'company_scoped_key_required' | 'forbidden' | 'insufficient_api_key_scope' | 'not_found' | 'recorded_since_termination' | 'version_overlap' | 'precondition_failed' | 'attachment_not_image' | 'company_not_employer' | 'confirm_apprenticeship_conflict' | 'destroy_restricted' | 'invalid_date' | 'invalid_filter_value' | 'invalid_iso8601_duration' | 'invalid_placement_move' | 'invalid_signed_id' | 'non_numeric_cents' | 'nothing_to_cancel' | 'pagination_failed' | 'subtype_foreign_keys' | 'synced_determination' | 'user_not_company_member' | 'validation_failed' | 'wage_schedule_outside_program' | 'precondition_required' | 'too_many_requests' | 'internal_error';
 export type ApiKeyScopeResponseObject = {
     resource: string;
     action: 'read' | 'create' | 'update' | 'delete';
@@ -2352,9 +2368,13 @@ export type JobResponseObject = {
      */
     tz_name: string;
     /**
-     * Whether workers must clock in to track time on this job; null when unset.
+     * Compatibility alias — true when clock_in_requirement is warning or required; always boolean.
+     */
+    require_clock_in: boolean;
+    /**
+     * Clock-in enforcement level: one of none (no guidance), warning (compliance warning on manual entries), or required (hard stop for technician web CUD and GraphQL owner CUD, including client-claimed punches, until a server-verified punch path exists; company-authed API v1 is intentionally ungated).
      */
-    require_clock_in: boolean | null;
+    clock_in_requirement: 'none' | 'warning' | 'required';
     /**
      * Human-readable job name, unique within the creating company; null when unset.
      */
@@ -2669,9 +2689,13 @@ export type JobParameters = {
     tz_name?: string;
     time_card_start_day?: TimeCardStartDay;
     /**
-     * Whether workers must clock in to track time on this job; null when unset.
+     * Compatibility alias — true ensures at least warning (never downgrades required); false or null clears to none; omit to leave unchanged. Prefer clock_in_requirement.
      */
     require_clock_in?: boolean | null;
+    /**
+     * Clock-in enforcement level: one of none (no guidance), warning (compliance warning on manual entries), or required (hard stop for technician web CUD and GraphQL owner CUD, including client-claimed punches, until a server-verified punch path exists; company-authed API v1 is intentionally ungated). Omit the field to leave the current value unchanged.
+     */
+    clock_in_requirement?: 'none' | 'warning' | 'required';
     /**
      * Whether to send geofence-based clock-in/out reminders for this job; null when unset.
      */
@@ -3080,7 +3104,7 @@ export type UserResponseObject = {
          */
         race?: Array<string> | null;
         /**
-         * Worker sex for demographic reporting: one of FEMALE, MALE, NON_BINARY, or NOT_SPECIFIED. Null when unset.
+         * Worker sex for demographic reporting: one of female, male, non_binary, or not_specified. Null when unset.
          */
         sex?: string | null;
         /**
@@ -3096,11 +3120,11 @@ export type UserResponseObject = {
          */
         drivers_license_number?: string | null;
         /**
-         * Veteran status per US Census definitions: one of PROTECTED_VETERAN, NOT_PROTECTED_VETERAN, RESERVES, GUARD, or NOT_SPECIFIED. Null when unset.
+         * Veteran status per US Census definitions: one of protected_veteran, not_protected_veteran, reserves, guard, or not_specified. Null when unset.
          */
         veteran_status?: string | null;
         /**
-         * Whether the worker is of Hispanic origin per US Census definitions: one of YES, NO, or NOT_SPECIFIED. Null when unset.
+         * Whether the worker is of Hispanic origin per US Census definitions: one of yes, no, or not_specified. Null when unset.
          */
         hispanic_origin?: string | null;
         /**
@@ -3369,7 +3393,7 @@ export type UserParameters = {
          */
         race?: Array<string> | null;
         /**
-         * Worker sex for demographic reporting: one of FEMALE, MALE, NON_BINARY, or NOT_SPECIFIED.
+         * Worker sex for demographic reporting: one of female, male, non_binary, or not_specified.
          */
         sex?: string | null;
         /**
@@ -3385,11 +3409,11 @@ export type UserParameters = {
          */
         drivers_license_number?: string | null;
         /**
-         * Veteran status per US Census definitions: one of PROTECTED_VETERAN, NOT_PROTECTED_VETERAN, RESERVES, GUARD, or NOT_SPECIFIED.
+         * Veteran status per US Census definitions: one of protected_veteran, not_protected_veteran, reserves, guard, or not_specified.
          */
         veteran_status?: string | null;
         /**
-         * Whether the worker is of Hispanic origin per US Census definitions: one of YES, NO, or NOT_SPECIFIED.
+         * Whether the worker is of Hispanic origin per US Census definitions: one of yes, no, or not_specified.
          */
         hispanic_origin?: string | null;
         /**
@@ -13781,6 +13805,12 @@ export type CreateWageDeterminationResponses = {
 export type CreateWageDeterminationResponse = CreateWageDeterminationResponses[keyof CreateWageDeterminationResponses];
 export type DeleteWageDeterminationData = {
     body?: never;
+    headers: {
+        /**
+         * Version validator this write is composed against — the `ETag` from a read of this wage determination, or `*` to write against whatever exists. See "Version validators" in the API overview.
+         */
+        'If-Match': string;
+    };
     path: {
         job_id: string;
         uid: string;
@@ -13797,10 +13827,18 @@ export type DeleteWageDeterminationErrors = {
      * Not Found
      */
     404: Problem;
+    /**
+     * Precondition Failed
+     */
+    412: Problem;
     /**
      * Unprocessable Content
      */
     422: Problem;
+    /**
+     * Precondition Required
+     */
+    428: Problem;
 };
 export type DeleteWageDeterminationError = DeleteWageDeterminationErrors[keyof DeleteWageDeterminationErrors];
 export type DeleteWageDeterminationResponses = {
@@ -16550,6 +16588,12 @@ export type ListTimecodeHistoryResponses = {
 export type ListTimecodeHistoryResponse = ListTimecodeHistoryResponses[keyof ListTimecodeHistoryResponses];
 export type CancelTimecodeScheduledChangesData = {
     body?: never;
+    headers: {
+        /**
+         * Version validator this write is composed against — the `ETag` from a read of this timecode, or `*` to write against whatever exists. See "Version validators" in the API overview.
+         */
+        'If-Match': string;
+    };
     path: {
         timecode_id: string;
     };
@@ -16565,10 +16609,18 @@ export type CancelTimecodeScheduledChangesErrors = {
      * Not Found
      */
     404: Problem;
+    /**
+     * Precondition Failed
+     */
+    412: Problem;
     /**
      * Unprocessable Content
      */
     422: Problem;
+    /**
+     * Precondition Required
+     */
+    428: Problem;
 };
 export type CancelTimecodeScheduledChangesError = CancelTimecodeScheduledChangesErrors[keyof CancelTimecodeScheduledChangesErrors];
 export type CancelTimecodeScheduledChangesResponses = {
@@ -16606,6 +16658,12 @@ export type ListTimecodeScheduledChangesResponses = {
 export type ListTimecodeScheduledChangesResponse = ListTimecodeScheduledChangesResponses[keyof ListTimecodeScheduledChangesResponses];
 export type ScheduleTimecodeChangeData = {
     body: TimecodeScheduledChangeParameters;
+    headers: {
+        /**
+         * Version validator this write is composed against — the `ETag` from a read of this timecode, or `*` to write against whatever exists. See "Version validators" in the API overview.
+         */
+        'If-Match': string;
+    };
     path: {
         timecode_id: string;
     };
@@ -16625,10 +16683,18 @@ export type ScheduleTimecodeChangeErrors = {
      * Not Found
      */
     404: Problem;
+    /**
+     * Precondition Failed
+     */
+    412: Problem;
     /**
      * Unprocessable Content
      */
     422: Problem;
+    /**
+     * Precondition Required
+     */
+    428: Problem;
 };
 export type ScheduleTimecodeChangeError = ScheduleTimecodeChangeErrors[keyof ScheduleTimecodeChangeErrors];
 export type ScheduleTimecodeChangeResponses = {
@@ -16640,6 +16706,12 @@ export type ScheduleTimecodeChangeResponses = {
 export type ScheduleTimecodeChangeResponse = ScheduleTimecodeChangeResponses[keyof ScheduleTimecodeChangeResponses];
 export type CancelTimecodeScheduledTerminationData = {
     body?: never;
+    headers: {
+        /**
+         * Version validator this write is composed against — the `ETag` from a read of this timecode, or `*` to write against whatever exists. See "Version validators" in the API overview.
+         */
+        'If-Match': string;
+    };
     path: {
         timecode_id: string;
     };
@@ -16659,10 +16731,18 @@ export type CancelTimecodeScheduledTerminationErrors = {
      * Conflict
      */
     409: Problem;
+    /**
+     * Precondition Failed
+     */
+    412: Problem;
     /**
      * Unprocessable Content
      */
     422: Problem;
+    /**
+     * Precondition Required
+     */
+    428: Problem;
 };
 export type CancelTimecodeScheduledTerminationError = CancelTimecodeScheduledTerminationErrors[keyof CancelTimecodeScheduledTerminationErrors];
 export type CancelTimecodeScheduledTerminationResponses = {
@@ -16796,6 +16876,12 @@ export type GetTimecodeResponses = {
 export type GetTimecodeResponse = GetTimecodeResponses[keyof GetTimecodeResponses];
 export type UpdateTimecodeData = {
     body: TimecodeParameters;
+    headers: {
+        /**
+         * Version validator this write is composed against — the `ETag` from a read of this timecode, or `*` to write against whatever exists. See "Version validators" in the API overview.
+         */
+        'If-Match': string;
+    };
     path: {
         /**
          * Unique identifier of the timecode.
@@ -16810,10 +16896,18 @@ export type UpdateTimecodeErrors = {
      * Forbidden
      */
     403: Problem;
+    /**
+     * Precondition Failed
+     */
+    412: Problem;
     /**
      * Unprocessable Content
      */
     422: Problem;
+    /**
+     * Precondition Required
+     */
+    428: Problem;
 };
 export type UpdateTimecodeError = UpdateTimecodeErrors[keyof UpdateTimecodeErrors];
 export type UpdateTimecodeResponses = {
@@ -17684,6 +17778,10 @@ export type CancelUserCompanyScheduledTerminationErrors = {
      * Not Found
      */
     404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
 };
 export type CancelUserCompanyScheduledTerminationError = CancelUserCompanyScheduledTerminationErrors[keyof CancelUserCompanyScheduledTerminationErrors];
 export type CancelUserCompanyScheduledTerminationResponses = {

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

@@ -153,6 +153,14 @@ export declare const zProblem: z.ZodObject<{
  *
  * The write conflicts with what is already recorded for the resource — another version occupies the same span, or the write contradicts the resource's recorded identity. Re-read the current state and retry on top of it.
  *
+ * ## 412
+ *
+ * ### precondition_failed
+ *
+ * **Precondition Failed**
+ *
+ * The `If-Match` validator names a version of this resource that is no longer current — the version family changed after you read it. Re-read the resource, take its fresh `ETag`, and reapply your change on top of the current state. A malformed or unrecognizable validator refuses the same way, since neither matches.
+ *
  * ## 422
  *
  * ### attachment_not_image
@@ -257,6 +265,14 @@ export declare const zProblem: z.ZodObject<{
  *
  * The apprentice's wage schedule does not belong to the program in the URL. Use a schedule from that program.
  *
+ * ## 428
+ *
+ * ### precondition_required
+ *
+ * **Precondition Required**
+ *
+ * The write must state which version of the resource it was composed against, and no `If-Match` was sent. Read the resource, send its `ETag` back as `If-Match`, or send `If-Match: *` to write unconditionally against whatever exists.
+ *
  * ## 429
  *
  * ### too_many_requests
@@ -296,6 +312,7 @@ export declare const zProblemTypeCatalog: z.ZodEnum<{
     not_found: "not_found";
     recorded_since_termination: "recorded_since_termination";
     version_overlap: "version_overlap";
+    precondition_failed: "precondition_failed";
     attachment_not_image: "attachment_not_image";
     company_not_employer: "company_not_employer";
     confirm_apprenticeship_conflict: "confirm_apprenticeship_conflict";
@@ -313,6 +330,7 @@ export declare const zProblemTypeCatalog: z.ZodEnum<{
     user_not_company_member: "user_not_company_member";
     validation_failed: "validation_failed";
     wage_schedule_outside_program: "wage_schedule_outside_program";
+    precondition_required: "precondition_required";
     too_many_requests: "too_many_requests";
     internal_error: "internal_error";
 }>;
@@ -1768,6 +1786,11 @@ export declare const zJobParameters: z.ZodObject<{
     tz_name: z.ZodOptional<z.ZodString>;
     time_card_start_day: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>>;
     require_clock_in: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    clock_in_requirement: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>>;
     send_geofence_reminders: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     allow_customer_access: z.ZodOptional<z.ZodBoolean>;
     timekeeping_timecode_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
@@ -1841,6 +1864,11 @@ export declare const zJobUpdateParameters: z.ZodIntersection<z.ZodObject<{
     tz_name: z.ZodOptional<z.ZodString>;
     time_card_start_day: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>>;
     require_clock_in: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    clock_in_requirement: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>>;
     send_geofence_reminders: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     allow_customer_access: z.ZodOptional<z.ZodBoolean>;
     timekeeping_timecode_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
@@ -3175,7 +3203,12 @@ export declare const zJobResponseObject: z.ZodObject<{
     purchase_order_number: z.ZodNullable<z.ZodString>;
     time_card_start_day: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>;
     tz_name: z.ZodString;
-    require_clock_in: z.ZodNullable<z.ZodBoolean>;
+    require_clock_in: z.ZodBoolean;
+    clock_in_requirement: z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>;
     name: z.ZodNullable<z.ZodString>;
     federal_pwa_mode: z.ZodEnum<{
         none: "none";
@@ -12116,6 +12149,9 @@ export declare const zCreateWageDeterminationResponse: z.ZodDiscriminatedUnion<[
     updated_at: z.ZodISODateTime;
     type: z.ZodLiteral<"Pwa::JobWageDeterminations::Regional">;
 }, z.core.$strip>], "type">;
+export declare const zDeleteWageDeterminationHeaders: z.ZodObject<{
+    'If-Match': z.ZodString;
+}, z.core.$strip>;
 export declare const zDeleteWageDeterminationPath: z.ZodObject<{
     job_id: z.ZodString;
     uid: z.ZodString;
@@ -12246,7 +12282,12 @@ export declare const zListJobsResponse: z.ZodObject<{
         purchase_order_number: z.ZodNullable<z.ZodString>;
         time_card_start_day: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>;
         tz_name: z.ZodString;
-        require_clock_in: z.ZodNullable<z.ZodBoolean>;
+        require_clock_in: z.ZodBoolean;
+        clock_in_requirement: z.ZodEnum<{
+            none: "none";
+            warning: "warning";
+            required: "required";
+        }>;
         name: z.ZodNullable<z.ZodString>;
         federal_pwa_mode: z.ZodEnum<{
             none: "none";
@@ -12363,6 +12404,11 @@ export declare const zCreateJobBody: z.ZodObject<{
     tz_name: z.ZodOptional<z.ZodString>;
     time_card_start_day: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>>;
     require_clock_in: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    clock_in_requirement: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>>;
     send_geofence_reminders: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     allow_customer_access: z.ZodOptional<z.ZodBoolean>;
     timekeeping_timecode_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
@@ -12422,7 +12468,12 @@ export declare const zCreateJobResponse: z.ZodObject<{
     purchase_order_number: z.ZodNullable<z.ZodString>;
     time_card_start_day: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>;
     tz_name: z.ZodString;
-    require_clock_in: z.ZodNullable<z.ZodBoolean>;
+    require_clock_in: z.ZodBoolean;
+    clock_in_requirement: z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>;
     name: z.ZodNullable<z.ZodString>;
     federal_pwa_mode: z.ZodEnum<{
         none: "none";
@@ -12527,7 +12578,12 @@ export declare const zGetJobResponse: z.ZodObject<{
     purchase_order_number: z.ZodNullable<z.ZodString>;
     time_card_start_day: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>;
     tz_name: z.ZodString;
-    require_clock_in: z.ZodNullable<z.ZodBoolean>;
+    require_clock_in: z.ZodBoolean;
+    clock_in_requirement: z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>;
     name: z.ZodNullable<z.ZodString>;
     federal_pwa_mode: z.ZodEnum<{
         none: "none";
@@ -12640,6 +12696,11 @@ export declare const zUpdateJobBody: z.ZodIntersection<z.ZodObject<{
     tz_name: z.ZodOptional<z.ZodString>;
     time_card_start_day: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>>;
     require_clock_in: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    clock_in_requirement: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>>;
     send_geofence_reminders: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     allow_customer_access: z.ZodOptional<z.ZodBoolean>;
     timekeeping_timecode_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
@@ -12708,7 +12769,12 @@ export declare const zUpdateJobResponse: z.ZodObject<{
     purchase_order_number: z.ZodNullable<z.ZodString>;
     time_card_start_day: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>;
     tz_name: z.ZodString;
-    require_clock_in: z.ZodNullable<z.ZodBoolean>;
+    require_clock_in: z.ZodBoolean;
+    clock_in_requirement: z.ZodEnum<{
+        none: "none";
+        warning: "warning";
+        required: "required";
+    }>;
     name: z.ZodNullable<z.ZodString>;
     federal_pwa_mode: z.ZodEnum<{
         none: "none";
@@ -16228,6 +16294,9 @@ export declare const zListTimecodeHistoryResponse: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+export declare const zCancelTimecodeScheduledChangesHeaders: z.ZodObject<{
+    'If-Match': z.ZodString;
+}, z.core.$strip>;
 export declare const zCancelTimecodeScheduledChangesPath: z.ZodObject<{
     timecode_id: z.ZodString;
 }, z.core.$strip>;
@@ -16323,6 +16392,9 @@ export declare const zScheduleTimecodeChangeBody: z.ZodObject<{
         job_with_timecode: "job_with_timecode";
     }>>;
 }, z.core.$strip>;
+export declare const zScheduleTimecodeChangeHeaders: z.ZodObject<{
+    'If-Match': z.ZodString;
+}, z.core.$strip>;
 export declare const zScheduleTimecodeChangePath: z.ZodObject<{
     timecode_id: z.ZodString;
 }, z.core.$strip>;
@@ -16359,6 +16431,9 @@ export declare const zScheduleTimecodeChangeResponse: z.ZodObject<{
     created_at: z.ZodISODateTime;
     updated_at: z.ZodISODateTime;
 }, z.core.$strip>;
+export declare const zCancelTimecodeScheduledTerminationHeaders: z.ZodObject<{
+    'If-Match': z.ZodString;
+}, z.core.$strip>;
 export declare const zCancelTimecodeScheduledTerminationPath: z.ZodObject<{
     timecode_id: z.ZodString;
 }, z.core.$strip>;
@@ -16576,6 +16651,9 @@ export declare const zUpdateTimecodeBody: z.ZodObject<{
     }>>;
     effective_date: z.ZodOptional<z.ZodISODateTime>;
 }, z.core.$strip>;
+export declare const zUpdateTimecodeHeaders: z.ZodObject<{
+    'If-Match': z.ZodString;
+}, z.core.$strip>;
 export declare const zUpdateTimecodePath: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;

package/dist/gen/zod.gen.js

@@ -154,6 +154,14 @@ export const zProblem = z.object({
  *
  * The write conflicts with what is already recorded for the resource — another version occupies the same span, or the write contradicts the resource's recorded identity. Re-read the current state and retry on top of it.
  *
+ * ## 412
+ *
+ * ### precondition_failed
+ *
+ * **Precondition Failed**
+ *
+ * The `If-Match` validator names a version of this resource that is no longer current — the version family changed after you read it. Re-read the resource, take its fresh `ETag`, and reapply your change on top of the current state. A malformed or unrecognizable validator refuses the same way, since neither matches.
+ *
  * ## 422
  *
  * ### attachment_not_image
@@ -258,6 +266,14 @@ export const zProblem = z.object({
  *
  * The apprentice's wage schedule does not belong to the program in the URL. Use a schedule from that program.
  *
+ * ## 428
+ *
+ * ### precondition_required
+ *
+ * **Precondition Required**
+ *
+ * The write must state which version of the resource it was composed against, and no `If-Match` was sent. Read the resource, send its `ETag` back as `If-Match`, or send `If-Match: *` to write unconditionally against whatever exists.
+ *
  * ## 429
  *
  * ### too_many_requests
@@ -297,6 +313,7 @@ export const zProblemTypeCatalog = z.enum([
     'not_found',
     'recorded_since_termination',
     'version_overlap',
+    'precondition_failed',
     'attachment_not_image',
     'company_not_employer',
     'confirm_apprenticeship_conflict',
@@ -314,6 +331,7 @@ export const zProblemTypeCatalog = z.enum([
     'user_not_company_member',
     'validation_failed',
     'wage_schedule_outside_program',
+    'precondition_required',
     'too_many_requests',
     'internal_error'
 ]);
@@ -1695,6 +1713,11 @@ export const zJobParameters = z.object({
     tz_name: z.string().optional(),
     time_card_start_day: zTimeCardStartDay.optional(),
     require_clock_in: z.boolean().nullish(),
+    clock_in_requirement: z.enum([
+        'none',
+        'warning',
+        'required'
+    ]).optional(),
     send_geofence_reminders: z.boolean().nullish(),
     allow_customer_access: z.boolean().optional(),
     timekeeping_timecode_ids: z.array(z.string()).nullish(),
@@ -2896,7 +2919,12 @@ export const zJobResponseObject = z.object({
     purchase_order_number: z.string().nullable(),
     time_card_start_day: zTimeCardStartDay,
     tz_name: z.string(),
-    require_clock_in: z.boolean().nullable(),
+    require_clock_in: z.boolean(),
+    clock_in_requirement: z.enum([
+        'none',
+        'warning',
+        'required'
+    ]),
     name: z.string().nullable(),
     federal_pwa_mode: z.enum([
         'all',
@@ -6028,6 +6056,9 @@ export const zCreateWageDeterminationPath = z.object({
  * Created
  */
 export const zCreateWageDeterminationResponse = zJobWageDeterminationResponseObject;
+export const zDeleteWageDeterminationHeaders = z.object({
+    'If-Match': z.string()
+});
 export const zDeleteWageDeterminationPath = z.object({
     job_id: z.string(),
     uid: z.string()
@@ -6918,6 +6949,9 @@ export const zListTimecodeHistoryResponse = z.object({
     links: zLinks.optional(),
     data: z.array(zTimecodeHistoryVersionObject).optional()
 });
+export const zCancelTimecodeScheduledChangesHeaders = z.object({
+    'If-Match': z.string()
+});
 export const zCancelTimecodeScheduledChangesPath = z.object({
     timecode_id: z.string()
 });
@@ -6933,6 +6967,9 @@ export const zListTimecodeScheduledChangesPath = z.object({
  */
 export const zListTimecodeScheduledChangesResponse = z.array(zTimecodeResponseObject);
 export const zScheduleTimecodeChangeBody = zTimecodeScheduledChangeParameters;
+export const zScheduleTimecodeChangeHeaders = z.object({
+    'If-Match': z.string()
+});
 export const zScheduleTimecodeChangePath = z.object({
     timecode_id: z.string()
 });
@@ -6940,6 +6977,9 @@ export const zScheduleTimecodeChangePath = z.object({
  * Created
  */
 export const zScheduleTimecodeChangeResponse = zTimecodeResponseObject;
+export const zCancelTimecodeScheduledTerminationHeaders = z.object({
+    'If-Match': z.string()
+});
 export const zCancelTimecodeScheduledTerminationPath = z.object({
     timecode_id: z.string()
 });
@@ -6988,6 +7028,9 @@ export const zGetTimecodeQuery = z.object({
  */
 export const zGetTimecodeResponse = zTimecodeResponseObject;
 export const zUpdateTimecodeBody = zTimecodeParameters;
+export const zUpdateTimecodeHeaders = z.object({
+    'If-Match': z.string()
+});
 export const zUpdateTimecodePath = z.object({
     id: z.string()
 });

package/package.json

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