@opsimathically/vlc_playlist_generator 0.0.1

package/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Jason Medeiros
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# VLC Playlist Generator
+
+I was spending too much time every day trying to figure out what background noise to have playing while I worked, so I created this project which will just scan a directory, select some random content and shove it in a m3u playlist file. That way you can just queue up whatever random nonsense, let it play, and get to work.
+
+```bash
+# You can run it as a command line bin.
+npx tsx ./src/index.ts --source-search-directory /home/your_user/Downloads/ \
+    --output-playlist-file-destination /tmp/my_playlist.m3u \
+    --number-of-results 25
+```
+
+```typescript
+// You can import the class as a typescript module.
+import { VLCPlaylistGenerator } from '@opsimathically/vlc_playlist_generator';
+
+// create class handle
+const vlc_playlist_generator = new VLCPlaylistGenerator();
+
+// generate playlist
+await vlc_playlist_generator.createPlaylist({
+  number_of_results: 100,
+  output_playlist_file_destination: '/tmp/whatever_random_playlistname.m3u',
+  source_search_directory: '/home/your_user/Downloads/'
+});
+```
+
+## Install
+
+```bash
+npm install @opsimathically/vlc_playlist_generator
+```
+
+## Building from source
+
+This package is intended to be run via npm, but if you'd like to build from source,
+clone this repo, enter directory, and run `npm install` for dev dependencies, then run
+`npm run build`.
+
+## Reference
+
+[See API Reference for documentation](https://github.com/opsimathically/vlc_playlist_generator/tree/main/docs)

package/dist/index.d.mts

@@ -0,0 +1,21 @@
+type create_playlist_params_t = {
+    source_search_directory: string;
+    output_playlist_file_destination: string;
+    number_of_results: number;
+    filename_matching_regular_expression?: RegExp | string;
+};
+declare class VLCPlaylistGenerator {
+    private readonly video_extensions;
+    constructor(params?: {
+        video_extensions?: string[];
+    });
+    createPlaylist(params: create_playlist_params_t): Promise<string>;
+    private validateCreatePlaylistParams;
+    private getFilenameMatcher;
+    private findVideoFiles;
+    private isVideoFile;
+    private doesFilenameMatchPattern;
+    private buildM3UContents;
+}
+
+export { VLCPlaylistGenerator };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+type create_playlist_params_t = {
+    source_search_directory: string;
+    output_playlist_file_destination: string;
+    number_of_results: number;
+    filename_matching_regular_expression?: RegExp | string;
+};
+declare class VLCPlaylistGenerator {
+    private readonly video_extensions;
+    constructor(params?: {
+        video_extensions?: string[];
+    });
+    createPlaylist(params: create_playlist_params_t): Promise<string>;
+    private validateCreatePlaylistParams;
+    private getFilenameMatcher;
+    private findVideoFiles;
+    private isVideoFile;
+    private doesFilenameMatchPattern;
+    private buildM3UContents;
+}
+
+export { VLCPlaylistGenerator };

package/dist/index.js

@@ -0,0 +1,363 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  VLCPlaylistGenerator: () => VLCPlaylistGenerator
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/classes/vlc_playlist_generator/VLCPlaylistGenerator.class.ts
+var import_promises = require("fs/promises");
+var import_node_path = __toESM(require("path"));
+function ShuffleArray(params) {
+  const values_copy = [
+    ...params.values
+  ];
+  for (let index = values_copy.length - 1; index > 0; index--) {
+    const random_index = Math.floor(Math.random() * (index + 1));
+    const current_value = values_copy[index];
+    values_copy[index] = values_copy[random_index];
+    values_copy[random_index] = current_value;
+  }
+  return values_copy;
+}
+__name(ShuffleArray, "ShuffleArray");
+var _VLCPlaylistGenerator = class _VLCPlaylistGenerator {
+  constructor(params = {}) {
+    __publicField(this, "video_extensions");
+    const fallback_extensions = [
+      ".3gp",
+      ".avi",
+      ".m4v",
+      ".mkv",
+      ".mov",
+      ".mp4",
+      ".mpeg",
+      ".mpg",
+      ".ogv",
+      ".webm",
+      ".wmv"
+    ];
+    const extensions_to_use = params.video_extensions ?? fallback_extensions;
+    this.video_extensions = new Set(extensions_to_use.map((extension) => extension.toLowerCase()));
+  }
+  async createPlaylist(params) {
+    await this.validateCreatePlaylistParams({
+      params
+    });
+    const source_directory_path = import_node_path.default.resolve(params.source_search_directory);
+    const output_playlist_path = import_node_path.default.resolve(params.output_playlist_file_destination);
+    const filename_matcher = this.getFilenameMatcher({
+      filename_matching_regular_expression: params.filename_matching_regular_expression
+    });
+    const filtered_files = await this.findVideoFiles({
+      directory_path: source_directory_path,
+      filename_matcher
+    });
+    const randomized_files = ShuffleArray({
+      values: filtered_files
+    });
+    const selected_files = randomized_files.slice(0, Math.min(params.number_of_results, randomized_files.length));
+    const playlist_contents = this.buildM3UContents({
+      selected_files
+    });
+    await (0, import_promises.mkdir)(import_node_path.default.dirname(output_playlist_path), {
+      recursive: true
+    });
+    await (0, import_promises.writeFile)(output_playlist_path, playlist_contents, "utf8");
+    return output_playlist_path;
+  }
+  async validateCreatePlaylistParams(params) {
+    if (params.params.source_search_directory.trim() === "") {
+      throw new Error("source_search_directory must not be empty.");
+    }
+    if (params.params.output_playlist_file_destination.trim() === "") {
+      throw new Error("output_playlist_file_destination must not be empty.");
+    }
+    if (!Number.isInteger(params.params.number_of_results)) {
+      throw new Error("number_of_results must be an integer value greater than 0.");
+    }
+    if (params.params.number_of_results <= 0) {
+      throw new Error("number_of_results must be greater than 0.");
+    }
+    const source_search_directory_stats = await (0, import_promises.stat)(params.params.source_search_directory).catch(() => null);
+    if (!source_search_directory_stats?.isDirectory()) {
+      throw new Error(`source_search_directory is not a valid directory: ${params.params.source_search_directory}`);
+    }
+  }
+  getFilenameMatcher(params) {
+    if (params.filename_matching_regular_expression === void 0) {
+      return /^.*$/;
+    }
+    if (params.filename_matching_regular_expression instanceof RegExp) {
+      return params.filename_matching_regular_expression;
+    }
+    return new RegExp(params.filename_matching_regular_expression);
+  }
+  async findVideoFiles(params) {
+    const entries = await (0, import_promises.readdir)(params.directory_path, {
+      withFileTypes: true
+    });
+    const files = [];
+    for (const entry of entries) {
+      const absolute_entry_path = import_node_path.default.join(params.directory_path, entry.name);
+      if (entry.isDirectory()) {
+        const nested_files = await this.findVideoFiles({
+          directory_path: absolute_entry_path,
+          filename_matcher: params.filename_matcher
+        });
+        files.push(...nested_files);
+        continue;
+      }
+      if (!entry.isFile()) {
+        continue;
+      }
+      if (!this.isVideoFile({
+        file_name: entry.name
+      })) {
+        continue;
+      }
+      if (!this.doesFilenameMatchPattern({
+        file_name: entry.name,
+        filename_matcher: params.filename_matcher
+      })) {
+        continue;
+      }
+      files.push({
+        absolute_file_path: absolute_entry_path,
+        file_name: entry.name
+      });
+    }
+    return files;
+  }
+  isVideoFile(params) {
+    const file_extension = import_node_path.default.extname(params.file_name).toLowerCase();
+    return this.video_extensions.has(file_extension);
+  }
+  doesFilenameMatchPattern(params) {
+    params.filename_matcher.lastIndex = 0;
+    return params.filename_matcher.test(params.file_name);
+  }
+  buildM3UContents(params) {
+    const m3u_lines = [
+      "#EXTM3U"
+    ];
+    for (const selected_file of params.selected_files) {
+      m3u_lines.push(`#EXTINF:-1,${selected_file.file_name}`, selected_file.absolute_file_path);
+    }
+    return `${m3u_lines.join("\n")}
+`;
+  }
+};
+__name(_VLCPlaylistGenerator, "VLCPlaylistGenerator");
+var VLCPlaylistGenerator = _VLCPlaylistGenerator;
+
+// src/index.ts
+function BuildUsageText() {
+  return [
+    "Usage:",
+    "  node dist/index.js --source-search-directory <path> --output-playlist-file-destination <path> --number-of-results <number> [--filename-matching-regular-expression <regex>] [--filename-matching-regular-expression-flags <flags>]",
+    "",
+    "Required Arguments:",
+    "  --source-search-directory, -s",
+    "  --output-playlist-file-destination, -o",
+    "  --number-of-results, -n",
+    "",
+    "Optional Arguments:",
+    "  --filename-matching-regular-expression, -r   Default: .*",
+    "  --filename-matching-regular-expression-flags, -f",
+    "  --help, -h"
+  ].join("\n");
+}
+__name(BuildUsageText, "BuildUsageText");
+function ParseRawCommandLineArguments(params) {
+  const parsed_arguments = {
+    help_requested: false
+  };
+  const option_aliases = /* @__PURE__ */ new Map([
+    [
+      "--source-search-directory",
+      "source_search_directory"
+    ],
+    [
+      "-s",
+      "source_search_directory"
+    ],
+    [
+      "--output-playlist-file-destination",
+      "output_playlist_file_destination"
+    ],
+    [
+      "-o",
+      "output_playlist_file_destination"
+    ],
+    [
+      "--number-of-results",
+      "number_of_results"
+    ],
+    [
+      "-n",
+      "number_of_results"
+    ],
+    [
+      "--filename-matching-regular-expression",
+      "filename_matching_regular_expression"
+    ],
+    [
+      "-r",
+      "filename_matching_regular_expression"
+    ],
+    [
+      "--filename-matching-regular-expression-flags",
+      "filename_matching_regular_expression_flags"
+    ],
+    [
+      "-f",
+      "filename_matching_regular_expression_flags"
+    ],
+    [
+      "--help",
+      "help_requested"
+    ],
+    [
+      "-h",
+      "help_requested"
+    ]
+  ]);
+  for (let index = 0; index < params.command_line_tokens.length; index++) {
+    const raw_token = params.command_line_tokens[index];
+    const split_index = raw_token.indexOf("=");
+    const has_inline_value = split_index !== -1;
+    const option_key = has_inline_value ? raw_token.slice(0, split_index) : raw_token;
+    const parsed_option_key = option_aliases.get(option_key);
+    if (parsed_option_key === void 0) {
+      throw new Error(`Unknown argument: ${option_key}`);
+    }
+    if (parsed_option_key === "help_requested") {
+      parsed_arguments.help_requested = true;
+      continue;
+    }
+    const option_value = has_inline_value ? raw_token.slice(split_index + 1) : params.command_line_tokens[index + 1];
+    if (option_value === void 0 || option_value.startsWith("-")) {
+      throw new Error(`Missing value for argument: ${option_key}`);
+    }
+    parsed_arguments[parsed_option_key] = option_value;
+    if (!has_inline_value) {
+      index++;
+    }
+  }
+  return parsed_arguments;
+}
+__name(ParseRawCommandLineArguments, "ParseRawCommandLineArguments");
+function ParseFilenameMatcher(params) {
+  const regex_pattern = params.filename_matching_regular_expression ?? ".*";
+  const regex_flags = params.filename_matching_regular_expression_flags ?? "";
+  return new RegExp(regex_pattern, regex_flags);
+}
+__name(ParseFilenameMatcher, "ParseFilenameMatcher");
+function ParseCommandLineArguments(params) {
+  const raw_arguments = ParseRawCommandLineArguments({
+    command_line_tokens: params.command_line_tokens
+  });
+  if (raw_arguments.help_requested) {
+    return null;
+  }
+  if (raw_arguments.source_search_directory === void 0) {
+    throw new Error("Missing required argument: --source-search-directory");
+  }
+  if (raw_arguments.output_playlist_file_destination === void 0) {
+    throw new Error("Missing required argument: --output-playlist-file-destination");
+  }
+  if (raw_arguments.number_of_results === void 0) {
+    throw new Error("Missing required argument: --number-of-results");
+  }
+  const parsed_number_of_results = Number(raw_arguments.number_of_results);
+  if (!Number.isInteger(parsed_number_of_results)) {
+    throw new Error("--number-of-results must be an integer value.");
+  }
+  return {
+    source_search_directory: raw_arguments.source_search_directory,
+    output_playlist_file_destination: raw_arguments.output_playlist_file_destination,
+    number_of_results: parsed_number_of_results,
+    filename_matching_regular_expression: ParseFilenameMatcher({
+      filename_matching_regular_expression: raw_arguments.filename_matching_regular_expression,
+      filename_matching_regular_expression_flags: raw_arguments.filename_matching_regular_expression_flags
+    })
+  };
+}
+__name(ParseCommandLineArguments, "ParseCommandLineArguments");
+async function RunCommandLineApplication() {
+  try {
+    const command_line_arguments = ParseCommandLineArguments({
+      command_line_tokens: process.argv.slice(2)
+    });
+    if (command_line_arguments === null) {
+      console.log(BuildUsageText());
+      return;
+    }
+    const vlc_playlist_generator = new VLCPlaylistGenerator();
+    const output_playlist_path = await vlc_playlist_generator.createPlaylist({
+      source_search_directory: command_line_arguments.source_search_directory,
+      output_playlist_file_destination: command_line_arguments.output_playlist_file_destination,
+      number_of_results: command_line_arguments.number_of_results,
+      filename_matching_regular_expression: command_line_arguments.filename_matching_regular_expression
+    });
+    console.log(`Playlist generated: ${output_playlist_path}`);
+  } catch (error) {
+    const error_message = error instanceof Error ? error.message : String(error);
+    console.error(error_message);
+    console.error("");
+    console.error(BuildUsageText());
+    process.exitCode = 1;
+  }
+}
+__name(RunCommandLineApplication, "RunCommandLineApplication");
+function IsDirectCommandLineExecution() {
+  if (typeof require === "undefined") {
+    return false;
+  }
+  if (typeof module === "undefined") {
+    return false;
+  }
+  return require.main === module;
+}
+__name(IsDirectCommandLineExecution, "IsDirectCommandLineExecution");
+if (IsDirectCommandLineExecution()) {
+  void RunCommandLineApplication();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VLCPlaylistGenerator
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/classes/vlc_playlist_generator/VLCPlaylistGenerator.class.ts"],"sourcesContent":["import { VLCPlaylistGenerator } from './classes/vlc_playlist_generator/VLCPlaylistGenerator.class';\n\ntype command_line_arguments_t = {\n    source_search_directory: string;\n    output_playlist_file_destination: string;\n    number_of_results: number;\n    filename_matching_regular_expression: RegExp | string;\n};\n\ntype raw_command_line_arguments_t = {\n    source_search_directory?: string;\n    output_playlist_file_destination?: string;\n    number_of_results?: string;\n    filename_matching_regular_expression?: string;\n    filename_matching_regular_expression_flags?: string;\n    help_requested: boolean;\n};\n\nexport { VLCPlaylistGenerator };\n\nfunction BuildUsageText(): string {\n    return [\n        'Usage:',\n        '  node dist/index.js --source-search-directory <path> --output-playlist-file-destination <path> --number-of-results <number> [--filename-matching-regular-expression <regex>] [--filename-matching-regular-expression-flags <flags>]',\n        '',\n        'Required Arguments:',\n        '  --source-search-directory, -s',\n        '  --output-playlist-file-destination, -o',\n        '  --number-of-results, -n',\n        '',\n        'Optional Arguments:',\n        '  --filename-matching-regular-expression, -r   Default: .*',\n        '  --filename-matching-regular-expression-flags, -f',\n        '  --help, -h'\n    ].join('\\n');\n}\n\nfunction ParseRawCommandLineArguments(params: {\n    command_line_tokens: string[];\n}): raw_command_line_arguments_t {\n    const parsed_arguments: raw_command_line_arguments_t = {\n        help_requested: false\n    };\n    const option_aliases = new Map<string, keyof raw_command_line_arguments_t>([\n        ['--source-search-directory', 'source_search_directory'],\n        ['-s', 'source_search_directory'],\n        ['--output-playlist-file-destination', 'output_playlist_file_destination'],\n        ['-o', 'output_playlist_file_destination'],\n        ['--number-of-results', 'number_of_results'],\n        ['-n', 'number_of_results'],\n        [\n            '--filename-matching-regular-expression',\n            'filename_matching_regular_expression'\n        ],\n        ['-r', 'filename_matching_regular_expression'],\n        [\n            '--filename-matching-regular-expression-flags',\n            'filename_matching_regular_expression_flags'\n        ],\n        ['-f', 'filename_matching_regular_expression_flags'],\n        ['--help', 'help_requested'],\n        ['-h', 'help_requested']\n    ]);\n\n    for (let index = 0; index < params.command_line_tokens.length; index++) {\n        const raw_token = params.command_line_tokens[index];\n        const split_index = raw_token.indexOf('=');\n        const has_inline_value = split_index !== -1;\n        const option_key = has_inline_value\n            ? raw_token.slice(0, split_index)\n            : raw_token;\n        const parsed_option_key = option_aliases.get(option_key);\n\n        if (parsed_option_key === undefined) {\n            throw new Error(`Unknown argument: ${option_key}`);\n        }\n\n        if (parsed_option_key === 'help_requested') {\n            parsed_arguments.help_requested = true;\n            continue;\n        }\n\n        const option_value = has_inline_value\n            ? raw_token.slice(split_index + 1)\n            : params.command_line_tokens[index + 1];\n\n        if (option_value === undefined || option_value.startsWith('-')) {\n            throw new Error(`Missing value for argument: ${option_key}`);\n        }\n\n        parsed_arguments[parsed_option_key] = option_value;\n\n        if (!has_inline_value) {\n            index++;\n        }\n    }\n\n    return parsed_arguments;\n}\n\nfunction ParseFilenameMatcher(params: {\n    filename_matching_regular_expression?: string;\n    filename_matching_regular_expression_flags?: string;\n}): RegExp | string {\n    const regex_pattern = params.filename_matching_regular_expression ?? '.*';\n    const regex_flags = params.filename_matching_regular_expression_flags ?? '';\n\n    return new RegExp(regex_pattern, regex_flags);\n}\n\nfunction ParseCommandLineArguments(params: {\n    command_line_tokens: string[];\n}): command_line_arguments_t | null {\n    const raw_arguments = ParseRawCommandLineArguments({\n        command_line_tokens: params.command_line_tokens\n    });\n\n    if (raw_arguments.help_requested) {\n        return null;\n    }\n\n    if (raw_arguments.source_search_directory === undefined) {\n        throw new Error('Missing required argument: --source-search-directory');\n    }\n\n    if (raw_arguments.output_playlist_file_destination === undefined) {\n        throw new Error(\n            'Missing required argument: --output-playlist-file-destination'\n        );\n    }\n\n    if (raw_arguments.number_of_results === undefined) {\n        throw new Error('Missing required argument: --number-of-results');\n    }\n\n    const parsed_number_of_results = Number(raw_arguments.number_of_results);\n\n    if (!Number.isInteger(parsed_number_of_results)) {\n        throw new Error('--number-of-results must be an integer value.');\n    }\n\n    return {\n        source_search_directory: raw_arguments.source_search_directory,\n        output_playlist_file_destination:\n            raw_arguments.output_playlist_file_destination,\n        number_of_results: parsed_number_of_results,\n        filename_matching_regular_expression: ParseFilenameMatcher({\n            filename_matching_regular_expression:\n                raw_arguments.filename_matching_regular_expression,\n            filename_matching_regular_expression_flags:\n                raw_arguments.filename_matching_regular_expression_flags\n        })\n    };\n}\n\nasync function RunCommandLineApplication(): Promise<void> {\n    try {\n        const command_line_arguments = ParseCommandLineArguments({\n            command_line_tokens: process.argv.slice(2)\n        });\n\n        if (command_line_arguments === null) {\n            console.log(BuildUsageText());\n            return;\n        }\n\n        const vlc_playlist_generator = new VLCPlaylistGenerator();\n        const output_playlist_path = await vlc_playlist_generator.createPlaylist(\n            {\n                source_search_directory:\n                    command_line_arguments.source_search_directory,\n                output_playlist_file_destination:\n                    command_line_arguments.output_playlist_file_destination,\n                number_of_results: command_line_arguments.number_of_results,\n                filename_matching_regular_expression:\n                    command_line_arguments.filename_matching_regular_expression\n            }\n        );\n\n        console.log(`Playlist generated: ${output_playlist_path}`);\n    } catch (error) {\n        const error_message =\n            error instanceof Error ? error.message : String(error);\n        console.error(error_message);\n        console.error('');\n        console.error(BuildUsageText());\n        process.exitCode = 1;\n    }\n}\n\nfunction IsDirectCommandLineExecution(): boolean {\n    if (typeof require === 'undefined') {\n        return false;\n    }\n\n    if (typeof module === 'undefined') {\n        return false;\n    }\n\n    return require.main === module;\n}\n\nif (IsDirectCommandLineExecution()) {\n    void RunCommandLineApplication();\n}\n","import { mkdir, readdir, stat, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\ntype create_playlist_params_t = {\n  source_search_directory: string;\n  output_playlist_file_destination: string;\n  number_of_results: number;\n  filename_matching_regular_expression?: RegExp | string;\n};\n\ntype discovered_video_file_t = {\n  absolute_file_path: string;\n  file_name: string;\n};\n\nfunction ShuffleArray<value_t>(params: { values: value_t[] }): value_t[] {\n  const values_copy = [...params.values];\n\n  for (let index = values_copy.length - 1; index > 0; index--) {\n    const random_index = Math.floor(Math.random() * (index + 1));\n    const current_value = values_copy[index];\n    values_copy[index] = values_copy[random_index];\n    values_copy[random_index] = current_value;\n  }\n\n  return values_copy;\n}\n\nexport class VLCPlaylistGenerator {\n  private readonly video_extensions: Set<string>;\n\n  constructor(\n    params: {\n      video_extensions?: string[];\n    } = {}\n  ) {\n    const fallback_extensions = [\n      '.3gp',\n      '.avi',\n      '.m4v',\n      '.mkv',\n      '.mov',\n      '.mp4',\n      '.mpeg',\n      '.mpg',\n      '.ogv',\n      '.webm',\n      '.wmv'\n    ];\n\n    const extensions_to_use = params.video_extensions ?? fallback_extensions;\n    this.video_extensions = new Set(\n      extensions_to_use.map((extension) => extension.toLowerCase())\n    );\n  }\n\n  async createPlaylist(params: create_playlist_params_t): Promise<string> {\n    await this.validateCreatePlaylistParams({ params });\n\n    const source_directory_path = path.resolve(params.source_search_directory);\n    const output_playlist_path = path.resolve(\n      params.output_playlist_file_destination\n    );\n    const filename_matcher = this.getFilenameMatcher({\n      filename_matching_regular_expression:\n        params.filename_matching_regular_expression\n    });\n    const filtered_files = await this.findVideoFiles({\n      directory_path: source_directory_path,\n      filename_matcher\n    });\n    const randomized_files = ShuffleArray({ values: filtered_files });\n    const selected_files = randomized_files.slice(\n      0,\n      Math.min(params.number_of_results, randomized_files.length)\n    );\n    const playlist_contents = this.buildM3UContents({\n      selected_files\n    });\n\n    await mkdir(path.dirname(output_playlist_path), { recursive: true });\n    await writeFile(output_playlist_path, playlist_contents, 'utf8');\n\n    return output_playlist_path;\n  }\n\n  private async validateCreatePlaylistParams(params: {\n    params: create_playlist_params_t;\n  }): Promise<void> {\n    if (params.params.source_search_directory.trim() === '') {\n      throw new Error('source_search_directory must not be empty.');\n    }\n\n    if (params.params.output_playlist_file_destination.trim() === '') {\n      throw new Error('output_playlist_file_destination must not be empty.');\n    }\n\n    if (!Number.isInteger(params.params.number_of_results)) {\n      throw new Error(\n        'number_of_results must be an integer value greater than 0.'\n      );\n    }\n\n    if (params.params.number_of_results <= 0) {\n      throw new Error('number_of_results must be greater than 0.');\n    }\n\n    const source_search_directory_stats = await stat(\n      params.params.source_search_directory\n    ).catch(() => null);\n\n    if (!source_search_directory_stats?.isDirectory()) {\n      throw new Error(\n        `source_search_directory is not a valid directory: ${params.params.source_search_directory}`\n      );\n    }\n  }\n\n  private getFilenameMatcher(params: {\n    filename_matching_regular_expression?: RegExp | string;\n  }): RegExp {\n    if (params.filename_matching_regular_expression === undefined) {\n      return /^.*$/;\n    }\n\n    if (params.filename_matching_regular_expression instanceof RegExp) {\n      return params.filename_matching_regular_expression;\n    }\n\n    return new RegExp(params.filename_matching_regular_expression);\n  }\n\n  private async findVideoFiles(params: {\n    directory_path: string;\n    filename_matcher: RegExp;\n  }): Promise<discovered_video_file_t[]> {\n    const entries = await readdir(params.directory_path, {\n      withFileTypes: true\n    });\n    const files: discovered_video_file_t[] = [];\n\n    for (const entry of entries) {\n      const absolute_entry_path = path.join(params.directory_path, entry.name);\n\n      if (entry.isDirectory()) {\n        const nested_files = await this.findVideoFiles({\n          directory_path: absolute_entry_path,\n          filename_matcher: params.filename_matcher\n        });\n        files.push(...nested_files);\n        continue;\n      }\n\n      if (!entry.isFile()) {\n        continue;\n      }\n\n      if (!this.isVideoFile({ file_name: entry.name })) {\n        continue;\n      }\n\n      if (\n        !this.doesFilenameMatchPattern({\n          file_name: entry.name,\n          filename_matcher: params.filename_matcher\n        })\n      ) {\n        continue;\n      }\n\n      files.push({\n        absolute_file_path: absolute_entry_path,\n        file_name: entry.name\n      });\n    }\n\n    return files;\n  }\n\n  private isVideoFile(params: { file_name: string }): boolean {\n    const file_extension = path.extname(params.file_name).toLowerCase();\n    return this.video_extensions.has(file_extension);\n  }\n\n  private doesFilenameMatchPattern(params: {\n    file_name: string;\n    filename_matcher: RegExp;\n  }): boolean {\n    params.filename_matcher.lastIndex = 0;\n    return params.filename_matcher.test(params.file_name);\n  }\n\n  private buildM3UContents(params: {\n    selected_files: discovered_video_file_t[];\n  }): string {\n    const m3u_lines = ['#EXTM3U'];\n\n    for (const selected_file of params.selected_files) {\n      m3u_lines.push(\n        `#EXTINF:-1,${selected_file.file_name}`,\n        selected_file.absolute_file_path\n      );\n    }\n\n    return `${m3u_lines.join('\\n')}\\n`;\n  }\n}\n"],"mappings":"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","names":["ShuffleArray","params","values_copy","values","index","length","random_index","Math","floor","random","current_value","VLCPlaylistGenerator","video_extensions","fallback_extensions","extensions_to_use","Set","map","extension","toLowerCase","createPlaylist","validateCreatePlaylistParams","source_directory_path","path","resolve","source_search_directory","output_playlist_path","output_playlist_file_destination","filename_matcher","getFilenameMatcher","filename_matching_regular_expression","filtered_files","findVideoFiles","directory_path","randomized_files","selected_files","slice","min","number_of_results","playlist_contents","buildM3UContents","mkdir","dirname","recursive","writeFile","trim","Error","Number","isInteger","source_search_directory_stats","stat","catch","isDirectory","undefined","RegExp","entries","readdir","withFileTypes","files","entry","absolute_entry_path","join","name","nested_files","push","isFile","isVideoFile","file_name","doesFilenameMatchPattern","absolute_file_path","file_extension","extname","has","lastIndex","test","m3u_lines","selected_file","BuildUsageText","join","ParseRawCommandLineArguments","params","parsed_arguments","help_requested","option_aliases","Map","index","command_line_tokens","length","raw_token","split_index","indexOf","has_inline_value","option_key","slice","parsed_option_key","get","undefined","Error","option_value","startsWith","ParseFilenameMatcher","regex_pattern","filename_matching_regular_expression","regex_flags","filename_matching_regular_expression_flags","RegExp","ParseCommandLineArguments","raw_arguments","source_search_directory","output_playlist_file_destination","number_of_results","parsed_number_of_results","Number","isInteger","RunCommandLineApplication","command_line_arguments","process","argv","console","log","vlc_playlist_generator","VLCPlaylistGenerator","output_playlist_path","createPlaylist","error","error_message","message","String","exitCode","IsDirectCommandLineExecution","require","module","main"]}

package/dist/index.mjs

@@ -0,0 +1,334 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/classes/vlc_playlist_generator/VLCPlaylistGenerator.class.ts
+import { mkdir, readdir, stat, writeFile } from "fs/promises";
+import path from "path";
+function ShuffleArray(params) {
+  const values_copy = [
+    ...params.values
+  ];
+  for (let index = values_copy.length - 1; index > 0; index--) {
+    const random_index = Math.floor(Math.random() * (index + 1));
+    const current_value = values_copy[index];
+    values_copy[index] = values_copy[random_index];
+    values_copy[random_index] = current_value;
+  }
+  return values_copy;
+}
+__name(ShuffleArray, "ShuffleArray");
+var _VLCPlaylistGenerator = class _VLCPlaylistGenerator {
+  constructor(params = {}) {
+    __publicField(this, "video_extensions");
+    const fallback_extensions = [
+      ".3gp",
+      ".avi",
+      ".m4v",
+      ".mkv",
+      ".mov",
+      ".mp4",
+      ".mpeg",
+      ".mpg",
+      ".ogv",
+      ".webm",
+      ".wmv"
+    ];
+    const extensions_to_use = params.video_extensions ?? fallback_extensions;
+    this.video_extensions = new Set(extensions_to_use.map((extension) => extension.toLowerCase()));
+  }
+  async createPlaylist(params) {
+    await this.validateCreatePlaylistParams({
+      params
+    });
+    const source_directory_path = path.resolve(params.source_search_directory);
+    const output_playlist_path = path.resolve(params.output_playlist_file_destination);
+    const filename_matcher = this.getFilenameMatcher({
+      filename_matching_regular_expression: params.filename_matching_regular_expression
+    });
+    const filtered_files = await this.findVideoFiles({
+      directory_path: source_directory_path,
+      filename_matcher
+    });
+    const randomized_files = ShuffleArray({
+      values: filtered_files
+    });
+    const selected_files = randomized_files.slice(0, Math.min(params.number_of_results, randomized_files.length));
+    const playlist_contents = this.buildM3UContents({
+      selected_files
+    });
+    await mkdir(path.dirname(output_playlist_path), {
+      recursive: true
+    });
+    await writeFile(output_playlist_path, playlist_contents, "utf8");
+    return output_playlist_path;
+  }
+  async validateCreatePlaylistParams(params) {
+    if (params.params.source_search_directory.trim() === "") {
+      throw new Error("source_search_directory must not be empty.");
+    }
+    if (params.params.output_playlist_file_destination.trim() === "") {
+      throw new Error("output_playlist_file_destination must not be empty.");
+    }
+    if (!Number.isInteger(params.params.number_of_results)) {
+      throw new Error("number_of_results must be an integer value greater than 0.");
+    }
+    if (params.params.number_of_results <= 0) {
+      throw new Error("number_of_results must be greater than 0.");
+    }
+    const source_search_directory_stats = await stat(params.params.source_search_directory).catch(() => null);
+    if (!source_search_directory_stats?.isDirectory()) {
+      throw new Error(`source_search_directory is not a valid directory: ${params.params.source_search_directory}`);
+    }
+  }
+  getFilenameMatcher(params) {
+    if (params.filename_matching_regular_expression === void 0) {
+      return /^.*$/;
+    }
+    if (params.filename_matching_regular_expression instanceof RegExp) {
+      return params.filename_matching_regular_expression;
+    }
+    return new RegExp(params.filename_matching_regular_expression);
+  }
+  async findVideoFiles(params) {
+    const entries = await readdir(params.directory_path, {
+      withFileTypes: true
+    });
+    const files = [];
+    for (const entry of entries) {
+      const absolute_entry_path = path.join(params.directory_path, entry.name);
+      if (entry.isDirectory()) {
+        const nested_files = await this.findVideoFiles({
+          directory_path: absolute_entry_path,
+          filename_matcher: params.filename_matcher
+        });
+        files.push(...nested_files);
+        continue;
+      }
+      if (!entry.isFile()) {
+        continue;
+      }
+      if (!this.isVideoFile({
+        file_name: entry.name
+      })) {
+        continue;
+      }
+      if (!this.doesFilenameMatchPattern({
+        file_name: entry.name,
+        filename_matcher: params.filename_matcher
+      })) {
+        continue;
+      }
+      files.push({
+        absolute_file_path: absolute_entry_path,
+        file_name: entry.name
+      });
+    }
+    return files;
+  }
+  isVideoFile(params) {
+    const file_extension = path.extname(params.file_name).toLowerCase();
+    return this.video_extensions.has(file_extension);
+  }
+  doesFilenameMatchPattern(params) {
+    params.filename_matcher.lastIndex = 0;
+    return params.filename_matcher.test(params.file_name);
+  }
+  buildM3UContents(params) {
+    const m3u_lines = [
+      "#EXTM3U"
+    ];
+    for (const selected_file of params.selected_files) {
+      m3u_lines.push(`#EXTINF:-1,${selected_file.file_name}`, selected_file.absolute_file_path);
+    }
+    return `${m3u_lines.join("\n")}
+`;
+  }
+};
+__name(_VLCPlaylistGenerator, "VLCPlaylistGenerator");
+var VLCPlaylistGenerator = _VLCPlaylistGenerator;
+
+// src/index.ts
+function BuildUsageText() {
+  return [
+    "Usage:",
+    "  node dist/index.js --source-search-directory <path> --output-playlist-file-destination <path> --number-of-results <number> [--filename-matching-regular-expression <regex>] [--filename-matching-regular-expression-flags <flags>]",
+    "",
+    "Required Arguments:",
+    "  --source-search-directory, -s",
+    "  --output-playlist-file-destination, -o",
+    "  --number-of-results, -n",
+    "",
+    "Optional Arguments:",
+    "  --filename-matching-regular-expression, -r   Default: .*",
+    "  --filename-matching-regular-expression-flags, -f",
+    "  --help, -h"
+  ].join("\n");
+}
+__name(BuildUsageText, "BuildUsageText");
+function ParseRawCommandLineArguments(params) {
+  const parsed_arguments = {
+    help_requested: false
+  };
+  const option_aliases = /* @__PURE__ */ new Map([
+    [
+      "--source-search-directory",
+      "source_search_directory"
+    ],
+    [
+      "-s",
+      "source_search_directory"
+    ],
+    [
+      "--output-playlist-file-destination",
+      "output_playlist_file_destination"
+    ],
+    [
+      "-o",
+      "output_playlist_file_destination"
+    ],
+    [
+      "--number-of-results",
+      "number_of_results"
+    ],
+    [
+      "-n",
+      "number_of_results"
+    ],
+    [
+      "--filename-matching-regular-expression",
+      "filename_matching_regular_expression"
+    ],
+    [
+      "-r",
+      "filename_matching_regular_expression"
+    ],
+    [
+      "--filename-matching-regular-expression-flags",
+      "filename_matching_regular_expression_flags"
+    ],
+    [
+      "-f",
+      "filename_matching_regular_expression_flags"
+    ],
+    [
+      "--help",
+      "help_requested"
+    ],
+    [
+      "-h",
+      "help_requested"
+    ]
+  ]);
+  for (let index = 0; index < params.command_line_tokens.length; index++) {
+    const raw_token = params.command_line_tokens[index];
+    const split_index = raw_token.indexOf("=");
+    const has_inline_value = split_index !== -1;
+    const option_key = has_inline_value ? raw_token.slice(0, split_index) : raw_token;
+    const parsed_option_key = option_aliases.get(option_key);
+    if (parsed_option_key === void 0) {
+      throw new Error(`Unknown argument: ${option_key}`);
+    }
+    if (parsed_option_key === "help_requested") {
+      parsed_arguments.help_requested = true;
+      continue;
+    }
+    const option_value = has_inline_value ? raw_token.slice(split_index + 1) : params.command_line_tokens[index + 1];
+    if (option_value === void 0 || option_value.startsWith("-")) {
+      throw new Error(`Missing value for argument: ${option_key}`);
+    }
+    parsed_arguments[parsed_option_key] = option_value;
+    if (!has_inline_value) {
+      index++;
+    }
+  }
+  return parsed_arguments;
+}
+__name(ParseRawCommandLineArguments, "ParseRawCommandLineArguments");
+function ParseFilenameMatcher(params) {
+  const regex_pattern = params.filename_matching_regular_expression ?? ".*";
+  const regex_flags = params.filename_matching_regular_expression_flags ?? "";
+  return new RegExp(regex_pattern, regex_flags);
+}
+__name(ParseFilenameMatcher, "ParseFilenameMatcher");
+function ParseCommandLineArguments(params) {
+  const raw_arguments = ParseRawCommandLineArguments({
+    command_line_tokens: params.command_line_tokens
+  });
+  if (raw_arguments.help_requested) {
+    return null;
+  }
+  if (raw_arguments.source_search_directory === void 0) {
+    throw new Error("Missing required argument: --source-search-directory");
+  }
+  if (raw_arguments.output_playlist_file_destination === void 0) {
+    throw new Error("Missing required argument: --output-playlist-file-destination");
+  }
+  if (raw_arguments.number_of_results === void 0) {
+    throw new Error("Missing required argument: --number-of-results");
+  }
+  const parsed_number_of_results = Number(raw_arguments.number_of_results);
+  if (!Number.isInteger(parsed_number_of_results)) {
+    throw new Error("--number-of-results must be an integer value.");
+  }
+  return {
+    source_search_directory: raw_arguments.source_search_directory,
+    output_playlist_file_destination: raw_arguments.output_playlist_file_destination,
+    number_of_results: parsed_number_of_results,
+    filename_matching_regular_expression: ParseFilenameMatcher({
+      filename_matching_regular_expression: raw_arguments.filename_matching_regular_expression,
+      filename_matching_regular_expression_flags: raw_arguments.filename_matching_regular_expression_flags
+    })
+  };
+}
+__name(ParseCommandLineArguments, "ParseCommandLineArguments");
+async function RunCommandLineApplication() {
+  try {
+    const command_line_arguments = ParseCommandLineArguments({
+      command_line_tokens: process.argv.slice(2)
+    });
+    if (command_line_arguments === null) {
+      console.log(BuildUsageText());
+      return;
+    }
+    const vlc_playlist_generator = new VLCPlaylistGenerator();
+    const output_playlist_path = await vlc_playlist_generator.createPlaylist({
+      source_search_directory: command_line_arguments.source_search_directory,
+      output_playlist_file_destination: command_line_arguments.output_playlist_file_destination,
+      number_of_results: command_line_arguments.number_of_results,
+      filename_matching_regular_expression: command_line_arguments.filename_matching_regular_expression
+    });
+    console.log(`Playlist generated: ${output_playlist_path}`);
+  } catch (error) {
+    const error_message = error instanceof Error ? error.message : String(error);
+    console.error(error_message);
+    console.error("");
+    console.error(BuildUsageText());
+    process.exitCode = 1;
+  }
+}
+__name(RunCommandLineApplication, "RunCommandLineApplication");
+function IsDirectCommandLineExecution() {
+  if (typeof __require === "undefined") {
+    return false;
+  }
+  if (typeof module === "undefined") {
+    return false;
+  }
+  return __require.main === module;
+}
+__name(IsDirectCommandLineExecution, "IsDirectCommandLineExecution");
+if (IsDirectCommandLineExecution()) {
+  void RunCommandLineApplication();
+}
+export {
+  VLCPlaylistGenerator
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/classes/vlc_playlist_generator/VLCPlaylistGenerator.class.ts","../src/index.ts"],"sourcesContent":["import { mkdir, readdir, stat, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\ntype create_playlist_params_t = {\n  source_search_directory: string;\n  output_playlist_file_destination: string;\n  number_of_results: number;\n  filename_matching_regular_expression?: RegExp | string;\n};\n\ntype discovered_video_file_t = {\n  absolute_file_path: string;\n  file_name: string;\n};\n\nfunction ShuffleArray<value_t>(params: { values: value_t[] }): value_t[] {\n  const values_copy = [...params.values];\n\n  for (let index = values_copy.length - 1; index > 0; index--) {\n    const random_index = Math.floor(Math.random() * (index + 1));\n    const current_value = values_copy[index];\n    values_copy[index] = values_copy[random_index];\n    values_copy[random_index] = current_value;\n  }\n\n  return values_copy;\n}\n\nexport class VLCPlaylistGenerator {\n  private readonly video_extensions: Set<string>;\n\n  constructor(\n    params: {\n      video_extensions?: string[];\n    } = {}\n  ) {\n    const fallback_extensions = [\n      '.3gp',\n      '.avi',\n      '.m4v',\n      '.mkv',\n      '.mov',\n      '.mp4',\n      '.mpeg',\n      '.mpg',\n      '.ogv',\n      '.webm',\n      '.wmv'\n    ];\n\n    const extensions_to_use = params.video_extensions ?? fallback_extensions;\n    this.video_extensions = new Set(\n      extensions_to_use.map((extension) => extension.toLowerCase())\n    );\n  }\n\n  async createPlaylist(params: create_playlist_params_t): Promise<string> {\n    await this.validateCreatePlaylistParams({ params });\n\n    const source_directory_path = path.resolve(params.source_search_directory);\n    const output_playlist_path = path.resolve(\n      params.output_playlist_file_destination\n    );\n    const filename_matcher = this.getFilenameMatcher({\n      filename_matching_regular_expression:\n        params.filename_matching_regular_expression\n    });\n    const filtered_files = await this.findVideoFiles({\n      directory_path: source_directory_path,\n      filename_matcher\n    });\n    const randomized_files = ShuffleArray({ values: filtered_files });\n    const selected_files = randomized_files.slice(\n      0,\n      Math.min(params.number_of_results, randomized_files.length)\n    );\n    const playlist_contents = this.buildM3UContents({\n      selected_files\n    });\n\n    await mkdir(path.dirname(output_playlist_path), { recursive: true });\n    await writeFile(output_playlist_path, playlist_contents, 'utf8');\n\n    return output_playlist_path;\n  }\n\n  private async validateCreatePlaylistParams(params: {\n    params: create_playlist_params_t;\n  }): Promise<void> {\n    if (params.params.source_search_directory.trim() === '') {\n      throw new Error('source_search_directory must not be empty.');\n    }\n\n    if (params.params.output_playlist_file_destination.trim() === '') {\n      throw new Error('output_playlist_file_destination must not be empty.');\n    }\n\n    if (!Number.isInteger(params.params.number_of_results)) {\n      throw new Error(\n        'number_of_results must be an integer value greater than 0.'\n      );\n    }\n\n    if (params.params.number_of_results <= 0) {\n      throw new Error('number_of_results must be greater than 0.');\n    }\n\n    const source_search_directory_stats = await stat(\n      params.params.source_search_directory\n    ).catch(() => null);\n\n    if (!source_search_directory_stats?.isDirectory()) {\n      throw new Error(\n        `source_search_directory is not a valid directory: ${params.params.source_search_directory}`\n      );\n    }\n  }\n\n  private getFilenameMatcher(params: {\n    filename_matching_regular_expression?: RegExp | string;\n  }): RegExp {\n    if (params.filename_matching_regular_expression === undefined) {\n      return /^.*$/;\n    }\n\n    if (params.filename_matching_regular_expression instanceof RegExp) {\n      return params.filename_matching_regular_expression;\n    }\n\n    return new RegExp(params.filename_matching_regular_expression);\n  }\n\n  private async findVideoFiles(params: {\n    directory_path: string;\n    filename_matcher: RegExp;\n  }): Promise<discovered_video_file_t[]> {\n    const entries = await readdir(params.directory_path, {\n      withFileTypes: true\n    });\n    const files: discovered_video_file_t[] = [];\n\n    for (const entry of entries) {\n      const absolute_entry_path = path.join(params.directory_path, entry.name);\n\n      if (entry.isDirectory()) {\n        const nested_files = await this.findVideoFiles({\n          directory_path: absolute_entry_path,\n          filename_matcher: params.filename_matcher\n        });\n        files.push(...nested_files);\n        continue;\n      }\n\n      if (!entry.isFile()) {\n        continue;\n      }\n\n      if (!this.isVideoFile({ file_name: entry.name })) {\n        continue;\n      }\n\n      if (\n        !this.doesFilenameMatchPattern({\n          file_name: entry.name,\n          filename_matcher: params.filename_matcher\n        })\n      ) {\n        continue;\n      }\n\n      files.push({\n        absolute_file_path: absolute_entry_path,\n        file_name: entry.name\n      });\n    }\n\n    return files;\n  }\n\n  private isVideoFile(params: { file_name: string }): boolean {\n    const file_extension = path.extname(params.file_name).toLowerCase();\n    return this.video_extensions.has(file_extension);\n  }\n\n  private doesFilenameMatchPattern(params: {\n    file_name: string;\n    filename_matcher: RegExp;\n  }): boolean {\n    params.filename_matcher.lastIndex = 0;\n    return params.filename_matcher.test(params.file_name);\n  }\n\n  private buildM3UContents(params: {\n    selected_files: discovered_video_file_t[];\n  }): string {\n    const m3u_lines = ['#EXTM3U'];\n\n    for (const selected_file of params.selected_files) {\n      m3u_lines.push(\n        `#EXTINF:-1,${selected_file.file_name}`,\n        selected_file.absolute_file_path\n      );\n    }\n\n    return `${m3u_lines.join('\\n')}\\n`;\n  }\n}\n","import { VLCPlaylistGenerator } from './classes/vlc_playlist_generator/VLCPlaylistGenerator.class';\n\ntype command_line_arguments_t = {\n    source_search_directory: string;\n    output_playlist_file_destination: string;\n    number_of_results: number;\n    filename_matching_regular_expression: RegExp | string;\n};\n\ntype raw_command_line_arguments_t = {\n    source_search_directory?: string;\n    output_playlist_file_destination?: string;\n    number_of_results?: string;\n    filename_matching_regular_expression?: string;\n    filename_matching_regular_expression_flags?: string;\n    help_requested: boolean;\n};\n\nexport { VLCPlaylistGenerator };\n\nfunction BuildUsageText(): string {\n    return [\n        'Usage:',\n        '  node dist/index.js --source-search-directory <path> --output-playlist-file-destination <path> --number-of-results <number> [--filename-matching-regular-expression <regex>] [--filename-matching-regular-expression-flags <flags>]',\n        '',\n        'Required Arguments:',\n        '  --source-search-directory, -s',\n        '  --output-playlist-file-destination, -o',\n        '  --number-of-results, -n',\n        '',\n        'Optional Arguments:',\n        '  --filename-matching-regular-expression, -r   Default: .*',\n        '  --filename-matching-regular-expression-flags, -f',\n        '  --help, -h'\n    ].join('\\n');\n}\n\nfunction ParseRawCommandLineArguments(params: {\n    command_line_tokens: string[];\n}): raw_command_line_arguments_t {\n    const parsed_arguments: raw_command_line_arguments_t = {\n        help_requested: false\n    };\n    const option_aliases = new Map<string, keyof raw_command_line_arguments_t>([\n        ['--source-search-directory', 'source_search_directory'],\n        ['-s', 'source_search_directory'],\n        ['--output-playlist-file-destination', 'output_playlist_file_destination'],\n        ['-o', 'output_playlist_file_destination'],\n        ['--number-of-results', 'number_of_results'],\n        ['-n', 'number_of_results'],\n        [\n            '--filename-matching-regular-expression',\n            'filename_matching_regular_expression'\n        ],\n        ['-r', 'filename_matching_regular_expression'],\n        [\n            '--filename-matching-regular-expression-flags',\n            'filename_matching_regular_expression_flags'\n        ],\n        ['-f', 'filename_matching_regular_expression_flags'],\n        ['--help', 'help_requested'],\n        ['-h', 'help_requested']\n    ]);\n\n    for (let index = 0; index < params.command_line_tokens.length; index++) {\n        const raw_token = params.command_line_tokens[index];\n        const split_index = raw_token.indexOf('=');\n        const has_inline_value = split_index !== -1;\n        const option_key = has_inline_value\n            ? raw_token.slice(0, split_index)\n            : raw_token;\n        const parsed_option_key = option_aliases.get(option_key);\n\n        if (parsed_option_key === undefined) {\n            throw new Error(`Unknown argument: ${option_key}`);\n        }\n\n        if (parsed_option_key === 'help_requested') {\n            parsed_arguments.help_requested = true;\n            continue;\n        }\n\n        const option_value = has_inline_value\n            ? raw_token.slice(split_index + 1)\n            : params.command_line_tokens[index + 1];\n\n        if (option_value === undefined || option_value.startsWith('-')) {\n            throw new Error(`Missing value for argument: ${option_key}`);\n        }\n\n        parsed_arguments[parsed_option_key] = option_value;\n\n        if (!has_inline_value) {\n            index++;\n        }\n    }\n\n    return parsed_arguments;\n}\n\nfunction ParseFilenameMatcher(params: {\n    filename_matching_regular_expression?: string;\n    filename_matching_regular_expression_flags?: string;\n}): RegExp | string {\n    const regex_pattern = params.filename_matching_regular_expression ?? '.*';\n    const regex_flags = params.filename_matching_regular_expression_flags ?? '';\n\n    return new RegExp(regex_pattern, regex_flags);\n}\n\nfunction ParseCommandLineArguments(params: {\n    command_line_tokens: string[];\n}): command_line_arguments_t | null {\n    const raw_arguments = ParseRawCommandLineArguments({\n        command_line_tokens: params.command_line_tokens\n    });\n\n    if (raw_arguments.help_requested) {\n        return null;\n    }\n\n    if (raw_arguments.source_search_directory === undefined) {\n        throw new Error('Missing required argument: --source-search-directory');\n    }\n\n    if (raw_arguments.output_playlist_file_destination === undefined) {\n        throw new Error(\n            'Missing required argument: --output-playlist-file-destination'\n        );\n    }\n\n    if (raw_arguments.number_of_results === undefined) {\n        throw new Error('Missing required argument: --number-of-results');\n    }\n\n    const parsed_number_of_results = Number(raw_arguments.number_of_results);\n\n    if (!Number.isInteger(parsed_number_of_results)) {\n        throw new Error('--number-of-results must be an integer value.');\n    }\n\n    return {\n        source_search_directory: raw_arguments.source_search_directory,\n        output_playlist_file_destination:\n            raw_arguments.output_playlist_file_destination,\n        number_of_results: parsed_number_of_results,\n        filename_matching_regular_expression: ParseFilenameMatcher({\n            filename_matching_regular_expression:\n                raw_arguments.filename_matching_regular_expression,\n            filename_matching_regular_expression_flags:\n                raw_arguments.filename_matching_regular_expression_flags\n        })\n    };\n}\n\nasync function RunCommandLineApplication(): Promise<void> {\n    try {\n        const command_line_arguments = ParseCommandLineArguments({\n            command_line_tokens: process.argv.slice(2)\n        });\n\n        if (command_line_arguments === null) {\n            console.log(BuildUsageText());\n            return;\n        }\n\n        const vlc_playlist_generator = new VLCPlaylistGenerator();\n        const output_playlist_path = await vlc_playlist_generator.createPlaylist(\n            {\n                source_search_directory:\n                    command_line_arguments.source_search_directory,\n                output_playlist_file_destination:\n                    command_line_arguments.output_playlist_file_destination,\n                number_of_results: command_line_arguments.number_of_results,\n                filename_matching_regular_expression:\n                    command_line_arguments.filename_matching_regular_expression\n            }\n        );\n\n        console.log(`Playlist generated: ${output_playlist_path}`);\n    } catch (error) {\n        const error_message =\n            error instanceof Error ? error.message : String(error);\n        console.error(error_message);\n        console.error('');\n        console.error(BuildUsageText());\n        process.exitCode = 1;\n    }\n}\n\nfunction IsDirectCommandLineExecution(): boolean {\n    if (typeof require === 'undefined') {\n        return false;\n    }\n\n    if (typeof module === 'undefined') {\n        return false;\n    }\n\n    return require.main === module;\n}\n\nif (IsDirectCommandLineExecution()) {\n    void RunCommandLineApplication();\n}\n"],"mappings":"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","names":["mkdir","readdir","stat","writeFile","path","ShuffleArray","params","values_copy","values","index","length","random_index","Math","floor","random","current_value","VLCPlaylistGenerator","video_extensions","fallback_extensions","extensions_to_use","Set","map","extension","toLowerCase","createPlaylist","validateCreatePlaylistParams","source_directory_path","path","resolve","source_search_directory","output_playlist_path","output_playlist_file_destination","filename_matcher","getFilenameMatcher","filename_matching_regular_expression","filtered_files","findVideoFiles","directory_path","randomized_files","selected_files","slice","min","number_of_results","playlist_contents","buildM3UContents","mkdir","dirname","recursive","writeFile","trim","Error","Number","isInteger","source_search_directory_stats","stat","catch","isDirectory","undefined","RegExp","entries","readdir","withFileTypes","files","entry","absolute_entry_path","join","name","nested_files","push","isFile","isVideoFile","file_name","doesFilenameMatchPattern","absolute_file_path","file_extension","extname","has","lastIndex","test","m3u_lines","selected_file","BuildUsageText","join","ParseRawCommandLineArguments","params","parsed_arguments","help_requested","option_aliases","Map","index","command_line_tokens","length","raw_token","split_index","indexOf","has_inline_value","option_key","slice","parsed_option_key","get","undefined","Error","option_value","startsWith","ParseFilenameMatcher","regex_pattern","filename_matching_regular_expression","regex_flags","filename_matching_regular_expression_flags","RegExp","ParseCommandLineArguments","raw_arguments","source_search_directory","output_playlist_file_destination","number_of_results","parsed_number_of_results","Number","isInteger","RunCommandLineApplication","command_line_arguments","process","argv","console","log","vlc_playlist_generator","VLCPlaylistGenerator","output_playlist_path","createPlaylist","error","error_message","message","String","exitCode","IsDirectCommandLineExecution","require","module","main"]}

package/markdowns/code_naming_conventions.md

@@ -0,0 +1,19 @@
+# Code Naming Conventions
+
+Since all code in typescript is mostly a class, method, variable, or function, we use specific case semantics so that reading code is much easier.
+
+- **let some_var:** Variable names use snake_case.
+- **FunctionName:** Individual functions use pascal case.
+- **let some_class = new SomeClass:** Class names are pascal case.
+- **some_class.someMethod:** Method names are camel case.
+
+Be aware that this is what we use, not what other librarys that we use, use.
+
+# Types/Interfaces/Typescript
+
+- **typename_t:** typenames are affixed with \_t.
+- **interfacename_i:** interfaces are affixed with \_i.
+
+# Runtime Schema Validation
+
+- **sometypename_t_zods:** Zod type schemas are defined by matching their type, along with \_zods.

package/markdowns/zod_schemas.md

@@ -0,0 +1,8 @@
+# Zod Schemas
+
+We use zod for runtime data validation. The way we do this is by using ts-to-zod, which compiles runtime loadable zod objects from existing typescript types and interfaces.
+
+[ts-to-zod github](https://github.com/fabien0102/ts-to-zod)
+
+- **Autogenerated Zod Schemas:** ./src/zod_type_validators/
+- **ts-to-zod configuration:** ./ts-to-zod.config.mjs

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@opsimathically/vlc_playlist_generator",
+  "version": "0.0.1",
+  "description": "A m3u format playlist generator designed for generating input for vlc.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "npx ts-to-zod && tsup",
+    "test": "node --require ts-node/register --require tsconfig-paths/register --test test/**/*.test.ts",
+    "ts-to-zod": "npx ts-to-zod",
+    "docs": "typedoc"
+  },
+  "keywords": [
+    "set_keywords"
+  ],
+  "homepage": "https://github.com/opsimathically/vlc_playlist_generator",
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.19.1",
+    "@types/node-forge": "^1.3.11",
+    "@types/wtfnode": "^0.7.3",
+    "esbuild": "^0.25.0",
+    "eslint": "^9.20.1",
+    "globals": "^15.14.0",
+    "prettier": "^3.5.0",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "tsup": "^8.5.1",
+    "typedoc": "^0.28.1",
+    "typedoc-plugin-markdown": "^4.6.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.24.0",
+    "wtfnode": "^0.10.0"
+  },
+  "author": "Jason Medeiros",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opsimathically/vlc_playlist_generator.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@swc/core": "^1.11.24",
+    "@types/command-line-args": "^5.2.3",
+    "@types/command-line-usage": "^5.0.4",
+    "command-line-args": "^6.0.1",
+    "command-line-usage": "^7.0.3",
+    "sharp": "^0.34.1",
+    "source-map-support": "^0.5.21",
+    "ts-to-zod": "^5.1.0",
+    "zod": "^4.3.5"
+  }
+}

package/ts-to-zod.config.mjs

@@ -0,0 +1,17 @@
+/**
+ * ts-to-zod configuration.  Add elements to the exported default array below to extend
+ * this configuration across multiple files.
+ *
+ * @type {import("ts-to-zod").TsToZodConfig}
+ */
+export default [
+  {
+    name: 'zod-to-ts',
+    input: './src/types/custom_zod_types/custom_zod_types.d.ts',
+    output:
+      './src/zod_type_validators/custom_ts_to_zod_generated_validators.ts',
+    // this is where we define how types are converted into schemas.  We just take the type name
+    // and append _zods to identify that it's a schema not a type.
+    getSchemaName: (id) => id + '_zods'
+  }
+];

package/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["cjs", "esm"],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  external: [
+    "./transpilers/swc.js",
+    "source-map-support",
+    "@cspotcode/source-map-support",
+  ], // Mark it external
+});

package/typedoc.json

@@ -0,0 +1,7 @@
+{
+  "entryPoints": ["src/index.ts"],
+  "out": "docs",
+  "plugin": ["typedoc-plugin-markdown"],
+  "readme": "none",
+  "githubPages": false
+}