@zip.js/zip.js 2.8.44 → 2.8.45

package/index.d.cts

@@ -1292,6 +1292,30 @@ export interface EntryExtraFieldAES extends EntryExtraField {
    */
   originalCompressionMethod?: number;
 }
+/**
+ * Represents a Unix extra field record storing timestamps: the Info-ZIP Unix type 1 extra field (0x5855),
+ * written notably by macOS Archive Utility and `ditto`, or the PKWARE Unix extra field (0x000d). Both store
+ * the last access/modification dates as 32-bit Unix times, followed by the optional uid/gid in the local
+ * file header.
+ */
+export interface EntryExtraFieldUnixDates extends EntryExtraField {
+  /**
+   * The last access date.
+   */
+  lastAccessDate?: Date;
+  /**
+   * The last modification date.
+   */
+  lastModDate?: Date;
+  /**
+   * The Unix user id.
+   */
+  uid?: number;
+  /**
+   * The Unix group id.
+   */
+  gid?: number;
+}
 /**
  * Represents a Unicode path or comment extra field record of an entry.
  */
@@ -1387,6 +1411,14 @@ export interface LocalDirectory {
    * The Info-ZIP Unix extra field.
    */
   extraFieldInfoZip?: EntryExtraField;
+  /**
+   * The Info-ZIP Unix type 1 extra field (0x5855).
+   */
+  extraFieldUnixType1?: EntryExtraFieldUnixDates;
+  /**
+   * The PKWARE Unix extra field (0x000d).
+   */
+  extraFieldPkwareUnix?: EntryExtraFieldUnixDates;
   /**
    * The extended timestamp extra field.
    */
@@ -1660,6 +1692,14 @@ export interface EntryMetaData {
    * The Info-ZIP Unix extra field.
    */
   extraFieldInfoZip?: EntryExtraField;
+  /**
+   * The Info-ZIP Unix type 1 extra field (0x5855).
+   */
+  extraFieldUnixType1?: EntryExtraFieldUnixDates;
+  /**
+   * The PKWARE Unix extra field (0x000d).
+   */
+  extraFieldPkwareUnix?: EntryExtraFieldUnixDates;
   /**
    * The extended timestamp extra field.
    */
@@ -1968,15 +2008,23 @@ export interface ZipWriterAddDataOptions
    */
   comment?: string;
   /**
-   * The extra field of the entry.
+   * The extra field of the entry, written in the local file header and the central directory.
    */
   extraField?: Map<number, Uint8Array>;
+  /**
+   * The extra field of the entry written only in the local file header.
+   */
+  localExtraField?: Map<number, Uint8Array>;
   /**
    * The uncompressed size of the entry. This option is ignored if the {@link ZipWriterConstructorOptions#passThrough} option is not set to `true`.
    */
   uncompressedSize?: number;
   /**
    * The CRC-32 checksum of the content. This option is ignored if the {@link ZipWriterConstructorOptions#passThrough} option is not set to `true`.
+   *
+   * When the entry is AES-encrypted (see {@link ZipWriterConstructorOptions#encrypted}), setting this option marks the entry as AE-1
+   * and stores the checksum in the entry headers, e.g. when copying an AE-1 entry read with the
+   * {@link ZipReaderOptions#passThrough} option. Otherwise, the entry is marked as AE-2 and the checksum fields are set to 0.
    */
   crc32?: number;
   /**

package/index.d.ts

@@ -1292,6 +1292,30 @@ export interface EntryExtraFieldAES extends EntryExtraField {
    */
   originalCompressionMethod?: number;
 }
+/**
+ * Represents a Unix extra field record storing timestamps: the Info-ZIP Unix type 1 extra field (0x5855),
+ * written notably by macOS Archive Utility and `ditto`, or the PKWARE Unix extra field (0x000d). Both store
+ * the last access/modification dates as 32-bit Unix times, followed by the optional uid/gid in the local
+ * file header.
+ */
+export interface EntryExtraFieldUnixDates extends EntryExtraField {
+  /**
+   * The last access date.
+   */
+  lastAccessDate?: Date;
+  /**
+   * The last modification date.
+   */
+  lastModDate?: Date;
+  /**
+   * The Unix user id.
+   */
+  uid?: number;
+  /**
+   * The Unix group id.
+   */
+  gid?: number;
+}
 /**
  * Represents a Unicode path or comment extra field record of an entry.
  */
@@ -1387,6 +1411,14 @@ export interface LocalDirectory {
    * The Info-ZIP Unix extra field.
    */
   extraFieldInfoZip?: EntryExtraField;
+  /**
+   * The Info-ZIP Unix type 1 extra field (0x5855).
+   */
+  extraFieldUnixType1?: EntryExtraFieldUnixDates;
+  /**
+   * The PKWARE Unix extra field (0x000d).
+   */
+  extraFieldPkwareUnix?: EntryExtraFieldUnixDates;
   /**
    * The extended timestamp extra field.
    */
@@ -1660,6 +1692,14 @@ export interface EntryMetaData {
    * The Info-ZIP Unix extra field.
    */
   extraFieldInfoZip?: EntryExtraField;
+  /**
+   * The Info-ZIP Unix type 1 extra field (0x5855).
+   */
+  extraFieldUnixType1?: EntryExtraFieldUnixDates;
+  /**
+   * The PKWARE Unix extra field (0x000d).
+   */
+  extraFieldPkwareUnix?: EntryExtraFieldUnixDates;
   /**
    * The extended timestamp extra field.
    */
@@ -1968,15 +2008,23 @@ export interface ZipWriterAddDataOptions
    */
   comment?: string;
   /**
-   * The extra field of the entry.
+   * The extra field of the entry, written in the local file header and the central directory.
    */
   extraField?: Map<number, Uint8Array>;
+  /**
+   * The extra field of the entry written only in the local file header.
+   */
+  localExtraField?: Map<number, Uint8Array>;
   /**
    * The uncompressed size of the entry. This option is ignored if the {@link ZipWriterConstructorOptions#passThrough} option is not set to `true`.
    */
   uncompressedSize?: number;
   /**
    * The CRC-32 checksum of the content. This option is ignored if the {@link ZipWriterConstructorOptions#passThrough} option is not set to `true`.
+   *
+   * When the entry is AES-encrypted (see {@link ZipWriterConstructorOptions#encrypted}), setting this option marks the entry as AE-1
+   * and stores the checksum in the entry headers, e.g. when copying an AE-1 entry read with the
+   * {@link ZipReaderOptions#passThrough} option. Otherwise, the entry is marked as AE-2 and the checksum fields are set to 0.
    */
   crc32?: number;
   /**