twenty-sdk 2.1.0 → 2.3.0

package/dist/{get-function-input-schema-BZ7_XyUh-D38OurwZ.js → get-function-input-schema-BZ7_XyUh-BXB2AcBE.js}

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("typescript"),o=require("./uninstall-CYiYoBPe.js"),c=n=>{switch(n.kind){case e.SyntaxKind.NumberKeyword:return{type:"number"};case e.SyntaxKind.StringKeyword:return{type:"string"};case e.SyntaxKind.BooleanKeyword:return{type:"boolean"};case e.SyntaxKind.ArrayType:return{type:"array",items:c(n.elementType)};case e.SyntaxKind.ObjectKeyword:return{type:"object"};case e.SyntaxKind.TypeLiteral:{const i={};return n.members.forEach(t=>{if(o.o(t.name)&&o.o(t.type)){const r=t.name.text;i[r]=c(t.type)}}),{type:"object",properties:i}}case e.SyntaxKind.UnionType:{const i=n,t=[];let r=!0;return i.types.forEach(a=>{if(a.kind===e.SyntaxKind.LiteralType){const y=a.literal;y.kind===e.SyntaxKind.StringLiteral?t.push(y.text):r=!1}else r=!1}),r?{type:"string",enum:t}:{}}default:return{}}},s=(n,i)=>n.parameters.reduce((t,r)=>{const a=r.type;return o.o(a)?[...t,c(a)]:[...t,{}]},i),d=n=>n.kind===e.SyntaxKind.FunctionDeclaration?[n]:n.kind===e.SyntaxKind.VariableStatement?n.declarationList.declarations.filter(i=>o.o(i.initializer)&&i.initializer.kind===e.SyntaxKind.ArrowFunction).map(i=>i.initializer):[],l=n=>{const i=e.createSourceFile("temp.ts",n,e.ScriptTarget.ESNext,!0);let t=[];return i.forEachChild(r=>{(r.kind===e.SyntaxKind.FunctionDeclaration||r.kind===e.SyntaxKind.VariableStatement)&&d(r).forEach(a=>{t=s(a,t)})}),t};exports.getFunctionInputSchema=l;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("typescript"),o=require("./uninstall-BiLmSWhb.js"),c=n=>{switch(n.kind){case e.SyntaxKind.NumberKeyword:return{type:"number"};case e.SyntaxKind.StringKeyword:return{type:"string"};case e.SyntaxKind.BooleanKeyword:return{type:"boolean"};case e.SyntaxKind.ArrayType:return{type:"array",items:c(n.elementType)};case e.SyntaxKind.ObjectKeyword:return{type:"object"};case e.SyntaxKind.TypeLiteral:{const i={};return n.members.forEach(t=>{if(o.o(t.name)&&o.o(t.type)){const r=t.name.text;i[r]=c(t.type)}}),{type:"object",properties:i}}case e.SyntaxKind.UnionType:{const i=n,t=[];let r=!0;return i.types.forEach(a=>{if(a.kind===e.SyntaxKind.LiteralType){const y=a.literal;y.kind===e.SyntaxKind.StringLiteral?t.push(y.text):r=!1}else r=!1}),r?{type:"string",enum:t}:{}}default:return{}}},s=(n,i)=>n.parameters.reduce((t,r)=>{const a=r.type;return o.o(a)?[...t,c(a)]:[...t,{}]},i),d=n=>n.kind===e.SyntaxKind.FunctionDeclaration?[n]:n.kind===e.SyntaxKind.VariableStatement?n.declarationList.declarations.filter(i=>o.o(i.initializer)&&i.initializer.kind===e.SyntaxKind.ArrowFunction).map(i=>i.initializer):[],l=n=>{const i=e.createSourceFile("temp.ts",n,e.ScriptTarget.ESNext,!0);let t=[];return i.forEachChild(r=>{(r.kind===e.SyntaxKind.FunctionDeclaration||r.kind===e.SyntaxKind.VariableStatement)&&d(r).forEach(a=>{t=s(a,t)})}),t};exports.getFunctionInputSchema=l;

package/dist/{get-function-input-schema-BZ7_XyUh-CKgoFzji.mjs → get-function-input-schema-BZ7_XyUh-PnCntsct.mjs}

@@ -1,5 +1,5 @@
 import { createSourceFile as p, ScriptTarget as l, SyntaxKind as t } from "typescript";
