deere-sdk 1.0.10 → 2.1.0

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

@@ -0,0 +1,72 @@
+/**
+ * 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-14T19:26:59.403Z
+ *
+ * Env coverage matrix (X = supported, - = throws UnsupportedEnvironmentError):
+ *
+ *                              api  sandboxapi  partnerapi  apicert  apiqa.tal  partnerapicert  partnerapiqa  sandboxapiqa  apidev.tal
+ * aemp                          X    X           X           -        -          -               -             -             -
+ * assets                        X    X           X           X        X          -               -             -             -
+ * boundaries                    X    X           X           X        X          X               X             X             -
+ * clients                       X    X           X           X        X          -               -             -             -
+ * connection-management         X    X           -           X        X          -               -             -             -
+ * crop-types                    X    X           X           X        X          X               X             X             -
+ * equipment-measurement         X    -           X           X        X          X               X             X             -
+ * equipment                     X    -           X           -        -          -               -             -             -
+ * farms                         X    X           X           X        X          -               -             -             -
+ * field-operations-api          X    X           X           X        X          X               X             X             -
+ * fields                        X    X           X           X        X          -               -             -             -
+ * files                         X    X           X           X        X          X               X             X             X
+ * flags                         X    X           X           X        X          X               X             X             X
+ * guidance-lines                X    X           X           X        X          -               -             -             X
+ * harvest-id                    X    X           X           X        X          X               X             X             -
+ * machine-alerts                X    X           X           X        X          X               X             X             X
+ * machine-device-state-reports  X    X           X           X        X          -               -             -             -
+ * machine-engine-hours          X    X           X           X        X          -               -             -             -
+ * machine-hours-of-operation    X    X           X           X        X          -               -             -             -
+ * machine-locations             X    X           X           X        X          X               X             X             X
+ * map-layers                    X    X           X           X        X          -               -             -             -
+ * notifications                 X    X           X           X        X          X               X             X             X
+ * operators                     X    X           -           X        X          -               -             -             -
+ * organizations                 X    X           X           X        X          X               X             X             X
+ * partnerships                  X    X           X           X        X          X               X             X             X
+ * products                      X    X           X           X        X          -               -             -             X
+ * users                         X    X           X           X        X          -               -             -             -
+ * webhook                       X    X           X           X        X          -               -             -             X
+ *
+ * A dash (-) means the env is NOT supported for that spec. Calling a method
+ * on that API with that env throws UnsupportedEnvironmentError at request
+ * time, before any HTTP call — no silent cross-tier routing.
+ */
+export type SpecName = 'aemp' | 'assets' | 'boundaries' | 'clients' | 'connection-management' | 'crop-types' | 'equipment-measurement' | 'equipment' | 'farms' | 'field-operations-api' | 'fields' | 'files' | 'flags' | 'guidance-lines' | 'harvest-id' | 'machine-alerts' | 'machine-device-state-reports' | 'machine-engine-hours' | 'machine-hours-of-operation' | 'machine-locations' | 'map-layers' | 'notifications' | 'operators' | 'organizations' | 'partnerships' | 'products' | 'users' | 'webhook';
+export type Environment = 'api' | 'sandboxapi' | 'partnerapi' | 'apicert' | 'apiqa.tal' | 'partnerapicert' | 'partnerapiqa' | 'sandboxapiqa' | 'apidev.tal';
+export declare const KNOWN_ENVIRONMENTS: readonly Environment[];
+/**
+ * Default environment for new DeereClient instances when config.environment
+ * is not specified. 'sandboxapi' is safe-by-default — never silently hits
+ * production data.
+ */
+export declare const DEFAULT_ENVIRONMENT: Environment;
+export type SpecServerConfig = {
+    kind: 'templated';
+    /** URL template with `{environment}` placeholder. */
+    urlTemplate: string;
+    /** Envs declared in the spec's servers.variables.environment.enum. */
+    supportedEnvironments: readonly Environment[];
+} | {
+    kind: 'static';
+    /**
+     * PARTIAL map — envs we can't confidently serve are OMITTED. Runtime
+     * throws UnsupportedEnvironmentError on missing keys. See
+     * scripts/generate-api-servers.ts for the env-to-tier classifier.
+     */
+    urlByEnvironment: Readonly<Partial<Record<Environment, string>>>;
+} | {
+    kind: 'unavailable';
+    /** Human-readable explanation for diagnostics. */
+    reason: string;
+};
+export declare const API_SERVERS: Record<SpecName, SpecServerConfig>;
+//# sourceMappingURL=api-servers.generated.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-servers.generated.d.ts","sourceRoot":"","sources":["../src/api-servers.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAMH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,uBAAuB,GACvB,YAAY,GACZ,uBAAuB,GACvB,WAAW,GACX,OAAO,GACP,sBAAsB,GACtB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,gBAAgB,GAChB,YAAY,GACZ,gBAAgB,GAChB,8BAA8B,GAC9B,sBAAsB,GACtB,4BAA4B,GAC5B,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,WAAW,GACX,eAAe,GACf,cAAc,GACd,UAAU,GACV,OAAO,GACP,SAAS,CAAC;AAQd,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,YAAY,CAAC;AAEjB,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAU3C,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAA0B,CAAC;AAM7D,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,qBAAqB,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/C,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf;;;;OAIG;IACH,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAClE,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAMN,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAwR1D,CAAC"}

