@ngageoint/mage.service 6.3.0-beta.0

package/lib/entities/feeds/entities.feeds.d.ts

@@ -0,0 +1,340 @@
+/// <reference types="node" />
+import { Json, JsonObject } from '../entities.json_types';
+import { FeatureCollection } from 'geojson';
+import { JSONSchema4 } from 'json-schema';
+import { URL } from 'url';
+import { RegisteredStaticIconReference, SourceUrlStaticIconReference, StaticIconId, StaticIconReference } from '../icons/entities.icons';
+import { LanguageTag, Locale, Localized } from '../entities.i18n';
+export declare class FeedsError<Code extends symbol, Data> extends Error {
+    readonly code: Code;
+    readonly data?: Data | undefined;
+    constructor(code: Code, data?: Data | undefined, message?: string);
+}
+export declare const ErrInvalidServiceConfig: unique symbol;
+export interface InvalidServiceConfigErrorData {
+    readonly invalidKeys: string[];
+    readonly config: Json;
+}
+export type InvalidServiceConfigError = FeedsError<typeof ErrInvalidServiceConfig, InvalidServiceConfigErrorData>;
+export declare const ErrInvalidFeedAttrs: unique symbol;
+export type InvalidFeedAttrsErrorData = {
+    readonly invalidKeys?: string[];
+};
+export type InvalidFeedAttrsError = FeedsError<typeof ErrInvalidFeedAttrs, InvalidFeedAttrsErrorData>;
+export declare const FeedServiceTypeUnregistered: unique symbol;
+export type FeedServiceTypeId = string | typeof FeedServiceTypeUnregistered;
+export interface FeedServiceType {
+    readonly id: FeedServiceTypeId;
+    readonly pluginServiceTypeId: string;
+    readonly title: string;
+    readonly summary: string | null;
+    readonly configSchema: JSONSchema4 | null;
+    validateServiceConfig(config: Json): Promise<null | InvalidServiceConfigError>;
+    /**
+     * Remove data from the given service coniguration document that is sensitive
+     * or otherwise unsuitable to send over the wire to a service client.
+     * TODO: this might go away in favor of a marking properties on config
+     * instances as secret
+     * @param config
+     */
+    redactServiceConfig(config: Json): Json;
+    createConnection(config: Json, context?: ServiceConnectionContext): Promise<FeedServiceConnection>;
+}
+/**
+ * The connection context can include extra standard infmoration, such as the
+ * client's localization information, or perhaps authentication mechanism
+ * parameters, such as OpenID Connect.
+ */
+export interface ServiceConnectionContext {
+    /**
+     * The locale holds localization information such as a client's preferred
+     * language.
+     */
+    locale?: Locale | null | undefined;
+}
+export type RegisteredFeedServiceType = FeedServiceType & {
+    id: string;
+};
+/**
+ * A feed service ID is globally unique.
+ */
+export type FeedServiceId = string;
+export interface FeedServiceInfo {
+    readonly title: string;
+    readonly summary: string;
+}
+export interface FeedService {
+    id: FeedServiceId;
+    serviceType: FeedServiceTypeId;
+    title: string;
+    summary: string | null;
+    config: Json;
+}
+export interface FeedServiceConnection {
+    fetchServiceInfo(): Promise<FeedServiceInfo | null>;
+    fetchAvailableTopics(): Promise<FeedTopic[]>;
+    fetchTopicContent(topic: FeedTopicId, params?: JsonObject): Promise<FeedTopicContent>;
+}
+export interface FeedServiceTypeRepository {
+    register(moduleName: string, serviceType: FeedServiceType): Promise<RegisteredFeedServiceType>;
+    findAll(): Promise<FeedServiceType[]>;
+    findById(serviceTypeId: FeedServiceTypeId): Promise<FeedServiceType | null>;
+}
+export type FeedServiceCreateAttrs = Pick<FeedService, 'serviceType' | 'title' | 'summary' | 'config'>;
+export interface FeedServiceRepository {
+    create(feedAttrs: FeedServiceCreateAttrs): Promise<FeedService>;
+    findAll(): Promise<FeedService[]>;
+    findById(serviceId: FeedServiceId): Promise<FeedService | null>;
+    removeById(serviceId: FeedServiceId): Promise<FeedService | null>;
+}
+/**
+ * A topic ID is unique in the context the providing {@linkcode FeedService}.
+ */
+export type FeedTopicId = string;
+export interface FeedTopic {
+    readonly id: FeedTopicId;
+    readonly title: string;
+    readonly summary?: string;
+    /**
+     * This icon represents the overall topic, such as in a list of available
+     * topics.  This icon may also potentially represent the content items in the
+     * topic on a map or in a list if no item style assigns an icon to content
+     * items.
+     */
+    readonly icon?: SourceUrlStaticIconReference;
+    /**
+     * The paramters schema defines the parameters MAGE can use to fetch and
+     * filter content from the topic.
+     */
+    readonly paramsSchema?: JSONSchema4;
+    /**
+     * A topic's update frequency is a hint about how often a service might
+     * publish new data to a topic.  A value of `undefined` indicates a topic's
+     * update frequency is unknown and requires configuration in a derived
+     * {@linkcode Feed}.
+     */
+    readonly updateFrequencySeconds?: number;
+    /**
+     * When feed items have identity, the `id` property of the GeoJSON feature
+     * items fetched from a feed will contain a persistent unique identifier for
+     * the items.  The same item across mulutiple fetches will have the same
+     * `id` property value.  Consumers of feed content can then present changes as
+     * updates to previously fetched items, for example updating the location of
+     * a moving vehicle.  A value of `undefined` indicates a topic's item identity
+     * is unknown and requires configuration in a derived {@linkcode Feed}.
+     */
+    readonly itemsHaveIdentity?: boolean;
+    /**
+     * Feed items with a spatial dimension will translate to GeoJSON features with
+     * non-null geometries.  A value of `undefined` indicates a topic's spatial
+     * dimension is unknown and requires configuration in a derived
+     * {@linkcode Feed}.
+     */
+    readonly itemsHaveSpatialDimension?: boolean;
+    /**
+     * A topic's `itemPropertiesSchema` describes the shape of the [`properties`](https://www.rfc-editor.org/rfc/rfc7946.html#section-3.2)
+     * object of the GeoJSON Features that a topic provides.  The schema should
+     * be relatively flat, describing simple key-value pairs with titles and
+     * descriptions.  Complex schemas with nested structures will not have robust
+     * support from MAGE's core clients.
+     */
+    readonly itemPropertiesSchema?: JSONSchema4;
+    /**
+     * Feed items with a temporal property will translate to GeoJSON features
+     * that have a temporal property whose value is a numeric epoch timestamp.  A
+     * value of `undefined` indicates a topic's temporal property is unknown and
+     * requires configuration in a derived {@linkcode Feed}.
+     */
+    readonly itemTemporalProperty?: string;
+    /**
+     * The primary property of a GeoJSON feature feed item is the main value that
+     * should represent the item in a list view to the end user, as well as in
+     * a popup on a map view.  A value of `undefined` indicates a topic's primary
+     * property is unknown and requires configuration in a derived
+     * {@linkcode Feed}.
+     */
+    readonly itemPrimaryProperty?: string;
+    /**
+     * Simimlar to {@linkcode FeedTopic.itemPrimaryProperty}, the intent of the
+     * secondary of a GeoJSON feature feed item is to indicate a value that
+     * represents the item in a list or map view to the end user.  The secondary
+     * property can add a bit of enhancing detail about the item to the primary
+     * property.  A value of `undefined` indicates a topic's secondary property is
+     * unknown and requires configuration in a derived {@linkcode Feed}.
+     */
+    readonly itemSecondaryProperty?: string;
+    readonly mapStyle?: MapStyle;
+    /**
+     * The `Topic` `localization` is a dictionary whose keys are [RFC-5646](https://www.rfc-editor.org/rfc/rfc5646.html)
+     * Localization of the topic applies mainly to the titles and descriptions
+     * the {@link FeedTopic.itemPropertiesSchema | `itemPropertiesSchema`} defines,
+     * but could also indicate the language of the {@link FeedTopic.title | title},
+     * {@link FeedTopic.summary | summary}, and even {@link FeedTopic.icon | icon}, if
+     * those properties have localized values.  This is similar to HTTP's
+     * [`Content-Language`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Language) header.
+     */
+    readonly localization?: {
+        [rfc5646LanguageTag: string]: {
+            title?: string;
+            summary?: string;
+            properties?: {
+                [key: string]: Pick<JSONSchema4, 'title' | 'description'> | undefined;
+            };
+        };
+    };
+}
+export interface FeedTopicContent {
+    topic: FeedTopicId;
+    items: FeatureCollection;
+    /**
+     * A feed service may provide content in different languages based on the
+     * client's {@link ServiceConnectionContext.locale | real or preferred localization}.
+     */
+    language?: LanguageTag[] | null | undefined;
+    pageCursor?: Json;
+}
+/** A feed ID is globally unique. */
+export type FeedId = string;
+export interface Feed {
+    id: FeedId;
+    service: FeedServiceId;
+    topic: FeedTopicId;
+    title: string;
+    summary?: string;
+    icon?: RegisteredStaticIconReference;
+    /**
+     * The constant paramters are a subset of a topic's parameters that an
+     * administrative user defines and that MAGE will apply to every fetch
+     * request to the feed's source topic.  An example of a constant parameter
+     * might be `apiKey`.  MAGE does not expose constant parameters to the end-
+     * user consumer of the feed.
+     */
+    constantParams?: FeedContentParams;
+    /**
+     * The variable parameters schema of a feed is a schema an administrative user
+     * can define to advertise the parameters feed consumers can pass when
+     * fetching content from a feed.  This schema could be the same as that of the
+     * source  {@linkcode FeedTopic} or could be a more restrictive subset of the
+     * topic schema.
+     */
+    variableParamsSchema?: JSONSchema4;
+    /**
+     * A feed's update frequency is similar to the like-named property on its
+     * underlying topic.  While a topic's update frequency would come from the
+     * implementing plugin, a feed's update frequency would likely come from user
+     * configuration based on the parameters of the feed as well as the update
+     * frequency of the underlying topic.  This allows for feed service type
+     * plugins that are too generic to know what an appropriate update interval
+     * would be for particular service's topics.
+     */
+    updateFrequencySeconds?: number;
+    /**
+     * This flag is similar to the like-named property on its source
+     * {@linkcode FeedTopic}, but as with {@linkcode Feed.updateFrequency}, allows
+     * configuration by an administrative user.
+     */
+    itemsHaveIdentity: boolean;
+    itemsHaveSpatialDimension: boolean;
+    itemPropertiesSchema?: JSONSchema4;
+    itemTemporalProperty?: string;
+    /**
+     * A feed that does not have a primary property (implying there is no
+     * secondary as well) covers the case that a data set might provide only
+     * spatial geometries, and the feed/topic context provides the implicit
+     * meaning of the geometry data.
+     */
+    itemPrimaryProperty?: string;
+    itemSecondaryProperty?: string;
+    mapStyle?: ResolvedMapStyle;
+    /**
+     * See {@link FeedTopic.localization}.
+     */
+    localization?: FeedTopic['localization'];
+}
+/**
+ * TODO: This could move outside of feeds to be used for other map-able
+ * elements.
+ */
+export interface MapStyle {
+    stroke?: HexRgb;
+    strokeOpacity?: number;
+    strokeWidth?: number;
+    fill?: HexRgb;
+    fillOpacity?: number;
+    icon?: SourceUrlStaticIconReference;
+}
+export type ResolvedMapStyle = Omit<MapStyle, 'icon'> & {
+    icon?: RegisteredStaticIconReference;
+};
+/**
+ * HexRgb is the typical hexadecimal, 24-bit color string.
+ */
+export type HexRgb = string;
+export type FeedCreateAttrs = Omit<Feed, 'id'> & Partial<Pick<Feed, 'id'>>;
+export interface FeedRepository {
+    create(attrs: FeedCreateAttrs): Promise<Feed>;
+    findById(id: FeedId): Promise<Feed | null>;
+    findAllByIds(feedIds: FeedId[]): Promise<{
+        [id: string]: Feed | null;
+    }>;
+    findAll(): Promise<Feed[]>;
+    findFeedsForService(service: FeedServiceId): Promise<Feed[]>;
+    put(feed: Feed): Promise<Feed | null>;
+    removeById(feedId: FeedId): Promise<Feed | null>;
+    removeByServiceId(serviceId: FeedServiceId): Promise<Feed[]>;
+}
+type OptionalPropertyOf<T extends object> = Exclude<{
+    [K in keyof T]: T extends Record<K, T[K]> ? never : K;
+}[keyof T], undefined>;
+export type FeedOverrideTopicNullableKeys = OptionalPropertyOf<Feed>;
+export type FeedCreateMinimal = Partial<Omit<Feed, 'id' | FeedOverrideTopicNullableKeys>> & Pick<Feed, 'topic' | 'service'> & {
+    [nullable in FeedOverrideTopicNullableKeys]?: FeedCreateUnresolved[nullable] | null;
+};
+export type FeedUpdateMinimal = Omit<FeedCreateMinimal, 'service' | 'topic' | 'id'> & Pick<Feed, 'id'>;
+export type FeedCreateUnresolved = Omit<FeedCreateAttrs, 'icon' | 'mapStyle'> & {
+    icon?: StaticIconReference;
+    mapStyle?: MapStyle | ResolvedMapStyle;
+    unresolvedIcons: URL[];
+};
+/**
+ * This is a factory function to build the attributes for creating a feed by
+ * merging a minimal set of client input attributes with those of the source
+ * topic.  Attributes that are not present or have an `undefined` value in the
+ * input will receive the corresponding value from the topic. Keys with a `null`
+ * value (where allowed) explicitly instruct that the resulting feed will not
+ * receive the correspondingvalues from the topic and be absent in the resulting
+ * create attributes.
+ *
+ * The `Unresolved` qualification indicates that the input and result attributes
+ * may contain URLs of icons that are not yet registered with MAGE's icon
+ * repository.  Any unresolved URLs will be in the `unresolvedIcons` array.
+ */
+export declare function FeedCreateUnresolved(topic: FeedTopic, feedMinimal: Readonly<FeedCreateMinimal>): FeedCreateUnresolved | InvalidFeedAttrsError;
+/**
+ * Ensure the given feed's {@link Feed.itemPrimaryProperty | `itemPrimaryProperty`},
+ * {@link Feed.itemSecondaryProperty | `itemSecondaryProperty`}, and {@link Feed.itemTemporalProperty | `itemTemporalProperty`}
+ * reference valid properties in the feed's {@link Feed.itemPropertiesSchema | `itemPropertiesSchema`}
+ * @param feed
+ * @returns
+ */
+export declare function validateSchemaPropertyReferencesForFeed<T extends Feed | FeedCreateAttrs | FeedCreateMinimal | FeedUpdateMinimal>(feed: T): T | InvalidFeedAttrsError;
+export declare function FeedCreateAttrs(unresolved: FeedCreateUnresolved, icons: {
+    [iconUrl: string]: StaticIconId;
+}): FeedCreateAttrs;
+/**
+ * Iterate the features of the given feature collection and remove from the
+ * `properties` object of each feature any entries that the given schema does
+ * not define.  Return a new feature collection object with the modified
+ * features.
+ * @param featureCollection
+ * @param itemPropertiesSchema
+ */
+export declare function retainSchemaPropertiesInFeatures(featureCollection: FeatureCollection, itemPropertiesSchema?: Feed['itemPropertiesSchema'] | null): FeatureCollection;
+export declare function localizedFeed(feed: Feed, targetLanguages: LanguageTag[]): Localized<Feed>;
+export type FeedContentParams = JsonObject;
+export interface FeedContent extends FeedTopicContent {
+    readonly feed: FeedId;
+    readonly variableParams?: FeedContentParams;
+}
+export {};
+//# sourceMappingURL=entities.feeds.d.ts.map

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

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

