astro-buffalo 0.1.2 → 0.2.0

package/README.md

@@ -3,6 +3,8 @@
 Share newly published Astro articles to Buffer using its experimental `createContentItem` API.
 One request per article, with a variant for each channel. No SDK, database, or browser JavaScript.
 
+An independent integration; not affiliated with or endorsed by Buffer.
+
 ## Setup
 
 Requires Astro 7.x and Node 24 or newer.
@@ -62,6 +64,7 @@ The endpoint must return a JSON array with these fields on each article:
 | `title` | Yes | Non-empty article title, also used as the default announcement. |
 | `url` | Yes | Absolute HTTP(S) canonical production URL, without whitespace, credentials, or a fragment. Must match the deployed URL without a redirect. |
 | `text` | No | Non-empty custom announcement text; the article URL is always appended. |
+| `mode` | No | `shareNow` or `addToQueue`; overrides the integration's default for this article. |
 
 An empty array is valid; invalid entries stop the build before any Buffer requests.
 Adapt the collection name and routes to your site. Include only public articles, filtering drafts
@@ -103,6 +106,9 @@ mode: "addToQueue",
 `mode` supports `shareNow` (default) and `addToQueue`; both use automatic delivery.
 Disconnected or locked channels are reported and skipped.
 
+For different choices per article, return `mode` in each manifest entry. Articles without a
+mode use the integration setting.
+
 Announcements use `title + "\n\n" + url`. Add `text: post.data.description` to an article's manifest
 entry for custom copy; the content item's title stays unchanged. Custom text is trimmed and must
 be non-empty. The URL is always appended for duplicate detection.

package/dist/index.js

@@ -23,6 +23,7 @@ const articlesSchema = z.array(z.object({
         .string({ message: "announcement text must be a non-empty string." })
         .refine((text) => text.trim(), "announcement text must be a non-empty string.")
         .optional(),
+    mode: z.enum(["shareNow", "addToQueue"]).optional(),
 }, { message: "must be an object." }), { message: "Buffer manifest must be an array of articles." });
 function isDraft(source) {
     const lines = (source.startsWith("\uFEFF") ? source.slice(1) : source).split("\n");
@@ -163,6 +164,7 @@ export default function buffer({ posts: entrypoint, contentDirectory, channelIds
                     .map((article) => ({
                     ...article,
                     text: `${article.text?.trim() ?? article.title}\n\n${article.url}`,
+                    mode: article.mode ?? mode,
                 }));
                 if (!posts.length) {
                     logger.info("No new blog posts to share.");
@@ -237,7 +239,7 @@ export default function buffer({ posts: entrypoint, contentDirectory, channelIds
                             title: article.title,
                             text: article.text,
                             channels: pending.map(({ id, name }) => ({ id, name })),
-                            mode,
+                            mode: article.mode,
                         })}`);
                         continue;
                     }
@@ -258,7 +260,7 @@ export default function buffer({ posts: entrypoint, contentDirectory, channelIds
                                 channelId: id,
                                 text: article.text,
                                 schedulingType: "automatic",
-                                mode,
+                                mode: article.mode,
                             })),
                         },
                     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro-buffalo",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Share newly published Astro articles through Buffer.",
   "license": "MIT",
   "homepage": "https://github.com/HiroAgustin/astro-buffalo#readme",