@memberjunction/core 0.9.0

package/dist/generic/runView.d.ts

@@ -0,0 +1,106 @@
+import { IRunViewProvider, RunViewResult } from './interfaces';
+import { UserInfo } from './securityInfo';
+import { BaseEntity } from './baseEntity';
+/**
+ * Parameters for running either a stored or dynamic view.
+ * A stored view is a view that is saved in the database and can be run either by ID or Name.
+ * A dynamic view is one that is not stored in the database and you provide parameters to return data as
+ * desired programatically.
+ */
+export type RunViewParams = {
+    /**
+     * optional - ID of the UserView record to run, if provided, ViewName is ignored
+     */
+    ViewID?: number;
+    /**
+     * optional - Name of the UserView record to run, if you are using this, make sure to use a naming convention
+     * so that your view names are unique. For example use a prefix like __Entity_View_ etc so that you're
+     * likely to have a single result. If more than one view is available that matches a provided view name an
+     * exception will be thrown.
+     */
+    ViewName?: string;
+    /**
+     * optional - this is the loaded instance of the BaseEntity (UserViewEntityComplete or a subclass of it).
+     * This is the preferred parameter to use IF you already have a view entity object loaded up in your code
+     * becuase by passing this in, the RunView() method doesn't have to lookup all the metadata for the view and it is faster.
+     * If you provide ViewEntity, ViewID/ViewName are ignored.
+     */
+    ViewEntity?: BaseEntity;
+    /**
+     * optional - this is only used if ViewID/ViewName/ViewEntity are not provided, it is used for
+     * Dynamic Views in combination with the optional ExtraFilter
+     */
+    EntityName?: string;
+    /**
+     * An optional SQL WHERE clause that you can add to the existing filters on a stored view. For dynamic views, you can either
+     * run a view without a filter (if the entity definition allows it with AllowAllRowsAPI=1) or filter with any valid SQL WHERE clause.
+     */
+    ExtraFilter?: string;
+    /**
+     * An optional SQL ORDER BY clause that you can use for dynamic views, as well as to OVERRIDE the stored view's sorting order.
+     */
+    OrderBy?: string;
+    /**
+     * An optional array of field names that you want returned. The RunView() function will always return ID so you don't need to ask for that. If you leave this null then
+     * for a dynamic view all fields are returned, and for stored views, the fields stored in it view configuration are returned.
+      */
+    Fields?: string[];
+    /**
+     * optional - string that represents a user "search" - typically from a text search option in a UI somewhere. This field is then used in the view filtering to search whichever fields are configured to be included in search in the Entity Fields definition.
+     * Search String is combined with the stored view filters as well as ExtraFilter with an AND.
+     */
+    UserSearchString?: string;
+    /**
+     * optional - if provided, records that were returned in the specified UserViewRunID will NOT be allowed in the result set.
+     * This is useful if you want to run a particular view over time and exclude a specific prior run's resulting data set. If you
+     * want to exclude ALL data returned from ALL prior runs, use the ExcludeDataFromAllPriorViewRuns property instead.
+     */
+    ExcludeUserViewRunID?: number;
+    /**
+     * optional - if set to true, the resulting data will filter out ANY records that were ever returned by this view, when the SaveViewResults property was set to true.
+     * This is useful if you want to run a particular view over time and make sure the results returned each time are new to the view.
+     */
+    ExcludeDataFromAllPriorViewRuns?: boolean;
+    /**
+     * optional - if you are providing the optional ExcludeUserViewRunID property, you can also optionally provide
+     * this filter which will negate the specific list of record IDs that are excluded by the ExcludeUserViewRunID property.
+     * This can be useful if you want to ensure a certain class of data is always allowed into your view and not filtered out
+     * by a prior view run.
+     *
+     */
+    OverrideExcludeFilter?: string;
+    /**
+     * optional - if set to true, the LIST OF ID values from the view run will be stored in the User View Runs entity and the
+     * newly created UserViewRun.ID value will be returned in the RunViewResult that the RunView() function sends back to ya.
+     */
+    SaveViewResults?: boolean;
+    /**
+     * optional - if set to true, if there IS any UserViewMaxRows property set for the entity in question, it will be IGNORED. This is useful in scenarios where you
+     * want to programmatically run a view and get ALL the data back, regardless of the MaxRows setting on the entity.
+     */
+    IgnoreMaxRows?: boolean;
+    /**
+     * optional - if set to true, the view run will ALWAYS be logged to the Audit Log, regardless of the entity's property settings for logging view runs.
+     */
+    ForceAuditLog?: boolean;
+    /**
+     * optional - if provided and either ForceAuditLog is set, or the entity's property settings for logging view runs are set to true, this will be used as the Audit Log Description.
+     */
+    AuditLogDescription?: string;
+};
+/**
+ * Class for runnings views in a generic, tier-independent manner - uses a provider model for
+ * implementation transparently from the viewpoint of the consumer of the class.
+ */
+export declare class RunView {
+    /**
+     * Runs a view based on the provided parameters, see documentation for RunViewParams for more
+     * @param params
+     * @param contextUser if provided, this user is used for permissions and logging. For server based calls, this is generally required because there is no "Current User" since this object is shared across all requests.
+     * @returns
+     */
+    RunView(params: RunViewParams, contextUser?: UserInfo): Promise<RunViewResult>;
+    private static _globalProviderKey;
+    static get Provider(): IRunViewProvider;
+    static set Provider(value: IRunViewProvider);
+}

