@hubspot/local-dev-lib 0.0.1-experimental.0

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright 2019  HubSpot, Inc.
+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.

package/README.md

@@ -0,0 +1,17 @@
+# hubspot/local-dev-lib
+
+Provides library functionality for HubSpot local development tooling, including the [HubSpot CLI](https://github.com/HubSpot/hubspot-cli).
+
+**NOTE:** This library is intended to replace the deprecated [@hubspot/cli-lib](https://github.com/HubSpot/cli-lib) library.
+
+## Overview
+
+This library contains utils that facilitate interactions with HubSpot. It is consumed by the [HubSpot CLI](https://github.com/HubSpot/hubspot-cli) as well as other HubSpot development tooling. Major exports include:
+
+- Config utils for managing HubSpot account configuration and access keys ([docs](./config/README.md))
+- API utils to interact with HubSpot assets such as Design Manager and Developer Projects ([docs](./api/README.md))
+- Utils to navigate the local filesystem, parse common HubSpot files, interact with common HubSpot objects, and connect with GitHub ([docs](./lib/README.md))
+
+## Contributing
+
+For more information on developing, see the [Contributing Guide](CONTRIBUTING.md).

package/api/appsDev.d.ts

@@ -0,0 +1,6 @@
+import { AxiosPromise } from 'axios';
+import { PublicApp, PublicAppInstallCounts, PublicAppDeveloperTestAccountInstallData, FetchPublicAppsForPortalResponse } from '../types/Apps';
+export declare function fetchPublicAppsForPortal(accountId: number): AxiosPromise<FetchPublicAppsForPortalResponse>;
+export declare function fetchPublicAppDeveloperTestAccountInstallData(appId: number, accountId: number): AxiosPromise<PublicAppDeveloperTestAccountInstallData>;
+export declare function fetchPublicAppProductionInstallCounts(appId: number, accountId: number): AxiosPromise<PublicAppInstallCounts>;
+export declare function fetchPublicAppMetadata(appId: number, accountId: number): AxiosPromise<PublicApp>;

package/api/appsDev.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchPublicAppMetadata = exports.fetchPublicAppProductionInstallCounts = exports.fetchPublicAppDeveloperTestAccountInstallData = exports.fetchPublicAppsForPortal = void 0;
+const http_1 = require("../http");
+const APPS_DEV_API_PATH = 'apps-dev/external/public/v3';
+function fetchPublicAppsForPortal(accountId) {
+    return http_1.http.get(accountId, {
+        url: `${APPS_DEV_API_PATH}/full/portal`,
+    });
+}
+exports.fetchPublicAppsForPortal = fetchPublicAppsForPortal;
+function fetchPublicAppDeveloperTestAccountInstallData(appId, accountId) {
+    return http_1.http.get(accountId, {
+        url: `${APPS_DEV_API_PATH}/${appId}/test-portal-installs`,
+    });
+}
+exports.fetchPublicAppDeveloperTestAccountInstallData = fetchPublicAppDeveloperTestAccountInstallData;
+function fetchPublicAppProductionInstallCounts(appId, accountId) {
+    return http_1.http.get(accountId, {
+        url: `${APPS_DEV_API_PATH}/${appId}/install-counts-without-test-portals`,
+    });
+}
+exports.fetchPublicAppProductionInstallCounts = fetchPublicAppProductionInstallCounts;
+function fetchPublicAppMetadata(appId, accountId) {
+    return http_1.http.get(accountId, {
+        url: `${APPS_DEV_API_PATH}/${appId}/full`,
+    });
+}
+exports.fetchPublicAppMetadata = fetchPublicAppMetadata;

package/api/customObjects.d.ts

@@ -0,0 +1,8 @@
+import { AxiosPromise } from 'axios';
+import { FetchSchemasResponse, Schema, CreateObjectsResponse } from '../types/Schemas';
+export declare function batchCreateObjects(accountId: number, objectTypeId: string, objects: JSON): AxiosPromise<CreateObjectsResponse>;
+export declare function createObjectSchema(accountId: number, schema: JSON): AxiosPromise<Schema>;
+export declare function updateObjectSchema(accountId: number, schemaObjectType: string, schema: Schema): AxiosPromise<Schema>;
+export declare function fetchObjectSchema(accountId: number, schemaObjectType: string): AxiosPromise<Schema>;
+export declare function fetchObjectSchemas(accountId: number): AxiosPromise<FetchSchemasResponse>;
+export declare function deleteObjectSchema(accountId: number, schemaObjectType: string): AxiosPromise<void>;

package/api/customObjects.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteObjectSchema = exports.fetchObjectSchemas = exports.fetchObjectSchema = exports.updateObjectSchema = exports.createObjectSchema = exports.batchCreateObjects = void 0;
+const http_1 = require("../http");
+const CUSTOM_OBJECTS_API_PATH = 'crm/v3/objects';
+const SCHEMA_API_PATH = 'crm-object-schemas/v3/schemas';
+function batchCreateObjects(accountId, objectTypeId, objects) {
+    return http_1.http.post(accountId, {
+        url: `${CUSTOM_OBJECTS_API_PATH}/${objectTypeId}/batch/create`,
+        data: objects,
+    });
+}
+exports.batchCreateObjects = batchCreateObjects;
+function createObjectSchema(accountId, schema) {
+    return http_1.http.post(accountId, {
+        url: SCHEMA_API_PATH,
+        data: schema,
+    });
+}
+exports.createObjectSchema = createObjectSchema;
+function updateObjectSchema(accountId, schemaObjectType, schema) {
+    return http_1.http.patch(accountId, {
+        url: `${SCHEMA_API_PATH}/${schemaObjectType}`,
+        data: schema,
+    });
+}
+exports.updateObjectSchema = updateObjectSchema;
+function fetchObjectSchema(accountId, schemaObjectType) {
+    return http_1.http.get(accountId, {
+        url: `${SCHEMA_API_PATH}/${schemaObjectType}`,
+    });
+}
+exports.fetchObjectSchema = fetchObjectSchema;
+function fetchObjectSchemas(accountId) {
+    return http_1.http.get(accountId, {
+        url: SCHEMA_API_PATH,
+    });
+}
+exports.fetchObjectSchemas = fetchObjectSchemas;
+function deleteObjectSchema(accountId, schemaObjectType) {
+    return http_1.http.delete(accountId, {
+        url: `${SCHEMA_API_PATH}/${schemaObjectType}`,
+    });
+}
+exports.deleteObjectSchema = deleteObjectSchema;

package/api/designManager.d.ts

@@ -0,0 +1,5 @@
+import { AxiosPromise } from 'axios';
+import { QueryParams } from '../types/Http';
+import { FetchThemesResponse, FetchBuiltinMappingResponse } from '../types/DesignManager';
+export declare function fetchThemes(accountId: number, params?: QueryParams): AxiosPromise<FetchThemesResponse>;
+export declare function fetchBuiltinMapping(accountId: number): AxiosPromise<FetchBuiltinMappingResponse>;

package/api/designManager.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchBuiltinMapping = exports.fetchThemes = void 0;
+const http_1 = require("../http");
+const DESIGN_MANAGER_API_PATH = 'designmanager/v1';
+function fetchThemes(accountId, params = {}) {
+    return http_1.http.get(accountId, {
+        url: `${DESIGN_MANAGER_API_PATH}/themes/combined`,
+        params,
+    });
+}
+exports.fetchThemes = fetchThemes;
+function fetchBuiltinMapping(accountId) {
+    return http_1.http.get(accountId, {
+        url: `${DESIGN_MANAGER_API_PATH}/widgets/builtin-mapping`,
+    });
+}
+exports.fetchBuiltinMapping = fetchBuiltinMapping;

package/api/developerTestAccounts.d.ts

@@ -0,0 +1,7 @@
+import { AxiosPromise } from 'axios';
+import { DeveloperTestAccount, FetchDeveloperTestAccountsResponse } from '../types/developerTestAccounts';
+import { Environment } from '../types/Config';
+export declare function fetchDeveloperTestAccounts(accountId: number): AxiosPromise<FetchDeveloperTestAccountsResponse>;
+export declare function createDeveloperTestAccount(accountId: number, accountName: string): AxiosPromise<DeveloperTestAccount>;
+export declare function deleteDeveloperTestAccount(accountId: number, testAccountId: number): AxiosPromise<void>;
+export declare function fetchDeveloperTestAccountData(accessToken: string, accountId: number, env?: Environment): AxiosPromise<DeveloperTestAccount>;

package/api/developerTestAccounts.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchDeveloperTestAccountData = exports.deleteDeveloperTestAccount = exports.createDeveloperTestAccount = exports.fetchDeveloperTestAccounts = void 0;
+const axios_1 = __importDefault(require("axios"));
+const http_1 = require("../http");
+const getAxiosConfig_1 = require("../http/getAxiosConfig");
+const environments_1 = require("../constants/environments");
+const api_1 = require("../constants/api");
+const TEST_ACCOUNTS_API_PATH = 'integrators/test-portals/v2';
+function fetchDeveloperTestAccounts(accountId) {
+    return http_1.http.get(accountId, {
+        url: TEST_ACCOUNTS_API_PATH,
+    });
+}
+exports.fetchDeveloperTestAccounts = fetchDeveloperTestAccounts;
+function createDeveloperTestAccount(accountId, accountName) {
+    return http_1.http.post(accountId, {
+        url: TEST_ACCOUNTS_API_PATH,
+        data: { accountName, generatePersonalAccessKey: true },
+        timeout: api_1.SANDBOX_TIMEOUT,
+    });
+}
+exports.createDeveloperTestAccount = createDeveloperTestAccount;
+function deleteDeveloperTestAccount(accountId, testAccountId) {
+    return http_1.http.delete(accountId, {
+        url: `${TEST_ACCOUNTS_API_PATH}/${testAccountId}`,
+    });
+}
+exports.deleteDeveloperTestAccount = deleteDeveloperTestAccount;
+function fetchDeveloperTestAccountData(accessToken, accountId, env = environments_1.ENVIRONMENTS.PROD) {
+    const axiosConfig = (0, getAxiosConfig_1.getAxiosConfig)({
+        env,
+        url: `${TEST_ACCOUNTS_API_PATH}/self`,
+        params: { portalId: accountId },
+    });
+    const reqWithToken = {
+        ...axiosConfig,
+        headers: {
+            ...axiosConfig.headers,
+            Authorization: `Bearer ${accessToken}`,
+        },
+    };
+    return (0, axios_1.default)(reqWithToken);
+}
+exports.fetchDeveloperTestAccountData = fetchDeveloperTestAccountData;

package/api/fileManager.d.ts

@@ -0,0 +1,6 @@
+import { AxiosPromise } from 'axios';
+import { FetchStatResponse, FetchFilesResponse, FetchFolderResponse, UploadResponse } from '../types/FileManager';
+export declare function uploadFile(accountId: number, src: string, dest: string): AxiosPromise<UploadResponse>;
+export declare function fetchStat(accountId: number, src: string): AxiosPromise<FetchStatResponse>;
+export declare function fetchFiles(accountId: number, folderId: number | 'None', offset: number, archived?: boolean): AxiosPromise<FetchFilesResponse>;
+export declare function fetchFolders(accountId: number, folderId: number | 'None'): AxiosPromise<FetchFolderResponse>;

package/api/fileManager.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchFolders = exports.fetchFiles = exports.fetchStat = exports.uploadFile = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const http_1 = require("../http");
+const FILE_MANAGER_V2_API_PATH = 'filemanager/api/v2';
+const FILE_MANAGER_V3_API_PATH = 'filemanager/api/v3';
+function uploadFile(accountId, src, dest) {
+    const directory = path_1.default.dirname(dest);
+    const filename = path_1.default.basename(dest);
+    const formData = {
+        file: fs_1.default.createReadStream(src),
+        fileName: filename,
+        options: JSON.stringify({
+            access: 'PUBLIC_INDEXABLE',
+            overwrite: true,
+        }),
+    };
+    if (directory && directory !== '.') {
+        formData.folderPath = directory;
+    }
+    else {
+        formData.folderPath = '/';
+    }
+    return http_1.http.post(accountId, {
+        url: `${FILE_MANAGER_V3_API_PATH}/files/upload`,
+        data: formData,
+        headers: { 'Content-Type': 'multipart/form-data' },
+    });
+}
+exports.uploadFile = uploadFile;
+function fetchStat(accountId, src) {
+    return http_1.http.get(accountId, {
+        url: `${FILE_MANAGER_V2_API_PATH}/files/stat/${src}`,
+    });
+}
+exports.fetchStat = fetchStat;
+function fetchFiles(accountId, folderId, offset, archived) {
+    return http_1.http.get(accountId, {
+        url: `${FILE_MANAGER_V2_API_PATH}/files/`,
+        params: {
+            hidden: 0,
+            offset: offset,
+            folder_id: folderId,
+            ...(!archived && { archived: 0 }),
+        },
+    });
+}
+exports.fetchFiles = fetchFiles;
+function fetchFolders(accountId, folderId) {
+    return http_1.http.get(accountId, {
+        url: `${FILE_MANAGER_V2_API_PATH}/folders/`,
+        params: {
+            hidden: 0,
+            parent_folder_id: folderId,
+        },
+    });
+}
+exports.fetchFolders = fetchFolders;

package/api/fileMapper.d.ts

@@ -0,0 +1,12 @@
+import { AxiosResponse, AxiosPromise } from 'axios';
+import { FileMapperNode, FileMapperOptions, FileTree } from '../types/Files';
+export declare const FILE_MAPPER_API_PATH = "content/filemapper/v1";
+export declare function createFileMapperNodeFromStreamResponse(filePath: string, response: Partial<AxiosResponse>): FileMapperNode;
+export declare function upload(accountId: number, src: string, dest: string, options?: FileMapperOptions): AxiosPromise<void>;
+export declare function fetchModule(accountId: number, moduleId: number, options?: FileMapperOptions): AxiosPromise<FileTree>;
+export declare function fetchFileStream(accountId: number, filePath: string, destination: string, options?: FileMapperOptions): Promise<FileMapperNode>;
+export declare function download(accountId: number, filepath: string, options?: FileMapperOptions): AxiosPromise<FileMapperNode>;
+export declare function downloadDefault(accountId: number, filepath: string, options?: FileMapperOptions): AxiosPromise<FileMapperNode>;
+export declare function deleteFile(accountId: number, filePath: string): AxiosPromise<void>;
+export declare function moveFile(accountId: number, srcPath: string, destPath: string): AxiosPromise<void>;
+export declare function getDirectoryContentsByPath(accountId: number, path: string): AxiosPromise<FileMapperNode>;

package/api/fileMapper.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDirectoryContentsByPath = exports.moveFile = exports.deleteFile = exports.downloadDefault = exports.download = exports.fetchFileStream = exports.fetchModule = exports.upload = exports.createFileMapperNodeFromStreamResponse = exports.FILE_MAPPER_API_PATH = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const content_disposition_1 = __importDefault(require("content-disposition"));
+const http_1 = require("../http");
+const path_2 = require("../lib/path");
+exports.FILE_MAPPER_API_PATH = 'content/filemapper/v1';
+function createFileMapperNodeFromStreamResponse(filePath, response) {
+    if (filePath[0] !== '/') {
+        filePath = `/${filePath}`;
+    }
+    if (filePath[filePath.length - 1] === '/') {
+        filePath = filePath.slice(0, filePath.length - 1);
+    }
+    const node = {
+        source: null,
+        path: filePath,
+        name: path_1.default.basename(filePath),
+        folder: false,
+        children: [],
+        createdAt: 0,
+        updatedAt: 0,
+    };
+    if (!(response.headers && response.headers['content-disposition'])) {
+        return node;
+    }
+    const { parameters } = content_disposition_1.default.parse(response.headers['content-disposition']);
+    return {
+        ...node,
+        name: parameters.filename,
+        createdAt: parseInt(parameters['creation-date'], 10) || 0,
+        updatedAt: parseInt(parameters['modification-date'], 10) || 0,
+    };
+}
+exports.createFileMapperNodeFromStreamResponse = createFileMapperNodeFromStreamResponse;
+function upload(accountId, src, dest, options = {}) {
+    return http_1.http.post(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/upload/${encodeURIComponent(dest)}`,
+        data: {
+            file: fs_1.default.createReadStream(path_1.default.resolve((0, path_2.getCwd)(), src)),
+        },
+        headers: { 'Content-Type': 'multipart/form-data' },
+        ...options,
+    });
+}
+exports.upload = upload;
+// Fetch a module by moduleId
+function fetchModule(accountId, moduleId, options = {}) {
+    return http_1.http.get(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/modules/${moduleId}`,
+        ...options,
+    });
+}
+exports.fetchModule = fetchModule;
+// Fetch a file by file path.
+async function fetchFileStream(accountId, filePath, destination, options = {}) {
+    const response = await http_1.http.getOctetStream(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/stream/${encodeURIComponent(filePath)}`,
+        ...options,
+    }, destination);
+    return createFileMapperNodeFromStreamResponse(filePath, response);
+}
+exports.fetchFileStream = fetchFileStream;
+// Fetch a folder or file node by path.
+function download(accountId, filepath, options = {}) {
+    return http_1.http.get(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/download/${encodeURIComponent(filepath)}`,
+        ...options,
+    });
+}
+exports.download = download;
+// Fetch a folder or file node by path.
+function downloadDefault(accountId, filepath, options = {}) {
+    return http_1.http.get(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/download-default/${filepath}`,
+        ...options,
+    });
+}
+exports.downloadDefault = downloadDefault;
+// Delete a file or folder by path
+function deleteFile(accountId, filePath) {
+    return http_1.http.delete(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/delete/${encodeURIComponent(filePath)}`,
+    });
+}
+exports.deleteFile = deleteFile;
+// Moves file from srcPath to destPath
+function moveFile(accountId, srcPath, destPath) {
+    return http_1.http.put(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/rename/${srcPath}?path=${destPath}`,
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+exports.moveFile = moveFile;
+// Get directory contents
+function getDirectoryContentsByPath(accountId, path) {
+    return http_1.http.get(accountId, {
+        url: `${exports.FILE_MAPPER_API_PATH}/meta/${path}`,
+    });
+}
+exports.getDirectoryContentsByPath = getDirectoryContentsByPath;

package/api/fileTransport.d.ts

@@ -0,0 +1,4 @@
+import { AxiosPromise } from 'axios';
+export declare function createSchemaFromHubFile(accountId: number, filepath: string): AxiosPromise;
+export declare function updateSchemaFromHubFile(accountId: number, filepath: string): AxiosPromise;
+export declare function fetchHubFileSchema(accountId: number, objectName: string, path: string): AxiosPromise;

package/api/fileTransport.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchHubFileSchema = exports.updateSchemaFromHubFile = exports.createSchemaFromHubFile = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const path_2 = require("../lib/path");
+const http_1 = require("../http");
+const HUBFILES_API_PATH = '/file-transport/v1/hubfiles';
+function createSchemaFromHubFile(accountId, filepath) {
+    const file = fs_1.default.createReadStream(path_1.default.resolve((0, path_2.getCwd)(), filepath));
+    return http_1.http.post(accountId, {
+        url: `${HUBFILES_API_PATH}/object-schemas`,
+        data: {
+            file,
+        },
+        headers: { 'Content-Type': 'multipart/form-data' },
+    });
+}
+exports.createSchemaFromHubFile = createSchemaFromHubFile;
+async function updateSchemaFromHubFile(accountId, filepath) {
+    const file = fs_1.default.createReadStream(path_1.default.resolve((0, path_2.getCwd)(), filepath));
+    return http_1.http.put(accountId, {
+        url: `${HUBFILES_API_PATH}/object-schemas`,
+        data: {
+            file,
+        },
+        headers: { 'Content-Type': 'multipart/form-data' },
+    });
+}
+exports.updateSchemaFromHubFile = updateSchemaFromHubFile;
+async function fetchHubFileSchema(accountId, objectName, path) {
+    return http_1.http.getOctetStream(accountId, {
+        url: `${HUBFILES_API_PATH}/object-schemas/${objectName}`,
+    }, path);
+}
+exports.fetchHubFileSchema = fetchHubFileSchema;

package/api/functions.d.ts

@@ -0,0 +1,8 @@
+import { AxiosPromise } from 'axios';
+import { QueryParams } from '../types/Http';
+import { GetBuildStatusResponse, GetRoutesResponse } from '../types/Functions';
+export declare function getRoutes(accountId: number): AxiosPromise<GetRoutesResponse>;
+export declare function getFunctionLogs(accountId: number, route: string, params?: QueryParams): AxiosPromise;
+export declare function getLatestFunctionLog(accountId: number, route: string): AxiosPromise;
+export declare function buildPackage(accountId: number, folderPath: string): AxiosPromise<string>;
+export declare function getBuildStatus(accountId: number, buildId: number): AxiosPromise<GetBuildStatusResponse>;

package/api/functions.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBuildStatus = exports.buildPackage = exports.getLatestFunctionLog = exports.getFunctionLogs = exports.getRoutes = void 0;
+const http_1 = require("../http");
+const FUNCTION_API_PATH = 'cms/v3/functions';
+function getRoutes(accountId) {
+    return http_1.http.get(accountId, {
+        url: `${FUNCTION_API_PATH}/routes`,
+    });
+}
+exports.getRoutes = getRoutes;
+function getFunctionLogs(accountId, route, params = {}) {
+    const { limit = 5 } = params;
+    return http_1.http.get(accountId, {
+        url: `${FUNCTION_API_PATH}/results/by-route/${encodeURIComponent(route)}`,
+        params: { ...params, limit },
+    });
+}
+exports.getFunctionLogs = getFunctionLogs;
+function getLatestFunctionLog(accountId, route) {
+    return http_1.http.get(accountId, {
+        url: `${FUNCTION_API_PATH}/results/by-route/${encodeURIComponent(route)}/latest`,
+    });
+}
+exports.getLatestFunctionLog = getLatestFunctionLog;
+function buildPackage(accountId, folderPath) {
+    return http_1.http.post(accountId, {
+        url: `${FUNCTION_API_PATH}/build/async`,
+        headers: {
+            Accept: 'text/plain',
+        },
+        data: {
+            folderPath,
+        },
+    });
+}
+exports.buildPackage = buildPackage;
+function getBuildStatus(accountId, buildId) {
+    return http_1.http.get(accountId, {
+        url: `${FUNCTION_API_PATH}/build/${buildId}/poll`,
+    });
+}
+exports.getBuildStatus = getBuildStatus;

package/api/github.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="node" />
+import { AxiosPromise } from 'axios';
+import { GithubReleaseData, GithubRepoFile, RepoPath } from '../types/Github';
+declare global {
+    var githubToken: string;
+}
+export declare function fetchRepoReleaseData(repoPath: RepoPath, tag?: string): AxiosPromise<GithubReleaseData>;
+export declare function fetchRepoAsZip(zipUrl: string): AxiosPromise<Buffer>;
+export declare function fetchRepoFile(repoPath: RepoPath, filePath: string, ref: string): AxiosPromise<Buffer>;
+export declare function fetchRepoFileByDownloadUrl(downloadUrl: string): AxiosPromise<Buffer>;
+export declare function fetchRepoContents(repoPath: RepoPath, path: string, ref?: string): AxiosPromise<Array<GithubRepoFile>>;

package/api/github.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchRepoContents = exports.fetchRepoFileByDownloadUrl = exports.fetchRepoFile = exports.fetchRepoAsZip = exports.fetchRepoReleaseData = void 0;
+const axios_1 = __importDefault(require("axios"));
+const getAxiosConfig_1 = require("../http/getAxiosConfig");
+const GITHUB_REPOS_API = 'https://api.github.com/repos';
+const GITHUB_RAW_CONTENT_API_PATH = 'https://raw.githubusercontent.com';
+function getAdditionalHeaders() {
+    const headers = {};
+    if (global && global.githubToken) {
+        headers.authorization = `Bearer ${global.githubToken}`;
+    }
+    else if (process.env.GITHUB_TOKEN) {
+        headers.authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+    }
+    return headers;
+}
+// Returns information about the repo's releases. Defaults to "latest" if no tag is provided
+// https://docs.github.com/en/rest/releases/releases?apiVersion=2022-11-28#get-a-release-by-tag-name
+function fetchRepoReleaseData(repoPath, tag = '') {
+    const URL = `${GITHUB_REPOS_API}/${repoPath}/releases`;
+    return axios_1.default.get(`${URL}/${tag ? `tags/${tag}` : 'latest'}`, {
+        headers: {
+            ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(),
+            ...getAdditionalHeaders(),
+        },
+    });
+}
+exports.fetchRepoReleaseData = fetchRepoReleaseData;
+// Returns the entire repo content as a zip, using the zipball_url from fetchRepoReleaseData()
+// https://docs.github.com/en/rest/repos/contents?apiVersion=2022-11-28#download-a-repository-archive-zip
+function fetchRepoAsZip(zipUrl) {
+    return axios_1.default.get(zipUrl, {
+        responseType: 'arraybuffer',
+        headers: { ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(), ...getAdditionalHeaders() },
+    });
+}
+exports.fetchRepoAsZip = fetchRepoAsZip;
+// Returns the raw file contents via the raw.githubusercontent endpoint
+function fetchRepoFile(repoPath, filePath, ref) {
+    return axios_1.default.get(`${GITHUB_RAW_CONTENT_API_PATH}/${repoPath}/${ref}/${filePath}`, {
+        headers: {
+            ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(),
+            ...getAdditionalHeaders(),
+        },
+    });
+}
+exports.fetchRepoFile = fetchRepoFile;
+// Returns the raw file contents via the raw.githubusercontent endpoint
+function fetchRepoFileByDownloadUrl(downloadUrl) {
+    return axios_1.default.get(downloadUrl, {
+        headers: { ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(), ...getAdditionalHeaders() },
+        responseType: 'arraybuffer',
+    });
+}
+exports.fetchRepoFileByDownloadUrl = fetchRepoFileByDownloadUrl;
+// Returns the contents of a file or directory in a repository by path
+// https://docs.github.com/en/rest/repos/contents?apiVersion=2022-11-28#get-repository-content
+function fetchRepoContents(repoPath, path, ref) {
+    const refQuery = ref ? `?ref=${ref}` : '';
+    return axios_1.default.get(`${GITHUB_REPOS_API}/${repoPath}/contents/${path}${refQuery}`, {
+        headers: {
+            ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(),
+            ...getAdditionalHeaders(),
+        },
+    });
+}
+exports.fetchRepoContents = fetchRepoContents;

package/api/hubdb.d.ts

@@ -0,0 +1,12 @@
+import { AxiosPromise } from 'axios';
+import { QueryParams } from '../types/Http';
+import { CreateRowsResponse, FetchRowsResponse, Row, Schema, Table, FetchTablesResponse } from '../types/Hubdb';
+export declare function fetchTables(accountId: number): AxiosPromise<FetchTablesResponse>;
+export declare function fetchTable(accountId: number, tableId: string): AxiosPromise<Table>;
+export declare function createTable(accountId: number, schema: Schema): AxiosPromise<Table>;
+export declare function updateTable(accountId: number, tableId: string, schema: Schema): AxiosPromise<Table>;
+export declare function publishTable(accountId: number, tableId: string): AxiosPromise<Table>;
+export declare function deleteTable(accountId: number, tableId: string): AxiosPromise<void>;
+export declare function createRows(accountId: number, tableId: string, rows: Array<Row>): AxiosPromise<CreateRowsResponse>;
+export declare function fetchRows(accountId: number, tableId: string, params?: QueryParams): AxiosPromise<FetchRowsResponse>;
+export declare function deleteRows(accountId: number, tableId: string, rowIds: Array<string>): AxiosPromise<void>;