box-node-sdk 10.0.1 → 10.2.0

package/src/managers/appItemAssociations.ts

@@ -54,7 +54,7 @@ export class GetFileAppItemAssociationsOptionals {
 export interface GetFileAppItemAssociationsOptionalsInput {
   readonly queryParams?: GetFileAppItemAssociationsQueryParams;
   readonly headers?: GetFileAppItemAssociationsHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class GetFolderAppItemAssociationsOptionals {
   readonly queryParams: GetFolderAppItemAssociationsQueryParams =
@@ -88,7 +88,7 @@ export class GetFolderAppItemAssociationsOptionals {
 export interface GetFolderAppItemAssociationsOptionalsInput {
   readonly queryParams?: GetFolderAppItemAssociationsQueryParams;
   readonly headers?: GetFolderAppItemAssociationsHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export interface GetFileAppItemAssociationsQueryParams {
   /**
@@ -122,11 +122,9 @@ export class GetFileAppItemAssociationsHeaders {
 export interface GetFileAppItemAssociationsHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export interface GetFolderAppItemAssociationsQueryParams {
   /**
@@ -160,11 +158,9 @@ export class GetFolderAppItemAssociationsHeaders {
 export interface GetFolderAppItemAssociationsHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class AppItemAssociationsManager {
   readonly auth?: Authentication;

package/src/managers/archives.ts

@@ -51,7 +51,7 @@ export class CreateArchiveV2025R0Optionals {
 }
 export interface CreateArchiveV2025R0OptionalsInput {
   readonly headers?: CreateArchiveV2025R0Headers;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class DeleteArchiveByIdV2025R0Optionals {
   readonly headers: DeleteArchiveByIdV2025R0Headers =
@@ -76,7 +76,41 @@ export class DeleteArchiveByIdV2025R0Optionals {
 }
 export interface DeleteArchiveByIdV2025R0OptionalsInput {
   readonly headers?: DeleteArchiveByIdV2025R0Headers;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
+}
+export class UpdateArchiveByIdV2025R0Optionals {
+  readonly requestBody: UpdateArchiveByIdV2025R0RequestBody =
+    {} satisfies UpdateArchiveByIdV2025R0RequestBody;
+  readonly headers: UpdateArchiveByIdV2025R0Headers =
+    new UpdateArchiveByIdV2025R0Headers({});
+  readonly cancellationToken?: CancellationToken = void 0;
+  constructor(
+    fields: Omit<
+      UpdateArchiveByIdV2025R0Optionals,
+      'requestBody' | 'headers' | 'cancellationToken'
+    > &
+      Partial<
+        Pick<
+          UpdateArchiveByIdV2025R0Optionals,
+          'requestBody' | 'headers' | 'cancellationToken'
+        >
+      >,
+  ) {
+    if (fields.requestBody !== undefined) {
+      this.requestBody = fields.requestBody;
+    }
+    if (fields.headers !== undefined) {
+      this.headers = fields.headers;
+    }
+    if (fields.cancellationToken !== undefined) {
+      this.cancellationToken = fields.cancellationToken;
+    }
+  }
+}
+export interface UpdateArchiveByIdV2025R0OptionalsInput {
+  readonly requestBody?: UpdateArchiveByIdV2025R0RequestBody;
+  readonly headers?: UpdateArchiveByIdV2025R0Headers;
+  readonly cancellationToken?: CancellationToken;
 }
 export interface GetArchivesV2025R0QueryParams {
   /**
@@ -115,16 +149,20 @@ export interface GetArchivesV2025R0HeadersInput {
   readonly boxVersion?: BoxVersionHeaderV2025R0;
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export interface CreateArchiveV2025R0RequestBody {
   /**
    * The name of the archive. */
   readonly name: string;
+  /**
+   * The description of the archive. */
+  readonly description?: string;
+  /**
+   * The ID of the storage policy that the archive is assigned to. */
+  readonly storagePolicyId?: string;
   readonly rawData?: SerializedData;
 }
 export class CreateArchiveV2025R0Headers {
@@ -155,11 +193,9 @@ export interface CreateArchiveV2025R0HeadersInput {
   readonly boxVersion?: BoxVersionHeaderV2025R0;
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class DeleteArchiveByIdV2025R0Headers {
   /**
@@ -194,11 +230,55 @@ export interface DeleteArchiveByIdV2025R0HeadersInput {
   readonly boxVersion?: BoxVersionHeaderV2025R0;
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
+}
+export interface UpdateArchiveByIdV2025R0RequestBody {
+  /**
+   * The name of the archive. */
+  readonly name?: string;
+  /**
+   * The description of the archive. */
+  readonly description?: string;
+  readonly rawData?: SerializedData;
+}
+export class UpdateArchiveByIdV2025R0Headers {
+  /**
+   * Version header. */
+  readonly boxVersion: BoxVersionHeaderV2025R0 =
+    '2025.0' as BoxVersionHeaderV2025R0;
+  /**
+   * Extra headers that will be included in the HTTP request. */
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  } = {};
+  constructor(
+    fields: Omit<
+      UpdateArchiveByIdV2025R0Headers,
+      'boxVersion' | 'extraHeaders'
+    > &
+      Partial<
+        Pick<UpdateArchiveByIdV2025R0Headers, 'boxVersion' | 'extraHeaders'>
+      >,
+  ) {
+    if (fields.boxVersion !== undefined) {
+      this.boxVersion = fields.boxVersion;
+    }
+    if (fields.extraHeaders !== undefined) {
+      this.extraHeaders = fields.extraHeaders;
+    }
+  }
+}
+export interface UpdateArchiveByIdV2025R0HeadersInput {
+  /**
+   * Version header. */
+  readonly boxVersion?: BoxVersionHeaderV2025R0;
+  /**
+   * Extra headers that will be included in the HTTP request. */
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class ArchivesManager {
   readonly auth?: Authentication;
@@ -210,6 +290,7 @@ export class ArchivesManager {
       | 'getArchivesV2025R0'
       | 'createArchiveV2025R0'
       | 'deleteArchiveByIdV2025R0'
+      | 'updateArchiveByIdV2025R0'
     > &
       Partial<Pick<ArchivesManager, 'networkSession'>>,
   ) {
@@ -364,6 +445,57 @@ export class ArchivesManager {
       );
     return void 0;
   }
+  /**
+     * Updates an archive.
+     *
+     * To learn more about the archive APIs, see the [Archive API Guide](g://archives).
+     * @param {string} archiveId The ID of the archive.
+    Example: "982312"
+     * @param {UpdateArchiveByIdV2025R0OptionalsInput} optionalsInput
+     * @returns {Promise<ArchiveV2025R0>}
+     */
+  async updateArchiveByIdV2025R0(
+    archiveId: string,
+    optionalsInput: UpdateArchiveByIdV2025R0OptionalsInput = {},
+  ): Promise<ArchiveV2025R0> {
+    const optionals: UpdateArchiveByIdV2025R0Optionals =
+      new UpdateArchiveByIdV2025R0Optionals({
+        requestBody: optionalsInput.requestBody,
+        headers: optionalsInput.headers,
+        cancellationToken: optionalsInput.cancellationToken,
+      });
+    const requestBody: any = optionals.requestBody;
+    const headers: any = optionals.headers;
+    const cancellationToken: any = optionals.cancellationToken;
+    const headersMap: {
+      readonly [key: string]: string;
+    } = prepareParams({
+      ...{ ['box-version']: toString(headers.boxVersion) as string },
+      ...headers.extraHeaders,
+    });
+    const response: FetchResponse =
+      await this.networkSession.networkClient.fetch(
+        new FetchOptions({
+          url: ''.concat(
+            this.networkSession.baseUrls.baseUrl,
+            '/2.0/archives/',
+            toString(archiveId) as string,
+          ) as string,
+          method: 'PUT',
+          headers: headersMap,
+          data: serializeUpdateArchiveByIdV2025R0RequestBody(requestBody),
+          contentType: 'application/json',
+          responseFormat: 'json' as ResponseFormat,
+          auth: this.auth,
+          networkSession: this.networkSession,
+          cancellationToken: cancellationToken,
+        }),
+      );
+    return {
+      ...deserializeArchiveV2025R0(response.data!),
+      rawData: response.data!,
+    };
+  }
 }
 export interface ArchivesManagerInput {
   readonly auth?: Authentication;
@@ -372,7 +504,11 @@ export interface ArchivesManagerInput {
 export function serializeCreateArchiveV2025R0RequestBody(
   val: CreateArchiveV2025R0RequestBody,
 ): SerializedData {
-  return { ['name']: val.name };
+  return {
+    ['name']: val.name,
+    ['description']: val.description,
+    ['storage_policy_id']: val.storagePolicyId,
+  };
 }
 export function deserializeCreateArchiveV2025R0RequestBody(
   val: SerializedData,
@@ -395,5 +531,61 @@ export function deserializeCreateArchiveV2025R0RequestBody(
     });
   }
   const name: string = val.name;
-  return { name: name } satisfies CreateArchiveV2025R0RequestBody;
+  if (!(val.description == void 0) && !sdIsString(val.description)) {
+    throw new BoxSdkError({
+      message:
+        'Expecting string for "description" of type "CreateArchiveV2025R0RequestBody"',
+    });
+  }
+  const description: undefined | string =
+    val.description == void 0 ? void 0 : val.description;
+  if (
+    !(val.storage_policy_id == void 0) &&
+    !sdIsString(val.storage_policy_id)
+  ) {
+    throw new BoxSdkError({
+      message:
+        'Expecting string for "storage_policy_id" of type "CreateArchiveV2025R0RequestBody"',
+    });
+  }
+  const storagePolicyId: undefined | string =
+    val.storage_policy_id == void 0 ? void 0 : val.storage_policy_id;
+  return {
+    name: name,
+    description: description,
+    storagePolicyId: storagePolicyId,
+  } satisfies CreateArchiveV2025R0RequestBody;
+}
+export function serializeUpdateArchiveByIdV2025R0RequestBody(
+  val: UpdateArchiveByIdV2025R0RequestBody,
+): SerializedData {
+  return { ['name']: val.name, ['description']: val.description };
+}
+export function deserializeUpdateArchiveByIdV2025R0RequestBody(
+  val: SerializedData,
+): UpdateArchiveByIdV2025R0RequestBody {
+  if (!sdIsMap(val)) {
+    throw new BoxSdkError({
+      message: 'Expecting a map for "UpdateArchiveByIdV2025R0RequestBody"',
+    });
+  }
+  if (!(val.name == void 0) && !sdIsString(val.name)) {
+    throw new BoxSdkError({
+      message:
+        'Expecting string for "name" of type "UpdateArchiveByIdV2025R0RequestBody"',
+    });
+  }
+  const name: undefined | string = val.name == void 0 ? void 0 : val.name;
+  if (!(val.description == void 0) && !sdIsString(val.description)) {
+    throw new BoxSdkError({
+      message:
+        'Expecting string for "description" of type "UpdateArchiveByIdV2025R0RequestBody"',
+    });
+  }
+  const description: undefined | string =
+    val.description == void 0 ? void 0 : val.description;
+  return {
+    name: name,
+    description: description,
+  } satisfies UpdateArchiveByIdV2025R0RequestBody;
 }

package/src/managers/authorization.ts

@@ -49,7 +49,7 @@ export class AuthorizeUserOptionals {
 }
 export interface AuthorizeUserOptionalsInput {
   readonly headers?: AuthorizeUserHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class RequestAccessTokenOptionals {
   readonly headers: RequestAccessTokenHeaders = new RequestAccessTokenHeaders(
@@ -72,7 +72,7 @@ export class RequestAccessTokenOptionals {
 }
 export interface RequestAccessTokenOptionalsInput {
   readonly headers?: RequestAccessTokenHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class RefreshAccessTokenOptionals {
   readonly headers: RefreshAccessTokenHeaders = new RefreshAccessTokenHeaders(
@@ -95,7 +95,7 @@ export class RefreshAccessTokenOptionals {
 }
 export interface RefreshAccessTokenOptionalsInput {
   readonly headers?: RefreshAccessTokenHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class RevokeAccessTokenOptionals {
   readonly headers: RevokeAccessTokenHeaders = new RevokeAccessTokenHeaders({});
@@ -116,7 +116,7 @@ export class RevokeAccessTokenOptionals {
 }
 export interface RevokeAccessTokenOptionalsInput {
   readonly headers?: RevokeAccessTokenHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export type AuthorizeUserQueryParamsResponseTypeField = 'code' | string;
 export interface AuthorizeUserQueryParams {
@@ -172,11 +172,9 @@ export class AuthorizeUserHeaders {
 export interface AuthorizeUserHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class RequestAccessTokenHeaders {
   /**
@@ -196,11 +194,9 @@ export class RequestAccessTokenHeaders {
 export interface RequestAccessTokenHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class RefreshAccessTokenHeaders {
   /**
@@ -220,11 +216,9 @@ export class RefreshAccessTokenHeaders {
 export interface RefreshAccessTokenHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class RevokeAccessTokenHeaders {
   /**
@@ -244,11 +238,9 @@ export class RevokeAccessTokenHeaders {
 export interface RevokeAccessTokenHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class AuthorizationManager {
   readonly auth?: Authentication;

package/src/managers/avatars.ts

@@ -40,7 +40,7 @@ export class GetUserAvatarOptionals {
 }
 export interface GetUserAvatarOptionalsInput {
   readonly headers?: GetUserAvatarHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class CreateUserAvatarOptionals {
   readonly headers: CreateUserAvatarHeaders = new CreateUserAvatarHeaders({});
@@ -59,7 +59,7 @@ export class CreateUserAvatarOptionals {
 }
 export interface CreateUserAvatarOptionalsInput {
   readonly headers?: CreateUserAvatarHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class DeleteUserAvatarOptionals {
   readonly headers: DeleteUserAvatarHeaders = new DeleteUserAvatarHeaders({});
@@ -78,7 +78,7 @@ export class DeleteUserAvatarOptionals {
 }
 export interface DeleteUserAvatarOptionalsInput {
   readonly headers?: DeleteUserAvatarHeaders;
-  readonly cancellationToken?: undefined | CancellationToken;
+  readonly cancellationToken?: CancellationToken;
 }
 export class GetUserAvatarHeaders {
   /**
@@ -98,11 +98,9 @@ export class GetUserAvatarHeaders {
 export interface GetUserAvatarHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export interface CreateUserAvatarRequestBody {
   /**
@@ -131,11 +129,9 @@ export class CreateUserAvatarHeaders {
 export interface CreateUserAvatarHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class DeleteUserAvatarHeaders {
   /**
@@ -155,11 +151,9 @@ export class DeleteUserAvatarHeaders {
 export interface DeleteUserAvatarHeadersInput {
   /**
    * Extra headers that will be included in the HTTP request. */
-  readonly extraHeaders?:
-    | undefined
-    | {
-        readonly [key: string]: undefined | string;
-      };
+  readonly extraHeaders?: {
+    readonly [key: string]: undefined | string;
+  };
 }
 export class AvatarsManager {
   readonly auth?: Authentication;