deboa 1.0.0

package/dist/esm/types/Priority.js

@@ -0,0 +1 @@
+export { };

package/dist/esm/types/Section.js

@@ -0,0 +1 @@
+export { };

package/dist/esm/types/classes/Deboa.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Some useful references:
+ *
+ * https://radagast.ca/linux/anatomy_of_a_deb_file.html
+ * https://pubs.opengroup.org/onlinepubs/9699919799/utilities/ar.html
+ * https://www.unix.com/man-page/opensolaris/3head/ar.h/
+ */
+import type { IDeboa } from '../types';
+/**
+ * @return IDeboa
+ */
+declare class Deboa implements IDeboa {
+    #private;
+    /** See {@link IDeboa.additionalTarEntries} */
+    additionalTarEntries: IDeboa['additionalTarEntries'];
+    /** See {@link IDeboa.beforeCreateDesktopEntry} */
+    beforeCreateDesktopEntry: IDeboa['beforeCreateDesktopEntry'];
+    /** See {@link IDeboa.beforePackage} */
+    beforePackage: IDeboa['beforePackage'];
+    /** See {@link IDeboa.controlFileOptions} */
+    controlFileOptions: IDeboa['controlFileOptions'];
+    /** See {@link IDeboa.icon} */
+    icon: IDeboa['icon'];
+    /** See {@link IDeboa.modifyTarHeader} */
+    modifyTarHeader: IDeboa['modifyTarHeader'];
+    /** See {@link IDeboa.sourceDir} */
+    sourceDir: IDeboa['sourceDir'];
+    /** See {@link IDeboa.tarballFormat} */
+    tarballFormat: IDeboa['tarballFormat'];
+    /** See {@link IDeboa.targetDir} */
+    targetDir: IDeboa['targetDir'];
+    constructor(options: IDeboa);
+    /**
+     * Creates the .deb file.
+     * @return {Promise<string>} outputFile - Absolute path to the generated .deb
+     */
+    package(): Promise<string>;
+    /**
+     * Checks if the values provided to the hook options are file paths
+     * and imports the actual functions from them if necessary.
+     */
+    loadHooks(): Promise<void>;
+}
+export { Deboa };

package/dist/esm/types/classes/DeboaFromFile.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="node" />
+import type { ReadStream } from 'fs';
+import type { IWriteToArchive, IDeboaFromFile } from '../types';
+/**
+ * @return IDeboaFromFile
+ */
+export declare class DeboaFromFile implements IDeboaFromFile {
+    #private;
+    isARFile: IDeboaFromFile['isARFile'];
+    outputFile: IDeboaFromFile['outputFile'];
+    writeStream: IWriteToArchive['writeStream'];
+    constructor(options: IDeboaFromFile);
+    /**
+     * Creates a ReadStream from the input file.
+     * Useful if you need access to the underlying stream.
+     */
+    createReadStream(inputFile: string): Promise<ReadStream>;
+    writeFromStream(readStream: ReadStream): Promise<void>;
+    /**
+     * Writes the input file to the .deb.
+     */
+    writeFromFile(inputFile: string): Promise<void>;
+}

package/dist/esm/types/index.d.ts

@@ -0,0 +1,4 @@
+import { Deboa } from './classes/Deboa';
+import { DeboaFromFile } from './classes/DeboaFromFile';
+export { Deboa, DeboaFromFile };
+export * from './types';

package/dist/esm/types/index.js

@@ -0,0 +1,10 @@
+export * from './IAddTarEntriesParams';
+export * from './IControlFileOptions';
+export * from './IDeboa';
+export * from './IDeboaFromFile';
+export * from './INormalizeOptionsLength';
+export * from './IWriteFileFromLinesArgs';
+export * from './IWriteToArchive';
+export * from './MaintainerScript';
+export * from './Priority';
+export * from './Section';

package/dist/esm/types/types/IAddTarEntriesParams.d.ts

@@ -0,0 +1,5 @@
+import { Headers as TarStreamHeader, Pack } from 'tar-stream';
+export interface IAddTarEntriesParams {
+    entries: TarStreamHeader[];
+    pack: Pack;
+}

