@mailoo/forms 0.0.0-stage → 1.32.2

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 (45) hide show
  1. package/LICENSE +16 -0
  2. package/README.md +205 -2
  3. package/dist/chunk-4B377BWO.js +147 -0
  4. package/dist/chunk-4B377BWO.js.map +1 -0
  5. package/dist/chunk-LD246ORB.js +86 -0
  6. package/dist/chunk-LD246ORB.js.map +1 -0
  7. package/dist/chunk-QBZAYHBD.js +36 -0
  8. package/dist/chunk-QBZAYHBD.js.map +1 -0
  9. package/dist/events/index.cjs +176 -0
  10. package/dist/events/index.cjs.map +1 -0
  11. package/dist/events/index.d.cts +107 -0
  12. package/dist/events/index.d.ts +107 -0
  13. package/dist/events/index.js +17 -0
  14. package/dist/events/index.js.map +1 -0
  15. package/dist/hooks/index.cjs +301 -0
  16. package/dist/hooks/index.cjs.map +1 -0
  17. package/dist/hooks/index.d.cts +130 -0
  18. package/dist/hooks/index.d.ts +130 -0
  19. package/dist/hooks/index.js +221 -0
  20. package/dist/hooks/index.js.map +1 -0
  21. package/dist/index.cjs +66 -0
  22. package/dist/index.cjs.map +1 -0
  23. package/dist/index.d.cts +35 -0
  24. package/dist/index.d.ts +35 -0
  25. package/dist/index.js +19 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/routes/index.cjs +544 -0
  28. package/dist/routes/index.cjs.map +1 -0
  29. package/dist/routes/index.d.cts +59 -0
  30. package/dist/routes/index.d.ts +59 -0
  31. package/dist/routes/index.js +351 -0
  32. package/dist/routes/index.js.map +1 -0
  33. package/dist/server/index.cjs +270 -0
  34. package/dist/server/index.cjs.map +1 -0
  35. package/dist/server/index.d.cts +44 -0
  36. package/dist/server/index.d.ts +44 -0
  37. package/dist/server/index.js +112 -0
  38. package/dist/server/index.js.map +1 -0
  39. package/dist/webhooks/index.cjs +111 -0
  40. package/dist/webhooks/index.cjs.map +1 -0
  41. package/dist/webhooks/index.d.cts +37 -0
  42. package/dist/webhooks/index.d.ts +37 -0
  43. package/dist/webhooks/index.js +9 -0
  44. package/dist/webhooks/index.js.map +1 -0
  45. package/package.json +77 -3
