Schemas

Schemas are a declarative way of using Sailhouse, and the least chaotic.

They’re decoupled from applications, and you can have them split across several files.

key: schema-key

topics:
  - slug: awesome-topic

subscriptions:
  - slug: awesome-subscription
    topic: awesome-topic
    # Push or Pull
    type: push
    # Endpoint only used for push subscriptions
    endpoint: https://...
    # Filters are supported too
    filter:
      path: type
      value: new

  # defaults to pull if no `type` defined
  - slug: great-subscription
    topic: awesome-topic

Creating a schema

Schemas can be created as an empty .yaml file, or via the CLI.

sailhouse schema create

Schema keys

Schema keys are the way you can manage multiple topics and subscriptions across several different files.

They’re a unique slug that identifies all of the resources attached to that schema.

Using the hosted YAML schema

A schema created by the CLI should have this line at the top.

# yaml-language-server: $schema=https://assets.sailhouse.dev/schema.yaml

If you’re using an editor such as VS Code or a more powerful IDE, it should be able to parse this out of the box and provide strong typing support.