package/dist/esm/types/types/IControlFileOptions.d.ts

@@ -0,0 +1,130 @@
+import { MaintainerScript } from './MaintainerScript';
+import { Priority } from './Priority';
+import { Section } from './Section';
+/**
+ * The descriptions are mostly just shameless copies from the following docs:
+ *
+ * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html}
+ *
+ * {@link https://www.debian.org/doc/debian-policy/ch-maintainerscripts.html}
+ *
+ * {@link https://www.debian.org/doc/debian-policy/ch-relationships.html}
+ */
+export interface IControlFileOptions {
+    /**
+     * Target architecture. Defaults to the current system's architecture.
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-architecture}
+     */
+    architecture?: string;
+    /**
+     * {@link https://www.debian.org/doc/debian-policy/ch-relationships.html#s-built-using}
+     */
+    builtUsing?: string;
+    /**
+     * {@link https://www.debian.org/doc/debian-policy/ch-relationships.html}
+     */
+    conflicts?: string[];
+    /**
+     * {@link https://www.debian.org/doc/debian-policy/ch-relationships.html}
+     */
+    depends?: string[];
+    /**
+     * If set to `yes`, then the package management system will refuse to
+     * remove
+     * the package (upgrading and replacing it is still possible). The other
+     * possible value is `no`, which is the same as not having the field at
+     * all.
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-essential}
+     */
+    essential?: 'yes' | 'no';
+    /**
+     * Extended description for the package. Defaults to the value provided for
+     * the `shortDescription` option.
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-description}
+     */
+    extendedDescription?: string;
+    /**
+     * URL for this package.
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-homepage}
+     */
+    homepage?: string;
+    /**
+     * The package maintainer's name and email address. The name must come
+     * first, then the email address inside angle brackets. **This field is
+     * mandatory.**
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-maintainer}
+     */
+    maintainer: string;
+    /**
+     * Path to the scripts you want to execute before/after the system
+     * installs/upgrades/removes your package. There are quite a few rules
+     * here,
+     * so please check
+     * {@link
+     * https://www.debian.org/doc/debian-policy/ch-maintainerscripts.html} for
+     * details.
+     */
+    maintainerScripts?: Partial<Record<MaintainerScript, string>>;
+    /**
+     * Binary package name. Must be at least two characters long and must start
+     * with an alphanumeric character. Only lower case letters (a-z), digits
+     * (0-9), plus (+) and minus (-) signs, and periods (.) are allowed. **This
+     * field is mandatory.**
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-source}
+     */
+    packageName: string;
+    /**
+     * See {@link
+     * https://www.debian.org/doc/debian-policy/ch-relationships.html} for
+     * details.
+     */
+    preDepends?: string[];
+    /**
+     * This field represents how important it is that the user have the package
+     * installed. Defaults to `optional`.
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-priority}
+     */
+    priority?: Priority;
+    /**
+     * {@link https://www.debian.org/doc/debian-policy/ch-relationships.html}
+     */
+    recommends?: string[];
+    /**
+     * This field specifies an application area into which the package has been
+     * classified. This is a recommended field.
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-section}
+     */
+    section?: Section;
+    /**
+     * Short, single-line synopsys for the package. Usually ~80 characters.
+     * **This field is mandatory.**
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-description}
+     */
+    shortDescription: string;
+    /**
+     * Source package name.
+     *
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-source}
+     */
+    source?: string;
+    /**
+     * {@link https://www.debian.org/doc/debian-policy/ch-relationships.html}
+     */
+    suggests?: string[];
+    /**
+     * Version number of the package in the
+     * `[epoch:]upstream_version[-debian_revision]` format. See
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-version}
+     * for details. **This field is mandatory.**
+     */
+    version: string;
+}

package/dist/esm/types/types/IDeboa.d.ts

