@ngageoint/mage.service 6.2.2

package/lib/entities/entities.i18n.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAcceptLanguageHeader = exports.selectContentLanguageFor = exports.LanguageTag = exports.ContentLanguageKey = void 0;
+const RFC5646LanguageTagImpl = require('rfc5646');
+exports.ContentLanguageKey = Symbol.for('ContentLanguage');
+exports.LanguageTag = RFC5646LanguageTagImpl;
+/**
+ * Choose the best matching content language from the given list of content
+ * languages for the given list of language preferences.  The preferences list
+ * should be in descending order of preference.  Return null if none of the
+ * content languages satisfies the preferences.
+ * @param preferences
+ * @param contentLanguages
+ * @returns the matched content lanugage or null
+ */
+function selectContentLanguageFor(preferences, contentLanguages) {
+    for (const pref of preferences) {
+        const match = contentLanguages.find(x => x.suitableFor(pref.minimal.toString()));
+        if (match) {
+            return match;
+        }
+    }
+    return null;
+}
+exports.selectContentLanguageFor = selectContentLanguageFor;
+/**
+ * Parse the string that represents a client's language preferences, as defined
+ * in [RFC-7231](https://www.rfc-editor.org/rfc/rfc7231.html#section-5.3.5)
+ * (HTTP/1.1).  These strings appear in the `Accept-Language` HTTP header.
+ * Return an array of {@link LanguageTag | language tag} instances in descending
+ * order of preference.
+ *
+ * Example:
+ * ```text
+ * Accept-Language: da, en-gb;q=0.8, en;q=0.7
+ * ```
+ * The portion following `Accept-Language: ` is what this function expects.
+ * @param header
+ * @returns
+ */
+function parseAcceptLanguageHeader(header) {
+    if (!header) {
+        return [];
+    }
+    const ranges = header.split(',')
+        .reduce((ranges, part) => {
+        const range = parseLanguageRange(part);
+        if (range) {
+            ranges.push(range);
+        }
+        return ranges;
+    }, [])
+        .sort((a, b) => b.quality - a.quality);
+    return ranges.map(x => x.tag);
+}
+exports.parseAcceptLanguageHeader = parseAcceptLanguageHeader;
+function parseLanguageRange(range) {
+    range = range.trim();
+    if (!range.length) {
+        return null;
+    }
+    const [tagStr, qualityStr = ''] = range.split(';');
+    const tag = new exports.LanguageTag(tagStr.trim());
+    const qualityPart = qualityStr.split(/=\s*/)[1] || '';
+    // absence of quality value implies 1.0 per rfc-7231
+    const quality = parseFloat(qualityPart.trim()) || 1.0;
+    return { tag, quality };
+}
+//# sourceMappingURL=entities.i18n.js.map

package/lib/entities/entities.i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.i18n.js","sourceRoot":"","sources":["../../src/entities/entities.i18n.ts"],"names":[],"mappings":";;;AAAA,MAAM,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAsC,CAAA;AAmCzE,QAAA,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AAMlD,QAAA,WAAW,GAAG,sBAAsB,CAAA;AAEjD;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CAAC,WAA0B,EAAE,gBAA+B;IAClG,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE;QAC9B,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QAChF,IAAI,KAAK,EAAE;YACT,OAAO,KAAK,CAAA;SACb;KACF;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AARD,4DAQC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,yBAAyB,CAAC,MAAiC;IACzE,IAAI,CAAC,MAAM,EAAE;QACX,OAAO,EAAE,CAAA;KACV;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;SAC7B,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;QACtC,IAAI,KAAK,EAAE;YACT,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;SACnB;QACD,OAAO,MAAM,CAAA;IACf,CAAC,EAAE,EAAqB,CAAC;SACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;IACxC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAC/B,CAAC;AAdD,8DAcC;AAuBD,SAAS,kBAAkB,CAAC,KAAa;IACvC,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IACpB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QACjB,OAAO,IAAI,CAAA;KACZ;IACD,MAAM,CAAE,MAAM,EAAE,UAAU,GAAG,EAAE,CAAE,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACpD,MAAM,GAAG,GAAG,IAAI,mBAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACrD,oDAAoD;IACpD,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAA;IACrD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAA;AACzB,CAAC"}

