feat: add vended_credentials config in declare table

docs/src/client/operations/models/CreateEmptyTableRequest.md

@@ -12,6 +12,7 @@ Request for creating an empty table.  **Deprecated**: Use `DeclareTableRequest`
 |**context** | **Map<String, String>** | Arbitrary context for a request as key-value pairs. How to use the context is custom to the specific implementation.  REST NAMESPACE ONLY Context entries are passed via HTTP headers using the naming convention `x-lance-ctx-<key>: <value>`. For example, a context entry `{\"trace_id\": \"abc123\"}` would be sent as the header `x-lance-ctx-trace_id: abc123`.  |  [optional] |
 |**id** | **List<String>** |  |  [optional] |
 |**location** | **String** | Optional storage location for the table. If not provided, the namespace implementation should determine the table location.  |  [optional] |
+|**vendCredentials** | **Boolean** | Whether to include vended credentials in the response `storage_options`. When true, the implementation should provide vended credentials for accessing storage. When not set, the implementation can decide whether to return vended credentials.  |  [optional] |
 
 
 

docs/src/client/operations/models/DeclareTableRequest.md

@@ -12,6 +12,7 @@ Request for declaring a table.
 |**context** | **Map<String, String>** | Arbitrary context for a request as key-value pairs. How to use the context is custom to the specific implementation.  REST NAMESPACE ONLY Context entries are passed via HTTP headers using the naming convention `x-lance-ctx-<key>: <value>`. For example, a context entry `{\"trace_id\": \"abc123\"}` would be sent as the header `x-lance-ctx-trace_id: abc123`.  |  [optional] |
 |**id** | **List<String>** |  |  [optional] |
 |**location** | **String** | Optional storage location for the table. If not provided, the namespace implementation should determine the table location.  |  [optional] |
+|**vendCredentials** | **Boolean** | Whether to include vended credentials in the response `storage_options`. When true, the implementation should provide vended credentials for accessing storage. When not set, the implementation can decide whether to return vended credentials.  |  [optional] |
 
 
 

docs/src/rest.yaml

@@ -2946,6 +2946,12 @@ components:
           description: |
             Optional storage location for the table.
             If not provided, the namespace implementation should determine the table location.
+        vend_credentials:
+          description: |
+            Whether to include vended credentials in the response `storage_options`.
+            When true, the implementation should provide vended credentials for accessing storage.
+            When not set, the implementation can decide whether to return vended credentials.
+          type: boolean
 
     CreateEmptyTableResponse:
       type: object
@@ -2987,6 +2993,12 @@ components:
           description: |
             Optional storage location for the table.
             If not provided, the namespace implementation should determine the table location.
+        vend_credentials:
+          description: |
+            Whether to include vended credentials in the response `storage_options`.
+            When true, the implementation should provide vended credentials for accessing storage.
+            When not set, the implementation can decide whether to return vended credentials.
+          type: boolean
 
     DeclareTableResponse:
       type: object

java/lance-namespace-apache-client/api/openapi.yaml

@@ -4120,6 +4120,7 @@ components:
         id:
         - id
         - id
+        vend_credentials: true
       properties:
         identity:
           $ref: '#/components/schemas/Identity'
@@ -4143,6 +4144,12 @@ components:
             Optional storage location for the table.
             If not provided, the namespace implementation should determine the table location.
           type: string
+        vend_credentials:
+          description: |
+            Whether to include vended credentials in the response `storage_options`.
+            When true, the implementation should provide vended credentials for accessing storage.
+            When not set, the implementation can decide whether to return vended credentials.
+          type: boolean
     CreateEmptyTableResponse:
       deprecated: true
       description: |
@@ -4180,6 +4187,7 @@ components:
         id:
         - id
         - id
+        vend_credentials: true
       properties:
         identity:
           $ref: '#/components/schemas/Identity'
@@ -4203,6 +4211,12 @@ components:
             Optional storage location for the table.
             If not provided, the namespace implementation should determine the table location.
           type: string
