Skip to content

LeoYeAI/agent-master-skills / skills/analyticscli-ts-sdk

analyticscli-ts-sdk

Verified

Use when integrating or upgrading the AnalyticsCLI TypeScript SDK in web, TypeScript, React Native, or Expo apps.

FileKindSize
SKILL.mdskill md20.7 KB
_meta.jsonconfig472 B
references/minimal-host-template.mdmarkdown6.6 KB
references/onboarding-paywall.mdmarkdown11.5 KB
references/storage.mdmarkdown3.2 KB
references/versioning.mdmarkdown869 B

references/storage.md

View on GitHub
# Storage Options

Storage behavior depends on `identityTrackingMode`.

- `consent_gated` (default): strict identity behavior until full-tracking consent is granted
- `always_on`: persistent identity immediately
- `strict`: no persistent identity at all

Strict identity behavior means:
- no persistent `anonId` / `sessionId` across restarts
- no cookie/localStorage identity continuity
- `analytics.identify(...)` / `analytics.setUser(...)` are ignored

Credential source reminder:
- Publishable ingest API key and CLI `readonly_token` come from project **API Keys** in [dash.analyticscli.com](https://dash.analyticscli.com).
- Optional for CLI verification: set a default project once with `analyticscli projects select` (arrow-key picker), or pass `--project <project_id>` per command.

## Adapter Options (when full tracking is enabled)

| Strategy | Good for | Tradeoff |
| --- | --- | --- |
| No adapter | Fast prototypes and strict behavior | IDs reset across restarts |
| `localStorage` | Browser host apps with full tracking enabled | Browser-only API |
| `@react-native-async-storage/async-storage` | Standard React Native persistence | Async hydration happens in background; call `ready()` only when you must block first event |
| `react-native-mmkv` | Fast local key-value storage in RN | Native dependency |
| Custom adapter | Existing secure or encrypted store | You own the wrapper |

## Minimal Example

```ts
import { init } from '@analyticscli/sdk';

const analytics = init({
  apiKey: '<YOUR_APP_KEY>',
  identityTrackingMode: 'consent_gated', // default
});
```

## Full-Tracking Consent Example

```ts
// user accepts full tracking
analytics.setFullTrackingConsent(true);

// user declines full tracking but strict analytics can continue
analytics.setFullTrackingConsent(false);
```

## Web localStorage Example

```ts
import { init } from '@analyticscli/sdk';

const analytics = init({
  apiKey: process.env.NEXT_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY ?? '',
  platform: 'web',
  identityTrackingMode: 'always_on',
  storage: typeof window !== 'undefined' ? window.localStorage : undefined,
});
```

## AsyncStorage Example

```ts
import AsyncStorage from '@react-native-async-storage/async-storage';
import * as Application from 'expo-application';
import { Platform } from 'react-native';
import { init } from '@analyticscli/sdk';

const analytics = init({
  apiKey: process.env.EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY,
  debug: __DEV__,
  platform: Platform.OS,
  appVersion: Application.nativeApplicationVersion,
  identityTrackingMode: 'consent_gated',
  storage: AsyncStorage,
});
```

## MMKV Example

```ts
import { MMKV } from 'react-native-mmkv';
import { Platform } from 'react-native';
import { init } from '@analyticscli/sdk';

const kv = new MMKV();

const analytics = init({
  apiKey: process.env.EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY,
  debug: __DEV__,
  platform: Platform.OS,
  identityTrackingMode: 'consent_gated',
  storage: {
    getItem: (key) => kv.getString(key) ?? null,
    setItem: (key, value) => kv.set(key, value),
    removeItem: (key) => kv.delete(key),
  },
});
```

There is no "do not start yet" init flag. Tracking starts on `init(...)`; use
`ready()` (or `initAsync(...)`) only when startup should wait for async storage
hydration.
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall