peepshow/sinks/graphql

Reel #07Typed HTTP

peepshow sink / graphql

GraphQLPOST a mutation to any GraphQL endpoint.

Typed ingestion into Hasura · Postgraphile · Apollo · Supabase · Contentful · anything.

What it does

Like the webhook sink, but structured: fire a parameterised GraphQL mutation with the peepshow payload as variables. The mutation is configurable, so any schema is a fit.

When to reach for it

  • Ingest into a Hasura / Postgraphile API over HTTPS
  • Drop runs into a headless CMS (Contentful, Strapi, Hygraph) as entries
  • Pipe into a custom Apollo server without writing a REST adapter

Install

npm i -g peepshow

Use it

peepshow ./v.mp4 --sink graphql \
  --sink-arg url=https://api.example.com/graphql \
  --sink-arg mutation="mutation Ingest(\$run: PeepshowRunInput!) { createRun(input: \$run) { id } }"

Make it automatic

Register the sink once — every run fires it afterward. Scope by--whenso it only runs for matching videos.

peepshow sinks add graphql
peepshow sinks add graphql --when extension=mp4,mov
peepshow sinks add graphql --when path=/Volumes/Work/

Configuration

  • PEEPSHOW_GRAPHQL_URLEndpoint URL.required
  • PEEPSHOW_GRAPHQL_TOKENBearer token sent as `Authorization: Bearer <token>`.

Write your own

A sink is any executable that reads the--emit jsonpayload on stdin. Shell, Node, Python, Go — the spec's indocs/PLUGINS.md. Register persistent ones withpeepshow sinks add-cmd 'your-command'.