package/dist/generic/runView.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunView = void 0;
+const mj_global_1 = require("mj_global");
+/**
+ * Class for runnings views in a generic, tier-independent manner - uses a provider model for
+ * implementation transparently from the viewpoint of the consumer of the class.
+ */
+class RunView {
+    /**
+     * Runs a view based on the provided parameters, see documentation for RunViewParams for more
+     * @param params
+     * @param contextUser if provided, this user is used for permissions and logging. For server based calls, this is generally required because there is no "Current User" since this object is shared across all requests.
+     * @returns
+     */
+    async RunView(params, contextUser) {
+        return RunView.Provider.RunView(params, contextUser);
+    }
+    static get Provider() {
+        const g = mj_global_1.MJGlobal.Instance.GetGlobalObjectStore();
+        if (g)
+            return g[RunView._globalProviderKey];
+        else
+            throw new Error('No global object store, so we cant get the static provider');
+    }
+    static set Provider(value) {
+        const g = mj_global_1.MJGlobal.Instance.GetGlobalObjectStore();
+        if (g)
+            g[RunView._globalProviderKey] = value;
+        else
+            throw new Error('No global object store, so we cant set the static provider');
+    }
+}
+RunView._globalProviderKey = 'MJ_RunViewProvider';
+exports.RunView = RunView;
+//# sourceMappingURL=runView.js.map

package/dist/generic/runView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runView.js","sourceRoot":"","sources":["../../src/generic/runView.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AA6FrC;;;GAGG;AACH,MAAa,OAAO;IAChB;;;;;OAKG;IACI,KAAK,CAAC,OAAO,CAAC,MAAqB,EAAE,WAAsB;QAC9D,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;IAGM,MAAM,KAAK,QAAQ;QACtB,MAAM,CAAC,GAAG,oBAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QACnD,IAAI,CAAC;YACD,OAAO,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;;YAErC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACtF,CAAC;IACM,MAAM,KAAK,QAAQ,CAAC,KAAuB;QAC9C,MAAM,CAAC,GAAG,oBAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QACnD,IAAI,CAAC;YACD,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC;;YAEtC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACtF,CAAC;;AAdc,0BAAkB,GAAW,oBAAoB,CAAC;AAXxD,0BAAO"}

package/dist/generic/securityInfo.d.ts