@@ -0,0 +1,176 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/events/index.ts
21
+ var events_exports = {};
22
+ __export(events_exports, {
23
+ MAILOO_LIFECYCLE_ATTRIBUTE_KEYS: () => MAILOO_LIFECYCLE_ATTRIBUTE_KEYS,
24
+ MAILOO_LIFECYCLE_EVENTS: () => MAILOO_LIFECYCLE_EVENTS,
25
+ MAILOO_LIFECYCLE_EVENT_NAMES: () => MAILOO_LIFECYCLE_EVENT_NAMES,
26
+ isMailooLifecycleEventName: () => isMailooLifecycleEventName,
27
+ parseMailooLifecycleIngestData: () => parseMailooLifecycleIngestData,
28
+ validateMailooLifecycleEvent: () => validateMailooLifecycleEvent
29
+ });
30
+ module.exports = __toCommonJS(events_exports);
31
+ var MAILOO_LIFECYCLE_EVENTS = {
32
+ USER_REGISTERED: "user.registered",
33
+ USER_ACTIVATED: "user.activated"
34
+ };
35
+ var MAILOO_LIFECYCLE_EVENT_NAMES = [
36
+ MAILOO_LIFECYCLE_EVENTS.USER_REGISTERED,
37
+ MAILOO_LIFECYCLE_EVENTS.USER_ACTIVATED
38
+ ];
39
+ var EVENT_NAME_SET = new Set(MAILOO_LIFECYCLE_EVENT_NAMES);
40
+ var MAILOO_LIFECYCLE_ATTRIBUTE_KEYS = [
41
+ "plan",
42
+ "tier",
43
+ "country",
44
+ "signupChannel",
45
+ "referrer"
46
+ ];
47
+ var ATTRIBUTE_KEY_SET = new Set(MAILOO_LIFECYCLE_ATTRIBUTE_KEYS);
48
+ var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
49
+ function isPlainObject(v) {
50
+ return typeof v === "object" && v !== null && !Array.isArray(v);
51
+ }
52
+ function validateMailooLifecycleEvent(body) {
53
+ if (!isPlainObject(body)) {
54
+ return { ok: false, message: "JSON body object is required" };
55
+ }
56
+ const idempotencyKey = typeof body.idempotencyKey === "string" ? body.idempotencyKey.trim() : "";
57
+ if (!idempotencyKey || idempotencyKey.length > 256) {
58
+ return {
59
+ ok: false,
60
+ message: "idempotencyKey is required (max 256 characters)"
61
+ };
62
+ }
63
+ const eventName = typeof body.eventName === "string" ? body.eventName.trim() : "";
64
+ if (!eventName) {
65
+ return { ok: false, message: "eventName is required" };
66
+ }
67
+ if (!EVENT_NAME_SET.has(eventName)) {
68
+ return {
69
+ ok: false,
70
+ message: `Unknown eventName: ${eventName}. Allowed: ${MAILOO_LIFECYCLE_EVENT_NAMES.join(", ")}`
71
+ };
72
+ }
73
+ const externalUserId = typeof body.externalUserId === "string" ? body.externalUserId.trim() : "";
74
+ if (!externalUserId) {
75
+ return { ok: false, message: "externalUserId is required" };
76
+ }
77
+ const emailRaw = typeof body.email === "string" ? body.email.trim() : "";
78
+ if (!emailRaw || !EMAIL_RE.test(emailRaw)) {
79
+ return { ok: false, message: "Valid email is required" };
80
+ }
81
+ const locale = typeof body.locale === "string" && body.locale.trim() ? body.locale.trim() : void 0;
82
+ const name = typeof body.name === "string" && body.name.trim() ? body.name.trim() : void 0;
83
+ let marketingConsent;
84
+ const rawConsent = body.marketingConsent;
85
+ if (rawConsent === true || rawConsent === false) {
86
+ marketingConsent = rawConsent;
87
+ } else if (isPlainObject(rawConsent) && typeof rawConsent.granted === "boolean") {
88
+ const at = typeof rawConsent.at === "string" && rawConsent.at.trim() ? rawConsent.at.trim() : void 0;
89
+ if (at !== void 0) {
90
+ const parsed = new Date(at);
91
+ if (Number.isNaN(parsed.getTime())) {
92
+ return {
93
+ ok: false,
94
+ message: "marketingConsent.at must be a valid ISO timestamp"
95
+ };
96
+ }
97
+ }
98
+ marketingConsent = {
99
+ granted: rawConsent.granted,
100
+ ...at ? { at } : {},
101
+ ...typeof rawConsent.source === "string" ? { source: rawConsent.source } : {}
102
+ };
103
+ } else {
104
+ return {
105
+ ok: false,
106
+ message: "marketingConsent is required (boolean or { granted })"
107
+ };
108
+ }
109
+ let attributes;
110
+ if (body.attributes !== void 0) {
111
+ if (!isPlainObject(body.attributes)) {
112
+ return { ok: false, message: "attributes must be an object" };
113
+ }
114
+ attributes = {};
115
+ for (const [key, value] of Object.entries(body.attributes)) {
116
+ if (!ATTRIBUTE_KEY_SET.has(key)) {
117
+ return { ok: false, message: `Unknown attribute key: ${key}` };
118
+ }
119
+ attributes[key] = value;
120
+ }
121
+ }
122
+ return {
123
+ ok: true,
124
+ value: {
125
+ eventName,
126
+ idempotencyKey,
127
+ externalUserId,
128
+ email: emailRaw,
129
+ marketingConsent,
130
+ ...locale ? { locale } : {},
131
+ ...name ? { name } : {},
132
+ ...attributes ? { attributes } : {}
133
+ }
134
+ };
135
+ }
136
+ function isMailooLifecycleEventName(value) {
137
+ return EVENT_NAME_SET.has(value);
138
+ }
139
+ function parseMailooLifecycleIngestData(data) {
140
+ if (!isPlainObject(data)) return null;
141
+ if (typeof data.eventId !== "string" || typeof data.contactId !== "string") {
142
+ return null;
143
+ }
144
+ let send = null;
145
+ if (data.send === null) {
146
+ send = null;
147
+ } else if (isPlainObject(data.send) && typeof data.send.sendId === "string") {
148
+ send = {
149
+ sendId: data.send.sendId,
150
+ status: String(data.send.status ?? ""),
151
+ messageId: data.send.messageId === null || typeof data.send.messageId === "string" ? data.send.messageId : null,
152
+ trackingToken: String(data.send.trackingToken ?? ""),
153
+ campaignId: data.send.campaignId === null || typeof data.send.campaignId === "string" ? data.send.campaignId : null
154
+ };
155
+ } else {
156
+ return null;
157
+ }
158
+ return {
159
+ eventId: data.eventId,
160
+ contactId: data.contactId,
161
+ idempotentReplay: data.idempotentReplay === true,
162
+ processingStatus: String(data.processingStatus ?? ""),
163
+ skipReason: data.skipReason === null || typeof data.skipReason === "string" ? data.skipReason : null,
164
+ send
165
+ };
166
+ }
167
+ // Annotate the CommonJS export names for ESM import in node:
168
+ 0 && (module.exports = {
169
+ MAILOO_LIFECYCLE_ATTRIBUTE_KEYS,
170
+ MAILOO_LIFECYCLE_EVENTS,
171
+ MAILOO_LIFECYCLE_EVENT_NAMES,
172
+ isMailooLifecycleEventName,
173
+ parseMailooLifecycleIngestData,
174
+ validateMailooLifecycleEvent
175
+ });
176
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/events/index.ts"],"sourcesContent":["/**\n * Closed lifecycle event catalog for FORM / CONTACT_FORM integrations.\n * Integrators choose *when* to emit; they must not invent event names or\n * attribute keys.\n */\n\nexport const MAILOO_LIFECYCLE_EVENTS = {\n USER_REGISTERED: 'user.registered',\n USER_ACTIVATED: 'user.activated',\n} as const\n\nexport type MailooLifecycleEventName =\n (typeof MAILOO_LIFECYCLE_EVENTS)[keyof typeof MAILOO_LIFECYCLE_EVENTS]\n\nexport const MAILOO_LIFECYCLE_EVENT_NAMES = [\n MAILOO_LIFECYCLE_EVENTS.USER_REGISTERED,\n MAILOO_LIFECYCLE_EVENTS.USER_ACTIVATED,\n] as const\n\nconst EVENT_NAME_SET = new Set<string>(MAILOO_LIFECYCLE_EVENT_NAMES)\n\nexport const MAILOO_LIFECYCLE_ATTRIBUTE_KEYS = [\n 'plan',\n 'tier',\n 'country',\n 'signupChannel',\n 'referrer',\n] as const\n\nexport type MailooLifecycleAttributeKey =\n (typeof MAILOO_LIFECYCLE_ATTRIBUTE_KEYS)[number]\n\nconst ATTRIBUTE_KEY_SET = new Set<string>(MAILOO_LIFECYCLE_ATTRIBUTE_KEYS)\n\nconst EMAIL_RE = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n\nexport type MailooMarketingConsent =\n | boolean\n | {\n granted: boolean\n at?: string\n source?: string\n }\n\nexport type MailooLifecycleEventInput = {\n eventName: MailooLifecycleEventName\n idempotencyKey: string\n externalUserId: string\n email: string\n marketingConsent: MailooMarketingConsent\n locale?: string\n name?: string\n attributes?: Partial<Record<MailooLifecycleAttributeKey, unknown>>\n}\n\nexport type MailooLifecycleEventValidation =\n | { ok: true; value: MailooLifecycleEventInput }\n | { ok: false; message: string }\n\nfunction isPlainObject(v: unknown): v is Record<string, unknown> {\n return typeof v === 'object' && v !== null && !Array.isArray(v)\n}\n\n/**\n * Parse and validate a lifecycle ingest body. Fail-fast — no default\n * `eventName`. Used by BFF handlers and server ingest.\n */\nexport function validateMailooLifecycleEvent(\n body: unknown\n): MailooLifecycleEventValidation {\n if (!isPlainObject(body)) {\n return { ok: false, message: 'JSON body object is required' }\n }\n\n const idempotencyKey =\n typeof body.idempotencyKey === 'string' ? body.idempotencyKey.trim() : ''\n if (!idempotencyKey || idempotencyKey.length > 256) {\n return {\n ok: false,\n message: 'idempotencyKey is required (max 256 characters)',\n }\n }\n\n const eventName =\n typeof body.eventName === 'string' ? body.eventName.trim() : ''\n if (!eventName) {\n return { ok: false, message: 'eventName is required' }\n }\n if (!EVENT_NAME_SET.has(eventName)) {\n return {\n ok: false,\n message: `Unknown eventName: ${eventName}. Allowed: ${MAILOO_LIFECYCLE_EVENT_NAMES.join(', ')}`,\n }\n }\n\n const externalUserId =\n typeof body.externalUserId === 'string' ? body.externalUserId.trim() : ''\n if (!externalUserId) {\n return { ok: false, message: 'externalUserId is required' }\n }\n\n const emailRaw = typeof body.email === 'string' ? body.email.trim() : ''\n if (!emailRaw || !EMAIL_RE.test(emailRaw)) {\n return { ok: false, message: 'Valid email is required' }\n }\n\n const locale =\n typeof body.locale === 'string' && body.locale.trim()\n ? body.locale.trim()\n : undefined\n const name =\n typeof body.name === 'string' && body.name.trim()\n ? body.name.trim()\n : undefined\n\n let marketingConsent: MailooMarketingConsent\n const rawConsent = body.marketingConsent\n if (rawConsent === true || rawConsent === false) {\n marketingConsent = rawConsent\n } else if (isPlainObject(rawConsent) && typeof rawConsent.granted === 'boolean') {\n const at =\n typeof rawConsent.at === 'string' && rawConsent.at.trim()\n ? rawConsent.at.trim()\n : undefined\n if (at !== undefined) {\n const parsed = new Date(at)\n if (Number.isNaN(parsed.getTime())) {\n return {\n ok: false,\n message: 'marketingConsent.at must be a valid ISO timestamp',\n }\n }\n }\n marketingConsent = {\n granted: rawConsent.granted,\n ...(at ? { at } : {}),\n ...(typeof rawConsent.source === 'string'\n ? { source: rawConsent.source }\n : {}),\n }\n } else {\n return {\n ok: false,\n message: 'marketingConsent is required (boolean or { granted })',\n }\n }\n\n let attributes:\n | Partial<Record<MailooLifecycleAttributeKey, unknown>>\n | undefined\n if (body.attributes !== undefined) {\n if (!isPlainObject(body.attributes)) {\n return { ok: false, message: 'attributes must be an object' }\n }\n attributes = {}\n for (const [key, value] of Object.entries(body.attributes)) {\n if (!ATTRIBUTE_KEY_SET.has(key)) {\n return { ok: false, message: `Unknown attribute key: ${key}` }\n }\n attributes[key as MailooLifecycleAttributeKey] = value\n }\n }\n\n return {\n ok: true,\n value: {\n eventName: eventName as MailooLifecycleEventName,\n idempotencyKey,\n externalUserId,\n email: emailRaw,\n marketingConsent,\n ...(locale ? { locale } : {}),\n ...(name ? { name } : {}),\n ...(attributes ? { attributes } : {}),\n },\n }\n}\n\nexport function isMailooLifecycleEventName(\n value: string\n): value is MailooLifecycleEventName {\n return EVENT_NAME_SET.has(value)\n}\n\n/** Send row returned by lifecycle ingest / retry. */\nexport type MailooLifecycleSendResult = {\n sendId: string\n status: string\n messageId: string | null\n trackingToken: string\n campaignId: string | null\n}\n\n/**\n * Typed `data` from lifecycle ingest / retry success JSON.\n * `contactId` is Mailoo's Subscriber cuid — not the host user id.\n * Host identity key is `externalUserId` (e.g. Firebase UID).\n */\nexport type MailooLifecycleIngestData = {\n eventId: string\n contactId: string\n idempotentReplay: boolean\n processingStatus: string\n skipReason: string | null\n send: MailooLifecycleSendResult | null\n}\n\nexport type MailooLifecycleIngestSuccess = {\n success: true\n data: MailooLifecycleIngestData\n}\n\nexport type MailooLifecycleContactSummary = {\n requestedExternalUserId: string | null\n requestedEmail: string | null\n matchedBy: 'externalUserId' | 'email' | null\n contactId: string | null\n externalUserId: string | null\n email: string | null\n marketingConsentGranted: boolean | null\n unsubscribedAt: string | null\n lastEvent: {\n eventId: string\n eventName: string\n processingStatus: string\n skipReason: string | null\n createdAt: string\n } | null\n lastSend: {\n sendId: string\n status: string\n messageId: string | null\n openedAt: string | null\n clickedAt: string | null\n } | null\n}\n\nexport type MailooLifecycleStatusData = {\n success: true\n configured: true\n contacts: number\n contact: Record<string, unknown> | null\n events: Array<Record<string, unknown>>\n sends: Array<Record<string, unknown>>\n segments: Array<{\n id: string\n name: string\n systemKey: string | null\n }>\n summaries?: MailooLifecycleContactSummary[]\n}\n\nexport function parseMailooLifecycleIngestData(\n data: unknown\n): MailooLifecycleIngestData | null {\n if (!isPlainObject(data)) return null\n if (typeof data.eventId !== 'string' || typeof data.contactId !== 'string') {\n return null\n }\n let send: MailooLifecycleSendResult | null = null\n if (data.send === null) {\n send = null\n } else if (isPlainObject(data.send) && typeof data.send.sendId === 'string') {\n send = {\n sendId: data.send.sendId,\n status: String(data.send.status ?? ''),\n messageId:\n data.send.messageId === null || typeof data.send.messageId === 'string'\n ? (data.send.messageId as string | null)\n : null,\n trackingToken: String(data.send.trackingToken ?? ''),\n campaignId:\n data.send.campaignId === null ||\n typeof data.send.campaignId === 'string'\n ? (data.send.campaignId as string | null)\n : null,\n }\n } else {\n return null\n }\n return {\n eventId: data.eventId,\n contactId: data.contactId,\n idempotentReplay: data.idempotentReplay === true,\n processingStatus: String(data.processingStatus ?? ''),\n skipReason:\n data.skipReason === null || typeof data.skipReason === 'string'\n ? (data.skipReason as string | null)\n : null,\n send,\n }\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Closed lifecycle event catalog for FORM / CONTACT_FORM integrations.
3
+ * Integrators choose *when* to emit; they must not invent event names or
4
+ * attribute keys.
5
+ */
6
+ declare const MAILOO_LIFECYCLE_EVENTS: {
7
+ readonly USER_REGISTERED: "user.registered";
8
+ readonly USER_ACTIVATED: "user.activated";
9
+ };
10
+ type MailooLifecycleEventName = (typeof MAILOO_LIFECYCLE_EVENTS)[keyof typeof MAILOO_LIFECYCLE_EVENTS];
11
+ declare const MAILOO_LIFECYCLE_EVENT_NAMES: readonly ["user.registered", "user.activated"];
12
+ declare const MAILOO_LIFECYCLE_ATTRIBUTE_KEYS: readonly ["plan", "tier", "country", "signupChannel", "referrer"];
13
+ type MailooLifecycleAttributeKey = (typeof MAILOO_LIFECYCLE_ATTRIBUTE_KEYS)[number];
14
+ type MailooMarketingConsent = boolean | {
15
+ granted: boolean;
16
+ at?: string;
17
+ source?: string;
18
+ };
19
+ type MailooLifecycleEventInput = {
20
+ eventName: MailooLifecycleEventName;
21
+ idempotencyKey: string;
22
+ externalUserId: string;
23
+ email: string;
24
+ marketingConsent: MailooMarketingConsent;
25
+ locale?: string;
26
+ name?: string;
27
+ attributes?: Partial<Record<MailooLifecycleAttributeKey, unknown>>;
28
+ };
29
+ type MailooLifecycleEventValidation = {
30
+ ok: true;
31
+ value: MailooLifecycleEventInput;
32
+ } | {
33
+ ok: false;
34
+ message: string;
35
+ };
36
+ /**
37
+ * Parse and validate a lifecycle ingest body. Fail-fast — no default
38
+ * `eventName`. Used by BFF handlers and server ingest.
39
+ */
40
+ declare function validateMailooLifecycleEvent(body: unknown): MailooLifecycleEventValidation;
41
+ declare function isMailooLifecycleEventName(value: string): value is MailooLifecycleEventName;
42
+ /** Send row returned by lifecycle ingest / retry. */
43
+ type MailooLifecycleSendResult = {
44
+ sendId: string;
45
+ status: string;
46
+ messageId: string | null;
47
+ trackingToken: string;
48
+ campaignId: string | null;
49
+ };
50
+ /**
51
+ * Typed `data` from lifecycle ingest / retry success JSON.
52
+ * `contactId` is Mailoo's Subscriber cuid — not the host user id.
53
+ * Host identity key is `externalUserId` (e.g. Firebase UID).
54
+ */
55
+ type MailooLifecycleIngestData = {
56
+ eventId: string;
57
+ contactId: string;
58
+ idempotentReplay: boolean;
59
+ processingStatus: string;
60
+ skipReason: string | null;
61
+ send: MailooLifecycleSendResult | null;
62
+ };
63
+ type MailooLifecycleIngestSuccess = {
64
+ success: true;
65
+ data: MailooLifecycleIngestData;
66
+ };
67
+ type MailooLifecycleContactSummary = {
68
+ requestedExternalUserId: string | null;
69
+ requestedEmail: string | null;
70
+ matchedBy: 'externalUserId' | 'email' | null;
71
+ contactId: string | null;
72
+ externalUserId: string | null;
73
+ email: string | null;
74
+ marketingConsentGranted: boolean | null;
75
+ unsubscribedAt: string | null;
76
+ lastEvent: {
77
+ eventId: string;
78
+ eventName: string;
79
+ processingStatus: string;
80
+ skipReason: string | null;
81
+ createdAt: string;
82
+ } | null;
83
+ lastSend: {
84
+ sendId: string;
85
+ status: string;
86
+ messageId: string | null;
87
+ openedAt: string | null;
88
+ clickedAt: string | null;
89
+ } | null;
90
+ };
91
+ type MailooLifecycleStatusData = {
92
+ success: true;
93
+ configured: true;
94
+ contacts: number;
95
+ contact: Record<string, unknown> | null;
96
+ events: Array<Record<string, unknown>>;
97
+ sends: Array<Record<string, unknown>>;
98
+ segments: Array<{
99
+ id: string;
100
+ name: string;
101
+ systemKey: string | null;
102
+ }>;
103
+ summaries?: MailooLifecycleContactSummary[];
104
+ };
105
+ declare function parseMailooLifecycleIngestData(data: unknown): MailooLifecycleIngestData | null;
106
+
107
+ export { MAILOO_LIFECYCLE_ATTRIBUTE_KEYS, MAILOO_LIFECYCLE_EVENTS, MAILOO_LIFECYCLE_EVENT_NAMES, type MailooLifecycleAttributeKey, type MailooLifecycleContactSummary, type MailooLifecycleEventInput, type MailooLifecycleEventName, type MailooLifecycleEventValidation, type MailooLifecycleIngestData, type MailooLifecycleIngestSuccess, type MailooLifecycleSendResult, type MailooLifecycleStatusData, type MailooMarketingConsent, isMailooLifecycleEventName, parseMailooLifecycleIngestData, validateMailooLifecycleEvent };
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Closed lifecycle event catalog for FORM / CONTACT_FORM integrations.
3
+ * Integrators choose *when* to emit; they must not invent event names or
4
+ * attribute keys.
5
+ */
6
+ declare const MAILOO_LIFECYCLE_EVENTS: {
7
+ readonly USER_REGISTERED: "user.registered";
8
+ readonly USER_ACTIVATED: "user.activated";
9
+ };
10
+ type MailooLifecycleEventName = (typeof MAILOO_LIFECYCLE_EVENTS)[keyof typeof MAILOO_LIFECYCLE_EVENTS];
11
+ declare const MAILOO_LIFECYCLE_EVENT_NAMES: readonly ["user.registered", "user.activated"];
12
+ declare const MAILOO_LIFECYCLE_ATTRIBUTE_KEYS: readonly ["plan", "tier", "country", "signupChannel", "referrer"];
13
+ type MailooLifecycleAttributeKey = (typeof MAILOO_LIFECYCLE_ATTRIBUTE_KEYS)[number];
14
+ type MailooMarketingConsent = boolean | {
15
+ granted: boolean;
16
+ at?: string;
17
+ source?: string;
18
+ };
19
+ type MailooLifecycleEventInput = {
20
+ eventName: MailooLifecycleEventName;
21
+ idempotencyKey: string;
22
+ externalUserId: string;
23
+ email: string;
24
+ marketingConsent: MailooMarketingConsent;
25
+ locale?: string;
26
+ name?: string;
27
+ attributes?: Partial<Record<MailooLifecycleAttributeKey, unknown>>;
28
+ };
29
+ type MailooLifecycleEventValidation = {
30
+ ok: true;
31
+ value: MailooLifecycleEventInput;
32
+ } | {
33
+ ok: false;
34
+ message: string;
35
+ };
36
+ /**
37
+ * Parse and validate a lifecycle ingest body. Fail-fast — no default
38
+ * `eventName`. Used by BFF handlers and server ingest.
39
+ */
40
+ declare function validateMailooLifecycleEvent(body: unknown): MailooLifecycleEventValidation;
41
+ declare function isMailooLifecycleEventName(value: string): value is MailooLifecycleEventName;
42
+ /** Send row returned by lifecycle ingest / retry. */
43
+ type MailooLifecycleSendResult = {
44
+ sendId: string;
45
+ status: string;
46
+ messageId: string | null;
47
+ trackingToken: string;
48
+ campaignId: string | null;
49
+ };
50
+ /**
51
+ * Typed `data` from lifecycle ingest / retry success JSON.
52
+ * `contactId` is Mailoo's Subscriber cuid — not the host user id.
53
+ * Host identity key is `externalUserId` (e.g. Firebase UID).
54
+ */
55
+ type MailooLifecycleIngestData = {
56
+ eventId: string;
57
+ contactId: string;
58
+ idempotentReplay: boolean;
59
+ processingStatus: string;
60
+ skipReason: string | null;
61
+ send: MailooLifecycleSendResult | null;
62
+ };
63
+ type MailooLifecycleIngestSuccess = {
64
+ success: true;
65
+ data: MailooLifecycleIngestData;
66
+ };
67
+ type MailooLifecycleContactSummary = {
68
+ requestedExternalUserId: string | null;
69
+ requestedEmail: string | null;
70
+ matchedBy: 'externalUserId' | 'email' | null;
71
+ contactId: string | null;
72
+ externalUserId: string | null;
73
+ email: string | null;
74
+ marketingConsentGranted: boolean | null;
75
+ unsubscribedAt: string | null;
76
+ lastEvent: {
77
+ eventId: string;
78
+ eventName: string;
79
+ processingStatus: string;
80
+ skipReason: string | null;
81
+ createdAt: string;
82
+ } | null;
83
+ lastSend: {
84
+ sendId: string;
85
+ status: string;
86
+ messageId: string | null;
87
+ openedAt: string | null;
88
+ clickedAt: string | null;
89
+ } | null;
90
+ };
91
+ type MailooLifecycleStatusData = {
92
+ success: true;
93
+ configured: true;
94
+ contacts: number;
95
+ contact: Record<string, unknown> | null;
96
+ events: Array<Record<string, unknown>>;
97
+ sends: Array<Record<string, unknown>>;
98
+ segments: Array<{
99
+ id: string;
100
+ name: string;
101
+ systemKey: string | null;
102
+ }>;
103
+ summaries?: MailooLifecycleContactSummary[];
104
+ };
105
+ declare function parseMailooLifecycleIngestData(data: unknown): MailooLifecycleIngestData | null;
106
+
107
+ export { MAILOO_LIFECYCLE_ATTRIBUTE_KEYS, MAILOO_LIFECYCLE_EVENTS, MAILOO_LIFECYCLE_EVENT_NAMES, type MailooLifecycleAttributeKey, type MailooLifecycleContactSummary, type MailooLifecycleEventInput, type MailooLifecycleEventName, type MailooLifecycleEventValidation, type MailooLifecycleIngestData, type MailooLifecycleIngestSuccess, type MailooLifecycleSendResult, type MailooLifecycleStatusData, type MailooMarketingConsent, isMailooLifecycleEventName, parseMailooLifecycleIngestData, validateMailooLifecycleEvent };
@@ -0,0 +1,17 @@
1
+ import {
2
+ MAILOO_LIFECYCLE_ATTRIBUTE_KEYS,
3
+ MAILOO_LIFECYCLE_EVENTS,
4
+ MAILOO_LIFECYCLE_EVENT_NAMES,
5
+ isMailooLifecycleEventName,
6
+ parseMailooLifecycleIngestData,
7
+ validateMailooLifecycleEvent
8
+ } from "../chunk-4B377BWO.js";
9
+ export {
10
+ MAILOO_LIFECYCLE_ATTRIBUTE_KEYS,
11
+ MAILOO_LIFECYCLE_EVENTS,
12
+ MAILOO_LIFECYCLE_EVENT_NAMES,
13
+ isMailooLifecycleEventName,
14
+ parseMailooLifecycleIngestData,
15
+ validateMailooLifecycleEvent
16
+ };
17
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}