@project-ajax/sdk 0.0.59 → 0.0.61

package/src/cli/flags.ts

@@ -1,72 +0,0 @@
-import type { TypedFlagParameter } from "@stricli/core";
-import { type Environment, Environments } from "./config.js";
-import type { LocalContext } from "./context.js";
-
-export interface GlobalFlags {
-	config?: string;
-	debug: boolean;
-	env?: Environment;
-	"base-url"?: string;
-	token?: string;
-	"worker-id"?: string;
-}
-
-export const globalFlags: {
-	[K in keyof Required<GlobalFlags>]: TypedFlagParameter<
-		GlobalFlags[K],
-		LocalContext
-	>;
-} = {
-	config: {
-		kind: "parsed",
-		parse: String,
-		brief: "The path to the config file to use",
-		optional: true,
-	},
-	debug: {
-		kind: "boolean",
-		brief: "Enable debug logging",
-		default: false,
-	},
-	env: {
-		kind: "enum",
-		values: Environments,
-		brief: "The environment to use for the command",
-		optional: true,
-	},
-	"base-url": {
-		kind: "parsed",
-		parse: String,
-		brief: "The base URL to use for all API requests",
-		optional: true,
-	},
-	token: {
-		kind: "parsed",
-		parse: String,
-		brief: "The token to use for authentication",
-		optional: true,
-	},
-	"worker-id": {
-		kind: "parsed",
-		parse: String,
-		brief: "The ID of the worker to use for the command",
-		optional: true,
-	},
-};
-
-export interface FormatFlags {
-	plain: boolean;
-}
-
-export const formatFlags: {
-	[K in keyof Required<FormatFlags>]: TypedFlagParameter<
-		FormatFlags[K],
-		LocalContext
-	>;
-} = {
-	plain: {
-		kind: "boolean",
-		brief: "Output the results in plain text format",
-		default: false,
-	},
-};

package/src/cli/handler.ts

@@ -1,68 +0,0 @@
-import type { BaseArgs } from "@stricli/core";
-import { ApiClient } from "./api/client.js";
-import { Config } from "./config.js";
-import type { LocalContext } from "./context.js";
-import type { GlobalFlags } from "./flags.js";
-
-export interface HandlerContext extends LocalContext {
-	config: Config;
-}
-
-export interface AuthedContext extends HandlerContext {
-	apiClient: ApiClient;
-}
-
-export function buildHandler<const FLAGS, const ARGS extends BaseArgs = []>(
-	handler: (
-		this: HandlerContext,
-		flags: FLAGS,
-		...args: ARGS
-	) => Promise<void> | void,
-) {
-	return async function (
-		this: LocalContext,
-		flags: GlobalFlags & FLAGS,
-		...args: ARGS
-	) {
-		const configFilePath =
-			flags.config ??
-			this.process.env.WORKERS_CONFIG_FILE_PATH ??
-			"./workers.json";
-
-		const config = await Config.load({
-			configFilePath,
-			processEnv: process.env,
-			flags,
-		});
-
-		this.io.debugEnabled = flags.debug;
-
-		await handler.call({ ...this, config }, flags, ...args);
-	};
-}
-
-export function buildAuthedHandler<
-	const FLAGS,
-	const ARGS extends BaseArgs = [],
->(
-	handler: (
-		this: AuthedContext,
-		flags: FLAGS,
-		...args: ARGS
-	) => Promise<void> | void,
-) {
-	return buildHandler(function (flags: FLAGS, ...args: ARGS) {
-		// Check token first - this will throw TokenNotSetError with helpful message if not authenticated
-		const { token, cellId } = this.config.tokenInfo;
-		const environment = this.config.environment;
-
-		const client = new ApiClient({
-			token,
-			environment,
-			baseUrl: this.config.baseUrl,
-			cellId,
-			writer: this.io,
-		});
-		return handler.call({ ...this, apiClient: client }, flags, ...args);
-	});
-}

package/src/cli/io.ts