package/lib/entities/feeds/entities.feeds.js

@@ -0,0 +1,213 @@
+"use strict";
+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.localizedFeed = exports.retainSchemaPropertiesInFeatures = exports.FeedCreateAttrs = exports.validateSchemaPropertyReferencesForFeed = exports.FeedCreateUnresolved = exports.FeedServiceTypeUnregistered = exports.ErrInvalidFeedAttrs = exports.ErrInvalidServiceConfig = exports.FeedsError = void 0;
+const lodash_1 = __importDefault(require("lodash"));
+const entities_i18n_1 = require("../entities.i18n");
+class FeedsError extends Error {
+    constructor(code, data, message) {
+        super(message ? message : Symbol.keyFor(code));
+        this.code = code;
+        this.data = data;
+    }
+}
+exports.FeedsError = FeedsError;
+exports.ErrInvalidServiceConfig = Symbol.for('err.feeds.invalid_service_config');
+exports.ErrInvalidFeedAttrs = Symbol.for('err.feeds.invalid_feed_attrs');
+exports.FeedServiceTypeUnregistered = Symbol.for('err.feeds.service_type_unregistered');
+/**
+ * This is a factory function to build the attributes for creating a feed by
+ * merging a minimal set of client input attributes with those of the source
+ * topic.  Attributes that are not present or have an `undefined` value in the
+ * input will receive the corresponding value from the topic. Keys with a `null`
+ * value (where allowed) explicitly instruct that the resulting feed will not
+ * receive the correspondingvalues from the topic and be absent in the resulting
+ * create attributes.
+ *
+ * The `Unresolved` qualification indicates that the input and result attributes
+ * may contain URLs of icons that are not yet registered with MAGE's icon
+ * repository.  Any unresolved URLs will be in the `unresolvedIcons` array.
+ */
+function FeedCreateUnresolved(topic, feedMinimal) {
+    var _a;
+    const nonNullable = {
+        service: feedMinimal.service,
+        topic: topic.id,
+        title: feedMinimal.title || topic.title,
+        itemsHaveIdentity: feedMinimal.itemsHaveIdentity === undefined ? topic.itemsHaveIdentity || false : feedMinimal.itemsHaveIdentity,
+        itemsHaveSpatialDimension: feedMinimal.itemsHaveSpatialDimension === undefined ? topic.itemsHaveSpatialDimension || false : feedMinimal.itemsHaveSpatialDimension,
+    };
+    const nullable = {
+        summary: feedMinimal.summary === null ? undefined : feedMinimal.summary || topic.summary,
+        constantParams: feedMinimal.constantParams || undefined,
+        variableParamsSchema: feedMinimal.variableParamsSchema || undefined,
+        itemPropertiesSchema: feedMinimal.itemPropertiesSchema === null ? undefined : feedMinimal.itemPropertiesSchema || topic.itemPropertiesSchema,
+        itemPrimaryProperty: feedMinimal.itemPrimaryProperty === null ? undefined : feedMinimal.itemPrimaryProperty || topic.itemPrimaryProperty,
+        itemSecondaryProperty: feedMinimal.itemSecondaryProperty === null ? undefined : feedMinimal.itemSecondaryProperty || topic.itemSecondaryProperty,
+        itemTemporalProperty: feedMinimal.itemTemporalProperty === null ? undefined : feedMinimal.itemTemporalProperty || topic.itemTemporalProperty,
+        updateFrequencySeconds: feedMinimal.updateFrequencySeconds === null ? undefined : feedMinimal.updateFrequencySeconds || topic.updateFrequencySeconds,
+        mapStyle: feedMinimal.mapStyle === null ? undefined :
+            feedMinimal.mapStyle ? Object.assign({}, feedMinimal.mapStyle) :
+                topic.mapStyle ? Object.assign({}, topic.mapStyle) : undefined,
+        localization: feedMinimal.localization === null ? undefined :
+            feedMinimal.localization ? Object.assign({}, feedMinimal.localization) :
+                topic.localization ? Object.assign({}, topic.localization) : undefined
+    };
+    if (feedMinimal.icon !== null) {
+        if (feedMinimal.icon) {
+            nullable.icon = feedMinimal.icon;
+        }
+        else if (topic.icon) {
+            nullable.icon = topic.icon;
+        }
+    }
+    const unresolvedIcons = [];
+    let icon = nullable.icon || { sourceUrl: null };
+    if (icon.sourceUrl) {
+        unresolvedIcons.push(icon.sourceUrl);
+    }
+    icon = ((_a = nullable.mapStyle) === null || _a === void 0 ? void 0 : _a.icon) || { sourceUrl: null };
+    if (icon.sourceUrl) {
+        unresolvedIcons.push(icon.sourceUrl);
+    }
+    const unresolvedAttrs = Object.assign(Object.assign(Object.assign({}, nonNullable), nullable), { unresolvedIcons });
+    for (const key in unresolvedAttrs) {
+        const attr = key;
+        if (typeof unresolvedAttrs[attr] === 'undefined') {
+            delete unresolvedAttrs[attr];
+        }
+    }
+    return validateSchemaPropertyReferencesForFeed(unresolvedAttrs);
+}
+exports.FeedCreateUnresolved = FeedCreateUnresolved;
+/**
+ * Ensure the given feed's {@link Feed.itemPrimaryProperty | `itemPrimaryProperty`},
+ * {@link Feed.itemSecondaryProperty | `itemSecondaryProperty`}, and {@link Feed.itemTemporalProperty | `itemTemporalProperty`}
+ * reference valid properties in the feed's {@link Feed.itemPropertiesSchema | `itemPropertiesSchema`}
+ * @param feed
+ * @returns
+ */
+function validateSchemaPropertyReferencesForFeed(feed) {
+    var _a;
+    const schemaProps = (_a = feed.itemPropertiesSchema) === null || _a === void 0 ? void 0 : _a.properties;
+    if (!schemaProps) {
+        return feed;
+    }
+    const referencedProps = [feed.itemPrimaryProperty, feed.itemSecondaryProperty, feed.itemTemporalProperty];
+    if (referencedProps.every(key => key ? schemaProps.hasOwnProperty(key) : true)) {
+        return feed;
+    }
+    return new FeedsError(exports.ErrInvalidFeedAttrs, { invalidKeys: ['itemPropertiesSchema'] }, 'feed item properties schema must include primary, secondary, and temporal properties');
+}
+exports.validateSchemaPropertyReferencesForFeed = validateSchemaPropertyReferencesForFeed;
+const resolvedMapStyle = (unresolved, icons) => {
+    const { icon } = unresolved, rest = __rest(unresolved, ["icon"]);
+    if (!icon) {
+        return rest;
+    }
+    const resolved = rest;
+    if (icon.sourceUrl) {
+        const id = icons[String(icon.sourceUrl)];
+        if (id) {
+            resolved.icon = { id };
+        }
+    }
+    else {
+        resolved.icon = Object.assign({}, icon);
+    }
+    return resolved;
+};
+function FeedCreateAttrs(unresolved, icons) {
+    icons = icons || {};
+    const { unresolvedIcons, icon, mapStyle } = unresolved, rest = __rest(unresolved, ["unresolvedIcons", "icon", "mapStyle"]);
+    const resolved = rest;
+    if (mapStyle) {
+        resolved.mapStyle = resolvedMapStyle(mapStyle, icons);
+    }
+    if (icon) {
+        if (icon.sourceUrl) {
+            const id = icons[String(icon.sourceUrl)];
+            if (id) {
+                resolved.icon = { id };
+            }
+        }
+        else {
+            resolved.icon = Object.assign({}, icon);
+        }
+    }
+    return resolved;
+}
+exports.FeedCreateAttrs = FeedCreateAttrs;
+/**
+ * Iterate the features of the given feature collection and remove from the
+ * `properties` object of each feature any entries that the given schema does
+ * not define.  Return a new feature collection object with the modified
+ * features.
+ * @param featureCollection
+ * @param itemPropertiesSchema
+ */
+function retainSchemaPropertiesInFeatures(featureCollection, itemPropertiesSchema) {
+    if (!itemPropertiesSchema || !itemPropertiesSchema.properties) {
+        return featureCollection;
+    }
+    const retainedPropertyKeys = Object.keys(itemPropertiesSchema.properties);
+    const features = (featureCollection.features || []).map(feature => {
+        const properties = feature.properties ? lodash_1.default.pick(feature.properties, ...retainedPropertyKeys) : null;
+        return Object.assign(Object.assign({}, feature), { properties });
+    });
+    return Object.assign(Object.assign({}, featureCollection), { features });
+}
+exports.retainSchemaPropertiesInFeatures = retainSchemaPropertiesInFeatures;
+function localizedFeed(feed, targetLanguages) {
+    var _a;
+    if (!feed.localization) {
+        return feed;
+    }
+    const contentLanguages = Object.keys(feed.localization).map(x => new entities_i18n_1.LanguageTag(x));
+    const matchedLanguage = (0, entities_i18n_1.selectContentLanguageFor)(targetLanguages, contentLanguages);
+    if (!matchedLanguage) {
+        return lodash_1.default.omit(feed, 'localization');
+    }
+    const translations = feed.localization[matchedLanguage.toString()];
+    const localized = Object.assign(Object.assign({}, feed), { [entities_i18n_1.ContentLanguageKey]: matchedLanguage });
+    if (translations.title) {
+        localized.title = translations.title;
+    }
+    if (translations.summary) {
+        localized.summary = translations.summary;
+    }
+    if (translations.properties) {
+        const localProperties = translations.properties;
+        const mainProperties = Object.assign({}, (_a = feed.itemPropertiesSchema) === null || _a === void 0 ? void 0 : _a.properties);
+        localized.itemPropertiesSchema = Object.assign(Object.assign({}, feed.itemPropertiesSchema), { properties: Object.entries(mainProperties).reduce((properties, entry) => {
+                const [propertyKey, propertySchema] = entry;
+                const localPropertyDesc = localProperties[propertyKey];
+                const localPropertySchema = Object.assign({}, propertySchema);
+                if (localPropertyDesc === null || localPropertyDesc === void 0 ? void 0 : localPropertyDesc.title) {
+                    localPropertySchema.title = localPropertyDesc.title;
+                }
+                if (localPropertyDesc === null || localPropertyDesc === void 0 ? void 0 : localPropertyDesc.description) {
+                    localPropertySchema.description = localPropertyDesc.description;
+                }
+                properties[propertyKey] = localPropertySchema;
+                return properties;
+            }, {}) });
+    }
+    delete localized['localization'];
+    return localized;
+}
+exports.localizedFeed = localizedFeed;
+//# sourceMappingURL=entities.feeds.js.map

