@contextplusplus/core 1.1.0

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@contextplusplus/core",
+  "version": "1.1.0",
+  "description": "Shared engine for contextplusplus — converts public URLs and provider responses into LLM-friendly Markdown (domain, application workflows, providers, and Handlebars templates). Consumed by the contextplusplus CLI, HTTP API, and MCP server.",
+  "private": false,
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yigitkonur/contextplusplus.git"
+  },
+  "homepage": "https://contextplusplus-web.vercel.app",
+  "bugs": {
+    "url": "https://github.com/yigitkonur/contextplusplus/issues"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "@effect/opentelemetry": "^0.63.0",
+    "@effect/platform": "~0.96.2",
+    "@effect/platform-node": "~0.107.0",
+    "@onkernel/sdk": "^0.70.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
+    "@opentelemetry/sdk-trace-base": "^2.7.1",
+    "@sentry/core": "^10.60.0",
+    "@sentry/node": "^10.60.0",
+    "@sentry/opentelemetry": "^10.55.0",
+    "@supabase/supabase-js": "^2.108.2",
+    "defuddle": "^0.19.1",
+    "dotenv": "^17.4.2",
+    "effect": "~3.21.2",
+    "handlebars": "^4.7.9",
+    "jose": "^6.2.3",
+    "linkedom": "^0.18.12",
+    "node-html-markdown": "~2.0.0",
+    "redis": "^5.12.1",
+    "stripe": "^22.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "@vitest/coverage-v8": "~3.2.4",
+    "typescript": "^6.0.3",
+    "vitest": "~3.2.4",
+    "@contextplusplus/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
+    "test": "vitest run"
+  }
+}

package/templates/AGENTS.md

@@ -0,0 +1,32 @@
+# templates/
+
+Handlebars templates rendered by `MarkdownRendererService`.
+
+## Layout
+
+```
+templates/
+  json.hbs         generic JSON-fence fallback (renderJsonMarkdown)
+  scrape-creators/
+    _partials/       4 shared partials
+    <provider>/<endpoint>.hbs    146 endpoint templates
+```
+
+151 `.hbs` total = 146 endpoint + 4 partials + `json.hbs`. See `templates/scrape-creators/AGENTS.md` for the per-template contract.
+
+## Rules
+
+- Templates are pure — no helpers that aren't registered in `src/infrastructure/markdown/handlebars-renderer.ts`.
+- Filenames are kebab-case and exactly match the endpoint id.
+- The structure parity test counts templates against strategies. Adding a template without a strategy (or vice versa) will fail.
+- The path↔strategy mapping is mechanical: the renderer derives the file path from the strategy id (`strategyId.replaceAll(".", sep) + ".hbs"`). A filename that doesn't equal the endpoint slug yields a silent `undefined` → generic fallback render (no error) and breaks the parity test.
+
+## What goes here
+
+Endpoint markdown templates. That's all.
+
+## What doesn't
+
+- Generic helpers (those live in `src/infrastructure/markdown/handlebars-renderer.ts`).
+- Documentation templates.
+- Email templates (this project sends no email).

package/templates/json.hbs

