@ngageoint/mage.service 6.2.2

package/lib/adapters/observations/adapters.observations.db.mongoose.js

@@ -0,0 +1,294 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docToEntity = exports.createObservationRepositoryFactory = exports.MongooseObservationRepository = void 0;
+const entities_observations_1 = require("../../entities/observations/entities.observations");
+const adapters_base_db_mongoose_1 = require("../base/adapters.base.db.mongoose");
+const mongoose_1 = __importDefault(require("mongoose"));
+const legacy = __importStar(require("../../models/observation"));
+class MongooseObservationRepository extends adapters_base_db_mongoose_1.BaseMongooseRepository {
+    constructor(eventDoc, eventLookup, domainEvents) {
+        // TODO: do not bind to the default mongoose instance and connection
+        super(legacy.observationModel(eventDoc), { docToEntity: createDocumentMapping(eventDoc.id) });
+        this.eventLookup = eventLookup;
+        this.domainEvents = domainEvents;
+        this.eventScope = eventDoc.id;
+        this.idModel = legacy.ObservationId;
+    }
+    allocateObservationId() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const idDoc = yield this.idModel.create({});
+            return idDoc.id;
+        });
+    }
+    save(observation) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (observation.validation.hasErrors) {
+                return new entities_observations_1.ObservationRepositoryError(entities_observations_1.ObservationRepositoryErrorCode.InvalidObservation);
+            }
+            let dbId;
+            try {
+                dbId = mongoose_1.default.Types.ObjectId(observation.id);
+            }
+            catch (err) {
+                return new entities_observations_1.ObservationRepositoryError(entities_observations_1.ObservationRepositoryErrorCode.InvalidObservationId);
+            }
+            const attrs = (0, entities_observations_1.copyObservationAttrs)(observation);
+            const docSeed = Object.assign(Object.assign({}, attrs), { _id: dbId });
+            delete docSeed.importantFlag;
+            if (attrs.important) {
+                docSeed.important = attrs.important;
+            }
+            docSeed.properties.forms = attrs.properties.forms.map(assignMongoIdToDocAttrs);
+            docSeed.attachments = attrs.attachments.map(attachmentDocSeedForEntity);
+            docSeed.states = attrs.states.map(assignMongoIdToDocAttrs);
+            let beforeDoc = yield this.model.findById(dbId);
+            if (beforeDoc) {
+                if (docSeed.createdAt.getTime() !== beforeDoc.createdAt.getTime()) {
+                    console.warn(`attempted to modify create timestamp on observation ${beforeDoc.id} from ${beforeDoc.createdAt} to ${docSeed.createdAt}`);
+                    docSeed.createdAt = new Date(beforeDoc.createdAt);
+                }
+                beforeDoc = beforeDoc.set(docSeed);
+            }
+            else {
+                const idVerified = yield this.idModel.findById(dbId);
+                if (!idVerified) {
+                    return new entities_observations_1.ObservationRepositoryError(entities_observations_1.ObservationRepositoryErrorCode.InvalidObservationId);
+                }
+                beforeDoc = new this.model(docSeed);
+            }
+            const savedDoc = yield beforeDoc.save();
+            const savedAttrs = this.entityForDocument(savedDoc);
+            const saved = entities_observations_1.Observation.evaluate(savedAttrs, observation.mageEvent);
+            for (const e of observation.pendingEvents) {
+                this.domainEvents.emit(e.type, Object.freeze(Object.assign(Object.assign({}, e), { observation: saved })));
+            }
+            return saved;
+        });
+    }
+    findById(id) {
+        const _super = Object.create(null, {
+            findById: { get: () => super.findById }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            const attrs = yield _super.findById.call(this, id);
+            if (!attrs) {
+                return null;
+            }
+            const mageEvent = yield this.eventLookup(attrs.eventId);
+            if (!mageEvent) {
+                return null;
+            }
+            return entities_observations_1.Observation.evaluate(attrs, mageEvent);
+        });
+    }
+    findLatest() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const latest = yield this.model.findOne({}, { lastModified: true }, { sort: { lastModified: -1 }, limit: 1 });
+            return latest ? this.entityForDocument(latest) : null;
+        });
+    }
+    findLastModifiedAfter(timestamp, paging) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new Error('unimplemented');
+        });
+    }
+    patchAttachment(observation, attachmentId, patch) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const patchedObs = (0, entities_observations_1.patchAttachment)(observation, attachmentId, patch);
+            if (!(patchedObs instanceof entities_observations_1.Observation)) {
+                return patchedObs;
+            }
+            const attachment = attachmentDocSeedForEntity(patchedObs.attachmentFor(attachmentId));
+            const doc = yield this.model.findOneAndUpdate({ _id: mongoose_1.default.Types.ObjectId(observation.id), attachments: { $elemMatch: { _id: mongoose_1.default.Types.ObjectId(attachmentId) } } }, { $set: { 'attachments.$': attachment } }, { new: true });
+            if (doc) {
+                return entities_observations_1.Observation.evaluate(this.entityForDocument(doc), observation.mageEvent);
+            }
+            return null;
+        });
+    }
+    nextFormEntryIds(count = 1) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return Array.from({ length: count }).map(_ => mongoose_1.default.Types.ObjectId().toHexString());
+        });
+    }
+    nextAttachmentIds(count = 1) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return Array.from({ length: count }).map(_ => mongoose_1.default.Types.ObjectId().toHexString());
+        });
+    }
+}
+exports.MongooseObservationRepository = MongooseObservationRepository;
+const createObservationRepositoryFactory = (eventRepo, domainEvents) => {
+    return (eventId) => __awaiter(void 0, void 0, void 0, function* () {
+        const event = yield eventRepo.model.findById(eventId);
+        if (event) {
+            return new MongooseObservationRepository({ id: eventId, collectionName: event.collectionName }, (mageEventId) => __awaiter(void 0, void 0, void 0, function* () {
+                return yield eventRepo.findById(mageEventId);
+            }), domainEvents);
+        }
+        const err = new Error(`unexpected error: event not found for id ${event}`);
+        console.error(err);
+        throw err;
+    });
+};
+exports.createObservationRepositoryFactory = createObservationRepositoryFactory;
+function docToEntity(doc, eventId) {
+    return createDocumentMapping(eventId)(doc);
+}
+exports.docToEntity = docToEntity;
+function createDocumentMapping(eventId) {
+    return doc => {
+        var _a, _b, _c;
+        const attrs = {
+            id: doc.id,
+            eventId,
+            createdAt: doc.createdAt,
+            lastModified: doc.lastModified,
+            type: doc.type,
+            geometry: doc.geometry,
+            bbox: doc.bbox,
+            states: doc.states.map(stateAttrsForDoc),
+            properties: Object.assign(Object.assign({}, doc.properties), { forms: doc.properties.forms.map(formEntryForDoc) }),
+            attachments: doc.attachments.map(attachmentAttrsForDoc),
+            userId: (_a = doc.userId) === null || _a === void 0 ? void 0 : _a.toHexString(),
+            deviceId: (_b = doc.deviceId) === null || _b === void 0 ? void 0 : _b.toHexString(),
+            important: importantFlagAttrsForDoc(doc),
+            favoriteUserIds: (_c = doc.favoriteUserIds) === null || _c === void 0 ? void 0 : _c.map(x => x.toHexString()),
+        };
+        return attrs;
+    };
+}
+function importantFlagAttrsForDoc(doc) {
+    var _a;
+    /*
+    because the observation schema defines `important` as a nested documnet
+    instead of a subdocument schema, a mongoose observation document instance
+    always returns a value for `observation.important`, even if the `important`
+    key is undefined in the database.  so, if `important` is undefined in the
+    database, the mongoose document instance `important` getter will return an
+    empty object `{}`.  not cool, mongoose.
+    */
+    const docImportant = doc.important;
+    if ((docImportant === null || docImportant === void 0 ? void 0 : docImportant.userId) || (docImportant === null || docImportant === void 0 ? void 0 : docImportant.timestamp) || (docImportant === null || docImportant === void 0 ? void 0 : docImportant.description)) {
+        return {
+            userId: (_a = docImportant.userId) === null || _a === void 0 ? void 0 : _a.toHexString(),
+            timestamp: docImportant.timestamp,
+            description: docImportant.description
+        };
+    }
+    return void (0);
+}
+function attachmentAttrsForDoc(doc) {
+    return {
+        id: doc.id,
+        observationFormId: doc.observationFormId.toHexString(),
+        fieldName: doc.fieldName,
+        lastModified: doc.lastModified ? new Date(doc.lastModified) : undefined,
+        name: doc.name,
+        contentType: doc.contentType,
+        width: doc.width,
+        height: doc.height,
+        size: doc.size,
+        oriented: doc.oriented,
+        contentLocator: doc.relativePath,
+        thumbnails: doc.thumbnails.map(thumbnailAttrsForDoc),
+    };
+}
+function thumbnailAttrsForDoc(doc) {
+    return {
+        // TODO: is id necessary for thumnails? needs cleanup
+        contentLocator: doc.relativePath,
+        minDimension: doc.minDimension,
+        contentType: doc.contentType,
+        height: doc.height,
+        width: doc.width,
+        size: doc.size,
+        name: doc.name,
+    };
+}
+function stateAttrsForDoc(doc) {
+    var _a;
+    return {
+        id: doc.id,
+        name: doc.name,
+        userId: (_a = doc.userId) === null || _a === void 0 ? void 0 : _a.toHexString()
+    };
+}
+function formEntryForDoc(doc) {
+    const { _id } = doc, withoutDbId = __rest(doc, ["_id"]);
+    return Object.assign(Object.assign({}, withoutDbId), { id: _id.toHexString() });
+}
+function assignMongoIdToDocAttrs(attrs) {
+    const _a = attrs, { id } = _a, withoutId = __rest(_a, ["id"]);
+    withoutId._id =
+        typeof id === 'string' ? mongoose_1.default.Types.ObjectId(id)
+            : typeof id === 'number' ? id
+                : mongoose_1.default.Types.ObjectId();
+    return withoutId;
+}
+function attachmentDocSeedForEntity(attrs) {
+    const seed = assignMongoIdToDocAttrs(attrs);
+    seed.relativePath = attrs.contentLocator;
+    delete seed['contentLocator'];
+    seed.thumbnails = attrs.thumbnails.map(thumbnailDocSeedForEntity);
+    return seed;
+}
+function thumbnailDocSeedForEntity(attrs) {
+    return {
+        _id: mongoose_1.default.Types.ObjectId(),
+        relativePath: attrs.contentLocator,
+        minDimension: attrs.minDimension,
+        name: attrs.name,
+        contentType: attrs.contentType,
+        size: attrs.size,
+        width: attrs.width,
+        height: attrs.height,
+    };
+}
+//# sourceMappingURL=adapters.observations.db.mongoose.js.map