package/lib/entities/feeds/entities.feeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.feeds.js","sourceRoot":"","sources":["../../../src/entities/feeds/entities.feeds.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAMA,oDAAsB;AACtB,oDAA+G;AAG/G,MAAa,UAAsC,SAAQ,KAAK;IAC9D,YAAqB,IAAU,EAAW,IAAW,EAAE,OAAgB;QACrE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QAD3B,SAAI,GAAJ,IAAI,CAAM;QAAW,SAAI,GAAJ,IAAI,CAAO;IAErD,CAAC;CACF;AAJD,gCAIC;AAEY,QAAA,uBAAuB,GAAG,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAA;AAOxE,QAAA,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAA;AAMhE,QAAA,2BAA2B,GAAG,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAA;AAyT5F;;;;;;;;;;;;GAYG;AACH,SAAgB,oBAAoB,CAAC,KAAgB,EAAE,WAAwC;;IAE7F,MAAM,WAAW,GAA2B;QAC1C,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;QACvC,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,iBAAiB;QACjI,yBAAyB,EAAE,WAAW,CAAC,yBAAyB,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,yBAAyB,IAAI,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,yBAAyB;KAClK,CAAA;IACD,MAAM,QAAQ,GAA2E;QACvF,OAAO,EAAE,WAAW,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;QACxF,cAAc,EAAE,WAAW,CAAC,cAAc,IAAI,SAAS;QACvD,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,IAAI,SAAS;QACnE,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,oBAAoB,IAAI,KAAK,CAAC,oBAAoB;QAC5I,mBAAmB,EAAE,WAAW,CAAC,mBAAmB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,mBAAmB,IAAI,KAAK,CAAC,mBAAmB;QACxI,qBAAqB,EAAE,WAAW,CAAC,qBAAqB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,qBAAqB,IAAI,KAAK,CAAC,qBAAqB;QAChJ,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,oBAAoB,IAAI,KAAK,CAAC,oBAAoB;QAC5I,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,sBAAsB,IAAI,KAAK,CAAC,sBAAsB;QACpJ,QAAQ,EAAE,WAAW,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACnD,WAAW,CAAC,QAAQ,CAAC,CAAC,mBAAM,WAAW,CAAC,QAAQ,EAAG,CAAC;gBACpD,KAAK,CAAC,QAAQ,CAAC,CAAC,mBAAM,KAAK,CAAC,QAAQ,EAAG,CAAC,CAAC,SAAS;QACpD,YAAY,EAAE,WAAW,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC3D,WAAW,CAAC,YAAY,CAAC,CAAC,mBAAM,WAAW,CAAC,YAAY,EAAG,CAAC;gBAC5D,KAAK,CAAC,YAAY,CAAC,CAAC,mBAAM,KAAK,CAAC,YAAY,EAAG,CAAC,CAAC,SAAS;KAC7D,CAAA;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI,EAAE;QAC7B,IAAI,WAAW,CAAC,IAAI,EAAE;YACpB,QAAQ,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAA;SACjC;aACI,IAAI,KAAK,CAAC,IAAI,EAAE;YACnB,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;SAC3B;KACF;IACD,MAAM,eAAe,GAAU,EAAE,CAAA;IACjC,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;IAC/C,IAAI,IAAI,CAAC,SAAS,EAAE;QAClB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;KACrC;IACD,IAAI,GAAG,CAAA,MAAA,QAAQ,CAAC,QAAQ,0CAAE,IAAI,KAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;IACrD,IAAI,IAAI,CAAC,SAAS,EAAE;QAClB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;KACrC;IACD,MAAM,eAAe,iDAChB,WAAW,GACX,QAAQ,KACX,eAAe,GAChB,CAAA;IACD,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE;QACjC,MAAM,IAAI,GAAG,GAAmC,CAAA;QAChD,IAAI,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE;YAChD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAA;SAC7B;KACF;IACD,OAAO,uCAAuC,CAAC,eAAe,CAAC,CAAA;AACjE,CAAC;AAtDD,oDAsDC;AAED;;;;;;GAMG;AACH,SAAgB,uCAAuC,CAA2E,IAAO;;IACvI,MAAM,WAAW,GAAG,MAAA,IAAI,CAAC,oBAAoB,0CAAE,UAAU,CAAA;IACzD,IAAI,CAAC,WAAW,EAAE;QAChB,OAAO,IAAI,CAAA;KACZ;IACD,MAAM,eAAe,GAAG,CAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,oBAAoB,CAAE,CAAA;IAC3G,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;QAC9E,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,IAAI,UAAU,CAAC,2BAAmB,EAAE,EAAE,WAAW,EAAE,CAAE,sBAAsB,CAAE,EAAE,EACpF,sFAAsF,CAAC,CAAA;AAC3F,CAAC;AAXD,0FAWC;AAED,MAAM,gBAAgB,GAAG,CAAC,UAAuC,EAAE,KAA0C,EAAoB,EAAE;IACjI,MAAM,EAAE,IAAI,KAAc,UAAU,EAAnB,IAAI,UAAK,UAAU,EAA9B,QAAiB,CAAa,CAAA;IACpC,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,IAAI,CAAA;KACZ;IACD,MAAM,QAAQ,GAAqB,IAAI,CAAA;IACvC,IAAI,IAAI,CAAC,SAAS,EAAE;QAClB,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;QACxC,IAAI,EAAE,EAAE;YACN,QAAQ,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAA;SACvB;KACF;SACI;QACH,QAAQ,CAAC,IAAI,qBAAQ,IAAI,CAAE,CAAA;KAC5B;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED,SAAgB,eAAe,CAAC,UAAgC,EAAE,KAA0C;IAC1G,KAAK,GAAG,KAAK,IAAI,EAAE,CAAA;IACnB,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,KAAc,UAAU,EAAnB,IAAI,UAAK,UAAU,EAAzD,uCAA4C,CAAa,CAAA;IAC/D,MAAM,QAAQ,GAAG,IAAuB,CAAA;IACxC,IAAI,QAAQ,EAAE;QACZ,QAAQ,CAAC,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;KACtD;IACD,IAAI,IAAI,EAAE;QACR,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;YACxC,IAAI,EAAE,EAAE;gBACN,QAAQ,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAA;aACvB;SACF;aACI;YACH,QAAQ,CAAC,IAAI,qBAAQ,IAAI,CAAE,CAAA;SAC5B;KACF;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAnBD,0CAmBC;AAED;;;;;;;GAOG;AACH,SAAgB,gCAAgC,CAAC,iBAAoC,EAAE,oBAA0D;IAC/I,IAAI,CAAC,oBAAoB,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE;QAC7D,OAAO,iBAAiB,CAAA;KACzB;IACD,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAA;IACzE,MAAM,QAAQ,GAAG,CAAC,iBAAiB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAClG,uCACK,OAAO,KACV,UAAU,IACX;IACH,CAAC,CAAC,CAAA;IACF,uCACK,iBAAiB,KACpB,QAAQ,IACT;AACH,CAAC;AAhBD,4EAgBC;AAED,SAAgB,aAAa,CAAC,IAAU,EAAE,eAA8B;;IACtE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;QACtB,OAAO,IAAI,CAAA;KACZ;IACD,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,IAAI,2BAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACrF,MAAM,eAAe,GAAG,IAAA,wCAAwB,EAAC,eAAe,EAAE,gBAAgB,CAAC,CAAA;IACnF,IAAI,CAAC,eAAe,EAAE;QACpB,OAAO,gBAAC,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;KACpC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAA;IAClE,MAAM,SAAS,mCACV,IAAI,KACP,CAAC,kCAAkB,CAAC,EAAE,eAAe,GACtC,CAAA;IACD,IAAI,YAAY,CAAC,KAAK,EAAE;QACtB,SAAS,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAA;KACrC;IACD,IAAI,YAAY,CAAC,OAAO,EAAE;QACxB,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAA;KACzC;IACD,IAAI,YAAY,CAAC,UAAU,EAAE;QAC3B,MAAM,eAAe,GAAG,YAAY,CAAC,UAAU,CAAA;QAC/C,MAAM,cAAc,qBAAQ,MAAA,IAAI,CAAC,oBAAoB,0CAAE,UAAU,CAAE,CAAA;QACnE,SAAS,CAAC,oBAAoB,mCACzB,IAAI,CAAC,oBAAoB,KAC5B,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;gBACtE,MAAM,CAAE,WAAW,EAAE,cAAc,CAAE,GAAG,KAAK,CAAA;gBAC7C,MAAM,iBAAiB,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;gBACtD,MAAM,mBAAmB,qBAAQ,cAAc,CAAE,CAAA;gBACjD,IAAI,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,KAAK,EAAE;oBAC5B,mBAAmB,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAA;iBACpD;gBACD,IAAI,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,WAAW,EAAE;oBAClC,mBAAmB,CAAC,WAAW,GAAG,iBAAiB,CAAC,WAAW,CAAA;iBAChE;gBACD,UAAW,CAAC,WAAW,CAAC,GAAG,mBAAmB,CAAA;gBAC9C,OAAO,UAAU,CAAA;YACnB,CAAC,EAAE,EAA+B,CAAC,GACpC,CAAA;KACF;IACD,OAAO,SAAS,CAAC,cAAc,CAAC,CAAA;IAChC,OAAO,SAAS,CAAA;AAClB,CAAC;AA1CD,sCA0CC"}