ingestlayer/recipes

Track file uploads in Postgres

Keep an eye on what's being uploaded — large files, unusual types, heavy buckets — and route the ones worth a second look.

01source

sourcesdk.eventTypeScript SDK
matchfile.uploaded

02pipeline · 1 steps

  • 01CTLfilter.matchsize ≥ 100 MB only

03destinations · 1

  • towarehouse.pgPostgres
    tableevents.signups

the event

You emit file.uploaded with this shape. The TypeScript SDK keeps the call type-safe, and the event is stored whole — so every field below is available to the pipeline by name.

  • user_idstring
  • file_idstring
  • size_bytesnumber
  • mimestringcontent type
  • bucketstring

emit it

From your code with the TypeScript SDK — or any language over the REST endpoint and signed webhook ingress.

emit file.uploaded
import { ingest } from "@ingestlayer/sdk";

await ingest("file.uploaded", {
  user_id:    ctx.user.id,
  file_id:    object.key,
  size_bytes: object.size,
  mime:       object.contentType,
  bucket:     object.bucket,
}, {
  idempotencyKey: object.key,
});

route it to Postgres

Insert each event as a row into a table in your own Postgres.

  1. 01

    add the connection

    Paste a Postgres connection string. Connections originate from our EU region — allowlist those egress IPs on your database.

  2. 02

    point at a table

    Name the target table. Top-level event fields map to columns, and the full payload is also available as a jsonb column.

  3. 03

    map columns

    Match event fields to columns with $event.* references, or accept the default mapping into a typed events table.

in postgresdelivered
INSERT INTO events.signups
  (user_id, email, plan, source, payload)
VALUES
  ('u_018f', 'ada@acme.com', 'pro',
   'marketing-site', '{ … }'::jsonb);

notes

questions

Can I flag unexpected file types?
Branch on the mime field so an executable in a documents bucket reaches the channel while ordinary uploads stay quiet.
How do I watch storage growth?
Land every upload in Postgres with size_bytes and bucket, and aggregate by bucket over time.
Does the file itself pass through?
No — only the metadata you send. The bytes stay in your storage; ingestlayer routes the event, not the object.
build this pipelineor read the quickstart →

file uploads, routed elsewhere

more, into Postgres