twenty-client-sdk 2.10.0 → 2.12.0

package/dist/rest/index.d.ts

@@ -0,0 +1,48 @@
+export type RestApiClientOptions = {
+    baseUrl?: string;
+    token?: string;
+    fetch?: typeof globalThis.fetch;
+    defaultHeaders?: HeadersInit;
+};
+export type RestApiRequestOptions = {
+    headers?: HeadersInit;
+    query?: Record<string, string | number | boolean | null | undefined>;
+    signal?: AbortSignal;
+};
+type RestApiClientErrorDetails = {
+    status?: number;
+    statusText?: string;
+    url?: string;
+    body?: unknown;
+};
+export declare class RestApiClientError extends Error {
+    readonly status?: number;
+    readonly statusText?: string;
+    readonly url?: string;
+    readonly body?: unknown;
+    constructor(message: string, details?: RestApiClientErrorDetails);
+}
+export declare class RestApiClient {
+    private baseUrl;
+    private token;
+    private defaultHeaders;
+    private fetchImplementation;
+    private authorizationToken;
+    private refreshAccessTokenPromise;
+    constructor(options?: RestApiClientOptions);
+    request<TResponse = unknown>(method: string, path: string, options?: RestApiRequestOptions & {
+        body?: unknown;
+    }): Promise<TResponse>;
+    get<TResponse = unknown>(path: string, options?: RestApiRequestOptions): Promise<TResponse>;
+    post<TResponse = unknown>(path: string, body?: unknown, options?: RestApiRequestOptions): Promise<TResponse>;
+    put<TResponse = unknown>(path: string, body?: unknown, options?: RestApiRequestOptions): Promise<TResponse>;
+    patch<TResponse = unknown>(path: string, body?: unknown, options?: RestApiRequestOptions): Promise<TResponse>;
+    delete<TResponse = unknown>(path: string, options?: RestApiRequestOptions): Promise<TResponse>;
+    private resolveBaseUrl;
+    private resolveToken;
+    private requestRefreshedAccessToken;
+    private sendRequest;
+    private parseResponse;
+    private execute;
+}
+export {};

