@chassdev/client-sdk 2.46.0

package/dist/rest/index.d.ts

@@ -0,0 +1,54 @@
+import { type TwentyClientRunAs } from '../shared/twenty-client-run-as.type';
+export type { TwentyClientRunAs };
+export type RestApiClientOptions = {
+    baseUrl?: string;
+    token?: string;
+    fetch?: typeof globalThis.fetch;
+    defaultHeaders?: HeadersInit;
+    runAs?: TwentyClientRunAs;
+};
+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 runAs;
+    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>;
+    resolveUrl(path: string, requestOptions?: Pick<RestApiRequestOptions, 'query'>): string;
+    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 resolveFunctionsBaseUrl;
+    private resolveTarget;
+    private resolveToken;
+    private requestRefreshedAccessToken;
+    private sendRequest;
+    private parseResponse;
+    private execute;
+}

package/dist/rest.cjs

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

package/dist/rest.mjs

@@ -0,0 +1,112 @@
+import { i as e, n as t, r as n, t as r } from "./application-CMx2Si6C.mjs";
+//#region src/rest/index.ts
+var i = (e) => e != null, a = class 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;
+	}
+}, o = () => globalThis.process?.env ?? {}, s = (e) => /^\/?s\//.test(e), c = (e) => e.replace(/^(\/?)s\//, "$1"), l = (e, t, n) => {
+	let r = /^https?:\/\//i.test(t) ? t : `${e}${t.startsWith("/") ? "" : "/"}${t}`;
+	if (!i(n)) return r;
+	let a = new URLSearchParams();
+	for (let [e, t] of Object.entries(n)) i(t) && a.append(e, String(t));
+	let o = a.toString();
+	return o.length === 0 ? r : r.includes("?") ? `${r}&${o}` : `${r}?${o}`;
+}, u = class {
+	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, this.runAs = e?.runAs;
+	}
+	request(e, t, n) {
+		return this.execute(e, t, n?.body, n);
+	}
+	get(e, t) {
+		return this.execute("GET", e, void 0, t);
+	}
+	resolveUrl(e, t) {
+		let n = this.resolveTarget(e);
+		return l(n.baseUrl, n.path, t?.query);
+	}
+	post(e, t, n) {
+		return this.execute("POST", e, t, n);
+	}
+	put(e, t, n) {
+		return this.execute("PUT", e, t, n);
+	}
+	patch(e, t, n) {
+		return this.execute("PATCH", e, t, n);
+	}
+	delete(e, t) {
+		return this.execute("DELETE", e, void 0, t);
+	}
+	resolveBaseUrl() {
+		let e = this.baseUrl ?? o().TWENTY_API_URL;
+		if (!i(e) || e.trim().length === 0) throw new a(`Missing API url. Set the \`${r}\` environment variable or pass \`baseUrl\` to \`RestApiClient\`.`);
+		return e.replace(/\/+$/, "");
+	}
+	resolveFunctionsBaseUrl() {
+		let e = o()[n];
+		if (!(!i(e) || e.trim().length === 0)) return e.trim().replace(/\/+$/, "");
+	}
+	resolveTarget(e) {
+		return i(this.baseUrl) || !s(e) ? {
+			baseUrl: this.resolveBaseUrl(),
+			path: e
+		} : {
+			baseUrl: this.resolveFunctionsBaseUrl() ?? `${this.resolveBaseUrl()}/s`,
+			path: c(e)
+		};
+	}
+	resolveToken() {
+		let n = this.runAs === "application" ? t : e;
+		if (!i(this.authorizationToken)) {
+			let e = o();
+			this.authorizationToken = this.token ?? e[n] ?? e.TWENTY_API_KEY ?? null;
+		}
+		if (!i(this.authorizationToken) || this.authorizationToken.length === 0) throw new a(`Missing application access token. Set the \`${n}\` environment variable or pass \`token\` to \`RestApiClient\`.`);
+		return this.authorizationToken;
+	}
+	async requestRefreshedAccessToken() {
+		let t = globalThis.frontComponentHostCommunicationApi?.requestAccessTokenRefresh;
+		return typeof t == "function" ? (this.refreshAccessTokenPromise ||= t().then((t) => typeof t != "string" || t.length === 0 ? null : (this.authorizationToken = t, o()[e] = t, t)).catch((e) => (console.error("Chass REST client: token refresh failed", e), null)).finally(() => {
+			this.refreshAccessTokenPromise = null;
+		}), this.refreshAccessTokenPromise) : null;
+	}
+	sendRequest(e, t, n, r, o) {
+		if (!i(this.fetchImplementation)) throw new a("Global `fetch` function is not available, pass a fetch implementation to `RestApiClient`.");
+		let s = new Headers(this.defaultHeaders);
+		i(o?.headers) && new Headers(o.headers).forEach((e, t) => s.set(t, e));
+		let c = typeof FormData < "u" && n instanceof FormData, l = i(n) && !c && typeof n != "string";
+		c ? s.delete("Content-Type") : l && s.set("Content-Type", "application/json"), s.set("Authorization", `Bearer ${r}`);
+		let u = i(n) ? c || typeof n == "string" ? n : JSON.stringify(n) : void 0;
+		return this.fetchImplementation.call(globalThis, e, {
+			method: t,
+			headers: s,
+			body: u,
+			signal: o?.signal
+		});
+	}
+	async parseResponse(e, t) {
+		let n = await e.text(), r;
+		if (n.trim().length > 0) try {
+			r = JSON.parse(n);
+		} catch {
+			r = n;
+		}
+		if (!e.ok) throw new a(`Request to ${t} failed with status ${e.status} ${e.statusText}`, {
+			status: e.status,
+			statusText: e.statusText,
+			url: t,
+			body: r
+		});
+		return r;
+	}
+	async execute(e, t, n, r) {
+		let a = this.resolveTarget(t), o = l(a.baseUrl, a.path, r?.query), s = this.resolveToken(), c = await this.sendRequest(o, e, n, s, r);
+		if (c.status === 401) {
+			let t = await this.requestRefreshedAccessToken();
+			i(t) && (c = await this.sendRequest(o, e, n, t, r));
+		}
+		return this.parseResponse(c, o);
+	}
+};
+//#endregion
+export { u as RestApiClient, a as RestApiClientError };

