Integrations

# Local disk (default)
PYLON_FILES_PROVIDER=local            # default
PYLON_FILES_DIR=uploads               # optional, default "uploads/"
PYLON_FILES_URL_PREFIX=/api/files     # optional, default "/api/files"

# Stack0 CDN
PYLON_FILES_PROVIDER=stack0
PYLON_STACK0_API_KEY=sk_live_...      # required for stack0
PYLON_STACK0_FOLDER=uploads           # optional prefix
PYLON_STACK0_BASE_URL=https://...     # optional override

# S3-compatible: AWS S3, Cloudflare R2, Tigris, MinIO, GCS interop
PYLON_FILES_PROVIDER=s3
PYLON_S3_BUCKET=my-bucket             # required
PYLON_S3_ACCESS_KEY=AKIA...           # required
PYLON_S3_SECRET_KEY=...               # required
PYLON_S3_REGION=us-east-1             # optional, default us-east-1
PYLON_S3_ENDPOINT=https://...         # optional; set for R2/Tigris/MinIO (path-style)
PYLON_S3_PUBLIC_URL=https://cdn...    # optional; public/CDN base (public bucket)
PYLON_S3_SESSION_TOKEN=...            # optional; STS/temporary credentials
PYLON_S3_FOLDER=uploads               # optional prefix

// 1. Ask pylon for an upload slot
const init = await fetch("/api/files/init", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    filename: file.name,
    mimeType: file.type,
    size: file.size,
    visibility: "private", // or "public"; see below
  }),
}).then((r) => r.json());

// 2. PUT the bytes DIRECTLY to the returned URL (Stack0's S3 for the
//    stack0 backend, pylon's local-put endpoint for local). Pylon's
//    process is bypassed for the byte transfer.
await fetch(init.uploadUrl, {
  method: "PUT",
  body: file,
  headers: { "Content-Type": file.type },
});

// 3. Confirm so pylon records ownership and returns the canonical URL
const stored = await fetch("/api/files/confirm", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ assetId: init.assetId }),
}).then((r) => r.json());

// stored = { id, url, size }
//   - stack0: url is the CDN URL
//   - local:  url is /api/files/<id> (served by pylon)

import { uploadFile } from "@pylonsync/react";

const photo = await uploadFile(file, { visibility: "public" });
await db.insert("Post", { imageUrl: photo.url, caption });

PYLON_EMAIL_PROVIDER=sendgrid   # sendgrid | resend | stack0 | webhook
PYLON_EMAIL_API_KEY=...         # the provider's API key
PYLON_EMAIL_FROM="Acme <[email protected]>"   # optional; webhook also needs PYLON_EMAIL_ENDPOINT

import { action, v } from "@pylonsync/functions";

export default action({
  args: { to: v.string() },
  async handler(ctx, args) {
    await ctx.email.send({
      to: args.to,
      subject: "Welcome",
      text: "Thanks for signing up.",        // always required — the text/plain part
      html: "<p>Thanks for signing up.</p>", // optional HTML body
      attachments: [{                        // optional, base64 content
        filename: "invite.ics",
        // Passed through verbatim — `method=REQUEST` is what makes
        // Gmail/Outlook render an RSVP-able calendar invite.
        contentType: "text/calendar; method=REQUEST",
        content: icsBase64,
      }],
    });
  },
});