deere-sdk 2.0.0 → 2.1.1

package/CHANGELOG.md

@@ -5,6 +5,200 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.1] - 2026-04-14
+
+**Patch release completing 2.1.0's intended scope.** 2.1.0 shipped one safe
+facade method — `deere.safe.fieldOperations.listAllWithMeasurements` — against
+a plan that explicitly deferred `list`/`get` variants and silently omitted any
+audit of the rest of the embed surface. A post-ship audit found that the same
+silent-zero bug class was still loaded on TWO other field-operations methods,
+plus the entire equipment and products families. 2.1.1 fixes that.
+
+Framing as a patch is technically stretched (2.1.1 adds public API surface,
+which semver-purists would call a minor), but the work here is completing
+2.1.0's promise to kill the embed footgun in the `fieldOperations` family and
+extending that guarantee to adjacent families where JD's spec documents narrow
+embed enum values. Nothing in 2.1.0 is broken or removed.
+
+### Added
+
+- **`deere.safe.fieldOperations.listWithMeasurements(orgId, fieldId, params?)`** —
+  paginated single-page variant. Returns `PaginatedResponse<FieldOperationWithMeasurements>`.
+  Forces `embed=measurementTypes`, runtime-verifies every operation on the
+  returned page carries the `measurementTypes` array, throws `DeereError` on
+  contract violation. Same guarantee contract as `listAllWithMeasurements`.
+- **`deere.safe.fieldOperations.getWithMeasurements(operationId, params?)`** —
+  single-operation-by-id variant. Returns `FieldOperationIdWithMeasurements`.
+  JD treats the list-shape (`FieldOperation`) and get-shape (`FieldOperationId`)
+  as separate schemas; 2.1.0's spec patch only covered `FieldOperation`. 2.1.1
+  adds a matching patch for `FieldOperationId` so the narrowed return type on
+  the single-op path is honest.
+- **`FieldOperationIdWithMeasurements`** — new exported type, the narrowed
+  variant of `FieldOperationId`.
+- **`deere.safe.equipment`** (new facade, `SafeEquipmentApi`) — six methods
+  wrapping every embed-accepting raw method on `EquipmentApi`:
+  `getWithEmbed`, `getEquipmentWithEmbed`, `listEquipmentmodelsWithEmbed`,
+  `listEquipmentisgtypesWithEmbed`, `getEquipmentisgtypesWithEmbed`,
+  `getEquipmentisgtypes2WithEmbed`. Each method makes the `embed` parameter
+  **required at the type level** — TypeScript refuses to compile a call that
+  forgets it. Embed values follow JD's documented enums (`devices`, `equipment`,
+  `icon`, `pairingDetails`, `offsets`, `capabilities`, `make`, `type`, `isgType`,
+  `equipmentModels`, `recordMetadata`).
+- **`deere.safe.products`** (new facade, `SafeProductsApi`) — three methods
+  wrapping every embed-accepting raw method on `ProductsApi`: `listWithEmbed`,
+  `listAllWithEmbed`, `getWithEmbed`. Embed values are JD's documented enum:
+  `documents`, `showMergedProducts`.
+- **Spec patch: `FieldOperationId.measurementTypes`** — mirrors the 2.1.0
+  patch on `FieldOperation` so both the list-shape and get-shape carry the
+  optional array in the generated types. Added via one new `addProperty` entry
+  in `scripts/embed-contracts.yaml`.
+
+### Important scope note — what 2.1.1 does NOT cover
+
+Equipment and Products safe facades are **type-level forcing functions only**.
+They require the caller to pass `embed`, but they do NOT narrow the return
+type and do NOT runtime-verify that response fields are populated. The reason:
+we don't yet have empirical wire traces confirming which response fields each
+embed value populates on those endpoints. Without that evidence, any type
+narrowing or runtime assertion would be guessing. 2.1.0's pattern of spec
+patch + narrowed type + runtime verification is deferred for these families
+until `field-mcp/scripts/jd-probe-shapes.ts` captures wire traces for
+equipment and products. Once captured, a future release can tighten the
+wrappers with the same registry-driven mechanism.
+
+The following endpoints also take an `embed` parameter but **remain unwrapped
+in 2.1.1** because JD's published OpenAPI spec documents the embed as a bare
+`string` with no enum values — we literally cannot know what values the caller
+should be forced to pass. These endpoints are still raw-only and still expose
+the silent-zero footgun to callers who forget the embed: `boundaries.list`,
+`boundaries.listAll`, `boundaries.listBoundaries`, `clients.list`,
+`clients.listAll`, `clients.get`, `farms.list`, `farms.listAll`, `farms.get`,
+`assets.list`, `assets.listAll`, `assets.get`, `guidance-lines.list`,
+`guidance-lines.listAll`, `guidance-lines.get`, `harvest-id.list`,
+`harvest-id.listAll`, `harvest-id.get`, `operators.list`, `operators.listAll`,
+`operators.get`, `map-layers.list`, `map-layers.listAll`, `users.*`,
+`flags.*`, `fields.*`. A proper audit of these requires both empirical wire
+traces AND a fix-specs patch to tighten the `embed?: string` type to a
+narrow enum, and is tracked as a future work item.
+
+### Migration
+
+If FieldMCP (or any other consumer) calls `fieldOperations.list` or
+`fieldOperations.get` and reads measurement data from the response, migrate:
+
+```ts
+// Before — silent data loss if embed is forgotten
+const page = await deere.fieldOperations.list(orgId, fieldId);
+const op = await deere.fieldOperations.get(operationId);
+
+// After — guaranteed measurementTypes, throws on contract drift
+const page = await deere.safe.fieldOperations.listWithMeasurements(orgId, fieldId);
+const op = await deere.safe.fieldOperations.getWithMeasurements(operationId);
+```
+
+For equipment and products, the migration is the same pattern but the safe
+wrapper just forces you to pick an embed at compile time:
+
+```ts
+// Raw (compiles, will silently miss fields when you forget embed)
+const equipmentList = await deere.equipment.get();
+
+// Safe (refuses to compile unless you pass embed)
+const equipmentList = await deere.safe.equipment.getWithEmbed({ embed: 'devices' });
+```
+
+### Unchanged
+
+- Everything shipped in 2.1.0. `listAllWithMeasurements` is untouched, same
+  signature, same guarantee.
+- Raw `FieldOperationsApi`, `EquipmentApi`, `ProductsApi` method signatures.
+- Error hierarchy, URL resolution, HATEOAS mode.
+- The contract registry mechanism and `applyEmbedContracts` patcher.
+
+## [2.1.0] - 2026-04-14
+
+**Minor, additive release.** Kills a footgun on `fieldOperations.listAll` by
+introducing a "safe facade" layer (`deere.safe.*`) that forces query params
+John Deere's API requires for a complete response but the raw SDK leaves
+optional. Also adds a contract registry that lets future SDK patches encode
+JD spec gaps in one place instead of across hand-written wrappers.
+
+### Why
+
+John Deere's API documents `embed` as an optional query param on
+`GET /organizations/{orgId}/fields/{fieldId}/fieldOperations`, but silently
+omits the `measurementTypes` array on every returned FieldOperation unless
+the request passes `?embed=measurementTypes`. Downstream consumers that
+forget the embed param get objects with zero values for yield, area,
+moisture, application rate, and seeding population — and can't tell "missing
+data" from "real zero" because JD's OpenAPI spec never documents the
+invariant. FieldMCP shipped placeholder data to production three separate
+times because of this exact bug. 2.1.0 makes "forget the embed param"
+syntactically impossible.
+
+### Added
+
+- **`deere.safe.fieldOperations.listAllWithMeasurements(orgId, fieldId, params?)`**
+  — returns `FieldOperationWithMeasurements[]` (non-optional `measurementTypes`
+  array). Forces `embed=measurementTypes` on the outgoing request, and verifies
+  every returned operation actually carries the array, throwing `DeereError`
+  with the operation id on any contract violation. Empty `measurementTypes: []`
+  is valid (the operation has no recorded measurements yet); `undefined` is not
+  and fails loudly.
+- **`SafeFacades` class** on `deere.safe` — composition root for safe facades.
+  Adding a new safe wrapper means writing a file under `src/safe/` and adding
+  one field + one constructor init to `SafeFacades`. The codegen at
+  `scripts/generate-sdk.ts` is deliberately kept dumb about what's inside
+  `SafeFacades` — it only emits the wire-up, never the contents.
+- **`FieldOperationWithMeasurements`** type — re-exported from the main entry
+  for consumers who need to reference the narrowed shape directly.
+- **`scripts/embed-contracts.yaml`** — new registry encoding JD's undocumented
+  invariants as a list of OpenAPI schema-patch operations. Consumed at codegen
+  time by `scripts/fix-specs.ts`'s `applyEmbedContracts()` transform before
+  `openapi-typescript` runs, so the generated types include the
+  previously-missing fields with JD's own declared schemas as `$ref` targets.
+- **Generated type `ApplicationProductTotal`** and optional properties
+  `FieldOperation.measurementTypes: FieldOperationMeasurement[]` and
+  `FieldOperationMeasurementInFullRelease.applicationProductTotals:
+  ApplicationProductTotal[]` — produced by the registry patcher and visible to
+  both safe-path and raw-path callers.
+
+### Migration
+
+Replace raw `listAll` calls that read measurement data with the safe variant:
+
+```ts
+// Before — silently returns FieldOperation objects without measurementTypes
+// unless you remember to pass embed, and the type system doesn't warn you.
+const ops = await deere.fieldOperations.listAll(orgId, fieldId);
+const yield_ = ops[0].measurementTypes; // ← undefined, silent data loss
+
+// After — always populated, type-guaranteed, throws clearly on drift
+const ops = await deere.safe.fieldOperations.listAllWithMeasurements(
+  orgId,
+  fieldId
+);
+const yield_ = ops[0].measurementTypes[0]?.averageYield?.value; // typed, narrowed
+```
+
+Raw `deere.fieldOperations.listAll` still exists and still works — it's the
+right tool for metadata-only callers (calendar UIs, operation listings that
+don't consume measurement data). The raw return type now carries
+`measurementTypes?: FieldOperationMeasurement[]` as an optional field, so
+raw-path consumers can read it when they pass the embed param themselves,
+but with a compile-time nudge that it might be absent.
+
+### Unchanged
+
+- `FieldOperationsApi.listAll` signature, behavior, and existing query param
+  semantics. No breaking changes.
+- All other generated API classes.
+- Error hierarchy, HATEOAS mode, URL resolution, retry policy.
+- `openapi-typescript` version, generator script structure (aside from the
+  three literal-string insertions in `generateMainClass()` that wire up
+  `SafeFacades` — see `scripts/generate-sdk.ts` and the `// DO NOT REORDER`
+  comment it emits into the generated `deere.ts`).
+
 ## [2.0.0] - 2026-04-13
 
 **Major release.** URL resolution is now fully spec-driven. This release fixes

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src=".github/images/hero.png" alt="deere-sdk">
+</p>
+
 <h1 align="center">deere-sdk</h1>
 
 <p align="center">
@@ -59,7 +63,7 @@ import {Deere} from 'deere-sdk';
 
 const deere = new Deere({
     accessToken: 'your-oauth-access-token',
-    environment: 'sandbox', // or 'production'
+    environment: 'sandboxapi', // or 'api' for production
 });
 
 // List all organizations
@@ -98,13 +102,48 @@ This SDK requires an OAuth 2.0 access token from John Deere:
 <details>
 <summary><strong>Environments</strong></summary>
 
-| Environment  | URL                  | Use Case             |
-|--------------|----------------------|----------------------|
-| `production` | api.deere.com        | Live data            |
-| `sandbox`    | sandboxapi.deere.com | Development          |
-| `partner`    | partnerapi.deere.com | Partner integrations |
-| `cert`       | apicert.deere.com    | Certification        |
-| `qa`         | apiqa.tal.deere.com  | QA testing           |
+v2.0.0 uses raw John Deere subdomain names as environment values. Pass the subdomain (without `.deere.com`) as `environment`. Default: `sandboxapi`.
+
+| Environment      | URL                        | Use Case                         |
+|------------------|----------------------------|----------------------------------|
+| `api`            | api.deere.com              | Live production                  |
+| `sandboxapi`     | sandboxapi.deere.com       | Development (default)            |
+| `partnerapi`     | partnerapi.deere.com       | Partner production               |
+| `apicert`        | apicert.deere.com          | Production certification         |
+| `partnerapicert` | partnerapicert.deere.com   | Partner certification            |
+| `apiqa.tal`      | apiqa.tal.deere.com        | QA tier                          |
+| `partnerapiqa`   | partnerapiqa.deere.com     | Partner QA                       |
+| `sandboxapiqa`   | sandboxapiqa.deere.com     | Sandbox QA                       |
+| `apidev.tal`     | apidev.tal.deere.com       | Internal dev tier (rarely used)  |
+
+Not every spec has servers for every environment. If you pick an environment a given spec doesn't ship (e.g., a production-only spec on `sandboxapi`), the constructor throws `UnsupportedEnvironmentError` with the valid values for that spec.
+
+</details>
+
+<details>
+<summary><strong>Migrating from v1</strong></summary>
+
+v1 accepted friendly environment names. v2.0.0 replaces them with the raw John Deere subdomain names so URL routing comes directly from each spec's OpenAPI `servers` block — no more hardcoded hostname maps.
+
+Passing a v1 name to the v2 constructor throws immediately with a migration hint:
+
+| v1 (pre-2.0.0) | v2.0.0+        |
+|----------------|----------------|
+| `production`   | `api`          |
+| `sandbox`      | `sandboxapi`   |
+| `partner`      | `partnerapi`   |
+| `cert`         | `apicert`      |
+| `qa`           | `apiqa.tal`    |
+
+```typescript
+// v1
+const deere = new Deere({ accessToken, environment: 'sandbox' });
+
+// v2.0.0
+const deere = new Deere({ accessToken, environment: 'sandboxapi' });
+```
+
+The SDK now uses separate host subdomains per spec family (e.g., `equipmentapi.deere.com` for machine telemetry, `api.deere.com` for organizations) on the production tier. v1 silently routed everything through `api.deere.com`, which worked for most flows but mis-routed some machine-data endpoints. v2 routes each call to the exact host the spec declares.
 
 </details>
 
@@ -290,14 +329,26 @@ const models = await deere.equipment.listEquipmentmodels({equipmentModelName: '9
 <summary><strong>Field Operations</strong></summary>
 
 ```typescript
-// List field operations
-const ops = await deere.fieldOperations.list('org-id', 'field-id');
-
-// Filter by type and season
-const harvests = await deere.fieldOperations.list('org-id', 'field-id', {
-    cropSeason: '2026',
-    fieldOperationType: 'harvest'
-});
+// Prefer the safe facade when you need measurement data (yield, area,
+// moisture, application rate, seeding population). It forces
+// ?embed=measurementTypes on the request and guarantees the returned
+// operations carry a measurementTypes array, throwing a clear error if
+// JD's wire format ever drifts from the documented contract.
+const ops = await deere.safe.fieldOperations.listAllWithMeasurements(
+    'org-id',
+    'field-id'
+);
+const yieldValue = ops[0].measurementTypes[0]?.averageYield?.value;
+
+// Filter by type and season — filters forward through to the safe wrapper too.
+const harvests = await deere.safe.fieldOperations.listAllWithMeasurements(
+    'org-id',
+    'field-id',
+    { cropSeason: '2026', fieldOperationType: 'harvest' }
+);
+
+// Raw API (no forcing) — use when you only need metadata, not measurements.
+const metaOnly = await deere.fieldOperations.list('org-id', 'field-id');
 
 // Get operation details
 const op = await deere.fieldOperations.get('operation-id');
@@ -309,6 +360,17 @@ const shapefile = await deere.fieldOperations.getFieldops('operation-id', {
 });
 ```
 
+**Why `deere.safe.*`?** John Deere's API silently omits the `measurementTypes`
+array on `fieldOperations.listAll` responses unless the request passes
+`?embed=measurementTypes`, and their OpenAPI spec doesn't document that
+invariant. Consumers that forget the embed param get objects with zero values
+for yield, area, moisture, and rate — and can't tell "missing data" from "real
+zero." The safe facade makes that footgun syntactically impossible: you can't
+call `listAllWithMeasurements` without the embed param because the wrapper
+adds it for you, and the returned type guarantees `measurementTypes` is
+present. See `src/safe/` and `scripts/embed-contracts.yaml` for the spec-patch
+machinery that makes the narrowed type honest at the type level.
+
 </details>
 
 <details>
@@ -452,7 +514,7 @@ import {DeereClient} from 'deere-sdk';
 
 const client = new DeereClient({
     accessToken: 'your-token',
-    environment: 'sandbox',
+    environment: 'sandboxapi',
     timeout: 30000,   // Request timeout in ms (default: 30000)
     maxRetries: 3,    // Retry attempts (default: 3, set to 0 to disable)
 });
@@ -470,6 +532,25 @@ for await (const items of client.paginate('/large/collection')) {
 }
 ```
 
+### fetchUrl — Bearer token hostname guard
+
+`DeereClient` exposes `fetchUrl(method, url, body?, options?)` and `followLink(url)` for calling absolute URLs (e.g., HAL `next` page links, externally-discovered URLs). Both **suppress the OAuth Bearer token** on any URL whose hostname is not a trusted `*.deere.com` origin. This prevents accidental token leakage if a HATEOAS response, user-supplied URL, or link cache ever includes a third-party host.
+
+```typescript
+// Bearer token attached (trusted host)
+await client.fetchUrl('GET', 'https://api.deere.com/platform/organizations');
+
+// Bearer token SUPPRESSED (untrusted host) — request still goes out, just without Authorization
+await client.fetchUrl('GET', 'https://example.com/some-webhook');
+
+// You can opt in explicitly by passing your own Authorization header:
+await client.fetchUrl('GET', 'https://example.com/api', undefined, {
+    headers: { Authorization: 'Bearer some-other-token' },
+});
+```
+
+Enable `hateoasDebug: true` to see a `console.warn` whenever a token is suppressed, so you can audit where your HATEOAS graph is pointing.
+
 ---
 
 ## HATEOAS Mode
@@ -479,7 +560,7 @@ John Deere requires applications to demonstrate [HATEOAS](https://en.wikipedia.o
 ```typescript
 const deere = new Deere({
     accessToken: 'your-token',
-    environment: 'sandbox',
+    environment: 'sandboxapi',
     hateoas: true,       // Enable HATEOAS link traversal
     hateoasDebug: true,  // Optional: log resolution details
 });
@@ -499,7 +580,7 @@ import {Deere} from 'deere-sdk';
 // 1. Create client with HATEOAS enabled
 const deere = new Deere({
     accessToken: 'your-oauth-token',
-    environment: 'sandbox',
+    environment: 'sandboxapi',
     hateoas: true,
     hateoasDebug: true, // See link resolution in console
 });
@@ -573,8 +654,23 @@ const deere = new Deere({
 
 ### Error Types
 
+| Error                         | When it's thrown                                                  | Retried? |
+|-------------------------------|-------------------------------------------------------------------|----------|
+| `DeereError`                  | Base class. Any HTTP error from John Deere (400/404/422/5xx).     | Only 5xx |
+| `RateLimitError`              | HTTP 429. Only reaches your catch after all retries are exhausted. | Yes      |
+| `AuthError`                   | HTTP 401/403. Refresh your OAuth token.                            | No       |
+| `HateoasError`                | HATEOAS link resolution fails (parent fetch errored or no matching link). | No       |
+| `UnsupportedEnvironmentError` | Constructor threw because `environment` doesn't match the spec's `servers` block. | N/A (thrown at construction) |
+| `NoServerConfigError`         | Constructor threw because a spec has no `servers` block at all.    | N/A      |
+
 ```typescript
-import {DeereError, RateLimitError, AuthError} from 'deere-sdk';
+import {
+    DeereError,
+    RateLimitError,
+    AuthError,
+    HateoasError,
+    UnsupportedEnvironmentError,
+} from 'deere-sdk';
 
 try {
     const fields = await deere.fields.listAll('org-id');
@@ -585,6 +681,12 @@ try {
     } else if (error instanceof AuthError) {
         // Never retried - refresh your token
         console.log('Token expired - refresh required');
+    } else if (error instanceof HateoasError) {
+        // HATEOAS link resolution failed (only when hateoas: true)
+        console.log(`Link resolution failed on ${error.path}: ${error.message}`);
+    } else if (error instanceof UnsupportedEnvironmentError) {
+        // Spec doesn't ship this environment — try another from its valid list
+        console.log(error.message);
     } else if (error instanceof DeereError) {
         console.log(`API error: ${error.status} ${error.message}`);
     }
@@ -691,6 +793,14 @@ git push --follow-tags
 
 CI sees the tag → creates GitHub Release → publishes to npm.
 
+**Gotcha:** GitHub sometimes does not fire the `push` event for a tag pushed via `git push --follow-tags`, so `release.yml` never auto-triggers. If you don't see a "Create Release" run within a minute of pushing the tag, dispatch it manually:
+
+```bash
+gh workflow run release.yml --ref vX.Y.Z
+```
+
+`release.yml` also accepts `workflow_dispatch`, so this produces an identical run against the tag's commit.
+
 ---
 
 ## Disclaimer

package/dist/api-servers.generated.d.ts

@@ -2,7 +2,7 @@
  * API server configuration per spec — single source of truth for URL resolution.
  *
  * @generated by scripts/generate-api-servers.ts — do not edit manually
- * Last generated: 2026-04-13T20:34:18.775Z
+ * Last generated: 2026-04-14T21:02:00.480Z
  *
  * Env coverage matrix (X = supported, - = throws UnsupportedEnvironmentError):
  *

package/dist/api-servers.generated.js

@@ -2,7 +2,7 @@
  * API server configuration per spec — single source of truth for URL resolution.
  *
  * @generated by scripts/generate-api-servers.ts — do not edit manually
- * Last generated: 2026-04-13T20:34:18.775Z
+ * Last generated: 2026-04-14T21:02:00.480Z
  *
  * Env coverage matrix (X = supported, - = throws UnsupportedEnvironmentError):
  *

package/dist/deere.d.ts

@@ -6,6 +6,7 @@
  */
 import { AempApi, AssetsApi, BoundariesApi, ClientsApi, ConnectionManagementApi, CropTypesApi, EquipmentApi, EquipmentMeasurementApi, FarmsApi, FieldOperationsApi, FieldsApi, FilesApi, FlagsApi, GuidanceLinesApi, HarvestIdApi, MachineAlertsApi, MachineDeviceStateReportsApi, MachineEngineHoursApi, MachineHoursOfOperationApi, MachineLocationsApi, MapLayersApi, NotificationsApi, OperatorsApi, OrganizationsApi, PartnershipsApi, ProductsApi, UsersApi, WebhookApi } from './api/index.js';
 import { DeereClient, type DeereClientConfig } from './client.js';
+import { SafeFacades } from './safe/index.js';
 /**
  * John Deere SDK
  *
@@ -23,6 +24,14 @@ import { DeereClient, type DeereClientConfig } from './client.js';
  * const orgs = await deere.organizations.listAll();
  * const farms = await deere.farms.listAll(orgs[0].id);
  * const fields = await deere.fields.listAll(orgs[0].id);
+ *
+ * // Safe facades force query params that JD's API requires for a complete
+ * // response but the raw SDK leaves optional. See src/safe/ and
+ * // scripts/embed-contracts.yaml for the contract invariants they enforce.
+ * const ops = await deere.safe.fieldOperations.listAllWithMeasurements(
+ *   orgs[0].id,
+ *   fields[0].id
+ * );
  * ```
  */
 export declare class Deere {
@@ -84,6 +93,11 @@ export declare class Deere {
     readonly users: UsersApi;
     /** webhook API */
     readonly webhook: WebhookApi;
+    /**
+     * Safe facades that force query params the raw API leaves optional (e.g.
+     * `embed=measurementTypes`). See src/safe/ and scripts/embed-contracts.yaml.
+     */
+    readonly safe: SafeFacades;
     constructor(config: DeereClientConfig);
 }
 /**

package/dist/deere.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deere.d.ts","sourceRoot":"","sources":["../src/deere.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deere.d.ts","sourceRoot":"","sources":["../src/deere.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,SAAS,EACT,aAAa,EACb,UAAU,EACV,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,QAAQ,EACR,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,KAAK;IAChB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,eAAe;IACf,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,iBAAiB;IACjB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IAEnC,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,gCAAgC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;IAEvD,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAEjC,gCAAgC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;IAEvD,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAEjC,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB,+BAA+B;IAC/B,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAE7C,iBAAiB;IACjB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB,yBAAyB;IACzB,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAEzC,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAEjC,yBAAyB;IACzB,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAEzC,uCAAuC;IACvC,QAAQ,CAAC,yBAAyB,EAAE,4BAA4B,CAAC;IAEjE,+BAA+B;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;IAEnD,qCAAqC;IACrC,QAAQ,CAAC,uBAAuB,EAAE,0BAA0B,CAAC;IAE7D,4BAA4B;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IAE/C,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAEjC,wBAAwB;IACxB,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAEzC,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAEjC,wBAAwB;IACxB,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAEzC,uBAAuB;IACvB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IAEvC,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEf,MAAM,EAAE,iBAAiB;CAqCtC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,KAAK,CAE5D"}

package/dist/deere.js

@@ -6,6 +6,7 @@
  */
 import { AempApi, AssetsApi, BoundariesApi, ClientsApi, ConnectionManagementApi, CropTypesApi, EquipmentApi, EquipmentMeasurementApi, FarmsApi, FieldOperationsApi, FieldsApi, FilesApi, FlagsApi, GuidanceLinesApi, HarvestIdApi, MachineAlertsApi, MachineDeviceStateReportsApi, MachineEngineHoursApi, MachineHoursOfOperationApi, MachineLocationsApi, MapLayersApi, NotificationsApi, OperatorsApi, OrganizationsApi, PartnershipsApi, ProductsApi, UsersApi, WebhookApi, } from './api/index.js';
 import { DeereClient } from './client.js';
+import { SafeFacades } from './safe/index.js';
 /**
  * John Deere SDK
  *
@@ -23,6 +24,14 @@ import { DeereClient } from './client.js';
  * const orgs = await deere.organizations.listAll();
  * const farms = await deere.farms.listAll(orgs[0].id);
  * const fields = await deere.fields.listAll(orgs[0].id);
+ *
+ * // Safe facades force query params that JD's API requires for a complete
+ * // response but the raw SDK leaves optional. See src/safe/ and
+ * // scripts/embed-contracts.yaml for the contract invariants they enforce.
+ * const ops = await deere.safe.fieldOperations.listAllWithMeasurements(
+ *   orgs[0].id,
+ *   fields[0].id
+ * );
  * ```
  */
 export class Deere {
@@ -84,6 +93,11 @@ export class Deere {
     users;
     /** webhook API */
     webhook;
+    /**
+     * Safe facades that force query params the raw API leaves optional (e.g.
+     * `embed=measurementTypes`). See src/safe/ and scripts/embed-contracts.yaml.
+     */
+    safe;
     constructor(config) {
         this.client = new DeereClient(config);
         this.aemp = new AempApi(this.client);
@@ -114,6 +128,12 @@ export class Deere {
         this.products = new ProductsApi(this.client);
         this.users = new UsersApi(this.client);
         this.webhook = new WebhookApi(this.client);
+        // DO NOT REORDER: SafeFacades reads generated API fields (e.g.
+        // `this.fieldOperations`), so it MUST run AFTER every API field has
+        // been initialized above. The runtime guard in SafeFacades' constructor
+        // fires loudly if this line ever moves ahead of the generated field
+        // inits. See scripts/generate-sdk.ts generateMainClass() for the source.
+        this.safe = new SafeFacades(this);
     }
 }
 /**

package/dist/deere.js.map

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

package/dist/index.d.ts

@@ -32,5 +32,6 @@ export * from './api/index.js';
 export type { DeereClientConfig, Environment, Link, PaginatedResponse, RequestOptions, } from './client.js';
 export { AuthError, createClient, DeereClient, DeereError, HateoasError, RateLimitError, } from './client.js';
 export { createDeere, Deere } from './deere.js';
+export { type FieldOperationIdWithMeasurements, type FieldOperationWithMeasurements, SafeEquipmentApi, SafeFacades, SafeFieldOperationsApi, SafeProductsApi, } from './safe/index.js';
 export * as Types from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,IAAI,EACJ,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,IAAI,EACJ,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIhD,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EACnC,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -34,6 +34,9 @@ export * from './api/index.js';
 export { AuthError, createClient, DeereClient, DeereError, HateoasError, RateLimitError, } from './client.js';
 // Main SDK class
 export { createDeere, Deere } from './deere.js';
+// Safe facades that force query params the raw API leaves optional.
+// See scripts/embed-contracts.yaml and src/safe/ for context.
+export { SafeEquipmentApi, SafeFacades, SafeFieldOperationsApi, SafeProductsApi, } from './safe/index.js';
 // OpenAPI Types (for advanced usage)
 export * as Types from './types/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,cAAc;AACd,cAAc,gBAAgB,CAAC;AAQ/B,mBAAmB;AACnB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhD,qCAAqC;AACrC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,cAAc;AACd,cAAc,gBAAgB,CAAC;AAQ/B,mBAAmB;AACnB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhD,oEAAoE;AACpE,8DAA8D;AAC9D,OAAO,EAGL,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,qCAAqC;AACrC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}