package/lib/adapters/observations/adapters.observations.db.mongoose.js.map

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

package/lib/adapters/plugins/adapters.plugins.db.mongoose.d.ts

@@ -0,0 +1,17 @@
+import mongoose from 'mongoose';
+import { EnsureJson } from '../../entities/entities.json_types';
+import { PluginStateRepository } from '../../plugins.api';
+export declare type PluginStateDocument<State extends object> = mongoose.Document & {
+    _id: 'string';
+    state: State;
+};
+export declare class MongoosePluginStateRepository<State extends object> implements PluginStateRepository<State> {
+    readonly pluginId: string;
+    readonly mongoose: mongoose.Mongoose;
+    readonly model: mongoose.Model<PluginStateDocument<State>>;
+    constructor(pluginId: string, mongoose: mongoose.Mongoose);
+    put(state: EnsureJson<State>): Promise<EnsureJson<State>>;
+    patch(state: Partial<EnsureJson<State>>): Promise<EnsureJson<State>>;
+    get(): Promise<EnsureJson<State> | null>;
+}
+//# sourceMappingURL=adapters.plugins.db.mongoose.d.ts.map

package/lib/adapters/plugins/adapters.plugins.db.mongoose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.plugins.db.mongoose.d.ts","sourceRoot":"","sources":["../../../src/adapters/plugins/adapters.plugins.db.mongoose.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,oBAAY,mBAAmB,CAAC,KAAK,SAAS,MAAM,IAAI,QAAQ,CAAC,QAAQ,GAAG;IAC1E,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAOD,qBAAa,6BAA6B,CAAC,KAAK,SAAS,MAAM,CAAE,YAAW,qBAAqB,CAAC,KAAK,CAAC;aAI1E,QAAQ,EAAE,MAAM;aAAkB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;IAFzF,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAA;gBAE9B,QAAQ,EAAE,MAAM,EAAkB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;IAMnF,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAKzD,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAepE,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;CAI/C"}

