@neetru/sdk 3.0.1 → 3.1.0

package/dist/index.d.cts

@@ -1,7 +1,6 @@
 export { createNeetruClient } from './auth.cjs';
 export { NeetruError, NeetruErrorCode } from './errors.cjs';
-export { A as AuthNamespace, a as AuthStateListener, C as CatalogListOptions, b as CatalogListResponse, c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, i as CreateTicketInput, D as DEFAULT_BASE_URL, j as DbNamespace, k as DbSqlLease, l as DbWhereFilter, E as EntitlementCheck, L as ListNotificationsOptions, M as MockCheckout, m as MockNotifications, n as MockWebhooks, N as NeetruClient, o as NeetruClientConfig, p as NeetruDb, q as NeetruDbEngine, r as NeetruDbError, s as NeetruDbErrorCode, t as NeetruDbOptions, u as NeetruDbTransport, v as NeetruEnv, w as NeetruSqlClient, x as NeetruUser, y as NotificationScopeOptions, z as NotificationsNamespace, P as Product, B as ProductNotification, F as ProductNotificationSeverity, G as ProductPlan, H as ProductStatus, R as RegisterWebhookInput, I as ResolvedConfig, S as SendNotificationInput, J as SignInOptions, O as SupportNamespace, Q as SupportSeverity, T as SupportStatus, U as SupportTicket, V as TelemetryEventAck, W as TelemetryEventInput, Z as UsageEventInput, _ as UsageNamespace, $ as UsageQuota, a0 as VerifyTokenOptions, a1 as WebhookEndpoint, a2 as WebhookEvent, a3 as WebhookScopeOptions, a4 as WebhookTestResult, a5 as WebhooksNamespace, a6 as createCheckoutNamespace, a7 as createNeetruDb, a8 as createNotificationsNamespace, aa as createWebhooksNamespace, ac as verifyWebhookSignature } from './types-Lfd3LiAF.cjs';
-export { D as DbBatchOp, b as DbChangeType, c as DbCollectionRef, d as DbDoc, e as DbDocRef, f as DbGetResult, g as DbListResult, h as DbQuery } from './collection-ref-DqAAhuhX.cjs';
+export { A as AuthNamespace, a as AuthStateListener, C as CatalogListOptions, b as CatalogListResponse, c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, k as CreateTicketInput, D as DEFAULT_BASE_URL, l as DbBatchOp, m as DbChangeType, n as DbCollectionRef, o as DbDoc, p as DbDocRef, q as DbGetResult, r as DbListResult, s as DbNamespace, t as DbQuery, u as DbSqlLease, v as DbWhereFilter, E as EntitlementCheck, F as FieldSentinel, I as IncrementSentinel, L as ListNotificationsOptions, M as MockCheckout, x as MockNotifications, y as MockWebhooks, N as NEETRU_SENTINEL_KEY, z as NeetruClient, B as NeetruClientConfig, G as NeetruDb, J as NeetruDbEngine, K as NeetruDbError, O as NeetruDbErrorCode, P as NeetruDbOptions, Q as NeetruDbTransport, R as NeetruEnv, S as NeetruSqlClient, T as NeetruUser, U as NotificationScopeOptions, V as NotificationsNamespace, W as Product, X as ProductNotification, Y as ProductNotificationSeverity, Z as ProductPlan, _ as ProductStatus, a0 as RegisterWebhookInput, a1 as ResolvedConfig, a2 as SendNotificationInput, a3 as ServerTimestampSentinel, a4 as SignInOptions, a6 as SupportNamespace, a7 as SupportSeverity, a8 as SupportStatus, a9 as SupportTicket, ab as TelemetryEventAck, ac as TelemetryEventInput, ag as UsageEventInput, ah as UsageNamespace, ai as UsageQuota, aj as VerifyTokenOptions, ak as WebhookEndpoint, al as WebhookEvent, am as WebhookScopeOptions, an as WebhookTestResult, ao as WebhooksNamespace, ap as WithFieldSentinels, aq as createCheckoutNamespace, ar as createNeetruDb, as as createNotificationsNamespace, au as createWebhooksNamespace, aw as increment, ax as isFieldSentinel, ay as isIncrementSentinel, az as isServerTimestampSentinel, aA as serverTimestamp, aB as verifyWebhookSignature } from './types-nwErcRX8.cjs';
 export { DEV_FIXTURE_USER, MockAuth, MockDb, MockEntitlements, MockSupport, MockUsage } from './mocks.cjs';
 import 'drizzle-orm/node-postgres';
 