package/lib/entities/entities.json_types.d.ts

@@ -0,0 +1,42 @@
+export declare type JsonPrimitive = null | boolean | number | string;
+export declare type Json = JsonPrimitive | JsonObject | Json[];
+export declare type JsonObject = {
+    [prop: string]: Json | undefined;
+};
+/**
+ * This mapped type ensures the target type is JSON-compatible.  If so, this
+ * type maps to the given target type.  If not, this type maps to `never`.
+ * This type enforces JSON compatibility on strongly typed interfaces with
+ * strict keys because this does not use a dynamic index signature that would
+ * allow any key to be present in the target type, like {@link JsonObject}
+ * uses.  To use this type, created a class or function with a generic
+ * parameter for the target type, and substitute `EnsureJson<TargetType>` for
+ * references to `TargetType`.  For example,
+ * ```
+ * class Job<T> {
+ *   execute(): Promise<EnsureJson<T>>
+ *   chain(from: EnsureJson<T>): Job<EnsureJson<T>>
+ * }
+ * ```
+ */
+export declare type EnsureJson<T> = T extends Function ? never : T extends JsonPrimitive ? T : T extends (infer E)[] ? EnsureJson<E>[] : keyof T extends string | number ? T extends {
+    [K in keyof T]: EnsureJson<T[K]>;
+} ? T : never : never;
+export declare type JsonCompatible<T> = {
+    [P in keyof T]: T[P] extends Json ? T[P] : Pick<T, P> extends Required<Pick<T, P>> ? never : T[P] extends (() => any) | undefined ? never : JsonCompatible<T[P]>;
+};
+export { JSONSchema4 } from 'json-schema';
+import { JSONSchema4 } from 'json-schema';
+export interface JsonValidator {
+    validate(instance: Json): Promise<null | Error>;
+}
+export interface JsonSchemaService {
+    /**
+     * Validate the given JSON Schema and resolve an object that is essentially
+     * a compiled, cacheable version of the schema that can validate JSON
+     * instances.
+     * @param schema the JSON Schema to validate and compile
+     */
+    validateSchema(schema: JSONSchema4): Promise<JsonValidator>;
+}
+//# sourceMappingURL=entities.json_types.d.ts.map

package/lib/entities/entities.json_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.json_types.d.ts","sourceRoot":"","sources":["../../src/entities/entities.json_types.ts"],"names":[],"mappings":"AACA,oBAAY,aAAa,GACrB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,CAAA;AAEV,oBAAY,IAAI,GACZ,aAAa,GACb,UAAU,GACV,IAAI,EAAE,CAAA;AAEV,oBAAY,UAAU,GAAG;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,CAAA;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,UAAU,CAAC,CAAC,IACtB,CAAC,SAAS,QAAQ,GAAG,KAAK,GACxB,CAAC,SAAS,aAAa,GAAG,CAAC,GAC3B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,GACvC,MAAM,CAAC,SAAS,MAAM,GAAG,MAAM,GAC/B,CAAC,SAAS;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,CAAC,GAClD,KAAK,GACL,KAAK,CAAA;AAGT,oBAAY,cAAc,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAC7B,CAAC,CAAC,CAAC,CAAC,GACJ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACvC,KAAK,GACL,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,GAAG,SAAS,GACpC,KAAK,GACL,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACzB,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CAAA;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAC5D"}

package/lib/entities/entities.json_types.js

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

package/lib/entities/entities.json_types.js.map

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

package/lib/entities/events/entities.events.d.ts

