@novedu/cli 0.7.0 → 0.8.0

package/dist/main.js

@@ -6,11 +6,11 @@ import { createServer } from "node:http";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { CryptoProvider, PublicClientApplication } from "@azure/msal-node";
+import { readFile } from "node:fs/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import Handlebars from "handlebars";
 import { parse } from "yaml";
 import { z } from "zod";
-import { readFile } from "node:fs/promises";
 //#region src/auth.ts
 const DEFAULT_TENANT_ID = "91fc072c-edef-4f97-bdc5-cfb67718ae3a";
 const DEFAULT_CLIENT_ID = "4d44fc4b-0434-4981-9765-62e2074ceecb";
@@ -185,6 +185,143 @@ function displayName(result) {
 	return result.account?.name ?? result.account?.username ?? "(unknown account)";
 }
 //#endregion
+//#region src/server-url.ts
+const DEFAULT_SERVER = "https://novedu-chat-mvp-at.azurewebsites.net";
+function resolveServerUrl(cliOption) {
+	return cliOption || process.env.NOVEDU_SERVER || DEFAULT_SERVER;
+}
+//#endregion
+//#region src/api.ts
+/** Pretty-prints a success payload to stdout. */
+function printJson(value) {
+	console.log(JSON.stringify(value, null, 2));
+}
+/** Prints a failure payload as JSON to stderr and marks the process failed. */
+function failJson(value) {
+	console.error(JSON.stringify(value, null, 2));
+	process.exitCode = 1;
+}
+/**
+* Performs one authenticated API request and prints the outcome per the JSON
+* contract. Server error bodies (`{ message }` — incl. the generic 401/403 —
+* or `{ errors }`) are passed through VERBATIM to stderr — the server's
+* structured validation detail is the CLI's error message. No client-side
+* pre-validation: the server runs the identical pipeline; offline checking is
+* the `validate` command's job.
+*/
+async function runApiRequest(options) {
+	let token;
+	try {
+		token = await getAccessToken();
+	} catch (error) {
+		if (error instanceof NotSignedInError) {
+			failJson({ message: error.message });
+			return;
+		}
+		throw error;
+	}
+	const server = resolveServerUrl(options.server);
+	let response;
+	try {
+		response = await fetch(new URL(options.path, server), {
+			method: options.method ?? "GET",
+			headers: {
+				authorization: `Bearer ${token}`,
+				...options.body === void 0 ? {} : { "content-type": "application/json" }
+			},
+			body: options.body === void 0 ? void 0 : JSON.stringify(options.body)
+		});
+	} catch (error) {
+		failJson({ message: `Could not reach ${server}: ${error instanceof Error ? error.message : error}` });
+		return;
+	}
+	let payload;
+	try {
+		payload = await response.json();
+	} catch {
+		payload = void 0;
+	}
+	if (!response.ok) {
+		failJson(payload ?? { message: `${server} rejected the request: HTTP ${response.status}` });
+		return;
+	}
+	printJson(payload ?? null);
+}
+//#endregion
+//#region src/commands/codes.ts
+const SERVER_OPTION$1 = ["--server <url>", "Novedu server base URL (defaults to the NOVEDU_SERVER env var, then production)"];
+function registerCodes(program) {
+	const codes = program.command("codes").description("Manage activity codes on the Novedu server");
+	codes.command("create").description("Create a code for an activity YAML (validated server-side before storing)").requiredOption("--module <module>", "activity module: tutor, quiz, writing or coding").requiredOption("--file <url>", "public http(s) URL of the activity YAML").option("--start <iso>", "window start, ISO 8601 with explicit offset (e.g. 2026-07-07T08:00:00Z)").option("--end <iso>", "window end, ISO 8601 with explicit offset").option("--note <text>", "note shown in the codes list").option("--llm-provider <provider>", "LLM override provider (\"SCCH\" or \"Azure Foundry\"; needs --llm-model)").option("--llm-model <model>", "LLM override model id (needs --llm-provider)").option(...SERVER_OPTION$1).action(async (options) => {
+		await runApiRequest({
+			server: options.server,
+			path: "/api/codes",
+			method: "POST",
+			body: {
+				module: options.module,
+				fileUrl: options.file,
+				...options.start === void 0 ? {} : { validFrom: options.start },
+				...options.end === void 0 ? {} : { validUntil: options.end },
+				...options.note === void 0 ? {} : { note: options.note },
+				...options.llmProvider === void 0 && options.llmModel === void 0 ? {} : { llm: {
+					provider: options.llmProvider ?? "",
+					model: options.llmModel ?? ""
+				} }
+			}
+		});
+	});
+	codes.command("list").description("List codes (defaults to only your own, like the web list)").option("--search <q>", "contains-filter over note/code").option("--module <module>", "only codes for one activity module").option("--all", "include codes created by other teachers").option(...SERVER_OPTION$1).action(async (options) => {
+		const params = new URLSearchParams();
+		if (options.search) params.set("q", options.search);
+		if (options.module) params.set("module", options.module);
+		if (options.all) params.set("mine", "0");
+		const query = params.toString();
+		await runApiRequest({
+			server: options.server,
+			path: `/api/codes${query ? `?${query}` : ""}`
+		});
+	});
+}
+//#endregion
+//#region src/commands/files.ts
+const SERVER_OPTION = ["--server <url>", "Novedu server base URL (defaults to the NOVEDU_SERVER env var, then production)"];
+async function readStdin() {
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(chunk);
+	return Buffer.concat(chunks).toString("utf8");
+}
+function registerFiles(program) {
+	const files = program.command("files").description("Manage app-hosted YAML files on the Novedu server");
+	files.command("upload <name>").description("Create or update an app-hosted YAML file from --file or stdin (validated server-side)").option("--kind <kind>", "file kind (tutor, fragment, quiz, writing, coding) — required when creating").option("--file <path>", "read the YAML from this path instead of stdin").option(...SERVER_OPTION).action(async (name, options) => {
+		let content;
+		try {
+			content = options.file === void 0 ? await readStdin() : await readFile(options.file, "utf8");
+		} catch (error) {
+			failJson({ message: `Could not read ${options.file}: ${error instanceof Error ? error.message : error}` });
+			return;
+		}
+		await runApiRequest({
+			server: options.server,
+			path: `/api/files/${encodeURIComponent(name)}`,
+			method: "PUT",
+			body: {
+				...options.kind === void 0 ? {} : { kind: options.kind },
+				content
+			}
+		});
+	});
+	files.command("list").description("List app-hosted YAML files (defaults to only your own, like the web list)").option("--search <q>", "contains-filter over name/title/description").option("--all", "include files last written by other teachers").option(...SERVER_OPTION).action(async (options) => {
+		const params = new URLSearchParams();
+		if (options.search) params.set("q", options.search);
+		if (options.all) params.set("mine", "0");
+		const query = params.toString();
+		await runApiRequest({
+			server: options.server,
+			path: `/api/files${query ? `?${query}` : ""}`
+		});
+	});
+}
+//#endregion
 //#region src/commands/login.ts
 function registerLogin(program) {
 	program.command("login").description("Sign in to Microsoft Entra ID (opens your browser)").option("--device-code", "sign in with the device code flow instead (for machines without a browser; the tenant must allow it)").addHelpText("after", `
@@ -1310,12 +1447,6 @@ function formatOutcome(outcome, source) {
 	}
 }
 //#endregion
-//#region src/server-url.ts
-const DEFAULT_SERVER = "https://novedu-chat-mvp-at.azurewebsites.net";
-function resolveServerUrl(cliOption) {
-	return cliOption || process.env.NOVEDU_SERVER || DEFAULT_SERVER;
-}
-//#endregion
 //#region src/commands/whoami.ts
 function registerWhoami(program) {
 	program.command("whoami").description("Show who is signed in by calling the Novedu server's /api/me").option("--server <url>", "Novedu server base URL (defaults to the NOVEDU_SERVER env var, then production)").action(async (options) => {
@@ -1359,6 +1490,8 @@ registerValidate(program);
 registerLogin(program);
 registerLogout(program);
 registerWhoami(program);
+registerCodes(program);
+registerFiles(program);
 program.parseAsync().catch((err) => {
 	console.error(err instanceof Error ? err.message : err);
 	process.exitCode = 1;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@novedu/cli",
-  "version": "0.7.0",
-  "description": "Command-line companion for the Novedu chat app. Validates tutor, fragment, quiz, writing and coding YAML definitions (more commands to follow).",
+  "version": "0.8.0",
+  "description": "Command-line companion for the Novedu chat app. Validates tutor, fragment, quiz, writing and coding YAML definitions; signs in with Entra ID and manages codes and app-hosted files over the app's API.",
   "type": "module",
   "repository": {
     "type": "git",