package/lib/adapters/plugins/adapters.plugins.db.mongoose.js

@@ -0,0 +1,59 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoosePluginStateRepository = void 0;
+const mongoose_1 = __importDefault(require("mongoose"));
+const SCHEMA_SPEC = {
+    _id: { type: mongoose_1.default.SchemaTypes.String },
+    state: { type: mongoose_1.default.SchemaTypes.Mixed, default: null }
+};
+class MongoosePluginStateRepository {
+    constructor(pluginId, mongoose) {
+        this.pluginId = pluginId;
+        this.mongoose = mongoose;
+        const collectionName = `plugin_state_${pluginId}`;
+        const modelNames = mongoose.modelNames();
+        this.model = modelNames.includes(collectionName) ? mongoose.model(collectionName) : mongoose.model(collectionName, new mongoose.Schema(SCHEMA_SPEC), collectionName);
+    }
+    put(state) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const updated = yield this.model.findByIdAndUpdate(this.pluginId, { state }, { new: true, upsert: true });
+            return updated.toJSON().state;
+        });
+    }
+    patch(state) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const update = Object.entries(state).reduce((update, entry) => {
+                const stateKey = `state.${entry[0]}`;
+                if (entry[1] === undefined) {
+                    update.$unset = Object.assign(Object.assign({}, update.$unset), { [stateKey]: 1 });
+                }
+                else {
+                    update.$set = Object.assign(Object.assign({}, update.$set), { [stateKey]: entry[1] });
+                }
+                return update;
+            }, {});
+            const patched = yield this.model.findByIdAndUpdate(this.pluginId, update, { new: true, upsert: true });
+            return patched.toJSON().state;
+        });
+    }
+    get() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const doc = yield this.model.findById(this.pluginId);
+            return (doc === null || doc === void 0 ? void 0 : doc.toJSON().state) || null;
+        });
+    }
+}
+exports.MongoosePluginStateRepository = MongoosePluginStateRepository;
+//# sourceMappingURL=adapters.plugins.db.mongoose.js.map