@@ -0,0 +1,118 @@
+import { FeedId } from '../feeds/entities.feeds';
+import { Form, FormField, FormId } from './entities.events.forms';
+import { Team, TeamId } from '../teams/entities.teams';
+import { LineStyle } from '../entities.global';
+export declare type MageEventId = number;
+export interface MageEventAttrs {
+    id: MageEventId;
+    name: string;
+    description?: string;
+    complete?: boolean;
+    teamIds?: TeamId[];
+    teams?: Team[];
+    layerIds: string[];
+    feedIds: FeedId[];
+    forms: Form[];
+    minObservationForms?: number;
+    maxObservationForms?: number;
+    style: LineStyle;
+    acl: Acl;
+}
+/**
+ * A note about copying: One might think that using the spread operator `...`
+ * would be a cleaner way to quickly copy objects.  However, because `MageEvent`
+ * implements `MageEventAttrs`, and `MageEvent` uses accessor functions to
+ * return property values, the spread operator would fail to copy those
+ * properties to a new object hash.  So, to properly copy all the values of the
+ * given source object, which might be class instance or an object with
+ * properties on the protoype chain, the only fool-proof way is to explicitly
+ * read and assign the properties of interest.
+ * @param x
+ * @returns
+ */
+export declare function copyMageEventAttrs(x: MageEventAttrs): MageEventAttrs;
+export declare function copyAclAttrs(x: Acl): Acl;
+export declare class MageEvent implements Readonly<MageEventAttrs> {
+    #private;
+    constructor(attrs: MageEventAttrs);
+    get id(): number;
+    get name(): string;
+    get description(): string | undefined;
+    get complete(): boolean | undefined;
+    get teamIds(): string[] | undefined;
+    get teams(): Team[] | undefined;
+    get layerIds(): string[];
+    get feedIds(): string[];
+    get forms(): Form[];
+    /**
+     * Return only the forms for this event whose `archived` flag is `false`.
+     */
+    get activeForms(): Form[];
+    get minObservationForms(): number | undefined;
+    get maxObservationForms(): number | undefined;
+    get style(): LineStyle;
+    get acl(): Acl;
+    formFor(id: FormId): Form | null;
+    formFieldFor(fieldName: string, formId: FormId): FormField | null;
+    /**
+     * Similarly to {@link activeForms}, return only the form fields in the
+     * given form whose `archived` flag is `false` or `undefined`.
+     * @param formId
+     * @returns
+     */
+    activeFieldsForForm(formId: FormId): FormField[] | null;
+}
+export declare function formForId(id: FormId, mageEvent: MageEventAttrs): Form | null;
+export declare enum EventAccessType {
+    Read = "read",
+    Update = "update",
+    Delete = "delete"
+}
+export declare enum EventRole {
+    OWNER = "OWNER",
+    MANAGER = "MANAGER",
+    GUEST = "GUEST"
+}
+export declare type EventRolePermissions = {
+    [role in EventRole]: EventAccessType[];
+};
+export declare const EventRolePermissions: EventRolePermissions;
+export declare function rolesWithPermission(permission: EventAccessType): EventRole[];
+/**
+ * The ACL (access control list) structure is a dictionary whose keys are
+ * user IDs, and corresponding values are the role names that define the
+ * permissions the user ID has on the event.
+ */
+export interface Acl {
+    [userId: string]: {
+        role: EventRole;
+        permissions: EventAccessType[];
+    };
+}
+export declare type MageEventCreateAttrs = Pick<MageEventAttrs, 'name' | 'description'>;
+export interface MageEventRepository {
+    findAll(): Promise<MageEventAttrs[]>;
+    findById(id: MageEventId): Promise<MageEvent | null>;
+    findAllByIds(ids: MageEventId[]): Promise<{
+        [id: number]: MageEventAttrs | null;
+    }>;
+    /**
+     * Return all the MAGE events that are not {@link MageEventAttrs.complete | complete}.
+     */
+    findActiveEvents(): Promise<MageEventAttrs[]>;
+    /**
+     * Add a reference to the given feed ID on the given event.
+     * @param event an Event ID
+     * @param feed a Feed ID
+     */
+    addFeedsToEvent(event: MageEventId, ...feeds: FeedId[]): Promise<MageEventAttrs | null>;
+    findTeamsInEvent(event: MageEventId): Promise<Team[] | null>;
+    removeFeedsFromEvent(event: MageEventId, ...feeds: FeedId[]): Promise<MageEventAttrs | null>;
+    /**
+     * Remove the given feeds from any events that reference the feed.  Return the
+     * count of events the operation modified.
+     * @param feed the ID of the feed to remove from events
+     */
+    removeFeedsFromEvents(...feed: FeedId[]): Promise<number>;
+}
+//# sourceMappingURL=entities.events.d.ts.map