+        vend_credentials:
+          description: |
+            Whether to include vended credentials in the response `storage_options`.
+            When true, the implementation should provide vended credentials for accessing storage.
+            When not set, the implementation can decide whether to return vended credentials.
+          type: boolean
     DeclareTableResponse:
       description: |
         Response for declaring a table.

java/lance-namespace-apache-client/docs/CreateEmptyTableRequest.md

@@ -12,6 +12,7 @@ Request for creating an empty table.  **Deprecated**: Use `DeclareTableRequest`
 |**context** | **Map<String, String>** | Arbitrary context for a request as key-value pairs. How to use the context is custom to the specific implementation.  REST NAMESPACE ONLY Context entries are passed via HTTP headers using the naming convention `x-lance-ctx-<key>: <value>`. For example, a context entry `{\"trace_id\": \"abc123\"}` would be sent as the header `x-lance-ctx-trace_id: abc123`.  |  [optional] |
 |**id** | **List<String>** |  |  [optional] |
 |**location** | **String** | Optional storage location for the table. If not provided, the namespace implementation should determine the table location.  |  [optional] |
+|**vendCredentials** | **Boolean** | Whether to include vended credentials in the response `storage_options`. When true, the implementation should provide vended credentials for accessing storage. When not set, the implementation can decide whether to return vended credentials.  |  [optional] |
 
 
 

java/lance-namespace-apache-client/docs/DeclareTableRequest.md

@@ -12,6 +12,7 @@ Request for declaring a table.
 |**context** | **Map<String, String>** | Arbitrary context for a request as key-value pairs. How to use the context is custom to the specific implementation.  REST NAMESPACE ONLY Context entries are passed via HTTP headers using the naming convention `x-lance-ctx-<key>: <value>`. For example, a context entry `{\"trace_id\": \"abc123\"}` would be sent as the header `x-lance-ctx-trace_id: abc123`.  |  [optional] |
 |**id** | **List<String>** |  |  [optional] |
 |**location** | **String** | Optional storage location for the table. If not provided, the namespace implementation should determine the table location.  |  [optional] |
+|**vendCredentials** | **Boolean** | Whether to include vended credentials in the response `storage_options`. When true, the implementation should provide vended credentials for accessing storage. When not set, the implementation can decide whether to return vended credentials.  |  [optional] |
 
 
 

java/lance-namespace-apache-client/src/main/java/org/lance/namespace/model/CreateEmptyTableRequest.java

@@ -36,7 +36,8 @@
   CreateEmptyTableRequest.JSON_PROPERTY_IDENTITY,
   CreateEmptyTableRequest.JSON_PROPERTY_CONTEXT,
   CreateEmptyTableRequest.JSON_PROPERTY_ID,
