softkave-node-utils 0.1.0

package/build/src/contexts/injection/keys.d.ts

@@ -0,0 +1,22 @@
+export declare const kInjectionKeys: {
+    data: {
+        utils: string;
+    };
+    semantic: {
+        utils: string;
+    };
+    encryption: string;
+    suppliedConfig: string;
+    runtimeConfig: string;
+    secretsManager: string;
+    fileProviderResolver: string;
+    asyncLocalStorage: string;
+    session: string;
+    dbConnection: string;
+    email: string;
+    promises: string;
+    locks: string;
+    disposables: string;
+    usageLogic: string;
+    logger: string;
+};

package/build/src/contexts/injection/keys.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kInjectionKeys = void 0;
+function dataKey(name) {
+    return `data_${name}`;
+}
+function semanticKey(name) {
+    return `semantic_${name}`;
+}
+exports.kInjectionKeys = {
+    data: {
+        utils: dataKey('utils'),
+    },
+    semantic: {
+        utils: semanticKey('utils'),
+    },
+    encryption: 'encryption',
+    // config: 'config',
+    suppliedConfig: 'suppliedConfig',
+    runtimeConfig: 'runtimeConfig',
+    secretsManager: 'secretsManager',
+    fileProviderResolver: 'fileProviderResolver',
+    asyncLocalStorage: 'asyncLocalStorage',
+    session: 'session',
+    dbConnection: 'dbConnection',
+    email: 'email',
+    promises: 'promises',
+    locks: 'locks',
+    disposables: 'disposables',
+    usageLogic: 'usageLogic',
+    logger: 'logger',
+};
+//# sourceMappingURL=keys.js.map

package/build/src/contexts/injection/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../src/contexts/injection/keys.ts"],"names":[],"mappings":";;;AAAA,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,YAAY,IAAI,EAAE,CAAC;AAC5B,CAAC;AAEY,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC;KACxB;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;KAC5B;IACD,UAAU,EAAE,YAAY;IACxB,oBAAoB;IACpB,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;CACjB,CAAC"}

package/build/src/contexts/injection/register.d.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { DisposablesStore, LockStore, PromiseStore } from 'softkave-js-utils';
+import { DbConnection } from '../../mongodb/connection';
+import { SessionContextType } from '../SessionContext';
+import { AsyncLocalStorageUtils } from '../asyncLocalStorage';
+import { FimidaraSuppliedConfig } from '../config';
+import { DataProviderUtils } from '../data/types';
+import { IEmailProviderContext } from '../email/types';
+import { SecretsManagerProvider } from '../encryption/types';
+import { Logger } from '../logger/types';
+import { SemanticProviderUtils } from '../semantic/types';
+export declare const kRegisterSemanticModels: {
+    utils: (item: SemanticProviderUtils) => void;
+};
+export declare const kRegisterDataModels: {
+    utils: (item: DataProviderUtils) => void;
+};
+export declare const kRegisterUtilsInjectables: {
+    suppliedConfig: (item: FimidaraSuppliedConfig) => void;
+    secretsManager: (item: SecretsManagerProvider) => void;
+    asyncLocalStorage: (item: AsyncLocalStorageUtils) => void;
+    session: (item: SessionContextType) => void;
+    mongoConnection: (item: DbConnection) => void;
+    email: (item: IEmailProviderContext) => void;
+    promises: (item: PromiseStore) => void;
+    locks: (item: LockStore) => void;
+    disposables: (item: DisposablesStore) => void;
+    logger: (item: Logger) => void;
+};
+export declare function registerDataModelInjectables(): void;
+export declare function registerSemanticModelInjectables(): void;
+export declare function registerUtilsInjectables(): void;
+export declare function registerInjectables(): void;

package/build/src/contexts/injection/register.js

