@neetru/sdk 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -7,11 +7,63 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Planned (post-2.0)
+### Planned (post-2.1)
 - size-limit budget no CI (<12KB gz core com db namespace).
 - CDN distribution (`cdn.neetru.com/sdk/v2/`).
 - Endpoint batch `/api/v1/sdk/telemetry/batch` (substitui drenagem N×1 do `track()` por 1 request).
 
+## [2.1.1] - 2026-05-25 — **DbDocRef identity + DbBatchOp discriminated union [patch]**
+
+Dois fixes LOW reportados por pdv-agiliza (tickets `bug_97b3f0488d1c49cf8c5f94e5d544289b` + `bug_6aab9adc182640218652a65cdcb71b63`).
+Sem breaking changes — todos os usos de `doc()` existentes continuam funcionando.
+
+### Fixed
+
+- **`DbDocRef.id / .path / .collection`** (fix #13, ticket `bug_97b3f0488d1c49cf8c5f94e5d544289b`):
+  `DbDocRef` agora expõe três propriedades readonly de identidade:
+  - `id: string` — ID do documento dentro da coleção.
+  - `path: string` — Caminho completo `"colecao/docId"`.
+  - `collection: string` — Nome da coleção parent.
+  Análogo ao `DocumentReference.id/.path` do Firestore Web SDK. Elimina a necessidade
+  de adaptadores externos que reattachavam `collection + id` manualmente.
+  Implementado em `DbCollectionRefImpl.doc()` (offline), `createLazyCollectionRef.doc()`
+  (client-db) e `MockDb.doc()` (mocks).
+
+- **`DbBatchOp` discriminated union** (fix #14, ticket `bug_6aab9adc182640218652a65cdcb71b63`):
+  `DbBatchOp` foi convertido de `interface` opaca (campo `op: 'add'|'set'|'update'|'remove'`
+  com `id?`/`data?` opcionais) para **discriminated union** pelo campo `kind`:
+  ```ts
+  type DbBatchOp<T = Record<string, unknown>> =
+    | { kind: 'add';    data: Omit<T, 'id'> }
+    | { kind: 'set';    id: string; data: Omit<T, 'id'> }
+    | { kind: 'update'; id: string; data: Partial<Omit<T, 'id'>> }
+    | { kind: 'remove'; id: string };
+  ```
+  O `.d.ts` público agora expõe claramente quais campos são obrigatórios por variante.
+  O campo `collection` foi removido da operação (sempre opera na coleção do `DbCollectionRef`).
+
+### Migration (2.0.0 → 2.1.1)
+
+Callers que usavam `batch()` devem trocar `op` por `kind` e remover o campo `collection`:
+
+```ts
+// antes (2.0.0)
+col.batch([
+  { op: 'add',    collection: 'orders', data: { total: 10 } },
+  { op: 'set',    collection: 'orders', id: 'x', data: { total: 20 } },
+  { op: 'update', collection: 'orders', id: 'y', data: { total: 30 } },
+  { op: 'remove', collection: 'orders', id: 'z' },
+]);
+
+// depois (2.1.1)
+col.batch([
+  { kind: 'add',    data: { total: 10 } },
+  { kind: 'set',    id: 'x', data: { total: 20 } },
+  { kind: 'update', id: 'y', data: { total: 30 } },
+  { kind: 'remove', id: 'z' },
+]);
+```
+
 ## [2.0.0] - 2026-05-22 — **client.db NeetruDb (Documentos engine-aware + SQL) [M2]**
 
 Major bump — breaking changes no namespace `db`. Liga todos os building blocks M2 na superfície pública.

package/dist/auth.cjs

@@ -2956,10 +2956,9 @@ var DbCollectionRefImpl = class {
     const batchId = `batch-${Date.now()}-${Math.random().toString(36).slice(2)}`;
     const busChanges = [];
     for (const op of ops) {
-      const id = op.id ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
-      const data = op.data ?? {};
-      const collection = op.collection;
-      if (op.op === "add") {
+      const collection = this._collection;
+      if (op.kind === "add") {
+        const data = op.data;
         const mutation = await this._queue.enqueue({
           collection,
           op: "add",
@@ -2983,7 +2982,9 @@ var DbCollectionRefImpl = class {
           }
         });
         busChanges.push({ type: "added", collection, doc: { id: docId, data } });
-      } else if (op.op === "set") {
+      } else if (op.kind === "set") {
+        const id = op.id;
+        const data = op.data;
         const existing = await this._store.getDoc(collection, id);
         const mutation = await this._queue.enqueue({
           collection,
@@ -3012,7 +3013,9 @@ var DbCollectionRefImpl = class {
           collection,
           doc: { id, data }
         });
-      } else if (op.op === "update") {
+      } else if (op.kind === "update") {
+        const id = op.id;
+        const data = op.data;
         const existing = await this._store.getDoc(collection, id);
         const merged = { ...existing?.data ?? {}, ...data };
         const mutation = await this._queue.enqueue({
@@ -3041,7 +3044,8 @@ var DbCollectionRefImpl = class {
           }
         });
         busChanges.push({ type: "modified", collection, doc: { id, data: merged } });
-      } else if (op.op === "remove") {
+      } else if (op.kind === "remove") {
+        const id = op.id;
         const existing = await this._store.getDoc(collection, id);
         await this._queue.enqueue({
           collection,
@@ -3150,6 +3154,15 @@ var DbCollectionRefImpl = class {
     assertValidId(id);
     const self = this;
     return {
+      get id() {
+        return id;
+      },
+      get path() {
+        return `${self._collection}/${id}`;
+      },
+      get collection() {
+        return self._collection;
+      },
       async get() {
         return self._buildGetResult(id);
       },
@@ -4283,6 +4296,15 @@ function createLazyCollectionRef(name, getDocsPromise) {
     },
     doc(id) {
       return {
+        get id() {
+          return id;
+        },
+        get path() {
+          return `${name}/${id}`;
+        },
+        get collection() {
+          return name;
+        },
         async get() {
           return (await getRef()).doc(id).get();
         },