-  CreateEmptyTableRequest.JSON_PROPERTY_LOCATION
+  CreateEmptyTableRequest.JSON_PROPERTY_LOCATION,
+  CreateEmptyTableRequest.JSON_PROPERTY_VEND_CREDENTIALS
 })
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
@@ -54,6 +55,9 @@ public class CreateEmptyTableRequest {
   public static final String JSON_PROPERTY_LOCATION = "location";
   @javax.annotation.Nullable private String location;
 
+  public static final String JSON_PROPERTY_VEND_CREDENTIALS = "vend_credentials";
+  @javax.annotation.Nullable private Boolean vendCredentials;
+
   public CreateEmptyTableRequest() {}
 
   public CreateEmptyTableRequest identity(@javax.annotation.Nullable Identity identity) {
@@ -173,6 +177,33 @@ public void setLocation(@javax.annotation.Nullable String location) {
     this.location = location;
   }
 
+  public CreateEmptyTableRequest vendCredentials(
+      @javax.annotation.Nullable Boolean vendCredentials) {
+
+    this.vendCredentials = vendCredentials;
+    return this;
+  }
+
+  /**
+   * Whether to include vended credentials in the response `storage_options`. When true,
+   * the implementation should provide vended credentials for accessing storage. When not set, the
+   * implementation can decide whether to return vended credentials.
+   *
+   * @return vendCredentials
+   */
+  @javax.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_VEND_CREDENTIALS)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public Boolean getVendCredentials() {
+    return vendCredentials;
+  }
+
+  @JsonProperty(JSON_PROPERTY_VEND_CREDENTIALS)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public void setVendCredentials(@javax.annotation.Nullable Boolean vendCredentials) {
+    this.vendCredentials = vendCredentials;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -185,12 +216,13 @@ public boolean equals(Object o) {
     return Objects.equals(this.identity, createEmptyTableRequest.identity)
         && Objects.equals(this.context, createEmptyTableRequest.context)
         && Objects.equals(this.id, createEmptyTableRequest.id)
-        && Objects.equals(this.location, createEmptyTableRequest.location);
+        && Objects.equals(this.location, createEmptyTableRequest.location)
+        && Objects.equals(this.vendCredentials, createEmptyTableRequest.vendCredentials);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(identity, context, id, location);
+    return Objects.hash(identity, context, id, location, vendCredentials);
   }
 
   @Override
@@ -201,6 +233,7 @@ public String toString() {
     sb.append("    context: ").append(toIndentedString(context)).append("\n");
     sb.append("    id: ").append(toIndentedString(id)).append("\n");
     sb.append("    location: ").append(toIndentedString(location)).append("\n");
+    sb.append("    vendCredentials: ").append(toIndentedString(vendCredentials)).append("\n");
     sb.append("}");
     return sb.toString();
   }
@@ -311,6 +344,22 @@ public String toUrlQueryString(String prefix) {
       }
     }
 
+    // add `vend_credentials` to the URL query string
+    if (getVendCredentials() != null) {
+      try {
+        joiner.add(
+            String.format(
+                "%svend_credentials%s=%s",
+                prefix,
+                suffix,
+                URLEncoder.encode(String.valueOf(getVendCredentials()), "UTF-8")
+                    .replaceAll("\\+", "%20")));
+      } catch (UnsupportedEncodingException e) {
+        // Should never happen, UTF-8 is always supported
+        throw new RuntimeException(e);
+      }
+    }
+
     return joiner.toString();
   }
 }

java/lance-namespace-apache-client/src/main/java/org/lance/namespace/model/DeclareTableRequest.java

@@ -31,7 +31,8 @@
   DeclareTableRequest.JSON_PROPERTY_IDENTITY,
   DeclareTableRequest.JSON_PROPERTY_CONTEXT,
   DeclareTableRequest.JSON_PROPERTY_ID,
-  DeclareTableRequest.JSON_PROPERTY_LOCATION
+  DeclareTableRequest.JSON_PROPERTY_LOCATION,
+  DeclareTableRequest.JSON_PROPERTY_VEND_CREDENTIALS
 })
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
@@ -49,6 +50,9 @@ public class DeclareTableRequest {
   public static final String JSON_PROPERTY_LOCATION = "location";
   @javax.annotation.Nullable private String location;
 
+  public static final String JSON_PROPERTY_VEND_CREDENTIALS = "vend_credentials";
+  @javax.annotation.Nullable private Boolean vendCredentials;
+
   public DeclareTableRequest() {}
 
   public DeclareTableRequest identity(@javax.annotation.Nullable Identity identity) {
@@ -168,6 +172,32 @@ public void setLocation(@javax.annotation.Nullable String location) {
     this.location = location;
   }
 
+  public DeclareTableRequest vendCredentials(@javax.annotation.Nullable Boolean vendCredentials) {
+
+    this.vendCredentials = vendCredentials;
+    return this;
+  }
+
+  /**
+   * Whether to include vended credentials in the response `storage_options`. When true,
+   * the implementation should provide vended credentials for accessing storage. When not set, the
+   * implementation can decide whether to return vended credentials.
+   *
+   * @return vendCredentials
+   */
+  @javax.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_VEND_CREDENTIALS)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public Boolean getVendCredentials() {
+    return vendCredentials;
+  }
+
+  @JsonProperty(JSON_PROPERTY_VEND_CREDENTIALS)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public void setVendCredentials(@javax.annotation.Nullable Boolean vendCredentials) {
+    this.vendCredentials = vendCredentials;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -180,12 +210,13 @@ public boolean equals(Object o) {
     return Objects.equals(this.identity, declareTableRequest.identity)
         && Objects.equals(this.context, declareTableRequest.context)
         && Objects.equals(this.id, declareTableRequest.id)
-        && Objects.equals(this.location, declareTableRequest.location);
+        && Objects.equals(this.location, declareTableRequest.location)
+        && Objects.equals(this.vendCredentials, declareTableRequest.vendCredentials);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(identity, context, id, location);
+    return Objects.hash(identity, context, id, location, vendCredentials);
   }
 
   @Override
@@ -196,6 +227,7 @@ public String toString() {
     sb.append("    context: ").append(toIndentedString(context)).append("\n");
     sb.append("    id: ").append(toIndentedString(id)).append("\n");
     sb.append("    location: ").append(toIndentedString(location)).append("\n");
+    sb.append("    vendCredentials: ").append(toIndentedString(vendCredentials)).append("\n");
     sb.append("}");
     return sb.toString();
   }
@@ -306,6 +338,22 @@ public String toUrlQueryString(String prefix) {
       }
     }
 
+    // add `vend_credentials` to the URL query string
+    if (getVendCredentials() != null) {
+      try {
+        joiner.add(
+            String.format(
+                "%svend_credentials%s=%s",
+                prefix,
+                suffix,
+                URLEncoder.encode(String.valueOf(getVendCredentials()), "UTF-8")
+                    .replaceAll("\\+", "%20")));
+      } catch (UnsupportedEncodingException e) {
+        // Should never happen, UTF-8 is always supported
+        throw new RuntimeException(e);
+      }
+    }
+
     return joiner.toString();
   }
 }

