@wishknish/knishio-client-ts 0.8.2 → 0.8.3

package/dist/index.js

@@ -3806,7 +3806,8 @@ z.object({
   client: z.unknown().optional(),
   socket: z.unknown().optional(),
   serverSdkVersion: z.number().int().min(1).optional(),
-  logging: z.boolean().optional()
+  logging: z.boolean().optional(),
+  defaultRequestPolicy: z.enum(["cache-first", "cache-only", "network-only", "cache-and-network"]).nullable().optional()
 }).strict();
 z.object({
   token: z.string().min(1, "Auth token cannot be empty"),
@@ -6336,7 +6337,11 @@ var KnishIOClientConfigSchema2 = z.object({
   client: z.unknown().optional(),
   socket: z.unknown().optional(),
   serverSdkVersion: z.number().int().min(1).max(10).default(4),
-  logging: z.boolean().default(false)
+  logging: z.boolean().default(false),
+  // Optional default urql request policy for reads (server/sync clients pass
+  // 'network-only'). Permitted by the strict schema so the constructor option
+  // isn't rejected.
+  defaultRequestPolicy: z.enum(["cache-first", "cache-only", "network-only", "cache-and-network"]).nullable().optional()
 }).strict();
 var EnvironmentConfigSchema = z.object({
   NODE_ENV: z.enum(["development", "production", "test"]).default("development"),
@@ -10064,6 +10069,10 @@ var KnishIOClient = class {
   $__client;
   $__serverSdkVersion = 3;
   $__logging = false;
+  // Default urql request policy applied to reads when the caller doesn't pass
+  // one. null = urql's default (cache-first). Server/sync clients set this to
+  // 'network-only' so a long-lived client never serves a stale cached read.
+  $__defaultRequestPolicy = null;
   $__authTokenObjects = {};
   $__authToken = null;
   $__authInProcess = false;
@@ -10103,13 +10112,15 @@ var KnishIOClient = class {
       serverSdkVersion = 3,
       logging = false
     } = validatedConfig;
+    const defaultRequestPolicy = config.defaultRequestPolicy ?? null;
     this.initialize({
       uri,
       cellSlug,
       socket,
       client,
       serverSdkVersion,
-      logging
+      logging,
+      defaultRequestPolicy
     });
   }
   /**
@@ -10121,7 +10132,8 @@ var KnishIOClient = class {
     socket = null,
     client = null,
     serverSdkVersion = 3,
-    logging = false
+    logging = false,
+    defaultRequestPolicy = null
   }) {
     this.reset();
     this.$__logging = logging;
@@ -10143,6 +10155,7 @@ var KnishIOClient = class {
       encrypt: this.$__encrypt
     });
     this.$__serverSdkVersion = serverSdkVersion;
+    this.$__defaultRequestPolicy = defaultRequestPolicy;
   }
   /**
    * Get random uri from specified this.$__uris
@@ -10190,6 +10203,20 @@ var KnishIOClient = class {
   getServerSdkVersion() {
     return this.$__serverSdkVersion;
   }
+  /**
+   * Gets the client's default urql request policy (null = urql default).
+   */
+  getDefaultRequestPolicy() {
+    return this.$__defaultRequestPolicy;
+  }
+  /**
+   * Sets the default urql request policy applied to reads that don't specify
+   * one. Pass 'network-only' on a long-lived server/sync client so it never
+   * serves a stale cached read; null restores urql's default (cache-first).
+   */
+  setDefaultRequestPolicy(policy) {
+    this.$__defaultRequestPolicy = policy;
+  }
   /**
    * Reset common properties
    */
@@ -10394,7 +10421,8 @@ var KnishIOClient = class {
         return response;
       });
     }
-    return await query.execute({ variables: variables || {}, context });
+    const effectiveContext = this.$__defaultRequestPolicy && !context.requestPolicy ? { requestPolicy: this.$__defaultRequestPolicy, ...context } : context;
+    return await query.execute({ variables: variables || {}, context: effectiveContext });
   }
   /**
    * When a ProposeMolecule submission is rejected for a position-related