@lgriffin/esi.ts 6.1.0 → 7.4.0

package/CHANGELOG.md

@@ -5,7 +5,90 @@ 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [7.4.0] - 2026-07-17
+
+### Added
+
+- **`withSafeMode()` on all domain clients** — mirrors existing `withMetadata()`, surfaces the `EsiResult<T>` discriminated union (`{ ok: true, data, meta } | { ok: false, error }`) without needing to call `createClient()` directly
+- **`responseSchema` on `routeEndpoints`** — was the only endpoint file without runtime response validation; now validated with `z.looseObject({ route: z.array(z.number()) })`
+
+### Changed
+
+- **ESLint 8 → 10 flat config migration** — replaced `.eslintrc.cjs` with `eslint.config.mjs`, switched to unified `typescript-eslint` package, dropped `eslint-plugin-prettier` (redundant with lint-staged)
+- **jest-fetch-mock 3 → 4** — updated null-body status mocks (204/304) to use `new Response(null, ...)` per Fetch spec
+- Updated 11 minor/patch dependencies: @commitlint/cli, @microsoft/api-extractor, @redocly/cli, @types/node, @typescript-eslint/*, eslint-plugin-sonarjs, fast-check, knip, prettier, typedoc
+
+### Fixed
+
+- CI: aligned `codeql.yml` branch targets to `[master, main, develop]`
+- CI: pinned `jest-coverage-comment@main` → `@v1.0.34` (supply-chain risk)
+- CI: added schema drift and generated types freshness checks to release pipeline
+
+### Deprecated
+
+- `AllianceClient.getContacts()` — use `ContactsClient.getAllianceContacts()` instead
+- `AllianceClient.getContactLabels()` — use `ContactsClient.getAllianceContactLabels()` instead
+
+## [7.3.0] - 2026-07-14
+
+### Added
+
+- **`EsiResult<T>` discriminated union** and `safeMode` option for error-safe API calls
+- **Branded ID types** (16 types) for type-safe ESI entity references
+- **Expanded type-level tests** with tsd for error guards, endpoints, and domain types
+- **Compile-time spec-to-Zod type alignment checks**
+- **Schema drift detection** as a blocking CI check
+- **Comprehensive testing gap closure** (+1233 tests)
+
+### Fixed
+
+- Resolved three CI jobs failing with continue-on-error
+- Normalized CRLF in API surface check
+- Fixed schemathesis report permissions and `--url` flag
+- Fixed API surface ordering issues
+- Added missing `system_id` to `MarketOrderSchema` test data
+
+## [7.2.0] - 2026-07-08
+
+### Added
+
+- **Contract testing infrastructure** — deep validation of all endpoint definitions against the live ESI OpenAPI spec (`npm run contract:live`). Checks path parameter alignment, required query params, request body consistency, auth requirements, response schema coverage, HTTP methods, pagination metadata, and deprecation sync. 8 contract validation categories with known-exception tracking.
+- **Property-based fuzz testing** with [fast-check](https://github.com/dubzzz/fast-check) — 601 tests fuzzing `validatePathParam()`, `validateQueryParam()`, `buildEndpointPath()`, and all Zod schemas with random/adversarial inputs (`npm run fuzz`)
+- **OpenAPI spec snapshot & diff** — `npm run contract:snapshot` saves a baseline; `npm run contract:diff` detects breaking changes via [oasdiff](https://github.com/Tufin/oasdiff) (Docker)
+- **Consumer type tests** with [tsd](https://github.com/tsdjs/tsd) — verifies public API type correctness (`npm run test:types`)
+- **Prism mock server** — `npm run mock:esi` starts a spec-conformant ESI mock on port 4010 via [@stoplight/prism-cli](https://stoplight.io/open-source/prism)
+- **Schemathesis fuzz runner** — `npm run fuzz:api` runs Schemathesis against the Prism mock (Docker, weekly CI)
+- Contract and fuzz test CI jobs added to `ci.yml` quality gate
+- Weekly spec drift detection job added to `maintenance.yml`
+- `jest.contract.config.cjs` and `jest.fuzz.config.cjs` test configurations
+
+### Dependencies
+
+- Added `fast-check` (dev) — property-based testing framework
+- Added `@stoplight/prism-cli` (dev) — OpenAPI mock server
+- Added `tsd` (dev) — TypeScript type testing
+
+## [7.1.0] - 2026-07-08
+
+### Added
+
+- **Redocly CLI integration** — lints the live ESI OpenAPI spec for structural validity and best-practice compliance (`npm run validate:spec`). Catches spec breakage from CCP before it breaks generated types, cache TTLs, or scopes. Baseline: 0 errors, 328 warnings (all known CCP spec issues).
+- `redocly.yaml` config with tuned rulesets for ESI — structural rules as errors, CCP spec quirks as warnings
+- `validate:spec` npm script added to `check:all` pipeline
+
+## [7.0.0] - 2026-07-08
+
+### Breaking Changes
+
+- **Swagger 2.0 → OpenAPI 3.1 migration** — all generated types, cache TTLs, scopes, and rate limit groups are now sourced from the ESI OpenAPI 3.1 spec (`/meta/openapi.json`) instead of the deprecated Swagger 2.0 spec (`/latest/swagger.json`). See [esi-issues#1490](https://github.com/esi/esi-issues/issues/1490).
+- **Generated interface names changed** — `EsiSpec` namespace types now use OpenAPI schema names (e.g., `AllianceDetail` instead of `GetAlliancesAllianceIdOk`). These are generated types; hand-written consumer types are unchanged.
+- **Cache TTL metadata key** — internally changed from `x-cached-seconds` to `x-cache-age`. No consumer-facing impact (cache behavior is identical).
+
+### Changed
+
+- Single OpenAPI spec fetch instead of dual Swagger + OpenAPI fetches
+- Updated all scripts, tests, and documentation to reference OpenAPI spec
+- Generated types now include 161 interfaces (up from 147), 126 cache TTLs, 70 scopes
 
 ## [6.1.0] - 2026-07-07
 

package/README.md

@@ -8,37 +8,39 @@
 [![Coverage](https://img.shields.io/badge/coverage-65%25%2B-brightgreen)](https://github.com/lgriffin/ESI.ts)
 [![npm downloads](https://img.shields.io/npm/dm/%40lgriffin/esi.ts)](https://www.npmjs.com/package/@lgriffin/esi.ts)
 
-A production-grade TypeScript client for the [EVE Online ESI API](https://esi.evetech.net/), with runtime validation, intelligent caching, and full endpoint coverage.
+A production-grade TypeScript client for the [EVE Online ESI API](https://esi.evetech.net/), built on the **OpenAPI 3.1 spec**, with runtime validation, intelligent caching, and full endpoint coverage.
 
-**All 210 ESI endpoints are defined, tested, and validated against live Tranquility.**
+**v7.0.0** — Fully migrated from the deprecated Swagger 2.0 spec to OpenAPI 3.1 (`/meta/openapi.json`). All generated types, cache TTLs, scopes, and rate limit groups are now sourced from a single OpenAPI fetch. See [esi-issues#1490](https://github.com/esi/esi-issues/issues/1490) for the deprecation notice.
+
+**208 endpoint definitions — 194 from the public ESI OpenAPI spec, plus 14 for newer EVE features (Equinox sovereignty, orbital skyhooks, mercenary dens, access lists, freelance jobs). All 206 exercisable endpoints validated against live Tranquility on 2026-07-08.**
 
 ## Why ESI.ts vs. OpenAPI-Generated Clients?
 
-Tools like `openapi-typescript` or `openapi-generator` can produce a typed client from the ESI swagger spec in minutes. They're a reasonable starting point — but they stop at type generation. ESI.ts is a purpose-built SDK that handles the problems you hit _after_ the types compile.
+Tools like `openapi-typescript` or `openapi-generator` can produce a typed client from the ESI OpenAPI spec in minutes. They're a reasonable starting point — but they stop at type generation. ESI.ts is a purpose-built SDK that handles the problems you hit _after_ the types compile.
 
 ### What generators give you
 
-- TypeScript interfaces from the swagger spec
+- TypeScript interfaces from the OpenAPI spec
 - Basic request/response typing
 - A thin HTTP wrapper
 
 ### What ESI.ts gives you on top of that
 
-| Capability                      | openapi-typescript                                                                                                  | ESI.ts                                                                                                                                                                                                   |
-| ------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Runtime response validation** | None — types are erased at compile time. If CCP changes a field, you get silent data corruption.                    | Every response is validated at runtime via [Zod](https://zod.dev/) schemas (146 of 210 endpoints). Schema mismatches throw `EsiValidationError` immediately.                                             |
-| **Intelligent caching**         | None — you build your own.                                                                                          | Three-tier: spec-aware TTL (zero HTTP calls within ESI's `x-cached-seconds` window), ETag conditional GETs, stale-on-error fallback on 5xx. Write operations auto-invalidate related GET caches.         |
-| **Rate limiting**               | None — you build your own.                                                                                          | 36 per-group token buckets extracted from the ESI spec at build time. Market requests can't starve wallet requests. Optional per-user bucketing for multi-character apps.                                |
-| **Pagination**                  | Manual — you write the page loop.                                                                                   | Automatic offset pagination, cursor-based pagination (Equinox-era endpoints), and streaming `AsyncGenerator` pagination for memory-efficient processing of large datasets.                               |
-| **Retry & resilience**          | None.                                                                                                               | Exponential backoff with jitter, circuit breaker (closed/open/half-open), automatic 401 token refresh with concurrent coalescing.                                                                        |
-| **Wire format correctness**     | Generates from spec, but ESI's spec has inconsistencies (query params documented as body, missing required fields). | Every endpoint tested against live ESI. Wire format bugs (query params vs. body, field naming) are caught and fixed — see the contacts and UI endpoint fixes in v6.1.0.                                  |
-| **Batch operations**            | None.                                                                                                               | `batch()` with bounded concurrency for GET fan-out, `batchPost()` with auto-chunking for large POST payloads.                                                                                            |
-| **Domain knowledge**            | None — generic HTTP client.                                                                                         | 35 domain clients with typed methods, JSDoc documentation, and input validation (e.g., fleet wing/squad names are capped at 10 characters before hitting the API).                                       |
-| **Testing**                     | Whatever you write.                                                                                                 | 121 test suites, 3,224 tests across 7 tiers (TDD unit, BDD behavioral, mocked integration, live smoke, client integration, ESI spec contract, gated auth). 43 runnable example scripts with live output. |
+| Capability                      | openapi-typescript                                                                                                  | ESI.ts                                                                                                                                                                                                  |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Runtime response validation** | None — types are erased at compile time. If CCP changes a field, you get silent data corruption.                    | Every GET response is validated at runtime via [Zod](https://zod.dev/) schemas — all 173 GET endpoints have schemas. Schema mismatches throw `EsiValidationError` immediately.                          |
+| **Intelligent caching**         | None — you build your own.                                                                                          | Three-tier: spec-aware TTL (zero HTTP calls within ESI's `x-cached-seconds` window), ETag conditional GETs, stale-on-error fallback on 5xx. Write operations auto-invalidate related GET caches.        |
+| **Rate limiting**               | None — you build your own.                                                                                          | 36 per-group token buckets extracted from the ESI spec at build time. Market requests can't starve wallet requests. Optional per-user bucketing for multi-character apps.                               |
+| **Pagination**                  | Manual — you write the page loop.                                                                                   | Automatic offset pagination, cursor-based pagination (Equinox-era endpoints), and streaming `AsyncGenerator` pagination for memory-efficient processing of large datasets.                              |
+| **Retry & resilience**          | None.                                                                                                               | Exponential backoff with jitter, circuit breaker (closed/open/half-open), automatic 401 token refresh with concurrent coalescing.                                                                       |
+| **Wire format correctness**     | Generates from spec, but ESI's spec has inconsistencies (query params documented as body, missing required fields). | Every endpoint tested against live ESI. Wire format bugs (query params vs. body, field naming) are caught and fixed — see the contacts and UI endpoint fixes in v6.1.0.                                 |
+| **Batch operations**            | None.                                                                                                               | `batch()` with bounded concurrency for GET fan-out, `batchPost()` with auto-chunking for large POST payloads.                                                                                           |
+| **Domain knowledge**            | None — generic HTTP client.                                                                                         | 35 domain clients with typed methods, JSDoc documentation, and input validation (e.g., fleet wing/squad names are capped at 10 characters before hitting the API).                                      |
+| **Testing**                     | Whatever you write.                                                                                                 | 121+ test suites, 3,800+ tests across 9 tiers including property-based fuzzing (fast-check), deep contract tests against live OpenAPI spec, and consumer type tests (tsd). 43 runnable example scripts. |
 
 ### The real problem with generated clients
 
-The ESI swagger spec is not a perfect source of truth. During live endpoint validation, we discovered:
+The ESI OpenAPI spec is not a perfect source of truth. During live endpoint validation against the OpenAPI 3.1 spec, we discovered:
 
 - `addContacts`, `editContacts`, and 4 UI endpoints document parameters as request body when ESI actually expects query parameters
 - `deleteCharacterContacts` expects comma-separated contact IDs as a query param, not a JSON body
@@ -274,7 +276,7 @@ All clients are accessed as properties on the `EsiClient` instance. Authenticate
 
 ## Runtime Response Validation
 
-ESI.ts validates every API response at runtime using [Zod](https://zod.dev/) schemas. 146 of 210 endpoints have schemas attached. If CCP changes the ESI API and the response no longer matches the expected shape, you get an immediate `EsiValidationError` instead of silent data corruption.
+ESI.ts validates API responses at runtime using [Zod](https://zod.dev/) schemas. All GET endpoints have schemas — these are the endpoints that return data your application consumes, where a silent shape change from CCP would cause bugs. POST/PUT/DELETE mutations typically return `204 No Content` (no body to validate) or simple confirmation values, so schemas are omitted where there is nothing meaningful to validate.
 
 Validation is **on by default**. Extra fields from ESI are preserved via `z.looseObject()` passthrough mode, so new fields added by CCP won't break your application — they flow through to your code untouched.
 
@@ -329,7 +331,7 @@ const uncachedClient = new EsiClient({ enableETagCache: false });
 
 ### Spec-Aware Cache TTLs
 
-The library reads `x-cached-seconds` from the ESI swagger spec (119 of 195 endpoints). Within the TTL window, repeated GET requests return cached data with **zero HTTP calls** — not even a conditional GET.
+The library reads `x-cache-age` from the ESI OpenAPI spec (126 of 195 endpoints). Within the TTL window, repeated GET requests return cached data with **zero HTTP calls** — not even a conditional GET.
 
 This layers on top of ETag caching in three tiers:
 
@@ -479,13 +481,13 @@ Key points:
 
 ## Generated Types
 
-The library includes TypeScript interfaces generated directly from the ESI swagger spec, available as the `EsiSpec` namespace. These are guaranteed to match the live spec and complement the hand-written types:
+The library includes TypeScript interfaces generated directly from the ESI OpenAPI 3.1 spec, available as the `EsiSpec` namespace. These are guaranteed to match the live spec and complement the hand-written types:
 
 ```typescript
 import { EsiSpec } from '@lgriffin/esi.ts';
 
-// Generated type — exact spec field names and optionality
-const order: EsiSpec.GetMarketsRegionIdOrders200Ok = {
+// Generated type — uses OpenAPI schema names (v7.0.0+)
+const order: EsiSpec.MarketsRegionIdOrdersGet = {
   order_id: 123,
   type_id: 34,
   price: 5.5,
@@ -499,13 +501,13 @@ const order: EsiSpec.GetMarketsRegionIdOrders200Ok = {
 To regenerate types from the latest ESI spec:
 
 ```bash
-npm run generate:types    # fetches spec, generates 147 interfaces + cache TTL map + rate limit groups + scope map
+npm run generate:types    # fetches OpenAPI spec, generates 161 interfaces + cache TTL map + rate limit groups + scope map
 npm run validate:esi      # reports type drift between hand-written and generated types
 ```
 
 ## ESI Scopes
 
-The library includes a generated scope-to-endpoint mapping extracted from the ESI swagger spec. Use it to check which OAuth scopes an endpoint requires before making a request:
+The library includes a generated scope-to-endpoint mapping extracted from the ESI OpenAPI spec. Use it to check which OAuth scopes an endpoint requires before making a request:
 
 ```typescript
 import { esiEndpointScopes, EsiScope } from '@lgriffin/esi.ts';
@@ -657,7 +659,7 @@ const prices = await marketClient.getMarketPrices();
 
 ## Endpoint Coverage
 
-All 210 ESI endpoint definitions have been validated against live Tranquility. This table summarizes the validation approach:
+All 208 endpoint definitions have been validated against live Tranquility using the **OpenAPI 3.1 spec** — 194 from the public ESI spec plus 14 for newer EVE features. 206 endpoints are exercisable (2 mercenary den endpoints await CCP deployment). Full output is captured in [`openapi.output.md`](openapi.output.md).
 
 | Category                    | Endpoints | Method                                             |
 | --------------------------- | --------- | -------------------------------------------------- |
@@ -668,10 +670,10 @@ All 210 ESI endpoint definitions have been validated against live Tranquility. T
 | Mail (POST/PUT/DELETE)      | 5         | Live send/label/metadata/delete lifecycle          |
 | UI (POST)                   | 5         | Live testing with EVE client running               |
 | Calendar (PUT)              | 1         | Live RSVP to event                                 |
-| Fleet (GET/POST/PUT/DELETE) | 14        | Live fleet with two characters                     |
+| Fleet (GET/POST/PUT/DELETE) | 14        | Live fleet with fleet commander + squad members    |
 | Assets POST                 | 3         | Live asset location/name queries                   |
 | CSPA (POST)                 | 1         | Live charge cost calculation                       |
-| Dogma dynamic (GET)         | 1         | Live mutaplasmid item query                        |
+| Dogma dynamic (GET)         | 1         | Live mutaplasmid (Abyssal) item query              |
 | Universe POST helpers       | 3         | Live name resolution and affiliation               |
 | Freelance Jobs (GET)        | 4         | Live queries (graceful 404 for no active jobs)     |
 
@@ -778,19 +780,25 @@ try {
 
 ESI.ts has a comprehensive multi-tier testing strategy:
 
-| Tier                   | Tests            | Purpose                                                          |
-| ---------------------- | ---------------- | ---------------------------------------------------------------- |
-| **TDD unit tests**     | 81 files         | Every client method, endpoint path, query param, and body format |
-| **BDD scenario tests** | 40 feature files | Behavioral specifications in Gherkin (Given/When/Then)           |
-| **Mocked integration** | Full suite       | Cross-layer request flow with jest-fetch-mock                    |
-| **Live smoke tests**   | 43 examples      | Every endpoint against live Tranquility                          |
-| **ESI spec contract**  | 10 tests         | Endpoint definitions validated against live swagger spec         |
-| **Gated auth tests**   | 33 tests         | Authenticated endpoints with real tokens                         |
+| Tier                       | Tests            | Purpose                                                            |
+| -------------------------- | ---------------- | ------------------------------------------------------------------ |
+| **TDD unit tests**         | 81 files         | Every client method, endpoint path, query param, and body format   |
+| **BDD scenario tests**     | 40 feature files | Behavioral specifications in Gherkin (Given/When/Then)             |
+| **Mocked integration**     | Full suite       | Cross-layer request flow with jest-fetch-mock                      |
+| **Live smoke tests**       | 43 examples      | Every endpoint against live Tranquility                            |
+| **ESI spec contract**      | 15 tests         | Endpoint definitions validated against live OpenAPI spec           |
+| **Deep contract tests**    | 8 categories     | Path params, query params, body, auth, schemas, pagination vs spec |
+| **Property-based fuzzing** | 601 tests        | fast-check fuzzing of validation, URL construction, Zod schemas    |
+| **Type-level tests**       | tsd              | Consumer API type correctness via tsd                              |
+| **Gated auth tests**       | 33 tests         | Authenticated endpoints with real tokens                           |
 
 ```bash
 npm test          # Unit + BDD tests (121 suites, 3,224 tests)
 npm run coverage  # Tests with coverage report (thresholds enforced)
 npm run bdd       # BDD scenario tests only
+npm run contract  # Contract tests (skipped without ESI_LIVE_TESTS=true)
+npm run fuzz      # Property-based fuzz tests (601 tests)
+npm run test:types # tsd consumer type tests
 ```
 
 Coverage thresholds are enforced in CI: branches 50%, functions 50%, lines 65%, statements 65%.
@@ -817,6 +825,7 @@ The project uses a comprehensive suite of static analysis and code quality tools
 | [eslint-plugin-sonarjs](https://github.com/SonarSource/eslint-plugin-sonarjs)        | Cognitive complexity and code smell detection           | Integrated into `npm run lint` |
 | [husky](https://typicode.github.io/husky/)                                           | Git pre-commit hooks                                    | Automatic on commit            |
 | [lint-staged](https://github.com/lint-staged/lint-staged)                            | Run linters on staged files only                        | Automatic on commit            |
+| [Redocly CLI](https://redocly.com/docs/cli/)                                         | OpenAPI spec validation and linting                     | `npm run validate:spec`        |
 
 ### Available Scripts
 
@@ -830,15 +839,20 @@ npm run format:check       # Check formatting without modifying
 
 # Testing
 npm test                   # Unit tests (121 suites, 3,224 tests)
-npm run test:all           # Unit + improved + BDD tests
+npm run test:all           # Unit + BDD + integration + fuzz + type tests
 npm run coverage           # Tests with coverage report (thresholds enforced)
 npm run bdd                # BDD scenario tests
+npm run contract:live      # Deep contract tests against live ESI spec
+npm run fuzz               # Property-based fuzz tests (fast-check)
+npm run test:types         # Consumer type tests (tsd)
+npm run mock:esi           # Start Prism mock ESI server on port 4010
 
 # Static Analysis
 npm run knip               # Detect dead code and unused exports
-npm run validate:esi       # Validate endpoints against live ESI swagger spec
+npm run validate:esi       # Validate endpoints against live ESI OpenAPI spec
+npm run validate:spec      # Lint ESI OpenAPI spec with Redocly (structural + best practices)
 npm run validate           # Run all checks: lint, format, build, coverage, knip
-npm run generate:types     # Regenerate TypeScript interfaces from ESI swagger spec
+npm run generate:types     # Regenerate TypeScript interfaces from ESI OpenAPI spec
 
 # Documentation
 npm run docs               # Generate TypeDoc API documentation
@@ -847,13 +861,13 @@ npm run docs:serve         # Serve docs locally on port 8080
 
 ### ESI Endpoint Validation
 
-To verify that the codebase endpoint definitions match the live ESI swagger spec:
+To verify that the codebase endpoint definitions match the live ESI OpenAPI spec:
 
 ```bash
 npm run validate:esi
 ```
 
-This fetches `https://esi.evetech.net/latest/swagger.json` and reports:
+This fetches the ESI OpenAPI spec and reports:
 
 - Endpoints in the codebase that are no longer in the ESI spec
 - Endpoints in the ESI spec that the codebase doesn't cover
@@ -870,7 +884,7 @@ Every pull request runs the full validation suite:
 - ESLint (with security and sonarjs plugins)
 - Prettier formatting check
 - TypeScript compilation
-- Generated types staleness check (regenerates from live ESI spec and verifies no diff)
+- Generated types staleness check (regenerates from live ESI OpenAPI spec and verifies no diff)
 - Unit tests across Node.js 18, 20, and 22
 - BDD scenario tests
 - Coverage threshold enforcement (branches: 50%, functions: 50%, lines: 65%, statements: 65%)

package/dist/clients/AllianceClient.d.ts

@@ -15,6 +15,7 @@ export declare class AllianceClient extends BaseEsiClient<typeof allianceEndpoin
     /**
      * Retrieve contacts for an alliance.
      *
+     * @deprecated Use ContactsClient.getAllianceContacts() instead
      * @param allianceId - The ID of the alliance whose contacts to retrieve
      * @returns A list of alliance contacts with standings and contact types
      * @requires Authentication
@@ -23,6 +24,7 @@ export declare class AllianceClient extends BaseEsiClient<typeof allianceEndpoin
     /**
      * Retrieve custom contact labels for an alliance.
      *
+     * @deprecated Use ContactsClient.getAllianceContactLabels() instead
      * @param allianceId - The ID of the alliance whose contact labels to retrieve
      * @returns A list of custom labels used to categorize alliance contacts
      * @requires Authentication

package/dist/clients/AllianceClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AllianceClient.d.ts","sourceRoot":"","sources":["../../src/clients/AllianceClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,cAAe,SAAQ,aAAa,CAAC,OAAO,iBAAiB,CAAC;IACzE,OAAO,CAAC,UAAU,CAA2D;gBAEjE,MAAM,EAAE,SAAS;IAK7B;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1D;;;;;;OAMG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAM3D;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAMrE;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAItD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAInD;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAGlC"}
+{"version":3,"file":"AllianceClient.d.ts","sourceRoot":"","sources":["../../src/clients/AllianceClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,cAAe,SAAQ,aAAa,CAAC,OAAO,iBAAiB,CAAC;IACzE,OAAO,CAAC,UAAU,CAA2D;gBAEjE,MAAM,EAAE,SAAS;IAK7B;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1D;;;;;;;OAOG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAM3D;;;;;;;OAOG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAMrE;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAItD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAInD;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAGlC"}

package/dist/clients/AllianceClient.js

@@ -23,6 +23,7 @@ class AllianceClient extends BaseEsiClient_1.BaseEsiClient {
     /**
      * Retrieve contacts for an alliance.
      *
+     * @deprecated Use ContactsClient.getAllianceContacts() instead
      * @param allianceId - The ID of the alliance whose contacts to retrieve
      * @returns A list of alliance contacts with standings and contact types
      * @requires Authentication
@@ -33,6 +34,7 @@ class AllianceClient extends BaseEsiClient_1.BaseEsiClient {
     /**
      * Retrieve custom contact labels for an alliance.
      *
+     * @deprecated Use ContactsClient.getAllianceContactLabels() instead
      * @param allianceId - The ID of the alliance whose contact labels to retrieve
      * @returns A list of custom labels used to categorize alliance contacts
      * @requires Authentication

package/dist/clients/BaseEsiClient.d.ts

@@ -1,5 +1,5 @@
 import { ApiClient } from '../core/ApiClient';
-import { createClient, WithMetadata } from '../core/endpoints/createClient';
+import { createClient, WithMetadata, WithSafeMode } from '../core/endpoints/createClient';
 import { EndpointMap } from '../core/endpoints/EndpointDefinition';
 import { PageResult } from '../core/pagination/AsyncPaginationIterator';
 type ClientMethods<T extends EndpointMap> = ReturnType<typeof createClient<T>>;
@@ -8,9 +8,11 @@ export declare abstract class BaseEsiClient<T extends EndpointMap> {
     protected _client: ApiClient;
     protected _endpoints: T;
     private _metaApi?;
+    private _safeApi?;
     constructor(client: ApiClient, endpoints: T);
     protected streamEndpoint<R>(endpointName: string & keyof T, ...args: unknown[]): AsyncGenerator<PageResult<R>, void, undefined>;
-    withMetadata(): WithMetadata<Omit<this, 'withMetadata'>>;
+    withMetadata(): WithMetadata<Omit<this, 'withMetadata' | 'withSafeMode'>>;
+    withSafeMode(): WithSafeMode<Omit<this, 'withMetadata' | 'withSafeMode'>>;
 }
 export {};
 //# sourceMappingURL=BaseEsiClient.d.ts.map

package/dist/clients/BaseEsiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseEsiClient.d.ts","sourceRoot":"","sources":["../../src/clients/BaseEsiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,YAAY,EAEZ,YAAY,EACb,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,EAEL,UAAU,EACX,MAAM,4CAA4C,CAAC;AAEpD,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/E,8BAAsB,aAAa,CAAC,CAAC,SAAS,WAAW;IACvD,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IAC7B,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAmB;gBAExB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAM3C,SAAS,CAAC,cAAc,CAAC,CAAC,EACxB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,EAC9B,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IAgBjD,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;CAQzD"}
+{"version":3,"file":"BaseEsiClient.d.ts","sourceRoot":"","sources":["../../src/clients/BaseEsiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,YAAY,EAEZ,YAAY,EACZ,YAAY,EACb,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,EAEL,UAAU,EACX,MAAM,4CAA4C,CAAC;AAEpD,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/E,8BAAsB,aAAa,CAAC,CAAC,SAAS,WAAW;IACvD,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IAC7B,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAAmB;gBAExB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAM3C,SAAS,CAAC,cAAc,CAAC,CAAC,EACxB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,EAC9B,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IAgBjD,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAAC,CAAC;IAWzE,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAAC,CAAC;CAU1E"}

package/dist/clients/BaseEsiClient.js

@@ -9,6 +9,7 @@ class BaseEsiClient {
     _client;
     _endpoints;
     _metaApi;
+    _safeApi;
     constructor(client, endpoints) {
         this._client = client;
         this._endpoints = endpoints;
@@ -27,5 +28,13 @@ class BaseEsiClient {
         }
         return this._metaApi;
     }
+    withSafeMode() {
+        if (!this._safeApi) {
+            this._safeApi = (0, createClient_1.createClient)(this._client, this._endpoints, {
+                safeMode: true,
+            });
+        }
+        return this._safeApi;
+    }
 }
 exports.BaseEsiClient = BaseEsiClient;

package/dist/core/constants.d.ts

@@ -1,5 +1,5 @@
 export declare const PACKAGE_NAME = "esi.ts";
-export declare const PACKAGE_VERSION = "5.3.0";
-export declare const USER_AGENT = "esi.ts/5.3.0";
+export declare const PACKAGE_VERSION = "7.4.0";
+export declare const USER_AGENT = "esi.ts/7.4.0";
 export declare const COMPATIBILITY_DATE = "2026-05-19";
 //# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.js

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.COMPATIBILITY_DATE = exports.USER_AGENT = exports.PACKAGE_VERSION = exports.PACKAGE_NAME = void 0;
 exports.PACKAGE_NAME = 'esi.ts';
-exports.PACKAGE_VERSION = '5.3.0';
+exports.PACKAGE_VERSION = '7.4.0';
 exports.USER_AGENT = `${exports.PACKAGE_NAME}/${exports.PACKAGE_VERSION}`;
 exports.COMPATIBILITY_DATE = '2026-05-19';

package/dist/core/endpoints/allianceEndpoints.d.ts

@@ -1,40 +1,43 @@
+import { z } from 'zod';
 export declare const allianceEndpoints: {
     readonly getAllianceById: {
         readonly path: "alliances/{allianceId}/";
         readonly method: "GET";
         readonly requiresAuth: false;
         readonly pathParams: readonly ["allianceId"];
-        readonly responseSchema: import("zod").ZodObject<{
-            alliance_id: import("zod").ZodOptional<import("zod").ZodNumber>;
-            name: import("zod").ZodString;
-            ticker: import("zod").ZodString;
-            creator_id: import("zod").ZodNumber;
-            creator_corporation_id: import("zod").ZodNumber;
-            executor_corporation_id: import("zod").ZodOptional<import("zod").ZodNumber>;
-            date_founded: import("zod").ZodString;
-            faction_id: import("zod").ZodOptional<import("zod").ZodNumber>;
-        }, import("zod/v4/core").$loose>;
+        readonly responseSchema: z.ZodObject<{
+            alliance_id: z.ZodOptional<z.ZodNumber>;
+            name: z.ZodString;
+            ticker: z.ZodString;
+            creator_id: z.ZodNumber;
+            creator_corporation_id: z.ZodNumber;
+            executor_corporation_id: z.ZodOptional<z.ZodNumber>;
+            date_founded: z.ZodString;
+            faction_id: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>;
     };
     readonly getCorporations: {
         readonly path: "alliances/{allianceId}/corporations/";
         readonly method: "GET";
         readonly requiresAuth: false;
         readonly pathParams: readonly ["allianceId"];
+        readonly responseSchema: z.ZodArray<z.ZodNumber>;
     };
     readonly getIcons: {
         readonly path: "alliances/{allianceId}/icons/";
         readonly method: "GET";
         readonly requiresAuth: false;
         readonly pathParams: readonly ["allianceId"];
-        readonly responseSchema: import("zod").ZodObject<{
-            px64x64: import("zod").ZodOptional<import("zod").ZodString>;
-            px128x128: import("zod").ZodOptional<import("zod").ZodString>;
-        }, import("zod/v4/core").$loose>;
+        readonly responseSchema: z.ZodObject<{
+            px64x64: z.ZodOptional<z.ZodString>;
+            px128x128: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
     };
     readonly getAlliances: {
         readonly path: "alliances";
         readonly method: "GET";
         readonly requiresAuth: false;
+        readonly responseSchema: z.ZodArray<z.ZodNumber>;
     };
 };
 //# sourceMappingURL=allianceEndpoints.d.ts.map

package/dist/core/endpoints/allianceEndpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"allianceEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/allianceEndpoints.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BE,CAAC"}
+{"version":3,"file":"allianceEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/allianceEndpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BE,CAAC"}

package/dist/core/endpoints/allianceEndpoints.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.allianceEndpoints = void 0;
+const zod_1 = require("zod");
 const alliance_1 = require("../../schemas/alliance");
 exports.allianceEndpoints = {
     getAllianceById: {
@@ -15,6 +16,7 @@ exports.allianceEndpoints = {
         method: 'GET',
         requiresAuth: false,
         pathParams: ['allianceId'],
+        responseSchema: zod_1.z.array(zod_1.z.number()),
     },
     getIcons: {
         path: 'alliances/{allianceId}/icons/',
@@ -27,5 +29,6 @@ exports.allianceEndpoints = {
         path: 'alliances',
         method: 'GET',
         requiresAuth: false,
+        responseSchema: zod_1.z.array(zod_1.z.number()),
     },
 };

package/dist/core/endpoints/assetEndpoints.d.ts

@@ -26,6 +26,21 @@ export declare const assetEndpoints: {
         readonly method: "GET";
         readonly requiresAuth: true;
         readonly pathParams: readonly ["corporationId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            item_id: z.ZodNumber;
+            type_id: z.ZodNumber;
+            quantity: z.ZodNumber;
+            location_id: z.ZodNumber;
+            location_type: z.ZodEnum<{
+                other: "other";
+                solar_system: "solar_system";
+                station: "station";
+                item: "item";
+            }>;
+            location_flag: z.ZodString;
+            is_singleton: z.ZodBoolean;
+            is_blueprint_copy: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
     };
     readonly postCharacterAssetLocations: {
         readonly path: "characters/{characterId}/assets/locations/";

package/dist/core/endpoints/assetEndpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assetEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/assetEndpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAmBA,MAAM,EAAE;;;;;;;;;;;;;;;wCAQR,MAAM,EAAE;;;;;;;;;;;wCAQR,MAAM,EAAE;;;;;;;wCAOR,MAAM,EAAE;;CAEH,CAAC"}
+{"version":3,"file":"assetEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/assetEndpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAoBA,MAAM,EAAE;;;;;;;;;;;;;;;wCAQR,MAAM,EAAE;;;;;;;;;;;wCAQR,MAAM,EAAE;;;;;;;wCAOR,MAAM,EAAE;;CAEH,CAAC"}

package/dist/core/endpoints/assetEndpoints.js

@@ -16,6 +16,7 @@ exports.assetEndpoints = {
         method: 'GET',
         requiresAuth: true,
         pathParams: ['corporationId'],
+        responseSchema: zod_1.z.array(assets_1.CharacterAssetSchema),
     },
     postCharacterAssetLocations: {
         path: 'characters/{characterId}/assets/locations/',

package/dist/core/endpoints/characterEndpoints.d.ts

@@ -11,6 +11,7 @@ export declare const characterEndpoints: {
             description: z.ZodOptional<z.ZodString>;
             corporation_id: z.ZodNumber;
             alliance_id: z.ZodOptional<z.ZodNumber>;
+            faction_id: z.ZodOptional<z.ZodNumber>;
             ancestry_id: z.ZodOptional<z.ZodNumber>;
             bloodline_id: z.ZodNumber;
             race_id: z.ZodNumber;
@@ -94,6 +95,13 @@ export declare const characterEndpoints: {
         readonly method: "GET";
         readonly requiresAuth: true;
         readonly pathParams: readonly ["characterId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            notification_id: z.ZodNumber;
+            sender_character_id: z.ZodNumber;
+            message: z.ZodString;
+            send_date: z.ZodString;
+            standing_level: z.ZodNumber;
+        }, z.core.$loose>>;
     };
     readonly getCorporationHistory: {
         readonly path: "characters/{characterId}/corporationhistory/";

package/dist/core/endpoints/characterEndpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"characterEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/characterEndpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGC,CAAC"}
+{"version":3,"file":"characterEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/characterEndpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGC,CAAC"}

package/dist/core/endpoints/characterEndpoints.js

@@ -51,6 +51,7 @@ exports.characterEndpoints = {
         method: 'GET',
         requiresAuth: true,
         pathParams: ['characterId'],
+        responseSchema: zod_1.z.array(character_1.ContactNotificationSchema),
     },
     getCorporationHistory: {
         path: 'characters/{characterId}/corporationhistory/',