@mailoo/forms 1.32.2 → 1.33.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 +12 -9
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -14,11 +14,11 @@ Published on npm as `@mailoo/forms`. Inside this monorepo, apps use
14
14
 
15
15
  ## Scopes (API keys)
16
16
 
17
- | Integration path | Required scope |
18
- |------------------|----------------|
19
- | FORM submit | `webhook.form-submission` (or FULL) |
17
+ | Integration path | Required scope |
18
+ | --------------------- | --------------------------------------- |
19
+ | FORM submit | `webhook.form-submission` (or FULL) |
20
20
  | CONTACT_FORM feedback | `webhook.feedback-submission` (or FULL) |
21
- | Lifecycle events | `lifecycle.ingest` (or FULL) |
21
+ | Lifecycle events | `lifecycle.ingest` (or FULL) |
22
22
 
23
23
  Use a **separate** key (or FULL) for lifecycle — do not reuse a form-only RESTRICTED key.
24
24
 
@@ -47,11 +47,11 @@ Feedback also reads (same prefix):
47
47
 
48
48
  ## Identity (lifecycle)
49
49
 
50
- | Field | Who owns it | Use |
51
- |-------|-------------|-----|
50
+ | Field | Who owns it | Use |
51
+ | ---------------- | ------------------------ | --------------------------------------------------------------------- |
52
52
  | `externalUserId` | Host (e.g. Firebase UID) | Stable key for ingest, status, welcome idempotency, `consent.changed` |
53
- | `email` | Host + Mailoo | Unique merge / bulk status lookup |
54
- | `contactId` | Mailoo cuid | Debug only — **not** your user id |
53
+ | `email` | Host + Mailoo | Unique merge / bulk status lookup |
54
+ | `contactId` | Mailoo cuid | Debug only — **not** your user id |
55
55
 
56
56
  Pass **both** UID and email on ingest. Do not put email into `externalUserId`.
57
57
 
@@ -121,7 +121,10 @@ Allowed `attributes` keys only: `plan`, `tier`, `country`, `signupChannel`, `ref
121
121
  After **your** app creates or activates a user:
122
122
 
123
123
  ```ts
124
- import { ingestMailooLifecycleEvent, retryMailooLifecycleEvent } from '@mailoo/forms/server'
124
+ import {
125
+ ingestMailooLifecycleEvent,
126
+ retryMailooLifecycleEvent,
127
+ } from '@mailoo/forms/server'
125
128
  import { MAILOO_LIFECYCLE_EVENTS } from '@mailoo/forms/events'
126
129
 
127
130
  const result = await ingestMailooLifecycleEvent({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mailoo/forms",
3
- "version": "1.32.2",
3
+ "version": "1.33.0",
4
4
  "description": "Mailoo FORM and CONTACT_FORM (feedback) Next.js BFF helpers, hooks, and lifecycle events",
5
5
  "license": "LicenseRef-Mailoo-NoModification",
6
6
  "homepage": "https://mailoo.app/en/support/docs/integrations/nextjs-packages",
@@ -59,7 +59,7 @@
59
59
  "react": ">=18.3.1"
60
60
  },
61
61
  "devDependencies": {
62
- "@mailoo/next-core": "1.32.2",
62
+ "@mailoo/next-core": "1.33.0",
63
63
  "@types/node": "^25.9.5",
64
64
  "@types/react": "^19.2.18",
65
65
  "next": "^16.3.4",