-import { o } from "./uninstall-Bw-TK4rL.mjs";
+import { t as o } from "./uninstall-DAf2XiS3.mjs";
 const c = (r) => {
   switch (r.kind) {
     case t.NumberKeyword:

package/dist/logic-function/index.cjs

@@ -1,2 +1,2 @@
-"use strict";
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class c extends Error{constructor(e){super(`App connection ${e} requires the user to reconnect (authFailedAt is set). Surface a "Reconnect" prompt in your UI.`),this.name="AppConnectionAuthFailedError",this.connectionId=e}}const r="TWENTY_API_URL",i="TWENTY_APP_ACCESS_TOKEN",a=async(n,e)=>{const s=process.env[r],t=process.env[i];if(!s||!t)throw new Error(`${n==="list"?"listConnections":"getConnection"}() requires the app runtime env vars ${r} and ${i}.`);const o=await fetch(`${s}/apps/connections/${n}`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t}`},body:JSON.stringify(e)});if(!o.ok)throw new Error(`${n==="list"?"listConnections":"getConnection"}() failed: HTTP ${o.status} ${o.statusText}`);return await o.json()},u=async n=>{const e=await a("get",{id:n});if(e.authFailedAt!==null)throw new c(e.id);return e},p=async(n={})=>a("list",n),l=(n,e)=>{if(e.userWorkspaceId!==null){const t=n.find(o=>o.visibility==="user"&&o.userWorkspaceId===e.userWorkspaceId);if(t)return t}return n.find(t=>t.visibility==="workspace")??null};exports.AppConnectionAuthFailedError=c;exports.findConnectionForRequest=l;exports.getConnection=u;exports.listConnections=p;
 //# sourceMappingURL=index.cjs.map

package/dist/logic-function/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.cjs","sources":["../../src/sdk/logic-function/connections/errors/app-connection-auth-failed.error.ts","../../../twenty-shared/dist/application.mjs","../../src/sdk/logic-function/connections/utils/post-connections-endpoint.util.ts","../../src/sdk/logic-function/connections/get-connection.ts","../../src/sdk/logic-function/connections/list-connections.ts","../../src/sdk/logic-function/connections/find-connection-for-request.ts"],"sourcesContent":["// Thrown when the platform asks the SDK to operate on a connection whose\n// OAuth refresh failed permanently (`authFailedAt` is set). The end user\n// must reconnect from the app's settings tab — the app cannot recover on\n// its own.\n//\n// `listConnections` filters these out by default (the user can't act on\n// them anyway). `getConnection` throws this when the looked-up connection\n// is in this state, so a stored connection id can be safely retried until\n// it works again.\nexport class AppConnectionAuthFailedError extends Error {\n  readonly connectionId: string;\n\n  constructor(connectionId: string) {\n    super(\n      `App connection ${connectionId} requires the user to reconnect ` +\n        `(authFailedAt is set). Surface a \"Reconnect\" prompt in your UI.`,\n    );\n    this.name = 'AppConnectionAuthFailedError';\n    this.connectionId = connectionId;\n  }\n}\n","const _ = \"public\", A = \"TWENTY_API_KEY\", T = \"TWENTY_API_URL\", r = \"TWENTY_APP_ACCESS_TOKEN\", t = \"generated\", N = {\n  js: `import { createRequire as __createRequire } from 'module';\nconst require = __createRequire(import.meta.url);`\n}, u = \".twenty/output\", I = \"Standard\", n = \"20202020-64aa-4b6f-b003-9c74b97cee20\";\nvar e = /* @__PURE__ */ ((o) => (o.Object = \"object\", o.Field = \"field\", o.LogicFunction = \"logicFunction\", o.FrontComponent = \"frontComponent\", o.Role = \"role\", o.Skill = \"skill\", o.Agent = \"agent\", o.ConnectionProvider = \"connectionProvider\", o.View = \"view\", o.NavigationMenuItem = \"navigationMenuItem\", o.PageLayout = \"pageLayout\", o.PageLayoutTab = \"pageLayoutTab\", o.CommandMenuItem = \"commandMenuItem\", o))(e || {});\nexport {\n  _ as ASSETS_DIR,\n  A as DEFAULT_API_KEY_NAME,\n  T as DEFAULT_API_URL_NAME,\n  r as DEFAULT_APP_ACCESS_TOKEN_NAME,\n  t as GENERATED_DIR,\n  N as NODE_ESM_CJS_BANNER,\n  u as OUTPUT_DIR,\n  e as SyncableEntity,\n  I as TWENTY_STANDARD_APPLICATION_NAME,\n  n as TWENTY_STANDARD_APPLICATION_UNIVERSAL_IDENTIFIER\n};\n","import {\n  DEFAULT_API_URL_NAME,\n  DEFAULT_APP_ACCESS_TOKEN_NAME,\n} from 'twenty-shared/application';\n\n// Shared transport for `/apps/connections/*` endpoints. Centralises the\n// env-var check, auth header, and HTTP error translation so each helper\n// stays focused on its own input/output shape.\nexport const postConnectionsEndpoint = async <TBody, TResponse>(\n  path: 'list' | 'get',\n  body: TBody,\n): Promise<TResponse> => {\n  const apiUrl = process.env[DEFAULT_API_URL_NAME];\n  const accessToken = process.env[DEFAULT_APP_ACCESS_TOKEN_NAME];\n\n  if (!apiUrl || !accessToken) {\n    throw new Error(\n      `${path === 'list' ? 'listConnections' : 'getConnection'}() requires the app runtime env vars ` +\n        `${DEFAULT_API_URL_NAME} and ${DEFAULT_APP_ACCESS_TOKEN_NAME}.`,\n    );\n  }\n\n  const response = await fetch(`${apiUrl}/apps/connections/${path}`, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `${path === 'list' ? 'listConnections' : 'getConnection'}() failed: ` +\n        `HTTP ${response.status} ${response.statusText}`,\n    );\n  }\n\n  return (await response.json()) as TResponse;\n};\n","import { AppConnectionAuthFailedError } from '@/sdk/logic-function/connections/errors/app-connection-auth-failed.error';\nimport { type AppConnection } from '@/sdk/logic-function/connections/types/app-connection.type';\nimport { postConnectionsEndpoint } from '@/sdk/logic-function/connections/utils/post-connections-endpoint.util';\n\n// Look up a single connection by id. The id is stable across reconnects\n// (the row keeps its id when the user clicks \"Reconnect\"), so apps can\n// safely persist it in their own data and call this helper on each\n// invocation to retrieve a fresh access token.\n//\n// Throws `AppConnectionAuthFailedError` if the credential is in a\n// permanent-failure state (the user must reconnect from the app's\n// settings tab). Throws a regular `Error` for any other failure\n// (network, not-found, transient refresh failure).\nexport const getConnection = async (id: string): Promise<AppConnection> => {\n  const connection = await postConnectionsEndpoint<\n    { id: string },\n    AppConnection\n  >('get', { id });\n\n  if (connection.authFailedAt !== null) {\n    throw new AppConnectionAuthFailedError(connection.id);\n  }\n\n  return connection;\n};\n","import { type AppConnection } from '@/sdk/logic-function/connections/types/app-connection.type';\nimport { postConnectionsEndpoint } from '@/sdk/logic-function/connections/utils/post-connections-endpoint.util';\n\nexport type ListConnectionsFilter = {\n  // Provider name as declared on `defineConnectionProvider({ name })`.\n  providerName?: string;\n  // Restrict to credentials owned by a specific user. Useful in cron\n  // triggers when picking a service-account user via app config.\n  userWorkspaceId?: string;\n  // Restrict by row visibility — 'user' (private) or 'workspace' (shared).\n  visibility?: 'user' | 'workspace';\n};\n\n// Returns every connection owned by the running app, optionally filtered.\n// The server refreshes each access token on read, so the returned values\n// are usable immediately. When the running execution carries a user\n// context (HTTP-route trigger with `isAuthRequired`, tool calls, etc.),\n// `scope: 'user'` connections belonging to other users are filtered out\n// server-side. Cron and database-event triggers see all connections.\nexport const listConnections = async (\n  filter: ListConnectionsFilter = {},\n): Promise<AppConnection[]> =>\n  postConnectionsEndpoint<ListConnectionsFilter, AppConnection[]>(\n    'list',\n    filter,\n  );\n","import { type AppConnection } from '@/sdk/logic-function/connections/types/app-connection.type';\n\n// Resolution rule for an HTTP-route handler that wants \"the request user's\n// connection, or fall back to a workspace-shared one.\" Pure function — no\n// network. Pass it the result of `listConnections` and the trigger event.\n//\n// The plan-of-record for picking a connection is documented in the v3 plan\n// notes; this utility encodes the most common case so handlers don't have\n// to repeat the same `find(...) ?? find(...)` chain.\n//\n// Returns `null` when no candidate exists — caller decides whether that's\n// a 4xx for the end user or a hard error.\nexport const findConnectionForRequest = (\n  connections: AppConnection[],\n  event: { userWorkspaceId: string | null },\n): AppConnection | null => {\n  // 1. Personal credential of the request user (highest specificity).\n  if (event.userWorkspaceId !== null) {\n    const personal = connections.find(\n      (connection) =>\n        connection.visibility === 'user' &&\n        connection.userWorkspaceId === event.userWorkspaceId,\n    );\n\n    if (personal) {\n      return personal;\n    }\n  }\n\n  // 2. Any workspace-shared credential (team-managed service account).\n  const workspaceShared = connections.find(\n    (connection) => connection.visibility === 'workspace',\n  );\n\n  return workspaceShared ?? null;\n};\n"],"names":["AppConnectionAuthFailedError","connectionId","T","r","postConnectionsEndpoint","path","body","apiUrl","DEFAULT_API_URL_NAME","accessToken","DEFAULT_APP_ACCESS_TOKEN_NAME","response","getConnection","id","connection","listConnections","filter","findConnectionForRequest","connections","event","personal"],"mappings":"gFASO,MAAMA,UAAqC,KAAM,CAGtD,YAAYC,EAAsB,CAChC,MACE,kBAAkBA,CAAY,iGAAA,EAGhC,KAAK,KAAO,+BACZ,KAAK,aAAeA,CACtB,CACF,CCpBK,MAAqCC,EAAI,iBAAkBC,EAAI,0BCQvDC,EAA0B,MACrCC,EACAC,IACuB,CACvB,MAAMC,EAAS,QAAQ,IAAIC,CAAoB,EACzCC,EAAc,QAAQ,IAAIC,CAA6B,EAE7D,GAAI,CAACH,GAAU,CAACE,EACd,MAAM,IAAI,MACR,GAAGJ,IAAS,OAAS,kBAAoB,eAAe,wCACnDG,CAAoB,QAAQE,CAA6B,GAAA,EAIlE,MAAMC,EAAW,MAAM,MAAM,GAAGJ,CAAM,qBAAqBF,CAAI,GAAI,CACjE,OAAQ,OACR,QAAS,CACP,eAAgB,mBAChB,cAAe,UAAUI,CAAW,EAAA,EAEtC,KAAM,KAAK,UAAUH,CAAI,CAAA,CAC1B,EAED,GAAI,CAACK,EAAS,GACZ,MAAM,IAAI,MACR,GAAGN,IAAS,OAAS,kBAAoB,eAAe,mBAC9CM,EAAS,MAAM,IAAIA,EAAS,UAAU,EAAA,EAIpD,OAAQ,MAAMA,EAAS,KAAA,CACzB,EC1BaC,EAAgB,MAAOC,GAAuC,CACzE,MAAMC,EAAa,MAAMV,EAGvB,MAAO,CAAE,GAAAS,EAAI,EAEf,GAAIC,EAAW,eAAiB,KAC9B,MAAM,IAAId,EAA6Bc,EAAW,EAAE,EAGtD,OAAOA,CACT,ECLaC,EAAkB,MAC7BC,EAAgC,CAAA,IAEhCZ,EACE,OACAY,CACF,ECbWC,EAA2B,CACtCC,EACAC,IACyB,CAEzB,GAAIA,EAAM,kBAAoB,KAAM,CAClC,MAAMC,EAAWF,EAAY,KAC1BJ,GACCA,EAAW,aAAe,QAC1BA,EAAW,kBAAoBK,EAAM,eAAA,EAGzC,GAAIC,EACF,OAAOA,CAEX,CAOA,OAJwBF,EAAY,KACjCJ,GAAeA,EAAW,aAAe,WAAA,GAGlB,IAC5B"}

package/dist/logic-function/index.d.ts

@@ -2,6 +2,46 @@ type SyncableEntityOptions = {
     universalIdentifier: string;
 };
 
+type AppConnection = {
+    id: string;
+    providerName: string;
+    name: string;
+    handle: string;
+    visibility: 'user' | 'workspace';
+    userWorkspaceId: string;
+    accessToken: string;
+    scopes: string[];
+    authFailedAt: string | null;
+};
+
+declare enum FieldMetadataType {
+    ACTOR = "ACTOR",
+    ADDRESS = "ADDRESS",
+    ARRAY = "ARRAY",
+    BOOLEAN = "BOOLEAN",
+    CURRENCY = "CURRENCY",
+    DATE = "DATE",
+    DATE_TIME = "DATE_TIME",
+    EMAILS = "EMAILS",
+    FILES = "FILES",
+    FULL_NAME = "FULL_NAME",
+    LINKS = "LINKS",
+    MORPH_RELATION = "MORPH_RELATION",
+    MULTI_SELECT = "MULTI_SELECT",
+    NUMBER = "NUMBER",
+    NUMERIC = "NUMERIC",
+    PHONES = "PHONES",
+    POSITION = "POSITION",
+    RATING = "RATING",
+    RAW_JSON = "RAW_JSON",
+    RELATION = "RELATION",
+    RICH_TEXT = "RICH_TEXT",
+    SELECT = "SELECT",
+    TEXT = "TEXT",
+    TS_VECTOR = "TS_VECTOR",
+    UUID = "UUID"
+}
+
 declare enum HTTPMethod {
     GET = "GET",
     POST = "POST",
@@ -10,32 +50,20 @@ declare enum HTTPMethod {
     DELETE = "DELETE"
 }
 
-/**
- * AWS HTTP API v2 compatible request format for logic functions
- * @see https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-lambda.html
- *
- * @typeParam TBody - The type of the request body. Defaults to `object` for parsed JSON bodies.
- */
 type LogicFunctionEvent<TBody = object> = {
-    /** HTTP headers (filtered by forwardedRequestHeaders in route trigger) */
     headers: Record<string, string | undefined>;
-    /** Query string parameters (multiple values are joined with commas, e.g., "1,2,3") */
     queryStringParameters: Record<string, string | undefined>;
-    /** Path parameters extracted from the route pattern (e.g., /users/:id → { id: '123' }). Multiple values are joined with commas. */
     pathParameters: Record<string, string | undefined>;
-    /** Request body */
     body: TBody | null;
-    /** Whether the body is base64 encoded */
+    rawBody?: string;
     isBase64Encoded: boolean;
-    /** Request context containing HTTP method, path, and other metadata */
     requestContext: {
         http: {
-            /** HTTP method (GET, POST, PUT, PATCH, DELETE) */
             method: string;
-            /** Raw request path (e.g., /users/123) */
             path: string;
         };
     };
+    userWorkspaceId: string | null;
 };
 
 type InputJsonSchema = {
@@ -50,6 +78,32 @@ type InputJsonSchema = {
     maximum?: number;
 };
 
+type ToolTriggerSettings = {
+    inputSchema?: InputJsonSchema;
+};
+
+type LeafType = 'string' | 'number' | 'boolean' | 'array' | 'unknown';
+type NodeType = 'object' | 'unknown';
+
+type InputSchemaPropertyType = LeafType | NodeType | FieldMetadataType;
+type InputSchemaProperty = {
+    type: InputSchemaPropertyType;
+    enum?: string[];
+    items?: InputSchemaProperty;
+    properties?: Properties$1;
+};
+type Properties$1 = {
+    [name: string]: InputSchemaProperty;
+};
+type InputSchema = InputSchemaProperty[];
+
+type WorkflowActionTriggerSettings = {
+    inputSchema?: InputSchema;
+    outputSchema?: InputSchema;
+    icon?: string;
+    label?: string;
+};
+
 type LogicFunctionManifest = SyncableEntityOptions & {
     name?: string;
     description?: string;
@@ -57,12 +111,12 @@ type LogicFunctionManifest = SyncableEntityOptions & {
     cronTriggerSettings?: CronTriggerSettings;
     databaseEventTriggerSettings?: DatabaseEventTriggerSettings;
     httpRouteTriggerSettings?: HttpRouteTriggerSettings;
+    toolTriggerSettings?: ToolTriggerSettings;
+    workflowActionTriggerSettings?: WorkflowActionTriggerSettings;
     sourceHandlerPath: string;
     builtHandlerPath: string;
     builtHandlerChecksum: string;
     handlerName: string;
-    toolInputSchema: InputJsonSchema;
-    isTool?: boolean;
 };
 type CronTriggerSettings = {
     pattern: string;
@@ -79,9 +133,8 @@ type HttpRouteTriggerSettings = {
 };
 
 type LogicFunctionHandler = (...args: any[]) => any | Promise<any>;
-type LogicFunctionConfig = Omit<LogicFunctionManifest, 'sourceHandlerPath' | 'builtHandlerPath' | 'builtHandlerChecksum' | 'handlerName' | 'toolInputSchema'> & {
+type LogicFunctionConfig = Omit<LogicFunctionManifest, 'sourceHandlerPath' | 'builtHandlerPath' | 'builtHandlerChecksum' | 'handlerName'> & {
     handler: LogicFunctionHandler;
-    toolInputSchema?: InputJsonSchema;
 };
 
 type InstallPayload = {
@@ -211,5 +264,23 @@ type WorkspaceEventBatch<WorkspaceEvent> = {
 };
 type DatabaseEventPayload<T = ObjectRecordEvent> = Omit<WorkspaceEventBatch<T>, 'events'> & T;
 
-export { ObjectRecordBaseEvent, ObjectRecordCreateEvent, ObjectRecordDeleteEvent, ObjectRecordDestroyEvent, ObjectRecordRestoreEvent, ObjectRecordUpdateEvent, ObjectRecordUpsertEvent };
-export type { CronPayload, DatabaseEventPayload, InputJsonSchema, InstallHandler, InstallPayload, LogicFunctionConfig, LogicFunctionHandler, ObjectRecordEvent, LogicFunctionEvent as RoutePayload };
+declare const getConnection: (id: string) => Promise<AppConnection>;
+
+type ListConnectionsFilter = {
+    providerName?: string;
+    userWorkspaceId?: string;
+    visibility?: 'user' | 'workspace';
+};
+declare const listConnections: (filter?: ListConnectionsFilter) => Promise<AppConnection[]>;
+
+declare const findConnectionForRequest: (connections: AppConnection[], event: {
+    userWorkspaceId: string | null;
+}) => AppConnection | null;
+
+declare class AppConnectionAuthFailedError extends Error {
+    readonly connectionId: string;
+    constructor(connectionId: string);
+}
+
+export { AppConnectionAuthFailedError, ObjectRecordBaseEvent, ObjectRecordCreateEvent, ObjectRecordDeleteEvent, ObjectRecordDestroyEvent, ObjectRecordRestoreEvent, ObjectRecordUpdateEvent, ObjectRecordUpsertEvent, findConnectionForRequest, getConnection, listConnections };
+export type { AppConnection, CronPayload, DatabaseEventPayload, InputJsonSchema, InstallHandler, InstallPayload, ListConnectionsFilter, LogicFunctionConfig, LogicFunctionHandler, ObjectRecordEvent, LogicFunctionEvent as RoutePayload };

package/dist/logic-function/index.mjs

@@ -1,2 +1,53 @@
-
+class a extends Error {
+  constructor(e) {
+    super(
+      `App connection ${e} requires the user to reconnect (authFailedAt is set). Surface a "Reconnect" prompt in your UI.`
+    ), this.name = "AppConnectionAuthFailedError", this.connectionId = e;
+  }
+}
+const r = "TWENTY_API_URL", i = "TWENTY_APP_ACCESS_TOKEN", c = async (n, e) => {
+  const s = process.env[r], t = process.env[i];
+  if (!s || !t)
+    throw new Error(
+      `${n === "list" ? "listConnections" : "getConnection"}() requires the app runtime env vars ${r} and ${i}.`
+    );
+  const o = await fetch(`${s}/apps/connections/${n}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${t}`
+    },
+    body: JSON.stringify(e)
+  });
+  if (!o.ok)
+    throw new Error(
+      `${n === "list" ? "listConnections" : "getConnection"}() failed: HTTP ${o.status} ${o.statusText}`
+    );
+  return await o.json();
+}, p = async (n) => {
+  const e = await c("get", { id: n });
+  if (e.authFailedAt !== null)
+    throw new a(e.id);
+  return e;
+}, u = async (n = {}) => c(
+  "list",
+  n
+), l = (n, e) => {
+  if (e.userWorkspaceId !== null) {
+    const t = n.find(
+      (o) => o.visibility === "user" && o.userWorkspaceId === e.userWorkspaceId
+    );
+    if (t)
+      return t;
+  }
+  return n.find(
+    (t) => t.visibility === "workspace"
+  ) ?? null;
+};
+export {
+  a as AppConnectionAuthFailedError,
+  l as findConnectionForRequest,
+  p as getConnection,
+  u as listConnections
+};
 //# sourceMappingURL=index.mjs.map

package/dist/logic-function/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.mjs","sources":["../../src/sdk/logic-function/connections/errors/app-connection-auth-failed.error.ts","../../../twenty-shared/dist/application.mjs","../../src/sdk/logic-function/connections/utils/post-connections-endpoint.util.ts","../../src/sdk/logic-function/connections/get-connection.ts","../../src/sdk/logic-function/connections/list-connections.ts","../../src/sdk/logic-function/connections/find-connection-for-request.ts"],"sourcesContent":["// Thrown when the platform asks the SDK to operate on a connection whose\n// OAuth refresh failed permanently (`authFailedAt` is set). The end user\n// must reconnect from the app's settings tab — the app cannot recover on\n// its own.\n//\n// `listConnections` filters these out by default (the user can't act on\n// them anyway). `getConnection` throws this when the looked-up connection\n// is in this state, so a stored connection id can be safely retried until\n// it works again.\nexport class AppConnectionAuthFailedError extends Error {\n  readonly connectionId: string;\n\n  constructor(connectionId: string) {\n    super(\n      `App connection ${connectionId} requires the user to reconnect ` +\n        `(authFailedAt is set). Surface a \"Reconnect\" prompt in your UI.`,\n    );\n    this.name = 'AppConnectionAuthFailedError';\n    this.connectionId = connectionId;\n  }\n}\n","const _ = \"public\", A = \"TWENTY_API_KEY\", T = \"TWENTY_API_URL\", r = \"TWENTY_APP_ACCESS_TOKEN\", t = \"generated\", N = {\n  js: `import { createRequire as __createRequire } from 'module';\nconst require = __createRequire(import.meta.url);`\n}, u = \".twenty/output\", I = \"Standard\", n = \"20202020-64aa-4b6f-b003-9c74b97cee20\";\nvar e = /* @__PURE__ */ ((o) => (o.Object = \"object\", o.Field = \"field\", o.LogicFunction = \"logicFunction\", o.FrontComponent = \"frontComponent\", o.Role = \"role\", o.Skill = \"skill\", o.Agent = \"agent\", o.ConnectionProvider = \"connectionProvider\", o.View = \"view\", o.NavigationMenuItem = \"navigationMenuItem\", o.PageLayout = \"pageLayout\", o.PageLayoutTab = \"pageLayoutTab\", o.CommandMenuItem = \"commandMenuItem\", o))(e || {});\nexport {\n  _ as ASSETS_DIR,\n  A as DEFAULT_API_KEY_NAME,\n  T as DEFAULT_API_URL_NAME,\n  r as DEFAULT_APP_ACCESS_TOKEN_NAME,\n  t as GENERATED_DIR,\n  N as NODE_ESM_CJS_BANNER,\n  u as OUTPUT_DIR,\n  e as SyncableEntity,\n  I as TWENTY_STANDARD_APPLICATION_NAME,\n  n as TWENTY_STANDARD_APPLICATION_UNIVERSAL_IDENTIFIER\n};\n","import {\n  DEFAULT_API_URL_NAME,\n  DEFAULT_APP_ACCESS_TOKEN_NAME,\n} from 'twenty-shared/application';\n\n// Shared transport for `/apps/connections/*` endpoints. Centralises the\n// env-var check, auth header, and HTTP error translation so each helper\n// stays focused on its own input/output shape.\nexport const postConnectionsEndpoint = async <TBody, TResponse>(\n  path: 'list' | 'get',\n  body: TBody,\n): Promise<TResponse> => {\n  const apiUrl = process.env[DEFAULT_API_URL_NAME];\n  const accessToken = process.env[DEFAULT_APP_ACCESS_TOKEN_NAME];\n\n  if (!apiUrl || !accessToken) {\n    throw new Error(\n      `${path === 'list' ? 'listConnections' : 'getConnection'}() requires the app runtime env vars ` +\n        `${DEFAULT_API_URL_NAME} and ${DEFAULT_APP_ACCESS_TOKEN_NAME}.`,\n    );\n  }\n\n  const response = await fetch(`${apiUrl}/apps/connections/${path}`, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `${path === 'list' ? 'listConnections' : 'getConnection'}() failed: ` +\n        `HTTP ${response.status} ${response.statusText}`,\n    );\n  }\n\n  return (await response.json()) as TResponse;\n};\n","import { AppConnectionAuthFailedError } from '@/sdk/logic-function/connections/errors/app-connection-auth-failed.error';\nimport { type AppConnection } from '@/sdk/logic-function/connections/types/app-connection.type';\nimport { postConnectionsEndpoint } from '@/sdk/logic-function/connections/utils/post-connections-endpoint.util';\n\n// Look up a single connection by id. The id is stable across reconnects\n// (the row keeps its id when the user clicks \"Reconnect\"), so apps can\n// safely persist it in their own data and call this helper on each\n// invocation to retrieve a fresh access token.\n//\n// Throws `AppConnectionAuthFailedError` if the credential is in a\n// permanent-failure state (the user must reconnect from the app's\n// settings tab). Throws a regular `Error` for any other failure\n// (network, not-found, transient refresh failure).\nexport const getConnection = async (id: string): Promise<AppConnection> => {\n  const connection = await postConnectionsEndpoint<\n    { id: string },\n    AppConnection\n  >('get', { id });\n\n  if (connection.authFailedAt !== null) {\n    throw new AppConnectionAuthFailedError(connection.id);\n  }\n\n  return connection;\n};\n","import { type AppConnection } from '@/sdk/logic-function/connections/types/app-connection.type';\nimport { postConnectionsEndpoint } from '@/sdk/logic-function/connections/utils/post-connections-endpoint.util';\n\nexport type ListConnectionsFilter = {\n  // Provider name as declared on `defineConnectionProvider({ name })`.\n  providerName?: string;\n  // Restrict to credentials owned by a specific user. Useful in cron\n  // triggers when picking a service-account user via app config.\n  userWorkspaceId?: string;\n  // Restrict by row visibility — 'user' (private) or 'workspace' (shared).\n  visibility?: 'user' | 'workspace';\n};\n\n// Returns every connection owned by the running app, optionally filtered.\n// The server refreshes each access token on read, so the returned values\n// are usable immediately. When the running execution carries a user\n// context (HTTP-route trigger with `isAuthRequired`, tool calls, etc.),\n// `scope: 'user'` connections belonging to other users are filtered out\n// server-side. Cron and database-event triggers see all connections.\nexport const listConnections = async (\n  filter: ListConnectionsFilter = {},\n): Promise<AppConnection[]> =>\n  postConnectionsEndpoint<ListConnectionsFilter, AppConnection[]>(\n    'list',\n    filter,\n  );\n","import { type AppConnection } from '@/sdk/logic-function/connections/types/app-connection.type';\n\n// Resolution rule for an HTTP-route handler that wants \"the request user's\n// connection, or fall back to a workspace-shared one.\" Pure function — no\n// network. Pass it the result of `listConnections` and the trigger event.\n//\n// The plan-of-record for picking a connection is documented in the v3 plan\n// notes; this utility encodes the most common case so handlers don't have\n// to repeat the same `find(...) ?? find(...)` chain.\n//\n// Returns `null` when no candidate exists — caller decides whether that's\n// a 4xx for the end user or a hard error.\nexport const findConnectionForRequest = (\n  connections: AppConnection[],\n  event: { userWorkspaceId: string | null },\n): AppConnection | null => {\n  // 1. Personal credential of the request user (highest specificity).\n  if (event.userWorkspaceId !== null) {\n    const personal = connections.find(\n      (connection) =>\n        connection.visibility === 'user' &&\n        connection.userWorkspaceId === event.userWorkspaceId,\n    );\n\n    if (personal) {\n      return personal;\n    }\n  }\n\n  // 2. Any workspace-shared credential (team-managed service account).\n  const workspaceShared = connections.find(\n    (connection) => connection.visibility === 'workspace',\n  );\n\n  return workspaceShared ?? null;\n};\n"],"names":["AppConnectionAuthFailedError","connectionId","T","r","postConnectionsEndpoint","path","body","apiUrl","DEFAULT_API_URL_NAME","accessToken","DEFAULT_APP_ACCESS_TOKEN_NAME","response","getConnection","id","connection","listConnections","filter","findConnectionForRequest","connections","event","personal"],"mappings":"AASO,MAAMA,UAAqC,MAAM;AAAA,EAGtD,YAAYC,GAAsB;AAChC;AAAA,MACE,kBAAkBA,CAAY;AAAA,IAAA,GAGhC,KAAK,OAAO,gCACZ,KAAK,eAAeA;AAAA,EACtB;AACF;ACpBK,MAAqCC,IAAI,kBAAkBC,IAAI,2BCQvDC,IAA0B,OACrCC,GACAC,MACuB;AACvB,QAAMC,IAAS,QAAQ,IAAIC,CAAoB,GACzCC,IAAc,QAAQ,IAAIC,CAA6B;AAE7D,MAAI,CAACH,KAAU,CAACE;AACd,UAAM,IAAI;AAAA,MACR,GAAGJ,MAAS,SAAS,oBAAoB,eAAe,wCACnDG,CAAoB,QAAQE,CAA6B;AAAA,IAAA;AAIlE,QAAMC,IAAW,MAAM,MAAM,GAAGJ,CAAM,qBAAqBF,CAAI,IAAI;AAAA,IACjE,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,eAAe,UAAUI,CAAW;AAAA,IAAA;AAAA,IAEtC,MAAM,KAAK,UAAUH,CAAI;AAAA,EAAA,CAC1B;AAED,MAAI,CAACK,EAAS;AACZ,UAAM,IAAI;AAAA,MACR,GAAGN,MAAS,SAAS,oBAAoB,eAAe,mBAC9CM,EAAS,MAAM,IAAIA,EAAS,UAAU;AAAA,IAAA;AAIpD,SAAQ,MAAMA,EAAS,KAAA;AACzB,GC1BaC,IAAgB,OAAOC,MAAuC;AACzE,QAAMC,IAAa,MAAMV,EAGvB,OAAO,EAAE,IAAAS,GAAI;AAEf,MAAIC,EAAW,iBAAiB;AAC9B,UAAM,IAAId,EAA6Bc,EAAW,EAAE;AAGtD,SAAOA;AACT,GCLaC,IAAkB,OAC7BC,IAAgC,CAAA,MAEhCZ;AAAA,EACE;AAAA,EACAY;AACF,GCbWC,IAA2B,CACtCC,GACAC,MACyB;AAEzB,MAAIA,EAAM,oBAAoB,MAAM;AAClC,UAAMC,IAAWF,EAAY;AAAA,MAC3B,CAACJ,MACCA,EAAW,eAAe,UAC1BA,EAAW,oBAAoBK,EAAM;AAAA,IAAA;AAGzC,QAAIC;AACF,aAAOA;AAAA,EAEX;AAOA,SAJwBF,EAAY;AAAA,IAClC,CAACJ,MAAeA,EAAW,eAAe;AAAA,EAAA,KAGlB;AAC5B;"}

package/dist/operations.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./uninstall-CYiYoBPe.js"),a=async t=>(t?.remote&&e.ConfigService.setActiveRemote(t.remote),await new e.ConfigService().clearConfig(),{success:!0,data:void 0}),n=t=>e.runSafe(()=>a(t),e.AUTH_ERROR_CODES.AUTH_FAILED);exports.APP_ERROR_CODES=e.APP_ERROR_CODES;exports.AUTH_ERROR_CODES=e.AUTH_ERROR_CODES;exports.ConfigService=e.ConfigService;exports.FUNCTION_ERROR_CODES=e.FUNCTION_ERROR_CODES;exports.SERVER_ERROR_CODES=e.SERVER_ERROR_CODES;exports.appBuild=e.appBuild;exports.appDeploy=e.appDeploy;exports.appDevOnce=e.appDevOnce;exports.appInstall=e.appInstall;exports.appPublish=e.appPublish;exports.appUninstall=e.appUninstall;exports.authLogin=e.authLogin;exports.authLoginOAuth=e.authLoginOAuth;exports.detectLocalServer=e.detectLocalServer;exports.functionExecute=e.functionExecute;exports.serverStart=e.serverStart;exports.authLogout=n;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./uninstall-BiLmSWhb.js"),n=async t=>(t?.remote&&e.ConfigService.setActiveRemote(t.remote),await new e.ConfigService().clearConfig(),{success:!0,data:void 0}),i=t=>e.runSafe(()=>n(t),e.AUTH_ERROR_CODES.AUTH_FAILED);exports.APP_ERROR_CODES=e.APP_ERROR_CODES;exports.AUTH_ERROR_CODES=e.AUTH_ERROR_CODES;exports.ConfigService=e.ConfigService;exports.FUNCTION_ERROR_CODES=e.FUNCTION_ERROR_CODES;exports.SERVER_ERROR_CODES=e.SERVER_ERROR_CODES;exports.appBuild=e.appBuild;exports.appDeploy=e.appDeploy;exports.appDevOnce=e.appDevOnce;exports.appInstall=e.appInstall;exports.appPublish=e.appPublish;exports.appUninstall=e.appUninstall;exports.authLogin=e.authLogin;exports.authLoginOAuth=e.authLoginOAuth;exports.checkDockerRunning=e.checkDockerRunning;exports.containerExists=e.containerExists;exports.detectLocalServer=e.detectLocalServer;exports.functionExecute=e.functionExecute;exports.getContainerDigest=e.getContainerDigest;exports.getImageDigest=e.getImageDigest;exports.getImageForVersion=e.getImageForVersion;exports.serverStart=e.serverStart;exports.serverUpgrade=e.serverUpgrade;exports.authLogout=i;

package/dist/operations.mjs

@@ -1,22 +1,28 @@
-import { r as s, A as t, C as e } from "./uninstall-Bw-TK4rL.mjs";
-import { a as u, F as R, S as E, b as S, c as O, d as f, e as g, f as l, g as _, h as v, i as A, j as C, k as h, s as D } from "./uninstall-Bw-TK4rL.mjs";
-const o = async (a) => (a?.remote && e.setActiveRemote(a.remote), await new e().clearConfig(), { success: !0, data: void 0 }), c = (a) => s(() => o(a), t.AUTH_FAILED);
+import { r as s, A as t, C as a } from "./uninstall-DAf2XiS3.mjs";
+import { a as p, F as u, S as R, b as E, c as S, d as O, e as f, f as l, g as D, h as m, i as v, j as C, k as _, l as h, m as A, n as d, o as L, p as I, s as U, q as x } from "./uninstall-DAf2XiS3.mjs";
+const r = async (e) => (e?.remote && a.setActiveRemote(e.remote), await new a().clearConfig(), { success: !0, data: void 0 }), i = (e) => s(() => r(e), t.AUTH_FAILED);
 export {
-  u as APP_ERROR_CODES,
+  p as APP_ERROR_CODES,
   t as AUTH_ERROR_CODES,
-  e as ConfigService,
-  R as FUNCTION_ERROR_CODES,
-  E as SERVER_ERROR_CODES,
-  S as appBuild,
-  O as appDeploy,
-  f as appDevOnce,
-  g as appInstall,
+  a as ConfigService,
+  u as FUNCTION_ERROR_CODES,
+  R as SERVER_ERROR_CODES,
+  E as appBuild,
+  S as appDeploy,
+  O as appDevOnce,
+  f as appInstall,
   l as appPublish,
-  _ as appUninstall,
-  v as authLogin,
-  A as authLoginOAuth,
-  c as authLogout,
-  C as detectLocalServer,
-  h as functionExecute,
-  D as serverStart
+  D as appUninstall,
+  m as authLogin,
+  v as authLoginOAuth,
+  i as authLogout,
+  C as checkDockerRunning,
+  _ as containerExists,
+  h as detectLocalServer,
+  A as functionExecute,
+  d as getContainerDigest,
+  L as getImageDigest,
+  I as getImageForVersion,
+  U as serverStart,
+  x as serverUpgrade
 };