@neetru/sdk 2.1.0 → 2.1.1

package/dist/catalog.d.cts

@@ -1,5 +1,5 @@
-import { G as ResolvedConfig, C as CatalogListOptions, b as CatalogListResponse, P as Product } from './types-Kmt4y1FQ.cjs';
-import './collection-ref-BBvTTXoG.cjs';
+import { G as ResolvedConfig, C as CatalogListOptions, b as CatalogListResponse, P as Product } from './types-Cfb-qeDg.cjs';
+import './collection-ref-DqAAhuhX.cjs';
 import '@neetru/realtime-protocol';
 import 'drizzle-orm/node-postgres';
 import './errors.cjs';

package/dist/catalog.d.ts

@@ -1,5 +1,5 @@
-import { G as ResolvedConfig, C as CatalogListOptions, b as CatalogListResponse, P as Product } from './types-B1jylbMC.js';
-import './collection-ref-BBvTTXoG.js';
+import { G as ResolvedConfig, C as CatalogListOptions, b as CatalogListResponse, P as Product } from './types-V1EfjR1p.js';
+import './collection-ref-DqAAhuhX.js';
 import '@neetru/realtime-protocol';
 import 'drizzle-orm/node-postgres';
 import './errors.js';

package/dist/checkout.d.cts

@@ -1,5 +1,5 @@
-export { c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, M as MockCheckout, a2 as createCheckoutNamespace } from './types-Kmt4y1FQ.cjs';
-import './collection-ref-BBvTTXoG.cjs';
+export { c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, M as MockCheckout, a2 as createCheckoutNamespace } from './types-Cfb-qeDg.cjs';
+import './collection-ref-DqAAhuhX.cjs';
 import '@neetru/realtime-protocol';
 import 'drizzle-orm/node-postgres';
 import './errors.cjs';

package/dist/checkout.d.ts

@@ -1,5 +1,5 @@
-export { c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, M as MockCheckout, a2 as createCheckoutNamespace } from './types-B1jylbMC.js';
-import './collection-ref-BBvTTXoG.js';
+export { c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, M as MockCheckout, a2 as createCheckoutNamespace } from './types-V1EfjR1p.js';
+import './collection-ref-DqAAhuhX.js';
 import '@neetru/realtime-protocol';
 import 'drizzle-orm/node-postgres';
 import './errors.js';

package/dist/{collection-ref-BBvTTXoG.d.cts → collection-ref-DqAAhuhX.d.cts}

@@ -293,12 +293,43 @@ interface DbGetResult<T = Record<string, unknown>> {
     }>;
 }
 type DbChangeType = 'added' | 'modified' | 'removed';
