@trakit/objects 0.0.1

package/Assets/Asset.d.ts

@@ -0,0 +1,192 @@
+import { BaseComponent } from "../API/BaseComponent";
+import { BaseCompound } from "../API/BaseCompound";
+import { Position } from "../API/Geography/Position";
+import { IBelongCompany } from "../API/Interfaces/IBelongCompany";
+import { IIconic } from "../API/Interfaces/IIconic";
+import { IIdUlong } from "../API/Interfaces/IIdUlong";
+import { ILabelled } from "../API/Interfaces/ILabelled";
+import { INamed } from "../API/Interfaces/INamed";
+import { IPictured } from "../API/Interfaces/IPictured";
+import { ISuspendable } from "../API/Interfaces/ISuspendable";
+import { codified, double, ulong } from "../API/Types";
+import { Company } from "../Companies/Company";
+import { Icon } from "../Images/Icon";
+import { Picture } from "../Images/Picture";
+import { Provider } from "../Providers/Provider";
+import { AssetAdvanced } from "./AssetAdvanced";
+import { AssetAttribute } from "./AssetAttribute";
+import { AssetDispatch } from "./AssetDispatch";
+import { AssetGeneral } from "./AssetGeneral";
+import { AssetPlaceStatus } from "./AssetPlaceStatus";
+import { AssetType } from "./AssetType";
+import { Vehicle } from "./Vehicle";
+/**
+ * The full details of an Asset, containing all the properties from the {@link AssetGeneral} and {@link AssetAdvanced} objects.
+ */
+export declare class Asset extends BaseCompound implements IIdUlong, INamed, IIconic, IBelongCompany, ILabelled, IPictured, ISuspendable {
+    #private;
+    /**
+     *
+     * @param json
+     */
+    static fromJSON(json: any): Asset | Vehicle;
+    /**
+     *
+     */
+    get pieces(): BaseComponent[];
+    /**
+     * Unique identifier of this asset.
+     * {@link Asset.id}
+     */
+    get id(): ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    get companyId(): ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    get company(): Company;
+    /**
+     * Type of asset.
+     */
+    get kind(): AssetType;
+    /**
+     *
+     */
+    get general(): AssetGeneral;
+    /**
+     * This thing's name.
+     */
+    get name(): string;
+    set name(value: string);
+    /**
+     * Notes about it.
+     */
+    get notes(): string;
+    set notes(value: string);
+    /**
+     * The icon that represents this asset on the map and in lists.
+     * {@link Icon.id}
+     */
+    get iconId(): ulong;
+    set iconId(value: ulong);
+    /**
+     * The icon that represents this asset on the map and in lists.
+     * {@link Icon.id}
+     */
+    get icon(): Icon;
+    set icon(value: Icon);
+    /**
+     * Codified label names.
+     * {@link LabelStyle.code}
+     */
+    get labels(): codified[];
+    set labels(value: codified[]);
+    /**
+     * A list of photos of this thing.
+     * {@link Picture.id}
+     */
+    get pictureIds(): ulong[];
+    set pictureIds(value: ulong[]);
+    /**
+     * A list of photos of this thing.
+     * {@link Picture.id}
+     */
+    get pictures(): Picture[];
+    set pictures(value: Picture[]);
+    /**
+     * The fall-back address which is used to send Messages if the asset is a Person and has no Contact phone or email.
+     */
+    get messagingAddress(): string;
+    set messagingAddress(value: string);
+    /**
+     * Name/value collections of custom fields used to refer to external systems.
+     */
+    get references(): Map<string, string>;
+    set references(value: Map<string, string>);
+    /**
+     *
+     */
+    get advanced(): AssetAdvanced;
+    /**
+     * The things GPS coordinates including speed, bearing, and street information.
+     */
+    get position(): Position | null;
+    set position(value: Position | null);
+    /**
+     * The cumulative distance travelled in kilometres.
+     */
+    get odometer(): double;
+    set odometer(value: double);
+    /**
+     * The codified status tag names.
+     */
+    get tags(): codified[];
+    set tags(value: codified[]);
+    /**
+     * A list of attributes given to this asset by the connection device such as wiring state, VBus, etc.
+     */
+    get attributes(): Map<codified, AssetAttribute>;
+    set attributes(value: Map<codified, AssetAttribute>);
+    /**
+     * The list of devices providing events for this asset.
+     */
+    get providerIds(): string[];
+    /**
+     * The list of devices providing events for this asset.
+     */
+    get providers(): Provider[];
+    /**
+     * A list of assets related to this one; like a Person for a Vehicle (driver).
+     * {@link Asset.id}
+     */
+    get relationshipIds(): ulong[];
+    set relationshipIds(value: ulong[]);
+    /**
+     * A list of assets related to this one; like a Person for a Vehicle (driver).
+     * {@link Asset.id}
+     */
+    get relationships(): Asset[];
+    set relationships(value: Asset[]);
+    /**
+     * The current state of this asset's interaction with known Places.
+     * {@link Place.id}
+     */
+    get places(): Map<ulong, AssetPlaceStatus>;
+    set places(value: Map<ulong, AssetPlaceStatus>);
+    /**
+     *
+     */
+    get dispatch(): AssetDispatch;
+    toJSON(): {
+        pictures?: number[] | undefined;
+        messagingAddress?: string | undefined;
+        references?: object | undefined;
+        suspended?: boolean | undefined;
+        since?: string | null | undefined;
+        id: number | null;
+        company: number;
+        kind: AssetType;
+        name: string;
+        notes: string;
+        icon: number;
+        labels: string[];
+        v: number[];
+    };
+    fromJSON(json: any, force?: boolean): boolean;
+    /**
+     * The {@link id} is the key.
+     */
+    getKey(): string;
+    /**
+     * Indicates whether this object is suspended from event processing.
+     */
+    get suspended(): boolean;
+    /**
+     * Timestamp from the action that deleted or suspended this object.
+     */
+    get since(): Date;
+}