@@ -0,0 +1,123 @@
+import type { Headers as TarFSHeader } from 'tar-fs';
+import type { Headers as TarStreamHeader } from 'tar-stream';
+import { IControlFileOptions } from './IControlFileOptions';
+/**
+ * @property {IDeboa["additionalTarEntries"]} [additionalTarEntries] -
+ *  Additional entries to be added to the .tar archive. This is useful for
+ *  creating symlinks on Windows. See the [Headers]{@link TarStreamHeader}
+ *  interface from tar-stream for more details. Optional.
+ *
+ *
+ * @property {IDeboa["beforeCreateDesktopEntry"]} [beforeCreateDesktopEntry] -
+ *  Runs before the desktop entry file is created, allowing you to add more
+ *  entries or modify the default entries if necessary. This can be a function
+ *  or a path to a file that has a function as its default export. Check
+ *  {@link https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html}
+ *  for more details. Optional.
+ *
+ *
+ * @property {IDeboa["beforePackage"]} [beforePackage] -
+ *  Runs after the control file, maintainer scripts and sourceDir contents
+ *  are copied to the temporary directory and before they're packaged. Receives
+ *  the temporary directory path as an argument. This can be a function or a
+ *  path to a file that has a function as its default export. Optional.
+ *
+ *
+ * @property {IDeboa["controlFileOptions"]} controlFileOptions -
+ *  Control file fields.
+ *  {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html}
+ *
+ *
+ * @property {IDeboa["icon"]} [icon] -
+ *  Path to the image you want to use as your app icon. It is copied to
+ *  /usr/share/pixmaps. Optional.
+ *
+ *
+ * @property {IDeboa["modifyTarHeader"]} [modifyTarHeader] -
+ *  This callback makes it possible to modify file headers before they're
+ *  written to the .tar archive, which is useful for setting permissions.
+ *  This can be a function or a path to a file that has a function as its
+ *  default export. See the [Headers]{@link TarFSHeader} interface from tar-fs
+ *  and {@link https://github.com/mafintosh/tar-fs/blob/7ec11cb27f93948193770f32b4d820e2e7195715/README.md}
+ *  for more details. Optional.
+ *
+ *
+ * @property {IDeboa["sourceDir"]} sourceDir -
+ *  Location of the files you want to package. **This field is mandatory.**
+ *
+ *
+ * @property {IDeboa["tarballFormat"]} [tarballFormat] -
+ *  Sets the format used for storing the files. This impacts the build time
+ *  and .deb output size. Defaults to `tar.gz`.
+ *
+ *  As a rule of thumb, you can expect the following from each format:
+ *  - `tar` (no compression): lowest resources usage, faster build time, largest .deb size
+ *  - `tar.gz` (gzip compression using zlib): low resources usage, good build time, good .deb size
+ *  - `tar.xz` (xz compression using lzma-native): high resources usage, slowest build time, smallest .deb size
+ *
+ *
+ * @property {IDeboa["targetDir"]} targetDir -
+ *  Directory where your .deb file will be copied to.
+ *  **This field is mandatory.**
+ */
+export interface IDeboa {
+    /**
+     * Additional entries to be added to the .tar archive. This is useful for
+     * creating symlinks on Windows. See the [Headers]{@link TarStreamHeader}
+     * interface from tar-stream for more details. Optional.
+     */
+    additionalTarEntries?: TarStreamHeader[];
+    /**
+     * Runs before the desktop entry file is created, allowing you to add more
+     * entries or modify the default entries if necessary. This can be a function
+     * or a path to a file that has a function as its default export. Check
+     * {@link https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html}
+     * for more details. Optional.
+     */
+    beforeCreateDesktopEntry?: string | (<T extends Record<string, string>>(desktopEntries: T) => Promise<T> | T);
+    /**
+     * Runs after the control file, maintainer scripts and sourceDir contents
+     * are copied to the temporary directory and before they're packaged. Receives
+     * the temporary directory path as an argument. This can be a function or a
+     * path to a file that has a function as its default export. Optional.
+     */
+    beforePackage?: string | ((tempDir: string) => Promise<void> | void);
+    /**
+     * Control file fields.
+     * {@link https://www.debian.org/doc/debian-policy/ch-controlfields.html}
+     */
+    controlFileOptions: IControlFileOptions;
+    /**
+     * Path to the image you want to use as your app icon. It is copied to
+     * /usr/share/pixmaps. Optional.
+     */
+    icon?: string;
+    /**
+     * This callback makes it possible to modify file headers before they're
+     * written to the .tar archive, which is useful for setting permissions.
+     * This can be a function or a path to a file that has a function as its
+     * default export. See the [Headers]{@link TarFSHeader} interface from tar-fs
+     * and {@link https://github.com/mafintosh/tar-fs/blob/7ec11cb27f93948193770f32b4d820e2e7195715/README.md}
+     * for more details. Optional.
+     */
+    modifyTarHeader?: string | ((header: TarFSHeader) => TarFSHeader);
+    /**
+     * Location of the files you want to package. **This field is mandatory.**
+     */
+    sourceDir: string;
+    /**
+     * Sets the format used for storing the files. This impacts the build time
+     * and .deb output size. Defaults to `tar.gz`.
+     *
+     * As a rule of thumb, you can expect the following from each format:
+     * - `tar` (no compression): lowest resources usage, faster build time, largest .deb size
+     * - `tar.gz` (gzip compression using zlib): low resources usage, good build time, good .deb size
+     * - `tar.xz` (xz compression using lzma-native): high resources usage, slowest build time, smallest .deb size
+     */
+    tarballFormat?: 'tar' | 'tar.gz' | 'tar.xz';
+    /**
+     * Directory where your .deb file will be copied to.
+     * **This field is mandatory.**
+     */
+    targetDir: string;
+}

