mk-sdk-git 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +26 -2
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,12 +4,15 @@ SDK de tracking de e-commerce + try-on da MetaKosmos. Um único `<script>` que
4
4
  roda em todas as páginas da loja: mede a jornada de compra (visita → produto →
5
5
  carrinho → compra) e injeta o botão de provador virtual de forma zero-touch.
6
6
 
7
+ Publicado no npm como [`mk-sdk-git`](https://www.npmjs.com/package/mk-sdk-git)
8
+ e distribuído via CDN (jsDelivr / unpkg).
9
+
7
10
  ## Instalação
8
11
 
9
- Uma linha antes de `</head>`, em todas as páginas:
12
+ Cole **uma linha** antes de `</head>`, em **todas as páginas** da loja:
10
13
 
11
14
  ```html
12
- <script src="https://collector.metakosmos.com.br/sdk/mk-sdk.js"
15
+ <script src="https://cdn.jsdelivr.net/npm/mk-sdk-git@1/dist/mk-sdk.js"
13
16
  data-mk-project="SEU_PROJECT_ID"
14
17
  data-mk-product="mk-fashion"
15
18
  async></script>
@@ -18,6 +21,27 @@ Uma linha antes de `</head>`, em todas as páginas:
18
21
  - `data-mk-project` — ID do projeto (obrigatório).
19
22
  - `data-mk-product` — produto MetaKosmos da página (`mk-fashion`, `mk-beauty`,
20
23
  `mk-3d`…). Opcional; default `mk-fashion`.
24
+ - `async` — não bloqueia o carregamento da página.
25
+
26
+ ### Versão do CDN
27
+
28
+ | Forma | URL | Quando usar |
29
+ |---|---|---|
30
+ | **Major fixo** (recomendado) | `…/mk-sdk-git@1/dist/mk-sdk.js` | Pega o último `1.x.y` automaticamente — recebe correções sem quebrar |
31
+ | **Versão exata** | `…/mk-sdk-git@1.2.3/dist/mk-sdk.js` | Trava numa versão específica (imutável) |
32
+ | **unpkg** (alternativa) | `https://unpkg.com/mk-sdk-git@1/dist/mk-sdk.js` | Mesmo pacote, outro CDN |
33
+
34
+ > Evite `@latest` em produção: cache fraco e risco de um release novo quebrar a
35
+ > loja sem aviso. Prefira o major fixo (`@1`).
36
+
37
+ ### Via bundler (opcional)
38
+
39
+ ```bash
40
+ npm install mk-sdk-git
41
+ ```
42
+ O SDK é um IIFE auto-executável feito pra `<script>`. Num bundler, importe e
43
+ garanta que `window.__MK = { projectId, product }` esteja definido antes do
44
+ import (não há tag `<script>` pra ler os `data-*`).
21
45
 
22
46
  ## Configuração
23
47
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mk-sdk-git",
3
- "version": "0.1.0",
3
+ "version": "1.0.0",
4
4
  "description": "SDK de tracking de e-commerce + try-on da MetaKosmos (core tracker, roda em todas as páginas)",
5
5
  "main": "dist/mk-sdk.js",
6
6
  "files": [