package/Assets/AssetAdvanced.d.ts

@@ -0,0 +1,90 @@
+import { BaseComponent } from "../API/BaseComponent";
+import { Position } from "../API/Geography/Position";
+import { IBelongCompany } from "../API/Interfaces/IBelongCompany";
+import { IIdUlong } from "../API/Interfaces/IIdUlong";
+import { codified, double, ulong } from "../API/Types";
+import { Company } from "../Companies/Company";
+import { Provider } from "../Providers/Provider";
+import { Asset } from "./Asset";
+import { AssetAttribute } from "./AssetAttribute";
+import { AssetPlaceStatus } from "./AssetPlaceStatus";
+/**
+ * Often changing details about a thing.
+ */
+export declare class AssetAdvanced extends BaseComponent implements IIdUlong, IBelongCompany {
+    /**
+     *
+     * @param json
+     */
+    static fromJSON(json: any): AssetAdvanced;
+    /**
+     * Unique identifier of this asset.
+     * {@link Asset.id}
+     */
+    id: ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    companyId: ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    get company(): Company;
+    /**
+     * The things GPS coordinates including speed, bearing, and street information.
+     */
+    position: Position | null;
+    /**
+     * The cumulative distance travelled in kilometres.
+     */
+    odometer: double;
+    /**
+     * The codified status tag names.
+     */
+    tags: codified[];
+    /**
+     * A list of attributes given to this asset by the connection device such as wiring state, VBus, etc.
+     */
+    attributes: Map<codified, AssetAttribute>;
+    /**
+     * The list of {@link Provider.id|device identifiers} providing events for this asset.
+     */
+    providerIds: string[];
+    /**
+     * The list of {@link Provider|devices} providing events for this asset.
+     */
+    get providers(): Provider[];
+    set providers(value: Provider[]);
+    /**
+     * A list of {@link Asset.id}s related to this one; like a {@link Person} for a {@link Vehicle} (driver).
+     */
+    relationshipIds: ulong[];
+    /**
+     * A list of {@link Asset}s related to this one; like a {@link Person} for a {@link Vehicle} (driver).
+     */
+    get relationships(): Asset[];
+    set relationships(value: Asset[]);
+    /**
+     * The current state of this asset's interaction with known {@link Place}s.
+     */
+    places: Map<ulong, AssetPlaceStatus>;
+    toJSON(): {
+        id: number | null;
+        v: number[];
+        company: number;
+        position: import("../API/Geography/Interfaces").IPosition | null;
+        odometer: number;
+        tags: string[];
+        attributes: object;
+        providers: string[];
+        relationships: number[];
+        places: object;
+    };
+    fromJSON(json: any, force?: boolean): boolean;
+    /**
+     * The {@link id} is the key.
+     */
+    getKey(): string;
+}