package/lib/adapters/plugins/adapters.plugins.db.mongoose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.plugins.db.mongoose.js","sourceRoot":"","sources":["../../../src/adapters/plugins/adapters.plugins.db.mongoose.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,wDAA+B;AAS/B,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,EAAE,IAAI,EAAE,kBAAQ,CAAC,WAAW,CAAC,MAAM,EAAE;IAC1C,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;CAC3D,CAAA;AAED,MAAa,6BAA6B;IAIxC,YAA4B,QAAgB,EAAkB,QAA2B;QAA7D,aAAQ,GAAR,QAAQ,CAAQ;QAAkB,aAAQ,GAAR,QAAQ,CAAmB;QACvF,MAAM,cAAc,GAAG,gBAAgB,QAAQ,EAAE,CAAA;QACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAA;QACxC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAA;IACtK,CAAC;IAEK,GAAG,CAAC,KAAwB;;YAChC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YACzG,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAA;QAC/B,CAAC;KAAA;IAEK,KAAK,CAAC,KAAiC;;YAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAC5D,MAAM,QAAQ,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;gBACpC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE;oBAC1B,MAAM,CAAC,MAAM,mCAAQ,MAAM,CAAC,MAAM,KAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAE,CAAA;iBACpD;qBACI;oBACH,MAAM,CAAC,IAAI,mCAAQ,MAAM,CAAC,IAAI,KAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAE,CAAA;iBACvD;gBACD,OAAO,MAAM,CAAA;YACf,CAAC,EAAE,EAAS,CAAC,CAAA;YACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YACtG,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAA;QAC/B,CAAC;KAAA;IAEK,GAAG;;YACP,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACpD,OAAO,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,MAAM,GAAG,KAAK,KAAI,IAAI,CAAA;QACpC,CAAC;KAAA;CACF;AAlCD,sEAkCC"}

