@qumra/cli 2.4.14 → 2.4.17

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.
Files changed (4) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +140 -0
  3. package/dist/cli.js +11 -9
  4. package/package.json +14 -10
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024-present Qumra Cloud
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,140 @@
1
+ <div align="center">
2
+
3
+ <br />
4
+
5
+ <picture>
6
+ <source media="(prefers-color-scheme: dark)" srcset="https://qumra.cloud/logo-white.svg">
7
+ <source media="(prefers-color-scheme: light)" srcset="https://qumra.cloud/logo.svg">
8
+ <img alt="Qumra Cloud" src="https://qumra.cloud/logo.svg" width="200">
9
+ </picture>
10
+
11
+ <br />
12
+ <br />
13
+
14
+ # @qumra/cli
15
+
16
+ **Build, develop, and deploy themes & apps for your Qumra Cloud store.**
17
+
18
+ [![npm version](https://img.shields.io/npm/v/@qumra/cli?color=%23764abc&label=npm)](https://www.npmjs.com/package/@qumra/cli)
19
+ [![node](https://img.shields.io/node/v/@qumra/cli?color=%23339933)](https://nodejs.org)
20
+ [![license](https://img.shields.io/npm/l/@qumra/cli?color=%232563eb)](LICENSE)
21
+
22
+ [Documentation](https://docs.qumra.cloud/docs/cli/intro) · [Qumra Cloud](https://qumra.cloud) · [Get Started](https://app.qumra.cloud)
23
+
24
+ </div>
25
+
26
+ ---
27
+
28
+ ## Installation
29
+
30
+ ```bash
31
+ npm install -g @qumra/cli
32
+ ```
33
+
34
+ ## Quick Start
35
+
36
+ ```bash
37
+ # 1. Login to your account
38
+ qumra login
39
+
40
+ # 2. Initialize a theme
41
+ qumra theme init
42
+
43
+ # 3. Start developing with hot reload
44
+ qumra theme dev
45
+
46
+ # 4. Publish when ready
47
+ qumra theme publish
48
+ ```
49
+
50
+ ## Commands
51
+
52
+ ### Authentication
53
+
54
+ ```
55
+ qumra login Login to your Qumra Cloud account
56
+ qumra logout Logout from your account
57
+ qumra info Show current user info
58
+ ```
59
+
60
+ ### Themes
61
+
62
+ ```
63
+ qumra theme init Initialize a new theme project
64
+ qumra theme dev Start dev server with hot reload
65
+ qumra theme publish Publish theme to Qumra Cloud
66
+ qumra theme bundle Bundle theme for distribution
67
+ qumra theme patch Bump patch version and publish
68
+ qumra theme minor Bump minor version and publish
69
+ qumra theme major Bump major version and publish
70
+ ```
71
+
72
+ ### Apps
73
+
74
+ ```
75
+ qumra app init Initialize a new app project
76
+ qumra app dev Start dev server with HTTPS tunnel
77
+ qumra app deploy Deploy app to Qumra Cloud
78
+ ```
79
+
80
+ ### Generators
81
+
82
+ ```
83
+ qumra generate widget Scaffold a new widget
84
+ ```
85
+
86
+ ## Theme Development
87
+
88
+ `qumra theme dev` spins up a full local development environment:
89
+
90
+ ```
91
+ ┌─────────────────────────────────────────────┐
92
+ │ Qumra Dev Server │
93
+ ├─────────────────────────────────────────────┤
94
+ │ │
95
+ │ Local: http://localhost:3000 │
96
+ │ Store: https://mystore.qumra.cloud │
97
+ │ Editor: https://app.qumra.cloud/... │
98
+ │ │
99
+ │ ● Proxy server — local asset serving │
100
+ │ ● Hot reload — instant CSS updates │
101
+ │ ● File watcher — auto cloud sync │
102
+ │ │
103
+ ├─────────────────────────────────────────────┤
104
+ │ q quit · o open browser · e editor │
105
+ └─────────────────────────────────────────────┘
106
+ ```
107
+
108
+ ### Theme Structure
109
+
110
+ ```
111
+ my-theme/
112
+ ├── assets/ Static files (images, fonts, scripts)
113
+ ├── layouts/ Base layout templates (.njk)
114
+ ├── templates/ Page templates (.njk)
115
+ ├── ui/ UI components (.njk, .css)
116
+ ├── widgets/ Widget schemas & templates
117
+ ├── pages/ Page definitions (.json)
118
+ ├── locales/ Translation files (.json)
119
+ └── settings/ Theme configuration
120
+ ├── settings-schema.json
121
+ ├── settings-data.json
122
+ ├── header-schema.json
123
+ ├── header-data.json
124
+ ├── footer-schema.json
125
+ ├── footer-data.json
126
+ └── templates-settings.json
127
+ ```
128
+
129
+ ## Requirements
130
+
131
+ - **Node.js** >= 18
132
+ - A [Qumra Cloud](https://qumra.cloud) account
133
+
134
+ ## Documentation
135
+
136
+ Full docs available at **[docs.qumra.cloud](https://docs.qumra.cloud/docs/cli/intro)**
137
+
138
+ ## License
139
+
140
+ [MIT](LICENSE) — Made with care by [Qumra](https://qumra.cloud)
package/dist/cli.js CHANGED
@@ -304366,7 +304366,7 @@ class SectionBuilder {
304366
304366
  }
304367
304367
  }
304368
304368
 
304369
- var version$2 = "2.4.14";
304369
+ var version$2 = "2.4.17";
304370
304370
  var pkg = {
304371
304371
  version: version$2};
304372
304372
 
@@ -534680,23 +534680,25 @@ let AppService = class AppService {
534680
534680
  { label: 'Install URL', url: installUrl },
534681
534681
  ],
534682
534682
  shortcuts: [
534683
- { key: 'q', label: 'Quit', handler: () => {
534683
+ {
534684
+ key: 'q', label: 'Quit', handler: () => {
534684
534685
  devUI.stop();
534685
534686
  this.tunnel.stopTunnel();
534686
534687
  process.exit(0);
534687
- } },
534688
+ }
534689
+ },
534688
534690
  { key: 'p', label: 'Preview', handler: () => open(developmentUrl) },
534689
534691
  { key: 'o', label: 'Open Store', handler: () => open(installUrl) },
534690
534692
  ],
534691
534693
  logPanels: ['All', 'Server', 'Tunnel', 'Prisma'],
534692
534694
  });
534693
534695
  // Log initial steps
534694
- devUI.log('prisma', 'Running migrations...');
534695
- require$$1$7.execSync('npx prisma db push && npx prisma generate', {
534696
- cwd: process.cwd(),
534697
- stdio: 'ignore',
534698
- });
534699
- devUI.log('prisma', 'Migrations complete', 'success');
534696
+ // devUI.log('prisma', 'Running migrations...');
534697
+ // execSync('npx prisma db push && npx prisma generate', {
534698
+ // cwd: process.cwd(),
534699
+ // stdio: 'ignore',
534700
+ // });
534701
+ // devUI.log('prisma', 'Migrations complete', 'success');
534700
534702
  devUI.log('tunnel', `Tunnel ready: ${developmentUrl}`, 'success');
534701
534703
  devUI.log('app-preview', 'Dev preview ready', 'success');
534702
534704
  // Open install URL in browser
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@qumra/cli",
3
- "version": "2.4.14",
4
- "description": "Professional CLI tool for Qumra Cloud - Shopify competitor",
3
+ "version": "2.4.17",
4
+ "description": "Official CLI for Qumra Cloud e-commerce platform. Build, develop, and deploy themes and apps.",
5
5
  "main": "dist/cli.js",
6
6
  "bin": {
7
7
  "qumra": "dist/cli.js"
@@ -27,14 +27,19 @@
27
27
  ],
28
28
  "keywords": [
29
29
  "qumra",
30
- "sdk",
31
- "api",
32
- "graphql",
30
+ "cli",
33
31
  "ecommerce",
34
- "admin"
32
+ "ecommerce-platform",
33
+ "theme",
34
+ "storefront",
35
+ "headless-commerce",
36
+ "graphql"
35
37
  ],
36
- "author": "Qumra",
38
+ "author": "Qumra <support@qumra.cloud> (https://qumra.cloud)",
37
39
  "license": "MIT",
40
+ "engines": {
41
+ "node": ">=18"
42
+ },
38
43
  "dependencies": {
39
44
  "@inquirer/search": "^4.1.0",
40
45
  "@nestjs/common": "^11.1.12",
@@ -42,8 +47,6 @@
42
47
  "@nestjs/microservices": "^11.1.12",
43
48
  "@nestjs/platform-express": "^11.1.12",
44
49
  "@nestjs/websockets": "^11.1.12",
45
- "@types/blessed": "^0.1.27",
46
- "@types/figlet": "^1.7.0",
47
50
  "archiver": "^7.0.1",
48
51
  "axios": "^1.10.0",
49
52
  "blessed": "^0.1.81",
@@ -54,7 +57,6 @@
54
57
  "cli-progress": "^3.12.0",
55
58
  "cli-table3": "^0.6.5",
56
59
  "cloudflared": "^0.7.1",
57
- "commander": "^11.0.0",
58
60
  "conf": "^14.0.0",
59
61
  "express": "^4.18.2",
60
62
  "fast-glob": "^3.3.3",
@@ -81,6 +83,8 @@
81
83
  "@rollup/plugin-terser": "^0.4.4",
82
84
  "@rollup/plugin-typescript": "^11.0.0",
83
85
  "@types/archiver": "^7.0.0",
86
+ "@types/blessed": "^0.1.27",
87
+ "@types/figlet": "^1.7.0",
84
88
  "@types/cli-progress": "^3.11.6",
85
89
  "@types/conf": "^2.1.0",
86
90
  "@types/express": "^4.17.21",