@jant/core 0.3.46 → 0.3.47

package/bin/commands/posts.js

@@ -1,262 +0,0 @@
-import { parseArgs } from "node:util";
-import {
-  printJson,
-  readJsonInput,
-  requestJson,
-  requireApiToken,
-  requireSiteUrl,
-  runCommand,
-  sharedApiOptions,
-} from "../lib/http-api.js";
-
-function showHelp() {
-  console.log("Usage: jant posts <subcommand> [options]");
-  console.log("");
-  console.log("Subcommands:");
-  console.log("  list                List posts");
-  console.log("  get <id>            Get one post");
-  console.log("  content <id>        Get one post body as markdown");
-  console.log("  create              Create a post from JSON");
-  console.log("  update <id>         Update a post from JSON");
-  console.log("  delete <id>         Delete a post");
-  console.log("");
-  console.log("Create and update accept either:");
-  console.log("  --json '{...}'      Inline JSON body");
-  console.log("  --input <path>      Path to a JSON file");
-  console.log("  --input -           Read JSON from stdin");
-  console.log("");
-  console.log("Shared options:");
-  console.log("  --url               Target site URL");
-  console.log("  --token             API token");
-  console.log(
-    "  --config            Wrangler config file (default: wrangler.toml)",
-  );
-  console.log("  --env               Wrangler environment name");
-  console.log("");
-  console.log("Authentication:");
-  console.log("  Posts commands require an API token.");
-  console.log("  Use JANT_API_TOKEN or DEV_API_TOKEN for local development.");
-}
-
-export async function run(argv) {
-  return runCommand(async () => {
-    const [subcommand, ...rest] = argv;
-
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-      showHelp();
-      return;
-    }
-
-    switch (subcommand) {
-      case "list":
-        await runList(rest);
-        return;
-      case "get":
-        await runGet(rest);
-        return;
-      case "content":
-        await runContent(rest);
-        return;
-      case "create":
-        await runCreate(rest);
-        return;
-      case "update":
-        await runUpdate(rest);
-        return;
-      case "delete":
-        await runDelete(rest);
-        return;
-      default:
-        throw new Error(`Unknown posts subcommand: ${subcommand}`);
-    }
-  });
-}
-
-async function runList(argv) {
-  const { values } = parseArgs({
-    args: argv,
-    allowPositionals: false,
-    options: {
-      ...sharedApiOptions,
-      cursor: { type: "string" },
-      format: { type: "string" },
-      limit: { type: "string" },
-      status: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log("Usage: jant posts list [options]");
-    console.log("");
-    console.log("Options:");
-    console.log("  --format            note | link | quote");
-    console.log("  --status            draft | published");
-    console.log("  --limit             Max posts to return (1-100)");
-    console.log("  --cursor            Cursor from nextCursor");
-    return;
-  }
-
-  const siteUrl = requireSiteUrl(values, "Listing posts");
-  const token = requireApiToken(values, "Listing posts");
-
-  const result = await requestJson({
-    siteUrl,
-    path: "/api/posts",
-    token,
-    query: {
-      cursor: values.cursor,
-      format: values.format,
-      limit: values.limit,
-      status: values.status,
-    },
-  });
-
-  printJson(result);
-}
-
-async function runGet(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant posts get <id> [options]");
-    return;
-  }
-
-  const postId = positionals[0];
-  if (!postId) {
-    throw new Error("Post ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Getting a post");
-  const token = requireApiToken(values, "Getting a post");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/posts/${postId}`,
-    token,
-  });
-  printJson(result);
-}
-
-async function runContent(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant posts content <id> [options]");
-    return;
-  }
-
-  const postId = positionals[0];
-  if (!postId) {
-    throw new Error("Post ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Getting post content");
-  const token = requireApiToken(values, "Getting post content");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/posts/${postId}/content`,
-    token,
-  });
-  printJson(result);
-}
-
-async function runCreate(argv) {
-  const { values } = parseArgs({
-    args: argv,
-    allowPositionals: false,
-    options: {
-      ...sharedApiOptions,
-      input: { type: "string" },
-      json: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log("Usage: jant posts create (--json '{...}' | --input <path>)");
-    return;
-  }
-
-  const siteUrl = requireSiteUrl(values, "Creating a post");
-  const token = requireApiToken(values, "Creating a post");
-  const body = await readJsonInput(values);
-  const result = await requestJson({
-    siteUrl,
-    path: "/api/posts",
-    method: "POST",
-    token,
-    body,
-  });
-  printJson(result);
-}
-
-async function runUpdate(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: {
-      ...sharedApiOptions,
-      input: { type: "string" },
-      json: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log(
-      "Usage: jant posts update <id> (--json '{...}' | --input <path>)",
-    );
-    return;
-  }
-
-  const postId = positionals[0];
-  if (!postId) {
-    throw new Error("Post ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Updating a post");
-  const token = requireApiToken(values, "Updating a post");
-  const body = await readJsonInput(values);
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/posts/${postId}`,
-    method: "PUT",
-    token,
-    body,
-  });
-  printJson(result);
-}
-
-async function runDelete(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant posts delete <id> [options]");
-    return;
-  }
-
-  const postId = positionals[0];
-  if (!postId) {
-    throw new Error("Post ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Deleting a post");
-  const token = requireApiToken(values, "Deleting a post");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/posts/${postId}`,
-    method: "DELETE",
-    token,
-  });
-  printJson(result);
-}

package/bin/commands/search.js

@@ -1,53 +0,0 @@
-import { parseArgs } from "node:util";
-import {
-  getOptionalApiToken,
-  printJson,
-  requestJson,
-  requireSiteUrl,
-  runCommand,
-  sharedApiOptions,
-} from "../lib/http-api.js";
-
-function showHelp() {
-  console.log("Usage: jant search [--query <text>] [options]");
-  console.log("");
-  console.log("Options:");
-  console.log("  --query            Search query");
-  console.log("  --limit            Max results to return (1-50)");
-}
-
-export async function run(argv) {
-  return runCommand(async () => {
-    const { values, positionals } = parseArgs({
-      args: argv,
-      allowPositionals: true,
-      options: {
-        ...sharedApiOptions,
-        limit: { type: "string" },
-        query: { type: "string" },
-      },
-    });
-
-    if (values.help) {
-      showHelp();
-      return;
-    }
-
-    const query = values.query?.trim() || positionals.join(" ").trim();
-    if (!query) {
-      throw new Error("Search query is required.");
-    }
-
-    const siteUrl = requireSiteUrl(values, "Searching posts");
-    const result = await requestJson({
-      siteUrl,
-      path: "/api/search",
-      token: getOptionalApiToken(values),
-      query: {
-        limit: values.limit,
-        q: query,
-      },
-    });
-    printJson(result);
-  });
-}

package/bin/commands/settings.js

@@ -1,93 +0,0 @@
-import { parseArgs } from "node:util";
-import {
-  printJson,
-  readJsonInput,
-  requestJson,
-  requireApiToken,
-  requireSiteUrl,
-  runCommand,
-  sharedApiOptions,
-} from "../lib/http-api.js";
-
-function showHelp() {
-  console.log("Usage: jant settings <subcommand> [options]");
-  console.log("");
-  console.log("Subcommands:");
-  console.log("  get                Get editable site settings");
-  console.log("  update             Update editable site settings from JSON");
-}
-
-export async function run(argv) {
-  return runCommand(async () => {
-    const [subcommand, ...rest] = argv;
-
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-      showHelp();
-      return;
-    }
-
-    switch (subcommand) {
-      case "get":
-        await runGet(rest);
-        return;
-      case "update":
-        await runUpdate(rest);
-        return;
-      default:
-        throw new Error(`Unknown settings subcommand: ${subcommand}`);
-    }
-  });
-}
-
-async function runGet(argv) {
-  const { values } = parseArgs({
-    args: argv,
-    allowPositionals: false,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant settings get [options]");
-    return;
-  }
-
-  const siteUrl = requireSiteUrl(values, "Getting settings");
-  const token = requireApiToken(values, "Getting settings");
-  const result = await requestJson({
-    siteUrl,
-    path: "/api/settings",
-    token,
-  });
-  printJson(result);
-}
-
-async function runUpdate(argv) {
-  const { values } = parseArgs({
-    args: argv,
-    allowPositionals: false,
-    options: {
-      ...sharedApiOptions,
-      input: { type: "string" },
-      json: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log(
-      "Usage: jant settings update (--json '{...}' | --input <path>)",
-    );
-    return;
-  }
-
-  const siteUrl = requireSiteUrl(values, "Updating settings");
-  const token = requireApiToken(values, "Updating settings");
-  const body = await readJsonInput(values);
-  const result = await requestJson({
-    siteUrl,
-    path: "/api/settings",
-    method: "PUT",
-    token,
-    body,
-  });
-  printJson(result);
-}

package/bin/lib/http-api.js

@@ -1,223 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { CLI_API_TOKEN_ENV_VAR, getCliApiToken } from "./cli-api-token.js";
-import { resolveSiteUrl } from "./site-url.js";
-
-export const DEV_API_TOKEN_ENV_VAR = "DEV_API_TOKEN";
-
-export const sharedApiOptions = {
-  config: { type: "string" },
-  env: { type: "string" },
-  help: { type: "boolean", short: "h" },
-  token: { type: "string" },
-  url: { type: "string" },
-};
-
-function normalizeBaseUrl(value) {
-  const trimmed = value.trim();
-  return trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
-}
-
-function maybeParseJson(text) {
-  if (!text) {
-    return null;
-  }
-
-  try {
-    return JSON.parse(text);
-  } catch {
-    return null;
-  }
-}
-
-async function readStdinText() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
-  }
-
-  return Buffer.concat(chunks).toString("utf8");
-}
-
-export function buildApiUrl(siteUrl, path, query) {
-  const url = new URL(path.replace(/^\//, ""), normalizeBaseUrl(siteUrl));
-
-  if (query) {
-    for (const [key, value] of Object.entries(query)) {
-      if (value === undefined || value === null || value === "") {
-        continue;
-      }
-      url.searchParams.set(key, String(value));
-    }
-  }
-
-  return url.toString();
-}
-
-export function resolveRequestUrl(siteUrl, targetUrl) {
-  return new URL(targetUrl, normalizeBaseUrl(siteUrl)).toString();
-}
-
-export function requireSiteUrl(values, purpose) {
-  const siteUrl = resolveSiteUrl({
-    url: values.url,
-    config: values.config,
-    env: values.env,
-  });
-
-  if (!siteUrl) {
-    throw new Error(
-      `${purpose} requires --url or SITE_ORIGIN in the environment or wrangler.toml.`,
-    );
-  }
-
-  return siteUrl;
-}
-
-export function getOptionalApiToken(values) {
-  return (
-    values.token?.trim() ||
-    getCliApiToken(process.env, process.env[DEV_API_TOKEN_ENV_VAR]?.trim()) ||
-    ""
-  );
-}
-
-export function requireApiToken(values, purpose) {
-  const token = getOptionalApiToken(values);
-
-  if (!token) {
-    throw new Error(
-      `${purpose} requires --token or ${CLI_API_TOKEN_ENV_VAR} (or ${DEV_API_TOKEN_ENV_VAR} for local development).`,
-    );
-  }
-
-  return token;
-}
-
-export async function readJsonInput(values) {
-  const rawJson = values.json?.trim();
-  const inputPath = values.input?.trim();
-
-  if (rawJson && inputPath) {
-    throw new Error("Provide either --json or --input, not both.");
-  }
-
-  if (!rawJson && !inputPath) {
-    throw new Error("Provide --json or --input.");
-  }
-
-  const source =
-    rawJson ??
-    (inputPath === "-"
-      ? await readStdinText()
-      : await readFile(inputPath, "utf8"));
-
-  try {
-    return JSON.parse(source);
-  } catch {
-    const sourceLabel = rawJson
-      ? "--json"
-      : inputPath === "-"
-        ? "stdin"
-        : inputPath;
-    throw new Error(`Invalid JSON in ${sourceLabel}.`);
-  }
-}
-
-export async function requestRaw({
-  body,
-  headers: customHeaders,
-  method = "GET",
-  path,
-  query,
-  siteUrl,
-  token,
-  url,
-}) {
-  const requestUrl =
-    url ?? (siteUrl && path ? buildApiUrl(siteUrl, path, query) : "");
-  if (!requestUrl) {
-    throw new Error("requestRaw requires either url or siteUrl + path.");
-  }
-
-  const headers = {
-    ...(customHeaders ?? {}),
-  };
-
-  if (token) {
-    headers.Authorization = `Bearer ${token}`;
-  }
-  const response = await fetch(requestUrl, {
-    method,
-    headers,
-    body,
-  });
-
-  const text = await response.text();
-  const parsed = maybeParseJson(text);
-
-  if (!response.ok) {
-    const message =
-      parsed &&
-      typeof parsed === "object" &&
-      "error" in parsed &&
-      typeof parsed.error === "string"
-        ? parsed.error
-        : text || response.statusText;
-    throw new Error(`HTTP ${response.status}: ${message}`);
-  }
-
-  return {
-    json: parsed,
-    response,
-    text,
-    url: requestUrl,
-  };
-}
-
-export async function requestJson({
-  body,
-  method = "GET",
-  path,
-  query,
-  siteUrl,
-  token,
-  url,
-}) {
-  const headers = {
-    Accept: "application/json",
-  };
-  if (body !== undefined) {
-    headers["Content-Type"] = "application/json";
-  }
-
-  const { json, text } = await requestRaw({
-    body: body === undefined ? undefined : JSON.stringify(body),
-    headers,
-    method,
-    path,
-    query,
-    siteUrl,
-    token,
-    url,
-  });
-
-  if (!text) {
-    return null;
-  }
-
-  return json ?? text;
-}
-
-export function printJson(value) {
-  console.log(JSON.stringify(value, null, 2));
-}
-
-export async function runCommand(action) {
-  try {
-    await action();
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(`Error: ${message}`);
-    process.exit(1);
-  }
-}