-interface DbBatchOp {
-    op: 'add' | 'set' | 'update' | 'remove';
-    collection: string;
-    id?: string;
-    data?: Record<string, unknown>;
-}
+/**
+ * Operação atômica para uso em `DbCollectionRef.batch()`.
+ *
+ * Discriminated union pelo campo `kind` — cada variante deixa claro
+ * quais campos são obrigatórios:
+ *
+ * - `add`    — insere com id gerado pelo cliente; `data` obrigatório.
+ * - `set`    — cria ou sobrescreve pelo `id`; `data` obrigatório.
+ * - `update` — mescla campos em doc existente pelo `id`; `data` obrigatório.
+ * - `remove` — tombstone pelo `id`; sem `data`.
+ *
+ * @example
+ * ```ts
+ * const ops: DbBatchOp[] = [
+ *   { kind: 'add',    data: { name: 'produto A', price: 10 } },
+ *   { kind: 'set',    id: 'sku-1', data: { name: 'produto B', price: 20 } },
+ *   { kind: 'update', id: 'sku-2', data: { price: 25 } },
+ *   { kind: 'remove', id: 'sku-3' },
+ * ];
+ * await col.batch(ops);
+ * ```
+ */
+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;
+};
 /**
  * Contrato do transporte de realtime — injetado no namespace.
  *
@@ -313,8 +344,26 @@ type RealtimeTransport = SyncTransport;
 /**
  * Referência a um documento específico.
  * Parte da superfície `DbCollectionRef.doc(id)`.
+ *
+ * Expõe as propriedades de identidade do documento de forma análoga ao
+ * `DocumentReference` do Firestore SDK, evitando a necessidade de adaptadores
+ * externos que reattachavam `collection` + `id` manualmente.
+ *
+ * @example
+ * ```ts
+ * const ref = orders.doc('order-123');
+ * console.log(ref.id);         // "order-123"
+ * console.log(ref.collection); // "orders"
+ * console.log(ref.path);       // "orders/order-123"
+ * ```
  */
 interface DbDocRef<T = Record<string, unknown>> {
+    /** ID do documento dentro da coleção. */
+    readonly id: string;
+    /** Caminho completo no formato "collection/docId". */
+    readonly path: string;
+    /** Nome da coleção parent. */
+    readonly collection: string;
     get(): Promise<DbGetResult<T> | null>;
     set(data: Omit<T, 'id'>): Promise<{
         ok: true;
@@ -355,7 +404,7 @@ interface DbCollectionRef<T = Record<string, unknown>> {
         ok: true;
     }>;
     /** Aplica múltiplas operações atomicamente na fila. */
-    batch(ops: DbBatchOp[]): Promise<{
+    batch(ops: DbBatchOp<T>[]): Promise<{
         ok: true;
     }>;
     /** Escuta um documento específico. */

package/dist/{collection-ref-BBvTTXoG.d.ts → collection-ref-DqAAhuhX.d.ts}

@@ -293,12 +293,43 @@ interface DbGetResult<T = Record<string, unknown>> {
     }>;
 }
 type DbChangeType = 'added' | 'modified' | 'removed';
-interface DbBatchOp {
-    op: 'add' | 'set' | 'update' | 'remove';
-    collection: string;
-    id?: string;
-    data?: Record<string, unknown>;
-}
+/**
+ * Operação atômica para uso em `DbCollectionRef.batch()`.
+ *
+ * Discriminated union pelo campo `kind` — cada variante deixa claro
+ * quais campos são obrigatórios:
+ *
+ * - `add`    — insere com id gerado pelo cliente; `data` obrigatório.
+ * - `set`    — cria ou sobrescreve pelo `id`; `data` obrigatório.
+ * - `update` — mescla campos em doc existente pelo `id`; `data` obrigatório.
+ * - `remove` — tombstone pelo `id`; sem `data`.
+ *
+ * @example
+ * ```ts
+ * const ops: DbBatchOp[] = [
+ *   { kind: 'add',    data: { name: 'produto A', price: 10 } },
+ *   { kind: 'set',    id: 'sku-1', data: { name: 'produto B', price: 20 } },
+ *   { kind: 'update', id: 'sku-2', data: { price: 25 } },
+ *   { kind: 'remove', id: 'sku-3' },
+ * ];
+ * await col.batch(ops);
+ * ```
+ */
+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;
+};
 /**
  * Contrato do transporte de realtime — injetado no namespace.
  *
@@ -313,8 +344,26 @@ type RealtimeTransport = SyncTransport;
 /**
  * Referência a um documento específico.
  * Parte da superfície `DbCollectionRef.doc(id)`.
+ *
+ * Expõe as propriedades de identidade do documento de forma análoga ao
+ * `DocumentReference` do Firestore SDK, evitando a necessidade de adaptadores
+ * externos que reattachavam `collection` + `id` manualmente.
+ *
+ * @example
+ * ```ts
+ * const ref = orders.doc('order-123');
+ * console.log(ref.id);         // "order-123"
+ * console.log(ref.collection); // "orders"
+ * console.log(ref.path);       // "orders/order-123"
+ * ```
  */
 interface DbDocRef<T = Record<string, unknown>> {
+    /** ID do documento dentro da coleção. */
+    readonly id: string;
+    /** Caminho completo no formato "collection/docId". */
+    readonly path: string;
+    /** Nome da coleção parent. */
+    readonly collection: string;
     get(): Promise<DbGetResult<T> | null>;
     set(data: Omit<T, 'id'>): Promise<{
         ok: true;
@@ -355,7 +404,7 @@ interface DbCollectionRef<T = Record<string, unknown>> {
         ok: true;
     }>;
     /** Aplica múltiplas operações atomicamente na fila. */
-    batch(ops: DbBatchOp[]): Promise<{
+    batch(ops: DbBatchOp<T>[]): Promise<{
         ok: true;
     }>;
     /** Escuta um documento específico. */

package/dist/db-react.d.cts

@@ -1,4 +1,4 @@
-import { S as SyncState, U as Unsubscribe, d as DbDoc, c as DbCollectionRef, h as DbQuery } from './collection-ref-BBvTTXoG.cjs';
+import { S as SyncState, U as Unsubscribe, d as DbDoc, c as DbCollectionRef, h as DbQuery } from './collection-ref-DqAAhuhX.cjs';
 
 /**
  * Resultado de `useDocument`.

package/dist/db-react.d.ts

@@ -1,4 +1,4 @@
-import { S as SyncState, U as Unsubscribe, d as DbDoc, c as DbCollectionRef, h as DbQuery } from './collection-ref-BBvTTXoG.js';
+import { S as SyncState, U as Unsubscribe, d as DbDoc, c as DbCollectionRef, h as DbQuery } from './collection-ref-DqAAhuhX.js';
 
 /**
  * Resultado de `useDocument`.

package/dist/db.cjs

@@ -2377,10 +2377,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",
@@ -2404,7 +2403,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,
@@ -2433,7 +2434,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({
@@ -2462,7 +2465,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,
@@ -2571,6 +2575,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);
       },
@@ -3707,6 +3720,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();
         },