@snapcap/native v0.0.1

@snapcap/native — browser-free Snapchat client for Node.

Loads Snap's web JavaScript bundle and 814 KB of WASM directly inside an isolated Node vm.Context, with shimmed Chrome APIs so the bundle "thinks" it's still running in Chromium. No Playwright, no emulator, no rooted phone — many accounts run on a fraction of the resources a browser harness would require.

Remarks

The package is the public surface for the Snap automation runner — a thin facade over Snap's own bundle plus an opt-in observability + throttling layer. Authentication, friends, messaging, stories, presence, and inbox are surfaced via the SnapcapClient entry point; persistence plugs in via the DataStore interface.

Examples

Quick start:

import { SnapcapClient, FileDataStore } from "@snapcap/native";

const dataStore = new FileDataStore(".tmp/auth/auth.json");
const client = new SnapcapClient({
  dataStore,
  credentials: { username: "...", password: "..." },
  browser: {
    userAgent:
      "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36",
  },
});

await client.authenticate();        // warm-or-cold login, idempotent
const friends = await client.friends.list();

Multi-tenant runners should share one throttle gate across clients — see createSharedThrottle and RECOMMENDED_THROTTLE_RULES:

import {
  SnapcapClient,
  createSharedThrottle,
  RECOMMENDED_THROTTLE_RULES,
} from "@snapcap/native";

const gate = createSharedThrottle({ rules: RECOMMENDED_THROTTLE_RULES });
const clients = tenants.map(t => new SnapcapClient({ ...t, throttle: gate }));

Opt into structured network observability with setLogger (or set SNAP_NETLOG=1 in the environment for the built-in text formatter):

import { setLogger, defaultTextLogger } from "@snapcap/native";
setLogger(defaultTextLogger);

See

• SnapcapClient — the main entry point
• Friends — friends domain manager
• DataStore — persistence interface
• ThrottleConfig — opt-in HTTP throttling
• Logger — structured network observability

Classes

Interfaces

Type Aliases

Variables

Functions