Syncly— Developer Documentation & Architecture

Master user preferences entity enforcing strict invariant boundaries via private # fields.

export class UserSettings {
  #name;
  #background;
  #themePreset;
  #timeFormat;
  #clocks;
  #searchEnabled;
  #searchEngine;
  #weatherEnabled;
  #todoEnabled;
  #customCss;

  constructor({
    name = '',
    background = new BackgroundConfig({ kind: 'solid_color', value: '#0B251A' }),
    themePreset = 'minimal',
    timeFormat = '24h',
    clocks = [],
    searchEnabled = true,
    searchEngine = 'google',
    weatherEnabled = false,
    todoEnabled = true,
    customCss = ''
  } = {}) {
    this.#name = this.#sanitizeName(name);
    this.#background = background;
    this.#themePreset = themePreset;
    this.#timeFormat = timeFormat;
    this.#clocks = clocks;
    this.#searchEnabled = Boolean(searchEnabled);
    this.#searchEngine = searchEngine;
    this.#weatherEnabled = Boolean(weatherEnabled);
    this.#todoEnabled = Boolean(todoEnabled);
    this.#customCss = customCss;
  }

  toJSON() {
    return {
      name: this.#name,
      background: this.#background.toJSON(),
      themePreset: this.#themePreset,
      timeFormat: this.#timeFormat,
      clocks: this.#clocks,
      searchEnabled: this.#searchEnabled,
      searchEngine: this.#searchEngine,
      weatherEnabled: this.#weatherEnabled,
      todoEnabled: this.#todoEnabled,
      customCss: this.#customCss
    };
  }
}

Bookmark entity governing title sanitization, category binding, order sorting, and access tracking.

export class Bookmark {
  #id;
  #title;
  #url;
  #categoryId;
  #order;
  #lastAccessed;
  #accessCount;
  #faviconUrl;

  constructor({ id, title, url, categoryId, order = 0, lastAccessed = null, accessCount = 0, faviconUrl = '' }) {
    this.#id = id;
    this.#title = this.#validateTitle(title);
    this.#url = url instanceof Url ? url : new Url(url);
    this.#categoryId = categoryId;
    this.#order = Number.isInteger(order) && order >= 0 ? order : 0;
    this.#lastAccessed = lastAccessed;
    this.#accessCount = accessCount;
    this.#faviconUrl = this.#normalizeFaviconUrl(faviconUrl);
  }

  recordAccess(timestamp = Date.now()) {
    this.#lastAccessed = timestamp;
    this.#accessCount += 1;
  }
}

Synchronous publish/subscribe event bus governing real-time reactive updates across extension surfaces.

export class EventBus {
  #handlers = new Map();

  on(event, handler) {
    if (!this.#handlers.has(event)) {
      this.#handlers.set(event, new Set());
    }
    this.#handlers.get(event).add(handler);
    return () => this.off(event, handler);
  }

  off(event, handler) {
    const set = this.#handlers.get(event);
    if (set) {
      set.delete(handler);
      if (set.size === 0) this.#handlers.delete(event);
    }
  }

  emit(event, payload) {
    const set = this.#handlers.get(event);
    if (set) {
      for (const handler of set) {
        try {
          handler(payload);
        } catch (err) {
          console.error(`[EventBus] Error in handler for ${event}:`, err);
        }
      }
    }
  }
}