@rockcarver/frodo-lib 0.12.5 → 0.12.7

package/esm/ops/utils/Console.mjs

@@ -11,7 +11,6 @@ import storage from '../../storage/SessionStorage';
  * type="data" will be written to stderr.
  * @param {boolean} [newline=true] Whether to add a newline at the end of message
  * messages returned
- *
  */
 
 export function printMessage(message, type = 'text', newline = true) {
@@ -21,6 +20,22 @@ export function printMessage(message, type = 'text', newline = true) {
     handler(message, type, newline);
   }
 }
+/**
+ * Handles debug output. The caller decides and implements how
+ * the messages are handled, by implementing the handler function
+ * on its side. `handler` is optional, and if not included by the caller,
+ * the data and messages will be lost.
+ *
+ * @param {string | unknown} message The string message to return
+ */
+
+export function debugMessage(message) {
+  const handler = storage.session.getDebugHandler();
+
+  if (handler) {
+    handler(message);
+  }
+}
 /**
  * Calls a callback on client to create a progress indicator.
  * The actual implementation of the indicator is left to the client

package/esm/storage/SessionStorage.mjs

@@ -50,6 +50,10 @@ export default {
     getMasterKeyPath: () => _sessionStorage['masterKeyPath'],
     setPrintHandler: printHandler => _sessionStorage['printHandler'] = printHandler,
     getPrintHandler: () => _sessionStorage['printHandler'],
+    setErrorHandler: errorHandler => _sessionStorage['errorHandler'] = errorHandler,
+    getErrorHandler: () => _sessionStorage['errorHandler'],
+    setDebugHandler: debugHandler => _sessionStorage['debugHandler'] = debugHandler,
+    getDebugHandler: () => _sessionStorage['debugHandler'],
     setCreateProgressHandler: handler => _sessionStorage['createProgressHandler'] = handler,
     getCreateProgressHandler: () => _sessionStorage['createProgressHandler'],
     setUpdateProgressHandler: handler => _sessionStorage['updateProgressHandler'] = handler,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rockcarver/frodo-lib",
-  "version": "0.12.5",
+  "version": "0.12.7",
   "type": "commonjs",
   "main": "./cjs/index.js",
   "module": "./esm/index.mjs",
@@ -16,7 +16,8 @@
     "test": "npx gulp && node --no-warnings --experimental-vm-modules --experimental-specifier-resolution=node node_modules/jest/bin/jest.js --silent",
     "test:debug": "npx gulp && node --no-warnings --experimental-vm-modules --experimental-specifier-resolution=node node_modules/jest/bin/jest.js --verbose=true --silent=false",
     "lint": "npx eslint --ext .ts --ignore-path .gitignore .",
-    "build": "npx gulp"
+    "build": "npx gulp",
+    "watch": "npx gulp watch"
   },
   "jest": {
     "roots": [

package/types/api/ApiTypes.d.ts

@@ -0,0 +1,102 @@
+interface ObjectSkeletonInterface {
+    _id: string;
+    _rev?: number;
+    [k: string]: string | number | ObjectSkeletonInterface;
+}
+export interface UiConfigInterface {
+    categories: string;
+}
+export interface NodeRefSkeletonInterface {
+    connections: Record<string, string>;
+    displayName: string;
+    nodeType: string;
+    x: number;
+    y: number;
+}
+export interface InnerNodeRefSkeletonInterface {
+    _id: string;
+    displayName: string;
+    nodeType: string;
+}
+export declare type TreeSkeleton = ObjectSkeletonInterface & {
+    entryNodeId: string;
+    nodes: Record<string, NodeRefSkeletonInterface>;
+    identityResource?: string;
+    uiConfig?: UiConfigInterface;
+    enabled?: boolean;
+};
+export declare type AmServiceType = ObjectSkeletonInterface & {
+    name: string;
+};
+export declare type NodeSkeleton = ObjectSkeletonInterface & {
+    _type: AmServiceType;
+    nodes?: InnerNodeRefSkeletonInterface[];
+    tree?: string;
+    identityResource?: string;
+};
+export declare type SocialIdpSkeleton = ObjectSkeletonInterface & {
+    _type: AmServiceType;
+    enabled: boolean;
+};
+export declare type EmailTemplateSkeleton = ObjectSkeletonInterface & {
+    defaultLocale?: string;
+    displayName?: string;
+    enabled?: boolean;
+    from: string;
+    subject: Record<string, string>;
+};
+export declare type ThemeSkeleton = ObjectSkeletonInterface & {
+    name: string;
+    isDefault: boolean;
+    linkedTrees: string[];
+};
+export declare enum ScriptLanguage {
+    GROOVY = "GROOVY",
+    JAVASCRIPT = "JAVASCRIPT"
+}
+export declare enum ScriptContext {
+    OAUTH2_ACCESS_TOKEN_MODIFICATION = "OAUTH2_ACCESS_TOKEN_MODIFICATION",
+    AUTHENTICATION_CLIENT_SIDE = "AUTHENTICATION_CLIENT_SIDE",
+    AUTHENTICATION_TREE_DECISION_NODE = "AUTHENTICATION_TREE_DECISION_NODE",
+    AUTHENTICATION_SERVER_SIDE = "AUTHENTICATION_SERVER_SIDE",
+    SOCIAL_IDP_PROFILE_TRANSFORMATION = "SOCIAL_IDP_PROFILE_TRANSFORMATION",
+    OAUTH2_VALIDATE_SCOPE = "OAUTH2_VALIDATE_SCOPE",
+    CONFIG_PROVIDER_NODE = "CONFIG_PROVIDER_NODE",
+    OAUTH2_AUTHORIZE_ENDPOINT_DATA_PROVIDER = "OAUTH2_AUTHORIZE_ENDPOINT_DATA_PROVIDER",
+    OAUTH2_EVALUATE_SCOPE = "OAUTH2_EVALUATE_SCOPE",
+    POLICY_CONDITION = "POLICY_CONDITION",
+    OIDC_CLAIMS = "OIDC_CLAIMS",
+    SAML2_IDP_ADAPTER = "SAML2_IDP_ADAPTER",
+    SAML2_IDP_ATTRIBUTE_MAPPER = "SAML2_IDP_ATTRIBUTE_MAPPER",
+    OAUTH2_MAY_ACT = "OAUTH2_MAY_ACT"
+}
+export declare type ScriptSkeleton = ObjectSkeletonInterface & {
+    name: string;
+    description: string;
+    isDefault: boolean;
+    script: string;
+    language: ScriptLanguage;
+    context: ScriptContext;
+    createdBy: string;
+    creationDate: number;
+    lastModifiedBy: string;
+    lastModifiedDate: number;
+};
+export declare enum Saml2ProiderLocation {
+    HOSTED = "hosted",
+    REMOTE = "remote"
+}
+export declare type Saml2ProviderSkeleton = ObjectSkeletonInterface & {
+    entityId: string;
+    entityLocation: Saml2ProiderLocation;
+    serviceProvider: unknown;
+    identityProvider: unknown;
+    attributeQueryProvider: unknown;
+    xacmlPolicyEnforcementPoint: unknown;
+};
+export declare type CircleOfTrustSkeleton = ObjectSkeletonInterface & {
+    _type: AmServiceType;
+    status: string;
+    trustedProviders: string[];
+};
+export {};

package/types/api/ApiTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/ApiTypes.ts"],"names":[],"mappings":"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","file":"ApiTypes.d.ts","sourcesContent":["interface ObjectSkeletonInterface {\n  _id: string;\n  _rev?: number;\n  [k: string]: string | number | ObjectSkeletonInterface;\n}\n\nexport interface UiConfigInterface {\n  categories: string;\n}\n\nexport interface NodeRefSkeletonInterface {\n  connections: Record<string, string>;\n  displayName: string;\n  nodeType: string;\n  x: number;\n  y: number;\n}\n\nexport interface InnerNodeRefSkeletonInterface {\n  _id: string;\n  displayName: string;\n  nodeType: string;\n}\n\nexport type TreeSkeleton = ObjectSkeletonInterface & {\n  entryNodeId: string;\n  nodes: Record<string, NodeRefSkeletonInterface>;\n  identityResource?: string;\n  uiConfig?: UiConfigInterface;\n  enabled?: boolean;\n};\n\nexport type AmServiceType = ObjectSkeletonInterface & {\n  name: string;\n};\n\nexport type NodeSkeleton = ObjectSkeletonInterface & {\n  _type: AmServiceType;\n  nodes?: InnerNodeRefSkeletonInterface[];\n  tree?: string;\n  identityResource?: string;\n};\n\nexport type SocialIdpSkeleton = ObjectSkeletonInterface & {\n  _type: AmServiceType;\n  enabled: boolean;\n};\n\nexport type EmailTemplateSkeleton = ObjectSkeletonInterface & {\n  defaultLocale?: string;\n  displayName?: string;\n  enabled?: boolean;\n  from: string;\n  subject: Record<string, string>;\n};\n\nexport type ThemeSkeleton = ObjectSkeletonInterface & {\n  name: string;\n  isDefault: boolean;\n  linkedTrees: string[];\n};\n\nexport enum ScriptLanguage {\n  GROOVY = 'GROOVY',\n  JAVASCRIPT = 'JAVASCRIPT',\n}\n\nexport enum ScriptContext {\n  OAUTH2_ACCESS_TOKEN_MODIFICATION = 'OAUTH2_ACCESS_TOKEN_MODIFICATION',\n  AUTHENTICATION_CLIENT_SIDE = 'AUTHENTICATION_CLIENT_SIDE',\n  AUTHENTICATION_TREE_DECISION_NODE = 'AUTHENTICATION_TREE_DECISION_NODE',\n  AUTHENTICATION_SERVER_SIDE = 'AUTHENTICATION_SERVER_SIDE',\n  SOCIAL_IDP_PROFILE_TRANSFORMATION = 'SOCIAL_IDP_PROFILE_TRANSFORMATION',\n  OAUTH2_VALIDATE_SCOPE = 'OAUTH2_VALIDATE_SCOPE',\n  CONFIG_PROVIDER_NODE = 'CONFIG_PROVIDER_NODE',\n  OAUTH2_AUTHORIZE_ENDPOINT_DATA_PROVIDER = 'OAUTH2_AUTHORIZE_ENDPOINT_DATA_PROVIDER',\n  OAUTH2_EVALUATE_SCOPE = 'OAUTH2_EVALUATE_SCOPE',\n  POLICY_CONDITION = 'POLICY_CONDITION',\n  OIDC_CLAIMS = 'OIDC_CLAIMS',\n  SAML2_IDP_ADAPTER = 'SAML2_IDP_ADAPTER',\n  SAML2_IDP_ATTRIBUTE_MAPPER = 'SAML2_IDP_ATTRIBUTE_MAPPER',\n  OAUTH2_MAY_ACT = 'OAUTH2_MAY_ACT',\n}\n\nexport type ScriptSkeleton = ObjectSkeletonInterface & {\n  name: string;\n  description: string;\n  isDefault: boolean;\n  script: string;\n  language: ScriptLanguage;\n  context: ScriptContext;\n  createdBy: string;\n  creationDate: number;\n  lastModifiedBy: string;\n  lastModifiedDate: number;\n};\n\nexport enum Saml2ProiderLocation {\n  HOSTED = 'hosted',\n  REMOTE = 'remote',\n}\n\nexport type Saml2ProviderSkeleton = ObjectSkeletonInterface & {\n  entityId: string;\n  entityLocation: Saml2ProiderLocation;\n  serviceProvider: unknown;\n  identityProvider: unknown;\n  attributeQueryProvider: unknown;\n  xacmlPolicyEnforcementPoint: unknown;\n};\n\nexport type CircleOfTrustSkeleton = ObjectSkeletonInterface & {\n  _type: AmServiceType;\n  status: string;\n  trustedProviders: string[];\n};\n"]}

package/types/api/Saml2Api.d.ts

@@ -5,7 +5,7 @@
 export declare function getProviders(): Promise<any>;
 /**
  * Find all providers matching the filter and return the requested fields
- * @param {string} filter CREST filter string, eg "entityId+eq+'${entityId}'"
+ * @param {string} filter CREST filter string, eg "entityId+eq+'${entityId}'" or "true" for all providers
  * @param {string} fields Comma-delimited list of fields to include in the response
  * @returns {Promise} a promise that resolves to an object containing an array of saml2 entities
  */

