git-dlp 0.2.0

package/README.md

@@ -0,0 +1,290 @@
+# <img src="https://nikelborm.github.io/git-dl/logo.png" align="right" width="40px" height="40px"/> Get git repo contents (git-dl) :lizard:
+
+[![Open in VS Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20VS%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://github.dev/nikelborm/git-dl)
+[![NPM package version](https://badge.fury.io/js/git-dl.svg)](https://www.npmjs.com/package/git-dl)
+[![NPM downloads](https://img.shields.io/npm/dm/git-dl.svg?style=flat)](https://npmjs.org/package/git-dl)
+[![NPM Last Update](https://img.shields.io/npm/last-update/git-dl)](https://npmjs.org/package/git-dl)
+[![package.json Dependents count](https://badgen.net/npm/dependents/git-dl)](https://www.npmjs.com/package/git-dl?activeTab=dependents)
+[![JSR package version](https://jsr.io/badges/@evadev/git-dl)](https://jsr.io/@evadev/git-dl)
+[![JSR package Score](https://jsr.io/badges/@evadev/git-dl/score)](https://jsr.io/@evadev/git-dl)
+[![JSR package owner](https://jsr.io/badges/@evadev)](https://jsr.io/@evadev)
+[![GitHub commits per month](https://img.shields.io/github/commit-activity/m/nikelborm/git-dl)](https://github.com/nikelborm/git-dl/pulse)
+[![GitHub Total commits Count](https://img.shields.io/github/commit-activity/t/nikelborm/git-dl)](https://github.com/nikelborm/git-dl/graphs/commit-activity)
+[![NPM License](https://img.shields.io/npm/l/git-dl)](https://github.com/nikelborm/git-dl?tab=MIT-1-ov-file)
+[![Coveralls Coverage Percentage](https://coveralls.io/repos/github/nikelborm/git-dl/badge.svg?branch=main&rand=9148876)](https://coveralls.io/github/nikelborm/git-dl?branch=main)
+[![CodeFactor Code quality Grade](https://img.shields.io/codefactor/grade/github/nikelborm/git-dl?label=codefactor)](https://www.codefactor.io/repository/github/nikelborm/git-dl)
+[![Code Climate Technical Debt](https://img.shields.io/codeclimate/tech-debt/nikelborm/git-dl)](https://codeclimate.com/github/nikelborm/git-dl/issues)
+[![Code Climate Issues](https://img.shields.io/codeclimate/issues/nikelborm/git-dl)](https://codeclimate.com/github/nikelborm/git-dl/issues)
+[![GitHub Tests Workflow status](https://github.com/nikelborm/git-dl/actions/workflows/test.yml/badge.svg)](https://github.com/nikelborm/git-dl/actions/workflows/test.yml)
+[![GitHub Release Workflow status](https://github.com/nikelborm/git-dl/actions/workflows/release.yml/badge.svg)](https://github.com/nikelborm/git-dl/actions/workflows/release.yml)
+[![Sonar Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Bugs Count](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=bugs)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Code Smells Count](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Lines of Code Count](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Reliability Grade](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Security Grade](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Technical Debt Count](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Maintainability Grade](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+[![Sonar Vulnerabilities Count](https://sonarcloud.io/api/project_badges/measure?project=nikelborm_fetch-github-folder&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=nikelborm_fetch-github-folder)
+![OSS Lifecycle status](https://img.shields.io/osslifecycle?file_url=https%3A%2F%2Fgithub.com%2Fnikelborm%2Ffetch-github-folder%2Fblob%2Fmain%2FOSSMETADATA)
+
+<!-- Commented because there's some bug in effect library or in bundlephobia that prevents proper rendering of this badge -->
+<!-- [![npm minzipped bundle size](https://img.shields.io/bundlephobia/minzip/git-dl)](https://bundlephobia.com/package/git-dl) -->
+<!-- [![package.json Dependencies count](https://badgen.net/bundlephobia/dependency-count/git-dl)](https://www.npmjs.com/package/git-dl?activeTab=dependencies) -->
+
+<!-- commented because it seems that npms.io was acquired by somebody and is slowly dying -->
+<!-- [![npms.io](https://img.shields.io/npms-io/final-score/git-dl)](update_link_later) -->
+
+<!-- commented because I haven't started following it yet -->
+<!-- [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org) -->
+
+<sup>(Don't judge me for my obsession with badges)</sup>
+
+> [!CAUTION]
+>
+> This project currently is not stable, but I'm actively working on writing tests and handling edge cases, such as support for Git-LFS and other.
+> Check out the `dev` branch to see the latest updates! 😉 (except that I currently don't care and just push to main)
+
+## What this library+CLI does?
+
+It allows you to download any folder or a file from a repo on github.
+
+## Requirements
+
+1. Latest Node.js (You can install it easily via [mise](https://github.com/jdx/mise))
+2. Git for development
+
+## Installation
+
+We support various installation options. Regardless of what you choose, if you want to make
+CLIs written in JS run faster, I highly recommend adding this line to your `.bashrc`:
+
+```bash
+export NODE_COMPILE_CACHE=~/.cache/nodejs-compile-cache
+```
+
+### Install package with CLI and functions from [default NPM registry](https://www.npmjs.com/package/git-dl)
+
+```bash
+npm i git-dl
+```
+
+<details>
+<summary>
+
+### Install package with only functions from [JSR](https://jsr.io/@evadev/git-dl)
+
+</summary>
+
+Unfortunately JSR doesn't support publishing executables yet, so you can install
+only script library with functions that will allow you to fetch github folder
+from other scripts.
+
+```bash
+npx jsr add @evadev/git-dl
+```
+
+</details>
+<details>
+<summary>
+
+### Install package with CLI and functions from [GitHub's NPM registry](https://github.com/nikelborm/git-dl/pkgs/npm/git-dl)
+
+</summary>
+
+1. [Generate `Personal access token (classic)` with `read:packages` scope](https://github.com/settings/tokens/new?description=Install%20packages%20from%20GitHub%20NPM%20registry&scopes=read:packages&default_expires_at=none)
+2. Login to Github's NPM registry (yes you need to do it, even if the package is public):
+   1. Run the following command (Info about `--auth-type=legacy` [here](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#authenticating-with-a-personal-access-token)):
+
+      ```bash
+      npm login --scope=@evadev --auth-type=legacy --registry=https://npm.pkg.github.com
+      ```
+
+   2. Enter your username when asked
+   3. Paste the access token as password value
+
+3. Install the package by executing:
+
+   ```bash
+   npm i @evadev/git-dl
+   ```
+
+</details>
+<details>
+<summary>
+
+### Install package with CLI and functions from [Github Releases](https://github.com/nikelborm/git-dl/releases)
+
+</summary>
+
+```bash
+PACKAGE=git-dl
+
+# Either set specific tag
+TAG=0.1.28 && npm i https://github.com/nikelborm/$PACKAGE/releases/download/$TAG/$PACKAGE.tgz
+# or download the latest
+npm i https://github.com/nikelborm/$PACKAGE/releases/latest/download/$PACKAGE.tgz
+```
+
+</details>
+<details open>
+<summary>
+
+### Install only the CLI directly into the system from [Github Releases](https://github.com/nikelborm/git-dl/releases)
+
+</summary>
+
+```bash
+set -euo pipefail
+PACKAGE=git-dl
+
+path_to_the_script=/usr/bin/$PACKAGE
+
+# Either set specific tag
+TAG=0.1.28 && sudo curl -sLo $path_to_the_script https://github.com/nikelborm/$PACKAGE/releases/download/$TAG/$PACKAGE.js
+# or download the latest
+sudo curl -sLo $path_to_the_script https://github.com/nikelborm/$PACKAGE/releases/latest/download/$PACKAGE.js
+
+sudo chmod +x $path_to_the_script
+```
+
+</details>
+<details>
+<summary>
+
+### Setup the repo for local development
+
+</summary>
+
+```bash
+git clone -b main git@github.com:nikelborm/git-dl.git
+cd git-dl
+npm install
+cp template.env .env
+read -sp 'Enter github access token: ' gh_token; echo;
+sed -i "s/\(GITHUB_ACCESS_TOKEN\)='.*'/\1='$gh_token'/" .env
+```
+
+</details>
+
+## Usage
+
+### EcmaScript module
+
+```ts
+import {
+  downloadEntityFromRepo,
+  OctokitLayer,
+  FailedToParseGitLFSInfoError,
+  GitHubApiBadCredentialsError,
+  type InputConfig,
+  type OutputConfig,
+  type SingleTargetConfig,
+  repoNameCLIOptionBackedByEnv,
+  repoOwnerCLIOptionBackedByEnv,
+  // etc...
+} from 'git-dl';
+// or '@evadev/git-dl' for non-default installation methods
+```
+
+### Execution of CLI installed with NPM
+
+The **easiest way** to execute the CLI (preliminary installation is not required) is
+like this:
+
+```bash
+npx git-dl --repoOwner apache --repoName superset
+```
+
+Also there's a shorter form available (preliminary installation is required):
+
+```bash
+npx gdl --repoOwner apache --repoName superset
+```
+
+<details>
+<summary>
+
+### Non-interactive CLI execution on the fly from [Github Releases](https://github.com/nikelborm/git-dl/releases)
+
+</summary>
+
+If you already know the supported arguments (e.g. `--help` to print them all),
+you can pipe the bundled and minified script version into node directly and pass
+your arguments after `node -`:
+
+```bash
+set -euo pipefail
+
+# Either set specific tag
+TAG=0.1.28 && curl -sL https://github.com/nikelborm/$PACKAGE/releases/download/$TAG/$PACKAGE.js | node - --repoOwner apache --repoName superset
+# or download the latest
+curl -sL https://github.com/nikelborm/$PACKAGE/releases/latest/download/$PACKAGE.js | node - --repoOwner apache --repoName superset
+```
+
+</details>
+<details>
+<summary>
+
+### Interactive CLI execution from [Github Releases](https://github.com/nikelborm/git-dl/releases)
+
+</summary>
+
+The script also supports interactive mode (`--wizard`), where you will be asked
+to pass arguments sequentially and interactively. Since it requires user input,
+it can't be piped and needs to be saved to a temporary file:
+
+```bash
+set -euo pipefail
+tmp_js=$(mktemp --suffix .js)
+
+# Either set specific tag
+TAG=0.1.28 && curl -sLo $tmp_js https://github.com/nikelborm/$PACKAGE/releases/download/$TAG/$PACKAGE.js
+# or download the latest
+curl -sLo $tmp_js https://github.com/nikelborm/$PACKAGE/releases/latest/download/$PACKAGE.js
+
+node $tmp_js --wizard
+rm $tmp_js
+```
+
+</details>
+<details open>
+<summary>
+
+### Execution of CLI installed directly into the system
+
+</summary>
+
+```bash
+git-dl --repoOwner apache --repoName superset
+```
+
+</details>
+
+## Environment Variables
+
+If you often use the CLI, you can permanently set the arguments via env
+variables, and they will be used as a backup if arguments weren't provided
+explicitly.
+
+- `GITHUB_ACCESS_TOKEN`: This is your personal access token from GitHub. It is
+  used to authenticate your requests to the GitHub API. You can generate one
+  [here](https://github.com/settings/tokens/new?description=Read%20repo%20contents%20access%20to%20fetch-github-folder&scopes=public_repo&default_expires_at=none).
+- `REPO_OWNER`: This is the username of the owner of the repository you are
+  trying to download from. For example, if the repository's URL is
+  `https://github.com/apache/superset`, the owner is `apache`.
+- `REPO_NAME`: This is the name of the repository you are trying to download
+  from. In the example above, the repository name is `superset`.
+- `PATH_TO_ENTITY_IN_REPO`: This is the path to the directory you want to
+  download. It can be directory that lies inside root of repo like `docker` or
+  it can be some nested directory like `docker/nginx`.
+- `GIT_REF`: This is the commit SHA hash, branch name, or tag name you want to
+  download from. If you don't specify it, the default branch in the repository
+  will be used.
+- `DESTINATION_PATH`: If entity at `PATH_TO_ENTITY_IN_REPO` is a file, then
+  destination path is a path to downloaded file. If it's a directory, then all
+  files and directories from target directory of remote repository at
+  `PATH_TO_ENTITY_IN_REPO` will be put into a directory having
+  `DESTINATION_PATH` path. If the directory doesn't exist, it will be
+  automatically created.

package/dist/git-dl.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { prettyPrint } from 'effect-errors';
+import * as CliConfig from '@effect/cli/CliConfig';
+import * as CliCommand from '@effect/cli/Command';
+import * as HelpDocSpan from '@effect/cli/HelpDoc/Span';
+import * as NodeFileSystem from '@effect/platform-node/NodeFileSystem';
+import * as NodePath from '@effect/platform-node/NodePath';
+import * as NodeRuntime from '@effect/platform-node/NodeRuntime';
+import * as NodeTerminal from '@effect/platform-node/NodeTerminal';
+import * as Effect from 'effect/Effect';
+import { pipe } from 'effect/Function';
+import * as Layer from 'effect/Layer';
+import pkg from './package.json' with { type: 'json' };
+import { destinationPathCLIOptionBackedByEnv, gitRefCLIOptionBackedByEnv, pathToEntityInRepoCLIOptionBackedByEnv, repoNameCLIOptionBackedByEnv, repoOwnerCLIOptionBackedByEnv, } from "./src/commandLineParams.js";
+import { downloadEntityFromRepo } from "./src/downloadEntityFromRepo.js";
+import { OctokitLayer } from "./src/octokit.js";
+const appCommand = CliCommand.make(pkg.name, {
+    repo: {
+        owner: repoOwnerCLIOptionBackedByEnv,
+        name: repoNameCLIOptionBackedByEnv,
+    },
+    pathToEntityInRepo: pathToEntityInRepoCLIOptionBackedByEnv,
+    localPathAtWhichEntityFromRepoWillBeAvailable: destinationPathCLIOptionBackedByEnv,
+    gitRef: gitRefCLIOptionBackedByEnv,
+}, downloadEntityFromRepo);
+const cli = CliCommand.run(appCommand, {
+    name: pkg.name,
+    version: pkg.version,
+    summary: HelpDocSpan.text(pkg.description),
+});
+const AppLayer = Layer.mergeAll(NodeFileSystem.layer, NodePath.layer, NodeTerminal.layer, CliConfig.layer({ showTypes: false }), OctokitLayer({
+// auth: getEnvVarOrFail('GITHUB_ACCESS_TOKEN'),
+}));
+pipe(process.argv, cli, Effect.withSpan('cli', {
+    attributes: {
+        name: pkg.name,
+        version: pkg.version,
+    },
+}), Effect.sandbox, Effect.catchAll(e => {
+    console.error(prettyPrint(e));
+    return Effect.fail(e);
+}), Effect.provide(AppLayer), NodeRuntime.runMain({ disableErrorReporting: true }));
+//# sourceMappingURL=git-dl.js.map

package/dist/git-dl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-dl.js","sourceRoot":"","sources":["../git-dl.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,cAAc,MAAM,sCAAsC,CAAA;AACtE,OAAO,KAAK,QAAQ,MAAM,gCAAgC,CAAA;AAC1D,OAAO,KAAK,WAAW,MAAM,mCAAmC,CAAA;AAChE,OAAO,KAAK,YAAY,MAAM,oCAAoC,CAAA;AAClE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACtD,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC1B,sCAAsC,EACtC,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAChC,GAAG,CAAC,IAAI,EACR;IACE,IAAI,EAAE;QACJ,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,4BAA4B;KACnC;IACD,kBAAkB,EAAE,sCAAsC;IAC1D,6CAA6C,EAC3C,mCAAmC;IACrC,MAAM,EAAE,0BAA0B;CACnC,EACD,sBAAsB,CACvB,CAAA;AAED,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE;IACrC,IAAI,EAAE,GAAG,CAAC,IAAI;IACd,OAAO,EAAE,GAAG,CAAC,OAAO;IACpB,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;CAC3C,CAAC,CAAA;AAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAC7B,cAAc,CAAC,KAAK,EACpB,QAAQ,CAAC,KAAK,EACd,YAAY,CAAC,KAAK,EAClB,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EACrC,YAAY,CAAC;AACX,gDAAgD;CACjD,CAAC,CACH,CAAA;AAED,IAAI,CACF,OAAO,CAAC,IAAI,EACZ,GAAG,EACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;IACrB,UAAU,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB;CACF,CAAC,EACF,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAE7B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACvB,CAAC,CAAC,EACF,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EACxB,WAAW,CAAC,OAAO,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CACrD,CAAA"}

package/dist/package.json

@@ -0,0 +1,138 @@
+{
+    "name": "git-dl",
+    "type": "module",
+    "version": "0.2.0",
+    "description": "Download any directory at any depth from any repo on GitHub on any git ref",
+    "devDependencies": {
+        "@effect/language-service": "catalog:",
+        "@effect/vitest": "catalog:",
+        "@evadev/tsconfig": "workspace:*",
+        "@rollup/plugin-commonjs": "catalog:",
+        "@rollup/plugin-json": "catalog:",
+        "@rollup/plugin-node-resolve": "catalog:",
+        "@rollup/plugin-terser": "catalog:",
+        "@vitest/coverage-v8": "catalog:",
+        "rollup": "catalog:",
+        "rollup-plugin-visualizer": "catalog:",
+        "ts-namespace-import": "catalog:",
+        "ts-patch": "catalog:",
+        "typescript": "catalog:",
+        "vitest": "catalog:"
+    },
+    "peerDependencies": {
+        "@effect/cli": "catalog:",
+        "@effect/platform": "catalog:",
+        "@effect/platform-node": "catalog:",
+        "effect": "catalog:"
+    },
+    "dependencies": {
+        "@evadev/effect-helpers": "workspace:*",
+        "@octokit/core": "catalog:",
+        "@octokit/request-error": "catalog:",
+        "@octokit/types": "catalog:",
+        "@total-typescript/ts-reset": "catalog:",
+        "@types/tar-fs": "catalog:",
+        "effect-errors": "catalog:",
+        "outdent": "catalog:",
+        "tar-fs": "catalog:",
+        "tsafe": "catalog:"
+    },
+    "homepage": "https://github.com/nikelborm/effect-garden/tree/main/packages/git-dl#readme",
+    "bugs": {
+        "url": "https://github.com/nikelborm/effect-garden/issues",
+        "email": "evadev@duck.com"
+    },
+    "keywords": [
+        "github",
+        "git",
+        "octokit",
+        "github-api",
+        "folder",
+        "scraper",
+        "downloader",
+        "download",
+        "extract",
+        "tarball",
+        "targz",
+        "directory"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+ssh://git@github.com/nikelborm/effect-garden.git",
+        "directory": "packages/git-dl"
+    },
+    "scripts": {
+        "build": "./scripts/build.sh",
+        "coverage": "vitest run --coverage",
+        "doc": "./scripts/generate_docs.sh",
+        "docs": "./scripts/generate_docs.sh",
+        "print-important-ts-files": "find . -type f -name '*.ts' |grep -vE '^./(node_modules|tmp|dist|(vite\\.config|.*\\.spec|scratchpad)\\.ts)'",
+        "scratchpad": "node --use-strict --env-file=.env ./scratchpad.ts",
+        "start": "node --env-file=.env ./git-dl.ts",
+        "test": "vitest --typecheck --watch",
+        "test-jsr": "tspc && jsr publish --dry-run",
+        "test-once": "vitest --run",
+        "watch-docs": "find src/ cli.ts index.ts errors.ts ./scripts/generate_docs.sh | entr -can ./scripts/generate_docs.sh"
+    },
+    "author": {
+        "name": "nikelborm",
+        "email": "evadev@duck.com",
+        "url": "https://github.com/nikelborm"
+    },
+    "contributors": [
+        {
+            "name": "nikelborm",
+            "email": "evadev@duck.com",
+            "url": "https://github.com/nikelborm"
+        }
+    ],
+    "maintainers": [
+        {
+            "name": "nikelborm",
+            "email": "evadev@duck.com",
+            "url": "https://github.com/nikelborm"
+        }
+    ],
+    "license": "MIT",
+    "private": false,
+    "publishConfig": {
+        "access": "public",
+        "provenance": false
+    },
+    "exports": {
+        ".": {
+            "types": "./dist-types/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./*.js": {
+            "types": "./dist-types/src/*.d.ts",
+            "default": "./dist/src/*.js"
+        },
+        "./*.ts": "./src/*.ts",
+        "./*": {
+            "types": "./dist-types/src/*.d.ts",
+            "default": "./dist/src/*.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist-types/index.d.ts",
+    "bin": {
+        "gdl": "dist/git-dl.js",
+        "git-dl": "dist/git-dl.js"
+    },
+    "files": [
+        "dist",
+        "dist-types",
+        "index.ts",
+        "cli.ts",
+        "errors.ts",
+        "template.env",
+        "src",
+        "!dist/minified",
+        "!**/*.tsbuildinfo",
+        "!**/*.spec.*",
+        "!**/scratchpad.*"
+    ]
+}

package/dist/src/TaggedErrorVerifyingCause.js

@@ -0,0 +1,27 @@
+import * as Data from 'effect/Data';
+import * as Predicate from 'effect/Predicate';
+const removeLastIfItIsEmptyObject = (arr) => Object.keys(arr.at(-1) ?? {}).length ? arr : arr.slice(0, -1);
+export const buildTaggedErrorClassVerifyingCause = () => (errorName, customMessage, expectedCauseClass, staticContext) => {
+    // TODO: Consider using Schema.TaggedError instead of Data.TaggedError
+    const CustomTaggedErrorClass = (Data.TaggedError(errorName));
+    class Base extends CustomTaggedErrorClass {
+        constructor(...args) {
+            if (expectedCauseClass && !(args[0] instanceof expectedCauseClass))
+                throw new Error(`Provided cause of incorrect type to "${errorName}" class. Expected cause class: "${expectedCauseClass.name}"`);
+            const customMessageRendererArgs = removeLastIfItIsEmptyObject(expectedCauseClass
+                ? [args[0], { ...(args[1] ?? {}), ...staticContext }]
+                : [{ ...(args[0] ?? {}), ...staticContext }]);
+            super({
+                name: errorName,
+                message: Predicate.isFunction(customMessage)
+                    ? customMessage(...customMessageRendererArgs)
+                    : customMessage,
+                ...(!!expectedCauseClass && { cause: args[0] }),
+                ...staticContext,
+                ...(args[+!!expectedCauseClass] ?? {}), // dynamic context
+            });
+        }
+    }
+    return Base;
+};
+//# sourceMappingURL=TaggedErrorVerifyingCause.js.map

package/dist/src/TaggedErrorVerifyingCause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaggedErrorVerifyingCause.js","sourceRoot":"","sources":["../../src/TaggedErrorVerifyingCause.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAA;AAE7C,MAAM,2BAA2B,GAAG,CAAC,GAAmB,EAAE,EAAE,CAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,mCAAmC,GAC9C,GAA8D,EAAE,CAChE,CAWE,SAAoB,EACpB,aAA0E,EAC1E,kBAAuC,EACvC,aAA6B,EACH,EAAE;IAC5B,sEAAsE;IACtE,MAAM,sBAAsB,GAAG,CAAA,IAAI,CAAC,WAAW,CAAC,SAAS,CAExD,CAAA,CAAA;IAED,MAAM,IAAK,SAAQ,sBAAsB;QACvC,YAAY,GAAG,IAA6B;YAC1C,IAAI,kBAAkB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,kBAAkB,CAAC;gBAChE,MAAM,IAAI,KAAK,CACb,wCACE,SACF,mCAAmC,kBAAkB,CAAC,IAAI,GAAG,CAC9D,CAAA;YAEH,MAAM,yBAAyB,GAAG,2BAA2B,CAC3D,kBAAkB;gBAChB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,aAAa,EAAE,CAAC;gBACrD,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,aAAa,EAAE,CAAC,CAChB,CAAA;YAEhC,KAAK,CAAC;gBACJ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC;oBAC1C,CAAC,CAAC,aAAa,CAAC,GAAG,yBAAyB,CAAC;oBAC7C,CAAC,CAAC,aAAa;gBACjB,GAAG,CAAC,CAAC,CAAC,kBAAkB,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,aAAa;gBAChB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,EAAE,kBAAkB;aAC3D,CAAC,CAAA;QACJ,CAAC;KACF;IAED,OAAO,IAAgC,CAAA;AACzC,CAAC,CAAA"}

package/dist/src/castToReadableStream.js

@@ -0,0 +1,28 @@
+import { Readable } from 'node:stream';
+import { ReadableStream } from 'node:stream/web';
+import * as Effect from 'effect/Effect';
+import { buildTaggedErrorClassVerifyingCause, } from "./TaggedErrorVerifyingCause.js";
+// TODO: should eventually delete this shit because:
+// 1. Effect has streams and I now know them well
+// 2. Effect has Platform's utilities like BunSink and BunStream
+export const CastToReadableStream = (self) => Effect.gen(function* () {
+    const data = yield* self;
+    if (data instanceof ArrayBuffer || data instanceof Buffer)
+        return new Readable({
+            read() {
+                this.push(data);
+                this.push(null);
+            },
+        });
+    if (data instanceof ReadableStream)
+        return Readable.fromWeb(data);
+    if (data instanceof Readable)
+        return data;
+    return yield* new FailedToCastDataToReadableStreamError();
+});
+// Extracting to a separate type is required by JSR, so that consumers of the
+// library will have much faster type inference
+const _1 = buildTaggedErrorClassVerifyingCause()('FailedToCastDataToReadableStreamError', 'Error: Failed to cast data to Readable stream, type of argument is not familiar');
+export class FailedToCastDataToReadableStreamError extends _1 {
+}
+//# sourceMappingURL=castToReadableStream.js.map

package/dist/src/castToReadableStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castToReadableStream.js","sourceRoot":"","sources":["../../src/castToReadableStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EACL,mCAAmC,GAEpC,MAAM,gCAAgC,CAAA;AAEvC,oDAAoD;AACpD,iDAAiD;AACjD,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAkC,EAClC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAA;IAExB,IAAI,IAAI,YAAY,WAAW,IAAI,IAAI,YAAY,MAAM;QACvD,OAAO,IAAI,QAAQ,CAAC;YAClB,IAAI;gBACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACf,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,CAAC;SACF,CAAC,CAAA;IAEJ,IAAI,IAAI,YAAY,cAAc;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjE,IAAI,IAAI,YAAY,QAAQ;QAAE,OAAO,IAAI,CAAA;IAEzC,OAAO,KAAK,CAAC,CAAC,IAAI,qCAAqC,EAAE,CAAA;AAC3D,CAAC,CAAC,CAAA;AAEJ,6EAA6E;AAC7E,+CAA+C;AAC/C,MAAM,EAAE,GAEH,mCAAmC,EAAE,CACxC,uCAAuC,EACvC,iFAAiF,CAClF,CAAA;AAED,MAAM,OAAO,qCAAsC,SAAQ,EAAE;CAAG"}

package/dist/src/cli.js

@@ -0,0 +1,8 @@
+/**
+ * Reusable in {@link https://effect.website/ Effect} applications CLI Options
+ * backed by ENV variables
+ *
+ * @module
+ */
+export { destinationPathCLIOptionBackedByEnv, gitRefCLIOptionBackedByEnv, pathToEntityInRepoCLIOptionBackedByEnv, repoNameCLIOptionBackedByEnv, repoOwnerCLIOptionBackedByEnv, } from "./commandLineParams.js";
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,mCAAmC,EACnC,0BAA0B,EAC1B,sCAAsC,EACtC,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,wBAAwB,CAAA"}