# rebarfw/meme-autoposter architecture

> Architecture diagram of the GitHub repository rebarfw/meme-autoposter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rebarfw/meme-autoposter
- Repository: https://github.com/rebarfw/meme-autoposter

## Overview

Meme Autoposter is a Cloudflare Worker that turns an owner-authorized Instagram Reel DM into durable publishing jobs for Instagram and TikTok. Its main path polls Meta, validates and records messages, resolves and validates video, stores it temporarily, creates Buffer posts, checks delivery, and cleans up media. A documented signed-webhook mode can ingest jobs instead of polling; owner setup and protected administration support configuration and operations. Runtime wiring is evidenced by the supplied excerpts and SOURCE INDEX; some workflow links are documented in the README, and unsampled implementation details are not inferred.

Main entry points: [`src/jobs.ts`](https://github.com/rebarfw/meme-autoposter/blob/main/src/jobs.ts) (Durable jobs), [`src/index.ts`](https://github.com/rebarfw/meme-autoposter/blob/main/src/index.ts) (Worker router), [`src/downloaders.ts`](https://github.com/rebarfw/meme-autoposter/blob/main/src/downloaders.ts) (Provider selection), [`src/instagram-polling.ts`](https://github.com/rebarfw/meme-autoposter/blob/main/src/instagram-polling.ts) (DM polling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Ingestion and authorization"]
  node_worker["Worker router<br/>[index.ts]"]
  node_owner_setup["Owner setup<br/>[owner-setup.ts]"]
  node_polling["DM polling"]
  node_instagram_api["Instagram API client<br/>[instagram-api.ts]"]
  node_meta["Meta messaging<br/>[meta.ts]"]
end

subgraph group_processing["Job processing"]
  node_jobs["Durable jobs<br/>[jobs.ts]"]
  node_d1[("D1 job store")]
  node_downloaders["Provider selection<br/>[downloaders.ts]"]
  node_apify_budget["Apify budget<br/>[apify-budget.ts]"]
  node_provider_adapters["Website adapters"]
  node_video_validation["Video validation"]
end

subgraph group_delivery["Publishing and storage"]
  node_media["Media lifecycle<br/>[media.ts]"]
  node_r2[("Private R2 media")]
  node_buffer_client["Buffer client<br/>[buffer.ts]"]
end

subgraph group_operations["Operations and safeguards"]
  node_cloudflare_usage["Cloudflare usage guard"]
  node_privacy["Privacy policy<br/>[privacy.ts]"]
end

node_owner(("Page owner"))
node_meta_service["Meta API"]
node_apify["Apify service"]
node_buffer["Buffer"]
node_social_channels["Instagram and TikTok"]

node_owner -->|"shares Reel"| node_worker
node_worker -->|"runs scheduled"| node_polling
node_polling -->|"reads conversations"| node_instagram_api
node_instagram_api -->|"requests messages"| node_meta_service
node_polling -->|"processes messages"| node_jobs
node_worker -->|"routes setup"| node_owner_setup
node_owner_setup -->|"verifies sender"| node_instagram_api
node_owner_setup -->|"initializes polling"| node_polling
node_worker -->|"handles webhook"| node_meta
node_jobs -->|"records jobs"| node_d1
node_jobs -->|"downloads video"| node_downloaders
node_downloaders -->|"tries providers"| node_provider_adapters
node_downloaders -->|"checks budget"| node_apify_budget
node_downloaders -->|"validates media"| node_video_validation
node_provider_adapters -->|"validates candidates"| node_video_validation
node_downloaders -->|"resolves Reel"| node_apify
node_jobs -->|"stores media"| node_media
node_media -->|"writes and deletes"| node_r2
node_jobs -->|"creates and checks posts"| node_buffer_client
node_buffer_client -->|"creates posts"| node_buffer
node_buffer -->|"publishes posts"| node_social_channels
node_jobs -->|"notifies owner"| node_meta
node_worker -->|"guards admin routes"| node_cloudflare_usage

click node_worker "https://github.com/rebarfw/meme-autoposter/blob/main/src/index.ts"
click node_owner_setup "https://github.com/rebarfw/meme-autoposter/blob/main/src/owner-setup.ts"
click node_polling "https://github.com/rebarfw/meme-autoposter/blob/main/src/instagram-polling.ts"
click node_instagram_api "https://github.com/rebarfw/meme-autoposter/blob/main/src/instagram-api.ts"
click node_meta "https://github.com/rebarfw/meme-autoposter/blob/main/src/meta.ts"
click node_jobs "https://github.com/rebarfw/meme-autoposter/blob/main/src/jobs.ts"
click node_downloaders "https://github.com/rebarfw/meme-autoposter/blob/main/src/downloaders.ts"
click node_apify_budget "https://github.com/rebarfw/meme-autoposter/blob/main/src/apify-budget.ts"
click node_provider_adapters "https://github.com/rebarfw/meme-autoposter/tree/main/src/downloader-providers"
click node_video_validation "https://github.com/rebarfw/meme-autoposter/blob/main/src/video-downloader.ts"
click node_media "https://github.com/rebarfw/meme-autoposter/blob/main/src/media.ts"
click node_buffer_client "https://github.com/rebarfw/meme-autoposter/blob/main/src/buffer.ts"
click node_cloudflare_usage "https://github.com/rebarfw/meme-autoposter/blob/main/src/cloudflare-usage.ts"
click node_privacy "https://github.com/rebarfw/meme-autoposter/blob/main/src/privacy.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_worker,node_owner_setup,node_polling,node_instagram_api,node_meta toneBlue
class node_jobs,node_d1,node_downloaders,node_apify_budget,node_provider_adapters,node_video_validation toneAmber
class node_media,node_r2,node_buffer_client,node_meta_service,node_apify toneMint
class node_cloudflare_usage,node_privacy toneRose
class node_owner,node_buffer,node_social_channels toneIndigo
```

## Components

### Ingestion and authorization

- [Worker router](https://github.com/rebarfw/meme-autoposter/blob/main/src/index.ts): `src/index.ts`
- [Owner setup](https://github.com/rebarfw/meme-autoposter/blob/main/src/owner-setup.ts): `src/owner-setup.ts`
- [DM polling](https://github.com/rebarfw/meme-autoposter/blob/main/src/instagram-polling.ts): `src/instagram-polling.ts`
- [Instagram API client](https://github.com/rebarfw/meme-autoposter/blob/main/src/instagram-api.ts): `src/instagram-api.ts`
- [Meta messaging](https://github.com/rebarfw/meme-autoposter/blob/main/src/meta.ts): `src/meta.ts`

### Job processing

- [Durable jobs](https://github.com/rebarfw/meme-autoposter/blob/main/src/jobs.ts): `src/jobs.ts`
- **D1 job store**
- [Provider selection](https://github.com/rebarfw/meme-autoposter/blob/main/src/downloaders.ts): `src/downloaders.ts`
- [Apify budget](https://github.com/rebarfw/meme-autoposter/blob/main/src/apify-budget.ts): `src/apify-budget.ts`
- [Website adapters](https://github.com/rebarfw/meme-autoposter/tree/main/src/downloader-providers): `src/downloader-providers`
- [Video validation](https://github.com/rebarfw/meme-autoposter/blob/main/src/video-downloader.ts): `src/video-downloader.ts`

### Publishing and storage

- [Media lifecycle](https://github.com/rebarfw/meme-autoposter/blob/main/src/media.ts): `src/media.ts`
- **Private R2 media**
- [Buffer client](https://github.com/rebarfw/meme-autoposter/blob/main/src/buffer.ts): `src/buffer.ts`

### Operations and safeguards

- [Cloudflare usage guard](https://github.com/rebarfw/meme-autoposter/blob/main/src/cloudflare-usage.ts): `src/cloudflare-usage.ts`
- [Privacy policy](https://github.com/rebarfw/meme-autoposter/blob/main/src/privacy.ts): `src/privacy.ts`

### Other components

- **Page owner**
- **Meta API**
- **Apify service**
- **Buffer**
- **Instagram and TikTok**

## Connections

- Page owner → Worker router: shares Reel (evidence: `README.md`)
- Worker router → DM polling: runs scheduled (evidence: `README.md`)
- DM polling → Instagram API client: reads conversations (evidence: `src/instagram-polling.ts`)
- Instagram API client → Meta API: requests messages (evidence: `src/instagram-api.ts`)
- DM polling → Durable jobs: processes messages (evidence: `src/instagram-polling.ts`)
- Worker router → Owner setup: routes setup (evidence: `src/index.ts`)
- Owner setup → Instagram API client: verifies sender (evidence: `src/owner-setup.ts`)
- Owner setup → DM polling: initializes polling (evidence: `src/owner-setup.ts`)
- Worker router → Meta messaging: handles webhook (evidence: `README.md`)
- Durable jobs → D1 job store: records jobs (evidence: `src/jobs.ts`)
- Durable jobs → Provider selection: downloads video (evidence: `src/jobs.ts`)
- Provider selection → Website adapters: tries providers (evidence: `src/downloaders.ts`)
- Provider selection → Apify budget: checks budget (evidence: `src/downloaders.ts`)
- Provider selection → Video validation: validates media (evidence: `src/downloaders.ts`)
- Website adapters → Video validation: validates candidates (evidence: `src/downloader-providers/shared.ts`)
- Provider selection → Apify service: resolves Reel (evidence: `README.md`)
- Durable jobs → Media lifecycle: stores media (evidence: `README.md`)
- Media lifecycle → Private R2 media: writes and deletes (evidence: `README.md`)
- Durable jobs → Buffer client: creates and checks posts (evidence: `README.md`)
- Buffer client → Buffer: creates posts (evidence: `README.md`)
- Buffer → Instagram and TikTok: publishes posts (evidence: `README.md`)
- Durable jobs → Meta messaging: notifies owner (evidence: `src/jobs.ts`)
- Worker router → Cloudflare usage guard: guards admin routes (evidence: `src/index.ts`)
