@xemahq/workload-runtime-api-client 0.2.0 → 0.3.1

package/LICENSE

@@ -9,7 +9,7 @@ Parameters
 
 Licensor:  Neuralchowder Inc.
 
-Licensed Work:  Xema. The Licensed Work is (c) 2026 Neuralchowder Inc..
+Licensed Work:  Xema. The Licensed Work is (c) 2026 Neuralchowder Inc.
 
   The Licensed Work includes, without limitation, Xema Core, Xema Runtime,
   Xema Kernel, Xema control plane, Xema application runtime, Xema biome
@@ -116,6 +116,7 @@ the interpretation of, the Additional Use Grant set out above.
       and effect. The Licensor reserves all rights not expressly granted
       by this License.
 
+
 Change Date:  Four years from the date the specific version of the Licensed
   Work is first publicly released by Licensor.
 

package/dist/custom-fetch.d.ts

@@ -26,5 +26,22 @@ export declare class ClientError extends Error {
 }
 export declare function configureClient(config: ClientConfig): void;
 export declare function getClientConfig(): ClientConfig;
+/**
+ * Returns the response body EXACTLY as the service sent it.
+ *
+ * Xema platform services wrap every 2xx payload in a `{ data: T }` envelope
+ * (`{ data: T[], pagination }` for lists) via the global
+ * ResponseEnvelopeInterceptor. That envelope is part of the wire contract, so
+ * controllers document it with the `@ApiDataResponse` / `@ApiDataArrayResponse`
+ * / `@ApiPaginatedResponse` family and the generated types describe it —
+ * consumers read `.data`.
+ *
+ * This client therefore does NOT peel the envelope. It used to, which made the
+ * transport contradict the published schema: any endpoint documented honestly
+ * returned `undefined` from `.data` at runtime. Do not re-introduce an unwrap
+ * here — fix the controller's decorator instead.
+ *
+ * Only 2xx bodies are returned: non-2xx is surfaced as a thrown ClientError.
+ */
 export declare const customFetch: <T>(url: string, options: RequestInit) => Promise<T>;
 export default customFetch;

package/dist/custom-fetch.js

@@ -49,6 +49,23 @@ async function buildHeaders(config, callerHeaders) {
     }
     return headers;
 }