package/dist/esm/types/types/IDeboaFromFile.d.ts

@@ -0,0 +1,8 @@
+import { IWriteToArchive } from '../types';
+/**
+ * @property {string} outputFile - Path to the output file.
+ */
+export interface IDeboaFromFile extends Pick<IWriteToArchive, 'isARFile'> {
+    /** Path to the output file. */
+    outputFile: string;
+}

package/dist/esm/types/types/INormalizeOptionsLength.d.ts

@@ -0,0 +1,8 @@
+export interface INormalizeOptionLength {
+    fileMode?: string | number;
+    fileName: string;
+    fileSize: string | number;
+    groupID?: string | number;
+    ownerID?: string | number;
+    timestamp?: string | number;
+}

package/dist/esm/types/types/IWriteFileFromLinesArgs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @property {string} filePath - Path to the output file.
+ * @property {string[]} lines - Lines to be written.
+ */
+export interface IWriteFileFromLinesArgs {
+    /** Path to the output file. */
+    filePath: string;
+    /** Lines to be written. */
+    lines: string[];
+}

package/dist/esm/types/types/IWriteToArchive.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { ReadStream, WriteStream } from 'fs';
+/**
+ * @property {Buffer} header - AR header.
+ * @property {boolean} [isARFile] - If true, the .deb-specific sections won't be added to the file.
+ * @property {readStream} readStream - ReadStream from the input file.
+ * @property {WriteStream} writeStream - WriteStream to the output file.
+ */
+export interface IWriteToArchive {
+    /** AR header. */
+    header: Buffer;
+    /** If true, the .deb-specific sections won't be added to the file. */
+    isARFile?: boolean;
+    /** ReadStream from the input file. */
+    readStream: ReadStream;
+    /** WriteStream to the output file. */
+    writeStream: WriteStream;
+}

package/dist/esm/types/types/MaintainerScript.d.ts

@@ -0,0 +1 @@
+export declare type MaintainerScript = 'preinst' | 'postinst' | 'prerm' | 'postrm';

package/dist/esm/types/types/Priority.d.ts

@@ -0,0 +1 @@
+export declare type Priority = 'required' | 'important' | 'standard' | 'optional';

package/dist/esm/types/types/Section.d.ts