@@ -0,0 +1,27 @@
+# {{title}}
+
+{{#if hasDescription}}
+{{description}}
+
+{{/if}}
+{{#if hasSummary}}
+## Key Fields
+
+| Field | Value |
+|---|---|
+{{#each summary}}
+| {{label}} | {{value}} |
+{{/each}}
+
+{{/if}}
+{{#if hasSections}}
+{{#each sections}}
+## {{title}}
+
+{{{body}}}
+
+{{/each}}
+{{/if}}
+## Compact JSON
+
+{{{markdown}}}

package/templates/scrape-creators/AGENTS.md

@@ -0,0 +1,33 @@
+# templates/scrape-creators/
+
+The 146 endpoint templates + 4 shared partials.
+
+## Partials
+
+- `_partials/provider-error.hbs` — canonical error block (`## Provider Error / Status / Message`).
+- `_partials/empty-success.hbs` — fallback for empty success responses.
+- `_partials/stats-table.hbs` — labeled stats table block (up to 8 slots).
+- `_partials/more-footer.hbs` — pagination footer (`...and N more`).
+
+Partials register under the `_partials/<name>` key (the renderer strips everything up to and including `_partials/`), so invoke them with that exact prefix — `{{> _partials/stats-table}}`. `stats-table` silently drops slots beyond 8.
+
+## Per-template contract
+
+1. **H1 always present.** `# <Provider> · <Subject>` (or similar). Never a blank `# <Provider> ·`.
+2. **Error branch uses the partial.** Inside `{{#if error}}` use `{{> _partials/provider-error}}`. Do not write inline `Status:`/`Message:` blocks — the partial covers that. 44 templates use this pattern today; new templates must too.
+3. **Helpers must be registered.** See `src/infrastructure/markdown/handlebars-renderer.ts`. The 15 names are: `value`, `coalesce`, `formatCount`, `truncate`, `stripHtml`, `formatDate`, `timestamp`, `duration`, `inc`, `hashtags`, `hashtagsCsv`, `moreCount`, `eachLimit`, `commentsTree`, `providerMessage`.
+4. **Field paths use `coalesce` over fallback chains.** Upstream sends camelCase + snake_case variants for the same value; `coalesce` picks the first defined.
+5. **Hard size ceiling: `Buffer.byteLength(rendered, "utf8")` must be `< 12_000` bytes** (strictly less than 12000 — not 12 KB / 12288). A 12001-byte render fails the structure test.
+6. **No denylist matches** in the rendered output. `RENDERED_DENYLIST` (`scrape-creators-structure.test.ts`) is an array of **regexes**, not literal substrings — several are case-insensitive and several are anchored to `?`/`&` query delimiters (e.g. `/[?&](?:sqp|rs)=/i`, `/\butm_[a-z0-9_]+=?/i`, `/x-signature/i`). Tokens it catches include `credits_remaining`, `sec_uid`, `author_user_id`, `url_list`, `x-signature`, `x-expires`, `refresh_token`, `common-sign.tiktokcdn`, `utm_*`, `ascsubtag`, `mcid`, `tag_override`, `sqp=`, `rs=`, `continuationItems`. Add new noise as a regex, not a plain string.
+7. **No collapsed-empty sections.** Beyond the H1 rule, the structure test also rejects: a trailing `· ` blank heading, a render shorter than 10 chars, a leading fenced ```json block, a blank `>` quote, a blank numbered list item, and a blank `@ Followers`/`Following` heading. Guard conditional sections so sparse data never emits an empty quote, list item, or heading.
+
+## When you change a template
+
+1. Edit the `.hbs`.
+2. Re-render the fixture: `npm run fixtures:render-live`.
+3. Check parity: `npm run fixtures:check-live`.
+4. Commit the template + the re-rendered fixture together.
+
+## When you need a new helper
+
+A new helper is a registration in `src/infrastructure/markdown/handlebars-renderer.ts`. Justify it in the PR — adding the 16th helper crosses a line, prefer composing existing helpers (`value`, `coalesce`, `inc`, `eachLimit`) where possible.

package/templates/scrape-creators/_partials/empty-success.hbs

@@ -0,0 +1,3 @@
+## Provider Response
+
+The provider returned a successful response with no renderable fields for this resource. The upstream may have served an empty payload, the account may be private, or the resource may be unavailable.

package/templates/scrape-creators/_partials/more-footer.hbs

@@ -0,0 +1 @@
+{{#if (moreCount items limit)}}{{#if bullet}}- {{/if}}...and {{moreCount items limit}} more{{#if noun}} {{noun}}{{/if}}{{/if}}

package/templates/scrape-creators/_partials/provider-error.hbs

@@ -0,0 +1,4 @@
+## Provider Error
+
+Status: {{coalesce error "provider_error"}}{{#if errorStatus}} ({{errorStatus}}){{/if}}
+Message: {{providerMessage message}}

package/templates/scrape-creators/_partials/stats-table.hbs

@@ -0,0 +1,11 @@
+| Metric | Value |
+|---|---:|
+{{#if value1}}| {{label1}} | {{value1}} |
+{{/if}}{{#if value2}}| {{label2}} | {{value2}} |
+{{/if}}{{#if value3}}| {{label3}} | {{value3}} |
+{{/if}}{{#if value4}}| {{label4}} | {{value4}} |
+{{/if}}{{#if value5}}| {{label5}} | {{value5}} |
+{{/if}}{{#if value6}}| {{label6}} | {{value6}} |
+{{/if}}{{#if value7}}| {{label7}} | {{value7}} |
+{{/if}}{{#if value8}}| {{label8}} | {{value8}} |
+{{/if}}

package/templates/scrape-creators/age-gender/detect-age-gender.hbs

@@ -0,0 +1,11 @@
+# Age and Gender · {{coalesce gender "Unknown"}}
+
+{{#if error}}
+{{> _partials/provider-error title="Age and Gender" }}
+{{else}}
+{{#if ageRange.low}}Age range: {{ageRange.low}}-{{ageRange.high}}
+{{/if}}{{#if confidence.gender}}Gender confidence: {{formatCount confidence.gender}}%
+{{/if}}{{#unless gender}}
+{{> _partials/empty-success}}
+{{/unless}}
+{{/if}}

package/templates/scrape-creators/amazon-shop/profile.hbs

@@ -0,0 +1,49 @@
+# Amazon Shop · {{name}}
+
+Host: {{name}}{{#if isTopCreator}} · Top Creator{{/if}}
+{{#if description}}
+Bio: {{truncate description 400}}
+{{/if}}{{#if avatar}}
+Avatar: [image]({{avatar}})
+{{/if}}
+{{#if socials}}
+## Socials
+
+{{#eachLimit socials 5}}
+- {{this}}
+{{/eachLimit}}
+{{/if}}
+{{#if lists}}
+## Collections
+
+{{#eachLimit lists 10}}
+{{inc @index}}. {{title}} · {{formatCount itemCount}} items
+Cover: [image]({{image}})
+URL: {{url}}
+
+{{/eachLimit}}
+{{#if (moreCount lists 10)}}...and {{moreCount lists 10}} more{{/if}}
+{{/if}}
+{{#if curations}}
+## Curations
+
+{{#eachLimit curations 5}}
+{{inc @index}}. {{title}} · {{formatCount postCount}} posts
+Image: [image]({{image}})
+URL: {{url}}
+
+{{/eachLimit}}
+{{> _partials/more-footer items=curations limit=5 noun="curations" }}
+{{/if}}
+{{#if trendingPicks}}
+## Trending Picks
+
+{{#eachLimit trendingPicks 5}}
+{{inc @index}}. {{url}}
+{{#if price}}Price: {{price}}{{/if}}{{#if discount}}
+Discount: {{discount}}%{{/if}}{{#if image}}
+Image: [image]({{image}}){{/if}}
+
+{{/eachLimit}}
+{{> _partials/more-footer items=trendingPicks limit=5 noun="picks" }}
+{{/if}}

package/templates/scrape-creators/bluesky/post.hbs

@@ -0,0 +1,45 @@
+# Bluesky · {{coalesce post.author.handle author.handle "Post"}}
+
+{{#if (coalesce post.record.text record.text text post.text caption)}}
+{{#if (coalesce post.author.handle author.handle)}}Author: @{{coalesce post.author.handle author.handle}}{{#if (coalesce post.author.displayName author.displayName)}} ({{coalesce post.author.displayName author.displayName}}){{/if}}{{#if (coalesce post.author.verification.verifiedStatus author.verification.verifiedStatus)}} · verification: {{coalesce post.author.verification.verifiedStatus author.verification.verifiedStatus}}{{/if}}{{/if}}
+{{#if (coalesce post.record.createdAt post.indexedAt record.createdAt createdAt indexedAt)}}Posted: {{formatDate (coalesce post.record.createdAt post.indexedAt record.createdAt createdAt indexedAt)}}{{/if}}
+{{#if (coalesce post.url url)}}Link: {{coalesce post.url url}}{{/if}}
+
+> {{truncate (coalesce post.record.text record.text text post.text caption) 500}}
+
+{{#if (formatCount (coalesce post.replyCount replyCount post.repostCount repostCount post.likeCount likeCount post.quoteCount quoteCount))}}
+## Stats
+{{> _partials/stats-table label1="Replies" value1=(formatCount (coalesce post.replyCount replyCount)) label2="Reposts" value2=(formatCount (coalesce post.repostCount repostCount)) label3="Likes" value3=(formatCount (coalesce post.likeCount likeCount)) label4="Quotes" value4=(formatCount (coalesce post.quoteCount quoteCount)) }}
+{{/if}}
+
+{{#if (coalesce (value "post.embed.images.0.alt") (value "embed.images.0.alt") (value "post.record.embed.images.0.alt") (value "record.embed.images.0.alt"))}}
+Image: {{truncate (coalesce (value "post.embed.images.0.alt") (value "embed.images.0.alt") (value "post.record.embed.images.0.alt") (value "record.embed.images.0.alt")) 180}}
+{{/if}}
+{{#if (coalesce post.embed.alt embed.alt post.record.embed.alt record.embed.alt)}}
+Video: {{truncate (coalesce post.embed.alt embed.alt post.record.embed.alt record.embed.alt) 180}}{{#if (coalesce post.embed.presentation embed.presentation post.record.embed.presentation record.embed.presentation)}} (presentation: {{coalesce post.embed.presentation embed.presentation post.record.embed.presentation record.embed.presentation}}){{/if}}
+{{/if}}
+{{#if (coalesce post.embed.external.title embed.external.title post.record.embed.external.title record.embed.external.title post.record.embed.card.title record.embed.card.title)}}
+Card: [{{coalesce post.embed.external.title embed.external.title post.record.embed.external.title record.embed.external.title post.record.embed.card.title record.embed.card.title}}]({{coalesce post.embed.external.uri embed.external.uri post.record.embed.external.uri record.embed.external.uri post.record.embed.card.uri record.embed.card.uri}}){{#if (coalesce post.embed.external.description embed.external.description post.record.embed.external.description record.embed.external.description post.record.embed.card.description record.embed.card.description)}} - {{truncate (coalesce post.embed.external.description embed.external.description post.record.embed.external.description record.embed.external.description post.record.embed.card.description record.embed.card.description) 160}}{{/if}}
+{{/if}}
+{{#if (coalesce post.embed.record.value.text embed.record.value.text)}}
+Quoted: @{{coalesce post.embed.record.author.handle embed.record.author.handle}} - {{truncate (coalesce post.embed.record.value.text embed.record.value.text) 220}}
+{{#if (formatCount (coalesce post.embed.record.replyCount embed.record.replyCount post.embed.record.repostCount embed.record.repostCount post.embed.record.likeCount embed.record.likeCount post.embed.record.quoteCount embed.record.quoteCount))}}Quoted stats: {{formatCount (coalesce post.embed.record.replyCount embed.record.replyCount)}} replies · {{formatCount (coalesce post.embed.record.repostCount embed.record.repostCount)}} reposts · {{formatCount (coalesce post.embed.record.likeCount embed.record.likeCount)}} likes · {{formatCount (coalesce post.embed.record.quoteCount embed.record.quoteCount)}} quotes{{/if}}
+{{#if (coalesce (value "post.embed.record.embeds.0.images.0.alt") (value "embed.record.embeds.0.images.0.alt") (value "post.embed.record.value.embed.images.0.alt") (value "embed.record.value.embed.images.0.alt"))}}Quoted image: {{truncate (coalesce (value "post.embed.record.embeds.0.images.0.alt") (value "embed.record.embeds.0.images.0.alt") (value "post.embed.record.value.embed.images.0.alt") (value "embed.record.value.embed.images.0.alt")) 160}}{{/if}}
+{{#if (coalesce (value "post.embed.record.embeds.0.external.title") (value "embed.record.embeds.0.external.title") post.embed.record.value.embed.external.title embed.record.value.embed.external.title)}}Quoted card: [{{coalesce (value "post.embed.record.embeds.0.external.title") (value "embed.record.embeds.0.external.title") post.embed.record.value.embed.external.title embed.record.value.embed.external.title}}]({{coalesce (value "post.embed.record.embeds.0.external.uri") (value "embed.record.embeds.0.external.uri") post.embed.record.value.embed.external.uri embed.record.value.embed.external.uri}}){{/if}}
+{{/if}}
+
+{{#if replies}}
+## Replies
+
+{{#eachLimit replies 5}}
+{{inc @index}}. {{truncate (coalesce post.record.text record.text text) 240}}
+{{#if (coalesce post.author.handle author.handle)}}Author: @{{coalesce post.author.handle author.handle}}{{/if}}
+{{#if (coalesce post.record.createdAt post.indexedAt record.createdAt indexedAt)}}Posted: {{formatDate (coalesce post.record.createdAt post.indexedAt record.createdAt indexedAt)}}{{/if}}
+{{#if (formatCount (coalesce post.replyCount replyCount post.repostCount repostCount post.likeCount likeCount post.quoteCount quoteCount))}}Stats: {{formatCount (coalesce post.replyCount replyCount)}} replies · {{formatCount (coalesce post.repostCount repostCount)}} reposts · {{formatCount (coalesce post.likeCount likeCount)}} likes · {{formatCount (coalesce post.quoteCount quoteCount)}} quotes{{/if}}
+
+{{/eachLimit}}
+{{> _partials/more-footer items=replies limit=5 noun="replies" }}
+{{/if}}
+{{else}}
+{{> _partials/empty-success }}
+{{/if}}

package/templates/scrape-creators/bluesky/profile.hbs

@@ -0,0 +1,12 @@
+# Bluesky · {{coalesce displayName handle}}
+
+Profile: @{{handle}}
+Created: {{formatDate createdAt}}
+
+{{#if description}}
+> {{description}}
+
+{{/if}}
+## Stats
+
+{{> _partials/stats-table label1="Followers" value1=(formatCount followersCount) label2="Following" value2=(formatCount followsCount) label3="Posts" value3=(formatCount postsCount) }}

package/templates/scrape-creators/bluesky/user-posts.hbs

@@ -0,0 +1,25 @@
+# Bluesky · User Posts
+
+{{#eachLimit (coalesce feed posts) 20}}
+{{inc @index}}. {{truncate (coalesce record.text text post.record.text) 280}}
+Author: @{{author.handle}}{{#if author.verification.verifiedStatus}} (verification: {{author.verification.verifiedStatus}}){{/if}}
+Posted: {{formatDate (coalesce record.createdAt indexedAt)}}
+Stats: {{formatCount replyCount}} replies · {{formatCount repostCount}} reposts · {{formatCount likeCount}} likes{{#if (formatCount quoteCount)}} · {{formatCount quoteCount}} quotes{{/if}}
+{{#if embed.images}}
+Image: {{truncate (coalesce (value "embed.images.0.alt") "attached image") 180}}
+{{/if}}
+{{#if (coalesce embed.alt record.embed.alt)}}
+Video: {{truncate (coalesce embed.alt record.embed.alt) 180}}{{#if (coalesce embed.presentation record.embed.presentation)}} (presentation: {{coalesce embed.presentation record.embed.presentation}}){{/if}}
+{{/if}}
+{{#if embed.external}}
+Card: [{{embed.external.title}}]({{embed.external.uri}}){{#if embed.external.description}} - {{truncate embed.external.description 160}}{{/if}}
+{{/if}}
+{{#if embed.record}}
+Quoted: @{{embed.record.author.handle}} - {{truncate embed.record.value.text 200}}
+{{#if (formatCount (coalesce embed.record.replyCount embed.record.repostCount embed.record.likeCount embed.record.quoteCount))}}Quoted stats: {{formatCount embed.record.replyCount}} replies · {{formatCount embed.record.repostCount}} reposts · {{formatCount embed.record.likeCount}} likes · {{formatCount embed.record.quoteCount}} quotes{{/if}}
+{{#if (coalesce (value "embed.record.embeds.0.images.0.alt") (value "embed.record.value.embed.images.0.alt"))}}Quoted image: {{truncate (coalesce (value "embed.record.embeds.0.images.0.alt") (value "embed.record.value.embed.images.0.alt")) 160}}{{/if}}
+{{#if (coalesce (value "embed.record.embeds.0.external.title") embed.record.value.embed.external.title)}}Quoted card: [{{coalesce (value "embed.record.embeds.0.external.title") embed.record.value.embed.external.title}}]({{coalesce (value "embed.record.embeds.0.external.uri") embed.record.value.embed.external.uri}}){{#if (coalesce (value "embed.record.embeds.0.external.description") embed.record.value.embed.external.description)}} - {{truncate (coalesce (value "embed.record.embeds.0.external.description") embed.record.value.embed.external.description) 140}}{{/if}}{{/if}}
+{{/if}}
+
+{{/eachLimit}}
+{{#if (moreCount (coalesce feed posts) 20)}}...and {{moreCount (coalesce feed posts) 20}} more{{/if}}

package/templates/scrape-creators/facebook/comment-replies.hbs

@@ -0,0 +1,21 @@
+# Facebook · Comment Replies
+
+{{#if error}}
+{{> _partials/provider-error }}
+{{else}}
+{{#eachLimit replies 20}}
+{{inc @index}}. **{{coalesce author.name author.display_name authorDisplayName author_name from.name username}}** ({{formatDate (coalesce posted_at created_time createdAt timestamp)}}, {{formatCount (coalesce like_count likes_count reactions.like_count reactions.total)}} likes)
+> {{truncate (coalesce text message content body) 200}}
+{{#if (coalesce reply_count replies_count nested_reply_count)}}Replies: {{formatCount (coalesce reply_count replies_count nested_reply_count)}}{{/if}}
+
+{{/eachLimit}}
+{{#eachLimit comments 20}}
+{{inc @index}}. **{{coalesce author.name author.display_name authorDisplayName author_name from.name username}}** ({{formatDate (coalesce posted_at created_time createdAt timestamp)}}, {{formatCount (coalesce like_count likes_count reactions.like_count reactions.total)}} likes)
+> {{truncate (coalesce text message content body) 200}}
+{{#if (coalesce reply_count replies_count nested_reply_count)}}Replies: {{formatCount (coalesce reply_count replies_count nested_reply_count)}}{{/if}}
+
+{{/eachLimit}}
+{{#if (moreCount replies 20)}}...and {{moreCount replies 20}} more{{/if}}
+{{#if (moreCount comments 20)}}...and {{moreCount comments 20}} more{{/if}}
+{{#unless replies.length}}{{#unless comments.length}}No comment replies returned.{{/unless}}{{/unless}}
+{{/if}}

package/templates/scrape-creators/facebook/comments.hbs

@@ -0,0 +1,10 @@
+# Facebook Comments
+
+## Comments
+
+{{#eachLimit comments 10}}
+{{inc @index}}. **{{coalesce author.name author_name username}}**: {{truncate (coalesce text message) 200}}{{#if (coalesce reactions.like reaction_count like_count)}} — {{formatCount (coalesce reactions.like reaction_count like_count)}} reactions{{/if}}{{#if reply_count}} · {{formatCount reply_count}} replies{{/if}}{{#if created_at}} · {{formatDate created_at}}{{/if}}
+{{/eachLimit}}
+{{#unless comments.length}}No comments returned.{{/unless}}
+{{#if (moreCount comments 10)}}...and {{moreCount comments 10}} more{{/if}}
+{{#if has_next_page}}More comments available.{{/if}}

package/templates/scrape-creators/facebook/group-posts.hbs

@@ -0,0 +1,11 @@
+# Facebook · Group Posts
+
+{{#eachLimit posts 20}}
+{{inc @index}}. **{{coalesce author.name author.display_name authorDisplayName author_name from.name username}}** — {{formatDate (coalesce posted_at created_time createdAt timestamp)}}
+> {{truncate (coalesce text message content body) 280}}
+Reactions: {{formatCount (coalesce reaction_count reactions_count reactions.total reactions.total_count)}} · Comments: {{formatCount (coalesce comment_count comments_count comments.total comments.total_count)}}{{#if (coalesce shares_count share_count shares.total shares_count_total)}} · Shares: {{formatCount (coalesce shares_count share_count shares.total shares_count_total)}}{{/if}}
+{{#if (coalesce url post_url postUrl permalink_url permalinkUrl facebook_url)}}Post: {{coalesce url post_url postUrl permalink_url permalinkUrl facebook_url}}{{/if}}
+
+{{/eachLimit}}
+{{#unless posts.length}}No group posts returned.{{/unless}}
+{{#if (moreCount posts 20)}}...and {{moreCount posts 20}} more{{/if}}

package/templates/scrape-creators/facebook/post-transcript.hbs

@@ -0,0 +1,11 @@
+# Facebook · Post Transcript
+
+## Transcript
+
+{{#if text}}
+{{text}}
+{{/if}}
+{{#eachLimit transcript 500}}
+{{coalesce text transcript content line sentence}}
+
+{{/eachLimit}}

package/templates/scrape-creators/facebook/post.hbs

@@ -0,0 +1,21 @@
+# Facebook Post
+
+{{#if (coalesce description post.message)}}
+> {{truncate (coalesce description post.message) 300}}
+
+{{/if}}
+{{#if author.name}}Author: [{{author.name}}]({{author.url}})
+{{/if}}Posted: {{formatDate (coalesce creation_time post.created_time)}}{{#if (coalesce url post.url)}} · Link: {{coalesce url post.url}}{{/if}}{{#if (coalesce post_id post.post_id)}} · Post ID: {{coalesce post_id post.post_id}}{{/if}}
+
+## Engagement
+
+{{> _partials/stats-table label1="Likes" value1=(formatCount (coalesce like_count post.reactions.total)) label2="Comments" value2=(formatCount (coalesce comment_count post.comments_count)) label3="Shares" value3=(formatCount (coalesce share_count post.shares_count)) label4="Views" value4=(formatCount view_count) }}
+{{#if reaction_counts}}Reactions:{{#if reaction_counts.like}} Like {{formatCount reaction_counts.like}}{{/if}}{{#if reaction_counts.love}} · Love {{formatCount reaction_counts.love}}{{/if}}{{#if reaction_counts.care}} · Care {{formatCount reaction_counts.care}}{{/if}}{{#if reaction_counts.haha}} · Haha {{formatCount reaction_counts.haha}}{{/if}}{{#if reaction_counts.wow}} · Wow {{formatCount reaction_counts.wow}}{{/if}}{{#if reaction_counts.sad}} · Sad {{formatCount reaction_counts.sad}}{{/if}}{{#if reaction_counts.anger}} · Anger {{formatCount reaction_counts.anger}}{{/if}}
+{{/if}}
+{{#if comments}}
+## Top Comments
+
+{{#eachLimit comments 3}}
+- **{{author.name}}:** {{truncate text 160}}{{#if reaction_count}} — {{formatCount reaction_count}} reactions{{/if}}
+{{/eachLimit}}
+{{/if}}

package/templates/scrape-creators/facebook/profile-events.hbs

@@ -0,0 +1,19 @@
+{{#if error}}
+# Facebook · Profile Events Error
+
+{{> _partials/provider-error}}
+{{else}}
+# Facebook · Profile Events
+
+{{#if events}}
+{{#eachLimit events 20}}
+{{inc @index}}. **{{truncate name 200}}**{{#if day_time_sentence}} — {{day_time_sentence}}{{/if}}{{#if event_place.contextual_name}} · {{event_place.contextual_name}}{{/if}}{{#if is_canceled}} · canceled{{/if}}{{#if url}} · [event]({{url}}){{/if}}
+
+{{/eachLimit}}
+{{> _partials/more-footer items=events limit=20 }}
+{{else}}
+No profile events returned.
+{{/if}}
+
+{{#if has_next_page}}More events available.{{/if}}{{#if cursor}} Cursor: `{{cursor}}`{{/if}}
+{{/if}}

package/templates/scrape-creators/facebook/profile-photos.hbs

@@ -0,0 +1,8 @@
+# Facebook · Profile Photos
+
+{{#eachLimit photos 20}}
+{{inc @index}}. {{truncate accessibility_caption 200}}{{#if created_time}} — {{formatDate created_time}}{{/if}}{{#if reactionCount}} · {{formatCount reactionCount}} reactions{{/if}}{{#if url}}
+[![{{truncate accessibility_caption 80}}]({{url}})]({{url}}){{/if}}
+
+{{/eachLimit}}
+{{#if (moreCount photos 20)}}...and {{moreCount photos 20}} more{{/if}}

package/templates/scrape-creators/facebook/profile-posts.hbs

@@ -0,0 +1,7 @@
+# Facebook · Profile Posts
+
+{{#eachLimit posts 20}}
+{{inc @index}}. {{truncate text 280}}{{#if publishTime}} — {{formatDate publishTime}}{{/if}} · {{formatCount reactionCount}} reactions · {{formatCount commentCount}} comments{{#if shareCount}} · {{formatCount shareCount}} shares{{/if}}{{#if url}} · [post]({{url}}){{/if}}{{#if image}} · [media]({{image}}){{/if}}
+
+{{/eachLimit}}
+{{#if (moreCount posts 20)}}...and {{moreCount posts 20}} more{{/if}}

package/templates/scrape-creators/facebook/profile-reels.hbs

@@ -0,0 +1,7 @@
+# Facebook · Profile Reels
+
+{{#eachLimit reels 20}}
+{{inc @index}}. {{truncate (coalesce description "Reel") 280}}{{#if creation_time}} — {{formatDate creation_time}}{{/if}} · {{formatCount view_count}} views{{#if like_count}} · {{formatCount like_count}} likes{{/if}}{{#if comment_count}} · {{formatCount comment_count}} comments{{/if}}{{#if url}} · [reel]({{url}}){{/if}}{{#if thumbnail}} · thumbnail available{{/if}}
+
+{{/eachLimit}}
+{{#if (moreCount reels 20)}}...and {{moreCount reels 20}} more{{/if}}

package/templates/scrape-creators/facebook/profile.hbs

@@ -0,0 +1,30 @@
+# Facebook Profile · {{coalesce name profile.name title}}
+
+{{#if username}}Profile: {{username}}{{/if}}
+{{#if url}}Profile URL: {{url}}{{/if}}
+{{#if category}}Category: {{category}}{{/if}}
+{{#if creationDate}}Created: {{creationDate}}{{/if}}
+
+## Counts
+
+| Metric | Value |
+|---|---:|
+| Followers | {{formatCount (coalesce followerCount followers)}} |
+| Likes | {{formatCount (coalesce likeCount likes)}} |
+{{#if (coalesce posts_count postCount)}}
+| Posts | {{formatCount (coalesce posts_count postCount)}} |
+{{/if}}
+
+{{#if (coalesce pageIntro bio)}}
+## Bio
+
+> {{truncate (coalesce pageIntro bio) 300}}
+
+{{/if}}
+{{#if recentActivity}}
+## Recent Activity
+
+{{#eachLimit recentActivity 5}}
+- {{truncate text 180}}{{#if created_time}} — {{formatDate created_time}}{{/if}}
+{{/eachLimit}}
+{{/if}}

package/templates/scrape-creators/facebook-ad-library/ad-detail.hbs

@@ -0,0 +1,83 @@
+# Facebook Ad Library · Ad Detail
+
+{{#if error}}
+{{> _partials/provider-error}}
+{{else}}
+{{#if pageName}}
+Advertiser: {{pageName}}
+Status: {{#if isActive}}Active{{else}}Inactive{{/if}}
+Run dates: {{formatDate startDate}} - {{formatDate endDate}}
+Platforms: {{publisherPlatform}}
+Impressions/audience: {{coalesce impressions impressionsText reachEstimate "Not disclosed"}}
+Headline: {{coalesce snapshot.title snapshot.cards.0.title}}
+Body: {{coalesce snapshot.body.text snapshot.body snapshot.cards.0.body}}
+Creative: {{coalesce snapshot.cta_text snapshot.display_format}}
+{{#if snapshot.link_url}}Destination: {{snapshot.link_url}}{{/if}}
+{{#if snapshot.page_profile_uri}}Advertiser link: {{snapshot.page_profile_uri}}{{/if}}
+{{#if url}}Ad Library: {{url}}{{/if}}
+
+{{#if snapshot.cards}}
+## Creative Variants
+
+{{#eachLimit snapshot.cards 5}}
+{{inc @index}}. {{coalesce title cta_text}}
+{{#if body}}Body: {{truncate body 200}}{{/if}}
+{{#if link_description}}Description: {{link_description}}{{/if}}
+{{#if link_url}}Link: {{link_url}}{{/if}}
+
+{{/eachLimit}}
+{{/if}}
+{{/if}}
+
+{{#if data}}
+Advertiser: {{data.pageName}}
+Status: {{#if data.isActive}}Active{{else}}Inactive{{/if}}
+Run dates: {{formatDate data.startDate}} - {{formatDate data.endDate}}
+Platforms: {{data.publisherPlatform}}
+Impressions/audience: {{coalesce data.impressions data.impressionsText data.reachEstimate "Not disclosed"}}
+Headline: {{coalesce data.snapshot.title data.snapshot.cards.0.title}}
+Body: {{coalesce data.snapshot.body.text data.snapshot.body data.snapshot.cards.0.body}}
+Creative: {{coalesce data.snapshot.cta_text data.snapshot.display_format}}
+{{#if data.snapshot.link_url}}Destination: {{data.snapshot.link_url}}{{/if}}
+{{#if data.snapshot.page_profile_uri}}Advertiser link: {{data.snapshot.page_profile_uri}}{{/if}}
+{{#if data.url}}Ad Library: {{data.url}}{{/if}}
+
+{{#if data.snapshot.cards}}
+## Creative Variants
+
+{{#eachLimit data.snapshot.cards 5}}
+{{inc @index}}. {{coalesce title cta_text}}
+{{#if body}}Body: {{truncate body 200}}{{/if}}
+{{#if link_description}}Description: {{link_description}}{{/if}}
+{{#if link_url}}Link: {{link_url}}{{/if}}
+
+{{/eachLimit}}
+{{/if}}
+{{/if}}
+
+{{#if ad}}
+Advertiser: {{ad.pageName}}
+Status: {{#if ad.isActive}}Active{{else}}Inactive{{/if}}
+Run dates: {{formatDate ad.startDate}} - {{formatDate ad.endDate}}
+Platforms: {{ad.publisherPlatform}}
+Impressions/audience: {{coalesce ad.impressions ad.impressionsText ad.reachEstimate "Not disclosed"}}
+Headline: {{coalesce ad.snapshot.title ad.snapshot.cards.0.title}}
+Body: {{coalesce ad.snapshot.body.text ad.snapshot.body ad.snapshot.cards.0.body}}
+Creative: {{coalesce ad.snapshot.cta_text ad.snapshot.display_format}}
+{{#if ad.snapshot.link_url}}Destination: {{ad.snapshot.link_url}}{{/if}}
+{{#if ad.snapshot.page_profile_uri}}Advertiser link: {{ad.snapshot.page_profile_uri}}{{/if}}
+{{#if ad.url}}Ad Library: {{ad.url}}{{/if}}
+
+{{#if ad.snapshot.cards}}
+## Creative Variants
+
+{{#eachLimit ad.snapshot.cards 5}}
+{{inc @index}}. {{coalesce title cta_text}}
+{{#if body}}Body: {{truncate body 200}}{{/if}}
+{{#if link_description}}Description: {{link_description}}{{/if}}
+{{#if link_url}}Link: {{link_url}}{{/if}}
+
+{{/eachLimit}}
+{{/if}}
+{{/if}}
+{{/if}}

package/templates/scrape-creators/facebook-ad-library/ad-search.hbs

@@ -0,0 +1,21 @@
+# Facebook Ad Library - Ad Search
+
+{{#if searchResultsCount}}Total matching ads: {{formatCount searchResultsCount}}{{/if}}
+{{#if cursor}}More results available: yes{{/if}}
+
+{{#if searchResults}}
+{{#eachLimit searchResults 20}}
+{{inc @index}}. {{coalesce snapshot.title snapshot.cards.0.title page_name "Ad"}}
+Advertiser: {{coalesce page_name snapshot.page_name}}
+Body: {{truncate (coalesce snapshot.body.text snapshot.cards.0.body) 220}}
+{{#if start_date}}Started: {{formatDate start_date}}{{/if}}
+{{#if end_date}}Ended: {{formatDate end_date}}{{/if}}
+Active: {{#if is_active}}Yes{{else}}No{{/if}}
+{{#if publisher_platform}}Platforms: {{publisher_platform}}{{/if}}
+Impressions/audience: {{coalesce impressions_with_index.impressions_text reach_estimate "Not disclosed"}}
+{{#if snapshot.link_url}}Destination: {{snapshot.link_url}}{{/if}}
+{{#if url}}Ad Library: {{url}}{{/if}}
+
+{{/eachLimit}}
+{{> _partials/more-footer items=searchResults limit=20 noun="ads" }}
+{{/if}}

package/templates/scrape-creators/facebook-ad-library/company-ads.hbs

@@ -0,0 +1,20 @@
+# Facebook Ad Library · Company Ads
+
+{{#if searchResultsCount}}Total matching ads: {{formatCount searchResultsCount}}{{/if}}
+
+{{#if (coalesce results ads)}}
+{{#eachLimit (coalesce results ads) 20}}
+{{inc @index}}. {{coalesce snapshot.title snapshot.cards.0.title page_name}}
+Advertiser: {{coalesce page_name snapshot.page_name}}
+Body: {{truncate (coalesce snapshot.body.text snapshot.cards.0.body) 200}}
+Started: {{formatDate start_date}}
+{{#if end_date}}Ended: {{formatDate end_date}}{{/if}}
+Active: {{#if is_active}}Yes{{else}}No{{/if}}
+Platforms: {{publisher_platform}}
+Impressions/audience: {{coalesce impressions_with_index.impressions_text reach_estimate "Not disclosed"}}
+{{#if snapshot.link_url}}Destination: {{snapshot.link_url}}{{/if}}
+Ad Library: {{url}}
+
+{{/eachLimit}}
+{{#if (moreCount (coalesce results ads) 20)}}...and {{moreCount (coalesce results ads) 20}} more{{/if}}
+{{else}}No ads returned.{{/if}}

package/templates/scrape-creators/facebook-ad-library/company-search.hbs

@@ -0,0 +1,14 @@
+# Facebook Ad Library · Advertiser Search
+
+{{#if searchResults}}
+{{#eachLimit searchResults 20}}
+{{inc @index}}. {{name}}{{#if verification}} ✓{{/if}}
+Category: {{category}}
+Page likes: {{formatCount likes}}
+{{#if page_alias}}Page: https://www.facebook.com/{{page_alias}}
+{{/if}}{{#if ig_username}}Instagram: @{{ig_username}}{{#if ig_verification}} ✓{{/if}} · {{formatCount ig_followers}} followers
+{{/if}}
+
+{{/eachLimit}}
+{{#if (moreCount searchResults 20)}}...and {{moreCount searchResults 20}} more{{/if}}
+{{/if}}