gbfs-typescript-types/v2.3/gbfs_versions.d.ts

Language Bindings for GBFS in Typescript.

// Copyright 2024 MobilityData
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/**
 * Lists all feed endpoints published according to version sof the GBFS documentation.
 * (added in v1.1)
 */
export interface GbfsVersions {
    /**
     * Response data in the form of name:value pairs.
     */
    data: Data;
    /**
     * Last time the data in the feed was updated in POSIX time.
     */
    last_updated: number;
    /**
     * Number of seconds before the data in the feed will be updated again (0 if the data should
     * always be refreshed).
     */
    ttl: number;
    /**
     * GBFS version number to which the feed conforms, according to the versioning framework.
     */
    version: GbfsVersionsVersion;
    [property: string]: any;
}

/**
 * Response data in the form of name:value pairs.
 */
export interface Data {
    /**
     * Contains one object, as defined below, for each of the available versions of a feed. The
     * array must be sorted by increasing MAJOR and MINOR version number.
     */
    versions: VersionElement[];
}

export interface VersionElement {
    /**
     * URL of the corresponding gbfs.json endpoint
     */
    url: string;
    /**
     * The semantic version of the feed in the form X.Y
     */
    version: VersionVersion;
    [property: string]: any;
}

/**
 * The semantic version of the feed in the form X.Y
 */
export type VersionVersion = "1.0" | "1.1" | "2.0" | "2.1" | "2.2" | "2.3" | "3.0";

export type GbfsVersionsVersion = "2.3";