@@ -0,0 +1 @@
+export declare type Section = 'admin' | 'cli-mono' | 'comm' | 'database' | 'debug' | 'devel' | 'doc' | 'editors' | 'education' | 'electronics' | 'embedded' | 'fonts' | 'games' | 'gnome' | 'gnu-r' | 'gnustep' | 'graphics' | 'hamradio' | 'haskell' | 'httpd' | 'interpreters' | 'introspection' | 'java' | 'javascript' | 'kde' | 'kernel' | 'libdevel' | 'libs' | 'lisp' | 'localization' | 'mail' | 'math' | 'metapackages' | 'misc' | 'net' | 'news' | 'ocaml' | 'oldlibs' | 'otherosfs' | 'perl' | 'php' | 'python' | 'ruby' | 'rust' | 'science' | 'shells' | 'sound' | 'tasks' | 'tex' | 'text' | 'utils' | 'vcs' | 'video' | 'web' | 'x11' | 'xfce' | 'zope' | undefined;

package/dist/esm/types/types/index.d.ts

@@ -0,0 +1,10 @@
+export * from './IAddTarEntriesParams';
+export * from './IControlFileOptions';
+export * from './IDeboa';
+export * from './IDeboaFromFile';
+export * from './INormalizeOptionsLength';
+export * from './IWriteFileFromLinesArgs';
+export * from './IWriteToArchive';
+export * from './MaintainerScript';
+export * from './Priority';
+export * from './Section';

package/dist/esm/types/utils/addTarEntries.d.ts

@@ -0,0 +1,5 @@
+import { IAddTarEntriesParams } from '../types';
+/**
+ * Adds entries to the .tar archive after all the files are packed.
+ */
+export declare function addTarEntries({ entries, pack, }: IAddTarEntriesParams): Promise<void>;

package/dist/esm/types/utils/createFileHeader.d.ts

@@ -0,0 +1,2 @@
+import { INormalizeOptionLength } from '../types';
+export declare function createFileHeader(options: INormalizeOptionLength): string;

package/dist/esm/types/utils/writeFileFromLines.d.ts

@@ -0,0 +1,5 @@
+import { IWriteFileFromLinesArgs } from '../types';
+/**
+ * Creates a file from a string array.
+ */
+export declare function writeFileFromLines({ filePath, lines, }: IWriteFileFromLinesArgs): Promise<void>;

package/dist/esm/types/utils/writeToArchive.d.ts

@@ -0,0 +1,5 @@
+import { IWriteToArchive } from '../types';
+/**
+ *
+ */
+export declare function writeToArchive({ header, isARFile, readStream, writeStream, }: IWriteToArchive): Promise<void>;

package/dist/esm/utils/addTarEntries.js

@@ -0,0 +1,19 @@
+/**
+ * Adds entries to the .tar archive after all the files are packed.
+ */ export async function addTarEntries({ entries , pack  }) {
+    const entriesCopy = entries.slice();
+    return new Promise((resolve, reject)=>{
+        function packEntry(err) {
+            if (err) {
+                reject(err);
+            }
+            if (entriesCopy.length === 0) {
+                return resolve();
+            }
+            const entry = entriesCopy.shift();
+            pack.entry(entry, packEntry);
+        }
+        packEntry();
+        pack.on('error', reject);
+    });
+}

package/dist/esm/utils/createFileHeader.js

@@ -0,0 +1,53 @@
+export function createFileHeader(options) {
+    const { fileName , ...numericOptions } = options;
+    const { timestamp =String(Math.trunc(new Date().getTime() / 1000)) , ownerID ='0' , groupID ='0' , fileMode ='100644' , fileSize ,  } = numericOptions;
+    if (!fileName) {
+        throw new Error('filename is required');
+    }
+    const maxLengthMap = {
+        fileName: {
+            maxLength: 16,
+            value: fileName
+        },
+        timestamp: {
+            maxLength: 12,
+            value: String(timestamp)
+        },
+        ownerID: {
+            maxLength: 6,
+            value: String(ownerID)
+        },
+        groupID: {
+            maxLength: 6,
+            value: String(groupID)
+        },
+        fileMode: {
+            maxLength: 8,
+            value: String(fileMode)
+        },
+        fileSize: {
+            maxLength: 10,
+            value: String(fileSize)
+        }
+    };
+    const paddedFields = Object.entries(maxLengthMap).map(([optionName, { maxLength , value  }])=>{
+        // checks if the numeric options are correct
+        if (optionName in numericOptions) {
+            const asNumber = +value;
+            if (Number.isNaN(asNumber)) {
+                throw new Error(`The \`${optionName}\` option must be a numeric value`);
+            }
+            if (!Number.isInteger(asNumber)) {
+                throw new Error(`The \`${optionName}\` option must be a integer`);
+            }
+        }
+        // checks if the option length is correct
+        if (value.length > maxLength) {
+            throw new Error(`The \`${optionName}\` option must be at most ${maxLength} characters`);
+        }
+        return value.padEnd(maxLength);
+    });
+    // ending sequence
+    paddedFields.push('`\n');
+    return paddedFields.join('');
+}

