Skip to main content

Cloud Connectivity

Border can connect to Dotset cloud for centralized policy management and analytics.
[!NOTE] Cloud features require a Dotset account. Sign up →

Initialization

import { init, initCloud } from "@dotsetlabs/border";

// First, initialize Border
init({ sensitivity: "medium" });

// Then, connect to cloud
await initCloud({
  projectId: "proj_xxx",
  apiToken: "dss_xxx",
  policySyncEnabled: true,
});

Features

FeatureDescription
Policy SyncFetch destination policies from dashboard
TelemetrySend audit metadata for analytics
Offline ModeQueue events when disconnected

Policy Sync

Policies configured in the dashboard are automatically applied:
import { fetchAndApplyPolicy } from "@dotsetlabs/border";

// Manually trigger sync
const cloudPolicy = await fetchAndApplyPolicy();
Dashboard-managed settings include:
  • Destination policies
  • Allowed domains
  • Sensitivity settings
  • Custom patterns (Business tier)

Telemetry

Audit events are submitted for dashboard analytics:
import { syncEvents } from "@dotsetlabs/border";

// Force immediate sync
await syncEvents();
[!IMPORTANT] No PII is ever sent to the cloud. Only metadata (counts, types, URLs).

Offline Mode

When disconnected, events are queued locally:
import { isCloudConnected, getQueuedEventCount } from "@dotsetlabs/border";

console.log(isCloudConnected());    // false
console.log(getQueuedEventCount()); // 42
Events sync automatically when connection is restored.

Status Monitoring

import { getCloudStatus } from "@dotsetlabs/border";

const status = getCloudStatus();
console.log(status.connected);      // true
console.log(status.queuedEvents);   // 0
console.log(status.lastSync);       // Date

Shutdown

import { shutdownCloud } from "@dotsetlabs/border";

await shutdownCloud();

Plan Features

FeatureFreeProBusiness
Cloud Sync
Telemetry
Policy Sync
Custom Patterns
Retention7d90d1yr

Next Steps