@first-to-fly/crm-sdk 1.1.0 → 1.3.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 +197 -10
- package/dist/api.cjs +2 -0
- package/dist/api.cjs.map +1 -0
- package/dist/api.d.cts +842 -0
- package/dist/api.d.ts +842 -0
- package/dist/api.js +2 -0
- package/dist/api.js.map +1 -0
- package/dist/embed-server.cjs +1 -1
- package/dist/embed-server.cjs.map +1 -1
- package/dist/embed-server.d.cts +72 -32
- package/dist/embed-server.d.ts +72 -32
- package/dist/embed-server.js +1 -1
- package/dist/embed-server.js.map +1 -1
- package/package.json +12 -2
package/dist/api.js
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
var g=class r extends Error{constructor(c,a,o,i,n){super(o),this.name="CrmApiError",this.status=c,this.code=a,this.body=i,n&&"cause"in n&&(this.cause=n.cause),Object.setPrototypeOf(this,r.prototype)}};function w(r){if(!r)return"";let c=new URLSearchParams;for(let[o,i]of Object.entries(r))if(i!=null)if(Array.isArray(i))for(let n of i)n!=null&&c.append(o,String(n));else c.append(o,String(i));let a=c.toString();return a?`?${a}`:""}function v(r){return typeof r=="object"&&r!==null&&"success"in r}function R(r,c){let a=v(r)&&r.success===!1?r:void 0,o=a?.error,i=typeof a?.message=="string"?a.message:void 0,n=o&&typeof o=="object"?o:void 0,f=typeof n?.code=="string"?n.code:void 0,C=typeof n?.message=="string"?n.message:void 0,t=typeof o=="string"?o:void 0,e=f??t??`HTTP_${c}`,s=C??i??t??`CRM request failed with status ${c}`;return{code:e,message:s}}function Q(r){let{crmBaseUrl:c,accessToken:a,apiKey:o}=r;if(!a&&!o)throw new Error("createCrmApiClient: exactly one of `accessToken` or `apiKey` is required (got neither).");if(a&&o)throw new Error("createCrmApiClient: provide only one of `accessToken` or `apiKey` (got both).");let i=r.fetch??globalThis.fetch;if(typeof i!="function")throw new Error("createCrmApiClient: no fetch implementation available. Pass `fetch` explicitly.");let n=c.replace(/\/+$/,""),f=n.endsWith("/api")?n:`${n}/api`,C=a?{Authorization:`Bearer ${a}`}:{"X-API-Key":o};async function t(e,s,p={}){let b=`${f}${s}${w(p.query)}`,k={...C},h=p.body!==void 0;h&&(k["Content-Type"]="application/json");let y=p.timeoutMs??r.timeoutMs,T=y!==void 0?new AbortController:void 0,L=!1,P;T&&y!==void 0&&(P=setTimeout(()=>{L=!0,T.abort()},y));let m;try{m=await i(b,{method:e,headers:k,body:h?JSON.stringify(p.body):void 0,signal:T?.signal})}catch(u){if(L||u instanceof Error&&u.name==="AbortError")throw new g(0,"TIMEOUT",`CRM request timed out after ${y}ms`,u,{cause:u});let E=u instanceof Error?u.message:"CRM request failed (network error)";throw new g(0,"NETWORK_ERROR",E,u,{cause:u})}finally{P!==void 0&&clearTimeout(P)}let l=await m.text(),d=l;if(l)try{d=JSON.parse(l)}catch{d=l}let U=v(d)&&d.success===!1;if(!m.ok||U){let{code:u,message:E}=R(d,m.status);throw new g(m.status,u,E,d)}if(v(d)&&d.success===!0)return d.data;if(l!=="")return d}return{contacts:{list:e=>t("GET","/contacts",{query:e}),get:e=>t("GET",`/contacts/${encodeURIComponent(e)}`),create:e=>t("POST","/contacts",{body:e}),update:(e,s)=>t("PUT",`/contacts/${encodeURIComponent(e)}`,{body:s}),delete:e=>t("DELETE",`/contacts/${encodeURIComponent(e)}`)},leads:{list:e=>t("GET","/leads",{query:e}),get:e=>t("GET",`/leads/${encodeURIComponent(e)}`),create:e=>t("POST","/leads",{body:e}),update:(e,s)=>t("PUT",`/leads/${encodeURIComponent(e)}`,{body:s}),delete:e=>t("DELETE",`/leads/${encodeURIComponent(e)}`)},tasks:{list:e=>t("GET","/tasks",{query:e}),create:(e,s)=>t("POST",`/leads/${encodeURIComponent(e)}/tasks`,{body:s}),update:(e,s,p)=>t("PATCH",`/leads/${encodeURIComponent(e)}/tasks/${encodeURIComponent(s)}`,{body:p})},products:{list:e=>t("GET","/products",{query:e}),get:e=>t("GET",`/products/${encodeURIComponent(e)}`),create:e=>t("POST","/products",{body:e}),update:(e,s)=>t("PUT",`/products/${encodeURIComponent(e)}`,{body:s}),delete:e=>t("DELETE",`/products/${encodeURIComponent(e)}`)},conversations:{list:e=>t("GET","/conversations",{query:e}),get:e=>t("GET",`/conversations/${encodeURIComponent(e)}`),update:(e,s)=>t("PUT",`/conversations/${encodeURIComponent(e)}`,{body:s}),messages:{list:(e,s)=>t("GET",`/conversations/${encodeURIComponent(e)}/messages`,{query:s}),send:(e,s)=>t("POST",`/conversations/${encodeURIComponent(e)}/messages`,{body:s})}},tags:{list:e=>t("GET","/tags",{query:e}),create:e=>t("POST","/tags",{body:e})},request:t}}var $=Q;export{g as CrmApiError,Q as createCrmApiClient,$ as default};
|
|
2
|
+
//# sourceMappingURL=api.js.map
|
package/dist/api.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/api.ts"],"sourcesContent":["/**\n * Typed CRM REST API client for SaaS backends.\n *\n * Construct with `createCrmApiClient({ crmBaseUrl, accessToken | apiKey })` and\n * call typed resource methods (contacts, leads, conversations, messages, tasks,\n * products, tags) or the generic `request<T>()` escape hatch. Every method\n * returns the UNWRAPPED `data` from the CRM's `{ success, data }` envelope.\n *\n * Auth:\n * - `accessToken` (from `createEmbedSessionWithKey().data.access_token`) is\n * sent as `Authorization: Bearer <token>` and covers the full API surface.\n * The typed resource methods below hit `/api/*` routes that require this\n * **Bearer** token.\n * - `apiKey` (`crm_live_...`) is sent as `X-API-Key` and today only guards\n * `/api/public/*`. An `apiKey` client should use the generic `request()`\n * against those `/public/*` endpoints, NOT the typed resource methods.\n *\n * Error handling — every failure is thrown as a {@link CrmApiError} so callers\n * can `catch (e) { if (e instanceof CrmApiError) ... }`:\n * - non-2xx responses, AND 2xx responses the server mislabels with an\n * `{ success: false }` envelope, throw with the HTTP `status` and a code\n * derived from the body.\n * - network / DNS / connection failures throw with `status: 0` and\n * `code: 'NETWORK_ERROR'`.\n * - a request that exceeds `timeoutMs` (via `AbortController`) throws with\n * `status: 0` and `code: 'TIMEOUT'`.\n *\n * Timeouts — pass `timeoutMs` on the client (default for all requests) and/or\n * per request. If unset there is no timeout.\n *\n * @packageDocumentation\n */\n\nimport type {\n Contact,\n ContactCreate,\n ContactUpdate,\n ContactQuery,\n ContactList,\n Lead,\n LeadCreate,\n LeadUpdate,\n LeadQuery,\n Task,\n TaskCreate,\n TaskUpdate,\n TaskQuery,\n Conversation,\n ConversationQuery,\n ConversationUpdate,\n Message,\n MessageQuery,\n MessageCreate,\n Product,\n ProductCreate,\n ProductUpdate,\n ProductQuery,\n Tag,\n TagCreate,\n TagQuery,\n TagWithUsage,\n ListEnvelope,\n} from './generated/crm-contracts';\n\nexport type * from './generated/crm-contracts';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype FetchLike = typeof fetch;\n\n/** Options for {@link createCrmApiClient}. Exactly one of accessToken / apiKey. */\nexport interface CrmApiClientOptions {\n /** Base URL of the CRM, e.g. `https://crm.example.com` (no trailing `/api`). */\n crmBaseUrl: string;\n /** Bearer token from `createEmbedSessionWithKey` — full API surface. */\n accessToken?: string;\n /** Server-to-server API key (`crm_live_...`) — `/api/public/*` only today. */\n apiKey?: string;\n /** Custom fetch implementation (e.g. for Node < 18 or testing). */\n fetch?: FetchLike;\n /**\n * Default per-request timeout in milliseconds, enforced via `AbortController`.\n * On timeout the request throws a {@link CrmApiError} (`status: 0`,\n * `code: 'TIMEOUT'`). If unset (default), requests have no timeout.\n */\n timeoutMs?: number;\n}\n\n/** CRM success envelope. */\ninterface SuccessEnvelope<T> {\n success: true;\n data: T;\n message?: string;\n meta?: Record<string, unknown>;\n}\n\n/** CRM error envelope. */\ninterface ErrorEnvelope {\n success: false;\n error: string;\n message?: string;\n details?: string;\n}\n\ntype QueryPrimitive = string | number | boolean;\ntype QueryValue =\n | QueryPrimitive\n | Array<QueryPrimitive>\n | undefined\n | null;\ntype QueryParams = Record<string, QueryValue>;\n\ninterface RequestOptions {\n query?: QueryParams;\n body?: unknown;\n /**\n * Per-request timeout in milliseconds (overrides the client `timeoutMs`).\n * On timeout the request throws a {@link CrmApiError} (`status: 0`,\n * `code: 'TIMEOUT'`).\n */\n timeoutMs?: number;\n}\n\n/**\n * Error thrown for any failed CRM request:\n * - a non-2xx HTTP response,\n * - a 2xx response carrying an `{ success: false }` envelope (server mislabel),\n * - a network/DNS/connection failure (`status: 0`, `code: 'NETWORK_ERROR'`),\n * - a timeout / abort (`status: 0`, `code: 'TIMEOUT'`).\n */\nexport class CrmApiError extends Error {\n /** HTTP status code (0 for network errors / timeouts). */\n readonly status: number;\n /**\n * Machine-readable code. For envelope errors: the object `error.code`, else\n * the string `error`, else `HTTP_<status>`. For transport failures:\n * `NETWORK_ERROR` or `TIMEOUT`.\n */\n readonly code: string;\n /** Parsed response body, or the underlying error for transport failures. */\n readonly body: unknown;\n\n constructor(\n status: number,\n code: string,\n message: string,\n body: unknown,\n options?: { cause?: unknown },\n ) {\n super(message);\n this.name = 'CrmApiError';\n this.status = status;\n this.code = code;\n this.body = body;\n // Preserve the underlying error (network/abort) without requiring the\n // ES2022 `cause` constructor option.\n if (options && 'cause' in options) {\n (this as { cause?: unknown }).cause = options.cause;\n }\n Object.setPrototypeOf(this, CrmApiError.prototype);\n }\n}\n\n/** The client returned by {@link createCrmApiClient}. */\nexport interface CrmApiClient {\n contacts: {\n list(query?: ContactQuery): Promise<ContactList>;\n get(id: string): Promise<Contact>;\n create(body: ContactCreate): Promise<Contact>;\n update(id: string, body: ContactUpdate): Promise<Contact>;\n delete(id: string): Promise<void>;\n };\n leads: {\n list(query?: LeadQuery): Promise<ListEnvelope<Lead>>;\n get(id: string): Promise<Lead>;\n create(body: LeadCreate): Promise<Lead>;\n update(id: string, body: LeadUpdate): Promise<Lead>;\n delete(id: string): Promise<void>;\n };\n tasks: {\n list(query?: TaskQuery): Promise<ListEnvelope<Task>>;\n create(leadId: string, body: TaskCreate): Promise<Task>;\n update(leadId: string, taskId: string, body: TaskUpdate): Promise<Task>;\n };\n products: {\n list(query?: ProductQuery): Promise<ListEnvelope<Product>>;\n get(id: string): Promise<Product>;\n create(body: ProductCreate): Promise<Product>;\n update(id: string, body: ProductUpdate): Promise<Product>;\n delete(id: string): Promise<void>;\n };\n conversations: {\n list(query?: ConversationQuery): Promise<ListEnvelope<Conversation>>;\n get(id: string): Promise<Conversation>;\n update(id: string, body: ConversationUpdate): Promise<Conversation>;\n messages: {\n list(\n conversationId: string,\n query?: MessageQuery,\n ): Promise<ListEnvelope<Message>>;\n send(conversationId: string, body: MessageCreate): Promise<Message>;\n };\n };\n tags: {\n list(query?: TagQuery): Promise<ListEnvelope<TagWithUsage>>;\n create(body: TagCreate): Promise<Tag>;\n };\n /** Generic escape hatch — returns the unwrapped `data` typed as `T`. */\n request<T>(\n method: string,\n path: string,\n options?: RequestOptions,\n ): Promise<T>;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Serialize query params. Array values are appended as repeated params\n * (`?tag=a&tag=b`); `undefined`/`null` values (and array elements) are skipped.\n *\n * NOTE on the CRM's `tags` filter: the CRM's contacts/leads query schemas expect\n * `tags` as a single comma-separated string (`?tags=a,b`), which the server\n * splits on `,`. If you pass `tags` as an array here it becomes repeated params\n * (`?tags=a&tags=b`), which those endpoints will NOT parse as multiple tags —\n * pass a comma-joined string for that specific field. All other core query\n * fields are primitives. No core query field is a nested object.\n */\nfunction serializeQuery(query?: QueryParams): string {\n if (!query) return '';\n const params = new URLSearchParams();\n for (const [key, value] of Object.entries(query)) {\n if (value === undefined || value === null) continue;\n if (Array.isArray(value)) {\n for (const el of value) {\n if (el === undefined || el === null) continue;\n params.append(key, String(el));\n }\n } else {\n params.append(key, String(value));\n }\n }\n const qs = params.toString();\n return qs ? `?${qs}` : '';\n}\n\nfunction isEnvelope(v: unknown): v is SuccessEnvelope<unknown> | ErrorEnvelope {\n return typeof v === 'object' && v !== null && 'success' in v;\n}\n\n/** Derive `{ code, message }` from a parsed CRM error envelope + HTTP status. */\nfunction deriveError(parsed: unknown, status: number): { code: string; message: string } {\n const envelope =\n isEnvelope(parsed) && parsed.success === false\n ? (parsed as ErrorEnvelope & { error?: unknown })\n : undefined;\n const rawError: unknown = envelope?.error;\n const envMessage =\n typeof envelope?.message === 'string' ? envelope.message : undefined;\n\n // error can be a string (\"human string\" or a code) OR an object { code, message }.\n const errorObj =\n rawError && typeof rawError === 'object'\n ? (rawError as { code?: unknown; message?: unknown })\n : undefined;\n const errorObjCode =\n typeof errorObj?.code === 'string' ? errorObj.code : undefined;\n const errorObjMessage =\n typeof errorObj?.message === 'string' ? errorObj.message : undefined;\n const errorStr = typeof rawError === 'string' ? rawError : undefined;\n\n const code = errorObjCode ?? errorStr ?? `HTTP_${status}`;\n const message =\n errorObjMessage ??\n envMessage ??\n errorStr ??\n `CRM request failed with status ${status}`;\n\n return { code, message };\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\nexport function createCrmApiClient(opts: CrmApiClientOptions): CrmApiClient {\n const { crmBaseUrl, accessToken, apiKey } = opts;\n\n if (!accessToken && !apiKey) {\n throw new Error(\n 'createCrmApiClient: exactly one of `accessToken` or `apiKey` is required (got neither).',\n );\n }\n if (accessToken && apiKey) {\n throw new Error(\n 'createCrmApiClient: provide only one of `accessToken` or `apiKey` (got both).',\n );\n }\n\n const fetchImpl: FetchLike = opts.fetch ?? globalThis.fetch;\n if (typeof fetchImpl !== 'function') {\n throw new Error(\n 'createCrmApiClient: no fetch implementation available. Pass `fetch` explicitly.',\n );\n }\n\n // Normalize base: strip trailing slash, then ensure it ends with `/api`.\n const trimmed = crmBaseUrl.replace(/\\/+$/, '');\n const apiBase = trimmed.endsWith('/api') ? trimmed : `${trimmed}/api`;\n\n const authHeaders: Record<string, string> = accessToken\n ? { Authorization: `Bearer ${accessToken}` }\n : { 'X-API-Key': apiKey as string };\n\n async function request<T>(\n method: string,\n path: string,\n options: RequestOptions = {},\n ): Promise<T> {\n const url = `${apiBase}${path}${serializeQuery(options.query)}`;\n const headers: Record<string, string> = { ...authHeaders };\n const hasBody = options.body !== undefined;\n if (hasBody) headers['Content-Type'] = 'application/json';\n\n const timeoutMs = options.timeoutMs ?? opts.timeoutMs;\n const controller =\n timeoutMs !== undefined ? new AbortController() : undefined;\n let timedOut = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n if (controller && timeoutMs !== undefined) {\n timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, timeoutMs);\n }\n\n let res: Response;\n try {\n res = await fetchImpl(url, {\n method,\n headers,\n body: hasBody ? JSON.stringify(options.body) : undefined,\n signal: controller?.signal,\n });\n } catch (err) {\n // Network error, DNS failure, connection refused, or abort/timeout.\n if (\n timedOut ||\n (err instanceof Error && err.name === 'AbortError')\n ) {\n throw new CrmApiError(\n 0,\n 'TIMEOUT',\n `CRM request timed out after ${timeoutMs}ms`,\n err,\n { cause: err },\n );\n }\n const message =\n err instanceof Error ? err.message : 'CRM request failed (network error)';\n throw new CrmApiError(0, 'NETWORK_ERROR', message, err, { cause: err });\n } finally {\n if (timer !== undefined) clearTimeout(timer);\n }\n\n // Parse body (JSON when possible, else raw text).\n const text = await res.text();\n let parsed: unknown = text;\n if (text) {\n try {\n parsed = JSON.parse(text);\n } catch {\n parsed = text;\n }\n }\n\n // Treat an `{ success: false }` envelope as an error regardless of HTTP\n // status — a server can mislabel an error as 2xx.\n const isEnvelopeError = isEnvelope(parsed) && parsed.success === false;\n if (!res.ok || isEnvelopeError) {\n const { code, message } = deriveError(parsed, res.status);\n throw new CrmApiError(res.status, code, message, parsed);\n }\n\n // Unwrap `{ success, data }`.\n if (isEnvelope(parsed) && parsed.success === true) {\n return parsed.data as T;\n }\n\n // Empty 2xx body (e.g. 204 / empty DELETE) → undefined, not \"\".\n if (text === '') {\n return undefined as T;\n }\n\n // Non-enveloped 2xx response — return the raw parsed body.\n return parsed as T;\n }\n\n return {\n contacts: {\n list: (query) => request<ContactList>('GET', '/contacts', { query: query as QueryParams }),\n get: (id) => request<Contact>('GET', `/contacts/${encodeURIComponent(id)}`),\n create: (body) => request<Contact>('POST', '/contacts', { body }),\n update: (id, body) => request<Contact>('PUT', `/contacts/${encodeURIComponent(id)}`, { body }),\n delete: (id) => request<void>('DELETE', `/contacts/${encodeURIComponent(id)}`),\n },\n leads: {\n list: (query) => request<ListEnvelope<Lead>>('GET', '/leads', { query: query as QueryParams }),\n get: (id) => request<Lead>('GET', `/leads/${encodeURIComponent(id)}`),\n create: (body) => request<Lead>('POST', '/leads', { body }),\n update: (id, body) => request<Lead>('PUT', `/leads/${encodeURIComponent(id)}`, { body }),\n delete: (id) => request<void>('DELETE', `/leads/${encodeURIComponent(id)}`),\n },\n tasks: {\n list: (query) => request<ListEnvelope<Task>>('GET', '/tasks', { query: query as QueryParams }),\n create: (leadId, body) =>\n request<Task>('POST', `/leads/${encodeURIComponent(leadId)}/tasks`, { body }),\n update: (leadId, taskId, body) =>\n request<Task>(\n 'PATCH',\n `/leads/${encodeURIComponent(leadId)}/tasks/${encodeURIComponent(taskId)}`,\n { body },\n ),\n },\n products: {\n list: (query) => request<ListEnvelope<Product>>('GET', '/products', { query: query as QueryParams }),\n get: (id) => request<Product>('GET', `/products/${encodeURIComponent(id)}`),\n create: (body) => request<Product>('POST', '/products', { body }),\n update: (id, body) => request<Product>('PUT', `/products/${encodeURIComponent(id)}`, { body }),\n delete: (id) => request<void>('DELETE', `/products/${encodeURIComponent(id)}`),\n },\n conversations: {\n list: (query) =>\n request<ListEnvelope<Conversation>>('GET', '/conversations', { query: query as QueryParams }),\n get: (id) => request<Conversation>('GET', `/conversations/${encodeURIComponent(id)}`),\n update: (id, body) =>\n request<Conversation>('PUT', `/conversations/${encodeURIComponent(id)}`, { body }),\n messages: {\n list: (conversationId, query) =>\n request<ListEnvelope<Message>>(\n 'GET',\n `/conversations/${encodeURIComponent(conversationId)}/messages`,\n { query: query as QueryParams },\n ),\n send: (conversationId, body) =>\n request<Message>(\n 'POST',\n `/conversations/${encodeURIComponent(conversationId)}/messages`,\n { body },\n ),\n },\n },\n tags: {\n list: (query) => request<ListEnvelope<TagWithUsage>>('GET', '/tags', { query: query as QueryParams }),\n create: (body) => request<Tag>('POST', '/tags', { body }),\n },\n request,\n };\n}\n\nexport default createCrmApiClient;\n"],"mappings":"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","names":["CrmApiError","_CrmApiError","status","code","message","body","options","serializeQuery","query","params","key","value","el","qs","isEnvelope","v","deriveError","parsed","envelope","rawError","envMessage","errorObj","errorObjCode","errorObjMessage","errorStr","createCrmApiClient","opts","crmBaseUrl","accessToken","apiKey","fetchImpl","trimmed","apiBase","authHeaders","request","method","path","url","headers","hasBody","timeoutMs","controller","timedOut","timer","res","err","text","isEnvelopeError","id","leadId","taskId","conversationId","api_default"]}
|
package/dist/embed-server.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
"use strict";var
|
|
1
|
+
"use strict";var l=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var S=(e,t)=>{for(var r in t)l(e,r,{get:t[r],enumerable:!0})},w=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of h(t))!x.call(e,s)&&s!==r&&l(e,s,{get:()=>t[s],enumerable:!(n=f(t,s))||n.enumerable});return e};var k=e=>w(l({},"__esModule",{value:!0}),e);var T={};S(T,{CrmExchangeError:()=>d,createEmbedSession:()=>U,createEmbedSessionWithKey:()=>C,exchangeAssertion:()=>b,getCrmEmbedJwks:()=>P,mintCrmAssertion:()=>y,resetCrmEmbedKeys:()=>I});module.exports=k(T);var o=require("jose"),d=class extends Error{constructor(r,n,s,a){super(r);this.status=n;this.code=s;this.detail=a;this.name="CrmExchangeError"}};async function C(e,t){let r=t.fetch??fetch,n=`${t.crmBaseUrl.replace(/\/$/,"")}/api/auth/exchange`,s=await r(n,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({app_id:e.appId,app_secret:e.appSecret,user:e.user})}),a=await s.json().catch(()=>({}));if(!s.ok){let c=a?.error?.code??`HTTP_${s.status}`,m=a?.error?.message??"CRM exchange failed";throw new d(m,s.status,c,a)}let i=a?.data??{};return{accessToken:i.access_token,expiresIn:i.expires_in,workspaceId:i.workspace?.id,user:i.user,role:i.role}}var E="crm",g=120,p=new Map;function K(){let e=globalThis.crypto;if(e?.randomUUID)return e.randomUUID();let t=new Uint8Array(16);e?.getRandomValues?.(t),t[6]=t[6]&15|64,t[8]=t[8]&63|128;let r=Array.from(t,n=>n.toString(16).padStart(2,"0")).join("");return`${r.slice(0,8)}-${r.slice(8,12)}-${r.slice(12,16)}-${r.slice(16,20)}-${r.slice(20)}`}async function u(e){let t=e.alg??"RS256",r=`${e.iss}:${t}`,n=p.get(r);if(n)return n;let s=(async()=>{let a=await(0,o.importPKCS8)(e.privateKeyPem,t),i=await(0,o.importSPKI)(e.publicKeyPem,t),c=await(0,o.exportJWK)(i),m=await(0,o.calculateJwkThumbprint)(c);return{privateKey:a,publicJwk:{...c,kid:m,alg:t,use:"sig"},kid:m}})();return p.set(r,s),s}function I(){p.clear()}async function P(e){let{publicJwk:t}=await u(e);return{keys:[t]}}async function y(e,t,r){let n=t.alg??"RS256",{privateKey:s,kid:a}=await u(t),i=Math.min(r?.ttlSeconds??g,g);return new o.SignJWT({email:e.email,requested_role:e.requestedRole,org_id:e.orgId,...e.fullName?{full_name:e.fullName}:{},...e.avatarUrl?{avatar_url:e.avatarUrl}:{}}).setProtectedHeader({alg:n,kid:a}).setSubject(e.sub).setIssuer(t.iss).setAudience(E).setIssuedAt().setExpirationTime(`${i}s`).setJti(K()).sign(s)}async function b(e,t){let r=t.fetch??fetch,n=`${t.crmBaseUrl.replace(/\/$/,"")}/api/auth/exchange`,s=await r(n,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({assertion:e})}),a=await s.json().catch(()=>({}));if(!s.ok){let c=a?.error?.code??`HTTP_${s.status}`,m=a?.error?.message??"CRM exchange failed";throw new d(m,s.status,c,a)}let i=a?.data??{};return{accessToken:i.access_token,expiresIn:i.expires_in,workspaceId:i.workspace?.id,user:i.user,role:i.role}}async function U(e,t,r){let n=await y(e,t);return b(n,r)}0&&(module.exports={CrmExchangeError,createEmbedSession,createEmbedSessionWithKey,exchangeAssertion,getCrmEmbedJwks,mintCrmAssertion,resetCrmEmbedKeys});
|
|
2
2
|
//# sourceMappingURL=embed-server.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/embed-server.ts"],"sourcesContent":["/**\n * CRM Embed Server SDK (server side).\n *\n * Use this in YOUR SaaS backend to authenticate the embedded CRM without a\n * shared secret. You mint a short-lived ASYMMETRIC (RS256/ES256) assertion for\n * the logged-in user and exchange it at the CRM for a CRM bearer, which your\n * frontend hands to the CRM iframe (see ./embed-host).\n *\n * The CRM verifies the assertion against your PUBLIC JWKS — you never share a\n * private key with the CRM. Expose getCrmEmbedJwks() at a public https URL and\n * give that URL to the CRM team (they register it as your app's `jwks_url`).\n *\n * Claim contract the CRM expects:\n * iss = your client_id (registered with the CRM; == this config.iss)\n * aud = 'crm'\n * sub = stable user id in YOUR system (becomes the CRM external_subject)\n * email = user email\n * requested_role = 'member' | 'admin' (the CRM clamps to the install's max_role)\n * org_id = your organization id; the CRM resolves the target workspace\n * from the install an admin bound to this org\n * exp - iat <= 120s, plus a unique jti (single-use, replay-protected)\n *\n * Requires `jose` (peer of this subpath). Works in Node and Bun.\n *\n * @packageDocumentation\n */\nimport {\n SignJWT,\n exportJWK,\n importPKCS8,\n importSPKI,\n calculateJwkThumbprint,\n type JWK,\n type KeyLike,\n} from 'jose';\n\nexport type CrmEmbedAlg = 'RS256' | 'ES256';\n\nconst AUDIENCE = 'crm';\nconst DEFAULT_TTL_SECONDS = 120;\n\nexport interface CrmEmbedSigningConfig {\n /** Issuer — MUST equal the client_id the CRM registered for your app. */\n iss: string;\n /** PKCS8 PEM private key used to sign assertions. */\n privateKeyPem: string;\n /** SPKI PEM public key — required so getCrmEmbedJwks() can publish it. */\n publicKeyPem: string;\n /** Signature algorithm. Default 'RS256'. The CRM accepts RS256 or ES256. */\n alg?: CrmEmbedAlg;\n}\n\nexport interface CrmAssertionInput {\n /** Stable user id in your system (becomes the CRM external_subject). */\n sub: string;\n /** User email. */\n email: string;\n /** Requested role; the CRM clamps it to the install's configured max_role. */\n requestedRole: 'member' | 'admin';\n /** Your organization id; the CRM resolves the workspace from the org binding. */\n orgId: string;\n /** Optional display name for first-time provisioning. */\n fullName?: string;\n /** Optional avatar URL for first-time provisioning. */\n avatarUrl?: string;\n}\n\n/** The CRM session returned by the exchange. */\nexport interface CrmEmbedSession {\n accessToken: string;\n expiresIn?: number;\n /** The CRM workspace the user was provisioned into (resolved from org_id). */\n workspaceId?: string;\n user?: { id: string; email: string; full_name?: string };\n role?: string;\n}\n\ninterface LoadedKeys { privateKey: KeyLike; publicJwk: JWK; kid: string }\n\n// Memoize per config.iss so repeated calls don't re-import keys.\nconst keyCache = new Map<string, Promise<LoadedKeys>>();\n\nfunction randomUUID(): string {\n const c = (globalThis as { crypto?: Crypto }).crypto;\n if (c?.randomUUID) return c.randomUUID();\n // Fallback (should not happen on Node 16+/Bun): RFC4122-ish from getRandomValues.\n const b = new Uint8Array(16);\n c?.getRandomValues?.(b);\n b[6] = (b[6] & 0x0f) | 0x40;\n b[8] = (b[8] & 0x3f) | 0x80;\n const h = Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');\n return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;\n}\n\nasync function loadKeys(config: CrmEmbedSigningConfig): Promise<LoadedKeys> {\n const alg = config.alg ?? 'RS256';\n const cacheKey = `${config.iss}:${alg}`;\n const existing = keyCache.get(cacheKey);\n if (existing) return existing;\n\n const created = (async (): Promise<LoadedKeys> => {\n const privateKey = await importPKCS8(config.privateKeyPem, alg);\n const publicKey = await importSPKI(config.publicKeyPem, alg);\n const publicJwk = await exportJWK(publicKey);\n // Stable kid = RFC 7638 thumbprint so the signed header kid matches JWKS.\n const kid = await calculateJwkThumbprint(publicJwk);\n return { privateKey, publicJwk: { ...publicJwk, kid, alg, use: 'sig' }, kid };\n })();\n keyCache.set(cacheKey, created);\n return created;\n}\n\n/** Test/dev only: clear the memoized keys. */\nexport function resetCrmEmbedKeys(): void {\n keyCache.clear();\n}\n\n/**\n * The public JWKS document to serve at a public https URL. Give that URL to the\n * CRM team so they can verify your assertions. Example (Express):\n *\n * app.get('/crm-embed/jwks', async (_req, res) =>\n * res.json(await getCrmEmbedJwks(config)));\n */\nexport async function getCrmEmbedJwks(\n config: CrmEmbedSigningConfig,\n): Promise<{ keys: JWK[] }> {\n const { publicJwk } = await loadKeys(config);\n return { keys: [publicJwk] };\n}\n\n/** Mint a short-lived signed assertion the CRM will exchange for a bearer. */\nexport async function mintCrmAssertion(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options?: { ttlSeconds?: number },\n): Promise<string> {\n const alg = config.alg ?? 'RS256';\n const { privateKey, kid } = await loadKeys(config);\n const ttl = Math.min(options?.ttlSeconds ?? DEFAULT_TTL_SECONDS, DEFAULT_TTL_SECONDS);\n\n return new SignJWT({\n email: input.email,\n requested_role: input.requestedRole,\n org_id: input.orgId,\n ...(input.fullName ? { full_name: input.fullName } : {}),\n ...(input.avatarUrl ? { avatar_url: input.avatarUrl } : {}),\n })\n .setProtectedHeader({ alg, kid })\n .setSubject(input.sub)\n .setIssuer(config.iss)\n .setAudience(AUDIENCE)\n .setIssuedAt()\n .setExpirationTime(`${ttl}s`)\n .setJti(randomUUID())\n .sign(privateKey);\n}\n\nexport interface ExchangeOptions {\n /** CRM exchange base URL, e.g. \"https://api.crm.example.com\". */\n crmBaseUrl: string;\n /** Override fetch (tests / custom agents). Defaults to global fetch. */\n fetch?: typeof fetch;\n}\n\n/**\n * Exchange a minted assertion at the CRM for a CRM bearer. Do this server-side\n * so the browser never calls the CRM's exchange endpoint cross-origin.\n */\nexport async function exchangeAssertion(\n assertion: string,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const doFetch = options.fetch ?? fetch;\n const url = `${options.crmBaseUrl.replace(/\\/$/, '')}/api/auth/exchange`;\n const res = await doFetch(url, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({ assertion }),\n });\n const body = await res.json().catch(() => ({}));\n if (!res.ok) {\n const code = body?.error?.code ?? `HTTP_${res.status}`;\n const msg = body?.error?.message ?? 'CRM exchange failed';\n throw new CrmExchangeError(msg, res.status, code, body);\n }\n const data = body?.data ?? {};\n return {\n accessToken: data.access_token,\n expiresIn: data.expires_in,\n workspaceId: data.workspace?.id,\n user: data.user,\n role: data.role,\n };\n}\n\n/** Mint + exchange in one call — the typical \"give me a CRM session\" helper. */\nexport async function createEmbedSession(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const assertion = await mintCrmAssertion(input, config);\n return exchangeAssertion(assertion, options);\n}\n\n/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */\nexport class CrmExchangeError extends Error {\n constructor(\n message: string,\n public readonly status: number,\n public readonly code: string,\n public readonly detail?: unknown,\n ) {\n super(message);\n this.name = 'CrmExchangeError';\n }\n}\n"],"mappings":"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","names":["embed_server_exports","__export","CrmExchangeError","createEmbedSession","exchangeAssertion","getCrmEmbedJwks","mintCrmAssertion","resetCrmEmbedKeys","__toCommonJS","import_jose","AUDIENCE","DEFAULT_TTL_SECONDS","keyCache","randomUUID","c","b","h","x","loadKeys","config","alg","cacheKey","existing","created","privateKey","publicKey","publicJwk","kid","input","options","ttl","assertion","doFetch","url","res","body","code","msg","data","message","status","detail"]}
|
|
1
|
+
{"version":3,"sources":["../src/embed-server.ts"],"sourcesContent":["/**\n * CRM Embed Server SDK (server side).\n *\n * Use this in YOUR SaaS backend to authenticate the embedded CRM. Two auth\n * approaches are supported:\n *\n * **Option A — API-key auth (simpler, no keypair):**\n * POST user identity + your registered `app_id`/`app_secret` to the CRM.\n * Use {@link createEmbedSessionWithKey}. No `jose` required.\n *\n * **Option B — Signed-assertion auth (zero shared-secret):**\n * Mint a short-lived asymmetric (RS256/ES256) assertion server-side and\n * exchange it at the CRM for a CRM bearer. Use {@link createEmbedSession} (or\n * {@link mintCrmAssertion} + {@link exchangeAssertion} separately).\n * Requires the `jose` peer dependency.\n *\n * Both paths return a short-lived CRM bearer; hand that bearer to the CRM\n * iframe via `embed-host` (see ./embed-host).\n *\n * Works in Node and Bun (or any environment with a global `fetch`).\n *\n * @packageDocumentation\n */\nimport {\n SignJWT,\n exportJWK,\n importPKCS8,\n importSPKI,\n calculateJwkThumbprint,\n type JWK,\n type KeyLike,\n} from 'jose';\n\n// ─── Shared error class ──────────────────────────────────────────────────────\n\n/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */\nexport class CrmExchangeError extends Error {\n constructor(\n message: string,\n public readonly status: number,\n public readonly code: string,\n public readonly detail?: unknown,\n ) {\n super(message);\n this.name = 'CrmExchangeError';\n }\n}\n\n// ─── Option A: API-key auth ──────────────────────────────────────────────────\n\n/** The end-user being embedded into the CRM. */\nexport interface EmbedUser {\n id: string;\n email: string;\n role: 'member' | 'admin';\n name?: string;\n avatar_url?: string;\n}\n\n/** Input for {@link createEmbedSessionWithKey}. */\nexport interface CreateEmbedSessionWithKeyInput {\n appId: string;\n appSecret: string;\n user: EmbedUser;\n}\n\n/** The CRM session returned by {@link createEmbedSessionWithKey}. */\nexport interface EmbedSession {\n accessToken: string;\n expiresIn?: number;\n /** The CRM workspace the user was provisioned into. */\n workspaceId?: string;\n user?: unknown;\n role?: string;\n}\n\n/**\n * Exchange app credentials + user identity for a short-lived CRM bearer.\n *\n * POSTs `{ app_id, app_secret, user }` to `${crmBaseUrl}/api/auth/exchange`\n * and maps the CRM response to an {@link EmbedSession}. On non-2xx, throws\n * {@link CrmExchangeError} with `.status` and `.code`.\n *\n * @example\n * ```typescript\n * const session = await createEmbedSessionWithKey(\n * { appId: process.env.CRM_APP_ID!, appSecret: process.env.CRM_APP_SECRET!, user },\n * { crmBaseUrl: process.env.CRM_BASE_URL! },\n * );\n * // { accessToken, expiresIn, workspaceId, user, role }\n * ```\n */\nexport async function createEmbedSessionWithKey(\n input: CreateEmbedSessionWithKeyInput,\n opts: { crmBaseUrl: string; fetch?: typeof fetch },\n): Promise<EmbedSession> {\n const doFetch = opts.fetch ?? fetch;\n const url = `${opts.crmBaseUrl.replace(/\\/$/, '')}/api/auth/exchange`;\n const res = await doFetch(url, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({\n app_id: input.appId,\n app_secret: input.appSecret,\n user: input.user,\n }),\n });\n const body = await res.json().catch(() => ({}));\n if (!res.ok) {\n const code = body?.error?.code ?? `HTTP_${res.status}`;\n const msg = body?.error?.message ?? 'CRM exchange failed';\n throw new CrmExchangeError(msg, res.status, code, body);\n }\n const data = body?.data ?? {};\n return {\n accessToken: data.access_token,\n expiresIn: data.expires_in,\n workspaceId: data.workspace?.id,\n user: data.user,\n role: data.role,\n };\n}\n\n// ─── Option B: Signed-assertion auth ────────────────────────────────────────\n\nexport type CrmEmbedAlg = 'RS256' | 'ES256';\n\nconst AUDIENCE = 'crm';\nconst DEFAULT_TTL_SECONDS = 120;\n\nexport interface CrmEmbedSigningConfig {\n /** Issuer — MUST equal the client_id the CRM registered for your app. */\n iss: string;\n /** PKCS8 PEM private key used to sign assertions. */\n privateKeyPem: string;\n /** SPKI PEM public key — required so getCrmEmbedJwks() can publish it. */\n publicKeyPem: string;\n /** Signature algorithm. Default 'RS256'. The CRM accepts RS256 or ES256. */\n alg?: CrmEmbedAlg;\n}\n\nexport interface CrmAssertionInput {\n /** Stable user id in your system (becomes the CRM external_subject). */\n sub: string;\n /** User email. */\n email: string;\n /** Requested role; the CRM clamps it to the install's configured max_role. */\n requestedRole: 'member' | 'admin';\n /** Your organization id; the CRM resolves the workspace from the org binding. */\n orgId: string;\n /** Optional display name for first-time provisioning. */\n fullName?: string;\n /** Optional avatar URL for first-time provisioning. */\n avatarUrl?: string;\n}\n\n/** The CRM session returned by {@link createEmbedSession} / {@link exchangeAssertion}. */\nexport interface CrmEmbedSession {\n accessToken: string;\n expiresIn?: number;\n /** The CRM workspace the user was provisioned into (resolved from org_id). */\n workspaceId?: string;\n user?: { id: string; email: string; full_name?: string };\n role?: string;\n}\n\nexport interface ExchangeOptions {\n /** CRM exchange base URL, e.g. \"https://api.crm.example.com\". */\n crmBaseUrl: string;\n /** Override fetch (tests / custom agents). Defaults to global fetch. */\n fetch?: typeof fetch;\n}\n\ninterface LoadedKeys { privateKey: KeyLike; publicJwk: JWK; kid: string }\n\n// Memoize per config.iss so repeated calls don't re-import keys.\nconst keyCache = new Map<string, Promise<LoadedKeys>>();\n\nfunction randomUUID(): string {\n const c = (globalThis as { crypto?: Crypto }).crypto;\n if (c?.randomUUID) return c.randomUUID();\n // Fallback (should not happen on Node 16+/Bun): RFC4122-ish from getRandomValues.\n const b = new Uint8Array(16);\n c?.getRandomValues?.(b);\n b[6] = (b[6] & 0x0f) | 0x40;\n b[8] = (b[8] & 0x3f) | 0x80;\n const h = Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');\n return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;\n}\n\nasync function loadKeys(config: CrmEmbedSigningConfig): Promise<LoadedKeys> {\n const alg = config.alg ?? 'RS256';\n const cacheKey = `${config.iss}:${alg}`;\n const existing = keyCache.get(cacheKey);\n if (existing) return existing;\n\n const created = (async (): Promise<LoadedKeys> => {\n const privateKey = await importPKCS8(config.privateKeyPem, alg);\n const publicKey = await importSPKI(config.publicKeyPem, alg);\n const publicJwk = await exportJWK(publicKey);\n // Stable kid = RFC 7638 thumbprint so the signed header kid matches JWKS.\n const kid = await calculateJwkThumbprint(publicJwk);\n return { privateKey, publicJwk: { ...publicJwk, kid, alg, use: 'sig' }, kid };\n })();\n keyCache.set(cacheKey, created);\n return created;\n}\n\n/** Test/dev only: clear the memoized keys. */\nexport function resetCrmEmbedKeys(): void {\n keyCache.clear();\n}\n\n/**\n * The public JWKS document to serve at a public https URL. Give that URL to the\n * CRM team so they can verify your assertions. Example (Express):\n *\n * app.get('/crm-embed/jwks', async (_req, res) =>\n * res.json(await getCrmEmbedJwks(config)));\n */\nexport async function getCrmEmbedJwks(\n config: CrmEmbedSigningConfig,\n): Promise<{ keys: JWK[] }> {\n const { publicJwk } = await loadKeys(config);\n return { keys: [publicJwk] };\n}\n\n/** Mint a short-lived signed assertion the CRM will exchange for a bearer. */\nexport async function mintCrmAssertion(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options?: { ttlSeconds?: number },\n): Promise<string> {\n const alg = config.alg ?? 'RS256';\n const { privateKey, kid } = await loadKeys(config);\n const ttl = Math.min(options?.ttlSeconds ?? DEFAULT_TTL_SECONDS, DEFAULT_TTL_SECONDS);\n\n return new SignJWT({\n email: input.email,\n requested_role: input.requestedRole,\n org_id: input.orgId,\n ...(input.fullName ? { full_name: input.fullName } : {}),\n ...(input.avatarUrl ? { avatar_url: input.avatarUrl } : {}),\n })\n .setProtectedHeader({ alg, kid })\n .setSubject(input.sub)\n .setIssuer(config.iss)\n .setAudience(AUDIENCE)\n .setIssuedAt()\n .setExpirationTime(`${ttl}s`)\n .setJti(randomUUID())\n .sign(privateKey);\n}\n\n/**\n * Exchange a minted assertion at the CRM for a CRM bearer. Do this server-side\n * so the browser never calls the CRM's exchange endpoint cross-origin.\n */\nexport async function exchangeAssertion(\n assertion: string,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const doFetch = options.fetch ?? fetch;\n const url = `${options.crmBaseUrl.replace(/\\/$/, '')}/api/auth/exchange`;\n const res = await doFetch(url, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({ assertion }),\n });\n const body = await res.json().catch(() => ({}));\n if (!res.ok) {\n const code = body?.error?.code ?? `HTTP_${res.status}`;\n const msg = body?.error?.message ?? 'CRM exchange failed';\n throw new CrmExchangeError(msg, res.status, code, body);\n }\n const data = body?.data ?? {};\n return {\n accessToken: data.access_token,\n expiresIn: data.expires_in,\n workspaceId: data.workspace?.id,\n user: data.user,\n role: data.role,\n };\n}\n\n/** Mint + exchange in one call — the typical \"give me a CRM session\" helper. */\nexport async function createEmbedSession(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const assertion = await mintCrmAssertion(input, config);\n return exchangeAssertion(assertion, options);\n}\n"],"mappings":"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","names":["embed_server_exports","__export","CrmExchangeError","createEmbedSession","createEmbedSessionWithKey","exchangeAssertion","getCrmEmbedJwks","mintCrmAssertion","resetCrmEmbedKeys","__toCommonJS","import_jose","message","status","code","detail","input","opts","doFetch","url","res","body","msg","data","AUDIENCE","DEFAULT_TTL_SECONDS","keyCache","randomUUID","c","b","h","x","loadKeys","config","alg","cacheKey","existing","created","privateKey","publicKey","publicJwk","kid","options","ttl","assertion"]}
|
package/dist/embed-server.d.cts
CHANGED
|
@@ -3,30 +3,77 @@ import { JWK } from 'jose';
|
|
|
3
3
|
/**
|
|
4
4
|
* CRM Embed Server SDK (server side).
|
|
5
5
|
*
|
|
6
|
-
* Use this in YOUR SaaS backend to authenticate the embedded CRM
|
|
7
|
-
*
|
|
8
|
-
* the logged-in user and exchange it at the CRM for a CRM bearer, which your
|
|
9
|
-
* frontend hands to the CRM iframe (see ./embed-host).
|
|
6
|
+
* Use this in YOUR SaaS backend to authenticate the embedded CRM. Two auth
|
|
7
|
+
* approaches are supported:
|
|
10
8
|
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
9
|
+
* **Option A — API-key auth (simpler, no keypair):**
|
|
10
|
+
* POST user identity + your registered `app_id`/`app_secret` to the CRM.
|
|
11
|
+
* Use {@link createEmbedSessionWithKey}. No `jose` required.
|
|
14
12
|
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* requested_role = 'member' | 'admin' (the CRM clamps to the install's max_role)
|
|
21
|
-
* org_id = your organization id; the CRM resolves the target workspace
|
|
22
|
-
* from the install an admin bound to this org
|
|
23
|
-
* exp - iat <= 120s, plus a unique jti (single-use, replay-protected)
|
|
13
|
+
* **Option B — Signed-assertion auth (zero shared-secret):**
|
|
14
|
+
* Mint a short-lived asymmetric (RS256/ES256) assertion server-side and
|
|
15
|
+
* exchange it at the CRM for a CRM bearer. Use {@link createEmbedSession} (or
|
|
16
|
+
* {@link mintCrmAssertion} + {@link exchangeAssertion} separately).
|
|
17
|
+
* Requires the `jose` peer dependency.
|
|
24
18
|
*
|
|
25
|
-
*
|
|
19
|
+
* Both paths return a short-lived CRM bearer; hand that bearer to the CRM
|
|
20
|
+
* iframe via `embed-host` (see ./embed-host).
|
|
21
|
+
*
|
|
22
|
+
* Works in Node and Bun (or any environment with a global `fetch`).
|
|
26
23
|
*
|
|
27
24
|
* @packageDocumentation
|
|
28
25
|
*/
|
|
29
26
|
|
|
27
|
+
/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */
|
|
28
|
+
declare class CrmExchangeError extends Error {
|
|
29
|
+
readonly status: number;
|
|
30
|
+
readonly code: string;
|
|
31
|
+
readonly detail?: unknown | undefined;
|
|
32
|
+
constructor(message: string, status: number, code: string, detail?: unknown | undefined);
|
|
33
|
+
}
|
|
34
|
+
/** The end-user being embedded into the CRM. */
|
|
35
|
+
interface EmbedUser {
|
|
36
|
+
id: string;
|
|
37
|
+
email: string;
|
|
38
|
+
role: 'member' | 'admin';
|
|
39
|
+
name?: string;
|
|
40
|
+
avatar_url?: string;
|
|
41
|
+
}
|
|
42
|
+
/** Input for {@link createEmbedSessionWithKey}. */
|
|
43
|
+
interface CreateEmbedSessionWithKeyInput {
|
|
44
|
+
appId: string;
|
|
45
|
+
appSecret: string;
|
|
46
|
+
user: EmbedUser;
|
|
47
|
+
}
|
|
48
|
+
/** The CRM session returned by {@link createEmbedSessionWithKey}. */
|
|
49
|
+
interface EmbedSession {
|
|
50
|
+
accessToken: string;
|
|
51
|
+
expiresIn?: number;
|
|
52
|
+
/** The CRM workspace the user was provisioned into. */
|
|
53
|
+
workspaceId?: string;
|
|
54
|
+
user?: unknown;
|
|
55
|
+
role?: string;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Exchange app credentials + user identity for a short-lived CRM bearer.
|
|
59
|
+
*
|
|
60
|
+
* POSTs `{ app_id, app_secret, user }` to `${crmBaseUrl}/api/auth/exchange`
|
|
61
|
+
* and maps the CRM response to an {@link EmbedSession}. On non-2xx, throws
|
|
62
|
+
* {@link CrmExchangeError} with `.status` and `.code`.
|
|
63
|
+
*
|
|
64
|
+
* @example
|
|
65
|
+
* ```typescript
|
|
66
|
+
* const session = await createEmbedSessionWithKey(
|
|
67
|
+
* { appId: process.env.CRM_APP_ID!, appSecret: process.env.CRM_APP_SECRET!, user },
|
|
68
|
+
* { crmBaseUrl: process.env.CRM_BASE_URL! },
|
|
69
|
+
* );
|
|
70
|
+
* // { accessToken, expiresIn, workspaceId, user, role }
|
|
71
|
+
* ```
|
|
72
|
+
*/
|
|
73
|
+
declare function createEmbedSessionWithKey(input: CreateEmbedSessionWithKeyInput, opts: {
|
|
74
|
+
crmBaseUrl: string;
|
|
75
|
+
fetch?: typeof fetch;
|
|
76
|
+
}): Promise<EmbedSession>;
|
|
30
77
|
type CrmEmbedAlg = 'RS256' | 'ES256';
|
|
31
78
|
interface CrmEmbedSigningConfig {
|
|
32
79
|
/** Issuer — MUST equal the client_id the CRM registered for your app. */
|
|
@@ -52,7 +99,7 @@ interface CrmAssertionInput {
|
|
|
52
99
|
/** Optional avatar URL for first-time provisioning. */
|
|
53
100
|
avatarUrl?: string;
|
|
54
101
|
}
|
|
55
|
-
/** The CRM session returned by
|
|
102
|
+
/** The CRM session returned by {@link createEmbedSession} / {@link exchangeAssertion}. */
|
|
56
103
|
interface CrmEmbedSession {
|
|
57
104
|
accessToken: string;
|
|
58
105
|
expiresIn?: number;
|
|
@@ -65,6 +112,12 @@ interface CrmEmbedSession {
|
|
|
65
112
|
};
|
|
66
113
|
role?: string;
|
|
67
114
|
}
|
|
115
|
+
interface ExchangeOptions {
|
|
116
|
+
/** CRM exchange base URL, e.g. "https://api.crm.example.com". */
|
|
117
|
+
crmBaseUrl: string;
|
|
118
|
+
/** Override fetch (tests / custom agents). Defaults to global fetch. */
|
|
119
|
+
fetch?: typeof fetch;
|
|
120
|
+
}
|
|
68
121
|
/** Test/dev only: clear the memoized keys. */
|
|
69
122
|
declare function resetCrmEmbedKeys(): void;
|
|
70
123
|
/**
|
|
@@ -81,12 +134,6 @@ declare function getCrmEmbedJwks(config: CrmEmbedSigningConfig): Promise<{
|
|
|
81
134
|
declare function mintCrmAssertion(input: CrmAssertionInput, config: CrmEmbedSigningConfig, options?: {
|
|
82
135
|
ttlSeconds?: number;
|
|
83
136
|
}): Promise<string>;
|
|
84
|
-
interface ExchangeOptions {
|
|
85
|
-
/** CRM exchange base URL, e.g. "https://api.crm.example.com". */
|
|
86
|
-
crmBaseUrl: string;
|
|
87
|
-
/** Override fetch (tests / custom agents). Defaults to global fetch. */
|
|
88
|
-
fetch?: typeof fetch;
|
|
89
|
-
}
|
|
90
137
|
/**
|
|
91
138
|
* Exchange a minted assertion at the CRM for a CRM bearer. Do this server-side
|
|
92
139
|
* so the browser never calls the CRM's exchange endpoint cross-origin.
|
|
@@ -94,12 +141,5 @@ interface ExchangeOptions {
|
|
|
94
141
|
declare function exchangeAssertion(assertion: string, options: ExchangeOptions): Promise<CrmEmbedSession>;
|
|
95
142
|
/** Mint + exchange in one call — the typical "give me a CRM session" helper. */
|
|
96
143
|
declare function createEmbedSession(input: CrmAssertionInput, config: CrmEmbedSigningConfig, options: ExchangeOptions): Promise<CrmEmbedSession>;
|
|
97
|
-
/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */
|
|
98
|
-
declare class CrmExchangeError extends Error {
|
|
99
|
-
readonly status: number;
|
|
100
|
-
readonly code: string;
|
|
101
|
-
readonly detail?: unknown | undefined;
|
|
102
|
-
constructor(message: string, status: number, code: string, detail?: unknown | undefined);
|
|
103
|
-
}
|
|
104
144
|
|
|
105
|
-
export { type CrmAssertionInput, type CrmEmbedAlg, type CrmEmbedSession, type CrmEmbedSigningConfig, CrmExchangeError, type ExchangeOptions, createEmbedSession, exchangeAssertion, getCrmEmbedJwks, mintCrmAssertion, resetCrmEmbedKeys };
|
|
145
|
+
export { type CreateEmbedSessionWithKeyInput, type CrmAssertionInput, type CrmEmbedAlg, type CrmEmbedSession, type CrmEmbedSigningConfig, CrmExchangeError, type EmbedSession, type EmbedUser, type ExchangeOptions, createEmbedSession, createEmbedSessionWithKey, exchangeAssertion, getCrmEmbedJwks, mintCrmAssertion, resetCrmEmbedKeys };
|
package/dist/embed-server.d.ts
CHANGED
|
@@ -3,30 +3,77 @@ import { JWK } from 'jose';
|
|
|
3
3
|
/**
|
|
4
4
|
* CRM Embed Server SDK (server side).
|
|
5
5
|
*
|
|
6
|
-
* Use this in YOUR SaaS backend to authenticate the embedded CRM
|
|
7
|
-
*
|
|
8
|
-
* the logged-in user and exchange it at the CRM for a CRM bearer, which your
|
|
9
|
-
* frontend hands to the CRM iframe (see ./embed-host).
|
|
6
|
+
* Use this in YOUR SaaS backend to authenticate the embedded CRM. Two auth
|
|
7
|
+
* approaches are supported:
|
|
10
8
|
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
9
|
+
* **Option A — API-key auth (simpler, no keypair):**
|
|
10
|
+
* POST user identity + your registered `app_id`/`app_secret` to the CRM.
|
|
11
|
+
* Use {@link createEmbedSessionWithKey}. No `jose` required.
|
|
14
12
|
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* requested_role = 'member' | 'admin' (the CRM clamps to the install's max_role)
|
|
21
|
-
* org_id = your organization id; the CRM resolves the target workspace
|
|
22
|
-
* from the install an admin bound to this org
|
|
23
|
-
* exp - iat <= 120s, plus a unique jti (single-use, replay-protected)
|
|
13
|
+
* **Option B — Signed-assertion auth (zero shared-secret):**
|
|
14
|
+
* Mint a short-lived asymmetric (RS256/ES256) assertion server-side and
|
|
15
|
+
* exchange it at the CRM for a CRM bearer. Use {@link createEmbedSession} (or
|
|
16
|
+
* {@link mintCrmAssertion} + {@link exchangeAssertion} separately).
|
|
17
|
+
* Requires the `jose` peer dependency.
|
|
24
18
|
*
|
|
25
|
-
*
|
|
19
|
+
* Both paths return a short-lived CRM bearer; hand that bearer to the CRM
|
|
20
|
+
* iframe via `embed-host` (see ./embed-host).
|
|
21
|
+
*
|
|
22
|
+
* Works in Node and Bun (or any environment with a global `fetch`).
|
|
26
23
|
*
|
|
27
24
|
* @packageDocumentation
|
|
28
25
|
*/
|
|
29
26
|
|
|
27
|
+
/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */
|
|
28
|
+
declare class CrmExchangeError extends Error {
|
|
29
|
+
readonly status: number;
|
|
30
|
+
readonly code: string;
|
|
31
|
+
readonly detail?: unknown | undefined;
|
|
32
|
+
constructor(message: string, status: number, code: string, detail?: unknown | undefined);
|
|
33
|
+
}
|
|
34
|
+
/** The end-user being embedded into the CRM. */
|
|
35
|
+
interface EmbedUser {
|
|
36
|
+
id: string;
|
|
37
|
+
email: string;
|
|
38
|
+
role: 'member' | 'admin';
|
|
39
|
+
name?: string;
|
|
40
|
+
avatar_url?: string;
|
|
41
|
+
}
|
|
42
|
+
/** Input for {@link createEmbedSessionWithKey}. */
|
|
43
|
+
interface CreateEmbedSessionWithKeyInput {
|
|
44
|
+
appId: string;
|
|
45
|
+
appSecret: string;
|
|
46
|
+
user: EmbedUser;
|
|
47
|
+
}
|
|
48
|
+
/** The CRM session returned by {@link createEmbedSessionWithKey}. */
|
|
49
|
+
interface EmbedSession {
|
|
50
|
+
accessToken: string;
|
|
51
|
+
expiresIn?: number;
|
|
52
|
+
/** The CRM workspace the user was provisioned into. */
|
|
53
|
+
workspaceId?: string;
|
|
54
|
+
user?: unknown;
|
|
55
|
+
role?: string;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Exchange app credentials + user identity for a short-lived CRM bearer.
|
|
59
|
+
*
|
|
60
|
+
* POSTs `{ app_id, app_secret, user }` to `${crmBaseUrl}/api/auth/exchange`
|
|
61
|
+
* and maps the CRM response to an {@link EmbedSession}. On non-2xx, throws
|
|
62
|
+
* {@link CrmExchangeError} with `.status` and `.code`.
|
|
63
|
+
*
|
|
64
|
+
* @example
|
|
65
|
+
* ```typescript
|
|
66
|
+
* const session = await createEmbedSessionWithKey(
|
|
67
|
+
* { appId: process.env.CRM_APP_ID!, appSecret: process.env.CRM_APP_SECRET!, user },
|
|
68
|
+
* { crmBaseUrl: process.env.CRM_BASE_URL! },
|
|
69
|
+
* );
|
|
70
|
+
* // { accessToken, expiresIn, workspaceId, user, role }
|
|
71
|
+
* ```
|
|
72
|
+
*/
|
|
73
|
+
declare function createEmbedSessionWithKey(input: CreateEmbedSessionWithKeyInput, opts: {
|
|
74
|
+
crmBaseUrl: string;
|
|
75
|
+
fetch?: typeof fetch;
|
|
76
|
+
}): Promise<EmbedSession>;
|
|
30
77
|
type CrmEmbedAlg = 'RS256' | 'ES256';
|
|
31
78
|
interface CrmEmbedSigningConfig {
|
|
32
79
|
/** Issuer — MUST equal the client_id the CRM registered for your app. */
|
|
@@ -52,7 +99,7 @@ interface CrmAssertionInput {
|
|
|
52
99
|
/** Optional avatar URL for first-time provisioning. */
|
|
53
100
|
avatarUrl?: string;
|
|
54
101
|
}
|
|
55
|
-
/** The CRM session returned by
|
|
102
|
+
/** The CRM session returned by {@link createEmbedSession} / {@link exchangeAssertion}. */
|
|
56
103
|
interface CrmEmbedSession {
|
|
57
104
|
accessToken: string;
|
|
58
105
|
expiresIn?: number;
|
|
@@ -65,6 +112,12 @@ interface CrmEmbedSession {
|
|
|
65
112
|
};
|
|
66
113
|
role?: string;
|
|
67
114
|
}
|
|
115
|
+
interface ExchangeOptions {
|
|
116
|
+
/** CRM exchange base URL, e.g. "https://api.crm.example.com". */
|
|
117
|
+
crmBaseUrl: string;
|
|
118
|
+
/** Override fetch (tests / custom agents). Defaults to global fetch. */
|
|
119
|
+
fetch?: typeof fetch;
|
|
120
|
+
}
|
|
68
121
|
/** Test/dev only: clear the memoized keys. */
|
|
69
122
|
declare function resetCrmEmbedKeys(): void;
|
|
70
123
|
/**
|
|
@@ -81,12 +134,6 @@ declare function getCrmEmbedJwks(config: CrmEmbedSigningConfig): Promise<{
|
|
|
81
134
|
declare function mintCrmAssertion(input: CrmAssertionInput, config: CrmEmbedSigningConfig, options?: {
|
|
82
135
|
ttlSeconds?: number;
|
|
83
136
|
}): Promise<string>;
|
|
84
|
-
interface ExchangeOptions {
|
|
85
|
-
/** CRM exchange base URL, e.g. "https://api.crm.example.com". */
|
|
86
|
-
crmBaseUrl: string;
|
|
87
|
-
/** Override fetch (tests / custom agents). Defaults to global fetch. */
|
|
88
|
-
fetch?: typeof fetch;
|
|
89
|
-
}
|
|
90
137
|
/**
|
|
91
138
|
* Exchange a minted assertion at the CRM for a CRM bearer. Do this server-side
|
|
92
139
|
* so the browser never calls the CRM's exchange endpoint cross-origin.
|
|
@@ -94,12 +141,5 @@ interface ExchangeOptions {
|
|
|
94
141
|
declare function exchangeAssertion(assertion: string, options: ExchangeOptions): Promise<CrmEmbedSession>;
|
|
95
142
|
/** Mint + exchange in one call — the typical "give me a CRM session" helper. */
|
|
96
143
|
declare function createEmbedSession(input: CrmAssertionInput, config: CrmEmbedSigningConfig, options: ExchangeOptions): Promise<CrmEmbedSession>;
|
|
97
|
-
/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */
|
|
98
|
-
declare class CrmExchangeError extends Error {
|
|
99
|
-
readonly status: number;
|
|
100
|
-
readonly code: string;
|
|
101
|
-
readonly detail?: unknown | undefined;
|
|
102
|
-
constructor(message: string, status: number, code: string, detail?: unknown | undefined);
|
|
103
|
-
}
|
|
104
144
|
|
|
105
|
-
export { type CrmAssertionInput, type CrmEmbedAlg, type CrmEmbedSession, type CrmEmbedSigningConfig, CrmExchangeError, type ExchangeOptions, createEmbedSession, exchangeAssertion, getCrmEmbedJwks, mintCrmAssertion, resetCrmEmbedKeys };
|
|
145
|
+
export { type CreateEmbedSessionWithKeyInput, type CrmAssertionInput, type CrmEmbedAlg, type CrmEmbedSession, type CrmEmbedSigningConfig, CrmExchangeError, type EmbedSession, type EmbedUser, type ExchangeOptions, createEmbedSession, createEmbedSessionWithKey, exchangeAssertion, getCrmEmbedJwks, mintCrmAssertion, resetCrmEmbedKeys };
|
package/dist/embed-server.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{SignJWT as
|
|
1
|
+
import{SignJWT as g,exportJWK as u,importPKCS8 as y,importSPKI as b,calculateJwkThumbprint as f}from"jose";var m=class extends Error{constructor(r,a,s,i){super(r);this.status=a;this.code=s;this.detail=i;this.name="CrmExchangeError"}};async function C(e,t){let r=t.fetch??fetch,a=`${t.crmBaseUrl.replace(/\/$/,"")}/api/auth/exchange`,s=await r(a,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({app_id:e.appId,app_secret:e.appSecret,user:e.user})}),i=await s.json().catch(()=>({}));if(!s.ok){let o=i?.error?.code??`HTTP_${s.status}`,c=i?.error?.message??"CRM exchange failed";throw new m(c,s.status,o,i)}let n=i?.data??{};return{accessToken:n.access_token,expiresIn:n.expires_in,workspaceId:n.workspace?.id,user:n.user,role:n.role}}var h="crm",l=120,d=new Map;function x(){let e=globalThis.crypto;if(e?.randomUUID)return e.randomUUID();let t=new Uint8Array(16);e?.getRandomValues?.(t),t[6]=t[6]&15|64,t[8]=t[8]&63|128;let r=Array.from(t,a=>a.toString(16).padStart(2,"0")).join("");return`${r.slice(0,8)}-${r.slice(8,12)}-${r.slice(12,16)}-${r.slice(16,20)}-${r.slice(20)}`}async function p(e){let t=e.alg??"RS256",r=`${e.iss}:${t}`,a=d.get(r);if(a)return a;let s=(async()=>{let i=await y(e.privateKeyPem,t),n=await b(e.publicKeyPem,t),o=await u(n),c=await f(o);return{privateKey:i,publicJwk:{...o,kid:c,alg:t,use:"sig"},kid:c}})();return d.set(r,s),s}function E(){d.clear()}async function K(e){let{publicJwk:t}=await p(e);return{keys:[t]}}async function S(e,t,r){let a=t.alg??"RS256",{privateKey:s,kid:i}=await p(t),n=Math.min(r?.ttlSeconds??l,l);return new g({email:e.email,requested_role:e.requestedRole,org_id:e.orgId,...e.fullName?{full_name:e.fullName}:{},...e.avatarUrl?{avatar_url:e.avatarUrl}:{}}).setProtectedHeader({alg:a,kid:i}).setSubject(e.sub).setIssuer(t.iss).setAudience(h).setIssuedAt().setExpirationTime(`${n}s`).setJti(x()).sign(s)}async function w(e,t){let r=t.fetch??fetch,a=`${t.crmBaseUrl.replace(/\/$/,"")}/api/auth/exchange`,s=await r(a,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({assertion:e})}),i=await s.json().catch(()=>({}));if(!s.ok){let o=i?.error?.code??`HTTP_${s.status}`,c=i?.error?.message??"CRM exchange failed";throw new m(c,s.status,o,i)}let n=i?.data??{};return{accessToken:n.access_token,expiresIn:n.expires_in,workspaceId:n.workspace?.id,user:n.user,role:n.role}}async function I(e,t,r){let a=await S(e,t);return w(a,r)}export{m as CrmExchangeError,I as createEmbedSession,C as createEmbedSessionWithKey,w as exchangeAssertion,K as getCrmEmbedJwks,S as mintCrmAssertion,E as resetCrmEmbedKeys};
|
|
2
2
|
//# sourceMappingURL=embed-server.js.map
|
package/dist/embed-server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/embed-server.ts"],"sourcesContent":["/**\n * CRM Embed Server SDK (server side).\n *\n * Use this in YOUR SaaS backend to authenticate the embedded CRM without a\n * shared secret. You mint a short-lived ASYMMETRIC (RS256/ES256) assertion for\n * the logged-in user and exchange it at the CRM for a CRM bearer, which your\n * frontend hands to the CRM iframe (see ./embed-host).\n *\n * The CRM verifies the assertion against your PUBLIC JWKS — you never share a\n * private key with the CRM. Expose getCrmEmbedJwks() at a public https URL and\n * give that URL to the CRM team (they register it as your app's `jwks_url`).\n *\n * Claim contract the CRM expects:\n * iss = your client_id (registered with the CRM; == this config.iss)\n * aud = 'crm'\n * sub = stable user id in YOUR system (becomes the CRM external_subject)\n * email = user email\n * requested_role = 'member' | 'admin' (the CRM clamps to the install's max_role)\n * org_id = your organization id; the CRM resolves the target workspace\n * from the install an admin bound to this org\n * exp - iat <= 120s, plus a unique jti (single-use, replay-protected)\n *\n * Requires `jose` (peer of this subpath). Works in Node and Bun.\n *\n * @packageDocumentation\n */\nimport {\n SignJWT,\n exportJWK,\n importPKCS8,\n importSPKI,\n calculateJwkThumbprint,\n type JWK,\n type KeyLike,\n} from 'jose';\n\nexport type CrmEmbedAlg = 'RS256' | 'ES256';\n\nconst AUDIENCE = 'crm';\nconst DEFAULT_TTL_SECONDS = 120;\n\nexport interface CrmEmbedSigningConfig {\n /** Issuer — MUST equal the client_id the CRM registered for your app. */\n iss: string;\n /** PKCS8 PEM private key used to sign assertions. */\n privateKeyPem: string;\n /** SPKI PEM public key — required so getCrmEmbedJwks() can publish it. */\n publicKeyPem: string;\n /** Signature algorithm. Default 'RS256'. The CRM accepts RS256 or ES256. */\n alg?: CrmEmbedAlg;\n}\n\nexport interface CrmAssertionInput {\n /** Stable user id in your system (becomes the CRM external_subject). */\n sub: string;\n /** User email. */\n email: string;\n /** Requested role; the CRM clamps it to the install's configured max_role. */\n requestedRole: 'member' | 'admin';\n /** Your organization id; the CRM resolves the workspace from the org binding. */\n orgId: string;\n /** Optional display name for first-time provisioning. */\n fullName?: string;\n /** Optional avatar URL for first-time provisioning. */\n avatarUrl?: string;\n}\n\n/** The CRM session returned by the exchange. */\nexport interface CrmEmbedSession {\n accessToken: string;\n expiresIn?: number;\n /** The CRM workspace the user was provisioned into (resolved from org_id). */\n workspaceId?: string;\n user?: { id: string; email: string; full_name?: string };\n role?: string;\n}\n\ninterface LoadedKeys { privateKey: KeyLike; publicJwk: JWK; kid: string }\n\n// Memoize per config.iss so repeated calls don't re-import keys.\nconst keyCache = new Map<string, Promise<LoadedKeys>>();\n\nfunction randomUUID(): string {\n const c = (globalThis as { crypto?: Crypto }).crypto;\n if (c?.randomUUID) return c.randomUUID();\n // Fallback (should not happen on Node 16+/Bun): RFC4122-ish from getRandomValues.\n const b = new Uint8Array(16);\n c?.getRandomValues?.(b);\n b[6] = (b[6] & 0x0f) | 0x40;\n b[8] = (b[8] & 0x3f) | 0x80;\n const h = Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');\n return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;\n}\n\nasync function loadKeys(config: CrmEmbedSigningConfig): Promise<LoadedKeys> {\n const alg = config.alg ?? 'RS256';\n const cacheKey = `${config.iss}:${alg}`;\n const existing = keyCache.get(cacheKey);\n if (existing) return existing;\n\n const created = (async (): Promise<LoadedKeys> => {\n const privateKey = await importPKCS8(config.privateKeyPem, alg);\n const publicKey = await importSPKI(config.publicKeyPem, alg);\n const publicJwk = await exportJWK(publicKey);\n // Stable kid = RFC 7638 thumbprint so the signed header kid matches JWKS.\n const kid = await calculateJwkThumbprint(publicJwk);\n return { privateKey, publicJwk: { ...publicJwk, kid, alg, use: 'sig' }, kid };\n })();\n keyCache.set(cacheKey, created);\n return created;\n}\n\n/** Test/dev only: clear the memoized keys. */\nexport function resetCrmEmbedKeys(): void {\n keyCache.clear();\n}\n\n/**\n * The public JWKS document to serve at a public https URL. Give that URL to the\n * CRM team so they can verify your assertions. Example (Express):\n *\n * app.get('/crm-embed/jwks', async (_req, res) =>\n * res.json(await getCrmEmbedJwks(config)));\n */\nexport async function getCrmEmbedJwks(\n config: CrmEmbedSigningConfig,\n): Promise<{ keys: JWK[] }> {\n const { publicJwk } = await loadKeys(config);\n return { keys: [publicJwk] };\n}\n\n/** Mint a short-lived signed assertion the CRM will exchange for a bearer. */\nexport async function mintCrmAssertion(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options?: { ttlSeconds?: number },\n): Promise<string> {\n const alg = config.alg ?? 'RS256';\n const { privateKey, kid } = await loadKeys(config);\n const ttl = Math.min(options?.ttlSeconds ?? DEFAULT_TTL_SECONDS, DEFAULT_TTL_SECONDS);\n\n return new SignJWT({\n email: input.email,\n requested_role: input.requestedRole,\n org_id: input.orgId,\n ...(input.fullName ? { full_name: input.fullName } : {}),\n ...(input.avatarUrl ? { avatar_url: input.avatarUrl } : {}),\n })\n .setProtectedHeader({ alg, kid })\n .setSubject(input.sub)\n .setIssuer(config.iss)\n .setAudience(AUDIENCE)\n .setIssuedAt()\n .setExpirationTime(`${ttl}s`)\n .setJti(randomUUID())\n .sign(privateKey);\n}\n\nexport interface ExchangeOptions {\n /** CRM exchange base URL, e.g. \"https://api.crm.example.com\". */\n crmBaseUrl: string;\n /** Override fetch (tests / custom agents). Defaults to global fetch. */\n fetch?: typeof fetch;\n}\n\n/**\n * Exchange a minted assertion at the CRM for a CRM bearer. Do this server-side\n * so the browser never calls the CRM's exchange endpoint cross-origin.\n */\nexport async function exchangeAssertion(\n assertion: string,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const doFetch = options.fetch ?? fetch;\n const url = `${options.crmBaseUrl.replace(/\\/$/, '')}/api/auth/exchange`;\n const res = await doFetch(url, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({ assertion }),\n });\n const body = await res.json().catch(() => ({}));\n if (!res.ok) {\n const code = body?.error?.code ?? `HTTP_${res.status}`;\n const msg = body?.error?.message ?? 'CRM exchange failed';\n throw new CrmExchangeError(msg, res.status, code, body);\n }\n const data = body?.data ?? {};\n return {\n accessToken: data.access_token,\n expiresIn: data.expires_in,\n workspaceId: data.workspace?.id,\n user: data.user,\n role: data.role,\n };\n}\n\n/** Mint + exchange in one call — the typical \"give me a CRM session\" helper. */\nexport async function createEmbedSession(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const assertion = await mintCrmAssertion(input, config);\n return exchangeAssertion(assertion, options);\n}\n\n/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */\nexport class CrmExchangeError extends Error {\n constructor(\n message: string,\n public readonly status: number,\n public readonly code: string,\n public readonly detail?: unknown,\n ) {\n super(message);\n this.name = 'CrmExchangeError';\n }\n}\n"],"mappings":"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","names":["SignJWT","exportJWK","importPKCS8","importSPKI","calculateJwkThumbprint","AUDIENCE","DEFAULT_TTL_SECONDS","keyCache","randomUUID","c","b","h","x","loadKeys","config","alg","cacheKey","existing","created","privateKey","publicKey","publicJwk","kid","resetCrmEmbedKeys","getCrmEmbedJwks","mintCrmAssertion","input","options","ttl","exchangeAssertion","assertion","doFetch","url","res","body","code","msg","CrmExchangeError","data","createEmbedSession","message","status","detail"]}
|
|
1
|
+
{"version":3,"sources":["../src/embed-server.ts"],"sourcesContent":["/**\n * CRM Embed Server SDK (server side).\n *\n * Use this in YOUR SaaS backend to authenticate the embedded CRM. Two auth\n * approaches are supported:\n *\n * **Option A — API-key auth (simpler, no keypair):**\n * POST user identity + your registered `app_id`/`app_secret` to the CRM.\n * Use {@link createEmbedSessionWithKey}. No `jose` required.\n *\n * **Option B — Signed-assertion auth (zero shared-secret):**\n * Mint a short-lived asymmetric (RS256/ES256) assertion server-side and\n * exchange it at the CRM for a CRM bearer. Use {@link createEmbedSession} (or\n * {@link mintCrmAssertion} + {@link exchangeAssertion} separately).\n * Requires the `jose` peer dependency.\n *\n * Both paths return a short-lived CRM bearer; hand that bearer to the CRM\n * iframe via `embed-host` (see ./embed-host).\n *\n * Works in Node and Bun (or any environment with a global `fetch`).\n *\n * @packageDocumentation\n */\nimport {\n SignJWT,\n exportJWK,\n importPKCS8,\n importSPKI,\n calculateJwkThumbprint,\n type JWK,\n type KeyLike,\n} from 'jose';\n\n// ─── Shared error class ──────────────────────────────────────────────────────\n\n/** Thrown when the CRM rejects the exchange. `code` is the CRM's error code. */\nexport class CrmExchangeError extends Error {\n constructor(\n message: string,\n public readonly status: number,\n public readonly code: string,\n public readonly detail?: unknown,\n ) {\n super(message);\n this.name = 'CrmExchangeError';\n }\n}\n\n// ─── Option A: API-key auth ──────────────────────────────────────────────────\n\n/** The end-user being embedded into the CRM. */\nexport interface EmbedUser {\n id: string;\n email: string;\n role: 'member' | 'admin';\n name?: string;\n avatar_url?: string;\n}\n\n/** Input for {@link createEmbedSessionWithKey}. */\nexport interface CreateEmbedSessionWithKeyInput {\n appId: string;\n appSecret: string;\n user: EmbedUser;\n}\n\n/** The CRM session returned by {@link createEmbedSessionWithKey}. */\nexport interface EmbedSession {\n accessToken: string;\n expiresIn?: number;\n /** The CRM workspace the user was provisioned into. */\n workspaceId?: string;\n user?: unknown;\n role?: string;\n}\n\n/**\n * Exchange app credentials + user identity for a short-lived CRM bearer.\n *\n * POSTs `{ app_id, app_secret, user }` to `${crmBaseUrl}/api/auth/exchange`\n * and maps the CRM response to an {@link EmbedSession}. On non-2xx, throws\n * {@link CrmExchangeError} with `.status` and `.code`.\n *\n * @example\n * ```typescript\n * const session = await createEmbedSessionWithKey(\n * { appId: process.env.CRM_APP_ID!, appSecret: process.env.CRM_APP_SECRET!, user },\n * { crmBaseUrl: process.env.CRM_BASE_URL! },\n * );\n * // { accessToken, expiresIn, workspaceId, user, role }\n * ```\n */\nexport async function createEmbedSessionWithKey(\n input: CreateEmbedSessionWithKeyInput,\n opts: { crmBaseUrl: string; fetch?: typeof fetch },\n): Promise<EmbedSession> {\n const doFetch = opts.fetch ?? fetch;\n const url = `${opts.crmBaseUrl.replace(/\\/$/, '')}/api/auth/exchange`;\n const res = await doFetch(url, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({\n app_id: input.appId,\n app_secret: input.appSecret,\n user: input.user,\n }),\n });\n const body = await res.json().catch(() => ({}));\n if (!res.ok) {\n const code = body?.error?.code ?? `HTTP_${res.status}`;\n const msg = body?.error?.message ?? 'CRM exchange failed';\n throw new CrmExchangeError(msg, res.status, code, body);\n }\n const data = body?.data ?? {};\n return {\n accessToken: data.access_token,\n expiresIn: data.expires_in,\n workspaceId: data.workspace?.id,\n user: data.user,\n role: data.role,\n };\n}\n\n// ─── Option B: Signed-assertion auth ────────────────────────────────────────\n\nexport type CrmEmbedAlg = 'RS256' | 'ES256';\n\nconst AUDIENCE = 'crm';\nconst DEFAULT_TTL_SECONDS = 120;\n\nexport interface CrmEmbedSigningConfig {\n /** Issuer — MUST equal the client_id the CRM registered for your app. */\n iss: string;\n /** PKCS8 PEM private key used to sign assertions. */\n privateKeyPem: string;\n /** SPKI PEM public key — required so getCrmEmbedJwks() can publish it. */\n publicKeyPem: string;\n /** Signature algorithm. Default 'RS256'. The CRM accepts RS256 or ES256. */\n alg?: CrmEmbedAlg;\n}\n\nexport interface CrmAssertionInput {\n /** Stable user id in your system (becomes the CRM external_subject). */\n sub: string;\n /** User email. */\n email: string;\n /** Requested role; the CRM clamps it to the install's configured max_role. */\n requestedRole: 'member' | 'admin';\n /** Your organization id; the CRM resolves the workspace from the org binding. */\n orgId: string;\n /** Optional display name for first-time provisioning. */\n fullName?: string;\n /** Optional avatar URL for first-time provisioning. */\n avatarUrl?: string;\n}\n\n/** The CRM session returned by {@link createEmbedSession} / {@link exchangeAssertion}. */\nexport interface CrmEmbedSession {\n accessToken: string;\n expiresIn?: number;\n /** The CRM workspace the user was provisioned into (resolved from org_id). */\n workspaceId?: string;\n user?: { id: string; email: string; full_name?: string };\n role?: string;\n}\n\nexport interface ExchangeOptions {\n /** CRM exchange base URL, e.g. \"https://api.crm.example.com\". */\n crmBaseUrl: string;\n /** Override fetch (tests / custom agents). Defaults to global fetch. */\n fetch?: typeof fetch;\n}\n\ninterface LoadedKeys { privateKey: KeyLike; publicJwk: JWK; kid: string }\n\n// Memoize per config.iss so repeated calls don't re-import keys.\nconst keyCache = new Map<string, Promise<LoadedKeys>>();\n\nfunction randomUUID(): string {\n const c = (globalThis as { crypto?: Crypto }).crypto;\n if (c?.randomUUID) return c.randomUUID();\n // Fallback (should not happen on Node 16+/Bun): RFC4122-ish from getRandomValues.\n const b = new Uint8Array(16);\n c?.getRandomValues?.(b);\n b[6] = (b[6] & 0x0f) | 0x40;\n b[8] = (b[8] & 0x3f) | 0x80;\n const h = Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');\n return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;\n}\n\nasync function loadKeys(config: CrmEmbedSigningConfig): Promise<LoadedKeys> {\n const alg = config.alg ?? 'RS256';\n const cacheKey = `${config.iss}:${alg}`;\n const existing = keyCache.get(cacheKey);\n if (existing) return existing;\n\n const created = (async (): Promise<LoadedKeys> => {\n const privateKey = await importPKCS8(config.privateKeyPem, alg);\n const publicKey = await importSPKI(config.publicKeyPem, alg);\n const publicJwk = await exportJWK(publicKey);\n // Stable kid = RFC 7638 thumbprint so the signed header kid matches JWKS.\n const kid = await calculateJwkThumbprint(publicJwk);\n return { privateKey, publicJwk: { ...publicJwk, kid, alg, use: 'sig' }, kid };\n })();\n keyCache.set(cacheKey, created);\n return created;\n}\n\n/** Test/dev only: clear the memoized keys. */\nexport function resetCrmEmbedKeys(): void {\n keyCache.clear();\n}\n\n/**\n * The public JWKS document to serve at a public https URL. Give that URL to the\n * CRM team so they can verify your assertions. Example (Express):\n *\n * app.get('/crm-embed/jwks', async (_req, res) =>\n * res.json(await getCrmEmbedJwks(config)));\n */\nexport async function getCrmEmbedJwks(\n config: CrmEmbedSigningConfig,\n): Promise<{ keys: JWK[] }> {\n const { publicJwk } = await loadKeys(config);\n return { keys: [publicJwk] };\n}\n\n/** Mint a short-lived signed assertion the CRM will exchange for a bearer. */\nexport async function mintCrmAssertion(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options?: { ttlSeconds?: number },\n): Promise<string> {\n const alg = config.alg ?? 'RS256';\n const { privateKey, kid } = await loadKeys(config);\n const ttl = Math.min(options?.ttlSeconds ?? DEFAULT_TTL_SECONDS, DEFAULT_TTL_SECONDS);\n\n return new SignJWT({\n email: input.email,\n requested_role: input.requestedRole,\n org_id: input.orgId,\n ...(input.fullName ? { full_name: input.fullName } : {}),\n ...(input.avatarUrl ? { avatar_url: input.avatarUrl } : {}),\n })\n .setProtectedHeader({ alg, kid })\n .setSubject(input.sub)\n .setIssuer(config.iss)\n .setAudience(AUDIENCE)\n .setIssuedAt()\n .setExpirationTime(`${ttl}s`)\n .setJti(randomUUID())\n .sign(privateKey);\n}\n\n/**\n * Exchange a minted assertion at the CRM for a CRM bearer. Do this server-side\n * so the browser never calls the CRM's exchange endpoint cross-origin.\n */\nexport async function exchangeAssertion(\n assertion: string,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const doFetch = options.fetch ?? fetch;\n const url = `${options.crmBaseUrl.replace(/\\/$/, '')}/api/auth/exchange`;\n const res = await doFetch(url, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({ assertion }),\n });\n const body = await res.json().catch(() => ({}));\n if (!res.ok) {\n const code = body?.error?.code ?? `HTTP_${res.status}`;\n const msg = body?.error?.message ?? 'CRM exchange failed';\n throw new CrmExchangeError(msg, res.status, code, body);\n }\n const data = body?.data ?? {};\n return {\n accessToken: data.access_token,\n expiresIn: data.expires_in,\n workspaceId: data.workspace?.id,\n user: data.user,\n role: data.role,\n };\n}\n\n/** Mint + exchange in one call — the typical \"give me a CRM session\" helper. */\nexport async function createEmbedSession(\n input: CrmAssertionInput,\n config: CrmEmbedSigningConfig,\n options: ExchangeOptions,\n): Promise<CrmEmbedSession> {\n const assertion = await mintCrmAssertion(input, config);\n return exchangeAssertion(assertion, options);\n}\n"],"mappings":"AAuBA,OACE,WAAAA,EACA,aAAAC,EACA,eAAAC,EACA,cAAAC,EACA,0BAAAC,MAGK,OAKA,IAAMC,EAAN,cAA+B,KAAM,CAC1C,YACEC,EACgBC,EACAC,EACAC,EAChB,CACA,MAAMH,CAAO,EAJG,YAAAC,EACA,UAAAC,EACA,YAAAC,EAGhB,KAAK,KAAO,kBACd,CACF,EA8CA,eAAsBC,EACpBC,EACAC,EACuB,CACvB,IAAMC,EAAUD,EAAK,OAAS,MACxBE,EAAM,GAAGF,EAAK,WAAW,QAAQ,MAAO,EAAE,CAAC,qBAC3CG,EAAM,MAAMF,EAAQC,EAAK,CAC7B,OAAQ,OACR,QAAS,CAAE,eAAgB,kBAAmB,EAC9C,KAAM,KAAK,UAAU,CACnB,OAAQH,EAAM,MACd,WAAYA,EAAM,UAClB,KAAMA,EAAM,IACd,CAAC,CACH,CAAC,EACKK,EAAO,MAAMD,EAAI,KAAK,EAAE,MAAM,KAAO,CAAC,EAAE,EAC9C,GAAI,CAACA,EAAI,GAAI,CACX,IAAMP,EAAOQ,GAAM,OAAO,MAAQ,QAAQD,EAAI,MAAM,GAC9CE,EAAMD,GAAM,OAAO,SAAW,sBACpC,MAAM,IAAIX,EAAiBY,EAAKF,EAAI,OAAQP,EAAMQ,CAAI,CACxD,CACA,IAAME,EAAOF,GAAM,MAAQ,CAAC,EAC5B,MAAO,CACL,YAAaE,EAAK,aAClB,UAAWA,EAAK,WAChB,YAAaA,EAAK,WAAW,GAC7B,KAAMA,EAAK,KACX,KAAMA,EAAK,IACb,CACF,CAMA,IAAMC,EAAW,MACXC,EAAsB,IAgDtBC,EAAW,IAAI,IAErB,SAASC,GAAqB,CAC5B,IAAMC,EAAK,WAAmC,OAC9C,GAAIA,GAAG,WAAY,OAAOA,EAAE,WAAW,EAEvC,IAAMC,EAAI,IAAI,WAAW,EAAE,EAC3BD,GAAG,kBAAkBC,CAAC,EACtBA,EAAE,CAAC,EAAKA,EAAE,CAAC,EAAI,GAAQ,GACvBA,EAAE,CAAC,EAAKA,EAAE,CAAC,EAAI,GAAQ,IACvB,IAAMC,EAAI,MAAM,KAAKD,EAAIE,GAAMA,EAAE,SAAS,EAAE,EAAE,SAAS,EAAG,GAAG,CAAC,EAAE,KAAK,EAAE,EACvE,MAAO,GAAGD,EAAE,MAAM,EAAG,CAAC,CAAC,IAAIA,EAAE,MAAM,EAAG,EAAE,CAAC,IAAIA,EAAE,MAAM,GAAI,EAAE,CAAC,IAAIA,EAAE,MAAM,GAAI,EAAE,CAAC,IAAIA,EAAE,MAAM,EAAE,CAAC,EAChG,CAEA,eAAeE,EAASC,EAAoD,CAC1E,IAAMC,EAAMD,EAAO,KAAO,QACpBE,EAAW,GAAGF,EAAO,GAAG,IAAIC,CAAG,GAC/BE,EAAWV,EAAS,IAAIS,CAAQ,EACtC,GAAIC,EAAU,OAAOA,EAErB,IAAMC,GAAW,SAAiC,CAChD,IAAMC,EAAa,MAAM/B,EAAY0B,EAAO,cAAeC,CAAG,EACxDK,EAAY,MAAM/B,EAAWyB,EAAO,aAAcC,CAAG,EACrDM,EAAY,MAAMlC,EAAUiC,CAAS,EAErCE,EAAM,MAAMhC,EAAuB+B,CAAS,EAClD,MAAO,CAAE,WAAAF,EAAY,UAAW,CAAE,GAAGE,EAAW,IAAAC,EAAK,IAAAP,EAAK,IAAK,KAAM,EAAG,IAAAO,CAAI,CAC9E,GAAG,EACH,OAAAf,EAAS,IAAIS,EAAUE,CAAO,EACvBA,CACT,CAGO,SAASK,GAA0B,CACxChB,EAAS,MAAM,CACjB,CASA,eAAsBiB,EACpBV,EAC0B,CAC1B,GAAM,CAAE,UAAAO,CAAU,EAAI,MAAMR,EAASC,CAAM,EAC3C,MAAO,CAAE,KAAM,CAACO,CAAS,CAAE,CAC7B,CAGA,eAAsBI,EACpB5B,EACAiB,EACAY,EACiB,CACjB,IAAMX,EAAMD,EAAO,KAAO,QACpB,CAAE,WAAAK,EAAY,IAAAG,CAAI,EAAI,MAAMT,EAASC,CAAM,EAC3Ca,EAAM,KAAK,IAAID,GAAS,YAAcpB,EAAqBA,CAAmB,EAEpF,OAAO,IAAIpB,EAAQ,CACjB,MAAOW,EAAM,MACb,eAAgBA,EAAM,cACtB,OAAQA,EAAM,MACd,GAAIA,EAAM,SAAW,CAAE,UAAWA,EAAM,QAAS,EAAI,CAAC,EACtD,GAAIA,EAAM,UAAY,CAAE,WAAYA,EAAM,SAAU,EAAI,CAAC,CAC3D,CAAC,EACE,mBAAmB,CAAE,IAAAkB,EAAK,IAAAO,CAAI,CAAC,EAC/B,WAAWzB,EAAM,GAAG,EACpB,UAAUiB,EAAO,GAAG,EACpB,YAAYT,CAAQ,EACpB,YAAY,EACZ,kBAAkB,GAAGsB,CAAG,GAAG,EAC3B,OAAOnB,EAAW,CAAC,EACnB,KAAKW,CAAU,CACpB,CAMA,eAAsBS,EACpBC,EACAH,EAC0B,CAC1B,IAAM3B,EAAU2B,EAAQ,OAAS,MAC3B1B,EAAM,GAAG0B,EAAQ,WAAW,QAAQ,MAAO,EAAE,CAAC,qBAC9CzB,EAAM,MAAMF,EAAQC,EAAK,CAC7B,OAAQ,OACR,QAAS,CAAE,eAAgB,kBAAmB,EAC9C,KAAM,KAAK,UAAU,CAAE,UAAA6B,CAAU,CAAC,CACpC,CAAC,EACK3B,EAAO,MAAMD,EAAI,KAAK,EAAE,MAAM,KAAO,CAAC,EAAE,EAC9C,GAAI,CAACA,EAAI,GAAI,CACX,IAAMP,EAAOQ,GAAM,OAAO,MAAQ,QAAQD,EAAI,MAAM,GAC9CE,EAAMD,GAAM,OAAO,SAAW,sBACpC,MAAM,IAAIX,EAAiBY,EAAKF,EAAI,OAAQP,EAAMQ,CAAI,CACxD,CACA,IAAME,EAAOF,GAAM,MAAQ,CAAC,EAC5B,MAAO,CACL,YAAaE,EAAK,aAClB,UAAWA,EAAK,WAChB,YAAaA,EAAK,WAAW,GAC7B,KAAMA,EAAK,KACX,KAAMA,EAAK,IACb,CACF,CAGA,eAAsB0B,EACpBjC,EACAiB,EACAY,EAC0B,CAC1B,IAAMG,EAAY,MAAMJ,EAAiB5B,EAAOiB,CAAM,EACtD,OAAOc,EAAkBC,EAAWH,CAAO,CAC7C","names":["SignJWT","exportJWK","importPKCS8","importSPKI","calculateJwkThumbprint","CrmExchangeError","message","status","code","detail","createEmbedSessionWithKey","input","opts","doFetch","url","res","body","msg","data","AUDIENCE","DEFAULT_TTL_SECONDS","keyCache","randomUUID","c","b","h","x","loadKeys","config","alg","cacheKey","existing","created","privateKey","publicKey","publicJwk","kid","resetCrmEmbedKeys","getCrmEmbedJwks","mintCrmAssertion","options","ttl","exchangeAssertion","assertion","createEmbedSession"]}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@first-to-fly/crm-sdk",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "CRM SDK — embed third-party apps inside the CRM, or embed the CRM inside your own SaaS (proxy-free, signed-assertion auth)",
|
|
3
|
+
"version": "1.3.0",
|
|
4
|
+
"description": "CRM SDK — embed third-party apps inside the CRM, or embed the CRM inside your own SaaS (proxy-free, signed-assertion or API-key auth)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.cjs",
|
|
7
7
|
"module": "dist/index.js",
|
|
@@ -38,6 +38,16 @@
|
|
|
38
38
|
"types": "./dist/embed-server.d.cts",
|
|
39
39
|
"default": "./dist/embed-server.cjs"
|
|
40
40
|
}
|
|
41
|
+
},
|
|
42
|
+
"./api": {
|
|
43
|
+
"import": {
|
|
44
|
+
"types": "./dist/api.d.ts",
|
|
45
|
+
"default": "./dist/api.js"
|
|
46
|
+
},
|
|
47
|
+
"require": {
|
|
48
|
+
"types": "./dist/api.d.cts",
|
|
49
|
+
"default": "./dist/api.cjs"
|
|
50
|
+
}
|
|
41
51
|
}
|
|
42
52
|
},
|
|
43
53
|
"files": [
|