package/dist/esm/utils/writeFileFromLines.js

@@ -0,0 +1,7 @@
+import { promises as fs } from 'fs';
+/**
+ * Creates a file from a string array.
+ */ export async function writeFileFromLines({ filePath , lines  }) {
+    const joined = lines.join('\n') + '\n';
+    await fs.writeFile(filePath, joined);
+}

package/dist/esm/utils/writeToArchive.js

@@ -0,0 +1,72 @@
+import { createFileHeader } from './createFileHeader';
+/**
+ * Writes the .ar archive signature. If it's a .deb file,
+ * also writes the `debian-control` file and its header.
+ */ async function writeArchiveHeader({ writeStream , isARFile =false  }) {
+    return new Promise((resolve, reject)=>{
+        const arArchiveSignature = '!<arch>\n';
+        const header = [
+            arArchiveSignature
+        ];
+        // this part is .deb-specific, so we don't need it in plain .ar files
+        if (!isARFile) {
+            const debianBinaryFile = '2.0\n';
+            const debianBinaryIdentifier = createFileHeader({
+                fileName: 'debian-binary',
+                fileSize: debianBinaryFile.length
+            });
+            header.push(debianBinaryIdentifier, debianBinaryFile);
+        }
+        writeStream.write(Buffer.concat(header.map(Buffer.from)), (headerErr)=>{
+            if (headerErr) {
+                reject(`Error writing the archive header: ${headerErr}`);
+            }
+            resolve();
+        });
+    });
+}
+/**
+ *
+ */ export async function writeToArchive({ header , isARFile =false , readStream , writeStream  }) {
+    const shouldWriteArchiveHeader = writeStream.bytesWritten === 0;
+    if (shouldWriteArchiveHeader) {
+        console.log('Writing the archive header...\n');
+        await writeArchiveHeader({
+            writeStream,
+            isARFile
+        });
+        console.log('Archive header successfully written\n');
+    }
+    return new Promise((resolve, reject)=>{
+        const fileNameIdentifier = header.toString('utf-8').slice(0, 16).trim();
+        writeStream.write(header, (identifierErr)=>{
+            console.log(`Writing the identifier header for ${fileNameIdentifier}...\n`);
+            if (identifierErr) {
+                reject(`Error writing the identifier header for ${fileNameIdentifier}: ${identifierErr}`);
+            }
+            console.log(`Identifier header for ${fileNameIdentifier} successfully written\n`);
+            const initialBytesWritten = writeStream.bytesWritten;
+            console.log(`Writing file ${fileNameIdentifier}...\n`);
+            readStream.on('error', (fileError)=>reject(`Error writing file ${fileNameIdentifier}: ${fileError}`));
+            readStream.pipe(writeStream, {
+                end: false
+            });
+            readStream.on('end', ()=>{
+                const readStreamSize = writeStream.bytesWritten - initialBytesWritten;
+                const shouldWritePaddingByte = readStreamSize % 2 !== 0;
+                if (!shouldWritePaddingByte) {
+                    console.log(`File ${fileNameIdentifier} successfully written\n`);
+                    return resolve();
+                }
+                console.log(`Writing padding byte for ${fileNameIdentifier}...\n`);
+                writeStream.write(Buffer.from('\n'), (paddingError)=>{
+                    if (paddingError) {
+                        reject(`Error writing padding byte for ${fileNameIdentifier}: ${identifierErr}`);
+                    }
+                    console.log(`File ${fileNameIdentifier} successfully written\n`);
+                    return resolve();
+                });
+            });
+        });
+    });
+}