@@ -37,6 +36,6 @@ import 'drizzle-orm/node-postgres';
  */
 
 /** Versão do SDK — exportada explicitamente pra detecção em runtime. */
-declare const VERSION: "3.0.1";
+declare const VERSION: "3.1.0";
 
 export { VERSION };

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 export { createNeetruClient } from './auth.js';
 export { NeetruError, NeetruErrorCode } from './errors.js';
-export { A as AuthNamespace, a as AuthStateListener, C as CatalogListOptions, b as CatalogListResponse, c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, i as CreateTicketInput, D as DEFAULT_BASE_URL, j as DbNamespace, k as DbSqlLease, l as DbWhereFilter, E as EntitlementCheck, L as ListNotificationsOptions, M as MockCheckout, m as MockNotifications, n as MockWebhooks, N as NeetruClient, o as NeetruClientConfig, p as NeetruDb, q as NeetruDbEngine, r as NeetruDbError, s as NeetruDbErrorCode, t as NeetruDbOptions, u as NeetruDbTransport, v as NeetruEnv, w as NeetruSqlClient, x as NeetruUser, y as NotificationScopeOptions, z as NotificationsNamespace, P as Product, B as ProductNotification, F as ProductNotificationSeverity, G as ProductPlan, H as ProductStatus, R as RegisterWebhookInput, I as ResolvedConfig, S as SendNotificationInput, J as SignInOptions, O as SupportNamespace, Q as SupportSeverity, T as SupportStatus, U as SupportTicket, V as TelemetryEventAck, W as TelemetryEventInput, Z as UsageEventInput, _ as UsageNamespace, $ as UsageQuota, a0 as VerifyTokenOptions, a1 as WebhookEndpoint, a2 as WebhookEvent, a3 as WebhookScopeOptions, a4 as WebhookTestResult, a5 as WebhooksNamespace, a6 as createCheckoutNamespace, a7 as createNeetruDb, a8 as createNotificationsNamespace, aa as createWebhooksNamespace, ac as verifyWebhookSignature } from './types-DALIhcbq.js';
-export { D as DbBatchOp, b as DbChangeType, c as DbCollectionRef, d as DbDoc, e as DbDocRef, f as DbGetResult, g as DbListResult, h as DbQuery } from './collection-ref-DqAAhuhX.js';
+export { A as AuthNamespace, a as AuthStateListener, C as CatalogListOptions, b as CatalogListResponse, c as CheckoutIntentInfo, d as CheckoutIntentStatus, e as CheckoutNamespace, f as CheckoutStartInput, g as CheckoutStartResult, h as CheckoutTenantType, k as CreateTicketInput, D as DEFAULT_BASE_URL, l as DbBatchOp, m as DbChangeType, n as DbCollectionRef, o as DbDoc, p as DbDocRef, q as DbGetResult, r as DbListResult, s as DbNamespace, t as DbQuery, u as DbSqlLease, v as DbWhereFilter, E as EntitlementCheck, F as FieldSentinel, I as IncrementSentinel, L as ListNotificationsOptions, M as MockCheckout, x as MockNotifications, y as MockWebhooks, N as NEETRU_SENTINEL_KEY, z as NeetruClient, B as NeetruClientConfig, G as NeetruDb, J as NeetruDbEngine, K as NeetruDbError, O as NeetruDbErrorCode, P as NeetruDbOptions, Q as NeetruDbTransport, R as NeetruEnv, S as NeetruSqlClient, T as NeetruUser, U as NotificationScopeOptions, V as NotificationsNamespace, W as Product, X as ProductNotification, Y as ProductNotificationSeverity, Z as ProductPlan, _ as ProductStatus, a0 as RegisterWebhookInput, a1 as ResolvedConfig, a2 as SendNotificationInput, a3 as ServerTimestampSentinel, a4 as SignInOptions, a6 as SupportNamespace, a7 as SupportSeverity, a8 as SupportStatus, a9 as SupportTicket, ab as TelemetryEventAck, ac as TelemetryEventInput, ag as UsageEventInput, ah as UsageNamespace, ai as UsageQuota, aj as VerifyTokenOptions, ak as WebhookEndpoint, al as WebhookEvent, am as WebhookScopeOptions, an as WebhookTestResult, ao as WebhooksNamespace, ap as WithFieldSentinels, aq as createCheckoutNamespace, ar as createNeetruDb, as as createNotificationsNamespace, au as createWebhooksNamespace, aw as increment, ax as isFieldSentinel, ay as isIncrementSentinel, az as isServerTimestampSentinel, aA as serverTimestamp, aB as verifyWebhookSignature } from './types-BRv8wBxX.js';
 export { DEV_FIXTURE_USER, MockAuth, MockDb, MockEntitlements, MockSupport, MockUsage } from './mocks.js';
 import 'drizzle-orm/node-postgres';
 
