@unchainedshop/cockpit-api 2.4.0 → 2.4.2

package/dist/client.d.ts

@@ -14,7 +14,7 @@ import { type LocalizeOptions } from "./methods/localize.ts";
  * Cockpit API Client interface
  */
 export interface CockpitAPIClient {
-    graphQL<T = unknown>(document: DocumentNode, variables?: Record<string, unknown>): Promise<T | null>;
+    graphQL<T = unknown>(document: DocumentNode, variables?: Record<string, unknown>, operationName?: string): Promise<T | null>;
     getContentItem<T = unknown>(options: ContentItemQueryOptions): Promise<T | null>;
     getContentItems<T = CockpitContentItem>(model: string, options?: ContentListQueryOptions): Promise<CockpitListResponse<T> | null>;
     /**

package/dist/client.js

@@ -79,7 +79,7 @@ export async function CockpitAPI(options = {}) {
         : {};
     // Create response transformer
     const transformerConfig = {
-        baseUrl: config.endpoint.origin,
+        baseUrl: config.publicUrl ?? config.endpoint.origin,
         replacements: routeReplacements,
     };
     if (options.tenant)

package/dist/core/config.d.ts

@@ -71,6 +71,23 @@ export interface CockpitAPIOptions {
      * ```
      */
     cache?: false | CacheOptions;
+    /**
+     * Public URL for asset path rewriting.
+     * When using an internal/Docker endpoint (e.g. http://cms:80/api/gql), asset paths
+     * would contain the internal hostname. Set this to the public-facing URL so that
+     * asset paths use the correct origin in responses.
+     *
+     * Falls back to COCKPIT_PUBLIC_URL env var. When omitted, uses endpoint.origin.
+     *
+     * @example
+     * ```typescript
+     * const client = await CockpitAPI({
+     *   endpoint: 'http://cms-internal:80/api/gql',  // internal
+     *   publicUrl: 'https://cms.example.com',         // public-facing
+     * });
+     * ```
+     */
+    publicUrl?: string;
     /**
      * Preload route replacements during client initialization.
      * When true, fetches page routes to enable `pages://id` link resolution in responses.
@@ -85,6 +102,7 @@ export interface CockpitConfig {
     readonly apiKey?: string;
     readonly useAdminAccess: boolean;
     readonly defaultLanguage: string | null;
+    readonly publicUrl?: string;
     readonly cachePrefix: string;
 }
 /**

package/dist/core/config.js

@@ -22,6 +22,7 @@ export function createConfig(options = {}) {
     }
     const endpoint = new URL(endpointStr);
     const apiKey = resolveApiKey(tenant, options);
+    const publicUrl = options.publicUrl ?? process.env["COCKPIT_PUBLIC_URL"] ?? undefined;
     // Build config object with all properties before freezing
     const config = Object.freeze({
         endpoint,
@@ -30,6 +31,7 @@ export function createConfig(options = {}) {
         cachePrefix: `${endpointStr}:${tenant ?? "default"}:`,
         ...(tenant && { tenant }),
         ...(apiKey !== undefined && { apiKey }),
+        ...(publicUrl !== undefined && { publicUrl }),
     });
     return config;
 }

package/dist/methods/graphql.d.ts

@@ -4,6 +4,6 @@
 import { type DocumentNode } from "graphql";
 import type { MethodContext } from "./content.ts";
 export interface GraphQLMethods {
-    graphQL<T = unknown>(document: DocumentNode, variables?: Record<string, unknown>): Promise<T | null>;
+    graphQL<T = unknown>(document: DocumentNode, variables?: Record<string, unknown>, operationName?: string): Promise<T | null>;
 }
 export declare function createGraphQLMethods(ctx: MethodContext): GraphQLMethods;

package/dist/methods/graphql.js

@@ -1,13 +1,18 @@
 /**
  * GraphQL API method
  */
-import { print } from "graphql";
+import { print, getOperationAST } from "graphql";
 export function createGraphQLMethods(ctx) {
     return {
-        async graphQL(document, variables) {
+        async graphQL(document, variables, operationName) {
             const query = print(document);
+            const resolvedOperationName = operationName ?? getOperationAST(document)?.name?.value;
             const endpoint = ctx.url.graphqlEndpoint();
-            return ctx.http.post(endpoint, { query, variables });
+            return ctx.http.post(endpoint, {
+                query,
+                variables,
+                operationName: resolvedOperationName,
+            });
         },
     };
 }

package/dist/schema/executor.d.ts

@@ -36,6 +36,7 @@ export interface MakeCockpitSchemaOptions {
 export interface ExecutorRequest {
     document: DocumentNode;
     variables?: Record<string, unknown>;
+    operationName?: string;
     context?: CockpitExecutorContext;
 }
 /**

package/dist/schema/executor.js

@@ -72,7 +72,7 @@ export function createRemoteExecutor(options = {}) {
             pendingClients.delete(key);
         }
     }
-    return async ({ document, variables, context }) => {
+    return async ({ document, variables, operationName, context, }) => {
         // Extract tenant from context
         const tenant = extractTenant
             ? extractTenant(context)
@@ -80,6 +80,6 @@ export function createRemoteExecutor(options = {}) {
         // Get or create pooled client
         const cockpit = await getOrCreateClient(tenant);
         // Execute GraphQL query
-        return cockpit.graphQL(document, variables);
+        return cockpit.graphQL(document, variables, operationName);
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unchainedshop/cockpit-api",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "A package to interact with the Cockpit CMS API, including functionalities to handle GraphQL requests and various CMS content manipulations.",
   "main": "dist/index.js",
   "homepage": "https://unchained.shop",
@@ -47,11 +47,11 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=20"
+    "node": ">=25"
   },
   "dependencies": {
-    "@unchainedshop/logger": "^4.6.0",
-    "lru-cache": "^11.2.4"
+    "@unchainedshop/logger": "^4.6.2",
+    "lru-cache": "^11.2.6"
   },
   "types": "dist/index.d.ts",
   "peerDependencies": {
@@ -68,13 +68,13 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
-    "@types/node": "^24.10.7",
+    "@types/node": "^25.3.1",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "graphql": "^16.12.0",
-    "prettier": "^3.7.4",
+    "eslint-plugin-prettier": "^5.5.5",
+    "graphql": "^16.13.0",
+    "prettier": "^3.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.52.0"
+    "typescript-eslint": "^8.56.1"
   }
 }