@neetru/sdk 3.3.0 → 3.4.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 export { createNeetruClient } from './auth.cjs';
 export { NeetruError, NeetruErrorCode } from './errors.cjs';
-export { A as AiChatChoice, a as AiChatMessage, b as AiChatOptions, c as AiChatResult, d as AiChatUsage, e as AiContentPart, f as AiImageUrlPart, g as AiNamespace, h as AiResponseFormat, i as AiStreamHandle, j as AiStreamMeta, k as AiTextPart, l as AuthNamespace, m as AuthStateListener, C as CatalogListOptions, n as CatalogListResponse, p as CheckoutIntentInfo, q as CheckoutIntentStatus, r as CheckoutNamespace, s as CheckoutStartInput, t as CheckoutStartResult, u as CheckoutTenantType, v as CompleteSignInResult, y as CreateTicketInput, D as DEFAULT_BASE_URL, z as DbBatchOp, B as DbChangeType, E as DbCollectionRef, F as DbDoc, G as DbDocRef, H as DbGetResult, I as DbListResult, J as DbNamespace, K as DbQuery, L as DbSqlLease, M as DbWhereFilter, O as EntitlementCheck, P as FieldSentinel, Q as IncrementSentinel, R as ListNotificationsOptions, S as MockCheckout, T as MockNotifications, U as MockWebhooks, V as NEETRU_SENTINEL_KEY, W as NeetruClient, X as NeetruClientConfig, Y as NeetruDb, _ as NeetruDbEngine, $ as NeetruDbError, a0 as NeetruDbErrorCode, a1 as NeetruDbOptions, a2 as NeetruDbTransport, a3 as NeetruEnv, a4 as NeetruSqlClient, a5 as NeetruUser, a6 as NotificationScopeOptions, a7 as NotificationsNamespace, a8 as Product, a9 as ProductNotification, aa as ProductNotificationSeverity, ab as ProductPlan, ac as ProductStatus, ae as RedirectCallbackResult, af as RegisterWebhookInput, ag as ResolvedConfig, ah as SendNotificationInput, ai as ServerTimestampSentinel, aj as SignInOptions, al as SupportNamespace, am as SupportSeverity, an as SupportStatus, ao as SupportTicket, aq as TelemetryEventAck, ar as TelemetryEventInput, av as UsageEventInput, aw as UsageNamespace, ax as UsageQuota, ay as VerifyTokenOptions, az as VerifyWebhookRequestOptions, aA as VerifyWebhookRequestResult, aB as WebhookEndpoint, aC as WebhookEvent, aD as WebhookScopeOptions, aE as WebhookTestResult, aF as WebhooksNamespace, aG as WithFieldSentinels, aH as createAiNamespace, aI as createCheckoutNamespace, aJ as createNeetruDb, aK as createNotificationsNamespace, aM as createWebhooksNamespace, aO as increment, aP as isFieldSentinel, aQ as isIncrementSentinel, aR as isServerTimestampSentinel, aS as serverTimestamp, aT as verifyWebhookRequest, aU as verifyWebhookSignature } from './types-DQplLXIk.cjs';
+export { A as AiChatChoice, a as AiChatMessage, b as AiChatOptions, c as AiChatResult, d as AiChatUsage, e as AiContentPart, f as AiImageUrlPart, g as AiNamespace, h as AiResponseFormat, i as AiStreamHandle, j as AiStreamMeta, k as AiTextPart, l as AuthNamespace, m as AuthStateListener, C as CatalogListOptions, n as CatalogListResponse, p as CheckoutIntentInfo, q as CheckoutIntentStatus, r as CheckoutNamespace, s as CheckoutStartInput, t as CheckoutStartResult, u as CheckoutTenantType, v as CompleteSignInResult, y as CreateTicketInput, D as DEFAULT_BASE_URL, z as DbBatchOp, B as DbChangeType, E as DbCollectionRef, F as DbDoc, G as DbDocRef, H as DbGetResult, I as DbListResult, J as DbNamespace, K as DbQuery, L as DbSqlLease, M as DbWhereFilter, O as EntitlementCheck, P as FieldSentinel, Q as IncrementSentinel, R as ListNotificationsOptions, S as MockCheckout, T as MockNotifications, U as MockWebhooks, V as NEETRU_SENTINEL_KEY, W as NeetruClient, X as NeetruClientConfig, Y as NeetruDb, _ as NeetruDbEngine, $ as NeetruDbError, a0 as NeetruDbErrorCode, a1 as NeetruDbOptions, a2 as NeetruDbTransport, a3 as NeetruEnv, a4 as NeetruSqlClient, a5 as NeetruUser, a6 as NotificationScopeOptions, a7 as NotificationsNamespace, a8 as Product, a9 as ProductNotification, aa as ProductNotificationSeverity, ab as ProductPlan, ac as ProductStatus, ae as RedirectCallbackResult, af as RegisterWebhookInput, ag as ResolvedConfig, ah as SendNotificationInput, ai as ServerTimestampSentinel, aj as SignInOptions, al as SupportNamespace, am as SupportSeverity, an as SupportStatus, ao as SupportTicket, aq as TelemetryEventAck, ar as TelemetryEventInput, av as UsageEventInput, aw as UsageNamespace, ax as UsageQuota, ay as VerifyTokenOptions, az as VerifyWebhookRequestOptions, aA as VerifyWebhookRequestResult, aB as WebhookEndpoint, aC as WebhookEvent, aD as WebhookScopeOptions, aE as WebhookTestResult, aF as WebhooksNamespace, aG as WithFieldSentinels, aI as createAiNamespace, aJ as createCheckoutNamespace, aK as createNeetruDb, aL as createNotificationsNamespace, aN as createWebhooksNamespace, aP as increment, aQ as isFieldSentinel, aR as isIncrementSentinel, aS as isServerTimestampSentinel, aT as serverTimestamp, aU as verifyWebhookRequest, aV as verifyWebhookSignature } from './types-BoFSCHF_.cjs';
 export { DEV_FIXTURE_USER, MockAi, MockAuth, MockAuthOptions, MockDb, MockEntitlements, MockSupport, MockUsage } from './mocks.cjs';
 import 'drizzle-orm/node-postgres';
 