@@ -37,6 +36,6 @@ import 'drizzle-orm/node-postgres';
  */
 
 /** Versão do SDK — exportada explicitamente pra detecção em runtime. */
-declare const VERSION: "3.0.1";
+declare const VERSION: "3.1.0";
 
 export { VERSION };

package/dist/index.mjs

@@ -2041,7 +2041,71 @@ var MutationQueue = class {
   }
 };
 
+// src/db/field-value.ts
+var NEETRU_SENTINEL_KEY = "__neetru__";
+function serverTimestamp() {
+  return { __neetru__: "serverTimestamp" };
+}
+function increment(n) {
+  if (typeof n !== "number" || !Number.isFinite(n)) {
+    throw new TypeError(
+      `increment(n): n deve ser um n\xFAmero finito (recebido: ${String(n)}).`
+    );
+  }
+  return { __neetru__: "increment", operand: n };
+}
+function isFieldSentinel(v) {
+  return typeof v === "object" && v !== null && NEETRU_SENTINEL_KEY in v && typeof v[NEETRU_SENTINEL_KEY] === "string";
+}
+function isServerTimestampSentinel(v) {
+  return isFieldSentinel(v) && v.__neetru__ === "serverTimestamp";
+}
+function isIncrementSentinel(v) {
+  return isFieldSentinel(v) && v.__neetru__ === "increment" && typeof v.operand === "number" && Number.isFinite(v.operand);
+}
+function resolveSentinelLocally(value, baseValue) {
+  if (isServerTimestampSentinel(value)) {
+    return Date.now();
+  }
+  if (isIncrementSentinel(value)) {
+    const base = typeof baseValue === "number" && Number.isFinite(baseValue) ? baseValue : 0;
+    return base + value.operand;
+  }
+  return value;
+}
+function resolveSentinelsLocally(data, existing) {
+  let touched = false;
+  const out = {};
+  for (const [k, v] of Object.entries(data)) {
+    if (isFieldSentinel(v)) {
+      touched = true;
+      out[k] = resolveSentinelLocally(v, existing?.[k]);
+    } else {
+      out[k] = v;
+    }
+  }
+  return touched ? out : data;
+}
+function hasFieldSentinel(data) {
+  for (const v of Object.values(data)) {
+    if (isFieldSentinel(v)) return true;
+  }
+  return false;
+}
+
 // src/db/offline/sync-engine.ts