+/**
+ * Returns the response body EXACTLY as the service sent it.
+ *
+ * Xema platform services wrap every 2xx payload in a `{ data: T }` envelope
+ * (`{ data: T[], pagination }` for lists) via the global
+ * ResponseEnvelopeInterceptor. That envelope is part of the wire contract, so
+ * controllers document it with the `@ApiDataResponse` / `@ApiDataArrayResponse`
+ * / `@ApiPaginatedResponse` family and the generated types describe it —
+ * consumers read `.data`.
+ *
+ * This client therefore does NOT peel the envelope. It used to, which made the
+ * transport contradict the published schema: any endpoint documented honestly
+ * returned `undefined` from `.data` at runtime. Do not re-introduce an unwrap
+ * here — fix the controller's decorator instead.
+ *
+ * Only 2xx bodies are returned: non-2xx is surfaced as a thrown ClientError.
+ */
 const customFetch = async (url, options) => {
     const config = getClientConfig();
     const base = config.baseUrlResolver
@@ -74,14 +91,14 @@ const customFetch = async (url, options) => {
                 if (retryResponse.status >= 400) {
                     throw new ClientError(retryResponse.status, fullUrl, retryBody);
                 }
-                return unwrapEnvelope(retryBody);
+                return retryBody;
             }
             if (!RETRYABLE_STATUSES.includes(response.status) || attempt >= maxRetries) {
                 const body = await parseBody(response);
                 if (response.status >= 400) {
                     throw new ClientError(response.status, fullUrl, body);
                 }
-                return unwrapEnvelope(body);
+                return body;
             }
             const retryAfter = parseRetryAfter(response.headers.get('Retry-After'));
             const waitMs = retryAfter ?? addJitter(delay);
@@ -102,34 +119,6 @@ const customFetch = async (url, options) => {
     throw lastError ?? new Error(`All retries exhausted for ${fullUrl}`);
 };
 exports.customFetch = customFetch;
-/**
- * Xema platform services wrap every 2xx payload in a { data: T } envelope via
- * the global ResponseEnvelopeInterceptor (platform-common). Generated types
- * describe the INNER T (controllers declare their return type as T, not
- * { data: T }), so the client must peel data to keep the static types and the
- * wire shape consistent — otherwise consumers read fields off the envelope and
- * get undefined.
- *
- * Only 2xx bodies reach this helper: non-2xx responses are surfaced as a thrown
- * ClientError before unwrap, and error envelopes are emitted by the
- * GlobalExceptionFilter, never wrapped in { data }. Paginated lists arrive as
- * { data: T[], pagination: {...} }; consumers read both fields, so that envelope
- * is kept intact (detected by the presence of pagination). Any body without a
- * top-level data field is returned as-is.
- */
-function unwrapEnvelope(body) {
-    if (body === null ||
-        typeof body !== 'object' ||
-        Array.isArray(body) ||
-        !('data' in body)) {
-        return body;
-    }
-    const envelope = body;
-    if ('pagination' in envelope) {
-        return envelope;
-    }
-    return envelope.data;
-}
 async function parseBody(response) {
     const contentType = response.headers.get('content-type');
     if (contentType?.includes('application/json')) {

package/dist/endpoints/runner-operations/runner-operations.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 import type { RunnerJobManagementControllerListParams, RunnerJobSummaryDtoPaginatedEnvelope, RunnerWorkloadManagementControllerListParams, RunnerWorkloadSummaryDtoDataEnvelope, RunnerWorkloadSummaryDtoPaginatedEnvelope } from '../../models';

package/dist/models/paginationMeta.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export interface PaginationMeta {

package/dist/models/paginationMeta.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/runnerJobDeliveryState.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type RunnerJobDeliveryState = typeof RunnerJobDeliveryState[keyof typeof RunnerJobDeliveryState];

package/dist/models/runnerJobDeliveryState.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/runnerJobManagementControllerListParams.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { RunnerJobManagementControllerListState } from './runnerJobManagementControllerListState';
+import type { RunnerJobManagementControllerListState } from './runnerJobManagementControllerListState.js';
 export type RunnerJobManagementControllerListParams = {
     runnerId?: string;
     cursor?: string;

package/dist/models/runnerJobManagementControllerListState.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type RunnerJobManagementControllerListState = typeof RunnerJobManagementControllerListState[keyof typeof RunnerJobManagementControllerListState];

package/dist/models/runnerJobManagementControllerListState.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/runnerJobState.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type RunnerJobState = typeof RunnerJobState[keyof typeof RunnerJobState];

package/dist/models/runnerJobState.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/runnerJobSummaryDto.d.ts

@@ -1,12 +1,10 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { RunnerJobDeliveryState } from './runnerJobDeliveryState';
-import type { RunnerJobState } from './runnerJobState';
+import type { RunnerJobDeliveryState } from './runnerJobDeliveryState.js';
+import type { RunnerJobState } from './runnerJobState.js';
 export interface RunnerJobSummaryDto {
     jobId: string;
     projectId?: string;

package/dist/models/runnerJobSummaryDtoPaginatedEnvelope.d.ts

@@ -1,12 +1,10 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { PaginationMeta } from './paginationMeta';
-import type { RunnerJobSummaryDto } from './runnerJobSummaryDto';
+import type { PaginationMeta } from './paginationMeta.js';
+import type { RunnerJobSummaryDto } from './runnerJobSummaryDto.js';
 export interface RunnerJobSummaryDtoPaginatedEnvelope {
     data: RunnerJobSummaryDto[];
     pagination: PaginationMeta;

package/dist/models/runnerWorkloadManagementControllerListKind.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type RunnerWorkloadManagementControllerListKind = typeof RunnerWorkloadManagementControllerListKind[keyof typeof RunnerWorkloadManagementControllerListKind];

package/dist/models/runnerWorkloadManagementControllerListKind.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/runnerWorkloadManagementControllerListParams.d.ts

@@ -1,12 +1,10 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { RunnerWorkloadManagementControllerListKind } from './runnerWorkloadManagementControllerListKind';
-import type { RunnerWorkloadManagementControllerListState } from './runnerWorkloadManagementControllerListState';
+import type { RunnerWorkloadManagementControllerListKind } from './runnerWorkloadManagementControllerListKind.js';
+import type { RunnerWorkloadManagementControllerListState } from './runnerWorkloadManagementControllerListState.js';
 export type RunnerWorkloadManagementControllerListParams = {
     projectId?: string;
     ownerKey?: string;

package/dist/models/runnerWorkloadManagementControllerListState.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type RunnerWorkloadManagementControllerListState = typeof RunnerWorkloadManagementControllerListState[keyof typeof RunnerWorkloadManagementControllerListState];

package/dist/models/runnerWorkloadManagementControllerListState.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/runnerWorkloadSummaryDto.d.ts

@@ -1,13 +1,11 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { WorkloadHealthSnapshotDto } from './workloadHealthSnapshotDto';
-import type { WorkloadKind } from './workloadKind';
-import type { WorkloadState } from './workloadState';
+import type { WorkloadHealthSnapshotDto } from './workloadHealthSnapshotDto.js';
+import type { WorkloadKind } from './workloadKind.js';
+import type { WorkloadState } from './workloadState.js';
 export interface RunnerWorkloadSummaryDto {
     id: string;
     kind: WorkloadKind;

package/dist/models/runnerWorkloadSummaryDtoDataEnvelope.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { RunnerWorkloadSummaryDto } from './runnerWorkloadSummaryDto';
+import type { RunnerWorkloadSummaryDto } from './runnerWorkloadSummaryDto.js';
 export interface RunnerWorkloadSummaryDtoDataEnvelope {
     data: RunnerWorkloadSummaryDto;
 }

package/dist/models/runnerWorkloadSummaryDtoPaginatedEnvelope.d.ts

@@ -1,12 +1,10 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { PaginationMeta } from './paginationMeta';
-import type { RunnerWorkloadSummaryDto } from './runnerWorkloadSummaryDto';
+import type { PaginationMeta } from './paginationMeta.js';
+import type { RunnerWorkloadSummaryDto } from './runnerWorkloadSummaryDto.js';
 export interface RunnerWorkloadSummaryDtoPaginatedEnvelope {
     data: RunnerWorkloadSummaryDto[];
     pagination: PaginationMeta;

package/dist/models/workloadHealthConditionDto.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { WorkloadHealthConditionDtoStatus } from './workloadHealthConditionDtoStatus';
+import type { WorkloadHealthConditionDtoStatus } from './workloadHealthConditionDtoStatus.js';
 export interface WorkloadHealthConditionDto {
     type: string;
     status: WorkloadHealthConditionDtoStatus;

package/dist/models/workloadHealthConditionDtoStatus.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type WorkloadHealthConditionDtoStatus = typeof WorkloadHealthConditionDtoStatus[keyof typeof WorkloadHealthConditionDtoStatus];

package/dist/models/workloadHealthConditionDtoStatus.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/workloadHealthSnapshotDto.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
-import type { WorkloadHealthConditionDto } from './workloadHealthConditionDto';
+import type { WorkloadHealthConditionDto } from './workloadHealthConditionDto.js';
 export interface WorkloadHealthSnapshotDto {
     replicasReady: number;
     replicasDesired: number;

package/dist/models/workloadKind.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type WorkloadKind = typeof WorkloadKind[keyof typeof WorkloadKind];

package/dist/models/workloadKind.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/workloadState.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 export type WorkloadState = typeof WorkloadState[keyof typeof WorkloadState];

package/dist/models/workloadState.js

@@ -1,9 +1,7 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * Workload Runtime API
- * Declarative workload scheduling for biome sidecars, biome APIs,
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,12 @@
 {
   "name": "@xemahq/workload-runtime-api-client",
-  "version": "0.2.0",
+  "version": "0.3.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-base.git",
+    "directory": "packages/clients/workload-runtime-api"
+  },
+  "license": "LicenseRef-Xema-BSL-1.1",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -19,7 +25,7 @@
     "service": "workload-runtime-api",
     "biome": "workload-runtime",
     "target": "server",
-    "generator": "@xemahq/api-client-generator@0.2.0",
+    "generator": "@xemahq/api-client-generator@0.5.0",
     "source": "openapi.public.json"
   },
   "scripts": {