Write

The /write endpoint lets you initialize your replicator with some data. It is not used in production. Instead, it is a convenient way to populate your replicator with some data for testing.

To store data, POST a request to the /write endpoint. The body of the request should be raw text (Content-Type: text/plain). You can download an example Postman collection and enter your own replicator URL. Open the request called "Create blog post".

The body is expressed as the Jinaga fact language. The Jinaga fact language lets you declare a set of facts. Here is an example set:

let site: Blog.Site = {
    domain: "qedcode.com"
}

let post: Blog.Post = {
    createdAt: "2022-08-16T15:23:13.231Z",
    site
}

let title: Blog.Post.Title = {
    post,
    value: "Introducing Jinaga Replicator",
    prior: []
}
let title2: Blog.Post.Title = {
    post,
    value: "Introduction to the Jinaga Replicator",
    prior: [ title ]
}

Facts

All of the facts written in the request body will be inserted into the Replicator's database. Give each fact a variable name, a type, and a set of fields.

let site: Blog.Site = {
    domain: "qedcode.com"
}

Predecessors

You can use the variable to declare a predecessor of another fact.

let post: Blog.Post = {
    createdAt: "2022-08-16T15:23:13.231Z",
    site: site
}

If the predecessor has the same name as the variable, you can simplify it.

let post: Blog.Post = {
    createdAt: "2022-08-16T15:23:13.231Z",
    site
}

Arrays

To define an array of predecessors, use square brackets. You can supply empty square brackets for an empty array.

let title: Blog.Post.Title = {
    post,
    value: "Introducing Jinaga Replicator",
    prior: []
}

Or you can list any number of previously defined facts.

let title2: Blog.Post.Title = {
    post,
    value: "Introduction to the Jinaga Replicator",
    prior: [ title ]
}

You may not define predecessors inline. Give each fact its own distinct variable name.