package/dist/shared/twenty-client-options.type.d.ts

@@ -0,0 +1,9 @@
+import { type TwentyClientRunAs } from './twenty-client-run-as.type';
+export type TwentyClientOptions = Omit<RequestInit, 'body' | 'headers'> & {
+    url?: string;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    fetcher?: (operation: Record<string, unknown> | Record<string, unknown>[]) => Promise<unknown>;
+    fetch?: typeof globalThis.fetch;
+    batch?: unknown;
+    runAs?: TwentyClientRunAs;
+};

package/dist/shared/twenty-client-run-as.type.d.ts

@@ -0,0 +1 @@
+export type TwentyClientRunAs = 'user' | 'application';

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@chassdev/client-sdk",
+  "version": "2.46.0",
+  "description": "Typed Core, Metadata and REST API clients for Chass applications.",
+  "sideEffects": false,
+  "license": "MIT",
+  "scripts": {
+    "build": "npx rimraf dist && npx vite build && npx vite build -c vite.metadata.config.ts && tsgo -p tsconfig.lib.json --declaration --emitDeclarationOnly --noEmit false --outDir dist --rootDir src && npx tsc-alias -p tsconfig.lib.json --outDir dist"
+  },
+  "exports": {
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core.mjs",
+      "require": "./dist/core.cjs"
+    },
+    "./metadata": {
+      "types": "./dist/metadata/index.d.ts",
+      "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",
+      "require": "./dist/generate.cjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "core": [
+        "dist/core/index.d.ts"
+      ],
+      "metadata": [
+        "dist/metadata/index.d.ts"
+      ],
+      "rest": [
+        "dist/rest/index.d.ts"
+      ],
+      "generate": [
+        "dist/generate/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@genql/runtime": "^2.10.0",
+    "esbuild": "^0.28.1",
+    "graphql": "^16.8.1",
+    "lodash": "^4.17.21",
+    "prettier": "^3.8.3"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.17.24",
+    "@typescript/native-preview": "^7.0.0-dev.20260116.1",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.0",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.1.0"
+  },
+  "engines": {
+    "node": "^24.5.0",
+    "yarn": "^4.0.2"
+  },
+  "homepage": "https://chass.app",
+  "bugs": {
+    "email": "Pierre@chass.app"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}