package/lib/entities/events/entities.events.d.ts.map

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

package/lib/entities/events/entities.events.forms.d.ts

@@ -0,0 +1,132 @@
+import { LineStyle } from '../entities.global';
+export declare type FormId = number;
+/**
+ * A `Form` instance defines a group of form fields that a user must fill to
+ * submit observation data.
+ */
+export interface Form {
+    id: FormId;
+    name: string;
+    description?: string;
+    /**
+     * Require at least the given number of entries for this form.
+     */
+    min?: number;
+    /**
+     * Limit the entries for this form to the given number.
+     */
+    max?: number;
+    fields: FormField[];
+    /**
+     * Use the value of the specified field as the first component in a map style
+     * rule that determines the map marker for observations with entries for this
+     * form.  For example, the primary field could be `vehicleType`, and values
+     * could map to different icon images that represent types of vehicles.
+     */
+    primaryField?: string;
+    /**
+     * Use the value of the specified field as the second component in a map style
+     * rule that determines the map marker for observations with entries for this
+     * form.  For example, the variant field could be `color`, and values could
+     * map to defined color values to apply to the map marker.
+     */
+    variantField?: string;
+    /**
+     * Use the value of the specified field as the most prominent heading value
+     * that a feed list view would display for an observation.
+     */
+    primaryFeedField?: string;
+    /**
+     * Use the value of the specified field as a sub-heading value that a feed
+     * list view would display for an observation.
+     */
+    secondaryFeedField?: string;
+    /**
+     * This is a list of references to fields that are dropdowns whose choices
+     * are MAGE users' names.
+     * TODO: this could be modeled better as a general choice field that
+     * specifies a data source for its choices
+     */
+    userFields: string[];
+    /**
+     * Color must be a valid hexadecimal color string prefixed with a "#" symbol,
+     * e.g., #0a0b0c.
+     */
+    color: string;
+    style?: LineStyle;
+    archived: boolean;
+}
+export declare function copyFormAttrs(x: Form): Form;
+export declare function copyFormFieldAttrs(x: FormField): FormField;
+export declare function copyFormFieldChoiceAttrs(x: FormFieldChoice): FormFieldChoice;
+export interface FormField {
+    id: number;
+    archived?: boolean;
+    name: string;
+    title: string;
+    type: FormFieldType;
+    required: boolean;
+    value?: any;
+    choices?: FormFieldChoice[];
+    /**
+     * The absence of any media type constraints indicates the field allows any
+     * file type as an attachment.
+     */
+    allowedAttachmentTypes?: AttachmentPresentationType[];
+    /**
+     * The minimum constraint applies to the value of a numeric field or to the
+     * number of attachments required on an attachment field.
+     */
+    min?: number;
+    /**
+     * The maximum constraint applies to the value of a numeric field or to the
+     * number of attachments allowed on an attachment field.
+     */
+    max?: number;
+}
+/**
+ * Attachment presentation type is the general category of how the content of an
+ * attachment is presented and consumed.
+ */
+export declare enum AttachmentPresentationType {
+    Image = "image",
+    Video = "video",
+    Audio = "audio"
+}
+/**
+ * The attachment media types are the [IANA registered Media Type](https://www.iana.org/assignments/media-types/media-types.xhtml)
+ * designations associated with the {@link content types} that MAGE supports.
+ */
+export declare const AttachmentMediaTypes: {
+    [MediaType in AttachmentPresentationType]: readonly string[];
+};
+/**
+ * TODO: this should probably move to the observations entity module with other validations
+ * Return true if the allowed attachment MIME types for the given form field
+ * include the given MIME type of a submitted attachment.
+ * @param field
+ * @param attachmentMimeType
+ */
+export declare const attachmentTypeIsValidForField: (field: FormField, attachmentMimeType: string | null | undefined) => boolean;
+export declare enum FormFieldType {
+    Attachment = "attachment",
+    CheckBox = "checkbox",
+    DateTime = "date",
+    Dropdown = "dropdown",
+    Email = "email",
+    Geometry = "geometry",
+    Hidden = "hidden",
+    MultiSelectDropdown = "multiselectdropdown",
+    Numeric = "numberfield",
+    Password = "password",
+    Radio = "radio",
+    Text = "textfield",
+    TextArea = "textarea"
+}
+export interface FormFieldChoice {
+    id: number;
+    title: string;
+    value: number;
+    blank?: boolean;
+}
+//# sourceMappingURL=entities.events.forms.d.ts.map

