@persei/perseed-api 5.0.19 → 5.0.20

package/dist/lib/src/client/customFetch.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Orval mutator for the generated fetch client (`src/generated/client.ts`).
+ *
+ * Centralizes base URL composition, `Authorization` header injection, and
+ * response decoding/error handling for every generated operation, so
+ * consumers (the `front` repo) can call the generated functions directly
+ * without a bespoke glue layer (see `front/packages/perseed-api-client/src/generatedClient.ts`,
+ * which this replaces — api's owner requested moving this logic here in MR !109).
+ */
+/**
+ * Thrown by {@link customFetch} when the response status is not in the 2xx range. Carries the
+ * HTTP `status` and the parsed error body (when present) so consumers can branch on the failure
+ * without having to re-parse anything (e.g. the front's `isEndpointUnavailable`).
+ */
+export declare class GeneratedClientError extends Error {
+    status: number;
+    body?: unknown;
+    constructor(status: number, body?: unknown);
+}
+export interface ClientRuntimeConfig {
+    /** Absolute base URL of the API, e.g. `https://api.perseed.eu`. */
+    baseUrl: string;
+    /**
+     * Returns the session token to use for the *current* call, or `undefined` if unauthenticated.
+     * A function (not a static token) so the runtime always reads the token in effect at call
+     * time — avoiding a stale-token capture without depending on React or any specific state
+     * management.
+     */
+    getToken?: () => string | undefined;
+}
+/** Configures the base URL and token accessor used by every generated operation. */
+export declare function configureGeneratedClient(cfg: ClientRuntimeConfig): void;
+/**
+ * Mutator invoked by every generated operation in `src/generated/client.ts`. Composes the
+ * absolute URL from the configured base URL, injects `Authorization: Bearer <token>` when a
+ * token is available, performs the request, and decodes the response the same way the previous
+ * front-side `fetchGenerated` did (null body for 204/205/304, JSON otherwise). A non-2xx response
+ * throws a {@link GeneratedClientError} instead of resolving, so callers get a rejected promise
+ * for every failed request.
+ *
+ * `T` here is orval's own per-operation response union (e.g. `listActionsResponse`, shaped as
+ * `{ data, status, headers }` discriminated by `status`), not the bare payload type — orval calls
+ * this mutator as `customFetch<listActionsResponse>(url, init)` and uses its return value
+ * directly as the operation's return value. Confirmed empirically by regenerating the client and
+ * inspecting `src/generated/client.ts`. The cast below is unavoidable: at runtime we only know the
+ * status/data/headers triple, not which member of the union it narrows to — that narrowing is the
+ * server's contract with the generated types, not something this generic transport layer can (or
+ * should) re-verify.
+ */
+export declare function customFetch<T>(url: string, options: RequestInit): Promise<T>;
+//# sourceMappingURL=customFetch.d.ts.map

package/dist/lib/src/client/customFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customFetch.d.ts","sourceRoot":"","sources":["../../../../src/client/customFetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;gBAEF,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAe3C;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CACpC;AAID,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAEvE;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAmBlF"}

package/dist/lib/src/client/customFetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=customFetch.test.d.ts.map

package/dist/lib/src/client/customFetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customFetch.test.d.ts","sourceRoot":"","sources":["../../../../src/client/customFetch.test.ts"],"names":[],"mappings":""}

package/dist/lib/src/client/index.d.ts

@@ -1,2 +1,3 @@
 export * from '../generated/client';
+export * from './customFetch';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/src/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}