@@ -42,6 +42,6 @@ declare function checkCoreVersionCompat(coreVersion: string): void;
  */
 
 /** Versão do SDK — exportada explicitamente pra detecção em runtime. */
-declare const VERSION: "3.3.0";
+declare const VERSION: "3.4.0";
 
 export { VERSION, checkCoreVersionCompat };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { createNeetruClient } from './auth.js';
 export { NeetruError, NeetruErrorCode } from './errors.js';
-export { A as AiChatChoice, a as AiChatMessage, b as AiChatOptions, c as AiChatResult, d as AiChatUsage, e as AiContentPart, f as AiImageUrlPart, g as AiNamespace, h as AiResponseFormat, i as AiStreamHandle, j as AiStreamMeta, k as AiTextPart, l as AuthNamespace, m as AuthStateListener, C as CatalogListOptions, n as CatalogListResponse, p as CheckoutIntentInfo, q as CheckoutIntentStatus, r as CheckoutNamespace, s as CheckoutStartInput, t as CheckoutStartResult, u as CheckoutTenantType, v as CompleteSignInResult, y as CreateTicketInput, D as DEFAULT_BASE_URL, z as DbBatchOp, B as DbChangeType, E as DbCollectionRef, F as DbDoc, G as DbDocRef, H as DbGetResult, I as DbListResult, J as DbNamespace, K as DbQuery, L as DbSqlLease, M as DbWhereFilter, O as EntitlementCheck, P as FieldSentinel, Q as IncrementSentinel, R as ListNotificationsOptions, S as MockCheckout, T as MockNotifications, U as MockWebhooks, V as NEETRU_SENTINEL_KEY, W as NeetruClient, X as NeetruClientConfig, Y as NeetruDb, _ as NeetruDbEngine, $ as NeetruDbError, a0 as NeetruDbErrorCode, a1 as NeetruDbOptions, a2 as NeetruDbTransport, a3 as NeetruEnv, a4 as NeetruSqlClient, a5 as NeetruUser, a6 as NotificationScopeOptions, a7 as NotificationsNamespace, a8 as Product, a9 as ProductNotification, aa as ProductNotificationSeverity, ab as ProductPlan, ac as ProductStatus, ae as RedirectCallbackResult, af as RegisterWebhookInput, ag as ResolvedConfig, ah as SendNotificationInput, ai as ServerTimestampSentinel, aj as SignInOptions, al as SupportNamespace, am as SupportSeverity, an as SupportStatus, ao as SupportTicket, aq as TelemetryEventAck, ar as TelemetryEventInput, av as UsageEventInput, aw as UsageNamespace, ax as UsageQuota, ay as VerifyTokenOptions, az as VerifyWebhookRequestOptions, aA as VerifyWebhookRequestResult, aB as WebhookEndpoint, aC as WebhookEvent, aD as WebhookScopeOptions, aE as WebhookTestResult, aF as WebhooksNamespace, aG as WithFieldSentinels, aH as createAiNamespace, aI as createCheckoutNamespace, aJ as createNeetruDb, aK as createNotificationsNamespace, aM as createWebhooksNamespace, aO as increment, aP as isFieldSentinel, aQ as isIncrementSentinel, aR as isServerTimestampSentinel, aS as serverTimestamp, aT as verifyWebhookRequest, aU as verifyWebhookSignature } from './types-DslphKIM.js';
+export { A as AiChatChoice, a as AiChatMessage, b as AiChatOptions, c as AiChatResult, d as AiChatUsage, e as AiContentPart, f as AiImageUrlPart, g as AiNamespace, h as AiResponseFormat, i as AiStreamHandle, j as AiStreamMeta, k as AiTextPart, l as AuthNamespace, m as AuthStateListener, C as CatalogListOptions, n as CatalogListResponse, p as CheckoutIntentInfo, q as CheckoutIntentStatus, r as CheckoutNamespace, s as CheckoutStartInput, t as CheckoutStartResult, u as CheckoutTenantType, v as CompleteSignInResult, y as CreateTicketInput, D as DEFAULT_BASE_URL, z as DbBatchOp, B as DbChangeType, E as DbCollectionRef, F as DbDoc, G as DbDocRef, H as DbGetResult, I as DbListResult, J as DbNamespace, K as DbQuery, L as DbSqlLease, M as DbWhereFilter, O as EntitlementCheck, P as FieldSentinel, Q as IncrementSentinel, R as ListNotificationsOptions, S as MockCheckout, T as MockNotifications, U as MockWebhooks, V as NEETRU_SENTINEL_KEY, W as NeetruClient, X as NeetruClientConfig, Y as NeetruDb, _ as NeetruDbEngine, $ as NeetruDbError, a0 as NeetruDbErrorCode, a1 as NeetruDbOptions, a2 as NeetruDbTransport, a3 as NeetruEnv, a4 as NeetruSqlClient, a5 as NeetruUser, a6 as NotificationScopeOptions, a7 as NotificationsNamespace, a8 as Product, a9 as ProductNotification, aa as ProductNotificationSeverity, ab as ProductPlan, ac as ProductStatus, ae as RedirectCallbackResult, af as RegisterWebhookInput, ag as ResolvedConfig, ah as SendNotificationInput, ai as ServerTimestampSentinel, aj as SignInOptions, al as SupportNamespace, am as SupportSeverity, an as SupportStatus, ao as SupportTicket, aq as TelemetryEventAck, ar as TelemetryEventInput, av as UsageEventInput, aw as UsageNamespace, ax as UsageQuota, ay as VerifyTokenOptions, az as VerifyWebhookRequestOptions, aA as VerifyWebhookRequestResult, aB as WebhookEndpoint, aC as WebhookEvent, aD as WebhookScopeOptions, aE as WebhookTestResult, aF as WebhooksNamespace, aG as WithFieldSentinels, aI as createAiNamespace, aJ as createCheckoutNamespace, aK as createNeetruDb, aL as createNotificationsNamespace, aN as createWebhooksNamespace, aP as increment, aQ as isFieldSentinel, aR as isIncrementSentinel, aS as isServerTimestampSentinel, aT as serverTimestamp, aU as verifyWebhookRequest, aV as verifyWebhookSignature } from './types-DdJyqBy-.js';
 export { DEV_FIXTURE_USER, MockAi, MockAuth, MockAuthOptions, MockDb, MockEntitlements, MockSupport, MockUsage } from './mocks.js';
 import 'drizzle-orm/node-postgres';
 
