@dloizides/orval-preset 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to `@dloizides/orval-preset` are documented here.
+
+## [1.0.0] - 2026-06-14
+
+### Added
+
+- Initial extraction from the duplicated Orval setup in `erevna-web` and
+  `katalogos-web` (task #196).
+- `defineOrvalConfig({ swaggerDir, outDir, mutatorPath, prettier? })` — builds
+  the shared 6-API Orval config (onlineMenu / identity / questioner / content /
+  payment / notification) from app-supplied paths.
+- The 6 mutators (`customInstance`, `identityInstance`, `questionerInstance`,
+  `contentInstance`, `notificationInstance`, `paymentInstance`) plus the runtime
+  registry (`registerMutators` / `getMutator`).
+- `createHttpClient(httpService, opts)` — the axios-bridge factory, with the
+  transport injected as a port (`HttpServicePort`) so the package imports no
+  product or concrete http layer. Whitespace-normalized vs the per-app copies;
+  behaviour-identical.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 dloizides
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# @dloizides/orval-preset
+
+Shared [Orval](https://orval.dev) generation setup for the dloizides.com SaaS
+frontends (`erevna-web` + `katalogos-web`).
+
+Both apps generate React Query hooks from the **same six OpenAPI services**
+(onlineMenu / identity / questioner / content / notification / payment) with a
+byte-for-byte identical config, mutator registry, and axios-bridge http client.
+This package owns that shared shape. Each app keeps only its own
+`swagger/*.json` inputs, output paths, and the generated client dirs.
+
+## Surface
+
+| Export | When | Purpose |
+| --- | --- | --- |
+| `defineOrvalConfig(opts)` | build-time | Builds the 6-API Orval config from app paths. |
+| `customInstance`, `identityInstance`, `questionerInstance`, `contentInstance`, `notificationInstance`, `paymentInstance` | runtime | The mutators referenced by the generated hooks; they delegate to the registry. |
+| `registerMutators` / `getMutator` | runtime | The registry the app populates at startup with the real http clients. |
+| `createHttpClient(httpService, opts)` | runtime | Axios-bridge factory; the app injects its own `httpService` transport (port). |
+
+## Build-time: `orval.config.js`
+
+```js
+const { defineOrvalConfig } = require('@dloizides/orval-preset');
+
+module.exports = defineOrvalConfig({
+  swaggerDir: './src/server/swagger',
+  outDir: './src/server/autoGeneratedHooks',
+  mutatorPath: './src/server/mutators',
+});
+```
+
+`mutatorPath` is the directory the generated hooks import their mutator from.
+Keep a thin local shim at that path that re-exports from this package, so the
+generated import paths stay stable across regenerations:
+
+```ts
+// src/server/mutators/onlineMenuMutator.ts
+export { customInstance, customInstance as default } from '@dloizides/orval-preset';
+```
+
+## Runtime: registration + http client
+
+```ts
+// src/server/httpClient.ts
+import { createHttpClient } from '@dloizides/orval-preset';
+import * as httpService from '../lib/httpService';
+import { BFF_API_BASE } from './bffRoutes';
+
+export const customInstance = createHttpClient(httpService, {
+  baseURL: BFF_API_BASE.menus,
+  withCredentials: true,
+});
+```
+
+```ts
+// app entry point
+import { registerMutators } from '@dloizides/orval-preset';
+import { customInstance } from './server/httpClient';
+// …the other five httpClient* files…
+
+registerMutators({ customInstance /* , … */ });
+```
+
+The `httpService` port must expose `get` / `post` / `postForm` / `put` /
+`patch` / `deleteMethod` (the surface the apps' axios bridge already provides).
+
+## Why a port, not a baked-in axios
+
+`createHttpClient` takes the transport as an argument so the package never
+imports a product, a realm, or a concrete axios instance. The app's UI axios
+(`@dloizides/bff-web-client`) and this mutator transport remain separate
+instances by design; unifying them is a future optimization.

package/dist/index.d.mts

@@ -0,0 +1,244 @@
+/**
+ * Orval config factory shared by erevna-web and katalogos-web.
+ *
+ * Both apps generate React Query hooks from the SAME six OpenAPI services
+ * (onlineMenu / identity / questioner / content / notification / payment) with
+ * an identical `tags-split` + per-service-mutator setup. This factory owns that
+ * shared shape; each app supplies only its own paths via {@link DefineOrvalConfigOptions}.
+ *
+ * The return value is a plain Orval config object (the same thing
+ * `defineConfig(...)` returns), so the app's `orval.config.js` becomes:
+ *
+ * ```js
+ * const { defineOrvalConfig } = require('@dloizides/orval-preset');
+ * module.exports = defineOrvalConfig({
+ *   swaggerDir: './src/server/swagger',
+ *   outDir: './src/server/autoGeneratedHooks',
+ *   mutatorPath: './src/server/mutators',
+ * });
+ * ```
+ */
+interface DefineOrvalConfigOptions {
+    /** Directory holding the per-service swagger JSON inputs (app-owned). */
+    swaggerDir: string;
+    /** Directory the generated client dirs are written to (app-owned, gitignored). */
+    outDir: string;
+    /** Directory holding the mutator files orval points generated hooks at (app-owned shims). */
+    mutatorPath: string;
+    /** Optional prettier override (defaults to true, matching the legacy config). */
+    prettier?: boolean;
+}
+interface OrvalMutatorOverride {
+    path: string;
+    name: string;
+}
+interface OrvalHookCommand {
+    command: string;
+}
+interface OrvalApiEntry {
+    input: {
+        target: string;
+        validation: boolean;
+    };
+    output: {
+        target: string;
+        client: 'react-query';
+        mode: 'tags-split';
+        clean: boolean;
+        prettier: boolean;
+        schemas: string;
+        override: {
+            mutator: OrvalMutatorOverride;
+        };
+    };
+    hooks: {
+        afterAllFilesWrite: OrvalHookCommand[];
+    };
+}
+type OrvalConfig = Record<string, OrvalApiEntry>;
+/**
+ * Builds the shared 6-API Orval config object from app-supplied paths.
+ */
+declare function defineOrvalConfig(options: DefineOrvalConfigOptions): OrvalConfig;
+
+/**
+ * Runtime registry for HTTP client implementations.
+ *
+ * This registry allows the app to register the real http client implementations
+ * at startup, which the generated Orval hooks will then use at runtime.
+ *
+ * Usage in app entry point (e.g., App.tsx):
+ * ```typescript
+ * import { registerMutators } from '@dloizides/orval-preset';
+ * import { customInstance } from './server/httpClient';
+ * import { identityInstance } from './server/httpClientIdentity';
+ * import { questionerInstance } from './server/httpClientQuestioner';
+ * import { contentInstance } from './server/httpClientContent';
+ * import { notificationInstance } from './server/httpClientNotification';
+ * import { paymentInstance } from './server/httpClientPayment';
+ *
+ * registerMutators({
+ *   customInstance,
+ *   identityInstance,
+ *   questionerInstance,
+ *   contentInstance,
+ *   notificationInstance,
+ *   paymentInstance,
+ * });
+ * ```
+ */
+interface OrvalRequest<Req = unknown, Qry = unknown> {
+    url: string;
+    method?: string;
+    data?: Req | FormData;
+    params?: Qry;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+type OrvalMutator = <TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>) => Promise<TResp>;
+interface MutatorRegistry {
+    customInstance?: OrvalMutator;
+    identityInstance?: OrvalMutator;
+    questionerInstance?: OrvalMutator;
+    contentInstance?: OrvalMutator;
+    notificationInstance?: OrvalMutator;
+    paymentInstance?: OrvalMutator;
+}
+/**
+ * Register the real HTTP client implementations.
+ * Call this once at app startup before any API hooks are used.
+ */
+declare function registerMutators(mutators: Partial<MutatorRegistry>): void;
+/**
+ * Get a registered mutator by name.
+ * @throws Error if the mutator has not been registered.
+ */
+declare function getMutator(name: keyof MutatorRegistry): OrvalMutator;
+
+/**
+ * OnlineMenu API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for OnlineMenu API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function customInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Identity API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Identity API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function identityInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Questioner API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Questioner API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function questionerInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Content API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Content API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function contentInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Notification API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Notification API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function notificationInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Payment API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Payment API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function paymentInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Request options passed to the injected httpService methods.
+ *
+ * This is the contract the consuming app's `httpService` must accept. The
+ * package never imports a concrete axios/http layer — the app supplies it as
+ * a port (see `HttpServicePort`), keeping this factory product-agnostic.
+ */
+interface HttpRequestOptions {
+    withCredentials?: boolean;
+    baseURL?: string;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+/**
+ * The HTTP transport port the consuming app injects. Mirrors the method
+ * surface the app's `httpService` already exposes (axios bridge).
+ *
+ * The package always supplies the base {@link HttpRequestOptions} shape, so an
+ * app whose `httpService` accepts a *wider* options type (extra optional fields)
+ * can be adapted to this port without type assertions.
+ */
+interface HttpServicePort {
+    get<TQry, TResp>(endpoint: string, params: TQry, opts: HttpRequestOptions): Promise<TResp>;
+    post<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+    postForm<TResp>(endpoint: string, data: FormData, opts: HttpRequestOptions): Promise<TResp>;
+    put<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+    patch<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+    deleteMethod<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+}
+interface HttpClientOptions {
+    baseURL?: string;
+    withCredentials?: boolean;
+}
+/**
+ * Creates an HTTP client instance for Orval-generated hooks.
+ *
+ * @param http - The app's httpService transport (injected port).
+ * @param clientOptions - Configuration options for the client (baseURL, auth settings).
+ * @returns An async function that handles HTTP requests.
+ */
+declare function createHttpClient(http: HttpServicePort, clientOptions?: HttpClientOptions): OrvalMutator;
+
+export { type DefineOrvalConfigOptions, type HttpRequestOptions, type HttpServicePort, type OrvalConfig, type OrvalMutator, type OrvalRequest, contentInstance, createHttpClient, customInstance, defineOrvalConfig, getMutator, identityInstance, notificationInstance, paymentInstance, questionerInstance, registerMutators };

package/dist/index.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Orval config factory shared by erevna-web and katalogos-web.
+ *
+ * Both apps generate React Query hooks from the SAME six OpenAPI services
+ * (onlineMenu / identity / questioner / content / notification / payment) with
+ * an identical `tags-split` + per-service-mutator setup. This factory owns that
+ * shared shape; each app supplies only its own paths via {@link DefineOrvalConfigOptions}.
+ *
+ * The return value is a plain Orval config object (the same thing
+ * `defineConfig(...)` returns), so the app's `orval.config.js` becomes:
+ *
+ * ```js
+ * const { defineOrvalConfig } = require('@dloizides/orval-preset');
+ * module.exports = defineOrvalConfig({
+ *   swaggerDir: './src/server/swagger',
+ *   outDir: './src/server/autoGeneratedHooks',
+ *   mutatorPath: './src/server/mutators',
+ * });
+ * ```
+ */
+interface DefineOrvalConfigOptions {
+    /** Directory holding the per-service swagger JSON inputs (app-owned). */
+    swaggerDir: string;
+    /** Directory the generated client dirs are written to (app-owned, gitignored). */
+    outDir: string;
+    /** Directory holding the mutator files orval points generated hooks at (app-owned shims). */
+    mutatorPath: string;
+    /** Optional prettier override (defaults to true, matching the legacy config). */
+    prettier?: boolean;
+}
+interface OrvalMutatorOverride {
+    path: string;
+    name: string;
+}
+interface OrvalHookCommand {
+    command: string;
+}
+interface OrvalApiEntry {
+    input: {
+        target: string;
+        validation: boolean;
+    };
+    output: {
+        target: string;
+        client: 'react-query';
+        mode: 'tags-split';
+        clean: boolean;
+        prettier: boolean;
+        schemas: string;
+        override: {
+            mutator: OrvalMutatorOverride;
+        };
+    };
+    hooks: {
+        afterAllFilesWrite: OrvalHookCommand[];
+    };
+}
+type OrvalConfig = Record<string, OrvalApiEntry>;
+/**
+ * Builds the shared 6-API Orval config object from app-supplied paths.
+ */
+declare function defineOrvalConfig(options: DefineOrvalConfigOptions): OrvalConfig;
+
+/**
+ * Runtime registry for HTTP client implementations.
+ *
+ * This registry allows the app to register the real http client implementations
+ * at startup, which the generated Orval hooks will then use at runtime.
+ *
+ * Usage in app entry point (e.g., App.tsx):
+ * ```typescript
+ * import { registerMutators } from '@dloizides/orval-preset';
+ * import { customInstance } from './server/httpClient';
+ * import { identityInstance } from './server/httpClientIdentity';
+ * import { questionerInstance } from './server/httpClientQuestioner';
+ * import { contentInstance } from './server/httpClientContent';
+ * import { notificationInstance } from './server/httpClientNotification';
+ * import { paymentInstance } from './server/httpClientPayment';
+ *
+ * registerMutators({
+ *   customInstance,
+ *   identityInstance,
+ *   questionerInstance,
+ *   contentInstance,
+ *   notificationInstance,
+ *   paymentInstance,
+ * });
+ * ```
+ */
+interface OrvalRequest<Req = unknown, Qry = unknown> {
+    url: string;
+    method?: string;
+    data?: Req | FormData;
+    params?: Qry;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+type OrvalMutator = <TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>) => Promise<TResp>;
+interface MutatorRegistry {
+    customInstance?: OrvalMutator;
+    identityInstance?: OrvalMutator;
+    questionerInstance?: OrvalMutator;
+    contentInstance?: OrvalMutator;
+    notificationInstance?: OrvalMutator;
+    paymentInstance?: OrvalMutator;
+}
+/**
+ * Register the real HTTP client implementations.
+ * Call this once at app startup before any API hooks are used.
+ */
+declare function registerMutators(mutators: Partial<MutatorRegistry>): void;
+/**
+ * Get a registered mutator by name.
+ * @throws Error if the mutator has not been registered.
+ */
+declare function getMutator(name: keyof MutatorRegistry): OrvalMutator;
+
+/**
+ * OnlineMenu API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for OnlineMenu API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function customInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Identity API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Identity API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function identityInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Questioner API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Questioner API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function questionerInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Content API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Content API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function contentInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Notification API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Notification API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function notificationInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Payment API mutator for Orval code generation.
+ *
+ * This file has no Expo dependencies at the module level, allowing Orval
+ * to load it in Node.js during code generation. At runtime, it retrieves
+ * the real HTTP client from the registry.
+ */
+
+/**
+ * HTTP client for Payment API.
+ * At runtime, delegates to the real implementation registered via registerMutators().
+ */
+declare function paymentInstance<TResp = unknown, TReq = unknown, TQry = unknown>(opts: OrvalRequest<TReq, TQry>): Promise<TResp>;
+
+/**
+ * Request options passed to the injected httpService methods.
+ *
+ * This is the contract the consuming app's `httpService` must accept. The
+ * package never imports a concrete axios/http layer — the app supplies it as
+ * a port (see `HttpServicePort`), keeping this factory product-agnostic.
+ */
+interface HttpRequestOptions {
+    withCredentials?: boolean;
+    baseURL?: string;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+/**
+ * The HTTP transport port the consuming app injects. Mirrors the method
+ * surface the app's `httpService` already exposes (axios bridge).
+ *
+ * The package always supplies the base {@link HttpRequestOptions} shape, so an
+ * app whose `httpService` accepts a *wider* options type (extra optional fields)
+ * can be adapted to this port without type assertions.
+ */
+interface HttpServicePort {
+    get<TQry, TResp>(endpoint: string, params: TQry, opts: HttpRequestOptions): Promise<TResp>;
+    post<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+    postForm<TResp>(endpoint: string, data: FormData, opts: HttpRequestOptions): Promise<TResp>;
+    put<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+    patch<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+    deleteMethod<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;
+}
+interface HttpClientOptions {
+    baseURL?: string;
+    withCredentials?: boolean;
+}
+/**
+ * Creates an HTTP client instance for Orval-generated hooks.
+ *
+ * @param http - The app's httpService transport (injected port).
+ * @param clientOptions - Configuration options for the client (baseURL, auth settings).
+ * @returns An async function that handles HTTP requests.
+ */
+declare function createHttpClient(http: HttpServicePort, clientOptions?: HttpClientOptions): OrvalMutator;
+
+export { type DefineOrvalConfigOptions, type HttpRequestOptions, type HttpServicePort, type OrvalConfig, type OrvalMutator, type OrvalRequest, contentInstance, createHttpClient, customInstance, defineOrvalConfig, getMutator, identityInstance, notificationInstance, paymentInstance, questionerInstance, registerMutators };

package/dist/index.js

@@ -0,0 +1,236 @@
+'use strict';
+
+// src/defineOrvalConfig.ts
+var API_DESCRIPTORS = [
+  {
+    key: "onlineMenuApi",
+    slug: "onlinemenu",
+    mutatorFile: "onlineMenuMutator",
+    mutatorName: "customInstance",
+    label: "OnlineMenuSaaS"
+  },
+  {
+    key: "identityApi",
+    slug: "identity",
+    mutatorFile: "identityMutator",
+    mutatorName: "identityInstance",
+    label: "IdentityService"
+  },
+  {
+    key: "questionerApi",
+    slug: "questioner",
+    mutatorFile: "questionerMutator",
+    mutatorName: "questionerInstance",
+    label: "QuestionerService"
+  },
+  {
+    key: "contentApi",
+    slug: "content",
+    mutatorFile: "contentMutator",
+    mutatorName: "contentInstance",
+    label: "ContentService"
+  },
+  {
+    key: "paymentApi",
+    slug: "payment",
+    mutatorFile: "paymentMutator",
+    mutatorName: "paymentInstance",
+    label: "PaymentService"
+  },
+  {
+    key: "notificationApi",
+    slug: "notification",
+    mutatorFile: "notificationMutator",
+    mutatorName: "notificationInstance",
+    label: "NotificationService"
+  }
+];
+function stripTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value[end - 1] === "/") {
+    end -= 1;
+  }
+  return value.slice(0, end);
+}
+function joinPath(base, segment) {
+  return `${stripTrailingSlashes(base)}/${segment}`;
+}
+function buildApiEntry(descriptor, options) {
+  const generatedDir = joinPath(options.outDir, descriptor.slug);
+  return {
+    input: {
+      target: joinPath(options.swaggerDir, `${descriptor.slug}.json`),
+      validation: false
+    },
+    output: {
+      target: joinPath(generatedDir, "index.ts"),
+      client: "react-query",
+      mode: "tags-split",
+      clean: true,
+      prettier: options.prettier,
+      schemas: joinPath(generatedDir, "models"),
+      override: {
+        mutator: {
+          path: joinPath(options.mutatorPath, `${descriptor.mutatorFile}.ts`),
+          name: descriptor.mutatorName
+        }
+      }
+    },
+    hooks: {
+      afterAllFilesWrite: [
+        { command: `npx prettier --write ${generatedDir}` },
+        { command: `echo "\u2705 Orval: ${descriptor.label} hooks generated"` }
+      ]
+    }
+  };
+}
+function defineOrvalConfig(options) {
+  const resolved = {
+    swaggerDir: options.swaggerDir,
+    outDir: options.outDir,
+    mutatorPath: options.mutatorPath,
+    prettier: options.prettier ?? true
+  };
+  const config = {};
+  for (const descriptor of API_DESCRIPTORS) {
+    config[descriptor.key] = buildApiEntry(descriptor, resolved);
+  }
+  return config;
+}
+
+// src/mutators/registry.ts
+var registry = {};
+function registerMutators(mutators) {
+  if (mutators.customInstance) {
+    registry.customInstance = mutators.customInstance;
+  }
+  if (mutators.identityInstance) {
+    registry.identityInstance = mutators.identityInstance;
+  }
+  if (mutators.questionerInstance) {
+    registry.questionerInstance = mutators.questionerInstance;
+  }
+  if (mutators.contentInstance) {
+    registry.contentInstance = mutators.contentInstance;
+  }
+  if (mutators.notificationInstance) {
+    registry.notificationInstance = mutators.notificationInstance;
+  }
+  if (mutators.paymentInstance) {
+    registry.paymentInstance = mutators.paymentInstance;
+  }
+}
+function getMutator(name) {
+  const mutator = registry[name];
+  if (!mutator) {
+    throw new Error(
+      `HTTP client '${name}' not registered. Call registerMutators() at app startup.`
+    );
+  }
+  return mutator;
+}
+
+// src/mutators/onlineMenuMutator.ts
+async function customInstance(opts) {
+  const realMutator = getMutator("customInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/identityMutator.ts
+async function identityInstance(opts) {
+  const realMutator = getMutator("identityInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/questionerMutator.ts
+async function questionerInstance(opts) {
+  const realMutator = getMutator("questionerInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/contentMutator.ts
+async function contentInstance(opts) {
+  const realMutator = getMutator("contentInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/notificationMutator.ts
+async function notificationInstance(opts) {
+  const realMutator = getMutator("notificationInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/paymentMutator.ts
+async function paymentInstance(opts) {
+  const realMutator = getMutator("paymentInstance");
+  return realMutator(opts);
+}
+
+// src/createHttpClient.ts
+function createRequestOptions(opts, clientOptions) {
+  return {
+    withCredentials: clientOptions.withCredentials ?? true,
+    baseURL: clientOptions.baseURL,
+    signal: opts.signal,
+    headers: opts.headers
+  };
+}
+async function handleGet(http, endpoint, params, reqOpts) {
+  return http.get(endpoint, params, reqOpts);
+}
+async function handlePost(http, endpoint, data, reqOpts) {
+  if (typeof FormData !== "undefined" && data instanceof FormData) {
+    return http.postForm(endpoint, data, reqOpts);
+  }
+  const payload = data;
+  return http.post(endpoint, payload, reqOpts);
+}
+async function handlePut(http, endpoint, data, reqOpts) {
+  return http.put(endpoint, data, reqOpts);
+}
+async function handlePatch(http, endpoint, data, reqOpts) {
+  return http.patch(endpoint, data, reqOpts);
+}
+async function handleDelete(http, endpoint, data, reqOpts) {
+  return http.deleteMethod(endpoint, data, reqOpts);
+}
+function createHttpClient(http, clientOptions = {}) {
+  return async (opts) => {
+    const { url, method = "GET", data, params } = opts;
+    const m = method.toUpperCase();
+    const endpoint = url;
+    const reqOpts = createRequestOptions(opts, clientOptions);
+    if (m === "GET") {
+      return handleGet(http, endpoint, params, reqOpts);
+    }
+    if (m === "POST") {
+      return handlePost(http, endpoint, data, reqOpts);
+    }
+    if (m === "PUT") {
+      const putData = data instanceof FormData ? void 0 : data;
+      return handlePut(http, endpoint, putData, reqOpts);
+    }
+    if (m === "PATCH") {
+      const patchData = data instanceof FormData ? void 0 : data;
+      return handlePatch(http, endpoint, patchData, reqOpts);
+    }
+    if (m === "DELETE") {
+      const deleteData = data instanceof FormData ? void 0 : data;
+      return handleDelete(http, endpoint, deleteData, reqOpts);
+    }
+    return handlePost(http, endpoint, data, reqOpts);
+  };
+}
+
+exports.contentInstance = contentInstance;
+exports.createHttpClient = createHttpClient;
+exports.customInstance = customInstance;
+exports.defineOrvalConfig = defineOrvalConfig;
+exports.getMutator = getMutator;
+exports.identityInstance = identityInstance;
+exports.notificationInstance = notificationInstance;
+exports.paymentInstance = paymentInstance;
+exports.questionerInstance = questionerInstance;
+exports.registerMutators = registerMutators;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/defineOrvalConfig.ts","../src/mutators/registry.ts","../src/mutators/onlineMenuMutator.ts","../src/mutators/identityMutator.ts","../src/mutators/questionerMutator.ts","../src/mutators/contentMutator.ts","../src/mutators/notificationMutator.ts","../src/mutators/paymentMutator.ts","../src/createHttpClient.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Orval config factory shared by erevna-web and katalogos-web.\n *\n * Both apps generate React Query hooks from the SAME six OpenAPI services\n * (onlineMenu / identity / questioner / content / notification / payment) with\n * an identical `tags-split` + per-service-mutator setup. This factory owns that\n * shared shape; each app supplies only its own paths via {@link DefineOrvalConfigOptions}.\n *\n * The return value is a plain Orval config object (the same thing\n * `defineConfig(...)` returns), so the app's `orval.config.js` becomes:\n *\n * ```js\n * const { defineOrvalConfig } = require('@dloizides/orval-preset');\n * module.exports = defineOrvalConfig({\n *   swaggerDir: './src/server/swagger',\n *   outDir: './src/server/autoGeneratedHooks',\n *   mutatorPath: './src/server/mutators',\n * });\n * ```\n */\n\nexport interface DefineOrvalConfigOptions {\n  /** Directory holding the per-service swagger JSON inputs (app-owned). */\n  swaggerDir: string;\n  /** Directory the generated client dirs are written to (app-owned, gitignored). */\n  outDir: string;\n  /** Directory holding the mutator files orval points generated hooks at (app-owned shims). */\n  mutatorPath: string;\n  /** Optional prettier override (defaults to true, matching the legacy config). */\n  prettier?: boolean;\n}\n\ninterface OrvalMutatorOverride {\n  path: string;\n  name: string;\n}\n\ninterface OrvalHookCommand {\n  command: string;\n}\n\ninterface OrvalApiEntry {\n  input: {\n    target: string;\n    validation: boolean;\n  };\n  output: {\n    target: string;\n    client: 'react-query';\n    mode: 'tags-split';\n    clean: boolean;\n    prettier: boolean;\n    schemas: string;\n    override: {\n      mutator: OrvalMutatorOverride;\n    };\n  };\n  hooks: {\n    afterAllFilesWrite: OrvalHookCommand[];\n  };\n}\n\nexport type OrvalConfig = Record<string, OrvalApiEntry>;\n\ninterface ApiDescriptor {\n  /** Orval config key (e.g. `onlineMenuApi`). */\n  key: string;\n  /** Swagger file basename without extension + the generated dir name (e.g. `onlinemenu`). */\n  slug: string;\n  /** Mutator file basename without extension (e.g. `onlineMenuMutator`). */\n  mutatorFile: string;\n  /** Exported mutator function name (e.g. `customInstance`). */\n  mutatorName: string;\n  /** Human label used in the generated success echo. */\n  label: string;\n}\n\n// The six services both apps generate, in the legacy config's order.\nconst API_DESCRIPTORS: readonly ApiDescriptor[] = [\n  {\n    key: 'onlineMenuApi',\n    slug: 'onlinemenu',\n    mutatorFile: 'onlineMenuMutator',\n    mutatorName: 'customInstance',\n    label: 'OnlineMenuSaaS',\n  },\n  {\n    key: 'identityApi',\n    slug: 'identity',\n    mutatorFile: 'identityMutator',\n    mutatorName: 'identityInstance',\n    label: 'IdentityService',\n  },\n  {\n    key: 'questionerApi',\n    slug: 'questioner',\n    mutatorFile: 'questionerMutator',\n    mutatorName: 'questionerInstance',\n    label: 'QuestionerService',\n  },\n  {\n    key: 'contentApi',\n    slug: 'content',\n    mutatorFile: 'contentMutator',\n    mutatorName: 'contentInstance',\n    label: 'ContentService',\n  },\n  {\n    key: 'paymentApi',\n    slug: 'payment',\n    mutatorFile: 'paymentMutator',\n    mutatorName: 'paymentInstance',\n    label: 'PaymentService',\n  },\n  {\n    key: 'notificationApi',\n    slug: 'notification',\n    mutatorFile: 'notificationMutator',\n    mutatorName: 'notificationInstance',\n    label: 'NotificationService',\n  },\n];\n\n/** Strips trailing forward slashes without a backtracking-prone regex. */\nfunction stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value[end - 1] === '/') {\n    end -= 1;\n  }\n  return value.slice(0, end);\n}\n\n/**\n * Joins a base dir to a segment with a single forward slash. The base may carry\n * a trailing slash (app paths often do); segments are always clean slugs/files.\n */\nfunction joinPath(base: string, segment: string): string {\n  return `${stripTrailingSlashes(base)}/${segment}`;\n}\n\nfunction buildApiEntry(\n  descriptor: ApiDescriptor,\n  options: Required<Pick<DefineOrvalConfigOptions, 'swaggerDir' | 'outDir' | 'mutatorPath' | 'prettier'>>,\n): OrvalApiEntry {\n  const generatedDir = joinPath(options.outDir, descriptor.slug);\n  return {\n    input: {\n      target: joinPath(options.swaggerDir, `${descriptor.slug}.json`),\n      validation: false,\n    },\n    output: {\n      target: joinPath(generatedDir, 'index.ts'),\n      client: 'react-query',\n      mode: 'tags-split',\n      clean: true,\n      prettier: options.prettier,\n      schemas: joinPath(generatedDir, 'models'),\n      override: {\n        mutator: {\n          path: joinPath(options.mutatorPath, `${descriptor.mutatorFile}.ts`),\n          name: descriptor.mutatorName,\n        },\n      },\n    },\n    hooks: {\n      afterAllFilesWrite: [\n        { command: `npx prettier --write ${generatedDir}` },\n        { command: `echo \"✅ Orval: ${descriptor.label} hooks generated\"` },\n      ],\n    },\n  };\n}\n\n/**\n * Builds the shared 6-API Orval config object from app-supplied paths.\n */\nexport function defineOrvalConfig(options: DefineOrvalConfigOptions): OrvalConfig {\n  const resolved = {\n    swaggerDir: options.swaggerDir,\n    outDir: options.outDir,\n    mutatorPath: options.mutatorPath,\n    prettier: options.prettier ?? true,\n  };\n\n  const config: OrvalConfig = {};\n  for (const descriptor of API_DESCRIPTORS) {\n    config[descriptor.key] = buildApiEntry(descriptor, resolved);\n  }\n  return config;\n}\n","/**\n * Runtime registry for HTTP client implementations.\n *\n * This registry allows the app to register the real http client implementations\n * at startup, which the generated Orval hooks will then use at runtime.\n *\n * Usage in app entry point (e.g., App.tsx):\n * ```typescript\n * import { registerMutators } from '@dloizides/orval-preset';\n * import { customInstance } from './server/httpClient';\n * import { identityInstance } from './server/httpClientIdentity';\n * import { questionerInstance } from './server/httpClientQuestioner';\n * import { contentInstance } from './server/httpClientContent';\n * import { notificationInstance } from './server/httpClientNotification';\n * import { paymentInstance } from './server/httpClientPayment';\n *\n * registerMutators({\n *   customInstance,\n *   identityInstance,\n *   questionerInstance,\n *   contentInstance,\n *   notificationInstance,\n *   paymentInstance,\n * });\n * ```\n */\n\nexport interface OrvalRequest<Req = unknown, Qry = unknown> {\n  url: string;\n  method?: string;\n  data?: Req | FormData;\n  params?: Qry;\n  signal?: AbortSignal;\n  headers?: Record<string, string>;\n}\n\nexport type OrvalMutator = <TResp = unknown, TReq = unknown, TQry = unknown>(\n  opts: OrvalRequest<TReq, TQry>,\n) => Promise<TResp>;\n\ninterface MutatorRegistry {\n  customInstance?: OrvalMutator;\n  identityInstance?: OrvalMutator;\n  questionerInstance?: OrvalMutator;\n  contentInstance?: OrvalMutator;\n  notificationInstance?: OrvalMutator;\n  paymentInstance?: OrvalMutator;\n}\n\n// Global registry - populated at app startup\nconst registry: MutatorRegistry = {};\n\n/**\n * Register the real HTTP client implementations.\n * Call this once at app startup before any API hooks are used.\n */\nexport function registerMutators(mutators: Partial<MutatorRegistry>): void {\n  if (mutators.customInstance) {\n    registry.customInstance = mutators.customInstance;\n  }\n  if (mutators.identityInstance) {\n    registry.identityInstance = mutators.identityInstance;\n  }\n  if (mutators.questionerInstance) {\n    registry.questionerInstance = mutators.questionerInstance;\n  }\n  if (mutators.contentInstance) {\n    registry.contentInstance = mutators.contentInstance;\n  }\n  if (mutators.notificationInstance) {\n    registry.notificationInstance = mutators.notificationInstance;\n  }\n  if (mutators.paymentInstance) {\n    registry.paymentInstance = mutators.paymentInstance;\n  }\n}\n\n/**\n * Get a registered mutator by name.\n * @throws Error if the mutator has not been registered.\n */\nexport function getMutator(name: keyof MutatorRegistry): OrvalMutator {\n  const mutator = registry[name];\n  if (!mutator) {\n    throw new Error(\n      `HTTP client '${name}' not registered. Call registerMutators() at app startup.`,\n    );\n  }\n\n  return mutator;\n}\n","/**\n * OnlineMenu API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for OnlineMenu API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function customInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('customInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default customInstance;\n","/**\n * Identity API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Identity API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function identityInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('identityInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default identityInstance;\n","/**\n * Questioner API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Questioner API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function questionerInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('questionerInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default questionerInstance;\n","/**\n * Content API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Content API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function contentInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('contentInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default contentInstance;\n","/**\n * Notification API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Notification API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function notificationInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('notificationInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default notificationInstance;\n","/**\n * Payment API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Payment API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function paymentInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('paymentInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default paymentInstance;\n","import type { OrvalRequest, OrvalMutator } from './mutators/registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * Request options passed to the injected httpService methods.\n *\n * This is the contract the consuming app's `httpService` must accept. The\n * package never imports a concrete axios/http layer — the app supplies it as\n * a port (see `HttpServicePort`), keeping this factory product-agnostic.\n */\nexport interface HttpRequestOptions {\n  withCredentials?: boolean;\n  baseURL?: string;\n  signal?: AbortSignal;\n  headers?: Record<string, string>;\n}\n\n/**\n * The HTTP transport port the consuming app injects. Mirrors the method\n * surface the app's `httpService` already exposes (axios bridge).\n *\n * The package always supplies the base {@link HttpRequestOptions} shape, so an\n * app whose `httpService` accepts a *wider* options type (extra optional fields)\n * can be adapted to this port without type assertions.\n */\nexport interface HttpServicePort {\n  get<TQry, TResp>(endpoint: string, params: TQry, opts: HttpRequestOptions): Promise<TResp>;\n  post<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n  postForm<TResp>(endpoint: string, data: FormData, opts: HttpRequestOptions): Promise<TResp>;\n  put<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n  patch<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n  deleteMethod<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n}\n\ninterface HttpClientOptions {\n  baseURL?: string;\n  withCredentials?: boolean;\n}\n\n/**\n * Creates request options with common defaults.\n *\n * `withCredentials` is always on — the BFF session cookie must travel with\n * every same-origin API call. There is no `withToken`: the SPA holds no\n * token, the BFF attaches the `Bearer` server-side.\n */\nfunction createRequestOptions(\n  opts: OrvalRequest,\n  clientOptions: HttpClientOptions,\n): HttpRequestOptions {\n  return {\n    withCredentials: clientOptions.withCredentials ?? true,\n    baseURL: clientOptions.baseURL,\n    signal: opts.signal,\n    headers: opts.headers,\n  };\n}\n\n/**\n * Handles GET requests.\n */\nasync function handleGet<TResp, TQry>(\n  http: HttpServicePort,\n  endpoint: string,\n  params: TQry,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.get<TQry, TResp>(endpoint, params, reqOpts);\n}\n\n/**\n * Handles POST requests, including FormData.\n */\nasync function handlePost<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | FormData | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  if (typeof FormData !== 'undefined' && data instanceof FormData) {\n    return http.postForm<TResp>(endpoint, data, reqOpts);\n  }\n\n  // FormData was handled above, so `data` is TReq | undefined here. We cast\n  // rather than re-test (the re-test would be a dead, uncoverable branch).\n  const payload = data as TReq | undefined;\n  return http.post<TReq | undefined, TResp>(endpoint, payload, reqOpts);\n}\n\n/**\n * Handles PUT requests.\n */\nasync function handlePut<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.put<TReq | undefined, TResp>(endpoint, data, reqOpts);\n}\n\n/**\n * Handles PATCH requests.\n */\nasync function handlePatch<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.patch<TReq | undefined, TResp>(endpoint, data, reqOpts);\n}\n\n/**\n * Handles DELETE requests.\n */\nasync function handleDelete<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.deleteMethod<TReq | undefined, TResp>(endpoint, data, reqOpts);\n}\n\n/**\n * Creates an HTTP client instance for Orval-generated hooks.\n *\n * @param http - The app's httpService transport (injected port).\n * @param clientOptions - Configuration options for the client (baseURL, auth settings).\n * @returns An async function that handles HTTP requests.\n */\nexport function createHttpClient(\n  http: HttpServicePort,\n  clientOptions: HttpClientOptions = {},\n): OrvalMutator {\n  return async <TResp = unknown, TReq = unknown, TQry = unknown>(\n    opts: OrvalRequest<TReq, TQry>,\n  ): Promise<TResp> => {\n    const { url, method = 'GET', data, params } = opts;\n    const m = method.toUpperCase();\n    const endpoint = url;\n    const reqOpts = createRequestOptions(opts, clientOptions);\n\n    if (m === 'GET') {\n      return handleGet<TResp, TQry | undefined>(http, endpoint, params, reqOpts);\n    }\n\n    if (m === 'POST') {\n      return handlePost<TResp, TReq>(http, endpoint, data, reqOpts);\n    }\n\n    if (m === 'PUT') {\n      // data could be TReq | FormData | undefined, but PUT doesn't use FormData\n      const putData: TReq | undefined = data instanceof FormData ? undefined : data;\n      return handlePut<TResp, TReq>(http, endpoint, putData, reqOpts);\n    }\n\n    if (m === 'PATCH') {\n      const patchData: TReq | undefined = data instanceof FormData ? undefined : data;\n      return handlePatch<TResp, TReq>(http, endpoint, patchData, reqOpts);\n    }\n\n    if (m === 'DELETE') {\n      const deleteData: TReq | undefined = data instanceof FormData ? undefined : data;\n      return handleDelete<TResp, TReq>(http, endpoint, deleteData, reqOpts);\n    }\n\n    // Fallback to POST for unsupported methods\n    return handlePost<TResp, TReq>(http, endpoint, data, reqOpts);\n  };\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,225 @@
+// src/defineOrvalConfig.ts
+var API_DESCRIPTORS = [
+  {
+    key: "onlineMenuApi",
+    slug: "onlinemenu",
+    mutatorFile: "onlineMenuMutator",
+    mutatorName: "customInstance",
+    label: "OnlineMenuSaaS"
+  },
+  {
+    key: "identityApi",
+    slug: "identity",
+    mutatorFile: "identityMutator",
+    mutatorName: "identityInstance",
+    label: "IdentityService"
+  },
+  {
+    key: "questionerApi",
+    slug: "questioner",
+    mutatorFile: "questionerMutator",
+    mutatorName: "questionerInstance",
+    label: "QuestionerService"
+  },
+  {
+    key: "contentApi",
+    slug: "content",
+    mutatorFile: "contentMutator",
+    mutatorName: "contentInstance",
+    label: "ContentService"
+  },
+  {
+    key: "paymentApi",
+    slug: "payment",
+    mutatorFile: "paymentMutator",
+    mutatorName: "paymentInstance",
+    label: "PaymentService"
+  },
+  {
+    key: "notificationApi",
+    slug: "notification",
+    mutatorFile: "notificationMutator",
+    mutatorName: "notificationInstance",
+    label: "NotificationService"
+  }
+];
+function stripTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value[end - 1] === "/") {
+    end -= 1;
+  }
+  return value.slice(0, end);
+}
+function joinPath(base, segment) {
+  return `${stripTrailingSlashes(base)}/${segment}`;
+}
+function buildApiEntry(descriptor, options) {
+  const generatedDir = joinPath(options.outDir, descriptor.slug);
+  return {
+    input: {
+      target: joinPath(options.swaggerDir, `${descriptor.slug}.json`),
+      validation: false
+    },
+    output: {
+      target: joinPath(generatedDir, "index.ts"),
+      client: "react-query",
+      mode: "tags-split",
+      clean: true,
+      prettier: options.prettier,
+      schemas: joinPath(generatedDir, "models"),
+      override: {
+        mutator: {
+          path: joinPath(options.mutatorPath, `${descriptor.mutatorFile}.ts`),
+          name: descriptor.mutatorName
+        }
+      }
+    },
+    hooks: {
+      afterAllFilesWrite: [
+        { command: `npx prettier --write ${generatedDir}` },
+        { command: `echo "\u2705 Orval: ${descriptor.label} hooks generated"` }
+      ]
+    }
+  };
+}
+function defineOrvalConfig(options) {
+  const resolved = {
+    swaggerDir: options.swaggerDir,
+    outDir: options.outDir,
+    mutatorPath: options.mutatorPath,
+    prettier: options.prettier ?? true
+  };
+  const config = {};
+  for (const descriptor of API_DESCRIPTORS) {
+    config[descriptor.key] = buildApiEntry(descriptor, resolved);
+  }
+  return config;
+}
+
+// src/mutators/registry.ts
+var registry = {};
+function registerMutators(mutators) {
+  if (mutators.customInstance) {
+    registry.customInstance = mutators.customInstance;
+  }
+  if (mutators.identityInstance) {
+    registry.identityInstance = mutators.identityInstance;
+  }
+  if (mutators.questionerInstance) {
+    registry.questionerInstance = mutators.questionerInstance;
+  }
+  if (mutators.contentInstance) {
+    registry.contentInstance = mutators.contentInstance;
+  }
+  if (mutators.notificationInstance) {
+    registry.notificationInstance = mutators.notificationInstance;
+  }
+  if (mutators.paymentInstance) {
+    registry.paymentInstance = mutators.paymentInstance;
+  }
+}
+function getMutator(name) {
+  const mutator = registry[name];
+  if (!mutator) {
+    throw new Error(
+      `HTTP client '${name}' not registered. Call registerMutators() at app startup.`
+    );
+  }
+  return mutator;
+}
+
+// src/mutators/onlineMenuMutator.ts
+async function customInstance(opts) {
+  const realMutator = getMutator("customInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/identityMutator.ts
+async function identityInstance(opts) {
+  const realMutator = getMutator("identityInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/questionerMutator.ts
+async function questionerInstance(opts) {
+  const realMutator = getMutator("questionerInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/contentMutator.ts
+async function contentInstance(opts) {
+  const realMutator = getMutator("contentInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/notificationMutator.ts
+async function notificationInstance(opts) {
+  const realMutator = getMutator("notificationInstance");
+  return realMutator(opts);
+}
+
+// src/mutators/paymentMutator.ts
+async function paymentInstance(opts) {
+  const realMutator = getMutator("paymentInstance");
+  return realMutator(opts);
+}
+
+// src/createHttpClient.ts
+function createRequestOptions(opts, clientOptions) {
+  return {
+    withCredentials: clientOptions.withCredentials ?? true,
+    baseURL: clientOptions.baseURL,
+    signal: opts.signal,
+    headers: opts.headers
+  };
+}
+async function handleGet(http, endpoint, params, reqOpts) {
+  return http.get(endpoint, params, reqOpts);
+}
+async function handlePost(http, endpoint, data, reqOpts) {
+  if (typeof FormData !== "undefined" && data instanceof FormData) {
+    return http.postForm(endpoint, data, reqOpts);
+  }
+  const payload = data;
+  return http.post(endpoint, payload, reqOpts);
+}
+async function handlePut(http, endpoint, data, reqOpts) {
+  return http.put(endpoint, data, reqOpts);
+}
+async function handlePatch(http, endpoint, data, reqOpts) {
+  return http.patch(endpoint, data, reqOpts);
+}
+async function handleDelete(http, endpoint, data, reqOpts) {
+  return http.deleteMethod(endpoint, data, reqOpts);
+}
+function createHttpClient(http, clientOptions = {}) {
+  return async (opts) => {
+    const { url, method = "GET", data, params } = opts;
+    const m = method.toUpperCase();
+    const endpoint = url;
+    const reqOpts = createRequestOptions(opts, clientOptions);
+    if (m === "GET") {
+      return handleGet(http, endpoint, params, reqOpts);
+    }
+    if (m === "POST") {
+      return handlePost(http, endpoint, data, reqOpts);
+    }
+    if (m === "PUT") {
+      const putData = data instanceof FormData ? void 0 : data;
+      return handlePut(http, endpoint, putData, reqOpts);
+    }
+    if (m === "PATCH") {
+      const patchData = data instanceof FormData ? void 0 : data;
+      return handlePatch(http, endpoint, patchData, reqOpts);
+    }
+    if (m === "DELETE") {
+      const deleteData = data instanceof FormData ? void 0 : data;
+      return handleDelete(http, endpoint, deleteData, reqOpts);
+    }
+    return handlePost(http, endpoint, data, reqOpts);
+  };
+}
+
+export { contentInstance, createHttpClient, customInstance, defineOrvalConfig, getMutator, identityInstance, notificationInstance, paymentInstance, questionerInstance, registerMutators };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/defineOrvalConfig.ts","../src/mutators/registry.ts","../src/mutators/onlineMenuMutator.ts","../src/mutators/identityMutator.ts","../src/mutators/questionerMutator.ts","../src/mutators/contentMutator.ts","../src/mutators/notificationMutator.ts","../src/mutators/paymentMutator.ts","../src/createHttpClient.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Orval config factory shared by erevna-web and katalogos-web.\n *\n * Both apps generate React Query hooks from the SAME six OpenAPI services\n * (onlineMenu / identity / questioner / content / notification / payment) with\n * an identical `tags-split` + per-service-mutator setup. This factory owns that\n * shared shape; each app supplies only its own paths via {@link DefineOrvalConfigOptions}.\n *\n * The return value is a plain Orval config object (the same thing\n * `defineConfig(...)` returns), so the app's `orval.config.js` becomes:\n *\n * ```js\n * const { defineOrvalConfig } = require('@dloizides/orval-preset');\n * module.exports = defineOrvalConfig({\n *   swaggerDir: './src/server/swagger',\n *   outDir: './src/server/autoGeneratedHooks',\n *   mutatorPath: './src/server/mutators',\n * });\n * ```\n */\n\nexport interface DefineOrvalConfigOptions {\n  /** Directory holding the per-service swagger JSON inputs (app-owned). */\n  swaggerDir: string;\n  /** Directory the generated client dirs are written to (app-owned, gitignored). */\n  outDir: string;\n  /** Directory holding the mutator files orval points generated hooks at (app-owned shims). */\n  mutatorPath: string;\n  /** Optional prettier override (defaults to true, matching the legacy config). */\n  prettier?: boolean;\n}\n\ninterface OrvalMutatorOverride {\n  path: string;\n  name: string;\n}\n\ninterface OrvalHookCommand {\n  command: string;\n}\n\ninterface OrvalApiEntry {\n  input: {\n    target: string;\n    validation: boolean;\n  };\n  output: {\n    target: string;\n    client: 'react-query';\n    mode: 'tags-split';\n    clean: boolean;\n    prettier: boolean;\n    schemas: string;\n    override: {\n      mutator: OrvalMutatorOverride;\n    };\n  };\n  hooks: {\n    afterAllFilesWrite: OrvalHookCommand[];\n  };\n}\n\nexport type OrvalConfig = Record<string, OrvalApiEntry>;\n\ninterface ApiDescriptor {\n  /** Orval config key (e.g. `onlineMenuApi`). */\n  key: string;\n  /** Swagger file basename without extension + the generated dir name (e.g. `onlinemenu`). */\n  slug: string;\n  /** Mutator file basename without extension (e.g. `onlineMenuMutator`). */\n  mutatorFile: string;\n  /** Exported mutator function name (e.g. `customInstance`). */\n  mutatorName: string;\n  /** Human label used in the generated success echo. */\n  label: string;\n}\n\n// The six services both apps generate, in the legacy config's order.\nconst API_DESCRIPTORS: readonly ApiDescriptor[] = [\n  {\n    key: 'onlineMenuApi',\n    slug: 'onlinemenu',\n    mutatorFile: 'onlineMenuMutator',\n    mutatorName: 'customInstance',\n    label: 'OnlineMenuSaaS',\n  },\n  {\n    key: 'identityApi',\n    slug: 'identity',\n    mutatorFile: 'identityMutator',\n    mutatorName: 'identityInstance',\n    label: 'IdentityService',\n  },\n  {\n    key: 'questionerApi',\n    slug: 'questioner',\n    mutatorFile: 'questionerMutator',\n    mutatorName: 'questionerInstance',\n    label: 'QuestionerService',\n  },\n  {\n    key: 'contentApi',\n    slug: 'content',\n    mutatorFile: 'contentMutator',\n    mutatorName: 'contentInstance',\n    label: 'ContentService',\n  },\n  {\n    key: 'paymentApi',\n    slug: 'payment',\n    mutatorFile: 'paymentMutator',\n    mutatorName: 'paymentInstance',\n    label: 'PaymentService',\n  },\n  {\n    key: 'notificationApi',\n    slug: 'notification',\n    mutatorFile: 'notificationMutator',\n    mutatorName: 'notificationInstance',\n    label: 'NotificationService',\n  },\n];\n\n/** Strips trailing forward slashes without a backtracking-prone regex. */\nfunction stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value[end - 1] === '/') {\n    end -= 1;\n  }\n  return value.slice(0, end);\n}\n\n/**\n * Joins a base dir to a segment with a single forward slash. The base may carry\n * a trailing slash (app paths often do); segments are always clean slugs/files.\n */\nfunction joinPath(base: string, segment: string): string {\n  return `${stripTrailingSlashes(base)}/${segment}`;\n}\n\nfunction buildApiEntry(\n  descriptor: ApiDescriptor,\n  options: Required<Pick<DefineOrvalConfigOptions, 'swaggerDir' | 'outDir' | 'mutatorPath' | 'prettier'>>,\n): OrvalApiEntry {\n  const generatedDir = joinPath(options.outDir, descriptor.slug);\n  return {\n    input: {\n      target: joinPath(options.swaggerDir, `${descriptor.slug}.json`),\n      validation: false,\n    },\n    output: {\n      target: joinPath(generatedDir, 'index.ts'),\n      client: 'react-query',\n      mode: 'tags-split',\n      clean: true,\n      prettier: options.prettier,\n      schemas: joinPath(generatedDir, 'models'),\n      override: {\n        mutator: {\n          path: joinPath(options.mutatorPath, `${descriptor.mutatorFile}.ts`),\n          name: descriptor.mutatorName,\n        },\n      },\n    },\n    hooks: {\n      afterAllFilesWrite: [\n        { command: `npx prettier --write ${generatedDir}` },\n        { command: `echo \"✅ Orval: ${descriptor.label} hooks generated\"` },\n      ],\n    },\n  };\n}\n\n/**\n * Builds the shared 6-API Orval config object from app-supplied paths.\n */\nexport function defineOrvalConfig(options: DefineOrvalConfigOptions): OrvalConfig {\n  const resolved = {\n    swaggerDir: options.swaggerDir,\n    outDir: options.outDir,\n    mutatorPath: options.mutatorPath,\n    prettier: options.prettier ?? true,\n  };\n\n  const config: OrvalConfig = {};\n  for (const descriptor of API_DESCRIPTORS) {\n    config[descriptor.key] = buildApiEntry(descriptor, resolved);\n  }\n  return config;\n}\n","/**\n * Runtime registry for HTTP client implementations.\n *\n * This registry allows the app to register the real http client implementations\n * at startup, which the generated Orval hooks will then use at runtime.\n *\n * Usage in app entry point (e.g., App.tsx):\n * ```typescript\n * import { registerMutators } from '@dloizides/orval-preset';\n * import { customInstance } from './server/httpClient';\n * import { identityInstance } from './server/httpClientIdentity';\n * import { questionerInstance } from './server/httpClientQuestioner';\n * import { contentInstance } from './server/httpClientContent';\n * import { notificationInstance } from './server/httpClientNotification';\n * import { paymentInstance } from './server/httpClientPayment';\n *\n * registerMutators({\n *   customInstance,\n *   identityInstance,\n *   questionerInstance,\n *   contentInstance,\n *   notificationInstance,\n *   paymentInstance,\n * });\n * ```\n */\n\nexport interface OrvalRequest<Req = unknown, Qry = unknown> {\n  url: string;\n  method?: string;\n  data?: Req | FormData;\n  params?: Qry;\n  signal?: AbortSignal;\n  headers?: Record<string, string>;\n}\n\nexport type OrvalMutator = <TResp = unknown, TReq = unknown, TQry = unknown>(\n  opts: OrvalRequest<TReq, TQry>,\n) => Promise<TResp>;\n\ninterface MutatorRegistry {\n  customInstance?: OrvalMutator;\n  identityInstance?: OrvalMutator;\n  questionerInstance?: OrvalMutator;\n  contentInstance?: OrvalMutator;\n  notificationInstance?: OrvalMutator;\n  paymentInstance?: OrvalMutator;\n}\n\n// Global registry - populated at app startup\nconst registry: MutatorRegistry = {};\n\n/**\n * Register the real HTTP client implementations.\n * Call this once at app startup before any API hooks are used.\n */\nexport function registerMutators(mutators: Partial<MutatorRegistry>): void {\n  if (mutators.customInstance) {\n    registry.customInstance = mutators.customInstance;\n  }\n  if (mutators.identityInstance) {\n    registry.identityInstance = mutators.identityInstance;\n  }\n  if (mutators.questionerInstance) {\n    registry.questionerInstance = mutators.questionerInstance;\n  }\n  if (mutators.contentInstance) {\n    registry.contentInstance = mutators.contentInstance;\n  }\n  if (mutators.notificationInstance) {\n    registry.notificationInstance = mutators.notificationInstance;\n  }\n  if (mutators.paymentInstance) {\n    registry.paymentInstance = mutators.paymentInstance;\n  }\n}\n\n/**\n * Get a registered mutator by name.\n * @throws Error if the mutator has not been registered.\n */\nexport function getMutator(name: keyof MutatorRegistry): OrvalMutator {\n  const mutator = registry[name];\n  if (!mutator) {\n    throw new Error(\n      `HTTP client '${name}' not registered. Call registerMutators() at app startup.`,\n    );\n  }\n\n  return mutator;\n}\n","/**\n * OnlineMenu API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for OnlineMenu API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function customInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('customInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default customInstance;\n","/**\n * Identity API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Identity API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function identityInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('identityInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default identityInstance;\n","/**\n * Questioner API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Questioner API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function questionerInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('questionerInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default questionerInstance;\n","/**\n * Content API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Content API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function contentInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('contentInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default contentInstance;\n","/**\n * Notification API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Notification API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function notificationInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('notificationInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default notificationInstance;\n","/**\n * Payment API mutator for Orval code generation.\n *\n * This file has no Expo dependencies at the module level, allowing Orval\n * to load it in Node.js during code generation. At runtime, it retrieves\n * the real HTTP client from the registry.\n */\nimport { getMutator, type OrvalRequest, type OrvalMutator } from './registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * HTTP client for Payment API.\n * At runtime, delegates to the real implementation registered via registerMutators().\n */\nexport async function paymentInstance<\n  TResp = unknown,\n  TReq = unknown,\n  TQry = unknown,\n>(\n  opts: OrvalRequest<TReq, TQry>,\n): Promise<TResp> {\n  const realMutator = getMutator('paymentInstance');\n  return realMutator<TResp, TReq, TQry>(opts);\n}\n\nexport default paymentInstance;\n","import type { OrvalRequest, OrvalMutator } from './mutators/registry';\n\nexport type { OrvalRequest, OrvalMutator };\n\n/**\n * Request options passed to the injected httpService methods.\n *\n * This is the contract the consuming app's `httpService` must accept. The\n * package never imports a concrete axios/http layer — the app supplies it as\n * a port (see `HttpServicePort`), keeping this factory product-agnostic.\n */\nexport interface HttpRequestOptions {\n  withCredentials?: boolean;\n  baseURL?: string;\n  signal?: AbortSignal;\n  headers?: Record<string, string>;\n}\n\n/**\n * The HTTP transport port the consuming app injects. Mirrors the method\n * surface the app's `httpService` already exposes (axios bridge).\n *\n * The package always supplies the base {@link HttpRequestOptions} shape, so an\n * app whose `httpService` accepts a *wider* options type (extra optional fields)\n * can be adapted to this port without type assertions.\n */\nexport interface HttpServicePort {\n  get<TQry, TResp>(endpoint: string, params: TQry, opts: HttpRequestOptions): Promise<TResp>;\n  post<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n  postForm<TResp>(endpoint: string, data: FormData, opts: HttpRequestOptions): Promise<TResp>;\n  put<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n  patch<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n  deleteMethod<TReq, TResp>(endpoint: string, data: TReq, opts: HttpRequestOptions): Promise<TResp>;\n}\n\ninterface HttpClientOptions {\n  baseURL?: string;\n  withCredentials?: boolean;\n}\n\n/**\n * Creates request options with common defaults.\n *\n * `withCredentials` is always on — the BFF session cookie must travel with\n * every same-origin API call. There is no `withToken`: the SPA holds no\n * token, the BFF attaches the `Bearer` server-side.\n */\nfunction createRequestOptions(\n  opts: OrvalRequest,\n  clientOptions: HttpClientOptions,\n): HttpRequestOptions {\n  return {\n    withCredentials: clientOptions.withCredentials ?? true,\n    baseURL: clientOptions.baseURL,\n    signal: opts.signal,\n    headers: opts.headers,\n  };\n}\n\n/**\n * Handles GET requests.\n */\nasync function handleGet<TResp, TQry>(\n  http: HttpServicePort,\n  endpoint: string,\n  params: TQry,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.get<TQry, TResp>(endpoint, params, reqOpts);\n}\n\n/**\n * Handles POST requests, including FormData.\n */\nasync function handlePost<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | FormData | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  if (typeof FormData !== 'undefined' && data instanceof FormData) {\n    return http.postForm<TResp>(endpoint, data, reqOpts);\n  }\n\n  // FormData was handled above, so `data` is TReq | undefined here. We cast\n  // rather than re-test (the re-test would be a dead, uncoverable branch).\n  const payload = data as TReq | undefined;\n  return http.post<TReq | undefined, TResp>(endpoint, payload, reqOpts);\n}\n\n/**\n * Handles PUT requests.\n */\nasync function handlePut<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.put<TReq | undefined, TResp>(endpoint, data, reqOpts);\n}\n\n/**\n * Handles PATCH requests.\n */\nasync function handlePatch<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.patch<TReq | undefined, TResp>(endpoint, data, reqOpts);\n}\n\n/**\n * Handles DELETE requests.\n */\nasync function handleDelete<TResp, TReq>(\n  http: HttpServicePort,\n  endpoint: string,\n  data: TReq | undefined,\n  reqOpts: HttpRequestOptions,\n): Promise<TResp> {\n  return http.deleteMethod<TReq | undefined, TResp>(endpoint, data, reqOpts);\n}\n\n/**\n * Creates an HTTP client instance for Orval-generated hooks.\n *\n * @param http - The app's httpService transport (injected port).\n * @param clientOptions - Configuration options for the client (baseURL, auth settings).\n * @returns An async function that handles HTTP requests.\n */\nexport function createHttpClient(\n  http: HttpServicePort,\n  clientOptions: HttpClientOptions = {},\n): OrvalMutator {\n  return async <TResp = unknown, TReq = unknown, TQry = unknown>(\n    opts: OrvalRequest<TReq, TQry>,\n  ): Promise<TResp> => {\n    const { url, method = 'GET', data, params } = opts;\n    const m = method.toUpperCase();\n    const endpoint = url;\n    const reqOpts = createRequestOptions(opts, clientOptions);\n\n    if (m === 'GET') {\n      return handleGet<TResp, TQry | undefined>(http, endpoint, params, reqOpts);\n    }\n\n    if (m === 'POST') {\n      return handlePost<TResp, TReq>(http, endpoint, data, reqOpts);\n    }\n\n    if (m === 'PUT') {\n      // data could be TReq | FormData | undefined, but PUT doesn't use FormData\n      const putData: TReq | undefined = data instanceof FormData ? undefined : data;\n      return handlePut<TResp, TReq>(http, endpoint, putData, reqOpts);\n    }\n\n    if (m === 'PATCH') {\n      const patchData: TReq | undefined = data instanceof FormData ? undefined : data;\n      return handlePatch<TResp, TReq>(http, endpoint, patchData, reqOpts);\n    }\n\n    if (m === 'DELETE') {\n      const deleteData: TReq | undefined = data instanceof FormData ? undefined : data;\n      return handleDelete<TResp, TReq>(http, endpoint, deleteData, reqOpts);\n    }\n\n    // Fallback to POST for unsupported methods\n    return handlePost<TResp, TReq>(http, endpoint, data, reqOpts);\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@dloizides/orval-preset",
+  "version": "1.0.1",
+  "description": "Shared Orval generation setup for the dloizides.com SaaS frontends: a 6-API config factory (defineOrvalConfig), the per-service mutator registry, and the axios-bridge createHttpClient factory (transport injected as a port). Owned shape erevna-web and katalogos-web shared byte-for-byte; never imports a product.",
+  "keywords": [
+    "orval",
+    "react-query",
+    "openapi",
+    "codegen",
+    "mutator",
+    "dloizides"
+  ],
+  "author": "dloizides",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openmindednewby/orval-preset.git"
+  },
+  "homepage": "https://github.com/openmindednewby/orval-preset#readme",
+  "bugs": {
+    "url": "https://github.com/openmindednewby/orval-preset/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsup",
+    "build:watch": "tsup --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "security:audit": "npm audit --audit-level=high",
+    "deps:outdated": "npm outdated || exit 0",
+    "deps:unused": "npx depcheck --ignores \"@types/jest,@types/node,rimraf\"",
+    "deps:licenses": "npx license-checker --onlyAllow \"MIT;Apache-2.0;ISC;BSD-2-Clause;BSD-3-Clause;0BSD;Unlicense;CC0-1.0\"",
+    "deps:health": "npm run deps:outdated && npm run deps:unused",
+    "prepublishOnly": "npm run clean && npm run build && npm run test"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.19.32",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "eslint-plugin-sonarjs": "^4.0.3",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  }
+}