@@ -0,0 +1,107 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInjectables = exports.registerUtilsInjectables = exports.registerSemanticModelInjectables = exports.registerDataModelInjectables = exports.kRegisterUtilsInjectables = exports.kRegisterDataModels = exports.kRegisterSemanticModels = void 0;
+require("reflect-metadata");
+const assert_1 = __importDefault(require("assert"));
+const lodash_1 = require("lodash");
+const softkave_js_utils_1 = require("softkave-js-utils");
+const tsyringe_1 = require("tsyringe");
+const connection_1 = require("../../mongodb/connection");
+const NoopEmailProviderContext_1 = __importDefault(require("../../testUtils/context/email/NoopEmailProviderContext"));
+const SessionContext_1 = __importDefault(require("../SessionContext"));
+const asyncLocalStorage_1 = require("../asyncLocalStorage");
+const config_1 = require("../config");
+const MongoDataProviderUtils_1 = require("../data/MongoDataProviderUtils");
+const SESEmailProviderContext_1 = require("../email/SESEmailProviderContext");
+const AWSSecretsManagerProvider_1 = require("../encryption/AWSSecretsManagerProvider");
+const MemorySecretsManagerProvider_1 = require("../encryption/MemorySecretsManagerProvider");
+const utils_1 = require("../logger/utils");
+const utils_2 = require("../semantic/utils");
+const injectables_1 = require("./injectables");
+const keys_1 = require("./keys");
+function registerToken(token, item, use = 'value') {
+    if (use === 'factory') {
+        (0, assert_1.default)((0, lodash_1.isFunction)(item));
+        tsyringe_1.container.register(token, { useFactory: item });
+    }
+    else {
+        if ((0, lodash_1.isFunction)(item === null || item === void 0 ? void 0 : item.dispose)) {
+            injectables_1.kUtilsInjectables.disposables().add(item);
+        }
+        tsyringe_1.container.register(token, { useValue: item });
+    }
+}
+exports.kRegisterSemanticModels = {
+    utils: (item) => registerToken(keys_1.kInjectionKeys.semantic.utils, item),
+};
+exports.kRegisterDataModels = {
+    utils: (item) => registerToken(keys_1.kInjectionKeys.data.utils, item),
+};
+exports.kRegisterUtilsInjectables = {
+    // config: (item: FimidaraConfig) => register(kInjectionKeys.config, item),
+    suppliedConfig: (item) => registerToken(keys_1.kInjectionKeys.suppliedConfig, item),
+    secretsManager: (item) => registerToken(keys_1.kInjectionKeys.secretsManager, item),
+    asyncLocalStorage: (item) => registerToken(keys_1.kInjectionKeys.asyncLocalStorage, item),
+    session: (item) => registerToken(keys_1.kInjectionKeys.session, item),
+    mongoConnection: (item) => registerToken(keys_1.kInjectionKeys.dbConnection, item),
+    email: (item) => registerToken(keys_1.kInjectionKeys.email, item),
+    promises: (item) => registerToken(keys_1.kInjectionKeys.promises, item),
+    locks: (item) => registerToken(keys_1.kInjectionKeys.locks, item),
+    disposables: (item) => registerToken(keys_1.kInjectionKeys.disposables, item),
+    logger: (item) => registerToken(keys_1.kInjectionKeys.logger, item),
+};
+function registerDataModelInjectables() {
+    const connection = injectables_1.kUtilsInjectables.dbConnection().get();
+    (0, assert_1.default)((0, connection_1.isMongoConnection)(connection));
+    exports.kRegisterDataModels.utils(new MongoDataProviderUtils_1.MongoDataProviderUtils());
+}
+exports.registerDataModelInjectables = registerDataModelInjectables;
+function registerSemanticModelInjectables() {
+    exports.kRegisterSemanticModels.utils(new utils_2.DataSemanticProviderUtils());
+}
+exports.registerSemanticModelInjectables = registerSemanticModelInjectables;
+function registerUtilsInjectables() {
+    var _a, _b, _c, _d, _e, _f;
+    const suppliedConfig = (0, config_1.getSuppliedConfig)();
+    const promiseStore = new softkave_js_utils_1.PromiseStore();
+    exports.kRegisterUtilsInjectables.suppliedConfig(suppliedConfig);
+    exports.kRegisterUtilsInjectables.promises(promiseStore);
+    exports.kRegisterUtilsInjectables.disposables(new softkave_js_utils_1.DisposablesStore(promiseStore));
+    exports.kRegisterUtilsInjectables.asyncLocalStorage(asyncLocalStorage_1.kAsyncLocalStorageUtils);
+    exports.kRegisterUtilsInjectables.locks(new softkave_js_utils_1.LockStore());
+    exports.kRegisterUtilsInjectables.session(new SessionContext_1.default());
+    exports.kRegisterUtilsInjectables.logger((0, utils_1.getLogger)(suppliedConfig.loggerType));
+    (0, assert_1.default)(suppliedConfig.mongoDbURI);
+    (0, assert_1.default)(suppliedConfig.mongoDbDatabaseName);
+    exports.kRegisterUtilsInjectables.mongoConnection(new connection_1.MongoDbConnection(suppliedConfig.mongoDbURI, suppliedConfig.mongoDbDatabaseName));
+    if (suppliedConfig.emailProvider === config_1.kFimidaraConfigEmailProvider.ses) {
+        (0, assert_1.default)((_a = suppliedConfig.awsConfig) === null || _a === void 0 ? void 0 : _a.accessKeyId);
+        (0, assert_1.default)((_b = suppliedConfig.awsConfig) === null || _b === void 0 ? void 0 : _b.region);
+        (0, assert_1.default)((_c = suppliedConfig.awsConfig) === null || _c === void 0 ? void 0 : _c.secretAccessKey);
+        exports.kRegisterUtilsInjectables.email(new SESEmailProviderContext_1.SESEmailProviderContext(suppliedConfig.awsConfig));
+    }
+    else {
+        exports.kRegisterUtilsInjectables.email(new NoopEmailProviderContext_1.default());
+    }
+    if (suppliedConfig.secretsManagerProvider ===
+        config_1.kFimidaraConfigSecretsManagerProvider.awsSecretsManager) {
+        (0, assert_1.default)((_d = suppliedConfig.awsConfig) === null || _d === void 0 ? void 0 : _d.accessKeyId);
+        (0, assert_1.default)((_e = suppliedConfig.awsConfig) === null || _e === void 0 ? void 0 : _e.region);
+        (0, assert_1.default)((_f = suppliedConfig.awsConfig) === null || _f === void 0 ? void 0 : _f.secretAccessKey);
+        exports.kRegisterUtilsInjectables.secretsManager(new AWSSecretsManagerProvider_1.AWSSecretsManagerProvider(suppliedConfig.awsConfig));
+    }
+    else {
+        exports.kRegisterUtilsInjectables.secretsManager(new MemorySecretsManagerProvider_1.MemorySecretsManagerProvider());
+    }
+}
+exports.registerUtilsInjectables = registerUtilsInjectables;
+function registerInjectables() {
+    registerUtilsInjectables();
+    registerDataModelInjectables();
+    registerSemanticModelInjectables();
+}
+exports.registerInjectables = registerInjectables;
+//# sourceMappingURL=register.js.map

