Skip to main content

Tarant Sync Client

Provide the capabilities to actors to synchronize with a backend.


add it to your project using npm install tarant-sync-client --save or yarn add tarant-sync-client


Initialize the sync client with the configuration you desire and add it to your actor system as both a materializxer and a resolver

import { RemoteResolverMaterializer } from "tarant-sync-client";
import AppActor from '../AppActor';

const config : any = {
sync: {
active: true,
delay: 1000
paths: {
pull: "/pull",
push: "/push",
actorTypes: { AppActor }

const remote = new RemoteResolverMaterializer(config)
const system = ActorSystem.for(ActorSystemConfigurationBuilder.define()

your actors will require to implement IUpdatable (UpdateFrom) and IExportable (toJson)

import { Actor } from "tarant";
import { IUpdatable, IExportable } from "tarant-sync-client"

export default class AppActor extends Actor implements IUpdatable, IExportable {

constructor(name: string) {

addOne() {

return {
counter: this.counter

updateFrom({ counter }: any): void {
this.counter = counter

private counter = 1;

confiuration options

  1. boolean value defining if there should be live updates pull from the backend
  2. sync.delay: period of time in miliseconds between updates from the backend
  3. paths.pull: path to endpoint for pulling data from the backend
  4. paths.push: path to endpoint for pushing data to the backend
  5. ActorTypes: objects registering the type of actors that should be sync with the backend
Created my free logo at