@peristyle/emdash-plugin-instagram-to-recipe 0.1.0

package/README.md

@@ -0,0 +1,92 @@
+# @peristyle/emdash-plugin-instagram-to-recipe
+
+Import a public Instagram post into your food blog as a draft recipe from the EmDash admin.
+
+Paste a post URL such as [instagram.com/p/DXkhLGbEcOY](https://www.instagram.com/p/DXkhLGbEcOY/) and 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.
+
+## Install
+
+From your EmDash site (e.g. `food-blog-base`):
+
+```bash
+pnpm add ../plugins/instagram-to-recipe
+```
+
+Register in `astro.config.mjs`:
+
+```javascript
+import { instagramToRecipePlugin } from "@peristyle/emdash-plugin-instagram-to-recipe";
+
+export default defineConfig({
+  integrations: [
+    emdash({
+      plugins: [
+        recipesPlugin(),
+        instagramToRecipePlugin(),
+        // optional: custom collection slug
+        // instagramToRecipePlugin({ collection: "posts" }),
+      ],
+    }),
+  ],
+});
+```
+
+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)
+
+## 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                       |
+
+Allowed hosts: `www.instagram.com`, `*.cdninstagram.com`, `*.fbcdn.net`.
+
+## API routes
+
+For scripting or custom admin UI:
+
+| Route          | Method | Body                          |
+| -------------- | ------ | ----------------------------- |
+| `parse`        | POST   | `{ "url": "https://..." }`    |
+| `create-draft` | POST   | `{ "shortcode": "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`)
+
+## Development
+
+```bash
+cd plugins/instagram-to-recipe
+pnpm install
+pnpm build
+pnpm typecheck
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+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>;
+
+export { type InstagramToRecipePluginOptions, instagramToRecipePlugin };

package/dist/index.js

@@ -0,0 +1,31 @@
+// src/index.ts
+function instagramToRecipePlugin(options = {}) {
+  return {
+    id: "peristyle-instagram-to-recipe",
+    version: "0.1.0",
+    format: "standard",
+    entrypoint: "@peristyle/emdash-plugin-instagram-to-recipe/sandbox",
+    options,
+    capabilities: [
+      "content:read",
+      "content:write",
+      "media:write",
+      "network:request"
+    ],
+    allowedHosts: [
+      "www.instagram.com",
+      "*.cdninstagram.com",
+      "*.fbcdn.net"
+    ],
+    adminPages: [
+      {
+        path: "/import",
+        label: "Import from Instagram",
+        icon: "link"
+      }
+    ]
+  };
+}
+export {
+  instagramToRecipePlugin
+};

package/dist/instagram-curl-profile-H4ND6RCQ.js

@@ -0,0 +1,101 @@
+// src/instagram-curl-profile.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+var BROWSER_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
+var IG_APP_ID = "936619743392459";
+function cookieJarPath(handle) {
+  return `/tmp/emdash-ig-${handle.toLowerCase()}.cookies.txt`;
+}
+async function fetchInstagramProfileViaCurl(handle) {
+  const profileUrl = `https://www.instagram.com/${handle}/`;
+  const apiUrl = `https://www.instagram.com/api/v1/users/web_profile_info/?username=${encodeURIComponent(handle)}`;
+  const jar = cookieJarPath(handle);
+  try {
+    await execFileAsync(
+      "curl",
+      [
+        "-sL",
+        "-c",
+        jar,
+        "-b",
+        jar,
+        "-A",
+        BROWSER_UA,
+        profileUrl,
+        "-o",
+        "/dev/null",
+        "-w",
+        "%{http_code}"
+      ],
+      { timeout: 3e4 }
+    );
+    const { stdout } = await execFileAsync(
+      "curl",
+      [
+        "-sS",
+        "-b",
+        jar,
+        "-A",
+        BROWSER_UA,
+        "-H",
+        `X-IG-App-ID: ${IG_APP_ID}`,
+        "-H",
+        "X-Requested-With: XMLHttpRequest",
+        "-H",
+        `Referer: ${profileUrl}`,
+        "-w",
+        "\n__HTTP__:%{http_code}",
+        apiUrl
+      ],
+      { timeout: 3e4, maxBuffer: 8 * 1024 * 1024 }
+    );
+    const marker = stdout.lastIndexOf("\n__HTTP__:");
+    const body = marker >= 0 ? stdout.slice(0, marker) : stdout;
+    const httpStatus = marker >= 0 ? Number(stdout.slice(marker + 10)) : 0;
+    if (!httpStatus || httpStatus >= 400) {
+      return {
+        ok: false,
+        httpStatus: httpStatus || void 0,
+        message: `curl API HTTP ${httpStatus || "?"}`
+      };
+    }
+    let payload;
+    try {
+      payload = JSON.parse(body);
+    } catch {
+      return { ok: false, httpStatus, message: "curl response was not JSON" };
+    }
+    const user = payload?.data?.user;
+    if (!user) {
+      return {
+        ok: false,
+        httpStatus,
+        message: `profile not found for @${handle}`
+      };
+    }
+    return { ok: true, user, httpStatus };
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    return { ok: false, message: `curl fallback failed: ${message}` };
+  }
+}
+function shouldTryInstagramCurlFallback() {
+  const v = process.env.INSTAGRAM_USE_CURL?.trim();
+  if (v === "0") return false;
+  if (v === "1") return true;
+  return true;
+}
+async function curlAvailable() {
+  try {
+    await execFileAsync("curl", ["--version"], { timeout: 5e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  curlAvailable,
+  fetchInstagramProfileViaCurl,
+  shouldTryInstagramCurlFallback
+};

package/dist/sandbox-entry.d.ts

@@ -0,0 +1,103 @@
+import { PluginContext } from 'emdash';
+import { z } from 'astro/zod';
+
+type ParsedInstagramRecipe = {
+    source: {
+        instagram_url: string;
+        shortcode: string;
+        likes: number;
+        is_video: boolean;
+    };
+    suggested_slug: string;
+    title: string;
+    excerpt: string;
+    caption_raw: string;
+    ingredients: string[];
+    instructions: string[];
+    featured_image?: {
+        url: string;
+        alt: string;
+        filename: string;
+        /** Populated when the image is uploaded to EmDash media during convert. */
+        emdash_media?: {
+            provider: string;
+            id: string;
+            src: string;
+            mimeType?: string;
+            meta?: {
+                storageKey: string;
+            };
+        };
+        /** True when convert could not upload the image to media library. */
+        upload_failed?: boolean;
+    };
+    /** Set when convert succeeds but no featured image could be resolved. */
+    image_notice?: string;
+};
+
+type AdminInteraction = {
+    type: string;
+    page?: string;
+    action_id?: string;
+    block_id?: string;
+    values?: Record<string, string | boolean | number>;
+    value?: unknown;
+};
+declare const _default: {
+    hooks: {
+        "plugin:install": {
+            handler: (_event: unknown, ctx: PluginContext) => Promise<void>;
+        };
+    };
+    routes: {
+        parse: {
+            input: z.ZodObject<{
+                url: z.ZodString;
+            }, z.core.$strip>;
+            handler: (routeCtx: {
+                input: {
+                    url: string;
+                };
+            }, ctx: PluginContext) => Promise<{
+                ok: boolean;
+                recipe: ParsedInstagramRecipe;
+                existingContentId: string | undefined;
+            }>;
+        };
+        "create-draft": {
+            input: z.ZodObject<{
+                shortcode: z.ZodString;
+            }, z.core.$strip>;
+            handler: (routeCtx: {
+                input: {
+                    shortcode: string;
+                };
+            }, ctx: PluginContext) => Promise<{
+                contentId: string;
+                title: string;
+                collection: string;
+                ok: boolean;
+            }>;
+        };
+        admin: {
+            handler: (routeCtx: {
+                input?: AdminInteraction;
+            }, ctx: PluginContext) => Promise<{
+                blocks: {
+                    [x: string]: unknown;
+                }[];
+                toast?: undefined;
+            } | {
+                blocks: {
+                    [x: string]: unknown;
+                }[];
+                toast: {
+                    message: string;
+                    type: string;
+                };
+            }>;
+        };
+    };
+};
+
+export { _default as default };