@olenbetong/appframe-core 2.1.2 → 2.3.0

package/es/date.d.ts

@@ -0,0 +1,2 @@
+export declare function toLocalISODate(date: Date): string;
+export declare function toLocalISODateTime(date: Date): string;

package/es/date.js

@@ -0,0 +1,12 @@
+export function toLocalISODate(date) {
+    return toLocalISODateTime(date).substring(0, 10);
+}
+export function toLocalISODateTime(date) {
+    let newDate = new Date(date);
+    newDate.setUTCFullYear(date.getFullYear());
+    newDate.setUTCMonth(date.getMonth());
+    newDate.setUTCDate(date.getDate());
+    newDate.setUTCHours(date.getHours());
+    newDate.setUTCMinutes(date.getMinutes());
+    return newDate.toISOString().replace("Z", "");
+}

package/es/getUserImage.d.ts

@@ -0,0 +1,31 @@
+export declare type ImageSize = "xs" | "sm" | "md" | "lg" | "xl";
+export interface getUserImageOptions {
+    /**
+     * Prim key of the record in atbl_Personnel_Employees
+     */
+    primKey: string | null;
+    /**
+     * Person ID of the employee
+     */
+    login: string | null;
+    /**
+     * The value of the ImageHash column in atbl_Personnel_Employees
+     */
+    hash: string | number | null;
+    /**
+     * The image will be resized according to this value. Default is 'xs':
+     * - xs: 64px
+     * - sm: 128px
+     * - md: 256px
+     * - lg: 512px
+     * - xl: image is not resized
+     */
+    size?: ImageSize;
+}
+/**
+ * Returns the absolute path of a users profile picture. Uses the EmployeesLookup
+ * data resource to enable caching across applications.
+ *
+ * If one of primKey or hash are not provided, or are null, an empty string will be returned.
+ */
+export declare function getUserImage({ primKey, login, hash, size }: getUserImageOptions): string;

package/es/getUserImage.js

@@ -0,0 +1,20 @@
+const sizeMap = {
+    xs: 64,
+    sm: 128,
+    md: 256,
+    lg: 512,
+    xl: undefined,
+};
+/**
+ * Returns the absolute path of a users profile picture. Uses the EmployeesLookup
+ * data resource to enable caching across applications.
+ *
+ * If one of primKey or hash are not provided, or are null, an empty string will be returned.
+ */
+export function getUserImage({ primKey, login, hash, size = "xs" }) {
+    if (!primKey || !hash) {
+        return "";
+    }
+    let sizePx = sizeMap[size];
+    return `/api/data/blob/EmployeesLookup/${primKey}/Image/${login}${login ? "." : ""}${hash}.jpg${sizePx ? `?width=${sizePx}` : ""}`;
+}

package/es/index.d.ts

@@ -1,9 +1,11 @@
 import "./errorHandler.js";
 import { UserSession } from "./UserSession.js";
 export { default as mitt } from "mitt";
+export * from "./date.js";
 export { downloadBlob } from "./downloadBlob.js";
 export * from "./downloadRequest.js";
 export { expose } from "./expose.js";
+export * from "./getUserImage.js";
 export { getLocalizedString } from "./getLocalizedString.js";
 export { localize } from "./localize.js";
 export * from "./has.js";

package/es/index.js

@@ -1,9 +1,11 @@
 import "./errorHandler.js";
 import { UserSession } from "./UserSession.js";
 export { default as mitt } from "mitt";
+export * from "./date.js";
 export { downloadBlob } from "./downloadBlob.js";
 export * from "./downloadRequest.js";
 export { expose } from "./expose.js";
+export * from "./getUserImage.js";
 export { getLocalizedString } from "./getLocalizedString.js";
 export { localize } from "./localize.js";
 export * from "./has.js";
@@ -11,4 +13,4 @@ export { default as localStorage } from "./localStorage.js";
 export { default as SessionHandler } from "./SessionHandler.js";
 export { UserSession };
 export * from "./settings.js";
-export const version = "2.1.2";
+export const version = "2.3.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olenbetong/appframe-core",
-  "version": "2.1.2",
+  "version": "2.3.0",
   "description": "Javascript libraries to utilize the Appframe framework",
   "type": "module",
   "sideEffects": [
@@ -48,5 +48,5 @@
   "devDependencies": {
     "chalk": "^5.0.1"
   },
-  "gitHead": "16ac538bb4913c802543c23671e4169fa7c7607b"
+  "gitHead": "266f97a293771bb2c7e5a97fad143240c6c4e446"
 }

package/src/date.ts

@@ -0,0 +1,14 @@
+export function toLocalISODate(date: Date) {
+  return toLocalISODateTime(date).substring(0, 10);
+}
+
+export function toLocalISODateTime(date: Date) {
+  let newDate = new Date(date);
+  newDate.setUTCFullYear(date.getFullYear());
+  newDate.setUTCMonth(date.getMonth());
+  newDate.setUTCDate(date.getDate());
+  newDate.setUTCHours(date.getHours());
+  newDate.setUTCMinutes(date.getMinutes());
+
+  return newDate.toISOString().replace("Z", "");
+}

package/src/getUserImage.ts

@@ -0,0 +1,50 @@
+export type ImageSize = "xs" | "sm" | "md" | "lg" | "xl";
+
+export interface getUserImageOptions {
+  /**
+   * Prim key of the record in atbl_Personnel_Employees
+   */
+  primKey: string | null;
+  /**
+   * Person ID of the employee
+   */
+  login: string | null;
+  /**
+   * The value of the ImageHash column in atbl_Personnel_Employees
+   */
+  hash: string | number | null;
+  /**
+   * The image will be resized according to this value. Default is 'xs':
+   * - xs: 64px
+   * - sm: 128px
+   * - md: 256px
+   * - lg: 512px
+   * - xl: image is not resized
+   */
+  size?: ImageSize;
+}
+
+const sizeMap: Record<ImageSize, number | undefined> = {
+  xs: 64,
+  sm: 128,
+  md: 256,
+  lg: 512,
+  xl: undefined,
+};
+
+/**
+ * Returns the absolute path of a users profile picture. Uses the EmployeesLookup
+ * data resource to enable caching across applications.
+ *
+ * If one of primKey or hash are not provided, or are null, an empty string will be returned.
+ */
+export function getUserImage({ primKey, login, hash, size = "xs" }: getUserImageOptions) {
+  if (!primKey || !hash) {
+    return "";
+  }
+
+  let sizePx = sizeMap[size];
+  return `/api/data/blob/EmployeesLookup/${primKey}/Image/${login}${login ? "." : ""}${hash}.jpg${
+    sizePx ? `?width=${sizePx}` : ""
+  }`;
+}

package/src/index.ts

@@ -3,9 +3,11 @@ import "./errorHandler.js";
 import { UserSession } from "./UserSession.js";
 
 export { default as mitt } from "mitt";
+export * from "./date.js";
 export { downloadBlob } from "./downloadBlob.js";
 export * from "./downloadRequest.js";
 export { expose } from "./expose.js";
+export * from "./getUserImage.js";
 export { getLocalizedString } from "./getLocalizedString.js";
 export { localize } from "./localize.js";
 export * from "./has.js";