@shipeasy/sdk 6.3.1 → 7.1.0

package/docs/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: shipeasy-typescript
-description: Use Shipeasy (feature flags, configs, kill switches, A/B experiments, i18n) from TypeScript / JavaScript. Covers configure() + Client(user), getFlag/getConfig/getKillswitch/getExperiment, track, testing, OpenFeature, and the see() error reporter — server (@shipeasy/sdk/server) and browser (@shipeasy/sdk/client).
+description: Use Shipeasy (feature flags, configs, kill switches, A/B experiments, i18n) from TypeScript / JavaScript. Covers configure() + Client(user), getFlag/getConfig/getKillswitch/universe().assign(), track, testing, OpenFeature, and the see() error reporter — server (@shipeasy/sdk/server) and browser (@shipeasy/sdk/client).
 ---
 
 # Shipeasy TypeScript SDK
@@ -42,6 +42,12 @@ flags.getFlagDetail("new_checkout");                   // { value, reason }
 `configure()` is first-config-wins and owns the fetch lifecycle (one-shot by
 default; `poll: true` for a background refresh). Construct `new Client(user)` once
 per user/request — it binds the user, so no method takes a user argument.
+
+Egress is **environment-derived**: network + usage telemetry default ON in
+production and OFF otherwise (prod is read from `SHIPEASY_ENV`/`NODE_ENV`, else
+the `env` option, default `"prod"`), so the SDK never phones home from dev/CI.
+Override with `isNetworkEnabled: false` (fully offline) or `disableTelemetry: true`
+(keep fetching, no usage beacons).
 Full reference: <https://shipeasy-ai.github.io/sdk-ts/pages/configuration.md> ·
 <https://shipeasy-ai.github.io/sdk-ts/pages/flags.md> ·
 snippets <https://shipeasy-ai.github.io/sdk-ts/snippets/release/flags.md> ·
@@ -52,17 +58,21 @@ snippets <https://shipeasy-ai.github.io/sdk-ts/snippets/release/flags.md> ·
 
 ```ts
 const flags = new Client(currentUser); // construct once per callsite
-const { inExperiment, group, params } = flags.getExperiment("hero_cta", {
-  primary_label: "Sign up", // default params (control / not-enrolled)
-});
-render(params.primary_label);
 
-flags.logExposure("hero_cta");          // record the exposure where you present it
+// Read experiments by UNIVERSE (a mutual-exclusion pool — the unit lands in ≤1
+// experiment). assign() auto-logs one deduped exposure when enrolled.
+const exp = flags.universe("hero_cta").assign();
+render(exp.get("primary_label", "Sign up")); // variant ?? universe default ?? fallback
+
+if (exp.enrolled) {
+  // exp.group is the variant, exp.name is the experiment
+}
 flags.track("purchase", { value: 42 }); // record a conversion for the bound user
 ```
 
-`ExperimentResult = { inExperiment: boolean; group: string; params: P }`. Full
-reference: <https://shipeasy-ai.github.io/sdk-ts/pages/experiments.md> · track snippet
+`Assignment = { name: string | null; group: string | null; enrolled: boolean;
+get(field, fallback) }`. Full reference:
+<https://shipeasy-ai.github.io/sdk-ts/pages/experiments.md> · track snippet
 <https://shipeasy-ai.github.io/sdk-ts/snippets/metrics/track.md>
 
 ## i18n
@@ -138,8 +148,8 @@ Full reference: <https://shipeasy-ai.github.io/sdk-ts/pages/openfeature.md>
 ## Advanced
 
 `privateAttributes`, `bucketBy` (custom bucketing unit), `stickyBucketing`
-(browser: on by default, `__se_sticky` cookie), manual exposure
-(`getExperiment(..., { logExposure: false })` + `flags.logExposure(name)`),
+(browser: on by default, `__se_sticky` cookie), exposure control (browser:
+`universe(name).assign({ logExposure: false })` + `disableAutoExposure`),
 `onChange(cb)` (requires `configure({ poll: true })`) / browser `subscribe()`.
 Devtools overlay: `Shift+Alt+S` or `?se=1`. Full reference:
 <https://shipeasy-ai.github.io/sdk-ts/pages/advanced.md>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipeasy/sdk",
-  "version": "6.3.1",
+  "version": "7.1.0",
   "description": "Shipeasy SDK — feature gates, runtime configs, experiments, and metrics for the Shipeasy hosted service.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://shipeasy.ai",
@@ -14,6 +14,7 @@
   "main": "./dist/server/index.js",
   "module": "./dist/server/index.mjs",
   "browser": "./dist/client/index.js",
+  "react-native": "./dist/client/index.js",
   "typesVersions": {
     "*": {
       "client": [
@@ -29,6 +30,7 @@
   },
   "exports": {
     ".": {
+      "react-native": "./dist/client/index.js",
       "node": "./dist/server/index.js",
       "browser": "./dist/client/index.js",
       "default": "./dist/server/index.js"