@xsolla/backpack-js 1.6.0 → 1.6.1-rc.1

package/README.md

@@ -12,12 +12,14 @@ The published package is a self-contained bundle (React inlined). Do **not** ins
 "@xsolla/backpack-js": "workspace:*"
 ```
 
-**Other repositories** — GitLab npm registry. Configure auth first; see [PUBLISHING.md](PUBLISHING.md) and [`.npmrc.example`](.npmrc.example).
+**Other repositories** — npmjs, where the package is public, so nothing has to be configured:
 
 ```bash
 npm install @xsolla/backpack-js@<version>
 ```
 
+Every release is published to the GitLab npm registry as well, for hosts that already resolve `@xsolla` there. That one needs auth; see [PUBLISHING.md](PUBLISHING.md) and [`.npmrc.example`](.npmrc.example).
+
 ## Usage
 
 ```ts
@@ -36,8 +38,12 @@ Transfuse (minting an off-chain catalogue item onto the chain) is off by default
 
 Salvage (destroying an item) is the other way round: it is **on** by default, and an embed turns it off with `enableSalvage` / `enable-salvage`. It signs nothing and costs nothing, the backend refuses the item types it will not destroy, and the drag onto the target is the confirmation, so there is no button a user can hit by accident. The merchant configuration can withhold the seat as well, and wins over the attribute.
 
+Set `openItem` / `open-item` to open that inventory item as the element loads, with its action wheel already up. Backpack fetches the item on its own, so it does not have to be on the first page of the grid. A missing row, a failed fetch, or a hidden SKU leaves the grid as it is. Clearing the attribute, or the player closing the wheel, returns to the catalog. Reloading the embed does not open the same id again.
+
 The action wheel shows the item's 2D artwork in the middle. An embed can put the 3D model there instead with `enableWheel3dModel` / `enable-wheel-3d-model`, which is off by default: the viewer is a WebGL canvas that keeps rendering for as long as the wheel is open, and it takes frames the wheel's own spin and drag need. Item details is unaffected either way and always shows the model.
 
+Xsolla Metrika analytics is off by default. Turn it on with `enableAnalytics` / `enable-analytics`, and pass your project ID as `externalId` / `external-id` so every Backpack event carries it as `eid`. Metrika builds a device fingerprint, so collecting that is your call as the owner of the user's consent. If your page already runs Metrika, Backpack reuses that instance, so initialise it before the element mounts. Otherwise Backpack starts its own, with automatic page tracking off. `external-id` does nothing while analytics is off.
+
 Hosts can refresh or remount the mounted Backpack without reloading their page:
 
 ```ts

package/dist/BackpackElement.d.ts

@@ -24,6 +24,9 @@ export declare class BackpackElement extends HTMLElement {
   enableSalvage: boolean;
   enableWheel3dModel: boolean;
   pageBackground: string | undefined;
+  enableAnalytics: boolean;
+  externalId: string | undefined;
+  openItem: string | undefined;
 
   connectedCallback(): void;
   disconnectedCallback(): void;