@peristyle/emdash-plugin-instagram-to-recipe 0.1.4 → 0.1.6

package/README.md

@@ -1,22 +1,19 @@
 # @peristyle/emdash-plugin-instagram-to-recipe
 
-Import a public Instagram post into your food blog as a draft recipe from the EmDash admin.
+Import public Instagram posts into your [EmDash](https://www.npmjs.com/package/emdash) site as draft recipe posts — one at a time by URL, or in bulk by scanning a profile.
 
-Paste a post URL such as [instagram.com/p/DXkhLGbEcOY](https://www.instagram.com/p/DXkhLGbEcOY/) and the plugin will:
+For a post URL such as [instagram.com/p/DXkhLGbEcOY](https://www.instagram.com/p/DXkhLGbEcOY/) the plugin will:
 
-1. Fetch the post page and read the caption from Open Graph metadata
-2. Parse ingredients (`What you'll need` / `Ingredients:`) and numbered steps
-3. Download the post **feed image** (`display_url` from embedded JSON — same source as brand-bootstrap — not the OG share-card with a play button)
-4. Create a **draft** post in your `posts` collection
-
-Parsing logic matches [brand-bootstrap](https://github.com/time-to-eat/init-brand-resources) Instagram recipe extraction.
+1. Fetch the post and read the caption (profile API first, HTML Open Graph metadata as fallback)
+2. Parse ingredients (`What you'll need` / `Ingredients:`) and numbered steps — including captions Instagram has collapsed onto one line
+3. Download the post **feed image** (the embedded `display_url`, not the OG share-card with a play button) and store its dimensions for responsive images
+4. Create a **draft** post in your configured collection
 
 ## Install
 
-From your EmDash site (e.g. `food-blog-base`):
-
 ```bash
-pnpm add ../plugins/instagram-to-recipe
+pnpm add @peristyle/emdash-plugin-instagram-to-recipe
+# or: npm install / yarn add
 ```
 
 Register in `astro.config.mjs`:
@@ -27,12 +24,7 @@ import { instagramToRecipePlugin } from "@peristyle/emdash-plugin-instagram-to-r
 export default defineConfig({
   integrations: [
     emdash({
-      plugins: [
-        recipesPlugin(),
-        instagramToRecipePlugin(),
-        // optional: custom collection slug
-        // instagramToRecipePlugin({ collection: "posts" }),
-      ],
+      plugins: [instagramToRecipePlugin()],
     }),
   ],
 });
@@ -42,51 +34,74 @@ Rebuild or restart the dev server after adding the plugin.
 
 ## Admin usage
 
-1. Open **Plugins → Instagram to Recipe → Import from Instagram**
-2. Paste an Instagram post URL
-3. Click **Convert to recipe** and review the preview
-4. Click **Create draft post**
-5. Edit the draft under **Posts** (slug, categories, times, publish)
+Open **Plugins → Import from Instagram** in the EmDash admin. The page has three sections:
+
+### Single post
+
+1. Paste an Instagram post URL and click **Convert to recipe**
+2. Review the parsed preview (title, ingredients, steps, featured image)
+3. Click **Create draft post**
+4. Edit the draft under **Posts** (slug, categories, times, publish)
+
+### Bulk import from a profile
+
+1. Enter a public Instagram handle and click **Scan profile**
+2. The profile grid is fetched in a single request and every caption that parses as a recipe is listed, sorted by likes
+3. Check the recipes you want (already-imported posts are unchecked and labeled) and click **Create selected drafts**
+
+Bulk import is idempotent — posts already imported are skipped. Deleting an imported draft clears the bookkeeping, so the post can be imported again later.
+
+### Settings
+
+- **Content collection** — where drafts are created (default: `posts`)
+- **Instagram handle** (optional) — pre-fills the bulk scan and lets single-post imports go straight to the profile API; when empty, the post owner's handle is detected automatically
+
+> Standard-format EmDash plugins are configured here (settings are stored in the plugin's KV store), not via constructor options.
 
 ## Capabilities
 
-| Capability       | Purpose                                      |
-| ---------------- | -------------------------------------------- |
-| `network:fetch`  | Fetch Instagram HTML and CDN images          |
-| `read:content`   | Check for prior imports                      |
-| `write:content`  | Create draft posts                           |
-| `write:media`    | Upload featured images                       |
+| Capability        | Purpose                             |
+| ----------------- | ----------------------------------- |
+| `network:request` | Fetch Instagram HTML and CDN images |
+| `content:read`    | Check for prior imports             |
+| `content:write`   | Create draft posts                  |
+| `media:write`     | Upload featured images              |
 
 Allowed hosts: `www.instagram.com`, `*.cdninstagram.com`, `*.fbcdn.net`.
 
 ## API routes
 
-For scripting or custom admin UI:
+For scripting or a custom admin UI:
 
-| Route          | Method | Body                          |
-| -------------- | ------ | ----------------------------- |
-| `parse`        | POST   | `{ "url": "https://..." }`    |
-| `create-draft` | POST   | `{ "shortcode": "DXkhLGbEcOY" }` |
+| Route          | Method | Body                                  |
+| -------------- | ------ | ------------------------------------- |
+| `parse`        | POST   | `{ "url": "https://..." }`            |
+| `create-draft` | POST   | `{ "shortcode": "DXkhLGbEcOY" }`      |
+| `bulk-scan`    | POST   | `{ "handle": "somefoodblogger" }`     |
+| `bulk-create`  | POST   | `{ "shortcodes": ["DXkhLGbEcOY"] }`   |
 
 Base path: `/_emdash/api/plugins/peristyle-instagram-to-recipe/<route>`
 
 ## Limitations
 
 - **Public posts only** — private or login-walled posts cannot be read
-- **Caption format** — works best with “What you'll need” + numbered steps (same as brand-bootstrap)
-- **Instagram rate limits** — repeated imports may hit HTTP 429; wait and retry
-- **No video frames** — uses the OG thumbnail/image, not in-video text
-- **Cloudflare sandbox** — uses `ctx.http.fetch` and `ctx.media.upload` (no Node `curl`)
+- **Caption format** — works best with a “What you'll need” / “Ingredients:” section plus numbered steps
+- **Bulk scan depth** — one profile request returns roughly the 12 most recent posts; older posts can still be imported individually by URL
+- **Instagram rate limits** — repeated fetches may hit HTTP 429; responses are cached for 24 hours and stale cache is used as a fallback, but you may need to wait and retry
+- **No video frames** — video posts use the feed thumbnail, not in-video text
+
+## Building from source
 
-## Development
+The TypeScript source ships in the package under `src/`. From an unpacked copy:
 
 ```bash
-cd plugins/instagram-to-recipe
 pnpm install
 pnpm build
 pnpm typecheck
 ```
 
+The development repository is not currently public.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -1,14 +1,10 @@
 import { PluginDescriptor } from 'emdash';
 
-type InstagramToRecipePluginOptions = {
-    /** Content collection slug for imported recipes (default: posts). */
-    collection?: string;
-    /**
-     * Instagram username for web_profile_info (e.g. cookingwithashhhh).
-     * When omitted, the post page's owner username is used automatically.
-     */
-    instagramHandle?: string;
-};
-declare function instagramToRecipePlugin(options?: InstagramToRecipePluginOptions): PluginDescriptor<InstagramToRecipePluginOptions>;
+/**
+ * Standard-format EmDash plugins are configured via the admin UI (KV
+ * settings), not constructor options — set the target collection and
+ * Instagram handle under Plugins → Import from Instagram → Settings.
+ */
+declare function instagramToRecipePlugin(): PluginDescriptor;
 
-export { type InstagramToRecipePluginOptions, instagramToRecipePlugin };
+export { instagramToRecipePlugin };

package/dist/index.js

@@ -1,11 +1,10 @@
 // src/index.ts
-function instagramToRecipePlugin(options = {}) {
+function instagramToRecipePlugin() {
   return {
     id: "peristyle-instagram-to-recipe",
-    version: "0.1.4",
+    version: "0.1.6",
     format: "standard",
     entrypoint: "@peristyle/emdash-plugin-instagram-to-recipe/sandbox",
-    options,
     capabilities: [
       "content:read",
       "content:write",

package/dist/sandbox-entry.d.ts

@@ -60,6 +60,12 @@ declare const _default: {
         "plugin:install": {
             handler: (_event: unknown, ctx: PluginContext) => Promise<void>;
         };
+        "content:afterDelete": {
+            handler: (event: {
+                id: string;
+                collection: string;
+            }, ctx: PluginContext) => Promise<void>;
+        };
     };
     routes: {
         parse: {

package/dist/sandbox-entry.js

@@ -96,8 +96,47 @@ function importFormBlocks(initialUrl = "") {
     }
   ];
 }
-function pageBlocks() {
-  return [...importFormBlocks(), { type: "divider" }, ...bulkFormBlocks()];
+function settingsFormBlocks(current) {
+  return [
+    {
+      type: "header",
+      text: "Settings"
+    },
+    {
+      type: "context",
+      text: "Drafts are created in the collection below. The Instagram handle is optional \u2014 it pre-fills the bulk scan and speeds up single-post imports; when empty, the post owner's handle is used automatically."
+    },
+    {
+      type: "form",
+      block_id: "settings-form",
+      fields: [
+        {
+          type: "text_input",
+          action_id: "collection",
+          label: "Content collection",
+          placeholder: "posts",
+          initial_value: current.collection
+        },
+        {
+          type: "text_input",
+          action_id: "instagram_handle",
+          label: "Instagram handle (optional)",
+          placeholder: "@yourhandle",
+          initial_value: current.instagramHandle
+        }
+      ],
+      submit: { label: "Save settings", action_id: "save_settings" }
+    }
+  ];
+}
+function pageBlocks(settings) {
+  return [
+    ...importFormBlocks(),
+    { type: "divider" },
+    ...bulkFormBlocks(settings.instagramHandle),
+    { type: "divider" },
+    ...settingsFormBlocks(settings)
+  ];
 }
 function previewBlocks(recipe, options) {
   const ingredientPreview = recipe.ingredients.slice(0, 8).join("\n");
@@ -1040,6 +1079,7 @@ var instagramBrowserUserAgent = BROWSER_UA2;
 var DEFAULT_COLLECTION = "posts";
 var PARSE_CACHE_PREFIX = "parse:";
 var IMPORT_MAP_PREFIX = "imported:";
+var IMPORT_BY_ID_PREFIX = "imported-by-id:";
 var PROFILE_CACHE_PREFIX = "igprofile:";
 var BULK_CREATE_DELAY_MS = 600;
 function sleep2(ms) {
@@ -1048,12 +1088,21 @@ function sleep2(ms) {
 async function collectionSlug(ctx) {
   return await ctx.kv.get("config:collection") ?? DEFAULT_COLLECTION;
 }
+async function pluginSettings(ctx) {
+  return {
+    collection: await collectionSlug(ctx),
+    instagramHandle: await ctx.kv.get("config:instagram_handle") ?? ""
+  };
+}
 function parseCacheKey(shortcode) {
   return `${PARSE_CACHE_PREFIX}${shortcode}`;
 }
 function importMapKey(shortcode) {
   return `${IMPORT_MAP_PREFIX}${shortcode}`;
 }
+function importByIdKey(contentId) {
+  return `${IMPORT_BY_ID_PREFIX}${contentId}`;
+}
 async function httpFetch(ctx, url, init) {
   if (!ctx.http) {
     throw new Error("Network access is not available for this plugin.");
@@ -1188,6 +1237,7 @@ async function createDraftFromRecipe(ctx, shortcode) {
   const data = recipeToPostWriteData(recipe, featuredImage);
   const item = await ctx.content.create(collection, data);
   await ctx.kv.set(importMapKey(shortcode), item.id);
+  await ctx.kv.set(importByIdKey(item.id), shortcode);
   return {
     contentId: item.id,
     title: recipe.title,
@@ -1270,6 +1320,19 @@ var sandbox_entry_default = {
           await ctx.kv.set("config:collection", DEFAULT_COLLECTION);
         }
       }
+    },
+    // Deleting an imported recipe post doesn't otherwise touch this plugin's
+    // own "imported:<shortcode>" bookkeeping, so the bulk-scan UI keeps
+    // treating the source Instagram post as already imported forever.
+    "content:afterDelete": {
+      handler: async (event, ctx) => {
+        const collection = await collectionSlug(ctx);
+        if (event.collection !== collection) return;
+        const shortcode = await ctx.kv.get(importByIdKey(event.id));
+        if (!shortcode) return;
+        await ctx.kv.delete(importByIdKey(event.id));
+        await ctx.kv.delete(importMapKey(shortcode));
+      }
     }
   },
   routes: {
@@ -1319,11 +1382,44 @@ var sandbox_entry_default = {
       handler: async (routeCtx, ctx) => {
         const interaction = routeCtx.input ?? { type: "page_load" };
         if (interaction.type === "page_load") {
-          return { blocks: pageBlocks() };
+          return { blocks: pageBlocks(await pluginSettings(ctx)) };
         }
         const instagramHandle = String(
           interaction.values?.instagram_handle ?? ""
         ).trim();
+        if (interaction.type === "form_submit" && interaction.action_id === "save_settings") {
+          const collection = String(interaction.values?.collection ?? "").trim().toLowerCase();
+          if (!/^[a-z0-9][a-z0-9-_]*$/.test(collection)) {
+            return {
+              blocks: pageBlocks(await pluginSettings(ctx)),
+              toast: {
+                message: "Collection must be a slug (letters, numbers, dashes).",
+                type: "error"
+              }
+            };
+          }
+          let handle = "";
+          if (instagramHandle) {
+            try {
+              handle = normalizeInstagramHandle(instagramHandle);
+            } catch {
+              return {
+                blocks: pageBlocks(await pluginSettings(ctx)),
+                toast: { message: "Invalid Instagram handle.", type: "error" }
+              };
+            }
+          }
+          await ctx.kv.set("config:collection", collection);
+          if (handle) {
+            await ctx.kv.set("config:instagram_handle", handle);
+          } else {
+            await ctx.kv.delete("config:instagram_handle");
+          }
+          return {
+            blocks: pageBlocks({ collection, instagramHandle: handle }),
+            toast: { message: "Settings saved", type: "success" }
+          };
+        }
         if (interaction.type === "form_submit" && interaction.action_id === "bulk_scan") {
           try {
             const { handle, candidates, scanned, rateLimited, fromCache } = await scanProfileRecipes(ctx, instagramHandle);
@@ -1342,7 +1438,7 @@ var sandbox_entry_default = {
             const message = error instanceof Error ? error.message : String(error);
             return {
               blocks: [
-                ...pageBlocks(),
+                ...pageBlocks(await pluginSettings(ctx)),
                 {
                   type: "banner",
                   title: "Could not scan profile",
@@ -1359,7 +1455,7 @@ var sandbox_entry_default = {
           const shortcodes = Array.isArray(raw) ? raw.map((s) => String(s).trim()).filter(Boolean) : [];
           if (shortcodes.length === 0) {
             return {
-              blocks: pageBlocks(),
+              blocks: pageBlocks(await pluginSettings(ctx)),
               toast: { message: "Select at least one recipe", type: "error" }
             };
           }
@@ -1379,7 +1475,7 @@ var sandbox_entry_default = {
           } catch (error) {
             const message = error instanceof Error ? error.message : String(error);
             return {
-              blocks: pageBlocks(),
+              blocks: pageBlocks(await pluginSettings(ctx)),
               toast: { message, type: "error" }
             };
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peristyle/emdash-plugin-instagram-to-recipe",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "Import Instagram post URLs as recipe drafts in the EmDash admin",
   "publishConfig": {

package/src/admin-blocks.ts

@@ -30,9 +30,54 @@ export function importFormBlocks(initialUrl = ""): Block[] {
   ];
 }
 
-/** Landing view: single-post import on top, bulk profile import below. */
-export function pageBlocks(): Block[] {
-  return [...importFormBlocks(), { type: "divider" }, ...bulkFormBlocks()];
+export type PluginSettings = {
+  collection: string;
+  instagramHandle: string;
+};
+
+export function settingsFormBlocks(current: PluginSettings): Block[] {
+  return [
+    {
+      type: "header",
+      text: "Settings",
+    },
+    {
+      type: "context",
+      text: "Drafts are created in the collection below. The Instagram handle is optional — it pre-fills the bulk scan and speeds up single-post imports; when empty, the post owner's handle is used automatically.",
+    },
+    {
+      type: "form",
+      block_id: "settings-form",
+      fields: [
+        {
+          type: "text_input",
+          action_id: "collection",
+          label: "Content collection",
+          placeholder: "posts",
+          initial_value: current.collection,
+        },
+        {
+          type: "text_input",
+          action_id: "instagram_handle",
+          label: "Instagram handle (optional)",
+          placeholder: "@yourhandle",
+          initial_value: current.instagramHandle,
+        },
+      ],
+      submit: { label: "Save settings", action_id: "save_settings" },
+    },
+  ];
+}
+
+/** Landing view: single-post import, bulk profile import, settings. */
+export function pageBlocks(settings: PluginSettings): Block[] {
+  return [
+    ...importFormBlocks(),
+    { type: "divider" },
+    ...bulkFormBlocks(settings.instagramHandle),
+    { type: "divider" },
+    ...settingsFormBlocks(settings),
+  ];
 }
 
 export function previewBlocks(

package/src/index.ts

@@ -3,25 +3,17 @@ import type { PluginDescriptor } from "emdash";
 /** Replaced at build time by tsup `define` from package.json — single source of truth. */
 declare const __PLUGIN_VERSION__: string;
 
-export type InstagramToRecipePluginOptions = {
-  /** Content collection slug for imported recipes (default: posts). */
-  collection?: string;
-  /**
-   * Instagram username for web_profile_info (e.g. cookingwithashhhh).
-   * When omitted, the post page's owner username is used automatically.
-   */
-  instagramHandle?: string;
-};
-
-export function instagramToRecipePlugin(
-  options: InstagramToRecipePluginOptions = {},
-): PluginDescriptor<InstagramToRecipePluginOptions> {
+/**
+ * Standard-format EmDash plugins are configured via the admin UI (KV
+ * settings), not constructor options — set the target collection and
+ * Instagram handle under Plugins → Import from Instagram → Settings.
+ */
+export function instagramToRecipePlugin(): PluginDescriptor {
   return {
     id: "peristyle-instagram-to-recipe",
     version: __PLUGIN_VERSION__,
     format: "standard",
     entrypoint: "@peristyle/emdash-plugin-instagram-to-recipe/sandbox",
-    options,
     capabilities: [
       "content:read",
       "content:write",

package/src/instagram-curl-profile.ts

@@ -17,8 +17,8 @@ function cookieJarPath(handle: string): string {
 }
 
 /**
- * Same curl + cookie-jar flow as init-brand-resources brand-bootstrap.
- * Used when fetch() to web_profile_info fails (often HTTP 429).
+ * curl + cookie-jar fallback: prime cookies on the profile page, then call
+ * web_profile_info. Used when fetch() fails (often HTTP 429).
  */
 export async function fetchInstagramProfileViaCurl(
   handle: string,

package/src/instagram-profile-image.ts

@@ -43,7 +43,7 @@ export function extractOwnerUsername(html: string): string | undefined {
   return undefined;
 }
 
-/** Post data resolved from the profile grid — same fields brand-bootstrap maps. */
+/** Post data resolved from the profile grid. */
 export type ProfilePostNode = {
   shortcode: string;
   caption: string;
@@ -53,7 +53,7 @@ export type ProfilePostNode = {
   isVideo: boolean;
 };
 
-/** Same shape brand-bootstrap persists under `.cache/instagram/<handle>.json`. */
+/** Cached web_profile_info payload for one handle. */
 export type CachedInstagramProfile = {
   fetchedAt: string;
   handle: string;
@@ -106,7 +106,7 @@ export function postNodeFromProfileUser(
   return postsFromProfileUser(user).find((p) => p.shortcode === shortcode);
 }
 
-/** Same field brand-bootstrap uses: node.display_url from the profile grid. */
+/** node.display_url from the profile grid — the feed image URL. */
 export function displayUrlFromProfileUser(
   user: unknown,
   shortcode: string,
@@ -127,7 +127,7 @@ function profileApiHeaders(handle: string): HeadersInit {
   };
 }
 
-// Match brand-bootstrap: 3 retries with exponential backoff (2.5s, 5s, 10s).
+// 3 retries with exponential backoff (2.5s, 5s, 10s).
 const PROFILE_FETCH_RETRIES = 3;
 const PROFILE_RETRY_BASE_DELAY_MS = 2500;
 
@@ -155,8 +155,7 @@ export type ProfileDisplayUrlResult = {
 };
 
 /**
- * Resolve display_url via web_profile_info — same API and field as
- * init-brand-resources brand-bootstrap (postsFromProfile → displayUrl).
+ * Resolve display_url via one web_profile_info request for the handle.
  */
 async function fetchProfileUserOnce(
   fetchFn: (url: string, init?: RequestInit) => Promise<Response>,
@@ -228,9 +227,9 @@ async function cacheSet(
 }
 
 /**
- * Fetch the post's grid node via web_profile_info, mirroring brand-bootstrap:
- * fresh cache first, then live fetch with backoff, then stale cache on
- * failure, then the curl cookie-jar fallback.
+ * Fetch the post's grid node via web_profile_info: fresh cache first, then
+ * live fetch with backoff, then stale cache on failure, then the curl
+ * cookie-jar fallback.
  */
 export async function fetchProfilePostNode(
   fetchFn: (url: string, init?: RequestInit) => Promise<Response>,
@@ -275,7 +274,7 @@ export async function fetchProfilePostNode(
     if (!result.retryable) break;
   }
 
-  // Stale cache beats no image — same trade-off brand-bootstrap makes on 429.
+  // Stale cache beats no image when Instagram is rate-limiting.
   if (cached) {
     const node = postNodeFromProfileUser(cached.user, shortcode);
     if (node) {

package/src/parse-instagram-post.ts

@@ -146,8 +146,9 @@ export function extractEmbeddedImageUrl(html: string): string | undefined {
 }
 
 /**
- * Resolve the post's feed image (same class of URL as brand-bootstrap display_url).
- * Never uses og:video. Uses og:image only when no embedded display_url exists.
+ * Resolve the post's feed image (the embedded display_url, not the OG
+ * share-card). Never uses og:video. Uses og:image only when no embedded
+ * display_url exists.
  */
 export function resolvePostImageUrl(
   html: string,
@@ -300,7 +301,7 @@ export type FetchedInstagramPost = {
 };
 
 export type FetchInstagramPostOptions = {
-  /** Override owner handle for web_profile_info lookup (same as brand-bootstrap handle). */
+  /** Override owner handle for the web_profile_info lookup. */
   instagramHandle?: string;
   /** Profile payload cache (24h TTL, stale fallback on 429) — back with ctx.kv. */
   profileCache?: InstagramProfileCache;
@@ -358,10 +359,10 @@ export async function fetchInstagramPost(
   const { shortcode } = parseInstagramPostUrl(postUrl);
   const canonicalUrl = `https://www.instagram.com/p/${shortcode}/`;
 
-  // Profile-API-first, like init-brand-resources brand-bootstrap: a single
-  // (cached) web_profile_info request supplies caption, display_url, and
-  // is_video. Anonymous HTML page loads are what trip Instagram's rate
-  // limiter, so they are reserved for the fallback below.
+  // Profile-API-first: a single (cached) web_profile_info request supplies
+  // caption, display_url, and is_video. Anonymous HTML page loads are what
+  // trip Instagram's rate limiter, so they are reserved for the fallback
+  // below.
   const configuredHandle = options.instagramHandle
     ? normalizeInstagramHandle(options.instagramHandle)
     : undefined;
@@ -412,8 +413,8 @@ export async function fetchInstagramPost(
   const cookieHeader = cookieHeaderFromResponse(res);
   const ownerHandle = extractOwnerUsername(html);
 
-  // Same image source as init-brand-resources: web_profile_info → node.display_url.
-  // Skip the lookup when the configured handle already answered for this owner.
+  // Image source: web_profile_info → node.display_url. Skip the lookup when
+  // the configured handle already answered for this owner.
   if (ownerHandle && ownerHandle !== configuredHandle) {
     profileResult = await fetchProfilePostNode(
       fetchFn,

package/src/sandbox-entry.ts

@@ -9,6 +9,7 @@ import {
   pageBlocks,
   previewBlocks,
   type BulkCandidate,
+  type PluginSettings,
 } from "./admin-blocks.js";
 import {
   buildBulkRecipesFromPosts,
@@ -34,6 +35,7 @@ import { recipeToPostWriteData } from "./recipe-content.js";
 const DEFAULT_COLLECTION = "posts";
 const PARSE_CACHE_PREFIX = "parse:";
 const IMPORT_MAP_PREFIX = "imported:";
+const IMPORT_BY_ID_PREFIX = "imported-by-id:";
 const PROFILE_CACHE_PREFIX = "igprofile:";
 
 /** Delay between draft creations so per-post image downloads stay polite. */
@@ -56,6 +58,14 @@ async function collectionSlug(ctx: PluginContext): Promise<string> {
   return (await ctx.kv.get<string>("config:collection")) ?? DEFAULT_COLLECTION;
 }
 
+async function pluginSettings(ctx: PluginContext): Promise<PluginSettings> {
+  return {
+    collection: await collectionSlug(ctx),
+    instagramHandle:
+      (await ctx.kv.get<string>("config:instagram_handle")) ?? "",
+  };
+}
+
 function parseCacheKey(shortcode: string): string {
   return `${PARSE_CACHE_PREFIX}${shortcode}`;
 }
@@ -64,6 +74,10 @@ function importMapKey(shortcode: string): string {
   return `${IMPORT_MAP_PREFIX}${shortcode}`;
 }
 
+function importByIdKey(contentId: string): string {
+  return `${IMPORT_BY_ID_PREFIX}${contentId}`;
+}
+
 async function httpFetch(ctx: PluginContext, url: string, init?: RequestInit) {
   if (!ctx.http) {
     throw new Error("Network access is not available for this plugin.");
@@ -71,7 +85,7 @@ async function httpFetch(ctx: PluginContext, url: string, init?: RequestInit) {
   return ctx.http.fetch(url, init);
 }
 
-/** Same role as brand-bootstrap's `.cache/instagram/` files, backed by KV. */
+/** Profile payload cache backed by plugin KV (24h TTL, stale fallback). */
 function profileCacheForCtx(ctx: PluginContext): InstagramProfileCache {
   return {
     async get(handle) {
@@ -261,6 +275,7 @@ async function createDraftFromRecipe(
 
   const item = await ctx.content.create(collection, data);
   await ctx.kv.set(importMapKey(shortcode), item.id);
+  await ctx.kv.set(importByIdKey(item.id), shortcode);
 
   return {
     contentId: item.id,
@@ -397,6 +412,24 @@ export default {
         }
       },
     },
+    // Deleting an imported recipe post doesn't otherwise touch this plugin's
+    // own "imported:<shortcode>" bookkeeping, so the bulk-scan UI keeps
+    // treating the source Instagram post as already imported forever.
+    "content:afterDelete": {
+      handler: async (
+        event: { id: string; collection: string },
+        ctx: PluginContext,
+      ) => {
+        const collection = await collectionSlug(ctx);
+        if (event.collection !== collection) return;
+
+        const shortcode = await ctx.kv.get<string>(importByIdKey(event.id));
+        if (!shortcode) return;
+
+        await ctx.kv.delete(importByIdKey(event.id));
+        await ctx.kv.delete(importMapKey(shortcode));
+      },
+    },
   },
 
   routes: {
@@ -460,13 +493,57 @@ export default {
         const interaction = routeCtx.input ?? { type: "page_load" };
 
         if (interaction.type === "page_load") {
-          return { blocks: pageBlocks() };
+          return { blocks: pageBlocks(await pluginSettings(ctx)) };
         }
 
         const instagramHandle = String(
           interaction.values?.instagram_handle ?? "",
         ).trim();
 
+        if (
+          interaction.type === "form_submit" &&
+          interaction.action_id === "save_settings"
+        ) {
+          const collection = String(interaction.values?.collection ?? "")
+            .trim()
+            .toLowerCase();
+
+          if (!/^[a-z0-9][a-z0-9-_]*$/.test(collection)) {
+            return {
+              blocks: pageBlocks(await pluginSettings(ctx)),
+              toast: {
+                message:
+                  "Collection must be a slug (letters, numbers, dashes).",
+                type: "error",
+              },
+            };
+          }
+
+          let handle = "";
+          if (instagramHandle) {
+            try {
+              handle = normalizeInstagramHandle(instagramHandle);
+            } catch {
+              return {
+                blocks: pageBlocks(await pluginSettings(ctx)),
+                toast: { message: "Invalid Instagram handle.", type: "error" },
+              };
+            }
+          }
+
+          await ctx.kv.set("config:collection", collection);
+          if (handle) {
+            await ctx.kv.set("config:instagram_handle", handle);
+          } else {
+            await ctx.kv.delete("config:instagram_handle");
+          }
+
+          return {
+            blocks: pageBlocks({ collection, instagramHandle: handle }),
+            toast: { message: "Settings saved", type: "success" },
+          };
+        }
+
         if (
           interaction.type === "form_submit" &&
           interaction.action_id === "bulk_scan"
@@ -492,7 +569,7 @@ export default {
               error instanceof Error ? error.message : String(error);
             return {
               blocks: [
-                ...pageBlocks(),
+                ...pageBlocks(await pluginSettings(ctx)),
                 {
                   type: "banner",
                   title: "Could not scan profile",
@@ -516,7 +593,7 @@ export default {
 
           if (shortcodes.length === 0) {
             return {
-              blocks: pageBlocks(),
+              blocks: pageBlocks(await pluginSettings(ctx)),
               toast: { message: "Select at least one recipe", type: "error" },
             };
           }
@@ -545,7 +622,7 @@ export default {
             const message =
               error instanceof Error ? error.message : String(error);
             return {
-              blocks: pageBlocks(),
+              blocks: pageBlocks(await pluginSettings(ctx)),
               toast: { message, type: "error" },
             };
           }