@soluling/solucli 1.0.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/README.md +85 -0
- package/dist/apiClient.js +233 -0
- package/dist/apiClient.js.map +1 -0
- package/dist/index.js +205 -0
- package/dist/index.js.map +1 -0
- package/dist/jwt.js +12 -0
- package/dist/jwt.js.map +1 -0
- package/dist/models.js +2 -0
- package/dist/models.js.map +1 -0
- package/dist/prompt.js +58 -0
- package/dist/prompt.js.map +1 -0
- package/package.json +32 -0
package/README.md
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# SoluCli
|
|
2
|
+
|
|
3
|
+
Command-line tool for the [Soluling](https://soluling.com) localization cloud API. Moves files
|
|
4
|
+
to and from Soluling cloud projects - built for CI/CD pipelines, but usable interactively too.
|
|
5
|
+
|
|
6
|
+
Pure TypeScript/Node.js, distributed as a single npm package with no platform-specific binaries.
|
|
7
|
+
|
|
8
|
+
## Install
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
npm install -g @soluling/solucli
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Requires Node.js 18 or later.
|
|
15
|
+
|
|
16
|
+
## Authentication
|
|
17
|
+
|
|
18
|
+
Every command needs Soluling credentials, given as options or environment variables:
|
|
19
|
+
|
|
20
|
+
| Option | Short | Environment variable |
|
|
21
|
+
|--------------|-------|-----------------------|
|
|
22
|
+
| `--user` | `-u` | `SOLUCLI_USER` |
|
|
23
|
+
| `--password` | `-p` | `SOLUCLI_PASSWORD` |
|
|
24
|
+
| `--url` | `-r` | `SOLUCLI_URL` |
|
|
25
|
+
|
|
26
|
+
`--url` defaults to `https://www.soluling.com/api` - only set it if you're pointing at a
|
|
27
|
+
self-hosted or non-production instance. The `artifact` commands are anonymous and don't need
|
|
28
|
+
`--user`/`--password` at all.
|
|
29
|
+
|
|
30
|
+
If `--user` or `--password` is missing (and its environment variable isn't set either), and
|
|
31
|
+
you're running in an interactive terminal, SoluCli prompts for it - password input is masked.
|
|
32
|
+
In a non-interactive context (CI/CD, piped input) there's no one to answer a prompt, so it fails
|
|
33
|
+
immediately with the usual missing-option error instead.
|
|
34
|
+
|
|
35
|
+
## Commands
|
|
36
|
+
|
|
37
|
+
Language lists (`--languages`, `--target-languages`) are semicolon-separated, e.g. `fi;sv` -
|
|
38
|
+
quote them (`"fi;sv"`) in PowerShell or a POSIX shell, since an unquoted `;` there ends the
|
|
39
|
+
command instead of being passed through as part of the value.
|
|
40
|
+
|
|
41
|
+
The common case is pushing the resource files you want localized (`.resx`, `.json`, `.xml`,
|
|
42
|
+
`.html`, etc.) into an existing project, rather than a whole `.ntp` project file:
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
solucli project create-source <file> --original-language <code> --target-languages <codes> [--project-name <name>]
|
|
46
|
+
solucli project create-empty <name> --original-language <code> --target-languages <codes>
|
|
47
|
+
solucli project add-source <projectId> <file> [--name <fileName>] [--type <sourceType>]
|
|
48
|
+
solucli project update-source <projectId> <fileName> <file>
|
|
49
|
+
solucli project remove-source <projectId> <fileName>
|
|
50
|
+
solucli project sources <projectId>
|
|
51
|
+
solucli project download-source <projectId> <fileName> <language> <output>
|
|
52
|
+
|
|
53
|
+
solucli project build <projectId> [--languages "fi;sv"] [--publish]
|
|
54
|
+
solucli project add-language <projectId> <languageCode>
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
`create-source` creates the project itself, in one step, from that first resource file.
|
|
58
|
+
`create-empty` instead creates a project with no file at all - use `add-source` afterwards to
|
|
59
|
+
push files into it. To instead create or replace a project's whole `.ntp` (or `.zip`) file:
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
solucli project create <file> [--account <key>] [--name <name>] [--artifacts] [--cloud-is-master]
|
|
63
|
+
solucli project update <projectId> <file>
|
|
64
|
+
solucli project download <projectId> <output> [--languages "fi;sv"] [--poll-interval 5] [--timeout 1800]
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Downloading a project's published build artifacts, without signing in at all:
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
solucli artifact languages <projectGuid>
|
|
71
|
+
solucli artifact get <projectGuid> <filename> <output>
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Run `solucli <command> --help` for details on any command.
|
|
75
|
+
|
|
76
|
+
### Example: CI/CD pipeline
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
export SOLUCLI_USER=$SOLULING_USER
|
|
80
|
+
export SOLUCLI_PASSWORD=$SOLULING_PASSWORD
|
|
81
|
+
|
|
82
|
+
solucli project update-source 123 messages.json ./src/messages.json
|
|
83
|
+
solucli project build 123 --publish
|
|
84
|
+
solucli project download-source 123 messages.json fi ./out/messages.fi.json
|
|
85
|
+
```
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
import { readFileSync, statSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { decodeJwtExpiryMs } from "./jwt.js";
|
|
3
|
+
/** Re-authenticate this long before the token's real expiry, since a request whose body is a
|
|
4
|
+
* file upload can't be safely replayed after being sent once - proactive refresh avoids ever
|
|
5
|
+
* hitting a 401 mid-upload. */
|
|
6
|
+
const REFRESH_MARGIN_MS = 60_000;
|
|
7
|
+
export class ApiError extends Error {
|
|
8
|
+
}
|
|
9
|
+
export class SolulingApiClient {
|
|
10
|
+
baseUrl;
|
|
11
|
+
username;
|
|
12
|
+
password;
|
|
13
|
+
token;
|
|
14
|
+
refreshToken;
|
|
15
|
+
tokenExpiresAtMs = 0;
|
|
16
|
+
constructor(options) {
|
|
17
|
+
this.baseUrl = options.baseUrl.replace(/\/+$/, "");
|
|
18
|
+
this.username = options.username;
|
|
19
|
+
this.password = options.password;
|
|
20
|
+
}
|
|
21
|
+
// ---- Authentication ----------------------------------------------------
|
|
22
|
+
async ensureAuthenticated() {
|
|
23
|
+
if (this.token && Date.now() < this.tokenExpiresAtMs - REFRESH_MARGIN_MS)
|
|
24
|
+
return;
|
|
25
|
+
if (this.refreshToken) {
|
|
26
|
+
try {
|
|
27
|
+
await this.doAuth("/users/refresh", { refreshToken: this.refreshToken });
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
catch {
|
|
31
|
+
// Refresh token expired or rejected - fall back to a fresh login below.
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
await this.doAuth("/users/authenticate", {
|
|
35
|
+
username: this.username,
|
|
36
|
+
password: this.password,
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
async doAuth(path, body) {
|
|
40
|
+
const response = await fetch(this.baseUrl + path, {
|
|
41
|
+
method: "POST",
|
|
42
|
+
headers: { "Content-Type": "application/json" },
|
|
43
|
+
body: JSON.stringify(body),
|
|
44
|
+
});
|
|
45
|
+
if (!response.ok)
|
|
46
|
+
throw new ApiError(await describeError(response));
|
|
47
|
+
const result = (await response.json());
|
|
48
|
+
this.token = result.token;
|
|
49
|
+
this.refreshToken = result.refreshToken;
|
|
50
|
+
this.tokenExpiresAtMs = decodeJwtExpiryMs(result.token);
|
|
51
|
+
}
|
|
52
|
+
async authedFetch(path, init = {}) {
|
|
53
|
+
await this.ensureAuthenticated();
|
|
54
|
+
const headers = new Headers(init.headers);
|
|
55
|
+
headers.set("Authorization", `Bearer ${this.token}`);
|
|
56
|
+
const response = await fetch(this.baseUrl + path, { ...init, headers });
|
|
57
|
+
if (!response.ok)
|
|
58
|
+
throw new ApiError(await describeError(response));
|
|
59
|
+
return response;
|
|
60
|
+
}
|
|
61
|
+
// ---- Projects ------------------------------------------------------------
|
|
62
|
+
async createProject(filePath, account, name, artifacts, cloudIsMaster) {
|
|
63
|
+
const query = fileTimestampQuery(filePath);
|
|
64
|
+
query.set("name", name);
|
|
65
|
+
query.set("artifacts", String(artifacts));
|
|
66
|
+
query.set("cloudIsMaster", String(cloudIsMaster));
|
|
67
|
+
if (account)
|
|
68
|
+
query.set("account", account);
|
|
69
|
+
const response = await this.authedFetch(`/projects/file?${query}`, {
|
|
70
|
+
method: "POST",
|
|
71
|
+
headers: { "Content-Type": "application/octet-stream" },
|
|
72
|
+
body: readFileSync(filePath),
|
|
73
|
+
});
|
|
74
|
+
return (await response.json());
|
|
75
|
+
}
|
|
76
|
+
async createProjectFromSource(filePath, fileName, originalLanguage, targetLanguages, projectName, account, sourceType, artifacts, guid) {
|
|
77
|
+
const query = new URLSearchParams();
|
|
78
|
+
query.set("name", fileName);
|
|
79
|
+
query.set("originalLanguage", originalLanguage);
|
|
80
|
+
query.set("targetLanguages", targetLanguages);
|
|
81
|
+
query.set("artifacts", String(artifacts));
|
|
82
|
+
if (projectName)
|
|
83
|
+
query.set("projectName", projectName);
|
|
84
|
+
if (account)
|
|
85
|
+
query.set("account", account);
|
|
86
|
+
if (sourceType)
|
|
87
|
+
query.set("sourceType", sourceType);
|
|
88
|
+
if (guid)
|
|
89
|
+
query.set("guid", guid);
|
|
90
|
+
const response = await this.authedFetch(`/projects/source?${query}`, {
|
|
91
|
+
method: "POST",
|
|
92
|
+
headers: { "Content-Type": "application/octet-stream" },
|
|
93
|
+
body: readFileSync(filePath),
|
|
94
|
+
});
|
|
95
|
+
return (await response.json());
|
|
96
|
+
}
|
|
97
|
+
async createEmptyProject(name, originalLanguage, targetLanguages, account, artifacts, guid) {
|
|
98
|
+
const query = new URLSearchParams();
|
|
99
|
+
query.set("name", name);
|
|
100
|
+
query.set("originalLanguage", originalLanguage);
|
|
101
|
+
query.set("targetLanguages", targetLanguages);
|
|
102
|
+
query.set("artifacts", String(artifacts));
|
|
103
|
+
if (account)
|
|
104
|
+
query.set("account", account);
|
|
105
|
+
if (guid)
|
|
106
|
+
query.set("guid", guid);
|
|
107
|
+
const response = await this.authedFetch(`/projects?${query}`, {
|
|
108
|
+
method: "POST",
|
|
109
|
+
});
|
|
110
|
+
return (await response.json());
|
|
111
|
+
}
|
|
112
|
+
async updateProject(projectId, filePath) {
|
|
113
|
+
const query = fileTimestampQuery(filePath);
|
|
114
|
+
const response = await this.authedFetch(`/projects/${projectId}/file?${query}`, {
|
|
115
|
+
method: "PUT",
|
|
116
|
+
headers: { "Content-Type": "application/octet-stream" },
|
|
117
|
+
body: readFileSync(filePath),
|
|
118
|
+
});
|
|
119
|
+
return (await response.json());
|
|
120
|
+
}
|
|
121
|
+
async buildProject(projectId, languages, publish) {
|
|
122
|
+
const query = new URLSearchParams();
|
|
123
|
+
if (languages)
|
|
124
|
+
query.set("languages", languages);
|
|
125
|
+
query.set("publish", String(publish));
|
|
126
|
+
const response = await this.authedFetch(`/projects/${projectId}/build?${query}`, {
|
|
127
|
+
method: "POST",
|
|
128
|
+
});
|
|
129
|
+
return (await response.json());
|
|
130
|
+
}
|
|
131
|
+
async addLanguage(projectId, languageCode) {
|
|
132
|
+
await this.authedFetch(`/projects/${projectId}/languages/${encodeURIComponent(languageCode)}`, {
|
|
133
|
+
method: "POST",
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
// ---- Source files (individual resource files within a project) --------
|
|
137
|
+
async addSource(projectId, fileName, filePath, sourceType) {
|
|
138
|
+
const query = fileTimestampQuery(filePath);
|
|
139
|
+
if (sourceType)
|
|
140
|
+
query.set("sourceType", sourceType);
|
|
141
|
+
const response = await this.authedFetch(`/projects/${projectId}/files/${encodeURIComponent(fileName)}?${query}`, {
|
|
142
|
+
method: "POST",
|
|
143
|
+
headers: { "Content-Type": "application/octet-stream" },
|
|
144
|
+
body: readFileSync(filePath),
|
|
145
|
+
});
|
|
146
|
+
return (await response.json());
|
|
147
|
+
}
|
|
148
|
+
async updateSource(projectId, fileName, filePath) {
|
|
149
|
+
const query = fileTimestampQuery(filePath);
|
|
150
|
+
const response = await this.authedFetch(`/projects/${projectId}/files/${encodeURIComponent(fileName)}?${query}`, {
|
|
151
|
+
method: "PUT",
|
|
152
|
+
headers: { "Content-Type": "application/octet-stream" },
|
|
153
|
+
body: readFileSync(filePath),
|
|
154
|
+
});
|
|
155
|
+
return (await response.json());
|
|
156
|
+
}
|
|
157
|
+
async removeSource(projectId, fileName) {
|
|
158
|
+
const response = await this.authedFetch(`/projects/${projectId}/files/${encodeURIComponent(fileName)}`, {
|
|
159
|
+
method: "DELETE",
|
|
160
|
+
});
|
|
161
|
+
return (await response.json());
|
|
162
|
+
}
|
|
163
|
+
async listSources(projectId) {
|
|
164
|
+
const response = await this.authedFetch(`/projects/${projectId}/sources`);
|
|
165
|
+
return (await response.json());
|
|
166
|
+
}
|
|
167
|
+
async getSourceByName(projectId, fileName) {
|
|
168
|
+
const response = await this.authedFetch(`/projects/${projectId}/sources/${encodeURIComponent(fileName)}`);
|
|
169
|
+
return (await response.json());
|
|
170
|
+
}
|
|
171
|
+
/** Downloads a source's already-built localized file for one language. Unlike
|
|
172
|
+
* downloadProject, this never queues a build as a side effect - run `project build` first. */
|
|
173
|
+
async downloadSourceArtifact(projectId, fileName, language, outputPath) {
|
|
174
|
+
const source = await this.getSourceByName(projectId, fileName);
|
|
175
|
+
const response = await this.authedFetch(`/sources/${source.id}/artifacts/${encodeURIComponent(language)}`);
|
|
176
|
+
const bytes = Buffer.from(await response.arrayBuffer());
|
|
177
|
+
writeFileSync(outputPath, bytes);
|
|
178
|
+
}
|
|
179
|
+
async downloadProject(projectId, outputPath, languages, pollIntervalSec, timeoutSec) {
|
|
180
|
+
const query = new URLSearchParams();
|
|
181
|
+
if (languages)
|
|
182
|
+
query.set("languages", languages);
|
|
183
|
+
const deadline = Date.now() + timeoutSec * 1000;
|
|
184
|
+
for (;;) {
|
|
185
|
+
await this.ensureAuthenticated();
|
|
186
|
+
const headers = new Headers();
|
|
187
|
+
headers.set("Authorization", `Bearer ${this.token}`);
|
|
188
|
+
const response = await fetch(this.baseUrl + `/projects/${projectId}/download/file?${query}`, {
|
|
189
|
+
headers,
|
|
190
|
+
});
|
|
191
|
+
if (response.status === 409) {
|
|
192
|
+
if (Date.now() >= deadline)
|
|
193
|
+
throw new ApiError(`Timed out after ${timeoutSec}s waiting for the build to become available.`);
|
|
194
|
+
await sleep(pollIntervalSec * 1000);
|
|
195
|
+
continue;
|
|
196
|
+
}
|
|
197
|
+
if (!response.ok)
|
|
198
|
+
throw new ApiError(await describeError(response));
|
|
199
|
+
const bytes = Buffer.from(await response.arrayBuffer());
|
|
200
|
+
writeFileSync(outputPath, bytes);
|
|
201
|
+
return;
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
// ---- Artifacts (anonymous) -------------------------------------------
|
|
205
|
+
async getArtifactLanguages(projectGuid) {
|
|
206
|
+
const response = await fetch(this.baseUrl + `/artifacts/${projectGuid}/languages`);
|
|
207
|
+
if (!response.ok)
|
|
208
|
+
throw new ApiError(await describeError(response));
|
|
209
|
+
return (await response.json());
|
|
210
|
+
}
|
|
211
|
+
async getArtifact(projectGuid, filename, outputPath) {
|
|
212
|
+
const response = await fetch(this.baseUrl + `/artifacts/${projectGuid}/${filename}`);
|
|
213
|
+
if (!response.ok)
|
|
214
|
+
throw new ApiError(await describeError(response));
|
|
215
|
+
const bytes = Buffer.from(await response.arrayBuffer());
|
|
216
|
+
writeFileSync(outputPath, bytes);
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
function fileTimestampQuery(filePath) {
|
|
220
|
+
const stats = statSync(filePath);
|
|
221
|
+
const query = new URLSearchParams();
|
|
222
|
+
query.set("creationTime", stats.birthtime.toISOString());
|
|
223
|
+
query.set("lastWriteTime", stats.mtime.toISOString());
|
|
224
|
+
return query;
|
|
225
|
+
}
|
|
226
|
+
async function describeError(response) {
|
|
227
|
+
const body = await response.text();
|
|
228
|
+
return body ? `${response.status} ${response.statusText}: ${body}` : `${response.status} ${response.statusText}`;
|
|
229
|
+
}
|
|
230
|
+
function sleep(ms) {
|
|
231
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
232
|
+
}
|
|
233
|
+
//# sourceMappingURL=apiClient.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"apiClient.js","sourceRoot":"","sources":["../src/apiClient.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { Command, Option } from "commander";
|
|
3
|
+
import { basename } from "node:path";
|
|
4
|
+
import { SolulingApiClient } from "./apiClient.js";
|
|
5
|
+
import { promptPassword, promptText } from "./prompt.js";
|
|
6
|
+
const DEFAULT_API_URL = "https://www.soluling.com/api";
|
|
7
|
+
const DEV_API_URL = "http://localhost:52104/";
|
|
8
|
+
const program = new Command();
|
|
9
|
+
program
|
|
10
|
+
.name("solucli")
|
|
11
|
+
.description("Command-line tool for the Soluling localization cloud API - create and update " +
|
|
12
|
+
"projects, build them, and fetch localized files. Intended for use in CI/CD pipelines.");
|
|
13
|
+
program.addOption(new Option("-u, --user <username>", "Soluling username").env("SOLUCLI_USER"));
|
|
14
|
+
program.addOption(new Option("-p, --password <password>", "Soluling password").env("SOLUCLI_PASSWORD"));
|
|
15
|
+
program.addOption(new Option("-r, --url <url>", "Soluling API base URL")
|
|
16
|
+
.env("SOLUCLI_URL")
|
|
17
|
+
.default(DEFAULT_API_URL));
|
|
18
|
+
// Undocumented developer shortcut, intentionally left out of --help.
|
|
19
|
+
program.addOption(new Option("-d, --dev").hideHelp());
|
|
20
|
+
program.version("1.0.0", "-v, --version");
|
|
21
|
+
function resolveUrl() {
|
|
22
|
+
if (program.opts().dev && program.getOptionValueSource("url") !== "cli" && program.getOptionValueSource("url") !== "env")
|
|
23
|
+
return DEV_API_URL;
|
|
24
|
+
return program.opts().url;
|
|
25
|
+
}
|
|
26
|
+
async function createClient(command) {
|
|
27
|
+
const opts = command.optsWithGlobals();
|
|
28
|
+
// Only prompt against a real terminal - piped/non-interactive input (the normal case in
|
|
29
|
+
// CI/CD) has no one to answer a prompt, so fail fast there instead of hanging forever.
|
|
30
|
+
const user = opts.user ?? (process.stdin.isTTY ? await promptText("Soluling username: ") : undefined);
|
|
31
|
+
const password = opts.password ?? (process.stdin.isTTY ? await promptPassword("Soluling password: ") : undefined);
|
|
32
|
+
if (!user)
|
|
33
|
+
throw new Error("Missing required --user option (or the SOLUCLI_USER environment variable).");
|
|
34
|
+
if (!password)
|
|
35
|
+
throw new Error("Missing required --password option (or the SOLUCLI_PASSWORD environment variable).");
|
|
36
|
+
return new SolulingApiClient({ baseUrl: resolveUrl(), username: user, password });
|
|
37
|
+
}
|
|
38
|
+
function createAnonymousClient() {
|
|
39
|
+
return new SolulingApiClient({ baseUrl: resolveUrl(), username: "", password: "" });
|
|
40
|
+
}
|
|
41
|
+
function parseInteger(value) {
|
|
42
|
+
const result = parseInt(value, 10);
|
|
43
|
+
if (Number.isNaN(result))
|
|
44
|
+
throw new Error(`Not a valid integer: ${value}`);
|
|
45
|
+
return result;
|
|
46
|
+
}
|
|
47
|
+
/** Wraps a command action so a thrown Error becomes a clean "Error: ..." line and a non-zero
|
|
48
|
+
* exit code, instead of a raw stack trace. */
|
|
49
|
+
function action(fn) {
|
|
50
|
+
return async (...args) => {
|
|
51
|
+
try {
|
|
52
|
+
await fn(...args);
|
|
53
|
+
}
|
|
54
|
+
catch (err) {
|
|
55
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
56
|
+
console.error(`Error: ${message}`);
|
|
57
|
+
process.exitCode = 1;
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
// ---- project ---------------------------------------------------------------
|
|
62
|
+
const project = program.command("project").description("Manage Soluling projects.");
|
|
63
|
+
project
|
|
64
|
+
.command("create <file>")
|
|
65
|
+
.description("Create a new project by uploading a source (.ntp, or a .zip containing one) file.")
|
|
66
|
+
.option("--account <key>", "Id or key of the account to create the project in (default: your default account)")
|
|
67
|
+
.option("--name <name>", "Project name (defaults to the source file's name)")
|
|
68
|
+
.option("--artifacts", "Enable public build-artifact publishing", false)
|
|
69
|
+
.option("--cloud-is-master", "Treat the uploaded cloud copy as the master copy", false)
|
|
70
|
+
.action(action(async (file, options, command) => {
|
|
71
|
+
const client = await createClient(command);
|
|
72
|
+
const name = options.name ?? basename(file);
|
|
73
|
+
const project = await client.createProject(file, options.account, name, options.artifacts, options.cloudIsMaster);
|
|
74
|
+
console.log(JSON.stringify(project, null, 2));
|
|
75
|
+
}));
|
|
76
|
+
project
|
|
77
|
+
.command("create-source <file>")
|
|
78
|
+
.description("Create a new project by uploading a single resource file (.resx, .json, .xml, .html, etc.) as its first source - no .ntp needed.")
|
|
79
|
+
.requiredOption("--original-language <code>", "The file's language code, e.g. \"en\"")
|
|
80
|
+
.requiredOption("--target-languages <codes>", "Semicolon-separated language codes to localize into, e.g. \"fi;sv\"")
|
|
81
|
+
.option("--name <fileName>", "Name to give the source (defaults to the local file's name)")
|
|
82
|
+
.option("--project-name <name>", "Project name (defaults to the source's name)")
|
|
83
|
+
.option("--account <key>", "Id or key of the account to create the project in (default: your default account)")
|
|
84
|
+
.option("--type <sourceType>", "The source file's type code, e.g. \"resx\" (default: detected automatically)")
|
|
85
|
+
.option("--artifacts", "Enable public build-artifact publishing", false)
|
|
86
|
+
.option("--guid <guid>", "GUID to assign the project (default: generated)")
|
|
87
|
+
.action(action(async (file, options, command) => {
|
|
88
|
+
const client = await createClient(command);
|
|
89
|
+
const fileName = options.name ?? basename(file);
|
|
90
|
+
const project = await client.createProjectFromSource(file, fileName, options.originalLanguage, options.targetLanguages, options.projectName, options.account, options.type, options.artifacts, options.guid);
|
|
91
|
+
console.log(JSON.stringify(project, null, 2));
|
|
92
|
+
}));
|
|
93
|
+
project
|
|
94
|
+
.command("create-empty <name>")
|
|
95
|
+
.description("Create a new, empty project (no file) - add sources to it afterwards with 'project add-source'.")
|
|
96
|
+
.requiredOption("--original-language <code>", "The project's original (source) language code, e.g. \"en\"")
|
|
97
|
+
.requiredOption("--target-languages <codes>", "Semicolon-separated language codes to localize into, e.g. \"fi;sv\"")
|
|
98
|
+
.option("--account <key>", "Id or key of the account to create the project in (default: your default account)")
|
|
99
|
+
.option("--artifacts", "Enable public build-artifact publishing", false)
|
|
100
|
+
.option("--guid <guid>", "GUID to assign the project (default: generated)")
|
|
101
|
+
.action(action(async (name, options, command) => {
|
|
102
|
+
const client = await createClient(command);
|
|
103
|
+
const project = await client.createEmptyProject(name, options.originalLanguage, options.targetLanguages, options.account, options.artifacts, options.guid);
|
|
104
|
+
console.log(JSON.stringify(project, null, 2));
|
|
105
|
+
}));
|
|
106
|
+
project
|
|
107
|
+
.command("update <projectId> <file>")
|
|
108
|
+
.description("Replace a project's whole .ntp (or .zip) file with a new version.")
|
|
109
|
+
.action(action(async (projectId, file, _options, command) => {
|
|
110
|
+
const client = await createClient(command);
|
|
111
|
+
const project = await client.updateProject(parseInteger(projectId), file);
|
|
112
|
+
console.log(JSON.stringify(project, null, 2));
|
|
113
|
+
}));
|
|
114
|
+
project
|
|
115
|
+
.command("build <projectId>")
|
|
116
|
+
.description("Build a project, translating and validating its content.")
|
|
117
|
+
.option("--languages <codes>", "Semicolon-separated language codes to build (default: all)")
|
|
118
|
+
.option("--publish", "Publish the resulting files as build artifacts", false)
|
|
119
|
+
.action(action(async (projectId, options, command) => {
|
|
120
|
+
const client = await createClient(command);
|
|
121
|
+
const fileAction = await client.buildProject(parseInteger(projectId), options.languages, options.publish);
|
|
122
|
+
console.log(JSON.stringify(fileAction, null, 2));
|
|
123
|
+
}));
|
|
124
|
+
project
|
|
125
|
+
.command("download <projectId> <output>")
|
|
126
|
+
.description("Download a project's built, localized file. Polls until the build is ready.")
|
|
127
|
+
.option("--languages <codes>", "Semicolon-separated language codes to include (default: all)")
|
|
128
|
+
.option("--poll-interval <seconds>", "Seconds to wait between polls", parseInteger, 5)
|
|
129
|
+
.option("--timeout <seconds>", "Seconds to wait for the build before giving up", parseInteger, 1800)
|
|
130
|
+
.action(action(async (projectId, output, options, command) => {
|
|
131
|
+
const client = await createClient(command);
|
|
132
|
+
await client.downloadProject(parseInteger(projectId), output, options.languages, options.pollInterval, options.timeout);
|
|
133
|
+
console.log(`Saved to ${output}`);
|
|
134
|
+
}));
|
|
135
|
+
project
|
|
136
|
+
.command("add-language <projectId> <languageCode>")
|
|
137
|
+
.description("Add a language to a project (a no-op if it's already present).")
|
|
138
|
+
.action(action(async (projectId, languageCode, _options, command) => {
|
|
139
|
+
const client = await createClient(command);
|
|
140
|
+
await client.addLanguage(parseInteger(projectId), languageCode);
|
|
141
|
+
console.log(`Added language ${languageCode} to project ${projectId}.`);
|
|
142
|
+
}));
|
|
143
|
+
project
|
|
144
|
+
.command("add-source <projectId> <file>")
|
|
145
|
+
.description("Add a resource file (.resx, .json, .xml, .html, etc.) to a project as a new source.")
|
|
146
|
+
.option("--name <fileName>", "Name to give the source (defaults to the local file's name)")
|
|
147
|
+
.option("--type <sourceType>", "The source file's type code, e.g. \"resx\" (default: detected automatically)")
|
|
148
|
+
.action(action(async (projectId, file, options, command) => {
|
|
149
|
+
const client = await createClient(command);
|
|
150
|
+
const fileName = options.name ?? basename(file);
|
|
151
|
+
const fileAction = await client.addSource(parseInteger(projectId), fileName, file, options.type);
|
|
152
|
+
console.log(JSON.stringify(fileAction, null, 2));
|
|
153
|
+
}));
|
|
154
|
+
project
|
|
155
|
+
.command("update-source <projectId> <fileName> <file>")
|
|
156
|
+
.description("Replace the content of an existing source file with a local file's content.")
|
|
157
|
+
.action(action(async (projectId, fileName, file, _options, command) => {
|
|
158
|
+
const client = await createClient(command);
|
|
159
|
+
const fileAction = await client.updateSource(parseInteger(projectId), fileName, file);
|
|
160
|
+
console.log(JSON.stringify(fileAction, null, 2));
|
|
161
|
+
}));
|
|
162
|
+
project
|
|
163
|
+
.command("remove-source <projectId> <fileName>")
|
|
164
|
+
.description("Remove a source file from a project.")
|
|
165
|
+
.action(action(async (projectId, fileName, _options, command) => {
|
|
166
|
+
const client = await createClient(command);
|
|
167
|
+
const fileAction = await client.removeSource(parseInteger(projectId), fileName);
|
|
168
|
+
console.log(JSON.stringify(fileAction, null, 2));
|
|
169
|
+
}));
|
|
170
|
+
project
|
|
171
|
+
.command("sources <projectId>")
|
|
172
|
+
.description("List a project's source files.")
|
|
173
|
+
.action(action(async (projectId, _options, command) => {
|
|
174
|
+
const client = await createClient(command);
|
|
175
|
+
const sources = await client.listSources(parseInteger(projectId));
|
|
176
|
+
console.log(JSON.stringify(sources, null, 2));
|
|
177
|
+
}));
|
|
178
|
+
project
|
|
179
|
+
.command("download-source <projectId> <fileName> <language> <output>")
|
|
180
|
+
.description("Download a source file's already-built localized file for one language. Run 'project build' first - this doesn't queue one.")
|
|
181
|
+
.action(action(async (projectId, fileName, language, output, _options, command) => {
|
|
182
|
+
const client = await createClient(command);
|
|
183
|
+
await client.downloadSourceArtifact(parseInteger(projectId), fileName, language, output);
|
|
184
|
+
console.log(`Saved to ${output}`);
|
|
185
|
+
}));
|
|
186
|
+
// ---- artifact ----------------------------------------------------------------
|
|
187
|
+
const artifact = program.command("artifact").description("Fetch a project's published build artifacts (anonymous, no login required).");
|
|
188
|
+
artifact
|
|
189
|
+
.command("languages <projectGuid>")
|
|
190
|
+
.description("List the languages a project's published build artifacts are available in.")
|
|
191
|
+
.action(action(async (projectGuid) => {
|
|
192
|
+
const client = createAnonymousClient();
|
|
193
|
+
const languages = await client.getArtifactLanguages(projectGuid);
|
|
194
|
+
console.log(JSON.stringify(languages, null, 2));
|
|
195
|
+
}));
|
|
196
|
+
artifact
|
|
197
|
+
.command("get <projectGuid> <filename> <output>")
|
|
198
|
+
.description("Download a project's published build artifact file.")
|
|
199
|
+
.action(action(async (projectGuid, filename, output) => {
|
|
200
|
+
const client = createAnonymousClient();
|
|
201
|
+
await client.getArtifact(projectGuid, filename, output);
|
|
202
|
+
console.log(`Saved to ${output}`);
|
|
203
|
+
}));
|
|
204
|
+
await program.parseAsync(process.argv);
|
|
205
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/jwt.js
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/** Decodes a JWT's own "exp" claim (seconds since epoch) and returns it in milliseconds. */
|
|
2
|
+
export function decodeJwtExpiryMs(token) {
|
|
3
|
+
const parts = token.split(".");
|
|
4
|
+
if (parts.length < 2)
|
|
5
|
+
throw new Error("Invalid JWT: missing payload segment.");
|
|
6
|
+
const json = Buffer.from(parts[1], "base64url").toString("utf8");
|
|
7
|
+
const payload = JSON.parse(json);
|
|
8
|
+
if (typeof payload.exp !== "number")
|
|
9
|
+
throw new Error("Invalid JWT: missing exp claim.");
|
|
10
|
+
return payload.exp * 1000;
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=jwt.js.map
|
package/dist/jwt.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../src/jwt.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAE3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;IAErD,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;QACjC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAErD,OAAO,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;AAC5B,CAAC"}
|
package/dist/models.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":""}
|
package/dist/prompt.js
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { createInterface } from "node:readline";
|
|
2
|
+
/** Prompts for a line of plain, echoed input. Writes to stderr so it never pollutes a command's
|
|
3
|
+
* stdout (JSON) output when both are visible in the same terminal. */
|
|
4
|
+
export async function promptText(question) {
|
|
5
|
+
const rl = createInterface({ input: process.stdin, output: process.stderr });
|
|
6
|
+
try {
|
|
7
|
+
return await new Promise((resolve) => rl.question(question, resolve));
|
|
8
|
+
}
|
|
9
|
+
finally {
|
|
10
|
+
rl.close();
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
/** Prompts for a line of input without echoing it back - masks each keystroke with "*" instead.
|
|
14
|
+
* Only meaningful against a real terminal; callers should check process.stdin.isTTY first. */
|
|
15
|
+
export async function promptPassword(question) {
|
|
16
|
+
return new Promise((resolve) => {
|
|
17
|
+
process.stderr.write(question);
|
|
18
|
+
const stdin = process.stdin;
|
|
19
|
+
const wasRaw = stdin.isRaw;
|
|
20
|
+
stdin.setRawMode(true);
|
|
21
|
+
stdin.resume();
|
|
22
|
+
stdin.setEncoding("utf8");
|
|
23
|
+
let value = "";
|
|
24
|
+
const finish = (result) => {
|
|
25
|
+
stdin.removeListener("data", onData);
|
|
26
|
+
stdin.setRawMode(wasRaw ?? false);
|
|
27
|
+
stdin.pause();
|
|
28
|
+
process.stderr.write("\n");
|
|
29
|
+
resolve(result);
|
|
30
|
+
};
|
|
31
|
+
const onData = (char) => {
|
|
32
|
+
switch (char) {
|
|
33
|
+
case "\n":
|
|
34
|
+
case "\r":
|
|
35
|
+
case "": // Ctrl+D
|
|
36
|
+
finish(value);
|
|
37
|
+
break;
|
|
38
|
+
case "": // Ctrl+C
|
|
39
|
+
process.stderr.write("\n");
|
|
40
|
+
process.exit(130);
|
|
41
|
+
break;
|
|
42
|
+
case "": // Backspace
|
|
43
|
+
case "\b":
|
|
44
|
+
if (value.length > 0) {
|
|
45
|
+
value = value.slice(0, -1);
|
|
46
|
+
process.stderr.write("\b \b");
|
|
47
|
+
}
|
|
48
|
+
break;
|
|
49
|
+
default:
|
|
50
|
+
value += char;
|
|
51
|
+
process.stderr.write("*");
|
|
52
|
+
break;
|
|
53
|
+
}
|
|
54
|
+
};
|
|
55
|
+
stdin.on("data", onData);
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;sEACsE;AACtE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7E,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED;8FAC8F;AAC9F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1B,IAAI,KAAK,GAAG,EAAE,CAAC;QAEf,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE;YAChC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrC,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;YAClC,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE;YAC9B,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,IAAI,CAAC;gBACV,KAAK,IAAI,CAAC;gBACV,KAAK,GAAG,EAAE,SAAS;oBACjB,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,MAAM;gBACR,KAAK,GAAG,EAAE,SAAS;oBACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClB,MAAM;gBACR,KAAK,GAAG,CAAC,CAAC,YAAY;gBACtB,KAAK,IAAI;oBACP,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;wBAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAChC,CAAC;oBACD,MAAM;gBACR;oBACE,KAAK,IAAI,IAAI,CAAC;oBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC1B,MAAM;YACV,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@soluling/solucli",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Command-line tool for the Soluling localization cloud - create/update projects, build, and download localized files. Designed for use in CI/CD pipelines.",
|
|
5
|
+
"author": "Soluling",
|
|
6
|
+
"homepage": "https://www.soluling.com/Documentation/CLI",
|
|
7
|
+
"publishConfig": {
|
|
8
|
+
"access": "public"
|
|
9
|
+
},
|
|
10
|
+
"type": "module",
|
|
11
|
+
"bin": {
|
|
12
|
+
"solucli": "dist/index.js"
|
|
13
|
+
},
|
|
14
|
+
"files": [
|
|
15
|
+
"dist"
|
|
16
|
+
],
|
|
17
|
+
"engines": {
|
|
18
|
+
"node": ">=18"
|
|
19
|
+
},
|
|
20
|
+
"scripts": {
|
|
21
|
+
"build": "tsc",
|
|
22
|
+
"prepublishOnly": "npm run build",
|
|
23
|
+
"buildlib": "npm run build && npm publish"
|
|
24
|
+
},
|
|
25
|
+
"dependencies": {
|
|
26
|
+
"commander": "^12.1.0"
|
|
27
|
+
},
|
|
28
|
+
"devDependencies": {
|
|
29
|
+
"@types/node": "^20.14.0",
|
|
30
|
+
"typescript": "^5.5.4"
|
|
31
|
+
}
|
|
32
|
+
}
|