package/dist/api-servers.generated.js

@@ -0,0 +1,344 @@
+/**
+ * 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-14T19:26:59.403Z
+ *
+ * Env coverage matrix (X = supported, - = throws UnsupportedEnvironmentError):
+ *
+ *                              api  sandboxapi  partnerapi  apicert  apiqa.tal  partnerapicert  partnerapiqa  sandboxapiqa  apidev.tal
+ * aemp                          X    X           X           -        -          -               -             -             -
+ * assets                        X    X           X           X        X          -               -             -             -
+ * boundaries                    X    X           X           X        X          X               X             X             -
+ * clients                       X    X           X           X        X          -               -             -             -
+ * connection-management         X    X           -           X        X          -               -             -             -
+ * crop-types                    X    X           X           X        X          X               X             X             -
+ * equipment-measurement         X    -           X           X        X          X               X             X             -
+ * equipment                     X    -           X           -        -          -               -             -             -
+ * farms                         X    X           X           X        X          -               -             -             -
+ * field-operations-api          X    X           X           X        X          X               X             X             -
+ * fields                        X    X           X           X        X          -               -             -             -
+ * files                         X    X           X           X        X          X               X             X             X
+ * flags                         X    X           X           X        X          X               X             X             X
+ * guidance-lines                X    X           X           X        X          -               -             -             X
+ * harvest-id                    X    X           X           X        X          X               X             X             -
+ * machine-alerts                X    X           X           X        X          X               X             X             X
+ * machine-device-state-reports  X    X           X           X        X          -               -             -             -
+ * machine-engine-hours          X    X           X           X        X          -               -             -             -
+ * machine-hours-of-operation    X    X           X           X        X          -               -             -             -
+ * machine-locations             X    X           X           X        X          X               X             X             X
+ * map-layers                    X    X           X           X        X          -               -             -             -
+ * notifications                 X    X           X           X        X          X               X             X             X
+ * operators                     X    X           -           X        X          -               -             -             -
+ * organizations                 X    X           X           X        X          X               X             X             X
+ * partnerships                  X    X           X           X        X          X               X             X             X
+ * products                      X    X           X           X        X          -               -             -             X
+ * users                         X    X           X           X        X          -               -             -             -
+ * webhook                       X    X           X           X        X          -               -             -             X
+ *
+ * A dash (-) means the env is NOT supported for that spec. Calling a method
+ * on that API with that env throws UnsupportedEnvironmentError at request
+ * time, before any HTTP call — no silent cross-tier routing.
+ */
+export const KNOWN_ENVIRONMENTS = [
+    'api',
+    'sandboxapi',
+    'partnerapi',
+    'apicert',
+    'apiqa.tal',
+    'partnerapicert',
+    'partnerapiqa',
+    'sandboxapiqa',
+    'apidev.tal',
+];
+/**
+ * Default environment for new DeereClient instances when config.environment
+ * is not specified. 'sandboxapi' is safe-by-default — never silently hits
+ * production data.
+ */
+export const DEFAULT_ENVIRONMENT = 'sandboxapi';
+// ============================================================================
+// API_SERVERS — the resolver's lookup table, keyed by spec name
+// ============================================================================
+export const API_SERVERS = {
+    aemp: {
+        kind: 'static',
+        urlByEnvironment: {
+            api: 'https://partneraemp.deere.com',
+            partnerapi: 'https://partneraemp.deere.com',
+            sandboxapi: 'https://sandboxaemp.deere.com',
+        },
+    },
+    assets: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    boundaries: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'partnerapi',
+            'sandboxapi',
+            'apicert',
+            'partnerapicert',
+            'apiqa.tal',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    clients: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    'connection-management': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi'],
+    },
+    'crop-types': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'partnerapi',
+            'sandboxapi',
+            'apicert',
+            'partnerapicert',
+            'apiqa.tal',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    'equipment-measurement': {
+        kind: 'static',
+        urlByEnvironment: {
+            api: 'https://equipmentapi.deere.com/isg',
+            partnerapi: 'https://equipmentapi.deere.com/isg',
+            apicert: 'https://equipmentapi-cert.deere.com/isg',
+            partnerapicert: 'https://equipmentapi-cert.deere.com/isg',
+            'apiqa.tal': 'https://equipmentapi-qual.deere.com/isg',
+            partnerapiqa: 'https://equipmentapi-qual.deere.com/isg',
+            sandboxapiqa: 'https://equipmentapi-qual.deere.com/isg',
+        },
+    },
+    equipment: {
+        kind: 'static',
+        urlByEnvironment: {
+            api: 'https://equipmentapi.deere.com/isg',
+            partnerapi: 'https://equipmentapi.deere.com/isg',
+        },
+    },
+    farms: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    'field-operations-api': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'partnerapi',
+            'sandboxapi',
+            'apicert',
+            'partnerapicert',
+            'apiqa.tal',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    fields: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    files: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'sandboxapi',
+            'partnerapi',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'partnerapicert',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    flags: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'sandboxapi',
+            'partnerapi',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'partnerapicert',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    'guidance-lines': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'partnerapi',
+            'sandboxapi',
+            'api',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+        ],
+    },
+    'harvest-id': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'partnerapi',
+            'sandboxapi',
+            'apicert',
+            'partnerapicert',
+            'apiqa.tal',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    'machine-alerts': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'sandboxapi',
+            'partnerapi',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'partnerapicert',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    'machine-device-state-reports': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    'machine-engine-hours': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    'machine-hours-of-operation': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    'machine-locations': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'sandboxapi',
+            'partnerapi',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'partnerapicert',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    'map-layers': {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    notifications: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'sandboxapi',
+            'partnerapi',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'partnerapicert',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    operators: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi'],
+    },
+    organizations: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'sandboxapi',
+            'partnerapi',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'partnerapicert',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    partnerships: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'sandboxapi',
+            'partnerapi',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'partnerapicert',
+            'partnerapiqa',
+            'sandboxapiqa',
+        ],
+    },
+    products: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'partnerapi',
+            'sandboxapi',
+            'api',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+        ],
+    },
+    users: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: ['api', 'apicert', 'apiqa.tal', 'sandboxapi', 'partnerapi'],
+    },
+    webhook: {
+        kind: 'templated',
+        urlTemplate: 'https://{environment}.deere.com/platform',
+        supportedEnvironments: [
+            'api',
+            'apicert',
+            'apiqa.tal',
+            'apidev.tal',
+            'sandboxapi',
+            'partnerapi',
+        ],
+    },
+};
+//# sourceMappingURL=api-servers.generated.js.map

