@openactive/models-ts
Version:
JavaScript/TypeScript implementation of OpenActive's data model
173 lines (172 loc) • 9.31 kB
TypeScript
import * as Joi from 'joi';
import { OaValidationError } from '../oaValidationError';
import * as oa from '../oa';
import * as schema from '../schema';
/**
* LocationFeatureSpecification
*
* This type is derived from https://schema.org/LocationFeatureSpecification, which means that any of this type's properties within schema.org may also be used.
*/
export declare type LocationFeatureSpecification = {
'@type': 'LocationFeatureSpecification';
'@context'?: string | string[];
/**
* The identifier property represents any kind of identifier for any kind of [[Thing]], such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See [background notes](/docs/datamodel.html#identifierBg) for more details.
*
*/
identifier?: schema.PropertyValueOrSubClass | string;
/**
* A string, suitable for presentation in user interfaces.
*
* ```json
* "name": "Bike Shed"
* ```
*/
name?: string;
/**
* A description of the item.
*/
description?: string;
/**
* A unique url based identifier for the record
*/
'@id'?: string;
/**
* A boolean value indicating whether this ammenity is available.
*/
value?: boolean;
/**
* The date when the item becomes valid.
*/
validFrom?: string;
/**
* The hours during which this service or contact is available.
*/
hoursAvailable?: schema.OpeningHoursSpecificationOrSubClass | string;
/**
* The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours.
*/
validThrough?: string;
/**
* The upper value of some characteristic or property.
*/
maxValue?: number;
/**
* A string or text indicating the unit of measurement. Useful if you cannot provide a standard unit code for
* <a href='unitCode'>unitCode</a>.
*/
unitText?: string;
/**
* The unit of measurement given using the UN/CEFACT Common Code (3 characters) or a URL. Other codes than the UN/CEFACT Common Code may be used with a prefix followed by a colon.
*/
unitCode?: string;
/**
* A secondary value that provides additional information on the original value, e.g. a reference temperature or a type of measurement.
*/
valueReference?: schema.QuantitativeValueOrSubClass | schema.MeasurementTypeEnumeration | schema.DefinedTermOrSubClass | schema.EnumerationOrSubClass | schema.PropertyValueOrSubClass | schema.QualitativeValue | string | schema.StructuredValueOrSubClass;
/**
* A technique or technology used in a [[Dataset]] (or [[DataDownload]], [[DataCatalog]]),
* corresponding to the method used for measuring the corresponding variable(s) (described using [[variableMeasured]]). This is oriented towards scientific and scholarly dataset publication but may have broader applicability; it is not intended as a full representation of measurement, but rather as a high level summary for dataset discovery.
*
* For example, if [[variableMeasured]] is: molecule concentration, [[measurementTechnique]] could be: "mass spectrometry" or "nmr spectroscopy" or "colorimetry" or "immunofluorescence".
*
* If the [[variableMeasured]] is "depression rating", the [[measurementTechnique]] could be "Zung Scale" or "HAM-D" or "Beck Depression Inventory".
*
* If there are several [[variableMeasured]] properties recorded for some given data object, use a [[PropertyValue]] for each [[variableMeasured]] and attach the corresponding [[measurementTechnique]].
*
*/
measurementTechnique?: string;
/**
* The lower value of some characteristic or property.
*/
minValue?: number;
/**
* A commonly used identifier for the characteristic represented by the property, e.g. a manufacturer or a standard code for a property. propertyID can be
* (1) a prefixed string, mainly meant to be used with standards for product properties; (2) a site-specific, non-prefixed string (e.g. the primary key of the property or the vendor-specific id of the property), or (3)
* a URL indicating the type of the property, either pointing to an external vocabulary, or a Web resource that describes the property (e.g. a glossary entry).
* Standards bodies should promote a standard prefix for the identifiers of properties from their standards.
*/
propertyID?: string;
/**
* URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
*/
sameAs?: string;
/**
* A CreativeWork or Event about this Thing.
*/
subjectOf?: schema.Event_OrSubClass | schema.CreativeWorkOrSubClass | string;
/**
* Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
*/
potentialAction?: schema.ActionOrSubClass | string;
/**
* Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details.
*/
mainEntityOfPage?: schema.CreativeWorkOrSubClass | string;
/**
* An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
*/
additionalType?: string;
/**
* An alias for the item.
*/
alternateName?: string;
/**
* URL of the item.
*/
url?: string;
/**
* An image of the item. This can be a [[URL]] or a fully described [[ImageObject]].
*/
image?: schema.ImageObjectOrSubClass | string;
/**
* A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
*/
disambiguatingDescription?: string;
};
/**
* LocationFeatureSpecification
*
* This type is derived from https://schema.org/LocationFeatureSpecification, which means that any of this type's properties within schema.org may also be used.
*
* This differs from LocationFeatureSpecification because it also allows for objects that have the type of a model that
* sub-classes this model. e.g. `Event_OrSubClass` allows `Event`s as well as `ScheduledSession`s, `SessionSeries`,
* etc.
*/
export declare type LocationFeatureSpecificationOrSubClass = LocationFeatureSpecification | oa.BabyChangingOrSubClass | oa.ChangingFacilitiesOrSubClass | oa.CrecheOrSubClass | oa.LockersOrSubClass | oa.ParkingOrSubClass | oa.ShowersOrSubClass | oa.ToiletsOrSubClass | oa.TowelsOrSubClass | oa.CafeOrSubClass | oa.BarOrSubClass;
/**
* LocationFeatureSpecification - Validation schema (w/ JOI)
*
* This type is derived from https://schema.org/LocationFeatureSpecification, which means that any of this type's properties within schema.org may also be used.
*/
export declare const LocationFeatureSpecificationJoiSchema: Joi.ObjectSchema;
/**
* LocationFeatureSpecification - Validation schema (w/ JOI)
*
* This type is derived from https://schema.org/LocationFeatureSpecification, which means that any of this type's properties within schema.org may also be used.
*
* This differs from LocationFeatureSpecificationJoiSchema because it also allows for objects that have the type of a model that
* sub-classes this model. e.g. `Event.OrSubClassJoiSchema` allows `Event`s as well as `ScheduledSession`s,
* `SessionSeries`, etc.
*/
export declare const LocationFeatureSpecificationOrSubClassJoiSchema: Joi.AlternativesSchema;
/**
* Runtime validator for LocationFeatureSpecification.
*
* If some data has a structure which matches a LocationFeatureSpecification, it will be returned with the correct type.
* Otherwise, this function returns an OAValidationError with details about why the data does not match.
*
* Use this to e.g. check a JSON object received in an HTTP request. Example usage (for an express request handler):
*
* ```ts
* const maybeLocationFeatureSpecification = validateLocationFeatureSpecification(req.body); // `req.body` will have type `any` or `unknown`
* if (maybeLocationFeatureSpecification instanceof OaValidationError) {
* // From this point on, `maybeLocationFeatureSpecification` will have type `OaValidationError`
* const error = maybeLocationFeatureSpecification;
* // Do something with the error. Maybe ignore it? Or log it? Or throw? Up to you.
* }
* // From this point on, `maybeLocationFeatureSpecification` will have type `LocationFeatureSpecification`
* const locationFeatureSpecification = maybeLocationFeatureSpecification;
* ```
*/
export declare function validateLocationFeatureSpecification(maybeLocationFeatureSpecification: unknown): LocationFeatureSpecification | OaValidationError;