@first-to-fly/crm-sdk 1.11.0 → 1.13.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.
- package/README.md +129 -2
- package/dist/api.d.cts +2 -2
- package/dist/api.d.ts +2 -2
- package/dist/{crm-contracts-BeC2pzgj.d.cts → crm-contracts-Bl6_u353.d.cts} +72 -1
- package/dist/{crm-contracts-BeC2pzgj.d.ts → crm-contracts-Bl6_u353.d.ts} +72 -1
- package/dist/partner.cjs +1 -1
- package/dist/partner.cjs.map +1 -1
- package/dist/partner.d.cts +71 -8
- package/dist/partner.d.ts +71 -8
- package/dist/partner.js +1 -1
- package/dist/partner.js.map +1 -1
- package/package.json +1 -1
package/dist/partner.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export { y as ContactChangesQuery } from './crm-contracts-
|
|
1
|
+
import { a5 as PartnerWorkspaceUpsertBody$1, a0 as PartnerWorkspaceDetail$1, a2 as PartnerWorkspacePatchBody$1, a6 as PartnerWorkspaceUsage, z as ContactRefUpsertBody, A as ContactRefUpsertResult, H as PartnerContactEraseResult, F as PartnerContactEraseByIdentityBody, G as PartnerContactEraseByIdentityResult, x as ContactChanges } from './crm-contracts-Bl6_u353.js';
|
|
2
|
+
export { y as ContactChangesQuery } from './crm-contracts-Bl6_u353.js';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* Internal HTTP helper for the server-side `partner` entry point. Not part of the
|
|
@@ -11,6 +11,22 @@ export { y as ContactChangesQuery } from './crm-contracts-BeC2pzgj.js';
|
|
|
11
11
|
*/
|
|
12
12
|
type FetchLike = typeof fetch;
|
|
13
13
|
|
|
14
|
+
/**
|
|
15
|
+
* Files on the partner message channel, shared by the partner client and the webhook
|
|
16
|
+
* verifier. Internal: the types are re-exported from the `partner` entry point.
|
|
17
|
+
*/
|
|
18
|
+
/** One file on a partner app message. Fetch a link to it with `getPartnerMediaLinks`. */
|
|
19
|
+
interface PartnerMedia {
|
|
20
|
+
/** The CRM's file id. */
|
|
21
|
+
id: string;
|
|
22
|
+
name: string;
|
|
23
|
+
mimeType: string;
|
|
24
|
+
/** Bytes. */
|
|
25
|
+
size: number;
|
|
26
|
+
/** `image` for a JPEG, PNG or WebP photo; `file` for a PDF or Word document. */
|
|
27
|
+
kind: 'image' | 'file';
|
|
28
|
+
}
|
|
29
|
+
|
|
14
30
|
/**
|
|
15
31
|
* Verifier for the signed webhook the CRM sends for each staff reply on the partner message
|
|
16
32
|
* channel (server side ONLY: it uses `node:crypto`).
|
|
@@ -20,6 +36,7 @@ type FetchLike = typeof fetch;
|
|
|
20
36
|
* `rotateWebhookSecret`. Pass the body exactly as received: a body parsed and serialised again
|
|
21
37
|
* no longer matches the signature.
|
|
22
38
|
*/
|
|
39
|
+
|
|
23
40
|
/** A staff reply, as delivered by the webhook. */
|
|
24
41
|
interface PartnerMessageSentEvent {
|
|
25
42
|
event: 'partner_message.sent';
|
|
@@ -38,6 +55,8 @@ interface PartnerMessageSentEvent {
|
|
|
38
55
|
userRef: string | null;
|
|
39
56
|
name: string;
|
|
40
57
|
};
|
|
58
|
+
/** The reply's file (one at most); empty for a text reply, and from a CRM from before files. */
|
|
59
|
+
media: PartnerMedia[];
|
|
41
60
|
}
|
|
42
61
|
type PartnerWebhookVerificationReason = 'missing_headers' | 'stale_timestamp' | 'bad_signature' | 'bad_payload';
|
|
43
62
|
/** A delivery that failed verification. The message names the reason and nothing from the request. */
|
|
@@ -107,8 +126,10 @@ declare function verifyPartnerWebhook(input: VerifyPartnerWebhookInput): Partner
|
|
|
107
126
|
* `listPartnerMessageChanges`, and the webhook methods `setWebhook`, `getWebhook`,
|
|
108
127
|
* `rotateWebhookSecret`, `deleteWebhook`): customer messages go in, staff replies come back
|
|
109
128
|
* through the change feed or a signed webhook. Turn the channel on per workspace with
|
|
110
|
-
* `partnerChannelEnabled
|
|
111
|
-
*
|
|
129
|
+
* `partnerChannelEnabled`, and photos and files with `partnerFilesEnabled` (one file a message,
|
|
130
|
+
* see `PartnerMessageInput.file` and `getPartnerMediaLinks`). Codes the message endpoint can
|
|
131
|
+
* return, besides the common ones: `NOT_FOUND`, `CONTACT_NOT_FOUND`, `WORKSPACE_DISABLED`,
|
|
132
|
+
* `PARTNER_CHANNEL_DISABLED`, `PARTNER_FILES_DISABLED` (a file while files are off),
|
|
112
133
|
* `MESSAGE_REF_CONFLICT`, `THREAD_CONTACT_MISMATCH`, `RATE_LIMITED`, `VALIDATION_ERROR`
|
|
113
134
|
* and `SERVICE_BUSY`.
|
|
114
135
|
*
|
|
@@ -165,13 +186,20 @@ interface PartnerWorkspace {
|
|
|
165
186
|
aiMonthlyCapCredits: number | null;
|
|
166
187
|
/** Whether the partner message channel is on for this workspace (false from a CRM that does not report it). */
|
|
167
188
|
partnerChannelEnabled: boolean;
|
|
189
|
+
/** Whether photos and files are on for that channel (false from a CRM that does not report it). */
|
|
190
|
+
partnerFilesEnabled: boolean;
|
|
168
191
|
/** The workspace's own webhook URL; `null` = deliveries go to the URL set with `setWebhook`. */
|
|
169
192
|
webhookUrl: string | null;
|
|
170
193
|
}
|
|
171
194
|
/** Body of {@link CrmPartnerClient.upsertWorkspace}. */
|
|
172
|
-
type PartnerWorkspaceUpsertBody = Omit<PartnerWorkspaceUpsertBody$1, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'webhook_url'> & {
|
|
195
|
+
type PartnerWorkspaceUpsertBody = Omit<PartnerWorkspaceUpsertBody$1, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'partner_files_enabled' | 'webhook_url'> & {
|
|
173
196
|
/** Turns the partner message channel on or off. Omit to leave it unchanged (off on create). */
|
|
174
197
|
partnerChannelEnabled?: boolean;
|
|
198
|
+
/**
|
|
199
|
+
* Turns photos and files on or off for the channel. Omit to leave it unchanged (off on create).
|
|
200
|
+
* Files move only while `partnerChannelEnabled` is on too.
|
|
201
|
+
*/
|
|
202
|
+
partnerFilesEnabled?: boolean;
|
|
175
203
|
/** Webhook URL for this workspace, used instead of the partner's. `null` clears it; omit to leave it unchanged. */
|
|
176
204
|
webhookUrl?: string | null;
|
|
177
205
|
/**
|
|
@@ -181,9 +209,11 @@ type PartnerWorkspaceUpsertBody = Omit<PartnerWorkspaceUpsertBody$1, 'ai_monthly
|
|
|
181
209
|
aiMonthlyCapCredits?: number | null;
|
|
182
210
|
};
|
|
183
211
|
/** Body of {@link CrmPartnerClient.updateWorkspace}. At least one field is required. */
|
|
184
|
-
type PartnerWorkspacePatchBody = Omit<PartnerWorkspacePatchBody$1, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'webhook_url'> & {
|
|
212
|
+
type PartnerWorkspacePatchBody = Omit<PartnerWorkspacePatchBody$1, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'partner_files_enabled' | 'webhook_url'> & {
|
|
185
213
|
/** Turns the partner message channel on or off. */
|
|
186
214
|
partnerChannelEnabled?: boolean;
|
|
215
|
+
/** Turns photos and files on or off for the channel. */
|
|
216
|
+
partnerFilesEnabled?: boolean;
|
|
187
217
|
/** Webhook URL for this workspace, used instead of the partner's. `null` clears it. */
|
|
188
218
|
webhookUrl?: string | null;
|
|
189
219
|
/** Monthly AI cap in credits; `null` removes the cap, `0` switches AI off. */
|
|
@@ -235,7 +265,10 @@ interface PartnerMessageInput {
|
|
|
235
265
|
threadRef: string;
|
|
236
266
|
/** Your id for the message. Repeating it stores nothing new. */
|
|
237
267
|
messageRef: string;
|
|
238
|
-
/**
|
|
268
|
+
/**
|
|
269
|
+
* Plain text, 1 to 10,000 characters, not whitespace only. With `file` it is an optional
|
|
270
|
+
* caption: `''` for none.
|
|
271
|
+
*/
|
|
239
272
|
body: string;
|
|
240
273
|
/** When it was sent: a `Date`, or ISO 8601 with an offset. */
|
|
241
274
|
sentAt: string | Date;
|
|
@@ -243,12 +276,32 @@ interface PartnerMessageInput {
|
|
|
243
276
|
title?: string;
|
|
244
277
|
/** Your team key; the team is created if new. */
|
|
245
278
|
teamRef?: string;
|
|
279
|
+
/**
|
|
280
|
+
* One photo (JPEG, PNG, WebP) or document (PDF, DOC, DOCX) of at most 10 MB. Sent as
|
|
281
|
+
* `multipart/form-data` to `/messages/file`; refused with 409 `PARTNER_FILES_DISABLED`
|
|
282
|
+
* while the workspace's files are off. One file a message.
|
|
283
|
+
*/
|
|
284
|
+
file?: {
|
|
285
|
+
data: Blob | Uint8Array;
|
|
286
|
+
name: string;
|
|
287
|
+
type: string;
|
|
288
|
+
};
|
|
246
289
|
}
|
|
247
290
|
/** Result of {@link CrmPartnerClient.sendPartnerMessage}. `created` is false for a repeat of a stored `messageRef`. */
|
|
248
291
|
interface PartnerMessageResult {
|
|
249
292
|
conversationId: string;
|
|
250
293
|
messageId: string;
|
|
251
294
|
created: boolean;
|
|
295
|
+
/** The stored file of a message sent with `file` (on a repeat, the one stored the first time); `[]` otherwise. */
|
|
296
|
+
media: PartnerMedia[];
|
|
297
|
+
}
|
|
298
|
+
/** A signed link from {@link CrmPartnerClient.getPartnerMediaLinks}. */
|
|
299
|
+
interface PartnerMediaLink {
|
|
300
|
+
id: string;
|
|
301
|
+
/** HTTPS; do not store it. */
|
|
302
|
+
url: string;
|
|
303
|
+
/** ISO 8601 UTC; about one hour after the call. */
|
|
304
|
+
expiresAt: string;
|
|
252
305
|
}
|
|
253
306
|
/** One staff reply owed to you, from {@link CrmPartnerClient.listPartnerMessageChanges}. */
|
|
254
307
|
interface PartnerMessageChange {
|
|
@@ -267,6 +320,8 @@ interface PartnerMessageChange {
|
|
|
267
320
|
name: string;
|
|
268
321
|
};
|
|
269
322
|
deliveryStatus: 'pending' | 'delivered' | 'failed';
|
|
323
|
+
/** The reply's file (one at most); `[]` for a text reply, and from a CRM from before files. */
|
|
324
|
+
media: PartnerMedia[];
|
|
270
325
|
}
|
|
271
326
|
/** One page of {@link CrmPartnerClient.listPartnerMessageChanges}. */
|
|
272
327
|
interface PartnerMessageChangesPage {
|
|
@@ -341,6 +396,14 @@ interface CrmPartnerClient {
|
|
|
341
396
|
* `RATE_LIMITED` and `SERVICE_BUSY`.
|
|
342
397
|
*/
|
|
343
398
|
sendPartnerMessage(externalRef: string, message: PartnerMessageInput): Promise<PartnerMessageResult>;
|
|
399
|
+
/**
|
|
400
|
+
* Signed links (about one hour) to files of the conversation for `threadRef`: ids from
|
|
401
|
+
* `media` in a send result, the webhook or the change feed, 1 to 50 a call. Ids of another
|
|
402
|
+
* conversation or workspace, unknown or deleted are left out, so an unknown thread resolves
|
|
403
|
+
* `[]`. Request links when you show a file and do not store them. Works while the channel or
|
|
404
|
+
* its files are switched off.
|
|
405
|
+
*/
|
|
406
|
+
getPartnerMediaLinks(externalRef: string, threadRef: string, mediaIds: string[]): Promise<PartnerMediaLink[]>;
|
|
344
407
|
/** Delete the conversation for `threadRef`. `deleted: false` when there is none (already deleted, or never sent). */
|
|
345
408
|
deletePartnerConversation(externalRef: string, threadRef: string): Promise<{
|
|
346
409
|
deleted: boolean;
|
|
@@ -385,4 +448,4 @@ interface CrmPartnerClient {
|
|
|
385
448
|
}
|
|
386
449
|
declare function createCrmPartnerClient(opts: CrmPartnerClientOptions): CrmPartnerClient;
|
|
387
450
|
|
|
388
|
-
export { AI_MONTHLY_CAP_MAX_CREDITS, CONTACT_CHANGES_MAX_LIMIT, CONTACT_REF_PATTERN, ContactChanges, ContactRefUpsertBody, ContactRefUpsertResult, type CrmPartnerClient, type CrmPartnerClientOptions, CrmPartnerError, EXTERNAL_REF_PATTERN, PARTNER_MESSAGE_CHANGES_MAX_LIMIT, PartnerContactEraseByIdentityBody, PartnerContactEraseByIdentityResult, PartnerContactEraseResult, type PartnerMessageChange, type PartnerMessageChangesPage, type PartnerMessageInput, type PartnerMessageResult, type PartnerMessageSentEvent, type PartnerRotatedSecret, type PartnerUsageRange, PartnerWebhookVerificationError, type PartnerWebhookVerificationReason, type PartnerWorkspace, type PartnerWorkspaceDetail, type PartnerWorkspacePatchBody, type PartnerWorkspaceUpsertBody, type PartnerWorkspaceUpsertResult, PartnerWorkspaceUsage, type VerifyPartnerWebhookInput, createCrmPartnerClient, verifyPartnerWebhook };
|
|
451
|
+
export { AI_MONTHLY_CAP_MAX_CREDITS, CONTACT_CHANGES_MAX_LIMIT, CONTACT_REF_PATTERN, ContactChanges, ContactRefUpsertBody, ContactRefUpsertResult, type CrmPartnerClient, type CrmPartnerClientOptions, CrmPartnerError, EXTERNAL_REF_PATTERN, PARTNER_MESSAGE_CHANGES_MAX_LIMIT, PartnerContactEraseByIdentityBody, PartnerContactEraseByIdentityResult, PartnerContactEraseResult, type PartnerMedia, type PartnerMediaLink, type PartnerMessageChange, type PartnerMessageChangesPage, type PartnerMessageInput, type PartnerMessageResult, type PartnerMessageSentEvent, type PartnerRotatedSecret, type PartnerUsageRange, PartnerWebhookVerificationError, type PartnerWebhookVerificationReason, type PartnerWorkspace, type PartnerWorkspaceDetail, type PartnerWorkspacePatchBody, type PartnerWorkspaceUpsertBody, type PartnerWorkspaceUpsertResult, PartnerWorkspaceUsage, type VerifyPartnerWebhookInput, createCrmPartnerClient, verifyPartnerWebhook };
|
package/dist/partner.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
function A(e){return e.replace(/\/+$/,"").replace(/\/api$/,"")}function T(e,n){let c=e??globalThis.fetch;if(typeof c!="function")throw new Error(`${n}: no fetch implementation available. Pass \`fetch\` explicitly.`);return c}async function U(e,n,c,h){let k=new AbortController,g=!1,u=setTimeout(()=>{g=!0,k.abort()},n);try{let y={Accept:"application/json",...h.headers},l=h.body!==void 0;l&&(y["Content-Type"]="application/json");let R=await e(c,{method:h.method,headers:y,body:l?JSON.stringify(h.body):void 0,signal:k.signal}),s=await R.json().catch(()=>null);return g?{ok:!1,kind:"timeout"}:{ok:!0,status:R.status,json:s}}catch{return{ok:!1,kind:g?"timeout":"network"}}finally{clearTimeout(u)}}var j=/^[A-Za-z0-9_.:-]{1,60}$/;function B(e,n,c){let h=`HTTP_${n}`,k=g=>typeof g!="string"||!j.test(g)||c.some(u=>u&&g.includes(u))?null:g;if(e&&typeof e=="object"){let g=e,u=g.error;return k(g.code)??k(u)??(u&&typeof u=="object"?k(u.code):null)??h}return h}var f=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);import{createHmac as O,timingSafeEqual as L}from"crypto";var _=class e extends Error{constructor(n){super(`Partner webhook verification failed (${n})`),this.name="PartnerWebhookVerificationError",this.reason=n,Object.setPrototypeOf(this,e.prototype)}},F=300,G=/^[0-9a-fA-F]{64}$/,q=/^[0-9]{1,15}$/;function M(e,n){if(typeof e.get=="function")return e.get(n)||void 0;let c=e;for(let h of Object.keys(c)){if(h.toLowerCase()!==n)continue;let k=c[h],g=Array.isArray(k)?k[0]:k;if(typeof g=="string"&&g!=="")return g}}var C=e=>typeof e=="string",$=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);function H(e){let n;try{n=JSON.parse(e)}catch{throw new _("bad_payload")}if(!$(n)||n.event!=="partner_message.sent")throw new _("bad_payload");let{sender:c}=n;if(!C(n.delivery_id)||!C(n.external_ref)||!C(n.thread_ref)||!C(n.conversation_id)||!C(n.message_id)||!C(n.body)||!C(n.sent_at)||!$(c)||!C(c.name)||!(c.user_ref===null||C(c.user_ref)))throw new _("bad_payload");return{event:"partner_message.sent",deliveryId:n.delivery_id,externalRef:n.external_ref,threadRef:n.thread_ref,conversationId:n.conversation_id,messageId:n.message_id,body:n.body,sentAt:n.sent_at,sender:{userRef:c.user_ref,name:c.name}}}function V(e){if(typeof e.secret!="string"||e.secret==="")throw new TypeError("verifyPartnerWebhook: secret must be a non-empty string");if(typeof e.rawBody!="string")throw new TypeError("verifyPartnerWebhook: rawBody must be a string (the body exactly as received)");if(e.toleranceSeconds!==void 0&&!(Number.isFinite(e.toleranceSeconds)&&e.toleranceSeconds>=0))throw new TypeError("verifyPartnerWebhook: toleranceSeconds must be a finite number of at least 0");let n=M(e.headers,"x-crm-timestamp"),c=M(e.headers,"x-crm-signature");if(n===void 0||c===void 0)throw new _("missing_headers");let h=e.toleranceSeconds??F,k=(e.now??Date.now)()/1e3;if(!q.test(n)||!Number.isFinite(k)||Math.abs(k-Number(n))>h)throw new _("stale_timestamp");if(!G.test(c))throw new _("bad_signature");let g=O("sha256",e.secret).update(`${n}.${e.rawBody}`).digest();if(!L(g,Buffer.from(c,"hex")))throw new _("bad_signature");return H(e.rawBody)}var p=class e extends Error{constructor(n,c){super(n===0?`CRM partner API unreachable (${c})`:`CRM partner API ${n} ${c}`),this.name="CrmPartnerError",this.status=n,this.code=c,Object.setPrototypeOf(this,e.prototype)}},K=/^[A-Za-z0-9_-]{1,64}$/,v=/^[A-Za-z0-9._:-]{1,200}$/,X=200,Z=500,J=1e8,W=e=>({externalRef:e.external_ref,workspaceId:e.workspace_id,embedAppId:e.embed_app_id,enabled:e.enabled,aiMonthlyCapCredits:typeof e.ai_monthly_cap_credits=="number"?e.ai_monthly_cap_credits:null,partnerChannelEnabled:e.partner_channel_enabled===!0,webhookUrl:typeof e.webhook_url=="string"?e.webhook_url:null});function Q(e){if(e instanceof Date){if(Number.isNaN(e.getTime()))throw new p(400,"invalid_date");return e.toISOString()}if(typeof e!="string")throw new p(400,"invalid_date");return e}function Y(e){return f(e)&&typeof e.delivery_id=="string"&&typeof e.external_ref=="string"&&typeof e.thread_ref=="string"&&typeof e.conversation_id=="string"&&typeof e.message_id=="string"&&typeof e.body=="string"&&typeof e.sent_at=="string"&&f(e.sender)&&I(e.sender.user_ref)&&typeof e.sender.name=="string"&&(e.delivery_status==="pending"||e.delivery_status==="delivered"||e.delivery_status==="failed")}var ee=/^\d{4}-\d{2}-\d{2}$/;function N(e){let n=e instanceof Date&&!Number.isNaN(e.getTime())?e.toISOString().slice(0,10):e;if(typeof n!="string"||!ee.test(n)||Number.isNaN(Date.parse(`${n}T00:00:00Z`))||new Date(`${n}T00:00:00Z`).toISOString().slice(0,10)!==n)throw new p(400,"invalid_date");return n}function D(e){if(e==null)return e;if(typeof e!="number"||!Number.isInteger(e)||e<0||e>J)throw new p(400,"invalid_cap");return e}var I=e=>e===null||typeof e=="string";function S(e){return f(e)&&typeof e.external_ref=="string"&&I(e.workspace_id)&&I(e.embed_app_id)&&typeof e.enabled=="boolean"}function ae(e){if(!e.crmBaseUrl)throw new Error("createCrmPartnerClient: `crmBaseUrl` is required.");if(!e.partnerKey)throw new Error("createCrmPartnerClient: `partnerKey` is required.");let n=T(e.fetch,"createCrmPartnerClient"),c=e.timeoutMs??15e3,h=`${A(e.crmBaseUrl)}/api/partner/v1`,k=`${h}/workspaces`,g=[e.partnerKey];function u(s){if(typeof s!="string"||!K.test(s))throw new p(400,"invalid_external_ref");return s}async function y(s,t,i,a=k){let r=await U(n,c,`${a}/${t}`,{method:s,headers:{Authorization:`Bearer ${e.partnerKey}`},body:i});if(!r.ok)throw new p(0,r.kind);if(r.status<200||r.status>=300)throw new p(r.status,B(r.json,r.status,g));return{status:r.status,json:r.json}}let l=s=>new p(s,"bad_response");function R(s){if(typeof s!="string"||!v.test(s))throw new p(400,"invalid_contact_ref");return s}return{async upsertWorkspace(s,t){let i=u(s),{aiMonthlyCapCredits:a,partnerChannelEnabled:r,webhookUrl:o,...d}=t,w=D(a),m={...d};w!==void 0&&(m.ai_monthly_cap_credits=w),r!==void 0&&(m.partner_channel_enabled=r),o!==void 0&&(m.webhook_url=o);let{status:b,json:E}=await y("PUT",i,m);if(!S(E))throw l(b);let P=E;if(P.created===!0){let x=P.embed_app_secret;if(typeof x!="string"||!x)throw l(b);return{...W(P),created:!0,embedAppSecret:x}}if(P.created===!1)return{...W(P),created:!1};throw l(b)},async getWorkspace(s){let t=u(s);try{let{status:i,json:a}=await y("GET",t);if(!S(a)||typeof a.state!="string")throw l(i);let r=a.ai;return{...W(a),state:a.state,ai:f(r)&&typeof r.period=="string"&&typeof r.used_credits=="number"?{period:r.period,usedCredits:r.used_credits}:null}}catch(i){if(i instanceof p&&i.status===404)return null;throw i}},async updateWorkspace(s,t){let i=u(s),a={};t.enabled!==void 0&&(a.enabled=t.enabled),t.name!==void 0&&(a.name=t.name);let r=D(t.aiMonthlyCapCredits);r!==void 0&&(a.ai_monthly_cap_credits=r),t.partnerChannelEnabled!==void 0&&(a.partner_channel_enabled=t.partnerChannelEnabled),t.webhookUrl!==void 0&&(a.webhook_url=t.webhookUrl);let{status:o,json:d}=await y("PATCH",i,a);if(!S(d))throw l(o);return W(d)},async getWorkspaceUsage(s,t){let i=u(s),a=new URLSearchParams({from:N(t.from),to:N(t.to)});try{let{status:r,json:o}=await y("GET",`${i}/usage?${a.toString()}`);if(!f(o)||!f(o.totals)||!f(o.cap)||!Array.isArray(o.by_operation))throw l(r);return o}catch(r){if(r instanceof p&&r.status===404)return null;throw r}},async rotateWorkspaceSecret(s){let t=u(s),{status:i,json:a}=await y("POST",`${t}/rotate-secret`),r=a;if(!f(a)||typeof r?.embed_app_id!="string"||typeof r.embed_app_secret!="string"||!r.embed_app_secret)throw l(i);return{embedAppId:r.embed_app_id,embedAppSecret:r.embed_app_secret}},async upsertContact(s,t,i){let a=u(s),r=R(t),{status:o,json:d}=await y("PUT",`${a}/contacts/${encodeURIComponent(r)}`,i);if(!f(d)||!f(d.contact)||typeof d.created!="boolean"||typeof d.consent_applied!="boolean")throw l(o);return d},async eraseContact(s,t){let i=u(s),a=R(t);try{let{status:r,json:o}=await y("DELETE",`${i}/contacts/${encodeURIComponent(a)}`);if(!f(o)||o.erased!==!0||typeof o.contact_id!="string")throw l(r);return o}catch(r){if(r instanceof p&&r.status===404)return null;throw r}},async eraseContactsByIdentity(s,t){let i=u(s),a=typeof t?.phone=="string"?t.phone.trim():void 0,r=typeof t?.email=="string"?t.email.trim():void 0,o=a!==void 0&&/\d/.test(a),d=r!==void 0&&r.includes("@");if(t?.phone!==void 0&&!o||t?.email!==void 0&&!d||!o&&!d)throw new p(400,"invalid_identity");t.ref!==void 0&&R(t.ref);let w={};o&&(w.phone=a),d&&(w.email=r),t.ref!==void 0&&(w.ref=t.ref);try{let{status:m,json:b}=await y("POST",`${i}/contacts/erase-by-identity`,w);if(!f(b)||typeof b.erased!="number"||!Array.isArray(b.contact_ids)||typeof b.skipped_linked_elsewhere!="number")throw l(m);return b}catch(m){if(m instanceof p&&m.status===404)return null;throw m}},async listContactChanges(s,t={}){let i=u(s),{since:a,cursor:r,limit:o}=t;if(o!==void 0&&(!Number.isInteger(o)||o<1||o>X))throw new p(400,"invalid_limit");let d=new URLSearchParams;a!==void 0&&d.set("since",a),r!==void 0&&d.set("cursor",r),o!==void 0&&d.set("limit",String(o));let w=d.toString(),{status:m,json:b}=await y("GET",`${i}/contacts/changes${w?`?${w}`:""}`);if(!f(b)||!Array.isArray(b.items)||!(b.next_cursor===null||typeof b.next_cursor=="string"))throw l(m);return b},async sendPartnerMessage(s,t){let i=u(s),a={contact_ref:R(t.contactRef),thread_ref:t.threadRef,message_ref:t.messageRef,body:t.body,sent_at:Q(t.sentAt)};t.title!==void 0&&(a.title=t.title),t.teamRef!==void 0&&(a.team_ref=t.teamRef);let{status:r,json:o}=await y("POST",`${i}/messages`,a);if(!f(o)||typeof o.conversation_id!="string"||typeof o.message_id!="string"||typeof o.created!="boolean")throw l(r);let d=o;return{conversationId:d.conversation_id,messageId:d.message_id,created:d.created}},async deletePartnerConversation(s,t){let i=u(s);if(typeof t!="string"||!v.test(t)||t==="."||t==="..")throw new p(400,"invalid_thread_ref");let{status:a,json:r}=await y("DELETE",`${i}/conversations/${encodeURIComponent(t)}`);if(!f(r)||typeof r.deleted!="boolean")throw l(a);return{deleted:r.deleted}},async listPartnerMessageChanges(s,t={}){let i=u(s),{cursor:a,limit:r}=t;if(r!==void 0&&(!Number.isInteger(r)||r<1||r>Z))throw new p(400,"invalid_limit");let o=new URLSearchParams;a!==void 0&&o.set("cursor",a),r!==void 0&&o.set("limit",String(r));let d=o.toString(),{status:w,json:m}=await y("GET",`${i}/messages/changes${d?`?${d}`:""}`);if(!f(m)||!Array.isArray(m.items)||!(m.next_cursor===null||typeof m.next_cursor=="string"))throw l(w);let b=m;return{items:b.items.map(P=>{if(!Y(P))throw l(w);return{deliveryId:P.delivery_id,externalRef:P.external_ref,threadRef:P.thread_ref,conversationId:P.conversation_id,messageId:P.message_id,body:P.body,sentAt:P.sent_at,sender:{userRef:P.sender.user_ref,name:P.sender.name},deliveryStatus:P.delivery_status}}),nextCursor:b.next_cursor}},async setWebhook(s){let t={url:s.url},{status:i,json:a}=await y("PUT","webhook",t,h);if(!f(a)||typeof a.url!="string")throw l(i);if(i===201){let r=a.secret;if(typeof r!="string"||!r)throw l(i);return{url:a.url,secret:r}}return{url:a.url}},async getWebhook(){try{let{status:s,json:t}=await y("GET","webhook",void 0,h);if(!f(t)||typeof t.url!="string"||t.has_secret!==!0)throw l(s);return{url:t.url,hasSecret:!0}}catch(s){if(s instanceof p&&s.status===404)return null;throw s}},async rotateWebhookSecret(){let{status:s,json:t}=await y("POST","webhook/rotate-secret",void 0,h),i=f(t)?t.secret:void 0;if(typeof i!="string"||!i)throw l(s);return{secret:i}},async deleteWebhook(){await y("DELETE","webhook",void 0,h)}}}export{J as AI_MONTHLY_CAP_MAX_CREDITS,X as CONTACT_CHANGES_MAX_LIMIT,v as CONTACT_REF_PATTERN,p as CrmPartnerError,K as EXTERNAL_REF_PATTERN,Z as PARTNER_MESSAGE_CHANGES_MAX_LIMIT,_ as PartnerWebhookVerificationError,ae as createCrmPartnerClient,V as verifyPartnerWebhook};
|
|
1
|
+
function j(e){return e.replace(/\/+$/,"").replace(/\/api$/,"")}function v(e,n){let i=e??globalThis.fetch;if(typeof i!="function")throw new Error(`${n}: no fetch implementation available. Pass \`fetch\` explicitly.`);return i}async function F(e,n,i,f){let P=new AbortController,g=!1,p=setTimeout(()=>{g=!0,P.abort()},n);try{let m={Accept:"application/json",...f.headers},E=f.body!==void 0;E&&(m["Content-Type"]="application/json");let l=await e(i,{method:f.method,headers:m,body:E?JSON.stringify(f.body):void 0,signal:P.signal}),S=await l.json().catch(()=>null);return g?{ok:!1,kind:"timeout"}:{ok:!0,status:l.status,json:S}}catch{return{ok:!1,kind:g?"timeout":"network"}}finally{clearTimeout(p)}}async function D(e,n,i,f){let P=new AbortController,g=!1,p=setTimeout(()=>{g=!0,P.abort()},n);try{let m=await e(i,{method:f.method,headers:{Accept:"application/json",...f.headers},body:f.form,signal:P.signal}),E=await m.json().catch(()=>null);return g?{ok:!1,kind:"timeout"}:{ok:!0,status:m.status,json:E}}catch{return{ok:!1,kind:g?"timeout":"network"}}finally{clearTimeout(p)}}var H=/^[A-Za-z0-9_.:-]{1,60}$/;function T(e,n,i){let f=`HTTP_${n}`,P=g=>typeof g!="string"||!H.test(g)||i.some(p=>p&&g.includes(p))?null:g;if(e&&typeof e=="object"){let g=e,p=g.error;return P(g.code)??P(p)??(p&&typeof p=="object"?P(p.code):null)??f}return f}var b=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);var V=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);function A(e){if(e===void 0)return[];if(!Array.isArray(e))return null;let n=[];for(let i of e){if(!V(i)||typeof i.id!="string"||typeof i.name!="string"||typeof i.mime_type!="string"||typeof i.size!="number"||!Number.isFinite(i.size)||i.kind!=="image"&&i.kind!=="file")return null;n.push({id:i.id,name:i.name,mimeType:i.mime_type,size:i.size,kind:i.kind})}return n}import{createHmac as K,timingSafeEqual as X}from"crypto";var C=class e extends Error{constructor(n){super(`Partner webhook verification failed (${n})`),this.name="PartnerWebhookVerificationError",this.reason=n,Object.setPrototypeOf(this,e.prototype)}},Z=300,J=/^[0-9a-fA-F]{64}$/,Q=/^[0-9]{1,15}$/;function N(e,n){if(typeof e.get=="function")return e.get(n)||void 0;let i=e;for(let f of Object.keys(i)){if(f.toLowerCase()!==n)continue;let P=i[f],g=Array.isArray(P)?P[0]:P;if(typeof g=="string"&&g!=="")return g}}var R=e=>typeof e=="string",O=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);function Y(e){let n;try{n=JSON.parse(e)}catch{throw new C("bad_payload")}if(!O(n)||n.event!=="partner_message.sent")throw new C("bad_payload");let{sender:i}=n;if(!R(n.delivery_id)||!R(n.external_ref)||!R(n.thread_ref)||!R(n.conversation_id)||!R(n.message_id)||!R(n.body)||!R(n.sent_at)||!O(i)||!R(i.name)||!(i.user_ref===null||R(i.user_ref)))throw new C("bad_payload");let f=A(n.media);if(f===null)throw new C("bad_payload");return{event:"partner_message.sent",deliveryId:n.delivery_id,externalRef:n.external_ref,threadRef:n.thread_ref,conversationId:n.conversation_id,messageId:n.message_id,body:n.body,sentAt:n.sent_at,sender:{userRef:i.user_ref,name:i.name},media:f}}function ee(e){if(typeof e.secret!="string"||e.secret==="")throw new TypeError("verifyPartnerWebhook: secret must be a non-empty string");if(typeof e.rawBody!="string")throw new TypeError("verifyPartnerWebhook: rawBody must be a string (the body exactly as received)");if(e.toleranceSeconds!==void 0&&!(Number.isFinite(e.toleranceSeconds)&&e.toleranceSeconds>=0))throw new TypeError("verifyPartnerWebhook: toleranceSeconds must be a finite number of at least 0");let n=N(e.headers,"x-crm-timestamp"),i=N(e.headers,"x-crm-signature");if(n===void 0||i===void 0)throw new C("missing_headers");let f=e.toleranceSeconds??Z,P=(e.now??Date.now)()/1e3;if(!Q.test(n)||!Number.isFinite(P)||Math.abs(P-Number(n))>f)throw new C("stale_timestamp");if(!J.test(i))throw new C("bad_signature");let g=K("sha256",e.secret).update(`${n}.${e.rawBody}`).digest();if(!X(g,Buffer.from(i,"hex")))throw new C("bad_signature");return Y(e.rawBody)}var k=class e extends Error{constructor(n,i){super(n===0?`CRM partner API unreachable (${i})`:`CRM partner API ${n} ${i}`),this.name="CrmPartnerError",this.status=n,this.code=i,Object.setPrototypeOf(this,e.prototype)}},re=/^[A-Za-z0-9_-]{1,64}$/,L=/^[A-Za-z0-9._:-]{1,200}$/,ne=200,se=500,ae=1e8,I=e=>({externalRef:e.external_ref,workspaceId:e.workspace_id,embedAppId:e.embed_app_id,enabled:e.enabled,aiMonthlyCapCredits:typeof e.ai_monthly_cap_credits=="number"?e.ai_monthly_cap_credits:null,partnerChannelEnabled:e.partner_channel_enabled===!0,partnerFilesEnabled:e.partner_files_enabled===!0,webhookUrl:typeof e.webhook_url=="string"?e.webhook_url:null});function oe(e){if(e instanceof Date){if(Number.isNaN(e.getTime()))throw new k(400,"invalid_date");return e.toISOString()}if(typeof e!="string")throw new k(400,"invalid_date");return e}function ie(e){return b(e)&&typeof e.delivery_id=="string"&&typeof e.external_ref=="string"&&typeof e.thread_ref=="string"&&typeof e.conversation_id=="string"&&typeof e.message_id=="string"&&typeof e.body=="string"&&typeof e.sent_at=="string"&&b(e.sender)&&U(e.sender.user_ref)&&typeof e.sender.name=="string"&&(e.delivery_status==="pending"||e.delivery_status==="delivered"||e.delivery_status==="failed")}var ce=/^\d{4}-\d{2}-\d{2}$/;function G(e){let n=e instanceof Date&&!Number.isNaN(e.getTime())?e.toISOString().slice(0,10):e;if(typeof n!="string"||!ce.test(n)||Number.isNaN(Date.parse(`${n}T00:00:00Z`))||new Date(`${n}T00:00:00Z`).toISOString().slice(0,10)!==n)throw new k(400,"invalid_date");return n}function z(e){if(e==null)return e;if(typeof e!="number"||!Number.isInteger(e)||e<0||e>ae)throw new k(400,"invalid_cap");return e}var U=e=>e===null||typeof e=="string";function B(e){return b(e)&&typeof e.external_ref=="string"&&U(e.workspace_id)&&U(e.embed_app_id)&&typeof e.enabled=="boolean"}function me(e){if(!e.crmBaseUrl)throw new Error("createCrmPartnerClient: `crmBaseUrl` is required.");if(!e.partnerKey)throw new Error("createCrmPartnerClient: `partnerKey` is required.");let n=v(e.fetch,"createCrmPartnerClient"),i=e.timeoutMs??15e3,f=`${j(e.crmBaseUrl)}/api/partner/v1`,P=`${f}/workspaces`,g=[e.partnerKey];function p(s){if(typeof s!="string"||!re.test(s))throw new k(400,"invalid_external_ref");return s}async function m(s,t,o,a=P){let r=await F(n,i,`${a}/${t}`,{method:s,headers:{Authorization:`Bearer ${e.partnerKey}`},body:o});if(!r.ok)throw new k(0,r.kind);if(r.status<200||r.status>=300)throw new k(r.status,T(r.json,r.status,g));return{status:r.status,json:r.json}}async function E(s,t){let o=await D(n,i,`${P}/${s}`,{method:"POST",headers:{Authorization:`Bearer ${e.partnerKey}`},form:t});if(!o.ok)throw new k(0,o.kind);if(o.status<200||o.status>=300)throw new k(o.status,T(o.json,o.status,g));return{status:o.status,json:o.json}}let l=s=>new k(s,"bad_response");function S(s){if(typeof s!="string"||!L.test(s)||s==="."||s==="..")throw new k(400,"invalid_thread_ref");return s}function M(s){if(typeof s!="string"||!L.test(s))throw new k(400,"invalid_contact_ref");return s}return{async upsertWorkspace(s,t){let o=p(s),{aiMonthlyCapCredits:a,partnerChannelEnabled:r,partnerFilesEnabled:c,webhookUrl:d,...h}=t,u=z(a),y={...h};u!==void 0&&(y.ai_monthly_cap_credits=u),r!==void 0&&(y.partner_channel_enabled=r),c!==void 0&&(y.partner_files_enabled=c),d!==void 0&&(y.webhook_url=d);let{status:W,json:w}=await m("PUT",o,y);if(!B(w))throw l(W);let _=w;if(_.created===!0){let x=_.embed_app_secret;if(typeof x!="string"||!x)throw l(W);return{...I(_),created:!0,embedAppSecret:x}}if(_.created===!1)return{...I(_),created:!1};throw l(W)},async getWorkspace(s){let t=p(s);try{let{status:o,json:a}=await m("GET",t);if(!B(a)||typeof a.state!="string")throw l(o);let r=a.ai;return{...I(a),state:a.state,ai:b(r)&&typeof r.period=="string"&&typeof r.used_credits=="number"?{period:r.period,usedCredits:r.used_credits}:null}}catch(o){if(o instanceof k&&o.status===404)return null;throw o}},async updateWorkspace(s,t){let o=p(s),a={};t.enabled!==void 0&&(a.enabled=t.enabled),t.name!==void 0&&(a.name=t.name);let r=z(t.aiMonthlyCapCredits);r!==void 0&&(a.ai_monthly_cap_credits=r),t.partnerChannelEnabled!==void 0&&(a.partner_channel_enabled=t.partnerChannelEnabled),t.partnerFilesEnabled!==void 0&&(a.partner_files_enabled=t.partnerFilesEnabled),t.webhookUrl!==void 0&&(a.webhook_url=t.webhookUrl);let{status:c,json:d}=await m("PATCH",o,a);if(!B(d))throw l(c);return I(d)},async getWorkspaceUsage(s,t){let o=p(s),a=new URLSearchParams({from:G(t.from),to:G(t.to)});try{let{status:r,json:c}=await m("GET",`${o}/usage?${a.toString()}`);if(!b(c)||!b(c.totals)||!b(c.cap)||!Array.isArray(c.by_operation))throw l(r);return c}catch(r){if(r instanceof k&&r.status===404)return null;throw r}},async rotateWorkspaceSecret(s){let t=p(s),{status:o,json:a}=await m("POST",`${t}/rotate-secret`),r=a;if(!b(a)||typeof r?.embed_app_id!="string"||typeof r.embed_app_secret!="string"||!r.embed_app_secret)throw l(o);return{embedAppId:r.embed_app_id,embedAppSecret:r.embed_app_secret}},async upsertContact(s,t,o){let a=p(s),r=M(t),{status:c,json:d}=await m("PUT",`${a}/contacts/${encodeURIComponent(r)}`,o);if(!b(d)||!b(d.contact)||typeof d.created!="boolean"||typeof d.consent_applied!="boolean")throw l(c);return d},async eraseContact(s,t){let o=p(s),a=M(t);try{let{status:r,json:c}=await m("DELETE",`${o}/contacts/${encodeURIComponent(a)}`);if(!b(c)||c.erased!==!0||typeof c.contact_id!="string")throw l(r);return c}catch(r){if(r instanceof k&&r.status===404)return null;throw r}},async eraseContactsByIdentity(s,t){let o=p(s),a=typeof t?.phone=="string"?t.phone.trim():void 0,r=typeof t?.email=="string"?t.email.trim():void 0,c=a!==void 0&&/\d/.test(a),d=r!==void 0&&r.includes("@");if(t?.phone!==void 0&&!c||t?.email!==void 0&&!d||!c&&!d)throw new k(400,"invalid_identity");t.ref!==void 0&&M(t.ref);let h={};c&&(h.phone=a),d&&(h.email=r),t.ref!==void 0&&(h.ref=t.ref);try{let{status:u,json:y}=await m("POST",`${o}/contacts/erase-by-identity`,h);if(!b(y)||typeof y.erased!="number"||!Array.isArray(y.contact_ids)||typeof y.skipped_linked_elsewhere!="number")throw l(u);return y}catch(u){if(u instanceof k&&u.status===404)return null;throw u}},async listContactChanges(s,t={}){let o=p(s),{since:a,cursor:r,limit:c}=t;if(c!==void 0&&(!Number.isInteger(c)||c<1||c>ne))throw new k(400,"invalid_limit");let d=new URLSearchParams;a!==void 0&&d.set("since",a),r!==void 0&&d.set("cursor",r),c!==void 0&&d.set("limit",String(c));let h=d.toString(),{status:u,json:y}=await m("GET",`${o}/contacts/changes${h?`?${h}`:""}`);if(!b(y)||!Array.isArray(y.items)||!(y.next_cursor===null||typeof y.next_cursor=="string"))throw l(u);return y},async sendPartnerMessage(s,t){let o=p(s),a={contact_ref:M(t.contactRef),thread_ref:t.threadRef,message_ref:t.messageRef,body:t.body,sent_at:oe(t.sentAt)};t.title!==void 0&&(a.title=t.title),t.teamRef!==void 0&&(a.team_ref=t.teamRef);let r;if(t.file){let y=new FormData;for(let[q,$]of Object.entries(a))$!==void 0&&y.append(q,String($));let{data:W,name:w,type:_}=t.file,x=W instanceof Blob?W:new Blob([W],{type:_});y.append("file",x.type===_?x:new Blob([x],{type:_}),w),r=await E(`${o}/messages/file`,y)}else r=await m("POST",`${o}/messages`,a);let{status:c,json:d}=r;if(!b(d)||typeof d.conversation_id!="string"||typeof d.message_id!="string"||typeof d.created!="boolean")throw l(c);let h=d,u=A(h.media);if(u===null)throw l(c);return{conversationId:h.conversation_id,messageId:h.message_id,created:h.created,media:u}},async getPartnerMediaLinks(s,t,o){let a=p(s),r=S(t),c={media_ids:o},{status:d,json:h}=await m("POST",`${a}/conversations/${encodeURIComponent(r)}/media-links`,c);if(!b(h)||!Array.isArray(h.items))throw l(d);return h.items.map(u=>{if(!b(u)||typeof u.id!="string"||typeof u.url!="string"||typeof u.expires_at!="string")throw l(d);return{id:u.id,url:u.url,expiresAt:u.expires_at}})},async deletePartnerConversation(s,t){let o=p(s),a=S(t),{status:r,json:c}=await m("DELETE",`${o}/conversations/${encodeURIComponent(a)}`);if(!b(c)||typeof c.deleted!="boolean")throw l(r);return{deleted:c.deleted}},async listPartnerMessageChanges(s,t={}){let o=p(s),{cursor:a,limit:r}=t;if(r!==void 0&&(!Number.isInteger(r)||r<1||r>se))throw new k(400,"invalid_limit");let c=new URLSearchParams;a!==void 0&&c.set("cursor",a),r!==void 0&&c.set("limit",String(r));let d=c.toString(),{status:h,json:u}=await m("GET",`${o}/messages/changes${d?`?${d}`:""}`);if(!b(u)||!Array.isArray(u.items)||!(u.next_cursor===null||typeof u.next_cursor=="string"))throw l(h);let y=u;return{items:y.items.map(w=>{if(!ie(w))throw l(h);let _=A(w.media);if(_===null)throw l(h);return{deliveryId:w.delivery_id,externalRef:w.external_ref,threadRef:w.thread_ref,conversationId:w.conversation_id,messageId:w.message_id,body:w.body,sentAt:w.sent_at,sender:{userRef:w.sender.user_ref,name:w.sender.name},deliveryStatus:w.delivery_status,media:_}}),nextCursor:y.next_cursor}},async setWebhook(s){let t={url:s.url},{status:o,json:a}=await m("PUT","webhook",t,f);if(!b(a)||typeof a.url!="string")throw l(o);if(o===201){let r=a.secret;if(typeof r!="string"||!r)throw l(o);return{url:a.url,secret:r}}return{url:a.url}},async getWebhook(){try{let{status:s,json:t}=await m("GET","webhook",void 0,f);if(!b(t)||typeof t.url!="string"||t.has_secret!==!0)throw l(s);return{url:t.url,hasSecret:!0}}catch(s){if(s instanceof k&&s.status===404)return null;throw s}},async rotateWebhookSecret(){let{status:s,json:t}=await m("POST","webhook/rotate-secret",void 0,f),o=b(t)?t.secret:void 0;if(typeof o!="string"||!o)throw l(s);return{secret:o}},async deleteWebhook(){await m("DELETE","webhook",void 0,f)}}}export{ae as AI_MONTHLY_CAP_MAX_CREDITS,ne as CONTACT_CHANGES_MAX_LIMIT,L as CONTACT_REF_PATTERN,k as CrmPartnerError,re as EXTERNAL_REF_PATTERN,se as PARTNER_MESSAGE_CHANGES_MAX_LIMIT,C as PartnerWebhookVerificationError,me as createCrmPartnerClient,ee as verifyPartnerWebhook};
|
|
2
2
|
//# sourceMappingURL=partner.js.map
|
package/dist/partner.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/server-http.ts","../src/partner-webhook.ts","../src/partner.ts"],"sourcesContent":["/**\n * Internal HTTP helper for the server-side `partner` entry point. Not part of the\n * public API (no package export points here).\n *\n * It never puts a request header, a request body or a response body into an\n * error: callers get the HTTP status, a short sanitized error code, or a\n * transport failure kind, and nothing else.\n */\n\nexport type FetchLike = typeof fetch;\n\nexport const DEFAULT_TIMEOUT_MS = 15_000;\n\nexport type Transport =\n | { ok: true; status: number; json: unknown }\n | { ok: false; kind: 'timeout' | 'network' };\n\n/** Strip trailing slashes and a trailing `/api`, so callers can pass either form. */\nexport function normalizeBase(crmBaseUrl: string): string {\n return crmBaseUrl.replace(/\\/+$/, '').replace(/\\/api$/, '');\n}\n\nexport function resolveFetch(fetchImpl: FetchLike | undefined, who: string): FetchLike {\n const f = fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') {\n throw new Error(`${who}: no fetch implementation available. Pass \\`fetch\\` explicitly.`);\n }\n return f;\n}\n\n/**\n * One request with a hard timeout covering headers AND body. Returns the parsed\n * JSON (null when the body is empty or not JSON) or a transport failure kind.\n */\nexport async function sendJson(\n fetchImpl: FetchLike,\n timeoutMs: number,\n url: string,\n init: { method: string; headers: Record<string, string>; body?: unknown },\n): Promise<Transport> {\n const controller = new AbortController();\n let timedOut = false;\n const timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, timeoutMs);\n try {\n const headers: Record<string, string> = { Accept: 'application/json', ...init.headers };\n const hasBody = init.body !== undefined;\n if (hasBody) headers['Content-Type'] = 'application/json';\n const res = await fetchImpl(url, {\n method: init.method,\n headers,\n body: hasBody ? JSON.stringify(init.body) : undefined,\n signal: controller.signal,\n });\n const json: unknown = await res.json().catch(() => null);\n if (timedOut) return { ok: false, kind: 'timeout' };\n return { ok: true, status: res.status, json };\n } catch {\n return { ok: false, kind: timedOut ? 'timeout' : 'network' };\n } finally {\n clearTimeout(timer);\n }\n}\n\nconst SAFE_CODE = /^[A-Za-z0-9_.:-]{1,60}$/;\n\n/**\n * A short machine code from an error body, or `HTTP_<status>`. Accepts\n * `{ error: { code } }`, `{ error: \"code\" }` and `{ code }`. A value that is not\n * a short identifier (a sentence, a long string) or that contains one of the\n * `redact` strings (credentials) is dropped, so a code is always safe to log.\n */\nexport function errorCodeFrom(json: unknown, status: number, redact: readonly string[]): string {\n const fallback = `HTTP_${status}`;\n const pick = (v: unknown): string | null => {\n if (typeof v !== 'string' || !SAFE_CODE.test(v)) return null;\n return redact.some((r) => r && v.includes(r)) ? null : v;\n };\n if (json && typeof json === 'object') {\n const o = json as Record<string, unknown>;\n const err = o.error;\n return (\n pick(o.code)\n ?? pick(err)\n ?? (err && typeof err === 'object' ? pick((err as Record<string, unknown>).code) : null)\n ?? fallback\n );\n }\n return fallback;\n}\n\nexport const isRecord = (v: unknown): v is Record<string, unknown> =>\n typeof v === 'object' && v !== null && !Array.isArray(v);\n","/**\n * Verifier for the signed webhook the CRM sends for each staff reply on the partner message\n * channel (server side ONLY: it uses `node:crypto`).\n *\n * The CRM sends `POST <url>` with `x-crm-timestamp` (unix seconds) and `x-crm-signature`, the\n * hex HMAC-SHA256 of `<timestamp>.<raw body>` keyed with the secret text from `setWebhook` or\n * `rotateWebhookSecret`. Pass the body exactly as received: a body parsed and serialised again\n * no longer matches the signature.\n */\n\nimport { createHmac, timingSafeEqual } from 'node:crypto';\n\n/** A staff reply, as delivered by the webhook. */\nexport interface PartnerMessageSentEvent {\n event: 'partner_message.sent';\n /** Identifies this delivery. */\n deliveryId: string;\n externalRef: string;\n threadRef: string;\n conversationId: string;\n /** Unique per reply: deduplicate on it. */\n messageId: string;\n body: string;\n /** ISO 8601 UTC. */\n sentAt: string;\n sender: {\n /** Your own id for the staff member, or `null` when they have none. */\n userRef: string | null;\n name: string;\n };\n}\n\nexport type PartnerWebhookVerificationReason = 'missing_headers' | 'stale_timestamp' | 'bad_signature' | 'bad_payload';\n\n/** A delivery that failed verification. The message names the reason and nothing from the request. */\nexport class PartnerWebhookVerificationError extends Error {\n readonly reason: PartnerWebhookVerificationReason;\n\n constructor(reason: PartnerWebhookVerificationReason) {\n super(`Partner webhook verification failed (${reason})`);\n this.name = 'PartnerWebhookVerificationError';\n this.reason = reason;\n Object.setPrototypeOf(this, PartnerWebhookVerificationError.prototype);\n }\n}\n\nexport interface VerifyPartnerWebhookInput {\n /** The request body exactly as received, before any JSON parsing. */\n rawBody: string;\n headers: Headers | Record<string, string | string[] | undefined>;\n /** The signing secret as returned by `setWebhook` / `rotateWebhookSecret`. */\n secret: string;\n /** How far the timestamp may be from now, in either direction. Default 300. */\n toleranceSeconds?: number;\n /** Clock in milliseconds; for tests. Default `Date.now`. */\n now?: () => number;\n}\n\nconst DEFAULT_TOLERANCE_SECONDS = 300;\nconst SIGNATURE_HEX = /^[0-9a-fA-F]{64}$/;\nconst PLAIN_INTEGER = /^[0-9]{1,15}$/;\n\nfunction headerValue(headers: VerifyPartnerWebhookInput['headers'], name: string): string | undefined {\n if (typeof (headers as Headers).get === 'function') return (headers as Headers).get(name) || undefined;\n const record = headers as Record<string, string | string[] | undefined>;\n for (const key of Object.keys(record)) {\n if (key.toLowerCase() !== name) continue;\n const value = record[key];\n const first = Array.isArray(value) ? value[0] : value;\n if (typeof first === 'string' && first !== '') return first;\n }\n return undefined;\n}\n\nconst isString = (value: unknown): value is string => typeof value === 'string';\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value);\n\nfunction parseEvent(rawBody: string): PartnerMessageSentEvent {\n let data: unknown;\n try {\n data = JSON.parse(rawBody);\n } catch {\n throw new PartnerWebhookVerificationError('bad_payload');\n }\n if (!isRecord(data) || data.event !== 'partner_message.sent') throw new PartnerWebhookVerificationError('bad_payload');\n const { sender } = data;\n if (\n !isString(data.delivery_id) || !isString(data.external_ref) || !isString(data.thread_ref)\n || !isString(data.conversation_id) || !isString(data.message_id) || !isString(data.body) || !isString(data.sent_at)\n || !isRecord(sender) || !isString(sender.name) || !(sender.user_ref === null || isString(sender.user_ref))\n ) {\n throw new PartnerWebhookVerificationError('bad_payload');\n }\n return {\n event: 'partner_message.sent',\n deliveryId: data.delivery_id,\n externalRef: data.external_ref,\n threadRef: data.thread_ref,\n conversationId: data.conversation_id,\n messageId: data.message_id,\n body: data.body,\n sentAt: data.sent_at,\n sender: { userRef: sender.user_ref, name: sender.name },\n };\n}\n\n/**\n * Verify a delivery and return the event. Throws {@link PartnerWebhookVerificationError}\n * (answer 401); a present but malformed timestamp counts as `stale_timestamp`, a missing one as `missing_headers`. An empty or\n * non-string `secret`, a non-string `rawBody` or a non-finite or negative `toleranceSeconds`\n * is a caller bug and throws a plain `TypeError`. The body is parsed only after the signature has been verified.\n */\nexport function verifyPartnerWebhook(input: VerifyPartnerWebhookInput): PartnerMessageSentEvent {\n // Caller bugs, not verification failures: never fail open on a bad configuration.\n if (typeof input.secret !== 'string' || input.secret === '') throw new TypeError('verifyPartnerWebhook: secret must be a non-empty string');\n if (typeof input.rawBody !== 'string') throw new TypeError('verifyPartnerWebhook: rawBody must be a string (the body exactly as received)');\n if (input.toleranceSeconds !== undefined && !(Number.isFinite(input.toleranceSeconds) && input.toleranceSeconds >= 0)) {\n throw new TypeError('verifyPartnerWebhook: toleranceSeconds must be a finite number of at least 0');\n }\n\n const timestamp = headerValue(input.headers, 'x-crm-timestamp');\n const signature = headerValue(input.headers, 'x-crm-signature');\n if (timestamp === undefined || signature === undefined) throw new PartnerWebhookVerificationError('missing_headers');\n\n const tolerance = input.toleranceSeconds ?? DEFAULT_TOLERANCE_SECONDS;\n const nowSeconds = (input.now ?? Date.now)() / 1000;\n if (!PLAIN_INTEGER.test(timestamp) || !Number.isFinite(nowSeconds) || Math.abs(nowSeconds - Number(timestamp)) > tolerance) {\n throw new PartnerWebhookVerificationError('stale_timestamp');\n }\n\n if (!SIGNATURE_HEX.test(signature)) throw new PartnerWebhookVerificationError('bad_signature');\n const expected = createHmac('sha256', input.secret).update(`${timestamp}.${input.rawBody}`).digest();\n if (!timingSafeEqual(expected, Buffer.from(signature, 'hex'))) throw new PartnerWebhookVerificationError('bad_signature');\n\n return parseEvent(input.rawBody);\n}\n","/**\n * CRM Partner SDK (server side ONLY).\n *\n * A product that embeds the CRM (a \"partner\") provisions one CRM workspace per\n * customer of its own, keyed by the customer's id in the product (`externalRef`).\n * The call authenticates with ONE platform key (`ptk_...`) that can create and\n * manage workspaces for every customer of the partner.\n *\n * **Never run this in a browser, a mobile app or any client bundle.** The partner\n * key is a platform-wide secret and the responses carry per-workspace embed\n * secrets. Keep both in server-side configuration and never log them.\n *\n * ```ts\n * import { createCrmPartnerClient } from '@first-to-fly/crm-sdk/partner';\n *\n * const partner = createCrmPartnerClient({\n * crmBaseUrl: process.env.CRM_BASE_URL!,\n * partnerKey: process.env.CRM_PARTNER_KEY!,\n * });\n * const ws = await partner.upsertWorkspace(tenantId, { name: 'Acme School' });\n * if (ws.created) saveSecret(tenantId, ws.embedAppId, ws.embedAppSecret); // shown once\n * ```\n *\n * Errors are {@link CrmPartnerError}: `status` is the HTTP status (0 for a\n * network failure or timeout), `code` is the CRM's short error code (or\n * `timeout` / `network` / `bad_response` / `invalid_external_ref` / `invalid_contact_ref` /\n * `invalid_thread_ref` / `invalid_limit` / `invalid_cap` / `invalid_date` / `invalid_identity` / `HTTP_<status>`).\n * The message never contains the key, a secret or a response body.\n *\n * Contact sync (`upsertContact`, `eraseContact`, `eraseContactsByIdentity`, `listContactChanges`) acts in a\n * provisioned workspace as your product, with the same partner key. A disabled\n * workspace refuses upserts (409 `WORKSPACE_DISABLED`; not retryable) but still\n * erases and lists.\n *\n * AI for the workspace is metered in credits (1 credit = US$0.001). `aiMonthlyCapCredits` is\n * the monthly cap you set per workspace: `null` = no cap, `0` = AI off, N = N credits per UTC\n * calendar month. A workspace created without one gets 5000. `getWorkspaceUsage` reports use\n * over a date range.\n *\n * Partner message channel (`sendPartnerMessage`, `deletePartnerConversation`,\n * `listPartnerMessageChanges`, and the webhook methods `setWebhook`, `getWebhook`,\n * `rotateWebhookSecret`, `deleteWebhook`): customer messages go in, staff replies come back\n * through the change feed or a signed webhook. Turn the channel on per workspace with\n * `partnerChannelEnabled`. Codes the message endpoint can return, besides the common ones:\n * `NOT_FOUND`, `CONTACT_NOT_FOUND`, `WORKSPACE_DISABLED`, `PARTNER_CHANNEL_DISABLED`,\n * `MESSAGE_REF_CONFLICT`, `THREAD_CONTACT_MISMATCH`, `RATE_LIMITED`, `VALIDATION_ERROR`\n * and `SERVICE_BUSY`.\n *\n * Retryable: 409 only for `PROVISIONING_IN_PROGRESS` (another call for the ref is running),\n * 429 (`RATE_LIMITED`) and 503 (`SERVICE_BUSY`). Wait (the CRM sends `Retry-After`: 5 seconds\n * for 503 and 409, the 60-second window for 429) and repeat the same call; provisioning resumes\n * where it stopped. Other 409s (`MESSAGE_REF_CONFLICT`, `THREAD_CONTACT_MISMATCH`,\n * `PARTNER_CHANNEL_DISABLED`, `WORKSPACE_DISABLED`) last until something changes and carry no\n * `Retry-After`.\n * 500 and status 0 are also safe to repeat.\n *\n * @packageDocumentation\n */\n\nimport {\n DEFAULT_TIMEOUT_MS,\n errorCodeFrom,\n isRecord,\n normalizeBase,\n resolveFetch,\n sendJson,\n type FetchLike,\n} from './server-http';\nimport type {\n ContactChanges,\n ContactChangesQuery,\n ContactRefUpsertBody,\n ContactRefUpsertResult,\n PartnerContactEraseByIdentityBody,\n PartnerContactEraseByIdentityResult,\n PartnerContactEraseResult,\n PartnerInboundMessageBody,\n PartnerInboundMessageResult,\n PartnerMessageChange as WirePartnerMessageChange,\n PartnerMessageChanges as WirePartnerMessageChanges,\n PartnerThreadDeleteResult,\n PartnerWebhookCreated,\n PartnerWebhookGet,\n PartnerWebhookPutBody,\n PartnerWebhookRotate,\n PartnerWebhookUpdated,\n PartnerWorkspaceCreated,\n PartnerWorkspaceDetail as WirePartnerWorkspaceDetail,\n PartnerWorkspaceExisting,\n PartnerWorkspacePatchBody as WirePartnerWorkspacePatchBody,\n PartnerWorkspaceSecret,\n PartnerWorkspaceStatus,\n PartnerWorkspaceUpsertBody as WirePartnerWorkspaceUpsertBody,\n PartnerWorkspaceUsage,\n} from './generated/crm-contracts';\n\nexport { PartnerWebhookVerificationError, verifyPartnerWebhook } from './partner-webhook';\nexport type {\n PartnerMessageSentEvent, PartnerWebhookVerificationReason, VerifyPartnerWebhookInput,\n} from './partner-webhook';\n\n// ─── Error class ─────────────────────────────────────────────────────────────\n\n/** A failed partner API call. The message never includes the key, secrets or response bodies. */\nexport class CrmPartnerError extends Error {\n /** HTTP status; 0 when the CRM could not be reached (network failure or timeout). 409 `PROVISIONING_IN_PROGRESS`, 429 and 503 are retryable; other 409s (for example `MESSAGE_REF_CONFLICT`, `THREAD_CONTACT_MISMATCH`, `PARTNER_CHANNEL_DISABLED`, `WORKSPACE_DISABLED`) last until something changes, so do not retry them unchanged. */\n readonly status: number;\n /** The CRM's error code, or `timeout` / `network` / `bad_response` / `invalid_external_ref` / `invalid_contact_ref` / `invalid_thread_ref` / `invalid_limit` / `invalid_cap` / `invalid_date` / `invalid_identity` / `HTTP_<status>`. */\n readonly code: string;\n\n constructor(status: number, code: string) {\n super(status === 0 ? `CRM partner API unreachable (${code})` : `CRM partner API ${status} ${code}`);\n this.name = 'CrmPartnerError';\n this.status = status;\n this.code = code;\n Object.setPrototypeOf(this, CrmPartnerError.prototype);\n }\n}\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Same pattern the CRM enforces on `externalRef`. */\nexport const EXTERNAL_REF_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;\n\n/** Same pattern the CRM enforces on a `contactRef`. */\nexport const CONTACT_REF_PATTERN = /^[A-Za-z0-9._:-]{1,200}$/;\nexport const CONTACT_CHANGES_MAX_LIMIT = 200;\n/** Upper bound the CRM accepts for the `limit` of {@link CrmPartnerClient.listPartnerMessageChanges}. */\nexport const PARTNER_MESSAGE_CHANGES_MAX_LIMIT = 500;\n\nexport interface CrmPartnerClientOptions {\n /** CRM base URL, e.g. `https://crm.example.com` (a trailing `/api` is tolerated). */\n crmBaseUrl: string;\n /** Partner key (`ptk_...`). Server-side secret. */\n partnerKey: string;\n /** Custom fetch (tests, proxies). Defaults to the global `fetch`. */\n fetch?: FetchLike;\n /** Per-request timeout in ms. Default 15000. */\n timeoutMs?: number;\n}\n\n/** Upper bound the CRM accepts for `aiMonthlyCapCredits` (100 million credits). */\nexport const AI_MONTHLY_CAP_MAX_CREDITS = 100_000_000;\n\n/** Fields every workspace response carries. */\nexport interface PartnerWorkspace {\n externalRef: string;\n /** Null until provisioning has created the workspace. */\n workspaceId: string | null;\n /** Null until provisioning has created the embed app. */\n embedAppId: string | null;\n enabled: boolean;\n /**\n * Monthly AI cap in credits: `null` = no cap (also what an older CRM that does not report it\n * returns), `0` = AI off, N = N credits per UTC calendar month.\n */\n aiMonthlyCapCredits: number | null;\n /** Whether the partner message channel is on for this workspace (false from a CRM that does not report it). */\n partnerChannelEnabled: boolean;\n /** The workspace's own webhook URL; `null` = deliveries go to the URL set with `setWebhook`. */\n webhookUrl: string | null;\n}\n\n/** Body of {@link CrmPartnerClient.upsertWorkspace}. */\nexport type PartnerWorkspaceUpsertBody = Omit<WirePartnerWorkspaceUpsertBody, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'webhook_url'> & {\n /** Turns the partner message channel on or off. Omit to leave it unchanged (off on create). */\n partnerChannelEnabled?: boolean;\n /** Webhook URL for this workspace, used instead of the partner's. `null` clears it; omit to leave it unchanged. */\n webhookUrl?: string | null;\n /**\n * Monthly AI cap in credits (integer, 0 to {@link AI_MONTHLY_CAP_MAX_CREDITS}, or `null` for none).\n * Omit on create for the default of 5000; omit on a later call to leave it unchanged.\n */\n aiMonthlyCapCredits?: number | null;\n};\n\n/** Body of {@link CrmPartnerClient.updateWorkspace}. At least one field is required. */\nexport type PartnerWorkspacePatchBody = Omit<WirePartnerWorkspacePatchBody, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'webhook_url'> & {\n /** Turns the partner message channel on or off. */\n partnerChannelEnabled?: boolean;\n /** Webhook URL for this workspace, used instead of the partner's. `null` clears it. */\n webhookUrl?: string | null;\n /** Monthly AI cap in credits; `null` removes the cap, `0` switches AI off. */\n aiMonthlyCapCredits?: number | null;\n};\n\n/** Query of {@link CrmPartnerClient.getWorkspaceUsage}: UTC calendar dates, `to` inclusive. */\nexport interface PartnerUsageRange {\n /** `YYYY-MM-DD` (UTC), or a `Date` whose UTC date is used. */\n from: string | Date;\n /** `YYYY-MM-DD` (UTC) or a `Date`; the whole day is included. At most 12 months after `from`. */\n to: string | Date;\n}\n\n/**\n * Result of {@link CrmPartnerClient.upsertWorkspace}. `created: true` (HTTP 201)\n * is the one call that carries `embedAppSecret`, shown once: store it. A repeat\n * call (HTTP 200) has `created: false` and no secret; use `rotateWorkspaceSecret`\n * if it was lost.\n */\nexport type PartnerWorkspaceUpsertResult =\n | (PartnerWorkspace & { created: true; embedAppSecret: string })\n | (PartnerWorkspace & { created: false; embedAppSecret?: undefined });\n\n/** Result of {@link CrmPartnerClient.getWorkspace}. */\nexport interface PartnerWorkspaceDetail extends PartnerWorkspace {\n /** Provisioning progress; `active` once the workspace is ready for sessions. */\n state: WirePartnerWorkspaceDetail['state'];\n /**\n * AI credits used in the current UTC month (`period` is `YYYY-MM`); null until the workspace\n * exists, or when talking to a CRM that does not report it.\n */\n ai: { period: string; usedCredits: number } | null;\n}\n\n/** Result of {@link CrmPartnerClient.rotateWorkspaceSecret}. The old secret stops working at once. */\nexport interface PartnerRotatedSecret {\n embedAppId: string;\n embedAppSecret: string;\n}\n\n/** A customer message to hand to the CRM with {@link CrmPartnerClient.sendPartnerMessage}. */\nexport interface PartnerMessageInput {\n /** Your key for the person, as used by contact sync. */\n contactRef: string;\n /** Your id for the conversation. One thread belongs to one contact. */\n threadRef: string;\n /** Your id for the message. Repeating it stores nothing new. */\n messageRef: string;\n /** Plain text, 1 to 10,000 characters, not whitespace only. */\n body: string;\n /** When it was sent: a `Date`, or ISO 8601 with an offset. */\n sentAt: string | Date;\n /** Thread title (1 to 200 characters); set on create, updated when it changes. */\n title?: string;\n /** Your team key; the team is created if new. */\n teamRef?: string;\n}\n\n/** Result of {@link CrmPartnerClient.sendPartnerMessage}. `created` is false for a repeat of a stored `messageRef`. */\nexport interface PartnerMessageResult {\n conversationId: string;\n messageId: string;\n created: boolean;\n}\n\n/** One staff reply owed to you, from {@link CrmPartnerClient.listPartnerMessageChanges}. */\nexport interface PartnerMessageChange {\n deliveryId: string;\n externalRef: string;\n threadRef: string;\n conversationId: string;\n /** Unique per reply: deduplicate on it. */\n messageId: string;\n body: string;\n /** ISO 8601 UTC. */\n sentAt: string;\n sender: {\n /** Your own id for the staff member, or `null` when they have none. */\n userRef: string | null;\n name: string;\n };\n deliveryStatus: 'pending' | 'delivered' | 'failed';\n}\n\n/** One page of {@link CrmPartnerClient.listPartnerMessageChanges}. */\nexport interface PartnerMessageChangesPage {\n items: PartnerMessageChange[];\n nextCursor: string | null;\n}\n\nexport interface CrmPartnerClient {\n /**\n * Idempotent: provisions the workspace for `externalRef`, or resumes/returns it. Optional\n * `currency` (ISO 4217) and `timezone` (IANA) are applied on create and on any later call that\n * sends them; an invalid value is a 400 `VALIDATION_ERROR` and nothing is provisioned.\n * `aiMonthlyCapCredits` sets the monthly AI cap (see {@link PartnerWorkspaceUpsertBody}).\n */\n upsertWorkspace(externalRef: string, body: PartnerWorkspaceUpsertBody): Promise<PartnerWorkspaceUpsertResult>;\n /** Provisioning status, or `null` when the CRM does not know this ref (404). */\n getWorkspace(externalRef: string): Promise<PartnerWorkspaceDetail | null>;\n /** Enable/disable the embed app, rename the workspace or set its monthly AI cap. At least one field is required. */\n updateWorkspace(externalRef: string, patch: PartnerWorkspacePatchBody): Promise<PartnerWorkspace>;\n /**\n * AI usage of the workspace from `from` to `to` (UTC dates, `to` inclusive, at most 12 months):\n * totals, then the same figures by operation, model and day, plus the current month's cap and\n * the embedded assistant's tokens (which are recorded but not capped). Returned as the CRM\n * sends it (snake_case). `cost_usd` is the provider cost; credits are what the cap counts.\n * Resolves `null` for a ref the CRM does not know or that has no workspace yet (404).\n */\n getWorkspaceUsage(externalRef: string, range: PartnerUsageRange): Promise<PartnerWorkspaceUsage | null>;\n /** Replace the embed app secret. Throws a 404 error for an unknown or not-yet-active ref. */\n rotateWorkspaceSecret(externalRef: string): Promise<PartnerRotatedSecret>;\n /**\n * Idempotent upsert of the contact for `contactRef` (your own key for the person) in the\n * workspace: finds it by ref (then phone, then email) or creates it. `whatsapp_consent`\n * only applies when its `recorded_at` is newer than the stored one and the parent has\n * not replied STOP (`consent_applied` says whether it did). `team_ref` + `team_name` file\n * the contact under your team, created if new. Fails with 409 `WORKSPACE_DISABLED` while the\n * workspace is disabled and 404 for an unknown workspace.\n */\n upsertContact(externalRef: string, contactRef: string, body: ContactRefUpsertBody): Promise<ContactRefUpsertResult>;\n /**\n * PDPA erasure: overwrites the contact's personal data, soft-deletes it and removes its refs.\n * Resolves `null` when the CRM has no contact for this ref (404: never synced, or already\n * erased). Works while the workspace is disabled. An unknown workspace is also a 404, so it\n * also resolves `null`; use `getWorkspace` to tell them apart.\n */\n eraseContact(externalRef: string, contactRef: string): Promise<PartnerContactEraseResult | null>;\n /**\n * PDPA erasure of the contacts that match a person's phone (E.164) or email (case-insensitive)\n * and that your product never linked by ref, such as a parent who wrote first on WhatsApp.\n * Send `ref` (the erased person's own `contactRef`) so a contact linked only to that ref is\n * erased too. A matched contact with any other ref (another person of yours, or another\n * product) is left alone and counted in `skipped_linked_elsewhere`, so a shared family number\n * survives. At least one of `phone` or `email` is required (a client-side 400\n * `invalid_identity` otherwise). Works while the workspace is disabled. No match resolves\n * `erased: 0`. Resolves `null` for an unknown workspace (404).\n */\n eraseContactsByIdentity(externalRef: string, identity: PartnerContactEraseByIdentityBody): Promise<PartnerContactEraseByIdentityResult | null>;\n /**\n * One page of the contacts changes feed (oldest first, includes deleted contacts). Pass `since`\n * for the first page and the returned `next_cursor` as `cursor` until it is null. `limit` is 1\n * to 200 (default 100). Works while the workspace is disabled; an unknown workspace throws 404.\n */\n listContactChanges(externalRef: string, query?: { since?: string; cursor?: string; limit?: number }): Promise<ContactChanges>;\n /**\n * Hand a customer message to the CRM. Idempotent on `messageRef`: 201 resolves `created: true`,\n * a repeat (200) resolves `created: false` with the same ids. One `threadRef` belongs to one\n * contact. Rejections surface as {@link CrmPartnerError} with the CRM's code, for example\n * `PARTNER_CHANNEL_DISABLED`, `CONTACT_NOT_FOUND`, `MESSAGE_REF_CONFLICT` (the `messageRef` is already used on\n * another thread; not retryable), `THREAD_CONTACT_MISMATCH`, `WORKSPACE_DISABLED`,\n * `RATE_LIMITED` and `SERVICE_BUSY`.\n */\n sendPartnerMessage(externalRef: string, message: PartnerMessageInput): Promise<PartnerMessageResult>;\n /** Delete the conversation for `threadRef`. `deleted: false` when there is none (already deleted, or never sent). */\n deletePartnerConversation(externalRef: string, threadRef: string): Promise<{ deleted: boolean }>;\n /**\n * One page of staff replies owed to you, oldest first. `limit` is 1 to 500 (default 100).\n *\n * Presenting a `cursor` acknowledges every row before it, so persist a page before calling\n * again with its `nextCursor`. Keep calling until `items` is empty and store the cursor that\n * call returns for the next poll. `nextCursor` is null only when no cursor was sent and there\n * are no rows. Never construct a cursor, and never reuse one across workspaces. A 400\n * `VALIDATION_ERROR` on a stored cursor means drop it and restart with none. Rows are kept 30\n * days. A reply appears a few seconds after it is sent. Delivered rows are included\n * (`deliveryStatus`); deduplicate on `messageId`.\n */\n listPartnerMessageChanges(externalRef: string, query?: { cursor?: string; limit?: number }): Promise<PartnerMessageChangesPage>;\n /**\n * Register (or change) the URL that receives staff replies. The first registration returns the\n * signing `secret`, shown once: store it. Changing the URL returns no secret. The URL must be\n * HTTPS (400 `VALIDATION_ERROR` otherwise).\n */\n setWebhook(input: { url: string }): Promise<{ url: string; secret?: string }>;\n /** The registered webhook, or `null` when none is registered (404). The secret is never returned. */\n getWebhook(): Promise<{ url: string; hasSecret: true } | null>;\n /** Replace the signing secret; the old one stops working at once. Throws a 404 error when no webhook is registered. */\n rotateWebhookSecret(): Promise<{ secret: string }>;\n /** Remove the webhook. Resolves also when none was registered. */\n deleteWebhook(): Promise<void>;\n}\n\n// ─── Implementation ──────────────────────────────────────────────────────────\n\nconst fromStatus = (w: PartnerWorkspaceStatus): PartnerWorkspace => ({\n externalRef: w.external_ref,\n workspaceId: w.workspace_id,\n embedAppId: w.embed_app_id,\n enabled: w.enabled,\n // Absent on a CRM from before the AI cap: reported as no cap.\n aiMonthlyCapCredits: typeof w.ai_monthly_cap_credits === 'number' ? w.ai_monthly_cap_credits : null,\n // Absent on a CRM from before the message channel: reported as off, no URL.\n partnerChannelEnabled: w.partner_channel_enabled === true,\n webhookUrl: typeof w.webhook_url === 'string' ? w.webhook_url : null,\n});\n\n/** Throws a 400 `invalid_date` unless `value` is a valid `Date` or a string; returns the wire string. */\nfunction sentAtWire(value: string | Date): string {\n if (value instanceof Date) {\n if (Number.isNaN(value.getTime())) throw new CrmPartnerError(400, 'invalid_date');\n return value.toISOString();\n }\n if (typeof value !== 'string') throw new CrmPartnerError(400, 'invalid_date');\n return value;\n}\n\nfunction isChange(v: unknown): v is WirePartnerMessageChange {\n return isRecord(v)\n && typeof v.delivery_id === 'string'\n && typeof v.external_ref === 'string'\n && typeof v.thread_ref === 'string'\n && typeof v.conversation_id === 'string'\n && typeof v.message_id === 'string'\n && typeof v.body === 'string'\n && typeof v.sent_at === 'string'\n && isRecord(v.sender)\n && isNullableString(v.sender.user_ref)\n && typeof v.sender.name === 'string'\n && (v.delivery_status === 'pending' || v.delivery_status === 'delivered' || v.delivery_status === 'failed');\n}\n\nconst USAGE_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** `YYYY-MM-DD` as given, or the UTC date of a `Date`; anything else is a 400 `invalid_date`. */\nfunction usageDate(value: string | Date): string {\n const text = value instanceof Date && !Number.isNaN(value.getTime()) ? value.toISOString().slice(0, 10) : value;\n if (typeof text !== 'string' || !USAGE_DATE.test(text)\n || Number.isNaN(Date.parse(`${text}T00:00:00Z`))\n || new Date(`${text}T00:00:00Z`).toISOString().slice(0, 10) !== text) {\n throw new CrmPartnerError(400, 'invalid_date');\n }\n return text;\n}\n\n/** Throws a 400 `invalid_cap` for anything the CRM would refuse, so a typo never leaves the process. */\nfunction checkCap(cap: number | null | undefined): number | null | undefined {\n if (cap === undefined || cap === null) return cap;\n if (typeof cap !== 'number' || !Number.isInteger(cap) || cap < 0 || cap > AI_MONTHLY_CAP_MAX_CREDITS) {\n throw new CrmPartnerError(400, 'invalid_cap');\n }\n return cap;\n}\n\nconst isNullableString = (v: unknown): v is string | null => v === null || typeof v === 'string';\n\nfunction isStatus(v: unknown): v is PartnerWorkspaceStatus {\n return isRecord(v)\n && typeof v.external_ref === 'string'\n && isNullableString(v.workspace_id)\n && isNullableString(v.embed_app_id)\n && typeof v.enabled === 'boolean';\n}\n\nexport function createCrmPartnerClient(opts: CrmPartnerClientOptions): CrmPartnerClient {\n if (!opts.crmBaseUrl) throw new Error('createCrmPartnerClient: `crmBaseUrl` is required.');\n if (!opts.partnerKey) throw new Error('createCrmPartnerClient: `partnerKey` is required.');\n const fetchImpl = resolveFetch(opts.fetch, 'createCrmPartnerClient');\n const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n const root = `${normalizeBase(opts.crmBaseUrl)}/api/partner/v1`;\n const base = `${root}/workspaces`;\n const redact = [opts.partnerKey];\n\n function checkRef(externalRef: string): string {\n if (typeof externalRef !== 'string' || !EXTERNAL_REF_PATTERN.test(externalRef)) {\n throw new CrmPartnerError(400, 'invalid_external_ref');\n }\n return externalRef;\n }\n\n async function call(method: string, path: string, body?: unknown, prefix: string = base): Promise<{ status: number; json: unknown }> {\n const res = await sendJson(fetchImpl, timeoutMs, `${prefix}/${path}`, {\n method,\n headers: { Authorization: `Bearer ${opts.partnerKey}` },\n body,\n });\n if (!res.ok) throw new CrmPartnerError(0, res.kind);\n if (res.status < 200 || res.status >= 300) {\n throw new CrmPartnerError(res.status, errorCodeFrom(res.json, res.status, redact));\n }\n return { status: res.status, json: res.json };\n }\n\n const bad = (status: number) => new CrmPartnerError(status, 'bad_response');\n\n function checkContactRef(contactRef: string): string {\n if (typeof contactRef !== 'string' || !CONTACT_REF_PATTERN.test(contactRef)) {\n throw new CrmPartnerError(400, 'invalid_contact_ref');\n }\n return contactRef;\n }\n\n return {\n async upsertWorkspace(externalRef, body) {\n const ref = checkRef(externalRef);\n const { aiMonthlyCapCredits, partnerChannelEnabled, webhookUrl, ...rest } = body;\n const cap = checkCap(aiMonthlyCapCredits);\n const wireBody: WirePartnerWorkspaceUpsertBody = { ...rest };\n if (cap !== undefined) wireBody.ai_monthly_cap_credits = cap;\n if (partnerChannelEnabled !== undefined) wireBody.partner_channel_enabled = partnerChannelEnabled;\n if (webhookUrl !== undefined) wireBody.webhook_url = webhookUrl;\n const { status, json } = await call('PUT', ref, wireBody);\n if (!isStatus(json)) throw bad(status);\n const wire = json as PartnerWorkspaceCreated | PartnerWorkspaceExisting;\n if (wire.created === true) {\n const secret = (wire as PartnerWorkspaceCreated).embed_app_secret;\n if (typeof secret !== 'string' || !secret) throw bad(status);\n return { ...fromStatus(wire), created: true, embedAppSecret: secret };\n }\n if (wire.created === false) return { ...fromStatus(wire), created: false };\n throw bad(status);\n },\n\n async getWorkspace(externalRef) {\n const ref = checkRef(externalRef);\n try {\n const { status, json } = await call('GET', ref);\n if (!isStatus(json) || typeof (json as Record<string, unknown>).state !== 'string') throw bad(status);\n const ai = (json as unknown as WirePartnerWorkspaceDetail).ai;\n return {\n ...fromStatus(json),\n state: (json as unknown as WirePartnerWorkspaceDetail).state,\n ai: isRecord(ai) && typeof ai.period === 'string' && typeof ai.used_credits === 'number'\n ? { period: ai.period, usedCredits: ai.used_credits }\n : null,\n };\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async updateWorkspace(externalRef, patch) {\n const ref = checkRef(externalRef);\n const body: WirePartnerWorkspacePatchBody = {};\n if (patch.enabled !== undefined) body.enabled = patch.enabled;\n if (patch.name !== undefined) body.name = patch.name;\n const cap = checkCap(patch.aiMonthlyCapCredits);\n if (cap !== undefined) body.ai_monthly_cap_credits = cap;\n if (patch.partnerChannelEnabled !== undefined) body.partner_channel_enabled = patch.partnerChannelEnabled;\n if (patch.webhookUrl !== undefined) body.webhook_url = patch.webhookUrl;\n const { status, json } = await call('PATCH', ref, body);\n if (!isStatus(json)) throw bad(status);\n return fromStatus(json);\n },\n\n async getWorkspaceUsage(externalRef, range) {\n const ref = checkRef(externalRef);\n const qs = new URLSearchParams({ from: usageDate(range.from), to: usageDate(range.to) });\n try {\n const { status, json } = await call('GET', `${ref}/usage?${qs.toString()}`);\n if (!isRecord(json) || !isRecord(json.totals) || !isRecord(json.cap) || !Array.isArray(json.by_operation)) throw bad(status);\n return json as unknown as PartnerWorkspaceUsage;\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async rotateWorkspaceSecret(externalRef) {\n const ref = checkRef(externalRef);\n const { status, json } = await call('POST', `${ref}/rotate-secret`);\n const w = json as Partial<PartnerWorkspaceSecret> | null;\n if (!isRecord(json) || typeof w?.embed_app_id !== 'string' || typeof w.embed_app_secret !== 'string' || !w.embed_app_secret) {\n throw bad(status);\n }\n return { embedAppId: w.embed_app_id, embedAppSecret: w.embed_app_secret };\n },\n\n async upsertContact(externalRef, contactRef, body) {\n const ref = checkRef(externalRef);\n const cref = checkContactRef(contactRef);\n const { status, json } = await call('PUT', `${ref}/contacts/${encodeURIComponent(cref)}`, body);\n if (!isRecord(json) || !isRecord(json.contact) || typeof json.created !== 'boolean' || typeof json.consent_applied !== 'boolean') {\n throw bad(status);\n }\n return json as unknown as ContactRefUpsertResult;\n },\n\n async eraseContact(externalRef, contactRef) {\n const ref = checkRef(externalRef);\n const cref = checkContactRef(contactRef);\n try {\n const { status, json } = await call('DELETE', `${ref}/contacts/${encodeURIComponent(cref)}`);\n if (!isRecord(json) || json.erased !== true || typeof json.contact_id !== 'string') throw bad(status);\n return json as unknown as PartnerContactEraseResult;\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async eraseContactsByIdentity(externalRef, identity) {\n const ref = checkRef(externalRef);\n const phone = typeof identity?.phone === 'string' ? identity.phone.trim() : undefined;\n const email = typeof identity?.email === 'string' ? identity.email.trim() : undefined;\n const hasPhone = phone !== undefined && /\\d/.test(phone);\n const hasEmail = email !== undefined && email.includes('@');\n if ((identity?.phone !== undefined && !hasPhone) || (identity?.email !== undefined && !hasEmail) || (!hasPhone && !hasEmail)) {\n throw new CrmPartnerError(400, 'invalid_identity');\n }\n if (identity.ref !== undefined) checkContactRef(identity.ref);\n const body: PartnerContactEraseByIdentityBody = {};\n if (hasPhone) body.phone = phone;\n if (hasEmail) body.email = email;\n if (identity.ref !== undefined) body.ref = identity.ref;\n try {\n const { status, json } = await call('POST', `${ref}/contacts/erase-by-identity`, body);\n if (\n !isRecord(json)\n || typeof json.erased !== 'number'\n || !Array.isArray(json.contact_ids)\n || typeof json.skipped_linked_elsewhere !== 'number'\n ) {\n throw bad(status);\n }\n return json as unknown as PartnerContactEraseByIdentityResult;\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async listContactChanges(externalRef, query = {}) {\n const ref = checkRef(externalRef);\n const { since, cursor, limit } = query;\n if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > CONTACT_CHANGES_MAX_LIMIT)) {\n throw new CrmPartnerError(400, 'invalid_limit');\n }\n const qs = new URLSearchParams();\n if (since !== undefined) qs.set('since', since);\n if (cursor !== undefined) qs.set('cursor', cursor);\n if (limit !== undefined) qs.set('limit', String(limit));\n const q = qs.toString();\n const { status, json } = await call('GET', `${ref}/contacts/changes${q ? `?${q}` : ''}`);\n if (!isRecord(json) || !Array.isArray(json.items) || !(json.next_cursor === null || typeof json.next_cursor === 'string')) {\n throw bad(status);\n }\n return json as unknown as ContactChanges;\n },\n\n async sendPartnerMessage(externalRef, message) {\n const ref = checkRef(externalRef);\n const wireBody: PartnerInboundMessageBody = {\n contact_ref: checkContactRef(message.contactRef),\n thread_ref: message.threadRef,\n message_ref: message.messageRef,\n body: message.body,\n sent_at: sentAtWire(message.sentAt),\n };\n if (message.title !== undefined) wireBody.title = message.title;\n if (message.teamRef !== undefined) wireBody.team_ref = message.teamRef;\n const { status, json } = await call('POST', `${ref}/messages`, wireBody);\n if (!isRecord(json) || typeof json.conversation_id !== 'string' || typeof json.message_id !== 'string' || typeof json.created !== 'boolean') {\n throw bad(status);\n }\n const wire = json as unknown as PartnerInboundMessageResult;\n return { conversationId: wire.conversation_id, messageId: wire.message_id, created: wire.created };\n },\n\n async deletePartnerConversation(externalRef, threadRef) {\n const ref = checkRef(externalRef);\n if (typeof threadRef !== 'string' || !CONTACT_REF_PATTERN.test(threadRef) || threadRef === '.' || threadRef === '..') {\n throw new CrmPartnerError(400, 'invalid_thread_ref');\n }\n const { status, json } = await call('DELETE', `${ref}/conversations/${encodeURIComponent(threadRef)}`);\n if (!isRecord(json) || typeof json.deleted !== 'boolean') throw bad(status);\n return { deleted: (json as unknown as PartnerThreadDeleteResult).deleted };\n },\n\n async listPartnerMessageChanges(externalRef, query = {}) {\n const ref = checkRef(externalRef);\n const { cursor, limit } = query;\n if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > PARTNER_MESSAGE_CHANGES_MAX_LIMIT)) {\n throw new CrmPartnerError(400, 'invalid_limit');\n }\n const qs = new URLSearchParams();\n if (cursor !== undefined) qs.set('cursor', cursor);\n if (limit !== undefined) qs.set('limit', String(limit));\n const q = qs.toString();\n const { status, json } = await call('GET', `${ref}/messages/changes${q ? `?${q}` : ''}`);\n if (!isRecord(json) || !Array.isArray(json.items) || !(json.next_cursor === null || typeof json.next_cursor === 'string')) {\n throw bad(status);\n }\n const page = json as unknown as WirePartnerMessageChanges;\n const items: PartnerMessageChange[] = page.items.map((item: unknown) => {\n if (!isChange(item)) throw bad(status);\n return {\n deliveryId: item.delivery_id,\n externalRef: item.external_ref,\n threadRef: item.thread_ref,\n conversationId: item.conversation_id,\n messageId: item.message_id,\n body: item.body,\n sentAt: item.sent_at,\n sender: { userRef: item.sender.user_ref, name: item.sender.name },\n deliveryStatus: item.delivery_status,\n };\n });\n return { items, nextCursor: page.next_cursor };\n },\n\n async setWebhook(input) {\n const wireBody: PartnerWebhookPutBody = { url: input.url };\n const { status, json } = await call('PUT', 'webhook', wireBody, root);\n if (!isRecord(json) || typeof json.url !== 'string') throw bad(status);\n if (status === 201) {\n const secret = (json as unknown as PartnerWebhookCreated).secret;\n if (typeof secret !== 'string' || !secret) throw bad(status);\n return { url: json.url, secret };\n }\n return { url: (json as unknown as PartnerWebhookUpdated).url };\n },\n\n async getWebhook() {\n try {\n const { status, json } = await call('GET', 'webhook', undefined, root);\n if (!isRecord(json) || typeof json.url !== 'string' || json.has_secret !== true) throw bad(status);\n return { url: (json as unknown as PartnerWebhookGet).url, hasSecret: true as const };\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async rotateWebhookSecret() {\n const { status, json } = await call('POST', 'webhook/rotate-secret', undefined, root);\n const secret = isRecord(json) ? (json as unknown as Partial<PartnerWebhookRotate>).secret : undefined;\n if (typeof secret !== 'string' || !secret) throw bad(status);\n return { secret };\n },\n\n async deleteWebhook() {\n await call('DELETE', 'webhook', undefined, root);\n },\n };\n}\n\n// Re-exported so partner code can type its inputs without importing the contracts module.\nexport type {\n ContactChanges,\n ContactChangesQuery,\n ContactRefUpsertBody,\n ContactRefUpsertResult,\n PartnerContactEraseByIdentityBody,\n PartnerContactEraseByIdentityResult,\n PartnerContactEraseResult,\n PartnerWorkspaceUsage,\n};\n"],"mappings":"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","names":["normalizeBase","crmBaseUrl","resolveFetch","fetchImpl","who","f","sendJson","timeoutMs","url","init","controller","timedOut","timer","headers","hasBody","res","json","SAFE_CODE","errorCodeFrom","status","redact","fallback","pick","v","r","o","err","isRecord","createHmac","timingSafeEqual","PartnerWebhookVerificationError","_PartnerWebhookVerificationError","reason","DEFAULT_TOLERANCE_SECONDS","SIGNATURE_HEX","PLAIN_INTEGER","headerValue","headers","name","record","key","value","first","isString","isRecord","parseEvent","rawBody","data","sender","verifyPartnerWebhook","input","timestamp","signature","tolerance","nowSeconds","expected","CrmPartnerError","_CrmPartnerError","status","code","EXTERNAL_REF_PATTERN","CONTACT_REF_PATTERN","CONTACT_CHANGES_MAX_LIMIT","PARTNER_MESSAGE_CHANGES_MAX_LIMIT","AI_MONTHLY_CAP_MAX_CREDITS","fromStatus","w","sentAtWire","value","isChange","v","isRecord","isNullableString","USAGE_DATE","usageDate","text","checkCap","cap","isStatus","createCrmPartnerClient","opts","fetchImpl","resolveFetch","timeoutMs","root","normalizeBase","base","redact","checkRef","externalRef","call","method","path","body","prefix","res","sendJson","errorCodeFrom","bad","checkContactRef","contactRef","ref","aiMonthlyCapCredits","partnerChannelEnabled","webhookUrl","rest","wireBody","json","wire","secret","ai","err","patch","range","qs","cref","identity","phone","email","hasPhone","hasEmail","query","since","cursor","limit","q","message","threadRef","page","item","input"]}
|
|
1
|
+
{"version":3,"sources":["../src/server-http.ts","../src/partner-media.ts","../src/partner-webhook.ts","../src/partner.ts"],"sourcesContent":["/**\n * Internal HTTP helper for the server-side `partner` entry point. Not part of the\n * public API (no package export points here).\n *\n * It never puts a request header, a request body or a response body into an\n * error: callers get the HTTP status, a short sanitized error code, or a\n * transport failure kind, and nothing else.\n */\n\nexport type FetchLike = typeof fetch;\n\nexport const DEFAULT_TIMEOUT_MS = 15_000;\n\nexport type Transport =\n | { ok: true; status: number; json: unknown }\n | { ok: false; kind: 'timeout' | 'network' };\n\n/** Strip trailing slashes and a trailing `/api`, so callers can pass either form. */\nexport function normalizeBase(crmBaseUrl: string): string {\n return crmBaseUrl.replace(/\\/+$/, '').replace(/\\/api$/, '');\n}\n\nexport function resolveFetch(fetchImpl: FetchLike | undefined, who: string): FetchLike {\n const f = fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') {\n throw new Error(`${who}: no fetch implementation available. Pass \\`fetch\\` explicitly.`);\n }\n return f;\n}\n\n/**\n * One request with a hard timeout covering headers AND body. Returns the parsed\n * JSON (null when the body is empty or not JSON) or a transport failure kind.\n */\nexport async function sendJson(\n fetchImpl: FetchLike,\n timeoutMs: number,\n url: string,\n init: { method: string; headers: Record<string, string>; body?: unknown },\n): Promise<Transport> {\n const controller = new AbortController();\n let timedOut = false;\n const timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, timeoutMs);\n try {\n const headers: Record<string, string> = { Accept: 'application/json', ...init.headers };\n const hasBody = init.body !== undefined;\n if (hasBody) headers['Content-Type'] = 'application/json';\n const res = await fetchImpl(url, {\n method: init.method,\n headers,\n body: hasBody ? JSON.stringify(init.body) : undefined,\n signal: controller.signal,\n });\n const json: unknown = await res.json().catch(() => null);\n if (timedOut) return { ok: false, kind: 'timeout' };\n return { ok: true, status: res.status, json };\n } catch {\n return { ok: false, kind: timedOut ? 'timeout' : 'network' };\n } finally {\n clearTimeout(timer);\n }\n}\n\n/**\n * `sendJson` for a `multipart/form-data` body. No Content-Type is set: fetch adds it with\n * the boundary. Same timeout and the same never-leak rules.\n */\nexport async function sendForm(\n fetchImpl: FetchLike,\n timeoutMs: number,\n url: string,\n init: { method: string; headers: Record<string, string>; form: FormData },\n): Promise<Transport> {\n const controller = new AbortController();\n let timedOut = false;\n const timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, timeoutMs);\n try {\n const res = await fetchImpl(url, {\n method: init.method,\n headers: { Accept: 'application/json', ...init.headers },\n body: init.form,\n signal: controller.signal,\n });\n const json: unknown = await res.json().catch(() => null);\n if (timedOut) return { ok: false, kind: 'timeout' };\n return { ok: true, status: res.status, json };\n } catch {\n return { ok: false, kind: timedOut ? 'timeout' : 'network' };\n } finally {\n clearTimeout(timer);\n }\n}\n\nconst SAFE_CODE = /^[A-Za-z0-9_.:-]{1,60}$/;\n\n/**\n * A short machine code from an error body, or `HTTP_<status>`. Accepts\n * `{ error: { code } }`, `{ error: \"code\" }` and `{ code }`. A value that is not\n * a short identifier (a sentence, a long string) or that contains one of the\n * `redact` strings (credentials) is dropped, so a code is always safe to log.\n */\nexport function errorCodeFrom(json: unknown, status: number, redact: readonly string[]): string {\n const fallback = `HTTP_${status}`;\n const pick = (v: unknown): string | null => {\n if (typeof v !== 'string' || !SAFE_CODE.test(v)) return null;\n return redact.some((r) => r && v.includes(r)) ? null : v;\n };\n if (json && typeof json === 'object') {\n const o = json as Record<string, unknown>;\n const err = o.error;\n return (\n pick(o.code)\n ?? pick(err)\n ?? (err && typeof err === 'object' ? pick((err as Record<string, unknown>).code) : null)\n ?? fallback\n );\n }\n return fallback;\n}\n\nexport const isRecord = (v: unknown): v is Record<string, unknown> =>\n typeof v === 'object' && v !== null && !Array.isArray(v);\n","/**\n * Files on the partner message channel, shared by the partner client and the webhook\n * verifier. Internal: the types are re-exported from the `partner` entry point.\n */\n\n/** One file on a partner app message. Fetch a link to it with `getPartnerMediaLinks`. */\nexport interface PartnerMedia {\n /** The CRM's file id. */\n id: string;\n name: string;\n mimeType: string;\n /** Bytes. */\n size: number;\n /** `image` for a JPEG, PNG or WebP photo; `file` for a PDF or Word document. */\n kind: 'image' | 'file';\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * The `media` of a wire message: `[]` when the CRM sent none (a CRM from before files),\n * the mapped files when every item is well formed, and `null` for anything else.\n */\nexport function parsePartnerMedia(value: unknown): PartnerMedia[] | null {\n if (value === undefined) return [];\n if (!Array.isArray(value)) return null;\n const out: PartnerMedia[] = [];\n for (const item of value) {\n if (\n !isRecord(item) || typeof item.id !== 'string' || typeof item.name !== 'string' || typeof item.mime_type !== 'string'\n || typeof item.size !== 'number' || !Number.isFinite(item.size) || (item.kind !== 'image' && item.kind !== 'file')\n ) {\n return null;\n }\n out.push({\n id: item.id, name: item.name, mimeType: item.mime_type, size: item.size, kind: item.kind,\n });\n }\n return out;\n}\n","/**\n * Verifier for the signed webhook the CRM sends for each staff reply on the partner message\n * channel (server side ONLY: it uses `node:crypto`).\n *\n * The CRM sends `POST <url>` with `x-crm-timestamp` (unix seconds) and `x-crm-signature`, the\n * hex HMAC-SHA256 of `<timestamp>.<raw body>` keyed with the secret text from `setWebhook` or\n * `rotateWebhookSecret`. Pass the body exactly as received: a body parsed and serialised again\n * no longer matches the signature.\n */\n\nimport { createHmac, timingSafeEqual } from 'node:crypto';\n\nimport { parsePartnerMedia, type PartnerMedia } from './partner-media';\n\n/** A staff reply, as delivered by the webhook. */\nexport interface PartnerMessageSentEvent {\n event: 'partner_message.sent';\n /** Identifies this delivery. */\n deliveryId: string;\n externalRef: string;\n threadRef: string;\n conversationId: string;\n /** Unique per reply: deduplicate on it. */\n messageId: string;\n body: string;\n /** ISO 8601 UTC. */\n sentAt: string;\n sender: {\n /** Your own id for the staff member, or `null` when they have none. */\n userRef: string | null;\n name: string;\n };\n /** The reply's file (one at most); empty for a text reply, and from a CRM from before files. */\n media: PartnerMedia[];\n}\n\nexport type PartnerWebhookVerificationReason = 'missing_headers' | 'stale_timestamp' | 'bad_signature' | 'bad_payload';\n\n/** A delivery that failed verification. The message names the reason and nothing from the request. */\nexport class PartnerWebhookVerificationError extends Error {\n readonly reason: PartnerWebhookVerificationReason;\n\n constructor(reason: PartnerWebhookVerificationReason) {\n super(`Partner webhook verification failed (${reason})`);\n this.name = 'PartnerWebhookVerificationError';\n this.reason = reason;\n Object.setPrototypeOf(this, PartnerWebhookVerificationError.prototype);\n }\n}\n\nexport interface VerifyPartnerWebhookInput {\n /** The request body exactly as received, before any JSON parsing. */\n rawBody: string;\n headers: Headers | Record<string, string | string[] | undefined>;\n /** The signing secret as returned by `setWebhook` / `rotateWebhookSecret`. */\n secret: string;\n /** How far the timestamp may be from now, in either direction. Default 300. */\n toleranceSeconds?: number;\n /** Clock in milliseconds; for tests. Default `Date.now`. */\n now?: () => number;\n}\n\nconst DEFAULT_TOLERANCE_SECONDS = 300;\nconst SIGNATURE_HEX = /^[0-9a-fA-F]{64}$/;\nconst PLAIN_INTEGER = /^[0-9]{1,15}$/;\n\nfunction headerValue(headers: VerifyPartnerWebhookInput['headers'], name: string): string | undefined {\n if (typeof (headers as Headers).get === 'function') return (headers as Headers).get(name) || undefined;\n const record = headers as Record<string, string | string[] | undefined>;\n for (const key of Object.keys(record)) {\n if (key.toLowerCase() !== name) continue;\n const value = record[key];\n const first = Array.isArray(value) ? value[0] : value;\n if (typeof first === 'string' && first !== '') return first;\n }\n return undefined;\n}\n\nconst isString = (value: unknown): value is string => typeof value === 'string';\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value);\n\nfunction parseEvent(rawBody: string): PartnerMessageSentEvent {\n let data: unknown;\n try {\n data = JSON.parse(rawBody);\n } catch {\n throw new PartnerWebhookVerificationError('bad_payload');\n }\n if (!isRecord(data) || data.event !== 'partner_message.sent') throw new PartnerWebhookVerificationError('bad_payload');\n const { sender } = data;\n if (\n !isString(data.delivery_id) || !isString(data.external_ref) || !isString(data.thread_ref)\n || !isString(data.conversation_id) || !isString(data.message_id) || !isString(data.body) || !isString(data.sent_at)\n || !isRecord(sender) || !isString(sender.name) || !(sender.user_ref === null || isString(sender.user_ref))\n ) {\n throw new PartnerWebhookVerificationError('bad_payload');\n }\n const media = parsePartnerMedia(data.media);\n if (media === null) throw new PartnerWebhookVerificationError('bad_payload');\n return {\n event: 'partner_message.sent',\n deliveryId: data.delivery_id,\n externalRef: data.external_ref,\n threadRef: data.thread_ref,\n conversationId: data.conversation_id,\n messageId: data.message_id,\n body: data.body,\n sentAt: data.sent_at,\n sender: { userRef: sender.user_ref, name: sender.name },\n media,\n };\n}\n\n/**\n * Verify a delivery and return the event. Throws {@link PartnerWebhookVerificationError}\n * (answer 401); a present but malformed timestamp counts as `stale_timestamp`, a missing one as `missing_headers`. An empty or\n * non-string `secret`, a non-string `rawBody` or a non-finite or negative `toleranceSeconds`\n * is a caller bug and throws a plain `TypeError`. The body is parsed only after the signature has been verified.\n */\nexport function verifyPartnerWebhook(input: VerifyPartnerWebhookInput): PartnerMessageSentEvent {\n // Caller bugs, not verification failures: never fail open on a bad configuration.\n if (typeof input.secret !== 'string' || input.secret === '') throw new TypeError('verifyPartnerWebhook: secret must be a non-empty string');\n if (typeof input.rawBody !== 'string') throw new TypeError('verifyPartnerWebhook: rawBody must be a string (the body exactly as received)');\n if (input.toleranceSeconds !== undefined && !(Number.isFinite(input.toleranceSeconds) && input.toleranceSeconds >= 0)) {\n throw new TypeError('verifyPartnerWebhook: toleranceSeconds must be a finite number of at least 0');\n }\n\n const timestamp = headerValue(input.headers, 'x-crm-timestamp');\n const signature = headerValue(input.headers, 'x-crm-signature');\n if (timestamp === undefined || signature === undefined) throw new PartnerWebhookVerificationError('missing_headers');\n\n const tolerance = input.toleranceSeconds ?? DEFAULT_TOLERANCE_SECONDS;\n const nowSeconds = (input.now ?? Date.now)() / 1000;\n if (!PLAIN_INTEGER.test(timestamp) || !Number.isFinite(nowSeconds) || Math.abs(nowSeconds - Number(timestamp)) > tolerance) {\n throw new PartnerWebhookVerificationError('stale_timestamp');\n }\n\n if (!SIGNATURE_HEX.test(signature)) throw new PartnerWebhookVerificationError('bad_signature');\n const expected = createHmac('sha256', input.secret).update(`${timestamp}.${input.rawBody}`).digest();\n if (!timingSafeEqual(expected, Buffer.from(signature, 'hex'))) throw new PartnerWebhookVerificationError('bad_signature');\n\n return parseEvent(input.rawBody);\n}\n","/**\n * CRM Partner SDK (server side ONLY).\n *\n * A product that embeds the CRM (a \"partner\") provisions one CRM workspace per\n * customer of its own, keyed by the customer's id in the product (`externalRef`).\n * The call authenticates with ONE platform key (`ptk_...`) that can create and\n * manage workspaces for every customer of the partner.\n *\n * **Never run this in a browser, a mobile app or any client bundle.** The partner\n * key is a platform-wide secret and the responses carry per-workspace embed\n * secrets. Keep both in server-side configuration and never log them.\n *\n * ```ts\n * import { createCrmPartnerClient } from '@first-to-fly/crm-sdk/partner';\n *\n * const partner = createCrmPartnerClient({\n * crmBaseUrl: process.env.CRM_BASE_URL!,\n * partnerKey: process.env.CRM_PARTNER_KEY!,\n * });\n * const ws = await partner.upsertWorkspace(tenantId, { name: 'Acme School' });\n * if (ws.created) saveSecret(tenantId, ws.embedAppId, ws.embedAppSecret); // shown once\n * ```\n *\n * Errors are {@link CrmPartnerError}: `status` is the HTTP status (0 for a\n * network failure or timeout), `code` is the CRM's short error code (or\n * `timeout` / `network` / `bad_response` / `invalid_external_ref` / `invalid_contact_ref` /\n * `invalid_thread_ref` / `invalid_limit` / `invalid_cap` / `invalid_date` / `invalid_identity` / `HTTP_<status>`).\n * The message never contains the key, a secret or a response body.\n *\n * Contact sync (`upsertContact`, `eraseContact`, `eraseContactsByIdentity`, `listContactChanges`) acts in a\n * provisioned workspace as your product, with the same partner key. A disabled\n * workspace refuses upserts (409 `WORKSPACE_DISABLED`; not retryable) but still\n * erases and lists.\n *\n * AI for the workspace is metered in credits (1 credit = US$0.001). `aiMonthlyCapCredits` is\n * the monthly cap you set per workspace: `null` = no cap, `0` = AI off, N = N credits per UTC\n * calendar month. A workspace created without one gets 5000. `getWorkspaceUsage` reports use\n * over a date range.\n *\n * Partner message channel (`sendPartnerMessage`, `deletePartnerConversation`,\n * `listPartnerMessageChanges`, and the webhook methods `setWebhook`, `getWebhook`,\n * `rotateWebhookSecret`, `deleteWebhook`): customer messages go in, staff replies come back\n * through the change feed or a signed webhook. Turn the channel on per workspace with\n * `partnerChannelEnabled`, and photos and files with `partnerFilesEnabled` (one file a message,\n * see `PartnerMessageInput.file` and `getPartnerMediaLinks`). Codes the message endpoint can\n * return, besides the common ones: `NOT_FOUND`, `CONTACT_NOT_FOUND`, `WORKSPACE_DISABLED`,\n * `PARTNER_CHANNEL_DISABLED`, `PARTNER_FILES_DISABLED` (a file while files are off),\n * `MESSAGE_REF_CONFLICT`, `THREAD_CONTACT_MISMATCH`, `RATE_LIMITED`, `VALIDATION_ERROR`\n * and `SERVICE_BUSY`.\n *\n * Retryable: 409 only for `PROVISIONING_IN_PROGRESS` (another call for the ref is running),\n * 429 (`RATE_LIMITED`) and 503 (`SERVICE_BUSY`). Wait (the CRM sends `Retry-After`: 5 seconds\n * for 503 and 409, the 60-second window for 429) and repeat the same call; provisioning resumes\n * where it stopped. Other 409s (`MESSAGE_REF_CONFLICT`, `THREAD_CONTACT_MISMATCH`,\n * `PARTNER_CHANNEL_DISABLED`, `WORKSPACE_DISABLED`) last until something changes and carry no\n * `Retry-After`.\n * 500 and status 0 are also safe to repeat.\n *\n * @packageDocumentation\n */\n\nimport {\n DEFAULT_TIMEOUT_MS,\n errorCodeFrom,\n isRecord,\n normalizeBase,\n resolveFetch,\n sendForm,\n sendJson,\n type FetchLike,\n} from './server-http';\nimport { parsePartnerMedia, type PartnerMedia } from './partner-media';\nimport type {\n ContactChanges,\n ContactChangesQuery,\n ContactRefUpsertBody,\n ContactRefUpsertResult,\n PartnerContactEraseByIdentityBody,\n PartnerContactEraseByIdentityResult,\n PartnerContactEraseResult,\n PartnerInboundMessageBody,\n PartnerInboundMessageResult,\n PartnerMediaLinksBody,\n PartnerMessageChange as WirePartnerMessageChange,\n PartnerMessageChanges as WirePartnerMessageChanges,\n PartnerThreadDeleteResult,\n PartnerWebhookCreated,\n PartnerWebhookGet,\n PartnerWebhookPutBody,\n PartnerWebhookRotate,\n PartnerWebhookUpdated,\n PartnerWorkspaceCreated,\n PartnerWorkspaceDetail as WirePartnerWorkspaceDetail,\n PartnerWorkspaceExisting,\n PartnerWorkspacePatchBody as WirePartnerWorkspacePatchBody,\n PartnerWorkspaceSecret,\n PartnerWorkspaceStatus,\n PartnerWorkspaceUpsertBody as WirePartnerWorkspaceUpsertBody,\n PartnerWorkspaceUsage,\n} from './generated/crm-contracts';\n\nexport { PartnerWebhookVerificationError, verifyPartnerWebhook } from './partner-webhook';\nexport type { PartnerMedia } from './partner-media';\nexport type {\n PartnerMessageSentEvent, PartnerWebhookVerificationReason, VerifyPartnerWebhookInput,\n} from './partner-webhook';\n\n// ─── Error class ─────────────────────────────────────────────────────────────\n\n/** A failed partner API call. The message never includes the key, secrets or response bodies. */\nexport class CrmPartnerError extends Error {\n /** HTTP status; 0 when the CRM could not be reached (network failure or timeout). 409 `PROVISIONING_IN_PROGRESS`, 429 and 503 are retryable; other 409s (for example `MESSAGE_REF_CONFLICT`, `THREAD_CONTACT_MISMATCH`, `PARTNER_CHANNEL_DISABLED`, `WORKSPACE_DISABLED`) last until something changes, so do not retry them unchanged. */\n readonly status: number;\n /** The CRM's error code, or `timeout` / `network` / `bad_response` / `invalid_external_ref` / `invalid_contact_ref` / `invalid_thread_ref` / `invalid_limit` / `invalid_cap` / `invalid_date` / `invalid_identity` / `HTTP_<status>`. */\n readonly code: string;\n\n constructor(status: number, code: string) {\n super(status === 0 ? `CRM partner API unreachable (${code})` : `CRM partner API ${status} ${code}`);\n this.name = 'CrmPartnerError';\n this.status = status;\n this.code = code;\n Object.setPrototypeOf(this, CrmPartnerError.prototype);\n }\n}\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Same pattern the CRM enforces on `externalRef`. */\nexport const EXTERNAL_REF_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;\n\n/** Same pattern the CRM enforces on a `contactRef`. */\nexport const CONTACT_REF_PATTERN = /^[A-Za-z0-9._:-]{1,200}$/;\nexport const CONTACT_CHANGES_MAX_LIMIT = 200;\n/** Upper bound the CRM accepts for the `limit` of {@link CrmPartnerClient.listPartnerMessageChanges}. */\nexport const PARTNER_MESSAGE_CHANGES_MAX_LIMIT = 500;\n\nexport interface CrmPartnerClientOptions {\n /** CRM base URL, e.g. `https://crm.example.com` (a trailing `/api` is tolerated). */\n crmBaseUrl: string;\n /** Partner key (`ptk_...`). Server-side secret. */\n partnerKey: string;\n /** Custom fetch (tests, proxies). Defaults to the global `fetch`. */\n fetch?: FetchLike;\n /** Per-request timeout in ms. Default 15000. */\n timeoutMs?: number;\n}\n\n/** Upper bound the CRM accepts for `aiMonthlyCapCredits` (100 million credits). */\nexport const AI_MONTHLY_CAP_MAX_CREDITS = 100_000_000;\n\n/** Fields every workspace response carries. */\nexport interface PartnerWorkspace {\n externalRef: string;\n /** Null until provisioning has created the workspace. */\n workspaceId: string | null;\n /** Null until provisioning has created the embed app. */\n embedAppId: string | null;\n enabled: boolean;\n /**\n * Monthly AI cap in credits: `null` = no cap (also what an older CRM that does not report it\n * returns), `0` = AI off, N = N credits per UTC calendar month.\n */\n aiMonthlyCapCredits: number | null;\n /** Whether the partner message channel is on for this workspace (false from a CRM that does not report it). */\n partnerChannelEnabled: boolean;\n /** Whether photos and files are on for that channel (false from a CRM that does not report it). */\n partnerFilesEnabled: boolean;\n /** The workspace's own webhook URL; `null` = deliveries go to the URL set with `setWebhook`. */\n webhookUrl: string | null;\n}\n\n/** Body of {@link CrmPartnerClient.upsertWorkspace}. */\nexport type PartnerWorkspaceUpsertBody = Omit<WirePartnerWorkspaceUpsertBody, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'partner_files_enabled' | 'webhook_url'> & {\n /** Turns the partner message channel on or off. Omit to leave it unchanged (off on create). */\n partnerChannelEnabled?: boolean;\n /**\n * Turns photos and files on or off for the channel. Omit to leave it unchanged (off on create).\n * Files move only while `partnerChannelEnabled` is on too.\n */\n partnerFilesEnabled?: boolean;\n /** Webhook URL for this workspace, used instead of the partner's. `null` clears it; omit to leave it unchanged. */\n webhookUrl?: string | null;\n /**\n * Monthly AI cap in credits (integer, 0 to {@link AI_MONTHLY_CAP_MAX_CREDITS}, or `null` for none).\n * Omit on create for the default of 5000; omit on a later call to leave it unchanged.\n */\n aiMonthlyCapCredits?: number | null;\n};\n\n/** Body of {@link CrmPartnerClient.updateWorkspace}. At least one field is required. */\nexport type PartnerWorkspacePatchBody = Omit<WirePartnerWorkspacePatchBody, 'ai_monthly_cap_credits' | 'partner_channel_enabled' | 'partner_files_enabled' | 'webhook_url'> & {\n /** Turns the partner message channel on or off. */\n partnerChannelEnabled?: boolean;\n /** Turns photos and files on or off for the channel. */\n partnerFilesEnabled?: boolean;\n /** Webhook URL for this workspace, used instead of the partner's. `null` clears it. */\n webhookUrl?: string | null;\n /** Monthly AI cap in credits; `null` removes the cap, `0` switches AI off. */\n aiMonthlyCapCredits?: number | null;\n};\n\n/** Query of {@link CrmPartnerClient.getWorkspaceUsage}: UTC calendar dates, `to` inclusive. */\nexport interface PartnerUsageRange {\n /** `YYYY-MM-DD` (UTC), or a `Date` whose UTC date is used. */\n from: string | Date;\n /** `YYYY-MM-DD` (UTC) or a `Date`; the whole day is included. At most 12 months after `from`. */\n to: string | Date;\n}\n\n/**\n * Result of {@link CrmPartnerClient.upsertWorkspace}. `created: true` (HTTP 201)\n * is the one call that carries `embedAppSecret`, shown once: store it. A repeat\n * call (HTTP 200) has `created: false` and no secret; use `rotateWorkspaceSecret`\n * if it was lost.\n */\nexport type PartnerWorkspaceUpsertResult =\n | (PartnerWorkspace & { created: true; embedAppSecret: string })\n | (PartnerWorkspace & { created: false; embedAppSecret?: undefined });\n\n/** Result of {@link CrmPartnerClient.getWorkspace}. */\nexport interface PartnerWorkspaceDetail extends PartnerWorkspace {\n /** Provisioning progress; `active` once the workspace is ready for sessions. */\n state: WirePartnerWorkspaceDetail['state'];\n /**\n * AI credits used in the current UTC month (`period` is `YYYY-MM`); null until the workspace\n * exists, or when talking to a CRM that does not report it.\n */\n ai: { period: string; usedCredits: number } | null;\n}\n\n/** Result of {@link CrmPartnerClient.rotateWorkspaceSecret}. The old secret stops working at once. */\nexport interface PartnerRotatedSecret {\n embedAppId: string;\n embedAppSecret: string;\n}\n\n/** A customer message to hand to the CRM with {@link CrmPartnerClient.sendPartnerMessage}. */\nexport interface PartnerMessageInput {\n /** Your key for the person, as used by contact sync. */\n contactRef: string;\n /** Your id for the conversation. One thread belongs to one contact. */\n threadRef: string;\n /** Your id for the message. Repeating it stores nothing new. */\n messageRef: string;\n /**\n * Plain text, 1 to 10,000 characters, not whitespace only. With `file` it is an optional\n * caption: `''` for none.\n */\n body: string;\n /** When it was sent: a `Date`, or ISO 8601 with an offset. */\n sentAt: string | Date;\n /** Thread title (1 to 200 characters); set on create, updated when it changes. */\n title?: string;\n /** Your team key; the team is created if new. */\n teamRef?: string;\n /**\n * One photo (JPEG, PNG, WebP) or document (PDF, DOC, DOCX) of at most 10 MB. Sent as\n * `multipart/form-data` to `/messages/file`; refused with 409 `PARTNER_FILES_DISABLED`\n * while the workspace's files are off. One file a message.\n */\n file?: { data: Blob | Uint8Array; name: string; type: string };\n}\n\n/** Result of {@link CrmPartnerClient.sendPartnerMessage}. `created` is false for a repeat of a stored `messageRef`. */\nexport interface PartnerMessageResult {\n conversationId: string;\n messageId: string;\n created: boolean;\n /** The stored file of a message sent with `file` (on a repeat, the one stored the first time); `[]` otherwise. */\n media: PartnerMedia[];\n}\n\n/** A signed link from {@link CrmPartnerClient.getPartnerMediaLinks}. */\nexport interface PartnerMediaLink {\n id: string;\n /** HTTPS; do not store it. */\n url: string;\n /** ISO 8601 UTC; about one hour after the call. */\n expiresAt: string;\n}\n\n/** One staff reply owed to you, from {@link CrmPartnerClient.listPartnerMessageChanges}. */\nexport interface PartnerMessageChange {\n deliveryId: string;\n externalRef: string;\n threadRef: string;\n conversationId: string;\n /** Unique per reply: deduplicate on it. */\n messageId: string;\n body: string;\n /** ISO 8601 UTC. */\n sentAt: string;\n sender: {\n /** Your own id for the staff member, or `null` when they have none. */\n userRef: string | null;\n name: string;\n };\n deliveryStatus: 'pending' | 'delivered' | 'failed';\n /** The reply's file (one at most); `[]` for a text reply, and from a CRM from before files. */\n media: PartnerMedia[];\n}\n\n/** One page of {@link CrmPartnerClient.listPartnerMessageChanges}. */\nexport interface PartnerMessageChangesPage {\n items: PartnerMessageChange[];\n nextCursor: string | null;\n}\n\nexport interface CrmPartnerClient {\n /**\n * Idempotent: provisions the workspace for `externalRef`, or resumes/returns it. Optional\n * `currency` (ISO 4217) and `timezone` (IANA) are applied on create and on any later call that\n * sends them; an invalid value is a 400 `VALIDATION_ERROR` and nothing is provisioned.\n * `aiMonthlyCapCredits` sets the monthly AI cap (see {@link PartnerWorkspaceUpsertBody}).\n */\n upsertWorkspace(externalRef: string, body: PartnerWorkspaceUpsertBody): Promise<PartnerWorkspaceUpsertResult>;\n /** Provisioning status, or `null` when the CRM does not know this ref (404). */\n getWorkspace(externalRef: string): Promise<PartnerWorkspaceDetail | null>;\n /** Enable/disable the embed app, rename the workspace or set its monthly AI cap. At least one field is required. */\n updateWorkspace(externalRef: string, patch: PartnerWorkspacePatchBody): Promise<PartnerWorkspace>;\n /**\n * AI usage of the workspace from `from` to `to` (UTC dates, `to` inclusive, at most 12 months):\n * totals, then the same figures by operation, model and day, plus the current month's cap and\n * the embedded assistant's tokens (which are recorded but not capped). Returned as the CRM\n * sends it (snake_case). `cost_usd` is the provider cost; credits are what the cap counts.\n * Resolves `null` for a ref the CRM does not know or that has no workspace yet (404).\n */\n getWorkspaceUsage(externalRef: string, range: PartnerUsageRange): Promise<PartnerWorkspaceUsage | null>;\n /** Replace the embed app secret. Throws a 404 error for an unknown or not-yet-active ref. */\n rotateWorkspaceSecret(externalRef: string): Promise<PartnerRotatedSecret>;\n /**\n * Idempotent upsert of the contact for `contactRef` (your own key for the person) in the\n * workspace: finds it by ref (then phone, then email) or creates it. `whatsapp_consent`\n * only applies when its `recorded_at` is newer than the stored one and the parent has\n * not replied STOP (`consent_applied` says whether it did). `team_ref` + `team_name` file\n * the contact under your team, created if new. Fails with 409 `WORKSPACE_DISABLED` while the\n * workspace is disabled and 404 for an unknown workspace.\n */\n upsertContact(externalRef: string, contactRef: string, body: ContactRefUpsertBody): Promise<ContactRefUpsertResult>;\n /**\n * PDPA erasure: overwrites the contact's personal data, soft-deletes it and removes its refs.\n * Resolves `null` when the CRM has no contact for this ref (404: never synced, or already\n * erased). Works while the workspace is disabled. An unknown workspace is also a 404, so it\n * also resolves `null`; use `getWorkspace` to tell them apart.\n */\n eraseContact(externalRef: string, contactRef: string): Promise<PartnerContactEraseResult | null>;\n /**\n * PDPA erasure of the contacts that match a person's phone (E.164) or email (case-insensitive)\n * and that your product never linked by ref, such as a parent who wrote first on WhatsApp.\n * Send `ref` (the erased person's own `contactRef`) so a contact linked only to that ref is\n * erased too. A matched contact with any other ref (another person of yours, or another\n * product) is left alone and counted in `skipped_linked_elsewhere`, so a shared family number\n * survives. At least one of `phone` or `email` is required (a client-side 400\n * `invalid_identity` otherwise). Works while the workspace is disabled. No match resolves\n * `erased: 0`. Resolves `null` for an unknown workspace (404).\n */\n eraseContactsByIdentity(externalRef: string, identity: PartnerContactEraseByIdentityBody): Promise<PartnerContactEraseByIdentityResult | null>;\n /**\n * One page of the contacts changes feed (oldest first, includes deleted contacts). Pass `since`\n * for the first page and the returned `next_cursor` as `cursor` until it is null. `limit` is 1\n * to 200 (default 100). Works while the workspace is disabled; an unknown workspace throws 404.\n */\n listContactChanges(externalRef: string, query?: { since?: string; cursor?: string; limit?: number }): Promise<ContactChanges>;\n /**\n * Hand a customer message to the CRM. Idempotent on `messageRef`: 201 resolves `created: true`,\n * a repeat (200) resolves `created: false` with the same ids. One `threadRef` belongs to one\n * contact. Rejections surface as {@link CrmPartnerError} with the CRM's code, for example\n * `PARTNER_CHANNEL_DISABLED`, `CONTACT_NOT_FOUND`, `MESSAGE_REF_CONFLICT` (the `messageRef` is already used on\n * another thread; not retryable), `THREAD_CONTACT_MISMATCH`, `WORKSPACE_DISABLED`,\n * `RATE_LIMITED` and `SERVICE_BUSY`.\n */\n sendPartnerMessage(externalRef: string, message: PartnerMessageInput): Promise<PartnerMessageResult>;\n /**\n * Signed links (about one hour) to files of the conversation for `threadRef`: ids from\n * `media` in a send result, the webhook or the change feed, 1 to 50 a call. Ids of another\n * conversation or workspace, unknown or deleted are left out, so an unknown thread resolves\n * `[]`. Request links when you show a file and do not store them. Works while the channel or\n * its files are switched off.\n */\n getPartnerMediaLinks(externalRef: string, threadRef: string, mediaIds: string[]): Promise<PartnerMediaLink[]>;\n /** Delete the conversation for `threadRef`. `deleted: false` when there is none (already deleted, or never sent). */\n deletePartnerConversation(externalRef: string, threadRef: string): Promise<{ deleted: boolean }>;\n /**\n * One page of staff replies owed to you, oldest first. `limit` is 1 to 500 (default 100).\n *\n * Presenting a `cursor` acknowledges every row before it, so persist a page before calling\n * again with its `nextCursor`. Keep calling until `items` is empty and store the cursor that\n * call returns for the next poll. `nextCursor` is null only when no cursor was sent and there\n * are no rows. Never construct a cursor, and never reuse one across workspaces. A 400\n * `VALIDATION_ERROR` on a stored cursor means drop it and restart with none. Rows are kept 30\n * days. A reply appears a few seconds after it is sent. Delivered rows are included\n * (`deliveryStatus`); deduplicate on `messageId`.\n */\n listPartnerMessageChanges(externalRef: string, query?: { cursor?: string; limit?: number }): Promise<PartnerMessageChangesPage>;\n /**\n * Register (or change) the URL that receives staff replies. The first registration returns the\n * signing `secret`, shown once: store it. Changing the URL returns no secret. The URL must be\n * HTTPS (400 `VALIDATION_ERROR` otherwise).\n */\n setWebhook(input: { url: string }): Promise<{ url: string; secret?: string }>;\n /** The registered webhook, or `null` when none is registered (404). The secret is never returned. */\n getWebhook(): Promise<{ url: string; hasSecret: true } | null>;\n /** Replace the signing secret; the old one stops working at once. Throws a 404 error when no webhook is registered. */\n rotateWebhookSecret(): Promise<{ secret: string }>;\n /** Remove the webhook. Resolves also when none was registered. */\n deleteWebhook(): Promise<void>;\n}\n\n// ─── Implementation ──────────────────────────────────────────────────────────\n\nconst fromStatus = (w: PartnerWorkspaceStatus): PartnerWorkspace => ({\n externalRef: w.external_ref,\n workspaceId: w.workspace_id,\n embedAppId: w.embed_app_id,\n enabled: w.enabled,\n // Absent on a CRM from before the AI cap: reported as no cap.\n aiMonthlyCapCredits: typeof w.ai_monthly_cap_credits === 'number' ? w.ai_monthly_cap_credits : null,\n // Absent on a CRM from before the message channel: reported as off, no URL.\n partnerChannelEnabled: w.partner_channel_enabled === true,\n partnerFilesEnabled: w.partner_files_enabled === true,\n webhookUrl: typeof w.webhook_url === 'string' ? w.webhook_url : null,\n});\n\n/** Throws a 400 `invalid_date` unless `value` is a valid `Date` or a string; returns the wire string. */\nfunction sentAtWire(value: string | Date): string {\n if (value instanceof Date) {\n if (Number.isNaN(value.getTime())) throw new CrmPartnerError(400, 'invalid_date');\n return value.toISOString();\n }\n if (typeof value !== 'string') throw new CrmPartnerError(400, 'invalid_date');\n return value;\n}\n\nfunction isChange(v: unknown): v is WirePartnerMessageChange {\n return isRecord(v)\n && typeof v.delivery_id === 'string'\n && typeof v.external_ref === 'string'\n && typeof v.thread_ref === 'string'\n && typeof v.conversation_id === 'string'\n && typeof v.message_id === 'string'\n && typeof v.body === 'string'\n && typeof v.sent_at === 'string'\n && isRecord(v.sender)\n && isNullableString(v.sender.user_ref)\n && typeof v.sender.name === 'string'\n && (v.delivery_status === 'pending' || v.delivery_status === 'delivered' || v.delivery_status === 'failed');\n}\n\nconst USAGE_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** `YYYY-MM-DD` as given, or the UTC date of a `Date`; anything else is a 400 `invalid_date`. */\nfunction usageDate(value: string | Date): string {\n const text = value instanceof Date && !Number.isNaN(value.getTime()) ? value.toISOString().slice(0, 10) : value;\n if (typeof text !== 'string' || !USAGE_DATE.test(text)\n || Number.isNaN(Date.parse(`${text}T00:00:00Z`))\n || new Date(`${text}T00:00:00Z`).toISOString().slice(0, 10) !== text) {\n throw new CrmPartnerError(400, 'invalid_date');\n }\n return text;\n}\n\n/** Throws a 400 `invalid_cap` for anything the CRM would refuse, so a typo never leaves the process. */\nfunction checkCap(cap: number | null | undefined): number | null | undefined {\n if (cap === undefined || cap === null) return cap;\n if (typeof cap !== 'number' || !Number.isInteger(cap) || cap < 0 || cap > AI_MONTHLY_CAP_MAX_CREDITS) {\n throw new CrmPartnerError(400, 'invalid_cap');\n }\n return cap;\n}\n\nconst isNullableString = (v: unknown): v is string | null => v === null || typeof v === 'string';\n\nfunction isStatus(v: unknown): v is PartnerWorkspaceStatus {\n return isRecord(v)\n && typeof v.external_ref === 'string'\n && isNullableString(v.workspace_id)\n && isNullableString(v.embed_app_id)\n && typeof v.enabled === 'boolean';\n}\n\nexport function createCrmPartnerClient(opts: CrmPartnerClientOptions): CrmPartnerClient {\n if (!opts.crmBaseUrl) throw new Error('createCrmPartnerClient: `crmBaseUrl` is required.');\n if (!opts.partnerKey) throw new Error('createCrmPartnerClient: `partnerKey` is required.');\n const fetchImpl = resolveFetch(opts.fetch, 'createCrmPartnerClient');\n const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n const root = `${normalizeBase(opts.crmBaseUrl)}/api/partner/v1`;\n const base = `${root}/workspaces`;\n const redact = [opts.partnerKey];\n\n function checkRef(externalRef: string): string {\n if (typeof externalRef !== 'string' || !EXTERNAL_REF_PATTERN.test(externalRef)) {\n throw new CrmPartnerError(400, 'invalid_external_ref');\n }\n return externalRef;\n }\n\n async function call(method: string, path: string, body?: unknown, prefix: string = base): Promise<{ status: number; json: unknown }> {\n const res = await sendJson(fetchImpl, timeoutMs, `${prefix}/${path}`, {\n method,\n headers: { Authorization: `Bearer ${opts.partnerKey}` },\n body,\n });\n if (!res.ok) throw new CrmPartnerError(0, res.kind);\n if (res.status < 200 || res.status >= 300) {\n throw new CrmPartnerError(res.status, errorCodeFrom(res.json, res.status, redact));\n }\n return { status: res.status, json: res.json };\n }\n\n async function callForm(path: string, form: FormData): Promise<{ status: number; json: unknown }> {\n const res = await sendForm(fetchImpl, timeoutMs, `${base}/${path}`, {\n method: 'POST',\n headers: { Authorization: `Bearer ${opts.partnerKey}` },\n form,\n });\n if (!res.ok) throw new CrmPartnerError(0, res.kind);\n if (res.status < 200 || res.status >= 300) {\n throw new CrmPartnerError(res.status, errorCodeFrom(res.json, res.status, redact));\n }\n return { status: res.status, json: res.json };\n }\n\n const bad = (status: number) => new CrmPartnerError(status, 'bad_response');\n\n function checkThreadRef(threadRef: string): string {\n if (typeof threadRef !== 'string' || !CONTACT_REF_PATTERN.test(threadRef) || threadRef === '.' || threadRef === '..') {\n throw new CrmPartnerError(400, 'invalid_thread_ref');\n }\n return threadRef;\n }\n\n function checkContactRef(contactRef: string): string {\n if (typeof contactRef !== 'string' || !CONTACT_REF_PATTERN.test(contactRef)) {\n throw new CrmPartnerError(400, 'invalid_contact_ref');\n }\n return contactRef;\n }\n\n return {\n async upsertWorkspace(externalRef, body) {\n const ref = checkRef(externalRef);\n const {\n aiMonthlyCapCredits, partnerChannelEnabled, partnerFilesEnabled, webhookUrl, ...rest\n } = body;\n const cap = checkCap(aiMonthlyCapCredits);\n const wireBody: WirePartnerWorkspaceUpsertBody = { ...rest };\n if (cap !== undefined) wireBody.ai_monthly_cap_credits = cap;\n if (partnerChannelEnabled !== undefined) wireBody.partner_channel_enabled = partnerChannelEnabled;\n if (partnerFilesEnabled !== undefined) wireBody.partner_files_enabled = partnerFilesEnabled;\n if (webhookUrl !== undefined) wireBody.webhook_url = webhookUrl;\n const { status, json } = await call('PUT', ref, wireBody);\n if (!isStatus(json)) throw bad(status);\n const wire = json as PartnerWorkspaceCreated | PartnerWorkspaceExisting;\n if (wire.created === true) {\n const secret = (wire as PartnerWorkspaceCreated).embed_app_secret;\n if (typeof secret !== 'string' || !secret) throw bad(status);\n return { ...fromStatus(wire), created: true, embedAppSecret: secret };\n }\n if (wire.created === false) return { ...fromStatus(wire), created: false };\n throw bad(status);\n },\n\n async getWorkspace(externalRef) {\n const ref = checkRef(externalRef);\n try {\n const { status, json } = await call('GET', ref);\n if (!isStatus(json) || typeof (json as Record<string, unknown>).state !== 'string') throw bad(status);\n const ai = (json as unknown as WirePartnerWorkspaceDetail).ai;\n return {\n ...fromStatus(json),\n state: (json as unknown as WirePartnerWorkspaceDetail).state,\n ai: isRecord(ai) && typeof ai.period === 'string' && typeof ai.used_credits === 'number'\n ? { period: ai.period, usedCredits: ai.used_credits }\n : null,\n };\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async updateWorkspace(externalRef, patch) {\n const ref = checkRef(externalRef);\n const body: WirePartnerWorkspacePatchBody = {};\n if (patch.enabled !== undefined) body.enabled = patch.enabled;\n if (patch.name !== undefined) body.name = patch.name;\n const cap = checkCap(patch.aiMonthlyCapCredits);\n if (cap !== undefined) body.ai_monthly_cap_credits = cap;\n if (patch.partnerChannelEnabled !== undefined) body.partner_channel_enabled = patch.partnerChannelEnabled;\n if (patch.partnerFilesEnabled !== undefined) body.partner_files_enabled = patch.partnerFilesEnabled;\n if (patch.webhookUrl !== undefined) body.webhook_url = patch.webhookUrl;\n const { status, json } = await call('PATCH', ref, body);\n if (!isStatus(json)) throw bad(status);\n return fromStatus(json);\n },\n\n async getWorkspaceUsage(externalRef, range) {\n const ref = checkRef(externalRef);\n const qs = new URLSearchParams({ from: usageDate(range.from), to: usageDate(range.to) });\n try {\n const { status, json } = await call('GET', `${ref}/usage?${qs.toString()}`);\n if (!isRecord(json) || !isRecord(json.totals) || !isRecord(json.cap) || !Array.isArray(json.by_operation)) throw bad(status);\n return json as unknown as PartnerWorkspaceUsage;\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async rotateWorkspaceSecret(externalRef) {\n const ref = checkRef(externalRef);\n const { status, json } = await call('POST', `${ref}/rotate-secret`);\n const w = json as Partial<PartnerWorkspaceSecret> | null;\n if (!isRecord(json) || typeof w?.embed_app_id !== 'string' || typeof w.embed_app_secret !== 'string' || !w.embed_app_secret) {\n throw bad(status);\n }\n return { embedAppId: w.embed_app_id, embedAppSecret: w.embed_app_secret };\n },\n\n async upsertContact(externalRef, contactRef, body) {\n const ref = checkRef(externalRef);\n const cref = checkContactRef(contactRef);\n const { status, json } = await call('PUT', `${ref}/contacts/${encodeURIComponent(cref)}`, body);\n if (!isRecord(json) || !isRecord(json.contact) || typeof json.created !== 'boolean' || typeof json.consent_applied !== 'boolean') {\n throw bad(status);\n }\n return json as unknown as ContactRefUpsertResult;\n },\n\n async eraseContact(externalRef, contactRef) {\n const ref = checkRef(externalRef);\n const cref = checkContactRef(contactRef);\n try {\n const { status, json } = await call('DELETE', `${ref}/contacts/${encodeURIComponent(cref)}`);\n if (!isRecord(json) || json.erased !== true || typeof json.contact_id !== 'string') throw bad(status);\n return json as unknown as PartnerContactEraseResult;\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async eraseContactsByIdentity(externalRef, identity) {\n const ref = checkRef(externalRef);\n const phone = typeof identity?.phone === 'string' ? identity.phone.trim() : undefined;\n const email = typeof identity?.email === 'string' ? identity.email.trim() : undefined;\n const hasPhone = phone !== undefined && /\\d/.test(phone);\n const hasEmail = email !== undefined && email.includes('@');\n if ((identity?.phone !== undefined && !hasPhone) || (identity?.email !== undefined && !hasEmail) || (!hasPhone && !hasEmail)) {\n throw new CrmPartnerError(400, 'invalid_identity');\n }\n if (identity.ref !== undefined) checkContactRef(identity.ref);\n const body: PartnerContactEraseByIdentityBody = {};\n if (hasPhone) body.phone = phone;\n if (hasEmail) body.email = email;\n if (identity.ref !== undefined) body.ref = identity.ref;\n try {\n const { status, json } = await call('POST', `${ref}/contacts/erase-by-identity`, body);\n if (\n !isRecord(json)\n || typeof json.erased !== 'number'\n || !Array.isArray(json.contact_ids)\n || typeof json.skipped_linked_elsewhere !== 'number'\n ) {\n throw bad(status);\n }\n return json as unknown as PartnerContactEraseByIdentityResult;\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async listContactChanges(externalRef, query = {}) {\n const ref = checkRef(externalRef);\n const { since, cursor, limit } = query;\n if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > CONTACT_CHANGES_MAX_LIMIT)) {\n throw new CrmPartnerError(400, 'invalid_limit');\n }\n const qs = new URLSearchParams();\n if (since !== undefined) qs.set('since', since);\n if (cursor !== undefined) qs.set('cursor', cursor);\n if (limit !== undefined) qs.set('limit', String(limit));\n const q = qs.toString();\n const { status, json } = await call('GET', `${ref}/contacts/changes${q ? `?${q}` : ''}`);\n if (!isRecord(json) || !Array.isArray(json.items) || !(json.next_cursor === null || typeof json.next_cursor === 'string')) {\n throw bad(status);\n }\n return json as unknown as ContactChanges;\n },\n\n async sendPartnerMessage(externalRef, message) {\n const ref = checkRef(externalRef);\n const wireBody: PartnerInboundMessageBody = {\n contact_ref: checkContactRef(message.contactRef),\n thread_ref: message.threadRef,\n message_ref: message.messageRef,\n body: message.body,\n sent_at: sentAtWire(message.sentAt),\n };\n if (message.title !== undefined) wireBody.title = message.title;\n if (message.teamRef !== undefined) wireBody.team_ref = message.teamRef;\n let answer: { status: number; json: unknown };\n if (message.file) {\n const form = new FormData();\n for (const [key, value] of Object.entries(wireBody)) {\n if (value !== undefined) form.append(key, String(value));\n }\n const { data, name, type } = message.file;\n const blob = data instanceof Blob ? data : new Blob([data as BlobPart], { type });\n form.append('file', blob.type === type ? blob : new Blob([blob], { type }), name);\n answer = await callForm(`${ref}/messages/file`, form);\n } else {\n answer = await call('POST', `${ref}/messages`, wireBody);\n }\n const { status, json } = answer;\n if (!isRecord(json) || typeof json.conversation_id !== 'string' || typeof json.message_id !== 'string' || typeof json.created !== 'boolean') {\n throw bad(status);\n }\n const wire = json as unknown as PartnerInboundMessageResult;\n const media = parsePartnerMedia(wire.media);\n if (media === null) throw bad(status);\n return {\n conversationId: wire.conversation_id, messageId: wire.message_id, created: wire.created, media,\n };\n },\n\n async getPartnerMediaLinks(externalRef, threadRef, mediaIds) {\n const ref = checkRef(externalRef);\n const thread = checkThreadRef(threadRef);\n const wireBody: PartnerMediaLinksBody = { media_ids: mediaIds };\n const { status, json } = await call('POST', `${ref}/conversations/${encodeURIComponent(thread)}/media-links`, wireBody);\n if (!isRecord(json) || !Array.isArray(json.items)) throw bad(status);\n return json.items.map((item: unknown) => {\n if (!isRecord(item) || typeof item.id !== 'string' || typeof item.url !== 'string' || typeof item.expires_at !== 'string') {\n throw bad(status);\n }\n return { id: item.id, url: item.url, expiresAt: item.expires_at };\n });\n },\n\n async deletePartnerConversation(externalRef, threadRef) {\n const ref = checkRef(externalRef);\n const thread = checkThreadRef(threadRef);\n const { status, json } = await call('DELETE', `${ref}/conversations/${encodeURIComponent(thread)}`);\n if (!isRecord(json) || typeof json.deleted !== 'boolean') throw bad(status);\n return { deleted: (json as unknown as PartnerThreadDeleteResult).deleted };\n },\n\n async listPartnerMessageChanges(externalRef, query = {}) {\n const ref = checkRef(externalRef);\n const { cursor, limit } = query;\n if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > PARTNER_MESSAGE_CHANGES_MAX_LIMIT)) {\n throw new CrmPartnerError(400, 'invalid_limit');\n }\n const qs = new URLSearchParams();\n if (cursor !== undefined) qs.set('cursor', cursor);\n if (limit !== undefined) qs.set('limit', String(limit));\n const q = qs.toString();\n const { status, json } = await call('GET', `${ref}/messages/changes${q ? `?${q}` : ''}`);\n if (!isRecord(json) || !Array.isArray(json.items) || !(json.next_cursor === null || typeof json.next_cursor === 'string')) {\n throw bad(status);\n }\n const page = json as unknown as WirePartnerMessageChanges;\n const items: PartnerMessageChange[] = page.items.map((item: unknown) => {\n if (!isChange(item)) throw bad(status);\n const media = parsePartnerMedia((item as { media?: unknown }).media);\n if (media === null) throw bad(status);\n return {\n deliveryId: item.delivery_id,\n externalRef: item.external_ref,\n threadRef: item.thread_ref,\n conversationId: item.conversation_id,\n messageId: item.message_id,\n body: item.body,\n sentAt: item.sent_at,\n sender: { userRef: item.sender.user_ref, name: item.sender.name },\n deliveryStatus: item.delivery_status,\n media,\n };\n });\n return { items, nextCursor: page.next_cursor };\n },\n\n async setWebhook(input) {\n const wireBody: PartnerWebhookPutBody = { url: input.url };\n const { status, json } = await call('PUT', 'webhook', wireBody, root);\n if (!isRecord(json) || typeof json.url !== 'string') throw bad(status);\n if (status === 201) {\n const secret = (json as unknown as PartnerWebhookCreated).secret;\n if (typeof secret !== 'string' || !secret) throw bad(status);\n return { url: json.url, secret };\n }\n return { url: (json as unknown as PartnerWebhookUpdated).url };\n },\n\n async getWebhook() {\n try {\n const { status, json } = await call('GET', 'webhook', undefined, root);\n if (!isRecord(json) || typeof json.url !== 'string' || json.has_secret !== true) throw bad(status);\n return { url: (json as unknown as PartnerWebhookGet).url, hasSecret: true as const };\n } catch (err) {\n if (err instanceof CrmPartnerError && err.status === 404) return null;\n throw err;\n }\n },\n\n async rotateWebhookSecret() {\n const { status, json } = await call('POST', 'webhook/rotate-secret', undefined, root);\n const secret = isRecord(json) ? (json as unknown as Partial<PartnerWebhookRotate>).secret : undefined;\n if (typeof secret !== 'string' || !secret) throw bad(status);\n return { secret };\n },\n\n async deleteWebhook() {\n await call('DELETE', 'webhook', undefined, root);\n },\n };\n}\n\n// Re-exported so partner code can type its inputs without importing the contracts module.\nexport type {\n ContactChanges,\n ContactChangesQuery,\n ContactRefUpsertBody,\n ContactRefUpsertResult,\n PartnerContactEraseByIdentityBody,\n PartnerContactEraseByIdentityResult,\n PartnerContactEraseResult,\n PartnerWorkspaceUsage,\n};\n"],"mappings":"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","names":["normalizeBase","crmBaseUrl","resolveFetch","fetchImpl","who","f","sendJson","timeoutMs","url","init","controller","timedOut","timer","headers","hasBody","res","json","sendForm","SAFE_CODE","errorCodeFrom","status","redact","fallback","pick","v","r","o","err","isRecord","isRecord","value","parsePartnerMedia","out","item","createHmac","timingSafeEqual","PartnerWebhookVerificationError","_PartnerWebhookVerificationError","reason","DEFAULT_TOLERANCE_SECONDS","SIGNATURE_HEX","PLAIN_INTEGER","headerValue","headers","name","record","key","value","first","isString","isRecord","parseEvent","rawBody","data","sender","media","parsePartnerMedia","verifyPartnerWebhook","input","timestamp","signature","tolerance","nowSeconds","expected","createHmac","timingSafeEqual","CrmPartnerError","_CrmPartnerError","status","code","EXTERNAL_REF_PATTERN","CONTACT_REF_PATTERN","CONTACT_CHANGES_MAX_LIMIT","PARTNER_MESSAGE_CHANGES_MAX_LIMIT","AI_MONTHLY_CAP_MAX_CREDITS","fromStatus","w","sentAtWire","value","isChange","v","isRecord","isNullableString","USAGE_DATE","usageDate","text","checkCap","cap","isStatus","createCrmPartnerClient","opts","fetchImpl","resolveFetch","timeoutMs","root","normalizeBase","base","redact","checkRef","externalRef","call","method","path","body","prefix","res","sendJson","errorCodeFrom","callForm","form","sendForm","bad","checkThreadRef","threadRef","checkContactRef","contactRef","ref","aiMonthlyCapCredits","partnerChannelEnabled","partnerFilesEnabled","webhookUrl","rest","wireBody","json","wire","secret","ai","err","patch","range","qs","cref","identity","phone","email","hasPhone","hasEmail","query","since","cursor","limit","q","message","answer","key","data","name","type","blob","media","parsePartnerMedia","mediaIds","thread","item","page","input"]}
|