stow-cli 2.2.0 → 2.2.1

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.
@@ -0,0 +1,102 @@
1
+ import {
2
+ isJsonOutput,
3
+ output
4
+ } from "./chunk-5IX3ASXH.js";
5
+ import {
6
+ formatTable
7
+ } from "./chunk-FZGOTXTE.js";
8
+ import {
9
+ getApiKey,
10
+ getBaseUrl
11
+ } from "./chunk-TOADDO2F.js";
12
+
13
+ // src/commands/jobs.ts
14
+ async function bucketRequest(opts) {
15
+ const baseUrl = getBaseUrl();
16
+ const apiKey = getApiKey();
17
+ const res = await fetch(`${baseUrl}${opts.path}`, {
18
+ method: opts.method,
19
+ headers: {
20
+ "x-api-key": apiKey,
21
+ ...opts.body ? { "Content-Type": "application/json" } : {}
22
+ },
23
+ ...opts.body ? { body: JSON.stringify(opts.body) } : {}
24
+ });
25
+ if (!res.ok) {
26
+ const body = await res.json().catch(() => ({ error: res.statusText }));
27
+ const message = body.error ?? `HTTP ${res.status}`;
28
+ throw new Error(message);
29
+ }
30
+ return await res.json();
31
+ }
32
+ function formatTimestamp(ts) {
33
+ return new Date(ts).toISOString().replace("T", " ").slice(0, 19);
34
+ }
35
+ async function listJobs(bucketId, options) {
36
+ const params = new URLSearchParams();
37
+ if (options.status) {
38
+ params.set("status", options.status);
39
+ }
40
+ if (options.queue) {
41
+ params.set("queue", options.queue);
42
+ }
43
+ if (options.limit) {
44
+ params.set("limit", options.limit);
45
+ }
46
+ const qs = params.toString();
47
+ const path = `/buckets/${bucketId}/jobs${qs ? `?${qs}` : ""}`;
48
+ const result = await bucketRequest({
49
+ method: "GET",
50
+ path
51
+ });
52
+ if (result.jobs.length === 0) {
53
+ if (isJsonOutput() || options.json) {
54
+ output(result.jobs);
55
+ } else {
56
+ console.log("No jobs found.");
57
+ }
58
+ return;
59
+ }
60
+ output(
61
+ result.jobs,
62
+ () => {
63
+ const rows = result.jobs.map((job) => [
64
+ job.jobId,
65
+ job.queueName,
66
+ job.status,
67
+ `${job.data.fileId.slice(0, 8)}...`,
68
+ formatTimestamp(job.timestamp),
69
+ job.failedReason ? job.failedReason.slice(0, 40) : ""
70
+ ]);
71
+ return formatTable(
72
+ ["ID", "Queue", "Status", "File", "Created", "Error"],
73
+ rows
74
+ );
75
+ },
76
+ { json: options.json }
77
+ );
78
+ }
79
+ async function retryJob(jobId, options) {
80
+ const result = await bucketRequest({
81
+ method: "POST",
82
+ path: `/buckets/${options.bucket}/jobs/${jobId}/retry`,
83
+ body: { queue: options.queue }
84
+ });
85
+ if (result.retried) {
86
+ console.log(`Job ${jobId} retried.`);
87
+ }
88
+ }
89
+ async function deleteJob(jobId, options) {
90
+ const result = await bucketRequest({
91
+ method: "DELETE",
92
+ path: `/buckets/${options.bucket}/jobs/${jobId}?queue=${encodeURIComponent(options.queue)}`
93
+ });
94
+ if (result.deleted) {
95
+ console.log(`Job ${jobId} removed.`);
96
+ }
97
+ }
98
+ export {
99
+ deleteJob,
100
+ listJobs,
101
+ retryJob
102
+ };
@@ -0,0 +1,102 @@
1
+ import {
2
+ isJsonOutput,
3
+ output
4
+ } from "./chunk-5BVMPHKH.js";
5
+ import {
6
+ formatTable
7
+ } from "./chunk-FZGOTXTE.js";
8
+ import {
9
+ getApiKey,
10
+ getBaseUrl
11
+ } from "./chunk-TOADDO2F.js";
12
+
13
+ // src/commands/jobs.ts
14
+ async function bucketRequest(opts) {
15
+ const baseUrl = getBaseUrl();
16
+ const apiKey = getApiKey();
17
+ const res = await fetch(`${baseUrl}${opts.path}`, {
18
+ method: opts.method,
19
+ headers: {
20
+ "x-api-key": apiKey,
21
+ ...opts.body ? { "Content-Type": "application/json" } : {}
22
+ },
23
+ ...opts.body ? { body: JSON.stringify(opts.body) } : {}
24
+ });
25
+ if (!res.ok) {
26
+ const body = await res.json().catch(() => ({ error: res.statusText }));
27
+ const message = body.error ?? `HTTP ${res.status}`;
28
+ throw new Error(message);
29
+ }
30
+ return await res.json();
31
+ }
32
+ function formatTimestamp(ts) {
33
+ return new Date(ts).toISOString().replace("T", " ").slice(0, 19);
34
+ }
35
+ async function listJobs(bucketId, options) {
36
+ const params = new URLSearchParams();
37
+ if (options.status) {
38
+ params.set("status", options.status);
39
+ }
40
+ if (options.queue) {
41
+ params.set("queue", options.queue);
42
+ }
43
+ if (options.limit) {
44
+ params.set("limit", options.limit);
45
+ }
46
+ const qs = params.toString();
47
+ const path = `/buckets/${bucketId}/jobs${qs ? `?${qs}` : ""}`;
48
+ const result = await bucketRequest({
49
+ method: "GET",
50
+ path
51
+ });
52
+ if (result.jobs.length === 0) {
53
+ if (isJsonOutput() || options.json) {
54
+ output(result.jobs);
55
+ } else {
56
+ console.log("No jobs found.");
57
+ }
58
+ return;
59
+ }
60
+ output(
61
+ result.jobs,
62
+ () => {
63
+ const rows = result.jobs.map((job) => [
64
+ job.jobId,
65
+ job.queueName,
66
+ job.status,
67
+ `${job.data.fileId.slice(0, 8)}...`,
68
+ formatTimestamp(job.timestamp),
69
+ job.failedReason ? job.failedReason.slice(0, 40) : ""
70
+ ]);
71
+ return formatTable(
72
+ ["ID", "Queue", "Status", "File", "Created", "Error"],
73
+ rows
74
+ );
75
+ },
76
+ { json: options.json }
77
+ );
78
+ }
79
+ async function retryJob(jobId, options) {
80
+ const result = await bucketRequest({
81
+ method: "POST",
82
+ path: `/buckets/${options.bucket}/jobs/${jobId}/retry`,
83
+ body: { queue: options.queue }
84
+ });
85
+ if (result.retried) {
86
+ console.log(`Job ${jobId} retried.`);
87
+ }
88
+ }
89
+ async function deleteJob(jobId, options) {
90
+ const result = await bucketRequest({
91
+ method: "DELETE",
92
+ path: `/buckets/${options.bucket}/jobs/${jobId}?queue=${encodeURIComponent(options.queue)}`
93
+ });
94
+ if (result.deleted) {
95
+ console.log(`Job ${jobId} removed.`);
96
+ }
97
+ }
98
+ export {
99
+ deleteJob,
100
+ listJobs,
101
+ retryJob
102
+ };
@@ -0,0 +1,79 @@
1
+ import {
2
+ adminRequest
3
+ } from "./chunk-QF7PVPWQ.js";
4
+ import {
5
+ output
6
+ } from "./chunk-5BVMPHKH.js";
7
+ import "./chunk-TOADDO2F.js";
8
+
9
+ // src/commands/admin/maintenance.ts
10
+ async function cleanupDrops(options) {
11
+ const params = new URLSearchParams();
12
+ if (options.maxAgeHours) {
13
+ params.set("maxAgeHours", options.maxAgeHours);
14
+ }
15
+ if (options.dryRun) {
16
+ params.set("dryRun", "true");
17
+ }
18
+ const qs = params.toString();
19
+ const result = await adminRequest({
20
+ method: "POST",
21
+ path: `/admin/cleanup-drops${qs ? `?${qs}` : ""}`
22
+ });
23
+ output(
24
+ result,
25
+ () => options.dryRun ? `[dry run] Would clean up ${result.count ?? 0} drops` : `Cleaned up ${result.deleted ?? 0} drops`,
26
+ { json: options.json }
27
+ );
28
+ }
29
+ async function purgeEvents(options) {
30
+ const params = new URLSearchParams();
31
+ if (options.dryRun) {
32
+ params.set("dryRun", "true");
33
+ }
34
+ const qs = params.toString();
35
+ const result = await adminRequest({
36
+ method: "POST",
37
+ path: `/admin/purge-events${qs ? `?${qs}` : ""}`
38
+ });
39
+ output(
40
+ result,
41
+ () => options.dryRun ? `[dry run] Would purge ${result.count ?? 0} events` : `Purged ${result.deleted ?? 0} events`,
42
+ { json: options.json }
43
+ );
44
+ }
45
+ async function reconcileFiles(options) {
46
+ const params = new URLSearchParams({ bucketId: options.bucket });
47
+ if (options.dryRun) {
48
+ params.set("dryRun", "true");
49
+ }
50
+ const result = await adminRequest({
51
+ method: "POST",
52
+ path: `/admin/reconcile-files?${params}`
53
+ });
54
+ output(
55
+ result,
56
+ () => {
57
+ if (options.dryRun) {
58
+ return `[dry run] ${result.mismatched ?? 0} files need reconciliation`;
59
+ }
60
+ return `Reconciled ${result.reconciled ?? 0} files`;
61
+ },
62
+ { json: options.json }
63
+ );
64
+ }
65
+ async function retrySyncFailures(options) {
66
+ const result = await adminRequest({
67
+ method: "POST",
68
+ path: "/admin/retry-sync-failures"
69
+ });
70
+ output(result, () => `Retried ${result.retried ?? 0} sync failures`, {
71
+ json: options.json
72
+ });
73
+ }
74
+ export {
75
+ cleanupDrops,
76
+ purgeEvents,
77
+ reconcileFiles,
78
+ retrySyncFailures
79
+ };
@@ -0,0 +1,79 @@
1
+ import {
2
+ adminRequest
3
+ } from "./chunk-QF7PVPWQ.js";
4
+ import {
5
+ output
6
+ } from "./chunk-5IX3ASXH.js";
7
+ import "./chunk-TOADDO2F.js";
8
+
9
+ // src/commands/admin/maintenance.ts
10
+ async function cleanupDrops(options) {
11
+ const params = new URLSearchParams();
12
+ if (options.maxAgeHours) {
13
+ params.set("maxAgeHours", options.maxAgeHours);
14
+ }
15
+ if (options.dryRun) {
16
+ params.set("dryRun", "true");
17
+ }
18
+ const qs = params.toString();
19
+ const result = await adminRequest({
20
+ method: "POST",
21
+ path: `/admin/cleanup-drops${qs ? `?${qs}` : ""}`
22
+ });
23
+ output(
24
+ result,
25
+ () => options.dryRun ? `[dry run] Would clean up ${result.count ?? 0} drops` : `Cleaned up ${result.deleted ?? 0} drops`,
26
+ { json: options.json }
27
+ );
28
+ }
29
+ async function purgeEvents(options) {
30
+ const params = new URLSearchParams();
31
+ if (options.dryRun) {
32
+ params.set("dryRun", "true");
33
+ }
34
+ const qs = params.toString();
35
+ const result = await adminRequest({
36
+ method: "POST",
37
+ path: `/admin/purge-events${qs ? `?${qs}` : ""}`
38
+ });
39
+ output(
40
+ result,
41
+ () => options.dryRun ? `[dry run] Would purge ${result.count ?? 0} events` : `Purged ${result.deleted ?? 0} events`,
42
+ { json: options.json }
43
+ );
44
+ }
45
+ async function reconcileFiles(options) {
46
+ const params = new URLSearchParams({ bucketId: options.bucket });
47
+ if (options.dryRun) {
48
+ params.set("dryRun", "true");
49
+ }
50
+ const result = await adminRequest({
51
+ method: "POST",
52
+ path: `/admin/reconcile-files?${params}`
53
+ });
54
+ output(
55
+ result,
56
+ () => {
57
+ if (options.dryRun) {
58
+ return `[dry run] ${result.mismatched ?? 0} files need reconciliation`;
59
+ }
60
+ return `Reconciled ${result.reconciled ?? 0} files`;
61
+ },
62
+ { json: options.json }
63
+ );
64
+ }
65
+ async function retrySyncFailures(options) {
66
+ const result = await adminRequest({
67
+ method: "POST",
68
+ path: "/admin/retry-sync-failures"
69
+ });
70
+ output(result, () => `Retried ${result.retried ?? 0} sync failures`, {
71
+ json: options.json
72
+ });
73
+ }
74
+ export {
75
+ cleanupDrops,
76
+ purgeEvents,
77
+ reconcileFiles,
78
+ retrySyncFailures
79
+ };
@@ -0,0 +1,53 @@
1
+ import {
2
+ output
3
+ } from "./chunk-5IX3ASXH.js";
4
+ import {
5
+ formatTable
6
+ } from "./chunk-FZGOTXTE.js";
7
+ import {
8
+ createStow
9
+ } from "./chunk-5LU25QZK.js";
10
+ import "./chunk-TOADDO2F.js";
11
+
12
+ // src/commands/profiles.ts
13
+ async function createProfile(options) {
14
+ const stow = createStow();
15
+ const profile = await stow.profiles.create({
16
+ name: options.name,
17
+ ...options.bucket ? { bucketId: options.bucket } : {}
18
+ });
19
+ output(profile, () => `Created profile: ${profile.name} (${profile.id})`, {
20
+ json: options.json
21
+ });
22
+ }
23
+ async function getProfile(id, options) {
24
+ const stow = createStow();
25
+ const profile = await stow.profiles.get(id);
26
+ output(
27
+ profile,
28
+ () => {
29
+ const lines = [`Profile: ${profile.name} (${profile.id})`];
30
+ if (profile.clusters && profile.clusters.length > 0) {
31
+ lines.push("\nClusters:");
32
+ const rows = profile.clusters.map((c) => [
33
+ String(c.index),
34
+ c.name ?? "(unnamed)",
35
+ String(c.signalCount)
36
+ ]);
37
+ lines.push(formatTable(["Index", "Name", "Signals"], rows));
38
+ }
39
+ return lines.join("\n");
40
+ },
41
+ { json: options.json }
42
+ );
43
+ }
44
+ async function deleteProfile(id) {
45
+ const stow = createStow();
46
+ await stow.profiles.delete(id);
47
+ console.log(`Deleted profile: ${id}`);
48
+ }
49
+ export {
50
+ createProfile,
51
+ deleteProfile,
52
+ getProfile
53
+ };
@@ -0,0 +1,53 @@
1
+ import {
2
+ output
3
+ } from "./chunk-5BVMPHKH.js";
4
+ import {
5
+ formatTable
6
+ } from "./chunk-FZGOTXTE.js";
7
+ import {
8
+ createStow
9
+ } from "./chunk-5LU25QZK.js";
10
+ import "./chunk-TOADDO2F.js";
11
+
12
+ // src/commands/profiles.ts
13
+ async function createProfile(options) {
14
+ const stow = createStow();
15
+ const profile = await stow.profiles.create({
16
+ name: options.name,
17
+ ...options.bucket ? { bucketId: options.bucket } : {}
18
+ });
19
+ output(profile, () => `Created profile: ${profile.name} (${profile.id})`, {
20
+ json: options.json
21
+ });
22
+ }
23
+ async function getProfile(id, options) {
24
+ const stow = createStow();
25
+ const profile = await stow.profiles.get(id);
26
+ output(
27
+ profile,
28
+ () => {
29
+ const lines = [`Profile: ${profile.name} (${profile.id})`];
30
+ if (profile.clusters && profile.clusters.length > 0) {
31
+ lines.push("\nClusters:");
32
+ const rows = profile.clusters.map((c) => [
33
+ String(c.index),
34
+ c.name ?? "(unnamed)",
35
+ String(c.signalCount)
36
+ ]);
37
+ lines.push(formatTable(["Index", "Name", "Signals"], rows));
38
+ }
39
+ return lines.join("\n");
40
+ },
41
+ { json: options.json }
42
+ );
43
+ }
44
+ async function deleteProfile(id) {
45
+ const stow = createStow();
46
+ await stow.profiles.delete(id);
47
+ console.log(`Deleted profile: ${id}`);
48
+ }
49
+ export {
50
+ createProfile,
51
+ deleteProfile,
52
+ getProfile
53
+ };
@@ -0,0 +1,61 @@
1
+ import {
2
+ adminRequest
3
+ } from "./chunk-QF7PVPWQ.js";
4
+ import {
5
+ isJsonOutput,
6
+ output
7
+ } from "./chunk-5BVMPHKH.js";
8
+ import {
9
+ formatTable
10
+ } from "./chunk-FZGOTXTE.js";
11
+ import "./chunk-TOADDO2F.js";
12
+
13
+ // src/commands/admin/queues.ts
14
+ async function listQueues(options) {
15
+ const result = await adminRequest({
16
+ method: "GET",
17
+ path: "/admin/queues"
18
+ });
19
+ const entries = Object.entries(result.queues);
20
+ if (entries.length === 0) {
21
+ if (isJsonOutput() || options.json) {
22
+ output(result.queues, void 0, { json: options.json });
23
+ } else {
24
+ console.log("No queues found.");
25
+ }
26
+ return;
27
+ }
28
+ output(
29
+ result.queues,
30
+ () => {
31
+ const rows = entries.map(([name, counts]) => [
32
+ name,
33
+ String(counts.waiting),
34
+ String(counts.active),
35
+ String(counts.completed),
36
+ String(counts.failed)
37
+ ]);
38
+ return formatTable(
39
+ ["Queue", "Waiting", "Active", "Completed", "Failed"],
40
+ rows
41
+ );
42
+ },
43
+ { json: options.json }
44
+ );
45
+ }
46
+ async function cleanQueue(queueName, options) {
47
+ const status = options.failed ? "failed" : "completed";
48
+ const grace = options.grace ? Number(options.grace) : 0;
49
+ const result = await adminRequest({
50
+ method: "POST",
51
+ path: `/admin/queues/${encodeURIComponent(queueName)}/clean`,
52
+ body: { status, grace }
53
+ });
54
+ console.log(
55
+ `Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`
56
+ );
57
+ }
58
+ export {
59
+ cleanQueue,
60
+ listQueues
61
+ };
@@ -0,0 +1,61 @@
1
+ import {
2
+ adminRequest
3
+ } from "./chunk-QF7PVPWQ.js";
4
+ import {
5
+ isJsonOutput,
6
+ output
7
+ } from "./chunk-5IX3ASXH.js";
8
+ import {
9
+ formatTable
10
+ } from "./chunk-FZGOTXTE.js";
11
+ import "./chunk-TOADDO2F.js";
12
+
13
+ // src/commands/admin/queues.ts
14
+ async function listQueues(options) {
15
+ const result = await adminRequest({
16
+ method: "GET",
17
+ path: "/admin/queues"
18
+ });
19
+ const entries = Object.entries(result.queues);
20
+ if (entries.length === 0) {
21
+ if (isJsonOutput() || options.json) {
22
+ output(result.queues, void 0, { json: options.json });
23
+ } else {
24
+ console.log("No queues found.");
25
+ }
26
+ return;
27
+ }
28
+ output(
29
+ result.queues,
30
+ () => {
31
+ const rows = entries.map(([name, counts]) => [
32
+ name,
33
+ String(counts.waiting),
34
+ String(counts.active),
35
+ String(counts.completed),
36
+ String(counts.failed)
37
+ ]);
38
+ return formatTable(
39
+ ["Queue", "Waiting", "Active", "Completed", "Failed"],
40
+ rows
41
+ );
42
+ },
43
+ { json: options.json }
44
+ );
45
+ }
46
+ async function cleanQueue(queueName, options) {
47
+ const status = options.failed ? "failed" : "completed";
48
+ const grace = options.grace ? Number(options.grace) : 0;
49
+ const result = await adminRequest({
50
+ method: "POST",
51
+ path: `/admin/queues/${encodeURIComponent(queueName)}/clean`,
52
+ body: { status, grace }
53
+ });
54
+ console.log(
55
+ `Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`
56
+ );
57
+ }
58
+ export {
59
+ cleanQueue,
60
+ listQueues
61
+ };