@@ -0,0 +1,99 @@
+import { BaseInfo } from "./baseInfo";
+import { IMetadataProvider } from "./interfaces";
+export declare class UserInfo extends BaseInfo {
+    Name: string;
+    FirstName: string;
+    LastName: string;
+    Title: string;
+    Email: string;
+    Type: string;
+    IsActive: boolean;
+    LinkedRecordType: 'None' | 'Employee' | 'Other';
+    EmployeeID: number;
+    LinkedEntityID: number;
+    LinkedEntityRecordID: number;
+    CreatedAt: Date;
+    UpdatedAt: Date;
+    FirstLast: string;
+    EmployeeFirstLast: string;
+    EmployeeEmail: string;
+    EmployeeTitle: string;
+    EmployeeSupervisor: string;
+    EmployeeSupervisorEmail: string;
+    private _UserRoles;
+    get UserRoles(): UserRoleInfo[];
+    constructor(md: IMetadataProvider, initData?: any);
+    SetupUserRoles(md: IMetadataProvider, userRoles: UserRoleInfo[]): void;
+}
+export declare class UserRoleInfo extends BaseInfo {
+    UserID: number;
+    RoleName: string;
+    CreatedAt: Date;
+    UpdatedAt: Date;
+    User: string;
+    private _RoleInfo;
+    get RoleInfo(): RoleInfo;
+    _setRole(role: RoleInfo): void;
+    constructor(initData: any);
+}
+export declare class RoleInfo extends BaseInfo {
+    Name: string;
+    Description: string;
+    AzureID: string;
+    SQLName: string;
+    CreatedAt: Date;
+    UpdatedAt: Date;
+    constructor(initData: any);
+}
+export declare class RowLevelSecurityFilterInfo extends BaseInfo {
+    Name: string;
+    Description: string;
+    FilterText: string;
+    CreatedAt: Date;
+    UpdatedAt: Date;
+    constructor(initData: any);
+    MarkupFilterText(user: UserInfo): string;
+}
+export declare class AuthorizationInfo extends BaseInfo {
+    ParentID: number;
+    Name: string;
+    IsActive: boolean;
+    UseAuditLog: boolean;
+    Description: string;
+    CreatedAt: Date;
+    UpdatedAt: Date;
+    Parent: string;
+    private _AuthorizationRoles;
+    get Roles(): AuthorizationRoleInfo[];
+    constructor(md: IMetadataProvider, initData?: any);
+    SetupAuthorizationRoles(md: IMetadataProvider, authorizationRoles: AuthorizationRoleInfo[]): void;
+    UserCanExecute(user: UserInfo): boolean;
+}
+export declare enum AuthorizationRoleType {
+    Allow = 1,
+    Deny = 2
+}
+export declare class AuthorizationRoleInfo extends BaseInfo {
+    AuthorizationName: string;
+    RoleName: string;
+    Type: string;
+    CreatedAt: Date;
+    UpdatedAt: Date;
+    Authorization: string;
+    Role: string;
+    private _RoleInfo;
+    get RoleInfo(): RoleInfo;
+    AuthorizationType(): AuthorizationRoleType;
+    _setRole(role: RoleInfo): void;
+    constructor(initData: any);
+}
+export declare class AuditLogTypeInfo extends BaseInfo {
+    ParentID: number;
+    Name: string;
+    Description: string;
+    AuthorizationName: string;
+    CreatedAt: Date;
+    UpdatedAt: Date;
+    Parent: string;
+    constructor(initData: any);
+}

