@littlefriend/cli 0.1.4 → 0.1.5

package/README.md

@@ -89,6 +89,7 @@ A project in JSON is:
   privacyMode: 'aggregate' | 'journey';
   timezone: string;
   allowedOrigins: string[];        // empty: every origin
+  allowedApps: string[];           // app ids that may send, lowercased; empty: no app
   campaignAllowTerm: boolean;
   retentionEventsDays: number; retentionAggregatesDays: number;
   installVerifiedAt: string | null; createdAt: string;
@@ -218,6 +219,42 @@ The project, whether events arrive, and why any were refused. It is `verify` wit
 littlefriend projects check --project acme.com
 ```
 
+#### `apps list`
+
+The project's allowed apps: the bundle ids and package names of the native apps that may send data to it.
+
+```sh
+littlefriend apps list
+```
+
+```ts
+{ allowedApps: string[] }
+```
+
+#### `apps add`
+
+Allows an app by its bundle id (iOS, macOS) or package name (Android). The id is stored lowercased, and an id that does not look like `com.acme.shop` is refused before anything is sent. Prints the new list.
+
+```sh
+littlefriend apps add com.acme.shop
+```
+
+```ts
+{ allowedApps: string[] }
+```
+
+#### `apps remove`
+
+Stops accepting data from an app and prints the new list. An id that is not listed changes nothing.
+
+```sh
+littlefriend apps remove com.acme.shop
+```
+
+```ts
+{ allowedApps: string[] }
+```
+
 ### Install
 
 #### `snippet`
@@ -262,7 +299,7 @@ littlefriend keys list
 
 #### `keys create`
 
-Creates a secret key: `server` for `@littlefriend/node`, `edge` for `@littlefriend/edge` and the agent door, `read` for reading reports.
+Creates a secret key: `server` for `@littlefriend/node`, `edge` for `@littlefriend/edge` and the agent door, `read` for reading reports. `--label` names it in the key list.
 
 With `--write-env`, the secret goes straight into the file as `NAME=secret` and is never printed. The name defaults to `LF_SERVER_KEY`, `LF_EDGE_KEY` or `LF_READ_KEY`; change it with `--env-name`. If the file already sets that name, no key is created. The CLI warns when git does not ignore the file.
 
@@ -422,10 +459,11 @@ The JSON is the API's `FunnelReport`: `{ meta, available, unavailableReason?, wi
 
 #### `report`
 
-Quick numbers to check the data looks right: `overview` (the default), `pages`, `sources`, `goals` or `countries`, over `--from` and `--to` (default the last 7 days in the project's time zone).
+Quick numbers to check the data looks right: `overview` (the default), `pages`, `sources`, `goals` or `countries`, over `--from` and `--to` (default the last 7 days in the project's time zone). `--platform web`, `ios`, `macos` or `android` counts one platform only.
 
 ```sh
 littlefriend report sources --from 2026-09-01 --to 2026-09-28
+littlefriend report overview --platform ios
 ```
 
 The JSON is the API's report response, with `meta.range` holding the dates used.