package/Assets/AssetAttribute.d.ts

@@ -0,0 +1,71 @@
+import { IBelongAsset } from "../API/Interfaces/IBelongAsset";
+import { ISerializable } from "../API/Interfaces/ISerializable";
+import { datetime, ulong } from "../API/Types";
+import { Provider } from "../Providers/Provider";
+import { Asset } from "./Asset";
+/**
+ * An attribute given to an asset by a behaviour script.
+ */
+export declare class AssetAttribute implements ISerializable, IBelongAsset {
+    /**
+     *
+     * @param json
+     */
+    static fromJSON(json: any): AssetAttribute;
+    /**
+     * Display name of the attribute.
+     */
+    name: string;
+    /**
+     * Computed/contextual value from the behaviour.  Like "3.76 volts" or "on".
+     */
+    simple: string;
+    /**
+     * Parse-able/formatted string for complex display.  May contain HTML.
+     */
+    complex: string;
+    /**
+     * Raw value like 3.76 (volts) or true (on).
+     */
+    raw: any;
+    /**
+     * Text representation of unit like "°C" or "Km".
+     * {@link Units}
+     */
+    unit: string;
+    /**
+     * The {@link Provider.id|device id} which provided this attribute.
+     */
+    providerId: string;
+    /**
+     * The {@link Provider|device} which provided this attribute.
+     */
+    get provider(): Provider;
+    /**
+     * The related {@link Asset.id} which provided this attribute.
+     */
+    assetId: ulong;
+    /**
+     * The related {@link Asset} which provided this attribute.
+     */
+    get asset(): Asset;
+    /**
+     * Date/time stamp from when this attribute was recorded (or reported) by the device.
+     */
+    dts: Date;
+    /**
+     * When false, indicates that this attribute is used by an internal system and should be left untouched.
+     */
+    global: boolean;
+    constructor(name?: string, simple?: string, complex?: string, raw?: any, unit?: string, provider?: string, asset?: ulong, dts?: Date | number | datetime, global?: boolean);
+    toJSON(): {
+        name: string;
+        simple: string;
+        complex: string;
+        raw: any;
+        provider: string;
+        asset: number | null;
+        dts: string | null;
+        global: boolean;
+    };
+}

package/Assets/AssetDispatch.d.ts

@@ -0,0 +1,63 @@
+import { BaseComponent } from "../API/BaseComponent";
+import { IBelongCompany } from "../API/Interfaces/IBelongCompany";
+import { IIdUlong } from "../API/Interfaces/IIdUlong";
+import { ulong } from "../API/Types";
+import { Company } from "../Companies/Company";
+import { DispatchDirection } from "../Dispatch/DispatchDirection";
+import { DispatchJob } from "../Dispatch/DispatchJob";
+/**
+ * The current state of an asset's {@link DispatchJob} route progress.
+ */
+export declare class AssetDispatch extends BaseComponent implements IIdUlong, IBelongCompany {
+    /**
+     *
+     * @param json
+     */
+    static fromJSON(json: any): AssetDispatch;
+    /**
+     * Unique identifier of this asset.
+     * {@link Asset.id}
+     */
+    id: ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    companyId: ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    get company(): Company;
+    /**
+     * The current list of {@link DispatchJob}s assigned to the asset.
+     * {@link DispatchJob}
+     */
+    jobIds: ulong[];
+    /**
+     * A list of {@link Asset}s related to this one; like a {@link Person} for a {@link Vehicle} (driver).
+     */
+    get jobs(): DispatchJob[];
+    set jobs(value: DispatchJob[]);
+    /**
+     * Driving directions and route path details.
+     */
+    directions: DispatchDirection[];
+    /**
+     * Timestamp from the last update to this {@link AssetDispatch} by a {@link User}, {@link Machine}, {@link Asset}, or an assigned {@link DispatchJob}.
+     */
+    lastDispatched: Date;
+    toJSON(): {
+        id: number | null;
+        v: number[];
+        companyId: number | null;
+        jobs: number[];
+        directions: DispatchDirection[];
+        lastDispatched: string;
+    };
+    fromJSON(json: any, force?: boolean): boolean;
+    /**
+     * The {@link id} is the key.
+     */
+    getKey(): string;
+}