package/lib/adapters/url_schemes/adapters.url_schemes.plugin.d.ts

@@ -0,0 +1,38 @@
+/// <reference types="node" />
+import { URL } from 'url';
+import { UrlResolutionError, UrlScheme } from '../../entities/entities.global';
+/**
+ * The `PluginUrlScheme` resolves content that a `PluginResourceUrl`
+ * references.  The scheme starts with a known list of plugin base module names
+ * from which to resolve bundled child resources.  Be aware that if the base
+ * module includes a `package.json` with a `main` field, the scheme resolves
+ * all child resource paths relative to the directory that contains the `main`
+ * file.  For example, given a module `@example/nested-main` whose
+ * `package.json` `main` value is `"lib/public/main.js"`, the scheme would
+ * resolve the URL `mage-plugin:///@example/nested-main/assets/help.txt` with
+ * the path `<resolved base path>/node_modules/@example/nested-main/lib/public/assets/help.txt`.
+ * This behavior imposes a compatibility requirement on packages that any
+ * resolvable resources must be packaged as siblings of the main file.
+ *
+ * TODO: consider [package entry points](https://nodejs.org/dist/latest-v12.x/docs/api/packages.html#packages_package_entry_points)
+ */
+export declare class PluginUrlScheme implements UrlScheme {
+    private extraSearchPaths;
+    private readonly pluginNamesDescending;
+    /**
+     * This class must know the registered plugin module names to ensure
+     * resolution of only intended resources.
+     * @param pluginNames
+     */
+    constructor(pluginNames: string[], extraSearchPaths?: string[] | null);
+    get isLocalScheme(): boolean;
+    canResolve(url: URL): boolean;
+    resolveContent(url: URL): Promise<NodeJS.ReadableStream | UrlResolutionError>;
+    /**
+     * Resolve the local path the given plugin resource URL references.
+     * @param url a plugin URL that refers to a resource in a plugin module
+     * @returns
+     */
+    localPathOfUrl(url: URL): string | UrlResolutionError;
+}
+//# sourceMappingURL=adapters.url_schemes.plugin.d.ts.map

package/lib/adapters/url_schemes/adapters.url_schemes.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.url_schemes.plugin.d.ts","sourceRoot":"","sources":["../../../src/adapters/url_schemes/adapters.url_schemes.plugin.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AACzB,OAAO,EAAqB,kBAAkB,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAEjG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,SAAS;IASZ,OAAO,CAAC,gBAAgB;IAP3D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAEhD;;;;OAIG;gBACS,WAAW,EAAE,MAAM,EAAE,EAAU,gBAAgB,GAAE,MAAM,EAAE,GAAG,IAAW;IAInF,IAAI,aAAa,YAAkB;IAEnC,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAIvB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,GAAG,kBAAkB,CAAC;IAYnF;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,kBAAkB;CAyCtD"}

package/lib/adapters/url_schemes/adapters.url_schemes.plugin.js

