@mlhub/models-ts-sdk 0.0.8 → 0.1.0

package/dist/models/index.js

@@ -1,49 +1,60 @@
 "use strict";
-function __export(m) {
-    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
-}
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 /* tslint:disable */
 /* eslint-disable */
-__export(require("./Accelerator"));
-__export(require("./Artifact"));
-__export(require("./ArtifactIngestion"));
-__export(require("./ArtifactIngestionStatus"));
-__export(require("./ArtifactPublication"));
-__export(require("./ArtifactPublicationStatus"));
-__export(require("./ArtifactType"));
-__export(require("./AssociateModelMetadata"));
-__export(require("./AssociateModelMetadataResponse"));
-__export(require("./BadRequestResponse"));
-__export(require("./CreateModelMetadataResponse"));
-__export(require("./DiscoverModelsByPlatformResponse"));
-__export(require("./DiscoverModelsResponse"));
-__export(require("./DiscoveryCriteria"));
-__export(require("./DiscoveryCriterion"));
-__export(require("./GetModelArtifactResponse"));
-__export(require("./GetModelByPlatformResponse"));
-__export(require("./GetModelIngestionResponse"));
-__export(require("./GetModelPublicationResponse"));
-__export(require("./GetModelResponse"));
-__export(require("./HardwareRequirements"));
-__export(require("./IngestArtifactRequest"));
-__export(require("./IngestModelArtifactResponse"));
-__export(require("./ListModelArtifactResponse"));
-__export(require("./ListModelIngestionsResponse"));
-__export(require("./ListModelPublicationsForArtifactResponse"));
-__export(require("./ListModelPublicationsResponse"));
-__export(require("./ListModelsByPlatformResponse"));
-__export(require("./ListModelsResponse"));
-__export(require("./ListPlatformsResponse"));
-__export(require("./ListTasksResponse"));
-__export(require("./ModelArtifact"));
-__export(require("./ModelIO"));
-__export(require("./ModelMetadata"));
-__export(require("./NotFoundResponse"));
-__export(require("./Platform"));
-__export(require("./PlatformDetails"));
-__export(require("./PublishArtifactRequest"));
-__export(require("./PublishModelArtifactResponse"));
-__export(require("./ServerErrorResponse"));
-__export(require("./SystemRequirement"));
-__export(require("./Task"));
+__exportStar(require("./Accelerator"), exports);
+__exportStar(require("./Artifact"), exports);
+__exportStar(require("./ArtifactIngestion"), exports);
+__exportStar(require("./ArtifactIngestionStatus"), exports);
+__exportStar(require("./ArtifactPublication"), exports);
+__exportStar(require("./ArtifactPublicationStatus"), exports);
+__exportStar(require("./ArtifactType"), exports);
+__exportStar(require("./AssociateModelMetadata"), exports);
+__exportStar(require("./AssociateModelMetadataResponse"), exports);
+__exportStar(require("./BadRequestResponse"), exports);
+__exportStar(require("./CreateModelMetadataResponse"), exports);
+__exportStar(require("./DiscoverModelsByPlatformResponse"), exports);
+__exportStar(require("./DiscoverModelsResponse"), exports);
+__exportStar(require("./DiscoveryCriteria"), exports);
+__exportStar(require("./DiscoveryCriterion"), exports);
+__exportStar(require("./GetModelArtifactResponse"), exports);
+__exportStar(require("./GetModelByPlatformResponse"), exports);
+__exportStar(require("./GetModelIngestionResponse"), exports);
+__exportStar(require("./GetModelPublicationResponse"), exports);
+__exportStar(require("./GetModelResponse"), exports);
+__exportStar(require("./HardwareRequirements"), exports);
+__exportStar(require("./IngestArtifactRequest"), exports);
+__exportStar(require("./IngestModelArtifactResponse"), exports);
+__exportStar(require("./ListModelArtifactResponse"), exports);
+__exportStar(require("./ListModelIngestionsResponse"), exports);
+__exportStar(require("./ListModelPublicationsForArtifactResponse"), exports);
+__exportStar(require("./ListModelPublicationsResponse"), exports);
+__exportStar(require("./ListModelsByPlatformResponse"), exports);
+__exportStar(require("./ListModelsResponse"), exports);
+__exportStar(require("./ListPlatformsResponse"), exports);
+__exportStar(require("./ListTasksResponse"), exports);
+__exportStar(require("./ModelArtifact"), exports);
+__exportStar(require("./ModelIO"), exports);
+__exportStar(require("./ModelMetadata"), exports);
+__exportStar(require("./NotFoundResponse"), exports);
+__exportStar(require("./Platform"), exports);
+__exportStar(require("./PlatformDetails"), exports);
+__exportStar(require("./PublishArtifactRequest"), exports);
+__exportStar(require("./PublishModelArtifactResponse"), exports);
+__exportStar(require("./ServerErrorResponse"), exports);
+__exportStar(require("./SystemRequirement"), exports);
+__exportStar(require("./Task"), exports);

