@constructive-io/sdk 0.14.12 → 0.15.0

package/admin/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/admin/orm/client.js

@@ -1,19 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrmClient = exports.GraphQLRequestError = exports.FetchAdapter = void 0;
+const runtime_1 = require("@constructive-io/graphql-query/runtime");
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? (0, runtime_1.createFetch)();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -29,7 +36,9 @@ class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -76,7 +85,7 @@ class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');

package/auth/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/auth/orm/client.js

@@ -1,19 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrmClient = exports.GraphQLRequestError = exports.FetchAdapter = void 0;
+const runtime_1 = require("@constructive-io/graphql-query/runtime");
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? (0, runtime_1.createFetch)();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -29,7 +36,9 @@ class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -76,7 +85,7 @@ class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');

package/esm/admin/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/esm/admin/orm/client.js

@@ -1,16 +1,23 @@
+import { createFetch } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? createFetch();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -26,7 +33,9 @@ export class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -71,7 +80,7 @@ export class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');

package/esm/auth/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/esm/auth/orm/client.js

@@ -1,16 +1,23 @@
+import { createFetch } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? createFetch();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -26,7 +33,9 @@ export class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -71,7 +80,7 @@ export class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');

package/esm/objects/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/esm/objects/orm/client.js

@@ -1,16 +1,23 @@
+import { createFetch } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? createFetch();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -26,7 +33,9 @@ export class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -71,7 +80,7 @@ export class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');

package/esm/public/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/esm/public/orm/client.js

@@ -1,16 +1,23 @@
+import { createFetch } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? createFetch();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -26,7 +33,9 @@ export class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -71,7 +80,7 @@ export class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');

package/objects/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/objects/orm/client.js

@@ -1,19 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrmClient = exports.GraphQLRequestError = exports.FetchAdapter = void 0;
+const runtime_1 = require("@constructive-io/graphql-query/runtime");
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? (0, runtime_1.createFetch)();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -29,7 +36,9 @@ class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -76,7 +85,7 @@ class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/sdk",
-  "version": "0.14.12",
+  "version": "0.15.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive SDK - Auto-generated GraphQL types and ORM client",
   "main": "index.js",
@@ -42,17 +42,17 @@
   ],
   "dependencies": {
     "@0no-co/graphql.web": "^1.1.2",
-    "@constructive-io/graphql-query": "^3.15.1",
+    "@constructive-io/graphql-query": "^3.15.2",
     "@constructive-io/graphql-types": "^3.5.1",
     "gql-ast": "^3.5.0",
     "graphql": "16.13.0"
   },
   "devDependencies": {
-    "@constructive-io/graphql-codegen": "^4.31.1",
+    "@constructive-io/graphql-codegen": "^4.32.0",
     "@types/node": "^22.19.11",
     "makage": "^0.3.0",
     "tsx": "^4.19.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "90b15540015a927e45846923843fc1af36f5bed7"
+  "gitHead": "a8ccaed4f3a7c6c82495241ee1581700db9dd2dd"
 }

package/public/orm/client.d.ts

@@ -7,19 +7,24 @@ import type { GraphQLAdapter, GraphQLError, QueryResult } from '@constructive-io
 export type { GraphQLAdapter, GraphQLError, QueryResult, } from '@constructive-io/graphql-query/runtime';
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 export declare class FetchAdapter implements GraphQLAdapter {
     private endpoint;
     private headers;
-    constructor(endpoint: string, headers?: Record<string, string>);
+    private fetchFn;
+    constructor(endpoint: string, headers?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
     execute<T>(document: string, variables?: Record<string, unknown>): Promise<QueryResult<T>>;
     setHeaders(headers: Record<string, string>): void;
     getEndpoint(): string;
 }
 /**
  * Configuration for creating an ORM client.
- * Either provide endpoint (and optional headers) for HTTP requests,
+ * Either provide endpoint (and optional headers/fetch) for HTTP requests,
  * or provide a custom adapter for alternative execution strategies.
  */
 export interface OrmClientConfig {
@@ -27,7 +32,14 @@ export interface OrmClientConfig {
     endpoint?: string;
     /** Default headers for HTTP requests (only used with endpoint) */
     headers?: Record<string, string>;
-    /** Custom adapter for GraphQL execution (overrides endpoint/headers) */
+    /**
+     * Custom fetch implementation. Defaults to createFetch() from
+     * @constructive-io/graphql-query/runtime which handles *.localhost
+     * DNS and Host headers in Node.js. Pass your own for test mocking
+     * or custom proxy/credentials.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Custom adapter for GraphQL execution (overrides endpoint/headers/fetch) */
     adapter?: GraphQLAdapter;
 }
 /**

package/public/orm/client.js

@@ -1,19 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrmClient = exports.GraphQLRequestError = exports.FetchAdapter = void 0;
+const runtime_1 = require("@constructive-io/graphql-query/runtime");
 /**
  * Default adapter that uses fetch for HTTP requests.
- * This is used when no custom adapter is provided.
+ *
+ * When no custom fetch is provided, uses @constructive-io/fetch which
+ * handles *.localhost DNS rewriting and Host header preservation in
+ * Node.js. Pass a custom fetch to override for test mocking or custom
+ * proxy/credentials.
  */
 class FetchAdapter {
     endpoint;
     headers;
-    constructor(endpoint, headers) {
+    fetchFn;
+    constructor(endpoint, headers, fetchFn) {
         this.endpoint = endpoint;
         this.headers = headers ?? {};
+        this.fetchFn = fetchFn ?? (0, runtime_1.createFetch)();
     }
     async execute(document, variables) {
-        const response = await fetch(this.endpoint, {
+        const response = await this.fetchFn(this.endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -29,7 +36,9 @@ class FetchAdapter {
             return {
                 ok: false,
                 data: null,
-                errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+                errors: [
+                    { message: `HTTP ${response.status}: ${response.statusText}` },
+                ],
             };
         }
         const json = (await response.json());
@@ -76,7 +85,7 @@ class OrmClient {
             this.adapter = config.adapter;
         }
         else if (config.endpoint) {
-            this.adapter = new FetchAdapter(config.endpoint, config.headers);
+            this.adapter = new FetchAdapter(config.endpoint, config.headers, config.fetch);
         }
         else {
             throw new Error('OrmClientConfig requires either an endpoint or a custom adapter');