@extrahorizon/javascript-sdk 8.9.0-dev-121-e732d56 → 8.9.0-dev-135-f1c216a

package/build/types/services/templatesV2/types.d.ts

@@ -0,0 +1,145 @@
+import { ObjectId, LanguageCode, TimeZone, PagedResult, AffectedRecords, OptionsWithRql, OptionsBase } from '../types';
+export interface TemplateV2 extends TemplateV2Creation {
+    id: ObjectId;
+    creationTimestamp: Date;
+    updateTimestamp: Date;
+}
+export interface TemplateV2Creation {
+    name: string;
+    description?: string;
+    properties?: Record<string, TemplateV2TypeConfiguration>;
+    outputs: Record<string, string>;
+}
+export declare type TemplateV2TypeConfiguration = TemplateV2ObjectConfiguration | TemplateV2ArrayConfiguration | TemplateV2StringConfiguration | TemplateV2NumberConfiguration | TemplateV2BooleanConfiguration;
+export interface TemplateV2ObjectConfiguration {
+    type: 'object';
+    properties: Record<string, TemplateV2TypeConfiguration>;
+}
+export interface TemplateV2ArrayConfiguration {
+    type: 'array';
+    items: TemplateV2TypeConfiguration;
+}
+export interface TemplateV2StringConfiguration {
+    type: 'string';
+}
+export interface TemplateV2NumberConfiguration {
+    type: 'number';
+}
+export interface TemplateV2BooleanConfiguration {
+    type: 'boolean';
+}
+export interface TemplateV2ResolveIn<T extends Record<string, any>> {
+    /**
+     * If not present (or empty) we will first check the configured language in the users-service. If that is not present it will default to 'EN'
+     */
+    language?: LanguageCode;
+    /**
+     * If not present (or empty) we will first check the configured time_zone in the users-service. If that is not present it will default to 'UTC'
+     */
+    timeZone?: TimeZone;
+    data?: T;
+}
+export interface TemplatesV2ErrorInfo {
+    /**
+     * The template outputs key in the request body that resulted in an error
+     */
+    output: string;
+    /**
+     * Error message describing the syntax error
+     */
+    message: string;
+}
+export interface TemplatesV2Service {
+    /**
+     * Get all templates the service has to offer
+     *
+     * Permission | Scope | Effect
+     * - | - | -
+     * `VIEW_TEMPLATES` | `global` | **Required** for this endpoint
+     * @param rql Add filters to the requested list.
+     * @returns PagedResult<TemplateV2>
+     */
+    find(options?: OptionsWithRql): Promise<PagedResult<TemplateV2>>;
+    /**
+     * Request a list of all templates
+     *
+     * Do not pass in a rql with limit operator!
+     *
+     * Permission | Scope | Effect
+     * - | - | -
+     * `VIEW_TEMPLATES` | `global` | **Required** for this endpoint
+     * @param rql Add filters to the requested list.
+     * @returns TemplateV2[]
+     */
+    findAll(options?: OptionsWithRql): Promise<TemplateV2[]>;
+    /**
+     * Find By Id
+     * @param id the Id to search for
+     * @returns the first element found
+     */
+    findById(id: ObjectId, options?: OptionsWithRql): Promise<TemplateV2 | undefined>;
+    /**
+     * Find By Name
+     * @param name the name to search for
+     * @returns the first element found
+     */
+    findByName(name: string, options?: OptionsWithRql): Promise<TemplateV2 | undefined>;
+    /**
+     * Find First
+     * @returns the first element found
+     */
+    findFirst(options?: OptionsWithRql): Promise<TemplateV2 | undefined>;
+    /**
+     * Create a new template
+     *
+     * Permission | Scope | Effect
+     * - | - | -
+     * `CREATE_TEMPLATES` | `global` | **Required** for this endpoint
+     * @param requestBody TemplateIn
+     * @returns TemplateV2
+     * @throws {ResourceAlreadyExistsError}
+     * @throws {TemplateSyntaxError}
+     */
+    create(requestBody: TemplateV2Creation, options?: OptionsBase): Promise<TemplateV2>;
+    /**
+     * Update an existing template
+     *
+     * Permission | Scope | Effect
+     * - | - | -
+     * `UPDATE_TEMPLATES` | `global` | **Required** for this endpoint
+     * @param templateIdOrName Id or Name of the targeted template
+     * @param requestBody TemplateIn
+     * @returns TemplateV2
+     * @throws {ResourceAlreadyExistsError}
+     * @throws {TemplateSyntaxError}
+     * @throws {ResourceUnknownError}
+     */
+    update(templateIdOrName: string, requestBody: Partial<TemplateV2Creation>, options?: OptionsBase): Promise<AffectedRecords>;
+    /**
+     * Delete a template
+     *
+     * Permission | Scope | Effect
+     * - | - | -
+     * `DELETE_TEMPLATES` | `global` | **Required** for this endpoint
+     * @param templateIdOrName Id or Name of the targeted template
+     * @returns AffectedRecords
+     * @throws {ResourceUnknownError}
+     */
+    remove(templateIdOrName: string, options?: OptionsBase): Promise<AffectedRecords>;
+    /**
+     * Resolves a template and presents the result as a json response
+     * Permission is **required** for this endpoint
+     * Permission | Scope | Effect
+     * - | - | -
+     * `RESOLVE_TEMPLATES` | `global` | Resolve any template
+     * `RESOLVE_TEMPLATES:{TEMPLATE_NAME}` | `global` | Resolve the specified template
+     *
+     * @param templateIdOrName Id or Name of the targeted template
+     * @param requestBody CreateFile
+     * @returns TemplateV2ResolveOut
+     * @throws {TemplateResolvingError}
+     * @throws {TemplateFillingError}
+     * @throws {ResourceUnknownError}
+     */
+    resolve<InputData = Record<string, any>, Outputs = Record<string, string>>(templateIdOrName: string, requestBody: TemplateV2ResolveIn<InputData>, options?: OptionsBase): Promise<Outputs>;
+}

