@jant/core 0.3.46 → 0.3.48

package/bin/commands/collections.js

@@ -1,268 +0,0 @@
-import { parseArgs } from "node:util";
-import {
-  getOptionalApiToken,
-  printJson,
-  readJsonInput,
-  requestJson,
-  requireApiToken,
-  requireSiteUrl,
-  runCommand,
-  sharedApiOptions,
-} from "../lib/http-api.js";
-
-function showHelp() {
-  console.log("Usage: jant collections <subcommand> [options]");
-  console.log("");
-  console.log("Subcommands:");
-  console.log("  list                         List collections");
-  console.log("  get <id>                     Get one collection");
-  console.log("  create                       Create a collection from JSON");
-  console.log("  update <id>                  Update a collection from JSON");
-  console.log("  delete <id>                  Delete a collection");
-  console.log("  add-post <collection> <post> Add a post to a collection");
-  console.log(
-    "  remove-post <collection> <post> Remove a post from a collection",
-  );
-}
-
-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 "create":
-        await runCreate(rest);
-        return;
-      case "update":
-        await runUpdate(rest);
-        return;
-      case "delete":
-        await runDelete(rest);
-        return;
-      case "add-post":
-        await runAddPost(rest);
-        return;
-      case "remove-post":
-        await runRemovePost(rest);
-        return;
-      default:
-        throw new Error(`Unknown collections subcommand: ${subcommand}`);
-    }
-  });
-}
-
-async function runList(argv) {
-  const { values } = parseArgs({
-    args: argv,
-    allowPositionals: false,
-    options: {
-      ...sharedApiOptions,
-      view: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log("Usage: jant collections list [--view compose] [options]");
-    return;
-  }
-
-  const siteUrl = requireSiteUrl(values, "Listing collections");
-  const result = await requestJson({
-    siteUrl,
-    path: "/api/collections",
-    token: getOptionalApiToken(values),
-    query: { view: values.view },
-  });
-  printJson(result);
-}
-
-async function runGet(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant collections get <id> [options]");
-    return;
-  }
-
-  const collectionId = positionals[0];
-  if (!collectionId) {
-    throw new Error("Collection ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Getting a collection");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/collections/${collectionId}`,
-    token: getOptionalApiToken(values),
-  });
-  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 collections create (--json '{...}' | --input <path>)",
-    );
-    return;
-  }
-
-  const siteUrl = requireSiteUrl(values, "Creating a collection");
-  const token = requireApiToken(values, "Creating a collection");
-  const body = await readJsonInput(values);
-  const result = await requestJson({
-    siteUrl,
-    path: "/api/collections",
-    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 collections update <id> (--json '{...}' | --input <path>)",
-    );
-    return;
-  }
-
-  const collectionId = positionals[0];
-  if (!collectionId) {
-    throw new Error("Collection ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Updating a collection");
-  const token = requireApiToken(values, "Updating a collection");
-  const body = await readJsonInput(values);
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/collections/${collectionId}`,
-    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 collections delete <id> [options]");
-    return;
-  }
-
-  const collectionId = positionals[0];
-  if (!collectionId) {
-    throw new Error("Collection ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Deleting a collection");
-  const token = requireApiToken(values, "Deleting a collection");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/collections/${collectionId}`,
-    method: "DELETE",
-    token,
-  });
-  printJson(result);
-}
-
-async function runAddPost(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant collections add-post <collectionId> <postId>");
-    return;
-  }
-
-  const collectionId = positionals[0];
-  const postId = positionals[1];
-  if (!collectionId || !postId) {
-    throw new Error("Collection ID and post ID are required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Adding a post to a collection");
-  const token = requireApiToken(values, "Adding a post to a collection");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/collections/${collectionId}/posts`,
-    method: "POST",
-    token,
-    body: { postId },
-  });
-  printJson(result);
-}
-
-async function runRemovePost(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant collections remove-post <collectionId> <postId>");
-    return;
-  }
-
-  const collectionId = positionals[0];
-  const postId = positionals[1];
-  if (!collectionId || !postId) {
-    throw new Error("Collection ID and post ID are required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Removing a post from a collection");
-  const token = requireApiToken(values, "Removing a post from a collection");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/collections/${collectionId}/posts/${postId}`,
-    method: "DELETE",
-    token,
-  });
-  printJson(result);
-}

package/bin/commands/media.js

@@ -1,302 +0,0 @@
-import { parseArgs } from "node:util";
-import {
-  printJson,
-  requestJson,
-  requireApiToken,
-  requireSiteUrl,
-  runCommand,
-  sharedApiOptions,
-} from "../lib/http-api.js";
-import { uploadMediaFile } from "../lib/media-upload.js";
-
-function parseOptionalNonNegativeInteger(value, label) {
-  if (value === undefined) {
-    return undefined;
-  }
-
-  const parsed = Number.parseInt(value, 10);
-  if (!Number.isInteger(parsed) || parsed < 0) {
-    throw new Error(`${label} must be a non-negative integer.`);
-  }
-
-  return parsed;
-}
-
-function parseOptionalPositiveInteger(value, label) {
-  if (value === undefined) {
-    return undefined;
-  }
-
-  const parsed = Number.parseInt(value, 10);
-  if (!Number.isInteger(parsed) || parsed < 1) {
-    throw new Error(`${label} must be a positive integer.`);
-  }
-
-  return parsed;
-}
-
-function showHelp() {
-  console.log("Usage: jant media <subcommand> [options]");
-  console.log("");
-  console.log("Subcommands:");
-  console.log("  list                     List uploaded media");
-  console.log("  get <id>                 Get one media item");
-  console.log("  upload <file>            Upload one file");
-  console.log("  content <id>             Get text attachment markdown");
-  console.log("  set-alt <id> --alt <t>   Update alt text");
-  console.log("  delete <id>              Delete a media item");
-}
-
-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 "upload":
-        await runUpload(rest);
-        return;
-      case "content":
-        await runContent(rest);
-        return;
-      case "set-alt":
-        await runSetAlt(rest);
-        return;
-      case "delete":
-        await runDelete(rest);
-        return;
-      default:
-        throw new Error(`Unknown media subcommand: ${subcommand}`);
-    }
-  });
-}
-
-async function runList(argv) {
-  const { values } = parseArgs({
-    args: argv,
-    allowPositionals: false,
-    options: {
-      ...sharedApiOptions,
-      limit: { type: "string" },
-      mimePrefix: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log(
-      "Usage: jant media list [--limit 50] [--mimePrefix image/] [options]",
-    );
-    return;
-  }
-
-  const siteUrl = requireSiteUrl(values, "Listing media");
-  const token = requireApiToken(values, "Listing media");
-  const result = await requestJson({
-    siteUrl,
-    path: "/api/upload",
-    token,
-    query: {
-      limit: values.limit,
-      mimePrefix: values.mimePrefix,
-    },
-  });
-
-  printJson(result);
-}
-
-async function runGet(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant media get <id> [options]");
-    return;
-  }
-
-  const mediaId = positionals[0];
-  if (!mediaId) {
-    throw new Error("Media ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Getting media");
-  const token = requireApiToken(values, "Getting media");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/upload/${mediaId}`,
-    token,
-  });
-
-  printJson(result);
-}
-
-async function runUpload(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: {
-      ...sharedApiOptions,
-      alt: { type: "string" },
-      blurhash: { type: "string" },
-      chars: { type: "string" },
-      contentType: { type: "string" },
-      durationSeconds: { type: "string" },
-      height: { type: "string" },
-      poster: { type: "string" },
-      summary: { type: "string" },
-      waveform: { type: "string" },
-      width: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log("Usage: jant media upload <file> [options]");
-    console.log("");
-    console.log("Options:");
-    console.log("  --contentType       Override inferred MIME type");
-    console.log("  --alt               Alt text");
-    console.log("  --summary           Text summary");
-    console.log("  --width             Pixel width");
-    console.log("  --height            Pixel height");
-    console.log("  --durationSeconds   Duration for audio or video");
-    console.log("  --blurhash          Image blurhash");
-    console.log("  --waveform          Audio waveform string");
-    console.log("  --poster            Poster image path for video uploads");
-    return;
-  }
-
-  const filePath = positionals[0];
-  if (!filePath) {
-    throw new Error("File path is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Uploading media");
-  const token = requireApiToken(values, "Uploading media");
-  const result = await uploadMediaFile({
-    alt: values.alt?.trim() || undefined,
-    blurhash: values.blurhash?.trim() || undefined,
-    chars: parseOptionalNonNegativeInteger(values.chars, "chars"),
-    contentType: values.contentType,
-    durationSeconds: parseOptionalPositiveInteger(
-      values.durationSeconds,
-      "durationSeconds",
-    ),
-    filePath,
-    height: parseOptionalPositiveInteger(values.height, "height"),
-    posterPath: values.poster,
-    siteUrl,
-    summary: values.summary?.trim() || undefined,
-    token,
-    waveform: values.waveform?.trim() || undefined,
-    width: parseOptionalPositiveInteger(values.width, "width"),
-  });
-
-  printJson(result);
-}
-
-async function runContent(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant media content <id> [options]");
-    return;
-  }
-
-  const mediaId = positionals[0];
-  if (!mediaId) {
-    throw new Error("Media ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Getting attachment content");
-  const token = requireApiToken(values, "Getting attachment content");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/attachments/${mediaId}/content`,
-    token,
-  });
-
-  printJson(result);
-}
-
-async function runSetAlt(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: {
-      ...sharedApiOptions,
-      alt: { type: "string" },
-    },
-  });
-
-  if (values.help) {
-    console.log("Usage: jant media set-alt <id> --alt <text> [options]");
-    return;
-  }
-
-  const mediaId = positionals[0];
-  if (!mediaId) {
-    throw new Error("Media ID is required.");
-  }
-  if (values.alt === undefined) {
-    throw new Error("--alt is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Updating media alt text");
-  const token = requireApiToken(values, "Updating media alt text");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/upload/${mediaId}`,
-    method: "PATCH",
-    token,
-    body: {
-      alt: values.alt,
-    },
-  });
-
-  printJson(result);
-}
-
-async function runDelete(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: sharedApiOptions,
-  });
-
-  if (values.help) {
-    console.log("Usage: jant media delete <id> [options]");
-    return;
-  }
-
-  const mediaId = positionals[0];
-  if (!mediaId) {
-    throw new Error("Media ID is required.");
-  }
-
-  const siteUrl = requireSiteUrl(values, "Deleting media");
-  const token = requireApiToken(values, "Deleting media");
-  const result = await requestJson({
-    siteUrl,
-    path: `/api/upload/${mediaId}`,
-    method: "DELETE",
-    token,
-  });
-
-  printJson(result);
-}