java/lance-namespace-springboot-server/src/main/java/org/lance/namespace/server/springboot/model/CreateEmptyTableRequest.java

@@ -49,6 +49,8 @@ public class CreateEmptyTableRequest {
 
   private String location;
 
+  private Boolean vendCredentials;
+
   public CreateEmptyTableRequest identity(Identity identity) {
     this.identity = identity;
     return this;
@@ -158,6 +160,32 @@ public void setLocation(String location) {
     this.location = location;
   }
 
+  public CreateEmptyTableRequest vendCredentials(Boolean vendCredentials) {
+    this.vendCredentials = vendCredentials;
+    return this;
+  }
+
+  /**
+   * Whether to include vended credentials in the response `storage_options`. When true, the
+   * implementation should provide vended credentials for accessing storage. When not set, the
+   * implementation can decide whether to return vended credentials.
+   *
+   * @return vendCredentials
+   */
+  @Schema(
+      name = "vend_credentials",
+      description =
+          "Whether to include vended credentials in the response `storage_options`. When true, the implementation should provide vended credentials for accessing storage. When not set, the implementation can decide whether to return vended credentials. ",
+      requiredMode = Schema.RequiredMode.NOT_REQUIRED)
+  @JsonProperty("vend_credentials")
+  public Boolean getVendCredentials() {
+    return vendCredentials;
+  }
+
+  public void setVendCredentials(Boolean vendCredentials) {
+    this.vendCredentials = vendCredentials;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -170,12 +198,13 @@ public boolean equals(Object o) {
     return Objects.equals(this.identity, createEmptyTableRequest.identity)
         && Objects.equals(this.context, createEmptyTableRequest.context)
         && Objects.equals(this.id, createEmptyTableRequest.id)
-        && Objects.equals(this.location, createEmptyTableRequest.location);
+        && Objects.equals(this.location, createEmptyTableRequest.location)
+        && Objects.equals(this.vendCredentials, createEmptyTableRequest.vendCredentials);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(identity, context, id, location);
+    return Objects.hash(identity, context, id, location, vendCredentials);
   }
 
   @Override
@@ -186,6 +215,7 @@ public String toString() {
     sb.append("    context: ").append(toIndentedString(context)).append("\n");
     sb.append("    id: ").append(toIndentedString(id)).append("\n");
     sb.append("    location: ").append(toIndentedString(location)).append("\n");
+    sb.append("    vendCredentials: ").append(toIndentedString(vendCredentials)).append("\n");
     sb.append("}");
     return sb.toString();
   }