@wishknish/knishio-client-ts 0.8.2 → 0.8.3

package/dist/index.cjs

@@ -3812,7 +3812,8 @@ zod.z.object({
   client: zod.z.unknown().optional(),
   socket: zod.z.unknown().optional(),
   serverSdkVersion: zod.z.number().int().min(1).optional(),
-  logging: zod.z.boolean().optional()
+  logging: zod.z.boolean().optional(),
+  defaultRequestPolicy: zod.z.enum(["cache-first", "cache-only", "network-only", "cache-and-network"]).nullable().optional()
 }).strict();
 zod.z.object({
   token: zod.z.string().min(1, "Auth token cannot be empty"),
@@ -6342,7 +6343,11 @@ var KnishIOClientConfigSchema2 = zod.z.object({
   client: zod.z.unknown().optional(),
   socket: zod.z.unknown().optional(),
   serverSdkVersion: zod.z.number().int().min(1).max(10).default(4),
-  logging: zod.z.boolean().default(false)
+  logging: zod.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: zod.z.enum(["cache-first", "cache-only", "network-only", "cache-and-network"]).nullable().optional()
 }).strict();
 var EnvironmentConfigSchema = zod.z.object({
   NODE_ENV: zod.z.enum(["development", "production", "test"]).default("development"),
@@ -10070,6 +10075,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;
@@ -10109,13 +10118,15 @@ var KnishIOClient = class {
       serverSdkVersion = 3,
       logging = false
     } = validatedConfig;
+    const defaultRequestPolicy = config.defaultRequestPolicy ?? null;
     this.initialize({
       uri,
       cellSlug,
       socket,
       client,
       serverSdkVersion,
-      logging
+      logging,
+      defaultRequestPolicy
     });
   }
   /**
@@ -10127,7 +10138,8 @@ var KnishIOClient = class {
     socket = null,
     client = null,
     serverSdkVersion = 3,
-    logging = false
+    logging = false,
+    defaultRequestPolicy = null
   }) {
     this.reset();
     this.$__logging = logging;
@@ -10149,6 +10161,7 @@ var KnishIOClient = class {
       encrypt: this.$__encrypt
     });
     this.$__serverSdkVersion = serverSdkVersion;
+    this.$__defaultRequestPolicy = defaultRequestPolicy;
   }
   /**
    * Get random uri from specified this.$__uris
@@ -10196,6 +10209,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
    */
@@ -10400,7 +10427,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