package/lib/entities/events/entities.events.forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.events.forms.d.ts","sourceRoot":"","sources":["../../../src/entities/events/entities.events.forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGlE,oBAAY,MAAM,GAAG,MAAM,CAAA;AAE3B;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAiB3C;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,CAc1D;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,eAAe,GAAG,eAAe,CAO5E;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,0BAA0B,EAAE,CAAA;IACrD;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,oBAAY,0BAA0B;IACpC,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE;KAAG,SAAS,IAAI,0BAA0B,GAAG,SAAS,MAAM,EAAE;CAI/F,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,UAAW,SAAS,sBAAsB,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OAQ/G,CAAA;AAED,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,QAAQ,SAAS;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,mBAAmB,wBAAwB;IAC3C,OAAO,gBAAgB;IACvB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,IAAI,cAAc;IAClB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB"}

package/lib/entities/events/entities.events.forms.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormFieldType = exports.attachmentTypeIsValidForField = exports.AttachmentMediaTypes = exports.AttachmentPresentationType = exports.copyFormFieldChoiceAttrs = exports.copyFormFieldAttrs = exports.copyFormAttrs = void 0;
+const entities_global_1 = require("../entities.global");
+function copyFormAttrs(x) {
+    return {
+        id: x.id,
+        archived: x.archived,
+        name: x.name,
+        description: x.description,
+        max: x.max,
+        min: x.min,
+        fields: x.fields.map(copyFormFieldAttrs),
+        primaryField: x.primaryField,
+        variantField: x.variantField,
+        primaryFeedField: x.primaryFeedField,
+        secondaryFeedField: x.secondaryFeedField,
+        color: x.color,
+        style: x.style ? (0, entities_global_1.copyLineStyleAttrs)(x.style) : undefined,
+        userFields: x.userFields ? [...x.userFields] : [],
+    };
+}
+exports.copyFormAttrs = copyFormAttrs;
+function copyFormFieldAttrs(x) {
+    var _a;
+    return {
+        id: x.id,
+        name: x.name,
+        required: x.required,
+        title: x.title,
+        type: x.type,
+        archived: x.archived,
+        min: x.min,
+        max: x.max,
+        value: x.value,
+        choices: (_a = x.choices) === null || _a === void 0 ? void 0 : _a.map(copyFormFieldChoiceAttrs),
+        allowedAttachmentTypes: x.allowedAttachmentTypes ? [...x.allowedAttachmentTypes] : undefined
+    };
+}
+exports.copyFormFieldAttrs = copyFormFieldAttrs;
+function copyFormFieldChoiceAttrs(x) {
+    return {
+        id: x.id,
+        title: x.title,
+        value: x.value,
+        blank: x.blank
+    };
+}
+exports.copyFormFieldChoiceAttrs = copyFormFieldChoiceAttrs;
+/**
+ * Attachment presentation type is the general category of how the content of an
+ * attachment is presented and consumed.
+ */
+var AttachmentPresentationType;
+(function (AttachmentPresentationType) {
+    AttachmentPresentationType["Image"] = "image";
+    AttachmentPresentationType["Video"] = "video";
+    AttachmentPresentationType["Audio"] = "audio";
+})(AttachmentPresentationType = exports.AttachmentPresentationType || (exports.AttachmentPresentationType = {}));
+/**
+ * The attachment media types are the [IANA registered Media Type](https://www.iana.org/assignments/media-types/media-types.xhtml)
+ * designations associated with the {@link content types} that MAGE supports.
+ */
+exports.AttachmentMediaTypes = Object.freeze({
+    [AttachmentPresentationType.Image]: Object.freeze(['image/gif', 'image/jpeg', 'image/png', 'image/webp']),
+    [AttachmentPresentationType.Video]: Object.freeze(['video/mp4', 'video/quicktime']),
+    [AttachmentPresentationType.Audio]: Object.freeze(['audio/mp4']),
+});
+/**
+ * TODO: this should probably move to the observations entity module with other validations
+ * Return true if the allowed attachment MIME types for the given form field
+ * include the given MIME type of a submitted attachment.
+ * @param field
+ * @param attachmentMimeType
+ */
+const attachmentTypeIsValidForField = (field, attachmentMimeType) => {
+    if (!field.allowedAttachmentTypes || field.allowedAttachmentTypes.length === 0) {
+        return true;
+    }
+    const allowedTypes = field.allowedAttachmentTypes || [];
+    return typeof attachmentMimeType === 'string' && allowedTypes
+        .map(mediaType => exports.AttachmentMediaTypes[mediaType])
+        .some(mimeTypes => mimeTypes.includes(attachmentMimeType));
+};
+exports.attachmentTypeIsValidForField = attachmentTypeIsValidForField;
+var FormFieldType;
+(function (FormFieldType) {
+    FormFieldType["Attachment"] = "attachment";
+    FormFieldType["CheckBox"] = "checkbox";
+    FormFieldType["DateTime"] = "date";
+    FormFieldType["Dropdown"] = "dropdown";
+    FormFieldType["Email"] = "email";
+    FormFieldType["Geometry"] = "geometry";
+    FormFieldType["Hidden"] = "hidden";
+    FormFieldType["MultiSelectDropdown"] = "multiselectdropdown";
+    FormFieldType["Numeric"] = "numberfield";
+    FormFieldType["Password"] = "password";
+    FormFieldType["Radio"] = "radio";
+    FormFieldType["Text"] = "textfield";
+    FormFieldType["TextArea"] = "textarea";
+})(FormFieldType = exports.FormFieldType || (exports.FormFieldType = {}));
+//# sourceMappingURL=entities.events.forms.js.map