package/dist/api-servers.generated.js.map

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

package/dist/client.d.ts

@@ -2,16 +2,49 @@
  * John Deere API Client
  *
  * Unofficial TypeScript SDK for John Deere Operations Center API.
- * Provides typed access to all John Deere agricultural APIs.
+ *
+ * URL resolution flow (v2.0):
+ *
+ *   User code
+ *     │
+ *     ▼
+ *   deere.equipmentMeasurement.post(params)
+ *     │
+ *     ▼
+ *   this.client.post('equipment-measurement', '/orgs/.../measurements', data, options)
+ *     │
+ *     ▼
+ *   DeereClient.post()
+ *     ├─ resolveRequestUrl(spec, path, this.environment)
+ *     │    ├─ API_SERVERS[spec] lookup
+ *     │    ├─ templated   → urlTemplate.replace('{environment}', env)
+ *     │    ├─ static      → urlByEnvironment[env]  (throws UnsupportedEnvironmentError if missing)
+ *     │    └─ unavailable → throws NoServerConfigError
+ *     └─ requestUrl('POST', url, body, options)
+ *          └─ fetch(url, ...) with retry + timeout
+ *
+ * Absolute URLs bypass the resolver via fetchUrl() — used for HATEOAS next-page
+ * links and power-user escape hatches. fetchUrl attaches the Bearer token ONLY
+ * to *.deere.com hosts; third-party URLs get no Authorization header.
+ *
+ * URL data lives in src/api-servers.generated.ts, built from OpenAPI specs at
+ * build time by scripts/generate-api-servers.ts. Never hand-edit that file.
  */
