feat: update function (#267)

Author: MorganVonBrylan

README.md

@@ -181,6 +181,10 @@ setTimeout(subprocess.cancel, 30000)
 
 It creates a `yt-dlp` using the `binaryPath` provided.
 
+### youtubedl.update(binaryPath)
+
+Updates the `yt-dlp` executable at the provided path. If not path is provided, the default instance will be updated.
+
 ## Environment variables
 
 The environment variables are used to customize the [postinstall script](https://github.com/microlinkhq/youtube-dl-exec/blob/master/scripts/postinstall.js) behavior that will be triggered after `npm install` is performed.

src/index.d.ts

@@ -445,9 +445,11 @@ export type Flags = {
 
 export type Exec = (url: string, flags?: Flags, options?: SpawnOptions) => TinyspawnPromise
 export type Create = (binaryPath: string) => { (url: string, flags?: Flags, options?: SpawnOptions): Promise<Payload>; exec: Exec }
+export type Update = (binaryPath: string) => TinyspawnPromise
 export const youtubeDl: ((...args: Parameters<Exec>) => Promise<Payload | string>) & { exec: Exec, create: Create }
 
 export function exec(...args: Parameters<Exec>): ReturnType<Exec>
 export function create(...args: Parameters<Create>): ReturnType<Create>
+export function update(...args: Parameters<Update>): ReturnType<Update>
 
 export default youtubeDl

src/index.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { dirname, basename } = require('node:path')
+
 const dargs = require('dargs')
 const $ = require('tinyspawn')
 
@@ -24,11 +26,16 @@ const create = binaryPath => {
   return fn
 }
 
+const update = (binaryPath = constants.YOUTUBE_DL_PATH) => {
+  return $(basename(binaryPath), ['-U'], { cwd: dirname(binaryPath) })
+}
+
 const defaultInstance = create(constants.YOUTUBE_DL_PATH)
 
 module.exports = defaultInstance
 module.exports.youtubeDl = defaultInstance
 module.exports.create = create
+module.exports.update = update
 module.exports.args = args
 module.exports.isJSON = isJSON
 module.exports.constants = constants