package/dist/rest.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const u=require("./application-DIOnMh59.js"),o=l=>l!=null;class c extends Error{constructor(e,t){super(e),this.name="RestApiClientError",this.status=t?.status,this.statusText=t?.statusText,this.url=t?.url,this.body=t?.body}}const f=()=>globalThis.process?.env??{},m=(l,e,t)=>{const s=/^https?:\/\//i.test(e)?e:`${l}${e.startsWith("/")?"":"/"}${e}`;if(!o(t))return s;const n=new URLSearchParams;for(const[a,i]of Object.entries(t))o(i)&&n.append(a,String(i));const r=n.toString();return r.length===0?s:s.includes("?")?`${s}&${r}`:`${s}?${r}`};class k{constructor(e){this.refreshAccessTokenPromise=null,this.baseUrl=e?.baseUrl,this.token=e?.token,this.defaultHeaders=e?.defaultHeaders,this.fetchImplementation=e?.fetch??globalThis.fetch??null,this.authorizationToken=e?.token??null}request(e,t,s){return this.execute(e,t,s?.body,s)}get(e,t){return this.execute("GET",e,void 0,t)}post(e,t,s){return this.execute("POST",e,t,s)}put(e,t,s){return this.execute("PUT",e,t,s)}patch(e,t,s){return this.execute("PATCH",e,t,s)}delete(e,t){return this.execute("DELETE",e,void 0,t)}resolveBaseUrl(){const e=this.baseUrl??f()[u.T];if(!o(e)||e.trim().length===0)throw new c(`Missing API url. Set the \`${u.T}\` environment variable or pass \`baseUrl\` to \`RestApiClient\`.`);return e.replace(/\/+$/,"")}resolveToken(){if(!o(this.authorizationToken)){const e=f();this.authorizationToken=this.token??e[u.r]??e[u.A]??null}if(!o(this.authorizationToken)||this.authorizationToken.length===0)throw new c(`Missing application access token. Set the \`${u.r}\` environment variable or pass \`token\` to \`RestApiClient\`.`);return this.authorizationToken}async requestRefreshedAccessToken(){const e=globalThis.frontComponentHostCommunicationApi?.requestAccessTokenRefresh;return typeof e!="function"?null:(this.refreshAccessTokenPromise||(this.refreshAccessTokenPromise=e().then(t=>typeof t!="string"||t.length===0?null:(this.authorizationToken=t,f()[u.r]=t,t)).catch(t=>(console.error("Twenty REST client: token refresh failed",t),null)).finally(()=>{this.refreshAccessTokenPromise=null})),this.refreshAccessTokenPromise)}sendRequest(e,t,s,n,r){if(!o(this.fetchImplementation))throw new c("Global `fetch` function is not available, pass a fetch implementation to `RestApiClient`.");const a=new Headers(this.defaultHeaders);o(r?.headers)&&new Headers(r.headers).forEach((d,p)=>a.set(p,d));const i=typeof FormData<"u"&&s instanceof FormData,h=o(s)&&!i&&typeof s!="string";i?a.delete("Content-Type"):h&&a.set("Content-Type","application/json"),a.set("Authorization",`Bearer ${n}`);const T=o(s)?i||typeof s=="string"?s:JSON.stringify(s):void 0;return this.fetchImplementation.call(globalThis,e,{method:t,headers:a,body:T,signal:r?.signal})}async parseResponse(e,t){const s=await e.text();let n;if(s.trim().length>0)try{n=JSON.parse(s)}catch{n=s}if(!e.ok)throw new c(`Request to ${t} failed with status ${e.status} ${e.statusText}`,{status:e.status,statusText:e.statusText,url:t,body:n});return n}async execute(e,t,s,n){const r=m(this.resolveBaseUrl(),t,n?.query),a=this.resolveToken();let i=await this.sendRequest(r,e,s,a,n);if(i.status===401){const h=await this.requestRefreshedAccessToken();o(h)&&(i=await this.sendRequest(r,e,s,h,n))}return this.parseResponse(i,r)}}exports.RestApiClient=k;exports.RestApiClientError=c;

package/dist/rest.mjs

@@ -0,0 +1,137 @@
+import { T, r as u, A as k } from "./application-pjniEWXj.mjs";
+const o = (l) => l != null;
+class c extends Error {
+  constructor(e, t) {
+    super(e), this.name = "RestApiClientError", this.status = t?.status, this.statusText = t?.statusText, this.url = t?.url, this.body = t?.body;
+  }
+}
+const f = () => globalThis.process?.env ?? {}, g = (l, e, t) => {
+  const s = /^https?:\/\//i.test(e) ? e : `${l}${e.startsWith("/") ? "" : "/"}${e}`;
+  if (!o(t))
+    return s;
+  const n = new URLSearchParams();
+  for (const [a, i] of Object.entries(t))
+    o(i) && n.append(a, String(i));
+  const r = n.toString();
+  return r.length === 0 ? s : s.includes("?") ? `${s}&${r}` : `${s}?${r}`;
+};
+class w {
+  constructor(e) {
+    this.refreshAccessTokenPromise = null, this.baseUrl = e?.baseUrl, this.token = e?.token, this.defaultHeaders = e?.defaultHeaders, this.fetchImplementation = e?.fetch ?? globalThis.fetch ?? null, this.authorizationToken = e?.token ?? null;
+  }
+  request(e, t, s) {
+    return this.execute(e, t, s?.body, s);
+  }
+  get(e, t) {
+    return this.execute("GET", e, void 0, t);
+  }
+  post(e, t, s) {
+    return this.execute("POST", e, t, s);
+  }
+  put(e, t, s) {
+    return this.execute("PUT", e, t, s);
+  }
+  patch(e, t, s) {
+    return this.execute("PATCH", e, t, s);
+  }
+  delete(e, t) {
+    return this.execute("DELETE", e, void 0, t);
+  }
+  resolveBaseUrl() {
+    const e = this.baseUrl ?? f()[T];
+    if (!o(e) || e.trim().length === 0)
+      throw new c(
+        `Missing API url. Set the \`${T}\` environment variable or pass \`baseUrl\` to \`RestApiClient\`.`
+      );
+    return e.replace(/\/+$/, "");
+  }
+  resolveToken() {
+    if (!o(this.authorizationToken)) {
+      const e = f();
+      this.authorizationToken = this.token ?? e[u] ?? e[k] ?? null;
+    }
+    if (!o(this.authorizationToken) || this.authorizationToken.length === 0)
+      throw new c(
+        `Missing application access token. Set the \`${u}\` environment variable or pass \`token\` to \`RestApiClient\`.`
+      );
+    return this.authorizationToken;
+  }
+  async requestRefreshedAccessToken() {
+    const e = globalThis.frontComponentHostCommunicationApi?.requestAccessTokenRefresh;
+    return typeof e != "function" ? null : (this.refreshAccessTokenPromise || (this.refreshAccessTokenPromise = e().then((t) => typeof t != "string" || t.length === 0 ? null : (this.authorizationToken = t, f()[u] = t, t)).catch((t) => (console.error(
+      "Twenty REST client: token refresh failed",
+      t
+    ), null)).finally(() => {
+      this.refreshAccessTokenPromise = null;
+    })), this.refreshAccessTokenPromise);
+  }
+  sendRequest(e, t, s, n, r) {
+    if (!o(this.fetchImplementation))
+      throw new c(
+        "Global `fetch` function is not available, pass a fetch implementation to `RestApiClient`."
+      );
+    const a = new Headers(this.defaultHeaders);
+    o(r?.headers) && new Headers(r.headers).forEach(
+      (p, m) => a.set(m, p)
+    );
+    const i = typeof FormData < "u" && s instanceof FormData, h = o(s) && !i && typeof s != "string";
+    i ? a.delete("Content-Type") : h && a.set("Content-Type", "application/json"), a.set("Authorization", `Bearer ${n}`);
+    const d = o(s) ? i || typeof s == "string" ? s : JSON.stringify(s) : void 0;
+    return this.fetchImplementation.call(globalThis, e, {
+      method: t,
+      headers: a,
+      body: d,
+      signal: r?.signal
+    });
+  }
+  async parseResponse(e, t) {
+    const s = await e.text();
+    let n;
+    if (s.trim().length > 0)
+      try {
+        n = JSON.parse(s);
+      } catch {
+        n = s;
+      }
+    if (!e.ok)
+      throw new c(
+        `Request to ${t} failed with status ${e.status} ${e.statusText}`,
+        {
+          status: e.status,
+          statusText: e.statusText,
+          url: t,
+          body: n
+        }
+      );
+    return n;
+  }
+  async execute(e, t, s, n) {
+    const r = g(
+      this.resolveBaseUrl(),
+      t,
+      n?.query
+    ), a = this.resolveToken();
+    let i = await this.sendRequest(
+      r,
+      e,
+      s,
+      a,
+      n
+    );
+    if (i.status === 401) {
+      const h = await this.requestRefreshedAccessToken();
+      o(h) && (i = await this.sendRequest(
+        r,
+        e,
+        s,
+        h,
+        n
+      ));
+    }
+    return this.parseResponse(i, r);
+  }
+}
+export {
+  w as RestApiClient,
+  c as RestApiClientError
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twenty-client-sdk",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "sideEffects": false,
   "license": "AGPL-3.0",
   "scripts": {
@@ -17,6 +17,11 @@
       "import": "./dist/metadata.mjs",
       "require": "./dist/metadata.cjs"
     },
+    "./rest": {
+      "types": "./dist/rest/index.d.ts",
+      "import": "./dist/rest.mjs",
+      "require": "./dist/rest.cjs"
+    },
     "./generate": {
       "types": "./dist/generate/index.d.ts",
       "import": "./dist/generate.mjs",
@@ -31,6 +36,9 @@
       "metadata": [
         "dist/metadata/index.d.ts"
       ],
+      "rest": [
+        "dist/rest/index.d.ts"
+      ],
       "generate": [
         "dist/generate/index.d.ts"
       ]
@@ -40,12 +48,14 @@
     "dist"
   ],
   "dependencies": {
-    "@genql/cli": "^3.0.3",
     "@genql/runtime": "^2.10.0",
     "esbuild": "^0.28.0",
-    "graphql": "^16.8.1"
+    "graphql": "^16.8.1",
+    "lodash": "^4.17.21",
+    "prettier": "^3.8.3"
   },
   "devDependencies": {
+    "@types/lodash": "^4.17.15",
     "@typescript/native-preview": "^7.0.0-dev.20260116.1",
     "tsc-alias": "^1.8.16",
     "twenty-shared": "0.0.0",
@@ -53,7 +63,7 @@
     "vite": "^7.0.0",
     "vite-plugin-dts": "^4.5.4",
     "vite-tsconfig-paths": "^4.2.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "engines": {
     "node": "^24.5.0",