@@ -0,0 +1,110 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginUrlScheme = void 0;
+const fs_1 = __importDefault(require("fs"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const entities_global_1 = require("../../entities/entities.global");
+/**
+ * The `PluginUrlScheme` resolves content that a `PluginResourceUrl`
+ * references.  The scheme starts with a known list of plugin base module names
+ * from which to resolve bundled child resources.  Be aware that if the base
+ * module includes a `package.json` with a `main` field, the scheme resolves
+ * all child resource paths relative to the directory that contains the `main`
+ * file.  For example, given a module `@example/nested-main` whose
+ * `package.json` `main` value is `"lib/public/main.js"`, the scheme would
+ * resolve the URL `mage-plugin:///@example/nested-main/assets/help.txt` with
+ * the path `<resolved base path>/node_modules/@example/nested-main/lib/public/assets/help.txt`.
+ * This behavior imposes a compatibility requirement on packages that any
+ * resolvable resources must be packaged as siblings of the main file.
+ *
+ * TODO: consider [package entry points](https://nodejs.org/dist/latest-v12.x/docs/api/packages.html#packages_package_entry_points)
+ */
+class PluginUrlScheme {
+    /**
+     * This class must know the registered plugin module names to ensure
+     * resolution of only intended resources.
+     * @param pluginNames
+     */
+    constructor(pluginNames, extraSearchPaths = null) {
+        this.extraSearchPaths = extraSearchPaths;
+        this.pluginNamesDescending = pluginNames.sort().reverse();
+    }
+    get isLocalScheme() { return true; }
+    canResolve(url) {
+        return url.protocol === entities_global_1.PluginResourceUrl.pluginProtocol;
+    }
+    resolveContent(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const contentPath = this.localPathOfUrl(url);
+            if (typeof contentPath !== 'string') {
+                return contentPath;
+            }
+            const stats = yield fs_extra_1.default.stat(contentPath);
+            if (stats.isFile()) {
+                return fs_1.default.createReadStream(contentPath);
+            }
+            return new entities_global_1.UrlResolutionError(url, 'no content found');
+        });
+    }
+    /**
+     * Resolve the local path the given plugin resource URL references.
+     * @param url a plugin URL that refers to a resource in a plugin module
+     * @returns
+     */
+    localPathOfUrl(url) {
+        if (!this.canResolve(url)) {
+            return new entities_global_1.UrlResolutionError(url, 'invalid scheme');
+        }
+        const pluginPath = entities_global_1.PluginResourceUrl.pluginPathOf(url);
+        if (!pluginPath) {
+            return new entities_global_1.UrlResolutionError(url, 'not a plugin url');
+        }
+        const longestMatchingPlugin = this.pluginNamesDescending.find(pluginName => pluginPath.startsWith(pluginName));
+        if (!longestMatchingPlugin) {
+            return new entities_global_1.UrlResolutionError(url, 'no matching plugin module');
+        }
+        const resolveOpts = {};
+        if (Array.isArray(this.extraSearchPaths)) {
+            resolveOpts.paths = this.extraSearchPaths;
+        }
+        let manifestPath = null;
+        try {
+            manifestPath = require.resolve(longestMatchingPlugin + '/package.json', resolveOpts);
+        }
+        catch (err) {
+            // no package.json, no problem
+        }
+        let mainFilePath;
+        try {
+            mainFilePath = require.resolve(longestMatchingPlugin, resolveOpts);
+        }
+        catch (err) {
+            return new entities_global_1.UrlResolutionError(url, String(err));
+        }
+        const baseDir = path_1.default.dirname(manifestPath || mainFilePath);
+        const contentRelPath = pluginPath.slice(longestMatchingPlugin.length + 1);
+        if (!contentRelPath) {
+            if (url.pathname.endsWith('/')) {
+                return baseDir;
+            }
+            return mainFilePath;
+        }
+        const contentPath = path_1.default.join(baseDir, contentRelPath);
+        return contentPath;
+    }
+}
+exports.PluginUrlScheme = PluginUrlScheme;
+//# sourceMappingURL=adapters.url_schemes.plugin.js.map

package/lib/adapters/url_schemes/adapters.url_schemes.plugin.js.map

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

package/lib/adapters/users/adapters.users.controllers.web.d.ts

@@ -0,0 +1,7 @@
+import { SearchUsers } from '../../app.api/users/app.api.users';
+import { WebAppRequestFactory } from '../adapters.controllers.web';
+export interface UsersAppLayer {
+    searchUsers: SearchUsers;
+}
+export declare function UsersRoutes(app: UsersAppLayer, createAppRequest: WebAppRequestFactory): import("express-serve-static-core").Router;
+//# sourceMappingURL=adapters.users.controllers.web.d.ts.map

package/lib/adapters/users/adapters.users.controllers.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.users.controllers.web.d.ts","sourceRoot":"","sources":["../../../src/adapters/users/adapters.users.controllers.web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAqB,MAAM,mCAAmC,CAAA;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,8CAoBrF"}

package/lib/adapters/users/adapters.users.controllers.web.js

