@aurios/mizzling 1.1.3 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
 
2
- > @aurios/mizzling@1.1.3 build /home/runner/work/mizzle/mizzle/packages/mizzling
2
+ > @aurios/mizzling@1.1.4 build /home/runner/work/mizzle/mizzle/packages/mizzling
3
3
  > tsup
4
4
 
5
5
  CLI Building entry: src/cli.ts, src/index.ts
@@ -10,6 +10,6 @@
10
10
  CLI Cleaning output folder
11
11
  ESM Build start
12
12
  ESM dist/cli.js 13.77 KB
13
- ESM dist/index.js 87.00 B
14
13
  ESM dist/chunk-DKDRM5WU.js 1.79 KB
14
+ ESM dist/index.js 87.00 B
15
15
  ESM ⚡️ Build success in 36ms
package/README.md CHANGED
@@ -1,98 +1,81 @@
1
- 🌧️ Mizzling CLI
1
+ # 🌧️ Mizzling CLI
2
2
 
3
3
  Mizzling is the official command-line interface for the Mizzle ORM, designed to manage DynamoDB migrations and schemas with ease. It provides a streamlined workflow for initializing projects, detecting schema changes, and applying them to your AWS environment.
4
- 🚀 Installation
5
4
 
6
- You can install the CLI as a development dependency in your project using your preferred package manager:
7
- Bash
5
+ You can skip this and see a better documentation [here](https://mizzle-docs.vercel.app)
8
6
 
9
- # Using npm
7
+ ## 🚀 Installation
10
8
 
11
- npm install -D @aurios/mizzling
9
+ You can install the CLI as a development dependency in your project using your preferred package manager, so let's get started:
12
10
 
13
- # Using pnpm
11
+ ```bash
12
+ npm install @aurios/mizzling
13
+ # or
14
+ bun add @aurios/mizzling
15
+ ```
14
16
 
15
- pnpm add -D @aurios/mizzling
16
-
17
- The CLI is accessible via the mizzling command.
18
- 🛠️ Commands
17
+ ## 🛠️ Commands
19
18
 
20
19
  The CLI offers several commands to manage your DynamoDB infrastructure:
21
20
 
22
- 1. mizzling init
23
-
24
- Initializes a new Mizzle configuration in your current directory. This is an interactive command that guides you through:
25
-
26
- Setting the path to your schema files.
27
-
28
- Defining the output directory for migrations and snapshots.
29
-
30
- Configuring the AWS region and optional custom endpoints (e.g., for local development with DynamoDB Local or LocalStack).
31
-
32
- It generates a mizzle.config.ts file upon completion. 2. mizzling generate
33
-
34
- Analyzes your current schema and compares it against the last saved snapshot to generate a new migration script.
21
+ 1. `bunx mizzling init`: Initializes a new Mizzle configuration in your current directory. This is an interactive command that guides you through:
35
22
 
36
- Usage: mizzling generate [--name <name>].
23
+ - Setting the path to your schema files.
24
+ - Defining the output directory for migrations and snapshots.
25
+ - Configuring the AWS region and optional custom endpoints (e.g., for local development with DynamoDB Local or LocalStack).
37
26
 
38
- It automatically detects created, deleted, or updated tables.
27
+ It generates a mizzle.config.ts file upon completion.
39
28
 
40
- Creates a TypeScript migration file with up and down functions for version control.
29
+ 2. `bunx mizzling generate [--name <name>]`: Analyzes your current schema and compares it against the last saved snapshot to generate a new migration script.
41
30
 
42
- 3. mizzling push
31
+ It automatically detects created, deleted, or updated tables.
43
32
 
44
- Directly applies schema changes to your target DynamoDB environment without generating migration files.
33
+ Creates a TypeScript migration file with up and down functions for version control.
45
34
 
46
- Usage: mizzling push [-y, --yes].
35
+ 3. `bunx mizzling push [-y, --yes]`: Directly applies schema changes to your target DynamoDB environment without generating migration files.
47
36
 
48
- The --yes flag skips the interactive confirmation prompt.
37
+ The `--yes` flag skips the interactive confirmation prompt. Useful for rapid prototyping and synchronizing development environments.
49
38
 
50
- Useful for rapid prototyping and synchronizing development environments.
39
+ 4. `bunx mizzling list`: Provides a summary of all existing DynamoDB tables in the configured environment.
51
40
 
52
- 4. mizzling list
41
+ For each table, it displays:
53
42
 
54
- Provides a summary of all existing DynamoDB tables in the configured environment. For each table, it displays:
43
+ - The table name.
44
+ - Primary Key (PK) and Sort Key (SK) attributes.
45
+ - A list of Global Secondary Indexes (GSIs).
55
46
 
56
- The table name.
47
+ 5. `bunx mizzling drop`: An interactive tool to safely remove tables from your environment.
57
48
 
58
- Primary Key (PK) and Sort Key (SK) attributes.
49
+ It fetches a list of remote tables and allows you to select multiple items for deletion.
59
50
 
60
- A list of Global Secondary Indexes (GSIs).
51
+ > Warning: This action is irreversible and requires explicit
52
+ > confirmation before proceeding.
61
53
 
62
- 5. mizzling drop
63
-
64
- An interactive tool to safely remove tables from your environment.
65
-
66
- It fetches a list of remote tables and allows you to select multiple items for deletion.
67
-
68
- Warning: This action is irreversible and requires explicit confirmation before proceeding.
69
-
70
- ⚙️ Configuration (mizzle.config.ts)
54
+ ## ⚙️ Configuration (mizzle.config.ts)
71
55
 
72
56
  Mizzling uses a central configuration file. You can use the defineConfig helper for full TypeScript type safety:
73
57
  TypeScript
74
58
 
59
+ ```ts
75
60
  import { defineConfig } from "@aurios/mizzling";
76
61
 
77
62
  export default defineConfig({
78
- schema: "./src/schema.ts",
79
- out: "./migrations",
80
- region: "us-east-1",
81
- // endpoint: "http://localhost:8000", // Optional for local dev
63
+ schema: "./src/schema.ts",
64
+ out: "./migrations",
65
+ region: "us-east-1",
66
+ // endpoint: "http://localhost:8000", // Optional for local dev
82
67
  });
68
+ ```
83
69
 
84
- Environment Overrides
70
+ ## Environment Overrides
85
71
 
86
72
  Configuration values can be overridden using environment variables:
87
73
 
88
- MIZZLE_REGION: Overrides the AWS region.
89
-
90
- MIZZLE_ENDPOINT: Overrides the DynamoDB endpoint.
91
-
92
- MIZZLE_SCHEMA: Overrides the schema path.
93
-
94
- MIZZLE_OUT: Overrides the migrations output directory.
74
+ - MIZZLE_REGION: Overrides the AWS region.
75
+ - MIZZLE_ENDPOINT: Overrides the DynamoDB endpoint.
76
+ - MIZZLE_SCHEMA: Overrides the schema path.
77
+ - MIZZLE_OUT: Overrides the migrations output directory.
95
78
 
96
- 📄 License
79
+ ## 📄 License
97
80
 
98
81
  This project is licensed under the MIT License.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aurios/mizzling",
3
- "version": "1.1.3",
3
+ "version": "1.1.4",
4
4
  "description": "A CLI tool for managing Mizzle projects",
5
5
  "publishConfig": {
6
6
  "access": "public",
@@ -47,8 +47,8 @@
47
47
  "devDependencies": {
48
48
  "tsup": "^8.5.1",
49
49
  "@repo/shared": "0.0.3",
50
- "@repo/typescript-config": "0.0.0",
51
50
  "@aurios/mizzle": "1.1.3",
51
+ "@repo/typescript-config": "0.0.0",
52
52
  "@repo/vitest-config": "0.0.0"
53
53
  },
54
54
  "scripts": {