@wishknish/knishio-client-ts 0.8.1 → 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"),
@@ -5826,14 +5827,14 @@ var GraphQLClient = class {
     });
   }
   async query(request) {
-    const { query, variables } = request;
-    const result = await this.$__client.query(query, variables || {}).toPromise();
+    const { query, variables, context } = request;
+    const result = await this.$__client.query(query, variables || {}, context).toPromise();
     return this.formatResponse(result);
   }
   async mutation(request) {
-    const { query, variables } = request;
+    const { query, variables, context } = request;
     const mutationString = request.mutation || query;
-    const result = await this.$__client.mutation(mutationString, variables || {}).toPromise();
+    const result = await this.$__client.mutation(mutationString, variables || {}, context).toPromise();
     return this.formatResponse(result);
   }
   // Alias for mutation() to match JS SDK interface
@@ -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
    */
@@ -10384,7 +10411,7 @@ var KnishIOClient = class {
   /**
    * Executes a query or mutation
    */
-  async executeQuery(query, variables = null) {
+  async executeQuery(query, variables = null, context = {}) {
     if (this.$__authToken && this.$__authToken.isExpired() && !this.$__authInProcess) {
       this.log("info", "KnishIOClient::executeQuery() - Access token is expired. Getting new one...");
       await this.requestAuthToken({
@@ -10400,7 +10427,8 @@ var KnishIOClient = class {
         return response;
       });
     }
-    return await query.execute({ variables: variables || {} });
+    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
@@ -10733,7 +10761,8 @@ var KnishIOClient = class {
     throughMolecule = false,
     values = null,
     keys = null,
-    atomValues = null
+    atomValues = null,
+    requestPolicy = null
   }) {
     this.log("info", `KnishIOClient::queryMeta() - Querying metaType: ${metaType}, metaId: ${metaId}...`);
     let query;
@@ -10785,7 +10814,8 @@ var KnishIOClient = class {
         cellSlug: this.getCellSlug()
       });
     }
-    return this.executeQuery(query, variables);
+    const context = requestPolicy ? { requestPolicy } : {};
+    return this.executeQuery(query, variables, context);
   }
   /**
    * Queries meta assets and verifies cryptographic integrity of associated molecules.