@@ -42,6 +42,6 @@ declare function checkCoreVersionCompat(coreVersion: string): void;
  */
 
 /** Versão do SDK — exportada explicitamente pra detecção em runtime. */
-declare const VERSION: "3.3.0";
+declare const VERSION: "3.4.0";
 
 export { VERSION, checkCoreVersionCompat };

package/dist/index.mjs

@@ -1582,6 +1582,7 @@ function toTicket(raw) {
   if (typeof r.id !== "string") {
     throw new NeetruError("invalid_response", "Ticket missing id");
   }
+  const firstAttachment = Array.isArray(r.attachments) && typeof r.attachments[0] === "string" ? r.attachments[0] : void 0;
   return {
     id: r.id,
     subject: typeof r.subject === "string" ? r.subject : "",
@@ -1590,9 +1591,28 @@ function toTicket(raw) {
     status: VALID_STATUSES.includes(r.status) ? r.status : "open",
     createdAt: typeof r.createdAt === "string" ? r.createdAt : (/* @__PURE__ */ new Date()).toISOString(),
     updatedAt: typeof r.updatedAt === "string" ? r.updatedAt : void 0,
-    productSlug: typeof r.productId === "string" ? r.productId : typeof r.productSlug === "string" ? r.productSlug : void 0
+    productSlug: typeof r.productId === "string" ? r.productId : typeof r.productSlug === "string" ? r.productSlug : void 0,
+    pageUrl: typeof r.pageUrl === "string" ? r.pageUrl : null,
+    screenshotUrl: typeof r.screenshotUrl === "string" ? r.screenshotUrl : firstAttachment ?? null,
+    resolvedAt: typeof r.resolvedAt === "string" ? r.resolvedAt : null,
+    resolvedNotifiedAt: typeof r.resolvedNotifiedAt === "string" ? r.resolvedNotifiedAt : null,
+    satisfactionAttempts: typeof r.satisfactionAttempts === "number" && Number.isFinite(r.satisfactionAttempts) ? r.satisfactionAttempts : 0,
+    lastSatisfactionAttemptAt: typeof r.lastSatisfactionAttemptAt === "string" ? r.lastSatisfactionAttemptAt : null,
+    satisfiedAt: typeof r.satisfiedAt === "string" ? r.satisfiedAt : null,
+    rating: typeof r.rating === "number" && Number.isFinite(r.rating) ? r.rating : null,
+    satisfactionComment: typeof r.satisfactionComment === "string" ? r.satisfactionComment : null
   };
 }
+function assertTicketId(ticketId) {
+  if (!ticketId || typeof ticketId !== "string") {
+    throw new NeetruError("validation_failed", "ticketId is required");
+  }
+}
+function assertValidComment(comment) {
+  if (typeof comment === "string" && comment.length > 2e3) {
+    throw new NeetruError("validation_failed", "comment max 2000 chars");
+  }
+}
 function resolveProductId(config, ...candidates) {
   for (const c of candidates) {
     if (typeof c === "string" && c.length > 0) {
@@ -1649,6 +1669,15 @@ function createSupportNamespace(config) {
       if (input.metadata && typeof input.metadata === "object") {
         body.metadata = input.metadata;
       }
+      if (typeof input.pageUrl === "string") {
+        body.pageUrl = input.pageUrl;
+      }
+      if (typeof input.screenshotBase64 === "string") {
+        body.screenshotBase64 = input.screenshotBase64;
+      }
+      if (typeof input.consoleLogs === "string") {
+        body.consoleLogs = input.consoleLogs;
+      }
       const raw = await httpRequest(config, {
         method: "POST",
         path: "/api/sdk/v1/support/tickets",
@@ -1674,6 +1703,74 @@ function createSupportNamespace(config) {
       });
       const list = Array.isArray(raw) ? raw : raw && typeof raw === "object" && "tickets" in raw ? raw.tickets ?? [] : [];
       return list.map(toTicket);
+    },
+    /**
+     * 3.4: marca a notificação de resolução como vista (`resolvedNotifiedAt`,
+     * idempotente no Core). Endpoint canonical:
+     * `POST /api/sdk/v1/support/tickets/{id}/resolved-seen`.
+     */
+    async markResolvedSeen(ticketId) {
+      assertTicketId(ticketId);
+      await httpRequest(config, {
+        method: "POST",
+        path: `/api/sdk/v1/support/tickets/${encodeURIComponent(ticketId)}/resolved-seen`,
+        requireAuth: true
+      });
+    },
+    /**
+     * 3.4: registra uma tentativa de exibição do modal de satisfação
+     * (`satisfactionAttempts += 1`). Chamar no SHOW do modal, não na
+     * resposta. Endpoint canonical:
+     * `POST /api/sdk/v1/support/tickets/{id}/satisfaction-attempt`.
+     */
+    async recordSatisfactionAttempt(ticketId) {
+      assertTicketId(ticketId);
+      await httpRequest(config, {
+        method: "POST",
+        path: `/api/sdk/v1/support/tickets/${encodeURIComponent(ticketId)}/satisfaction-attempt`,
+        requireAuth: true
+      });
+    },
+    /**
+     * 3.4: envia (ou pula) a avaliação de satisfação (CSAT 1-5). Endpoint
+     * canonical: `POST /api/sdk/v1/support/tickets/{id}/satisfaction`.
+     */
+    async submitSatisfaction(input) {
+      if (!input || typeof input !== "object") {
+        throw new NeetruError("validation_failed", "input is required");
+      }
+      assertTicketId(input.ticketId);
+      if (input.rating !== null && input.rating !== void 0) {
+        if (!Number.isInteger(input.rating) || input.rating < 1 || input.rating > 5) {
+          throw new NeetruError("validation_failed", "rating must be an integer 1-5 or null");
+        }
+      }
+      assertValidComment(input.comment);
+      await httpRequest(config, {
+        method: "POST",
+        path: `/api/sdk/v1/support/tickets/${encodeURIComponent(input.ticketId)}/satisfaction`,
+        body: {
+          rating: input.rating ?? null,
+          comment: input.comment ?? null,
+          skipped: input.skipped
+        },
+        requireAuth: true
+      });
+    },
+    /**
+     * 3.4: contesta um ticket resolvido — reabre e zera o ciclo de
+     * satisfação/notificação. Endpoint canonical:
+     * `POST /api/sdk/v1/support/tickets/{id}/contest`.
+     */
+    async contestTicket(ticketId, opts) {
+      assertTicketId(ticketId);
+      assertValidComment(opts?.comment);
+      await httpRequest(config, {
+        method: "POST",
+        path: `/api/sdk/v1/support/tickets/${encodeURIComponent(ticketId)}/contest`,
+        body: { comment: opts?.comment ?? void 0 },
+        requireAuth: true
+      });
     }
   };
 }
@@ -5105,7 +5202,20 @@ function buildTicketProvider(config, opts) {
     return ticket;
   };
 }
+var _hasWarnedMissingDbId = false;
+function warnMissingDbIdOnce(config, dbOpts) {
+  if (_hasWarnedMissingDbId) return;
+  if (dbOpts.dbId) return;
+  if (config.env === "prod") return;
+  if (typeof window === "undefined") return;
+  if (typeof console === "undefined" || typeof console.warn !== "function") return;
+  _hasWarnedMissingDbId = true;
+  console.warn(
+    "[neetru/sdk] client.db sem `dbId` expl\xEDcito: escritas client-side (add/set/update/remove/list) caem no datastore gen\xE9rico do Core, escopado por tenant/produto (header x-neetru-tenant) \u2014 `dbId` s\xF3 nomeia o cache offline LOCAL (IndexedDB), n\xE3o roteia nem escopa nada no servidor. Veja o JSDoc de NeetruDbOptions.dbId."
+  );
+}
 function createNeetruDb(config, dbOpts = {}) {
+  warnMissingDbIdOnce(config, dbOpts);
   let resolvedTransport;
   if (dbOpts.transport !== void 0) {
     resolvedTransport = dbOpts.transport;
@@ -6615,7 +6725,18 @@ var MockSupport = class {
       severity: input.severity ?? "normal",
       status: "open",
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-      productSlug: input.productSlug
+      productSlug: input.productSlug,
+      // 3.4 (product-feedback): espelha o contrato — campos novos nullable,
+      // populados a partir do input quando fornecidos.
+      pageUrl: typeof input.pageUrl === "string" ? input.pageUrl : null,
+      screenshotUrl: typeof input.screenshotBase64 === "string" ? input.screenshotBase64 : null,
+      resolvedAt: null,
+      resolvedNotifiedAt: null,
+      satisfactionAttempts: 0,
+      lastSatisfactionAttemptAt: null,
+      satisfiedAt: null,
+      rating: null,
+      satisfactionComment: null
     };
     this._tickets.push(ticket);
     return ticket;
@@ -6626,6 +6747,62 @@ var MockSupport = class {
     }
     return [...this._tickets];
   }
+  _find(ticketId) {
+    if (!ticketId || typeof ticketId !== "string") {
+      throw new NeetruError("validation_failed", "ticketId is required");
+    }
+    const ticket = this._tickets.find((t) => t.id === ticketId);
+    if (!ticket) {
+      throw new NeetruError("not_found", `ticket ${ticketId} not found`);
+    }
+    return ticket;
+  }
+  /** 3.4: espelha `markResolvedSeen` — idempotente (só seta se ainda null). */
+  async markResolvedSeen(ticketId) {
+    const ticket = this._find(ticketId);
+    if (ticket.resolvedNotifiedAt === null) {
+      ticket.resolvedNotifiedAt = (/* @__PURE__ */ new Date()).toISOString();
+    }
+  }
+  /** 3.4: espelha `recordSatisfactionAttempt` — incrementa contador. */
+  async recordSatisfactionAttempt(ticketId) {
+    const ticket = this._find(ticketId);
+    ticket.satisfactionAttempts += 1;
+    ticket.lastSatisfactionAttemptAt = (/* @__PURE__ */ new Date()).toISOString();
+  }
+  /** 3.4: espelha `submitSatisfaction` — terminal, seta `satisfiedAt`. */
+  async submitSatisfaction(input) {
+    if (!input || typeof input !== "object") {
+      throw new NeetruError("validation_failed", "input is required");
+    }
+    if (input.rating !== null && input.rating !== void 0) {
+      if (!Number.isInteger(input.rating) || input.rating < 1 || input.rating > 5) {
+        throw new NeetruError("validation_failed", "rating must be an integer 1-5 or null");
+      }
+    }
+    if (typeof input.comment === "string" && input.comment.length > 2e3) {
+      throw new NeetruError("validation_failed", "comment max 2000 chars");
+    }
+    const ticket = this._find(input.ticketId);
+    ticket.satisfiedAt = (/* @__PURE__ */ new Date()).toISOString();
+    ticket.rating = input.rating ?? null;
+    ticket.satisfactionComment = input.comment ?? null;
+  }
+  /** 3.4: espelha `contestTicket` — reabre e zera o ciclo de satisfação. */
+  async contestTicket(ticketId, opts) {
+    if (typeof opts?.comment === "string" && opts.comment.length > 2e3) {
+      throw new NeetruError("validation_failed", "comment max 2000 chars");
+    }
+    const ticket = this._find(ticketId);
+    ticket.status = "open";
+    ticket.resolvedAt = null;
+    ticket.resolvedNotifiedAt = null;
+    ticket.satisfactionAttempts = 0;
+    ticket.lastSatisfactionAttemptAt = null;
+    ticket.satisfiedAt = null;
+    ticket.rating = null;
+    ticket.satisfactionComment = null;
+  }
   /** Test helper. */
   __reset() {
     this._tickets = [];
@@ -7662,7 +7839,7 @@ function createNeetruClient(config = {}) {
 init_errors();
 init_db_errors();
 init_http();
-var VERSION = "3.3.0";
+var VERSION = "3.4.0";
 
 export { DEFAULT_BASE_URL, DEV_FIXTURE_USER, MockAi, MockAuth, MockCheckout, MockDb, MockEntitlements, MockNotifications, MockSupport, MockUsage, MockWebhooks, NEETRU_SENTINEL_KEY, NeetruDbError, NeetruError, VERSION, checkCoreVersionCompat, createAiNamespace, createCheckoutNamespace, createNeetruClient, createNeetruDb, createNotificationsNamespace, createWebhooksNamespace, increment, isFieldSentinel, isIncrementSentinel, isServerTimestampSentinel, serverTimestamp, verifyWebhookRequest, verifyWebhookSignature };
 //# sourceMappingURL=index.mjs.map