@project-ajax/sdk 0.0.60 → 0.0.61

package/src/cli/commands/env.impl.ts

@@ -1,88 +0,0 @@
-import { Result } from "../api/result.js";
-import { buildAuthedHandler } from "../handler.js";
-import { pluralize } from "../utils/string.js";
-
-export interface PullEnvFlags {
-	yes: boolean;
-}
-
-export const DEFAULT_ENV_FILE = ".env";
-
-export const pullEnv = buildAuthedHandler(async function (
-	flags: PullEnvFlags,
-	filePath?: string,
-) {
-	const { workerId } = this.config;
-	if (!workerId) {
-		throw new Error(
-			"No worker configured. Run 'workers deploy' first to create a worker.",
-		);
-	}
-
-	const destination = filePath ?? DEFAULT_ENV_FILE;
-	const absoluteDestination = this.path.resolve(
-		this.process.cwd(),
-		destination,
-	);
-
-	if (this.fs.existsSync(absoluteDestination) && !flags.yes) {
-		const overwrite = await this.io.confirm({
-			message: `File "${destination}" already exists. Overwrite it?`,
-			noTTY: `File "${destination}" already exists.`,
-		});
-
-		if (overwrite !== true) {
-			this.io.writeErr("Aborted.");
-			return;
-		}
-	}
-
-	this.io.writeErr("Fetching environment variables...");
-	const envResult = await this.apiClient.pullEnv(workerId);
-
-	if (Result.isFail(envResult)) {
-		this.io.writeErr("✗ Failed to fetch env vars");
-		this.io.writeErr(`✗ ${envResult.error.message}`);
-		throw new Error(envResult.error.message);
-	}
-
-	const envEntries = envResult.value.env;
-	const fileContents = serializeEnvFile(envEntries);
-
-	await this.fs.promises.mkdir(this.path.dirname(absoluteDestination), {
-		recursive: true,
-	});
-	await this.fs.promises.writeFile(absoluteDestination, fileContents, "utf8");
-
-	this.io.writeErr(
-		`Wrote ${pluralize(envEntries.length, "env var")} to "${destination}"`,
-	);
-});
-
-export function serializeEnvFile(
-	envEntries: Array<{ key: string; value: string }>,
-): string {
-	if (envEntries.length === 0) {
-		return "# No env vars configured for this worker\n";
-	}
-
-	return envEntries
-		.map(({ key, value }) => `${key}=${formatEnvValue(value)}`)
-		.join("\n")
-		.concat("\n");
-}
-
-export function formatEnvValue(value: string): string {
-	if (/^[A-Za-z0-9_./:-]*$/.test(value)) {
-		return value;
-	}
-
-	const escaped = value
-		.replace(/\\/g, "\\\\")
-		.replace(/\n/g, "\\n")
-		.replace(/\r/g, "\\r")
-		.replace(/\t/g, "\\t")
-		.replace(/"/g, '\\"');
-
-	return `"${escaped}"`;
-}

package/src/cli/commands/env.ts

@@ -1,38 +0,0 @@
-import { buildCommand, buildRouteMap } from "@stricli/core";
-
-import { globalFlags } from "../flags.js";
-
-export const envCommands = buildRouteMap({
-	docs: {
-		brief: "Work with worker environment files",
-	},
-	routes: {
-		pull: buildCommand({
-			docs: {
-				brief: "Write the worker's env vars to a .env file",
-			},
-			parameters: {
-				positional: {
-					kind: "tuple",
-					parameters: [
-						{
-							brief: "Destination file path",
-							parse: String,
-							placeholder: "file",
-							optional: true,
-						},
-					],
-				},
-				flags: {
-					...globalFlags,
-					yes: {
-						kind: "boolean",
-						brief: "Overwrite the output file without prompting",
-						default: false,
-					},
-				},
-			},
-			loader: () => import("./env.impl.js").then((m) => m.pullEnv),
-		}),
-	},
-});

package/src/cli/commands/exec.impl.ts

@@ -1,171 +0,0 @@
-import { Result } from "../api/result.js";
-import type { GlobalFlags } from "../flags.js";
-import { buildAuthedHandler } from "../handler.js";
-import { chunkEvery } from "../utils/array.js";
-
-const usageHint = `Usage: workers exec <capabilityName> <capabilityFunction> [<argName1>=<value1> <argName2>=<value2>...]`;
-
-interface ExecFlags extends GlobalFlags {
-	stream: boolean;
-}
-
-export const exec = buildAuthedHandler(async function (
-	flags: ExecFlags,
-	...args: readonly string[]
-) {
-	const { workerId } = this.config;
-	if (!workerId) {
-		throw new Error(
-			"No worker configured. Run 'workers deploy' first to create a worker.",
-		);
-	}
-
-	const capabilityName = args[0];
-	const capabilityFunction = args[1] ?? null;
-	const functionArgs = args.slice(2).flatMap((arg) => arg.split(/[=]/));
-
-	if (!capabilityName) {
-		throw usageError();
-	}
-
-	// If there's an odd number of remaining args, the first one is the function name
-	if (functionArgs.length % 2 !== 0) {
-		throw usageError();
-	}
-
-	const argsList = chunkEvery(functionArgs, 2).map(([key, value]) => {
-		if (!key || !value) {
-			throw usageError();
-		}
-		return {
-			name: key,
-			value,
-		};
-	});
-
-	// Execute the capability
-	this.io.writeErr(`Executing capability "${capabilityName}"...`);
-
-	if (flags.stream) {
-		const result = await this.apiClient.runCapability(
-			workerId,
-			capabilityName,
-			capabilityFunction,
-			argsList,
-			true,
-		);
-
-		if (Result.isSuccess(result)) {
-			const decoder = new TextDecoder();
-			let buffer = "";
-
-			const allOutput: string[] = [];
-
-			const onBodyLine = async (jsonLine: string) => {
-				try {
-					const parsedLine = JSON.parse(jsonLine) as
-						| {
-								_tag: "log";
-								event: {
-									stream: "stdout" | "stderr";
-									data: string;
-								};
-						  }
-						| {
-								_tag: "result";
-								result: unknown;
-						  }
-						| {
-								_tag: "error";
-								error: string;
-						  };
-
-					switch (parsedLine._tag) {
-						case "log":
-							if (!flags.debug) {
-								break;
-							}
-
-							if (parsedLine.event.stream === "stdout") {
-								allOutput.push(parsedLine.event.data);
-							}
-
-							parsedLine.event.data
-								.trim()
-								.split("\n")
-								.forEach((dataLine) => {
-									this.io.writeErr(
-										`[worker:${parsedLine.event.stream}] ${dataLine.trim()}`,
-									);
-								});
-
-							break;
-						case "result":
-							this.io.writeOut(JSON.stringify(parsedLine.result, null, 2));
-							break;
-						case "error":
-							this.io.writeErr(`Error: ${parsedLine.error}`);
-							break;
-					}
-				} catch (error) {
-					this.io.writeErr(`Error parsing log line: ${jsonLine}: ${error}`);
-				}
-			};
-
-			for await (const log of result.value) {
-				const output = decoder.decode(log);
-				buffer += output;
-
-				const lines = buffer.split("\n");
-				// Keep the last element as buffer (might be empty or incomplete line)
-				buffer = lines.pop() ?? "";
-
-				// Process all complete lines
-				for (const line of lines) {
-					await onBodyLine(line);
-				}
-			}
-
-			// Process any remaining content in buffer
-			if (buffer) {
-				await onBodyLine(buffer);
-			}
-			return;
-		} else {
-			this.io.writeErr(`\n✗ Failed to execute capability`);
-
-			// If it's a validation error, show the clean debug message
-			if (result.error.validationError) {
-				this.io.writeErr(`\t✗ HTTP Error: ${result.error.status}`);
-				this.io.writeErr(`\t✗ ${result.error.validationError.debugMessage}`);
-				this.io.writeErr(`\n${usageHint}`);
-				throw new Error(result.error.validationError.debugMessage);
-			} else {
-				this.io.writeErr(`\t✗ HTTP Error: ${result.error.status}`);
-				this.io.writeErr(`\t✗ ${result.error.message}`);
-				throw new Error(result.error.message);
-			}
-		}
-	} else {
-		const result = await this.apiClient.runCapability(
-			workerId,
-			capabilityName,
-			capabilityFunction,
-			argsList,
-			false,
-		);
-
-		if (Result.isSuccess(result)) {
-			const data = Result.unwrap(result);
-			this.io.writeOut(JSON.stringify(data.result, null, 2));
-		} else {
-			this.io.writeErr(`\n✗ Failed to execute capability`);
-			this.io.writeErr(`\t✗ ${result.error.message}`);
-			throw new Error(result.error.message);
-		}
-	}
-});
-
-function usageError() {
-	return new Error(`Invalid arguments provided. ${usageHint}`);
-}

package/src/cli/commands/exec.ts

@@ -1,32 +0,0 @@
-import { buildCommand } from "@stricli/core";
-import { globalFlags } from "../flags.js";
-
-export default buildCommand({
-	docs: {
-		brief: "Execute a worker capability with optional function and arguments",
-	},
-
-	parameters: {
-		positional: {
-			kind: "array",
-			parameter: {
-				brief:
-					"Capability name, optional function name, and arguments (key value pairs)",
-				parse: String,
-				placeholder: "capabilityName [functionName] [key value]...",
-			},
-			minimum: 1,
-		},
-
-		flags: {
-			...globalFlags,
-			stream: {
-				kind: "boolean",
-				brief: "Stream the output of the capability",
-				default: true,
-			},
-		},
-	},
-
-	loader: () => import("./exec.impl.js").then((m) => m.exec),
-});

package/src/cli/commands/runs.impl.ts

@@ -1,87 +0,0 @@
-import { Result } from "../api/result.js";
-import type { FormatFlags, GlobalFlags } from "../flags.js";
-import { buildAuthedHandler } from "../handler.js";
-
-export const listRuns = buildAuthedHandler(async function (flags: FormatFlags) {
-	const { workerId } = this.config;
-	if (!workerId) {
-		throw new Error(
-			"No worker configured. Run 'workers deploy' first to create a worker.",
-		);
-	}
-
-	this.process.stderr.write("Fetching runs...");
-
-	const result = await this.apiClient.listRunsForWorker(workerId);
-
-	if (Result.isSuccess(result)) {
-		this.process.stderr.write("OK\n\n");
-
-		const data = Result.unwrap(result);
-		if (data.runs.length === 0) {
-			this.io.writeErr("No runs found for this worker.");
-		} else {
-			this.io.writeTableOut({
-				headers: ["Run ID", "Name", "Started At", "Ended At", "Exit Code"],
-				rows: data.runs.map((run) => [
-					run.runId,
-					run.name,
-					run.startedAt,
-					run.endedAt,
-					run.exitCode,
-				]),
-				plain: flags.plain,
-			});
-		}
-	} else {
-		this.process.stderr.write("ERROR\n\n");
-
-		// If it's a validation error, show the clean debug message
-		if (result.error.validationError) {
-			this.io.writeErr(`✗ ${result.error.validationError.debugMessage}`);
-			throw new Error(result.error.validationError.debugMessage);
-		} else {
-			this.io.writeErr(`✗ ${result.error.message}`);
-			throw new Error(result.error.message);
-		}
-	}
-});
-
-export const getRunLogs = buildAuthedHandler(async function (
-	_flags: GlobalFlags,
-	runId: string,
-) {
-	const { workerId } = this.config;
-	if (!workerId) {
-		throw new Error(
-			"No worker configured. Run 'workers deploy' first to create a worker.",
-		);
-	}
-
-	if (!runId) {
-		throw new Error("Run ID is required");
-	}
-
-	this.process.stderr.write(`Fetching logs for run ${runId}...`);
-
-	const result = await this.apiClient.getRunLogs(workerId, runId);
-
-	if (Result.isSuccess(result)) {
-		this.process.stderr.write("OK\n\n");
-
-		const data = Result.unwrap(result);
-		// Output logs directly to stdout (primary output)
-		this.io.writeOut(data.logs);
-	} else {
-		this.process.stderr.write("ERROR\n\n");
-
-		// If it's a validation error, show the clean debug message
-		if (result.error.validationError) {
-			this.io.writeErr(`✗ ${result.error.validationError.debugMessage}`);
-			throw new Error(result.error.validationError.debugMessage);
-		} else {
-			this.io.writeErr(`✗ ${result.error.message}`);
-			throw new Error(result.error.message);
-		}
-	}
-});

package/src/cli/commands/runs.ts

@@ -1,49 +0,0 @@
-import { buildCommand, buildRouteMap } from "@stricli/core";
-import { formatFlags, globalFlags } from "../flags.js";
-
-export const runsCommands = buildRouteMap({
-	docs: {
-		brief: "Commands for managing worker runs",
-	},
-	routes: {
-		list: buildCommand({
-			docs: {
-				brief: "List all runs for a worker",
-			},
-
-			parameters: {
-				flags: {
-					...globalFlags,
-					...formatFlags,
-				},
-			},
-
-			loader: () => import("./runs.impl.js").then((m) => m.listRuns),
-		}),
-
-		logs: buildCommand({
-			docs: {
-				brief: "Get logs for a specific run",
-			},
-
-			parameters: {
-				positional: {
-					kind: "tuple",
-					parameters: [
-						{
-							brief: "The run ID to get logs for",
-							parse: String,
-							placeholder: "runId",
-						},
-					],
-				},
-
-				flags: {
-					...globalFlags,
-				},
-			},
-
-			loader: () => import("./runs.impl.js").then((m) => m.getRunLogs),
-		}),
-	},
-});

package/src/cli/commands/secrets.impl.ts

@@ -1,130 +0,0 @@
-import { Result } from "../api/result.js";
-import type { FormatFlags, GlobalFlags } from "../flags.js";
-import { buildAuthedHandler } from "../handler.js";
-import { chunkEvery } from "../utils/array.js";
-import { pluralize } from "../utils/string.js";
-
-export const setSecrets = buildAuthedHandler(async function (
-	_flags: GlobalFlags,
-	...args: string[]
-) {
-	const secrets = parseSecretArgs(args);
-	const { workerId } = this.config;
-
-	if (!workerId) {
-		throw new Error(
-			"No worker configured. Run 'workers deploy' first to create a worker.",
-		);
-	}
-
-	this.io.writeErr(`Setting ${pluralize(secrets.length, "secret")}...`);
-
-	const result = await this.apiClient.upsertSecrets(workerId, secrets);
-
-	if (Result.isSuccess(result)) {
-		for (const secret of Result.unwrap(result).secrets) {
-			this.io.writeErr(`Set secret "${secret.key}"`);
-		}
-	} else {
-		this.io.writeErr(`✗ Failed to set secrets`);
-		this.io.writeErr(`✗ ${result.error.message}`);
-		throw new Error(result.error.message);
-	}
-});
-
-export const listSecrets = buildAuthedHandler(async function (
-	flags: FormatFlags,
-) {
-	const { workerId } = this.config;
-	if (!workerId) {
-		throw new Error(
-			"No worker configured. Run 'workers deploy' first to create a worker.",
-		);
-	}
-
-	this.process.stderr.write(`Fetching secrets...`);
-
-	const result = await this.apiClient.listSecrets(workerId);
-
-	if (Result.isSuccess(result)) {
-		this.process.stderr.write("OK\n\n");
-
-		const data = Result.unwrap(result);
-		if (data.secrets.length === 0) {
-			this.io.writeErr("No secrets for this worker.");
-			this.io.writeErr(
-				"To list OAuth connect secrets, use `npx workers connect list`",
-			);
-		} else {
-			this.io.writeTableOut({
-				headers: ["Key", "Created At"],
-				rows: data.secrets.map((secret) => [secret.key, secret.createdAt]),
-				plain: flags.plain,
-			});
-			this.io.writeErr(
-				"To list OAuth connect secrets, use `npx workers connect list`",
-			);
-		}
-	} else {
-		this.process.stderr.write("ERROR\n\n");
-
-		this.io.writeErr(`✗ Failed to list secrets`);
-		this.io.writeErr(`✗ ${result.error.message}`);
-		throw new Error(result.error.message);
-	}
-});
-
-export const removeSecret = buildAuthedHandler(async function (
-	_flags: GlobalFlags,
-	key: string,
-) {
-	const { workerId } = this.config;
-	if (!workerId) {
-		throw new Error(
-			"No worker configured. Run 'workers deploy' first to create a worker.",
-		);
-	}
-
-	this.process.stderr.write(`Removing secret "${key}"...`);
-
-	const result = await this.apiClient.deleteSecret(workerId, key);
-
-	if (Result.isSuccess(result)) {
-		this.process.stderr.write("OK\n\n");
-	} else {
-		this.process.stderr.write("ERROR\n\n");
-
-		this.io.writeErr(`✗ Failed to remove secret "${key}"`);
-		this.io.writeErr(`✗ ${result.error.message}`);
-		throw new Error(result.error.message);
-	}
-});
-
-function usageError() {
-	return new Error(
-		"Invalid secrets provided. Usage: workers secrets set <key> <value> [<key2> <value2>...] or <key>=<value> [<key2>=<value2>...]",
-	);
-}
-
-/**
- * Parse secret arguments from CLI, supporting "key value", "key=value", and "key:value" formats.
- */
-function parseSecretArgs(
-	args: readonly string[],
-): Array<{ key: string; value: string }> {
-	if (args.length === 0) {
-		throw usageError();
-	}
-
-	// Split each arg by = or : to flatten everything into tokens
-	const tokens = args.flatMap((arg) => arg.split(/[=:]/));
-
-	const secrets = chunkEvery(tokens, 2).map(([key, value]) => {
-		if (!key || !value) {
-			throw usageError();
-		}
-
-		return { key, value };
-	});
-	return secrets;
-}

package/src/cli/commands/secrets.ts

@@ -1,73 +0,0 @@
-import { buildCommand, buildRouteMap } from "@stricli/core";
-import { formatFlags, globalFlags } from "../flags.js";
-
-export const secretsCommands = buildRouteMap({
-	docs: {
-		brief: "Commands for managing worker secrets",
-	},
-	routes: {
-		set: buildCommand({
-			docs: {
-				brief:
-					"Set one or more secrets for a worker. Supports 'key value' or 'key=value' format.",
-			},
-
-			parameters: {
-				positional: {
-					kind: "array",
-					parameter: {
-						brief: "Secret key-value pairs (key value or key=value)",
-						parse: String,
-						placeholder: "secrets...",
-					},
-				},
-
-				flags: {
-					...globalFlags,
-				},
-			},
-
-			loader: () => import("./secrets.impl.js").then((m) => m.setSecrets),
-		}),
-
-		list: buildCommand({
-			docs: {
-				brief: "List all secrets for a worker (keys only)",
-			},
-
-			parameters: {
-				flags: {
-					...globalFlags,
-					...formatFlags,
-				},
-			},
-
-			loader: () => import("./secrets.impl.js").then((m) => m.listSecrets),
-		}),
-
-		rm: buildCommand({
-			docs: {
-				brief: "Remove a secret from a worker",
-			},
-
-			parameters: {
-				positional: {
-					kind: "tuple",
-					parameters: [
-						{
-							brief: "The secret key name to remove",
-							parse: String,
-							placeholder: "key",
-						},
-					],
-				},
-
-				flags: {
-					...globalFlags,
-				},
-			},
-
-			loader: () => import("./secrets.impl.js").then((m) => m.removeSecret),
-		}),
-	},
-});