package/dist/generic/securityInfo.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogTypeInfo = exports.AuthorizationRoleInfo = exports.AuthorizationRoleType = exports.AuthorizationInfo = exports.RowLevelSecurityFilterInfo = exports.RoleInfo = exports.UserRoleInfo = exports.UserInfo = void 0;
+const baseInfo_1 = require("./baseInfo");
+class UserInfo extends baseInfo_1.BaseInfo {
+    get UserRoles() {
+        return this._UserRoles;
+    }
+    constructor(md, initData = null) {
+        super();
+        this.Name = null;
+        this.FirstName = null;
+        this.LastName = null;
+        this.Title = null;
+        this.Email = null;
+        this.Type = null;
+        this.IsActive = null;
+        this.LinkedRecordType = null;
+        this.EmployeeID = null;
+        this.LinkedEntityID = null;
+        this.LinkedEntityRecordID = null;
+        this.CreatedAt = null;
+        this.UpdatedAt = null;
+        // virtual fields - returned by the database VIEW
+        this.FirstLast = null;
+        this.EmployeeFirstLast = null;
+        this.EmployeeEmail = null;
+        this.EmployeeTitle = null;
+        this.EmployeeSupervisor = null;
+        this.EmployeeSupervisorEmail = null;
+        this._UserRoles = [];
+        this.copyInitData(initData);
+        if (initData)
+            this.SetupUserRoles(md, initData.UserRoles || initData._UserRoles);
+    }
+    SetupUserRoles(md, userRoles) {
+        if (userRoles) {
+            const mdRoles = md.Roles;
+            this._UserRoles = [];
+            for (let i = 0; i < userRoles.length; i++) {
+                // 
+                const uri = new UserRoleInfo(userRoles[i]);
+                this._UserRoles.push(uri);
+                const match = mdRoles.find(r => r.Name.trim().toLowerCase() == uri.RoleName.trim().toLowerCase());
+                if (match)
+                    uri._setRole(match);
+            }
+        }
+    }
+}
+exports.UserInfo = UserInfo;
+class UserRoleInfo extends baseInfo_1.BaseInfo {
+    get RoleInfo() {
+        return this._RoleInfo;
+    }
+    _setRole(role) {
+        this._RoleInfo = role;
+    }
+    constructor(initData) {
+        super();
+        this.UserID = null;
+        this.RoleName = null;
+        this.CreatedAt = null;
+        this.UpdatedAt = null;
+        // virtual fields - returned by the database VIEW
+        this.User = null;
+        this._RoleInfo = null;
+        this.copyInitData(initData);
+    }
+}
+exports.UserRoleInfo = UserRoleInfo;
+class RoleInfo extends baseInfo_1.BaseInfo {
+    constructor(initData) {
+        super();
+        this.Name = null;
+        this.Description = null;
+        this.AzureID = null;
+        this.SQLName = null;
+        this.CreatedAt = null;
+        this.UpdatedAt = null;
+        this.copyInitData(initData);
+    }
+}
+exports.RoleInfo = RoleInfo;
+class RowLevelSecurityFilterInfo extends baseInfo_1.BaseInfo {
+    constructor(initData) {
+        super();
+        this.Name = null;
+        this.Description = null;
+        this.FilterText = null;
+        this.CreatedAt = null;
+        this.UpdatedAt = null;
+        this.copyInitData(initData);
+    }
+    MarkupFilterText(user) {
+        let ret = this.FilterText;
+        if (user) {
+            const keys = Object.keys(user);
+            for (let i = 0; i < keys.length; i++) {
+                const key = keys[i];
+                const val = user[key];
+                if (val && typeof val == 'string') {
+                    ret = ret.replace(new RegExp(`{{User${key}}}`, 'g'), val);
+                }
+            }
+        }
+        return ret;
+    }
+}
+exports.RowLevelSecurityFilterInfo = RowLevelSecurityFilterInfo;
+class AuthorizationInfo extends baseInfo_1.BaseInfo {
+    get Roles() {
+        return this._AuthorizationRoles;
+    }
+    constructor(md, initData = null) {
+        super();
+        this.ParentID = null;
+        this.Name = null;
+        this.IsActive = null;
+        this.UseAuditLog = null;
+        this.Description = null;
+        this.CreatedAt = null;
+        this.UpdatedAt = null;
+        this._AuthorizationRoles = [];
+        this.copyInitData(initData);
+        if (initData)
+            this.SetupAuthorizationRoles(md, initData.AuthorizationRoles || initData._AuthorizationRoles);
+    }
+    SetupAuthorizationRoles(md, authorizationRoles) {
+        if (authorizationRoles) {
+            const mdRoles = md.Roles;
+            this._AuthorizationRoles = [];
+            for (let i = 0; i < authorizationRoles.length; i++) {
+                // 
+                const ari = new AuthorizationRoleInfo(authorizationRoles[i]);
+                this._AuthorizationRoles.push(ari);
+                const match = mdRoles.find(r => r.Name.trim().toLowerCase() == ari.RoleName.trim().toLowerCase());
+                if (match)
+                    ari._setRole(match);
+            }
+        }
+    }
+    UserCanExecute(user) {
+        if (this.IsActive && user && user.UserRoles) {
+            for (let i = 0; i < user.UserRoles.length; i++) {
+                const matchingRole = this.Roles.find(r => r.RoleName == user.UserRoles[i].RoleName);
+                if (matchingRole)
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+exports.AuthorizationInfo = AuthorizationInfo;
+var AuthorizationRoleType;
+(function (AuthorizationRoleType) {
+    AuthorizationRoleType[AuthorizationRoleType["Allow"] = 1] = "Allow";
+    AuthorizationRoleType[AuthorizationRoleType["Deny"] = 2] = "Deny";
+})(AuthorizationRoleType = exports.AuthorizationRoleType || (exports.AuthorizationRoleType = {}));
+class AuthorizationRoleInfo extends baseInfo_1.BaseInfo {
+    get RoleInfo() {
+        return this._RoleInfo;
+    }
+    AuthorizationType() {
+        return this.Type.trim().toLowerCase() === 'allow' ? AuthorizationRoleType.Allow : AuthorizationRoleType.Deny;
+    }
+    _setRole(role) {
+        this._RoleInfo = role;
+    }
+    constructor(initData) {
+        super();
+        this.AuthorizationName = null;
+        this.RoleName = null;
+        this.Type = null;
+        this.CreatedAt = null;
+        this.UpdatedAt = null;
+        this._RoleInfo = null;
+        this.copyInitData(initData);
+    }
+}
+exports.AuthorizationRoleInfo = AuthorizationRoleInfo;
+class AuditLogTypeInfo extends baseInfo_1.BaseInfo {
+    constructor(initData) {
+        super();
+        this.ParentID = null;
+        this.Name = null;
+        this.Description = null;
+        this.AuthorizationName = null;
+        this.CreatedAt = null;
+        this.UpdatedAt = null;
+        this.copyInitData(initData);
+    }
+}
+exports.AuditLogTypeInfo = AuditLogTypeInfo;
+//# sourceMappingURL=securityInfo.js.map

package/dist/generic/securityInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"securityInfo.js","sourceRoot":"","sources":["../../src/generic/securityInfo.ts"],"names":[],"mappings":"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"}

package/dist/generic/transactionGroup.d.ts

@@ -0,0 +1,24 @@
+export declare class TransactionItem {
+    private _instruction;
+    private _vars;
+    private _callBack;
+    private _extraData;
+    get Vars(): any;
+    get ExtraData(): any;
+    get Instruction(): string;
+    get CallBack(): Function;
+    constructor(instruction: string, vars: any, extraData: any, callBack: Function);
+}
+export declare class TransactionResult {
+    Transaction: TransactionItem;
+    Result: any;
+    Success: boolean;
+    constructor(transaction: TransactionItem, result: any, success: boolean);
+}
+export declare abstract class TransactionGroupBase {
+    private _pendingTransactions;
+    protected PendingTransactions(): TransactionItem[];
+    AddTransaction(transaction: TransactionItem): void;
+    protected abstract HandleSubmit(item: TransactionItem[]): Promise<TransactionResult[]>;
+    Submit(): Promise<boolean>;
+}

package/dist/generic/transactionGroup.js

@@ -0,0 +1,79 @@
+"use strict";
+/* TransactionGroup is a class that handles the bundling of multiple transactions into a single request. The provider handles
+   the implementation details. If a transaction group is provided to the baseEntity object before either Save() or Delete() is called
+   instead of just immediately executing its SQL or GQL, it provides the instructions to the TransactionGroup object instead.
+
+   Then, whenever the TransactionGroup object instance has its Submit() method called, all of the requests will be bundled into a single
+   request and handled. For example in the case of the GraphQLDataProvider, we queue up all of the GQL statements for all of the
+   mutations and send them across as a single GraphQL request. The GraphQL server handles the actual DB transaction stuff.
+
+   TransactionGroup will call a callback function, if provided, after the transaction has either completed succesfully or failed.
+   If it is succesful, for Save() method calls, the latest data for that record will be provided back.
+   For Delete() method calls, the callback will be called with no data.
+
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionGroupBase = exports.TransactionResult = exports.TransactionItem = void 0;
+class TransactionItem {
+    get Vars() {
+        return this._vars;
+    }
+    get ExtraData() {
+        return this._extraData;
+    }
+    get Instruction() {
+        return this._instruction;
+    }
+    get CallBack() {
+        return this._callBack;
+    }
+    constructor(instruction, vars, extraData, callBack) {
+        this._instruction = instruction;
+        this._vars = vars;
+        this._extraData = extraData;
+        this._callBack = callBack;
+    }
+}
+exports.TransactionItem = TransactionItem;
+class TransactionResult {
+    constructor(transaction, result, success) {
+        this.Transaction = transaction;
+        this.Result = result;
+        this.Success = success;
+    }
+}
+exports.TransactionResult = TransactionResult;
+class TransactionGroupBase {
+    constructor() {
+        this._pendingTransactions = [];
+    }
+    PendingTransactions() {
+        return this._pendingTransactions;
+    }
+    AddTransaction(transaction) {
+        this._pendingTransactions.push(transaction);
+    }
+    async Submit() {
+        try {
+            if (this._pendingTransactions.length > 0) {
+                // subclass handles the actual submit implementation whatever that does
+                let results = await this.HandleSubmit(this._pendingTransactions);
+                // now we have the results back, so we can call the callback functions
+                for (let i = 0; i < results.length; i++) {
+                    await results[i].Transaction.CallBack(results[i].Result, results[i].Success);
+                }
+            }
+            return true;
+        }
+        catch (err) {
+            console.error(err);
+            // it failed, so we have to call the callback functions with the error
+            for (let i = 0; i < this._pendingTransactions.length; i++) {
+                await this._pendingTransactions[i].CallBack(err, false);
+            }
+            return false;
+        }
+    }
+}
+exports.TransactionGroupBase = TransactionGroupBase;
+//# sourceMappingURL=transactionGroup.js.map

package/dist/generic/transactionGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionGroup.js","sourceRoot":"","sources":["../../src/generic/transactionGroup.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;EAYE;;;AAEF,MAAa,eAAe;IAMxB,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IACD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,YAAa,WAAmB,EAAE,IAAS,EAAE,SAAc,EAAE,QAAkB;QAC3E,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;CACJ;AAzBD,0CAyBC;AAED,MAAa,iBAAiB;IAK1B,YAAY,WAA4B,EAAE,MAAW,EAAE,OAAgB;QACnE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ;AAVD,8CAUC;AAED,MAAsB,oBAAoB;IAA1C;QACY,yBAAoB,GAAsB,EAAE,CAAC;IAmCzD,CAAC;IAjCa,mBAAmB;QACzB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACrC,CAAC;IAEM,cAAc,CAAC,WAA4B;QAC9C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAIM,KAAK,CAAC,MAAM;QACf,IAAI;YACA,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE;gBACtC,uEAAuE;gBACvE,IAAI,OAAO,GAAwB,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBAEtF,sEAAsE;gBACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBACrC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;iBAChF;aACJ;YACD,OAAO,IAAI,CAAC;SACf;QACD,OAAO,GAAG,EAAE;YACR,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnB,sEAAsE;YACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBACvD,MAAM,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;aAC3D;YACD,OAAO,KAAK,CAAC;SAChB;IACL,CAAC;CAEJ;AApCD,oDAoCC"}

package/dist/generic/util.d.ts

@@ -0,0 +1,4 @@
+export declare function TypeScriptTypeFromSQLType(sqlType: string): string;
+export declare function FormatValue(sqlType: string, value: any, decimals?: number, currency?: string): string;
+export declare function SQLFullType(baseType: string, length: number, precision: number, scale: number): string;
+export declare function SQLMaxLength(sqlBaseType: string, sqlLength: number): number;

package/dist/generic/util.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLMaxLength = exports.SQLFullType = exports.FormatValue = exports.TypeScriptTypeFromSQLType = void 0;
+const logging_1 = require("./logging");
+function TypeScriptTypeFromSQLType(sqlType) {
+    switch (sqlType.trim().toLowerCase()) {
+        case 'text':
+        case 'char':
+        case 'varchar':
+        case 'ntext':
+        case 'nchar':
+        case 'nvarchar':
+        case 'uniqueidentifier': //treat this as a string
+            return 'string';
+        case 'datetime':
+        case 'datetime2':
+        case 'datetimeoffset':
+        case 'date':
+        case 'time':
+            return 'Date';
+        case 'bit':
+            return 'boolean';
+        default:
+            return 'number';
+    }
+}
+exports.TypeScriptTypeFromSQLType = TypeScriptTypeFromSQLType;
+function FormatValue(sqlType, value, decimals = 2, currency = 'USD') {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    try {
+        switch (sqlType.toLowerCase()) {
+            case 'money':
+                if (isNaN(value))
+                    return value;
+                else
+                    return new Intl.NumberFormat(undefined, { style: 'currency',
+                        currency: currency,
+                        minimumFractionDigits: decimals,
+                        maximumFractionDigits: decimals }).format(value);
+            case 'date':
+            case 'datetime':
+            case 'datetimeoffset':
+                let date = new Date(value);
+                return new Intl.DateTimeFormat().format(date);
+            case 'decimal':
+            case 'real':
+            case 'float':
+                return new Intl.NumberFormat(undefined, { minimumFractionDigits: decimals, maximumFractionDigits: decimals }).format(value);
+            case 'int':
+                return new Intl.NumberFormat(undefined, { minimumFractionDigits: 0, maximumFractionDigits: 0 }).format(value);
+            case 'percent':
+                return new Intl.NumberFormat(undefined, { style: 'percent',
+                    minimumFractionDigits: decimals,
+                    maximumFractionDigits: decimals }).format(value);
+            default:
+                return value;
+        }
+    }
+    catch (e) {
+        (0, logging_1.LogError)(`Error formatting value ${value} of type ${sqlType} with decimals ${decimals} and currency ${currency}`, e);
+        return value; // just return the value as is if we cant format it
+    }
+}
+exports.FormatValue = FormatValue;
+function SQLFullType(baseType, length, precision, scale) {
+    const type = baseType.trim().toLowerCase();
+    let sOutput = type;
+    if (type === 'varchar')
+        sOutput += `(${length > 0 ? length : 'MAX'})`;
+    else if (type === 'nvarchar')
+        sOutput += `(${length > 0 ? length / 2 : 'MAX'})`; // nvarchar divide the system length by 2 to get the actual length for the output
+    else if (type === 'char')
+        sOutput += `(${length})`;
+    else if (type === 'nchar')
+        sOutput += `(${length / 2})`; // nchar divide the system length by 2 to get the actual length for the output
+    else if (type === 'decimal' || type === 'numeric')
+        sOutput += `(${precision}, ${scale})`;
+    else if (type === 'float')
+        sOutput += `(${precision})`;
+    return sOutput;
+}
+exports.SQLFullType = SQLFullType;
+function SQLMaxLength(sqlBaseType, sqlLength) {
+    switch (sqlBaseType.trim().toLowerCase()) {
+        case 'varchar':
+        case 'char':
+        case 'text':
+            return sqlLength;
+        case 'nvarchar':
+        case 'nchar':
+        case 'ntext':
+            return sqlLength / 2; // length in the schema is the # of bytes and on unicode fields we divide by 2 to get the # of characters a user is allowed to put in.
+        default:
+            return 0;
+    }
+}
+exports.SQLMaxLength = SQLMaxLength;
+//# sourceMappingURL=util.js.map