package/types/api/Saml2Api.d.ts.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/api/Saml2Api.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,wBAAsB,YAAY,iBAUjC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,SAAS,EAAE,MAAM,SAAM,gBAYhE;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,gBAanB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,QAAQ,KAAA,gBAazC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,KAAA,UAO9C;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,KAAA,gBAQjD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,QAAQ,KAAA,EAAE,YAAY,KAAA,EAAE,QAAQ,KAAA,gBA8BpE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,QAAQ,KAAA,EAAE,YAAY,KAAA,gBAgB1D","file":"Saml2Api.d.ts","sourcesContent":["import util from 'util';\nimport _ from 'lodash';\nimport { generateAmApi } from './BaseApi';\nimport { getCurrentRealmPath } from './utils/ApiUtils';\nimport storage from '../storage/SessionStorage';\n\nconst providerByLocationAndIdURLTemplate = '%s/json%s/realm-config/saml2/%s/%s';\nconst createHostedProviderURLTemplate =\n  '%s/json%s/realm-config/saml2/hosted/?_action=create';\nconst createRemoteProviderURLTemplate =\n  '%s/json%s/realm-config/saml2/remote/?_action=importEntity';\nconst queryAllProvidersURLTemplate =\n  '%s/json%s/realm-config/saml2?_queryFilter=true';\nconst queryProvidersByEntityIdURLTemplate =\n  '%s/json%s/realm-config/saml2?_queryFilter=%s&_fields=%s';\nconst metadataByEntityIdURLTemplate =\n  '%s/saml2/jsp/exportmetadata.jsp?entityid=%s&realm=%s';\nconst apiVersion = 'protocol=2.1,resource=1.0';\nconst getApiConfig = () => {\n  const configPath = getCurrentRealmPath();\n  return {\n    path: `${configPath}/realm-config/saml2`,\n    apiVersion,\n  };\n};\n\n/**\n * Get all SAML2 entity providers\n * @returns {Promise} a promise that resolves to an array of saml2 entity stubs\n */\nexport async function getProviders() {\n  const urlString = util.format(\n    queryAllProvidersURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath()\n  );\n  const { data } = await generateAmApi(getApiConfig()).get(urlString, {\n    withCredentials: true,\n  });\n  return data;\n}\n\n/**\n * Find all providers matching the filter and return the requested fields\n * @param {string} filter CREST filter string, eg \"entityId+eq+'${entityId}'\"\n * @param {string} fields Comma-delimited list of fields to include in the response\n * @returns {Promise} a promise that resolves to an object containing an array of saml2 entities\n */\nexport async function findProviders(filter = 'true', fields = '*') {\n  const urlString = util.format(\n    queryProvidersByEntityIdURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath(),\n    encodeURIComponent(filter),\n    fields\n  );\n  const { data } = await generateAmApi(getApiConfig()).get(urlString, {\n    withCredentials: true,\n  });\n  return data;\n}\n\n/**\n * Geta SAML2 entity provider by location and id\n * @param {string} location Entity provider location (hosted or remote)\n * @param {string} entityId64 Base64-encoded provider entity id\n * @returns {Promise} a promise that resolves to a saml2 entity provider object\n */\nexport async function getProviderByLocationAndId(\n  location: string,\n  entityId64: string\n) {\n  const urlString = util.format(\n    providerByLocationAndIdURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath(),\n    location,\n    entityId64\n  );\n  const { data } = await generateAmApi(getApiConfig()).get(urlString, {\n    withCredentials: true,\n  });\n  return data;\n}\n\n/**\n * Get SAML2 entity provider by entity id\n * @param {string} entityId Provider entity id\n * @returns {Promise} a promise that resolves to a saml2 entity provider object or null\n */\nexport async function getProvider(entityId) {\n  const response = await findProviders(`entityId eq '${entityId}'`, 'location');\n  switch (response.resultCount) {\n    case 0:\n      throw new Error(`No provider with entity id '${entityId}' found`);\n    case 1: {\n      const { location } = response.result[0];\n      const id = response.result[0]._id;\n      return getProviderByLocationAndId(location, id);\n    }\n    default:\n      throw new Error(`Multiple providers with entity id '${entityId}' found`);\n  }\n}\n\n/**\n * Get a SAML2 entity provider's metadata URL by entity id\n * @param {string} entityId SAML2 entity id\n * @returns {string} the URL to get the metadata from\n */\nexport function getProviderMetadataUrl(entityId) {\n  return util.format(\n    metadataByEntityIdURLTemplate,\n    storage.session.getTenant(),\n    encodeURIComponent(entityId),\n    storage.session.getRealm()\n  );\n}\n\n/**\n * Get a SAML2 entity provider's metadata by entity id\n * @param {String} entityId SAML2 entity id\n * @returns {Promise} a promise that resolves to an object containing a SAML2 metadata\n */\nexport async function getProviderMetadata(entityId) {\n  const { data } = await generateAmApi(getApiConfig()).get(\n    getProviderMetadataUrl(entityId),\n    {\n      withCredentials: true,\n    }\n  );\n  return data;\n}\n\n/**\n * Create a SAML2 entity provider\n * @param {String} location 'hosted' or 'remote'\n * @param {Object} providerData Object representing a SAML entity provider\n * @param {String} metaData Base64-encoded metadata XML. Only required for remote providers\n * @returns {Promise} a promise that resolves to a saml2 entity provider object\n */\nexport async function createProvider(location, providerData, metaData) {\n  let postData = _.cloneDeep(providerData);\n  let urlString = util.format(\n    createHostedProviderURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath()\n  );\n\n  if (location === 'remote') {\n    /**\n     * Remote entity providers must be created using XML metadata\n     */\n    urlString = util.format(\n      createRemoteProviderURLTemplate,\n      storage.session.getTenant(),\n      getCurrentRealmPath()\n    );\n    postData = {\n      standardMetadata: metaData,\n    };\n  }\n\n  const { data } = await generateAmApi(getApiConfig()).post(\n    urlString,\n    postData,\n    {\n      withCredentials: true,\n    }\n  );\n  return data;\n}\n\n/**\n * Update SAML2 entity provider\n * @param {String} location Entity provider location (hosted or remote)\n * @param {Object} providerData Object representing a SAML entity provider\n * @returns {Promise} a promise that resolves to a saml2 entity provider object\n */\nexport async function updateProvider(location, providerData) {\n  const urlString = util.format(\n    providerByLocationAndIdURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath(),\n    location,\n    providerData._id\n  );\n  const { data } = await generateAmApi(getApiConfig()).put(\n    urlString,\n    providerData,\n    {\n      withCredentials: true,\n    }\n  );\n  return data;\n}\n"]}
+{"version":3,"sources":["../src/api/Saml2Api.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,wBAAsB,YAAY,iBAUjC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,SAAS,EAAE,MAAM,SAAM,gBAYhE;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,gBAanB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,QAAQ,KAAA,gBAazC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,KAAA,UAO9C;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,KAAA,gBAQjD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,QAAQ,KAAA,EAAE,YAAY,KAAA,EAAE,QAAQ,KAAA,gBA8BpE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,QAAQ,KAAA,EAAE,YAAY,KAAA,gBAgB1D","file":"Saml2Api.d.ts","sourcesContent":["import util from 'util';\nimport _ from 'lodash';\nimport { generateAmApi } from './BaseApi';\nimport { getCurrentRealmPath } from './utils/ApiUtils';\nimport storage from '../storage/SessionStorage';\n\nconst providerByLocationAndIdURLTemplate = '%s/json%s/realm-config/saml2/%s/%s';\nconst createHostedProviderURLTemplate =\n  '%s/json%s/realm-config/saml2/hosted/?_action=create';\nconst createRemoteProviderURLTemplate =\n  '%s/json%s/realm-config/saml2/remote/?_action=importEntity';\nconst queryAllProvidersURLTemplate =\n  '%s/json%s/realm-config/saml2?_queryFilter=true';\nconst queryProvidersByEntityIdURLTemplate =\n  '%s/json%s/realm-config/saml2?_queryFilter=%s&_fields=%s';\nconst metadataByEntityIdURLTemplate =\n  '%s/saml2/jsp/exportmetadata.jsp?entityid=%s&realm=%s';\nconst apiVersion = 'protocol=2.1,resource=1.0';\nconst getApiConfig = () => {\n  const configPath = getCurrentRealmPath();\n  return {\n    path: `${configPath}/realm-config/saml2`,\n    apiVersion,\n  };\n};\n\n/**\n * Get all SAML2 entity providers\n * @returns {Promise} a promise that resolves to an array of saml2 entity stubs\n */\nexport async function getProviders() {\n  const urlString = util.format(\n    queryAllProvidersURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath()\n  );\n  const { data } = await generateAmApi(getApiConfig()).get(urlString, {\n    withCredentials: true,\n  });\n  return data;\n}\n\n/**\n * Find all providers matching the filter and return the requested fields\n * @param {string} filter CREST filter string, eg \"entityId+eq+'${entityId}'\" or \"true\" for all providers\n * @param {string} fields Comma-delimited list of fields to include in the response\n * @returns {Promise} a promise that resolves to an object containing an array of saml2 entities\n */\nexport async function findProviders(filter = 'true', fields = '*') {\n  const urlString = util.format(\n    queryProvidersByEntityIdURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath(),\n    encodeURIComponent(filter),\n    fields\n  );\n  const { data } = await generateAmApi(getApiConfig()).get(urlString, {\n    withCredentials: true,\n  });\n  return data;\n}\n\n/**\n * Geta SAML2 entity provider by location and id\n * @param {string} location Entity provider location (hosted or remote)\n * @param {string} entityId64 Base64-encoded provider entity id\n * @returns {Promise} a promise that resolves to a saml2 entity provider object\n */\nexport async function getProviderByLocationAndId(\n  location: string,\n  entityId64: string\n) {\n  const urlString = util.format(\n    providerByLocationAndIdURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath(),\n    location,\n    entityId64\n  );\n  const { data } = await generateAmApi(getApiConfig()).get(urlString, {\n    withCredentials: true,\n  });\n  return data;\n}\n\n/**\n * Get SAML2 entity provider by entity id\n * @param {string} entityId Provider entity id\n * @returns {Promise} a promise that resolves to a saml2 entity provider object or null\n */\nexport async function getProvider(entityId) {\n  const response = await findProviders(`entityId eq '${entityId}'`, 'location');\n  switch (response.resultCount) {\n    case 0:\n      throw new Error(`No provider with entity id '${entityId}' found`);\n    case 1: {\n      const { location } = response.result[0];\n      const id = response.result[0]._id;\n      return getProviderByLocationAndId(location, id);\n    }\n    default:\n      throw new Error(`Multiple providers with entity id '${entityId}' found`);\n  }\n}\n\n/**\n * Get a SAML2 entity provider's metadata URL by entity id\n * @param {string} entityId SAML2 entity id\n * @returns {string} the URL to get the metadata from\n */\nexport function getProviderMetadataUrl(entityId) {\n  return util.format(\n    metadataByEntityIdURLTemplate,\n    storage.session.getTenant(),\n    encodeURIComponent(entityId),\n    storage.session.getRealm()\n  );\n}\n\n/**\n * Get a SAML2 entity provider's metadata by entity id\n * @param {String} entityId SAML2 entity id\n * @returns {Promise} a promise that resolves to an object containing a SAML2 metadata\n */\nexport async function getProviderMetadata(entityId) {\n  const { data } = await generateAmApi(getApiConfig()).get(\n    getProviderMetadataUrl(entityId),\n    {\n      withCredentials: true,\n    }\n  );\n  return data;\n}\n\n/**\n * Create a SAML2 entity provider\n * @param {String} location 'hosted' or 'remote'\n * @param {Object} providerData Object representing a SAML entity provider\n * @param {String} metaData Base64-encoded metadata XML. Only required for remote providers\n * @returns {Promise} a promise that resolves to a saml2 entity provider object\n */\nexport async function createProvider(location, providerData, metaData) {\n  let postData = _.cloneDeep(providerData);\n  let urlString = util.format(\n    createHostedProviderURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath()\n  );\n\n  if (location === 'remote') {\n    /**\n     * Remote entity providers must be created using XML metadata\n     */\n    urlString = util.format(\n      createRemoteProviderURLTemplate,\n      storage.session.getTenant(),\n      getCurrentRealmPath()\n    );\n    postData = {\n      standardMetadata: metaData,\n    };\n  }\n\n  const { data } = await generateAmApi(getApiConfig()).post(\n    urlString,\n    postData,\n    {\n      withCredentials: true,\n    }\n  );\n  return data;\n}\n\n/**\n * Update SAML2 entity provider\n * @param {String} location Entity provider location (hosted or remote)\n * @param {Object} providerData Object representing a SAML entity provider\n * @returns {Promise} a promise that resolves to a saml2 entity provider object\n */\nexport async function updateProvider(location, providerData) {\n  const urlString = util.format(\n    providerByLocationAndIdURLTemplate,\n    storage.session.getTenant(),\n    getCurrentRealmPath(),\n    location,\n    providerData._id\n  );\n  const { data } = await generateAmApi(getApiConfig()).put(\n    urlString,\n    providerData,\n    {\n      withCredentials: true,\n    }\n  );\n  return data;\n}\n"]}

package/types/index.d.ts

@@ -1,9 +1,11 @@
 export declare function getVersion(): string;
+export * as TypesRaw from './api/ApiTypes';
 export * as NodeRaw from './api/NodeApi';
 export * as TreeRaw from './api/TreeApi';
 export * as StartupRaw from './api/StartupApi';
 export * as SecretsRaw from './api/SecretsApi';
 export * as VariablesRaw from './api/VariablesApi';
+export * as Types from './ops/OpsTypes';
 export * as Admin from './ops/AdminOps';
 export * as Authenticate from './ops/AuthenticateOps';
 export * as CirclesOfTrust from './ops/CirclesOfTrustOps';
@@ -16,6 +18,7 @@ export * as Log from './ops/LogOps';
 export * as ManagedObject from './ops/ManagedObjectOps';
 export * as OAuth2Client from './ops/OAuth2ClientOps';
 export * as Organization from './ops/OrganizationOps';
+export * as Node from './ops/NodeOps';
 export * as Realm from './ops/RealmOps';
 export * as Saml2 from './ops/Saml2Ops';
 export * as Script from './ops/ScriptOps';

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"AAUA,wBAAgB,UAAU,WAEzB;AAGD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,iBAAiB,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AAG9C,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAIlD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC","file":"index.d.ts","sourcesContent":["import fs from 'fs';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst pkg = JSON.parse(\n  fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8')\n);\n\nexport function getVersion() {\n  return `v${pkg.version}`;\n}\n\n// Api Layer\nexport * as NodeRaw from './api/NodeApi';\nexport * as TreeRaw from './api/TreeApi';\nexport * as StartupRaw from './api/StartupApi';\nexport * as SecretsRaw from './api/SecretsApi';\nexport * as VariablesRaw from './api/VariablesApi';\n\n// Ops Layer\nexport * as Admin from './ops/AdminOps';\nexport * as Authenticate from './ops/AuthenticateOps';\nexport * as CirclesOfTrust from './ops/CirclesOfTrustOps';\nexport * as ConnectionProfile from './ops/ConnectionProfileOps';\nexport * as EmailTemplate from './ops/EmailTemplateOps';\nexport * as Idm from './ops/IdmOps';\nexport * as Idp from './ops/IdpOps';\nexport * as Journey from './ops/JourneyOps';\nexport * as Log from './ops/LogOps';\nexport * as ManagedObject from './ops/ManagedObjectOps';\nexport * as OAuth2Client from './ops/OAuth2ClientOps';\nexport * as Organization from './ops/OrganizationOps';\nexport * as Realm from './ops/RealmOps';\nexport * as Saml2 from './ops/Saml2Ops';\nexport * as Script from './ops/ScriptOps';\nexport * as Secrets from './ops/SecretsOps';\nexport * as Startup from './ops/StartupOps';\nexport * as Theme from './ops/ThemeOps';\nexport * as Variables from './ops/VariablesOps';\n// TODO: revisit if there are better ways\nexport * as Utils from './ops/utils/OpsUtils';\n// TODO: reconsider the aproach to pass in state from client\n// lib should be stateless, an aplication should own its state\nexport * as state from './storage/SessionStorage';\n// TODO: need to figure out if this is the right approach or if we should even\n// use a public oauth2/oidc library. might be ok for now since there is only\n// one place where the cli needs to execute an oauth flow.\nexport * as OAuth2OIDCApi from './api/OAuth2OIDCApi';\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"AAaA,wBAAgB,UAAU,WAEzB;AAGD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,iBAAiB,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AAG9C,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAIlD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC","file":"index.d.ts","sourcesContent":["import fs from 'fs';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport Color from 'colors';\n\nColor.enable();\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst pkg = JSON.parse(\n  fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8')\n);\n\nexport function getVersion() {\n  return `v${pkg.version}`;\n}\n\n// Api Layer\nexport * as TypesRaw from './api/ApiTypes';\nexport * as NodeRaw from './api/NodeApi';\nexport * as TreeRaw from './api/TreeApi';\nexport * as StartupRaw from './api/StartupApi';\nexport * as SecretsRaw from './api/SecretsApi';\nexport * as VariablesRaw from './api/VariablesApi';\n\n// Ops Layer\nexport * as Types from './ops/OpsTypes';\nexport * as Admin from './ops/AdminOps';\nexport * as Authenticate from './ops/AuthenticateOps';\nexport * as CirclesOfTrust from './ops/CirclesOfTrustOps';\nexport * as ConnectionProfile from './ops/ConnectionProfileOps';\nexport * as EmailTemplate from './ops/EmailTemplateOps';\nexport * as Idm from './ops/IdmOps';\nexport * as Idp from './ops/IdpOps';\nexport * as Journey from './ops/JourneyOps';\nexport * as Log from './ops/LogOps';\nexport * as ManagedObject from './ops/ManagedObjectOps';\nexport * as OAuth2Client from './ops/OAuth2ClientOps';\nexport * as Organization from './ops/OrganizationOps';\nexport * as Node from './ops/NodeOps';\nexport * as Realm from './ops/RealmOps';\nexport * as Saml2 from './ops/Saml2Ops';\nexport * as Script from './ops/ScriptOps';\nexport * as Secrets from './ops/SecretsOps';\nexport * as Startup from './ops/StartupOps';\nexport * as Theme from './ops/ThemeOps';\nexport * as Variables from './ops/VariablesOps';\n// TODO: revisit if there are better ways\nexport * as Utils from './ops/utils/OpsUtils';\n// TODO: reconsider the aproach to pass in state from client\n// lib should be stateless, an aplication should own its state\nexport * as state from './storage/SessionStorage';\n// TODO: need to figure out if this is the right approach or if we should even\n// use a public oauth2/oidc library. might be ok for now since there is only\n// one place where the cli needs to execute an oauth flow.\nexport * as OAuth2OIDCApi from './api/OAuth2OIDCApi';\n"]}

package/types/ops/JourneyOps.d.ts

@@ -1,46 +1,23 @@
-interface SingleJourneyExportTemplate {
-    meta?: Record<string, unknown>;
-    innerNodes?: Record<string, unknown>;
-    innernodes?: Record<string, unknown>;
-    nodes?: Record<string, unknown>;
-    scripts?: Record<string, unknown>;
-    emailTemplates?: Record<string, unknown>;
-    socialIdentityProviders?: Record<string, unknown>;
-    themes?: unknown[];
-    saml2Entities?: Record<string, unknown>;
-    circlesOfTrust?: Record<string, unknown>;
-    tree: Record<string, unknown>;
-}
-export declare function createSingleJourneyExportTemplate(): SingleJourneyExportTemplate;
-interface MultiJourneyExportTemplate {
-    meta?: Record<string, unknown>;
-    trees: Record<string, SingleJourneyExportTemplate>;
-}
-export declare function createMultiJourneyExportTemplate(): MultiJourneyExportTemplate;
-/**
- * Export options
- */
-interface ExportOptions {
-    /**
-     * Where applicable, use string arrays to store multi-line text (e.g. scripts).
-     */
-    useStringArrays: boolean;
-    /**
-     * Include any dependencies (scripts, email templates, SAML entity providers and circles of trust, social identity providers, themes).
-     */
-    deps: boolean;
-    /**
-     * Verbose output during command execution. May or may not produce additional output.
-     */
-    verbose: boolean;
-}
+import { JourneyClassification, TreeExportResolverInterface } from './OpsTypes';
+import { InnerNodeRefSkeletonInterface, NodeRefSkeletonInterface, NodeSkeleton } from '../api/ApiTypes';
+import { SingleTreeExportInterface, MultiTreeExportInterface, TreeDependencyMapInterface, TreeExportOptions, TreeImportOptions } from './OpsTypes';
+/**
+ * Create an empty single tree export template
+ * @returns {SingleTreeExportInterface} an empty single tree export template
+ */
+export declare function createSingleTreeExportTemplate(): SingleTreeExportInterface;
+/**
+ * Create an empty multi tree export template
+ * @returns {MultiTreeExportInterface} an empty multi tree export template
+ */
+export declare function createMultiTreeExportTemplate(): MultiTreeExportInterface;
 /**
  * Create export data for a tree/journey with all its nodes and dependencies. The export data can be written to a file as is.
  * @param {string} treeId tree id/name
- * @param {ExportOptions} options export options
- * @returns {Promise<SingleJourneyExportTemplate>} a promise that resolves to an object containing the tree and all its nodes and dependencies
+ * @param {TreeExportOptions} options export options
+ * @returns {Promise<SingleTreeExportInterface>} a promise that resolves to an object containing the tree and all its nodes and dependencies
  */
-export declare function exportJourney(treeId: string, options?: ExportOptions): Promise<SingleJourneyExportTemplate>;
+export declare function exportJourney(treeId: string, options?: TreeExportOptions): Promise<SingleTreeExportInterface>;
 /**
  * Get all the journeys/trees without all their nodes and dependencies.
  * @returns {Promise<unknown[]>} a promise that resolves to an array of journey objects
@@ -50,72 +27,92 @@ export declare function getJourneys(): Promise<unknown[]>;
  * Export journey by id/name to file
  * @param {string} journeyId journey id/name
  * @param {string} file optional export file name
- * @param {ExportOptions} options export options
+ * @param {TreeExportOptions} options export options
  */
-export declare function exportJourneyToFile(journeyId: string, file: string, options: ExportOptions): Promise<void>;
+export declare function exportJourneyToFile(journeyId: string, file: string, options: TreeExportOptions): Promise<void>;
 /**
  * Export all journeys to file
  * @param {string} file optional export file name
- * @param {ExportOptions} options export options
+ * @param {TreeExportOptions} options export options
  */
-export declare function exportJourneysToFile(file: string, options: ExportOptions): Promise<void>;
+export declare function exportJourneysToFile(file: string, options?: TreeExportOptions): Promise<void>;
 /**
  * Export all journeys to separate files
- * @param {ExportOptions} options export options
- */
-export declare function exportJourneysToFiles(options: ExportOptions): Promise<void>;
-/**
- * Import options
- */
-interface ImportOptions {
-    /**
-     * Generate new UUIDs for all nodes during import.
-     */
-    reUuid: boolean;
-    /**
-     * Include any dependencies (scripts, email templates, SAML entity providers and circles of trust, social identity providers, themes).
-     */
-    deps: boolean;
-    /**
-     * Verbose output during command execution. May or may not produce additional output.
-     */
-    verbose: boolean;
-}
+ * @param {TreeExportOptions} options export options
+ */
+export declare function exportJourneysToFiles(options: TreeExportOptions): Promise<void>;
 /**
  * Helper to import a tree with all dependencies from an import data object (typically read from a file)
- * @param {SingleJourneyExportTemplate} treeObject tree object containing tree and all its dependencies
- * @param {ImportOptions} options import options
+ * @param {SingleTreeExportInterface} treeObject tree object containing tree and all its dependencies
+ * @param {TreeImportOptions} options import options
  */
-export declare function importJourney(treeObject: SingleJourneyExportTemplate, options: ImportOptions): Promise<void>;
+export declare function importJourney(treeObject: SingleTreeExportInterface, options: TreeImportOptions): Promise<void>;
 /**
  * Import a journey from file
  * @param {string} journeyId journey id/name
  * @param {string} file import file name
- * @param {ImportOptions} options import options
+ * @param {TreeImportOptions} options import options
  */
-export declare function importJourneyFromFile(journeyId: string, file: string, options: ImportOptions): Promise<void>;
+export declare function importJourneyFromFile(journeyId: string, file: string, options: TreeImportOptions): Promise<void>;
 /**
  * Import first journey from file
  * @param {string} file import file name
- * @param {ImportOptions} options import options
+ * @param {TreeImportOptions} options import options
  */
-export declare function importFirstJourneyFromFile(file: string, options: ImportOptions): Promise<void>;
+export declare function importFirstJourneyFromFile(file: string, options: TreeImportOptions): Promise<void>;
 /**
  * Import all journeys from file
  * @param {string} file import file name
- * @param {ImportOptions} options import options
+ * @param {TreeImportOptions} options import options
  */
-export declare function importJourneysFromFile(file: string, options: ImportOptions): Promise<void>;
+export declare function importJourneysFromFile(file: string, options: TreeImportOptions): Promise<void>;
 /**
  * Import all journeys from separate files
- * @param {ImportOptions} options import options
+ * @param {TreeImportOptions} options import options
+ */
+export declare function importJourneysFromFiles(options: TreeImportOptions): Promise<void>;
+/**
+ * Get the node reference obbject for a node object. Node reference objects
+ * are used in a tree flow definition and within page nodes to reference
+ * nodes. Among other things, node references contain all the non-configuration
+ * meta data that exists for readaility, like the x/y coordinates of the node
+ * and the display name chosen by the tree designer. The dislay name is the
+ * only intuitive link between the graphical representation of the tree and
+ * the node configurations that make up the tree.
+ * @param nodeObj node object to retrieve the node reference object for
+ * @param singleTreeExport tree export with or without dependencies
+ * @returns {NodeRefSkeletonInterface | InnerNodeRefSkeletonInterface} node reference object
+ */
+export declare function getNodeRef(nodeObj: NodeSkeleton, singleTreeExport: SingleTreeExportInterface): NodeRefSkeletonInterface | InnerNodeRefSkeletonInterface;
+/**
+ * Default tree export resolver used to resolve a tree id/name to a full export
+ * w/o dependencies of that tree from a platform instance.
+ * @param {string} treeId id/name of the tree to resolve
+ * @returns {TreeExportResolverInterface} tree export
+ */
+export declare const onlineTreeExportResolver: TreeExportResolverInterface;
+/**
+ * Tree export resolver used to resolve a tree id/name to a full export
+ * of that tree from individual `treename.journey.json` export files.
+ * @param {string} treeId id/name of the tree to resolve
+ * @returns {TreeExportResolverInterface} tree export
+ */
+export declare const fileByIdTreeExportResolver: TreeExportResolverInterface;
+/**
+ * Factory that creates a tree export resolver used to resolve a tree id
+ * to a full export of that tree from a multi-tree export file.
+ * @param {string} file multi-tree export file
+ * @returns {TreeExportResolverInterface} tree export resolver
  */
-export declare function importJourneysFromFiles(options: ImportOptions): Promise<void>;
+export declare function createFileParamTreeExportResolver(file: string): TreeExportResolverInterface;
 /**
- * Describe a journey
- * @param {SingleJourneyExportTemplate} journeyData journey export object
+ * Get tree dependencies (all descendent inner trees)
+ * @param {SingleTreeExportInterface} treeExport single tree export
+ * @param {string[]} resolvedTreeIds list of tree ids wich have already been resolved
+ * @param {TreeExportResolverInterface} resolveTreeExport tree export resolver callback function
+ * @returns {Promise<TreeDependencyMapInterface>} a promise that resolves to a tree dependency map
  */
-export declare function describeJourney(journeyData: SingleJourneyExportTemplate): void;
+export declare function getTreeDescendents(treeExport: SingleTreeExportInterface, resolveTreeExport?: TreeExportResolverInterface, resolvedTreeIds?: string[]): Promise<TreeDependencyMapInterface>;
 /**
  * Find all node configuration objects that are no longer referenced by any tree
  * @returns {Promise<unknown[]>} a promise that resolves to an array of orphaned nodes
@@ -129,31 +126,31 @@ export declare function findOrphanedNodes(): Promise<unknown[]>;
 export declare function removeOrphanedNodes(orphanedNodes: unknown[]): Promise<unknown[]>;
 /**
  * Analyze if a journey contains any custom nodes considering the detected or the overridden version.
- * @param {SingleJourneyExportTemplate} journey Journey/tree configuration object
+ * @param {SingleTreeExportInterface} journey Journey/tree configuration object
  * @returns {boolean} True if the journey/tree contains any custom nodes, false otherwise.
  */
-export declare function isCustomJourney(journey: SingleJourneyExportTemplate): boolean;
+export declare function isCustomJourney(journey: SingleTreeExportInterface): boolean;
 /**
  * Analyze if a journey contains any premium nodes considering the detected or the overridden version.
- * @param {SingleJourneyExportTemplate} journey Journey/tree configuration object
+ * @param {SingleTreeExportInterface} journey Journey/tree configuration object
  * @returns {boolean} True if the journey/tree contains any custom nodes, false otherwise.
  */
-export declare function isPremiumJourney(journey: SingleJourneyExportTemplate): boolean;
+export declare function isPremiumJourney(journey: SingleTreeExportInterface): boolean;
 /**
  * Analyze if a journey contains any cloud-only nodes considering the detected or the overridden version.
- * @param {SingleJourneyExportTemplate} journey Journey/tree configuration object
+ * @param {SingleTreeExportInterface} journey Journey/tree configuration object
  * @returns {boolean} True if the journey/tree contains any cloud-only nodes, false otherwise.
  */
-export declare function isCloudOnlyJourney(journey: SingleJourneyExportTemplate): boolean;
+export declare function isCloudOnlyJourney(journey: SingleTreeExportInterface): boolean;
 /**
  * Get a journey's classifications, which can be one or multiple of:
  * - standard: can run on any instance of a ForgeRock platform
  * - cloud: utilize nodes, which are exclusively available in the ForgeRock Identity Cloud
  * - premium: utilizes nodes, which come at a premium
- * @param {SingleJourneyExportTemplate} journey journey export data
- * @returns {string[]} an array of one or multiple classifications
+ * @param {SingleTreeExportInterface} journey journey export data
+ * @returns {JourneyClassification[]} an array of one or multiple classifications
  */
-export declare function getJourneyClassification(journey: SingleJourneyExportTemplate): string[];
+export declare function getJourneyClassification(journey: SingleTreeExportInterface): JourneyClassification[];
 /**
  * List all the journeys/trees
  * @param {boolean} long Long version, all the fields
@@ -174,4 +171,3 @@ export declare function deleteJourney(journeyId: string, options: any, progress?
  * @param {Object} options deep=true also delete all the nodes and inner nodes, verbose=true print verbose info
  */
 export declare function deleteJourneys(options: any): Promise<{}>;
-export {};