@stackone/connect-sdk 1.12.1 → 1.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.es.mjs +1 -1
- package/dist/index.js +1 -1
- package/dist/types/blocks/createBlock.d.ts +3 -9
- package/dist/types/blocks/createBlockContext.d.ts +11 -0
- package/dist/types/errors/connectSDKErrors.d.ts +6 -4
- package/dist/types/index.d.ts +3 -0
- package/dist/types/runners/runConnectorOperation.d.ts +3 -1
- package/package.json +1 -1
package/dist/index.es.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{StepFunctionsFactory as t,StepFunctionName as e,AUTHENTICATION_SCHEMA as
|
|
1
|
+
import{StepFunctionsFactory as t,StepFunctionName as e,AUTHENTICATION_SCHEMA as r}from"@stackone/core";import{safeEvaluate as o}from"@stackone/expressions";import{notMissing as n,isString as i,isMissing as s}from"@stackone/utils";import{HttpClientManager as a}from"@stackone/transport";import{match as c}from"path-to-regexp";import{parse as p}from"yaml";import{z as u}from"zod";const l=async({block:r,stepFunctionName:o,params:n,buildStepFunction:i=t.build})=>{const s=i({functionName:o}).fn,a=await s({block:r,params:n}),c=o===e.MAP_FIELDS?{[e.MAP_FIELDS.toString()]:{output:{data:a.block.result},errors:a.errors,successful:a.successful}}:{};return{...a.block,steps:{...a?.block?.steps??{},...c}}},d=async({block:e,buildStepFunction:r=t.build})=>{const n=e.operation?.steps||[];let i={...e};const s=Object.keys(n);for(const t of s){const e=n[t].stepFunction,o=r({functionName:e.functionName,version:e.version,validateSchemas:!0}).fn,s=await o({block:i,params:e.params});i={...s.block,steps:{...s.block.steps,[t]:{successful:s.successful,errors:s.errors,output:s.output}}}}const a=e.operation?.result?o(e.operation.result,i):void 0;return{...i,outputs:a}},g=async({inputs:t,context:e,operation:r,credentials:o,logger:n,getHttpClient:i=async()=>a.getInstance()})=>({inputs:t,fieldConfigs:[],context:e,operation:r,credentials:o,httpClient:await i(),logger:n}),y=({category:t,connectorKey:e,connectorVersion:r,authConfigKey:o,environment:n="production",operation:i,accountSecureId:s,projectSecureId:a})=>({projectSecureId:a,accountSecureId:s,connectorKey:e,connectorVersion:r,category:t,service:"",resource:"",schema:i?.schema?.key,operationType:i?.operationType??"unknown",authenticationType:o,environment:n}),m=(t,e,r)=>{const o=r.toUpperCase();if(!t.operations)return;const n=Object.keys(t.operations),i=h(e,o,n);return i?{operation:t.operations?.[i.path],params:i.params}:void 0},f=t=>{const e=t.startsWith("/")?t.slice(1):t;return e.endsWith("/")?e.slice(0,-1):e},h=(t,e,r)=>{const o=f(t);for(const t of r)if(t.startsWith(e)){const r=t.replace(`${e} `,"").trim(),n=c(f(r))(f(o));if(!1!==n)return{path:t,params:n.params}}},b=u.object({key:u.string(),label:u.string(),type:u.string(),required:u.boolean().optional(),secret:u.boolean().optional(),placeholder:u.string().optional(),description:u.string().optional(),tooltip:u.string().optional()}),k=u.object({operationId:u.string(),categories:u.string().array(),operationType:u.string(),schema:u.string().optional(),entrypointUrl:u.string().optional(),entrypointHttpMethod:u.string().optional(),description:u.string(),inputs:u.object({name:u.string(),type:u.string(),required:u.boolean(),description:u.string(),in:u.string()}).array().optional(),fieldConfigs:u.object({targetFieldKey:u.string(),expression:u.string(),type:u.string(),isUnified:u.boolean()}).array(),steps:u.object({stepId:u.string(),description:u.string(),stepFunction:u.object({functionName:u.string(),version:u.string().optional(),parameters:u.record(u.string(),u.unknown())})}).array(),result:u.string()}),I=u.object({StackOne:u.string(),info:u.object({title:u.string(),version:u.string(),key:u.string(),description:u.string().optional()}),baseUrl:u.string(),authentication:u.record(u.string(),u.object({type:u.string(),label:u.string(),authorization:r,environments:u.object({key:u.string(),name:u.string()}).array(),support:u.object({link:u.string(),description:u.string().optional()}),configFields:b.array().optional(),setupFields:b.array().optional(),testOperationsIds:u.string().array().optional()})).array().optional(),operations:k.array().optional()});function v(t){try{const e=p(t),r=I.parse(e),o={title:r.info.title,version:r.info.version,key:r.info.key,description:r.info.description},i=j(r),s={baseUrl:r.baseUrl,authentication:F(i)},a=E(r,s);return o.operations=a,o.authentication=i,n(a)&&(o.categories=S(Object.values(a))),o}catch(t){throw new Error(`Error parsing YAML file: ${t.message}`)}}const F=t=>{const e={};for(const[r,o]of Object.entries(t))if(o&&"object"==typeof o){const{setupFields:t,configFields:n,support:i,testOperationsIds:s,...a}=o;e[r]=F(a)}else e[r]=o;return e},S=t=>{const e=t.reduce(((t,e)=>{for(const r of e.categories)t.add(r);return t}),new Set);return Array.from(e)},j=t=>{const e={};for(const r of t.authentication??[]){const[t]=Object.keys(r),o=r[t].environments.reduce(((e,o)=>{const{key:n,name:i}=o,{environments:s,...a}=r[t];return e[n]={...a,envKey:n,envName:i},e}),{});e[t]=o}return e},E=(t,e)=>{const r=t.operations?.reduce(((t,r)=>{const o=(t=>t.entrypointUrl&&t.entrypointHttpMethod?`${t.entrypointHttpMethod.toUpperCase()} ${t.entrypointUrl}`:void 0)(r),n=(t=>"list"===t.operationType?`GET /${t.schema}`:`GET /${t.schema}/:id`)(r),i=(t=>"list"===t.operationType?`/${t.schema}`:`/${t.schema}/:id`)(r);return t[o??n]={id:r.operationId,categories:r.categories,description:r.description,operationType:r.operationType,entrypointUrl:r.entrypointUrl??i,entrypointHttpMethod:r.entrypointHttpMethod??"get",inputs:r.inputs,steps:r.steps.reduce(((t,o)=>(t[o.stepId]={id:o.stepId,description:o.description,stepFunction:{functionName:o.stepFunction.functionName,version:o.stepFunction.version,params:{..."request"===o.stepFunction.functionName?e:{},..."map_fields"===o.stepFunction.functionName||"typecast"===o.stepFunction.functionName?{fields:r.fieldConfigs}:{},...o.stepFunction.parameters}}},t)),{}),result:r.result},t}),{});return r},O=(t,e)=>{if(!t.inputs)return{};const r=T(t.inputs).parse(e);return{...r.headers??{},...r.query??{},...r.path??{},...r.body??{}}},w=t=>{const e={};return t.forEach((t=>{let r;switch(t.type.toLowerCase()){case"string":r=u.string();break;case"number":r=u.number();break;case"boolean":r=u.boolean();break;default:r=u.any()}e[t.name]=t.required?r:r.optional()})),u.object(e)},T=t=>{const e=t.filter((t=>"path"===t.in)),r=t.filter((t=>"query"===t.in)),o=t.filter((t=>"body"===t.in)),n=t.filter((t=>"headers"===t.in));return u.object({path:w(e).optional(),query:w(r).optional(),body:w(o).optional(),headers:w(n).optional()})};class N extends Error{constructor(t,e,r){super(r),this.name="ConnectSDKError",this.errorType=t,this.context=e,Error.captureStackTrace&&Error.captureStackTrace(this,N)}toString(){return`${this.name} [${this.errorType}]: ${this.message}`}}class C extends N{constructor(t,e){super("CONNECTOR_PARSE_ERROR",t,e),this.name="ConnectorParseError"}}class x extends N{constructor(t,e){super("MISSING_OPERATION_ERROR",t,e),this.name="MissingOperationError"}}class R extends N{constructor(t,e){super("INVALID_OPERATION_INPUTS_ERROR",t,e),this.name="InvalidOperationInputsError"}}const U=async({account:t,connector:e,category:r,path:o,method:n="get",queryParams:a,logger:c,parseConnector:p=v,getOperationFromUrlFn:u=m,parseOperationInputsFn:l=O,createBlockContextFn:f=y,createBlockFn:h=g,runStepOperationFn:b=d})=>{const k=t.authConfigKey,I=t.environment??"production",F=t.secureId,S=t.projectSecureId,j=t.credentials,E=f({category:r,connectorKey:t.providerKey,connectorVersion:t.providerVersion,authConfigKey:k,environment:I,accountSecureId:F,projectSecureId:S});let w;try{w=i(e)?p(e):e}catch{throw new C(E,"Error while parsing connector")}const T=u(w,o,n);if(s(T))throw new x(E,"No matching operation found");let N;E.operationType=T.operation.operationType,E.schema=T.operation.schema?.key;try{N=l(T.operation,{query:a,path:T.params})}catch{throw new R(E,"Error while parsing operation inputs")}const U=await h({inputs:N,context:E,operation:T.operation,credentials:j,logger:c});return await b({block:U})};export{N as ConnectSDKError,g as createBlock,l as executeStepFunction,m as getOperationFromUrl,O as parseOperationInputs,v as parseYamlConnector,U as runConnectorOperation,d as runStepOperation};
|
package/dist/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";var t=require("@stackone/core"),e=require("@stackone/expressions"),
|
|
1
|
+
"use strict";var t=require("@stackone/core"),e=require("@stackone/expressions"),r=require("@stackone/utils"),n=require("@stackone/transport"),o=require("path-to-regexp"),i=require("yaml"),s=require("zod");const a=async({block:r,buildStepFunction:n=t.StepFunctionsFactory.build})=>{const o=r.operation?.steps||[];let i={...r};const s=Object.keys(o);for(const t of s){const e=o[t].stepFunction,r=n({functionName:e.functionName,version:e.version,validateSchemas:!0}).fn,s=await r({block:i,params:e.params});i={...s.block,steps:{...s.block.steps,[t]:{successful:s.successful,errors:s.errors,output:s.output}}}}const a=r.operation?.result?e.safeEvaluate(r.operation.result,i):void 0;return{...i,outputs:a}},c=async({inputs:t,context:e,operation:r,credentials:o,logger:i,getHttpClient:s=async()=>n.HttpClientManager.getInstance()})=>({inputs:t,fieldConfigs:[],context:e,operation:r,credentials:o,httpClient:await s(),logger:i}),p=({category:t,connectorKey:e,connectorVersion:r,authConfigKey:n,environment:o="production",operation:i,accountSecureId:s,projectSecureId:a})=>({projectSecureId:a,accountSecureId:s,connectorKey:e,connectorVersion:r,category:t,service:"",resource:"",schema:i?.schema?.key,operationType:i?.operationType??"unknown",authenticationType:n,environment:o}),u=(t,e,r)=>{const n=r.toUpperCase();if(!t.operations)return;const o=Object.keys(t.operations),i=d(e,n,o);return i?{operation:t.operations?.[i.path],params:i.params}:void 0},l=t=>{const e=t.startsWith("/")?t.slice(1):t;return e.endsWith("/")?e.slice(0,-1):e},d=(t,e,r)=>{const n=l(t);for(const t of r)if(t.startsWith(e)){const r=t.replace(`${e} `,"").trim(),i=o.match(l(r))(l(n));if(!1!==i)return{path:t,params:i.params}}},g=s.z.object({key:s.z.string(),label:s.z.string(),type:s.z.string(),required:s.z.boolean().optional(),secret:s.z.boolean().optional(),placeholder:s.z.string().optional(),description:s.z.string().optional(),tooltip:s.z.string().optional()}),y=s.z.object({operationId:s.z.string(),categories:s.z.string().array(),operationType:s.z.string(),schema:s.z.string().optional(),entrypointUrl:s.z.string().optional(),entrypointHttpMethod:s.z.string().optional(),description:s.z.string(),inputs:s.z.object({name:s.z.string(),type:s.z.string(),required:s.z.boolean(),description:s.z.string(),in:s.z.string()}).array().optional(),fieldConfigs:s.z.object({targetFieldKey:s.z.string(),expression:s.z.string(),type:s.z.string(),isUnified:s.z.boolean()}).array(),steps:s.z.object({stepId:s.z.string(),description:s.z.string(),stepFunction:s.z.object({functionName:s.z.string(),version:s.z.string().optional(),parameters:s.z.record(s.z.string(),s.z.unknown())})}).array(),result:s.z.string()}),m=s.z.object({StackOne:s.z.string(),info:s.z.object({title:s.z.string(),version:s.z.string(),key:s.z.string(),description:s.z.string().optional()}),baseUrl:s.z.string(),authentication:s.z.record(s.z.string(),s.z.object({type:s.z.string(),label:s.z.string(),authorization:t.AUTHENTICATION_SCHEMA,environments:s.z.object({key:s.z.string(),name:s.z.string()}).array(),support:s.z.object({link:s.z.string(),description:s.z.string().optional()}),configFields:g.array().optional(),setupFields:g.array().optional(),testOperationsIds:s.z.string().array().optional()})).array().optional(),operations:y.array().optional()});function z(t){try{const e=i.parse(t),n=m.parse(e),o={title:n.info.title,version:n.info.version,key:n.info.key,description:n.info.description},s=b(n),a={baseUrl:n.baseUrl,authentication:h(s)},c=k(n,a);return o.operations=c,o.authentication=s,r.notMissing(c)&&(o.categories=f(Object.values(c))),o}catch(t){throw new Error(`Error parsing YAML file: ${t.message}`)}}const h=t=>{const e={};for(const[r,n]of Object.entries(t))if(n&&"object"==typeof n){const{setupFields:t,configFields:o,support:i,testOperationsIds:s,...a}=n;e[r]=h(a)}else e[r]=n;return e},f=t=>{const e=t.reduce(((t,e)=>{for(const r of e.categories)t.add(r);return t}),new Set);return Array.from(e)},b=t=>{const e={};for(const r of t.authentication??[]){const[t]=Object.keys(r),n=r[t].environments.reduce(((e,n)=>{const{key:o,name:i}=n,{environments:s,...a}=r[t];return e[o]={...a,envKey:o,envName:i},e}),{});e[t]=n}return e},k=(t,e)=>{const r=t.operations?.reduce(((t,r)=>{const n=(t=>t.entrypointUrl&&t.entrypointHttpMethod?`${t.entrypointHttpMethod.toUpperCase()} ${t.entrypointUrl}`:void 0)(r),o=(t=>"list"===t.operationType?`GET /${t.schema}`:`GET /${t.schema}/:id`)(r),i=(t=>"list"===t.operationType?`/${t.schema}`:`/${t.schema}/:id`)(r);return t[n??o]={id:r.operationId,categories:r.categories,description:r.description,operationType:r.operationType,entrypointUrl:r.entrypointUrl??i,entrypointHttpMethod:r.entrypointHttpMethod??"get",inputs:r.inputs,steps:r.steps.reduce(((t,n)=>(t[n.stepId]={id:n.stepId,description:n.description,stepFunction:{functionName:n.stepFunction.functionName,version:n.stepFunction.version,params:{..."request"===n.stepFunction.functionName?e:{},..."map_fields"===n.stepFunction.functionName||"typecast"===n.stepFunction.functionName?{fields:r.fieldConfigs}:{},...n.stepFunction.parameters}}},t)),{}),result:r.result},t}),{});return r},F=(t,e)=>{if(!t.inputs)return{};const r=I(t.inputs).parse(e);return{...r.headers??{},...r.query??{},...r.path??{},...r.body??{}}},S=t=>{const e={};return t.forEach((t=>{let r;switch(t.type.toLowerCase()){case"string":r=s.z.string();break;case"number":r=s.z.number();break;case"boolean":r=s.z.boolean();break;default:r=s.z.any()}e[t.name]=t.required?r:r.optional()})),s.z.object(e)},I=t=>{const e=t.filter((t=>"path"===t.in)),r=t.filter((t=>"query"===t.in)),n=t.filter((t=>"body"===t.in)),o=t.filter((t=>"headers"===t.in));return s.z.object({path:S(e).optional(),query:S(r).optional(),body:S(n).optional(),headers:S(o).optional()})};class v extends Error{constructor(t,e,r){super(r),this.name="ConnectSDKError",this.errorType=t,this.context=e,Error.captureStackTrace&&Error.captureStackTrace(this,v)}toString(){return`${this.name} [${this.errorType}]: ${this.message}`}}class E extends v{constructor(t,e){super("CONNECTOR_PARSE_ERROR",t,e),this.name="ConnectorParseError"}}class O extends v{constructor(t,e){super("MISSING_OPERATION_ERROR",t,e),this.name="MissingOperationError"}}class j extends v{constructor(t,e){super("INVALID_OPERATION_INPUTS_ERROR",t,e),this.name="InvalidOperationInputsError"}}exports.ConnectSDKError=v,exports.createBlock=c,exports.executeStepFunction=async({block:e,stepFunctionName:r,params:n,buildStepFunction:o=t.StepFunctionsFactory.build})=>{const i=o({functionName:r}).fn,s=await i({block:e,params:n}),a=r===t.StepFunctionName.MAP_FIELDS?{[t.StepFunctionName.MAP_FIELDS.toString()]:{output:{data:s.block.result},errors:s.errors,successful:s.successful}}:{};return{...s.block,steps:{...s?.block?.steps??{},...a}}},exports.getOperationFromUrl=u,exports.parseOperationInputs=F,exports.parseYamlConnector=z,exports.runConnectorOperation=async({account:t,connector:e,category:n,path:o,method:i="get",queryParams:s,logger:l,parseConnector:d=z,getOperationFromUrlFn:g=u,parseOperationInputsFn:y=F,createBlockContextFn:m=p,createBlockFn:h=c,runStepOperationFn:f=a})=>{const b=t.authConfigKey,k=t.environment??"production",S=t.secureId,I=t.projectSecureId,v=t.credentials,C=m({category:n,connectorKey:t.providerKey,connectorVersion:t.providerVersion,authConfigKey:b,environment:k,accountSecureId:S,projectSecureId:I});let N;try{N=r.isString(e)?d(e):e}catch{throw new E(C,"Error while parsing connector")}const T=g(N,o,i);if(r.isMissing(T))throw new O(C,"No matching operation found");let x;C.operationType=T.operation.operationType,C.schema=T.operation.schema?.key;try{x=y(T.operation,{query:s,path:T.params})}catch{throw new j(C,"Error while parsing operation inputs")}const w=await h({inputs:x,context:C,operation:T.operation,credentials:v,logger:l});return await f({block:w})},exports.runStepOperation=a;
|
|
@@ -1,15 +1,9 @@
|
|
|
1
|
-
import { Block,
|
|
1
|
+
import { Block, BlockContext, ILogger, Operation } from '@stackone/core';
|
|
2
2
|
import { IHttpClient } from '@stackone/transport';
|
|
3
|
-
export declare const createBlock: ({ inputs,
|
|
3
|
+
export declare const createBlock: ({ inputs, context, operation, credentials, logger, getHttpClient, }: {
|
|
4
4
|
inputs?: Record<string, unknown>;
|
|
5
|
-
|
|
6
|
-
connectorKey: string;
|
|
7
|
-
connectorVersion: string;
|
|
8
|
-
authConfigKey: string;
|
|
9
|
-
environment?: string;
|
|
5
|
+
context: BlockContext;
|
|
10
6
|
operation: Operation;
|
|
11
|
-
accountSecureId: string;
|
|
12
|
-
projectSecureId: string;
|
|
13
7
|
credentials?: Record<string, unknown>;
|
|
14
8
|
logger?: ILogger;
|
|
15
9
|
getHttpClient?: () => Promise<IHttpClient>;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { BlockContext, Category, Operation } from '@stackone/core';
|
|
2
|
+
export declare const createBlockContext: ({ category, connectorKey, connectorVersion, authConfigKey, environment, operation, accountSecureId, projectSecureId, }: {
|
|
3
|
+
category: Category;
|
|
4
|
+
connectorKey: string;
|
|
5
|
+
connectorVersion: string;
|
|
6
|
+
authConfigKey: string;
|
|
7
|
+
environment?: string;
|
|
8
|
+
operation?: Operation;
|
|
9
|
+
accountSecureId: string;
|
|
10
|
+
projectSecureId: string;
|
|
11
|
+
}) => BlockContext;
|
|
@@ -1,15 +1,17 @@
|
|
|
1
|
+
import { BlockContext } from '@stackone/core';
|
|
1
2
|
import { ErrorType } from './types';
|
|
2
3
|
export declare class ConnectSDKError extends Error {
|
|
3
4
|
readonly errorType: ErrorType;
|
|
4
|
-
|
|
5
|
+
readonly context: BlockContext;
|
|
6
|
+
constructor(errorType: ErrorType, context: BlockContext, message?: string);
|
|
5
7
|
toString(): string;
|
|
6
8
|
}
|
|
7
9
|
export declare class ConnectorParseError extends ConnectSDKError {
|
|
8
|
-
constructor(message?: string);
|
|
10
|
+
constructor(context: BlockContext, message?: string);
|
|
9
11
|
}
|
|
10
12
|
export declare class MissingOperationError extends ConnectSDKError {
|
|
11
|
-
constructor(message?: string);
|
|
13
|
+
constructor(context: BlockContext, message?: string);
|
|
12
14
|
}
|
|
13
15
|
export declare class InvalidOperationInputsError extends ConnectSDKError {
|
|
14
|
-
constructor(message?: string);
|
|
16
|
+
constructor(context: BlockContext, message?: string);
|
|
15
17
|
}
|
package/dist/types/index.d.ts
CHANGED
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
export { executeStepFunction } from './runners/executeStepFunctions';
|
|
2
2
|
export { runStepOperation } from './runners/runStepOperation';
|
|
3
|
+
export { runConnectorOperation } from './runners/runConnectorOperation';
|
|
3
4
|
export { parseYamlConnector, parseOperationInputs } from './connectors/parsers';
|
|
4
5
|
export { createBlock } from './blocks/createBlock';
|
|
5
6
|
export { getOperationFromUrl } from './connectors/operations';
|
|
7
|
+
export { ConnectSDKError } from './errors/connectSDKErrors';
|
|
8
|
+
export { ErrorType } from './errors/types';
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
import { Account, Block, Category, Connector, ILogger } from '@stackone/core';
|
|
2
2
|
import { HttpMethod } from '@stackone/transport';
|
|
3
3
|
import { createBlock } from '../blocks/createBlock';
|
|
4
|
+
import { createBlockContext } from '../blocks/createBlockContext';
|
|
4
5
|
import { getOperationFromUrl } from '../connectors/operations';
|
|
5
6
|
import { parseOperationInputs, parseYamlConnector } from '../connectors/parsers';
|
|
6
7
|
import { runStepOperation } from './runStepOperation';
|
|
7
|
-
export declare const runConnectorOperation: ({ account, connector, category, path, method, queryParams, logger, parseConnector, getOperationFromUrlFn, parseOperationInputsFn, createBlockFn, runStepOperationFn, }: {
|
|
8
|
+
export declare const runConnectorOperation: ({ account, connector, category, path, method, queryParams, logger, parseConnector, getOperationFromUrlFn, parseOperationInputsFn, createBlockContextFn, createBlockFn, runStepOperationFn, }: {
|
|
8
9
|
account: Account;
|
|
9
10
|
connector: Connector | string;
|
|
10
11
|
category: Category;
|
|
@@ -15,6 +16,7 @@ export declare const runConnectorOperation: ({ account, connector, category, pat
|
|
|
15
16
|
parseConnector?: typeof parseYamlConnector;
|
|
16
17
|
getOperationFromUrlFn?: typeof getOperationFromUrl;
|
|
17
18
|
parseOperationInputsFn?: typeof parseOperationInputs;
|
|
19
|
+
createBlockContextFn?: typeof createBlockContext;
|
|
18
20
|
createBlockFn?: typeof createBlock;
|
|
19
21
|
runStepOperationFn?: typeof runStepOperation;
|
|
20
22
|
}) => Promise<Block>;
|