package/Assets/AssetGeneral.d.ts

@@ -0,0 +1,109 @@
+import { BaseComponent } from "../API/BaseComponent";
+import { IBelongCompany } from "../API/Interfaces/IBelongCompany";
+import { IIconic } from "../API/Interfaces/IIconic";
+import { IIdUlong } from "../API/Interfaces/IIdUlong";
+import { ILabelled } from "../API/Interfaces/ILabelled";
+import { INamed } from "../API/Interfaces/INamed";
+import { IPictured } from "../API/Interfaces/IPictured";
+import { ISuspendable } from "../API/Interfaces/ISuspendable";
+import { codified, ulong } from "../API/Types";
+import { Company } from "../Companies/Company";
+import { Icon } from "../Images/Icon";
+import { Picture } from "../Images/Picture";
+import { AssetType } from "./AssetType";
+import { VehicleGeneral } from "./VehicleGeneral";
+/**
+ * Seldom changing details about a thing.
+ */
+export declare class AssetGeneral extends BaseComponent implements IIdUlong, INamed, IIconic, IBelongCompany, ILabelled, IPictured, ISuspendable {
+    /**
+     *
+     * @param json
+     */
+    static fromJSON(json: any): AssetGeneral | VehicleGeneral;
+    /**
+     * Unique identifier of this asset.
+     * {@link Asset.id}
+     */
+    id: ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    companyId: ulong;
+    /**
+     * The company to which this asset belongs.
+     * {@link Company.id}
+     */
+    get company(): Company;
+    /**
+     * Type of asset.
+     */
+    kind: AssetType;
+    /**
+     * This thing's name.
+     */
+    name: string;
+    /**
+     * The {@link Icon.id} that represents this asset on the map and in lists.
+     */
+    iconId: ulong;
+    /**
+     * The {@link Icon} that represents this asset on the map and in lists.
+     */
+    get icon(): Icon;
+    set icon(value: Icon);
+    /**
+     * Notes about it.
+     */
+    notes: string;
+    /**
+     * Codified label names.
+     */
+    labels: codified[];
+    /**
+     * {@link Picture.id}s of this asset.
+     */
+    pictureIds: ulong[];
+    /**
+     * {@link Picture}s of this asset.
+     */
+    get pictures(): Picture[];
+    set pictures(values: Picture[]);
+    /**
+     * The fall-back address which is used to send Messages if the asset is a Person and has no Contact phone or email.
+     */
+    messagingAddress: string;
+    /**
+     * Name/value collections of custom fields used to refer to external systems.
+     */
+    references: Map<string, string>;
+    toJSON(): {
+        pictures?: number[] | undefined;
+        messagingAddress?: string | undefined;
+        references?: object | undefined;
+        suspended?: boolean | undefined;
+        since?: string | null | undefined;
+        id: number | null;
+        company: number;
+        kind: AssetType;
+        name: string;
+        icon: number;
+        notes: string;
+        labels: string[];
+        v: number[];
+    };
+    fromJSON(json: any, force?: boolean): boolean;
+    /**
+     * The {@link id} is the key.
+     */
+    getKey(): string;
+    /**
+     * Indicates whether this object is suspended from event processing.
+     */
+    suspended: boolean;
+    /**
+     * Timestamp from the action that deleted or suspended this object.
+     */
+    since: Date;
+}