@@ -0,0 +1,37 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsersRoutes = void 0;
+const express_1 = __importDefault(require("express"));
+function UsersRoutes(app, createAppRequest) {
+    const routes = express_1.default.Router();
+    routes.route('/search')
+        .get((req, res, next) => __awaiter(this, void 0, void 0, function* () {
+        const userSearch = {
+            nameOrContactTerm: req.query.term,
+            pageSize: parseInt(String(req.query.page_size)) || 250,
+            pageIndex: parseInt(String(req.query.page)) || 0,
+            includeTotalCount: 'total' in req.query ? /^true$/i.test(String(req.query.total)) : undefined
+        };
+        const appReq = createAppRequest(req, { userSearch });
+        const appRes = yield app.searchUsers(appReq);
+        if (appRes.success) {
+            return res.json(appRes.success);
+        }
+        next(appRes.error);
+    }));
+    return routes;
+}
+exports.UsersRoutes = UsersRoutes;
+//# sourceMappingURL=adapters.users.controllers.web.js.map

package/lib/adapters/users/adapters.users.controllers.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.users.controllers.web.js","sourceRoot":"","sources":["../../../src/adapters/users/adapters.users.controllers.web.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,sDAA6B;AAQ7B,SAAgB,WAAW,CAAC,GAAkB,EAAE,gBAAsC;IAEpF,MAAM,MAAM,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAA;IAE/B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;SACpB,GAAG,CAAC,CAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAoC;YAClD,iBAAiB,EAAE,GAAG,CAAC,KAAK,CAAC,IAA0B;YACvD,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,GAAG;YACtD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;YAChD,iBAAiB,EAAE,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9F,CAAA;QACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;QACpD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,MAAM,CAAC,OAAO,EAAE;YAClB,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;SAChC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC,CAAA,CAAC,CAAA;IACJ,OAAO,MAAM,CAAA;AACf,CAAC;AApBD,kCAoBC"}

package/lib/adapters/users/adapters.users.db.mongoose.d.ts

@@ -0,0 +1,19 @@
+import { User, UserId, UserRepository, UserFindParameters } from '../../entities/users/entities.users';
+import { BaseMongooseRepository } from '../base/adapters.base.db.mongoose';
+import { PageOf } from '../../entities/entities.global';
+import * as legacy from '../../models/user';
+import mongoose from 'mongoose';
+export declare const UserModelName = "User";
+export declare type UserDocument = legacy.UserDocument;
+export declare type UserModel = mongoose.Model<UserDocument>;
+export declare const UserSchema: mongoose.Schema;
+export declare class MongooseUserRepository extends BaseMongooseRepository<UserDocument, UserModel, User> implements UserRepository {
+    constructor(model: mongoose.Model<UserDocument>);
+    create(): Promise<User>;
+    update(attrs: Partial<User> & {
+        id: UserId;
+    }): Promise<User | null>;
+    removeById(id: any): Promise<User | null>;
+    find<T = User>(which: UserFindParameters, mapping?: (x: User) => T): Promise<PageOf<T>>;
+}
+//# sourceMappingURL=adapters.users.db.mongoose.d.ts.map

package/lib/adapters/users/adapters.users.db.mongoose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.users.db.mongoose.d.ts","sourceRoot":"","sources":["../../../src/adapters/users/adapters.users.db.mongoose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAA;AACtG,OAAO,EAAE,sBAAsB,EAAa,MAAM,mCAAmC,CAAA;AACrF,OAAO,EAAE,MAAM,EAAU,MAAM,gCAAgC,CAAA;AAC/D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAE3C,OAAO,QAAQ,MAAM,UAAU,CAAA;AAE/B,eAAO,MAAM,aAAa,SAAS,CAAA;AAEnC,oBAAY,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;AAC9C,oBAAY,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;AACpD,eAAO,MAAM,UAAU,iBAAsB,CAAA;AAO7C,qBAAa,sBAAuB,SAAQ,sBAAsB,CAAC,YAAY,EAAE,SAAS,EAAE,IAAI,CAAE,YAAW,cAAc;gBAE7G,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;IAczC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAInE,UAAU,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAIzC,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CA8B9F"}