@@ -1,132 +0,0 @@
-// biome-ignore lint/style/noRestrictedImports: This file contains safe wrappers for prompts.
-import * as prompts from "@inquirer/prompts";
-// biome-ignore lint/style/noRestrictedImports: This is the one allowed location for this import.
-import { createTable, type TableCell, type TableItem } from "@visulima/tabular";
-
-export interface WriterOptions {
-	debugEnabled: boolean;
-}
-
-export interface TableOptions {
-	headers: TableCell[] | TableCell[][];
-	rows: TableCell[][];
-	plain: boolean;
-}
-
-type WithSafety<T> = T & {
-	noTTY: string;
-};
-
-/**
- * IO manages safe, consistent, input and output patterns for the CLI.
- */
-export class IO {
-	debugEnabled: boolean;
-
-	constructor(options: WriterOptions) {
-		this.debugEnabled = options.debugEnabled;
-	}
-
-	/**
-	 * Writes a debug message to standard error.
-	 *
-	 * @param args The arguments to write.
-	 */
-	debug(...args: Parameters<typeof console.log>) {
-		if (this.debugEnabled) {
-			args
-				.join(" ")
-				.split("\n")
-				.forEach((line) => {
-					this.writeErr(`[debug] ${line}`);
-				});
-		}
-	}
-
-	/**
-	 * Writes a message to standard out.
-	 *
-	 * @param args The arguments to write.
-	 */
-	writeOut(...args: Parameters<typeof process.stdout.write>) {
-		process.stdout.write(`${args.join(" ")}\n`);
-	}
-
-	/**
-	 * Writes a message to standard error.
-	 *
-	 * @param args The arguments to write.
-	 */
-	writeErr(...args: Parameters<typeof process.stderr.write>) {
-		process.stderr.write(`${args.join(" ")}\n`);
-	}
-
-	/**
-	 * Writes a table to standard out.
-	 *
-	 * @param tableConfig The table configuration.
-	 */
-	writeTableOut(tableConfig: TableOptions) {
-		const content = this.#buildTable(tableConfig);
-		this.writeOut(content);
-	}
-
-	/**
-	 * Writes a table to standard error.
-	 *
-	 * @param tableConfig The table configuration.
-	 */
-	writeTableErr(tableConfig: TableOptions) {
-		const content = this.#buildTable(tableConfig);
-		this.writeErr(content);
-	}
-
-	confirm(config: WithSafety<Parameters<typeof prompts.confirm>[0]>) {
-		this.#ensureTTY(config.noTTY);
-		return prompts.confirm(config).catch(this.#handlePromptExit.bind(this));
-	}
-
-	input(config: WithSafety<Parameters<typeof prompts.input>[0]>) {
-		this.#ensureTTY(config.noTTY);
-		return prompts.input(config).catch(this.#handlePromptExit.bind(this));
-	}
-
-	#ensureTTY(noTTY: string): true | never {
-		if (!process.stdin.isTTY) {
-			this.writeErr(noTTY);
-			process.exit(1);
-		}
-
-		return true;
-	}
-
-	#handlePromptExit(err: unknown) {
-		if (err instanceof Error && err.name === "ExitPromptError") {
-			this.writeErr("👋 Prompt cancelled. Goodbye!");
-			process.exit(1);
-		}
-
-		throw err;
-	}
-
-	#buildTable(tableConfig: TableOptions) {
-		if (tableConfig.plain) {
-			return tableConfig.rows
-				.map((row) => {
-					return row
-						.map((cell) => (isTableItem(cell) ? cell.content : cell))
-						.join("\t");
-				})
-				.join("\n");
-		} else {
-			const table = createTable();
-			table.setHeaders(tableConfig.headers);
-			table.addRows(...tableConfig.rows);
-			return table.toString();
-		}
-	}
-}
-
-function isTableItem(cell: TableCell): cell is TableItem {
-	return typeof cell === "object";
-}

package/src/cli/routes.ts