-export type Environment = 'production' | 'sandbox' | 'partner' | 'cert' | 'qa';
+import { type Environment, type SpecName } from './api-servers.generated.js';
+export type { Environment, SpecName };
 export interface DeereClientConfig {
     /** OAuth access token */
     accessToken: string;
-    /** API environment. Defaults to 'sandbox' */
+    /**
+     * API environment — uses raw JD subdomain names. Defaults to 'sandboxapi'.
+     *
+     * Valid values: 'api' | 'sandboxapi' | 'partnerapi' | 'apicert' | 'apiqa.tal'
+     *             | 'partnerapicert' | 'partnerapiqa' | 'sandboxapiqa' | 'apidev.tal'
+     *
+     * Migration from v1: 'production' → 'api', 'sandbox' → 'sandboxapi',
+     * 'partner' → 'partnerapi', 'cert' → 'apicert', 'qa' → 'apiqa.tal'.
+     */
     environment?: Environment;
-    /** Custom base URL (overrides environment) */
-    baseUrl?: string;
     /** Custom fetch implementation */
     fetch?: typeof fetch;
     /** Default headers to include in all requests */
@@ -56,24 +89,8 @@ export interface Link {
     rel: string;
     uri: string;
 }
-export declare class DeereError extends Error {
-    readonly status: number;
-    readonly statusText: string;
-    readonly body?: unknown | undefined;
-    constructor(message: string, status: number, statusText: string, body?: unknown | undefined);
-}
-export declare class RateLimitError extends DeereError {
-    readonly retryAfter?: number | undefined;
-    constructor(message: string, status: number, statusText: string, retryAfter?: number | undefined, body?: unknown);
-}
-export declare class AuthError extends DeereError {
-    constructor(message: string, status: number, statusText: string, body?: unknown);
-}
-export declare class HateoasError extends Error {
-    readonly path: string;
-    readonly cause?: Error | undefined;
-    constructor(message: string, path: string, cause?: Error | undefined);
-}
+import { AuthError, DeereError, HateoasError, RateLimitError } from './errors.js';
+export { AuthError, DeereError, HateoasError, RateLimitError };
 /**
  * John Deere API Client
  *
@@ -81,11 +98,12 @@ export declare class HateoasError extends Error {
  * ```typescript
  * const client = new DeereClient({
  *   accessToken: 'your-token',
- *   environment: 'sandbox',
+ *   environment: 'sandboxapi',  // v2: raw JD subdomain, not 'sandbox'
  *   maxRetries: 3, // Retries with exponential backoff (default: 3)
  * });
  *
- * const orgs = await client.get('/organizations');
+ * // v2: first arg is the spec name (generated classes do this for you)
+ * const orgs = await client.get('organizations', '/organizations');
  * ```
  *
  * @remarks
@@ -95,7 +113,7 @@ export declare class HateoasError extends Error {
  * Set `maxRetries: 0` to disable automatic retries.
  */
 export declare class DeereClient {
-    private readonly baseUrl;
+    private readonly environment;
     private readonly accessToken;
     private readonly fetchFn;
     private readonly defaultHeaders;
@@ -106,37 +124,58 @@ export declare class DeereClient {
     private readonly linkCache;
     constructor(config: DeereClientConfig);
     /**
-     * Make a GET request to the John Deere API
+     * Validates the environment string from config. Throws at construction
+     * time with a migration hint if the user passed a v1 friendly name or an
+     * unknown string — catches errors immediately instead of at first request.
+     */
+    private validateEnvironment;
+    /**
+     * GET request, spec-aware. Generated API classes call this with their own
+     * `spec` as the first argument — consumers don't normally call it directly.
+     */
+    get<T = unknown>(specName: SpecName, path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * POST request, spec-aware.
      */
-    get<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    post<T = unknown>(specName: SpecName, path: string, body?: unknown, options?: RequestOptions): Promise<T>;
     /**
-     * Make a POST request to the John Deere API
+     * PUT request, spec-aware.
      */
-    post<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T = unknown>(specName: SpecName, path: string, body?: unknown, options?: RequestOptions): Promise<T>;
     /**
-     * Make a PUT request to the John Deere API
+     * DELETE request, spec-aware.
      */
-    put<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T = unknown>(specName: SpecName, path: string, options?: RequestOptions): Promise<T>;
     /**
-     * Make a DELETE request to the John Deere API
+     * PATCH request, spec-aware.
      */
-    delete<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    patch<T = unknown>(specName: SpecName, path: string, body?: unknown, options?: RequestOptions): Promise<T>;
     /**
-     * Make a PATCH request to the John Deere API
+     * Fetch an absolute URL directly. Escape hatch for HATEOAS next-page links,
+     * HAL link traversal, and power users with pre-resolved URLs.
+     *
+     * **Security**: Attaches the Bearer token ONLY when the target hostname
+     * matches a trusted `*.deere.com` origin. Third-party URLs get NO
+     * Authorization header — prevents accidental token leakage to tracking or
+     * proxy services. If you need to send auth to a non-JD host, set
+     * `Authorization` explicitly via `options.headers`.
      */
-    patch<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    fetchUrl<T = unknown>(method: string, url: string, body?: unknown, options?: RequestOptions): Promise<T>;
     /**
-     * Follow a HAL link from a response
+     * Follow a HAL link from a response. Accepts a Link object or a raw URL
+     * string. Delegates to fetchUrl() so the trusted-host check applies.
      */
     followLink<T = unknown>(link: Link | string, options?: RequestOptions): Promise<T>;
     /**
-     * Paginate through all results following nextPage links
+     * Paginate through all results following nextPage links. First page is
+     * resolved via the spec's URL config; subsequent pages use the absolute
+     * URLs returned by the API in `response.links`.
      */
-    paginate<T>(path: string, options?: RequestOptions): AsyncGenerator<T[], void, unknown>;
+    paginate<T>(specName: SpecName, path: string, options?: RequestOptions): AsyncGenerator<T[], void, unknown>;
     /**
-     * Get all items from a paginated endpoint
+     * Get all items from a paginated endpoint, spec-aware.
      */
-    getAll<T>(path: string, options?: RequestOptions): Promise<T[]>;
+    getAll<T>(specName: SpecName, path: string, options?: RequestOptions): Promise<T[]>;
     private request;
     private requestUrl;
     /**
@@ -146,18 +185,27 @@ export declare class DeereClient {
     /**
      * Pre-fetch parent resources to warm the HATEOAS link cache.
      * Reduces latency for subsequent HATEOAS-resolved requests.
-     * @param paths - Parent resource paths to pre-fetch (defaults to common roots)
+     *
+     * @param specName - Spec that owns the paths (e.g. 'organizations')
+     * @param paths - Parent resource paths to pre-fetch (defaults to '/organizations')
      */
-    warmLinkCache(paths?: string[]): Promise<void>;
+    warmLinkCache(specName: SpecName, paths?: string[]): Promise<void>;
     /**
      * Match a concrete path against the HATEOAS route map.
-     * Returns the concrete parent path and rel name, or null if no match.
+     * Returns the concrete parent path, rel name, and optional parentSpec
+     * (which spec owns the parent resource — used for cross-spec HATEOAS).
+     * Returns null if no map entry matches.
      */
     private matchHateoasPattern;
     /**
-     * Resolve a path via HATEOAS link traversal.
-     * Fetches the parent resource, finds the matching link rel, and returns the discovered URL.
-     * Throws HateoasError if resolution fails (strict mode).
+     * Resolve a path via HATEOAS link traversal, spec-aware.
+     *
+     * Fetches the parent resource (via the parent's own spec host, not the
+     * child's — critical for cross-spec flows like equipment.yaml's org-scoped
+     * endpoints whose parent `/organizations/{orgId}` lives on the platform
+     * host, not equipmentapi.deere.com/isg).
+     *
+     * Throws HateoasError if resolution fails.
      */
     private resolveHateoasUrl;
     /**