package/build/types/services/types.d.ts

@@ -31,7 +31,10 @@ export declare enum Results {
     Success = 200
 }
 /**
- * Supported timezones from [Java.time.zoneId](https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#of-java.lang.String-)
+ * IANA time zone identifier (e.g. "Europe/Brussels").
+ * We aim to stay aligned with the official IANA time zone database.
+ * In practice, supported values closely match those returned by Intl.supportedValuesOf('timeZone') in JavaScript.
+ * For an overview of IANA time zones, see: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
  */
 export declare type TimeZone = string;
 export declare type MailAddress = string;

package/build/types/services/users/activationRequests/types.d.ts

@@ -15,7 +15,7 @@ export interface ActivationRequestsService {
      * - | - | -
      * `VIEW_ACTIVATION_REQUESTS` | global | **Required** for this endpoint
      */
-    findFirst(options?: OptionsWithRql): Promise<ActivationRequest>;
+    findFirst(options?: OptionsWithRql): Promise<ActivationRequest | undefined>;
     /**
      * Find an activation request by its id
      *
@@ -23,7 +23,7 @@ export interface ActivationRequestsService {
      * - | - | -
      * `VIEW_ACTIVATION_REQUESTS` | global | **Required** for this endpoint
      */
-    findById(id: string, options?: OptionsWithRql): Promise<ActivationRequest>;
+    findById(id: string, options?: OptionsWithRql): Promise<ActivationRequest | undefined>;
     /**
      * Find an activation request for a user id
      *
@@ -31,7 +31,7 @@ export interface ActivationRequestsService {
      * - | - | -
      * `VIEW_ACTIVATION_REQUESTS` | global | **Required** for this endpoint
      */
-    findByUserId(userId: string, options?: OptionsWithRql): Promise<ActivationRequest>;
+    findByUserId(userId: string, options?: OptionsWithRql): Promise<ActivationRequest | undefined>;
     /**
      * Remove an activation request
      *

package/build/types/services/users/forgotPasswordRequests/types.d.ts

@@ -15,7 +15,7 @@ export interface ForgotPasswordRequestsService {
      * - | - | -
      * `VIEW_FORGOT_PASSWORD_REQUESTS` | global | **Required** for this endpoint
      */
-    findFirst(options?: OptionsWithRql): Promise<ForgotPasswordRequest>;
+    findFirst(options?: OptionsWithRql): Promise<ForgotPasswordRequest | undefined>;
     /**
      * Find a forgot password request by its id
      *
@@ -23,7 +23,7 @@ export interface ForgotPasswordRequestsService {
      * - | - | -
      * `VIEW_FORGOT_PASSWORD_REQUESTS` | global | **Required** for this endpoint
      */
-    findById(id: string, options?: OptionsWithRql): Promise<ForgotPasswordRequest>;
+    findById(id: string, options?: OptionsWithRql): Promise<ForgotPasswordRequest | undefined>;
     /**
      * Find a forgot password request for a user id
      *
@@ -31,7 +31,7 @@ export interface ForgotPasswordRequestsService {
      * - | - | -
      * `VIEW_FORGOT_PASSWORD_REQUESTS` | global | **Required** for this endpoint
      */
-    findByUserId(userId: string, options?: OptionsWithRql): Promise<ForgotPasswordRequest>;
+    findByUserId(userId: string, options?: OptionsWithRql): Promise<ForgotPasswordRequest | undefined>;
     /**
      * Remove a forgot password request
      *

package/build/types/services/users/types.d.ts

@@ -207,6 +207,7 @@ export declare enum GlobalPermissionName {
     REMOVE_ROLE_PERMISSION = "REMOVE_ROLE_PERMISSION",
     REMOVE_STAFF = "REMOVE_STAFF",
     RESET_FAILED_LOGIN_ATTEMPTS = "RESET_FAILED_LOGIN_ATTEMPTS",
+    RESOLVE_TEMPLATES = "RESOLVE_TEMPLATES",
     SEND_MAILS = "SEND_MAILS",
     SYNC_PROFILE_GROUPS = "SYNC_PROFILE_GROUPS",
     TRANSFER_PERIOD = "TRANSFER_PERIOD",
@@ -459,7 +460,7 @@ export interface UsersGlobalRolesService {
      * - | - | -
      * `VIEW_ROLE` | `global` | **Required** for this endpoint
      */
-    findFirst(options?: OptionsWithRql): Promise<Role>;
+    findFirst(options?: OptionsWithRql): Promise<Role | undefined>;
     /**
      * Returns the first role with a specific id
      *
@@ -467,7 +468,7 @@ export interface UsersGlobalRolesService {
      * - | - | -
      * `VIEW_ROLE` | `global` | **Required** for this endpoint
      */
-    findById(id: ObjectId, options?: OptionsWithRql): Promise<Role>;
+    findById(id: ObjectId, options?: OptionsWithRql): Promise<Role | undefined>;
     /**
      * Returns the first role with a specific name
      *
@@ -475,7 +476,7 @@ export interface UsersGlobalRolesService {
      * - | - | -
      * `VIEW_ROLE` | `global` | **Required** for this endpoint
      */
-    findByName(name: string, options?: OptionsWithRql): Promise<Role>;
+    findByName(name: string, options?: OptionsWithRql): Promise<Role | undefined>;
     /**
      * @deprecated Use `find` instead
      *
@@ -591,7 +592,7 @@ export interface UsersGroupRolesService {
      * none | `staff enlistment` | View the roles for the group
      * `VIEW_GROUP` | `global` | View any group its roles
      */
-    findFirst(groupId: ObjectId, options?: OptionsWithRql): Promise<GroupRole>;
+    findFirst(groupId: ObjectId, options?: OptionsWithRql): Promise<GroupRole | undefined>;
     /**
      * Finds a group role by its id
      *
@@ -600,7 +601,7 @@ export interface UsersGroupRolesService {
      * none | `staff enlistment` | View the roles for the group
      * `VIEW_GROUP` | `global` | View any group its roles
      */
-    findById(groupId: ObjectId, roleId: ObjectId, options?: OptionsWithRql): Promise<GroupRole>;
+    findById(groupId: ObjectId, roleId: ObjectId, options?: OptionsWithRql): Promise<GroupRole | undefined>;
     /**
      * Returns the first group role found by a specific name
      *
@@ -609,7 +610,7 @@ export interface UsersGroupRolesService {
      * none | `staff enlistment` | View the roles for the group
      * `VIEW_GROUP` | `global` | View any group its roles
      */
-    findByName(groupId: ObjectId, roleName: string, options?: OptionsWithRql): Promise<GroupRole>;
+    findByName(groupId: ObjectId, roleName: string, options?: OptionsWithRql): Promise<GroupRole | undefined>;
     /**
      * @deprecated Use `find` instead
      *
@@ -815,9 +816,26 @@ export interface UsersService {
      * @returns User[]
      */
     findAllIterator(options?: OptionsWithRql): FindAllIterator<User>;
-    findFirst(options?: {
-        rql?: RQLString;
-    }): Promise<User>;
+    /**
+     * Find the first user matching the rql query
+     *
+     * Permission | Scope | Effect
+     * - | - | -
+     * none | `patient enlistment` | See a limited set of fields of the staff members (of the groups where you are enlisted as a patient)
+     * none | `staff enlistment` | See a limited set of fields of all patients and staff members (of the groups where you are enlisted as staff member)
+     * `VIEW_USER` | `global` | See all fields of all users
+     */
+    findFirst(options?: OptionsWithRql): Promise<User | undefined>;
+    /**
+     * Find a user by their email address
+     *
+     * Permission | Scope | Effect
+     * - | - | -
+     * none | `patient enlistment` | See a limited set of fields of the staff members (of the groups where you are enlisted as a patient)
+     * none | `staff enlistment` | See a limited set of fields of all patients and staff members (of the groups where you are enlisted as staff member)
+     * `VIEW_USER` | `global` | See all fields of all users
+     */
+    findByEmail(email: string, options?: OptionsWithRql): Promise<User | undefined>;
     /**
      * @deprecated
      * Delete a list of users

package/build/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "8.9.0-dev-121-e732d56";
+export declare const version = "8.9.0-dev-135-f1c216a";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@extrahorizon/javascript-sdk",
-  "version": "8.9.0-dev-121-e732d56",
+  "version": "8.9.0-dev-135-f1c216a",
   "description": "This package serves as a JavaScript wrapper around all Extra Horizon cloud services.",
   "main": "build/index.cjs.js",
   "types": "build/types/index.d.ts",
@@ -26,7 +26,7 @@
     "prepare": "yarn build && yarn lint",
     "test": "jest",
     "test:e2e": "jest tests/e2e",
-    "lint": "eslint src --ext .ts"
+    "lint": "eslint src/** tests/** --ext .ts"
   },
   "files": [
     "build"