langctl 0.0.1 → 0.1.0
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.
- package/NPM_PUBLISH_GUIDE.md +293 -0
- package/QUICK_PUBLISH.md +64 -0
- package/README.md +287 -32
- package/dist/auth.d.ts +33 -0
- package/dist/auth.js +106 -0
- package/dist/commands/auth.d.ts +3 -0
- package/dist/commands/auth.js +41 -0
- package/dist/commands/config.d.ts +2 -0
- package/dist/commands/config.js +33 -0
- package/dist/commands/debug.d.ts +3 -0
- package/dist/commands/debug.js +63 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +93 -0
- package/dist/commands/projects.d.ts +2 -0
- package/dist/commands/projects.js +54 -0
- package/dist/commands/pull.d.ts +9 -0
- package/dist/commands/pull.js +194 -0
- package/dist/config.d.ts +49 -0
- package/dist/config.js +71 -0
- package/dist/exporters/index.d.ts +36 -0
- package/dist/exporters/index.js +214 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +166 -0
- package/dist/supabase.d.ts +14 -0
- package/dist/supabase.js +33 -0
- package/dist/utils/banner.d.ts +9 -0
- package/dist/utils/banner.js +24 -0
- package/package.json +22 -3
- package/translations/en.json +5 -0
- package/translations/en.xml +9 -0
- package/translations/fr.json +4 -0
- package/translations/fr.xml +7 -0
- package/translations/hi.json +4 -0
- package/translations/hi.xml +7 -0
- package/translations/ios/en.strings +9 -0
- package/translations/ios/fr.strings +6 -0
- package/translations/ios/hi.strings +6 -0
- package/translations/ios/ja.strings +6 -0
- package/translations/ja.json +4 -0
- package/translations/ja.xml +7 -0
- package/PUBLISH_GUIDE.md +0 -209
- package/bin/langctl.js +0 -19
- package/index.js +0 -26
package/PUBLISH_GUIDE.md
DELETED
|
@@ -1,209 +0,0 @@
|
|
|
1
|
-
# Publishing Langctl to npm
|
|
2
|
-
|
|
3
|
-
## 📦 Reserve the `langctl` Package Name
|
|
4
|
-
|
|
5
|
-
### Prerequisites
|
|
6
|
-
- npm account (create at https://www.npmjs.com/signup)
|
|
7
|
-
- Email verified on npm
|
|
8
|
-
- Two-factor authentication enabled (recommended)
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Step-by-Step Publishing Guide
|
|
13
|
-
|
|
14
|
-
### 1. Login to npm
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
cd /Users/siddharthsaxena/Documents/projects/langctl/langctl-cli
|
|
18
|
-
|
|
19
|
-
# Login to npm
|
|
20
|
-
npm login
|
|
21
|
-
|
|
22
|
-
# Enter your credentials:
|
|
23
|
-
# - Username
|
|
24
|
-
# - Password
|
|
25
|
-
# - Email
|
|
26
|
-
# - OTP (if 2FA enabled)
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
### 2. Check if Name is Available
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
npm search langctl
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
If nothing shows up, the name is available! ✅
|
|
36
|
-
|
|
37
|
-
### 3. Test the Package Locally
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
# Make the CLI executable
|
|
41
|
-
chmod +x bin/langctl.js
|
|
42
|
-
chmod +x index.js
|
|
43
|
-
|
|
44
|
-
# Test it works
|
|
45
|
-
node bin/langctl.js
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
You should see the "Coming Soon" message.
|
|
49
|
-
|
|
50
|
-
### 4. Publish to npm
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
# Publish as public package (free)
|
|
54
|
-
npm publish --access public
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
**Expected output:**
|
|
58
|
-
```
|
|
59
|
-
+ langctl@0.0.1
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
### 5. Verify It's Published
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
# Search for your package
|
|
66
|
-
npm search langctl
|
|
67
|
-
|
|
68
|
-
# View package page
|
|
69
|
-
npm view langctl
|
|
70
|
-
|
|
71
|
-
# Visit on web
|
|
72
|
-
# https://www.npmjs.com/package/langctl
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
### 6. Test Installation
|
|
76
|
-
|
|
77
|
-
```bash
|
|
78
|
-
# Test installing globally
|
|
79
|
-
npm install -g langctl
|
|
80
|
-
|
|
81
|
-
# Run it
|
|
82
|
-
langctl
|
|
83
|
-
|
|
84
|
-
# You should see the "Coming Soon" message
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
---
|
|
88
|
-
|
|
89
|
-
## 🎉 Success!
|
|
90
|
-
|
|
91
|
-
Your package is now published and the name is reserved!
|
|
92
|
-
|
|
93
|
-
Anyone who tries:
|
|
94
|
-
```bash
|
|
95
|
-
npm install -g langctl
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
Will get your placeholder package with the "Coming Soon" message.
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## 📈 Update Version When Ready
|
|
103
|
-
|
|
104
|
-
When you build the actual CLI:
|
|
105
|
-
|
|
106
|
-
```bash
|
|
107
|
-
# Update version
|
|
108
|
-
npm version patch # 0.0.1 -> 0.0.2
|
|
109
|
-
npm version minor # 0.0.1 -> 0.1.0
|
|
110
|
-
npm version major # 0.0.1 -> 1.0.0
|
|
111
|
-
|
|
112
|
-
# Publish update
|
|
113
|
-
npm publish
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
## 🔐 Security Best Practices
|
|
119
|
-
|
|
120
|
-
### Enable 2FA on npm Account
|
|
121
|
-
```bash
|
|
122
|
-
npm profile enable-2fa auth-and-writes
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
### Use npm Access Tokens (for CI/CD later)
|
|
126
|
-
```bash
|
|
127
|
-
npm token create --read-only
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
---
|
|
131
|
-
|
|
132
|
-
## 📝 Package Details
|
|
133
|
-
|
|
134
|
-
**Package Name:** `langctl`
|
|
135
|
-
**Current Version:** `0.0.1`
|
|
136
|
-
**Type:** Placeholder
|
|
137
|
-
**License:** MIT
|
|
138
|
-
**Homepage:** https://langctl.com
|
|
139
|
-
|
|
140
|
-
---
|
|
141
|
-
|
|
142
|
-
## 🚀 Next Steps
|
|
143
|
-
|
|
144
|
-
1. ✅ Publish placeholder package (reserve name)
|
|
145
|
-
2. 🏗️ Build actual CLI tool
|
|
146
|
-
3. 📦 Update package with real functionality
|
|
147
|
-
4. 🎯 Publish v1.0.0 when ready
|
|
148
|
-
|
|
149
|
-
---
|
|
150
|
-
|
|
151
|
-
## ⚠️ Important Notes
|
|
152
|
-
|
|
153
|
-
- **Placeholder package is intentional** - This reserves the name while you build
|
|
154
|
-
- **Users will see "Coming Soon"** - They know it's in development
|
|
155
|
-
- **npm allows placeholders** - As long as they have valid code
|
|
156
|
-
- **Update regularly** - Update description/readme as you build
|
|
157
|
-
|
|
158
|
-
---
|
|
159
|
-
|
|
160
|
-
## 🐛 Troubleshooting
|
|
161
|
-
|
|
162
|
-
### "Package name already taken"
|
|
163
|
-
```bash
|
|
164
|
-
# Try variations:
|
|
165
|
-
# @your-username/langctl
|
|
166
|
-
# langctl-cli
|
|
167
|
-
# langctl-tool
|
|
168
|
-
```
|
|
169
|
-
|
|
170
|
-
### "You must verify your email"
|
|
171
|
-
1. Check your email for npm verification link
|
|
172
|
-
2. Click the link
|
|
173
|
-
3. Try publishing again
|
|
174
|
-
|
|
175
|
-
### "You must sign in to publish"
|
|
176
|
-
```bash
|
|
177
|
-
npm logout
|
|
178
|
-
npm login
|
|
179
|
-
npm publish --access public
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
### "Package too large"
|
|
183
|
-
```bash
|
|
184
|
-
# Check package size
|
|
185
|
-
npm pack --dry-run
|
|
186
|
-
|
|
187
|
-
# Should be very small (<10KB for placeholder)
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
---
|
|
191
|
-
|
|
192
|
-
## 📧 Support
|
|
193
|
-
|
|
194
|
-
Questions about npm publishing?
|
|
195
|
-
- npm docs: https://docs.npmjs.com/
|
|
196
|
-
- npm support: support@npmjs.com
|
|
197
|
-
- Langctl: hello@langctl.com
|
|
198
|
-
|
|
199
|
-
---
|
|
200
|
-
|
|
201
|
-
**Ready to publish? Just run:**
|
|
202
|
-
|
|
203
|
-
```bash
|
|
204
|
-
cd /Users/siddharthsaxena/Documents/projects/langctl/langctl-cli
|
|
205
|
-
npm login
|
|
206
|
-
npm publish --access public
|
|
207
|
-
```
|
|
208
|
-
|
|
209
|
-
That's it! 🚀
|
package/bin/langctl.js
DELETED
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
console.log(`
|
|
4
|
-
╔══════════════════════════════════════════════════════════╗
|
|
5
|
-
║ ║
|
|
6
|
-
║ 🚧 Coming Soon 🚧 ║
|
|
7
|
-
║ ║
|
|
8
|
-
║ Langctl CLI is under development ║
|
|
9
|
-
║ ║
|
|
10
|
-
║ Translation management for developers who code ║
|
|
11
|
-
║ CLI-first • AI-powered • Affordable ║
|
|
12
|
-
║ ║
|
|
13
|
-
║ Learn more: https://langctl.com ║
|
|
14
|
-
║ Email: hello@langctl.com ║
|
|
15
|
-
║ ║
|
|
16
|
-
╚══════════════════════════════════════════════════════════╝
|
|
17
|
-
`);
|
|
18
|
-
|
|
19
|
-
process.exit(0);
|
package/index.js
DELETED
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Langctl - CLI-first translation management for developers
|
|
5
|
-
*
|
|
6
|
-
* This is a placeholder package. The full CLI is under development.
|
|
7
|
-
* Visit https://langctl.com for updates.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
console.log(`
|
|
11
|
-
╔══════════════════════════════════════════════════════════╗
|
|
12
|
-
║ ║
|
|
13
|
-
║ 🚧 Coming Soon 🚧 ║
|
|
14
|
-
║ ║
|
|
15
|
-
║ Langctl CLI is under development ║
|
|
16
|
-
║ ║
|
|
17
|
-
║ Translation management for developers who code ║
|
|
18
|
-
║ CLI-first • AI-powered • Affordable ║
|
|
19
|
-
║ ║
|
|
20
|
-
║ Learn more: https://langctl.com ║
|
|
21
|
-
║ Email: hello@langctl.com ║
|
|
22
|
-
║ ║
|
|
23
|
-
╚══════════════════════════════════════════════════════════╝
|
|
24
|
-
`);
|
|
25
|
-
|
|
26
|
-
module.exports = {};
|