package/Assets/AssetPlaceStatus.d.ts

@@ -0,0 +1,31 @@
+import { ISerializable } from "../API/Interfaces/ISerializable";
+import { datetime } from "../API/Types";
+import { AssetPlaceStatusType } from "./AssetPlaceStatusType";
+/**
+ * A simple status for each place an Asset visits.
+ */
+export declare class AssetPlaceStatus implements ISerializable {
+    /**
+     *
+     * @param json
+     */
+    static fromJSON(json: any): AssetPlaceStatus;
+    /**
+     * The kind of interaction.
+     */
+    kind: AssetPlaceStatusType;
+    /**
+     * The date/time stamp for when the Asset first began interacting with the Place.
+     */
+    enter: Date;
+    /**
+     * The most recent date/time stamp for the interaction.
+     */
+    latest: Date;
+    constructor(kind?: AssetPlaceStatusType, enter?: Date | number | datetime, latest?: Date | number | datetime);
+    toJSON(): {
+        kind: AssetPlaceStatusType;
+        enter: string | null;
+        latest: string | null;
+    };
+}

package/Assets/AssetPlaceStatusType.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The kinds of interactions had with a Place.
+ */
+export declare enum AssetPlaceStatusType {
+    /**
+     * Occurs when an asset is outside a Place, then goes inside the boundary.
+     */
+    enter = "enter",
+    /**
+     * Occurs when the asset was inside the boundary before, and is still inside the boundary now.
+     */
+    inside = "inside",
+    /**
+     * Occurs when an asset was inside the boundary of a Place, but then moves outside the boundary.
+     */
+    exit = "exit"
+}

package/Assets/AssetType.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The four supported types of trackable things.
+ */
+export declare enum AssetType {
+    /**
+     * Generic thing.
+     */
+    asset = "asset",
+    /**
+     * Human (or alien) Person.
+     */
+    person = "person",
+    /**
+     * A towed vehicle without an engine.
+     */
+    trailer = "trailer",
+    /**
+     * A vehicle that moves with its own power.
+     */
+    vehicle = "vehicle"
+}

package/Assets/Person.d.ts

@@ -0,0 +1,25 @@
+import { Contact } from '../Accounts/Contact';
+import { ulong } from '../API/Types';
+import { Asset } from './Asset';
+import { PersonGeneral } from './PersonGeneral';
+/**
+ * The full details of a Person, containing all the properties from the {@link PersonGeneral} and {@link AssetAdvanced} objects.
+ */
+export declare class Person extends Asset {
+    /**
+     * General details about this person.
+     */
+    get general(): PersonGeneral;
+    /**
+     * Contact information for this user.
+     * {@link Contact.id}
+     */
+    get contactId(): ulong;
+    set contactId(value: ulong);
+    /**
+     * Contact information for this user.
+     * {@link Contact.id}
+     */
+    get contact(): Contact;
+    set contact(value: Contact);
+}

package/Assets/PersonGeneral.d.ts

@@ -0,0 +1,35 @@
+import { Contact } from "../Accounts/Contact";
+import { ulong } from "../API/Types";
+import { AssetGeneral } from "./AssetGeneral";
+/**
+ * Seldom changing details about a person.
+ */
+export declare class PersonGeneral extends AssetGeneral {
+    /**
+     * A reference to their Company's Contact information.
+     * {@link Contact.id}
+     */
+    contactId: ulong;
+    /**
+     * Contact information for this person.
+     * {@link Contact.id}
+     */
+    get contact(): Contact;
+    set contact(value: Contact);
+    toJSON(): {
+        suspended?: boolean | undefined;
+        since?: string | null | undefined;
+        references?: object | undefined;
+        messagingAddress?: string | undefined;
+        pictures?: number[] | undefined;
+        id: number | null;
+        v: number[];
+        company: number;
+        kind: import("./AssetType").AssetType;
+        name: string;
+        notes: string;
+        icon: number;
+        labels: string[];
+    };
+    fromJSON(json: any, force?: boolean): boolean;
+}