package/lib/entities/events/entities.events.forms.js.map

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

package/lib/entities/events/entities.events.js

@@ -0,0 +1,146 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _MageEvent_attrs, _MageEvent_formIndex, _MageEvent_formFieldIndex;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rolesWithPermission = exports.EventRolePermissions = exports.EventRole = exports.EventAccessType = exports.formForId = exports.MageEvent = exports.copyAclAttrs = exports.copyMageEventAttrs = void 0;
+const entities_events_forms_1 = require("./entities.events.forms");
+const entities_global_1 = require("../entities.global");
+/**
+ * A note about copying: One might think that using the spread operator `...`
+ * would be a cleaner way to quickly copy objects.  However, because `MageEvent`
+ * implements `MageEventAttrs`, and `MageEvent` uses accessor functions to
+ * return property values, the spread operator would fail to copy those
+ * properties to a new object hash.  So, to properly copy all the values of the
+ * given source object, which might be class instance or an object with
+ * properties on the protoype chain, the only fool-proof way is to explicitly
+ * read and assign the properties of interest.
+ * @param x
+ * @returns
+ */
+function copyMageEventAttrs(x) {
+    return {
+        id: x.id,
+        name: x.name,
+        description: x.description,
+        complete: x.complete,
+        minObservationForms: x.minObservationForms,
+        maxObservationForms: x.maxObservationForms,
+        forms: x.forms.map(entities_events_forms_1.copyFormAttrs),
+        layerIds: [...x.layerIds],
+        feedIds: [...x.feedIds],
+        teamIds: x.teamIds ? [...x.teamIds] : undefined,
+        teams: x.teams,
+        acl: copyAclAttrs(x.acl),
+        style: (0, entities_global_1.copyLineStyleAttrs)(x.style),
+    };
+}
+exports.copyMageEventAttrs = copyMageEventAttrs;
+function copyAclAttrs(x) {
+    return Object.getOwnPropertyNames(x).reduce((acl, userId) => {
+        const entry = x[userId];
+        acl[userId] = {
+            role: entry.role,
+            permissions: entry.permissions,
+        };
+        return acl;
+    }, {});
+}
+exports.copyAclAttrs = copyAclAttrs;
+function FormFieldKey(formId, fieldName) {
+    return `${formId}::${fieldName}`;
+}
+class MageEvent {
+    constructor(attrs) {
+        _MageEvent_attrs.set(this, void 0);
+        _MageEvent_formIndex.set(this, new Map());
+        _MageEvent_formFieldIndex.set(this, new Map());
+        // TODO: deep copy
+        __classPrivateFieldSet(this, _MageEvent_attrs, Object.freeze(copyMageEventAttrs(attrs)), "f");
+        for (const form of attrs.forms) {
+            __classPrivateFieldGet(this, _MageEvent_formIndex, "f").set(form.id, form);
+            for (const field of form.fields) {
+                __classPrivateFieldGet(this, _MageEvent_formFieldIndex, "f").set(FormFieldKey(form.id, field.name), field);
+            }
+        }
+    }
+    get id() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").id; }
+    get name() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").name; }
+    get description() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").description; }
+    get complete() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").complete; }
+    get teamIds() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").teamIds; }
+    get teams() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").teams; }
+    get layerIds() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").layerIds; }
+    get feedIds() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").feedIds; }
+    get forms() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").forms; }
+    /**
+     * Return only the forms for this event whose `archived` flag is `false`.
+     */
+    get activeForms() { return this.forms.filter(x => !x.archived); }
+    get minObservationForms() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").minObservationForms; }
+    get maxObservationForms() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").maxObservationForms; }
+    get style() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").style; }
+    get acl() { return __classPrivateFieldGet(this, _MageEvent_attrs, "f").acl; }
+    formFor(id) {
+        return __classPrivateFieldGet(this, _MageEvent_formIndex, "f").get(id) || null;
+    }
+    formFieldFor(fieldName, formId) {
+        return __classPrivateFieldGet(this, _MageEvent_formFieldIndex, "f").get(FormFieldKey(formId, fieldName)) || null;
+    }
+    /**
+     * Similarly to {@link activeForms}, return only the form fields in the
+     * given form whose `archived` flag is `false` or `undefined`.
+     * @param formId
+     * @returns
+     */
+    activeFieldsForForm(formId) {
+        const form = this.formFor(formId);
+        if (form) {
+            return form.fields.filter(x => !x.archived);
+        }
+        return null;
+    }
+}
+exports.MageEvent = MageEvent;
+_MageEvent_attrs = new WeakMap(), _MageEvent_formIndex = new WeakMap(), _MageEvent_formFieldIndex = new WeakMap();
+function formForId(id, mageEvent) {
+    return mageEvent.forms.find(x => x.id === id) || null;
+}
+exports.formForId = formForId;
+var EventAccessType;
+(function (EventAccessType) {
+    EventAccessType["Read"] = "read";
+    EventAccessType["Update"] = "update";
+    EventAccessType["Delete"] = "delete";
+})(EventAccessType = exports.EventAccessType || (exports.EventAccessType = {}));
+var EventRole;
+(function (EventRole) {
+    EventRole["OWNER"] = "OWNER";
+    EventRole["MANAGER"] = "MANAGER";
+    EventRole["GUEST"] = "GUEST";
+})(EventRole = exports.EventRole || (exports.EventRole = {}));
+exports.EventRolePermissions = {
+    OWNER: [EventAccessType.Read, EventAccessType.Update, EventAccessType.Delete],
+    MANAGER: [EventAccessType.Read, EventAccessType.Update],
+    GUEST: [EventAccessType.Read],
+};
+function rolesWithPermission(permission) {
+    const roles = [];
+    for (const key in exports.EventRolePermissions) {
+        if (exports.EventRolePermissions[key].indexOf(permission) !== -1) {
+            roles.push(key);
+        }
+    }
+    return roles;
+}
+exports.rolesWithPermission = rolesWithPermission;
+//# sourceMappingURL=entities.events.js.map

package/lib/entities/events/entities.events.js.map

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