@memberjunction/core 2.53.0 → 2.54.0

package/dist/generic/databaseProviderBase.d.ts

@@ -0,0 +1,46 @@
+import { ProviderBase } from "./providerBase";
+import { UserInfo } from "./securityInfo";
+/**
+ * This class is a generic server-side provider class to abstract database operations
+ * on any database system and therefore be usable by server-side components that need to
+ * do database operations but do not want close coupling with a specific database provider
+ * like @see @memberjunction/sqlserver-dataprovider
+ */
+export declare abstract class DatabaseProviderBase extends ProviderBase {
+    /**
+     * Executes a SQL query with optional parameters and options.
+     * @param query
+     * @param parameters
+     * @param options
+     * @param contextUser
+     * @param T - The type of the result set
+     * @returns A promise that resolves to an array of results of type T
+     */
+    abstract ExecuteSQL<T>(query: string, parameters?: any[], options?: ExecuteSQLOptions, contextUser?: UserInfo): Promise<Array<T>>;
+    /**
+     * Begins a transaction for the current database connection.
+     */
+    abstract BeginTransaction(): Promise<void>;
+    /**
+     * Commits the current transaction.
+     */
+    abstract CommitTransaction(): Promise<void>;
+    /**
+     * Rolls back the current transaction.
+     */
+    abstract RollbackTransaction(): Promise<void>;
+}
+/**
+ * Configuration options for SQL execution with logging support
+ */
+export interface ExecuteSQLOptions {
+    /** Optional description for this SQL operation, used by logging, if logging is supported by the underlying provider */
+    description?: string;
+    /** If true, this statement will not be logged to any logging session */
+    ignoreLogging?: boolean;
+    /** Whether this is a data mutation operation (INSERT/UPDATE/DELETE or SP call that results in any data change) */
+    isMutation?: boolean;
+    /** Simple SQL fallback for loggers to emit logging of a simpler SQL statement that doesn't have extra functionality that isn't important for migrations or other logging purposes. */
+    simpleSQLFallback?: string;
+}
+//# sourceMappingURL=databaseProviderBase.d.ts.map

package/dist/generic/databaseProviderBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseProviderBase.d.ts","sourceRoot":"","sources":["../../src/generic/databaseProviderBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;GAKG;AACH,8BAAsB,oBAAqB,SAAQ,YAAY;IAC3D;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjI;;OAEG;IACH,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uHAAuH;IACvH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kHAAkH;IAClH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sLAAsL;IACtL,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/generic/databaseProviderBase.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseProviderBase = void 0;
+const providerBase_1 = require("./providerBase");
+/**
+ * This class is a generic server-side provider class to abstract database operations
+ * on any database system and therefore be usable by server-side components that need to
+ * do database operations but do not want close coupling with a specific database provider
+ * like @see @memberjunction/sqlserver-dataprovider
+ */
+class DatabaseProviderBase extends providerBase_1.ProviderBase {
+}
+exports.DatabaseProviderBase = DatabaseProviderBase;
+//# sourceMappingURL=databaseProviderBase.js.map

package/dist/generic/databaseProviderBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseProviderBase.js","sourceRoot":"","sources":["../../src/generic/databaseProviderBase.ts"],"names":[],"mappings":";;;AAAA,iDAA8C;AAG9C;;;;;GAKG;AACH,MAAsB,oBAAqB,SAAQ,2BAAY;CA0B9D;AA1BD,oDA0BC"}

package/dist/index.d.ts

@@ -17,5 +17,6 @@ export * from "./generic/queryInfo";
 export * from "./generic/compositeKey";
 export * from "./generic/authEvaluator";
 export * from "./generic/metadataUtil";
+export * from "./generic/databaseProviderBase";
 export declare function SetProvider(provider: any): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AAEvC,wBAAgB,WAAW,CAAC,QAAQ,KAAA,QAMnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,gCAAgC,CAAC;AAE/C,wBAAgB,WAAW,CAAC,QAAQ,KAAA,QAMnC"}

package/dist/index.js

@@ -39,6 +39,7 @@ __exportStar(require("./generic/queryInfo"), exports);
 __exportStar(require("./generic/compositeKey"), exports);
 __exportStar(require("./generic/authEvaluator"), exports);
 __exportStar(require("./generic/metadataUtil"), exports);
+__exportStar(require("./generic/databaseProviderBase"), exports);
 function SetProvider(provider) {
     metadata_1.Metadata.Provider = provider;
     baseEntity_1.BaseEntity.Provider = provider;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAkD;AAClD,iDAA8C;AAC9C,iDAA8C;AAC9C,mDAAgD;AAChD,6CAA0C;AAE1C,qDAAmC;AACnC,qDAAmC;AACnC,uDAAqC;AACrC,kDAAgC;AAChC,sDAAoC;AACpC,qDAAmC;AACnC,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAC1C,yDAAuC;AACvC,uDAAqC;AACrC,yDAAuC;AACvC,6DAA2C;AAC3C,iDAA+B;AAC/B,oDAAkC;AAClC,sDAAoC;AACpC,yDAAuC;AACvC,0DAAwC;AACxC,yDAAuC;AAEvC,SAAgB,WAAW,CAAC,QAAQ;IAChC,mBAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,uBAAU,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/B,iBAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC5B,qBAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,mBAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,CAAC;AAND,kCAMC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAkD;AAClD,iDAA8C;AAC9C,iDAA8C;AAC9C,mDAAgD;AAChD,6CAA0C;AAE1C,qDAAmC;AACnC,qDAAmC;AACnC,uDAAqC;AACrC,kDAAgC;AAChC,sDAAoC;AACpC,qDAAmC;AACnC,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAC1C,yDAAuC;AACvC,uDAAqC;AACrC,yDAAuC;AACvC,6DAA2C;AAC3C,iDAA+B;AAC/B,oDAAkC;AAClC,sDAAoC;AACpC,yDAAuC;AACvC,0DAAwC;AACxC,yDAAuC;AAEvC,iEAA+C;AAE/C,SAAgB,WAAW,CAAC,QAAQ;IAChC,mBAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,uBAAU,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/B,iBAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC5B,qBAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,mBAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,CAAC;AAND,kCAMC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/core",
-  "version": "2.53.0",
+  "version": "2.54.0",
   "description": "MemberJunction: Core Library including Metadata, Application, Entity Retrieval and Manipulation, and Utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
     "@types/debug": "^4.1.12"
   },
   "dependencies": {
-    "@memberjunction/global": "2.53.0",
+    "@memberjunction/global": "2.54.0",
     "rxjs": "^7.8.1",
     "zod": "^3.23.8",
     "debug": "^4.4.0"