@@ -1,61 +0,0 @@
-import { buildApplication, buildRouteMap, text_en } from "@stricli/core";
-import packageJson from "../../package.json" with { type: "json" };
-import { authCommands } from "./commands/auth.js";
-import { bundleCommands } from "./commands/bundle.js";
-import { capabilitiesCommands } from "./commands/capabilities.js";
-import { connectCommands } from "./commands/connect.js";
-import deploy from "./commands/deploy.js";
-import { envCommands } from "./commands/env.js";
-import exec from "./commands/exec.js";
-import { runsCommands } from "./commands/runs.js";
-import { secretsCommands } from "./commands/secrets.js";
-import { TokenNotSetError } from "./config.js";
-
-const routes = buildRouteMap({
-	docs: {
-		brief: "A CLI for the Project Ajax platform",
-		fullDescription: `
-The Project Ajax CLI is a tool for managing workers, which run code written by
-you, other developers, or AI agents to perform automation tasks, such as syncing
-data, adding slash commands, or performing other actions.
-
-Most flags are configured either with a config file or flags, but environment
-variables can also be provided:
-
-- WORKERS_CONFIG_FILE_PATH: The path to the config file to use (e.g. ./workers.dev.json)
-- WORKERS_TOKEN: The token to use for authentication
-- WORKERS_ENVIRONMENT: The environment to use
-- WORKERS_WORKER_ID: The worker ID to use
-- WORKERS_BASE_URL: The base API URL to use
-`.trim(),
-	},
-	routes: {
-		auth: authCommands,
-		capabilities: capabilitiesCommands,
-		deploy: deploy,
-		exec: exec,
-		connect: connectCommands,
-		env: envCommands,
-		runs: runsCommands,
-		secrets: secretsCommands,
-		bundle: bundleCommands,
-	},
-});
-
-export const app = buildApplication(routes, {
-	name: "workers",
-	versionInfo: {
-		currentVersion: packageJson.version,
-	},
-	localization: {
-		loadText: () => ({
-			...text_en,
-			exceptionWhileRunningCommand(exc: unknown, ansiColor: boolean): string {
-				if (exc instanceof TokenNotSetError) {
-					return exc.message;
-				}
-				return text_en.exceptionWhileRunningCommand(exc, ansiColor);
-			},
-		}),
-	},
-});

package/src/cli/utils/array.ts

@@ -1,7 +0,0 @@
-export function chunkEvery<T>(array: readonly T[], size: number): T[][] {
-	const result: T[][] = [];
-	for (let i = 0; i < array.length; i += size) {
-		result.push(array.slice(i, i + size));
-	}
-	return result;
-}

package/src/cli/utils/openUrl.ts

@@ -1,53 +0,0 @@
-import { exec } from "node:child_process";
-import { existsSync } from "node:fs";
-
-import type { Environment } from "../config.js";
-
-export async function openBrowserUrl(url: string): Promise<void> {
-	const platform = process.platform;
-
-	try {
-		if (platform === "darwin") {
-			exec(`open "${url}"`);
-		} else if (platform === "win32") {
-			exec(`start "" "${url}"`);
-		} else {
-			exec(`xdg-open "${url}"`);
-		}
-	} catch (error) {
-		throw new Error(`Failed to open browser: ${error}`);
-	}
-}
-
-export async function openNotionUrl(
-	env: Environment,
-	url: string,
-): Promise<void> {
-	const platform = process.platform;
-
-	if (platform === "darwin") {
-		const appName = preferredNotionApp(env);
-		if (appName) {
-			try {
-				exec(`open -a "${appName}" "${url}"`);
-				return;
-			} catch {
-				// Fall back to the default browser below.
-			}
-		}
-	}
-
-	await openBrowserUrl(url);
-}
-
-function preferredNotionApp(env: Environment): string | null {
-	if (env === "prod" && existsSync("/Applications/Notion.app")) {
-		return "Notion";
-	}
-
-	if (env === "dev" && existsSync("/Applications/Notion Dev.app")) {
-		return "Notion Dev";
-	}
-
-	return null;
-}

package/src/cli/utils/string.ts

@@ -1,9 +0,0 @@
-export function pluralize(count: number, word: string, pluralWord?: string) {
-	if (count === 1) {
-		return `${count} ${word}`;
-	}
-	if (!pluralWord) {
-		return `${count} ${word}s`;
-	}
-	return `${count} ${pluralWord}`;
-}