package/build/src/contexts/injection/register.js.map

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

package/build/src/contexts/logger/noop.d.ts

@@ -0,0 +1,5 @@
+import { Logger } from './types';
+export declare class NoopLogger implements Logger {
+    log: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}

package/build/src/contexts/logger/noop.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopLogger = void 0;
+const lodash_1 = require("lodash");
+class NoopLogger {
+    constructor() {
+        this.log = lodash_1.noop;
+        this.error = lodash_1.noop;
+    }
+}
+exports.NoopLogger = NoopLogger;
+//# sourceMappingURL=noop.js.map

package/build/src/contexts/logger/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../../src/contexts/logger/noop.ts"],"names":[],"mappings":";;;AAAA,mCAA4B;AAG5B,MAAa,UAAU;IAAvB;QACE,QAAG,GAAiC,aAAI,CAAC;QACzC,UAAK,GAAiC,aAAI,CAAC;IAC7C,CAAC;CAAA;AAHD,gCAGC"}

package/build/src/contexts/logger/types.d.ts

@@ -0,0 +1,11 @@
+import { DisposableResource } from 'softkave-js-utils';
+import { ValueOf } from 'type-fest';
+export interface Logger extends DisposableResource {
+    log: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+export declare const kLoggerTypes: {
+    readonly console: "console";
+    readonly noop: "noop";
+};
+export type LoggerType = ValueOf<typeof kLoggerTypes>;

package/build/src/contexts/logger/types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kLoggerTypes = void 0;
+exports.kLoggerTypes = {
+    console: 'console',
+    noop: 'noop',
+};
+//# sourceMappingURL=types.js.map

package/build/src/contexts/logger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/contexts/logger/types.ts"],"names":[],"mappings":";;;AAQa,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/build/src/contexts/logger/utils.d.ts

@@ -0,0 +1,2 @@
+import { Logger, LoggerType } from './types';
+export declare function getLogger(type?: LoggerType): Logger;

package/build/src/contexts/logger/utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogger = void 0;
+const noop_1 = require("./noop");
+const types_1 = require("./types");
+function getLogger(type = types_1.kLoggerTypes.noop) {
+    switch (type) {
+        case types_1.kLoggerTypes.console:
+            return console;
+        case types_1.kLoggerTypes.noop:
+            return new noop_1.NoopLogger();
+    }
+}
+exports.getLogger = getLogger;
+//# sourceMappingURL=utils.js.map

package/build/src/contexts/logger/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/contexts/logger/utils.ts"],"names":[],"mappings":";;;AAAA,iCAAkC;AAClC,mCAAyD;AAEzD,SAAgB,SAAS,CAAC,OAAmB,oBAAY,CAAC,IAAI;IAC5D,QAAQ,IAAI,EAAE;QACZ,KAAK,oBAAY,CAAC,OAAO;YACvB,OAAO,OAAO,CAAC;QACjB,KAAK,oBAAY,CAAC,IAAI;YACpB,OAAO,IAAI,iBAAU,EAAE,CAAC;KAC3B;AACH,CAAC;AAPD,8BAOC"}

package/build/src/contexts/semantic/DataSemanticDataAccessBaseProvider.d.ts

@@ -0,0 +1,28 @@
+import { AnyObject } from 'softkave-js-utils';
+import { Agent } from '../../definitions/agent';
+import { Resource } from '../../definitions/resource';
+import { BaseDataProvider, DataQuery } from '../data/types';
+import { SemanticBaseProviderType, SemanticProviderMutationOpOptions, SemanticProviderMutationTxnOptions, SemanticProviderOpOptions, SemanticProviderQueryListRunOptions, SemanticProviderQueryRunOptions } from './types';
+export declare class DataSemanticBaseProvider<T extends Resource> implements SemanticBaseProviderType<T> {
+    protected data: BaseDataProvider<T, DataQuery<T>>;
+    protected assertFn: (item?: T | null) => asserts item;
+    constructor(data: BaseDataProvider<T, DataQuery<T>>, assertFn: (item?: T | null) => asserts item);
+    insertItem(item: T | T[], opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    getOneById(id: string, opts?: SemanticProviderQueryRunOptions<T> | undefined): Promise<T | null>;
+    existsById(id: string, opts?: SemanticProviderOpOptions | undefined): Promise<boolean>;
+    updateOneById(id: string, update: Partial<T>, opts: SemanticProviderMutationOpOptions): Promise<void>;
+    updateManyByQuery(query: DataQuery<T>, update: Partial<T>, opts: SemanticProviderMutationOpOptions): Promise<void>;
+    getAndUpdateOneById(id: string, update: Partial<T>, opts: SemanticProviderMutationOpOptions & SemanticProviderQueryRunOptions<T>): Promise<T | null>;
+    deleteManyByIdList(idList: string[], opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    softDeleteManyByIdList(idList: string[], agent: Agent, opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    deleteOneById(id: string, opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    countManyByIdList(idList: string[], opts?: SemanticProviderOpOptions | undefined): Promise<number>;
+    getManyByIdList(idList: string[], opts?: SemanticProviderQueryListRunOptions<T> | undefined): Promise<T[]>;
+    countByQuery(query: DataQuery<T>, opts?: SemanticProviderOpOptions | undefined): Promise<number>;
+    getManyByQuery(query: DataQuery<T>, opts?: SemanticProviderQueryListRunOptions<T> | undefined): Promise<T[]>;
+    assertGetOneByQuery(query: DataQuery<T>, opts?: SemanticProviderQueryRunOptions<T> | undefined): Promise<T>;
+    existsByQuery(query: DataQuery<T>, opts?: SemanticProviderOpOptions | undefined): Promise<boolean>;
+    getOneByQuery(query: DataQuery<T>, opts?: SemanticProviderQueryRunOptions<T> | undefined): Promise<T | null>;
+    deleteManyByQuery(query: DataQuery<T>, opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    protected softDeleteManyByQuery(query: DataQuery<AnyObject>, agent: Agent, opts: SemanticProviderMutationTxnOptions): Promise<void>;
+}

package/build/src/contexts/semantic/DataSemanticDataAccessBaseProvider.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSemanticBaseProvider = void 0;
+const lodash_1 = require("lodash");
+const softkave_js_utils_1 = require("softkave-js-utils");
+function mergeIsDeletedIntoQuery(q01, includeDeleted, isDeleted) {
+    var _a;
+    return (0, lodash_1.merge)({}, q01, {
+        isDeleted: (_a = q01.isDeleted) !== null && _a !== void 0 ? _a : ((0, lodash_1.isUndefined)(includeDeleted) ? isDeleted !== null && isDeleted !== void 0 ? isDeleted : false : isDeleted),
+    });
+}
+function mergeIsDeletedIntoQueryList(qList, includeDeleted, isDeleted) {
+    return qList === null || qList === void 0 ? void 0 : qList.map(q02 => {
+        return mergeIsDeletedIntoQuery(q02, includeDeleted, isDeleted);
+    });
+}
+function addIsDeletedIntoQuery(q01, includeDeleted, isDeleted) {
+    const hasLogicalOps = !!(q01.$and || q01.$nor || q01.$or);
+    let q00 = { ...q01 };
+    if (hasLogicalOps) {
+        q00.$and = mergeIsDeletedIntoQueryList(q01.$and);
+        q00.$nor = mergeIsDeletedIntoQueryList(q01.$nor);
+        q00.$or = mergeIsDeletedIntoQueryList(q01.$or);
+    }
+    else {
+        q00 = mergeIsDeletedIntoQuery(q00, includeDeleted, isDeleted);
+    }
+    return q00;
+}
+class DataSemanticBaseProvider {
+    constructor(data, assertFn) {
+        this.data = data;
+        this.assertFn = assertFn;
+    }
+    async insertItem(item, opts) {
+        await this.data.insertList((0, softkave_js_utils_1.convertToArray)(item), opts);
+    }
+    async getOneById(id, opts) {
+        const query = mergeIsDeletedIntoQuery({ resourceId: id }, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return (await this.data.getOneByQuery(query, opts));
+    }
+    async existsById(id, opts) {
+        const query = mergeIsDeletedIntoQuery({ resourceId: id }, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return await this.data.existsByQuery(query, opts);
+    }
+    async updateOneById(id, update, opts) {
+        const query = mergeIsDeletedIntoQuery({ resourceId: id }, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return await this.data.updateOneByQuery(query, update, opts);
+    }
+    async updateManyByQuery(query, update, opts) {
+        query = addIsDeletedIntoQuery(query, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return await this.data.updateManyByQuery(query, update, opts);
+    }
+    async getAndUpdateOneById(id, update, opts) {
+        const query = mergeIsDeletedIntoQuery({ resourceId: id }, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        const item = await this.data.getAndUpdateOneByQuery(query, update, opts);
+        this.assertFn(item);
+        return item;
+    }
+    async deleteManyByIdList(idList, opts) {
+        const query = { resourceId: { $in: idList } };
+        await this.data.deleteManyByQuery(query, opts);
+    }
+    async softDeleteManyByIdList(idList, agent, opts) {
+        const query = { resourceId: { $in: idList } };
+        await this.softDeleteManyByQuery(query, agent, opts);
+    }
+    async deleteOneById(id, opts) {
+        const query = { resourceId: id };
+        await this.data.deleteOneByQuery(query, opts);
+    }
+    async countManyByIdList(idList, opts) {
+        const query = mergeIsDeletedIntoQuery({ resourceId: { $in: idList } }, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return await this.data.countByQuery(query, opts);
+    }
+    async getManyByIdList(idList, opts) {
+        const query = mergeIsDeletedIntoQuery({ resourceId: { $in: idList } }, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return (await this.data.getManyByQuery(query, opts));
+    }
+    async countByQuery(query, opts) {
+        query = addIsDeletedIntoQuery(query, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return await this.data.countByQuery(query, opts);
+    }
+    async getManyByQuery(query, opts) {
+        query = addIsDeletedIntoQuery(query, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return (await this.data.getManyByQuery(query, opts));
+    }
+    async assertGetOneByQuery(query, opts) {
+        query = addIsDeletedIntoQuery(query, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        const item = await this.data.getOneByQuery(query, opts);
+        this.assertFn(item);
+        return item;
+    }
+    async existsByQuery(query, opts) {
+        query = addIsDeletedIntoQuery(query, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return await this.data.existsByQuery(query, opts);
+    }
+    async getOneByQuery(query, opts) {
+        query = addIsDeletedIntoQuery(query, opts === null || opts === void 0 ? void 0 : opts.includeDeleted, opts === null || opts === void 0 ? void 0 : opts.isDeleted);
+        return (await this.data.getOneByQuery(query, opts));
+    }
+    async deleteManyByQuery(query, opts) {
+        await this.data.deleteManyByQuery(query, opts);
+    }
+    async softDeleteManyByQuery(query, agent, opts) {
+        const update = {
+            isDeleted: true,
+            deletedAt: Date.now(),
+            deletedBy: agent,
+        };
+        await this.data.updateManyByQuery(query, update, opts);
+    }
+}
+exports.DataSemanticBaseProvider = DataSemanticBaseProvider;
+//# sourceMappingURL=DataSemanticDataAccessBaseProvider.js.map

package/build/src/contexts/semantic/DataSemanticDataAccessBaseProvider.js.map

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

package/build/src/contexts/semantic/types.d.ts

@@ -0,0 +1,48 @@
+import { AnyFn } from 'softkave-js-utils';
+import { Agent } from '../../definitions/agent';
+import { Resource } from '../../definitions/resource';
+import { DataProviderOpParams, DataProviderQueryListParams, DataProviderQueryParams, DataQuery } from '../data/types';
+export interface SemanticProviderTxnOptions {
+    txn?: unknown;
+}
+export interface SemanticProviderMutationTxnOptions {
+    txn: unknown;
+}
+export interface SemanticProviderOpOptions extends SemanticProviderTxnOptions, DataProviderOpParams {
+    includeDeleted?: boolean;
+    isDeleted?: boolean;
+}
+export interface SemanticProviderMutationOpOptions extends Omit<SemanticProviderOpOptions, 'txn'>, SemanticProviderMutationTxnOptions {
+}
+export interface SemanticProviderQueryRunOptions<TResource extends Partial<Resource>> extends SemanticProviderOpOptions, DataProviderQueryParams<TResource> {
+}
+export interface SemanticProviderQueryListRunOptions<TResource extends Resource> extends SemanticProviderOpOptions, DataProviderQueryListParams<TResource> {
+}
+export interface SemanticBaseProviderType<TResource extends Resource> {
+    insertItem(item: TResource | TResource[], opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    getOneById(id: string, opts?: SemanticProviderQueryRunOptions<TResource>): Promise<TResource | null>;
+    getManyByIdList(idList: string[], options?: SemanticProviderQueryListRunOptions<TResource>): Promise<TResource[]>;
+    countManyByIdList(idList: string[], opts?: SemanticProviderOpOptions): Promise<number>;
+    existsById(id: string, opts?: SemanticProviderOpOptions): Promise<boolean>;
+    updateOneById(id: string, update: Partial<TResource>, opts: SemanticProviderMutationOpOptions): Promise<void>;
+    updateManyByQuery(query: DataQuery<TResource>, update: Partial<TResource>, opts: SemanticProviderMutationOpOptions): Promise<void>;
+    getAndUpdateOneById(id: string, update: Partial<TResource>, opts: SemanticProviderMutationOpOptions & SemanticProviderQueryRunOptions<TResource>): Promise<TResource | null>;
+    deleteOneById(id: string, opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    deleteManyByIdList(idList: string[], opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    softDeleteManyByIdList(idList: string[], agent: Agent, opts: SemanticProviderMutationTxnOptions): Promise<void>;
+    getOneByQuery(query: DataQuery<TResource>, opts?: SemanticProviderQueryRunOptions<TResource>): Promise<TResource | null>;
+    getManyByQuery(query: DataQuery<TResource>, options?: SemanticProviderQueryListRunOptions<TResource>): Promise<TResource[]>;
+    countByQuery(query: DataQuery<TResource>, opts?: SemanticProviderOpOptions): Promise<number>;
+    assertGetOneByQuery(query: DataQuery<TResource>, opts?: SemanticProviderQueryRunOptions<TResource>): Promise<TResource>;
+    existsByQuery(query: DataQuery<TResource>, opts?: SemanticProviderOpOptions): Promise<boolean>;
+    deleteManyByQuery(query: DataQuery<TResource>, opts: SemanticProviderMutationTxnOptions): Promise<void>;
+}
+export type SemanticWorkspaceResourceProviderBaseType = Resource & {
+    name?: string;
+};
+export interface SemanticProviderUtils {
+    useTxnId(txn: unknown): string | undefined;
+    withTxn<TResult>(fn: AnyFn<[SemanticProviderMutationTxnOptions], Promise<TResult>>, 
+    /** Whether or not to reuse an existing txn from async local storage. */
+    reuseAsyncLocalTxn: boolean, opts?: SemanticProviderMutationTxnOptions): Promise<TResult>;
+}

package/build/src/contexts/semantic/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/src/contexts/semantic/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/contexts/semantic/types.ts"],"names":[],"mappings":""}

package/build/src/contexts/semantic/utils.d.ts

@@ -0,0 +1,16 @@
+import { AnyFn, AnyObject, OrArray, StringKeysOnly } from 'softkave-js-utils';
+import { ComparisonLiteralFieldQueryOps, DataQuery } from '../data/types';
+import { SemanticProviderMutationTxnOptions, SemanticProviderUtils } from './types';
+export declare class DataSemanticProviderUtils implements SemanticProviderUtils {
+    useTxnId(txn: unknown): string | undefined;
+    withTxn<TResult>(fn: AnyFn<[SemanticProviderMutationTxnOptions], Promise<TResult>>, reuseAsyncLocalTxn?: boolean, opts?: SemanticProviderMutationTxnOptions): Promise<TResult>;
+}
+export declare function getStringListQuery<TData extends AnyObject>(stringList: string[], prefix: keyof TData, op?: '$regex' | '$eq', includeSizeOp?: boolean): DataQuery<TData>;
+export declare function getInAndNinQuery<TData extends Record<string, any>, TKey extends StringKeysOnly<TData> = StringKeysOnly<TData>>(prefix: TKey, 
+/** `null` or `undefined` will not go into query. To explicitly handle them,
+ * pass `[null]` or `[undefined]` */
+inList: OrArray<TData[TKey]> | undefined, 
+/** `null` or `undefined` will not go into query. To explicitly handle them,
+ * pass `[null]` or `[undefined]` */
+ninList?: OrArray<TData[TKey]> | undefined): DataQuery<TData>;
+export declare function getIgnoreCaseDataQueryRegExp(str: string): ComparisonLiteralFieldQueryOps<string>;

package/build/src/contexts/semantic/utils.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIgnoreCaseDataQueryRegExp = exports.getInAndNinQuery = exports.getStringListQuery = exports.DataSemanticProviderUtils = void 0;
+const lodash_1 = require("lodash");
+const softkave_js_utils_1 = require("softkave-js-utils");
+const assertion_1 = require("../../utils/assertion");
+const injectables_1 = require("../injection/injectables");
+class DataSemanticProviderUtils {
+    useTxnId(txn) {
+        if (!txn) {
+            return undefined;
+        }
+        const id = txn.__fimidaraTxnId;
+        (0, assertion_1.appAssert)(id);
+        return id;
+    }
+    async withTxn(fn, reuseAsyncLocalTxn = true, opts) {
+        return await injectables_1.kDataModels.utils().withTxn(async (txn) => {
+            if (!txn.__fimidaraTxnId) {
+                txn.__fimidaraTxnId = 'txn_' + (0, softkave_js_utils_1.getNewId)();
+            }
+            return await fn({ txn });
+        }, reuseAsyncLocalTxn, opts === null || opts === void 0 ? void 0 : opts.txn);
+    }
+}
+exports.DataSemanticProviderUtils = DataSemanticProviderUtils;
+function getStringListQuery(stringList, prefix, op = '$eq', includeSizeOp = false) {
+    const query = {};
+    if (stringList.length === 0) {
+        // MongoDB array queries with `{$all: [], $size: 0}` do not work, so using
+        // `{$eq: []}` instead, since that works
+        query[prefix] = { $eq: [] };
+        return query;
+    }
+    stringList.reduce((map, name, index) => {
+        const key = `${prefix}.${index}`;
+        const q = op === '$eq' ? { $eq: name } : getIgnoreCaseDataQueryRegExp(name);
+        map[key] = q;
+        return map;
+    }, query);
+    if (includeSizeOp) {
+        query[prefix] = { $size: stringList.length };
+    }
+    return query;
+}
+exports.getStringListQuery = getStringListQuery;
+function getInAndNinQuery(prefix, 
+/** `null` or `undefined` will not go into query. To explicitly handle them,
+ * pass `[null]` or `[undefined]` */
+inList, 
+/** `null` or `undefined` will not go into query. To explicitly handle them,
+ * pass `[null]` or `[undefined]` */
+ninList) {
+    const inKey = `${prefix}.$in`;
+    const ninKey = `${prefix}.$nin`;
+    const query = {};
+    if (!(0, lodash_1.isNil)(inList))
+        (0, lodash_1.set)(query, inKey, (0, softkave_js_utils_1.convertToArray)(inList));
+    if (!(0, lodash_1.isNil)(ninList))
+        (0, lodash_1.set)(query, ninKey, (0, softkave_js_utils_1.convertToArray)(ninList));
+    return query;
+}
+exports.getInAndNinQuery = getInAndNinQuery;
+function getIgnoreCaseDataQueryRegExp(str) {
+    return { $regex: `^${str}$`, $options: 'i' };
+}
+exports.getIgnoreCaseDataQueryRegExp = getIgnoreCaseDataQueryRegExp;
+//# sourceMappingURL=utils.js.map

package/build/src/contexts/semantic/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/contexts/semantic/utils.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAClC,yDAO2B;AAC3B,qDAAgD;AAMhD,0DAAqD;AAUrD,MAAa,yBAAyB;IACpC,QAAQ,CAAC,GAAY;QACnB,IAAI,CAAC,GAAG,EAAE;YACR,OAAO,SAAS,CAAC;SAClB;QAED,MAAM,EAAE,GAAI,GAA4B,CAAC,eAAe,CAAC;QACzD,IAAA,qBAAS,EAAC,EAAE,CAAC,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,EAAiE,EACjE,kBAAkB,GAAG,IAAI,EACzB,IAAyC;QAEzC,OAAO,MAAM,yBAAW,CAAC,KAAK,EAAE,CAAC,OAAO,CACtC,KAAK,EAAC,GAAG,EAAC,EAAE;YACV,IAAI,CAAE,GAA4B,CAAC,eAAe,EAAE;gBACjD,GAA4B,CAAC,eAAe,GAAG,MAAM,GAAG,IAAA,4BAAQ,GAAE,CAAC;aACrE;YAED,OAAO,MAAM,EAAE,CAAC,EAAC,GAAG,EAAC,CAAC,CAAC;QACzB,CAAC,EACD,kBAAkB,EAClB,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,CACV,CAAC;IACJ,CAAC;CACF;AA5BD,8DA4BC;AAED,SAAgB,kBAAkB,CAChC,UAAoB,EACpB,MAAmB,EACnB,KAAuB,KAAK,EAC5B,aAAa,GAAG,KAAK;IAErB,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE;QAC3B,0EAA0E;QAC1E,wCAAwC;QACxC,KAAK,CAAC,MAAgB,CAAC,GAAG,EAAC,GAAG,EAAE,EAAE,EAAC,CAAC;QACpC,OAAO,KAAK,CAAC;KACd;IAED,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,GAAG,MAAgB,IAAI,KAAK,EAAE,CAAC;QAC3C,MAAM,CAAC,GACL,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,EAAC,GAAG,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;QAClE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,IAAI,aAAa,EAAE;QACjB,KAAK,CAAC,MAAgB,CAAC,GAAG,EAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAC,CAAC;KACtD;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AA5BD,gDA4BC;AAED,SAAgB,gBAAgB,CAK9B,MAAY;AACZ;oCACoC;AACpC,MAAwC;AACxC;oCACoC;AACpC,OAA0C;IAE1C,MAAM,KAAK,GACT,GAAG,MAAM,MAAe,CAAC;IAC3B,MAAM,MAAM,GACV,GAAG,MAAM,OAAgB,CAAC;IAC5B,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,IAAI,CAAC,IAAA,cAAK,EAAC,MAAM,CAAC;QAAE,IAAA,YAAG,EAAC,KAAK,EAAE,KAAK,EAAE,IAAA,kCAAc,EAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAA,cAAK,EAAC,OAAO,CAAC;QAAE,IAAA,YAAG,EAAC,KAAK,EAAE,MAAM,EAAE,IAAA,kCAAc,EAAC,OAAO,CAAC,CAAC,CAAC;IAEjE,OAAO,KAAK,CAAC;AACf,CAAC;AAvBD,4CAuBC;AAED,SAAgB,4BAA4B,CAC1C,GAAW;IAEX,OAAO,EAAC,MAAM,EAAE,IAAI,GAAG,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAC,CAAC;AAC7C,CAAC;AAJD,oEAIC"}

package/build/src/contexts/types.d.ts

@@ -0,0 +1,6 @@
+import { Request } from 'express';
+import { BaseTokenData } from '../definitions/token';
+export interface ServerRequest extends Request {
+    /** decoded JWT token using the expressJWT middleware */
+    auth?: BaseTokenData;
+}

package/build/src/contexts/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/src/contexts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/contexts/types.ts"],"names":[],"mappings":""}

package/build/src/definitions/agent.d.ts

@@ -0,0 +1,10 @@
+import { AnyObject } from 'softkave-js-utils';
+export interface Agent {
+    agentId: string;
+    agentType: string;
+    agentTokenId: string;
+}
+export type PublicAgent = Pick<Agent, 'agentId' | 'agentType'>;
+export type ConvertAgentToPublicAgent<T> = {
+    [K in keyof T]: NonNullable<T[K]> extends Agent ? PublicAgent : NonNullable<T[K]> extends AnyObject ? ConvertAgentToPublicAgent<NonNullable<T[K]>> : T[K];
+};

package/build/src/definitions/agent.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent.js.map