@evcraddock/slug-cli 0.6.2 → 0.6.3

package/README.md

@@ -51,7 +51,7 @@ Use `slug --site <name> site config show` to read supported runtime site configu
 
 Use `slug --site <name> doctor` to check API compatibility and package metadata. Use `slug --site <name> upgrade` for advisory, non-destructive package update recommendations; it reports suggested dependency changes without rewriting site files.
 
-Use `slug --site <name> post list`, `slug --site <name> post show <slug>`, `slug --site <name> post create`, `slug --site <name> post edit <slug>`, `slug --site <name> post publish <slug>`, `slug --site <name> post unpublish <slug>`, and `slug --site <name> post delete <slug>` to manage posts through the Slugkit posts API.
+Use `slug --site <name> post list`, `slug --site <name> post show <slug>`, `slug --site <name> post create`, `slug --site <name> post edit <slug>`, `slug --site <name> post publish <slug>`, `slug --site <name> post unpublish <slug>`, and `slug --site <name> post delete <slug>` to manage posts through the Slugkit posts API. For migration imports, pass `--published-at <date-or-datetime>` to `post create` or `post publish` to preserve an original publish date without triggering follower delivery by default.
 
 Use `slug tag list` to list tags and post usage counts through the Slugkit tags API.
 

package/dist/commands.js

@@ -22,10 +22,10 @@ Usage:
   slug [--config <file>] init <directory> --name <name> [--site-title <title>] [--template <name>] [--template-url <url>] [--template-dir <dir>] [--json]
   slug [--config <file>] --site <name> post list [--type article|link|note] [--status draft|published|all] [--tag <slug>] [--json]
   slug [--config <file>] post show <slug> [--json]
-  slug [--config <file>] post create --type article|link|note --slug <slug> --content <text> [--title <text>] [--url <url>] [--excerpt <text>] [--tag <slug>]... [--source-id <id>] [--credit-contact-id <id>]... [--json]
-  slug [--config <file>] post edit <slug> [--slug <new-slug>] [--title <text>] [--content <text>] [--url <url>] [--excerpt <text>] [--tag <slug>]... [--source-id <id>] [--credit-contact-id <id>]... [--json]
+  slug [--config <file>] post create --type article|link|note --slug <slug> --content <text> [--title <text>] [--url <url>] [--excerpt <text>] [--published-at <datetime>] [--tag <slug>]... [--source-id <id>] [--credit-contact-id <id>]... [--json]
+  slug [--config <file>] post edit <slug> [--slug <new-slug>] [--title <text>] [--content <text>] [--url <url>] [--excerpt <text>] [--published-at <datetime>] [--tag <slug>]... [--source-id <id>] [--credit-contact-id <id>]... [--json]
   slug [--config <file>] post delete <slug> [--json]
-  slug [--config <file>] post publish <slug> [--json]
+  slug [--config <file>] post publish <slug> [--published-at <datetime>] [--json]
   slug [--config <file>] post unpublish <slug> [--json]
   slug [--config <file>] comment list [--post <slug>] [--status pending|approved|hidden|all] [--json]
   slug [--config <file>] comment approve <id> [--json]
@@ -920,6 +920,7 @@ async function runPostsCreateCommand(context, args) {
         "tag",
         "source-id",
         "credit-contact-id",
+        "published-at",
     ]);
     const body = createPostMutationInput(parsed.options, true);
     const api = await createConfiguredApiContext(context);
@@ -946,6 +947,7 @@ async function runPostsEditCommand(context, args) {
         "tag",
         "source-id",
         "credit-contact-id",
+        "published-at",
     ]);
     const body = createPostMutationInput(parsed.options, false);
     if (Object.keys(body).length === 0) {
@@ -975,12 +977,16 @@ async function runPostsDeleteCommand(context, args) {
     return { exitCode: ExitCode.Ok };
 }
 async function runPostsLifecycleCommand(context, args, action) {
-    const { slug, json } = readSlugCommandArgs(args, `Usage: slug post ${action} <slug> [--json]`);
+    const usage = action === "publish"
+        ? "Usage: slug post publish <slug> [--published-at <datetime>] [--json]"
+        : "Usage: slug post unpublish <slug> [--json]";
+    const { slug, json, publishedAt } = readPostLifecycleArgs(args, usage, action);
     const api = await createConfiguredApiContext(context);
     writeMutationTarget(context.writer, api.apiBaseUrl, json);
     const response = await api.client.requestJson({
         method: "POST",
         path: `/posts/${encodeURIComponent(slug)}/${action}`,
+        body: publishedAt === undefined ? undefined : { publishedAt },
     });
     writePostMutationOutput(context.writer, response, json);
     return { exitCode: ExitCode.Ok };
@@ -1025,6 +1031,9 @@ function createPostMutationInput(options, requireCreateFields) {
     copyStringOption(options, input, "url", "url");
     copyStringOption(options, input, "excerpt", "excerpt");
     copyNumberOption(options, input, "source-id", "sourceId");
+    if (typeof options["published-at"] === "string") {
+        input.publishedAt = normalizeCliPublishedAt(options["published-at"]);
+    }
     if (Array.isArray(options.tag)) {
         input.tagSlugs = options.tag;
     }
@@ -1065,6 +1074,37 @@ function readSlugCommandArgs(args, usage) {
     }
     return { slug: positional[0], json };
 }
+function readPostLifecycleArgs(args, usage, action) {
+    if (action === "unpublish") {
+        const { slug, json } = readSlugCommandArgs(args, usage);
+        return { slug, json };
+    }
+    const slug = args[0];
+    if (slug === undefined || slug.startsWith("--")) {
+        throw createInvalidUsageError(usage);
+    }
+    const parsed = parsePostFlags(args.slice(1), ["published-at"]);
+    return {
+        slug,
+        json: parsed.json,
+        publishedAt: typeof parsed.options["published-at"] === "string"
+            ? normalizeCliPublishedAt(parsed.options["published-at"])
+            : undefined,
+    };
+}
+function normalizeCliPublishedAt(value) {
+    const isDateOnly = /^\d{4}-\d{2}-\d{2}$/.test(value);
+    const isDateTime = /^\d{4}-\d{2}-\d{2}T/.test(value);
+    if (!isDateOnly && !isDateTime) {
+        throw createInvalidUsageError("--published-at must be a valid ISO date or datetime");
+    }
+    const normalizedInput = isDateOnly ? `${value}T00:00:00.000Z` : value;
+    const date = new Date(normalizedInput);
+    if (Number.isNaN(date.valueOf())) {
+        throw createInvalidUsageError("--published-at must be a valid ISO date or datetime");
+    }
+    return date.toISOString();
+}
 function addOptionalQuery(query, key, value) {
     if (typeof value === "string") {
         query.set(key, value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evcraddock/slug-cli",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Command-line tool for Slugkit sites.",
   "private": false,
   "type": "module",
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "@evcraddock/slug-core": "0.1.1",
-    "@evcraddock/slug-template": "0.1.2",
+    "@evcraddock/slug-template": "0.1.3",
     "tar": "^7.5.16"
   }
 }