package/dist/runtime.d.ts

@@ -40,7 +40,7 @@ export declare const COLLECTION_FORMATS: {
     tsv: string;
     pipes: string;
 };
-export declare type FetchAPI = GlobalFetch['fetch'];
+export type FetchAPI = WindowOrWorkerGlobalScope['fetch'];
 export interface ConfigurationParameters {
     basePath?: string;
     fetchApi?: FetchAPI;
@@ -56,27 +56,27 @@ export interface ConfigurationParameters {
 export declare class Configuration {
     private configuration;
     constructor(configuration?: ConfigurationParameters);
-    readonly basePath: string;
-    readonly fetchApi: FetchAPI | undefined;
-    readonly middleware: Middleware[];
-    readonly queryParamsStringify: (params: HTTPQuery) => string;
-    readonly username: string | undefined;
-    readonly password: string | undefined;
-    readonly apiKey: ((name: string) => string) | undefined;
-    readonly accessToken: ((name?: string, scopes?: string[]) => string | Promise<string>) | undefined;
-    readonly headers: HTTPHeaders | undefined;
-    readonly credentials: RequestCredentials | undefined;
-}
-export declare type Json = any;
-export declare type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-export declare type HTTPHeaders = {
+    get basePath(): string;
+    get fetchApi(): FetchAPI | undefined;
+    get middleware(): Middleware[];
+    get queryParamsStringify(): (params: HTTPQuery) => string;
+    get username(): string | undefined;
+    get password(): string | undefined;
+    get apiKey(): ((name: string) => string) | undefined;
+    get accessToken(): ((name?: string, scopes?: string[]) => string | Promise<string>) | undefined;
+    get headers(): HTTPHeaders | undefined;
+    get credentials(): RequestCredentials | undefined;
+}
+export type Json = any;
+export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+export type HTTPHeaders = {
     [key: string]: string;
 };
-export declare type HTTPQuery = {
+export type HTTPQuery = {
     [key: string]: string | number | null | boolean | Array<string | number | null | boolean> | HTTPQuery;
 };
-export declare type HTTPBody = Json | FormData | URLSearchParams;
-export declare type ModelPropertyNaming = 'camelCase' | 'snake_case' | 'PascalCase' | 'original';
+export type HTTPBody = Json | FormData | URLSearchParams;
+export type ModelPropertyNaming = 'camelCase' | 'snake_case' | 'PascalCase' | 'original';
 export interface FetchParams {
     url: string;
     init: RequestInit;

package/dist/runtime.js

@@ -13,38 +13,47 @@
  * Do not edit the class manually.
  */
 var __extends = (this && this.__extends) || (function () {
-    var extendStatics = Object.setPrototypeOf ||
-        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-        function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-var __assign = (this && this.__assign) || Object.assign || function(t) {
-    for (var s, i = 1, n = arguments.length; i < n; i++) {
-        s = arguments[i];
-        for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-            t[p] = s[p];
-    }
-    return t;
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
 };
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
         function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
 var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
     function step(op) {
         if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
             if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
             if (y = 0, t) op = [op[0] & 2, t.value];
             switch (op[0]) {
@@ -66,6 +75,11 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextApiResponse = exports.BlobApiResponse = exports.VoidApiResponse = exports.JSONApiResponse = exports.Configuration = exports.COLLECTION_FORMATS = exports.RequiredError = exports.BaseAPI = exports.BASE_PATH = void 0;
+exports.exists = exists;
+exports.querystring = querystring;
+exports.mapValues = mapValues;
+exports.canConsumeForm = canConsumeForm;
 exports.BASE_PATH = "http://localhost".replace(/\/+$/, "");
 var isBlob = function (value) { return typeof Blob !== 'undefined' && value instanceof Blob; };
 /**
@@ -123,11 +137,11 @@ var BaseAPI = /** @class */ (function () {
         this.middleware = configuration.middleware;
     }
     BaseAPI.prototype.withMiddleware = function () {
+        var _a;
         var middlewares = [];
         for (var _i = 0; _i < arguments.length; _i++) {
             middlewares[_i] = arguments[_i];
         }
-        var _a;
         var next = this.clone();
         next.middleware = (_a = next.middleware).concat.apply(_a, middlewares);
         return next;
@@ -221,42 +235,42 @@ var Configuration = /** @class */ (function () {
         get: function () {
             return this.configuration.basePath != null ? this.configuration.basePath : exports.BASE_PATH;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "fetchApi", {
         get: function () {
             return this.configuration.fetchApi;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "middleware", {
         get: function () {
             return this.configuration.middleware || [];
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "queryParamsStringify", {
         get: function () {
             return this.configuration.queryParamsStringify || querystring;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "username", {
         get: function () {
             return this.configuration.username;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "password", {
         get: function () {
             return this.configuration.password;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "apiKey", {
@@ -267,7 +281,7 @@ var Configuration = /** @class */ (function () {
             }
             return undefined;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "accessToken", {
@@ -281,21 +295,21 @@ var Configuration = /** @class */ (function () {
             }
             return undefined;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "headers", {
         get: function () {
             return this.configuration.headers;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(Configuration.prototype, "credentials", {
         get: function () {
             return this.configuration.credentials;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     return Configuration;
@@ -305,37 +319,34 @@ function exists(json, key) {
     var value = json[key];
     return value !== null && value !== undefined;
 }
-exports.exists = exists;
 function querystring(params, prefix) {
     if (prefix === void 0) { prefix = ''; }
     return Object.keys(params)
         .map(function (key) {
-        var fullKey = prefix + (prefix.length ? "[" + key + "]" : key);
+        var fullKey = prefix + (prefix.length ? "[".concat(key, "]") : key);
         var value = params[key];
         if (value instanceof Array) {
             var multiValue = value.map(function (singleValue) { return encodeURIComponent(String(singleValue)); })
-                .join("&" + encodeURIComponent(fullKey) + "=");
-            return encodeURIComponent(fullKey) + "=" + multiValue;
+                .join("&".concat(encodeURIComponent(fullKey), "="));
+            return "".concat(encodeURIComponent(fullKey), "=").concat(multiValue);
         }
         if (value instanceof Date) {
-            return encodeURIComponent(fullKey) + "=" + encodeURIComponent(value.toISOString());
+            return "".concat(encodeURIComponent(fullKey), "=").concat(encodeURIComponent(value.toISOString()));
         }
         if (value instanceof Object) {
             return querystring(value, fullKey);
         }
-        return encodeURIComponent(fullKey) + "=" + encodeURIComponent(String(value));
+        return "".concat(encodeURIComponent(fullKey), "=").concat(encodeURIComponent(String(value)));
     })
         .filter(function (part) { return part.length > 0; })
         .join('&');
 }
-exports.querystring = querystring;
 function mapValues(data, fn) {
     return Object.keys(data).reduce(function (acc, key) {
         var _a;
-        return (__assign({}, acc, (_a = {}, _a[key] = fn(data[key]), _a)));
+        return (__assign(__assign({}, acc), (_a = {}, _a[key] = fn(data[key]), _a)));
     }, {});
 }
-exports.mapValues = mapValues;
 function canConsumeForm(consumes) {
     for (var _i = 0, consumes_1 = consumes; _i < consumes_1.length; _i++) {
         var consume = consumes_1[_i];
@@ -345,7 +356,6 @@ function canConsumeForm(consumes) {
     }
     return false;
 }
-exports.canConsumeForm = canConsumeForm;
 var JSONApiResponse = /** @class */ (function () {
     function JSONApiResponse(raw, transformer) {
         if (transformer === void 0) { transformer = function (jsonValue) { return jsonValue; }; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlhub/models-ts-sdk",
-  "version": "0.0.8",
+  "version": "0.1.0",
   "description": "OpenAPI client for @mlhub/models-ts-sdk",
   "author": "OpenAPI-Generator",
   "main": "./dist/index.js",
@@ -10,6 +10,6 @@
     "prepare": "npm run build"
   },
   "devDependencies": {
-    "typescript": "^2.4"
+    "typescript": "^5.9.3"
   }
-}
+}

package/src/apis/ModelsApi.ts

@@ -30,6 +30,12 @@ import {
     GetModelResponse,
     GetModelResponseFromJSON,
     GetModelResponseToJSON,
+    IngestArtifactRequest,
+    IngestArtifactRequestFromJSON,
+    IngestArtifactRequestToJSON,
+    IngestModelArtifactResponse,
+    IngestModelArtifactResponseFromJSON,
+    IngestModelArtifactResponseToJSON,
     ListModelsResponse,
     ListModelsResponseFromJSON,
     ListModelsResponseToJSON,
@@ -60,6 +66,12 @@ export interface GetModelRequest {
     name: string;
 }
 
+export interface IngestCanonicalModelRequest {
+    author: string;
+    name: string;
+    ingestArtifactRequest: IngestArtifactRequest;
+}
+
 export interface ListModelsRequest {
     modelMetadata: ModelMetadata;
 }
@@ -185,6 +197,47 @@ export class ModelsApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Ingest canonical model artifact
+     */
+    async ingestCanonicalModelRaw(requestParameters: IngestCanonicalModelRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<IngestModelArtifactResponse>> {
+        if (requestParameters.author === null || requestParameters.author === undefined) {
+            throw new runtime.RequiredError('author','Required parameter requestParameters.author was null or undefined when calling ingestCanonicalModel.');
+        }
+
+        if (requestParameters.name === null || requestParameters.name === undefined) {
+            throw new runtime.RequiredError('name','Required parameter requestParameters.name was null or undefined when calling ingestCanonicalModel.');
+        }
+
+        if (requestParameters.ingestArtifactRequest === null || requestParameters.ingestArtifactRequest === undefined) {
+            throw new runtime.RequiredError('ingestArtifactRequest','Required parameter requestParameters.ingestArtifactRequest was null or undefined when calling ingestCanonicalModel.');
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        const response = await this.request({
+            path: `/models-api/models/{author}/{name}`.replace(`{${"author"}}`, encodeURIComponent(String(requestParameters.author))).replace(`{${"name"}}`, encodeURIComponent(String(requestParameters.name))),
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: IngestArtifactRequestToJSON(requestParameters.ingestArtifactRequest),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => IngestModelArtifactResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Ingest canonical model artifact
+     */
+    async ingestCanonicalModel(requestParameters: IngestCanonicalModelRequest, initOverrides?: RequestInit): Promise<IngestModelArtifactResponse> {
+        const response = await this.ingestCanonicalModelRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * List all models
      */

package/src/apis/PlatformsApi.ts

@@ -131,7 +131,7 @@ export class PlatformsApi extends runtime.BaseAPI {
         const headerParameters: runtime.HTTPHeaders = {};
 
         const response = await this.request({
-            path: `/models-api/platforms/{platform}/models/{model_id}`.replace(`{${"platform"}}`, encodeURIComponent(String(requestParameters.platform))).replace(`{${"model_id"}}`, String(requestParameters.modelId)),
+            path: `/models-api/platforms/{platform}/models/{model_id}`.replace(`{${"platform"}}`, encodeURIComponent(String(requestParameters.platform))).replace(`{${"model_id"}}`, encodeURIComponent(String(requestParameters.modelId))),
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,

package/src/models/DiscoveryCriterion.ts

@@ -81,7 +81,7 @@ export interface DiscoveryCriterion {
      * @type {HardwareRequirements}
      * @memberof DiscoveryCriterion
      */
-    inference_hardware?: HardwareRequirements | null;
+    inference_hardware?: HardwareRequirements;
     /**
      * 
      * @type {number}
@@ -232,7 +232,7 @@ export interface DiscoveryCriterion {
      * @type {HardwareRequirements}
      * @memberof DiscoveryCriterion
      */
-    training_hardware?: HardwareRequirements | null;
+    training_hardware?: HardwareRequirements;
     /**
      * Training performance fields
      * @type {number}

package/src/models/ModelArtifact.ts

@@ -59,7 +59,7 @@ export interface ModelArtifact {
      * @type {ModelMetadata}
      * @memberof ModelArtifact
      */
-    metadata?: ModelMetadata | null;
+    metadata?: ModelMetadata;
 }
 
 export function ModelArtifactFromJSON(json: any): ModelArtifact {

package/src/models/ModelMetadata.ts

@@ -81,7 +81,7 @@ export interface ModelMetadata {
      * @type {HardwareRequirements}
      * @memberof ModelMetadata
      */
-    inference_hardware?: HardwareRequirements | null;
+    inference_hardware?: HardwareRequirements;
     /**
      * 
      * @type {number}
@@ -232,7 +232,7 @@ export interface ModelMetadata {
      * @type {HardwareRequirements}
      * @memberof ModelMetadata
      */
-    training_hardware?: HardwareRequirements | null;
+    training_hardware?: HardwareRequirements;
     /**
      * Training performance fields
      * @type {number}

package/src/models/Platform.ts

@@ -21,11 +21,12 @@
  * @enum {string}
  */
 export enum Platform {
-    Huggingface = 'huggingface',
+    HuggingFace = 'hugging-face',
     Github = 'github',
     Git = 'git',
     Patra = 'patra',
-    TaccTapis = 'tacc-tapis',
+    TapisPods = 'tapis-pods',
+    TapisJobs = 'tapis-jobs',
     S3 = 's3'
 }
 

package/src/runtime.ts

@@ -126,7 +126,7 @@ export const COLLECTION_FORMATS = {
     pipes: "|",
 };
 
-export type FetchAPI = GlobalFetch['fetch'];
+export type FetchAPI = WindowOrWorkerGlobalScope['fetch'];
 
 export interface ConfigurationParameters {
     basePath?: string; // override base path