@unchainedshop/cockpit-api 2.1.0 → 2.1.2

package/dist/core/config.d.ts

@@ -13,9 +13,8 @@ export interface CockpitAPIOptions {
     /**
      * Default language that maps to Cockpit's "default" locale.
      * When a request uses this language, it will be sent as "default" to Cockpit.
-     * @default "de"
      */
-    defaultLanguage?: string;
+    defaultLanguage?: string | null;
     /** Cache configuration */
     cache?: {
         /** Max entries (falls back to COCKPIT_CACHE_MAX env var, default: 100) */
@@ -36,7 +35,7 @@ export interface CockpitConfig {
     readonly tenant?: string;
     readonly apiKey?: string;
     readonly useAdminAccess: boolean;
-    readonly defaultLanguage: string;
+    readonly defaultLanguage: string | null;
     readonly cachePrefix: string;
 }
 /**

package/dist/core/config.js

@@ -12,20 +12,23 @@ export function createConfig(options = {}) {
     if (endpointStr === undefined || endpointStr === "") {
         throw new Error("Cockpit: endpoint is required (provide via options or COCKPIT_GRAPHQL_ENDPOINT env var)");
     }
+    // Normalize empty string tenant to undefined
+    const tenant = options.tenant === undefined || options.tenant === ""
+        ? undefined
+        : options.tenant;
     // Validate tenant format to prevent path traversal
-    if (options.tenant !== undefined &&
-        !VALID_TENANT_PATTERN.test(options.tenant)) {
+    if (tenant !== undefined && !VALID_TENANT_PATTERN.test(tenant)) {
         throw new Error("Cockpit: Invalid tenant format (only alphanumeric, hyphens, and underscores allowed)");
     }
     const endpoint = new URL(endpointStr);
-    const apiKey = resolveApiKey(options.tenant, options);
+    const apiKey = resolveApiKey(tenant, options);
     // Build config object with all properties before freezing
     const config = Object.freeze({
         endpoint,
         useAdminAccess: options.useAdminAccess ?? false,
-        defaultLanguage: options.defaultLanguage ?? "de",
-        cachePrefix: `${endpointStr}:${options.tenant ?? "default"}:`,
-        ...(options.tenant !== undefined && { tenant: options.tenant }),
+        defaultLanguage: options.defaultLanguage ?? null,
+        cachePrefix: `${endpointStr}:${tenant ?? "default"}:`,
+        ...(tenant !== undefined && { tenant }),
         ...(apiKey !== undefined && { apiKey }),
     });
     return config;

package/dist/core/locale.d.ts

@@ -5,7 +5,7 @@
  * Creates a locale normalizer for the given default language.
  * Maps the default language to Cockpit's "default" locale.
  *
- * @param defaultLanguage - The language that should map to "default"
+ * @param defaultLanguage - The language that should map to "default", or null to disable mapping
  * @returns A function that normalizes locale strings
  */
-export declare function createLocaleNormalizer(defaultLanguage: string): (locale?: string) => string;
+export declare function createLocaleNormalizer(defaultLanguage: string | null): (locale?: string) => string;

package/dist/core/locale.js

@@ -5,12 +5,14 @@
  * Creates a locale normalizer for the given default language.
  * Maps the default language to Cockpit's "default" locale.
  *
- * @param defaultLanguage - The language that should map to "default"
+ * @param defaultLanguage - The language that should map to "default", or null to disable mapping
  * @returns A function that normalizes locale strings
  */
 export function createLocaleNormalizer(defaultLanguage) {
     return (locale) => {
-        if (locale === undefined || locale === defaultLanguage)
+        if (locale === undefined)
+            return "default";
+        if (defaultLanguage !== null && locale === defaultLanguage)
             return "default";
         return locale;
     };

package/dist/schema/executor.d.ts

@@ -25,8 +25,8 @@ export interface MakeCockpitSchemaOptions {
     transforms?: unknown[];
     /** Custom tenant extractor function */
     extractTenant?: (context: CockpitExecutorContext | undefined) => string | undefined;
-    /** CockpitAPI options to pass through (endpoint, apiKey, useAdminAccess) */
-    cockpitOptions?: Pick<CockpitAPIOptions, "endpoint" | "apiKey" | "useAdminAccess">;
+    /** CockpitAPI options to pass through (endpoint, apiKey, useAdminAccess, preloadRoutes) */
+    cockpitOptions?: Pick<CockpitAPIOptions, "endpoint" | "apiKey" | "useAdminAccess" | "preloadRoutes">;
     /** Maximum number of clients to keep in the pool (default: 100) */
     maxClients?: number;
 }

package/dist/schema/executor.js

@@ -54,7 +54,11 @@ export function createRemoteExecutor(options = {}) {
         if (pending)
             return pending;
         // Create new client and cache it
-        const clientOpts = { ...cockpitOptions };
+        // Default preloadRoutes to true for page link resolution in GraphQL responses
+        const clientOpts = {
+            preloadRoutes: true,
+            ...cockpitOptions,
+        };
         if (tenant !== undefined)
             clientOpts.tenant = tenant;
         const clientPromise = CockpitAPI(clientOpts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unchainedshop/cockpit-api",
-  "version": "2.1.0",
+  "version": "2.1.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",