@heronlabs/terminal-cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HeronLabs
+
+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,207 @@
+# 🪶 terminal-cli — Heron CLI (`hcli`)
+
+[![CI](https://github.com/heronlabs/terminal-cli/actions/workflows/ci-cli.yml/badge.svg)](https://github.com/heronlabs/terminal-cli/actions/workflows/ci-cli.yml)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.8.x-blue.svg)](https://www.typescriptlang.org/)
+[![NestJS](https://img.shields.io/badge/NestJS-11.x-e0234e.svg)](https://nestjs.com/)
+[![Node.js](https://img.shields.io/badge/Node.js-22+-green.svg)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
+Database backup & rollup CLI for PostgreSQL and MySQL. Dumps a database to a
+gzipped SQL file, uploads it to S3 (or keeps it local), and restores it back on
+demand. Built with NestJS + [nest-commander](https://nest-commander.jaymcdoniel.dev/),
+AWS S3, and Luxon. Designed to run as a scheduled cron container on EasyPanel.
+
+## Table of Contents
+
+- [Why This Project](#why-this-project)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+- [Configuration](#configuration)
+- [Architecture](#architecture)
+- [Docker & Cron](#docker--cron)
+- [Testing](#testing)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Why This Project
+
+Scheduled, type-safe database backups with a single binary:
+
+- **One tool, two engines** — PostgreSQL (`pg_dump`/`psql`) and MySQL (`mysqldump`/`mysql`) behind one CLI.
+- **S3 or local** — push backups to S3 by default, or keep them on disk with `--local` (handy for seeding).
+- **Cron-ready containers** — purpose-built Dockerfiles run a backup on start and every 12 hours.
+- **100% tested** — v8 coverage + Stryker mutation testing, both at 100% thresholds.
+
+## Quick Start
+
+### Prerequisites
+
+| Requirement | Version | Purpose |
+|-------------|---------|---------|
+| Node.js | `>=22` | Runtime |
+| pnpm | `>=10.29.3` | Package manager |
+| `pg_dump` / `psql` | — | PostgreSQL backup/restore |
+| `mysqldump` / `mysql` | — | MySQL backup/restore |
+
+### Installation
+
+```bash
+git clone https://github.com/heronlabs/terminal-cli.git
+cd terminal-cli
+pnpm install
+pnpm build         # nest build → bin/
+```
+
+After `pnpm build`, run the CLI via `node bin/src/main.js <command>` or link the
+`hcli` bin (`pnpm link --global`).
+
+### Verify
+
+```bash
+pnpm build         # nest build → bin/
+pnpm lint:check    # gts + eslint
+pnpm test:unit     # vitest run (100% coverage)
+pnpm test:mutation # stryker (100% break)
+pnpm dep:cruise    # architecture check
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `hcli psql-backup` | Back up a PostgreSQL database (S3 by default) |
+| `hcli psql-rollup --filename <file>` | Restore a PostgreSQL database from a backup |
+| `hcli mysql-backup` | Back up a MySQL database (S3 by default) |
+| `hcli mysql-rollup --filename <file>` | Restore a MySQL database from a backup |
+| `hcli version` | Print the current version |
+
+### Flags
+
+| Flag | Applies to | Meaning |
+|---|---|---|
+| `-f, --filename <name>` | all | Backup filename. Backup defaults to `<database>-<timestamp>.sql.gz`; rollup requires it. |
+| `--local` | all | Read/write the backup on the local filesystem instead of S3. |
+
+Examples:
+
+```bash
+# Back up to S3 with an auto-generated, timestamped filename
+hcli psql-backup
+
+# Back up to a local file (no S3)
+hcli psql-backup --local --filename seed.sql.gz
+
+# Restore from a local file
+hcli psql-rollup --local --filename seed.sql.gz
+
+# Restore from S3
+hcli mysql-rollup --filename mydb-2026-03-05T12-00-00Z.sql.gz
+```
+
+## Configuration
+
+All configuration comes from environment variables (see [.env.example](./.env.example)).
+
+| Variable | Required | Description |
+|---|---|---|
+| `DB_HOST` | ✅ | Database host |
+| `DB_PORT` | ✅ | Database port |
+| `DB_NAME` | ✅ | Database name |
+| `DB_USER` | ✅ | Database user |
+| `DB_PASSWORD` | ✅ | Database password |
+| `AWS_S3_BUCKET_NAME` | for S3 | Destination bucket for remote backups |
+| `AWS_REGION` | for S3 | AWS region |
+| `AWS_ACCESS_KEY_ID` | for S3 | AWS credentials (or use an instance role) |
+| `AWS_SECRET_ACCESS_KEY` | for S3 | AWS credentials (or use an instance role) |
+
+Locally, `pnpm start -- <command>` loads variables from a `.env` file via `dotenv`.
+
+## Architecture
+
+Hexagonal NestJS layering:
+
+```
+src/
+├── application/          # CLI surface (nest-commander)
+│   └── cli/
+│       ├── cli-module.ts
+│       └── commands/     # backup/, rollup/, version/ + per-command option types
+├── core/                 # domain logic
+│   ├── interfaces/       # BackupService / RollupService abstract base services
+│   └── services/         # {mysql,psql}-{backup,rollup}-service
+└── infrastructure/       # adapters
+    ├── environment/      # EnvironmentService (ConfigService wrapper)
+    ├── log/              # nestjs-pino logger module
+    └── storage/          # S3StorageService (AWS SDK v3)
+```
+
+- **`application/`** wires commands into modules — the composition root.
+- **`core/`** holds the backup/rollup flow. The abstract `BackupService`/`RollupService`
+  own the S3 upload/download + local-cleanup orchestration; engine subclasses implement
+  the `dump`/`restore` shell commands.
+- **`infrastructure/`** adapters never import inward (enforced by `pnpm dep:cruise`).
+
+## Docker & Cron
+
+Three Dockerfiles:
+
+| File | Purpose |
+|---|---|
+| `Dockerfile` | General-purpose image with `hcli` on `PATH` and both DB clients |
+| `cron-tab-postgres.dockerfile` | PostgreSQL cron container — backup on start + every 12h |
+| `cron-tab-mysql.dockerfile` | MySQL cron container — backup on start + every 12h |
+
+The cron images dump `printenv` to `/etc/environment` so `crond` inherits the
+runtime variables injected by EasyPanel, run an immediate backup, then start
+`crond` in the foreground.
+
+Local stack for manual testing:
+
+```bash
+docker compose up        # spins up psql + mysql DBs and CLI containers
+```
+
+## Testing
+
+| Detail | Value |
+|---|---|
+| Framework | Vitest 4.x (`vitest.config.ts`, SWC transform for decorators) |
+| Test location | `tests/specs/` (mirrors `src/`) |
+| Shared mocks | `tests/__mocks__/create-testing-module.ts` (moq.ts + vitest) |
+| Coverage | v8, 100% lines/functions/branches/statements |
+| Coverage excludes | `**/main.ts`, `**/*.d.ts`, `**/*factory.ts`, `**/types/` |
+| Mutation | Stryker 9.x (`stryker.conf.json`), 100% break threshold |
+| Mutation scope | `src/**/*.ts` excluding `main.ts`, `*.d.ts`, `*factory.ts`, `*-module.ts` |
+
+```bash
+pnpm test:unit      # vitest run with coverage
+pnpm test:mutation  # stryker mutation testing
+```
+
+## Contributing
+
+```bash
+pnpm lint:check   # check
+pnpm lint:fix     # auto-fix
+pnpm build        # verify compilation
+pnpm test:unit    # verify tests pass at 100% coverage
+pnpm dep:cruise   # verify architecture
+```
+
+Conventional Commits:
+
+```
+feat: add mongodb backup engine
+fix: handle empty database name in psql dump
+test: cover s3 download error path
+```
+
+- All work branches from `main`; PRs target `main`. Never commit directly to `main`.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built by [HeronLabs](https://github.com/heronlabs)

package/bin/src/application/cli/cli-module.js

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliModule = exports.cliModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_module_1 = require("../../core/core-module");
+const log_module_1 = require("../../infrastructure/log/log-module");
+const mysql_backup_command_1 = require("./commands/backup/mysql-backup-command");
+const psql_backup_command_1 = require("./commands/backup/psql-backup-command");
+const mysql_rollup_command_1 = require("./commands/rollup/mysql-rollup-command");
+const psql_rollup_command_1 = require("./commands/rollup/psql-rollup-command");
+const version_command_1 = require("./commands/version/version-command");
+exports.cliModule = {
+    imports: [log_module_1.LogModule, core_module_1.CoreModule],
+    providers: [
+        common_1.Logger,
+        version_command_1.VersionCommand,
+        psql_backup_command_1.PsqlBackupCommand,
+        psql_rollup_command_1.PsqlRollupCommand,
+        mysql_backup_command_1.MysqlBackupCommand,
+        mysql_rollup_command_1.MysqlRollupCommand,
+    ],
+};
+let CliModule = class CliModule {
+};
+exports.CliModule = CliModule;
+exports.CliModule = CliModule = __decorate([
+    (0, common_1.Module)(exports.cliModule)
+], CliModule);

package/bin/src/application/cli/commands/backup/mysql-backup-command.js

@@ -0,0 +1,57 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlBackupCommand = void 0;
+const nest_commander_1 = require("nest-commander");
+const mysql_backup_service_1 = require("../../../../core/services/mysql-backup-service");
+const backup_options_1 = require("./types/backup-options");
+let MysqlBackupCommand = class MysqlBackupCommand extends nest_commander_1.CommandRunner {
+    mysqlBackupService;
+    parseFilename(val) {
+        return val;
+    }
+    parseLocal() {
+        return true;
+    }
+    async run(_args, options) {
+        await this.mysqlBackupService.run(options?.[backup_options_1.BackupOptionsKeys.LOCAL] ?? false, options?.[backup_options_1.BackupOptionsKeys.FILENAME]);
+    }
+    constructor(mysqlBackupService) {
+        super();
+        this.mysqlBackupService = mysqlBackupService;
+    }
+};
+exports.MysqlBackupCommand = MysqlBackupCommand;
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `-f, --${backup_options_1.BackupOptionsKeys.FILENAME} <filename>`,
+        description: 'Output filename (e.g. seed.sql.gz). Defaults to "<database>-<timestamp>.sql.gz"',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", String)
+], MysqlBackupCommand.prototype, "parseFilename", null);
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `--${backup_options_1.BackupOptionsKeys.LOCAL}`,
+        description: 'Save backup to the local filesystem instead of S3 (default: S3)',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Boolean)
+], MysqlBackupCommand.prototype, "parseLocal", null);
+exports.MysqlBackupCommand = MysqlBackupCommand = __decorate([
+    (0, nest_commander_1.Command)({
+        name: 'mysql-backup',
+        description: 'Backup MySQL database',
+    }),
+    __metadata("design:paramtypes", [mysql_backup_service_1.MysqlBackupService])
+], MysqlBackupCommand);

package/bin/src/application/cli/commands/backup/psql-backup-command.js

@@ -0,0 +1,57 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsqlBackupCommand = void 0;
+const nest_commander_1 = require("nest-commander");
+const psql_backup_service_1 = require("../../../../core/services/psql-backup-service");
+const backup_options_1 = require("./types/backup-options");
+let PsqlBackupCommand = class PsqlBackupCommand extends nest_commander_1.CommandRunner {
+    psqlBackupService;
+    parseFilename(val) {
+        return val;
+    }
+    parseLocal() {
+        return true;
+    }
+    async run(_args, options) {
+        await this.psqlBackupService.run(options?.[backup_options_1.BackupOptionsKeys.LOCAL] ?? false, options?.[backup_options_1.BackupOptionsKeys.FILENAME]);
+    }
+    constructor(psqlBackupService) {
+        super();
+        this.psqlBackupService = psqlBackupService;
+    }
+};
+exports.PsqlBackupCommand = PsqlBackupCommand;
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `-f, --${backup_options_1.BackupOptionsKeys.FILENAME} <filename>`,
+        description: 'Output filename (e.g. seed.sql.gz). Defaults to "<database>-<timestamp>.sql.gz"',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", String)
+], PsqlBackupCommand.prototype, "parseFilename", null);
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `--${backup_options_1.BackupOptionsKeys.LOCAL}`,
+        description: 'Save backup to the local filesystem instead of S3 (default: S3)',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Boolean)
+], PsqlBackupCommand.prototype, "parseLocal", null);
+exports.PsqlBackupCommand = PsqlBackupCommand = __decorate([
+    (0, nest_commander_1.Command)({
+        name: 'psql-backup',
+        description: 'Backup PostgreSQL database',
+    }),
+    __metadata("design:paramtypes", [psql_backup_service_1.PsqlBackupService])
+], PsqlBackupCommand);

package/bin/src/application/cli/commands/backup/types/backup-options.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackupOptionsKeys = void 0;
+var BackupOptionsKeys;
+(function (BackupOptionsKeys) {
+    BackupOptionsKeys["FILENAME"] = "filename";
+    BackupOptionsKeys["LOCAL"] = "local";
+})(BackupOptionsKeys || (exports.BackupOptionsKeys = BackupOptionsKeys = {}));

package/bin/src/application/cli/commands/rollup/mysql-rollup-command.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlRollupCommand = void 0;
+const nest_commander_1 = require("nest-commander");
+const mysql_rollup_service_1 = require("../../../../core/services/mysql-rollup-service");
+const rollup_options_1 = require("./types/rollup-options");
+let MysqlRollupCommand = class MysqlRollupCommand extends nest_commander_1.CommandRunner {
+    mysqlRollupService;
+    parseFilename(val) {
+        return val;
+    }
+    parseLocal() {
+        return true;
+    }
+    async run(_args, options) {
+        await this.mysqlRollupService.run(options[rollup_options_1.RollupOptionsKeys.FILENAME], options[rollup_options_1.RollupOptionsKeys.LOCAL] ?? false);
+    }
+    constructor(mysqlRollupService) {
+        super();
+        this.mysqlRollupService = mysqlRollupService;
+    }
+};
+exports.MysqlRollupCommand = MysqlRollupCommand;
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `-f, --${rollup_options_1.RollupOptionsKeys.FILENAME} <filename>`,
+        description: 'Backup filename to restore (e.g. mydb-2026-03-05T12-00-00Z.sql.gz)',
+        required: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", String)
+], MysqlRollupCommand.prototype, "parseFilename", null);
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `--${rollup_options_1.RollupOptionsKeys.LOCAL}`,
+        description: 'Read backup from the local filesystem instead of S3 (default: S3)',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Boolean)
+], MysqlRollupCommand.prototype, "parseLocal", null);
+exports.MysqlRollupCommand = MysqlRollupCommand = __decorate([
+    (0, nest_commander_1.Command)({
+        name: 'mysql-rollup',
+        description: 'Restore a MySQL database from a backup file (S3 by default, or local filesystem with --local)',
+    }),
+    __metadata("design:paramtypes", [mysql_rollup_service_1.MysqlRollupService])
+], MysqlRollupCommand);

package/bin/src/application/cli/commands/rollup/psql-rollup-command.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsqlRollupCommand = void 0;
+const nest_commander_1 = require("nest-commander");
+const psql_rollup_service_1 = require("../../../../core/services/psql-rollup-service");
+const rollup_options_1 = require("./types/rollup-options");
+let PsqlRollupCommand = class PsqlRollupCommand extends nest_commander_1.CommandRunner {
+    psqlRollupService;
+    parseFilename(val) {
+        return val;
+    }
+    parseLocal() {
+        return true;
+    }
+    async run(_args, options) {
+        await this.psqlRollupService.run(options[rollup_options_1.RollupOptionsKeys.FILENAME], options[rollup_options_1.RollupOptionsKeys.LOCAL] ?? false);
+    }
+    constructor(psqlRollupService) {
+        super();
+        this.psqlRollupService = psqlRollupService;
+    }
+};
+exports.PsqlRollupCommand = PsqlRollupCommand;
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `-f, --${rollup_options_1.RollupOptionsKeys.FILENAME} <filename>`,
+        description: 'Backup filename to restore (e.g. mydb-2026-03-05T12-00-00Z.sql.gz)',
+        required: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", String)
+], PsqlRollupCommand.prototype, "parseFilename", null);
+__decorate([
+    (0, nest_commander_1.Option)({
+        flags: `--${rollup_options_1.RollupOptionsKeys.LOCAL}`,
+        description: 'Read backup from the local filesystem instead of S3 (default: S3)',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Boolean)
+], PsqlRollupCommand.prototype, "parseLocal", null);
+exports.PsqlRollupCommand = PsqlRollupCommand = __decorate([
+    (0, nest_commander_1.Command)({
+        name: 'psql-rollup',
+        description: 'Restore a PostgreSQL database from a backup file (S3 by default, or local filesystem with --local)',
+    }),
+    __metadata("design:paramtypes", [psql_rollup_service_1.PsqlRollupService])
+], PsqlRollupCommand);

package/bin/src/application/cli/commands/rollup/types/rollup-options.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RollupOptionsKeys = void 0;
+var RollupOptionsKeys;
+(function (RollupOptionsKeys) {
+    RollupOptionsKeys["FILENAME"] = "filename";
+    RollupOptionsKeys["LOCAL"] = "local";
+})(RollupOptionsKeys || (exports.RollupOptionsKeys = RollupOptionsKeys = {}));

package/bin/src/application/cli/commands/version/version-command.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionCommand = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const common_1 = require("@nestjs/common");
+const nest_commander_1 = require("nest-commander");
+let VersionCommand = class VersionCommand extends nest_commander_1.CommandRunner {
+    logger;
+    async run() {
+        const path = (0, node_path_1.join)(__dirname, '../../../../../../package.json');
+        const { version } = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf-8'));
+        this.logger.log(`Current Version: ${version}`);
+    }
+    constructor(logger) {
+        super();
+        this.logger = logger;
+    }
+};
+exports.VersionCommand = VersionCommand;
+exports.VersionCommand = VersionCommand = __decorate([
+    (0, nest_commander_1.Command)({ name: 'version', description: 'Print current version' }),
+    __metadata("design:paramtypes", [common_1.Logger])
+], VersionCommand);

package/bin/src/core/core-module.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreModule = void 0;
+const common_1 = require("@nestjs/common");
+const environment_module_1 = require("../infrastructure/environment/environment-module");
+const storage_module_1 = require("../infrastructure/storage/storage-module");
+const mysql_backup_service_1 = require("./services/mysql-backup-service");
+const mysql_rollup_service_1 = require("./services/mysql-rollup-service");
+const psql_backup_service_1 = require("./services/psql-backup-service");
+const psql_rollup_service_1 = require("./services/psql-rollup-service");
+const coreModule = {
+    imports: [environment_module_1.EnvironmentModule, storage_module_1.StorageModule],
+    providers: [
+        common_1.Logger,
+        mysql_backup_service_1.MysqlBackupService,
+        mysql_rollup_service_1.MysqlRollupService,
+        psql_backup_service_1.PsqlBackupService,
+        psql_rollup_service_1.PsqlRollupService,
+    ],
+    exports: [
+        mysql_backup_service_1.MysqlBackupService,
+        mysql_rollup_service_1.MysqlRollupService,
+        psql_backup_service_1.PsqlBackupService,
+        psql_rollup_service_1.PsqlRollupService,
+    ],
+};
+let CoreModule = class CoreModule {
+};
+exports.CoreModule = CoreModule;
+exports.CoreModule = CoreModule = __decorate([
+    (0, common_1.Module)(coreModule)
+], CoreModule);

package/bin/src/core/interfaces/backup-service.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackupService = void 0;
+const fs_1 = require("fs");
+class BackupService {
+    logger;
+    s3StorageService;
+    async run(local, filename) {
+        const result = this.dump(filename);
+        if (!result.ok) {
+            this.logger.error(result.error.message);
+            return;
+        }
+        if (local) {
+            return { ok: true };
+        }
+        const { error: uploadError } = await this.s3StorageService.upload(result.data.backupFileName);
+        if (uploadError) {
+            this.logger.error(uploadError.message);
+            return;
+        }
+        (0, fs_1.unlinkSync)(result.data.backupFileName);
+        this.logger.log('Deleted local backup file');
+        return { ok: true };
+    }
+    constructor(logger, s3StorageService) {
+        this.logger = logger;
+        this.s3StorageService = s3StorageService;
+    }
+}
+exports.BackupService = BackupService;

package/bin/src/core/interfaces/rollup-service.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RollupService = void 0;
+const fs_1 = require("fs");
+class RollupService {
+    logger;
+    s3StorageService;
+    async run(filename, local) {
+        if (!local) {
+            const { error: downloadError } = await this.s3StorageService.download(filename);
+            if (downloadError) {
+                this.logger.error(downloadError.message);
+                return;
+            }
+        }
+        const result = this.restore(filename);
+        if (!result.ok) {
+            this.logger.error(result.error.message);
+            return;
+        }
+        this.logger.log(`Restored ${result.data.backupFileName}`);
+        if (!local) {
+            (0, fs_1.unlinkSync)(filename);
+            this.logger.log('Deleted downloaded backup file');
+        }
+    }
+    constructor(logger, s3StorageService) {
+        this.logger = logger;
+        this.s3StorageService = s3StorageService;
+    }
+}
+exports.RollupService = RollupService;

package/bin/src/core/services/mysql-backup-service.js

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlBackupService = void 0;
+const common_1 = require("@nestjs/common");
+const child_process_1 = require("child_process");
+const luxon_1 = require("luxon");
+const environment_service_1 = require("../../infrastructure/environment/services/environment-service");
+const s3_storage_service_1 = require("../../infrastructure/storage/services/s3-storage-service");
+const backup_service_1 = require("../interfaces/backup-service");
+let MysqlBackupService = class MysqlBackupService extends backup_service_1.BackupService {
+    logger;
+    environmentService;
+    s3StorageService;
+    dump(filename) {
+        const { host, port, name, user, password } = this.environmentService.database;
+        const timestamp = luxon_1.DateTime.utc().toFormat("yyyy-MM-dd'T'HH-mm-ss'Z'");
+        const backupFileName = filename ?? `${name}-${timestamp}.sql.gz`;
+        try {
+            (0, child_process_1.execSync)('set -o pipefail; mariadb-dump -u "$DB_USER" -h "$DB_HOST" -P "$DB_PORT" "$DB_NAME" | gzip > "$BACKUP_FILE"', {
+                env: {
+                    ...process.env,
+                    DB_USER: user,
+                    DB_HOST: host,
+                    DB_PORT: port,
+                    DB_NAME: name,
+                    MYSQL_PWD: password,
+                    BACKUP_FILE: backupFileName,
+                },
+                stdio: ['inherit', 'pipe', 'inherit'],
+                shell: '/bin/bash',
+            });
+            this.logger.log(`Backup MySQL database successfully! Filename: ${backupFileName}`);
+            return { ok: true, data: { backupFileName } };
+        }
+        catch {
+            return { ok: false, error: new Error('mariadb-dump failed') };
+        }
+    }
+    constructor(logger, environmentService, s3StorageService) {
+        super(logger, s3StorageService);
+        this.logger = logger;
+        this.environmentService = environmentService;
+        this.s3StorageService = s3StorageService;
+    }
+};
+exports.MysqlBackupService = MysqlBackupService;
+exports.MysqlBackupService = MysqlBackupService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [common_1.Logger,
+        environment_service_1.EnvironmentService,
+        s3_storage_service_1.S3StorageService])
+], MysqlBackupService);

package/bin/src/core/services/mysql-rollup-service.js

@@ -0,0 +1,57 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlRollupService = void 0;
+const common_1 = require("@nestjs/common");
+const child_process_1 = require("child_process");
+const environment_service_1 = require("../../infrastructure/environment/services/environment-service");
+const s3_storage_service_1 = require("../../infrastructure/storage/services/s3-storage-service");
+const rollup_service_1 = require("../interfaces/rollup-service");
+let MysqlRollupService = class MysqlRollupService extends rollup_service_1.RollupService {
+    logger;
+    environmentService;
+    s3StorageService;
+    restore(backupFileName) {
+        const { host, port, name, user, password } = this.environmentService.database;
+        try {
+            (0, child_process_1.execSync)('set -o pipefail; gunzip -c "$BACKUP_FILE" | mariadb -u "$DB_USER" -h "$DB_HOST" -P "$DB_PORT" "$DB_NAME"', {
+                env: {
+                    ...process.env,
+                    DB_USER: user,
+                    DB_HOST: host,
+                    DB_PORT: port,
+                    DB_NAME: name,
+                    MYSQL_PWD: password,
+                    BACKUP_FILE: backupFileName,
+                },
+                stdio: ['inherit', 'pipe', 'inherit'],
+                shell: '/bin/bash',
+            });
+            return { ok: true, data: { backupFileName } };
+        }
+        catch {
+            return { ok: false, error: new Error('mariadb restore failed') };
+        }
+    }
+    constructor(logger, environmentService, s3StorageService) {
+        super(logger, s3StorageService);
+        this.logger = logger;
+        this.environmentService = environmentService;
+        this.s3StorageService = s3StorageService;
+    }
+};
+exports.MysqlRollupService = MysqlRollupService;
+exports.MysqlRollupService = MysqlRollupService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [common_1.Logger,
+        environment_service_1.EnvironmentService,
+        s3_storage_service_1.S3StorageService])
+], MysqlRollupService);

package/bin/src/core/services/psql-backup-service.js

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsqlBackupService = void 0;
+const common_1 = require("@nestjs/common");
+const child_process_1 = require("child_process");
+const luxon_1 = require("luxon");
+const environment_service_1 = require("../../infrastructure/environment/services/environment-service");
+const s3_storage_service_1 = require("../../infrastructure/storage/services/s3-storage-service");
+const backup_service_1 = require("../interfaces/backup-service");
+let PsqlBackupService = class PsqlBackupService extends backup_service_1.BackupService {
+    logger;
+    environmentService;
+    s3StorageService;
+    dump(filename) {
+        const { host, port, name, user, password } = this.environmentService.database;
+        const timestamp = luxon_1.DateTime.utc().toFormat("yyyy-MM-dd'T'HH-mm-ss'Z'");
+        const backupFileName = filename ?? `${name}-${timestamp}.sql.gz`;
+        try {
+            (0, child_process_1.execSync)('set -o pipefail; pg_dump | gzip > "$BACKUP_FILE"', {
+                env: {
+                    ...process.env,
+                    PGHOST: host,
+                    PGPORT: port,
+                    PGDATABASE: name,
+                    PGUSER: user,
+                    PGPASSWORD: password,
+                    BACKUP_FILE: backupFileName,
+                },
+                stdio: ['inherit', 'pipe', 'inherit'],
+                shell: '/bin/bash',
+            });
+            this.logger.log(`Backup PostgreSQL database successfully! Filename: ${backupFileName}`);
+            return { ok: true, data: { backupFileName } };
+        }
+        catch {
+            return { ok: false, error: new Error('pg_dump failed') };
+        }
+    }
+    constructor(logger, environmentService, s3StorageService) {
+        super(logger, s3StorageService);
+        this.logger = logger;
+        this.environmentService = environmentService;
+        this.s3StorageService = s3StorageService;
+    }
+};
+exports.PsqlBackupService = PsqlBackupService;
+exports.PsqlBackupService = PsqlBackupService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [common_1.Logger,
+        environment_service_1.EnvironmentService,
+        s3_storage_service_1.S3StorageService])
+], PsqlBackupService);

package/bin/src/core/services/psql-rollup-service.js

@@ -0,0 +1,57 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsqlRollupService = void 0;
+const common_1 = require("@nestjs/common");
+const child_process_1 = require("child_process");
+const environment_service_1 = require("../../infrastructure/environment/services/environment-service");
+const s3_storage_service_1 = require("../../infrastructure/storage/services/s3-storage-service");
+const rollup_service_1 = require("../interfaces/rollup-service");
+let PsqlRollupService = class PsqlRollupService extends rollup_service_1.RollupService {
+    logger;
+    environmentService;
+    s3StorageService;
+    restore(backupFileName) {
+        const { host, port, name, user, password } = this.environmentService.database;
+        try {
+            (0, child_process_1.execSync)('set -o pipefail; gunzip -c "$BACKUP_FILE" | psql', {
+                env: {
+                    ...process.env,
+                    PGHOST: host,
+                    PGPORT: port,
+                    PGDATABASE: name,
+                    PGUSER: user,
+                    PGPASSWORD: password,
+                    BACKUP_FILE: backupFileName,
+                },
+                stdio: ['inherit', 'pipe', 'inherit'],
+                shell: '/bin/bash',
+            });
+            return { ok: true, data: { backupFileName } };
+        }
+        catch {
+            return { ok: false, error: new Error('psql restore failed') };
+        }
+    }
+    constructor(logger, environmentService, s3StorageService) {
+        super(logger, s3StorageService);
+        this.logger = logger;
+        this.environmentService = environmentService;
+        this.s3StorageService = s3StorageService;
+    }
+};
+exports.PsqlRollupService = PsqlRollupService;
+exports.PsqlRollupService = PsqlRollupService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [common_1.Logger,
+        environment_service_1.EnvironmentService,
+        s3_storage_service_1.S3StorageService])
+], PsqlRollupService);

package/bin/src/infrastructure/environment/environment-module.js

@@ -0,0 +1,23 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentModule = exports.environmentModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const environment_service_1 = require("./services/environment-service");
+exports.environmentModule = {
+    providers: [environment_service_1.EnvironmentService],
+    exports: [environment_service_1.EnvironmentService],
+    imports: [config_1.ConfigModule],
+};
+let EnvironmentModule = class EnvironmentModule {
+};
+exports.EnvironmentModule = EnvironmentModule;
+exports.EnvironmentModule = EnvironmentModule = __decorate([
+    (0, common_1.Module)(exports.environmentModule)
+], EnvironmentModule);

package/bin/src/infrastructure/environment/services/environment-service.js

@@ -0,0 +1,39 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+let EnvironmentService = class EnvironmentService {
+    configService;
+    get database() {
+        return {
+            host: this.configService.getOrThrow('DB_HOST'),
+            port: this.configService.getOrThrow('DB_PORT'),
+            name: this.configService.getOrThrow('DB_NAME'),
+            user: this.configService.getOrThrow('DB_USER'),
+            password: this.configService.getOrThrow('DB_PASSWORD'),
+        };
+    }
+    get storage() {
+        return {
+            bucketName: this.configService.getOrThrow('AWS_S3_BUCKET_NAME'),
+        };
+    }
+    constructor(configService) {
+        this.configService = configService;
+    }
+};
+exports.EnvironmentService = EnvironmentService;
+exports.EnvironmentService = EnvironmentService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], EnvironmentService);

package/bin/src/infrastructure/log/log-module.js

@@ -0,0 +1,21 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogModule = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_pino_1 = require("nestjs-pino");
+const logModule = {
+    imports: [nestjs_pino_1.LoggerModule.forRoot()],
+};
+let LogModule = class LogModule {
+};
+exports.LogModule = LogModule;
+exports.LogModule = LogModule = __decorate([
+    (0, common_1.Module)(logModule),
+    (0, common_1.Global)()
+], LogModule);

package/bin/src/infrastructure/storage/services/s3-storage-service.js

@@ -0,0 +1,72 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3StorageService = void 0;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const common_1 = require("@nestjs/common");
+const fs_1 = require("fs");
+const environment_service_1 = require("../../environment/services/environment-service");
+let S3StorageService = class S3StorageService {
+    logger;
+    environmentService;
+    s3;
+    async upload(filePath, key) {
+        try {
+            const body = (0, fs_1.readFileSync)(filePath);
+            const command = new client_s3_1.PutObjectCommand({
+                Bucket: this.environmentService.storage.bucketName,
+                Key: key ?? filePath,
+                Body: body,
+                ContentType: 'application/octet-stream',
+            });
+            await this.s3.send(command);
+            this.logger.log('Uploaded file to S3');
+            return { ok: true };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { ok: false, error };
+            }
+            return { ok: false, error: new Error('Error uploading file to S3') };
+        }
+    }
+    async download(key) {
+        try {
+            const command = new client_s3_1.GetObjectCommand({
+                Bucket: this.environmentService.storage.bucketName,
+                Key: key,
+            });
+            const response = await this.s3.send(command);
+            const bytes = await response.Body.transformToByteArray();
+            (0, fs_1.writeFileSync)(key, bytes);
+            this.logger.log('Downloaded file from S3');
+            return { ok: true };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { ok: false, error };
+            }
+            return { ok: false, error: new Error('Error downloading file from S3') };
+        }
+    }
+    constructor(logger, environmentService, s3) {
+        this.logger = logger;
+        this.environmentService = environmentService;
+        this.s3 = s3;
+    }
+};
+exports.S3StorageService = S3StorageService;
+exports.S3StorageService = S3StorageService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [common_1.Logger,
+        environment_service_1.EnvironmentService,
+        client_s3_1.S3Client])
+], S3StorageService);

package/bin/src/infrastructure/storage/storage-module.js

@@ -0,0 +1,31 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageModule = exports.storageModule = void 0;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const common_1 = require("@nestjs/common");
+const environment_module_1 = require("../environment/environment-module");
+const s3_storage_service_1 = require("./services/s3-storage-service");
+exports.storageModule = {
+    imports: [environment_module_1.EnvironmentModule],
+    providers: [
+        common_1.Logger,
+        s3_storage_service_1.S3StorageService,
+        {
+            provide: client_s3_1.S3Client,
+            useValue: new client_s3_1.S3Client({}),
+        },
+    ],
+    exports: [s3_storage_service_1.S3StorageService],
+};
+let StorageModule = class StorageModule {
+};
+exports.StorageModule = StorageModule;
+exports.StorageModule = StorageModule = __decorate([
+    (0, common_1.Module)(exports.storageModule)
+], StorageModule);

package/bin/src/main.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const nest_commander_1 = require("nest-commander");
+const nestjs_pino_1 = require("nestjs-pino");
+const cli_module_1 = require("./application/cli/cli-module");
+const bootstrap = async () => {
+    const app = await nest_commander_1.CommandFactory.createWithoutRunning(cli_module_1.CliModule);
+    app.useLogger(app.get(nestjs_pino_1.Logger));
+    await nest_commander_1.CommandFactory.runApplication(app);
+};
+void bootstrap();

package/package.json

@@ -0,0 +1,96 @@
+{
+  "author": "Heron Labs",
+  "bin": {
+    "hcli": "bin/src/main.js"
+  },
+  "bugs": {
+    "url": "https://github.com/heronlabs/terminal-cli/issues"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1045.0",
+    "@nestjs/common": "^11.1.18",
+    "@nestjs/config": "^4.0.4",
+    "@nestjs/core": "^11.1.18",
+    "luxon": "^3.7.2",
+    "nest-commander": "^3.20.1",
+    "nestjs-pino": "^4.6.1",
+    "pino-http": "^10.5.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  },
+  "description": "Heron CLI — database backup & rollup (PostgreSQL/MySQL → S3)",
+  "devDependencies": {
+    "@faker-js/faker": "^9.9.0",
+    "@nestjs/cli": "^11.0.21",
+    "@nestjs/testing": "^11.1.18",
+    "@stryker-mutator/core": "^9.6.1",
+    "@stryker-mutator/typescript-checker": "^9.6.1",
+    "@stryker-mutator/vitest-runner": "^9.6.1",
+    "@types/luxon": "^3.7.1",
+    "@types/node": "^22.15.30",
+    "@vitest/coverage-v8": "^4.1.6",
+    "dependency-cruiser": "^17.4.2",
+    "dotenv-cli": "^11.0.0",
+    "eslint": "^9.39.4",
+    "eslint-plugin-jsonc": "^3.1.2",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-yml": "^3.3.2",
+    "gts": "^7.0.0",
+    "jiti": "^2.7.0",
+    "moq.ts": "^10.0.8",
+    "nest-commander-testing": "^3.5.1",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^4.1.6"
+  },
+  "engineStrict": true,
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=10.29.3"
+  },
+  "files": [
+    "bin"
+  ],
+  "homepage": "https://github.com/heronlabs/terminal-cli#readme",
+  "keywords": [
+    "cli",
+    "backup",
+    "rollup",
+    "postgresql",
+    "mysql",
+    "s3",
+    "database",
+    "nestjs"
+  ],
+  "license": "MIT",
+  "name": "@heronlabs/terminal-cli",
+  "packageManager": "pnpm@10.33.2",
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@nestjs/core",
+      "@swc/core"
+    ],
+    "overrides": {
+      "tmp@<0.2.6": ">=0.2.6"
+    }
+  },
+  "prettier": "gts/.prettierrc.json",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heronlabs/terminal-cli.git"
+  },
+  "scripts": {
+    "build": "nest build --path tsconfig.bin.json",
+    "dep:cruise": "depcruise src --config .dependency-cruiser.cjs",
+    "lint:check": "gts lint && eslint \"**/*.json\" \"**/*.yml\" \"**/*.yaml\" --no-error-on-unmatched-pattern",
+    "lint:fix": "gts fix && eslint \"**/*.json\" \"**/*.yml\" \"**/*.yaml\" --fix --no-error-on-unmatched-pattern",
+    "prepublishOnly": "pnpm build",
+    "start": "dotenv -- node bin/src/main.js",
+    "test:mutation": "stryker run stryker.conf.json",
+    "test:unit": "vitest run"
+  },
+  "version": "0.0.1"
+}