+function hasSentinels(payload) {
+  return payload !== null && hasFieldSentinel(payload);
+}
+function sanitizeSentinelPayload(payload) {
+  if (payload === null) return null;
+  if (!hasFieldSentinel(payload)) return payload;
+  const out = {};
+  for (const [k, v] of Object.entries(payload)) {
+    if (!isFieldSentinel(v)) out[k] = v;
+  }
+  return out;
+}
 var SyncEngine = class {
   _store;
   _queue;
@@ -2229,7 +2293,7 @@ var SyncEngine = class {
     return true;
   }
   /** Atualiza o cache após confirmação de escrita (outcome=confirmed). */
-  async _applySyncedDoc(collection, docId, serverVersion, serverTimestamp, mut, busChanges) {
+  async _applySyncedDoc(collection, docId, serverVersion, serverTimestamp2, mut, busChanges) {
     const existing = await this._store.getDoc(collection, docId);
     if (mut.op === "remove") {
       if (existing) {
@@ -2238,7 +2302,7 @@ var SyncEngine = class {
           meta: {
             ...existing.meta,
             serverVersion,
-            updatedAtServer: serverTimestamp,
+            updatedAtServer: serverTimestamp2,
             updatedAtLocal: Date.now(),
             state: "synced",
             deleted: true,
@@ -2249,14 +2313,19 @@ var SyncEngine = class {
       }
       return;
     }
-    const newData = mut.payload ?? (existing?.data ?? {});
+    const literalPayload = sanitizeSentinelPayload(mut.payload);
+    const newData = literalPayload ?? (existing?.data ?? {});
     const updatedDoc = {
       collection,
       id: docId,
-      data: mut.op === "update" ? { ...existing?.data ?? {}, ...newData } : newData,
+      data: mut.op === "update" ? { ...existing?.data ?? {}, ...newData } : (
+        // add/set: se o payload tinha sentinels, o cache otimista (existing.data)
+        // é a fonte de verdade até o pull; senão usa o payload literal.
+        hasSentinels(mut.payload) ? { ...existing?.data ?? {}, ...newData } : newData
+      ),
       meta: {
         serverVersion,
-        updatedAtServer: serverTimestamp,
+        updatedAtServer: serverTimestamp2,
         updatedAtLocal: Date.now(),
         state: "synced",
         pendingMutationIds: [],
@@ -3463,10 +3532,12 @@ var DbCollectionRefImpl = class {
     return this._buildListResult(q);
   }
   async add(data) {
+    const rawData = data;
+    const localData = resolveSentinelsLocally(rawData, void 0);
     const mutation = await this._queue.enqueue({
       collection: this._collection,
       op: "add",
-      payload: data,
+      payload: rawData,
       baseVersion: null,
       batchId: null
     });
@@ -3474,7 +3545,7 @@ var DbCollectionRefImpl = class {
     await this._store.putDoc({
       collection: this._collection,
       id: docId,
-      data,
+      data: localData,
       meta: {
         serverVersion: null,
         updatedAtServer: null,
@@ -3488,25 +3559,27 @@ var DbCollectionRefImpl = class {
     this._bus.emit([{
       type: "added",
       collection: this._collection,
-      doc: { id: docId, data }
+      doc: { id: docId, data: localData }
     }]);
     return { ok: true, id: docId };
   }
   async set(id, data) {
     assertValidId(id);
     const existing = await this._store.getDoc(this._collection, id);
+    const rawData = data;
+    const localData = resolveSentinelsLocally(rawData, void 0);
     const mutation = await this._queue.enqueue({
       collection: this._collection,
       docId: id,
       op: "set",
-      payload: data,
+      payload: rawData,
       baseVersion: existing?.meta.serverVersion ?? null,
       batchId: null
     });
     await this._store.putDoc({
       collection: this._collection,
       id,
-      data,
+      data: localData,
       meta: {
         serverVersion: existing?.meta.serverVersion ?? null,
         updatedAtServer: existing?.meta.updatedAtServer ?? null,
@@ -3520,19 +3593,22 @@ var DbCollectionRefImpl = class {
     this._bus.emit([{
       type: existing && !existing.meta.deleted ? "modified" : "added",
       collection: this._collection,
-      doc: { id, data }
+      doc: { id, data: localData }
     }]);
     return { ok: true };
   }
   async update(id, data) {
     assertValidId(id);
     const existing = await this._store.getDoc(this._collection, id);
-    const mergedData = existing?.meta.deleted ? { ...data } : { ...existing?.data ?? {}, ...data };
+    const rawData = data;
+    const existingBase = existing?.meta.deleted ? void 0 : existing?.data;
+    const localData = resolveSentinelsLocally(rawData, existingBase);
+    const mergedData = existing?.meta.deleted ? { ...localData } : { ...existing?.data ?? {}, ...localData };
     const mutation = await this._queue.enqueue({
       collection: this._collection,
       docId: id,
       op: "update",
-      payload: data,
+      payload: rawData,
       baseVersion: existing?.meta.serverVersion ?? null,
       batchId: null
     });
@@ -3589,6 +3665,7 @@ var DbCollectionRefImpl = class {
       const collection = this._collection;
       if (op.kind === "add") {
         const data = op.data;
+        const localData = resolveSentinelsLocally(data, void 0);
         const mutation = await this._queue.enqueue({
           collection,
           op: "add",
@@ -3600,7 +3677,7 @@ var DbCollectionRefImpl = class {
         await this._store.putDoc({
           collection,
           id: docId,
-          data,
+          data: localData,
           meta: {
             serverVersion: null,
             updatedAtServer: null,
@@ -3611,11 +3688,12 @@ var DbCollectionRefImpl = class {
             ownerId: null
           }
         });
-        busChanges.push({ type: "added", collection, doc: { id: docId, data } });
+        busChanges.push({ type: "added", collection, doc: { id: docId, data: localData } });
       } else if (op.kind === "set") {
         const id = op.id;
         const data = op.data;
         const existing = await this._store.getDoc(collection, id);
+        const localData = resolveSentinelsLocally(data, void 0);
         const mutation = await this._queue.enqueue({
           collection,
           docId: id,
@@ -3627,7 +3705,7 @@ var DbCollectionRefImpl = class {
         await this._store.putDoc({
           collection,
           id,
-          data,
+          data: localData,
           meta: {
             serverVersion: existing?.meta.serverVersion ?? null,
             updatedAtServer: existing?.meta.updatedAtServer ?? null,
@@ -3641,13 +3719,15 @@ var DbCollectionRefImpl = class {
         busChanges.push({
           type: existing && !existing.meta.deleted ? "modified" : "added",
           collection,
-          doc: { id, data }
+          doc: { id, data: localData }
         });
       } 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 existingBase = existing?.meta.deleted ? void 0 : existing?.data;
+        const localData = resolveSentinelsLocally(data, existingBase);
+        const merged = { ...existing?.data ?? {}, ...localData };
         const mutation = await this._queue.enqueue({
           collection,
           docId: id,
@@ -6081,8 +6161,8 @@ function createNeetruClient(config = {}) {
 // src/index.ts
 init_errors();
 init_db_errors();
-var VERSION = "3.0.1";
+var VERSION = "3.1.0";
 
-export { DEFAULT_BASE_URL, DEV_FIXTURE_USER, MockAuth, MockCheckout, MockDb, MockEntitlements, MockNotifications, MockSupport, MockUsage, MockWebhooks, NeetruDbError, NeetruError, VERSION, createCheckoutNamespace, createNeetruClient, createNeetruDb, createNotificationsNamespace, createWebhooksNamespace, verifyWebhookSignature };
+export { DEFAULT_BASE_URL, DEV_FIXTURE_USER, MockAuth, MockCheckout, MockDb, MockEntitlements, MockNotifications, MockSupport, MockUsage, MockWebhooks, NEETRU_SENTINEL_KEY, NeetruDbError, NeetruError, VERSION, createCheckoutNamespace, createNeetruClient, createNeetruDb, createNotificationsNamespace, createWebhooksNamespace, increment, isFieldSentinel, isIncrementSentinel, isServerTimestampSentinel, serverTimestamp, verifyWebhookSignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map