@lindle/sharepoint_requests 0.1.12 → 0.1.13

package/src/root/index.ts

@@ -1,605 +1,201 @@
+import { AxiosInstance, CreateAxiosDefaults as AxiosConfig } from 'axios';
+import instance from './instance';
 import {
-  AxiosInstance,
-  AxiosResponse,
-  CreateAxiosDefaults as AxiosConfig,
-} from 'axios';
-import instance from './instance';
-import {
-  CreateFileProps,
-  CurrentUser,
-  EmailProps,
-  Field_Options,
-  Folder_Options,
-  IListName,
-  ItemID,
-  ListData,
-  Options,
-  PersonField,
-  SHAREPOINT_VER,
-  SPItem,
-  UserPermision,
-  UserProfile,
-} from '../types';
-
-class HTTPSharePointRequests<
-  T extends { LISTS: Record<string, any>; FOLDERS?: Record<string, any> }
-> {
-  private baseURL: string;
-  private endpoint: string;
-  private listName: string;
-  private instance: AxiosInstance;
-
-  /**
-   * Creates an HTTP SharePoint requester bound to the provided base URL.
-   *
-   * @param baseURL The root SharePoint site URL (with or without trailing slash).
-   * @param config Optional axios configuration overrides.
-   */
+  CreateFileProps,
+  CurrentUser,
+  EmailProps,
+  Field_Options,
+  Folder_Options,
+  IListName,
+  ItemID,
+  ListData,
+  Options,
+  PersonField,
+  SHAREPOINT_VER,
+  UserPermision,
+  UserProfile,
+} from '../types';
+import { RequestContext } from './internal/context';
+import {
+  createAttachment,
+  createListItem,
+  deleteItem,
+  getFiles,
+  getListItems,
+  getOnly,
+  updateListItem,
+} from './internal/listRequests';
+import { sendEmail as sendEmailRequest } from './internal/emailRequests';
+import {
+  currentUserPermissions as resolveCurrentUserPermissions,
+  currentUserProperties as loadCurrentUserProperties,
+  getSiteUser as fetchSiteUser,
+  typeAhead,
+} from './internal/userRequests';
+
+class HTTPSharePointRequests<
+  T extends {
+    LISTS: Record<string, unknown>;
+    FOLDERS?: Record<string, unknown>;
+  }
+> {
+  private baseURL: string;
+  private endpoint: string;
+  private listName: string;
+  private instance: AxiosInstance;
+  private sharepointVersion: SHAREPOINT_VER;
+
   constructor(baseURL: string, config?: AxiosConfig) {
     this.baseURL = baseURL.endsWith('/') ? baseURL : `${baseURL}/`;
     this.endpoint = '/api';
     this.listName = '';
-
     this.instance = instance(this.baseURL, config);
+    this.sharepointVersion = '2013';
+  }
+
+  private getContext<V extends SHAREPOINT_VER = '2013'>(): RequestContext<V> {
+    return {
+      instance: this.instance,
+      baseURL: this.baseURL,
+      endpoint: this.endpoint,
+      listName: this.listName,
+      sharepointVersion: this.sharepointVersion as V,
+    };
+  }
+
+  /**
+   * @deprecated Use `from` instead.
+   */
+  list(listName: IListName<T>) {
+    this.listName = listName;
+    this.endpoint = `_vti_bin/ListData.svc/${listName}`;
+    this.sharepointVersion = '2010';
+    return this;
+  }
+
+  public readonly lists = {
+    get: () => {
+      this.endpoint = '_api/web/lists';
+      this.sharepointVersion = '2013';
+      return getListItems(this.getContext());
+    },
+  };
+
+  from<
+    K extends Extract<keyof T['LISTS'], string>,
+    V extends SHAREPOINT_VER = '2013'
+  >(listName: K, sharepoint_ver?: V) {
+    const version = (sharepoint_ver ?? '2013') as V;
+
+    this.listName = listName;
+    this.sharepointVersion = version;
+    this.endpoint =
+      version === '2013'
+        ? `_api/web/lists/GetByTitle('${this.listName}')/items`
+        : `_vti_bin/ListData.svc/${listName}`;
+
+    const getContext = () => this.getContext<V>();
+
+    return {
+      create: (data: ListData) => createListItem(getContext(), data),
+      get: (options?: Options<T['LISTS'][K], V>) =>
+        getListItems<T['LISTS'][K], V>(getContext(), options),
+      update: (id: ItemID, data: ListData, digest?: string) =>
+        updateListItem(getContext(), id, data, digest),
+      delete: (id: ItemID) => deleteItem(getContext(), id),
+      createFile: (props: CreateFileProps) =>
+        createAttachment(getContext(), props),
+      fields: (options?: Field_Options<T['LISTS'][K], V>) => {
+        this.endpoint = !options?.fieldName
+          ? `_api/web/lists/GetByTitle('${this.listName}')/fields`
+          : `_api/web/lists/GetByTitle('${this.listName}')/fields/getbytitle('${options.fieldName}')`;
+        return {
+          get: () => getOnly<T['LISTS'][K], V>(this.instance, this.endpoint, options),
+        };
+      },
+    };
+  }
+
+  public folders = {
+    get: () => {
+      this.endpoint = '_api/web/folders';
+      this.sharepointVersion = '2013';
+      getListItems(this.getContext());
+    },
+  };
+
+  public folder(folderName?: string | string[]) {
+    let filePath = ['Shared Documents'];
+
+    if (folderName) {
+      filePath = Array.isArray(folderName)
+        ? [...filePath, ...folderName]
+        : [...filePath, folderName];
+    }
+
+    this.endpoint = `_api/web/GetFolderByServerRelativeUrl('${filePath.join(
+      '/'
+    )}')`;
+    this.sharepointVersion = '2013';
+
+    const getContext = () => this.getContext();
+
+    return {
+      get: (options?: Folder_Options<any>) => {
+        if (!options?.type) {
+          this.endpoint += '/Files';
+        } else {
+          this.endpoint += `/${options.type}`;
+        }
+        return getFiles(getContext(), options);
+      },
+    };
+  }
+
+  public users(options?: Options<any>) {
+    this.endpoint = '_api/web/SiteUserInfoList/items';
+    this.sharepointVersion = '2013';
+    return {
+      get: () => getListItems(this.getContext(), options),
+    };
   }
-
-  /**
-   * Converts array values in a payload to the `Collection(Edm.String)` structure
-   * expected by SharePoint REST endpoints.
-   *
-   * @param data The list item payload to harmonise in-place.
-   */
-  private transformArraysToEdmStrings(data: ListData) {
-    for (const key in data) {
-      if (Array.isArray(data[key])) {
-        data[key] = {
-          __metadata: { type: 'Collection(Edm.String)' },
-          results: data[key],
-        };
-      }
-    }
-  }
-
-  /**
-   * @deprecated Use `from` instead.
-   */
-  list(listName: IListName<T>) {
-    this.listName = listName;
-    this.endpoint = `_vti_bin/ListData.svc/${listName}`;
-    return this;
-  }
-  public readonly lists = {
-    /**
-     * Fetches all SharePoint lists available to the current site.
-     *
-     * @returns Promise resolving to the list collection response payload.
-     */
-    get: () => {
-      this.endpoint = '_api/web/lists';
-      return this.get_v2();
-    },
-  };
-
-  /**
-   * Selects a SharePoint list and exposes list-scoped CRUD helpers.
-   *
-   * @param listName Logical list key configured in the generic type map.
-   * @param sharepoint_ver SharePoint version used to choose the correct REST endpoint.
-   * @returns Chainable helpers bound to the selected list.
-   */
-  from<K extends Extract<keyof T['LISTS'], string>>(
-    listName: K,
-    sharepoint_ver: SHAREPOINT_VER = '2013'
-  ) {
-    this.listName = listName;
-    this.endpoint =
-      sharepoint_ver === '2013'
-        ? `_api/web/lists/GetByTitle('${this.listName}')/items`
-        : `_vti_bin/ListData.svc/${listName}`;
-    return {
-      create: (data: ListData) => this.create_v2(data),
-      get: (options?: Options<T['LISTS'][K]>) =>
-        this.get_v2<T['LISTS'][K]>(options),
-      update: (id: ItemID, data: ListData, digest?: string) =>
-        this.update_2(id, data, digest),
-      delete: (id: ItemID) => this.delete(id),
-      createFile: (props: CreateFileProps) => this.createFile(props),
-      fields: (options?: Field_Options<T['LISTS'][K]>) => {
-        // return this.field_v2(options)
-        this.endpoint = !options?.fieldName
-          ? `_api/web/lists/GetByTitle('${this.listName}')/fields`
-          : `_api/web/lists/GetByTitle('${this.listName}')/fields/getbytitle('${options.fieldName}')`;
-        return {
-          get: () => this.get_only(options),
-        };
-      },
-    };
-  }
-
-  public folders = {
-    /**
-     * Retrieves SharePoint folders from the default folders endpoint.
-     *
-     * @returns A promise resolving with folder metadata.
-     */
-    get: () => {
-      this.endpoint = '_api/web/folders';
-      this.get_v2();
-    },
-  };
-
-  /**
-   * Targets a SharePoint folder path and exposes file retrieval helpers.
-   *
-   * @param folderName Optional folder path relative to `Shared Documents`.
-   * @returns Helper exposing `get` to fetch files or sub-folders.
-   */
-  public folder(folderName?: string | string[]) {
-    let filePath = ['Shared Documents'];
-
-    if (folderName) {
-      filePath = Array.isArray(folderName)
-        ? [...filePath, ...folderName]
-        : [...filePath, folderName];
-    }
-    this.endpoint = `_api/web/GetFolderByServerRelativeUrl('${filePath.join(
-      '/'
-    )}')`;
-    return {
-      /**
-       * Fetches files or folders from the targeted path.
-       *
-       * @param options Optional REST query options to refine the result set.
-       * @returns Promise resolving to folder contents and metadata.
-       */
-      get: (options?: Folder_Options<any>) => {
-        if (!options?.type) {
-          this.endpoint += '/Files';
-        } else {
-          this.endpoint += `/${options.type}`;
-        }
-
-        return this.get_files(options);
-      },
-    };
-  }
-
-  /**
-   * Retrieves user list items and exposes a get helper with optional query parameters.
-   *
-   * @param options Optional REST query options.
-   * @returns Helper exposing `get` returning SharePoint user rows.
-   */
-  public users(options?: Options<any>) {
-    this.endpoint = '_api/web/SiteUserInfoList/items';
-    return {
-      /**
-       * Executes the user list request using the specified options.
-       *
-       * @returns Promise resolving to the SharePoint user list response.
-       */
-      get: () => this.get_v2(options),
-    };
-  }
-
-  /**
-   * Asynchronously retrieves the Form Digest Value from the context information API.
-   *
-   * @returns {Promise<string>} A promise that resolves to the Form Digest Value.
-   * @throws {Error} If the HTTP request fails or the response does not contain the expected data.
-   */
-  private async getDigest(): Promise<string> {
-    try {
-      const response = await this.instance.post(
-        `${this.baseURL}_api/contextinfo`
-      );
-      if (!response.data?.d?.GetContextWebInformation?.FormDigestValue) {
-        throw new Error('Invalid response structure: Missing FormDigestValue');
-      }
-      return response.data.d.GetContextWebInformation.FormDigestValue;
-    } catch (error) {
-      console.error('Failed to retrieve the Form Digest Value:', error);
-      throw new Error(`Error retrieving Form Digest Value`);
-    }
-    '';
-  }
-
-  /**
-   * Executes a GET request without additional metadata wrapping.
-   *
-   * @param options Optional REST query options.
-   * @returns SharePoint response payload or undefined when empty.
-   */
-  private async get_only(options?: any) {
-    const { expand, orderBy, limit, filter, cols, skip } = options || {};
-
-    const params = {
-      $expand: Array.isArray(expand) ? expand.join(',') : expand,
-      $top: limit,
-      $skip: skip,
-      $select: Array.isArray(cols) ? cols.join(',') : cols,
-      $filter: filter,
-      $orderby: Array.isArray(orderBy) ? orderBy.join(',') : orderBy,
-    };
-    const { data } = await this.instance.get(this.endpoint, { params });
-    if (data) {
-      return data.d.results ? data.d.results : data.d;
-    }
-  }
-
-  /**
-   * Retrieves folder contents with optional filtering and returns the payload with metadata.
-   *
-   * @param options REST options describing expand/filter/order conditions.
-   * @returns Folder data and the fully resolved request URL.
-   */
-  private async get_files(options?: Folder_Options<any>) {
-    const { expand, orderBy, limit, filter, cols, skip } = options || {};
-    const params = {
-      $expand: Array.isArray(expand) ? expand.join(',') : expand,
-      $top: limit,
-      $skip: skip,
-      $select: Array.isArray(cols) ? cols.join(',') : cols,
-      $filter: filter,
-      $orderby: Array.isArray(orderBy) ? orderBy.join(',') : orderBy,
-    };
-    const url = new URL(this.endpoint, this.instance.defaults.baseURL);
-    Object.entries(params).forEach(([key, value]) => {
-      if (value !== undefined && value !== null) {
-        url.searchParams.append(key, String(value));
-      }
-    });
-
-    const response = await this.instance.request({
-      url: this.endpoint,
-      method: 'GET',
-      params,
-    });
-
-    const data =
-      limit || !response.data.d.results
-        ? response.data.d
-        : response.data.d.results;
-
-    const meta = { url };
-
-    return { data, meta };
-  }
-
-  /**
-   * Performs a typed list read against the current endpoint.
-   *
-   * @param options Optional REST query options governing expand, filter, ordering and pagination.
-   * @returns SharePoint list items alongside the fully-resolved request URL.
-   */
-  private async get_v2<K = any>(
-    options?: Options<K>
-  ): Promise<{ data: (K & Partial<SPItem>)[]; meta: { url: URL } }> {
-    const { expand, orderBy, limit, filter, cols, skip } = options || {};
-
-    const params = {
-      $expand: Array.isArray(expand) ? expand.join(',') : expand,
-      $top: limit,
-      $skip: skip,
-      $select: Array.isArray(cols) ? cols.join(',') : cols,
-      $filter: filter,
-      $orderby: Array.isArray(orderBy) ? orderBy.join(' ') : orderBy,
-    };
-
-    const url = new URL(this.endpoint, this.instance.defaults.baseURL);
-    Object.entries(params).forEach(([key, value]) => {
-      if (value !== undefined && value !== null) {
-        url.searchParams.append(key, String(value));
-      }
-    });
-
-    const response = await this.instance.request({
-      url: this.endpoint,
-      method: 'GET',
-      params,
-    });
-
-    const data =
-      limit || !response.data.d.results
-        ? response.data.d
-        : response.data.d.results;
-
-    const meta = { url };
-
-    return { data, meta };
-  }
-
-  /**
-   * Updates an item in the currently selected list.
-   *
-   * @param id Target list item identifier.
-   * @param data Payload with fields to update.
-   * @param digest Optional pre-fetched form digest to reuse.
-   * @returns Axios response of the update request.
-   */
-  private async update_2(id: ItemID, data: ListData, digest?: string) {
-    const formDigestValue = digest || (await this.getDigest());
-
-    data.__metadata = {
-      type: `SP.Data.${this.listName}ListItem`,
-    };
-    const url = `_api/lists/getbytitle('${this.listName}')/getItemById('${id}')`;
-    const response = await this.instance({
-      url,
-      method: 'POST',
-      data: JSON.stringify(data),
-      headers: {
-        'X-RequestDigest': formDigestValue,
-        'IF-MATCH': '*',
-        'X-Http-Method': 'PATCH',
-      },
-    });
-    return response;
-  }
-
-  /**
-   * Creates a new item within the active list.
-   *
-   * @param listData SharePoint list item payload.
-   * @returns Axios response resolved from the create request.
-   */
-  private async create_v2(listData: ListData) {
-    this.transformArraysToEdmStrings(listData);
-    listData.__metadata = {
-      type: `SP.Data.${this.listName}ListItem`,
-    };
-    const response = await this.instance({
-      url: this.endpoint,
-      method: 'POST',
-      data: JSON.stringify(listData),
-      headers: {
-        'X-RequestDigest': await this.getDigest(),
-        'IF-MATCH': '*',
-      },
-    });
-    return response;
-  }
-
-  /**
-   * Uploads an attachment file to an existing list item.
-   *
-   * @param props File payload and target item identifier.
-   * @returns Axios response describing the upload result.
-   */
-  private async createFile({ file, itemId }: CreateFileProps) {
-    const requestUrl = `_api/lists/getbytitle('${this.listName}')/items(${itemId})/AttachmentFiles/add(FileName='${file.name}')`;
-    const res = await this.instance.post(requestUrl, file, {
-      headers: {
-        'X-RequestDigest': await this.getDigest(),
-      },
-      withCredentials: true,
-    });
-
-    return res;
-  }
-
-  /**
-   * Deletes an item using the current endpoint.
-   *
-   * @param ID Identifier of the entity to remove.
-   * @returns Axios response from the delete call.
-   */
-  private async delete(ID: string | number) {
-    const response = await this.instance.delete(`${this.endpoint!}(${ID})`);
-    return response;
-  }
-
-  public email = {
-    /**
-     * Sends an email using SharePoint's Utility.SendEmail API.
-     *
-     * @param {EmailProps} param0 - The email properties.
-     * @param {string} param0.From - The sender's email address.
-     * @example
-     *  Example of a sender's email address
-     *  "sender@example.com"
-     * @param {string | string[]} param0.To - The recipient's email address or an array of email addresses.
-     * @example
-     *  Example of a single recipient's email address
-     *   "recipient@example.com"
-     *  Example of multiple recipients' email addresses
-     *  ["recipient1@example.com", "recipient2@example.com"]
-     * @param {string} param0.Subject - The subject of the email.
-     * @example
-     *  Example of an email subject
-     *  "Meeting Reminder"
-     * @param {string} param0.Body - The body content of the email.
-     * @example
-     *  Example of an email body
-     *  "Dear team, please be reminded of the meeting scheduled for tomorrow at 10 AM."
-     * @returns {Promise<any>} - A promise that resolves to the response of the email send request.
-     */
-    send: (props: EmailProps) => this.sendEmail(props),
-  };
-
-  private async sendEmail({
-    From,
-    To,
-    Subject,
-    Body,
-  }: EmailProps): Promise<
-    AxiosResponse<{
-      d: {
-        SendEmail: null;
-      };
-    }>
-  > {
-    const httpRequest = '_api/SP.Utilities.Utility.SendEmail';
-    const response = await this.instance({
-      url: httpRequest,
-      method: 'POST',
-      headers: {
-        'X-RequestDigest': await this.getDigest(),
-        'X-Http-Method': 'POST',
-        'Content-Type': 'application/json;odata=verbose',
-      },
-      data: JSON.stringify({
-        properties: {
-          __metadata: {
-            type: 'SP.Utilities.EmailProperties',
-          },
-          From,
-          To: {
-            results: Array.isArray(To) ? To : [To],
-          },
-          Body,
-          Subject,
-        },
-      }),
-    });
-
-    return response;
-  }
-
-  /**
-   * Queries SharePoint's people picker endpoint for matching users.
-   *
-   * @param input Free-text search term.
-   * @param filter Optional additional filter condition.
-   * @returns Promise with type-ahead results payload.
-   */
-  private async typeAhead(input: string, filter?: string) {
-    const filterValue = filter ? ` and ${filter}` : '';
-    const response = await this.instance.get(
-      `_vti_bin/listdata.svc/UserInformationList?$top=10&$filter=substringof('${input}',Name) or substringof('${input}',WorkEmail)${filterValue}`
-    );
-    return response.data.d;
-  }
-
-  /**
-   * Retrieves the current user profile and flattens selected properties.
-   *
-   * @returns Promise containing the current user's profile information.
-   */
-  private async currentUserProperties() {
-    const requestUrl = '_api/sp.userprofiles.peoplemanager/getmyproperties';
-    let profile: any = await this.instance.get(requestUrl);
-
-    profile = profile.data.d;
-
-    profile.UserProfileProperties.results.forEach(
-      (prop: { Key: string; Value: string }) => {
-        if (prop.Key === 'FirstName') {
-          profile.FirstName = prop.Value;
-        }
-        if (prop.Key === 'LastName') {
-          profile.LastName = prop.Value;
-        }
-        if (prop.Key === 'Country') {
-          profile.Country = prop.Value;
-        }
-        if (prop.Key === 'UserName') {
-          profile.UserName = prop.Value;
-        }
-      }
-    );
-    return profile as Promise<UserProfile>;
-  }
-  public user = {
-    /**
-     * Provides accessors for the current user's profile information.
-     *
-     * @returns Helper exposing a `get` function to retrieve profile details.
-     */
-    properties: () => {
-      return {
-        get: () => this.currentUserProperties(),
-      };
-    },
-    /**
-     * Searches across site users and their groups.
-     *
-     * @param searchValue Query string to match site users.
-     * @returns Promise resolving to matching site users.
-     */
-    searchSiteUser: (searchValue: string) => this.getSiteUser(searchValue),
-    /**
-     * Performs a people-picker search scoped to the current site collection.
-     *
-     * @param input Search prefix.
-     * @param filter Optional additional filter condition.
-     * @returns Promise with type-ahead person results.
-     */
-    searchUser: (input: string, filter?: string): Promise<PersonField> =>
-      this.typeAhead(input, filter),
-    /**
-     * Fetches the currently authenticated SharePoint user.
-     *
-     * @returns Helper exposing `get` that resolves to the current user payload.
-     */
-    current: () => {
-      this.endpoint = '_api/web/currentUser';
-      return {
-        get: (): Promise<CurrentUser> => this.get_only(),
-      };
-    },
-    /**
-     * Retrieves calculated permission level for the current user.
-     *
-     * @returns Helper exposing `get` resolving to the user's permission definition.
-     */
-    currentPermission: () => {
-      return {
-        get: () => this.currentUserPermissions(),
-      };
-    },
-  };
-
-  /**
-   * Searches site users based on a substring match across common fields.
-   *
-   * @param searchValue Term to match against the SharePoint user directory.
-   * @returns Promise with matching site users and their groups.
-   */
-  private async getSiteUser(searchValue: string) {
-    const requestUrl = `_api/web/siteusers?&$filter=substringof('${searchValue}', Title) or substringof('${searchValue}', LoginName) or substringof('${searchValue}', Email)&$top=50&$expand=Groups`;
-    const response = await this.instance.get(requestUrl);
-    return response.data.d;
-  }
-
-  /**
-   * Retrieves all available role definitions for the current site.
-   *
-   * @returns Promise resolving to an array of role definitions.
-   */
-  private async roleDefinitions() {
-    const requestUrl = `_api/Web/RoleDefinitions`;
-    const response = await this.instance.get(requestUrl);
-    return response.data.d.results;
-  }
-
-  /**
-   * Fetches the bit-encoded permissions of the current user.
-   *
-   * @returns Promise resolving to the `EffectiveBasePermissions` object.
-   */
-  private async getEffectiveBasePermissions() {
-    const requestUrl = `_api/Web/effectiveBasePermissions`;
-    const response = await this.instance.get(requestUrl);
-    return response.data.d.EffectiveBasePermissions;
-  }
-
-  /**
-   * Matches the current user's effective permissions against known role definitions.
-   *
-   * @returns The matching SharePoint role definition as a structured permission object.
-   */
-  private async currentUserPermissions() {
-    const { High } = await this.getEffectiveBasePermissions();
-    const roleDefinitions = await this.roleDefinitions();
-
-    const result = roleDefinitions.find(
-      ({ BasePermissions }: { BasePermissions: { High: string } }) =>
-        BasePermissions.High === High
-    );
-
-    return result as UserPermision;
-  }
-}
-
-export default HTTPSharePointRequests;
+
+  public email = {
+    send: (props: EmailProps) => {
+      this.sharepointVersion = '2013';
+      return sendEmailRequest(this.getContext(), props);
+    },
+  };
+
+  public user = {
+    properties: () => ({
+      get: (): Promise<UserProfile> => {
+        this.sharepointVersion = '2013';
+        return loadCurrentUserProperties(this.instance);
+      },
+    }),
+    searchSiteUser: (searchValue: string) => {
+      this.sharepointVersion = '2013';
+      return fetchSiteUser(this.instance, searchValue);
+    },
+    searchUser: (input: string, filter?: string): Promise<PersonField> => {
+      this.sharepointVersion = '2013';
+      return typeAhead(this.instance, input, filter);
+    },
+    current: () => {
+      this.endpoint = '_api/web/currentUser';
+      this.sharepointVersion = '2013';
+      return {
+        get: (): Promise<CurrentUser> => getOnly(this.instance, this.endpoint),
+      };
+    },
+    currentPermission: () => ({
+      get: (): Promise<UserPermision> => {
+        this.sharepointVersion = '2013';
+        return resolveCurrentUserPermissions(this.getContext());
+      },
+    }),
+  };
+}
+
+export default HTTPSharePointRequests;